# @agenticprimitives/coordination 中文文档

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

版本：0\.0\.0-alpha\.29
npm 元数据更新时间：2026-10-26T11:48:39.790Z
中文译文更新时间：2026-11-06T08:30:10.851Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：300 kB，100 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-07-22T01:53:14.273Z
- 最新版本发布：2026-10-26T11:48:39.188Z
- 近 30 天下载量：3832（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

协调核心:努力、成果说明、协调计划、参与——第332W1项.

## 安装

```sh
npm install @agenticprimitives/coordination
```

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

## README

# @ agenicprimitives/ 协调

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

这个 **努力** 协调核心(第332段,第1波):持久、共享、多主协调 对象 - _有人张贴了请求;该小组将请求作为一项目标;提出了一项共同计划并作了修订, 参与者得到分配和承诺;根据计划步骤开展工作;结果 已验证_ ——被表述为纯正的,决定性的,事件源的机器.

## 安装

```bash
pnpm add @agenticprimitives/coordination
```

子路径导出 : `.` (每件事物), `./core` (记录、命令、事件、减少器、出处输入), `./planning` (计划、步骤、边缘、里程碑、内容散列、循环), `./participation` (参与、提议、分配、签署承诺). `./profiles`, (中文(简体) ), `./decisions`,以及 `./projections` 其实际含量为333/334分贝的预留根.

## 型号

-   **`EndeavorRequestV1`** ——收养前有条理地录取(`ereq_` 页:1 任何切入点( Home) 请求、讨论请求、收件箱询问、A2A意图)生成相同的请求并驱动相同的 机制.
-   **`EndeavorV1`** - 持久的多主要情况`end_` (d) 追求 `OutcomeSpecificationV1` (可观察的成功标准,已版本).
-   **`CoordinationPlanV1`** - 持久 _共享_ 计划(`p-plan:Plan` 着陆). 订正为: 不可改变; `planContentHash` 实值 `sha256(JCS(steps + edges + milestones))`;收养是明确的 最多一次通过一个修订.
-   **`EndeavorParticipationV1`** ——参与者与努力的关系(作用+范围+) (b) 通过邀请/接受或分配/承诺主张有效.
-   **`ContributionProposalV1` → `AllocationDecisionV1` → `ContributionCommitmentV1`** - 提议, 选择和参与者 _签名_ 验收。 承诺对 **确切的计划订正 散列轴**;一种被否决的大麻.

## 使用量

```ts
import {
  initialCoordinationState,
  validateCoordinationCommand,
  applyCoordinationEvent,
  deriveProvenanceInputs,
} from '@agenticprimitives/coordination/core';

let state = initialCoordinationState();
const result = validateCoordinationCommand(state, {
  kind: 'SubmitEndeavorRequest',
  actor: requesterAddress,
  issuedAt: new Date().toISOString(),
  requestId: 'ereq_1',
  targetPrincipal: orgAddress,
  goal: 'Produce the Q3 treasury report',
  entryPoint: 'home-request',
});
if (!result.ok) throw new Error(result.reason);
for (const event of result.events) state = applyCoordinationEvent(state, event);
```

`validateCoordinationCommand` 拒绝附件前( 无法关闭) , 并返回事件持续存在 ; `applyCoordinationEvent` 是一个执行单调修改的纯还原器。 重放事件日志 总是复制国家; `deriveProvenanceInputs(events)` 产生一个结构摘要(实体, 活动、代理人、, `correspondsToStep` a P-Plan/PROV预测可以消耗.

## 变量(第332类第6和9节)

1.  **分配从来不是权威.** 没有门读出一个 `apcoord:` 记录; `capable / available / allocated / committed / authorized / performing / satisfied` 是七个不同的事实.
2.  **承诺签署** 由参与者反对通过的确切计划修订散列.
3.  **对话从不改变状态.** 只有签名的命令产生事件; `PlanRejected` 这是 计划提案只有死路一条;未知的命令类型被拒绝失败关闭.
4.  **一个机制** (ADR-0013):减员是唯一的国家-过渡路径.
5.  **决定:** id和时间戳来自命令/事件,从不来自还原器.

## 边界

取决于 `@agenticprimitives/types`, (中文(简体) ), `@agenticprimitives/situations` (实体参考书,有效性,JCS)和 `@agenticprimitives/ontology` (单位:千美元)`apcoord:` 国际法学会)。 绝不进口织物/家用/a2a/委托/断层- 这些层层消耗了协调。 销售商适配器(Linear、Jira、Temporal、LangGraph、.) 外部重置; 仅 `ExternalObjectBindingV1` (适配器合同表面) 船只在这里.

## 光谱

[`specs/332-coordination-endeavor-core.md`](https://npmcn.com/package/specs/332-coordination-endeavor-core.md) • 妇女 [ADR-0054 (英语)](https://npmcn.com/package/docs/architecture/decisions/0054-coordination-endeavor-doctrine.md) · 黄金固定装置 内 `test/fixtures/`。 。 。 .

## 常见问题

### @agenticprimitives/coordination 是什么？

协调核心:努力、成果说明、协调计划、参与——第332W1项\.

### 如何安装 @agenticprimitives/coordination？

在项目目录运行 npm install @agenticprimitives/coordination，或使用 pnpm add / yarn add / bun add。

### @agenticprimitives/coordination 支持 TypeScript 吗？

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

### @agenticprimitives/coordination 支持 ESM 还是 CommonJS？

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

### @agenticprimitives/coordination 可以商用吗？

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

### @agenticprimitives/coordination 的下载量有多少？

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

### @agenticprimitives/coordination 还在维护吗？

最新版本 0\.0\.0-alpha\.29 发布于 2026/10/26（12 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 28 个；首次发布于 2026/07/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。