@exellix/ai-skills 5.8.0

package/dist/analysis/analyze-skill-request.js

@@ -0,0 +1,201 @@
+import { run } from "@x12i/funcx/functions";
+import { buildSkillRequestAnalysisPacket } from "./build-skill-request-analysis-packet.js";
+import { formatSkillRequestAnalysisMarkdown } from "./format-skill-request-analysis-markdown.js";
+import { verdictFromFindings } from "./collect-deterministic-findings.js";
+import { FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID } from "./constants.js";
+function emptyReportFromFindings(findings, flexMdFrameHint) {
+    const verdict = verdictFromFindings(findings);
+    return {
+        verdict,
+        confidence: verdict === "ok" ? 0.85 : verdict === "warnings" ? 0.5 : 0.2,
+        inputAssessment: {
+            plausible: !findings.some((f) => f.severity === "error"),
+            summary: "Deterministic-only analysis (FuncX LLM skipped).",
+            issues: findings.filter((f) => f.category !== "smartInput" && f.category !== "template"),
+        },
+        smartInputAssessment: {
+            configured: findings.some((f) => f.category === "smartInput") || false,
+            pathsOk: !findings.some((f) => f.id.startsWith("SMART_INPUT") && f.severity === "error"),
+            issues: findings.filter((f) => f.category === "smartInput"),
+        },
+        templateAssessment: {
+            issues: findings.filter((f) => f.category === "template"),
+            unresolvedTokens: findings
+                .filter((f) => f.id === "TEMPLATE_TOKEN_UNRESOLVED" && f.evidence)
+                .map((f) => f.evidence),
+        },
+        configAssessment: {
+            issues: findings.filter((f) => f.category === "modelConfig" || f.category === "catalog"),
+        },
+        expectedResponse: {
+            flexMdFrame: flexMdFrameHint,
+            parsedShape: {},
+            metadataExpectations: [
+                { field: "usage", required: false, notes: "From gateway metadata when invoked." },
+                {
+                    field: "costUsd",
+                    required: false,
+                    notes: "USD total when gateway metadata.costStatus is priced (≥9.3) or cost/costUsd is numeric.",
+                },
+                {
+                    field: "costStatus",
+                    required: false,
+                    notes: 'SDK exposes "unpriced" or legacy "deferred" only — not gateway "priced".',
+                },
+            ],
+            runSkillResponseShape: {
+                fields: ["rawText", "flexMd", "parsed", "metadata"],
+            },
+        },
+        findings,
+    };
+}
+function isSkillRequestAnalysisReport(v) {
+    if (!v || typeof v !== "object")
+        return false;
+    const r = v;
+    return (typeof r.verdict === "string" &&
+        Array.isArray(r.findings) &&
+        typeof r.inputAssessment === "object" &&
+        typeof r.expectedResponse === "object");
+}
+function asFindingArray(v) {
+    return Array.isArray(v) ? v : [];
+}
+function normalizePartialFuncxReport(raw) {
+    const verdict = raw.verdict === "ok" || raw.verdict === "warnings" || raw.verdict === "errors"
+        ? raw.verdict
+        : "warnings";
+    const inputAssessment = (raw.inputAssessment ?? {});
+    const smartInputAssessment = (raw.smartInputAssessment ?? {});
+    const templateAssessment = (raw.templateAssessment ?? {});
+    const configAssessment = (raw.configAssessment ?? {});
+    const expectedResponse = (raw.expectedResponse ?? {});
+    return {
+        verdict,
+        confidence: typeof raw.confidence === "number" ? raw.confidence : 0.5,
+        inputAssessment: {
+            plausible: inputAssessment.plausible === true,
+            summary: typeof inputAssessment.summary === "string" ? inputAssessment.summary : "",
+            issues: asFindingArray(inputAssessment.issues),
+        },
+        smartInputAssessment: {
+            configured: smartInputAssessment.configured === true,
+            pathsOk: smartInputAssessment.pathsOk !== false,
+            issues: asFindingArray(smartInputAssessment.issues),
+            ...(typeof smartInputAssessment.renderedPreview === "string"
+                ? { renderedPreview: smartInputAssessment.renderedPreview }
+                : {}),
+        },
+        templateAssessment: {
+            issues: asFindingArray(templateAssessment.issues),
+            ...(Array.isArray(templateAssessment.unresolvedTokens)
+                ? { unresolvedTokens: templateAssessment.unresolvedTokens }
+                : {}),
+            ...(Array.isArray(templateAssessment.renderAnomalies)
+                ? { renderAnomalies: templateAssessment.renderAnomalies }
+                : {}),
+        },
+        configAssessment: {
+            issues: asFindingArray(configAssessment.issues),
+            ...(typeof configAssessment.modelConfigNotes === "string"
+                ? { modelConfigNotes: configAssessment.modelConfigNotes }
+                : {}),
+            ...(typeof configAssessment.timeoutNotes === "string"
+                ? { timeoutNotes: configAssessment.timeoutNotes }
+                : {}),
+        },
+        expectedResponse: {
+            ...(typeof expectedResponse.flexMdFrame === "string"
+                ? { flexMdFrame: expectedResponse.flexMdFrame }
+                : {}),
+            parsedShape: expectedResponse.parsedShape && typeof expectedResponse.parsedShape === "object"
+                ? expectedResponse.parsedShape
+                : {},
+            metadataExpectations: Array.isArray(expectedResponse.metadataExpectations)
+                ? expectedResponse.metadataExpectations
+                : [],
+            runSkillResponseShape: {
+                fields: Array.isArray(expectedResponse.runSkillResponseShape?.fields)
+                    ? expectedResponse.runSkillResponseShape
+                        .fields
+                    : ["rawText", "flexMd", "parsed", "metadata"],
+            },
+        },
+        findings: asFindingArray(raw.findings),
+    };
+}
+function coerceFuncxRunResult(raw) {
+    if (isSkillRequestAnalysisReport(raw))
+        return raw;
+    const wrapped = raw;
+    if (isSkillRequestAnalysisReport(wrapped.result))
+        return wrapped.result;
+    if (isSkillRequestAnalysisReport(wrapped.report))
+        return wrapped.report;
+    const candidate = wrapped.result && typeof wrapped.result === "object"
+        ? wrapped.result
+        : raw && typeof raw === "object"
+            ? raw
+            : null;
+    if (candidate && typeof candidate.verdict === "string") {
+        return normalizePartialFuncxReport(candidate);
+    }
+    throw new Error("[AI-SKILLS] FuncX analyze-gateway-invoke-request returned an unexpected shape; expected SkillRequestAnalysisReport.");
+}
+/**
+ * Preflight analysis for a {@link RunSkillRequest}: real sanitized gateway packet + FuncX review.
+ * **Not chained into {@link runSkill}** — call explicitly from implementation-phase clients.
+ */
+export async function analyzeSkillRequest(catalox, skillRequest, options) {
+    const built = await buildSkillRequestAnalysisPacket({ catalox, skillRequest, options });
+    const { packet, deterministicFindings, gatewayPayload } = built;
+    const functionId = skillRequest.skillKey;
+    const skillKey = skillRequest.skillKey;
+    if (options?.strictDeterministic && deterministicFindings.some((f) => f.severity === "error")) {
+        const ids = deterministicFindings.filter((f) => f.severity === "error").map((f) => f.id);
+        throw new Error(`[AI-SKILLS] analyzeSkillRequest strictDeterministic: blocking findings: ${ids.join(", ")}`);
+    }
+    let report;
+    let confidence;
+    if (options?.deterministicOnly) {
+        report = emptyReportFromFindings(deterministicFindings, packet.flexMdFrameHint);
+        confidence = report.confidence;
+    }
+    else {
+        options?.logger?.info?.("[AI-SKILLS] analyzeSkillRequest → FuncX", {
+            functionId: FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID,
+            targetFunctionId: functionId,
+        });
+        const funcxRun = options?.funcxRunOverride ?? run;
+        const raw = await funcxRun(FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID, packet, {
+            mode: options?.funcxMode ?? "strong",
+            validateOutput: options?.funcxValidateOutput !== false,
+        });
+        report = coerceFuncxRunResult(raw);
+        confidence = report.confidence;
+    }
+    let markdownReport = typeof report.markdownReport === "string"
+        ? report.markdownReport
+        : "";
+    if (!markdownReport || markdownReport.trim().length < 80) {
+        markdownReport = formatSkillRequestAnalysisMarkdown({
+            functionId,
+            skillKey,
+            report,
+            deterministicFindings,
+        });
+    }
+    const { markdownReport: _md, ...reportWithoutMd } = report;
+    return {
+        functionId,
+        skillKey,
+        verdict: report.verdict,
+        confidence,
+        report: reportWithoutMd,
+        markdownReport,
+        deterministicFindings,
+        gatewayPayload,
+    };
+}
+//# sourceMappingURL=analyze-skill-request.js.map

