@exellix/ai-tasks 7.8.0

package/dist/post-steps/polish/loadPolishTemplates.js

@@ -0,0 +1,38 @@
+/**
+ * Load polish POST step templates. Base path = POLISH_TEMPLATES_PATH or cwd/templates/post-steps/polish.
+ */
+import { readFile } from "fs/promises";
+import { join } from "path";
+import Handlebars from "handlebars";
+const DEFAULT_SYSTEM = `You are a content polisher. Refine the output per the checklist. Respond with JSON: { "polishedOutput": "...", "changeNotes": [...] }.`;
+const DEFAULT_USER = `Output to polish:\n\n{{currentOutput}}\n\nChecklist: {{checklist}}`;
+function getBasePath() {
+    return process.env.POLISH_TEMPLATES_PATH ?? process.cwd();
+}
+export async function loadPolishTemplates() {
+    const base = join(getBasePath(), "templates", "post-steps", "polish");
+    let system = DEFAULT_SYSTEM;
+    let user = DEFAULT_USER;
+    try {
+        system = await readFile(join(base, "system.md"), "utf-8");
+    }
+    catch {
+        /* use default */
+    }
+    try {
+        user = await readFile(join(base, "user.txt"), "utf-8");
+    }
+    catch {
+        /* use default */
+    }
+    return { system, user };
+}
+export function renderPolishSystem(template, data) {
+    const t = Handlebars.compile(template);
+    return t(data);
+}
+export function renderPolishUser(template, data) {
+    const t = Handlebars.compile(template);
+    return t(data);
+}
+//# sourceMappingURL=loadPolishTemplates.js.map

package/dist/post-steps/polish/loadPolishTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadPolishTemplates.js","sourceRoot":"","sources":["../../../src/post-steps/polish/loadPolishTemplates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,MAAM,cAAc,GAAG,wIAAwI,CAAC;AAChK,MAAM,YAAY,GAAG,oEAAoE,CAAC;AAI1F,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IACtE,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,IAAI,IAAI,GAAG,YAAY,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,IAAuF;IAC1I,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAUlD;IACC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/post-steps/polish/parsePolishOutput.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract JSON from polish LLM response (may be wrapped in markdown code fence).
+ */
+import type { PolishLLMOutput } from "../../types/task-types.js";
+export declare function parsePolishOutput(text: string): PolishLLMOutput | null;
+//# sourceMappingURL=parsePolishOutput.d.ts.map

package/dist/post-steps/polish/parsePolishOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePolishOutput.d.ts","sourceRoot":"","sources":["../../../src/post-steps/polish/parsePolishOutput.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAwBjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAiBtE"}

package/dist/post-steps/polish/parsePolishOutput.js

@@ -0,0 +1,47 @@
+/**
+ * Extract JSON from polish LLM response (may be wrapped in markdown code fence).
+ */
+function extractJsonFromText(text) {
+    const trimmed = text.trim();
+    const codeBlock = /^```(?:json)?\s*([\s\S]*?)```\s*$/m.exec(trimmed);
+    if (codeBlock)
+        return codeBlock[1].trim();
+    const firstBrace = trimmed.indexOf("{");
+    if (firstBrace === -1)
+        return trimmed;
+    let depth = 0;
+    let end = -1;
+    for (let i = firstBrace; i < trimmed.length; i++) {
+        const c = trimmed[i];
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0) {
+                end = i + 1;
+                break;
+            }
+        }
+    }
+    return end > 0 ? trimmed.slice(firstBrace, end) : trimmed.slice(firstBrace);
+}
+export function parsePolishOutput(text) {
+    try {
+        const jsonStr = extractJsonFromText(text);
+        const parsed = JSON.parse(jsonStr);
+        if (parsed && typeof parsed === "object" && "polishedOutput" in parsed && typeof parsed.polishedOutput === "string") {
+            const p = parsed;
+            return {
+                polishedOutput: p.polishedOutput,
+                changeNotes: Array.isArray(p.changeNotes)
+                    ? p.changeNotes
+                    : [],
+            };
+        }
+    }
+    catch {
+        /* ignore */
+    }
+    return null;
+}
+//# sourceMappingURL=parsePolishOutput.js.map

