@loxtep/sdk 0.9.5 → 0.9.7

package/dist/client/process-intelligence-types.d.ts

@@ -1,6 +1,6 @@
 /**
- * Process Intelligence API types (LOX-1478, LOX-1627).
- * decision_traces list, entity context.
+ * Process Intelligence API types (LOX-1478, LOX-1627, LOX-1226).
+ * decision_traces list/create, causal chain, similar, entity context.
  */
 export interface GetEntityContextParams {
     entity_type: string;
@@ -42,4 +42,96 @@ export interface DecisionTracesListResponse {
         };
     };
 }
+/** Canonical causal / precedent relation types (LOX-1226). */
+export declare const CAUSAL_LINK_TYPES: readonly ["CAUSED", "INFLUENCED", "PRECEDENT_FOR"];
+export type CausalLinkType = (typeof CAUSAL_LINK_TYPES)[number];
+/** Known entity types for entity-level decision traces. */
+export declare const DECISION_TRACE_ENTITY_TYPES: readonly ["order", "customer", "return", "refund", "shipment", "subscription", "ticket", "product"];
+export type DecisionTraceEntityType = (typeof DECISION_TRACE_ENTITY_TYPES)[number];
+export interface CausalLinkInput {
+    target_trace_id: string;
+    relation_type: CausalLinkType;
+}
+/** POST /decision-traces entity-level body (includes optional LOX-1226 links). */
+export interface CreateDecisionTraceInput {
+    entity_type: DecisionTraceEntityType;
+    entity_id: string;
+    decision_point: string;
+    decision: string;
+    reason?: string;
+    is_exception?: boolean;
+    /** Convenience: write PRECEDENT_FOR from this precedent → new trace. */
+    precedent_id?: string;
+    /** Typed causal links from the new trace → targets. */
+    links?: CausalLinkInput[];
+    metadata?: Record<string, unknown>;
+}
+export interface CreatedCausalLink {
+    from_trace_id: string;
+    to_trace_id: string;
+    relation_type: string;
+}
+export interface CreateDecisionTraceResult {
+    trace_id: string;
+    entity_type: string;
+    entity_id: string;
+    decision_point: string;
+    decision: string;
+    reason: string | null;
+    is_exception: boolean;
+    precedent_id: string | null;
+    links: CreatedCausalLink[];
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    created_by: string;
+}
+export interface CreateDecisionTraceResponse {
+    success: true;
+    data: CreateDecisionTraceResult;
+}
+export type CausalChainDirection = 'forward' | 'backward' | 'both';
+export interface GetDecisionChainParams {
+    max_depth?: number;
+    direction?: CausalChainDirection;
+}
+export interface CausalChainHop {
+    from_trace_id: string;
+    to_trace_id: string;
+    relation_type: CausalLinkType;
+    /** Edge direction relative to the seed. */
+    direction: 'outgoing' | 'incoming';
+    depth: number;
+}
+export interface DecisionChainResult {
+    seed_trace_id: string;
+    nodes: string[];
+    hops: CausalChainHop[];
+}
+export interface GetDecisionChainResponse {
+    success: true;
+    data: DecisionChainResult;
+}
+export interface GetSimilarDecisionsParams {
+    limit?: number;
+}
+export interface SimilarDecisionCandidate {
+    trace_id: string;
+    decision_point: string;
+    decision: string | null;
+    entity_type: string | null;
+    entity_id: string | null;
+    is_exception: boolean;
+    precedent_id: string | null;
+    created_at: string;
+    score: number;
+    match_reasons: string[];
+}
+export interface SimilarDecisionsResult {
+    seed_trace_id: string;
+    items: SimilarDecisionCandidate[];
+}
+export interface GetSimilarDecisionsResponse {
+    success: true;
+    data: SimilarDecisionsResult;
+}
 //# sourceMappingURL=process-intelligence-types.d.ts.map

package/dist/client/process-intelligence-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-intelligence-types.d.ts","sourceRoot":"","sources":["../../src/client/process-intelligence-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACJ,KAAK,EAAE,qBAAqB,EAAE,CAAC;QAC/B,UAAU,EAAE;YACV,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"process-intelligence-types.d.ts","sourceRoot":"","sources":["../../src/client/process-intelligence-types.ts"],"names":[],"mappings":"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"}

