@ agenticprimities/ 代理关系
部分 代理先导 ——代理应用程序的开源信任底板:可以签名的身份,行为时间检查权限,所有者携带的证据. 开发者工具包 • 妇女 所有软件包
警告——不要用于保密边缘.
此软件包写出信任- 配置边框图 公开上市。 。 。 . 每一个边缘——它的终点、类型、角色设置和地位——都可以看到 任何人看链子,永远。 没有连锁保密 联 合 国 存在边缘的事实。 。 。 .
这意味着这个包裹 结构不兼容 带有使用大小写 带来保密要求:财务对手图表, 医疗转诊网络、国家残疾管理局下的B2B伙伴关系, 家庭/家庭成员,或任何“谁与谁有关” 其中连接本身是秘密。 这个
metadata-hash字段 锚离链JSON但不能隐藏边缘的存在或 其终点的特性.每个边缘的具体公众接触量:
subject地址:,object地址:,relationshipType(例如:.HAS_MEMBER, (中文(简体) ),HAS_GOVERNANCE_OVER),角色设置 在每一边,EdgeStatus寿命周期(拟议/确认/活动/取消), 和每个州过渡的演员地址.私人链接——包括每个人的\\ org链接,属于
related-agents(持有者-居民金库证书, AR-0025 (英语)) (中文(简体) ). 未来 v2 私有尖端变体(基于承诺,带有 有选择性的披露证据)将与这个包裹并存. 直到它结束 船舶, 要求保密的收养人不应使用此方法 软件包 并且应该保持他们的关系图 在脱链 存储带有明确的访问控制.追踪为 隐私叉 (审计)
PKG-agent-relationships-001编号 :EXT-019) (中文(简体) ).capability.manifest.json套装"stability": "experimental"。 。 。 .
地址之间的信任图,而不是某人数据库中的账户. 随着特工们承担了真正的工作,问题从"这名特工是谁?"转移到"谁站在它的后面——它是谁的成员,谁管理它,谁担保它?". 大多数系统都用供应商数据库中的行进行回答,当供应商这样做时,这些行就会消失。 此软件包在Cononic Smart Agent地址之间以链上边缘回答: a Edge 是一个 (subject, object, relationshipType) 每边各设置一个角色,一个状态生命周期(PROPOSED → CONFIRMED → ACTIVE → REVOKED以决定性内容散列为主的可选链外元数据。 因为终点是犬类特征本身(ADR-0010 (英语)),边缘能活过证书旋转,名称变化,以及所有其他面相交换.
部分 代理原始产品 ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.
何处 agent-naming 决定 名称-地址 财务报告和审定财务报表 agent-profile 拥有 配置图层此软件包拥有 关系层:org会员的公开图表,治理主张,伙伴关系,以及验证信任其他层组成反对.
图层 : 发现——信任 图表 (不是犬科特征——即:
agent-account) (中文(简体) ). 条形键 : 聪明的特工地址 边缘连接锚;边缘是 没有 代表团.
安装
工作空间- 内置代理主机单列; 尚未发布 .
使用量
边缘ID 衍生(纯)
import {
computeEdgeId,
RELATIONSHIP_TYPE,
} from '@agenticprimitives/agent-relationships';
const id = computeEdgeId(
'0x1111…1111', // subject
'0x2222…2222', // object
RELATIONSHIP_TYPE.HAS_MEMBER, // type (bytes32 hash)
);
// 0x… — keccak256 of packed (subject || object || typeId)
同样的三相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 非对称类型的方向事项( :HAS_MEMBER(A→B) ≠ HAS_MEMBER(B→A))),并拒绝自来水.
关系类型+角色分类
import {
RELATIONSHIP_TYPE,
ROLE,
TYPE_SEMANTICS,
} from '@agenticprimitives/agent-relationships/taxonomy';
RELATIONSHIP_TYPE.HAS_MEMBER; // bytes32 — keccak256("HAS_MEMBER")
RELATIONSHIP_TYPE.PARTNERSHIP; // bytes32 — symmetric
RELATIONSHIP_TYPE.HAS_GOVERNANCE_OVER; // bytes32 — hierarchical
ROLE.BOARD_MEMBER; // bytes32 — keccak256("BOARD_MEMBER")
ROLE.TREASURER; // bytes32
TYPE_SEMANTICS[RELATIONSHIP_TYPE.PARTNERSHIP].symmetric; // true
TYPE_SEMANTICS[RELATIONSHIP_TYPE.HAS_GOVERNANCE_OVER].hierarchical; // true
NAMESPACE_CONTAINS 实值 故意缺席 ——命名等级存在于 agent-naming 通过父指针 ADR-0006 (韩语),所以没有平行的权威可以漂移.
关系客户端(第二阶段+)
import {
AgentRelationshipsClient,
RELATIONSHIP_TYPE,
ROLE,
} from '@agenticprimitives/agent-relationships';
const rel = new AgentRelationshipsClient({
rpcUrl: 'https://base-sepolia.g.alchemy.com/v2/…',
chainId: 84532,
});
// Read (Phase 2+)
const edges = await rel.listEdgesFor('0x…', { relationshipType: RELATIONSHIP_TYPE.HAS_MEMBER });
// Write (Phase 4+)
await rel.proposeEdge({
subject: '0xAlice…',
object: '0xAcme…',
relationshipType: RELATIONSHIP_TYPE.HAS_MEMBER,
subjectRoles: [ROLE.BOARD_MEMBER],
});
await rel.confirmEdge({ edgeId: '0x…', selfRoles: [] });
每种写作都通过演员的"智能特工"(Smart Agent ERC-1271 → 它的"保管政策"模块)授权. 关系包本身保持监护-不可知(否) @agenticprimitives/account-custody 导入).
怎么不一样
竞争类别是 社会/信任图产品和登记“认可”特征 —— 应用数据库中保存的跟随者边缘, 证明列表, org 图表 :
- 双边建筑. 非对称的边缘需要双方确认才能影响任何东西(第3阶段+合同执行);a
PROPOSED边缘是权利要求,而不是事实。 任何一方均可单方面、不经许可地撤销. - 边缘连接身份,而不是手柄. 两个端点都是Canonic Smart Agent地址,因此图不能被更名的手柄或旋转的密钥所孤.
- 边缘不是权威.
HAS_GOVERNANCE_OVER声称有关系,但没有任何好处。 权力总是一种授权或一种监护政策行动——单独的原始人,单独的包裹. 图形产品通常会模糊这条线;这里的包边让模糊变得不可能.
子路径导出
@agenticprimitives/agent-relationships/taxonomy——关系类型+角色常数+语义图.
安全变化因素
- 边缘标识是 决定性 —— 说
keccak256(subject || object || relationshipType);脱链和链上衍生物总是相匹配. computeEdgeId拒绝自攻(subject qq对象).- 关系类型+角色ID是
keccak256(name)(比例)keccak256(bytes(name)))——字节32 hashes,不是生弦,可以防止跨名空间相撞. - 非对称类型(第3阶段+合同执行)的双侧确认.
- 任何一方的许可撤销(第3阶段+).
- 保管-不可知——权威总是通过演员的"智能特工"ERC-1271来通路.
NAMESPACE_CONTAINS故意缺席(ADR-0006).
见 AUDIT.md 组合审计+开放式审计结果.
状态
实验和第一阶段 ——纯SDK + spec + API骨架. 纯层computeEdgeId,分类学,语义图)是真实的并经过测试的;客户端读取方法抛出 R Phase 2 并投掷写法 R Phase 4 - 设计上的根 合同(AgentRelationship.sol + 键 RelationshipTypeRegistry.sol第三阶段的土地. AgentAssertion (签名-索赔层)和 AgentRelationshipResolver (政策层)推迟至v2 ADR-0007 (英语). 全面设计+阶段计划: specs/216-agent-relationships.md。 。 。 .
包件阶段以外:仅测试网/飞行员准备状态;生产发射在根部的公开核对表上加门 README.md追踪所有安全发现 docs/audits/findings.yaml ——在通过前重读上层的保密警告.
许可证
UNLICENSED(内部单列,未出版).