@exellix/ai-tasks 7.8.0

package/dist/activix/phaseTracking.js

@@ -0,0 +1,85 @@
+import { activixOuterTier } from "@x12i/activix";
+export function createPhaseMeta(args) {
+    const { correlationId, phase, ...rest } = args;
+    return { correlationId, phase, ...rest };
+}
+async function safeStartPhase(ax, meta) {
+    try {
+        const r = await ax.startRecord(meta);
+        return r.recordId;
+    }
+    catch {
+        return null;
+    }
+}
+async function safeCompletePhase(ax, recordId, updates) {
+    try {
+        await ax.completeRecord(recordId, updates);
+    }
+    catch {
+        // non-fatal by design
+    }
+}
+async function safeFailPhase(ax, recordId, error, updates) {
+    try {
+        const e = error instanceof Error ? error : new Error(String(error));
+        await ax.failRecord(recordId, e, updates);
+    }
+    catch {
+        // non-fatal by design
+    }
+}
+export async function withPhaseRecord(args) {
+    const { ax, correlationId, phase, meta, fn } = args;
+    if (!ax || !correlationId)
+        return fn();
+    // Activix 6+ validates `outer` / optional `inner` on every write. Correlation envelope lives in `runContext`
+    // (see `resolveRunContext` in @x12i/activix); do not use a top-level `identity` blob on activity rows.
+    const { outer: metaOuter, runContext: metaRunContext, identity: topLevelIdentity, ...metaRest } = (meta ?? {});
+    const outer = metaOuter !== undefined &&
+        metaOuter !== null &&
+        typeof metaOuter === "object" &&
+        !Array.isArray(metaOuter) &&
+        Object.prototype.hasOwnProperty.call(metaOuter, "input")
+        ? metaOuter
+        : activixOuterTier(null, null, {});
+    const runContext = {
+        ...(typeof topLevelIdentity === "object" && topLevelIdentity !== null && !Array.isArray(topLevelIdentity)
+            ? { ...topLevelIdentity }
+            : {}),
+        ...(typeof metaRunContext === "object" && metaRunContext !== null && !Array.isArray(metaRunContext)
+            ? { ...metaRunContext }
+            : {}),
+    };
+    if (correlationId) {
+        runContext.sessionId = correlationId;
+    }
+    const recordMeta = {
+        ...metaRest,
+        correlationId,
+        phase,
+        runContext,
+        outer,
+    };
+    const recordId = await safeStartPhase(ax, recordMeta);
+    if (!recordId) {
+        // Activix failure mid-flight should not block task execution.
+        return fn();
+    }
+    try {
+        const result = await fn();
+        await safeCompletePhase(ax, recordId, args.onSuccessUpdates?.(result));
+        return result;
+    }
+    catch (error) {
+        const errorUpdates = {
+            errorMessage: error instanceof Error ? error.message : String(error),
+            errorCode: error?.code,
+            errorName: error instanceof Error ? error.name : undefined,
+            ...(args.onErrorUpdates?.(error) ?? {}),
+        };
+        await safeFailPhase(ax, recordId, error, errorUpdates);
+        throw error;
+    }
+}
+//# sourceMappingURL=phaseTracking.js.map

package/dist/activix/phaseTracking.js.map

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

package/dist/aiScoping/index.d.ts

@@ -0,0 +1,6 @@
+export { validateAiScoping } from "./validateAiScoping.js";
+export { runScopingCall, AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION } from "./runScopingCall.js";
+export type { RunScopingCallOpts } from "./runScopingCall.js";
+export { runAiScoping } from "./runAiScoping.js";
+export type { RunAiScopingOpts, RunAiScopingResult } from "./runAiScoping.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/aiScoping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aiScoping/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,qCAAqC,EAAE,MAAM,qBAAqB,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/aiScoping/index.js

