@x12i/memorix-service 3.0.6 → 3.1.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/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): 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,GACrB,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) {
+            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: 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"}

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,23 @@
+/**
+ * Unwrap AI-services/v1 invoke envelopes into KnowX / pipeline step bags.
+ * Skills return RunSkillResponse under body.output; prefer parsed, then FlexMD payloads.
+ */
+/** 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;;;GAGG;AAiCH,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAmEhG;AAED,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,CAsDhC"}

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

@@ -0,0 +1,148 @@
+/**
+ * Unwrap AI-services/v1 invoke envelopes into KnowX / pipeline step bags.
+ * Skills return RunSkillResponse under body.output; prefer parsed, then FlexMD payloads.
+ */
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function tryParseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+/** Pull a JSON object from prose / markdown fences when the model wraps the payload. */
+function extractJsonObject(text) {
+    const direct = tryParseJson(text);
+    if (direct !== null)
+        return direct;
+    const fence = /```(?:json)?\s*([\s\S]*?)```/i.exec(text);
+    if (fence?.[1]) {
+        const fromFence = tryParseJson(fence[1].trim());
+        if (fromFence !== null)
+            return fromFence;
+    }
+    const start = text.indexOf("{");
+    const end = text.lastIndexOf("}");
+    if (start >= 0 && end > start) {
+        return tryParseJson(text.slice(start, end + 1));
+    }
+    return 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;
+    if (typeof output === "string") {
+        return asRecord(extractJsonObject(output));
+    }
+    const out = asRecord(output);
+    if (!out)
+        return null;
+    // RunSkillResponse: { parsed, flexMd, rawText, … }
+    const parsed = asRecord(out.parsed);
+    if (parsed) {
+        if ("knowxDrafts" in parsed ||
+            "drafts" in parsed ||
+            "classification" in parsed ||
+            "relationshipPlans" in parsed ||
+            "docHash" in parsed) {
+            return parsed;
+        }
+        // parsed.rawText is a common passthrough when FlexMD parse misses
+        if (typeof parsed.rawText === "string") {
+            const fromParsedRaw = asRecord(extractJsonObject(parsed.rawText));
+            if (fromParsedRaw)
+                return fromParsedRaw;
+        }
+    }
+    const flex = asRecord(out.flexMd);
+    const payloads = asRecord(flex?.payloads);
+    if (payloads) {
+        for (const key of ["knowx", "result", "json", "output"]) {
+            const raw = payloads[key];
+            if (typeof raw === "string") {
+                const p = asRecord(extractJsonObject(raw));
+                if (p)
+                    return p;
+            }
+            else {
+                const p = asRecord(raw);
+                if (p)
+                    return p;
+            }
+        }
+        const values = Object.values(payloads);
+        if (values.length === 1 && typeof values[0] === "string") {
+            const p = asRecord(extractJsonObject(values[0]));
+            if (p)
+                return p;
+        }
+    }
+    if (typeof out.rawText === "string") {
+        const p = asRecord(extractJsonObject(out.rawText));
+        if (p)
+            return p;
+    }
+    // Already a domain bag (function-style or pre-normalized)
+    if ("knowxDrafts" in out ||
+        "drafts" in out ||
+        "classification" in out ||
+        "relationshipPlans" in out) {
+        return out;
+    }
+    return null;
+}
+/**
+ * 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 domain = extractAiServiceDomainOutput(invokeBody);
+    if (!domain) {
+        return {
+            ok: false,
+            code: "AI_OUTPUT_UNPARSEABLE",
+            message: `AI-service ${opts?.itemId ?? "item"} did not return structured KnowX output (expected parsed knowxDrafts / classification / relationshipPlans)`,
+        };
+    }
+    const out = { ...domain };
+    if (!Array.isArray(out.knowxDrafts) && Array.isArray(out.drafts)) {
+        out.knowxDrafts = out.drafts;
+    }
+    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)) {
+        return {
+            ok: false,
+            code: "AI_OUTPUT_MISSING_DRAFTS",
+            message: "knowx.extract output missing knowxDrafts array",
+        };
+    }
+    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":"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"}

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

@@ -0,0 +1,23 @@
+/**
+ * Default RunSkillRequest execution fields for KnowX AI-service pipeline steps.
+ * Merged into portConfig.execution at compile time; live invoke passes them under FR execution.
+ *
+ * ai-skills requires a concrete wire model on modelConfig (or modelId). Override with
+ * KNOWX_AI_SKILL_MODEL (OpenRouter-style id).
+ */
+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;;;;;;GAMG;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;AAgCF,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,CAsBrC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Default RunSkillRequest execution fields for KnowX AI-service pipeline steps.
+ * Merged into portConfig.execution at compile time; live invoke passes them under FR execution.
+ *
+ * ai-skills requires a concrete wire model on modelConfig (or modelId). Override with
+ * KNOWX_AI_SKILL_MODEL (OpenRouter-style id).
+ */
+function resolveKnowxSkillModel() {
+    return (process.env.KNOWX_AI_SKILL_MODEL?.trim() ||
+        process.env.AI_SKILLS_DEFAULT_MODEL?.trim() ||
+        "deepseek/deepseek-v4-flash");
+}
+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 modelConfig = { model: resolveKnowxSkillModel() };
+    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;;;;;;GAMG;AAYH,SAAS,sBAAsB;IAC7B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,EAAE;QAC3C,4BAA4B,CAC7B,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,WAAW,GAAG,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC;IACxD,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"}

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

@@ -0,0 +1,62 @@
+/** AI-services/v1 shapes (consumer side). Matches FR-AIS-1…8. */
+export type AiServiceType = "function" | "skill" | "task" | "graph" | (string & {});
+/** FR-AIS-7 — advertised mutation / subresource support. */
+export type AiServiceCapabilities = {
+    itemMutation: boolean;
+    actions?: string[];
+    subresources?: string[];
+    bundles?: boolean;
+};
+export type AiServiceDescriptor = {
+    protocolVersion: "ai-services/1";
+    aiServiceType: AiServiceType;
+    packageId: string;
+    zoneId: string;
+    title: string;
+    cataloxCatalogIds: string[];
+    capabilities?: AiServiceCapabilities;
+};
+export type AiServiceItemSummary = {
+    id: string;
+    title: string;
+    summary?: string;
+    tags?: string[];
+    version?: string;
+    meta?: Record<string, unknown>;
+};
+export type AiServiceItemDetail = AiServiceItemSummary & {
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    defaults?: unknown;
+};
+export type AiServiceInvokeRequest = {
+    itemId: string;
+    input?: unknown;
+    execution?: Record<string, unknown>;
+    correlationId?: string;
+};
+export type AiServiceInvokeResponse = {
+    ok: boolean;
+    itemId: string;
+    output?: unknown;
+    error?: {
+        code: string;
+        message: string;
+        retryable?: boolean;
+    };
+    meta?: Record<string, unknown>;
+};
+/** Pack / step binding — ids only, no Catalox row copies. */
+export type AiServiceBinding = {
+    aiServiceType: string;
+    itemId: string;
+    endpointEnv?: string;
+    endpoint?: string;
+};
+export type ConfiguredAiServiceOrigin = {
+    aiServiceType: AiServiceType;
+    env: string;
+    url: string | null;
+    defaultPort: number;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai-services/types.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEpF,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,aAAa,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/ai-services/types.js

@@ -0,0 +1,3 @@
+/** AI-services/v1 shapes (consumer side). Matches FR-AIS-1…8. */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai-services/types.ts"],"names":[],"mappings":"AAAA,iEAAiE"}

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,EAAE,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAgBvB,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D5E;AAED,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,GAAG;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,0BAA0B;;;;;GAM7E"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAIA,OAAO,OAAO,EAAE,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxD,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAqBvB,MAAM,MAAM,8BAA8B,GAAG,YAAY,GAAG;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC;IAAE,GAAG,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoF5E;AAED,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,GAAG;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,0BAA0B;;;;;GAM7E"}