@agenticprimitives/coordination

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

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

中文使用文档
文档目录6 节
  1. 安装
  2. 型号
  3. 使用量
  4. 变量(第332类第6和9节)
  5. 边界
  6. 光谱

@ agenicprimitives/ 协调

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

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

安装

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 - 提议, 选择和参与者 签名 验收。 承诺对 确切的计划订正 散列轴;一种被否决的大麻.

使用量

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 • 妇女 ADR-0054 (英语) · 黄金固定装置 内 test/fixtures/。 。 。 .

版本与发布记录

@agenticprimitives/coordination 共发布 28 个版本,首次发布于 2026/07/22;过去 12 个月发布了 28 个版本。

版本发布日期距今
0.0.0-alpha.29latest2026/10/2612 天前
0.0.0-alpha.282026/10/2612 天前
0.0.0-alpha.272026/10/1721 天前
0.0.0-alpha.262026/10/1722 天前
0.0.0-alpha.252026/10/1622 天前
0.0.0-alpha.242026/10/1622 天前

关于 @agenticprimitives/coordination 的常见问题

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