@@ -0,0 +1,4 @@
+export { validateAiScoping } from "./validateAiScoping.js";
+export { runScopingCall, AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION } from "./runScopingCall.js";
+export { runAiScoping } from "./runAiScoping.js";
+//# sourceMappingURL=index.js.map

package/dist/aiScoping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/aiScoping/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,qCAAqC,EAAE,MAAM,qBAAqB,CAAC;AAE5F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/aiScoping/runAiScoping.d.ts

@@ -0,0 +1,36 @@
+import type { AIScopingInstruction, AIScopedItem, AiScopingFailureRecord } from "../types/task-types.js";
+import type { DebugTraceCollector } from "../observability/debugTrace.js";
+import type { LlmCallConfig, LlmCallObservation } from "../types/llmCall.js";
+export type RunAiScopingOpts = {
+    bundle: {
+        jobMemory?: unknown;
+        taskMemory?: unknown;
+        executionMemory?: unknown;
+    };
+    instructions: AIScopingInstruction[];
+    concurrency?: number;
+    /** Per-call default `LlmCallConfig`; overridden by per-instruction `instruction.llmCall`. */
+    llmCall?: LlmCallConfig;
+    /** Trace mode forwarding (also enables `failures` + `llmCalls` capture). */
+    traceCollector?: DebugTraceCollector | null;
+    jobId?: string;
+    taskId?: string;
+};
+export type RunAiScopingResult = {
+    scoped: AIScopedItem[];
+    /** Per-item failure records (always populated; previously these were silently dropped). */
+    failures: AiScopingFailureRecord[];
+    /** Per-item `LlmCallObservation` (success + failure) — only populated in trace mode. */
+    llmCalls: LlmCallObservation[];
+};
+/**
+ * Runs all aiScoping instructions in parallel with bounded concurrency.
+ * Resolves source from bundle, calls internal LLM per item, returns results in original order.
+ *
+ * Behavior change vs. previous version:
+ *   - Failed items are NO LONGER silently dropped. The result now includes `failures[]` with the
+ *     originating index, target token, source path, and the typed upstream error.
+ *   - In trace mode, `llmCalls[]` carries every per-item `LlmCallObservation` (success + failure).
+ */
+export declare function runAiScoping(opts: RunAiScopingOpts): Promise<RunAiScopingResult>;
+//# sourceMappingURL=runAiScoping.d.ts.map

package/dist/aiScoping/runAiScoping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runAiScoping.d.ts","sourceRoot":"","sources":["../../src/aiScoping/runAiScoping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAEV,aAAa,EACb,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAU7B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACjF,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,2FAA2F;IAC3F,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,wFAAwF;IACxF,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAAC;AAIF;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoFtF"}

package/dist/aiScoping/runAiScoping.js

