@loxtep/sdk 0.9.16 → 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":"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"}

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/docs/sdk-mcp-mapping.md

@@ -14,8 +14,8 @@ deprecation aliases.
 | `loxtep_connect` | `client.connect` | `.connectors.*`, `.templates.*` |
 | `loxtep_workspace` | `client.workspace` | `.projects.*`, `.instances.*` (`list`/`get`/`create`; **`get_stream_config` is REST/CLI only** — not an MCP op). `.versions` (REST pending); planned MCP `get_project_workspace_status` → `ProjectWorkspaceStatus` ([docs](./project-workspace-status.md)) |
 | `loxtep_build` | `client.build` | `.workflows.*`, `.triggers.*`, `.data_products.*`, `.targets.*`, deploy writes, `.get_writer({ bot_id, queue })` escape hatch |
-| `loxtep_define` | `client.define` | `.schemas.*`, `.quality.*`, `.standards.*`, `.data_contracts.*`, `.domains.*` |
-| `loxtep_meaning` | `client.meaning` | `.thesaurus.*`, `.ontology.*`, `.packs.*`, `.semantic.*` (search/artifact/completeness) |
+| `loxtep_define` | `client.define` | `.schemas.*` (data-product), `.shapes.*` (domain canonical shapes), `.quality.*`, `.standards.*`, `.data_contracts.*`, `.domains.*` |
+| `loxtep_meaning` | `client.meaning` | `.thesaurus.*`, `.ontology.*`, `.packs.*`, `.semantic.*`, `.proposals.*`, `.bundles.import` |
 | `loxtep_review` | `client.review` | `.approvals.*`, `.improvements.*`, `.cdlc.*` (get/transition/propagate/lineage/deps + `list_review_queue`); `.mining.*` (`run_mining_pass`, `list_candidates`, `act_on_candidate`). CLI: `loxtep cdlc …`, `loxtep candidates list|act` |
 | `loxtep_query` | `client.query` | `.catalog.*`, `.discovery.*`, `.query()`, `.list_tables()`, `.search()` |
 | `loxtep_observe` | `client.observe` | `.status()`, `.stream_config()`, queue `.open_reader` / `.open_writer`, `.list_deployments()`, `.get_deployment()`, trust signals |
