# @agenticprimitives/admission 中文文档

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

版本：0\.0\.0-alpha\.21
npm 元数据更新时间：2026-10-26T11:06:18.743Z
中文译文更新时间：2026-11-06T11:11:26.988Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：220 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：@agenticprimitives/types ^1\.0\.0-alpha\.45
- 首次发布：2026-08-03T02:53:07.589Z
- 最新版本发布：2026-10-26T11:06:17.842Z
- 近 30 天下载量：3407（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

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

## 安装

```sh
npm install @agenticprimitives/admission
```

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

## README

# @ agenticprimitives/ 承认

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

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

**记录建筑师:** [第339区](https://github.com/agentictrustlabs/agenticprimitives/blob/master/specs/339-agentic-primitives-edge-https-admission.md) • 妇女 [ADR-0057 (英语)](https://github.com/agentictrustlabs/agenticprimitives/blob/master/docs/architecture/decisions/0057-a2a-over-https-admission-mtls-optional.md)

```text
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不是一个 代理, 补助金不是工具许可 。 这些人在审查中幸存下来,然后在实施过程中死亡,因为 错误永远不会像一个:

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

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

```ts
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`。 。 。 .

## 安装

```bash
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 是什么？

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