@x12i/memorix-service 3.0.6 → 3.2.0

package/README.md

@@ -69,7 +69,7 @@ curl -s http://127.0.0.1:5100/api/diagnostics/scope \
 
 | Family | Role |
 |--------|------|
-| `/api/metadata` | Kinds, definitions, install/publish, optional pack versions (`METADATA_MAGIT=1`) |
+| `/api/metadata` | Kinds, definitions, install/publish, pack versions (Magit default-on; `METADATA_MAGIT=0` disables) |
 | `/api/data` | Content get/list/write, compose, abstract |
 | `/api/relationships` | Query / discover / verify / rebuild (**no** ad-hoc link PUT) |
 | `/api/memory` | Pull, raw, sources, **checkpoints**, schedules, runs, `commit-page`, connection probe |
@@ -78,6 +78,13 @@ curl -s http://127.0.0.1:5100/api/diagnostics/scope \
 | `/api/workflow` | Workflow sibling content |
 | `/api/intelligence` | Profiles / proposals (never auto-install) |
 | `/api/data-journey` | Evidence cone + expected-vs-filled coverage |
+| `/api/ai-services` | Companion AI-services (function / skill / task / graph) — list, items, invoke proxy |
+
+### AI-services companions
+
+Point memorix-service at FR-compliant processes via env (`FUNCX_URL`, `AI_SKILLS_URL`, `AI_TASKS_URL`, `GRAPH_ENGINE_URL`).  
+Stack: `AI_SERVICES=1 node scripts/dev-stack.mjs` or `--ai-services`.  
+Ops: [`.operational/ai-services-get-started.md`](../.operational/ai-services-get-started.md).
 
 ### Memory (operator + called-service)
 

package/dist/ai-services/associate-prep.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared KnowX associate input prep — slim catalog, cap size, chunk drafts,
+ * merge classification / relationshipPlans across chunk invokes.
+ *
+ * Keep env knobs aligned with memorix-knowx-pack/src/associate-ai.ts:
+ *   KNOWX_AI_ASSOC_EXISTING_CAP (default 48)
+ *   KNOWX_AI_ASSOC_DRAFT_CHUNK (default 4)
+ *   KNOWX_AI_ASSOC_SUMMARY_CHARS (default 120)
+ *
+ * Large fat catalogs (full refs/provenance + long summaries) have caused the
+ * ai-skills companion to return ok:true with empty rawText after burning the
+ * full completion budget — keep prompts tight.
+ */
+export declare function associateExistingCap(): number;
+export declare function associateDraftChunkSize(): number;
+export declare function associateSummaryChars(): number;
+/** Slim a knowx API / draft record for the associate prompt. */
+export declare function slimKnowxForAssociate(raw: unknown, opts?: {
+    keepRefs?: boolean;
+}): Record<string, unknown> | null;
+export declare function draftKey(raw: unknown): string | null;
+/**
+ * Slim + exclude current drafts + cap existing catalog for associate prompt.
+ */
+export declare function prepareExistingKnowxForAssociate(input: {
+    existing: unknown[];
+    draftKeys?: Set<string>;
+    cap?: number;
+}): Record<string, unknown>[];
+export declare function slimDraftsForAssociate(drafts: unknown[]): Record<string, unknown>[];
+export declare function chunkArray<T>(items: T[], size: number): T[][];
+/**
+ * Merge chunked associate outputs; synthesize knowx-contradicts from
+ * classification.contradicts when plans omit them.
+ */
+export declare function mergeAssociateOutputs(chunks: Array<Record<string, unknown>>): Record<string, unknown>;
+//# sourceMappingURL=associate-prep.d.ts.map

package/dist/ai-services/associate-prep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate-prep.d.ts","sourceRoot":"","sources":["../../src/ai-services/associate-prep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AASD,gEAAgE;AAChE,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,OAAO,EACZ,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAyBhC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOpD;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAe5B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAYnF;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAO7D;AAqBD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2EzB"}

package/dist/ai-services/associate-prep.js