package/dist/post-steps/polish/parsePolishOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePolishOutput.js","sourceRoot":"","sources":["../../../src/post-steps/polish/parsePolishOutput.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,oCAAoC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aAClB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YACnB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;gBACZ,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;QAC9C,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,gBAAgB,IAAI,MAAM,IAAI,OAAQ,MAAc,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YAC7H,MAAM,CAAC,GAAG,MAAiC,CAAC;YAC5C,OAAO;gBACL,cAAc,EAAE,CAAC,CAAC,cAAwB;gBAC1C,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC;oBACvC,CAAC,CAAE,CAAC,CAAC,WAAwF;oBAC7F,CAAC,CAAC,EAAE;aACP,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/post-steps/polish/runPolish.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Polish POST step: refinement pass against a prioritized checklist.
+ */
+import type { PolishConfig, PolishPostStepMetadata, IntermediateStep } from "../../types/task-types.js";
+import type { DebugTraceCollector } from "../../observability/debugTrace.js";
+export type RunPolishPostStepContext = {
+    currentOutput: string;
+    config: PolishConfig;
+    originalInput?: unknown;
+    promptContext?: string;
+    /** Optional runTask trace collector (executionMode: "trace"). */
+    traceCollector?: DebugTraceCollector | null;
+    /** Optional job/task identifiers for trace metadata. */
+    jobId?: string;
+    taskId?: string;
+    skillKey?: string;
+};
+export type RunPolishPostStepResult = {
+    outputText: string;
+    metadata: PolishPostStepMetadata;
+    intermediateSteps: IntermediateStep[];
+};
+export declare function runPolishPostStep(ctx: RunPolishPostStepContext): Promise<RunPolishPostStepResult>;
+//# sourceMappingURL=runPolish.d.ts.map

package/dist/post-steps/polish/runPolish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPolish.d.ts","sourceRoot":"","sources":["../../../src/post-steps/polish/runPolish.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAmB,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACzH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAS7E,MAAM,MAAM,wBAAwB,GAAG;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsJvG"}

package/dist/post-steps/polish/runPolish.js