package/dist/analysis/analyze-skill-request.js.map

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

package/dist/analysis/build-skill-request-analysis-packet.d.ts

@@ -0,0 +1,14 @@
+import type { Catalox } from "@x12i/catalox";
+import type { RunSkillRequest } from "../types.js";
+import type { AnalyzeSkillRequestOptions, BuildSkillRequestAnalysisPacketResult } from "./types.js";
+export type BuildSkillRequestAnalysisPacketParams = {
+    catalox: Catalox;
+    skillRequest: RunSkillRequest;
+    options?: Pick<AnalyzeSkillRequestOptions, "templateOverride" | "maxTemplateCharsInPacket" | "cataloxAppId">;
+};
+/**
+ * Builds the real sanitized gateway invoke packet and SDK {@link deterministicFindings}
+ * without calling ai-gateway or executing the target skill.
+ */
+export declare function buildSkillRequestAnalysisPacket(params: BuildSkillRequestAnalysisPacketParams): Promise<BuildSkillRequestAnalysisPacketResult>;
+//# sourceMappingURL=build-skill-request-analysis-packet.d.ts.map

package/dist/analysis/build-skill-request-analysis-packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-skill-request-analysis-packet.d.ts","sourceRoot":"","sources":["../../src/analysis/build-skill-request-analysis-packet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAgBnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,qCAAqC,EAAE,MAAM,YAAY,CAAC;AAEpG,MAAM,MAAM,qCAAqC,GAAG;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,eAAe,CAAC;IAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,kBAAkB,GAAG,0BAA0B,GAAG,cAAc,CAAC,CAAC;CAChH,CAAC;AAEF;;;GAGG;AACH,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,qCAAqC,GAC9C,OAAO,CAAC,qCAAqC,CAAC,CAwGhD"}

