@absolutejs/agent-exchange

中文文档
0.5.1发布于 2026/09/25Apache-2.0TypeScriptES Module近 30 天下载 1925

使用Agency,A2A,和E2EE进行人和剂的验证,型号盲敏感值交换.

中文使用文档
文档目录7 节
  1. 明确保证
  2. 常设任务
  3. 安全变化因素
  4. A2A 边界
  5. 可互换来源
  6. 许可证
  7. 释放兼容性

@absolutejs/agent-exchange

经核实的、有目的限制的、模型盲敏感价值的人类和 探员 它由现有的绝对JS原始组成,而不是创建另一个 许可或运输系统:

Auth identity and delegation
        ↓
Agency approval and single-use execution lease
        ↓
deterministic source tool → E2EE envelope → deterministic recipient sink
        ↓
A2A carries an opaque exchange reference and redacted receipt

默认处理模式是 tool-confined。保护字节提供给 信任的工具,擦去每一个完成路径, 并排除从请求, 机构分类账、A2A任务历史、出错、遥测和收款.

这是实验 0.x 未经独立审计. 只有在宣布的每一项保证要求都存在时,才有吸入阻力 实际满足; 电子邮件和短信编码仍然是无记名证书.

明确保证

每次请求都宣布三项独立保证。 防钓的形状 故意无法以无记名证书或一般执行方式表示:

assurance: {
  approval: "webauthn-verifier-bound",
  credential: "sender-constrained",
  execution: "purpose-bound",
}

对于这个模式, beginApproval() 产生一个域分隔的 SHA-256 挑战 来自 完全不可改变的交换. approve() 只接受配置的核准 提供者核实的WebAuthn结果 请求者的确切对象和权限 源代码。 由此产生的机构核准储存了证书识别码的散列, 从来没有断言或原始标识。 租赁的签发和执行的重新检查 与当前要求相反的证据.

这符合WebAuthn关于验证挑战、来源、RP ID散列的要求, 用户存在标记,以及——应要求——用户验证标记。 提供者 必须请求用户验证并进行加密断言验证.

当上游提供者签发无记名访问标志但绝对 PaaS 限制 他们给一个决定性的经纪人, 请求使用一个单独的,故意弱化 形状 :

assurance: {
  approval: "webauthn-verifier-bound",
  credential: "token-confined-broker",
  execution: "purpose-bound",
}

这意味着代理商都无法进入 并且只限一个经批准的 工具操作,但上游资源本身没有加密绑定 经纪人的出入证 它绝不能被描述为相当于 发送器- 约束 DPoP 或 mTLS 令牌 .

常设任务

长期运行的代理对代理自动化使用单独的保证值:

assurance: {
  approval: "standing-mandate",
  credential: "token-confined-broker",
  execution: "purpose-bound",
}

createAgentExchangeStandingMandateAuthority() 问题和核查紧凑的JWS 其有效载荷对所有人、请求代理人、执行代理人、 OAuth代理授权、账户、提供者、来源、操作、目的、风险等级、秘密类型、激活 窗口、过期和总使用限额。 签发需要新鲜的、用户验证的WebAuthn 证据。 授权还需要请求 delegationId 将会是 作为其独立认证的代理代表团,要求 请求的单独 mandateId 与签署的授权身份证相等,并在解剖学上 在撤销时消耗交换 ID 存储。 JWS没有被放入A2A任务历史.

核心接受可互换的 JWS 签名器、 验证器和耐用存储器 执行。 生产核查员必须认证可信赖的签发人和 密钥 ID, 执行明确的 JWS 类型和允许的算法, 并拒绝未知或 撤销登记。 记忆库仅用于测试和局部开发.

此设计使用签名的负载格式 RFC 7515 (法语)JSON规则 RFC 8785 (英语),狭义的行动和 来自 RFC 9396 (法语),则 描述的单独主题/演员语义 RFC 8693 (法语)它不制造电线 合同取决于未完成的交易委托书或链式委托书.

安全变化因素

  • 每个请求都约束请求者、接受者、目的、服务来源、账户 参考、操作、保证、过期、非ce、处理模式,以及 maximumUses: 1。 。 。 .
  • 机构只授权元数据行动并消耗执行租赁 在读取来源之前.
  • 接受者同意的,须与同一请求核对.
  • 接收器认证信封,然后在解剖上消耗非ce 在水槽执行前。 无效的密码文本不能燃烧合法的交换 .
  • 源、信封、运输和汇故障成为允许列出的错误代码; 依赖性错误信息永远不会跨越边界 .
  • 接收和汇的参考文献被扫描为直接、UTF-8、十六进制、基数64、, 和受保护值的基数64url表示.
  • 高风险恢复、行政、安全设定、货币流动和出口 除非主机明确选择它们,否则流量会被拒绝.
  • 常设授权是精确匹配的许可列表,绝不是通配范围. 退缩, 重放预防,过期,总使用限由一原子商店执行.

A2A 边界

@absolutejs/agent-exchange/a2a 添加代理交换扩展到代理 卡片和创建请求信件,只包含不透明的交换引用和 安全元数据。 信封通过配置的交换运输交付, 在普通 A2A 任务历史中并不存在.

见 警卫 在使用真实的保护数据之前.

可互换来源

来源融合在公众中 absolutejs/agent-exchange-sources 所以这个核心从不依赖邮箱、短信、金库或设备提供者 SDKs (英语).

第一个适配器是 @absolutejs/agent-exchange-email它约束了决定性因素 Gmail, 微软图形, 或 IMAP 检索 @absolutejs/email 改为: SensitiveValueSource API : (英语)

bun add @absolutejs/agent-exchange @absolutejs/agent-exchange-email @absolutejs/email

模版清单中仍然没有核查码检索。 这个 适配器手可变字节直接到此软件包进行加密, 而这个 包裹在交货后擦去.

许可证

阿帕奇 - 2.0

释放兼容性

这个 0.5.x 线条使用版本绑定 @absolutejs/[email protected] 认证合同和单独认证的供应商运行时间。 供应商 接纳仍然是东道方的责任;兼容类型不替换 释放的特定安全证据.

版本与发布记录

@absolutejs/agent-exchange 共发布 11 个版本,首次发布于 2026/08/26;过去 12 个月发布了 11 个版本。

版本发布日期距今
0.5.1latest2026/09/251 个月前
0.5.02026/08/272 个月前
0.4.42026/08/262 个月前
0.4.32026/08/262 个月前
0.4.22026/08/262 个月前
0.4.12026/08/262 个月前

关于 @absolutejs/agent-exchange 的常见问题

@absolutejs/agent-exchange 是什么?

使用Agency,A2A,和E2EE进行人和剂的验证,型号盲敏感值交换.

如何安装 @absolutejs/agent-exchange?

在项目目录运行 npm install @absolutejs/agent-exchange,或使用 pnpm add / yarn add / bun add。

@absolutejs/agent-exchange 支持 TypeScript 吗?

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

@absolutejs/agent-exchange 支持 ESM 还是 CommonJS?

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

@absolutejs/agent-exchange 可以商用吗?

@absolutejs/agent-exchange 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@absolutejs/agent-exchange 的下载量有多少?

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

@absolutejs/agent-exchange 还在维护吗?

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