@x12i/memorix-service 3.0.6 → 3.2.0

package/dist/ai-services/config.js

@@ -0,0 +1,44 @@
+/** Registered companion types wired in Memorix. */
+export const AI_SERVICE_ORIGIN_SPECS = [
+    { aiServiceType: "function", env: "FUNCX_URL", defaultPort: 6120 },
+    { aiServiceType: "skill", env: "AI_SKILLS_URL", defaultPort: 5420 },
+    { aiServiceType: "task", env: "AI_TASKS_URL", defaultPort: 5440 },
+    { aiServiceType: "graph", env: "GRAPH_ENGINE_URL", defaultPort: 6200 },
+];
+const TYPE_TO_ENV = new Map(AI_SERVICE_ORIGIN_SPECS.map((s) => [s.aiServiceType, s.env]));
+export function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, "");
+}
+export function resolveConfiguredAiServiceOrigins(env = process.env) {
+    return AI_SERVICE_ORIGIN_SPECS.map((spec) => {
+        const raw = env[spec.env]?.trim();
+        return {
+            aiServiceType: spec.aiServiceType,
+            env: spec.env,
+            url: raw ? stripTrailingSlash(raw) : null,
+            defaultPort: spec.defaultPort,
+        };
+    });
+}
+/** Resolve origin for a type: explicit URL, endpointEnv, or type's default env. */
+export function resolveAiServiceOriginUrl(aiServiceType, opts) {
+    const env = opts?.env ?? process.env;
+    if (opts?.endpoint?.trim())
+        return stripTrailingSlash(opts.endpoint);
+    if (opts?.endpointEnv?.trim()) {
+        const named = env[opts.endpointEnv]?.trim();
+        if (named)
+            return stripTrailingSlash(named);
+    }
+    const defaultEnv = TYPE_TO_ENV.get(aiServiceType);
+    if (defaultEnv) {
+        const fromType = env[defaultEnv]?.trim();
+        if (fromType)
+            return stripTrailingSlash(fromType);
+    }
+    return null;
+}
+export function defaultEndpointEnvForType(aiServiceType) {
+    return TYPE_TO_ENV.get(aiServiceType);
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/ai-services/config.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAI/B;IACH,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE;IAClE,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE;IACnE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE;IACjE,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,WAAW,EAAE,IAAI,EAAE;CACvE,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,GAAG,CAAU,CAAC,CACtE,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QAClC,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;YACzC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CACvC,aAAqB,EACrB,IAA2E;IAE3E,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,IAAI,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrE,IAAI,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC;QAC5C,IAAI,KAAK;YAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,aAA8B,CAAC,CAAC;IACnE,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;QACzC,IAAI,QAAQ;YAAE,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,aAAqB;IAC7D,OAAO,WAAW,CAAC,GAAG,CAAC,aAA8B,CAAC,CAAC;AACzD,CAAC"}

package/dist/ai-services/normalize-output.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Unwrap AI-services/v1 invoke envelopes into KnowX / pipeline step bags.
+ *
+ * B2: HTTP envelope is JSON; LLM body is Markdown / FlexMD. Structured fields live on
+ * output.parsed / output.flexMd.payloads after MD extraction when outputContract is used.
+ * Do not treat a model-emitted root JSON blob in rawText as the primary contract.
+ *
+ * Live companions may lowercase heading keys (`knowxdrafts`) and leave `@payload:` wrappers
+ * as strings — coalesce those into camelCase domain bags.
+ */
+/** Extract structured domain object from a skill/function invoke response body. */
+export declare function extractAiServiceDomainOutput(invokeBody: unknown): Record<string, unknown> | null;
+export type NormalizeAiServiceOutputResult = {
+    ok: true;
+    output: Record<string, unknown>;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+/**
+ * Normalize invoke response into a step output bag for write-record / associate.
+ * Maps drafts → knowxDrafts when needed; preserves classification / relationshipPlans.
+ */
+export declare function normalizeAiServiceStepOutput(invokeBody: unknown, opts?: {
+    itemId?: string;
+    serviceId?: string;
+}): NormalizeAiServiceOutputResult;
+//# sourceMappingURL=normalize-output.d.ts.map

package/dist/ai-services/normalize-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-output.d.ts","sourceRoot":"","sources":["../../src/ai-services/normalize-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+HH,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkEhG;AAmID,MAAM,MAAM,8BAA8B,GACtC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,OAAO,EACnB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,8BAA8B,CA8FhC"}

package/dist/ai-services/normalize-output.js

@@ -0,0 +1,428 @@
+/**
+ * Unwrap AI-services/v1 invoke envelopes into KnowX / pipeline step bags.
+ *
+ * B2: HTTP envelope is JSON; LLM body is Markdown / FlexMD. Structured fields live on
+ * output.parsed / output.flexMd.payloads after MD extraction when outputContract is used.
+ * Do not treat a model-emitted root JSON blob in rawText as the primary contract.
+ *
+ * Live companions may lowercase heading keys (`knowxdrafts`) and leave `@payload:` wrappers
+ * as strings — coalesce those into camelCase domain bags.
+ */
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function tryParseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+const KNOWX_KEY_ALIASES = {
+    knowxdrafts: "knowxDrafts",
+    drafts: "knowxDrafts",
+    dochash: "docHash",
+    classification: "classification",
+    relationshipplans: "relationshipPlans",
+};
+function canonicalKnowxKey(key) {
+    return KNOWX_KEY_ALIASES[key.toLowerCase()] ?? null;
+}
+function hasKnowxKeys(rec) {
+    return Object.keys(rec).some((k) => canonicalKnowxKey(k) != null);
+}
+/** True when domain bag has a usable structured value (not empty shells). */
+function hasUsableKnowxValues(rec) {
+    if (Array.isArray(rec.knowxDrafts))
+        return true;
+    if (asRecord(rec.classification))
+        return true;
+    if (Array.isArray(rec.relationshipPlans))
+        return true;
+    if (typeof rec.docHash === "string" && rec.docHash.trim())
+        return true;
+    return false;
+}
+/** Best-effort JSON value from a section body (fences, leading prose, @payload wrapper). */
+function parseJsonish(text) {
+    let t = text.trim();
+    if (!t)
+        return null;
+    const fenced = t.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (fenced)
+        t = fenced[1].trim();
+    const direct = tryParseJson(t);
+    if (direct !== null)
+        return direct;
+    const arrStart = t.indexOf("[");
+    const objStart = t.indexOf("{");
+    let start = -1;
+    if (arrStart >= 0 && (objStart < 0 || arrStart < objStart))
+        start = arrStart;
+    else if (objStart >= 0)
+        start = objStart;
+    if (start < 0)
+        return null;
+    const slice = t.slice(start);
+    const endArr = slice.lastIndexOf("]");
+    const endObj = slice.lastIndexOf("}");
+    const end = Math.max(endArr, endObj);
+    if (end < 0)
+        return null;
+    return tryParseJson(slice.slice(0, end + 1));
+}
+/** Strip optional `@payload:Name` wrapper then JSON-parse when needed. */
+function unwrapPayloadValue(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw !== "string")
+        return raw;
+    let text = raw.trim();
+    const payloadHeader = text.match(/^@payload:([^\s\n]+)\s*\n?([\s\S]*)$/i);
+    if (payloadHeader) {
+        text = payloadHeader[2].trim();
+    }
+    if (!text)
+        return null;
+    const parsed = parseJsonish(text);
+    return parsed !== null ? parsed : text;
+}
+/** Hoist nested `{ knowxDrafts: [...] }` bags sometimes emitted inside a section payload. */
+function hoistKnowxSection(canon, value) {
+    const rec = asRecord(value);
+    if (!rec)
+        return value;
+    if (canon === "knowxDrafts" && Array.isArray(rec.knowxDrafts))
+        return rec.knowxDrafts;
+    if (canon === "docHash" && typeof rec.docHash === "string")
+        return rec.docHash;
+    if (canon === "classification" && asRecord(rec.classification))
+        return rec.classification;
+    if (canon === "relationshipPlans" && Array.isArray(rec.relationshipPlans)) {
+        return rec.relationshipPlans;
+    }
+    return value;
+}
+/** Coerce FlexMD @payload string/object into a domain record when it carries KnowX keys. */
+function domainFromPayload(raw) {
+    const unwrapped = unwrapPayloadValue(raw);
+    if (typeof unwrapped === "string") {
+        const p = asRecord(tryParseJson(unwrapped.trim()));
+        return p && hasKnowxKeys(p) ? canonicalizeDomain(p) : null;
+    }
+    const p = asRecord(unwrapped);
+    return p && hasKnowxKeys(p) ? canonicalizeDomain(p) : null;
+}
+function canonicalizeDomain(rec) {
+    const out = {};
+    for (const [k, v] of Object.entries(rec)) {
+        const canon = canonicalKnowxKey(k);
+        if (canon)
+            out[canon] = hoistKnowxSection(canon, unwrapPayloadValue(v));
+        else
+            out[k] = v;
+    }
+    return out;
+}
+/**
+ * Build a domain bag from per-section parsed/payload maps
+ * (e.g. { knowxdrafts: "@payload:…\n[…]", dochash: "…" }).
+ */
+function domainFromSectionMap(map) {
+    if (!map)
+        return null;
+    const out = {};
+    for (const [k, v] of Object.entries(map)) {
+        const canon = canonicalKnowxKey(k);
+        if (!canon)
+            continue;
+        const unwrapped = hoistKnowxSection(canon, unwrapPayloadValue(v));
+        if (unwrapped != null)
+            out[canon] = unwrapped;
+    }
+    return Object.keys(out).length > 0 ? out : null;
+}
+/** Extract structured domain object from a skill/function invoke response body. */
+export function extractAiServiceDomainOutput(invokeBody) {
+    const body = asRecord(invokeBody);
+    if (!body)
+        return null;
+    const output = body.output;
+    const out = asRecord(output);
+    if (!out)
+        return null;
+    // 1) output.parsed — whole bag or per-section contract keys
+    const parsed = asRecord(out.parsed);
+    if (parsed && hasKnowxKeys(parsed)) {
+        // Prefer coalescing sections (handles mixed casing + @payload strings)
+        const fromSections = domainFromSectionMap(parsed);
+        if (fromSections && hasUsableKnowxValues(fromSections))
+            return fromSections;
+        const canon = canonicalizeDomain(parsed);
+        if (hasUsableKnowxValues(canon))
+            return canon;
+        // Empty shells ("" after failed OFS extract) — fall through to flexMd / rawText.
+    }
+    // 2) FlexMD payloads (knowx / contract key names / result)
+    const flex = asRecord(out.flexMd);
+    const payloads = asRecord(flex?.payloads);
+    if (payloads) {
+        for (const key of [
+            "knowx",
+            "knowxDrafts",
+            "classification",
+            "relationshipPlans",
+            "result",
+            "output",
+        ]) {
+            const fromKey = domainFromPayload(payloads[key] ?? payloads[key.toLowerCase()]);
+            if (fromKey && hasUsableKnowxValues(fromKey))
+                return fromKey;
+        }
+        const fromSections = domainFromSectionMap(payloads);
+        if (fromSections && hasUsableKnowxValues(fromSections))
+            return fromSections;
+        // Single payload object that already is the domain bag
+        const values = Object.values(payloads);
+        if (values.length === 1) {
+            const only = domainFromPayload(values[0]);
+            if (only && hasUsableKnowxValues(only))
+                return only;
+        }
+    }
+    // 3) Already a domain bag on output (function-style or pre-normalized)
+    if (hasKnowxKeys(out)) {
+        const canon = canonicalizeDomain(out);
+        if (hasUsableKnowxValues(canon))
+            return canon;
+    }
+    // 4) Last resort: scrape contract headings / embedded JSON from rawText when
+    //    gateway FlexMD extractFromMarkdown(spec) fails (companion often still has MD).
+    const rawText = typeof out.rawText === "string"
+        ? out.rawText
+        : typeof body.rawText === "string"
+            ? body.rawText
+            : "";
+    if (rawText.trim()) {
+        const fromRaw = domainFromMarkdownHeadings(rawText);
+        if (fromRaw && hasUsableKnowxValues(fromRaw))
+            return fromRaw;
+        const fromJson = domainFromEmbeddedJson(rawText);
+        if (fromJson && hasUsableKnowxValues(fromJson))
+            return fromJson;
+    }
+    return null;
+}
+/**
+ * Parse `### classification` / `### relationshipPlans` (or @payload) blocks from MD.
+ * Also accepts headings that *start with* the contract name (e.g. "Classification analysis"
+ * is ignored; exact-or-alias "classification" / "relationshipPlans" required as the
+ * first token after #).
+ */
+function domainFromMarkdownHeadings(md) {
+    const out = {};
+    // First token after # must be a contract key (allow trailing junk: "classification {").
+    const headingRe = /^#{1,6}\s+(classification|relationshipPlans|knowxDrafts|docHash|knowx)\b[^\n]*$/gim;
+    const matches = [...md.matchAll(headingRe)];
+    for (let i = 0; i < matches.length; i++) {
+        const m = matches[i];
+        const name = m[1];
+        const start = (m.index ?? 0) + m[0].length;
+        const end = i + 1 < matches.length ? (matches[i + 1].index ?? md.length) : md.length;
+        const body = md.slice(start, end).trim();
+        const canon = canonicalKnowxKey(name) ?? (name.toLowerCase() === "knowx" ? "knowx" : null);
+        if (!canon)
+            continue;
+        const unwrapped = unwrapPayloadValue(body);
+        if (canon === "knowx") {
+            const rec = asRecord(unwrapped);
+            if (rec && hasKnowxKeys(rec)) {
+                Object.assign(out, canonicalizeDomain(rec));
+            }
+            continue;
+        }
+        if (unwrapped != null)
+            out[canon] = hoistKnowxSection(canon, unwrapped);
+    }
+    return Object.keys(out).length > 0 ? out : null;
+}
+/**
+ * Scan raw markdown for embedded classification object / relationshipPlans array
+ * when headings are missing or OFS left empty shells.
+ */
+function domainFromEmbeddedJson(md) {
+    const out = {};
+    // Walk every `{` and try to parse a balanced JSON object that looks like classification.
+    for (let i = 0; i < md.length; i++) {
+        if (md[i] !== "{")
+            continue;
+        if (!/"known"|"novel"|"contradicts"/.test(md.slice(i, i + 80)))
+            continue;
+        const slice = md.slice(i);
+        const endObj = findBalancedEnd(slice, "{", "}");
+        if (endObj < 0)
+            continue;
+        const candidate = tryParseJson(slice.slice(0, endObj + 1));
+        const rec = asRecord(candidate);
+        if (rec &&
+            (Array.isArray(rec.known) ||
+                Array.isArray(rec.novel) ||
+                Array.isArray(rec.contradicts))) {
+            out.classification = rec;
+            // keep scanning for a later (usually final) classification
+        }
+    }
+    for (let i = 0; i < md.length; i++) {
+        if (md[i] !== "[")
+            continue;
+        if (!/"definitionId"\s*:\s*"knowx-/.test(md.slice(i, i + 120)))
+            continue;
+        const slice = md.slice(i);
+        const endArr = findBalancedEnd(slice, "[", "]");
+        if (endArr < 0)
+            continue;
+        const candidate = tryParseJson(slice.slice(0, endArr + 1));
+        if (Array.isArray(candidate) &&
+            candidate.some((p) => asRecord(p) && typeof asRecord(p).definitionId === "string")) {
+            out.relationshipPlans = candidate;
+        }
+    }
+    for (let i = 0; i < md.length; i++) {
+        if (md[i] !== "[")
+            continue;
+        if (!/"contentType"\s*:\s*"knowx"/.test(md.slice(i, i + 400)))
+            continue;
+        const slice = md.slice(i);
+        const endArr = findBalancedEnd(slice, "[", "]");
+        if (endArr < 0)
+            continue;
+        const candidate = tryParseJson(slice.slice(0, endArr + 1));
+        if (Array.isArray(candidate) &&
+            candidate.some((p) => asRecord(p)?.recordId != null)) {
+            out.knowxDrafts = candidate;
+            break;
+        }
+    }
+    return hasUsableKnowxValues(out) ? out : null;
+}
+/** Index of matching closer for the opener at slice[0], or -1. */
+function findBalancedEnd(slice, open, close) {
+    if (slice[0] !== open)
+        return -1;
+    let depth = 0;
+    let inStr = false;
+    let esc = false;
+    for (let i = 0; i < slice.length; i++) {
+        const ch = slice[i];
+        if (inStr) {
+            if (esc) {
+                esc = false;
+                continue;
+            }
+            if (ch === "\\") {
+                esc = true;
+                continue;
+            }
+            if (ch === '"')
+                inStr = false;
+            continue;
+        }
+        if (ch === '"') {
+            inStr = true;
+            continue;
+        }
+        if (ch === open)
+            depth++;
+        else if (ch === close) {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Normalize invoke response into a step output bag for write-record / associate.
+ * Maps drafts → knowxDrafts when needed; preserves classification / relationshipPlans.
+ */
+export function normalizeAiServiceStepOutput(invokeBody, opts) {
+    const body = asRecord(invokeBody);
+    const output = asRecord(body?.output);
+    const rawText = (typeof output?.rawText === "string" && output.rawText) ||
+        (typeof asRecord(output?.parsed)?.rawText === "string" &&
+            asRecord(output?.parsed).rawText) ||
+        "";
+    const domain = extractAiServiceDomainOutput(invokeBody);
+    if (!domain) {
+        // Companion sometimes returns ok:true with empty rawText after burning the
+        // full completion budget on oversized associate prompts — mark distinctly.
+        const parsedRec = asRecord(output?.parsed);
+        const emptyShell = body?.ok === true &&
+            !rawText.trim() &&
+            (!parsedRec ||
+                (Object.keys(parsedRec).length === 0 ||
+                    (Object.keys(parsedRec).length === 1 &&
+                        typeof parsedRec.rawText === "string" &&
+                        !String(parsedRec.rawText).trim())));
+        if (emptyShell) {
+            return {
+                ok: false,
+                code: "AI_OUTPUT_EMPTY",
+                message: `AI-service ${opts?.itemId ?? "item"} returned empty structured output (rawText empty)`,
+            };
+        }
+        return {
+            ok: false,
+            code: "AI_OUTPUT_UNPARSEABLE",
+            message: `AI-service ${opts?.itemId ?? "item"} did not return structured KnowX output (expected output.parsed / FlexMD payloads with knowxDrafts / classification / relationshipPlans)`,
+        };
+    }
+    const out = { ...domain };
+    if (!Array.isArray(out.knowxDrafts) && Array.isArray(out.drafts)) {
+        out.knowxDrafts = out.drafts;
+    }
+    // Single draft object mistaken for the array section
+    if (!Array.isArray(out.knowxDrafts) &&
+        asRecord(out.knowxDrafts) &&
+        typeof out.knowxDrafts.recordId === "string") {
+        out.knowxDrafts = [out.knowxDrafts];
+    }
+    const serviceId = opts?.serviceId ?? "";
+    const itemId = opts?.itemId ?? "";
+    const looksExtract = serviceId === "knowx-extract" ||
+        itemId === "knowx.extract" ||
+        Array.isArray(out.knowxDrafts);
+    const looksAssociate = serviceId === "knowx-associate-knowledge" ||
+        itemId === "knowx.associate-knowledge" ||
+        asRecord(out.classification) != null ||
+        Array.isArray(out.relationshipPlans);
+    if (looksExtract && !Array.isArray(out.knowxDrafts)) {
+        const got = out.knowxDrafts;
+        const hint = got === undefined
+            ? "missing"
+            : Array.isArray(got)
+                ? "array"
+                : `${typeof got}${asRecord(got) ? ` keys=${Object.keys(got).join(",")}` : ""}`;
+        return {
+            ok: false,
+            code: "AI_OUTPUT_MISSING_DRAFTS",
+            message: `knowx.extract output missing knowxDrafts array (got ${hint}; domainKeys=${Object.keys(out).join(",")})`,
+        };
+    }
+    if (looksAssociate &&
+        !asRecord(out.classification) &&
+        !Array.isArray(out.relationshipPlans)) {
+        return {
+            ok: false,
+            code: "AI_OUTPUT_MISSING_ASSOCIATE",
+            message: "knowx.associate-knowledge output missing classification / relationshipPlans",
+        };
+    }
+    out.kind = "ai-services";
+    out.live = true;
+    return { ok: true, output: out };
+}
+//# sourceMappingURL=normalize-output.js.map

package/dist/ai-services/normalize-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-output.js","sourceRoot":"","sources":["../../src/ai-services/normalize-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,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,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,iBAAiB,GAA2B;IAChD,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,SAAS;IAClB,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;CACvC,CAAC;AAEF,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,GAA4B;IAChD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,6EAA6E;AAC7E,SAAS,oBAAoB,CAAC,GAA4B;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACvE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4FAA4F;AAC5F,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACxD,IAAI,MAAM;QAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACnC,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC;QAAE,KAAK,GAAG,QAAQ,CAAC;SACxE,IAAI,QAAQ,IAAI,CAAC;QAAE,KAAK,GAAG,QAAQ,CAAC;IACzC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,0EAA0E;AAC1E,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACtB,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC1E,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,6FAA6F;AAC7F,SAAS,iBAAiB,CAAC,KAAa,EAAE,KAAc;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,KAAK,KAAK,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC;IACtF,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC/E,IAAI,KAAK,KAAK,gBAAgB,IAAI,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,GAAG,CAAC,cAAc,CAAC;IAC1F,IAAI,KAAK,KAAK,mBAAmB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1E,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4FAA4F;AAC5F,SAAS,iBAAiB,CAAC,GAAY;IACrC,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,SAAS,kBAAkB,CAAC,GAA4B;IACtD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;;YACnE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,GAAmC;IAC/D,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,SAAS,IAAI,IAAI;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAAC,UAAmB;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAE3B,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,4DAA4D;IAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,uEAAuE;QACvE,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,YAAY,IAAI,oBAAoB,CAAC,YAAY,CAAC;YAAE,OAAO,YAAY,CAAC;QAC5E,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,oBAAoB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,iFAAiF;IACnF,CAAC;IAED,2DAA2D;IAC3D,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,GAAG,IAAI;YAChB,OAAO;YACP,aAAa;YACb,gBAAgB;YAChB,mBAAmB;YACnB,QAAQ;YACR,QAAQ;SACT,EAAE,CAAC;YACF,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAChF,IAAI,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;QAC/D,CAAC;QACD,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,YAAY,IAAI,oBAAoB,CAAC,YAAY,CAAC;YAAE,OAAO,YAAY,CAAC;QAC5E,uDAAuD;QACvD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,IAAI,IAAI,oBAAoB,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QACtD,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,oBAAoB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,oFAAoF;IACpF,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;QACb,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;YAChC,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,EAAE,CAAC;IACX,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAC7D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,QAAQ,IAAI,oBAAoB,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,0BAA0B,CAAC,EAAU;IAC5C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,wFAAwF;IACxF,MAAM,SAAS,GACb,oFAAoF,CAAC;IACvF,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACtB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3C,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC;QACtF,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,SAAS,IAAI,IAAI;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,EAAU;IACxC,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,yFAAyF;IACzF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,SAAS;QAC5B,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;YAAE,SAAS;QACzE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,MAAM,GAAG,CAAC;YAAE,SAAS;QACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChC,IACE,GAAG;YACH,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBACvB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;gBACxB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,EACjC,CAAC;YACD,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC;YACzB,2DAA2D;QAC7D,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,SAAS;QAC5B,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;YAAE,SAAS;QACzE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,MAAM,GAAG,CAAC;YAAE,SAAS;QACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,IACE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACxB,SAAS,CAAC,IAAI,CACZ,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC,YAAY,KAAK,QAAQ,CACpE,EACD,CAAC;YACD,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,SAAS;QAC5B,IAAI,CAAC,6BAA6B,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC;YAAE,SAAS;QACxE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,IAAI,MAAM,GAAG,CAAC;YAAE,SAAS;QACzB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3D,IACE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,IAAI,IAAI,CAAC,EACpD,CAAC;YACD,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;YAC5B,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,kEAAkE;AAClE,SAAS,eAAe,CAAC,KAAa,EAAE,IAAY,EAAE,KAAa;IACjE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,GAAG,KAAK,CAAC;gBACZ,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAChB,GAAG,GAAG,IAAI,CAAC;gBACX,SAAS;YACX,CAAC;YACD,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,GAAG,KAAK,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,KAAK,GAAG,IAAI,CAAC;YACb,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,IAAI;YAAE,KAAK,EAAE,CAAC;aACpB,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YACtB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAMD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAmB,EACnB,IAA8C;IAE9C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,OAAO,GACX,CAAC,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC;QACvD,CAAC,OAAO,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,QAAQ;YACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAE,CAAC,OAAkB,CAAC;QAChD,EAAE,CAAC;IACL,MAAM,MAAM,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,2EAA2E;QAC3E,2EAA2E;QAC3E,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,UAAU,GACd,IAAI,EAAE,EAAE,KAAK,IAAI;YACjB,CAAC,OAAO,CAAC,IAAI,EAAE;YACf,CAAC,CAAC,SAAS;gBACT,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;oBAClC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;wBAClC,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;wBACrC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,UAAU,EAAE,CAAC;YACf,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,cAAc,IAAI,EAAE,MAAM,IAAI,MAAM,mDAAmD;aACjG,CAAC;QACJ,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,cAAc,IAAI,EAAE,MAAM,IAAI,MAAM,0IAA0I;SACxL,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC;IAC/B,CAAC;IACD,qDAAqD;IACrD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;QACzB,OAAQ,GAAG,CAAC,WAAuC,CAAC,QAAQ,KAAK,QAAQ,EACzE,CAAC;QACD,GAAG,CAAC,WAAW,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAElC,MAAM,YAAY,GAChB,SAAS,KAAK,eAAe;QAC7B,MAAM,KAAK,eAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEjC,MAAM,cAAc,GAClB,SAAS,KAAK,2BAA2B;QACzC,MAAM,KAAK,2BAA2B;QACtC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI;QACpC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAEvC,IAAI,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;QAC5B,MAAM,IAAI,GACR,GAAG,KAAK,SAAS;YACf,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBAClB,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,GAAG,OAAO,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC/F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,uDAAuD,IAAI,gBAAgB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;SAClH,CAAC;IACJ,CAAC;IAED,IACE,cAAc;QACd,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EACrC,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,6BAA6B;YACnC,OAAO,EACL,6EAA6E;SAChF,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,IAAI,GAAG,aAAa,CAAC;IACzB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACnC,CAAC"}

package/dist/ai-services/skill-execution.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Default RunSkillRequest execution fields for KnowX AI-service pipeline steps.
+ * Merged into portConfig.execution at compile time; live invoke passes them under FR execution.
+ *
+ * Model: ai-profiles `profile/choice` (e.g. cheap/default) or a concrete wire id via
+ * execution.modelConfig.model. Override with KNOWX_AI_SKILL_MODEL / AI_SKILLS_DEFAULT_MODEL.
+ * Do not invent a default provider wire model — missing model fails at the companion.
+ */
+export type SkillExecutionDefaults = {
+    agentId: string;
+    jobId: string;
+    taskId: string;
+    jobTypeId: string;
+    taskTypeId: string;
+    modelConfig: {
+        model: string;
+    };
+    outputContract: string[];
+};
+export declare function defaultSkillExecutionForItem(itemId: string, opts?: {
+    runId?: string;
+    stepId?: string;
+}): Record<string, unknown> | undefined;
+//# sourceMappingURL=skill-execution.d.ts.map

package/dist/ai-services/skill-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-execution.d.ts","sourceRoot":"","sources":["../../src/ai-services/skill-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AA0CF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAmCrC"}

package/dist/ai-services/skill-execution.js

@@ -0,0 +1,74 @@
+/**
+ * Default RunSkillRequest execution fields for KnowX AI-service pipeline steps.
+ * Merged into portConfig.execution at compile time; live invoke passes them under FR execution.
+ *
+ * Model: ai-profiles `profile/choice` (e.g. cheap/default) or a concrete wire id via
+ * execution.modelConfig.model. Override with KNOWX_AI_SKILL_MODEL / AI_SKILLS_DEFAULT_MODEL.
+ * Do not invent a default provider wire model — missing model fails at the companion.
+ */
+function resolveKnowxSkillModel() {
+    return (process.env.KNOWX_AI_SKILL_MODEL?.trim() ||
+        process.env.AI_SKILLS_DEFAULT_MODEL?.trim() ||
+        "cheap/default");
+}
+/** Associate needs a non-reasoning chat model — flash often returns empty rawText. */
+function resolveKnowxAssociateModel() {
+    return (process.env.KNOWX_AI_ASSOC_MODEL?.trim() ||
+        process.env.KNOWX_AI_SKILL_MODEL?.trim() ||
+        process.env.AI_SKILLS_DEFAULT_MODEL?.trim() ||
+        "openrouter/deepseek/deepseek-chat");
+}
+const KNOWX_SKILL_EXECUTION = {
+    "knowx.extract": {
+        agentId: "knowx",
+        jobId: "knowx-pipeline",
+        taskId: "knowx-extract",
+        jobTypeId: "knowx-ingest",
+        taskTypeId: "knowx-extract",
+        outputContract: ["knowxDrafts", "docHash"],
+    },
+    "knowx.associate-knowledge": {
+        agentId: "knowx",
+        jobId: "knowx-pipeline",
+        taskId: "knowx-associate-knowledge",
+        jobTypeId: "knowx-ingest",
+        taskTypeId: "knowx-associate-knowledge",
+        outputContract: ["classification", "relationshipPlans"],
+    },
+};
+export function defaultSkillExecutionForItem(itemId, opts) {
+    const model = itemId === "knowx.associate-knowledge"
+        ? resolveKnowxAssociateModel()
+        : resolveKnowxSkillModel();
+    const modelConfig = { model };
+    // Associate plans grow with catalog size — prefer a higher completion budget.
+    if (itemId === "knowx.associate-knowledge") {
+        const maxTok = Number(process.env.KNOWX_AI_ASSOC_MAX_TOKENS?.trim() || "8192");
+        if (Number.isFinite(maxTok) && maxTok > 0) {
+            const n = Math.floor(maxTok);
+            modelConfig.maxTokens = n;
+            modelConfig.max_tokens = n;
+        }
+    }
+    const base = KNOWX_SKILL_EXECUTION[itemId];
+    if (!base) {
+        if (itemId.startsWith("knowx.")) {
+            return {
+                agentId: "knowx",
+                jobId: opts?.runId ?? "knowx-pipeline",
+                taskId: opts?.stepId ?? itemId,
+                jobTypeId: "knowx-ingest",
+                taskTypeId: itemId,
+                modelConfig,
+            };
+        }
+        return undefined;
+    }
+    return {
+        ...base,
+        modelConfig,
+        jobId: opts?.runId ?? base.jobId,
+        taskId: opts?.stepId ?? base.taskId,
+    };
+}
+//# sourceMappingURL=skill-execution.js.map

package/dist/ai-services/skill-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-execution.js","sourceRoot":"","sources":["../../src/ai-services/skill-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,SAAS,sBAAsB;IAC7B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE;QAC3C,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,SAAS,0BAA0B;IACjC,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE;QAC3C,mCAAmC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,qBAAqB,GAGvB;IACF,eAAe,EAAE;QACf,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,eAAe;QACvB,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,eAAe;QAC3B,cAAc,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;KAC3C;IACD,2BAA2B,EAAE;QAC3B,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,2BAA2B;QACnC,SAAS,EAAE,cAAc;QACzB,UAAU,EAAE,2BAA2B;QACvC,cAAc,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;KACxD;CACF,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAC1C,MAAc,EACd,IAA0C;IAE1C,MAAM,KAAK,GACT,MAAM,KAAK,2BAA2B;QACpC,CAAC,CAAC,0BAA0B,EAAE;QAC9B,CAAC,CAAC,sBAAsB,EAAE,CAAC;IAC/B,MAAM,WAAW,GAA4B,EAAE,KAAK,EAAE,CAAC;IACvD,8EAA8E;IAC9E,IAAI,MAAM,KAAK,2BAA2B,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,CAAC;QAC/E,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;YAC1B,WAAW,CAAC,UAAU,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,gBAAgB;gBACtC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,MAAM;gBAC9B,SAAS,EAAE,cAAc;gBACzB,UAAU,EAAE,MAAM;gBAClB,WAAW;aACZ,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,GAAG,IAAI;QACP,WAAW;QACX,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK;QAChC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM;KACpC,CAAC;AACJ,CAAC"}