package/dist/analysis/build-skill-request-analysis-packet.js

@@ -0,0 +1,106 @@
+import { buildSkillGatewayInvokePayload } from "../client/build-gateway-invoke-request.js";
+import { renderSkillTemplatesWithRendrix } from "../utils/rendrix-render-skill-templates.js";
+import { defaultAiSkillsCataloxContext, fetchSkillTemplatesFromCatalox, } from "../catalox/skill-templates.js";
+import { resolveGatewayJobAndTaskIds } from "../utils/resolve-gateway-job-task-ids.js";
+import { resolveOutputContractFields } from "../utils/normalize-output-parsed.js";
+import { collectDeterministicFindings } from "./collect-deterministic-findings.js";
+import { sanitizeGatewayPayloadForPacket, sanitizeRunSkillRequestForPacket, sanitizeTemplatesForPacket, } from "./sanitize-for-packet.js";
+import { extractFlexMdFrameHint, extractTemplateTokenInventory } from "./path-utils.js";
+/**
+ * Builds the real sanitized gateway invoke packet and SDK {@link deterministicFindings}
+ * without calling ai-gateway or executing the target skill.
+ */
+export async function buildSkillRequestAnalysisPacket(params) {
+    const { catalox, skillRequest, options } = params;
+    const maxTemplateChars = options?.maxTemplateCharsInPacket ?? 12_000;
+    const functionId = skillRequest.skillKey;
+    let instructionsRaw;
+    let promptRaw;
+    let catalogStatus;
+    if (options?.templateOverride) {
+        instructionsRaw = options.templateOverride.instructions;
+        promptRaw = options.templateOverride.prompt;
+    }
+    else {
+        const cxCtx = defaultAiSkillsCataloxContext({ appId: options?.cataloxAppId });
+        const fetched = await fetchSkillTemplatesFromCatalox(catalox, cxCtx, skillRequest.skillKey, {
+            audit: false,
+        });
+        instructionsRaw = fetched.instructionsPayload;
+        promptRaw = fetched.promptPayload;
+        catalogStatus = fetched.status;
+    }
+    const { jobId, taskId } = resolveGatewayJobAndTaskIds({
+        jobId: skillRequest.jobId,
+        taskId: skillRequest.taskId,
+        identity: skillRequest.identity,
+    });
+    const gatewayPayload = buildSkillGatewayInvokePayload({
+        skillRequest,
+        jobId,
+        taskId,
+        instructionsPayload: instructionsRaw,
+        promptPayload: promptRaw,
+    });
+    let instructionsRendered = instructionsRaw;
+    let promptRendered = promptRaw;
+    const renderFindings = [];
+    try {
+        const rendered = renderSkillTemplatesWithRendrix(skillRequest, instructionsRaw, promptRaw);
+        instructionsRendered = rendered.instructionsRendered;
+        promptRendered = rendered.promptRendered;
+    }
+    catch (e) {
+        renderFindings.push({
+            id: "TEMPLATE_RENDER_FAILED",
+            severity: "error",
+            category: "template",
+            message: e instanceof Error ? e.message : String(e),
+            suggestion: "Fix smartInput paths, workingMemory, or template tokens before invoke.",
+        });
+    }
+    const workingMemory = (gatewayPayload.workingMemory ?? {});
+    const deterministicFindings = [
+        ...renderFindings,
+        ...collectDeterministicFindings({
+            skillRequest,
+            workingMemory,
+            instructionsRaw,
+            promptRaw,
+            instructionsRendered,
+            promptRendered,
+        }),
+    ];
+    const templatesSanitized = sanitizeTemplatesForPacket({ instructions: instructionsRaw, prompt: promptRaw }, { instructions: instructionsRendered, prompt: promptRendered }, maxTemplateChars);
+    if (catalogStatus) {
+        templatesSanitized.catalogStatus = catalogStatus;
+    }
+    const packet = {
+        functionId,
+        aiRequestId: gatewayPayload.aiRequestId,
+        jobId: jobId || undefined,
+        taskId: taskId || undefined,
+        agentId: skillRequest.agentId,
+        jobTypeId: skillRequest.jobTypeId,
+        taskTypeId: skillRequest.taskTypeId,
+        gatewayPayload: sanitizeGatewayPayloadForPacket(gatewayPayload, maxTemplateChars),
+        runSkillRequest: sanitizeRunSkillRequestForPacket(skillRequest),
+        templates: templatesSanitized,
+        ...(skillRequest.outputContract !== undefined ? { outputContract: skillRequest.outputContract } : {}),
+        resolvedOutputFields: resolveOutputContractFields(skillRequest.outputContract),
+        deterministicFindings,
+        flexMdFrameHint: extractFlexMdFrameHint(instructionsRaw, promptRaw, instructionsRendered),
+        templateTokenInventory: extractTemplateTokenInventory(instructionsRaw, promptRaw),
+    };
+    return {
+        packet,
+        deterministicFindings,
+        gatewayPayload,
+        instructionsRaw,
+        promptRaw,
+        instructionsRendered,
+        promptRendered,
+        catalogStatus,
+    };
+}
+//# sourceMappingURL=build-skill-request-analysis-packet.js.map

