@ agenticprimitives/ 错误授权

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

纯粹的助手,负责对金库居民的主体的权威.

这个包件连接了三个现存的原始:

• RoleAssignment 从 @agenticprimitives/organization
• VaultRecordScopeGrant 从 @agenticprimitives/delegation
• 所有者- 默认资源命名来源 @agenticprimitives/vault

它不持久、不签署、不读取链条状态、不拨打MCP/A2A,也不核查应享权利。 呼叫已经通过 证实事实为决定性的帮助者.

它拥有什么

• 主体参考文件:金库角色的内容
• 角色定义:能力加库-记录范围赠款模板
• 捐赠汇编:角色定义+主题 - > VaultRecordScopeGrant[]
• 预测:角色分配 + 定义 - > 可读赠予视图
• 授权:主动任务+实现授权+记录范围 - > 允许/拒绝

核心规则

角色指派管理域-主体责任. 授权/没收执行权力。 应享权利 证明访问.

一个没有有效实现权力的角色就没有任何授权.

最小示例

import {
  authorizeVaultSubjectOperation,
  compileVaultRecordScopeGrants,
  type VaultAuthorityRoleDefinition,
} from '@agenticprimitives/vault-authority';

const definition: VaultAuthorityRoleDefinition = {
  roleDefinitionId: 'roledef:example.manager@1',
  name: 'manager',
  version: '1',
  allowedScopes: ['resource'],
  capabilities: ['example.manage'],
  grantTemplates: [
    {
      server: 'example-vault',
      resources: ['vault:example.subject:{scopeRef}:*'],
      ops: ['read', 'write'],
    },
  ],
};

const subject = {
  vaultOwner: '0x0000000000000000000000000000000000000001',
  scope: 'resource' as const,
  scopeRef: 'subject:123',
};

const recordScopes = compileVaultRecordScopeGrants({ definition, subject });

const decision = authorizeVaultSubjectOperation({
  assignment,
  definition,
  subject,
  hasMaterializingAuthority: true,
  recordScopes,
  request: {
    server: 'example-vault',
    resource: 'vault:example.subject:subject:123:title',
    op: 'write',
  },
});

隐私

该套件从不创建管理哪个主体的公共注册. 任务、电线和 应享权利在金库/家用/运行时间商店中生活。 链态仍为散列/签名/撤销 核查.