@@ -0,0 +1,208 @@
+/**
+ * Shared KnowX associate input prep — slim catalog, cap size, chunk drafts,
+ * merge classification / relationshipPlans across chunk invokes.
+ *
+ * Keep env knobs aligned with memorix-knowx-pack/src/associate-ai.ts:
+ *   KNOWX_AI_ASSOC_EXISTING_CAP (default 48)
+ *   KNOWX_AI_ASSOC_DRAFT_CHUNK (default 4)
+ *   KNOWX_AI_ASSOC_SUMMARY_CHARS (default 120)
+ *
+ * Large fat catalogs (full refs/provenance + long summaries) have caused the
+ * ai-skills companion to return ok:true with empty rawText after burning the
+ * full completion budget — keep prompts tight.
+ */
+function asRecord(v) {
+    return v && typeof v === "object" && !Array.isArray(v)
+        ? v
+        : null;
+}
+function envInt(name, fallback) {
+    const raw = process.env[name]?.trim();
+    if (!raw)
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : fallback;
+}
+export function associateExistingCap() {
+    return envInt("KNOWX_AI_ASSOC_EXISTING_CAP", 48);
+}
+export function associateDraftChunkSize() {
+    return envInt("KNOWX_AI_ASSOC_DRAFT_CHUNK", 4);
+}
+export function associateSummaryChars() {
+    return envInt("KNOWX_AI_ASSOC_SUMMARY_CHARS", 120);
+}
+function clipSummary(value, maxChars) {
+    if (typeof value !== "string")
+        return undefined;
+    const t = value.trim();
+    if (!t)
+        return undefined;
+    return t.length <= maxChars ? t : `${t.slice(0, maxChars - 1)}…`;
+}
+/** Slim a knowx API / draft record for the associate prompt. */
+export function slimKnowxForAssociate(raw, opts) {
+    const rec = asRecord(raw);
+    if (!rec)
+        return null;
+    const recordId = String(rec.recordId ?? "").trim();
+    if (!recordId)
+        return null;
+    const data = asRecord(rec.data) ?? {};
+    const objectType = String(rec.objectType ?? "content").trim() || "content";
+    const identity = asRecord(data.identity);
+    const dataOut = {
+        kind: data.kind,
+        label: data.label,
+        summary: clipSummary(data.summary, associateSummaryChars()),
+    };
+    if (identity?.category != null) {
+        dataOut.identity = { category: identity.category };
+    }
+    // Refs only on drafts when needed — catalog refs bloat prompts hard.
+    if (opts?.keepRefs && data.refs != null) {
+        dataOut.refs = data.refs;
+    }
+    return {
+        objectType,
+        recordId,
+        data: dataOut,
+    };
+}
+export function draftKey(raw) {
+    const rec = asRecord(raw);
+    if (!rec)
+        return null;
+    const recordId = String(rec.recordId ?? "").trim();
+    if (!recordId)
+        return null;
+    const objectType = String(rec.objectType ?? "content").trim() || "content";
+    return `${objectType}::${recordId}`;
+}
+/**
+ * Slim + exclude current drafts + cap existing catalog for associate prompt.
+ */
+export function prepareExistingKnowxForAssociate(input) {
+    const cap = input.cap ?? associateExistingCap();
+    const out = [];
+    const seen = new Set();
+    for (const raw of input.existing) {
+        const slim = slimKnowxForAssociate(raw, { keepRefs: false });
+        if (!slim)
+            continue;
+        const key = draftKey(slim);
+        if (!key || seen.has(key))
+            continue;
+        if (input.draftKeys?.has(key))
+            continue;
+        seen.add(key);
+        out.push(slim);
+        if (out.length >= cap)
+            break;
+    }
+    return out;
+}
+export function slimDraftsForAssociate(drafts) {
+    const out = [];
+    const seen = new Set();
+    for (const raw of drafts) {
+        const slim = slimKnowxForAssociate(raw, { keepRefs: true });
+        if (!slim)
+            continue;
+        const key = draftKey(slim);
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(slim);
+    }
+    return out;
+}
+export function chunkArray(items, size) {
+    const n = size > 0 ? size : 8;
+    const chunks = [];
+    for (let i = 0; i < items.length; i += n) {
+        chunks.push(items.slice(i, i + n));
+    }
+    return chunks.length ? chunks : [[]];
+}
+function planKey(p) {
+    return `${p.definitionId}|${p.from?.objectType}::${p.from?.recordId}|${p.to?.objectType}::${p.to?.recordId}`;
+}
+/**
+ * Merge chunked associate outputs; synthesize knowx-contradicts from
+ * classification.contradicts when plans omit them.
+ */
+export function mergeAssociateOutputs(chunks) {
+    const known = [];
+    const novel = [];
+    const contradicts = [];
+    const plans = [];
+    const seenPlans = new Set();
+    const pushPlan = (p) => {
+        const key = planKey(p);
+        if (!p.definitionId || !p.from?.recordId || !p.to?.recordId)
+            return;
+        if (seenPlans.has(key))
+            return;
+        seenPlans.add(key);
+        plans.push(p);
+    };
+    for (const chunk of chunks) {
+        const classification = asRecord(chunk.classification);
+        if (classification) {
+            if (Array.isArray(classification.known)) {
+                known.push(...classification.known);
+            }
+            if (Array.isArray(classification.novel)) {
+                novel.push(...classification.novel);
+            }
+            if (Array.isArray(classification.contradicts)) {
+                contradicts.push(...classification.contradicts);
+            }
+        }
+        if (Array.isArray(chunk.relationshipPlans)) {
+            for (const p of chunk.relationshipPlans) {
+                pushPlan(p);
+            }
+        }
+    }
+    for (const c of contradicts) {
+        if (!c.matchedRecordId || !c.draftRecordId)
+            continue;
+        pushPlan({
+            definitionId: "knowx-contradicts",
+            from: {
+                objectType: c.objectType || "content",
+                recordId: c.draftRecordId,
+            },
+            to: {
+                objectType: c.matchedObjectType || c.objectType || "content",
+                recordId: c.matchedRecordId,
+            },
+            reason: c.reason || "classification.contradicts",
+        });
+    }
+    for (const k of known) {
+        if (!k.matchedRecordId || !k.draftRecordId)
+            continue;
+        pushPlan({
+            definitionId: "knowx-same-as",
+            from: {
+                objectType: k.objectType || "content",
+                recordId: k.draftRecordId,
+            },
+            to: {
+                objectType: k.matchedObjectType || k.objectType || "content",
+                recordId: k.matchedRecordId,
+            },
+            reason: k.reason || "classification.known",
+        });
+    }
+    return {
+        classification: { known, novel, contradicts },
+        relationshipPlans: plans,
+        kind: "ai-services",
+        live: true,
+    };
+}
+//# sourceMappingURL=associate-prep.js.map