@@ -0,0 +1,147 @@
+/**
+ * Polish POST step: refinement pass against a prioritized checklist.
+ */
+import { llmCallEnvPrefix, resolveLlmCall } from "../resolvePostStepConfig.js";
+import { loadPolishTemplates, renderPolishSystem, renderPolishUser } from "./loadPolishTemplates.js";
+import { runPolishCall } from "./runPolishCall.js";
+import { parsePolishOutput } from "./parsePolishOutput.js";
+import { resolveOutputExpectation } from "@exellix/xynthesis/ai-actions";
+export async function runPolishPostStep(ctx) {
+    const started = Date.now();
+    const { currentOutput, config, originalInput, promptContext, traceCollector } = ctx;
+    const checklist = config.checklist ?? [];
+    const maxPasses = config.maxPasses ?? 1;
+    const highPriority = checklist.filter((c) => c.priority === "high").map((c) => ({ instruction: c.instruction }));
+    const mediumPriority = checklist.filter((c) => c.priority === "medium").map((c) => ({ instruction: c.instruction }));
+    const lowPriority = checklist.filter((c) => c.priority === "low").map((c) => ({ instruction: c.instruction }));
+    // Resolve effective LlmCallConfig for the polish LLM call. `config.llmCall` overrides legacy
+    // `modelConfig.model` / `timeoutMs`, which themselves remain backward-compatible fallbacks.
+    // Default `outputExpectation` from `resolveOutputExpectation("fix")`.
+    const polishLlmCallInput = {
+        ...(config.llmCall ?? {}),
+        model: config.llmCall?.model ??
+            config.modelConfig?.model,
+        timeoutMs: config.llmCall?.timeoutMs ?? config.timeoutMs,
+    };
+    const polishLlmCall = resolveLlmCall(polishLlmCallInput, llmCallEnvPrefix("POLISH"), {}, {
+        outputExpectation: resolveOutputExpectation("fix"),
+        timeoutMs: 30_000,
+    });
+    const model = polishLlmCall.model;
+    const templates = await loadPolishTemplates();
+    const allChangeNotes = [];
+    const intermediateSteps = [];
+    let lastOutput = currentOutput;
+    let nextStepNumber = 1;
+    // Trace-mode-only: per-pass observations surface on `metadata.llmCalls`.
+    const llmCalls = [];
+    const observationSink = traceCollector
+        ? (obs) => {
+            llmCalls.push(obs);
+        }
+        : undefined;
+    const includeOriginalContext = config.includeOriginalContext === true;
+    const originalInputStr = originalInput !== undefined
+        ? typeof originalInput === "string"
+            ? originalInput
+            : JSON.stringify(originalInput, null, 2)
+        : "";
+    let previousPassNotes = [];
+    for (let pass = 1; pass <= maxPasses; pass++) {
+        let rawText;
+        try {
+            const systemPrompt = renderPolishSystem(templates.system, {
+                customGuidelines: config.customGuidelines,
+                previousPassNotes: pass > 1 ? previousPassNotes : undefined,
+                passNumber: pass,
+            });
+            const userPrompt = renderPolishUser(templates.user, {
+                currentOutput: lastOutput,
+                highPriority,
+                mediumPriority,
+                lowPriority,
+                includeOriginalContext,
+                originalInput: includeOriginalContext ? originalInputStr : undefined,
+                promptContext: includeOriginalContext ? promptContext : undefined,
+                previousPassNotes: pass > 1 ? previousPassNotes : undefined,
+                previousPassNumber: pass - 1,
+            });
+            const stepId = `polish-pass-${pass}`;
+            const traceTask = traceCollector
+                ? {
+                    taskType: "post-execution",
+                    details: "polish call",
+                    modelUsed: model ?? null,
+                    metadata: {
+                        jobId: ctx.jobId,
+                        taskId: ctx.taskId,
+                        skillKey: ctx.skillKey,
+                        phase: "polish",
+                        postStepType: "polish",
+                        step: { phase: "post", type: "polish", stepId },
+                    },
+                }
+                : undefined;
+            rawText = await runPolishCall({
+                systemPrompt,
+                userPrompt,
+                llmCall: polishLlmCall,
+                jobId: ctx.jobId ?? "polish-post-step",
+                taskId: ctx.taskId,
+                agentId: "polish",
+                traceCollector,
+                traceTask,
+                observationSink,
+                stepId,
+            });
+        }
+        catch (err) {
+            const lastObs = traceCollector ? llmCalls[llmCalls.length - 1] : undefined;
+            intermediateSteps.push({
+                step: nextStepNumber++,
+                id: `polish-pass-${pass}`,
+                ok: false,
+                summary: "polish call failed",
+                error: err instanceof Error ? err.message : String(err),
+                observation: lastObs,
+            });
+            break;
+        }
+        const parsed = parsePolishOutput(rawText);
+        if (parsed && typeof parsed.polishedOutput === "string") {
+            lastOutput = parsed.polishedOutput;
+            allChangeNotes.push(parsed.changeNotes ?? []);
+            previousPassNotes = parsed.changeNotes ?? [];
+            const changed = (parsed.changeNotes ?? []).filter((n) => n.action === "changed").length;
+            const total = (parsed.changeNotes ?? []).length || 1;
+            intermediateSteps.push({
+                step: nextStepNumber++,
+                id: `polish-pass-${pass}`,
+                ok: true,
+                summary: `${changed}/${total} items changed`,
+            });
+        }
+        else {
+            intermediateSteps.push({
+                step: nextStepNumber++,
+                id: `polish-pass-${pass}`,
+                ok: false,
+                summary: "polish parse failed",
+            });
+            break;
+        }
+    }
+    const durationMs = Date.now() - started;
+    const metadata = {
+        totalPasses: allChangeNotes.length,
+        changeNotes: allChangeNotes,
+        durationMs,
+        ...(traceCollector && llmCalls.length > 0 ? { llmCalls } : {}),
+    };
+    return {
+        outputText: lastOutput,
+        metadata,
+        intermediateSteps,
+    };
+}
+//# sourceMappingURL=runPolish.js.map

