@ agenticrimitives/ 肿瘤
信任底物只与其词汇一致. 当30个包裹,42个合同,以及一个知识图 都谈到代理, 证书,监护权, 和授权, "什么是一个 CredentialFacet" 不能有30个答案。 这个软件包是单一的全域形式词汇——链上本体论(英语:Con-chain totology (film))的离链真理来源ADR-0009 (英语)即时和 identity-directory (第223项)符合.
它有意宣示:它命名和约束,它从来不授权。 词汇根依赖于无-甚至 @agenticprimitives/types ——所以其他每个包都可以在不倒置依赖图的情况下引用相同的IRI.
部分 代理原始产品 ——代理经济的信托基底:一个有监护,授权,命名,证书,审计证据的犬类智能代理身份,设计成一个系统.
见 第225区 合同全文 ADR-0018 (英语) 为了决定.
布局 (T- box / C- box / A- box) (中文(简体) )
context.jsonld @context — namespace prefix → IRI bindings
tbox/ RDFS/OWL schema (classes + properties), per domain
cbox/ SHACL shapes + SKOS controlled vocabularies (codelists)
abox/ example / fixture instances (tests + golden vectors only)
mappings/ external-standard crosswalks (HCS / ERC-8004, spec 226)
src/index.ts typed IRI constants + artifact paths
T-box = 名词 C-box = 约束 + 受控词汇 A-box = 例.
T-box的UML类图表文档——继承+每个域的关系
住在这里 docs/tbox/. 对于普通语版本——原则
词汇保护以及为什么——首先 docs/story.md。 。 。 .
使用量
import { NS, CLASS, SHAPE, ARTIFACTS, artifactPath } from '@agenticprimitives/ontology';
CLASS.CanonicalAgentId; // "https://agenticprimitives.dev/ns/core#CanonicalAgentId"
artifactPath(ARTIFACTS.tbox[0]); // absolute path to tbox/core.ttl — load into a SPARQL store
两个切入点,故意分开:
- 主条目(浏览器安全) 纯IRI常数:
NS, (中文(简体) ),CLASS, (中文(简体) ),PREDICATE, (中文(简体) ),SHAPE, (中文(简体) ),ONTOLOGY_VERSION。节点构建;这就是identity-directory(并通过它,浏览器应用)导入. /artifacts子路径( 只有节点) —— 说ARTIFACTS+ 键artifactPath(rel)用于解析运出 SPARQL 加载器或 SHACL 引擎的 TTL/JSON-LD 文件。 仅限服务器侧.
怎么不一样
通用 SKOS/SHACL 工具链作为文档管理词汇-在一个编辑器中管理,脱离依赖于它们的系统,漂移瞬间运行时间代码变化. 这里的词汇带有负载,并按三个方向进行锁步检查:
- 链条 ——这里的形状或上游必须与其链上对应物相匹配
OntologyTermRegistry编号 :ShapeRegistry(spec 225 §8);漂移被记录为一种发现,而不能被容忍为skew. - 在类型脚本中 ——IRIs 映射出品牌类型在
types(单位:千美元)CanonicalAgentId, (中文(简体) ),Assurance(中文(简体) ). 一个品牌;这个包命名为IRI,从未重新定义该类型. - 各种标准 —— 说
mappings/*.ttl携带明确跨行到外部代理识别标准(HCS,ERC-8004,OASF),而不是非正式"严格对应"的通俗.
并且它会轻而易举地航行:在已出版的地表没有重型的RDF/SHACL图书馆——消费者用自己的发动机来给文物接线.
范围
以普通AP原始为基准:身份、证书、监护、授权、审计、命名、Org、登记/发现、信任、公众接触结果以及底质-spine T-box类定义(Spec 225 §11.5)。 用于产品流动的运行时 SHACL 形状生活在自己的软件包中; GraphDB A-box 摄取形状用于发现 cbox/discovery-graph-shapes.shacl.ttl; 垂直词汇仍然为应用所有(ADR-0021 (英语)) (中文(简体) ).
发现本体论 刻意从 Agent Explorer 中的域源词汇形状中构建 apps/ontology/ontology 模块 - core.ttl, (中文(简体) ), discovery.ttl, (中文(简体) ), descriptors.ttl, (中文(简体) ), erc8004.ttl, (中文(简体) ), hol.ttl, (中文(简体) ), oasf.ttl,以及 trust.ttl ——同时将它提炼成植入PROV-O和DOLCE+DnS/DUL的AP-native命名空间.
模块映射( 按 spec 添加)
| 关切 | T- 选项 | 弹匣 |
|---|---|---|
| 身份、类型、衍生类型 | tbox/core.ttl, (中文(简体) ), tbox/identity.ttl | cbox/controlled-vocabularies.ttl, (中文(简体) ), cbox/canonical-agent-id-shape.shacl.ttl |
| 类型命名、登记核心(第346项) | tbox/naming.ttl, (中文(简体) ), tbox/registry.ttl | cbox/naming-registry-shapes.shacl.ttl, (中文(简体) ), cbox/registry-vocabulary.ttl |
| 能力、索赔、分类制图(第251/325/347 §5段) | tbox/skills.ttl (单位:千美元)aps:SkillTaxonomyMapping —— 说 relation = SKOS 绘图属性) | cbox/skill-vocabulary.ttl, (中文(简体) ), cbox/capability-catalog-shapes.shacl.ttl |
| Canonical profile → A2A代理卡 → 投影 → 出版 → 外部身份绑定(Spec 347 §11; ADR-0062) | tbox/card-projection.ttl ——第二单元 ap: 核心命名空间; PROV- O 定位( 生成/ 发布 ) prov:Activity文物/释放 prov:Entity; 出版商/适应者 {} prov:SoftwareAgent)),"canonical agent" ("canonical agent")""≡"" ap:Agent,没有二等 | cbox/card-projection-shapes.shacl.ttl 公共卡元数据;投影出处(全部) 八点 文摘列为 ap:hasDigest外部约束; 公开披露边界 (SPARQL目标于 ap:disclosureScope "public":没有回回回/私通/链接-本地端点,没有金库定位;没有范围是私通. 代码列表 ap:lossCategoryScheme,卡片放出/投影预告/装订生命周期, ap:bindingVerificationStateScheme, (中文(简体) ), ap:digestRoleScheme 内 cbox/controlled-vocabularies.ttl |
| 代理交互( 第340段) | tbox/interaction.ttl | cbox/interaction-shapes.shacl.ttl, (中文(简体) ), cbox/interaction-vocabulary.ttl |
| 协调/参与/执行(第332/336/330段) | tbox/coordination.ttl, (中文(简体) ), tbox/engagement.ttl, (中文(简体) ), tbox/execution.ttl, (中文(简体) ), tbox/plan.ttl | —— 说 |
这不是什么
- 不是TS类型 -
@agenticprimitives/types拥有CanonicalAgentId, (中文(简体) ),Assurance等;此套件命名为IRIs. 一个品牌. - 不是运行时间 CAIP- 10 构建器—— 即
@agenticprimitives/agent-profile。 。 。 . - 不是当局——它命名和确认;它从来不给予监护权或薄荷.
状态
第一阶段已执行 ——T/C/A-盒式文物,测绘,以及今天申报的TS地表飞船. SHACL-引擎对实例和实时 A-box 知识图的验证(一个 SPARQL 商店- Ontotext GraphDB 参考文献, 由 identity-directory)是第2阶段,由消费者按225 第11个谱线接通——即使这样,本体学仍保持一个验证器,从不成为权威.
测试网/飞行员准备 生产启动在基础README的公开核对表上进行——包括第三方合同审计和治理关键轮换。 追踪所有安全发现
docs/audits/findings.yaml。 。 。 .
权威规格 : specs/225-ontology.md. 地壳: CLAUDE.md + 键 capability.manifest.json。 。 。 .
构建
pnpm --filter @agenticprimitives/ontology typecheck
pnpm --filter @agenticprimitives/ontology test
pnpm --filter @agenticprimitives/ontology build