package/dist/analysis/build-skill-request-analysis-packet.js.map

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

package/dist/analysis/collect-deterministic-findings.d.ts

@@ -0,0 +1,14 @@
+import type { RunSkillRequest } from "../types.js";
+import type { SkillRequestAnalysisFinding } from "./types.js";
+export type CollectDeterministicFindingsParams = {
+    skillRequest: RunSkillRequest;
+    workingMemory: Record<string, unknown>;
+    instructionsRaw: string;
+    promptRaw: string;
+    instructionsRendered: string;
+    promptRendered: string;
+    templateSizeThreshold?: number;
+};
+export declare function collectDeterministicFindings(params: CollectDeterministicFindingsParams): SkillRequestAnalysisFinding[];
+export declare function verdictFromFindings(findings: SkillRequestAnalysisFinding[]): "ok" | "warnings" | "errors";
+//# sourceMappingURL=collect-deterministic-findings.d.ts.map

package/dist/analysis/collect-deterministic-findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-deterministic-findings.d.ts","sourceRoot":"","sources":["../../src/analysis/collect-deterministic-findings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AA8B9D,MAAM,MAAM,kCAAkC,GAAG;IAC7C,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,kCAAkC,GAAG,2BAA2B,EAAE,CAmOtH;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,2BAA2B,EAAE,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,CAIzG"}

package/dist/analysis/collect-deterministic-findings.js

