packs.list模块 25Signed pack registry
从外部引入一个由智能体、授权和演练组成的包,并知道是谁签署的,以及途中是否有任何字节被更改。
packs.list 是包注册表。它列出内置的 Parley 和演练包,以及您注册的 yard/0 包。register 检查包由谁签署、达到什么符合度等级,然后登记其智能体并写入其授权,否则拒绝并且不存储任何内容。
packs.list模块 25从外部引入一个由智能体、授权和演练组成的包,并知道是谁签署的,以及途中是否有任何字节被更改。
packs.list 是包注册表。它列出内置的 Parley 和演练包,以及您注册的 yard/0 包。register 检查包由谁签署、达到什么符合度等级,然后登记其智能体并写入其授权,否则拒绝并且不存储任何内容。
packsid、title 和 kind:parley、drill 或 yard。provenanceverify 返回包的来源、在当前策略下是否会激活、一次符合度运行及其 digest。不存储任何内容。
policy 读取或设置 requireVerified、requireVerifiedAuthor 和 。全新的平面没有作者密钥,因此默认值沿用较早的行为:接受未签名的包。
点击运行,将左侧的请求发送到共享演示工作区。
在共享的演示工作区中使用演示密钥运行:任何人都可以看到其中的内容,因此请勿发送任何私密信息。
一个符合 API 接受格式的请求,以及模块返回格式的示例响应。
GET /api/v1/acp/packs/list Authorization: Bearer av_workspace_•••• → 200 { packs }
通过 git 或附件到达的包会下发权限。verify 告诉您是谁签署的,如果签名不成立,register 会拒绝它。
设置 requireVerifiedAuthor,然后信任一个密钥并对其运行 verify-author。来自其他密钥或没有密钥的包将不再激活。
用 canary: true 注册。列车暴露包中一部分智能体;每次推进后 会扩大被授予的范围,被回退的列车会收回授权。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
tampered,任何策略设置都不能让它激活。pack:<id>/<action>/<principal>/<resource>,所以授权修订不会把其中之一当作自己的。parley 和 drill 条目是内置的。只有 yard 包通过 API 注册,并以 yard/0 文档的形式到达。
对不含自身 sig 块、也不含注册表所添加来源信息的包做分离的 Ed25519 签名,因此已存储的包仍能摘要为其被签署时的字节。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/packs/list列出内置和已注册的包。/api/v1/acp/packs/get按 id 读取一个包。verified、unsigned、untrusted-key、tampered 或 malformed,并附声称的作者和密钥 id。conformanceyard/0 套件的一次运行:level 为 none、structural、governed 或 portable,以及其背后的 checks。badgenull,此时 badgeReason 会说明。activatedenrolled 的智能体、applied 的授权、被裁决扣住的 withheld 授权,以及排队的 drills。canarycanary: true,并可附带 cohortPercent、cohortAgents、cohortWorkspaces、gate 和 rolloutSteps,以安排一列列车。minimumLevelrequireVerifiedAuthorminimumLevelregister 记录来源,执行策略,检查证明和符合度,在绑定了密钥时签发徽章,然后激活。被拒绝的包不会被存储。
发送 canary: true 以安排变更列车,而不是立即激活。列车推进后,sync 为它现在暴露的智能体登记并授权。
{
"packs": [
{
"id": "pack_frt",
"title": "First three FRT scenarios",
"kind": "drill"
},
{
"v": "yard/0",
"id": "yard_payments",
"title": "Payments review yard",
"kind": "yard",
"agents": [
{
"did": "did:web:acme.example:agent:reviewer",
"role": "reviewer"
}
],
"grants": [
{
"principal": "did:web:acme.example:agent:reviewer",
"action": "read",
"resource": "repo:payments"
}
]
}
]
}syncbadge 运行套件并对结果签名。badge-verify 对照现状检查任何人的徽章,因此过期的徽章会失败。
mandates.compile 编写授权;包用于随身携带的整套内容。change-trains.list;只有包会自动为您注册进列车。pack-revenue.balances 中,与注册表分开。badge-verify 检查。yard/0 文档;导入契约是另外的。trust 承认一个密钥,需要 keys.create。它不能验证作者。untrust 需要 keys.revoke,已注册的包保留它们原有的来源。
register 还会把包的构建证明作为传递而来的 detector-pack 检查;声称由平面构建的包会被拒绝。见 attestation.policy。
register、policy 写入和 badge 需要 policies.approve。列出、获取、verify 和 conformance 不需要。
PACK_BADGE_SIGNING_KEY 才会签发徽章。没有它,register 仍会成功并返回 badge: null 及 badgeReason。stored 会说明是否已存储。sync 只对用 canary: true 注册的包有效;其他包返回 400。minimumLevel 的包会被以 403 拒绝,并列出未通过的检查。/api/v1/acp/packs/registeryard/0 包,或拒绝它。/api/v1/acp/packs/verify报告注册会做什么,不存储任何内容。/api/v1/acp/packs/conformance对一个包或已注册的 id 运行 yard/0 套件。/api/v1/acp/packs/policy读取或设置注册门槛。/api/v1/acp/packs/sync把金丝雀包的授权应用到其列车现在暴露的智能体。coordination.packs.list从智能体列出注册表。coordination.packs.get从智能体读取一个包。coordination.packs.register从智能体注册一个 yard/0 包。change-trains.list24