@exellix/ai-tasks 7.8.0

package/dist/planWebScopeQuestions/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * AI-driven planning of explicit web-scope questions (Studio → `narrix.webScopeQuestions`).
+ * FuncX **`research/plan-questions`** uses the generic envelope (see `runResearchPlanQuestionsViaFuncx`).
+ */
+import { setResearchPlanQuestionsFuncxInvoker } from "./runResearchPlanQuestionsFuncx.js";
+export { setResearchPlanQuestionsFuncxInvoker };
+import type { DebugTraceCollector } from "../observability/debugTrace.js";
+import type { DebugTraceTask } from "../types/task-types.js";
+import type { LlmCallConfig, LlmCallObservation } from "../types/llmCall.js";
+/** Stable machine reason codes for `PlanWebScopeQuestionsOutput.reasonCodes`. */
+export declare const PlanWebScopeQuestionsReasonCode: {
+    readonly OUTPUT_INVALID: "OUTPUT_INVALID";
+    readonly PARSE_FAILED: "PARSE_FAILED";
+    readonly LLM_ERROR: "LLM_ERROR";
+    readonly INPUT_TOO_THIN: "INPUT_TOO_THIN";
+};
+export type PlanWebScopeQuestionsReasonCode = (typeof PlanWebScopeQuestionsReasonCode)[keyof typeof PlanWebScopeQuestionsReasonCode];
+export type PlanWebScopeQuestionsMemorySummary = {
+    jobMemory?: unknown;
+    taskMemory?: unknown;
+    executionMemory?: unknown;
+};
+export type PlanWebScopeQuestionsInput = {
+    nodeQuestion: string;
+    nodeInput?: unknown;
+    rawRecord?: unknown;
+    memorySummary?: PlanWebScopeQuestionsMemorySummary;
+    xynthesized?: {
+        job?: unknown;
+        task?: unknown;
+    };
+    maxQuestions: number;
+};
+export type PlanWebScopeQuestionItem = {
+    id: string;
+    question: string;
+    reason: string;
+    source: "ai-driven";
+};
+export type PlanWebScopeQuestionsOutput = {
+    questions: PlanWebScopeQuestionItem[];
+    confidence: number;
+    skipped?: boolean;
+    reasonCodes?: string[];
+};
+export type ParsePlanWebScopeQuestionsResult = {
+    ok: true;
+    value: PlanWebScopeQuestionsOutput;
+} | {
+    ok: false;
+    errors: string[];
+};
+/**
+ * Parse and validate model JSON for plan-web-scope-questions. `maxQuestions` is clamped to 1–20 before checking counts.
+ */
+export declare function parseAndValidatePlanWebScopeQuestionsOutput(rawText: string, maxQuestions: number): ParsePlanWebScopeQuestionsResult;
+export declare function buildPlanWebScopeQuestionsUserPrompt(input: PlanWebScopeQuestionsInput): string;
+export type RunPlanWebScopeQuestionsParams = {
+    input: PlanWebScopeQuestionsInput;
+    /** `xynthesis`: local gateway via `@exellix/xynthesis` (default). `funcx`: `research/plan-questions` generic envelope. */
+    backend?: "xynthesis" | "funcx";
+    /** Override FuncX function id when `backend` is `funcx` (must use the same generic request shape). */
+    funcxFunctionId?: string;
+    llmCall?: LlmCallConfig;
+    jobId?: string;
+    taskId?: string;
+    agentId?: string;
+    traceCollector?: DebugTraceCollector | null;
+    traceTask?: Omit<DebugTraceTask, "metadata"> & {
+        metadata?: Record<string, unknown>;
+    };
+    observationSink?: (obs: LlmCallObservation) => void;
+};
+/**
+ * Plans web-scope questions via Xynthesis (default) or FuncX `research/plan-questions`.
+ */
+export declare function runPlanWebScopeQuestions(params: RunPlanWebScopeQuestionsParams): Promise<PlanWebScopeQuestionsOutput>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/planWebScopeQuestions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAGL,oCAAoC,EACrC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,oCAAoC,EAAE,CAAC;AAChD,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,MAAM,qBAAqB,CAAC;AAE7E,iFAAiF;AACjF,eAAO,MAAM,+BAA+B;;;;;CAKlC,CAAC;AAEX,MAAM,MAAM,+BAA+B,GACzC,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,OAAO,+BAA+B,CAAC,CAAC;AAEzF,MAAM,MAAM,kCAAkC,GAAG;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,kCAAkC,CAAC;IACnD,WAAW,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AA2CF,MAAM,MAAM,gCAAgC,GACxC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,2BAA2B,CAAA;CAAE,GAChD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,gCAAgC,CA8FlC;AAkBD,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAsB9F;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,EAAE,0BAA0B,CAAC;IAClC,0HAA0H;IAC1H,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;IAChC,sGAAsG;IACtG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,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;CACrD,CAAC;AAEF;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,2BAA2B,CAAC,CAqGtC"}