@@ -0,0 +1,100 @@
+import { getByPath } from "../utils/jsonPaths.js";
+import { validateAiScoping } from "./validateAiScoping.js";
+import { runScopingCall } from "./runScopingCall.js";
+import { LlmCallContextError } from "../types/llmCall.js";
+function serializeSourceValue(value) {
+    if (value === undefined || value === null)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return JSON.stringify(value);
+}
+const DEFAULT_CONCURRENCY = 5;
+/**
+ * Runs all aiScoping instructions in parallel with bounded concurrency.
+ * Resolves source from bundle, calls internal LLM per item, returns results in original order.
+ *
+ * Behavior change vs. previous version:
+ *   - Failed items are NO LONGER silently dropped. The result now includes `failures[]` with the
+ *     originating index, target token, source path, and the typed upstream error.
+ *   - In trace mode, `llmCalls[]` carries every per-item `LlmCallObservation` (success + failure).
+ */
+export async function runAiScoping(opts) {
+    const { bundle, instructions, concurrency = DEFAULT_CONCURRENCY, llmCall, traceCollector, jobId, taskId, } = opts;
+    validateAiScoping(instructions);
+    const tasks = [];
+    for (let i = 0; i < instructions.length; i++) {
+        const item = instructions[i];
+        const raw = getByPath(bundle, item.source);
+        if (raw === undefined || raw === null) {
+            continue;
+        }
+        const sourceContent = serializeSourceValue(raw);
+        tasks.push({ index: i, item, sourceContent });
+    }
+    const results = new Array(instructions.length);
+    const failures = [];
+    const llmCalls = [];
+    let next = 0;
+    const observationSink = traceCollector
+        ? (obs) => {
+            llmCalls.push(obs);
+        }
+        : undefined;
+    async function worker() {
+        while (next < tasks.length) {
+            const i = next++;
+            const { index, item, sourceContent } = tasks[i];
+            const itemLlmCall = {
+                ...(llmCall ?? {}),
+                ...(item.llmCall ?? {}),
+            };
+            try {
+                const scopedInfo = await runScopingCall({
+                    instructions: item.instructions,
+                    sourceContent,
+                    llmCall: itemLlmCall,
+                    traceCollector,
+                    jobId,
+                    taskId,
+                    stepId: `ai-scoping-${index}-${item.targetToken}`,
+                    observationSink,
+                });
+                results[index] = { token: item.targetToken, scopedInfo };
+            }
+            catch (err) {
+                results[index] = null;
+                failures.push({
+                    index,
+                    targetToken: item.targetToken,
+                    source: item.source,
+                    error: {
+                        name: err instanceof Error ? err.name : "Error",
+                        message: err instanceof Error ? err.message : String(err),
+                        invokeSummary: pickInvokeSummary(err),
+                        observation: err instanceof LlmCallContextError ? err.observation : undefined,
+                    },
+                });
+            }
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, tasks.length) || 1 }, () => worker());
+    await Promise.all(workers);
+    return {
+        scoped: results.filter((r) => r !== null),
+        failures,
+        llmCalls,
+    };
+}
+function pickInvokeSummary(err) {
+    if (err && typeof err === "object" && "invokeSummary" in err) {
+        const summary = err.invokeSummary;
+        if (summary && typeof summary === "object") {
+            return summary;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=runAiScoping.js.map

package/dist/aiScoping/runAiScoping.js.map

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

package/dist/aiScoping/runScopingCall.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Single internal AI scoping LLM call. Uses only the provided source content.
+ */
+import type { DebugTraceCollector } from "../observability/debugTrace.js";
+import type { DebugTraceTask } from "../types/task-types.js";
+import type { LlmCallConfig, LlmCallObservation, OutputExpectation } from "../types/llmCall.js";
+export declare const AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION: OutputExpectation;
+export type RunScopingCallOpts = {
+    instructions: string;
+    sourceContent: string;
+    llmCall?: LlmCallConfig;
+    traceCollector?: DebugTraceCollector | null;
+    traceTask?: Omit<DebugTraceTask, "metadata"> & {
+        metadata?: Record<string, unknown>;
+    };
+    observationSink?: (obs: LlmCallObservation) => void;
+    jobId?: string;
+    taskId?: string;
+    agentId?: string;
+    stepId?: string;
+};
+export declare function runScopingCall(opts: RunScopingCallOpts): Promise<string>;
+//# sourceMappingURL=runScopingCall.d.ts.map

package/dist/aiScoping/runScopingCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScopingCall.d.ts","sourceRoot":"","sources":["../../src/aiScoping/runScopingCall.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAKhG,eAAO,MAAM,qCAAqC,EAAE,iBAGnD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,SAAS,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtF,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD9E"}

package/dist/aiScoping/runScopingCall.js

@@ -0,0 +1,50 @@
+/**
+ * Single internal AI scoping LLM call. Uses only the provided source content.
+ */
+import { runPostStepLlmCall } from "../internal/runPostStepLlmCall.js";
+const SCOPING_SYSTEM = "Use only the provided source content. Do not invent missing facts. Return a concise scoped result as plain text for a downstream AI task. No markdown, no code fences.";
+export const AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION = {
+    size: { mode: "absolute", minWords: 5, maxWords: 200 },
+    density: "concise",
+};
+export async function runScopingCall(opts) {
+    const { instructions, sourceContent, llmCall, traceCollector, traceTask, observationSink, jobId = "ai-scoping", taskId, agentId = "ai-scoping", stepId, } = opts;
+    const userPrompt = `Instructions:\n${instructions}\n\nSource content:\n${sourceContent}`;
+    const effectiveLlmCall = {
+        ...(llmCall ?? {}),
+        outputExpectation: llmCall?.outputExpectation ?? AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION,
+    };
+    const effectiveTimeout = effectiveLlmCall.timeoutMs;
+    const effectiveMaxOutputLength = effectiveLlmCall.maxOutputLength;
+    const doInvoke = async () => {
+        const { text: rawText } = await runPostStepLlmCall({
+            systemPrompt: SCOPING_SYSTEM,
+            userPrompt,
+            llmCall: effectiveLlmCall,
+            stage: "ai-scoping",
+            stepId,
+            outputExpectationDefault: AI_SCOPING_DEFAULT_OUTPUT_EXPECTATION,
+            jobId,
+            taskId,
+            agentId,
+            traceCollector,
+            traceTask,
+            observationSink,
+        });
+        let text = rawText.trim();
+        if (typeof effectiveMaxOutputLength === "number" &&
+            effectiveMaxOutputLength > 0 &&
+            text.length > effectiveMaxOutputLength) {
+            text = text.slice(0, effectiveMaxOutputLength);
+        }
+        return text;
+    };
+    if (typeof effectiveTimeout === "number" && effectiveTimeout > 0) {
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error("Scoping call timeout")), effectiveTimeout);
+        });
+        return Promise.race([doInvoke(), timeoutPromise]);
+    }
+    return doInvoke();
+}
+//# sourceMappingURL=runScopingCall.js.map