package/dist/post-steps/polish/runPolish.js.map

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

package/dist/post-steps/polish/runPolishCall.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Single polish LLM call via `@exellix/xynthesis` (`executeXynthesisAction`). Returns raw text (expect JSON in response).
+ */
+import type { DebugTraceCollector } from "../../observability/debugTrace.js";
+import type { DebugTraceTask } from "../../types/task-types.js";
+import type { LlmCallConfig, LlmCallObservation } from "../../types/llmCall.js";
+export type RunPolishCallOpts = {
+    systemPrompt: string;
+    userPrompt: string;
+    llmCall?: LlmCallConfig;
+    jobId?: string;
+    taskId?: string;
+    agentId?: string;
+    traceCollector?: DebugTraceCollector | null;
+    traceTask?: Omit<DebugTraceTask, "metadata"> & {
+        metadata?: Record<string, unknown>;
+    };
+    observationSink?: (obs: LlmCallObservation) => void;
+    stepId?: string;
+};
+export declare function runPolishCall(opts: RunPolishCallOpts): Promise<string>;
+//# sourceMappingURL=runPolishCall.d.ts.map

package/dist/post-steps/polish/runPolishCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPolishCall.d.ts","sourceRoot":"","sources":["../../../src/post-steps/polish/runPolishCall.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC5E"}

package/dist/post-steps/polish/runPolishCall.js

@@ -0,0 +1,32 @@
+/**
+ * Single polish LLM call via `@exellix/xynthesis` (`executeXynthesisAction`). Returns raw text (expect JSON in response).
+ */
+import { runPostStepLlmCall } from "../../internal/runPostStepLlmCall.js";
+export async function runPolishCall(opts) {
+    const { systemPrompt, userPrompt, llmCall, jobId, taskId, agentId, traceCollector, traceTask, observationSink, stepId, } = opts;
+    const effectiveTimeout = llmCall?.timeoutMs;
+    const doInvoke = async () => {
+        const { text } = await runPostStepLlmCall({
+            systemPrompt,
+            userPrompt,
+            llmCall,
+            stage: "post-polish",
+            stepId,
+            jobId: jobId ?? "polish-post-step",
+            taskId,
+            agentId: agentId ?? "polish",
+            traceCollector,
+            traceTask,
+            observationSink,
+        });
+        return text.trim();
+    };
+    if (typeof effectiveTimeout === "number" && effectiveTimeout > 0) {
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error("Polish call timeout")), effectiveTimeout);
+        });
+        return Promise.race([doInvoke(), timeoutPromise]);
+    }
+    return doInvoke();
+}
+//# sourceMappingURL=runPolishCall.js.map