@@ -0,0 +1,221 @@
+import { validateMandatoryActivixInvokeFields } from "../utils/validate-mandatory-activix-invoke-fields.js";
+import { validateSessionIdAgreement } from "../utils/validate-session-id.js";
+import { resolveGatewayJobAndTaskIds } from "../utils/resolve-gateway-job-task-ids.js";
+import { resolveAiEngineIdForRunSkill } from "../utils/resolve-run-skill-ai-engine.js";
+import { resolveOutputContractFields, markdownHeadingToFieldKey, } from "../utils/normalize-output-parsed.js";
+import { extractFlexMdFrameHint, extractTemplateTokenInventory, findUnresolvedMustacheTokens, isEmptyResolvedValue, resolveDotPath, } from "./path-utils.js";
+const SECTION_HEADER = /^#{2,3}\s+(.+?)\s*$/gm;
+function finding(partial) {
+    return partial;
+}
+function templateSectionKeys(...texts) {
+    const keys = new Set();
+    for (const text of texts) {
+        if (!text)
+            continue;
+        for (const match of text.matchAll(SECTION_HEADER)) {
+            const key = markdownHeadingToFieldKey(match[1] ?? "");
+            if (key)
+                keys.add(key);
+        }
+    }
+    return keys;
+}
+export function collectDeterministicFindings(params) {
+    const findings = [];
+    const { skillRequest, workingMemory } = params;
+    const hasSmartInput = skillRequest.smartInput !== undefined;
+    try {
+        validateMandatoryActivixInvokeFields(skillRequest);
+    }
+    catch (e) {
+        findings.push(finding({
+            id: "ACTIVIX_MANDATORY_FIELDS_MISSING",
+            severity: "error",
+            category: "activix",
+            message: e instanceof Error ? e.message : String(e),
+            suggestion: "Set non-empty agentId, jobTypeId, and taskTypeId on RunSkillRequest.",
+        }));
+    }
+    const { jobId, taskId, missingJobId, missingTaskId } = resolveGatewayJobAndTaskIds({
+        jobId: skillRequest.jobId,
+        taskId: skillRequest.taskId,
+        identity: skillRequest.identity,
+    });
+    if (missingJobId) {
+        findings.push(finding({
+            id: "JOB_ID_MISSING",
+            severity: "warning",
+            category: "activix",
+            path: "jobId",
+            message: "jobId is missing or empty on the request and identity.",
+            suggestion: "Supply a non-empty jobId before invoke.",
+        }));
+    }
+    if (missingTaskId) {
+        findings.push(finding({
+            id: "TASK_ID_MISSING",
+            severity: "warning",
+            category: "activix",
+            path: "taskId",
+            message: "taskId is missing or empty on the request and identity.",
+            suggestion: "Supply a non-empty taskId before invoke.",
+        }));
+    }
+    try {
+        const identitySession = skillRequest.identity &&
+            typeof skillRequest.identity === "object" &&
+            !Array.isArray(skillRequest.identity)
+            ? skillRequest.identity.sessionId
+            : undefined;
+        validateSessionIdAgreement(skillRequest.sessionId, identitySession);
+    }
+    catch (e) {
+        findings.push(finding({
+            id: "SESSION_ID_MISMATCH",
+            severity: "error",
+            category: "session",
+            path: "sessionId",
+            message: e instanceof Error ? e.message : String(e),
+            suggestion: "Align sessionId and identity.sessionId or omit one.",
+        }));
+    }
+    try {
+        resolveAiEngineIdForRunSkill(skillRequest);
+    }
+    catch (e) {
+        findings.push(finding({
+            id: "AI_ENGINE_ID_UNKNOWN",
+            severity: "error",
+            category: "catalog",
+            path: "aiEngineId",
+            message: e instanceof Error ? e.message : String(e),
+        }));
+    }
+    const inputEmpty = skillRequest.input === undefined ||
+        skillRequest.input === null ||
+        (typeof skillRequest.input === "string" && skillRequest.input.trim() === "") ||
+        (typeof skillRequest.input === "object" &&
+            !Array.isArray(skillRequest.input) &&
+            Object.keys(skillRequest.input).length === 0);
+    if (inputEmpty) {
+        findings.push(finding({
+            id: "INPUT_EMPTY",
+            severity: "warning",
+            category: "workingMemory",
+            path: "input",
+            message: "RunSkillRequest.input is empty; workingMemory.input may not carry user content.",
+        }));
+    }
+    const smartInput = skillRequest.smartInput;
+    const paths = smartInput?.paths ?? [];
+    if (paths.length > 0) {
+        for (const entry of paths) {
+            const path = typeof entry.path === "string" ? entry.path.trim() : "";
+            if (!path) {
+                findings.push(finding({
+                    id: "SMART_INPUT_PATH_EMPTY",
+                    severity: "warning",
+                    category: "smartInput",
+                    message: "smartInput.paths contains an entry with an empty path.",
+                }));
+                continue;
+            }
+            const resolved = resolveDotPath(workingMemory, path);
+            const required = entry.required === true;
+            if (!resolved.found || isEmptyResolvedValue(resolved.value)) {
+                findings.push(finding({
+                    id: required ? "SMART_INPUT_PATH_MISSING" : "SMART_INPUT_PATH_EMPTY_VALUE",
+                    severity: required ? "error" : "warning",
+                    category: "smartInput",
+                    path,
+                    message: required
+                        ? `Required smartInput path "${path}" does not resolve in workingMemory.`
+                        : `smartInput path "${path}" is missing or empty in workingMemory.`,
+                    suggestion: `Ensure variables, executionMemory, or input populate "${path}".`,
+                }));
+            }
+        }
+    }
+    const unresolvedInstr = findUnresolvedMustacheTokens(params.instructionsRendered, hasSmartInput);
+    const unresolvedPrompt = findUnresolvedMustacheTokens(params.promptRendered, hasSmartInput);
+    for (const token of [...unresolvedInstr, ...unresolvedPrompt]) {
+        findings.push(finding({
+            id: "TEMPLATE_TOKEN_UNRESOLVED",
+            severity: "warning",
+            category: "template",
+            message: `Rendered template still contains unresolved token ${token}.`,
+            evidence: token,
+        }));
+    }
+    const contractFields = resolveOutputContractFields(skillRequest.outputContract);
+    if (contractFields.length > 0) {
+        const sectionKeys = templateSectionKeys(params.instructionsRaw, params.promptRaw);
+        const flexHint = extractFlexMdFrameHint(params.instructionsRaw, params.promptRaw);
+        for (const field of contractFields) {
+            if (!sectionKeys.has(field) && flexHint === undefined) {
+                findings.push(finding({
+                    id: "OUTPUT_CONTRACT_FIELD_NOT_IN_TEMPLATE",
+                    severity: "warning",
+                    category: "outputContract",
+                    path: field,
+                    message: `outputContract expects "${field}" but no matching ### heading was found in templates.`,
+                    suggestion: "Add a markdown section or FlexMD @payload for this field.",
+                }));
+            }
+        }
+    }
+    const inventory = extractTemplateTokenInventory(params.instructionsRaw, params.promptRaw);
+    for (const tokenPath of inventory) {
+        const root = tokenPath.split(".")[0];
+        if (root === "smartInput")
+            continue;
+        const resolved = resolveDotPath(workingMemory, tokenPath);
+        if (!resolved.found && root !== "input" && root !== "variables") {
+            const altRoot = resolveDotPath(workingMemory, root);
+            if (!altRoot.found) {
+                findings.push(finding({
+                    id: "TEMPLATE_TOKEN_LIKELY_MISSING",
+                    severity: "info",
+                    category: "template",
+                    path: tokenPath,
+                    message: `Template references "{{${tokenPath}}}" but "${root}" is not present at workingMemory root.`,
+                }));
+            }
+        }
+    }
+    const totalChars = params.instructionsRaw.length +
+        params.promptRaw.length +
+        params.instructionsRendered.length +
+        params.promptRendered.length;
+    const threshold = params.templateSizeThreshold ?? 80_000;
+    if (totalChars > threshold) {
+        findings.push(finding({
+            id: "TEMPLATE_PAYLOAD_LARGE",
+            severity: "warning",
+            category: "template",
+            message: `Combined template text is ~${totalChars} characters (threshold ${threshold}).`,
+            suggestion: "Consider shortening templates or raising context limits.",
+        }));
+    }
+    if (!skillRequest.skillKey?.trim()) {
+        findings.push(finding({
+            id: "SKILL_KEY_MISSING",
+            severity: "error",
+            category: "catalog",
+            path: "skillKey",
+            message: "skillKey is required for Catalox template load and gateway actionRef.",
+        }));
+    }
+    void jobId;
+    void taskId;
+    return findings;
+}
+export function verdictFromFindings(findings) {
+    if (findings.some((f) => f.severity === "error"))
+        return "errors";
+    if (findings.some((f) => f.severity === "warning"))
+        return "warnings";
+    return "ok";
+}
+//# sourceMappingURL=collect-deterministic-findings.js.map