package/dist/ai-services/associate-prep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate-prep.js","sourceRoot":"","sources":["../../src/ai-services/associate-prep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACpD,CAAC,CAAE,CAA6B;QAChC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC5C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,MAAM,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,QAAgB;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC;AACnE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,qBAAqB,CACnC,GAAY,EACZ,IAA6B;IAE7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAC3E,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,OAAO,GAA4B;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,qBAAqB,EAAE,CAAC;KAC5D,CAAC;IACF,IAAI,QAAQ,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC/B,OAAO,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACrD,CAAC;IACD,qEAAqE;IACrE,IAAI,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAC3B,CAAC;IACD,OAAO;QACL,UAAU;QACV,QAAQ;QACR,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAC3E,OAAO,GAAG,UAAU,KAAK,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAAC,KAIhD;IACC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAChD,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,IAAI,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;YAAE,MAAM;IAC/B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,qBAAqB,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,KAAU,EAAE,IAAY;IACpD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC;AAiBD,SAAS,OAAO,CAAC,CAAmB;IAClC,OAAO,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC,EAAE,EAAE,UAAU,KAAK,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC/G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAsC;IAEtC,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpC,MAAM,QAAQ,GAAG,CAAC,CAAmB,EAAE,EAAE;QACvC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ;YAAE,OAAO;QACpE,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC/B,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC,GAAI,cAAc,CAAC,KAAgC,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,KAAK,CAAC,IAAI,CAAC,GAAI,cAAc,CAAC,KAAgC,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9C,WAAW,CAAC,IAAI,CACd,GAAI,cAAc,CAAC,WAAsC,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAuC,EAAE,CAAC;gBAC9D,QAAQ,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,aAAa;YAAE,SAAS;QACrD,QAAQ,CAAC;YACP,YAAY,EAAE,mBAAmB;YACjC,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,SAAS;gBACrC,QAAQ,EAAE,CAAC,CAAC,aAAa;aAC1B;YACD,EAAE,EAAE;gBACF,UAAU,EAAE,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,UAAU,IAAI,SAAS;gBAC5D,QAAQ,EAAE,CAAC,CAAC,eAAe;aAC5B;YACD,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,4BAA4B;SACjD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,aAAa;YAAE,SAAS;QACrD,QAAQ,CAAC;YACP,YAAY,EAAE,eAAe;YAC7B,IAAI,EAAE;gBACJ,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,SAAS;gBACrC,QAAQ,EAAE,CAAC,CAAC,aAAa;aAC1B;YACD,EAAE,EAAE;gBACF,UAAU,EAAE,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,UAAU,IAAI,SAAS;gBAC5D,QAAQ,EAAE,CAAC,CAAC,eAAe;aAC5B;YACD,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,sBAAsB;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE;QAC7C,iBAAiB,EAAE,KAAK;QACxB,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,IAAI;KACX,CAAC;AACJ,CAAC"}