package/dist/post-steps/polish/runPolishCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPolishCall.js","sourceRoot":"","sources":["../../../src/post-steps/polish/runPolishCall.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAkB1E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB;IACzD,MAAM,EACJ,YAAY,EACZ,UAAU,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,OAAO,EACP,cAAc,EACd,SAAS,EACT,eAAe,EACf,MAAM,GACP,GAAG,IAAI,CAAC;IAET,MAAM,gBAAgB,GAAG,OAAO,EAAE,SAAS,CAAC;IAE5C,MAAM,QAAQ,GAAG,KAAK,IAAqB,EAAE;QAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,kBAAkB,CAAC;YACxC,YAAY;YACZ,UAAU;YACV,OAAO;YACP,KAAK,EAAE,aAAa;YACpB,MAAM;YACN,KAAK,EAAE,KAAK,IAAI,kBAAkB;YAClC,MAAM;YACN,OAAO,EAAE,OAAO,IAAI,QAAQ;YAC5B,cAAc;YACd,SAAS;YACT,eAAe;SAChB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,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,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC/E,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/post-steps/resolvePostStepConfig.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Model and timeout resolution for POST step LLM calls.
+ * Resolution order: config field → step env → shared POST env → fallback.
+ *
+ * Also exposes {@link resolveLlmCall} which folds the per-stage `config.llmCall.X` field, the per-stage
+ * env var, the shared `POST_STEP_*` env var, and the supplied fallback into one effective `LlmCallConfig`.
+ */
+import type { LlmCallConfig } from "../types/llmCall.js";
+declare const SHARED_MODEL_ENV = "POST_STEP_MODEL";
+declare const SHARED_TIMEOUT_ENV = "POST_STEP_TIMEOUT_MS";
+declare const SHARED_MAX_TOKENS_CAP_ENV = "POST_STEP_MAX_TOKENS_CAP";
+declare const SHARED_TEMPERATURE_ENV = "POST_STEP_TEMPERATURE";
+declare const SHARED_TOP_P_ENV = "POST_STEP_TOP_P";
+declare const SHARED_MAX_OUTPUT_LENGTH_ENV = "POST_STEP_MAX_OUTPUT_LENGTH";
+declare const DEFAULT_TIMEOUT_MS = 30000;
+/**
+ * Resolve model string for a POST step LLM call.
+ * Order: configModel → process.env[stepEnv] → process.env[sharedEnv] → fallback.
+ */
+export declare function resolveModel(configModel: string | undefined, stepEnv: string, sharedEnv: string | undefined, fallback: string | undefined): string | undefined;
+/**
+ * Resolve timeout in ms for a POST step LLM call.
+ * Order: configTimeout → process.env[stepEnv] → process.env[sharedEnv] → fallback.
+ */
+export declare function resolveTimeout(configTimeout: number | undefined, stepEnv: string, sharedEnv?: string, fallback?: number): number;
+/**
+ * Per-stage env-var prefix mappings (e.g. `AUDIT` → `AUDIT_MODEL`, `AUDIT_MAX_TOKENS_CAP`, ...).
+ * Used by {@link resolveLlmCall}.
+ */
+export type LlmCallEnvPrefix = {
+    /** e.g. `AUDIT_MODEL`, `POLISH_MODEL`, `SYNTHESIS_MODEL`, `AI_SCOPING_MODEL`. */
+    modelEnv: string;
+    /** e.g. `AUDIT_TIMEOUT_MS`. */
+    timeoutEnv: string;
+    /** e.g. `AUDIT_MAX_TOKENS_CAP`. */
+    maxTokensCapEnv: string;
+    /** e.g. `AUDIT_TEMPERATURE`. */
+    temperatureEnv: string;
+    /** e.g. `AUDIT_TOP_P`. */
+    topPEnv: string;
+    /** e.g. `AUDIT_MAX_OUTPUT_LENGTH`. */
+    maxOutputLengthEnv: string;
+};
+/** Build a per-stage env prefix bundle from a base prefix (e.g. `AUDIT`). */
+export declare function llmCallEnvPrefix(base: string): LlmCallEnvPrefix;
+/**
+ * Resolve the effective {@link LlmCallConfig} for a stage.
+ *
+ * Resolution order per field: `config.<field>` → step env → shared `POST_STEP_*` env → `fallback.<field>`.
+ *
+ * `outputExpectation` is NEVER read from env (too structured for env-var carrying); it falls back to
+ * `fallback.outputExpectation` only.
+ *
+ * `maxTokensCap` is a HARD CEILING for xynthesis `resolveMaxTokens` (not a literal token count).
+ */
+export declare function resolveLlmCall(config: LlmCallConfig | undefined, stepEnv: LlmCallEnvPrefix, sharedEnv?: Partial<LlmCallEnvPrefix>, fallback?: LlmCallConfig): LlmCallConfig;
+export { SHARED_MODEL_ENV, SHARED_TIMEOUT_ENV, SHARED_MAX_TOKENS_CAP_ENV, SHARED_TEMPERATURE_ENV, SHARED_TOP_P_ENV, SHARED_MAX_OUTPUT_LENGTH_ENV, DEFAULT_TIMEOUT_MS, };
+//# sourceMappingURL=resolvePostStepConfig.d.ts.map