@@ -58,9 +58,31 @@ Bus physical names (`LeoCron`, `LeoS3`, …): Node `loxtep instances stream-conf
 or `client.workspace.instances.get_stream_config(id)` (Python same method). Not
 MCP `list_instances` or `get_sdk_config`.
 
+## Meaning: thesaurus / vocabulary (Phase 2)
+
+MCP `loxtep_meaning` thesaurus ops map to `client.meaning.thesaurus`:
+
+| MCP operation | SDK | REST |
+| --- | --- | --- |
+| `list_terms` | `client.meaning.thesaurus.list_terms()` | `GET /graph/organizations/{org}/thesaurus` |
+| `get_term` | `.get_term(term_id)` | `GET …/thesaurus/{term_id}` |
+| `create_term` | `.create_term({ canonical_key, aliases, … })` | `POST …/thesaurus` |
+| `update_term` | `.update_term(term_id, { … })` | `PUT …/thesaurus/{term_id}` |
+| `delete_term` | `.delete_term(term_id)` | `DELETE …/thesaurus/{term_id}` |
+| `sync_vocabulary` | `.sync_vocabulary({ domain, terms, mode, dry_run? })` | `POST …/thesaurus/sync` |
+| `create_enterprise_override` | `.create_enterprise_override({ canonical_key, enterprise_definition, divergence_reason, … })` | `POST …/thesaurus` (`is_override: true`) |
+| `resolve_canonical_key` | `.resolve_canonical_key(key_or_alias)` | client-side over `list_terms` |
+| append synonym (SDK) | `.append_synonym(canonical_key, alias_path, …)` | `POST …/thesaurus/synonyms` |
+
+MCP-only (no SDK yet): `list_enterprise_overrides`, `resolve_semantic_gap`,
+namespace-mapping CRUD (`register_namespace_mapping`, `list_namespace_mappings`,
+`get_namespace_mapping`).
+
 ## Meaning: ontology concepts (LOX-1241)
 
-MCP `loxtep_meaning` ontology ops map to `client.meaning.ontology`:
+MCP `loxtep_meaning` ontology ops map to `client.meaning.ontology`.
+`node_type` is a **lowercase** enum: `entity` \| `microservice` \| `taxonomy` \|
+`pattern` \| `custom` (not `Entity`).
 
 | MCP operation | SDK |
 | --- | --- |
@@ -74,6 +96,10 @@ MCP `loxtep_meaning` ontology ops map to `client.meaning.ontology`:
 
 REST: `/graph/organizations/{org}/ontology/concepts` and `…/relationships`.
 
+Ontology concepts are **graph types and relationships** between them. Defining
+**meaning** for agents/stewards is primarily **terms** (`thesaurus`) + **shapes**
+(`client.define.shapes`).
+
 ## Meaning: vocabulary packs (LOX-1242)
 
 These ops live under MCP **`loxtep_meaning`** / semantic-layer (not `loxtep_define`).
@@ -117,6 +143,47 @@ Notes:
 - SDK calls the semantic-layer MS REST routes directly. MCP-only enrichments (empty-search / completeness `metadata.activation_state` from pack activation) are not duplicated — use `client.meaning.packs.get_activation_status()` when needed.
 - Pack lifecycle remains under `client.meaning.packs` (see vocabulary packs section above).
 
+## Meaning: semantic proposals (Phase 2)
+
+Agent review of the same inbox Meaning shows. Batch helpers fan out to the
+single-id PUT (no dedicated batch REST).
+
+| Concern | SDK | REST |
+| --- | --- | --- |
+| list proposals | `client.meaning.proposals.list({ disposition?, proposal_type?, … })` | `GET /semantic-layer/semantic-proposals` |
+| accept | `.accept(semantic_proposal_id, { resolution_note? })` | `PUT …/semantic-proposals/{id}` `disposition: accepted` |
+| reject | `.reject(semantic_proposal_id, { resolution_note? })` | `PUT …` `disposition: rejected` |
+| batch accept / reject | `.accept_batch` / `.reject_batch` | N× PUT |
+
+## Meaning: semantic bundles (Phase 2)
+
+| MCP operation | SDK | REST |
+| --- | --- | --- |
+| `import_semantic_bundle` | `client.meaning.bundles.import({ bundle, dry_run? })` | `POST /semantic-layer/bundles/import` |
+
+Phase 0 error contract: result always includes `skipped_count` and `errors`.
+When skips/errors exist (or HTTP 207/422 with a parseable body), the SDK sets
+`partial: true` and still returns the result instead of dropping error detail.
+MCP-only sibling: `export_semantic_bundle` (no SDK yet).
+
+## Define: domain shapes (Phase 2)
+
+Domain / org **canonical shapes** (`domain_schemas`) — distinct from
+`client.define.schemas` (data-product schema versions on `/dataproducts`).
+
+| MCP operation | SDK | REST |
+| --- | --- | --- |
+| `create_schema` | `client.define.shapes.create({ name, format, … })` | `POST /semantic-layer/schemas` |
+| `list_schemas` | `.list({ domain_id?, format?, search? })` | `GET /semantic-layer/schemas` |
+| `get_schema` (by `schema_id`) | `.get(schema_id)` | `GET /semantic-layer/schemas/{schema_id}` |
+| `apply_schema` | `.apply({ schema_id, data_product_id, schema_version_id? })` | `POST …/schemas/{schema_id}/applications` |
+| `patch_schema` (align) | `.align({ schema_id, aligned_to_concept_uri })` | `PUT …/schemas/{schema_id}` |
+
+MCP-only (no SDK yet): `update_schema`, `delete_schema`, `list_schema_versions`,
+`unapply_schema`, `list_schema_applications`, `add_schema_version`,
+`get_schema_impact`, `install_schema_pack`. Data-product PII tagging stays on
+`client.define.schemas.tag_pii_fields`.
+
 ## Review: CDLC + context mining (LOX-1244…1247)
 
 MCP `loxtep_review` CDLC / mining ops map to `client.review.cdlc` and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loxtep/sdk",
-  "version": "0.9.16",
+  "version": "0.9.17",
   "description": "Loxtep SDK for Node.js — the Enterprise Context Layer: data products, workflows, projects, queues, and machine-usable context for AI",
   "author": "Loxtep <engineering@loxtep.io>",
   "homepage": "https://loxtep.io",