package/dist/ai-services/chunk-markdown.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Token-bounded markdown chunking for KnowX AI extract fan-out.
+ * Mirrors @x12i/memorix-knowx-pack content/chunk (keep in sync).
+ */
+/** ~1k tokens keeps OpenRouter cheap/default under its ~120s provider timeout. */
+export declare const DEFAULT_CHUNK_TARGET_TOKENS = 1000;
+export declare const DEFAULT_CHUNK_OVERLAP_RATIO = 0.1;
+export type MarkdownChunk = {
+    index: number;
+    count: number;
+    text: string;
+    pageStart?: number;
+    pageEnd?: number;
+    approxTokens: number;
+};
+export type ChunkMarkdownOptions = {
+    targetTokens?: number;
+    overlapRatio?: number;
+};
+export declare function chunkMarkdown(markdown: string, opts?: ChunkMarkdownOptions): MarkdownChunk[];
+export declare function markdownApproxTokens(markdown: string): number;
+//# sourceMappingURL=chunk-markdown.d.ts.map

package/dist/ai-services/chunk-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-markdown.d.ts","sourceRoot":"","sources":["../../src/ai-services/chunk-markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA0CF,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,oBAAoB,GAC1B,aAAa,EAAE,CAoHjB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/ai-services/chunk-markdown.js