package/dist/client/process-intelligence-types.js

@@ -1,6 +1,18 @@
 /**
- * Process Intelligence API types (LOX-1478, LOX-1627).
- * decision_traces list, entity context.
+ * Process Intelligence API types (LOX-1478, LOX-1627, LOX-1226).
+ * decision_traces list/create, causal chain, similar, entity context.
  */
-export {};
+/** Canonical causal / precedent relation types (LOX-1226). */
+export const CAUSAL_LINK_TYPES = ['CAUSED', 'INFLUENCED', 'PRECEDENT_FOR'];
+/** Known entity types for entity-level decision traces. */
+export const DECISION_TRACE_ENTITY_TYPES = [
+    'order',
+    'customer',
+    'return',
+    'refund',
+    'shipment',
+    'subscription',
+    'ticket',
+    'product',
+];
 //# sourceMappingURL=process-intelligence-types.js.map

package/dist/client/process-intelligence-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-intelligence-types.js","sourceRoot":"","sources":["../../src/client/process-intelligence-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"process-intelligence-types.js","sourceRoot":"","sources":["../../src/client/process-intelligence-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+CH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAU,CAAC;AAGpF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,cAAc;IACd,QAAQ;IACR,SAAS;CACD,CAAC"}

package/dist/client/process-intelligence.d.ts

@@ -1,16 +1,29 @@
 /**
- * Process Intelligence API: decision traces (LOX-1478), entity context (LOX-1627).
- * Backend: process-intelligence GET /organizations/:organization_id/decision-traces
- * and GET /organizations/:organization_id/context.
+ * Process Intelligence API: decision traces (LOX-1478), entity context (LOX-1627),
+ * causal chain / similar / linked create (LOX-1226).
+ *
+ * Backend (process-intelligence microservice):
+ *   GET  /organizations/:organization_id/decision-traces
+ *   POST /organizations/:organization_id/decision-traces
+ *   GET  /organizations/:organization_id/decision-traces/:trace_id/chain
+ *   GET  /organizations/:organization_id/decision-traces/:trace_id/similar
+ *   GET  /organizations/:organization_id/context
+ *
+ * Thin HTTP wrap only — platform owns graph walk / ranking logic.
  */
 import type { LoxtepHttpClient } from '../http/client.js';
-import type { DecisionTracesListParams, DecisionTracesListResponse, EntityContextResponse, GetEntityContextParams } from './process-intelligence-types.js';
+import type { CreateDecisionTraceInput, CreateDecisionTraceResult, DecisionChainResult, DecisionTracesListParams, DecisionTracesListResponse, EntityContextResponse, GetDecisionChainParams, GetEntityContextParams, GetSimilarDecisionsParams, SimilarDecisionsResult } from './process-intelligence-types.js';
+export type ProcessIntelligenceApi = ReturnType<typeof createProcessIntelligenceApi>;
 /**
- * Create the process intelligence API surface: decisionTraces.list, getEntityContext.
+ * Create the process intelligence API surface:
+ * decisionTraces.list / create / getChain / getSimilar, getEntityContext.
  */
 export declare function createProcessIntelligenceApi(http: LoxtepHttpClient): {
     decisionTraces: {
         list: (organizationId: string, params?: DecisionTracesListParams) => Promise<DecisionTracesListResponse['data']>;
+        create: (organizationId: string, body: CreateDecisionTraceInput) => Promise<CreateDecisionTraceResult>;
+        getChain: (organizationId: string, traceId: string, params?: GetDecisionChainParams) => Promise<DecisionChainResult>;
+        getSimilar: (organizationId: string, traceId: string, params?: GetSimilarDecisionsParams) => Promise<SimilarDecisionsResult>;
     };
     getEntityContext: (organizationId: string, params: GetEntityContextParams) => Promise<EntityContextResponse['data']>;
 };