package/dist/aiScoping/runScopingCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runScopingCall.js","sourceRoot":"","sources":["../../src/aiScoping/runScopingCall.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,MAAM,cAAc,GAClB,wKAAwK,CAAC;AAE3K,MAAM,CAAC,MAAM,qCAAqC,GAAsB;IACtE,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE;IACtD,OAAO,EAAE,SAAS;CACnB,CAAC;AAeF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAwB;IAC3D,MAAM,EACJ,YAAY,EACZ,aAAa,EACb,OAAO,EACP,cAAc,EACd,SAAS,EACT,eAAe,EACf,KAAK,GAAG,YAAY,EACpB,MAAM,EACN,OAAO,GAAG,YAAY,EACtB,MAAM,GACP,GAAG,IAAI,CAAC;IACT,MAAM,UAAU,GAAG,kBAAkB,YAAY,wBAAwB,aAAa,EAAE,CAAC;IAEzF,MAAM,gBAAgB,GAAkB;QACtC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAClB,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,IAAI,qCAAqC;KACvF,CAAC;IACF,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,SAAS,CAAC;IACpD,MAAM,wBAAwB,GAAG,gBAAgB,CAAC,eAAe,CAAC;IAElE,MAAM,QAAQ,GAAG,KAAK,IAAqB,EAAE;QAC3C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC;YACjD,YAAY,EAAE,cAAc;YAC5B,UAAU;YACV,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,YAAY;YACnB,MAAM;YACN,wBAAwB,EAAE,qCAAqC;YAC/D,KAAK;YACL,MAAM;YACN,OAAO;YACP,cAAc;YACd,SAAS;YACT,eAAe;SAChB,CAAC,CAAC;QACH,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC1B,IACE,OAAO,wBAAwB,KAAK,QAAQ;YAC5C,wBAAwB,GAAG,CAAC;YAC5B,IAAI,CAAC,MAAM,GAAG,wBAAwB,EACtC,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACtD,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,EAAE,CAAC;AACpB,CAAC"}