@@ -0,0 +1,159 @@
+/**
+ * Token-bounded markdown chunking for KnowX AI extract fan-out.
+ * Mirrors @x12i/memorix-knowx-pack content/chunk (keep in sync).
+ */
+/** ~1k tokens keeps OpenRouter cheap/default under its ~120s provider timeout. */
+export const DEFAULT_CHUNK_TARGET_TOKENS = 1000;
+export const DEFAULT_CHUNK_OVERLAP_RATIO = 0.1;
+const PAGE_RE = /<!--\s*page:(\d+)\s*-->/i;
+const HEADING_RE = /^#{1,6}\s+\S/;
+function approxTokenCount(text) {
+    const n = text.length;
+    if (n <= 0)
+        return 0;
+    return Math.ceil(n / 4);
+}
+function splitIntoSegments(markdown) {
+    const lines = markdown.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+    const segments = [];
+    let buf = [];
+    let page;
+    const flush = () => {
+        const text = buf.join("\n").trim();
+        if (text)
+            segments.push({ text, page });
+        buf = [];
+    };
+    for (const line of lines) {
+        const pageMatch = PAGE_RE.exec(line);
+        if (pageMatch) {
+            flush();
+            page = Number(pageMatch[1]);
+            buf.push(line);
+            continue;
+        }
+        if (HEADING_RE.test(line) && buf.length > 0) {
+            flush();
+        }
+        buf.push(line);
+    }
+    flush();
+    return segments.length ? segments : [{ text: markdown.trim() }];
+}
+export function chunkMarkdown(markdown, opts) {
+    const target = Math.max(200, opts?.targetTokens ?? DEFAULT_CHUNK_TARGET_TOKENS);
+    const overlapRatio = Math.min(0.5, Math.max(0, opts?.overlapRatio ?? DEFAULT_CHUNK_OVERLAP_RATIO));
+    const overlapTokens = Math.floor(target * overlapRatio);
+    const trimmed = markdown.trim();
+    if (!trimmed)
+        return [];
+    const segments = splitIntoSegments(trimmed);
+    const pieces = [];
+    let cur = [];
+    let curTokens = 0;
+    let pageStart;
+    let pageEnd;
+    const pushPiece = () => {
+        if (!cur.length)
+            return;
+        const text = cur.join("\n\n").trim();
+        if (!text) {
+            cur = [];
+            curTokens = 0;
+            pageStart = undefined;
+            pageEnd = undefined;
+            return;
+        }
+        pieces.push({ text, pageStart, pageEnd });
+        if (overlapTokens > 0 && text.length) {
+            const overlapChars = Math.max(80, overlapTokens * 4);
+            const tail = text.slice(Math.max(0, text.length - overlapChars));
+            cur = [tail];
+            curTokens = approxTokenCount(tail);
+            pageStart = pageEnd;
+        }
+        else {
+            cur = [];
+            curTokens = 0;
+            pageStart = undefined;
+            pageEnd = undefined;
+        }
+    };
+    for (const seg of segments) {
+        const segTokens = approxTokenCount(seg.text);
+        if (cur.length === 0) {
+            pageStart = seg.page;
+            pageEnd = seg.page;
+        }
+        else if (seg.page != null) {
+            pageEnd = seg.page;
+            if (pageStart == null)
+                pageStart = seg.page;
+        }
+        if (curTokens > 0 && curTokens + segTokens > target) {
+            pushPiece();
+            if (cur.length === 0) {
+                pageStart = seg.page ?? pageStart;
+                pageEnd = seg.page ?? pageEnd;
+            }
+            else if (seg.page != null) {
+                pageEnd = seg.page;
+            }
+        }
+        if (segTokens > target && cur.length === 0) {
+            const parts = seg.text.split(/\n{2,}/);
+            let hard = [];
+            let hardTokens = 0;
+            for (const part of parts) {
+                const t = approxTokenCount(part);
+                if (hardTokens > 0 && hardTokens + t > target) {
+                    pieces.push({
+                        text: hard.join("\n\n").trim(),
+                        pageStart: seg.page,
+                        pageEnd: seg.page,
+                    });
+                    hard = [];
+                    hardTokens = 0;
+                }
+                hard.push(part);
+                hardTokens += t;
+            }
+            if (hard.length) {
+                cur = hard;
+                curTokens = hardTokens;
+                pageStart = seg.page;
+                pageEnd = seg.page;
+            }
+            continue;
+        }
+        cur.push(seg.text);
+        curTokens += segTokens;
+    }
+    if (cur.length) {
+        const text = cur.join("\n\n").trim();
+        if (text)
+            pieces.push({ text, pageStart, pageEnd });
+    }
+    const cleaned = [];
+    for (const p of pieces) {
+        if (!p.text)
+            continue;
+        const prev = cleaned[cleaned.length - 1];
+        if (prev && prev.text === p.text)
+            continue;
+        cleaned.push(p);
+    }
+    const count = cleaned.length;
+    return cleaned.map((p, index) => ({
+        index,
+        count,
+        text: p.text,
+        pageStart: p.pageStart,
+        pageEnd: p.pageEnd,
+        approxTokens: approxTokenCount(p.text),
+    }));
+}
+export function markdownApproxTokens(markdown) {
+    return approxTokenCount(markdown);
+}
+//# sourceMappingURL=chunk-markdown.js.map