package/dist/planWebScopeQuestions/index.js

@@ -0,0 +1,282 @@
+/**
+ * AI-driven planning of explicit web-scope questions (Studio → `narrix.webScopeQuestions`).
+ * FuncX **`research/plan-questions`** uses the generic envelope (see `runResearchPlanQuestionsViaFuncx`).
+ */
+import { randomUUID } from "node:crypto";
+import { runPostStepLlmCall } from "../internal/runPostStepLlmCall.js";
+import { adaptFuncxResearchPlanToOutput, runResearchPlanQuestionsViaFuncx, setResearchPlanQuestionsFuncxInvoker, } from "./runResearchPlanQuestionsFuncx.js";
+export { setResearchPlanQuestionsFuncxInvoker };
+/** Stable machine reason codes for `PlanWebScopeQuestionsOutput.reasonCodes`. */
+export const PlanWebScopeQuestionsReasonCode = {
+    OUTPUT_INVALID: "OUTPUT_INVALID",
+    PARSE_FAILED: "PARSE_FAILED",
+    LLM_ERROR: "LLM_ERROR",
+    INPUT_TOO_THIN: "INPUT_TOO_THIN",
+};
+const MAX_JSON_SNIPPET = 24_000;
+function clampInt(n, lo, hi) {
+    if (!Number.isFinite(n))
+        return lo;
+    return Math.min(hi, Math.max(lo, Math.floor(n)));
+}
+function jsonSnippet(label, value) {
+    try {
+        const s = JSON.stringify(value, null, 0);
+        if (s.length <= MAX_JSON_SNIPPET)
+            return `${label}:\n${s}`;
+        return `${label}:\n${s.slice(0, MAX_JSON_SNIPPET)}\n…(truncated)`;
+    }
+    catch {
+        return `${label}:\n<unserializable>`;
+    }
+}
+function stripJsonFences(s) {
+    let t = s.trim();
+    if (t.startsWith("```")) {
+        t = t.replace(/^```(?:json)?\s*/i, "").replace(/\s*```\s*$/i, "");
+    }
+    return t.trim();
+}
+function extractJsonObject(raw) {
+    const t = stripJsonFences(raw);
+    const start = t.indexOf("{");
+    const end = t.lastIndexOf("}");
+    if (start < 0 || end <= start)
+        return null;
+    try {
+        return JSON.parse(t.slice(start, end + 1));
+    }
+    catch {
+        return null;
+    }
+}
+function isRecord(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+/**
+ * Parse and validate model JSON for plan-web-scope-questions. `maxQuestions` is clamped to 1–20 before checking counts.
+ */
+export function parseAndValidatePlanWebScopeQuestionsOutput(rawText, maxQuestions) {
+    const errors = [];
+    const maxQ = clampInt(maxQuestions, 1, 20);
+    const parsed = extractJsonObject(rawText);
+    if (parsed == null) {
+        errors.push("Could not parse JSON object from model output");
+        return { ok: false, errors };
+    }
+    if (!isRecord(parsed)) {
+        errors.push("Root must be a JSON object");
+        return { ok: false, errors };
+    }
+    let confidence = 0;
+    const confidenceRaw = parsed.confidence;
+    if (typeof confidenceRaw !== "number" || !Number.isFinite(confidenceRaw)) {
+        errors.push("confidence must be a finite number");
+    }
+    else if (confidenceRaw < 0 || confidenceRaw > 1) {
+        errors.push("confidence must be between 0 and 1 inclusive");
+    }
+    else {
+        confidence = confidenceRaw;
+    }
+    const questionsRaw = parsed.questions;
+    let questionsIn = [];
+    if (!Array.isArray(questionsRaw)) {
+        errors.push("questions must be an array");
+    }
+    else if (questionsRaw.length > maxQ) {
+        errors.push(`questions length ${questionsRaw.length} exceeds maxQuestions (${maxQ})`);
+    }
+    else {
+        questionsIn = questionsRaw;
+        for (let i = 0; i < questionsRaw.length; i++) {
+            const q = questionsRaw[i];
+            if (!isRecord(q)) {
+                errors.push(`questions[${i}] must be an object`);
+                continue;
+            }
+            if (typeof q.question !== "string" || !q.question.trim()) {
+                errors.push(`questions[${i}].question must be a non-empty string`);
+            }
+            if (typeof q.reason !== "string" || !q.reason.trim()) {
+                errors.push(`questions[${i}].reason must be a non-empty string`);
+            }
+            if (q.source !== undefined && q.source !== "ai-driven") {
+                errors.push(`questions[${i}].source must be "ai-driven" when set`);
+            }
+            if (q.id !== undefined && typeof q.id !== "string") {
+                errors.push(`questions[${i}].id must be a string when set`);
+            }
+        }
+    }
+    const skipped = parsed.skipped === true;
+    const reasonCodesRaw = parsed.reasonCodes;
+    if (reasonCodesRaw !== undefined && !Array.isArray(reasonCodesRaw)) {
+        errors.push("reasonCodes must be an array of strings when set");
+    }
+    else if (Array.isArray(reasonCodesRaw)) {
+        for (let i = 0; i < reasonCodesRaw.length; i++) {
+            if (typeof reasonCodesRaw[i] !== "string") {
+                errors.push(`reasonCodes[${i}] must be a string`);
+            }
+        }
+    }
+    if (errors.length)
+        return { ok: false, errors };
+    const questions = questionsIn.map((q) => {
+        const o = q;
+        const id = typeof o.id === "string" && o.id.trim()
+            ? o.id.trim()
+            : randomUUID();
+        return {
+            id,
+            question: String(o.question).trim(),
+            reason: String(o.reason).trim(),
+            source: "ai-driven",
+        };
+    });
+    const reasonCodes = Array.isArray(reasonCodesRaw) && reasonCodesRaw.length
+        ? reasonCodesRaw.map(String)
+        : undefined;
+    return {
+        ok: true,
+        value: {
+            questions,
+            confidence,
+            ...(skipped ? { skipped: true } : {}),
+            ...(reasonCodes ? { reasonCodes } : {}),
+        },
+    };
+}
+const PLAN_WEB_SCOPE_SYSTEM = `You are a planning assistant for web evidence collection.
+Return ONLY a single JSON object (no markdown fences, no prose) with this exact shape:
+{
+  "questions": Array<{ "id"?: string, "question": string, "reason": string, "source": "ai-driven" }>,
+  "confidence": number,
+  "skipped"?: boolean,
+  "reasonCodes"?: string[]
+}
+Rules:
+- "confidence" is a number from 0 to 1.
+- Each "question" must be a concrete web search or research question (non-empty string).
+- Each "reason" briefly explains why that question helps (non-empty string).
+- "source" must be the literal string "ai-driven" for every question entry.
+- Produce at most the requested maxQuestions items in "questions".
+- If you cannot propose useful questions, set "skipped": true, "questions": [], "confidence" <= 0.5, and include "reasonCodes" such as ["INPUT_TOO_THIN"].`;
+export function buildPlanWebScopeQuestionsUserPrompt(input) {
+    const maxQ = clampInt(input.maxQuestions, 1, 20);
+    const nq = typeof input.nodeQuestion === "string" ? input.nodeQuestion.trim() : "";
+    const lines = [
+        `maxQuestions: ${maxQ}`,
+        "",
+        "nodeQuestion:",
+        nq || "(empty)",
+        "",
+        "nodeInput:",
+        jsonSnippet("nodeInput", input.nodeInput ?? null),
+    ];
+    if (input.rawRecord !== undefined) {
+        lines.push("", "rawRecord:", jsonSnippet("rawRecord", input.rawRecord));
+    }
+    if (input.memorySummary !== undefined) {
+        lines.push("", "memorySummary:", jsonSnippet("memorySummary", input.memorySummary));
+    }
+    if (input.xynthesized !== undefined) {
+        lines.push("", "xynthesized:", jsonSnippet("xynthesized", input.xynthesized));
+    }
+    return lines.join("\n");
+}
+/**
+ * Plans web-scope questions via Xynthesis (default) or FuncX `research/plan-questions`.
+ */
+export async function runPlanWebScopeQuestions(params) {
+    const { input, backend = "xynthesis", funcxFunctionId, llmCall, jobId, taskId, agentId, traceCollector, traceTask, observationSink, } = params;
+    const nq = typeof input.nodeQuestion === "string" ? input.nodeQuestion.trim() : "";
+    const maxQ = clampInt(input.maxQuestions, 1, 20);
+    if (!nq) {
+        return {
+            questions: [],
+            confidence: 0,
+            skipped: true,
+            reasonCodes: [PlanWebScopeQuestionsReasonCode.INPUT_TOO_THIN],
+        };
+    }
+    if (backend === "funcx") {
+        try {
+            const raw = await runResearchPlanQuestionsViaFuncx({
+                input: { ...input, nodeQuestion: nq, maxQuestions: maxQ },
+                jobId,
+                taskId,
+                agentId,
+                funcxFunctionId,
+            });
+            const adapted = adaptFuncxResearchPlanToOutput(raw);
+            const maxAllowed = maxQ;
+            if (adapted.questions.length > maxAllowed) {
+                return {
+                    questions: [],
+                    confidence: 0,
+                    skipped: true,
+                    reasonCodes: [PlanWebScopeQuestionsReasonCode.OUTPUT_INVALID],
+                };
+            }
+            if (adapted.questions.length === 0 && adapted.skipped !== true) {
+                return {
+                    questions: [],
+                    confidence: 0,
+                    skipped: true,
+                    reasonCodes: [PlanWebScopeQuestionsReasonCode.OUTPUT_INVALID],
+                };
+            }
+            return {
+                questions: adapted.questions,
+                confidence: adapted.confidence,
+                ...(adapted.skipped ? { skipped: true } : {}),
+                ...(adapted.reasonCodes?.length ? { reasonCodes: adapted.reasonCodes } : {}),
+            };
+        }
+        catch {
+            return {
+                questions: [],
+                confidence: 0,
+                skipped: true,
+                reasonCodes: [PlanWebScopeQuestionsReasonCode.LLM_ERROR],
+            };
+        }
+    }
+    const userPrompt = buildPlanWebScopeQuestionsUserPrompt({ ...input, nodeQuestion: nq, maxQuestions: maxQ });
+    try {
+        const { text } = await runPostStepLlmCall({
+            systemPrompt: PLAN_WEB_SCOPE_SYSTEM,
+            userPrompt,
+            llmCall,
+            stage: "plan-web-scope-questions",
+            structuredOutput: true,
+            jobId: jobId ?? "plan-web-scope-questions",
+            taskId,
+            agentId: agentId ?? "plan-web-scope-questions",
+            traceCollector,
+            traceTask,
+            observationSink,
+        });
+        const parsed = parseAndValidatePlanWebScopeQuestionsOutput(text, maxQ);
+        if (!parsed.ok) {
+            return {
+                questions: [],
+                confidence: 0,
+                skipped: true,
+                reasonCodes: [PlanWebScopeQuestionsReasonCode.OUTPUT_INVALID],
+            };
+        }
+        return parsed.value;
+    }
+    catch {
+        return {
+            questions: [],
+            confidence: 0,
+            skipped: true,
+            reasonCodes: [PlanWebScopeQuestionsReasonCode.LLM_ERROR],
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/planWebScopeQuestions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/planWebScopeQuestions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,oCAAoC,GACrC,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,oCAAoC,EAAE,CAAC;AAKhD,iFAAiF;AACjF,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAkCX,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,SAAS,QAAQ,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,KAAc;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,MAAM,IAAI,gBAAgB;YAAE,OAAO,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO,GAAG,KAAK,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,KAAK,qBAAqB,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,CAAS;IAChC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjB,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAY,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAMD;;GAEG;AACH,MAAM,UAAU,2CAA2C,CACzD,OAAe,EACf,YAAoB;IAEpB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC;IACxC,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACzE,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,aAAa,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,aAAa,CAAC;IAC7B,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC;IACtC,IAAI,WAAW,GAAc,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,YAAY,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,oBAAoB,YAAY,CAAC,MAAM,0BAA0B,IAAI,GAAG,CAAC,CAAC;IACxF,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,YAAY,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;gBACjD,SAAS;YACX,CAAC;YACD,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,qCAAqC,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,uCAAuC,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,CAAC,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,gCAAgC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACxC,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC;IAC1C,IAAI,cAAc,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,OAAO,cAAc,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhD,MAAM,SAAS,GAA+B,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAClE,MAAM,CAAC,GAAG,CAA4B,CAAC;QACvC,MAAM,EAAE,GACN,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE;YACrC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE;YACb,CAAC,CAAC,UAAU,EAAE,CAAC;QACnB,OAAO;YACL,EAAE;YACF,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;YACnC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;YAC/B,MAAM,EAAE,WAAoB;SAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GACf,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,cAAc,CAAC,MAAM;QACpD,CAAC,CAAE,cAA2B,CAAC,GAAG,CAAC,MAAM,CAAC;QAC1C,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,SAAS;YACT,UAAU;YACV,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;2JAc6H,CAAC;AAE5J,MAAM,UAAU,oCAAoC,CAAC,KAAiC;IACpF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,KAAK,GAAa;QACtB,iBAAiB,IAAI,EAAE;QACvB,EAAE;QACF,eAAe;QACf,EAAE,IAAI,SAAS;QACf,EAAE;QACF,YAAY;QACZ,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC;KAClD,CAAC;IACF,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,EAAE,WAAW,CAAC,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,CAAC,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAiBD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAsC;IAEtC,MAAM,EACJ,KAAK,EACL,OAAO,GAAG,WAAW,EACrB,eAAe,EACf,OAAO,EACP,KAAK,EACL,MAAM,EACN,OAAO,EACP,cAAc,EACd,SAAS,EACT,eAAe,GAChB,GAAG,MAAM,CAAC;IACX,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,CAAC,+BAA+B,CAAC,cAAc,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,gCAAgC,CAAC;gBACjD,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;gBACzD,KAAK;gBACL,MAAM;gBACN,OAAO;gBACP,eAAe;aAChB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,8BAA8B,CAAC,GAAG,CAAC,CAAC;YACpD,MAAM,UAAU,GAAG,IAAI,CAAC;YACxB,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC1C,OAAO;oBACL,SAAS,EAAE,EAAE;oBACb,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,CAAC,+BAA+B,CAAC,cAAc,CAAC;iBAC9D,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC/D,OAAO;oBACL,SAAS,EAAE,EAAE;oBACb,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,CAAC,+BAA+B,CAAC,cAAc,CAAC;iBAC9D,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,SAAuC;gBAC1D,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7E,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,CAAC,+BAA+B,CAAC,SAAS,CAAC;aACzD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,oCAAoC,CAAC,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5G,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,kBAAkB,CAAC;YACxC,YAAY,EAAE,qBAAqB;YACnC,UAAU;YACV,OAAO;YACP,KAAK,EAAE,0BAA0B;YACjC,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE,KAAK,IAAI,0BAA0B;YAC1C,MAAM;YACN,OAAO,EAAE,OAAO,IAAI,0BAA0B;YAC9C,cAAc;YACd,SAAS;YACT,eAAe;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,2CAA2C,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,CAAC,+BAA+B,CAAC,cAAc,CAAC;aAC9D,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,CAAC,+BAA+B,CAAC,SAAS,CAAC;SACzD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/planWebScopeQuestions/runResearchPlanQuestionsFuncx.d.ts

@@ -0,0 +1,18 @@
+import { adaptResearchPlanQuestionsResult, type ResearchPlanQuestionsInputShape } from "../execution-strategies/genericExecutionFuncxEnvelope.js";
+export type ResearchPlanQuestionsFuncxInvokeContext = {
+    functionId: string;
+    payload: unknown;
+};
+/**
+ * Test-only override for FuncX `research/plan-questions` calls from {@link runPlanWebScopeQuestions} when `backend: "funcx"`.
+ */
+export declare function setResearchPlanQuestionsFuncxInvoker(fn: ((ctx: ResearchPlanQuestionsFuncxInvokeContext) => Promise<unknown>) | null): void;
+export declare function runResearchPlanQuestionsViaFuncx(params: {
+    input: ResearchPlanQuestionsInputShape;
+    jobId?: string;
+    taskId?: string;
+    agentId?: string;
+    funcxFunctionId?: string;
+}): Promise<unknown>;
+export declare function adaptFuncxResearchPlanToOutput(raw: unknown): ReturnType<typeof adaptResearchPlanQuestionsResult>;
+//# sourceMappingURL=runResearchPlanQuestionsFuncx.d.ts.map

package/dist/planWebScopeQuestions/runResearchPlanQuestionsFuncx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runResearchPlanQuestionsFuncx.d.ts","sourceRoot":"","sources":["../../src/planWebScopeQuestions/runResearchPlanQuestionsFuncx.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gCAAgC,EAGhC,KAAK,+BAA+B,EACrC,MAAM,0DAA0D,CAAC;AAElE,MAAM,MAAM,uCAAuC,GAAG;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAIF;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,uCAAuC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAC9E,IAAI,CAEN;AAgBD,wBAAsB,gCAAgC,CAAC,MAAM,EAAE;IAC7D,KAAK,EAAE,+BAA+B,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBnB;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAEhH"}

package/dist/planWebScopeQuestions/runResearchPlanQuestionsFuncx.js

@@ -0,0 +1,42 @@
+import { createClient } from "@x12i/funcx";
+import { run } from "@x12i/funcx/functions";
+import { FUNCX_RESEARCH_PLAN_QUESTIONS_FUNCTION_ID } from "../execution-strategies/constants.js";
+import { adaptResearchPlanQuestionsResult, buildResearchPlanQuestionsPayload, unwrapFuncxRunValue, } from "../execution-strategies/genericExecutionFuncxEnvelope.js";
+let injectedInvoker = null;
+/**
+ * Test-only override for FuncX `research/plan-questions` calls from {@link runPlanWebScopeQuestions} when `backend: "funcx"`.
+ */
+export function setResearchPlanQuestionsFuncxInvoker(fn) {
+    injectedInvoker = fn;
+}
+let cachedClient = null;
+function defaultOpenRouterClient() {
+    if (!cachedClient) {
+        cachedClient = createClient({ backend: "openrouter" });
+    }
+    return cachedClient;
+}
+function pickFunctionId(explicit) {
+    if (typeof explicit === "string" && explicit.trim())
+        return explicit.trim();
+    return FUNCX_RESEARCH_PLAN_QUESTIONS_FUNCTION_ID;
+}
+export async function runResearchPlanQuestionsViaFuncx(params) {
+    const functionId = pickFunctionId(params.funcxFunctionId);
+    const payload = buildResearchPlanQuestionsPayload({
+        input: params.input,
+        jobId: params.jobId,
+        taskId: params.taskId,
+        agentId: params.agentId,
+    });
+    if (injectedInvoker) {
+        return injectedInvoker({ functionId, payload });
+    }
+    const client = defaultOpenRouterClient();
+    const raw = await run(functionId, payload, { client });
+    return unwrapFuncxRunValue(raw);
+}
+export function adaptFuncxResearchPlanToOutput(raw) {
+    return adaptResearchPlanQuestionsResult(raw);
+}
+//# sourceMappingURL=runResearchPlanQuestionsFuncx.js.map

package/dist/planWebScopeQuestions/runResearchPlanQuestionsFuncx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runResearchPlanQuestionsFuncx.js","sourceRoot":"","sources":["../../src/planWebScopeQuestions/runResearchPlanQuestionsFuncx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,yCAAyC,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EACjC,mBAAmB,GAEpB,MAAM,0DAA0D,CAAC;AAOlE,IAAI,eAAe,GAAgF,IAAI,CAAC;AAExG;;GAEG;AACH,MAAM,UAAU,oCAAoC,CAClD,EAA+E;IAE/E,eAAe,GAAG,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC,SAAS,uBAAuB;IAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,cAAc,CAAC,QAAiB;IACvC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,yCAAyC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,MAMtD;IACC,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,iCAAiC,CAAC;QAChD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IAEH,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,eAAe,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,GAAY;IACzD,OAAO,gCAAgC,CAAC,GAAG,CAAC,CAAC;AAC/C,CAAC"}

package/dist/post-steps/audit/loadAuditTemplates.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Load audit POST step templates from disk. Base path = AUDIT_TEMPLATES_PATH or cwd/templates/post-steps/audit.
+ */
+export type AuditTemplates = {
+    system: string;
+    user: string;
+    feedbackInjection: string;
+    synthesis: string;
+};
+export declare function loadAuditTemplates(): Promise<AuditTemplates>;
+export declare function renderAuditSystem(template: string, data: {
+    customGuidelines?: string;
+}): string;
+export declare function renderAuditUser(template: string, data: {
+    originalInput: string;
+    promptContext: string;
+    candidateOutput: string;
+    mustChecks: {
+        check: string;
+        weight: number;
+    }[];
+    shouldChecks: {
+        check: string;
+        weight: number;
+    }[];
+    previousFeedback?: string;
+    previousCycle?: number;
+}): string;
+export declare function renderFeedbackInjection(template: string, data: {
+    cycle: number;
+    maxCycles: number;
+    failedChecks: {
+        kind: string;
+        check: string;
+        feedback: string;
+    }[];
+    overallFeedback: string;
+}): string;
+export declare function renderSynthesis(template: string, data: {
+    originalInput: string;
+    promptContext: string;
+    candidateA: {
+        cycle: number;
+        score: number;
+        output: string;
+        failedChecks: {
+            kind: string;
+            check: string;
+            feedback: string;
+        }[];
+        passedChecks: {
+            kind: string;
+            check: string;
+        }[];
+    };
+    candidateB: {
+        cycle: number;
+        score: number;
+        output: string;
+        failedChecks: {
+            kind: string;
+            check: string;
+            feedback: string;
+        }[];
+        passedChecks: {
+            kind: string;
+            check: string;
+        }[];
+    };
+    customSynthesisGuidelines?: string;
+}): string;
+//# sourceMappingURL=loadAuditTemplates.d.ts.map

package/dist/post-steps/audit/loadAuditTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAuditTemplates.d.ts","sourceRoot":"","sources":["../../../src/post-steps/audit/loadAuditTemplates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAMF,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CA2BlE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAG/F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAGT;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAGT;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,YAAY,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IACjL,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,YAAY,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IACjL,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC,GAAG,MAAM,CAGT"}

package/dist/post-steps/audit/loadAuditTemplates.js

@@ -0,0 +1,62 @@
+/**
+ * Load audit POST step templates from disk. Base path = AUDIT_TEMPLATES_PATH or cwd/templates/post-steps/audit.
+ */
+import { readFile } from "fs/promises";
+import { join } from "path";
+import Handlebars from "handlebars";
+const DEFAULT_SYSTEM = `You are a strict quality auditor. Evaluate every check, output structured markdown with "### Checks" and "### Overall feedback" sections.`;
+const DEFAULT_USER = `Original input: {{originalInput}}\n\nContext: {{promptContext}}\n\nCandidate: {{candidateOutput}}\n\nMust: {{mustChecks}}\nShould: {{shouldChecks}}`;
+const DEFAULT_FEEDBACK = `## Audit Feedback (cycle {{cycle}} of {{maxCycles}})\n\n{{overallFeedback}}\n\nFailed: {{failedChecks}}`;
+const DEFAULT_SYNTHESIS = `Merge the best of two candidates. Output only the merged task output.`;
+function getBasePath() {
+    return process.env.AUDIT_TEMPLATES_PATH ?? process.cwd();
+}
+export async function loadAuditTemplates() {
+    const base = join(getBasePath(), "templates", "post-steps", "audit");
+    let system = DEFAULT_SYSTEM;
+    let user = DEFAULT_USER;
+    let feedbackInjection = DEFAULT_FEEDBACK;
+    let synthesis = DEFAULT_SYNTHESIS;
+    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 */
+    }
+    try {
+        feedbackInjection = await readFile(join(base, "feedback-injection.md"), "utf-8");
+    }
+    catch {
+        /* use default */
+    }
+    try {
+        synthesis = await readFile(join(base, "synthesis.md"), "utf-8");
+    }
+    catch {
+        /* use default */
+    }
+    return { system, user, feedbackInjection, synthesis };
+}
+export function renderAuditSystem(template, data) {
+    const t = Handlebars.compile(template);
+    return t(data);
+}
+export function renderAuditUser(template, data) {
+    const t = Handlebars.compile(template);
+    return t(data);
+}
+export function renderFeedbackInjection(template, data) {
+    const t = Handlebars.compile(template);
+    return t(data);
+}
+export function renderSynthesis(template, data) {
+    const t = Handlebars.compile(template);
+    return t(data);
+}
+//# sourceMappingURL=loadAuditTemplates.js.map

package/dist/post-steps/audit/loadAuditTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadAuditTemplates.js","sourceRoot":"","sources":["../../../src/post-steps/audit/loadAuditTemplates.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,2IAA2I,CAAC;AACnK,MAAM,YAAY,GAAG,qJAAqJ,CAAC;AAC3K,MAAM,gBAAgB,GAAG,yGAAyG,CAAC;AACnI,MAAM,iBAAiB,GAAG,uEAAuE,CAAC;AASlG,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,IAAI,IAAI,GAAG,YAAY,CAAC;IACxB,IAAI,iBAAiB,GAAG,gBAAgB,CAAC;IACzC,IAAI,SAAS,GAAG,iBAAiB,CAAC;IAClC,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,IAAI,CAAC;QACH,iBAAiB,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAmC;IACrF,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAQjD;IACC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,IAKzD;IACC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAMjD;IACC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC;AACjB,CAAC"}

package/dist/post-steps/audit/parseAuditOutput.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parse audit LLM output (structured markdown / Flex-MD style) into AuditLLMOutput.
+ * Fallback: section-based markdown parser when Flex-MD is not used or parse fails.
+ */
+import type { AuditLLMOutput } from "../../types/task-types.js";
+/**
+ * Parse structured markdown from audit model into checks and overall feedback.
+ * Expects sections: "### Checks" with blocks of Check/Kind/Passed/Feedback, then "### Overall feedback".
+ */
+export declare function parseAuditOutputFromMarkdown(text: string): AuditLLMOutput;
+//# sourceMappingURL=parseAuditOutput.d.ts.map

package/dist/post-steps/audit/parseAuditOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseAuditOutput.d.ts","sourceRoot":"","sources":["../../../src/post-steps/audit/parseAuditOutput.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAElF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CA2CzE"}