@agenticprimitives/ontology 1.0.0-alpha.4 → 1.0.0-alpha.40

package/dist/grounded-vocabulary.d.ts

@@ -0,0 +1,29 @@
+export interface StandardGrounding {
+    /** The recognizable term in that world (e.g. "OAuth cnf", "ERC-4337 account"). */
+    term: string;
+    /** The owning standard / body (e.g. "RFC 7800", "GDPR Art. 4", "CAIP-10"). */
+    standard: string;
+    /** Canonical URL for the standard. */
+    ref: string;
+}
+export interface GroundedTerm {
+    /** Canonical AP name — identical to the TS type/field name AND the ontology `rdfs:label`. */
+    term: string;
+    /** The ontology IRI (T-box term in `tbox/actor-context.ttl`). */
+    iri: string;
+    /** Human label for UX surfaces. */
+    label: string;
+    /** One-line, jargon-free gloss for a non-expert. */
+    plainEnglish: string;
+    /** What a web2 IAM / security / legal reader already calls this. */
+    web2: StandardGrounding;
+    /** What a web3 reader already calls this. */
+    web3: StandardGrounding;
+    /** True for terms that carry context/presentation only — they NEVER authorize (ADR-0010/0020/0052). */
+    notAuthority?: boolean;
+}
+/** The actor-context / accountability vocabulary, each term dual-grounded (web2 + web3). Order is narrative. */
+export declare const GROUNDED_VOCABULARY: readonly GroundedTerm[];
+/** Look up a grounded term by its canonical name (the TS/ontology name). */
+export declare function groundedTerm(term: string): GroundedTerm | undefined;
+//# sourceMappingURL=grounded-vocabulary.d.ts.map

package/dist/grounded-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounded-vocabulary.d.ts","sourceRoot":"","sources":["../src/grounded-vocabulary.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,IAAI,EAAE,iBAAiB,CAAC;IACxB,6CAA6C;IAC7C,IAAI,EAAE,iBAAiB,CAAC;IACxB,uGAAuG;IACvG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAID,gHAAgH;AAChH,eAAO,MAAM,mBAAmB,EAAE,SAAS,YAAY,EA2FtD,CAAC;AAIF,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEnE"}

package/dist/grounded-vocabulary.js

