@agenticprimitives/fulfillment

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

完成Case生命周期+任务/信使/Artifact(从mcp-runtime/a2a再出)+手取政策+证据信用+结果信用发行.

中文使用文档
文档目录5 节
  1. 今天的什么战舰
  2. 在海浪中登陆的是什么(设计而未发运)
  3. 标题/市场背景
  4. 构建
  5. 状态——诚实版

@ agenicprimitives/ 实现

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

现况:STUB (Wave 0.5 of the W1执行浪潮). 国家机器,类型,和无常的卫兵 船今天; 完全完成运行 地在波7b w1 执行波计划。 。 。 .

如果事后没有人能说出实际发生的事情,那么两个代理人之间的协议就毫无价值了. 工作由谁完成,交给谁,他们产生了什么,结果是否与承诺的一致? 代理框架协调任务;几乎无一产生 证据。这个软件包是设计的答案:a FulfillmentCase 在容器中,每项任务、信息、文物和交接都附带有经打字政策认证的能干智能代理身份,并被提升为证书 OutcomeCredential 不引用 EvidenceCredential 支持它。 支持它。 "我们交付"的说法在结构上被迫指证证据.

这是底板的实现部分——脊椎层10-12, 完整地标出,现在脚手架上,降落在执行波中——它与授权这项工作和解决这项工作的付款授权的代表团共享一个信任链.

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

今天的什么战舰

类型、状态机器和无常的警卫——没有运行时间、储存或证书签发:

  • FulfillmentCase 类型 + 生命周期状态机器 - 13个国家drafted ...... ...... ..... archived 编号 : canceled 编号 : disputed与 canTransition 执法优势。 注:过渡只检查形状;演员授权为波工作.
  • A2A 对 Task 状态机器 —— 说 canTaskTransition 数据,包括 auth-required 等待新授权的任务暂停循环 .
  • HandoffPolicy 类型+ isHandoffAllowed ——键入权限约束交叉代理交接. 今天的检查只涵盖代理/类许可名单; requiresUserApproval, (中文(简体) ), preservePrivacyTier, (中文(简体) ), allowedScopes,以及 maxHopCount 执法是波浪工作(公开追踪为NEW-FLF-1) 调查结果分类账) (中文(简体) ).
  • Artifact + 键 OutcomeCredentialSubject 类型 散居地的文物(尸体从未上过链)和 assertOutcomeCitations,FLF-OUT-1的后卫:一个没有证据引用的结果.
  • IntentTraceSpan ——打入的痕量跨度(parse / solution / handoff / solve call / user 批准 /.),用于端到端执行法证.

在海浪中登陆的是什么(设计而未发运)

运行时间: buildFulfillmentCase, (中文(简体) ), transitionLifecycle 经演员授权, handoffTask 全面的政策执行 信息线索 文物出版物, promoteToEvidence 编号 : assertOutcome 证书发放到证明层、痕量树木组装和生命周期 QQ协议-状态调节(FLF-INV-01)。 工作流引擎保持App-layer;这个软件包是引擎不可知的.

标题/市场背景

  • 谷歌 A2A 定义任务/信使/Artifact电线模型;我们采用它(通过 mcp-runtime, spec 245)而不是发明出竞争对手——这个包件增加了案例容器,交接政策,以及证据推广A2A省略.
  • 上游大门(第336区: 只有在理解了意图、可接受的签名后,才创建任务 FulfillmentOffer 任务已经存在,而且没有到期——从不直接与发现匹配。 执行过渡作为明确的打字命令(出价摘要+接受摘要+任务陈述+一能键)而来,结束 FulfillmentReceipt 以摘要的形式约束意图、提议、任务、任务和结果——重新定向不是接收,也不是成功的民意调查.
  • 谷歌AP2和x402 授权代理人支付;a FulfillmentCase 将这些任务与它们支付的任务挂钩(ContextBinding.taskId, FLF-INV-11),所以机器付款从不从它所安排的工作中不流出.
  • 不同组合:任务执行、交割权、付款约束和成果证据 一个 委托 + 保管 + 审计底盘 – 缝合堆失去线条的接合正是第10-12层设计要持有的.

权威规格 : spec 244——实现 (见 spec.md) (中文(简体) ). 拥有脊柱地层 10-12;地表 CLAUDE.md 财务报告和审定财务报表 capability.manifest.json。 。 。 .

构建

pnpm --filter @agenticprimitives/fulfillment typecheck
pnpm --filter @agenticprimitives/fulfillment test
pnpm --filter @agenticprimitives/fulfillment build

状态——诚实版

苏布。 什么样的船是被打入的骨架和纯粹的卫兵;一切运转的都是波浪工作,两个已知的执法漏洞(交接政策领域,过渡授权)被公开登入 docs/audits/findings.yaml 而不是铺平。 波浪顺序 : w1-执行-波-计划.md。 。 。 .

版本与发布记录

@agenticprimitives/fulfillment 共发布 41 个版本,首次发布于 2026/06/11;过去 12 个月发布了 41 个版本。

版本发布日期距今
0.0.0-alpha.43latest2026/10/2610 天前
0.0.0-alpha.422026/10/2610 天前
0.0.0-alpha.412026/10/1720 天前
0.0.0-alpha.402026/10/1720 天前
0.0.0-alpha.392026/10/1620 天前
0.0.0-alpha.382026/10/1620 天前

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

关于 @agenticprimitives/fulfillment 的常见问题

@agenticprimitives/fulfillment 是什么?

完成Case生命周期+任务/信使/Artifact(从mcp-runtime/a2a再出)+手取政策+证据信用+结果信用发行.

如何安装 @agenticprimitives/fulfillment?

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

@agenticprimitives/fulfillment 支持 TypeScript 吗?

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

@agenticprimitives/fulfillment 支持 ESM 还是 CommonJS?

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

@agenticprimitives/fulfillment 可以商用吗?

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

@agenticprimitives/fulfillment 的下载量有多少?

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

@agenticprimitives/fulfillment 还在维护吗?

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