@ agenticprimitives/ home (英语)
部分 代理先导 ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. 开发者工具包 • 妇女 所有软件包
可移植 代理信任之家 合同(第310区: 计划 失效验证器 以及个人/org背后的决定性预测 信托控制平面——一个经纪人的老板以他们的名义审查一切行为的地方.
A Home服务于五个表面: 身份登记, (中文(简体) ), 连接的应用程序, (中文(简体) ), 管理代理人, (中文(简体) ),
授权审查,则 代理收件箱。此软件包定义了“家” 发表
生成;其中没有路线,UI,品牌,或部署细节(ADR-0021). 这个
参考文献 家用应用程序是 demo-sso-next (第234页).
两个学说点决定了这里的一切:
- 家是个面孔,不是身份 (ADR-0010/0011) (英语). 智能特工地址从不 当一个家庭被添加、旋转或贬值时,会有所改变.
- 家是权威的产物 永远不要薄荷. 核准/拒绝/签发/撤销路线
delegation编号 :entitlements/ 保管包; 此包只携带AuthorityRef指着他们的文物.
表面
| 导出 | 这是什么 |
|---|---|
HomeManifestV1 | 已签名、可移植的发现文件:端点、表面、能力、收件夹、有效性窗口 |
validateHomeManifest 编号 : isManifestCurrent | 无法关闭的结构 + 货币门; 未签名/ 过期/ 暂停 + 不信任 |
ManifestVerificationPort | 密码验证港(SA/运营商-委托代理)——由消费者接线 |
HomeInboxBindingV1 | 活动 Pub 形状的收件箱/出件箱声明: 支持的消息/交互类型, 加密 + 交付配置 |
HomeActionCardV1 + 键 validateHomeActionCard 编号 : resolveCardAction | 申报批准卡(交一半);仅申报 allowedActions 解析 - 未知动作qq null 拒绝 |
ManagedAgentEntryV1 | "你管理的人"控制台行:类型、关系、控制级别、状态、动作 |
ConnectedAppGrantV1 | 连接依赖应用程序行; grantRef 代表代表团 |
HomeControlEventV1 | 持久审计支持的控制飞机时间表行 |
projectHomeInboxSummary | 纯决定性的仪表盘计数完毕 messaging + 键 interactions 预测 |
使用量
import {
isManifestCurrent,
resolveCardAction,
projectHomeInboxSummary,
} from '@agenticprimitives/home';
// Trust gate before using any Home endpoint (reachable ≠ trusted):
if (!isManifestCurrent(manifest, new Date().toISOString())) throw new Error('untrusted home');
const ok = await verificationPort.verifyManifestProof(manifest); // consumer-wired crypto
// Card response handling — unknown actions are rejections, never defaults:
const action = resolveCardAction(card, submittedActionId);
if (!action) return reject('action_not_allowed');
// action.transition feeds the interactions state machine; it grants nothing.
// Dashboard badge:
const summary = projectHomeInboxSummary({ items, cases, runs });
// summary.attentionCount = pending approvals + paused runs
边界
进口 types, (中文(简体) ), vault, (中文(简体) ), messaging, (中文(简体) ), interactions (类型/仅保留). 不得导入
a2a, (中文(简体) ), mcp-runtime, (中文(简体) ), agent-account, Next.js, React, 或任何特定主机. 状态 :
w1-contracts ——在参考应用中公开发布并登陆收件箱/主机页
(光谱310 W2–W5).