@@ -0,0 +1,110 @@
+// Grounded vocabulary — spec 326 W1 (ADR-0052). The machine-readable, dual-grounded glossary.
+//
+// WHY THIS EXISTS: explainability lives in the TERMS, carried consistently across ontology, code, and UX — not
+// in a side document. This is the single source those three consumers share: the ontology IRI (`iri`), the code
+// type name (`term`), and the UX label (`label`) are the SAME concept, and each carries the web2 IAM/legal term
+// AND the web3 term a reader already recognizes. A UI renders `label` + a "web2 · web3" tooltip; a doc generates
+// from `plainEnglish`; a type name matches `term`. Pure browser-safe data — no Node builtins.
+// Namespace base inlined (NOT imported from ./index) to avoid a module-eval circular-init cycle — index.ts
+// re-exports this file, so importing NS back would read it in TDZ. Value is identical to `NS.apactor`.
+const APACTOR_NS = 'https://agenticprimitives.dev/ns/actor#';
+const A = (local) => `${APACTOR_NS}${local}`;
+/** The actor-context / accountability vocabulary, each term dual-grounded (web2 + web3). Order is narrative. */
+export const GROUNDED_VOCABULARY = [
+    {
+        term: 'accountabilityRoot',
+        iri: A('AccountabilityRoot'),
+        label: 'Accountable party',
+        plainEnglish: 'The durable anchor everything serious traces back to — custody, revocation, disputes.',
+        web2: { term: 'accountable party / controller', standard: 'GDPR Art. 4', ref: 'https://gdpr-info.eu/art-4-gdpr/' },
+        web3: { term: 'ERC-4337 Smart Agent', standard: 'ERC-4337 / CAIP-10', ref: 'https://eips.ethereum.org/EIPS/eip-4337' },
+    },
+    {
+        term: 'presentationIdentifier',
+        iri: A('PresentationIdentifier'),
+        label: 'Shown as',
+        plainEnglish: 'What one specific counterparty or surface is shown — a name, a pseudonym, or a proof.',
+        web2: { term: 'pairwise subject identifier', standard: 'OpenID Connect Core §8', ref: 'https://openid.net/specs/openid-connect-core-1_0.html#SubjectIDTypes' },
+        web3: { term: 'displayed address / registry entry', standard: 'ERC-8004', ref: 'https://eips.ethereum.org/EIPS/eip-8004' },
+        notAuthority: true,
+    },
+    {
+        term: 'rootPrincipal',
+        iri: A('rootPrincipal'),
+        label: 'On behalf of',
+        plainEnglish: 'The human or organization ultimately represented — may be shown pseudonymously.',
+        web2: { term: 'resource owner / principal', standard: 'OAuth 2.0 (RFC 6749)', ref: 'https://www.rfc-editor.org/rfc/rfc6749#section-1.1' },
+        web3: { term: 'controlling Person/Org SA', standard: 'CAIP-10', ref: 'https://chainagnostic.org/CAIPs/caip-10' },
+    },
+    {
+        term: 'originatingAgent',
+        iri: A('originatingAgent'),
+        label: 'Started by',
+        plainEnglish: 'The agent that kicked off the overall task.',
+        web2: { term: 'initiating client', standard: 'OAuth 2.0', ref: 'https://www.rfc-editor.org/rfc/rfc6749' },
+        web3: { term: 'originating Smart Agent', standard: 'CAIP-10', ref: 'https://chainagnostic.org/CAIPs/caip-10' },
+    },
+    {
+        term: 'actingAgent',
+        iri: A('actingAgent'),
+        label: 'Acting agent',
+        plainEnglish: 'The agent performing this particular step — possibly a sub-agent.',
+        web2: { term: 'actor (act claim)', standard: 'Token Exchange (RFC 8693)', ref: 'https://www.rfc-editor.org/rfc/rfc8693#section-4.1' },
+        web3: { term: 'session-key Smart Agent', standard: 'ERC-4337', ref: 'https://eips.ethereum.org/EIPS/eip-4337' },
+    },
+    {
+        term: 'agentInstance',
+        iri: A('AgentInstance'),
+        label: 'Running instance',
+        plainEnglish: 'The specific task, session, or container actually running right now.',
+        web2: { term: 'workload instance', standard: 'WIMSE / SPIFFE', ref: 'https://spiffe.io/docs/latest/spiffe-about/spiffe-concepts/' },
+        web3: { term: 'running session/container', standard: 'spec 326', ref: 'https://eips.ethereum.org/EIPS/eip-4337' },
+    },
+    {
+        term: 'confirmationKey',
+        iri: A('ConfirmationKey'),
+        label: 'Proof key',
+        plainEnglish: 'A key that proves possession — not who the agent is. It can rotate freely.',
+        web2: { term: 'cnf proof-of-possession', standard: 'RFC 7800', ref: 'https://www.rfc-editor.org/rfc/rfc7800' },
+        web3: { term: 'session key / passkey signer', standard: 'WebAuthn', ref: 'https://www.w3.org/TR/webauthn-3/' },
+        notAuthority: true,
+    },
+    {
+        term: 'SubjectRef',
+        iri: A('SubjectRef'),
+        label: 'Subject reference',
+        plainEnglish: 'A pointer to a party in any trust domain — kept typed so they are never confused.',
+        web2: { term: 'subject identifier', standard: 'RFC 9493', ref: 'https://www.rfc-editor.org/rfc/rfc9493' },
+        web3: { term: 'CAIP-10 account id', standard: 'CAIP-10', ref: 'https://chainagnostic.org/CAIPs/caip-10' },
+    },
+    {
+        term: 'SubjectBinding',
+        iri: A('SubjectBinding'),
+        label: 'Verified link',
+        plainEnglish: 'Signed proof that two identifiers refer to the same party — without merging them.',
+        web2: { term: 'account linking / VC', standard: 'W3C VC Data Model 2.0', ref: 'https://www.w3.org/TR/vc-data-model-2.0/' },
+        web3: { term: 'ERC-1271-verified signed link', standard: 'ERC-1271', ref: 'https://eips.ethereum.org/EIPS/eip-1271' },
+    },
+    {
+        term: 'delegatedTo',
+        iri: A('delegatedTo'),
+        label: 'Permission to act',
+        plainEnglish: 'Bounded permission to act on someone else’s behalf.',
+        web2: { term: 'delegation / power of attorney', standard: 'Token Exchange (RFC 8693)', ref: 'https://www.rfc-editor.org/rfc/rfc8693' },
+        web3: { term: 'on-chain Delegation', standard: 'ERC-7710', ref: 'https://eips.ethereum.org/EIPS/eip-7710' },
+    },
+    {
+        term: 'AuthorityChainEnvelope',
+        iri: A('AuthorityChainEnvelope'),
+        label: 'Authority chain',
+        plainEnglish: 'The portable, ordered record of how permission flowed from the root to this step.',
+        web2: { term: 'nested act delegation chain', standard: 'Token Exchange (RFC 8693)', ref: 'https://www.rfc-editor.org/rfc/rfc8693' },
+        web3: { term: 'on-chain delegation chain', standard: 'ERC-7710', ref: 'https://eips.ethereum.org/EIPS/eip-7710' },
+    },
+];
+const BY_TERM = new Map(GROUNDED_VOCABULARY.map((t) => [t.term, t]));
+/** Look up a grounded term by its canonical name (the TS/ontology name). */
+export function groundedTerm(term) {
+    return BY_TERM.get(term);
+}
+//# sourceMappingURL=grounded-vocabulary.js.map

