@loxtep/sdk 0.9.6 → 0.9.8

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

@@ -0,0 +1,81 @@
+/**
+ * Context mining API types (MCP: loxtep_review mining ops).
+ * MCP ops: run_mining_pass, list_candidates, act_on_candidate.
+ *
+ * REST (graph):
+ *   POST /graph/organizations/{org}/mining/run
+ *   GET  /graph/organizations/{org}/mining/candidates
+ *   POST /graph/organizations/{org}/mining/candidates/{candidate_id}/act
+ *
+ * Invariant: mining only surfaces candidates — never auto-commits.
+ * act_on_candidate(approve) routes through CDLC at `in_review`.
+ */
+export interface MiningApiDeps {
+    /** Default organization for mining calls; overridable per call. */
+    organization_id?: string;
+}
+/** Signal sources the mining pass can analyze. */
+export type MiningSignalSource = 'semantic_definitions' | 'decision_traces' | 'event_sequences' | (string & {});
+export type MiningCandidateType = 'semantic_conflict' | 'procedure' | 'promotion' | 'entity_fact' | (string & {});
+export type MiningCandidateStatus = 'candidate' | 'approved' | 'rejected' | (string & {});
+export type MiningCandidateAction = 'approve' | 'reject';
+export interface MiningScopeFilters {
+    entity_types?: string[];
+    from_date?: string;
+    to_date?: string;
+    [key: string]: unknown;
+}
+export interface RunMiningPassInput {
+    organization_id?: string;
+    /** Signal sources to mine (optional — platform defaults to all). */
+    signal_sources?: MiningSignalSource[] | null;
+    /** Scope filters to narrow the mining pass (optional). */
+    scope_filters?: MiningScopeFilters | null;
+}
+/** Platform payload for a mining pass; shape may grow — keep index signature. */
+export interface RunMiningPassResult {
+    mining_run_id?: string;
+    candidates?: MiningCandidate[];
+    candidate_ids?: string[];
+    candidates_created?: number;
+    [key: string]: unknown;
+}
+export interface ListCandidatesFilters {
+    organization_id?: string;
+    candidate_type?: MiningCandidateType;
+    status?: MiningCandidateStatus;
+    mining_run_id?: string;
+}
+export interface MiningCandidate {
+    id: string;
+    candidate_type: MiningCandidateType;
+    status: MiningCandidateStatus;
+    payload: Record<string, unknown>;
+    provenance_refs: string[];
+    mining_run_id: string | null;
+    organization_id: string;
+    created_at?: string;
+    resolved_at?: string | null;
+    resolved_by?: string | null;
+    [key: string]: unknown;
+}
+export interface ListCandidatesResult {
+    candidates: MiningCandidate[];
+    total: number;
+}
+export interface ActOnCandidateInput {
+    candidate_id: string;
+    action: MiningCandidateAction;
+    organization_id?: string;
+    rationale?: string;
+    /** Optional actor identity; platform may default from auth context. */
+    actor?: string;
+}
+export interface ActOnCandidateResult {
+    candidate_id?: string;
+    action?: MiningCandidateAction | string;
+    status?: MiningCandidateStatus | string;
+    artifact_ref?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=mining-types.d.ts.map

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

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

package/dist/client/mining-types.js

@@ -0,0 +1,14 @@
+/**
+ * Context mining API types (MCP: loxtep_review mining ops).
+ * MCP ops: run_mining_pass, list_candidates, act_on_candidate.
+ *
+ * REST (graph):
+ *   POST /graph/organizations/{org}/mining/run
+ *   GET  /graph/organizations/{org}/mining/candidates
+ *   POST /graph/organizations/{org}/mining/candidates/{candidate_id}/act
+ *
+ * Invariant: mining only surfaces candidates — never auto-commits.
+ * act_on_candidate(approve) routes through CDLC at `in_review`.
+ */
+export {};
+//# sourceMappingURL=mining-types.js.map

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

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

package/dist/client/mining.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Context mining API (MCP: loxtep_review — run_mining_pass, list_candidates, act_on_candidate).
+ *
+ * REST:
+ *   POST /graph/organizations/{org}/mining/run
+ *   GET  /graph/organizations/{org}/mining/candidates
+ *   POST /graph/organizations/{org}/mining/candidates/{candidate_id}/act
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import type { ActOnCandidateInput, ActOnCandidateResult, ListCandidatesFilters, ListCandidatesResult, MiningApiDeps, RunMiningPassInput, RunMiningPassResult } from './mining-types.js';
+export interface MiningApi {
+    run_mining_pass: (input?: RunMiningPassInput) => Promise<RunMiningPassResult>;
+    list_candidates: (filters?: ListCandidatesFilters) => Promise<ListCandidatesResult>;
+    act_on_candidate: (input: ActOnCandidateInput) => Promise<ActOnCandidateResult>;
+}
+export declare function createMiningApi(http: LoxtepHttpClient, deps?: MiningApiDeps): MiningApi;
+//# sourceMappingURL=mining.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mining.d.ts","sourceRoot":"","sources":["../../src/client/mining.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AA2E3B,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE,CAAC,KAAK,CAAC,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC9E,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpF,gBAAgB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,GAAE,aAAkB,GAAG,SAAS,CA2C3F"}

package/dist/client/mining.js

@@ -0,0 +1,115 @@
+/**
+ * Context mining API (MCP: loxtep_review — run_mining_pass, list_candidates, act_on_candidate).
+ *
+ * REST:
+ *   POST /graph/organizations/{org}/mining/run
+ *   GET  /graph/organizations/{org}/mining/candidates
+ *   POST /graph/organizations/{org}/mining/candidates/{candidate_id}/act
+ */
+function unwrapData(res) {
+    return (res.data ?? res);
+}
+function requireOrg(deps, override) {
+    const org = override ?? deps.organization_id;
+    if (!org) {
+        throw new Error('organization_id is required for mining calls (set it on the client or pass it explicitly)');
+    }
+    return org;
+}
+function orgBase(org) {
+    return `/graph/organizations/${encodeURIComponent(org)}/mining`;
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
+function normalizeCandidate(row) {
+    const provenance = row.provenance_refs ?? row.provenanceRefs;
+    return {
+        ...row,
+        id: String(row.id ?? row.candidate_id ?? row.candidateId ?? ''),
+        candidate_type: String(row.candidate_type ?? row.candidateType ?? 'unknown'),
+        status: String(row.status ?? 'candidate'),
+        payload: (asRecord(row.payload) ?? {}),
+        provenance_refs: Array.isArray(provenance)
+            ? provenance.map(String)
+            : [],
+        mining_run_id: row.mining_run_id ??
+            row.miningRunId ??
+            null,
+        organization_id: String(row.organization_id ?? row.organizationId ?? ''),
+        created_at: row.created_at ??
+            row.createdAt,
+        resolved_at: row.resolved_at ??
+            row.resolvedAt ??
+            null,
+        resolved_by: row.resolved_by ??
+            row.resolvedBy ??
+            null,
+    };
+}
+function normalizeCandidates(payload) {
+    const obj = asRecord(payload);
+    let rows = [];
+    if (Array.isArray(payload)) {
+        rows = payload;
+    }
+    else if (obj) {
+        if (Array.isArray(obj.candidates))
+            rows = obj.candidates;
+        else if (Array.isArray(obj.items))
+            rows = obj.items;
+    }
+    const candidates = rows
+        .filter((r) => !!r && typeof r === 'object')
+        .map(normalizeCandidate);
+    const total = typeof obj?.total === 'number' ? obj.total : candidates.length;
+    return { candidates, total };
+}
+export function createMiningApi(http, deps = {}) {
+    return {
+        async run_mining_pass(input = {}) {
+            const org = requireOrg(deps, input.organization_id);
+            const path = `${orgBase(org)}/run`;
+            const res = await http.post(path, {
+                signal_sources: input.signal_sources ?? null,
+                scope_filters: input.scope_filters ?? null,
+            });
+            const payload = unwrapData(res) ?? {};
+            return payload;
+        },
+        async list_candidates(filters = {}) {
+            const org = requireOrg(deps, filters.organization_id);
+            const search = new URLSearchParams();
+            if (filters.candidate_type)
+                search.set('candidate_type', filters.candidate_type);
+            if (filters.status)
+                search.set('status', filters.status);
+            if (filters.mining_run_id)
+                search.set('mining_run_id', filters.mining_run_id);
+            const qs = search.toString() ? `?${search.toString()}` : '';
+            const res = await http.get(`${orgBase(org)}/candidates${qs}`);
+            return normalizeCandidates(unwrapData(res));
+        },
+        async act_on_candidate(input) {
+            const org = requireOrg(deps, input.organization_id);
+            if (!input.candidate_id) {
+                throw new Error('candidate_id is required for act_on_candidate');
+            }
+            const path = `${orgBase(org)}/candidates/${encodeURIComponent(input.candidate_id)}/act`;
+            const res = await http.post(path, {
+                action: input.action,
+                ...(input.rationale != null ? { rationale: input.rationale } : {}),
+                ...(input.actor != null ? { actor: input.actor } : {}),
+            });
+            const payload = unwrapData(res) ?? {};
+            return {
+                candidate_id: payload.candidate_id ?? input.candidate_id,
+                action: payload.action ?? input.action,
+                ...payload,
+            };
+        },
+    };
+}
+//# sourceMappingURL=mining.js.map

package/dist/client/mining.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mining.js","sourceRoot":"","sources":["../../src/client/mining.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,SAAS,UAAU,CAAI,GAAY;IACjC,OAAO,CAAE,GAAoB,CAAC,IAAI,IAAI,GAAG,CAAM,CAAC;AAClD,CAAC;AAED,SAAS,UAAU,CAAC,IAAmB,EAAE,QAAiB;IACxD,MAAM,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,eAAe,CAAC;IAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,wBAAwB,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC;AAClE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,kBAAkB,CAAC,GAA4B;IACtD,MAAM,UAAU,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,cAAc,CAAC;IAC7D,OAAO;QACL,GAAG,GAAG;QACN,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAC/D,cAAc,EAAE,MAAM,CACpB,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,aAAa,IAAI,SAAS,CAChB;QACtC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,WAAW,CAA8B;QACtE,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAA4B;QACjE,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YACxC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YACxB,CAAC,CAAC,EAAE;QACN,aAAa,EACV,GAAG,CAAC,aAA2C;YAC/C,GAAG,CAAC,WAAyC;YAC9C,IAAI;QACN,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QACxE,UAAU,EACP,GAAG,CAAC,UAAiC;YACrC,GAAG,CAAC,SAAgC;QACvC,WAAW,EACR,GAAG,CAAC,WAAyC;YAC7C,GAAG,CAAC,UAAwC;YAC7C,IAAI;QACN,WAAW,EACR,GAAG,CAAC,WAAyC;YAC7C,GAAG,CAAC,UAAwC;YAC7C,IAAI;KACP,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAgB;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,IAAI,GAAc,EAAE,CAAC;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAG,OAAO,CAAC;IACjB,CAAC;SAAM,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC;aACpD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC;IACtD,CAAC;IACD,MAAM,UAAU,GAAG,IAAI;SACpB,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;SACzE,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC3B,MAAM,KAAK,GACT,OAAO,GAAG,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;IACjE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC;AAQD,MAAM,UAAU,eAAe,CAAC,IAAsB,EAAE,OAAsB,EAAE;IAC9E,OAAO;QACL,KAAK,CAAC,eAAe,CAAC,QAA4B,EAAE;YAClD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAU,IAAI,EAAE;gBACzC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;gBAC5C,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,IAAI;aAC3C,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAA0B,GAAG,CAAC,IAAI,EAAE,CAAC;YAC/D,OAAO,OAA8B,CAAC;QACxC,CAAC;QAED,KAAK,CAAC,eAAe,CAAC,UAAiC,EAAE;YACvD,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,cAAc;gBAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;YACjF,IAAI,OAAO,CAAC,MAAM;gBAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,aAAa;gBAAE,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;YAC9E,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAU,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YACvE,OAAO,mBAAmB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,KAA0B;YAC/C,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;YACD,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC;YACxF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAU,IAAI,EAAE;gBACzC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAA0B,GAAG,CAAC,IAAI,EAAE,CAAC;YAC/D,OAAO;gBACL,YAAY,EAAG,OAAO,CAAC,YAAmC,IAAI,KAAK,CAAC,YAAY;gBAChF,MAAM,EAAG,OAAO,CAAC,MAA6B,IAAI,KAAK,CAAC,MAAM;gBAC9D,GAAG,OAAO;aACX,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,91 @@
+/**
+ * Ontology concepts + relationships types (LOX-1241).
+ * Backend: /graph/organizations/:organization_id/ontology/{concepts,relationships}
+ */
+export type OntologyNodeType = 'entity' | 'microservice' | 'taxonomy' | 'pattern' | 'custom';
+export interface OntologyApiDeps {
+    organization_id?: string;
+}
+export interface OntologyConcept {
+    concept_id: string;
+    organization_id?: string;
+    name: string;
+    namespace: string;
+    node_type: OntologyNodeType | string;
+    description?: string;
+    uri?: string;
+    parent_concepts?: string[];
+    created_at?: string;
+    updated_at?: string;
+    tombstoned_at?: string;
+    lifecycle_state?: string | null;
+    change_propagation_policy?: string | null;
+    owner?: string | null;
+}
+export interface OntologyConceptListResult {
+    concepts: OntologyConcept[];
+    total: number;
+}
+export interface OntologyListConceptsFilters {
+    organization_id?: string;
+    namespace?: string;
+    node_type?: OntologyNodeType | string;
+}
+export interface OntologyCreateConceptInput {
+    name: string;
+    namespace: string;
+    node_type: OntologyNodeType;
+    description?: string;
+    uri?: string;
+    parent_concepts?: string[];
+    organization_id?: string;
+}
+export interface OntologyUpdateConceptInput {
+    description?: string;
+    namespace?: string;
+    node_type?: OntologyNodeType;
+    uri?: string;
+    organization_id?: string;
+}
+export interface OntologyDeleteConceptResult {
+    concept: OntologyConcept;
+    warnings?: string[];
+}
+export interface OntologyRelationship {
+    relationship_id?: string;
+    organization_id?: string;
+    source_entity_type: string;
+    target_entity_type: string;
+    relation_type: string;
+    relation_uri?: string;
+    join_field?: string;
+    description?: string;
+    created_at?: string;
+    source?: 'registry' | 'discovered' | 'authored' | 'merged';
+    confidence?: number;
+    namespace?: string;
+}
+export interface OntologyRelationshipsResult {
+    relationships: OntologyRelationship[];
+    total: number;
+    source?: 'registry' | 'discovered' | 'merged';
+}
+export interface OntologyCreateRelationshipInput {
+    source_entity_type: string;
+    target_entity_type: string;
+    relation_type: string;
+    relation_uri?: string;
+    join_field?: string;
+    description?: string;
+    organization_id?: string;
+}
+export interface OntologyGetRelationshipsFilters {
+    organization_id?: string;
+    include_discovered?: boolean;
+    limit?: number;
+    source_entity_type?: string;
+    target_entity_type?: string;
+    relation_type?: string;
+    namespace?: string;
+}
+//# sourceMappingURL=ontology-types.d.ts.map

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

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

package/dist/client/ontology-types.js

@@ -0,0 +1,6 @@
+/**
+ * Ontology concepts + relationships types (LOX-1241).
+ * Backend: /graph/organizations/:organization_id/ontology/{concepts,relationships}
+ */
+export {};
+//# sourceMappingURL=ontology-types.js.map

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

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

package/dist/client/ontology.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Ontology API (LOX-1241). Concepts CRUD + relationships create/list.
+ * MCP: loxtep_meaning ontology_* ops.
+ *
+ *   GET    /graph/organizations/{org}/ontology/concepts
+ *   GET    /graph/organizations/{org}/ontology/concepts/{concept_id}
+ *   POST   /graph/organizations/{org}/ontology/concepts
+ *   PUT    /graph/organizations/{org}/ontology/concepts/{concept_id}
+ *   DELETE /graph/organizations/{org}/ontology/concepts/{concept_id}
+ *   GET    /graph/organizations/{org}/ontology/relationships
+ *   POST   /graph/organizations/{org}/ontology/relationships
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import type { OntologyApiDeps, OntologyConcept, OntologyConceptListResult, OntologyCreateConceptInput, OntologyCreateRelationshipInput, OntologyDeleteConceptResult, OntologyGetRelationshipsFilters, OntologyListConceptsFilters, OntologyRelationship, OntologyRelationshipsResult, OntologyUpdateConceptInput } from './ontology-types.js';
+export declare function createOntologyApi(http: LoxtepHttpClient, deps?: OntologyApiDeps): {
+    list_concepts: (filters?: OntologyListConceptsFilters) => Promise<OntologyConceptListResult>;
+    get_concept: (concept_id: string, organization_id?: string) => Promise<OntologyConcept>;
+    create_concept: (input: OntologyCreateConceptInput) => Promise<OntologyConcept>;
+    update_concept: (concept_id: string, input: OntologyUpdateConceptInput) => Promise<OntologyConcept>;
+    delete_concept: (concept_id: string, organization_id?: string) => Promise<OntologyDeleteConceptResult>;
+    create_relationship: (input: OntologyCreateRelationshipInput) => Promise<OntologyRelationship>;
+    get_relationships: (filters?: OntologyGetRelationshipsFilters) => Promise<OntologyRelationshipsResult>;
+    /** Alias for get_relationships (GA meaning hub list path). */
+    list_relationships: (filters?: OntologyGetRelationshipsFilters) => Promise<OntologyRelationshipsResult>;
+};
+export type OntologyApi = ReturnType<typeof createOntologyApi>;
+//# sourceMappingURL=ontology.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ontology.d.ts","sourceRoot":"","sources":["../../src/client/ontology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,0BAA0B,EAC1B,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,2BAA2B,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAwB7B,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,IAAI,GAAE,eAAoB,GACzB;IACD,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,2BAA2B,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7F,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACxF,cAAc,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAChF,cAAc,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,0BAA0B,KAC9B,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,cAAc,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,KACrB,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1C,mBAAmB,EAAE,CACnB,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,iBAAiB,EAAE,CACjB,OAAO,CAAC,EAAE,+BAA+B,KACtC,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,kBAAkB,EAAE,CAClB,OAAO,CAAC,EAAE,+BAA+B,KACtC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CAC3C,CAwIA;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/client/ontology.js

@@ -0,0 +1,146 @@
+/**
+ * Ontology API (LOX-1241). Concepts CRUD + relationships create/list.
+ * MCP: loxtep_meaning ontology_* ops.
+ *
+ *   GET    /graph/organizations/{org}/ontology/concepts
+ *   GET    /graph/organizations/{org}/ontology/concepts/{concept_id}
+ *   POST   /graph/organizations/{org}/ontology/concepts
+ *   PUT    /graph/organizations/{org}/ontology/concepts/{concept_id}
+ *   DELETE /graph/organizations/{org}/ontology/concepts/{concept_id}
+ *   GET    /graph/organizations/{org}/ontology/relationships
+ *   POST   /graph/organizations/{org}/ontology/relationships
+ */
+function unwrapData(res) {
+    return (res.data ?? res);
+}
+function requireOrg(deps, override) {
+    const org = override ?? deps.organization_id;
+    if (!org) {
+        throw new Error('organization_id is required for ontology calls (set it on the client or pass it explicitly)');
+    }
+    return org;
+}
+function conceptsBase(org) {
+    return `/graph/organizations/${encodeURIComponent(org)}/ontology/concepts`;
+}
+function relationshipsBase(org) {
+    return `/graph/organizations/${encodeURIComponent(org)}/ontology/relationships`;
+}
+export function createOntologyApi(http, deps = {}) {
+    const api = {
+        async list_concepts(filters = {}) {
+            const org = requireOrg(deps, filters.organization_id);
+            const search = new URLSearchParams();
+            if (filters.namespace)
+                search.set('namespace', filters.namespace);
+            if (filters.node_type)
+                search.set('node_type', String(filters.node_type));
+            const qs = search.toString();
+            const res = await http.get(`${conceptsBase(org)}${qs ? `?${qs}` : ''}`);
+            const data = unwrapData(res);
+            if (Array.isArray(data)) {
+                return { concepts: data, total: data.length };
+            }
+            return {
+                concepts: data?.concepts ?? [],
+                total: data?.total ?? data?.concepts?.length ?? 0,
+            };
+        },
+        async get_concept(concept_id, organization_id) {
+            if (!concept_id)
+                throw new Error('concept_id is required');
+            const org = requireOrg(deps, organization_id);
+            const res = await http.get(`${conceptsBase(org)}/${encodeURIComponent(concept_id)}`);
+            return unwrapData(res);
+        },
+        async create_concept(input) {
+            const org = requireOrg(deps, input.organization_id);
+            const body = {
+                name: input.name,
+                namespace: input.namespace,
+                node_type: input.node_type,
+                description: input.description,
+                uri: input.uri,
+                parent_concepts: input.parent_concepts,
+            };
+            const res = await http.post(conceptsBase(org), body);
+            return unwrapData(res);
+        },
+        async update_concept(concept_id, input) {
+            if (!concept_id)
+                throw new Error('concept_id is required');
+            const org = requireOrg(deps, input.organization_id);
+            const body = {};
+            if (input.description !== undefined)
+                body.description = input.description;
+            if (input.namespace !== undefined)
+                body.namespace = input.namespace;
+            if (input.node_type !== undefined)
+                body.node_type = input.node_type;
+            if (input.uri !== undefined)
+                body.uri = input.uri;
+            const res = await http.put(`${conceptsBase(org)}/${encodeURIComponent(concept_id)}`, body);
+            return unwrapData(res);
+        },
+        async delete_concept(concept_id, organization_id) {
+            if (!concept_id)
+                throw new Error('concept_id is required');
+            const org = requireOrg(deps, organization_id);
+            const res = await http.delete(`${conceptsBase(org)}/${encodeURIComponent(concept_id)}`);
+            const envelope = res;
+            const concept = unwrapData(res);
+            return {
+                concept,
+                warnings: envelope.warnings,
+            };
+        },
+        async create_relationship(input) {
+            const org = requireOrg(deps, input.organization_id);
+            const body = {
+                source_entity_type: input.source_entity_type,
+                target_entity_type: input.target_entity_type,
+                relation_type: input.relation_type,
+                relation_uri: input.relation_uri,
+                join_field: input.join_field,
+                description: input.description,
+            };
+            const res = await http.post(relationshipsBase(org), body);
+            return unwrapData(res);
+        },
+        async get_relationships(filters = {}) {
+            const org = requireOrg(deps, filters.organization_id);
+            const search = new URLSearchParams();
+            if (filters.include_discovered !== undefined) {
+                search.set('include_discovered', filters.include_discovered ? 'true' : 'false');
+            }
+            if (filters.limit !== undefined)
+                search.set('limit', String(filters.limit));
+            if (filters.source_entity_type) {
+                search.set('source_entity_type', filters.source_entity_type);
+            }
+            if (filters.target_entity_type) {
+                search.set('target_entity_type', filters.target_entity_type);
+            }
+            if (filters.relation_type)
+                search.set('relation_type', filters.relation_type);
+            if (filters.namespace)
+                search.set('namespace', filters.namespace);
+            const qs = search.toString();
+            const res = await http.get(`${relationshipsBase(org)}${qs ? `?${qs}` : ''}`);
+            const data = unwrapData(res);
+            if (Array.isArray(data)) {
+                return { relationships: data, total: data.length };
+            }
+            return {
+                relationships: data?.relationships ?? [],
+                total: data?.total ?? data?.relationships?.length ?? 0,
+                source: data?.source,
+            };
+        },
+        list_relationships(filters) {
+            return api.get_relationships(filters);
+        },
+    };
+    return api;
+}
+//# sourceMappingURL=ontology.js.map

package/dist/client/ontology.js.map

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

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

@@ -0,0 +1,48 @@
+/**
+ * Vocabulary pack lifecycle types (LOX-1242).
+ * MCP: list_available_packs / activate_vocabulary_pack / get_pack_activation_status
+ * under loxtep_meaning (semantic-layer), not loxtep_define.
+ */
+export type PackActivationState = 'no_pack_active' | 'activating' | 'pack_active';
+export interface PackActivationStatus {
+    activation_state: PackActivationState;
+    active_pack_id: string | null;
+    active_pack_version: string | null;
+    active_pack_display_name: string | null;
+    enabled_at: string | null;
+}
+export interface AvailablePackSummary {
+    pack_id: string;
+    display_name: string;
+    term_count?: number;
+    version?: string;
+    industry_relevance?: string;
+    [key: string]: unknown;
+}
+/**
+ * Shape documented for MCP `list_available_packs`
+ * (GET /graph/admin/vocabulary-packs/recommend).
+ */
+export interface ListAvailablePacksResult {
+    recommended_pack_id?: string | null;
+    confidence?: 'high' | 'medium' | 'low' | string;
+    reason?: string;
+    all_packs: AvailablePackSummary[];
+    [key: string]: unknown;
+}
+export interface ActivateVocabularyPackInput {
+    pack_id: string;
+    /** Required by POST .../enable body; defaults to client organization_id. */
+    organization_id?: string;
+}
+export interface ActivateVocabularyPackResult {
+    pack_id: string;
+    organization_id: string;
+    enabled: boolean;
+    enabled_at: string;
+    [key: string]: unknown;
+}
+export interface PacksApiDeps {
+    organization_id?: string;
+}
+//# sourceMappingURL=packs-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packs-types.d.ts","sourceRoot":"","sources":["../../src/client/packs-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/client/packs-types.js

@@ -0,0 +1,7 @@
+/**
+ * Vocabulary pack lifecycle types (LOX-1242).
+ * MCP: list_available_packs / activate_vocabulary_pack / get_pack_activation_status
+ * under loxtep_meaning (semantic-layer), not loxtep_define.
+ */
+export {};
+//# sourceMappingURL=packs-types.js.map

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

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

package/dist/client/packs.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Vocabulary pack lifecycle API (LOX-1242).
+ * MCP loxtep_meaning ops (semantic-layer REST) — not loxtep_define.
+ *
+ *   GET  /graph/admin/vocabulary-packs/recommend
+ *   POST /graph/admin/vocabulary-packs/{pack_id}/enable
+ *   GET  /graph/semantic-layer/activation-state
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import type { ActivateVocabularyPackInput, ActivateVocabularyPackResult, ListAvailablePacksResult, PackActivationStatus, PacksApiDeps } from './packs-types.js';
+/** Normalize camelCase (graph handler) or snake_case (MCP docs) activation payloads. */
+export declare function normalizePackActivationStatus(raw: unknown): PackActivationStatus;
+/** Normalize recommend payload, or wrap bare admin list arrays. */
+export declare function normalizeListAvailablePacksResult(raw: unknown): ListAvailablePacksResult;
+export declare function createPacksApi(http: LoxtepHttpClient, deps?: PacksApiDeps): {
+    list_available: () => Promise<ListAvailablePacksResult>;
+    /** MCP operation alias. */
+    list_available_packs: () => Promise<ListAvailablePacksResult>;
+    activate: (input: ActivateVocabularyPackInput | string) => Promise<ActivateVocabularyPackResult>;
+    /** MCP operation alias. */
+    activate_vocabulary_pack: (input: ActivateVocabularyPackInput | string) => Promise<ActivateVocabularyPackResult>;
+    get_activation_status: () => Promise<PackActivationStatus>;
+    /** MCP operation alias. */
+    get_pack_activation_status: () => Promise<PackActivationStatus>;
+};
+export type PacksApi = ReturnType<typeof createPacksApi>;
+//# sourceMappingURL=packs.d.ts.map