package/dist/aiScoping/validateAiScoping.d.ts

@@ -0,0 +1,7 @@
+import type { AIScopingInstruction } from "../types/task-types.js";
+/**
+ * Validates aiScoping instructions. Throws on invalid or duplicate targetToken.
+ * Call only when aiScoping is present and non-empty.
+ */
+export declare function validateAiScoping(items: AIScopingInstruction[]): void;
+//# sourceMappingURL=validateAiScoping.d.ts.map

package/dist/aiScoping/validateAiScoping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAiScoping.d.ts","sourceRoot":"","sources":["../../src/aiScoping/validateAiScoping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,IAAI,CA2BrE"}

package/dist/aiScoping/validateAiScoping.js

@@ -0,0 +1,33 @@
+/**
+ * Validates aiScoping instructions. Throws on invalid or duplicate targetToken.
+ * Call only when aiScoping is present and non-empty.
+ */
+export function validateAiScoping(items) {
+    if (!Array.isArray(items) || items.length === 0) {
+        throw new Error("aiScoping must be a non-empty array");
+    }
+    const seen = new Set();
+    for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        if (!item || typeof item !== "object") {
+            throw new Error(`aiScoping[${i}] must be an object`);
+        }
+        const source = item.source;
+        if (typeof source !== "string" || source.trim() === "") {
+            throw new Error(`aiScoping[${i}].source must be a non-empty string`);
+        }
+        const instructions = item.instructions;
+        if (typeof instructions !== "string" || instructions.trim() === "") {
+            throw new Error(`aiScoping[${i}].instructions must be a non-empty string`);
+        }
+        const targetToken = item.targetToken;
+        if (typeof targetToken !== "string" || targetToken.trim() === "") {
+            throw new Error(`aiScoping[${i}].targetToken must be a non-empty string`);
+        }
+        if (seen.has(targetToken)) {
+            throw new Error(`aiScoping: duplicate targetToken "${targetToken}"`);
+        }
+        seen.add(targetToken);
+    }
+}
+//# sourceMappingURL=validateAiScoping.js.map

package/dist/aiScoping/validateAiScoping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAiScoping.js","sourceRoot":"","sources":["../../src/aiScoping/validateAiScoping.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,qCAAqC,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACvC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,2CAA2C,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACrC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,0CAA0C,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,qCAAqC,WAAW,GAAG,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/aiSkillsUpstreamExports.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Re-exports the **Catalox-backed `ai-skills` catalog** surface and related helpers from `@exellix/ai-skills`,
+ * so downstream apps can depend on `@exellix/ai-tasks` only.
+ *
+ * Gateway key helpers remain on {@link ./skillCatalogExports.js}.
+ */
+export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_LLM_IDENTITY_KEY, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, extractRunnableTemplateBodiesFromAiSkillsCatalogData, defaultAiSkillsCataloxContext, CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, initFirebaseAdminFromEnv, createCataloxFromEnv, enrichIdentityWithAiSkillsLlmSnapshot, normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, getSkillTokens, getSkillContent, modifySkillContent, createSubSkill, deleteSubSkill, SKILL_TEMPLATE_ROLES_ORDER, upsertSkillCatalogItem, softDeleteSkillCatalogItem, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, runSkillRequestFromFlat, resolveAiEngineIdForRunSkill, SkillExecutionTraceError, includeRawProviderPayload, isTraceExecutionMode, } from "@exellix/ai-skills";
+export type { AiSkillsCatalogItemSpec, AiSkillsLlmIdentitySlice, CatalogReleaseStatus, AiSkillsPublishedItem, ListAiSkillsCatalogItemsResult, SkillCatalogStatus, FetchSkillTemplatesMode, ExtractedTemplateInputs, RunnableTemplateBodiesFromCatalogData, SkillTemplatesPresentation, SkillTemplatePresentationPatch, UpdateSkillTemplatesFromPresentationOptions, UpsertSkillCatalogItemInput, UpsertSkillCatalogItemOptions, SkillTemplateRole, SkillContentPart, ModifySkillContentResult, CreateSubSkillOverrides, CreateSubSkillInput, CreateSubSkillResult, DeleteSubSkillResult, AnalyzeSkillRequestOptions, AnalyzeSkillRequestResult, BuildSkillRequestAnalysisPacketResult, SkillRequestAnalysisCategory, SkillRequestAnalysisFinding, SkillRequestAnalysisReport, SkillRequestAnalysisSeverity, SkillRequestAnalysisVerdict, AnalyzeGatewayInvokeRequestPacket, RunSkillRequestFlat, GatewayExecutionSummary, OutputContract, } from "@exellix/ai-skills";
+/** Lower-level execution entrypoints from `@exellix/ai-skills` (same package as {@link ExellixSkillsClient}). */
+export { SkillExecutor, BaseClient } from "@exellix/ai-skills";
+/** Markdown helper for gateway context payloads. */
+export { contextToMarkdownString } from "@exellix/ai-skills";
+//# sourceMappingURL=aiSkillsUpstreamExports.d.ts.map

