@action-state-group/agent-action-capsule

中文文档
0.14.0发布于 2026/11/05BSD-3-ClauseTypeScriptES Module零依赖构建来源已验证近 30 天下载 4410

Agent Action Capsule 格式 4 的文本引用

中文使用文档

代理动作封面类型Script 引用

此软件包是符合 Python 权威的记录格式引用 在此仓库中。 它执行严格的JSON/JCS,格式4 Capsule IDs 类型1和 references[] 核查、登记册、, 制片人封口,并通过DE-3披露封口. 这是故意的 不包含 Capsule 生产者动词、 CLL 存储、 策略、 适配器或 permalink运输.

对只记录的消费者,使用所支持的 @action-state-group/agent-action-capsule/core 输入。 它输出现有的JSON/身份,打出Capsule型号,Class-1/store, 注册、 披露信封和生产者信封 API 不装入 Bundle, CLL或演示文稿模块. 内容 browser 条件不包括节点签名/密钥 创建,同时保留 WebCrypto 信封校验.

import { verifyClass1 } from "@action-state-group/agent-action-capsule/core";
const result = await verifyClass1(capsule);

CLL 是一个可选的对等点, 因此干净的生产安装不会安装 CLL或它的存储驱动程序. 用于 @action-state-group/agent-action-capsule/bundle 或现有宽根条目,明确安装被绑定的相容 CLL:

npm install @action-state-group/agent-action-capsule @action-state-group/[email protected]

verifyBundle(bundle, { strict: true }) 增加严格检查 vectors/bundle/strict/README.md (单位:千美元) 判决(result.strict.verdict数字 : VALID, (中文(简体) ), INCOMPLETE 或者说 INVALID) (中文(简体) ). 过 requireSignature 未签名的记录和 witnessDirectory (a) 分析 witnesses.json检查证人的收据 checkpoint.witnesses; 无 被信任没有它。 CLL的COSE检查站核查员 验证签名 在节点和浏览器的检查点.

verificationBanner(context, stamps) 宣布判决为 页面中,有一个州 spec/verification-display-v0.md 节 6.2; 2; bundleVerified 是它的门(第1节) buildVerificationPageModel 财务报告和审定财务报表 verificationCheckLists 给出其他验证页。 此软件包不绘制页面: 胶囊查看器 (单位:千美元)action-state-group/capsule-viewer, (中文(简体) ), ts/src/evidence-graph-view.ts 从这个模型中抽取。 旗帜的 state 实值 verified 仅为 valid 判决,否则 incomplete 或者说 failed; 页面显示 checking 直到检查结束 unable 当它 根本没有SHA-256UNABLE_TO_VERIFY_LINES) (中文(简体) ). 每个州都有一条固定的线 (单位:千美元)VERIFICATION_BANNER_LINES被钉住的每个观众 vectors/viewer-core-text/),没有 模块、措辞包或捆绑提供. verdict 实值 valid, (中文(简体) ), incomplete 或者说 invalid,以及 checkpoint 实值 verified, (中文(简体) ), unverified, (中文(简体) ), invalid 或者说 absent编辑 detail 页面未检查的行名或失败的行名, 和标签间隔覆盖 每个有记录的成员 checkpoint_unverified 当他们在检查站休息时 页面未认证。 没有ED25519的运行时间不严格 判决; 失踪 Ed25519 本身从来不是失败, 所以捆绑通过 页面本身的检查,每个记录绑入日志位置,读取 incomplete。浏览器用 CLL 建立检查点认证 浏览器条目, 有无WebCrypto; 使用 Ed25519 是它的旗子 节点给。 匹配这些字段的一页状态,而不是其词.

