@loxtep/sdk 0.9.15 → 0.9.17

package/dist/client/thesaurus-types.d.ts

@@ -1,17 +1,35 @@
 /**
- * Thesaurus API types (LOX-1476). Canonical correlation keys and per-system aliases.
+ * Thesaurus API types (LOX-1476 + Phase 2 meaning parity).
+ * Canonical correlation keys, per-system aliases, enterprise overrides, sync.
  */
+export type ThesaurusScheme = 'field' | 'entity' | 'custom';
+export type OverrideSource = 'inferred_rejection' | 'govern_step' | 'manual' | 'agent_gap';
+export type OverrideStatus = 'active' | 'proposed' | 'retired';
+export interface ThesaurusAlias {
+    system?: string;
+    path: string;
+}
 export interface ThesaurusTerm {
     term_id: string;
     organization_id: string;
     canonical_key: string;
+    scheme?: ThesaurusScheme;
     precedence: number;
-    aliases: Array<{
-        system?: string;
-        path: string;
-    }>;
+    aliases: ThesaurusAlias[];
+    definition?: string | null;
+    broader?: string[];
+    narrower?: string[];
+    related?: string[];
+    is_override?: boolean;
+    enterprise_definition?: string | null;
+    baseline_assumption?: string | null;
+    divergence_reason?: string | null;
+    override_source?: OverrideSource | null;
+    override_status?: OverrideStatus | null;
+    linked_data_product_ids?: string[];
     created_at: string;
     updated_at: string;
+    deleted_at?: string | null;
 }
 export interface ThesaurusListResponse {
     success: true;
@@ -25,4 +43,93 @@ export interface ThesaurusResolveResponse {
         canonical_key: string;
     };
 }
+export interface CreateThesaurusTermInput {
+    canonical_key: string;
+    scheme?: ThesaurusScheme;
+    precedence?: number;
+    aliases?: ThesaurusAlias[];
+    definition?: string | null;
+    broader?: string[];
+    narrower?: string[];
+    related?: string[];
+    domain?: string;
+    organization_id?: string;
+}
+export interface UpdateThesaurusTermInput {
+    canonical_key?: string;
+    scheme?: ThesaurusScheme;
+    precedence?: number;
+    aliases?: ThesaurusAlias[];
+    definition?: string | null;
+    broader?: string[];
+    narrower?: string[];
+    related?: string[];
+    domain?: string;
+    is_override?: boolean;
+    enterprise_definition?: string | null;
+    baseline_assumption?: string | null;
+    divergence_reason?: string | null;
+    override_source?: OverrideSource | null;
+    override_status?: OverrideStatus | null;
+    linked_data_product_ids?: string[];
+    organization_id?: string;
+}
+export interface DeleteThesaurusTermResult {
+    term: ThesaurusTerm;
+    warnings?: string[];
+}
+export interface SyncVocabularyTermInput {
+    canonical_key: string;
+    scheme: ThesaurusScheme;
+    aliases?: ThesaurusAlias[];
+    broader?: string[];
+    narrower?: string[];
+    related?: string[];
+}
+export interface SyncVocabularyInput {
+    domain: string;
+    terms: SyncVocabularyTermInput[];
+    mode: 'full_sync' | 'additive_only';
+    dry_run?: boolean;
+    organization_id?: string;
+}
+export interface SyncVocabularyConflict {
+    canonical_key: string;
+    reason: string;
+}
+export interface SyncVocabularyResult {
+    created: {
+        count: number;
+        term_ids: string[];
+    };
+    updated: {
+        count: number;
+        term_ids: string[];
+    };
+    tombstoned: {
+        count: number;
+        term_ids: string[];
+    };
+    unchanged: {
+        count: number;
+    };
+    conflicts: SyncVocabularyConflict[];
+    dry_run: boolean;
+}
+export interface CreateEnterpriseOverrideInput {
+    canonical_key: string;
+    enterprise_definition: string;
+    divergence_reason: string;
+    scheme?: ThesaurusScheme;
+    aliases?: ThesaurusAlias[];
+    definition?: string | null;
+    precedence?: number;
+    broader?: string[];
+    narrower?: string[];
+    related?: string[];
+    baseline_assumption?: string | null;
+    linked_data_product_ids?: string[];
+    override_source?: OverrideSource;
+    organization_id?: string;
+}
 //# sourceMappingURL=thesaurus-types.d.ts.map