package/dist/grounded-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounded-vocabulary.js","sourceRoot":"","sources":["../src/grounded-vocabulary.ts"],"names":[],"mappings":"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"}

package/dist/household.d.ts

@@ -0,0 +1,19 @@
+/** The canonical kin terms (`aphh:*`), by local name. */
+export declare const KIN_TERMS: readonly ["spouse", "child", "parent", "sibling"];
+export type KinTerm = (typeof KIN_TERMS)[number];
+/** The words people say → the term the T-box declares (its `skos:prefLabel` or an `skos:altLabel`). */
+export declare const KIN_WORD_FOR: Readonly<Record<string, KinTerm>>;
+/** The T-box term a said word names, or null — null means "keep their word", never "guess the nearest". */
+export declare function kinTermFor(said: string): KinTerm | null;
+/** The IRI of a kin term, for a record that wants to say which term it means. */
+export declare function kinIri(term: KinTerm): string;
+/** The household roles, in the order a person would read them. Bound to `aphh:HouseholdRole` members. */
+export declare const HOUSEHOLD_ROLES: readonly ["member", "guardian", "dependent"];
+export type HouseholdRole = (typeof HOUSEHOLD_ROLES)[number];
+/**
+ * The role a said word names. `member` is the DEFAULT and the ordinary case — an adult with no
+ * dependency in either direction — and defaulting to it is safe precisely because the role grants
+ * nothing: a guardian's ability to act for a dependent is a delegation, never this word.
+ */
+export declare function householdRoleFor(said: string | undefined): HouseholdRole;
+//# sourceMappingURL=household.d.ts.map

