@agenticprimitives/registry-resolution

中文文档
1.0.0-alpha.40发布于 2026/10/26MITTypeScriptES Module零依赖近 30 天下载 1715

编组的打字解析器(第346页§6.3/§8/9):打出的名称-主题-衍生类型-(文稿-关系)-允许发布-绑定,以SEPARATE信号(主题/上下文/关系/绑定/权威/证据)发回——永远不

中文使用文档
文档目录4 节
  1. 使用量
  2. 流量(第346节)
  3. 态势默认值(第346页 第8.1节)
  4. 这个包裹拒绝做什么

@ agenticprimitives/ registry - 解析

部分 代理先导 ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. 开发者工具包 • 妇女 所有软件包

编 成 已键入名称解析器 346区: 给定打入的手柄(rpedersen.me, (中文(简体) ), [email protected], (中文(简体) ), [email protected], (中文(简体) ), discovery.registry)和呼叫者姿态, 它返回对象,它的 衍生类型、发行上下文和活关系(用于 x@ctx 名称),允许的部署 b. 约束性,其代表团 锯,以及登记册/目录证据——作为 六个单独的信号。 。 。 . 它从不返回一个信任的分数 也不授权任何东西.

parseAgentName ─▶ checkTypedName (suffix ↔ on-chain atl:agentType ↔ root; fail closed)
   │ x@ctx: issuance (posture-gated) ─▶ basis live? (membership · role gate · delegation) ─▶ ContextualAgentReferenceV1
   ▼
discovery policy (per-agent or the per-type default) ─▶ is THIS caller admitted? (one mechanism)
   ▼
publication via the caller's reference kind (ans-name | private-grant | direct-invitation) ─▶ bindings
   ▼
registry entries + directory evidence ─▶ TypedResolutionResultV1

使用量

import { resolveTypedName } from '@agenticprimitives/registry-resolution';

const out = await resolveTypedName('[email protected]', { posture: 'grant', requester, grantId, presentation }, ports);
if (out.ok) {
  out.result.subject;       // { agentId, derivedType: 'person', root: 'person', name, legacy: false, typeConsistent: true }
  out.result.context;       // { agentId: richcanvas.org's SA, derivedType: 'org', name: 'richcanvas.org' }
  out.result.relationship;  // { membershipId, roleAssignmentId?, delegationHash, current: true, basis: 'membership' }
  out.result.bindings;      // { host, agentCardUrl, a2aEndpoint, surfaces, publication } — from the signed publication
  out.result.authority;     // { note: 'resolution-is-not-authority', delegationsSeen: [...] }
  out.result.evidence;      // { registryEntries, assurance, directory }
} else {
  out.reason;               // 'unregistered' | 'type_mismatch' | 'issuance_not_found' | 'basis_not_current' | 'not_permitted' | …
}

ports (单位:千美元)TypedResolverPorts)全部被注入: 键入命名为(AgentNamingClient.checkTypedName, (中文(简体) ), 上下文的发行面、代表团实况、成员/作用、 解析器、登记证据和可选目录证据、工作空间读取和代理政策.

流量(第346节)

函数它的计划
acceptConnectInvitation(invitation, acceptor, now)形状 + 到期 + 接受者检查; 返回赠款 + 邀请商店的初始出版物。 登记处没有记录.
planContextualNameIssuance(input, registryId)在接受加入后:未签署 ContextualNameIssuanceV1 体 (单位:千人)kind: 'reference'成员+代表团基础)+ CONTEXTUAL_NAME_ISSUED 日志事件.
planScopedNameIssuance(input, registryId)发布上下文 vault.svc@… 编号 : architecture.team@… 在它自己的命名空间中( e)operated-by 编号 : chartered (b) 基准.
revokeContextualName(issuance, registryId, now)取消上下文名称;条柄未受影响.

转诊治疗(第9.3节) registry-kit (单位:千美元)admitRegistryEntry (a) 与一名赞助人.

态势默认值(第346页 第8.1节)

defaultDiscoveryPolicyForType(t) - 个人:公共名称、未列入名单、赠款解决;org/服务/登记: 公开; 团队/工作空间: 同意列名, 认证分辨率; 金库: 未列名, 赠款解决. callerAdmittedBy(policy, posture) 是单项录取规则.

这个包裹拒绝做什么

持有状态,打开交通工具,决定批准,级别,或者退后. 见 CLAUDE.md。 。 。 .

版本与发布记录

@agenticprimitives/registry-resolution 共发布 19 个版本,首次发布于 2026/09/12;过去 12 个月发布了 19 个版本。

版本发布日期距今
1.0.0-alpha.40latest2026/10/2614 天前
1.0.0-alpha.392026/10/1724 天前
1.0.0-alpha.382026/10/1624 天前
1.0.0-alpha.372026/10/1624 天前
1.0.0-alpha.362026/10/1624 天前
1.0.0-alpha.352026/10/1624 天前

关于 @agenticprimitives/registry-resolution 的常见问题

@agenticprimitives/registry-resolution 是什么?

编组的打字解析器(第346页§6.3/§8/9):打出的名称-主题-衍生类型-(文稿-关系)-允许发布-绑定,以SEPARATE信号(主题/上下文/关系/绑定/权威/证据)发回——永远不

如何安装 @agenticprimitives/registry-resolution?

在项目目录运行 npm install @agenticprimitives/registry-resolution,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@agenticprimitives/types(^1.0.0-alpha.45)、@agenticprimitives/situations(^0.0.0-alpha.29)、@agenticprimitives/agent-naming(^1.0.0-alpha.45)、@agenticprimitives/organization(^0.0.0-alpha.29)、@agenticprimitives/registry-kit(^0.0.0-alpha.28)、@agenticprimitives/agent-resolution(^0.0.0-alpha.21)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agenticprimitives/registry-resolution 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agenticprimitives/registry-resolution 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agenticprimitives/registry-resolution 可以商用吗?

@agenticprimitives/registry-resolution 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@agenticprimitives/registry-resolution 的下载量有多少?

根据 npm 官方下载统计,@agenticprimitives/registry-resolution 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,715 次,日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agenticprimitives/registry-resolution 还在维护吗?

最新版本 1.0.0-alpha.40 发布于 2026/10/26(14 天前);至今共发布 19 个版本,其中过去 12 个月发布了 19 个;首次发布于 2026/09/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。