package/dist/ai-services/chunk-markdown.js.map

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

package/dist/ai-services/client.d.ts

@@ -0,0 +1,31 @@
+import type { AiServiceDescriptor, AiServiceInvokeRequest, AiServiceInvokeResponse, AiServiceItemDetail, AiServiceItemSummary } from "./types.js";
+export type AiServicesClientOptions = {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+};
+export declare function createAiServicesClient(opts?: AiServicesClientOptions): {
+    getHealth(baseUrl: string): Promise<{
+        ok: boolean;
+        status: number;
+        body: unknown;
+    }>;
+    getDescriptor(baseUrl: string): Promise<AiServiceDescriptor>;
+    listItems(baseUrl: string, query?: {
+        q?: string;
+        tag?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<AiServiceItemSummary[]>;
+    getItem(baseUrl: string, id: string): Promise<AiServiceItemDetail>;
+    invoke(baseUrl: string, request: AiServiceInvokeRequest, correlationId?: string, timeoutMs?: number): Promise<{
+        status: number;
+        body: AiServiceInvokeResponse;
+    }>;
+    /** FR-AIS-6 — generic proxy helper for mutation / subresource paths. */
+    request(baseUrl: string, method: string, path: string, body?: unknown, correlationId?: string, timeoutMs?: number): Promise<{
+        status: number;
+        body: unknown;
+    }>;
+};
+export type AiServicesClient = ReturnType<typeof createAiServicesClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/ai-services/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai-services/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAgCF,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,uBAA4B;uBAE5C,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;2BAS5D,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;uBAavD,MAAM,UACP;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,oBAAoB,EAAE,CAAC;qBAmBX,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;oBAa7D,MAAM,WACN,sBAAsB,kBACf,MAAM,cACV,MAAM,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,uBAAuB,CAAA;KAAE,CAAC;IAmB7D,wEAAwE;qBAE7D,MAAM,UACP,MAAM,QACR,MAAM,SACL,OAAO,kBACE,MAAM,cACV,MAAM,GACjB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;EAchD;AAED,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/ai-services/client.js

@@ -0,0 +1,104 @@
+import { stripTrailingSlash } from "./config.js";
+function joinUrl(base, path) {
+    return `${stripTrailingSlash(base)}${path.startsWith("/") ? path : `/${path}`}`;
+}
+async function fetchJson(url, init, opts) {
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const timeoutMs = opts.timeoutMs ?? 8_000;
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetchImpl(url, { ...init, signal: ctrl.signal });
+        const body = await res.json().catch(() => null);
+        return { status: res.status, body };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function jsonHeaders(correlationId) {
+    const headers = {
+        "content-type": "application/json",
+    };
+    if (correlationId)
+        headers["x-correlation-id"] = correlationId;
+    return headers;
+}
+export function createAiServicesClient(opts = {}) {
+    return {
+        async getHealth(baseUrl) {
+            const { status, body } = await fetchJson(joinUrl(baseUrl, "/health"), { method: "GET" }, opts);
+            const ok = status >= 200 &&
+                status < 300 &&
+                Boolean(body && typeof body === "object" && body.ok === true);
+            return { ok, status, body };
+        },
+        async getDescriptor(baseUrl) {
+            const { status, body } = await fetchJson(joinUrl(baseUrl, "/ai-services/v1/descriptor"), { method: "GET" }, opts);
+            if (status < 200 || status >= 300 || !body || typeof body !== "object") {
+                throw new Error(`descriptor failed: HTTP ${status}`);
+            }
+            return body;
+        },
+        async listItems(baseUrl, query) {
+            const params = new URLSearchParams();
+            if (query?.q)
+                params.set("q", query.q);
+            if (query?.tag)
+                params.set("tag", query.tag);
+            if (query?.limit != null)
+                params.set("limit", String(query.limit));
+            if (query?.cursor)
+                params.set("cursor", query.cursor);
+            const qs = params.toString();
+            const path = `/ai-services/v1/items${qs ? `?${qs}` : ""}`;
+            const { status, body } = await fetchJson(joinUrl(baseUrl, path), { method: "GET" }, opts);
+            if (status < 200 || status >= 300) {
+                throw new Error(`list items failed: HTTP ${status}`);
+            }
+            if (Array.isArray(body))
+                return body;
+            if (body && typeof body === "object" && Array.isArray(body.items)) {
+                return body.items;
+            }
+            return [];
+        },
+        async getItem(baseUrl, id) {
+            const { status, body } = await fetchJson(joinUrl(baseUrl, `/ai-services/v1/items/${encodeURIComponent(id)}`), { method: "GET" }, opts);
+            if (status < 200 || status >= 300 || !body || typeof body !== "object") {
+                throw new Error(`get item failed: HTTP ${status}`);
+            }
+            return body;
+        },
+        async invoke(baseUrl, request, correlationId, timeoutMs) {
+            const cid = correlationId ?? request.correlationId;
+            const { status, body } = await fetchJson(joinUrl(baseUrl, "/ai-services/v1/invoke"), {
+                method: "POST",
+                headers: jsonHeaders(cid),
+                body: JSON.stringify(request),
+            }, { ...opts, timeoutMs: timeoutMs ?? opts.timeoutMs ?? 120_000 });
+            return {
+                status,
+                body: (body && typeof body === "object"
+                    ? body
+                    : { ok: false, itemId: request.itemId, error: { code: "EMPTY", message: "empty body" } }),
+            };
+        },
+        /** FR-AIS-6 — generic proxy helper for mutation / subresource paths. */
+        async request(baseUrl, method, path, body, correlationId, timeoutMs) {
+            const init = {
+                method,
+                headers: body !== undefined ? jsonHeaders(correlationId) : correlationId
+                    ? { "x-correlation-id": correlationId }
+                    : undefined,
+            };
+            if (body !== undefined)
+                init.body = JSON.stringify(body);
+            return fetchJson(joinUrl(baseUrl, path), init, {
+                ...opts,
+                timeoutMs: timeoutMs ?? opts.timeoutMs ?? 30_000,
+            });
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/ai-services/client.js.map

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

package/dist/ai-services/config.d.ts

@@ -0,0 +1,17 @@
+import type { AiServiceType, ConfiguredAiServiceOrigin } from "./types.js";
+/** Registered companion types wired in Memorix. */
+export declare const AI_SERVICE_ORIGIN_SPECS: ReadonlyArray<{
+    aiServiceType: AiServiceType;
+    env: string;
+    defaultPort: number;
+}>;
+export declare function stripTrailingSlash(url: string): string;
+export declare function resolveConfiguredAiServiceOrigins(env?: NodeJS.ProcessEnv): ConfiguredAiServiceOrigin[];
+/** Resolve origin for a type: explicit URL, endpointEnv, or type's default env. */
+export declare function resolveAiServiceOriginUrl(aiServiceType: string, opts?: {
+    endpoint?: string;
+    endpointEnv?: string;
+    env?: NodeJS.ProcessEnv;
+}): string | null;
+export declare function defaultEndpointEnvForType(aiServiceType: string): string | undefined;
+//# sourceMappingURL=config.d.ts.map

package/dist/ai-services/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/ai-services/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE3E,mDAAmD;AACnD,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC;IAClD,aAAa,EAAE,aAAa,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAKA,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,iCAAiC,CAC/C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,yBAAyB,EAAE,CAU7B;AAED,mFAAmF;AACnF,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAC1E,MAAM,GAAG,IAAI,CAaf;AAED,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF"}