package/dist/post-steps/resolvePostStepConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePostStepConfig.d.ts","sourceRoot":"","sources":["../../src/post-steps/resolvePostStepConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AAE5E,QAAA,MAAM,gBAAgB,oBAAoB,CAAC;AAC3C,QAAA,MAAM,kBAAkB,yBAAyB,CAAC;AAClD,QAAA,MAAM,yBAAyB,6BAA6B,CAAC;AAC7D,QAAA,MAAM,sBAAsB,0BAA0B,CAAC;AACvD,QAAA,MAAM,gBAAgB,oBAAoB,CAAC;AAC3C,QAAA,MAAM,4BAA4B,gCAAgC,CAAC;AACnE,QAAA,MAAM,kBAAkB,QAAS,CAAC;AAElC;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,YAAmB,EACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CAOpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAA2B,EACtC,QAAQ,GAAE,MAA2B,GACpC,MAAM,CAOR;AAgBD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAS/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,EACzC,QAAQ,GAAE,aAAkB,GAC3B,aAAa,CAmDf;AAED,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,kBAAkB,GACnB,CAAC"}

package/dist/post-steps/resolvePostStepConfig.js

@@ -0,0 +1,105 @@
+/**
+ * Model and timeout resolution for POST step LLM calls.
+ * Resolution order: config field → step env → shared POST env → fallback.
+ *
+ * Also exposes {@link resolveLlmCall} which folds the per-stage `config.llmCall.X` field, the per-stage
+ * env var, the shared `POST_STEP_*` env var, and the supplied fallback into one effective `LlmCallConfig`.
+ */
+const SHARED_MODEL_ENV = "POST_STEP_MODEL";
+const SHARED_TIMEOUT_ENV = "POST_STEP_TIMEOUT_MS";
+const SHARED_MAX_TOKENS_CAP_ENV = "POST_STEP_MAX_TOKENS_CAP";
+const SHARED_TEMPERATURE_ENV = "POST_STEP_TEMPERATURE";
+const SHARED_TOP_P_ENV = "POST_STEP_TOP_P";
+const SHARED_MAX_OUTPUT_LENGTH_ENV = "POST_STEP_MAX_OUTPUT_LENGTH";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Resolve model string for a POST step LLM call.
+ * Order: configModel → process.env[stepEnv] → process.env[sharedEnv] → fallback.
+ */
+export function resolveModel(configModel, stepEnv, sharedEnv = SHARED_MODEL_ENV, fallback) {
+    return (configModel ??
+        process.env[stepEnv] ??
+        process.env[sharedEnv] ??
+        fallback);
+}
+/**
+ * Resolve timeout in ms for a POST step LLM call.
+ * Order: configTimeout → process.env[stepEnv] → process.env[sharedEnv] → fallback.
+ */
+export function resolveTimeout(configTimeout, stepEnv, sharedEnv = SHARED_TIMEOUT_ENV, fallback = DEFAULT_TIMEOUT_MS) {
+    return (configTimeout ??
+        intFromEnv(stepEnv) ??
+        intFromEnv(sharedEnv) ??
+        fallback);
+}
+function intFromEnv(key) {
+    const v = process.env[key];
+    if (v === undefined || v === "")
+        return undefined;
+    const n = parseInt(v, 10);
+    return Number.isNaN(n) ? undefined : n;
+}
+function floatFromEnv(key) {
+    const v = process.env[key];
+    if (v === undefined || v === "")
+        return undefined;
+    const n = parseFloat(v);
+    return Number.isNaN(n) ? undefined : n;
+}
+/** Build a per-stage env prefix bundle from a base prefix (e.g. `AUDIT`). */
+export function llmCallEnvPrefix(base) {
+    return {
+        modelEnv: `${base}_MODEL`,
+        timeoutEnv: `${base}_TIMEOUT_MS`,
+        maxTokensCapEnv: `${base}_MAX_TOKENS_CAP`,
+        temperatureEnv: `${base}_TEMPERATURE`,
+        topPEnv: `${base}_TOP_P`,
+        maxOutputLengthEnv: `${base}_MAX_OUTPUT_LENGTH`,
+    };
+}
+/**
+ * Resolve the effective {@link LlmCallConfig} for a stage.
+ *
+ * Resolution order per field: `config.<field>` → step env → shared `POST_STEP_*` env → `fallback.<field>`.
+ *
+ * `outputExpectation` is NEVER read from env (too structured for env-var carrying); it falls back to
+ * `fallback.outputExpectation` only.
+ *
+ * `maxTokensCap` is a HARD CEILING for xynthesis `resolveMaxTokens` (not a literal token count).
+ */
+export function resolveLlmCall(config, stepEnv, sharedEnv = {}, fallback = {}) {
+    const cfg = config ?? {};
+    const model = resolveModel(cfg.model, stepEnv.modelEnv, sharedEnv.modelEnv ?? SHARED_MODEL_ENV, fallback.model);
+    const timeoutMs = (cfg.timeoutMs ??
+        intFromEnv(stepEnv.timeoutEnv) ??
+        intFromEnv(sharedEnv.timeoutEnv ?? SHARED_TIMEOUT_ENV) ??
+        fallback.timeoutMs);
+    const maxTokensCap = cfg.maxTokensCap ??
+        intFromEnv(stepEnv.maxTokensCapEnv) ??
+        intFromEnv(sharedEnv.maxTokensCapEnv ?? SHARED_MAX_TOKENS_CAP_ENV) ??
+        fallback.maxTokensCap;
+    const temperature = cfg.temperature ??
+        floatFromEnv(stepEnv.temperatureEnv) ??
+        floatFromEnv(sharedEnv.temperatureEnv ?? SHARED_TEMPERATURE_ENV) ??
+        fallback.temperature;
+    const topP = cfg.topP ??
+        floatFromEnv(stepEnv.topPEnv) ??
+        floatFromEnv(sharedEnv.topPEnv ?? SHARED_TOP_P_ENV) ??
+        fallback.topP;
+    const maxOutputLength = cfg.maxOutputLength ??
+        intFromEnv(stepEnv.maxOutputLengthEnv) ??
+        intFromEnv(sharedEnv.maxOutputLengthEnv ?? SHARED_MAX_OUTPUT_LENGTH_ENV) ??
+        fallback.maxOutputLength;
+    const outputExpectation = cfg.outputExpectation ?? fallback.outputExpectation;
+    return {
+        model,
+        maxTokensCap,
+        temperature,
+        topP,
+        maxOutputLength,
+        timeoutMs,
+        outputExpectation,
+    };
+}
+export { SHARED_MODEL_ENV, SHARED_TIMEOUT_ENV, SHARED_MAX_TOKENS_CAP_ENV, SHARED_TEMPERATURE_ENV, SHARED_TOP_P_ENV, SHARED_MAX_OUTPUT_LENGTH_ENV, DEFAULT_TIMEOUT_MS, };
+//# sourceMappingURL=resolvePostStepConfig.js.map

