@dharma-ai-labs/agent-fabric-contracts

中文文档
0.1.18发布于 2026/10/18MITTypeScriptES Module构建来源已验证近 30 天下载 1.2万

Dharma Agent Fabric 的版本计划、签名和类型脚本合同

中文使用文档
文档目录3 节
  1. 签名过期回收拥有协议
  2. 行动决定收款
  3. 代码任务观察

@dharma-ai-labs/agent-fabric-contracts

Dharma Agent Fabric 协议的版本类型脚本合同和验证器 信封、提供者能力、证据请求、签名任务和收据. Schema的有效性确定了结构和完整性;它没有证明事实 确定理由或推理的有效性.

签名过期回收拥有协议

parseDeviceSigningRecoveryChallenge(), (中文(简体) ), deviceSigningRecoverySigningPayload() 财务报告和审定财务报表 verifyDeviceSigningRecoveryProof() 验证目的分离 dharma.device-signing-recovery-challenge/v1 公共占有协议。 这个 挑战约束现有装置和安装、预定接收者、, 组织、工作空间、源选择和政策、受保护的配置、, 本地会话绑定文摘、浏览器批准意图、准确的发行人/观众, 以前的被保护锚和信任, 提议的单体信托文物, 加密传送公用钥匙和最多15分钟的窗口. 会话约束 是文摘,从不浏览器 cookie, 会话符号或本地的语录内容.

有效证据只确定设备钥匙的拥有。 它不是接受者或 所有者核准、候选出处、服务器认证员核查,a 单用途消费记录或修改受保护信任的许可。 呼叫者 必须从权威记录中获得预期的背景,而不是从 请求 计划检查结构; 解析器还检查峡谷 编码、时间戳、上下文平等、增加生成和改变 艺术品 普通签名更新核查和历史关键窗口 不变。 服务器、浏览器和被保护的存储恢复流程尚未实现 连接;仅靠这些功能无法恢复生产.

行动决定收款

dharma.action-decision-receipt/v1 是一个由名字签名的短期收据 KMS 密钥版本. 它携带一个 release, (中文(简体) ), block, (中文(简体) ), escalate,或 withhold 将决定与组织、任务、行动、, 终点、工作空间、评价合同、国家信封、证据参考书, 和犬学SHA-256任务动作文摘. 收据最多可活30个 几分钟.

使用 actionDecisionDigest() 结束 dharma.task-action/v1 并验证嵌入式 { id, actionDigest, receipt, signature, keyVersion } 与 verifyActionDecisionReceipt()。 。 。 . buildActionDecisionAcknowledgement() 发射 总部执行有效载荷 executed, (中文(简体) ), contained,或 unknown 处置。 身份确认在已签名的设备内返回 协议频道.

代码任务观察

dharma.codex-task-observation/v1 将一个逻辑命名会话工作项目绑定为 其精确保存的捕捉、源头和结果快照、签名存储器 包件,证据同意,以及独立签名的结果. 记录 包含散列和身份;原始来源,对话内容,证书, 私人分级者按其适用政策分别保留.

使用 codexTaskLogicalRequestId() 以在供应商复述时保存身份. verifyCodexTaskObservation() 检查设备签名, 当前注册 同意、权威证据、包干、分级合同、, 和独立的分级签名。 分级键必须与设备不同 键。 失败和中断的工作可以保留失败的结果;它们不能声称 过分 提供商要求的型号与其 未报告的已执行模式,而且重放是明确的任务级别.

原地观测核查现在需要 retained.captureBytes 从 授权的证据库。 匹配设备提供的散列描述符不是 足够了. verifyCodexTaskCaptureBytes() 检查准确的 UTF-8 字节 严格 v2 捕获计划, 请求/ 事件摘要, 所有范围化的身份, 事件 命令、时限、完整覆盖和观察终端通知. 其投入和产出没有授权披露或证明执行. 在本地保留原始捕获加密,除非有单独的适用许可 保留。 编辑或可移植导出是不同的证据 文摘;不能作为原始抓取而被传递. 缺少原始字节 未关闭且没有资格进入本地观察机构.

verifyCodexTaskOutcome() 适用具有约束性、时间性和独立性的相同结果 签名检查不需要设备签名的观察信封. A 类 成功结果返回收件ID、犬类收件散列和实际 任务详细证据参考的级别。 提供权威的逻辑工作, 抓取、快照、评估合同和公开证据散失 终端状态和完成时间、已注册设备密钥和可信任的分级器 解决者。 仅凭核实的结果并不能证明目前的同意或入学情况 并且不能被算作一种公认的学习观察.

打电话者必须从入学者那里获得核查资料和经批准的证据 存储和信任的分级记录,而不是对观察的 声明。 校验不存储或计数观察, 复制 或进行评价、金丝雀、出版或回滚。 这些运行时间 在学习之前仍然需要融入和真正的Codex资格 报告为可操作.

根据麻省理工学院的许可.

版本与发布记录

@dharma-ai-labs/agent-fabric-contracts 共发布 17 个版本,首次发布于 2026/08/09;过去 12 个月发布了 17 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.18latest2026/10/1824 天前
0.1.172026/10/1725 天前
0.1.162026/10/1330 天前
0.1.152026/10/101 个月前
0.1.142026/10/031 个月前
0.1.132026/10/011 个月前

关于 @dharma-ai-labs/agent-fabric-contracts 的常见问题

@dharma-ai-labs/agent-fabric-contracts 是什么?

Dharma Agent Fabric 的版本计划、签名和类型脚本合同

如何安装 @dharma-ai-labs/agent-fabric-contracts?

在项目目录运行 npm install @dharma-ai-labs/agent-fabric-contracts,或使用 pnpm add / yarn add / bun add。

@dharma-ai-labs/agent-fabric-contracts 支持 TypeScript 吗?

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

@dharma-ai-labs/agent-fabric-contracts 支持 ESM 还是 CommonJS?

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

@dharma-ai-labs/agent-fabric-contracts 可以商用吗?

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

@dharma-ai-labs/agent-fabric-contracts 的下载量有多少?

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

@dharma-ai-labs/agent-fabric-contracts 还在维护吗?

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