package/dist/aiSkillsUpstreamExports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSkillsUpstreamExports.d.ts","sourceRoot":"","sources":["../src/aiSkillsUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,oDAAoD,EACpD,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,qCAAqC,EACrC,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,8BAA8B,EAC9B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,qCAAqC,EACrC,0BAA0B,EAC1B,8BAA8B,EAC9B,2CAA2C,EAC3C,2BAA2B,EAC3B,6BAA6B,EAC7B,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,qCAAqC,EACrC,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,iCAAiC,EACjC,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/aiSkillsUpstreamExports.js

@@ -0,0 +1,12 @@
+/**
+ * Re-exports the **Catalox-backed `ai-skills` catalog** surface and related helpers from `@exellix/ai-skills`,
+ * so downstream apps can depend on `@exellix/ai-tasks` only.
+ *
+ * Gateway key helpers remain on {@link ./skillCatalogExports.js}.
+ */
+export { AI_SKILLS_APP_ID, AI_SKILLS_CATALOG_ID, AI_SKILLS_DESCRIPTOR_VERSION, AI_SKILLS_CATALOG_ITEMS, AI_SKILLS_LLM_IDENTITY_KEY, buildAiSkillsCatalogDescriptor, computeSkillRowStatus, listAiSkillsCatalogItems, catalogSkillKeyToRunSkillKey, catalogItemIdFromSkillKey, fetchSkillTemplatesFromCatalox, extractRunnableTemplateBodiesFromAiSkillsCatalogData, defaultAiSkillsCataloxContext, CataloxSkillNotFoundError, CataloxSkillAlreadyExistsError, CataloxSkillNotRunnableError, initFirebaseAdminFromEnv, createCataloxFromEnv, enrichIdentityWithAiSkillsLlmSnapshot, normalizeForStorage, toPresentationMarkdown, extractTemplateTokensFromTexts, extractTokenNamesFromStrings, getSkillTemplatesForPresentation, updateSkillTemplatesFromPresentation, getSkillTemplateInputs, getSkillTokens, getSkillContent, modifySkillContent, createSubSkill, deleteSubSkill, SKILL_TEMPLATE_ROLES_ORDER, upsertSkillCatalogItem, softDeleteSkillCatalogItem, analyzeSkillRequest, buildSkillRequestAnalysisPacket, formatSkillRequestAnalysisMarkdown, FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY, runSkillRequestFromFlat, resolveAiEngineIdForRunSkill, SkillExecutionTraceError, includeRawProviderPayload, isTraceExecutionMode, } from "@exellix/ai-skills";
+/** Lower-level execution entrypoints from `@exellix/ai-skills` (same package as {@link ExellixSkillsClient}). */
+export { SkillExecutor, BaseClient } from "@exellix/ai-skills";
+/** Markdown helper for gateway context payloads. */
+export { contextToMarkdownString } from "@exellix/ai-skills";
+//# sourceMappingURL=aiSkillsUpstreamExports.js.map

