@agenticprimitives/related-agents

中文文档
0.0.0-alpha.42发布于 2026/10/26MITTypeScriptES Module近 30 天下载 4149

私人,持有者-居民相关代理证书(Person-X-org链接作为金库状况证书,从未在链上边缘——ADR-0025)+范围授权读取了备注+列表-query形状. 由可核查证书+代表团组成.

中文使用文档
文档目录6 节
  1. 使用量
  2. 怎么不一样
  3. 边界
  4. 验证
  5. 状态
  6. 许可证

@ agenicprimitives/ 相关代理

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

有些关系不是别人的事. 当一个人通过一个依赖的应用程序创建一个组织时,这个人的QQorg链接是整个身份堆栈中最敏感的事实之一——大多数系统的默认是泄露它:输入一个应用程序数据库,输入一个公共图表,输入一个索引. 这个软件包使私人路径成为唯一的路径. 个人\\ org 链接是一个 私人、持有者-居民金库证书 ——从不连锁关系,从不依赖-app-local person-org状态(AR-0025 (英语)) (中文(简体) ). 公众信任图只保留Org↔org,只保留明确的双边同意.

部分 代理原始产品 ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

它运送三样东西: 证书建造者 将一个人与一个 相关代理人 (例如,它们通过依赖性应用创建的org),范围授权读取受赠方收到的警告,列表-query电线塑造会话经纪人服务——刻意携带的形状 无身份证明,因此连列表表面也不能泄露链接.

编曲 verifiable-credentials (DOLCE+DnS情况+EIP-712证明)和 delegation (ca. 亲兄弟 agent-relationships,拥有 公开、连锁 只有边缘——两者都是由设计而来设置的防火墙:此软件包可能不会导入该软件包,而personqqorg从不会被写作边缘.

使用量

import { buildRelatedAgentCredential, relatedAgentReadCaveats } from '@agenticprimitives/related-agents';
import { signCredential } from '@agenticprimitives/verifiable-credentials';

// The broker mints this during org-create, signed by the person's ROOT credential:
const unsigned = buildRelatedAgentCredential({
  holder: personSA, relatedAgent: orgSA,
  purpose: 'adopter-org', requestedBy: 'relying-app',
  issuerCaip10: `eip155:84532:${personSA}`,
  body: { agentName: 'acme-co.agent' },
  validFrom: new Date().toISOString(),
});
const credential = await signCredential(unsigned, personRootSigner);

// The scoped org→grantee delegation caveats:
const caveats = relatedAgentReadCaveats({
  enforcers: { timestamp, value, allowedTargets },
  validUntil, allowedTargets: [orgSA],
});

证书是自发的(持有者=发行者=该人的智能代理), visibility = private持有者 - 居民。 受赠方收到的警告是有时限的、零价值和目标范围——受赠方能够 读取 虎,不要动任何东西. purpose 是应用程序提供的免费字符串;此软件包没有纵向词汇.

怎么不一样

竞争模式是 app-地方会员表和公共社会图表 / 依赖的应用程序拥有个人- org行( 用户不能把它带到别处, 或取消该应用程序对它的知识), 或 链接发布在图中

  • 持有者 - 居民,而不是应用居民. 证书住在个人的金库里;依赖的应用程序得到一个范围,可撤销,有时间限制的委托——从不联系自己.
  • 隐私是结构性的,不是环境. 一个Person-QQorg链接上没有"公"旗. 链上图agent-relationships在得到明确双边同意的情况下,将保留给orgs边缘.
  • 固执以克能克相. 两端都是Smart Agent地址,因此私人链接能活下来的认证旋转和名称变化——其余基底运行的相同的面相学说.

边界

  • 仓库不在这里. 保险库(Process-home KV)和查询端点为app/Process-level;此包仅为形状+构建器.
  • VC信封和签名 属于 verifiable-credentials· ; 代表团 属于 delegation。这个软件包由两者组成,既不拥有,也不拥有.
  • 线形 —— 说 RelatedAgentLink, (中文(简体) ), ListRelatedAgentsResponse, (中文(简体) ), DelegatedAgentLink, (中文(简体) ), ListDelegatedAgentsResponse ——不携带个人身份证.

光谱: specs/246-related-agents-vault.md。 。 。 .

验证

pnpm --filter @agenticprimitives/related-agents typecheck
pnpm --filter @agenticprimitives/related-agents test

状态

w1 - 创始 - 证书建造者、警告装置和电线形状是今天的船只;在应用/经纪人层储存并服务土地。 测试网/已准备就绪;生产发射在根部的公开核对表上封门 README.md ——包括第三方合同审计和治理关键轮换. 追踪所有安全发现 docs/audits/findings.yaml。 。 。 .

许可证

UNLICENSED(内部单列,未出版).

版本与发布记录

@agenticprimitives/related-agents 共发布 40 个版本,首次发布于 2026/06/11;过去 12 个月发布了 40 个版本。

版本发布日期距今
0.0.0-alpha.42latest2026/10/2612 天前
0.0.0-alpha.412026/10/2612 天前
0.0.0-alpha.402026/10/1721 天前
0.0.0-alpha.392026/10/1722 天前
0.0.0-alpha.382026/10/1622 天前
0.0.0-alpha.372026/10/1622 天前

其他发布通道:alpha → 0.0.0-alpha.3。

关于 @agenticprimitives/related-agents 的常见问题

@agenticprimitives/related-agents 是什么?

私人,持有者-居民相关代理证书(Person-X-org链接作为金库状况证书,从未在链上边缘——ADR-0025)+范围授权读取了备注+列表-query形状. 由可核查证书+代表团组成.

如何安装 @agenticprimitives/related-agents?

在项目目录运行 npm install @agenticprimitives/related-agents,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:viem(^2.52.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@agenticprimitives/related-agents 支持 TypeScript 吗?

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

@agenticprimitives/related-agents 支持 ESM 还是 CommonJS?

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

@agenticprimitives/related-agents 可以商用吗?

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

@agenticprimitives/related-agents 的下载量有多少?

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

@agenticprimitives/related-agents 还在维护吗?

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