@agenticprimitives/witness

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

证据纠纷证明(Spec 307/G-11):确定走关系记录+核实收据并证明为 scope/出 scope/已撤销 执行前/stale status 已使用/不充分 证据. 事实,永远不要补救.

中文使用文档

@ 代理人/证人

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

证据纠纷证明 ——中性功能,仅取自文物: 这一行动是在事件发生时授权的关系范围内进行的,如果不是,则由谁负责 检查失败 ?

谱: specs/307-witness.md 消费: 核查收据(第303项) + 键 关系记录(第306项)。 。 。 .

走路时

import { evaluateDispute, mintWitnessAttestation } from '@agenticprimitives/witness';

const evaluation = await evaluateDispute({
  record,            // the spec-306 hash-linked evidence chain
  receipt,           // the disputed spec-303 public receipt
  detail,            // optional — released to the witness via releaseMode 'witness_escrow'
  verifyReceiptSignature,
});
// → { outcome: 'in_scope' | 'out_of_scope' | 'revoked_before_execution'
//              | 'stale_status_used' | 'insufficient_evidence', ... }

const attestation = await mintWitnessAttestation(
  { witness: witnessSa, relationshipId, evaluation, receipt, checkedDetail: !!detail, attestedAt },
  { sign: witnessSigner },
);

徒步走着 总计和订购 (证据完整性 ) 记录会员资格 ——撤销时间表 —— 因此,两个证人 给予同样的文物 产生相同的结果和结果 证相散相. 任何无法核实的东西——断开的链条,无效的收据,不是收据 记录的一个条目,一个不开放的细节——是 insufficient_evidence从来没有猜测.

stale_status_used 是负载结果: 撤销项在收件之前 关系记录,然而允许的验证器 revocation: 'active' - 核查员依赖 停顿状态,这正是引发该条采购清单所指定的责任.

状态

w1-evaluate-attest - 步行+证明薄荷/验证,8个测试套房(每个结果一个, 决断主义,篡改主义,无身份外出. W2: 证明锚+证人-证人 解密Grant发布路径. W3:G-12对这些结果的责任计划.

版本与发布记录

@agenticprimitives/witness 共发布 30 个版本,首次发布于 2026/07/14;过去 12 个月发布了 30 个版本。

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

关于 @agenticprimitives/witness 的常见问题

@agenticprimitives/witness 是什么?

证据纠纷证明(Spec 307/G-11):确定走关系记录+核实收据并证明为 scope/出 scope/已撤销 执行前/stale status 已使用/不充分 证据. 事实,永远不要补救.

如何安装 @agenticprimitives/witness?

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

@agenticprimitives/witness 支持 TypeScript 吗?

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

@agenticprimitives/witness 支持 ESM 还是 CommonJS?

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

@agenticprimitives/witness 可以商用吗?

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

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

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

@agenticprimitives/witness 还在维护吗?

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