package/dist/post-steps/resolvePostStepConfig.js.map

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

package/dist/rendrixUpstreamExports.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports Rendrix template / smart-input introspection used by ai-tasks validation
+ * so consumers can depend on `@exellix/ai-tasks` only.
+ */
+export { listTokens, listDirectiveValues, resolveTokenValues, analyzeTemplateResolution, renderSmartInput, verifyTemplate, SmartInputInvalidError, SmartInputRequiredPathMissingError, TemplateResolutionError, } from "@x12i/rendrix";
+export type { TemplateTokenRef, TemplateTokenKind, ListTokensOptions, ResolveTokenValuesInput, ResolvedTokenValue, TemplateResolutionReport, ParsedToken, SmartInputConfig, SmartInputRenderOptions, SmartInputRenderResult, TemplateRenderOptions, } from "@x12i/rendrix";
+//# sourceMappingURL=rendrixUpstreamExports.d.ts.map

package/dist/rendrixUpstreamExports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendrixUpstreamExports.d.ts","sourceRoot":"","sources":["../src/rendrixUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,kCAAkC,EAClC,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,eAAe,CAAC"}

package/dist/rendrixUpstreamExports.js

@@ -0,0 +1,6 @@
+/**
+ * Re-exports Rendrix template / smart-input introspection used by ai-tasks validation
+ * so consumers can depend on `@exellix/ai-tasks` only.
+ */
+export { listTokens, listDirectiveValues, resolveTokenValues, analyzeTemplateResolution, renderSmartInput, verifyTemplate, SmartInputInvalidError, SmartInputRequiredPathMissingError, TemplateResolutionError, } from "@x12i/rendrix";
+//# sourceMappingURL=rendrixUpstreamExports.js.map