package/dist/client/thesaurus-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thesaurus-types.d.ts","sourceRoot":"","sources":["../../src/client/thesaurus-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QAAE,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC"}
+{"version":3,"file":"thesaurus-types.d.ts","sourceRoot":"","sources":["../../src/client/thesaurus-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5D,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,aAAa,GACb,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QAAE,KAAK,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,uBAAuB,EAAE,CAAC;IACjC,IAAI,EAAE,WAAW,GAAG,eAAe,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC/C,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/client/thesaurus-types.js

@@ -1,5 +1,6 @@
 /**
- * Thesaurus API types (LOX-1476). Canonical correlation keys and per-system aliases.
+ * Thesaurus API types (LOX-1476 + Phase 2 meaning parity).
+ * Canonical correlation keys, per-system aliases, enterprise overrides, sync.
  */
 export {};
 //# sourceMappingURL=thesaurus-types.js.map

package/dist/client/thesaurus-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"thesaurus-types.js","sourceRoot":"","sources":["../../src/client/thesaurus-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"thesaurus-types.js","sourceRoot":"","sources":["../../src/client/thesaurus-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/client/thesaurus.d.ts

@@ -1,11 +1,24 @@
 /**
- * Thesaurus API (LOX-1476). listTerms, resolveCanonicalKey.
- * Backend: GET /graph/organizations/:organization_id/thesaurus.
+ * Thesaurus API (LOX-1476 + Phase 2 meaning parity).
+ * MCP: loxtep_meaning list_terms / get_term / create_term / update_term /
+ * delete_term / sync_vocabulary / create_enterprise_override / append synonym.
+ *
+ * Backend:
+ *   GET|POST /graph/organizations/:organization_id/thesaurus
+ *   GET|PUT|DELETE /graph/organizations/:organization_id/thesaurus/:term_id
+ *   POST /graph/organizations/:organization_id/thesaurus/sync
+ *   POST /graph/organizations/:organization_id/thesaurus/synonyms
  */
 import type { LoxtepHttpClient } from '../http/client.js';
-import type { ThesaurusTerm } from './thesaurus-types.js';
+import type { CreateEnterpriseOverrideInput, CreateThesaurusTermInput, DeleteThesaurusTermResult, SyncVocabularyInput, SyncVocabularyResult, ThesaurusTerm, UpdateThesaurusTermInput } from './thesaurus-types.js';
 export declare function createThesaurusApi(http: LoxtepHttpClient, organization_id?: string): {
     list_terms: (orgId?: string) => Promise<ThesaurusTerm[]>;
+    get_term: (term_id: string, orgId?: string) => Promise<ThesaurusTerm>;
+    create_term: (input: CreateThesaurusTermInput) => Promise<ThesaurusTerm>;
+    update_term: (term_id: string, input: UpdateThesaurusTermInput) => Promise<ThesaurusTerm>;
+    delete_term: (term_id: string, orgId?: string) => Promise<DeleteThesaurusTermResult>;
+    sync_vocabulary: (input: SyncVocabularyInput) => Promise<SyncVocabularyResult>;
+    create_enterprise_override: (input: CreateEnterpriseOverrideInput) => Promise<ThesaurusTerm>;
     resolve_canonical_key: (key_or_alias: string, orgId?: string) => Promise<string | null>;
     append_synonym: (canonical_key: string, alias_path: string, options?: {
         system?: string;
@@ -13,4 +26,5 @@ export declare function createThesaurusApi(http: LoxtepHttpClient, organization_
         orgId?: string;
     }) => Promise<ThesaurusTerm>;
 };
+export type ThesaurusApi = ReturnType<typeof createThesaurusApi>;
 //# sourceMappingURL=thesaurus.d.ts.map

package/dist/client/thesaurus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thesaurus.d.ts","sourceRoot":"","sources":["../../src/client/thesaurus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,sBAAsB,CAAC;AAYjF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB;IACD,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzD,qBAAqB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxF,cAAc,EAAE,CACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC/D,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,CA0CA"}
+{"version":3,"file":"thesaurus.d.ts","sourceRoot":"","sources":["../../src/client/thesaurus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EAEb,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AA0B9B,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,eAAe,CAAC,EAAE,MAAM,GACvB;IACD,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACtE,WAAW,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACzE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1F,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACrF,eAAe,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/E,0BAA0B,EAAE,CAC1B,KAAK,EAAE,6BAA6B,KACjC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,qBAAqB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxF,cAAc,EAAE,CACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAC/D,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,CAuIA;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/client/thesaurus.js

@@ -1,24 +1,132 @@
 /**
- * Thesaurus API (LOX-1476). listTerms, resolveCanonicalKey.
- * Backend: GET /graph/organizations/:organization_id/thesaurus.
+ * Thesaurus API (LOX-1476 + Phase 2 meaning parity).
+ * MCP: loxtep_meaning list_terms / get_term / create_term / update_term /
+ * delete_term / sync_vocabulary / create_enterprise_override / append synonym.
+ *
+ * Backend:
+ *   GET|POST /graph/organizations/:organization_id/thesaurus
+ *   GET|PUT|DELETE /graph/organizations/:organization_id/thesaurus/:term_id
+ *   POST /graph/organizations/:organization_id/thesaurus/sync
+ *   POST /graph/organizations/:organization_id/thesaurus/synonyms
  */
+function unwrapData(res) {
+    return (res.data ?? res);
+}
+function requireOrg(organization_id, orgId) {
+    const org = orgId ?? organization_id;
+    if (!org) {
+        throw new Error('organization_id required (pass explicitly or set on client)');
+    }
+    return org;
+}
+function thesaurusBase(org) {
+    return `/graph/organizations/${encodeURIComponent(org)}/thesaurus`;
+}
 async function fetchTerms(http, organization_id) {
-    const res = await http.get(`/graph/organizations/${encodeURIComponent(organization_id)}/thesaurus`);
+    const res = await http.get(thesaurusBase(organization_id));
     return res?.data?.terms ?? [];
 }
 export function createThesaurusApi(http, organization_id) {
-    const resolveOrg = (orgId) => orgId ?? organization_id;
     return {
         async list_terms(orgId) {
-            const org = resolveOrg(orgId);
-            if (!org)
-                throw new Error('organization_id required (pass to list_terms or set on client)');
+            const org = requireOrg(organization_id, orgId);
             return fetchTerms(http, org);
         },
+        async get_term(term_id, orgId) {
+            if (!term_id)
+                throw new Error('term_id is required');
+            const org = requireOrg(organization_id, orgId);
+            const res = await http.get(`${thesaurusBase(org)}/${encodeURIComponent(term_id)}`);
+            return unwrapData(res);
+        },
+        async create_term(input) {
+            const org = requireOrg(organization_id, input.organization_id);
+            const body = {
+                canonical_key: input.canonical_key,
+                scheme: input.scheme ?? 'field',
+                precedence: input.precedence ?? 100,
+                aliases: input.aliases ?? [],
+            };
+            if (input.definition !== undefined)
+                body.definition = input.definition;
+            if (input.broader !== undefined)
+                body.broader = input.broader;
+            if (input.narrower !== undefined)
+                body.narrower = input.narrower;
+            if (input.related !== undefined)
+                body.related = input.related;
+            if (input.domain !== undefined)
+                body.domain = input.domain;
+            const res = await http.post(thesaurusBase(org), body);
+            return unwrapData(res);
+        },
+        async update_term(term_id, input) {
+            if (!term_id)
+                throw new Error('term_id is required');
+            const org = requireOrg(organization_id, input.organization_id);
+            const body = {};
+            for (const [key, value] of Object.entries(input)) {
+                if (key === 'organization_id')
+                    continue;
+                if (value !== undefined)
+                    body[key] = value;
+            }
+            const res = await http.put(`${thesaurusBase(org)}/${encodeURIComponent(term_id)}`, body);
+            return unwrapData(res);
+        },
+        async delete_term(term_id, orgId) {
+            if (!term_id)
+                throw new Error('term_id is required');
+            const org = requireOrg(organization_id, orgId);
+            const res = await http.delete(`${thesaurusBase(org)}/${encodeURIComponent(term_id)}`);
+            const envelope = res;
+            return {
+                term: unwrapData(res),
+                warnings: envelope.warnings,
+            };
+        },
+        async sync_vocabulary(input) {
+            const org = requireOrg(organization_id, input.organization_id);
+            const body = {
+                domain: input.domain,
+                terms: input.terms,
+                mode: input.mode,
+                dry_run: input.dry_run ?? false,
+            };
+            const res = await http.post(`${thesaurusBase(org)}/sync`, body);
+            return unwrapData(res);
+        },
+        async create_enterprise_override(input) {
+            const org = requireOrg(organization_id, input.organization_id);
+            const body = {
+                canonical_key: input.canonical_key,
+                enterprise_definition: input.enterprise_definition,
+                divergence_reason: input.divergence_reason,
+                is_override: true,
+                override_source: input.override_source ?? 'manual',
+                scheme: input.scheme ?? 'field',
+                precedence: input.precedence ?? 100,
+                aliases: input.aliases ?? [],
+            };
+            if (input.definition !== undefined)
+                body.definition = input.definition;
+            if (input.broader !== undefined)
+                body.broader = input.broader;
+            if (input.narrower !== undefined)
+                body.narrower = input.narrower;
+            if (input.related !== undefined)
+                body.related = input.related;
+            if (input.baseline_assumption !== undefined) {
+                body.baseline_assumption = input.baseline_assumption;
+            }
+            if (input.linked_data_product_ids !== undefined) {
+                body.linked_data_product_ids = input.linked_data_product_ids;
+            }
+            const res = await http.post(thesaurusBase(org), body);
+            return unwrapData(res);
+        },
         async resolve_canonical_key(key_or_alias, orgId) {
-            const org = resolveOrg(orgId);
-            if (!org)
-                throw new Error('organization_id required (pass to resolve_canonical_key or set on client)');
+            const org = requireOrg(organization_id, orgId);
             const terms = await fetchTerms(http, org);
             const k = key_or_alias.toLowerCase();
             for (const term of terms) {
@@ -31,10 +139,8 @@ export function createThesaurusApi(http, organization_id) {
             return null;
         },
         async append_synonym(canonical_key, alias_path, options) {
-            const org = resolveOrg(options?.orgId);
-            if (!org)
-                throw new Error('organization_id required (pass options.orgId or set on client)');
-            const res = await http.post(`/graph/organizations/${encodeURIComponent(org)}/thesaurus/synonyms`, {
+            const org = requireOrg(organization_id, options?.orgId);
+            const res = await http.post(`${thesaurusBase(org)}/synonyms`, {
                 canonical_key,
                 alias_path,
                 system: options?.system,

package/dist/client/thesaurus.js.map

@@ -1 +1 @@
-{"version":3,"file":"thesaurus.js","sourceRoot":"","sources":["../../src/client/thesaurus.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,KAAK,UAAU,UAAU,CACvB,IAAsB,EACtB,eAAuB;IAEvB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CACxB,wBAAwB,kBAAkB,CAAC,eAAe,CAAC,YAAY,CACxE,CAAC;IACF,OAAO,GAAG,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAsB,EACtB,eAAwB;IAUxB,MAAM,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,IAAI,eAAe,CAAC;IAChE,OAAO;QACL,KAAK,CAAC,UAAU,CAAC,KAAc;YAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAC5F,OAAO,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,KAAK,CAAC,qBAAqB,CAAC,YAAoB,EAAE,KAAc;YAC9D,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,GAAG;gBACN,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;YAC/F,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;YACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC,aAAa,CAAC;gBACtE,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC1E,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC,aAAa,CAAC;YACnD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,cAAc,CAClB,aAAqB,EACrB,UAAkB,EAClB,OAAkE;YAElE,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;YAC5F,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CACzB,wBAAwB,kBAAkB,CAAC,GAAG,CAAC,qBAAqB,EACpE;gBACE,aAAa;gBACb,UAAU;gBACV,MAAM,EAAE,OAAO,EAAE,MAAM;gBACvB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,GAAG;aACvC,CACF,CAAC;YACF,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"thesaurus.js","sourceRoot":"","sources":["../../src/client/thesaurus.ts"],"names":[],"mappings":"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"}

package/dist/config/platform-request-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-request-url.d.ts","sourceRoot":"","sources":["../../src/config/platform-request-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqDH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAqC7E;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,EAmBA,CAAC"}
+{"version":3,"file":"platform-request-url.d.ts","sourceRoot":"","sources":["../../src/config/platform-request-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAqDH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAqC7E;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,EAuBA,CAAC"}

package/dist/config/platform-request-url.js

@@ -131,7 +131,11 @@ export const SDK_HTTP_PATHS_BY_FEATURE = [
     { feature: 'connectors', pathPrefixes: ['/connectors'] },
     { feature: 'observe, queues, data_products trace (HTTP fallback)', pathPrefixes: ['/observe'] },
     { feature: 'discovery (MCP tools)', pathPrefixes: ['/ai/mcp/'] },
-    { feature: 'thesaurus', pathPrefixes: ['/graph/organizations/'] },
+    { feature: 'thesaurus, ontology', pathPrefixes: ['/graph/organizations/'] },
+    {
+        feature: 'semantic-layer (search, shapes, proposals, bundles)',
+        pathPrefixes: ['/semantic-layer'],
+    },
     { feature: 'process_intelligence, procedures', pathPrefixes: ['/process-intelligence'] },
     { feature: 'rate limits', pathPrefixes: ['/rate-limits'] },
 ];

package/dist/config/platform-request-url.js.map

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

package/dist/rstreams/leo-runtime.d.ts

@@ -5,8 +5,13 @@
  * `build(process.cwd())` at module load and calls `fs.existsSync({})` when there is no
  * Leo system directory (DEP0187). REST-only CLI commands must not pay that cost or warning.
  */
+import type { AwsCredentialIdentity } from '@smithy/types';
 import type { ConfigurationResources, RStreamsSdk } from 'leo-sdk';
-export declare function createRStreamsSdk(config: ConfigurationResources): RStreamsSdk;
+export type CreateRStreamsSdkOptions = {
+    /** STS / explicit credentials from `loxtep login` (BusWriter). Required for customer bus writes. */
+    credentials?: AwsCredentialIdentity;
+};
+export declare function createRStreamsSdk(config: ConfigurationResources, options?: CreateRStreamsSdkOptions): RStreamsSdk;
 export type { ConfigurationResources, RStreamsSdk } from 'leo-sdk';
 /** Loxtep stream runtime handle (injected in tests or advanced wiring). */
 export type { RStreamsSdk as LoxtepStreamRuntime } from 'leo-sdk';

package/dist/rstreams/leo-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"leo-runtime.d.ts","sourceRoot":"","sources":["../../src/rstreams/leo-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAInE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,WAAW,CAc7E;AAED,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,2EAA2E;AAC3E,YAAY,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"leo-runtime.d.ts","sourceRoot":"","sources":["../../src/rstreams/leo-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAInE,MAAM,MAAM,wBAAwB,GAAG;IACrC,oGAAoG;IACpG,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,wBAAwB,GACjC,WAAW,CAmCb;AAED,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,2EAA2E;AAC3E,YAAY,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/rstreams/leo-runtime.js

@@ -7,7 +7,7 @@
  */
 import { createRequire } from 'node:module';
 const require = createRequire(import.meta.url);
-export function createRStreamsSdk(config) {
+export function createRStreamsSdk(config, options) {
     // Lazy CJS require — only when a stream reader/writer is actually constructed.
     const StreamRuntime = require('leo-sdk');
     const defaultExport = StreamRuntime.default;
@@ -15,6 +15,19 @@ export function createRStreamsSdk(config) {
     if (!SDK || typeof SDK !== 'function') {
         throw new Error('Failed to resolve RStreamsSdk constructor from leo-sdk');
     }
-    return new SDK(config);
+    const credentials = options?.credentials;
+    if (!credentials) {
+        return new SDK(config);
+    }
+    // Pin STS onto every AWS client the bus uses — default credential chain is the
+    // operator profile, which cannot write org/shared bus Kinesis streams.
+    const region = config.Region;
+    const clientCreds = { credentials, region };
+    return new SDK(config, {
+        kinesisConfig: clientCreds,
+        dynamodbConfig: clientCreds,
+        s3Config: clientCreds,
+        firehoseConfig: clientCreds,
+    });
 }
 //# sourceMappingURL=leo-runtime.js.map

package/dist/rstreams/leo-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"leo-runtime.js","sourceRoot":"","sources":["../../src/rstreams/leo-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC9D,+EAA+E;IAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAGtC,CAAC;IACF,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,IAAI,aAAa,EAAE,WAAW,CAEvD,CAAC;IACd,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"leo-runtime.js","sourceRoot":"","sources":["../../src/rstreams/leo-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAO/C,MAAM,UAAU,iBAAiB,CAC/B,MAA8B,EAC9B,OAAkC;IAElC,+EAA+E;IAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAMtC,CAAC;IACF,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC;IAC5C,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,IAAI,aAAa,EAAE,WAAW,CAKvD,CAAC;IACd,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,CAAC;IACzC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,+EAA+E;IAC/E,uEAAuE;IACvE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,WAAW,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC5C,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE;QACrB,aAAa,EAAE,WAAW;QAC1B,cAAc,EAAE,WAAW;QAC3B,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,WAAW;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/docs/code-first-cli.md

@@ -86,9 +86,10 @@ Scaffolds a **Loxtep workspace** in the current directory.
 | `workflows/` | Workflow modules you author and deploy |
 | `data-products/` | Data product definitions |
 
-With **`--template <slug>`**, init also materializes template content from the
-platform catalog, including **`AGENTS.md`** and a default skill at
-**`.loxtep/skills/<slug>.yaml`**.
+With **`--template shopify-orders`**, init materializes the **bundled runnable
+sample** (workflow, event fixture, AGENTS.md, skill, package/tsconfig). Other
+slugs still write AGENTS.md + a default skill from catalog metadata when
+available.
 
 ### Common flags
 
@@ -141,17 +142,18 @@ Import in workflow modules:
 
 ```typescript
 import { defineDataWorkflow, on } from '@loxtep/sdk';
-import { workspace } from './.loxtep/generated';
+import { workspace } from '../.loxtep/generated/index.js';
 
 export default defineDataWorkflow({
   name: 'orders-enricher',
-  triggers: [on.queueEvent(workspace.queues.orders_raw)],
+  triggers: [on.webhook('/shopify/orders')],
+  requireApproval: ['dataProducts.write'],
   async handler(ctx, event) {
-    await ctx.toolbox.dataProducts.upsert({
-      dataProduct: workspace.dataProducts.orders_enriched,
-      domain: workspace.domains.commerce,
-      record: event,
-    });
+    const order = (event ?? {}) as Record<string, unknown>;
+    await ctx.toolbox!.dataProducts.write(
+      workspace.dataProducts.orders_enriched,
+      { ...order, enriched_at: new Date().toISOString(), source: 'orders-enricher' }
+    );
   },
 });
 ```
@@ -161,6 +163,19 @@ credentials without hand-wiring env vars.
 
 ---
 
+## `loxtep setup` (shopify-orders)
+
+After attach, provision the sample data products (idempotent):
+
+```bash
+pnpm exec loxtep setup
+```
+
+Creates `orders_raw` and `orders_enriched` via `ingest create --deploy` when
+missing. Requires an org domain.
+
+---
+
 ## `loxtep test` and `loxtep deploy`
 
 ```bash
@@ -168,8 +183,9 @@ pnpm exec loxtep test orders-enricher --event ./events/order-created.json
 pnpm exec loxtep deploy
 ```
 
-- **`test`** — runs one workflow module locally against the attached instance and
-  prints an action trace.
+- **`test`** — runs one workflow module **locally with live instance I/O** and
+  prints an action trace. Guarded ops (`requireApproval`) prompt; reject/timeout
+  and handler errors exit **nonzero**.
 - **`deploy`** — compiles modules into the platform workflow graph and deploys to
   the attached instance.