package/dist/aiSkillsUpstreamExports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSkillsUpstreamExports.js","sourceRoot":"","sources":["../src/aiSkillsUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,yBAAyB,EACzB,8BAA8B,EAC9B,oDAAoD,EACpD,6BAA6B,EAC7B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,mBAAmB,EACnB,sBAAsB,EACtB,8BAA8B,EAC9B,4BAA4B,EAC5B,gCAAgC,EAChC,oCAAoC,EACpC,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,mBAAmB,EACnB,+BAA+B,EAC/B,kCAAkC,EAClC,uCAAuC,EACvC,qCAAqC,EACrC,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAsC5B,iHAAiH;AACjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE/D,oDAAoD;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/analysis/analyzeRunTaskRequest.d.ts

@@ -0,0 +1,29 @@
+import type { Catalox } from "@x12i/catalox";
+import type { Logxer } from "@x12i/logxer";
+import { type AnalyzeSkillRequestOptions, type AnalyzeSkillRequestResult } from "@exellix/ai-skills";
+import type { RunTaskRequest } from "../types/task-types.js";
+import type { RunTaskValidationIssue } from "../validation/types.js";
+export type AnalyzeRunTaskRequestOptions = AnalyzeSkillRequestOptions & {
+    logger?: Logxer;
+    /**
+     * When true (default), merge {@link validateRunTaskConfig} errors/warnings into the analysis report
+     * as additional findings (catalog / activix / modelConfig / template categories).
+     */
+    includeAiTasksConfigValidation?: boolean;
+};
+export type AnalyzeRunTaskRequestResult = AnalyzeSkillRequestResult & {
+    /** ai-tasks-specific static validation (correlation ids, pipeline, smartInput shape, llmCall). */
+    aiTasksConfigValidation?: {
+        ok: boolean;
+        issues: RunTaskValidationIssue[];
+    };
+};
+/**
+ * Preflight analysis for a {@link RunTaskRequest}: forwards to `@exellix/ai-skills`
+ * {@link analyzeSkillRequest} on the {@link pickRunSkillRequestFields} slice and optionally
+ * merges ai-tasks {@link validateRunTaskConfig} findings.
+ *
+ * Does **not** invoke `runTask`, xynthesis, or the gateway skill executor.
+ */
+export declare function analyzeRunTaskRequest(catalox: Catalox, request: RunTaskRequest, options?: AnalyzeRunTaskRequestOptions): Promise<AnalyzeRunTaskRequestResult>;
+//# sourceMappingURL=analyzeRunTaskRequest.d.ts.map

package/dist/analysis/analyzeRunTaskRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeRunTaskRequest.d.ts","sourceRoot":"","sources":["../../src/analysis/analyzeRunTaskRequest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAE/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,GAAG;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,yBAAyB,GAAG;IACpE,kGAAkG;IAClG,uBAAuB,CAAC,EAAE;QACxB,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,EAAE,sBAAsB,EAAE,CAAC;KAClC,CAAC;CACH,CAAC;AAgCF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,2BAA2B,CAAC,CAoDtC"}

package/dist/analysis/analyzeRunTaskRequest.js