package/dist/rendrixUpstreamExports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendrixUpstreamExports.js","sourceRoot":"","sources":["../src/rendrixUpstreamExports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,kCAAkC,EAClC,uBAAuB,GACxB,MAAM,eAAe,CAAC"}

package/dist/skillCatalogExports.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Legacy **Mongo / Xillix** skill catalog helpers were removed from `@exellix/ai-skills` in 4.1+.
+ * Skills metadata and templates now live in **Catalox** (`ai-skills` app); see {@link ./aiSkillsUpstreamExports.js}.
+ *
+ * These helpers remain on the upstream catalog barrel for gateway key normalization.
+ */
+export { canonicalSkillKey, ensureGatewayTreatsAsTemplateText } from "@exellix/ai-skills";
+//# sourceMappingURL=skillCatalogExports.d.ts.map

package/dist/skillCatalogExports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCatalogExports.d.ts","sourceRoot":"","sources":["../src/skillCatalogExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/skillCatalogExports.js

@@ -0,0 +1,8 @@
+/**
+ * Legacy **Mongo / Xillix** skill catalog helpers were removed from `@exellix/ai-skills` in 4.1+.
+ * Skills metadata and templates now live in **Catalox** (`ai-skills` app); see {@link ./aiSkillsUpstreamExports.js}.
+ *
+ * These helpers remain on the upstream catalog barrel for gateway key normalization.
+ */
+export { canonicalSkillKey, ensureGatewayTreatsAsTemplateText } from "@exellix/ai-skills";
+//# sourceMappingURL=skillCatalogExports.js.map

package/dist/skillCatalogExports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillCatalogExports.js","sourceRoot":"","sources":["../src/skillCatalogExports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/strategies/direct-execution-strategy.d.ts

@@ -0,0 +1,31 @@
+import { ExellixSkillsClient } from "@exellix/ai-skills";
+type WorexClientSkills = ExellixSkillsClient;
+import type { RunTaskRequest, RunSkillResponse } from "../types/index.js";
+import type { IExecutionStrategy } from "./execution-strategy.interface.js";
+/**
+ * Direct execution strategy.
+ *
+ * Executes tasks by directly passing through to the skill executor.
+ * This is the simplest and most common execution strategy.
+ *
+ * The client's runSkill method handles:
+ * 1. Skill execution via the AI Gateway
+ * 2. FlexMD response parsing
+ * 3. Returns structured response with payloads
+ *
+ * Trace mode integration (when `executionMode === "trace"` is forwarded by the caller):
+ *   - Forwards `executionMode: "trace"` and `diagnostics: { includeRawProviderPayload }` to `runSkill`.
+ *   - Catches and re-throws upstream `SkillExecutionTraceError` unchanged (already carries
+ *     `RunSkillDiagnostics` with full trace + invokeRequest echo).
+ *   - For default-mode raw errors (untyped), wraps with `LlmCallContextError` carrying a
+ *     `LlmCallObservation` snapshot of `modelConfig` so callers can read the request context.
+ */
+export declare class DirectExecutionStrategy implements IExecutionStrategy {
+    private client;
+    constructor(client: ExellixSkillsClient | WorexClientSkills);
+    execute<TParsed = any>(request: RunTaskRequest): Promise<RunSkillResponse<TParsed>>;
+    getType(): string;
+    canHandle(request: RunTaskRequest): boolean;
+}
+export {};
+//# sourceMappingURL=direct-execution-strategy.d.ts.map

package/dist/strategies/direct-execution-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-execution-strategy.d.ts","sourceRoot":"","sources":["../../src/strategies/direct-execution-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA4B,MAAM,oBAAoB,CAAC;AAInF,KAAK,iBAAiB,GAAG,mBAAmB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAK5E;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,kBAAkB;IAChE,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,EAAE,mBAAmB,GAAG,iBAAiB;IAIrD,OAAO,CAAC,OAAO,GAAG,GAAG,EACzB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAiFrC,OAAO,IAAI,MAAM;IAIjB,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;CAG5C"}