package/dist/analysis/collect-deterministic-findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-deterministic-findings.js","sourceRoot":"","sources":["../../src/analysis/collect-deterministic-findings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oCAAoC,EAAE,MAAM,sDAAsD,CAAC;AAC5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,EACH,2BAA2B,EAC3B,yBAAyB,GAC5B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACH,sBAAsB,EACtB,6BAA6B,EAC7B,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,GACjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,SAAS,OAAO,CACZ,OACiF;IAEjF,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAG,KAAe;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YAChD,MAAM,GAAG,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,IAAI,GAAG;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAYD,MAAM,UAAU,4BAA4B,CAAC,MAA0C;IACnF,MAAM,QAAQ,GAAkC,EAAE,CAAC;IACnD,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAC/C,MAAM,aAAa,GAAG,YAAY,CAAC,UAAU,KAAK,SAAS,CAAC;IAE5D,IAAI,CAAC;QACD,oCAAoC,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,kCAAkC;YACtC,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACnD,UAAU,EAAE,sEAAsE;SACrF,CAAC,CACL,CAAC;IACN,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,2BAA2B,CAAC;QAC/E,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,QAAQ,EAAE,YAAY,CAAC,QAAQ;KAClC,CAAC,CAAC;IACH,IAAI,YAAY,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,gBAAgB;YACpB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,wDAAwD;YACjE,UAAU,EAAE,yCAAyC;SACxD,CAAC,CACL,CAAC;IACN,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,iBAAiB;YACrB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,yDAAyD;YAClE,UAAU,EAAE,0CAA0C;SACzD,CAAC,CACL,CAAC;IACN,CAAC;IAED,IAAI,CAAC;QACD,MAAM,eAAe,GACjB,YAAY,CAAC,QAAQ;YACrB,OAAO,YAAY,CAAC,QAAQ,KAAK,QAAQ;YACzC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC;YACjC,CAAC,CAAE,YAAY,CAAC,QAAoC,CAAC,SAAS;YAC9D,CAAC,CAAC,SAAS,CAAC;QACpB,0BAA0B,CAAC,YAAY,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACxE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,qBAAqB;YACzB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACnD,UAAU,EAAE,qDAAqD;SACpE,CAAC,CACL,CAAC;IACN,CAAC;IAED,IAAI,CAAC;QACD,4BAA4B,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,sBAAsB;YAC1B,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SACtD,CAAC,CACL,CAAC;IACN,CAAC;IAED,MAAM,UAAU,GACZ,YAAY,CAAC,KAAK,KAAK,SAAS;QAChC,YAAY,CAAC,KAAK,KAAK,IAAI;QAC3B,CAAC,OAAO,YAAY,CAAC,KAAK,KAAK,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QAC5E,CAAC,OAAO,YAAY,CAAC,KAAK,KAAK,QAAQ;YACnC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IACtD,IAAI,UAAU,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,iFAAiF;SAC7F,CAAC,CACL,CAAC;IACN,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,UAA0C,CAAC;IAC3E,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;oBACJ,EAAE,EAAE,wBAAwB;oBAC5B,QAAQ,EAAE,SAAS;oBACnB,QAAQ,EAAE,YAAY;oBACtB,OAAO,EAAE,wDAAwD;iBACpE,CAAC,CACL,CAAC;gBACF,SAAS;YACb,CAAC;YACD,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC;YACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,oBAAoB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1D,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;oBACJ,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,8BAA8B;oBAC1E,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;oBACxC,QAAQ,EAAE,YAAY;oBACtB,IAAI;oBACJ,OAAO,EAAE,QAAQ;wBACb,CAAC,CAAC,6BAA6B,IAAI,sCAAsC;wBACzE,CAAC,CAAC,oBAAoB,IAAI,yCAAyC;oBACvE,UAAU,EAAE,yDAAyD,IAAI,IAAI;iBAChF,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,eAAe,GAAG,4BAA4B,CAAC,MAAM,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;IACjG,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAC5F,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,eAAe,EAAE,GAAG,gBAAgB,CAAC,EAAE,CAAC;QAC5D,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,2BAA2B;YAC/B,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,qDAAqD,KAAK,GAAG;YACtE,QAAQ,EAAE,KAAK;SAClB,CAAC,CACL,CAAC;IACN,CAAC;IAED,MAAM,cAAc,GAAG,2BAA2B,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAChF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAClF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACpD,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;oBACJ,EAAE,EAAE,uCAAuC;oBAC3C,QAAQ,EAAE,SAAS;oBACnB,QAAQ,EAAE,gBAAgB;oBAC1B,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,2BAA2B,KAAK,uDAAuD;oBAChG,UAAU,EAAE,2DAA2D;iBAC1E,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,6BAA6B,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1F,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,YAAY;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9D,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjB,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;oBACJ,EAAE,EAAE,+BAA+B;oBACnC,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,0BAA0B,SAAS,YAAY,IAAI,yCAAyC;iBACxG,CAAC,CACL,CAAC;YACN,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GACZ,MAAM,CAAC,eAAe,CAAC,MAAM;QAC7B,MAAM,CAAC,SAAS,CAAC,MAAM;QACvB,MAAM,CAAC,oBAAoB,CAAC,MAAM;QAClC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,qBAAqB,IAAI,MAAM,CAAC;IACzD,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,wBAAwB;YAC5B,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,8BAA8B,UAAU,0BAA0B,SAAS,IAAI;YACxF,UAAU,EAAE,0DAA0D;SACzE,CAAC,CACL,CAAC;IACN,CAAC;IAED,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CACT,OAAO,CAAC;YACJ,EAAE,EAAE,mBAAmB;YACvB,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,uEAAuE;SACnF,CAAC,CACL,CAAC;IACN,CAAC;IAED,KAAK,KAAK,CAAC;IACX,KAAK,MAAM,CAAC;IAEZ,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAuC;IACvE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC;QAAE,OAAO,UAAU,CAAC;IACtE,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/analysis/constants.d.ts