@@ -0,0 +1,85 @@
+import { analyzeSkillRequest, } from "@exellix/ai-skills";
+import { pickRunSkillRequestFields } from "../utils/bridgeRunSkillGatewayMemory.js";
+import { validateRunTaskConfig } from "../validation/validateRunTaskConfig.js";
+function categoryForAiTasksIssue(issue) {
+    const p = issue.path ?? "";
+    if (p.startsWith("smartInput"))
+        return "smartInput";
+    if (p.includes("executionPipeline"))
+        return "template";
+    if (p.includes("executionMemory"))
+        return "executionMemory";
+    if (p.includes("modelConfig") || p.includes("llmCall") || p.includes("timeoutMs"))
+        return "modelConfig";
+    if (p.startsWith("agentId") || p.startsWith("jobTypeId") || p.startsWith("taskTypeId"))
+        return "activix";
+    return "catalog";
+}
+function aiTasksIssueToFinding(issue) {
+    return {
+        id: `AI_TASKS_${issue.code}`,
+        severity: issue.severity,
+        category: categoryForAiTasksIssue(issue),
+        path: issue.path,
+        message: issue.message,
+        suggestion: "Fix the RunTaskRequest field before runTask() or graph compile.",
+    };
+}
+function mergeVerdict(a, b) {
+    if (a === "errors" || b === "errors")
+        return "errors";
+    if (a === "warnings" || b === "warnings")
+        return "warnings";
+    return "ok";
+}
+/**
+ * Preflight analysis for a {@link RunTaskRequest}: forwards to `@exellix/ai-skills`
+ * {@link analyzeSkillRequest} on the {@link pickRunSkillRequestFields} slice and optionally
+ * merges ai-tasks {@link validateRunTaskConfig} findings.
+ *
+ * Does **not** invoke `runTask`, xynthesis, or the gateway skill executor.
+ */
+export async function analyzeRunTaskRequest(catalox, request, options) {
+    const skillRequest = pickRunSkillRequestFields(request);
+    let aiTasksConfigValidation;
+    const extraFindings = [];
+    if (options?.includeAiTasksConfigValidation !== false) {
+        const v = validateRunTaskConfig(request);
+        aiTasksConfigValidation = { ok: v.ok, issues: v.issues };
+        extraFindings.push(...v.issues.map(aiTasksIssueToFinding));
+    }
+    const skillResult = await analyzeSkillRequest(catalox, skillRequest, options);
+    if (extraFindings.length === 0) {
+        return { ...skillResult, aiTasksConfigValidation };
+    }
+    const mergedFindings = [...skillResult.deterministicFindings, ...extraFindings];
+    const configVerdict = aiTasksConfigValidation?.ok
+        ? "ok"
+        : aiTasksConfigValidation?.issues.some((i) => i.severity === "error")
+            ? "errors"
+            : "warnings";
+    const verdict = mergeVerdict(skillResult.verdict, configVerdict);
+    const report = {
+        ...skillResult.report,
+        verdict,
+        findings: [...skillResult.report.findings, ...extraFindings],
+        configAssessment: {
+            ...skillResult.report.configAssessment,
+            issues: [
+                ...skillResult.report.configAssessment.issues,
+                ...extraFindings.filter((f) => f.category === "modelConfig" ||
+                    f.category === "catalog" ||
+                    f.category === "activix" ||
+                    f.category === "template"),
+            ],
+        },
+    };
+    return {
+        ...skillResult,
+        verdict,
+        deterministicFindings: mergedFindings,
+        report,
+        aiTasksConfigValidation,
+    };
+}
+//# sourceMappingURL=analyzeRunTaskRequest.js.map

package/dist/analysis/analyzeRunTaskRequest.js.map

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

package/dist/analysis/index.d.ts

@@ -0,0 +1,3 @@
+export { analyzeRunTaskRequest } from "./analyzeRunTaskRequest.js";
+export type { AnalyzeRunTaskRequestOptions, AnalyzeRunTaskRequestResult } from "./analyzeRunTaskRequest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/analysis/index.js

@@ -0,0 +1,2 @@
+export { analyzeRunTaskRequest } from "./analyzeRunTaskRequest.js";
+//# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}