buildEvidenceBundle(source, { root, intervalFrom }) 从一个 ProofSource:该日志的签名 COSE检查站,它的叶子,记录由 Capsule 身份证, 包含和范围证明 在Bundle自己的线形。 没有 键,它用 verifyBundle(bundle, { strict: true }) 在归还之前,拒绝 BundleBuildError 任何核查者 打电话来. proofSourceFromCll(backend, records) 制作一个 ProofSource 从 CLL 后端 (scanEntries, (中文(简体) ), loadCll还有一家唱片店 get(capsuleId) 决定: capsule 财务报告和审定财务报表 producerEnvelope 字节和拒绝 与 code: "not_found" 它没有记录.

  • intervalFrom: N 将每张记录从N后移到检查站小费 n以下没有,有范围证明: Bundle 可以读取 VALID . N = 1 这是 整个日志.
  • intervalFrom: null 只携带所选记录,每个记录都有自己的记录 包含证明和状态 completeness.selection: "producer-selected"数字 : 他们之间没有记录,所以它读作INCOMPLETE.

intervalFrom 没有默认,所以一个呼叫者 从来没有交出整个日志 遗漏。 树叶上没有记录, N以下有记录 并拒绝通过检查站的记录 姓名。 缺少引文或 未署名的记录被声明,没有拒绝,并读取INCOMPLETE. buildUnprovenBundle(records, { root }) 是没有日志证明的表单,用于 无日志的盖子 . buildEvidenceBundle 需要CLL的检查站 核查器,在节点测试; buildUnprovenBundle 没有检查站,所以 它在严格的地方运行 verifyBundle 包含浏览器.

@action-state-group/agent-action-capsule/settlement 出口 verifySettlements,产生状态 draft-mih-agent-settlement-records-01 从双方的腿部记录。 这个 不需要 CLL .

@action-state-group/agent-action-capsule/witness 出口证人收据 请检查严格模式的使用, 对于一个包外的呼叫者: verifyCoseReceipt (一个DER公用钥匙下的叶字节的COSE收据), verifyReceipt, (中文(简体) ), verifyRekorReceipt, (中文(简体) ), verifyScrapiReceipt帮助目录 witnessRowFor 财务报告和审定财务报表 witnessRowKeys它不需要CLL.

现有根出口仍然可用,安装了CLL。 分开 Bundle 条目重复使用 AAC 现有的验证器和 CLL 验证操作;它确实 未引入其他执行。 开发安装包括CLL,因此 完整套装和浏览器兼容套装继续运行.

节点条目需要node.js 20或更新. 使用 browser 条件解析 WebCrypto 唯一的校验条目;它排除 保留时只使用节点的制作人信封签名和密钥创建 API verifyProducerEnvelope。 。 。 .

依赖文摘的API为Aync:等待 sha256Hex, (中文(简体) ), jsonDigest, (中文(简体) ), computeCapsuleId, (中文(简体) ), verifyClass1, (中文(简体) ), verifyStore, (中文(简体) ), verifyDisclosureEnvelope, (中文(简体) ), sealCapsule,以及 parseCapsule。 。 。 . verifyProducerEnvelope 还在两个切入点同步.

npm ci
npm run check

测试消耗了同样的承诺 蝎子下 ../vectors/。 。 。 .

释放

发布跟随寄存器 相关内容: 运行 · 准备 页:1 ts,并合并其拉动请求 ts/v<version> 标记和发送 发布 \ 发布类型脚本 就在这 工作流程检查标签对应 ts/package.json,锁文件和 承诺是在 main运行 npm ci 和完整的软件包 检查/建设,并履行 npm publish --dry-run 从上传前 npm 环境。 重运行跳过 npm 版本, 注册错误 除E404之外,其他出版物停止出版。 预发版 next ditt-tag, 以及一个比 npm 时长的稳定版本 latest 下级 backport这样 latest 永远不要往后移动.

在真正发布之前, npm 软件包所有者必须配置一个 信任的出版社 页:1 @action-state-group/agent-action-capsule: GitHub 拥有者 action-state-group, (中文(简体) ), 仓库 agent-action-capsule,工作流程文件名 publish-ts.yml,以及 直接许可 npm publish,带有环境名称 npm (任务运行) 在这种环境下。 包/镜 必须由它的所有者提供; 该工作流程不拖住所有权. 工作流程使用节点22 (QQ22.14)并安装 npm 11.19.1; 信任 出版需要npm \\ 11.5.1. 没有使用长寿npm的代号,和 可信出版用品自动出处. 包裹公开.

TS工作流程只为 ts/v* 标记: 当发布... 标记发送时 在标签上,或当一个 GitHub 释放一个 ts/v* 标签已发布, 因此 通过手上传到 npm 发布这样的发布. 被派到一个分行 什么也没做. ts/v 标签从不启动 Python/ PyPI 发布任务, 矢量 释放要分开.

对于本地的免上传预览,运行于 ts/数字 :

npm ci
npm run check
npm publish --dry-run --access public

如果 npm 已经包含该版本, 但是 GitHub 拒绝使用标签回收 工作流程令牌,拥有所需工作流程许可的维护者必须创建 ts/v<version> 在npm记录 gitHead,然后重新运行工作流程。 别 重置另一个承诺或发布一个替换的 npm 版本.

版本与发布记录

@action-state-group/agent-action-capsule 共发布 18 个版本,首次发布于 2026/10/06;过去 12 个月发布了 18 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.14.0latest2026/11/051 天前
0.13.12026/11/033 天前
0.13.02026/11/015 天前
0.12.02026/10/315 天前
0.11.02026/10/316 天前
0.10.02026/10/297 天前

关于 @action-state-group/agent-action-capsule 的常见问题

@action-state-group/agent-action-capsule 是什么?

Agent Action Capsule 格式 4 的文本引用

如何安装 @action-state-group/agent-action-capsule?

在项目目录运行 npm install @action-state-group/agent-action-capsule,或使用 pnpm add / yarn add / bun add。

@action-state-group/agent-action-capsule 支持 TypeScript 吗?

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

@action-state-group/agent-action-capsule 支持 ESM 还是 CommonJS?

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

@action-state-group/agent-action-capsule 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=20。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@action-state-group/agent-action-capsule 可以商用吗?

@action-state-group/agent-action-capsule 使用 BSD-3-Clause 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括,不构成法律意见,请以许可原文为准。

@action-state-group/agent-action-capsule 的下载量有多少?

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

@action-state-group/agent-action-capsule 还在维护吗?

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