@agenticprimitives/admission

中文文档
0.0.0-alpha.21发布于 2026/10/26MITTypeScriptES Module零依赖近 30 天下载 3407

Agentic Primitives Edge 招生合同:运输证据,应用认证,犬科演员决议,招生补助,以及确切的MCP引用授权. 零运行时间依赖性;录取从来不是权威.

中文使用文档
文档目录6 节
  1. 这是什么
  2. 为何不变量是密码
  3. 零运行时间依赖关系
  4. 安装
  5. 证书演示文稿和 HTTP 签名
  6. 参考文献

@ agenticprimitives/ 承认

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

Agentic Primitives Edge的准入合同——外部代理意图之间的界限 和内部代理能力.

记录建筑师: 第339区 • 妇女 ADR-0057 (英语)

HTTPS is required.
mTLS is optional.
Application-level identity resolution and Admission are always required.

这是什么

四个必须分开的问题,四个形状不能相取而代之:

问题形状
运输证明什么了?OptionalTransportEvidence - 一个人永远不够
什么证明是来电的?OAuthEvidence 编号 : RequestProofEvidence
打电话的人是谁?CanonicalActorContext - 解决了,从未索赔
他们能做什么?AdmissionRequest → AdmissionDecision → AdmissionGrant

加号 ExactMcpInvocationRequest 对私人网关的补助金进行重新核实 辩论和现场代表团.

为何不变量是密码

该建筑的主张都是"X不是Y"——一个证书不是所有者,一个SPIFFE ID不是一个 代理, 补助金不是工具许可 。 这些人在审查中幸存下来,然后在实施过程中死亡,因为 错误永远不会像一个:

if (req.transport.mtls) { /* trusted peer */ }   // a real handshake; a wrong conclusion

一种类型无法捕捉到.. mtls: true 是一个完美的布尔。 所以说:

import { checkAdmissionInvariants } from '@agenticprimitives/admission';

const violations = checkAdmissionInvariants(request);
// mTLS-only, no token → OAUTH_TOKEN_REQUIRED
//   "a TLS connection, mutual or not, authenticates no principal"

[] 意味着请求足够一致的评估. 没错 没有 意思是承认——关系, 授权、能力、权利和政策都处于前列,没有人住在这里.

零运行时间依赖关系

没有viem,没有供应商SDK,没有SPIFFE,没有运输. 任何需要I/O的都是端口,而不是进口. 由 pnpm check:optional-package-boundaries。 。 。 .

安装

pnpm add @agenticprimitives/admission

麻省理工学院.

证书演示文稿和 HTTP 签名

credentialPresentationEvaluator (单位:千美元)CREDENTIAL_PRESENTATION_CONTRIBUTOR)承认零知识证书 作为证据在门口出示:判决书上标出发行人方位、上游摘要、失效等级和 状态序列, 并给予任何. verifyHttpSignature (单位:千美元)HTTP_SIGNATURE_CONTRIBUTOR, RFC 9421 记录了 HTTP 电文签名作为运输证据——从不认证,从不授权.

参考文献

代理身份是ERC-4337账户,而不是名字. principalAgentId, (中文(简体) ), actingAgentId 财务报告和审定财务报表 targetAgentId cAIP- 10 编号 决议至20字节地址(ADR-0010)。 作者使用的光谱 339 urn:ap:agent:…; 此处拒绝, 因为一个URN 是一个命名空间操作员可以重新指定的名称. runtimeId 豁免:部署不是账户. agentAddressOf 剖析; 它永远不会解决一个名字 .

没有 edge-runtime。 。 。 . edge-runtime 询问入侵问题(路线、标题、身体大小、虐待限制) 云花形;其类型为 EdgeIngressRequest。这个包问语义的, 和峡谷的 AdmissionRequest 住在这里。 两个词都有一个词是 路由检查最终如何 站在一个权威的决定.

mTLS是可选的,有三个含义相隔. createTransportAssuranceEvaluator 是唯一一个可以运输的地方 影响决定:没有证书是正常的(没有规则意味着ALLOW); minimumAssurance 栏下否认 (单位:千美元)MTLS_REQUIRED_FOR_PROFILE - 需要mTLS是政策,从不运输自行决定; preferredAssurance 与 constraintsBelowPreferred 缩入。 证书只能提高栏;测试表明它不能翻转另一个栏 评估员DENY 进入ADMIT。 证据来自 edge-cloudflare.transportEvidenceFromRequest; 测量级别 与 observedTransportAssurance从没有自报的标签.

布局图. src/types.ts 持有合同, 每人评论 倒闭 它的形状防止. src/ports.ts 拿着 注入接口和唯一的两个扩展点,都指向内. src/invariants.ts 拿着 不等同于代码,因为类型无法捕获 if (mtls) { trusted }。 。 。 .

声称这个包裹可以检查. 运输证据从来不是应用程序认证 (单位:千美元)hasApplicationAuthentication) (中文(简体) ). 保证是经过验证的,而不是声称的。 工作量标识符不是 代理; 绑定必须存在并具有活性. 赠款是一扇门,而不是一扇钥匙checkInvocationAgainstGrant 拒绝援引 (无代表团参加)。 空能力天花板是一无所有 RFC 9421 HTTP 签名只是运输证据 (单位:千美元)verifyHttpSignature → optionalTransportEvidence.httpSignature, spec 442 §6 : 键为解析器端口,不变量 集与无相同 tag: payment 不给任何东西.

版本与发布记录

@agenticprimitives/admission 共发布 21 个版本,首次发布于 2026/08/03;过去 12 个月发布了 21 个版本。

版本发布日期距今
0.0.0-alpha.21latest2026/10/2612 天前
0.0.0-alpha.202026/10/1722 天前
0.0.0-alpha.192026/10/1622 天前
0.0.0-alpha.182026/10/1622 天前
0.0.0-alpha.172026/10/1622 天前
0.0.0-alpha.162026/10/1622 天前

关于 @agenticprimitives/admission 的常见问题

@agenticprimitives/admission 是什么?

Agentic Primitives Edge 招生合同:运输证据,应用认证,犬科演员决议,招生补助,以及确切的MCP引用授权. 零运行时间依赖性;录取从来不是权威.

如何安装 @agenticprimitives/admission?

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

@agenticprimitives/admission 支持 TypeScript 吗?

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

@agenticprimitives/admission 支持 ESM 还是 CommonJS?

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

@agenticprimitives/admission 可以商用吗?

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

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

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

@agenticprimitives/admission 还在维护吗?

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