# @agenticprimitives/fulfillment 中文文档

规范地址：https://npmcn.com/package/%40agenticprimitives/fulfillment/

版本：0\.0\.0-alpha\.43
npm 元数据更新时间：2026-10-26T11:49:07.809Z
中文译文更新时间：2026-11-06T02:36:05.239Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agenticprimitives/fulfillment
原文对照：https://npmcn.com/package/%40agenticprimitives/fulfillment/?lang=original
项目主页：https://agenticprimitives.dev/
源码仓库：https://github.com/agentictrustlabs/agenticprimitives

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：24.8 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：6 个
- peer 依赖：viem ^2\.52\.2
- 首次发布：2026-06-11T05:00:07.946Z
- 最新版本发布：2026-10-26T11:48:55.140Z
- 近 30 天下载量：6253（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 41 个）

## 中文简介

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

## 安装

```sh
npm install @agenticprimitives/fulfillment
```

也可以使用：`pnpm add @agenticprimitives/fulfillment`、`yarn add @agenticprimitives/fulfillment`、`bun add @agenticprimitives/fulfillment`

## README

# @ agenicprimitives/ 实现

> 部分 **[代理先导](https://agenticprimitives.dev/)** ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. [开发者工具包](https://github.com/agentictrustlabs/agentic-primitives) • 妇女 [所有软件包](https://agenticprimitives.dev/developers)

> **现况:STUB** (Wave 0.5 of the W1执行浪潮). 国家机器,类型,和无常的卫兵 船今天; 完全完成运行 地在波7b [w1 执行波计划](https://npmcn.com/package/docs/architecture/w1-implementation-wave-plan.md)。 。 。 .

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

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

部分 [代理原始产品](https://npmcn.com/package/README.md) ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.

## 今天的什么战舰

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

-   **`FulfillmentCase` 类型 + 生命周期状态机器** - 13个国家`drafted` ...... ...... ..... `archived` 编号 : `canceled` 编号 : `disputed`与 `canTransition` 执法优势。 注:过渡只检查形状;演员授权为波工作.
-   **A2A 对 `Task` 状态机器** —— 说 `canTaskTransition` 数据,包括 `auth-required` 等待新授权的任务暂停循环 .
-   **`HandoffPolicy` 类型+ `isHandoffAllowed`** ——键入权限约束交叉代理交接. 今天的检查只涵盖代理/类许可名单; `requiresUserApproval`, (中文(简体) ), `preservePrivacyTier`, (中文(简体) ), `allowedScopes`,以及 `maxHopCount` 执法是波浪工作(公开追踪为NEW-FLF-1) [调查结果分类账](https://npmcn.com/package/docs/audits/findings.yaml)) (中文(简体) ).
-   **`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区](https://npmcn.com/package/specs/336-intent-engagement-profile.md):** 只有在理解了意图、可接受的签名后,才创建任务 `FulfillmentOffer` 任务已经存在,而且没有到期——从不直接与发现匹配。 执行过渡作为明确的打字命令(出价摘要+接受摘要+任务陈述+一能键)而来,结束 `FulfillmentReceipt` 以摘要的形式约束意图、提议、任务、任务和结果——重新定向不是接收,也不是成功的民意调查.
-   **谷歌AP2和x402** 授权代理人支付;a `FulfillmentCase` 将这些任务与它们支付的任务挂钩(`ContextBinding.taskId`, FLF-INV-11),所以机器付款从不从它所安排的工作中不流出.
-   不同组合:任务执行、交割权、付款约束和成果证据 **一个** 委托 + 保管 + 审计底盘 – 缝合堆失去线条的接合正是第10-12层设计要持有的.

**权威规格 :** [spec 244——实现](https://npmcn.com/package/specs/244-fulfillment.md) (见 [`spec.md`](https://npmcn.com/package/%40agenticprimitives/fulfillment/spec.md)) (中文(简体) ). 拥有脊柱地层 10-12;地表 `CLAUDE.md` 财务报告和审定财务报表 `capability.manifest.json`。 。 。 .

## 构建

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

## 状态——诚实版

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

## 常见问题

### @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 和提交记录判断。