@exellix/ai-skills 5.8.0

package/dist/utils/normalize-output-parsed.js

@@ -0,0 +1,128 @@
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/** Resolves contract field names from common graph-engine shapes. */
+export function resolveOutputContractFields(contract) {
+    if (contract === undefined)
+        return [];
+    if (Array.isArray(contract)) {
+        return contract.filter((k) => typeof k === "string" && k.trim().length > 0).map((k) => k.trim());
+    }
+    if (isPlainObject(contract)) {
+        const fromFields = contract.fields;
+        if (Array.isArray(fromFields)) {
+            return fromFields.filter((k) => typeof k === "string" && k.trim().length > 0).map((k) => k.trim());
+        }
+        const fromKeys = contract.keys;
+        if (Array.isArray(fromKeys)) {
+            return fromKeys.filter((k) => typeof k === "string" && k.trim().length > 0).map((k) => k.trim());
+        }
+        const fromRequired = contract.required;
+        if (Array.isArray(fromRequired)) {
+            return fromRequired.filter((k) => typeof k === "string" && k.trim().length > 0).map((k) => k.trim());
+        }
+        return Object.keys(contract).filter((k) => !["fields", "keys", "required"].includes(k));
+    }
+    return [];
+}
+/** `### Short Answer` → `shortAnswer`. */
+export function markdownHeadingToFieldKey(heading) {
+    const words = heading
+        .trim()
+        .replace(/^#+\s*/, "")
+        .split(/\s+/)
+        .filter(Boolean);
+    if (words.length === 0)
+        return "";
+    return words
+        .map((w, i) => {
+        const lower = w.toLowerCase();
+        if (i === 0)
+            return lower;
+        return lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join("");
+}
+const SECTION_HEADER = /^#{2,3}\s+(.+?)\s*$/gm;
+function isEmptyParsedValue(v) {
+    if (v === undefined || v === null)
+        return true;
+    if (typeof v === "string")
+        return v.trim().length === 0;
+    if (Array.isArray(v))
+        return v.length === 0;
+    if (isPlainObject(v) && Object.keys(v).length === 0)
+        return true;
+    return false;
+}
+/** Parses `### Section` blocks from markdown into camelCase field keys. */
+export function parseMarkdownSectionsToFields(text) {
+    const out = {};
+    if (!text || typeof text !== "string")
+        return out;
+    const matches = [...text.matchAll(SECTION_HEADER)];
+    for (let i = 0; i < matches.length; i++) {
+        const match = matches[i];
+        const title = match[1]?.trim() ?? "";
+        const key = markdownHeadingToFieldKey(title);
+        if (!key)
+            continue;
+        const start = (match.index ?? 0) + match[0].length;
+        const end = i + 1 < matches.length ? (matches[i + 1].index ?? text.length) : text.length;
+        const body = text.slice(start, end).trim();
+        if (body.length > 0) {
+            out[key] = body;
+        }
+    }
+    return out;
+}
+function coalescePayloadValue(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === "string")
+        return value.trim().length > 0 ? value : undefined;
+    return value;
+}
+/**
+ * Fills `parsed` keys requested by `outputContract` from FlexMD payloads and markdown sections.
+ * Does not remove existing parsed keys; only adds missing satisfiable values.
+ */
+export function enrichParsedForOutputContract(args) {
+    const fields = resolveOutputContractFields(args.outputContract);
+    const parsed = { ...args.parsed };
+    if (fields.length === 0)
+        return parsed;
+    const fromMarkdown = parseMarkdownSectionsToFields(args.rawText ?? "");
+    const payloads = args.flexMdPayloads ?? {};
+    for (const field of fields) {
+        if (!isEmptyParsedValue(parsed[field]))
+            continue;
+        const fromPayload = coalescePayloadValue(payloads[field]);
+        if (fromPayload !== undefined) {
+            parsed[field] = fromPayload;
+            continue;
+        }
+        const fromMd = fromMarkdown[field];
+        if (fromMd !== undefined && fromMd.trim().length > 0) {
+            parsed[field] = fromMd;
+            continue;
+        }
+        const rawParsed = parsed[field];
+        if (isPlainObject(rawParsed) && typeof rawParsed.rawText === "string") {
+            const nested = parseMarkdownSectionsToFields(rawParsed.rawText);
+            if (nested[field]) {
+                parsed[field] = nested[field];
+            }
+        }
+    }
+    if (typeof parsed.rawText === "string" && fields.length > 0) {
+        const expanded = parseMarkdownSectionsToFields(parsed.rawText);
+        for (const [key, value] of Object.entries(expanded)) {
+            if (isEmptyParsedValue(parsed[key])) {
+                parsed[key] = value;
+            }
+        }
+    }
+    return parsed;
+}
+//# sourceMappingURL=normalize-output-parsed.js.map

package/dist/utils/normalize-output-parsed.js.map

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

package/dist/utils/patch-activix-activity-after-skill.d.ts

@@ -0,0 +1,19 @@
+import type { AIGateway } from "@x12i/ai-gateway";
+import type { Logxer } from "@x12i/logxer";
+import type { NormalizedSkillBilling } from "./normalize-billing-metadata.js";
+import { type ActivixBillingPatchContext } from "./build-activix-billing-patch.js";
+export type PatchActivixActivityAfterSkillArgs = {
+    gateway: AIGateway;
+    logger: Logxer;
+    activityId: string;
+    billing: NormalizedSkillBilling;
+    parsed: Record<string, unknown>;
+    /** Routing / model slice for `outer.metadata` (mirrors gateway completion metadata). */
+    activixContext?: ActivixBillingPatchContext;
+};
+/**
+ * Best-effort patch of the persisted Activix row after gateway `logSuccess`, so studio Run Analysis
+ * sees enriched `cost` / `costStatus`, `outer.metadata` billing, Activix `outer.cost`, and `outer.output.parsed`.
+ */
+export declare function patchActivixActivityAfterSkill(args: PatchActivixActivityAfterSkillArgs): Promise<void>;
+//# sourceMappingURL=patch-activix-activity-after-skill.d.ts.map

package/dist/utils/patch-activix-activity-after-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-activix-activity-after-skill.d.ts","sourceRoot":"","sources":["../../src/utils/patch-activix-activity-after-skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAC;AAsC1C,MAAM,MAAM,kCAAkC,GAAG;IAC/C,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,sBAAsB,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wFAAwF;IACxF,cAAc,CAAC,EAAE,0BAA0B,CAAC;CAC7C,CAAC;AAEF;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,kCAAkC,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD5G"}

package/dist/utils/patch-activix-activity-after-skill.js

@@ -0,0 +1,81 @@
+import { buildActivixBillingPatch, } from "./build-activix-billing-patch.js";
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function mergeParsedIntoOutputContainer(container, parsed) {
+    if (!isPlainObject(container))
+        return undefined;
+    const existingParsed = isPlainObject(container.parsed) ? container.parsed : {};
+    return {
+        ...container,
+        parsed: { ...existingParsed, ...parsed },
+    };
+}
+function mergeMetadata(existing, incoming) {
+    const base = isPlainObject(existing) ? existing : {};
+    return { ...base, ...incoming };
+}
+function mergeOuterCost(existing, incoming) {
+    if (!isPlainObject(existing))
+        return incoming;
+    const prev = existing;
+    const prevTokens = isPlainObject(prev.tokens) ? prev.tokens : {};
+    const nextTokens = isPlainObject(incoming.tokens) ? incoming.tokens : {};
+    return {
+        ...prev,
+        ...incoming,
+        tokens: { ...prevTokens, ...nextTokens },
+    };
+}
+/**
+ * Best-effort patch of the persisted Activix row after gateway `logSuccess`, so studio Run Analysis
+ * sees enriched `cost` / `costStatus`, `outer.metadata` billing, Activix `outer.cost`, and `outer.output.parsed`.
+ */
+export async function patchActivixActivityAfterSkill(args) {
+    const activityManager = args.gateway
+        .getActivityManager?.();
+    const tracker = activityManager?.getTracker?.();
+    if (!tracker || !args.activityId)
+        return;
+    try {
+        const existing = await tracker.getRecord(args.activityId);
+        if (!existing)
+            return;
+        const billingPatch = buildActivixBillingPatch(args.billing, args.activixContext);
+        const patch = { ...billingPatch.topLevel };
+        const outer = isPlainObject(existing.outer) ? existing.outer : undefined;
+        const outerOutput = outer ? mergeParsedIntoOutputContainer(outer.output, args.parsed) : undefined;
+        const responseOutput = mergeParsedIntoOutputContainer(existing.response, args.parsed);
+        const outerPatched = outer
+            ? {
+                ...outer,
+                metadata: mergeMetadata(outer.metadata, billingPatch.outerMetadata),
+                ...(outerOutput !== undefined ? { output: outerOutput } : {}),
+                ...(billingPatch.outerCost !== undefined
+                    ? { cost: mergeOuterCost(outer.cost, billingPatch.outerCost) }
+                    : {}),
+            }
+            : undefined;
+        if (outerPatched !== undefined) {
+            patch.outer = outerPatched;
+        }
+        const existingResponse = isPlainObject(existing.response) ? existing.response : {};
+        if (responseOutput !== undefined || Object.keys(billingPatch.responseMetadata).length > 0) {
+            patch.response = {
+                ...existingResponse,
+                ...(responseOutput !== undefined ? responseOutput : {}),
+                metadata: mergeMetadata(existingResponse.metadata, billingPatch.responseMetadata),
+            };
+        }
+        if (Object.keys(patch).length === 0)
+            return;
+        await tracker.patchRecord(args.activityId, patch);
+    }
+    catch (err) {
+        args.logger.warn("[AI-SKILLS] Activix activity enrichment patch failed (non-blocking)", {
+            activityId: args.activityId,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=patch-activix-activity-after-skill.js.map

package/dist/utils/patch-activix-activity-after-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-activix-activity-after-skill.js","sourceRoot":"","sources":["../../src/utils/patch-activix-activity-after-skill.ts"],"names":[],"mappings":"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"}

package/dist/utils/rendrix-render-skill-templates.d.ts

@@ -0,0 +1,14 @@
+import type { RunSkillRequest } from "../types.js";
+/**
+ * Renders Catalox instruction/prompt template bodies with **`@x12i/rendrix`** using the same merged
+ * working-memory shape as {@link buildWorkingMemory} plus optional {@link RunSkillRequest.templateTokens}
+ * (short-term) and the same template-option merge order as the gateway
+ * ({@link mergeGatewayAndRequestTemplateRenderOptions} with no gateway default here).
+ *
+ * Exposed for tests and callers that need the same **`{{…}}`** resolution as the gateway without invoking it.
+ */
+export declare function renderSkillTemplatesWithRendrix(skillRequest: RunSkillRequest, instructionsPayload: string, promptPayload: string): {
+    instructionsRendered: string;
+    promptRendered: string;
+};
+//# sourceMappingURL=rendrix-render-skill-templates.d.ts.map

package/dist/utils/rendrix-render-skill-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendrix-render-skill-templates.d.ts","sourceRoot":"","sources":["../../src/utils/rendrix-render-skill-templates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC3C,YAAY,EAAE,eAAe,EAC7B,mBAAmB,EAAE,MAAM,EAC3B,aAAa,EAAE,MAAM,GACtB;IAAE,oBAAoB,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAgC1D"}

package/dist/utils/rendrix-render-skill-templates.js

@@ -0,0 +1,25 @@
+import { mergeGatewayAndRequestTemplateRenderOptions } from "@x12i/ai-gateway";
+import { render } from "@x12i/rendrix";
+import { buildWorkingMemory } from "../client/build-gateway-invoke-request.js";
+/**
+ * Renders Catalox instruction/prompt template bodies with **`@x12i/rendrix`** using the same merged
+ * working-memory shape as {@link buildWorkingMemory} plus optional {@link RunSkillRequest.templateTokens}
+ * (short-term) and the same template-option merge order as the gateway
+ * ({@link mergeGatewayAndRequestTemplateRenderOptions} with no gateway default here).
+ *
+ * Exposed for tests and callers that need the same **`{{…}}`** resolution as the gateway without invoking it.
+ */
+export function renderSkillTemplatesWithRendrix(skillRequest, instructionsPayload, promptPayload) {
+    const working = buildWorkingMemory(skillRequest);
+    const shortTerm = { ...(skillRequest.templateTokens ?? {}) };
+    const renderOptions = mergeGatewayAndRequestTemplateRenderOptions(undefined, {
+        smartInput: skillRequest.smartInput,
+        smartInputRenderOptions: skillRequest.smartInputRenderOptions,
+        templateRenderOptions: skillRequest.templateRenderOptions,
+    });
+    return {
+        instructionsRendered: render(instructionsPayload, working, shortTerm, undefined, undefined, undefined, undefined, undefined, renderOptions),
+        promptRendered: render(promptPayload, working, shortTerm, undefined, undefined, undefined, undefined, undefined, renderOptions),
+    };
+}
+//# sourceMappingURL=rendrix-render-skill-templates.js.map

package/dist/utils/rendrix-render-skill-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendrix-render-skill-templates.js","sourceRoot":"","sources":["../../src/utils/rendrix-render-skill-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2CAA2C,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,+BAA+B,CAC3C,YAA6B,EAC7B,mBAA2B,EAC3B,aAAqB;IAErB,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAkB,CAAC;IAClE,MAAM,SAAS,GAA4B,EAAE,GAAG,CAAC,YAAY,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAC;IACtF,MAAM,aAAa,GAAG,2CAA2C,CAAC,SAAS,EAAE;QACzE,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,uBAAuB,EAAE,YAAY,CAAC,uBAAuB;QAC7D,qBAAqB,EAAE,YAAY,CAAC,qBAAqB;KAC5D,CAAC,CAAC;IACH,OAAO;QACH,oBAAoB,EAAE,MAAM,CACxB,mBAAmB,EACnB,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,CAChB;QACD,cAAc,EAAE,MAAM,CAClB,aAAa,EACb,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,CAChB;KACJ,CAAC;AACN,CAAC"}

package/dist/utils/resolve-activity-id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gateway `invoke()` may omit top-level `metadata.activityId` even when activity tracking runs
+ * downstream. Map known metadata shapes so `runSkill` / audit callers still get a correlation id.
+ */
+export declare function resolveActivityIdFromGatewayMetadata(metadata: Record<string, unknown> | undefined | null, options?: {
+    jobId?: string;
+    fallbackSuffix?: string;
+}): string | undefined;
+//# sourceMappingURL=resolve-activity-id.d.ts.map

package/dist/utils/resolve-activity-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-activity-id.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-activity-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EACpD,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,MAAM,GAAG,SAAS,CAqBpB"}

package/dist/utils/resolve-activity-id.js

@@ -0,0 +1,27 @@
+/**
+ * Gateway `invoke()` may omit top-level `metadata.activityId` even when activity tracking runs
+ * downstream. Map known metadata shapes so `runSkill` / audit callers still get a correlation id.
+ */
+export function resolveActivityIdFromGatewayMetadata(metadata, options) {
+    if (!metadata)
+        return undefined;
+    const m = metadata;
+    const top = m.activityId;
+    if (typeof top === "string" && top.length > 0)
+        return top;
+    const air = m["ai-activities-response"];
+    if (air && typeof air === "object") {
+        const o = air;
+        if (typeof o.activityId === "string" && o.activityId.length > 0)
+            return o.activityId;
+        if (typeof o.requestId === "string" && o.requestId.length > 0)
+            return o.requestId;
+    }
+    const jobId = options?.jobId;
+    if (typeof jobId === "string" && jobId.length > 0) {
+        const suf = options?.fallbackSuffix;
+        return suf ? `${jobId}-${suf}` : jobId;
+    }
+    return undefined;
+}
+//# sourceMappingURL=resolve-activity-id.js.map

package/dist/utils/resolve-activity-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-activity-id.js","sourceRoot":"","sources":["../../src/utils/resolve-activity-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAClD,QAAoD,EACpD,OAAqD;IAErD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,CAAC,GAAG,QAAmC,CAAC;IAE9C,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC;IACzB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IAE1D,MAAM,GAAG,GAAG,CAAC,CAAC,wBAAwB,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,GAA8B,CAAC;QACzC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC,UAAU,CAAC;QACrF,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC,SAAS,CAAC;IACpF,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,OAAO,EAAE,cAAc,CAAC;QACpC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IACzC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/resolve-gateway-job-task-ids.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolves `jobId` / `taskId` for `AIGateway.invoke()` (Activix activity grouping).
+ * Prefer top-level request fields; if empty, read from upstream `identity`.
+ *
+ * **Gateway v9+:** `identity` on the invoke payload must include these strings; the gateway does not
+ * copy top-level `jobId` / `taskId` into `identity` — callers must merge them (see skill-executor / audit-manager).
+ */
+export type GatewayJobTaskResolution = {
+    jobId: string;
+    taskId: string;
+    missingJobId: boolean;
+    missingTaskId: boolean;
+};
+export declare function resolveGatewayJobAndTaskIds(params: {
+    jobId?: string | null;
+    taskId?: string | null;
+    identity?: Record<string, unknown> | null | undefined;
+}): GatewayJobTaskResolution;
+//# sourceMappingURL=resolve-gateway-job-task-ids.d.ts.map

package/dist/utils/resolve-gateway-job-task-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-gateway-job-task-ids.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-gateway-job-task-ids.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAQF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CACvD,GAAG,wBAAwB,CAe3B"}

package/dist/utils/resolve-gateway-job-task-ids.js

@@ -0,0 +1,21 @@
+function trimmedString(v) {
+    if (v === undefined || v === null)
+        return "";
+    if (typeof v !== "string")
+        return String(v).trim();
+    return v.trim();
+}
+export function resolveGatewayJobAndTaskIds(params) {
+    const id = params.identity && typeof params.identity === "object" && !Array.isArray(params.identity)
+        ? params.identity
+        : undefined;
+    const jobId = trimmedString(params.jobId) || trimmedString(id?.jobId);
+    const taskId = trimmedString(params.taskId) || trimmedString(id?.taskId);
+    return {
+        jobId,
+        taskId,
+        missingJobId: jobId.length === 0,
+        missingTaskId: taskId.length === 0,
+    };
+}
+//# sourceMappingURL=resolve-gateway-job-task-ids.js.map

package/dist/utils/resolve-gateway-job-task-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-gateway-job-task-ids.js","sourceRoot":"","sources":["../../src/utils/resolve-gateway-job-task-ids.ts"],"names":[],"mappings":"AAcA,SAAS,aAAa,CAAC,CAAU;IAC/B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,MAAM,EAAE,GACN,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QACvF,CAAC,CAAE,MAAM,CAAC,QAAoC;QAC9C,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAEzE,OAAO;QACL,KAAK;QACL,MAAM;QACN,YAAY,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC;QAChC,aAAa,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/utils/resolve-identity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve a downstream-provided **runtime** correlation envelope from gateway responses
+ * (same semantic as `ActivityIdentity` / Activix **`runContext`** in persistence—not client configuration).
+ *
+ * Tries `identity` on the response and common metadata paths first (canonical API shape), then
+ * **`metadata.runContext`** in case a path echoes the Activix BSON field name.
+ *
+ * Activix-oriented callers should treat the result as the enriched envelope to forward
+ * to the next hop (full object, not re-derived). Only plain objects qualify; else undefined.
+ */
+export declare function resolveIdentityFromGatewayResponse(response: unknown): Record<string, any> | undefined;
+//# sourceMappingURL=resolve-identity.d.ts.map

package/dist/utils/resolve-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-identity.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,OAAO,GAChB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CA0BjC"}

package/dist/utils/resolve-identity.js

@@ -0,0 +1,36 @@
+/**
+ * Resolve a downstream-provided **runtime** correlation envelope from gateway responses
+ * (same semantic as `ActivityIdentity` / Activix **`runContext`** in persistence—not client configuration).
+ *
+ * Tries `identity` on the response and common metadata paths first (canonical API shape), then
+ * **`metadata.runContext`** in case a path echoes the Activix BSON field name.
+ *
+ * Activix-oriented callers should treat the result as the enriched envelope to forward
+ * to the next hop (full object, not re-derived). Only plain objects qualify; else undefined.
+ */
+export function resolveIdentityFromGatewayResponse(response) {
+    const isPlainObject = (v) => {
+        if (!v || typeof v !== "object")
+            return false;
+        const proto = Object.getPrototypeOf(v);
+        return proto === Object.prototype || proto === null;
+    };
+    const r = response;
+    const candidates = [
+        r?.identity,
+        r?.metadata?.identity,
+        r?.metadata?.["ai-activities-response"]?.identity,
+        r?.metadata?.["ai-activities"]?.identity,
+        r?.metadata?.activity?.identity,
+        r?.metadata?.activityRecord?.identity,
+        r?.metadata?.runContext,
+        r?.metadata?.activity?.runContext,
+        r?.metadata?.activityRecord?.runContext,
+    ];
+    for (const c of candidates) {
+        if (isPlainObject(c))
+            return c;
+    }
+    return undefined;
+}
+//# sourceMappingURL=resolve-identity.js.map

package/dist/utils/resolve-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-identity.js","sourceRoot":"","sources":["../../src/utils/resolve-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAiB;IAEjB,MAAM,aAAa,GAAG,CAAC,CAAU,EAA4B,EAAE;QAC7D,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;IACtD,CAAC,CAAC;IAEF,MAAM,CAAC,GAAG,QAAe,CAAC;IAE1B,MAAM,UAAU,GAAc;QAC5B,CAAC,EAAE,QAAQ;QACX,CAAC,EAAE,QAAQ,EAAE,QAAQ;QACrB,CAAC,EAAE,QAAQ,EAAE,CAAC,wBAAwB,CAAC,EAAE,QAAQ;QACjD,CAAC,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE,QAAQ;QACxC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;QAC/B,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ;QACrC,CAAC,EAAE,QAAQ,EAAE,UAAU;QACvB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU;QACjC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU;KACxC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,aAAa,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/resolve-run-skill-ai-engine.d.ts

@@ -0,0 +1,8 @@
+import { type AiEngineCatalogItemId } from "../catalox/ai-engines-catalog.js";
+import type { RunSkillRequest } from "../types.js";
+/**
+ * Resolves optional {@link RunSkillRequest.aiEngineId} against the single supported engine (**`ai-gateway`**).
+ * Omitted / blank → {@link DEFAULT_AI_ENGINE_CATALOG_ITEM_ID}.
+ */
+export declare function resolveAiEngineIdForRunSkill(skillRequest: RunSkillRequest): AiEngineCatalogItemId;
+//# sourceMappingURL=resolve-run-skill-ai-engine.d.ts.map

package/dist/utils/resolve-run-skill-ai-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-run-skill-ai-engine.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-run-skill-ai-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,qBAAqB,EAC7B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,eAAe,GAAG,qBAAqB,CAejG"}

package/dist/utils/resolve-run-skill-ai-engine.js

@@ -0,0 +1,20 @@
+import { AI_ENGINE_CATALOG_ITEM_IDS, DEFAULT_AI_ENGINE_CATALOG_ITEM_ID, } from "../catalox/ai-engines-catalog.js";
+/**
+ * Resolves optional {@link RunSkillRequest.aiEngineId} against the single supported engine (**`ai-gateway`**).
+ * Omitted / blank → {@link DEFAULT_AI_ENGINE_CATALOG_ITEM_ID}.
+ */
+export function resolveAiEngineIdForRunSkill(skillRequest) {
+    const raw = skillRequest.aiEngineId;
+    if (raw === undefined || raw === null) {
+        return DEFAULT_AI_ENGINE_CATALOG_ITEM_ID;
+    }
+    const id = String(raw).trim();
+    if (id === "") {
+        return DEFAULT_AI_ENGINE_CATALOG_ITEM_ID;
+    }
+    if (!AI_ENGINE_CATALOG_ITEM_IDS.includes(id)) {
+        throw new Error(`[AI-SKILLS] Unknown aiEngineId "${id}". Allowlisted Catalox ai-engines catalog ids: ${AI_ENGINE_CATALOG_ITEM_IDS.join(", ")}.`);
+    }
+    return id;
+}
+//# sourceMappingURL=resolve-run-skill-ai-engine.js.map

package/dist/utils/resolve-run-skill-ai-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-run-skill-ai-engine.js","sourceRoot":"","sources":["../../src/utils/resolve-run-skill-ai-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,0BAA0B,EAC1B,iCAAiC,GAEpC,MAAM,kCAAkC,CAAC;AAG1C;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,YAA6B;IACtE,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC;IACpC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACpC,OAAO,iCAAiC,CAAC;IAC7C,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACZ,OAAO,iCAAiC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,0BAA0B,CAAC,QAAQ,CAAC,EAA2B,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CACX,mCAAmC,EAAE,kDAAkD,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClI,CAAC;IACN,CAAC;IACD,OAAO,EAA2B,CAAC;AACvC,CAAC"}

package/dist/utils/run-skill-request.d.ts

@@ -0,0 +1,11 @@
+import type { RunSkillRequest } from "../types.js";
+/**
+ * Required fields for {@link RunSkillRequest} plus optional copies of every other key.
+ * Does not accept arbitrary index signatures — avoids silently forwarding unknown props (e.g. obsolete `taskConfig`).
+ */
+export type RunSkillRequestFlat = Pick<RunSkillRequest, "skillKey" | "jobId" | "taskId" | "input" | "agentId" | "jobTypeId" | "taskTypeId"> & Partial<Omit<RunSkillRequest, "skillKey" | "jobId" | "taskId" | "input" | "agentId" | "jobTypeId" | "taskTypeId">>;
+/**
+ * Normalizes a single flat object into {@link RunSkillRequest} for `runSkill()`.
+ */
+export declare function runSkillRequestFromFlat(flat: RunSkillRequestFlat): RunSkillRequest;
+//# sourceMappingURL=run-skill-request.d.ts.map

package/dist/utils/run-skill-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-skill-request.d.ts","sourceRoot":"","sources":["../../src/utils/run-skill-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAClC,eAAe,EACf,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CACrF,GACG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC;AAEvH;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CA4ElF"}

package/dist/utils/run-skill-request.js

@@ -0,0 +1,44 @@
+/**
+ * Normalizes a single flat object into {@link RunSkillRequest} for `runSkill()`.
+ */
+export function runSkillRequestFromFlat(flat) {
+    const { skillKey, jobId, taskId, input, identity, sessionId, variables, executionMemory, context, knowledge, jobMemory, taskMemory, agentId, skillId, masterSkillId, masterSkillActivityId, graphId, nodeId, coreSkillId, prevNodeId, previousNodeId, timeoutMs, modelConfig, templateRenderOptions, smartInput, smartInputRenderOptions, templateTokens, executionMode, diagnostics, jobTypeId, taskTypeId, agentType, gatewayDiagnostics, aiEngineId, outputContract, } = flat;
+    return {
+        skillKey,
+        jobId,
+        taskId,
+        input,
+        agentId,
+        jobTypeId,
+        taskTypeId,
+        ...(identity !== undefined ? { identity } : {}),
+        ...(sessionId !== undefined ? { sessionId } : {}),
+        ...(variables !== undefined ? { variables } : {}),
+        ...(executionMemory !== undefined ? { executionMemory } : {}),
+        ...(context !== undefined ? { context } : {}),
+        ...(knowledge !== undefined ? { knowledge } : {}),
+        ...(jobMemory !== undefined ? { jobMemory } : {}),
+        ...(taskMemory !== undefined ? { taskMemory } : {}),
+        ...(skillId !== undefined ? { skillId } : {}),
+        ...(masterSkillId !== undefined ? { masterSkillId } : {}),
+        ...(masterSkillActivityId !== undefined ? { masterSkillActivityId } : {}),
+        ...(graphId !== undefined ? { graphId } : {}),
+        ...(nodeId !== undefined ? { nodeId } : {}),
+        ...(coreSkillId !== undefined ? { coreSkillId } : {}),
+        ...(prevNodeId !== undefined ? { prevNodeId } : {}),
+        ...(previousNodeId !== undefined ? { previousNodeId } : {}),
+        ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+        ...(modelConfig !== undefined ? { modelConfig } : {}),
+        ...(templateRenderOptions !== undefined ? { templateRenderOptions } : {}),
+        ...(smartInput !== undefined ? { smartInput } : {}),
+        ...(smartInputRenderOptions !== undefined ? { smartInputRenderOptions } : {}),
+        ...(templateTokens !== undefined ? { templateTokens } : {}),
+        ...(executionMode !== undefined ? { executionMode } : {}),
+        ...(diagnostics !== undefined ? { diagnostics } : {}),
+        ...(agentType !== undefined ? { agentType } : {}),
+        ...(gatewayDiagnostics !== undefined ? { gatewayDiagnostics } : {}),
+        ...(aiEngineId !== undefined ? { aiEngineId } : {}),
+        ...(outputContract !== undefined ? { outputContract } : {}),
+    };
+}
+//# sourceMappingURL=run-skill-request.js.map

package/dist/utils/run-skill-request.js.map

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

package/dist/utils/validate-mandatory-activix-invoke-fields.d.ts

@@ -0,0 +1,7 @@
+import type { RunSkillRequest } from "../types.js";
+/**
+ * Ensures Activix-oriented linkage fields are present on every skill invoke.
+ * Call before building the gateway payload.
+ */
+export declare function validateMandatoryActivixInvokeFields(skillRequest: RunSkillRequest): void;
+//# sourceMappingURL=validate-mandatory-activix-invoke-fields.d.ts.map

package/dist/utils/validate-mandatory-activix-invoke-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mandatory-activix-invoke-fields.d.ts","sourceRoot":"","sources":["../../src/utils/validate-mandatory-activix-invoke-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnD;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,CAIxF"}

package/dist/utils/validate-mandatory-activix-invoke-fields.js

@@ -0,0 +1,16 @@
+function assertNonEmptyTrimmed(field, value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`[AI-SKILLS] RunSkillRequest.${String(field)} is mandatory for gateway.invoke / Activix: upstream must supply a non-empty string (no package defaults).`);
+    }
+}
+/**
+ * Ensures Activix-oriented linkage fields are present on every skill invoke.
+ * Call before building the gateway payload.
+ */
+export function validateMandatoryActivixInvokeFields(skillRequest) {
+    assertNonEmptyTrimmed("agentId", skillRequest.agentId);
+    assertNonEmptyTrimmed("jobTypeId", skillRequest.jobTypeId);
+    assertNonEmptyTrimmed("taskTypeId", skillRequest.taskTypeId);
+}
+//# sourceMappingURL=validate-mandatory-activix-invoke-fields.js.map

package/dist/utils/validate-mandatory-activix-invoke-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-mandatory-activix-invoke-fields.js","sourceRoot":"","sources":["../../src/utils/validate-mandatory-activix-invoke-fields.ts"],"names":[],"mappings":"AAEA,SAAS,qBAAqB,CAAC,KAA0E,EAAE,KAAa;IACpH,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACX,+BAA+B,MAAM,CAAC,KAAK,CAAC,4GAA4G,CAC3J,CAAC;IACN,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAAC,YAA6B;IAC9E,qBAAqB,CAAC,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACvD,qBAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC3D,qBAAqB,CAAC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;AACjE,CAAC"}

package/dist/utils/validate-session-id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Activix / gateway contract: if both top-level `sessionId` and `identity.sessionId`
+ * are present, they must be equal. This package never generates `sessionId`.
+ */
+export declare function validateSessionIdAgreement(topLevel: string | undefined | null, identitySessionId: unknown): void;
+//# sourceMappingURL=validate-session-id.d.ts.map

package/dist/utils/validate-session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-session-id.d.ts","sourceRoot":"","sources":["../../src/utils/validate-session-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EACnC,iBAAiB,EAAE,OAAO,GACzB,IAAI,CAkBN"}