package/dist/client/process-intelligence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-intelligence.d.ts","sourceRoot":"","sources":["../../src/client/process-intelligence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAoBzC;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,gBAAgB,GAAG;IACpE,cAAc,EAAE;QACd,IAAI,EAAE,CACJ,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,wBAAwB,KAC9B,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC;KAClD,CAAC;IACF,gBAAgB,EAAE,CAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,sBAAsB,KAC3B,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7C,CAwBA"}
+{"version":3,"file":"process-intelligence.d.ts","sourceRoot":"","sources":["../../src/client/process-intelligence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,wBAAwB,EAExB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EAEtB,sBAAsB,EACtB,yBAAyB,EAEzB,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AAsCzC,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAErF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,gBAAgB,GAAG;IACpE,cAAc,EAAE;QACd,IAAI,EAAE,CACJ,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,wBAAwB,KAC9B,OAAO,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,MAAM,EAAE,CACN,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,wBAAwB,KAC3B,OAAO,CAAC,yBAAyB,CAAC,CAAC;QACxC,QAAQ,EAAE,CACR,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,sBAAsB,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAClC,UAAU,EAAE,CACV,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,yBAAyB,KAC/B,OAAO,CAAC,sBAAsB,CAAC,CAAC;KACtC,CAAC;IACF,gBAAgB,EAAE,CAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,sBAAsB,KAC3B,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;CAC7C,CAoDA"}

package/dist/client/process-intelligence.js

@@ -1,7 +1,15 @@
 /**
- * Process Intelligence API: decision traces (LOX-1478), entity context (LOX-1627).
- * Backend: process-intelligence GET /organizations/:organization_id/decision-traces
- * and GET /organizations/:organization_id/context.
+ * Process Intelligence API: decision traces (LOX-1478), entity context (LOX-1627),
+ * causal chain / similar / linked create (LOX-1226).
+ *
+ * Backend (process-intelligence microservice):
+ *   GET  /organizations/:organization_id/decision-traces
+ *   POST /organizations/:organization_id/decision-traces
+ *   GET  /organizations/:organization_id/decision-traces/:trace_id/chain
+ *   GET  /organizations/:organization_id/decision-traces/:trace_id/similar
+ *   GET  /organizations/:organization_id/context
+ *
+ * Thin HTTP wrap only — platform owns graph walk / ranking logic.
  */
 const BASE = '/process-intelligence';
 function buildQuery(params) {
@@ -25,14 +33,48 @@ function buildQuery(params) {
     const qs = searchParams.toString();
     return qs ? `?${qs}` : '';
 }
+function buildChainQuery(params) {
+    if (!params)
+        return '';
+    const searchParams = new URLSearchParams();
+    if (params.max_depth != null)
+        searchParams.set('max_depth', String(params.max_depth));
+    if (params.direction != null)
+        searchParams.set('direction', params.direction);
+    const qs = searchParams.toString();
+    return qs ? `?${qs}` : '';
+}
+function buildSimilarQuery(params) {
+    if (!params || params.limit == null)
+        return '';
+    return `?limit=${encodeURIComponent(String(params.limit))}`;
+}
+function tracesBase(organizationId) {
+    return `${BASE}/organizations/${encodeURIComponent(organizationId)}/decision-traces`;
+}
 /**
- * Create the process intelligence API surface: decisionTraces.list, getEntityContext.
+ * Create the process intelligence API surface:
+ * decisionTraces.list / create / getChain / getSimilar, getEntityContext.
  */
 export function createProcessIntelligenceApi(http) {
     return {
         decisionTraces: {
             async list(organizationId, params) {
-                const path = `${BASE}/organizations/${encodeURIComponent(organizationId)}/decision-traces${buildQuery(params)}`;
+                const path = `${tracesBase(organizationId)}${buildQuery(params)}`;
+                const res = await http.get(path);
+                return res.data;
+            },
+            async create(organizationId, body) {
+                const res = await http.post(tracesBase(organizationId), body);
+                return res.data;
+            },
+            async getChain(organizationId, traceId, params) {
+                const path = `${tracesBase(organizationId)}/${encodeURIComponent(traceId)}/chain${buildChainQuery(params)}`;
+                const res = await http.get(path);
+                return res.data;
+            },
+            async getSimilar(organizationId, traceId, params) {
+                const path = `${tracesBase(organizationId)}/${encodeURIComponent(traceId)}/similar${buildSimilarQuery(params)}`;
                 const res = await http.get(path);
                 return res.data;
             },

package/dist/client/process-intelligence.js.map

@@ -1 +1 @@
-{"version":3,"file":"process-intelligence.js","sourceRoot":"","sources":["../../src/client/process-intelligence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,IAAI,GAAG,uBAAuB,CAAC;AAErC,SAAS,UAAU,CAAC,MAAiC;IACnD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAC3C,IAAI,MAAM,CAAC,eAAe,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAChG,IAAI,MAAM,CAAC,iBAAiB,IAAI,IAAI;QAClC,YAAY,CAAC,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,cAAc,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAC7F,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,SAAS;QAC1C,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3E,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,IAAI,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI;QAAE,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IACtF,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAsB;IAYjE,OAAO;QACL,cAAc,EAAE;YACd,KAAK,CAAC,IAAI,CACR,cAAsB,EACtB,MAAiC;gBAEjC,MAAM,IAAI,GAAG,GAAG,IAAI,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,mBAAmB,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAA6B,IAAI,CAAC,CAAC;gBAC7D,OAAO,GAAG,CAAC,IAAI,CAAC;YAClB,CAAC;SACF;QACD,KAAK,CAAC,gBAAgB,CACpB,cAAsB,EACtB,MAA8B;YAE9B,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;YAC3C,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YACpD,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,GAAG,IAAI,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,YAAY,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC9G,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAwB,IAAI,CAAC,CAAC;YACxD,OAAO,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"process-intelligence.js","sourceRoot":"","sources":["../../src/client/process-intelligence.ts"],"names":[],"mappings":"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"}

package/dist/client/review.d.ts

@@ -1,16 +1,22 @@
 /**
  * Review facade (MCP: loxtep_review).
- * Delegates to approvals and improvements APIs.
+ * Delegates to approvals, improvements, CDLC, and context-mining APIs.
  */
 import type { createApprovalsApi } from './approvals.js';
+import type { CdlcApi } from './cdlc.js';
 import type { ImprovementsApi } from './improvements.js';
+import type { MiningApi } from './mining.js';
 export interface ReviewFacadeDeps {
     approvals: ReturnType<typeof createApprovalsApi>;
     improvements: ImprovementsApi;
+    cdlc: CdlcApi;
+    mining: MiningApi;
 }
 export declare function createReviewFacade(deps: ReviewFacadeDeps): {
     approvals: ReviewFacadeDeps['approvals'];
     improvements: ReviewFacadeDeps['improvements'];
+    cdlc: ReviewFacadeDeps['cdlc'];
+    mining: ReviewFacadeDeps['mining'];
 };
 export type ReviewFacade = ReturnType<typeof createReviewFacade>;
 //# sourceMappingURL=review.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/client/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACjD,YAAY,EAAE,eAAe,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAC1D,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;CAChD,CAKA;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/client/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACjD,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAC1D,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,YAAY,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;CACpC,CAOA;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/client/review.js

@@ -1,11 +1,13 @@
 /**
  * Review facade (MCP: loxtep_review).
- * Delegates to approvals and improvements APIs.
+ * Delegates to approvals, improvements, CDLC, and context-mining APIs.
  */
 export function createReviewFacade(deps) {
     return {
         approvals: deps.approvals,
         improvements: deps.improvements,
+        cdlc: deps.cdlc,
+        mining: deps.mining,
     };
 }
 //# sourceMappingURL=review.js.map

package/dist/client/review.js.map

@@ -1 +1 @@
-{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/client/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IAIvD,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/client/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IAMvD,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/client/semantic-layer-types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Semantic layer search / artifact / completeness types (LOX-1243).
+ * MCP: search_semantic_layer, get_semantic_artifact, get_semantic_completeness
+ * under loxtep_meaning (semantic-layer MS), not loxtep_define.
+ */
+export type SemanticArtifactType = 'entity' | 'glossary_term' | 'process_map' | 'schema' | 'ontology' | 'governance_standard';
+export interface SearchSemanticLayerInput {
+    query: string;
+    artifact_types?: SemanticArtifactType[];
+    domain?: string;
+    industry_relevance?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface SemanticSearchResultItem {
+    artifact_type: string;
+    id: string;
+    name: string;
+    description: string | null;
+    relevance_score: number;
+    [key: string]: unknown;
+}
+export interface SemanticSearchPagination {
+    total: number;
+    page: number;
+    page_size: number;
+}
+export interface SearchSemanticLayerResult {
+    items: SemanticSearchResultItem[];
+    pagination: SemanticSearchPagination;
+    metadata?: {
+        activation_state?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface GetSemanticArtifactInput {
+    artifact_type: SemanticArtifactType;
+    /** Artifact UUID (MCP `id`). */
+    id?: string;
+    /** Alias for `id` (MCP `artifact_id`). */
+    artifact_id?: string;
+}
+export interface GetSemanticCompletenessInput {
+    domain_id?: string;
+}
+export interface DomainCompleteness {
+    domain_id: string;
+    total_schema_fields: number;
+    annotated_fields: number;
+    unannotated_fields: number;
+    coverage_percentage: number;
+    [key: string]: unknown;
+}
+export interface SemanticCompletenessResult {
+    domains: DomainCompleteness[];
+    needs_attention: DomainCompleteness[];
+    /** Present when MCP/SDK enrichment adds pack activation context. */
+    metadata?: {
+        activation_state?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+//# sourceMappingURL=semantic-layer-types.d.ts.map

package/dist/client/semantic-layer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-layer-types.d.ts","sourceRoot":"","sources":["../../src/client/semantic-layer-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,eAAe,GACf,aAAa,GACb,QAAQ,GACR,UAAU,GACV,qBAAqB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,wBAAwB,EAAE,CAAC;IAClC,UAAU,EAAE,wBAAwB,CAAC;IACrC,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,oBAAoB,CAAC;IACpC,gCAAgC;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/client/semantic-layer-types.js

@@ -0,0 +1,7 @@
+/**
+ * Semantic layer search / artifact / completeness types (LOX-1243).
+ * MCP: search_semantic_layer, get_semantic_artifact, get_semantic_completeness
+ * under loxtep_meaning (semantic-layer MS), not loxtep_define.
+ */
+export {};
+//# sourceMappingURL=semantic-layer-types.js.map

package/dist/client/semantic-layer-types.js.map

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

package/dist/client/semantic-layer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Semantic layer search / artifact / completeness API (LOX-1243).
+ * MCP loxtep_meaning ops (semantic-layer REST) — not packs/ontology graph admin.
+ *
+ *   POST /semantic-layer/search
+ *   GET  /semantic-layer/{artifact_type_plural}/{id}
+ *   GET  /semantic-layer/completeness[?domain_id=]
+ */
+import type { LoxtepHttpClient } from '../http/client.js';
+import type { GetSemanticArtifactInput, GetSemanticCompletenessInput, SearchSemanticLayerInput, SearchSemanticLayerResult, SemanticArtifactType, SemanticCompletenessResult } from './semantic-layer-types.js';
+/** Path segment used by MCP get_semantic_artifact (plural / kebab routes). */
+export declare function semanticArtifactPathSegment(artifactType: SemanticArtifactType | string): string;
+export declare function createSemanticLayerApi(http: LoxtepHttpClient): {
+    search: (input: SearchSemanticLayerInput | string) => Promise<SearchSemanticLayerResult>;
+    /** MCP operation alias. */
+    search_semantic_layer: (input: SearchSemanticLayerInput | string) => Promise<SearchSemanticLayerResult>;
+    get_artifact: (input: GetSemanticArtifactInput) => Promise<unknown>;
+    /** MCP operation alias. */
+    get_semantic_artifact: (input: GetSemanticArtifactInput) => Promise<unknown>;
+    get_completeness: (input?: GetSemanticCompletenessInput) => Promise<SemanticCompletenessResult>;
+    /** MCP operation alias. */
+    get_semantic_completeness: (input?: GetSemanticCompletenessInput) => Promise<SemanticCompletenessResult>;
+};
+export type SemanticLayerApi = ReturnType<typeof createSemanticLayerApi>;
+//# sourceMappingURL=semantic-layer.d.ts.map

package/dist/client/semantic-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-layer.d.ts","sourceRoot":"","sources":["../../src/client/semantic-layer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,0BAA0B,EAE3B,MAAM,2BAA2B,CAAC;AAYnC,8EAA8E;AAC9E,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAE/F;AAiDD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG;IAC9D,MAAM,EAAE,CAAC,KAAK,EAAE,wBAAwB,GAAG,MAAM,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACzF,2BAA2B;IAC3B,qBAAqB,EAAE,CACrB,KAAK,EAAE,wBAAwB,GAAG,MAAM,KACrC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,YAAY,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,2BAA2B;IAC3B,qBAAqB,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,gBAAgB,EAAE,CAChB,KAAK,CAAC,EAAE,4BAA4B,KACjC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IACzC,2BAA2B;IAC3B,yBAAyB,EAAE,CACzB,KAAK,CAAC,EAAE,4BAA4B,KACjC,OAAO,CAAC,0BAA0B,CAAC,CAAC;CAC1C,CAiDA;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/client/semantic-layer.js

@@ -0,0 +1,100 @@
+/**
+ * Semantic layer search / artifact / completeness API (LOX-1243).
+ * MCP loxtep_meaning ops (semantic-layer REST) — not packs/ontology graph admin.
+ *
+ *   POST /semantic-layer/search
+ *   GET  /semantic-layer/{artifact_type_plural}/{id}
+ *   GET  /semantic-layer/completeness[?domain_id=]
+ */
+function unwrapData(res) {
+    return (res.data ?? res);
+}
+const SEMANTIC_ARTIFACT_PATH_SEGMENT = {
+    entity: 'entities',
+    glossary_term: 'glossary',
+    process_map: 'process-maps',
+};
+/** Path segment used by MCP get_semantic_artifact (plural / kebab routes). */
+export function semanticArtifactPathSegment(artifactType) {
+    return SEMANTIC_ARTIFACT_PATH_SEGMENT[artifactType] ?? artifactType;
+}
+function normalizeSearchResult(raw) {
+    const rec = raw != null && typeof raw === 'object' && !Array.isArray(raw)
+        ? raw
+        : {};
+    const itemsRaw = Array.isArray(rec.items) ? rec.items : [];
+    const items = itemsRaw.filter((item) => item != null && typeof item === 'object' && !Array.isArray(item));
+    const paginationRaw = rec.pagination != null && typeof rec.pagination === 'object' && !Array.isArray(rec.pagination)
+        ? rec.pagination
+        : {};
+    const page = typeof paginationRaw.page === 'number' ? paginationRaw.page : 1;
+    const page_size = typeof paginationRaw.page_size === 'number' ? paginationRaw.page_size : 20;
+    const total = typeof paginationRaw.total === 'number' ? paginationRaw.total : items.length;
+    return {
+        ...rec,
+        items,
+        pagination: { total, page, page_size },
+    };
+}
+function normalizeCompleteness(raw) {
+    const rec = raw != null && typeof raw === 'object' && !Array.isArray(raw)
+        ? raw
+        : {};
+    const domains = Array.isArray(rec.domains) ? rec.domains : [];
+    const needs_attention = Array.isArray(rec.needs_attention) ? rec.needs_attention : [];
+    return {
+        ...rec,
+        domains: domains,
+        needs_attention: needs_attention,
+    };
+}
+function resolveArtifactId(input) {
+    const id = input.id ?? input.artifact_id ?? '';
+    if (!id) {
+        throw new Error('Either id or artifact_id is required for get_artifact');
+    }
+    return id;
+}
+export function createSemanticLayerApi(http) {
+    async function search(input) {
+        const body = typeof input === 'string' ? { query: input } : input;
+        if (!body.query) {
+            throw new Error('query is required for semantic layer search');
+        }
+        const res = await http.post('/semantic-layer/search', {
+            query: body.query,
+            artifact_types: body.artifact_types,
+            domain: body.domain,
+            industry_relevance: body.industry_relevance,
+            page: body.page ?? 1,
+            page_size: body.page_size ?? 20,
+        });
+        return normalizeSearchResult(unwrapData(res));
+    }
+    async function get_artifact(input) {
+        if (!input.artifact_type) {
+            throw new Error('artifact_type is required for get_artifact');
+        }
+        const id = resolveArtifactId(input);
+        const segment = semanticArtifactPathSegment(input.artifact_type);
+        const path = `/semantic-layer/${segment}/${encodeURIComponent(id)}`;
+        const res = await http.get(path);
+        return unwrapData(res);
+    }
+    async function get_completeness(input = {}) {
+        const qs = input.domain_id
+            ? `?domain_id=${encodeURIComponent(input.domain_id)}`
+            : '';
+        const res = await http.get(`/semantic-layer/completeness${qs}`);
+        return normalizeCompleteness(unwrapData(res));
+    }
+    return {
+        search,
+        search_semantic_layer: search,
+        get_artifact,
+        get_semantic_artifact: get_artifact,
+        get_completeness,
+        get_semantic_completeness: get_completeness,
+    };
+}
+//# sourceMappingURL=semantic-layer.js.map

package/dist/client/semantic-layer.js.map

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

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

@@ -1,8 +1,15 @@
 /**
  * Loxtep stream runtime factory for the Node SDK data plane (ESM interop with the underlying runtime).
+ *
+ * IMPORTANT: do not statically `import 'leo-sdk'`. leo-sdk's `leoConfigure.js` runs
+ * `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.
+ *
+ * Lazy load must not use a bare `import.meta` in this file — Jest's CJS transform
+ * rejects it. Resolve the module URL via Function so ESM runtime still works.
  */
-import * as StreamRuntime from 'leo-sdk';
-export declare function createRStreamsSdk(config: StreamRuntime.ConfigurationResources): StreamRuntime.RStreamsSdk;
+import type { ConfigurationResources, RStreamsSdk } from 'leo-sdk';
+export declare function createRStreamsSdk(config: ConfigurationResources): 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;;GAEG;AAEH,OAAO,KAAK,aAAa,MAAM,SAAS,CAAC;AAEzC,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,CAAC,sBAAsB,GAC3C,aAAa,CAAC,WAAW,CAU3B;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;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAcnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,WAAW,CAW7E;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

@@ -1,11 +1,25 @@
 /**
  * Loxtep stream runtime factory for the Node SDK data plane (ESM interop with the underlying runtime).
+ *
+ * IMPORTANT: do not statically `import 'leo-sdk'`. leo-sdk's `leoConfigure.js` runs
+ * `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.
+ *
+ * Lazy load must not use a bare `import.meta` in this file — Jest's CJS transform
+ * rejects it. Resolve the module URL via Function so ESM runtime still works.
  */
-import * as StreamRuntime from 'leo-sdk';
+import { createRequire } from 'node:module';
+function loadLeoSdk() {
+    // Hide import.meta from static transforms (Jest); evaluate only in real ESM.
+    const moduleUrl = new Function('return import.meta.url')();
+    const requireCjs = createRequire(moduleUrl);
+    return requireCjs('leo-sdk');
+}
 export function createRStreamsSdk(config) {
-    const mod = StreamRuntime;
-    const defaultExport = mod.default;
-    const SDK = (mod.RStreamsSdk || defaultExport?.RStreamsSdk);
+    // Lazy CJS require — only when a stream reader/writer is actually constructed.
+    const StreamRuntime = loadLeoSdk();
+    const defaultExport = StreamRuntime.default;
+    const SDK = (StreamRuntime.RStreamsSdk || defaultExport?.RStreamsSdk);
     if (!SDK || typeof SDK !== 'function') {
         throw new Error('Failed to resolve RStreamsSdk constructor from leo-sdk');
     }

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;;GAEG;AAEH,OAAO,KAAK,aAAa,MAAM,SAAS,CAAC;AAEzC,MAAM,UAAU,iBAAiB,CAC/B,MAA4C;IAE5C,MAAM,GAAG,GAAG,aAAmD,CAAC;IAChE,MAAM,aAAa,GAAG,GAAG,CAAC,OAA8C,CAAC;IACzE,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,aAAa,EAAE,WAAW,CAE7C,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;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ5C,SAAS,UAAU;IACjB,6EAA6E;IAC7E,MAAM,SAAS,GAAG,IAAI,QAAQ,CAAC,wBAAwB,CAAC,EAAY,CAAC;IACrE,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,SAAS,CAAiB,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC9D,+EAA+E;IAC/E,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;IACnC,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"}