@@ -0,0 +1,5 @@
+/** FuncX catalog id (slash alias accepted by `run()`). Requires `@x12i/funcx` ≥ 4.0.1. */
+export declare const FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID = "ai-skills/analyze-gateway-invoke-request";
+/** Minimum `@x12i/funcx` version that ships the gateway invoke analyzer. */
+export declare const FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY = "4.0.1";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/analysis/constants.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,eAAO,MAAM,uCAAuC,6CAA6C,CAAC;AAElG,4EAA4E;AAC5E,eAAO,MAAM,qCAAqC,UAAU,CAAC"}

package/dist/analysis/constants.js

@@ -0,0 +1,5 @@
+/** FuncX catalog id (slash alias accepted by `run()`). Requires `@x12i/funcx` ≥ 4.0.1. */
+export const FUNCX_ANALYZE_GATEWAY_INVOKE_REQUEST_ID = "ai-skills/analyze-gateway-invoke-request";
+/** Minimum `@x12i/funcx` version that ships the gateway invoke analyzer. */
+export const FUNCX_MIN_VERSION_FOR_ANALYZE_GATEWAY = "4.0.1";
+//# sourceMappingURL=constants.js.map

package/dist/analysis/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/analysis/constants.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,CAAC,MAAM,uCAAuC,GAAG,0CAA0C,CAAC;AAElG,4EAA4E;AAC5E,MAAM,CAAC,MAAM,qCAAqC,GAAG,OAAO,CAAC"}

package/dist/analysis/format-skill-request-analysis-markdown.d.ts

@@ -0,0 +1,8 @@
+import type { SkillRequestAnalysisFinding, SkillRequestAnalysisReport } from "./types.js";
+export declare function formatSkillRequestAnalysisMarkdown(args: {
+    functionId: string;
+    skillKey: string;
+    report: SkillRequestAnalysisReport;
+    deterministicFindings?: SkillRequestAnalysisFinding[];
+}): string;
+//# sourceMappingURL=format-skill-request-analysis-markdown.d.ts.map

package/dist/analysis/format-skill-request-analysis-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-skill-request-analysis-markdown.d.ts","sourceRoot":"","sources":["../../src/analysis/format-skill-request-analysis-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAQ1F,wBAAgB,kCAAkC,CAAC,IAAI,EAAE;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,0BAA0B,CAAC;IACnC,qBAAqB,CAAC,EAAE,2BAA2B,EAAE,CAAC;CACzD,GAAG,MAAM,CA2GT"}