package/dist/household.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"household.d.ts","sourceRoot":"","sources":["../src/household.ts"],"names":[],"mappings":"AAcA,yDAAyD;AACzD,eAAO,MAAM,SAAS,mDAAoD,CAAC;AAC3E,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,uGAAuG;AACvG,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK1D,CAAC;AAEF,2GAA2G;AAC3G,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAEvD;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,yGAAyG;AACzG,eAAO,MAAM,eAAe,8CAA+C,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAGxE"}

package/dist/household.js

@@ -0,0 +1,41 @@
+// THE HOUSEHOLD'S OWN VOCABULARY — spec 363 W4.
+//
+// The T-box declares the kin terms and their `skos:altLabel`s (`aphh:child` is also "daughter" and
+// "son"). This is that list, compiled — the same arrangement `party-roles` has with the classes it
+// binds, and for the same reason: a resolver runs inside a request and cannot query a triple store
+// (spec 355 §1), while a second hand-kept synonym table in each caller is how "daughter" ended up
+// recorded as `otherKin` in one place and matched as `child` in another.
+//
+// DELIBERATELY SMALL, and the T-box says why: kinship vocabularies are bottomless, and the only thing a
+// resolver needs from this one is enough to understand "my daughter" when somebody says it. A word not
+// here is kept VERBATIM as the household's own label rather than squeezed into the nearest term.
+const AP_HH_NS = 'https://agenticprimitives.dev/ns/household#';
+/** The canonical kin terms (`aphh:*`), by local name. */
+export const KIN_TERMS = ['spouse', 'child', 'parent', 'sibling'];
+/** The words people say → the term the T-box declares (its `skos:prefLabel` or an `skos:altLabel`). */
+export const KIN_WORD_FOR = {
+    spouse: 'spouse', wife: 'spouse', husband: 'spouse', partner: 'spouse',
+    child: 'child', daughter: 'child', son: 'child', kid: 'child',
+    parent: 'parent', mother: 'parent', father: 'parent', mom: 'parent', mum: 'parent', dad: 'parent',
+    sibling: 'sibling', sister: 'sibling', brother: 'sibling',
+};
+/** The T-box term a said word names, or null — null means "keep their word", never "guess the nearest". */
+export function kinTermFor(said) {
+    return KIN_WORD_FOR[said.trim().toLowerCase().replace(/^(my|our)\s+/, '')] ?? null;
+}
+/** The IRI of a kin term, for a record that wants to say which term it means. */
+export function kinIri(term) {
+    return `${AP_HH_NS}${term}`;
+}
+/** The household roles, in the order a person would read them. Bound to `aphh:HouseholdRole` members. */
+export const HOUSEHOLD_ROLES = ['member', 'guardian', 'dependent'];
+/**
+ * The role a said word names. `member` is the DEFAULT and the ordinary case — an adult with no
+ * dependency in either direction — and defaulting to it is safe precisely because the role grants
+ * nothing: a guardian's ability to act for a dependent is a delegation, never this word.
+ */
+export function householdRoleFor(said) {
+    const w = String(said ?? '').trim().toLowerCase();
+    return HOUSEHOLD_ROLES.includes(w) ? w : 'member';
+}
+//# sourceMappingURL=household.js.map

package/dist/household.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"household.js","sourceRoot":"","sources":["../src/household.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,mGAAmG;AACnG,mGAAmG;AACnG,mGAAmG;AACnG,kGAAkG;AAClG,yEAAyE;AACzE,EAAE;AACF,wGAAwG;AACxG,uGAAuG;AACvG,iGAAiG;AAEjG,MAAM,QAAQ,GAAG,6CAA6C,CAAC;AAE/D,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAG3E,uGAAuG;AACvG,MAAM,CAAC,MAAM,YAAY,GAAsC;IAC7D,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;IACtE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO;IAC7D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ;IACjG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS;CAC1D,CAAC;AAEF,2GAA2G;AAC3G,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;AACrF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,MAAM,CAAC,IAAa;IAClC,OAAO,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC;AAG5E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAwB;IACvD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,OAAQ,eAAqC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9F,CAAC"}