@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-prompt-template-model/deterministic-step.d.ts

@@ -0,0 +1,30 @@
+import type { PromptWithModel, DeterministicStep, DeterministicExecution } from "./prompt-loader.ts";
+export declare const PROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE = "prompt-template-deterministic";
+export declare const PROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE = "prompt-template-deterministic-complete";
+export interface DeterministicExecutionResult {
+    execution: DeterministicExecution;
+    cwd: string;
+    nonInteractive: boolean;
+    resolvedScriptPath?: string;
+    exitCode: number;
+    signal?: NodeJS.Signals;
+    stdout: string;
+    stdoutTotalChars: number;
+    stdoutTotalLines: number;
+    stdoutTruncated: boolean;
+    stderr: string;
+    stderrTotalChars: number;
+    stderrTotalLines: number;
+    stderrTruncated: boolean;
+    durationMs: number;
+    timedOut: boolean;
+}
+export interface DeterministicPreambleOptions {
+    maxStdoutChars?: number;
+    maxStderrChars?: number;
+}
+export declare function formatDeterministicExecution(execution: DeterministicExecution, resolvedScriptPath?: string): string;
+export declare function shouldHandoffToLlm(step: DeterministicStep, result: Pick<DeterministicExecutionResult, "exitCode">): boolean;
+export declare function buildDeterministicPreamble(result: DeterministicExecutionResult, options?: DeterministicPreambleOptions): string;
+export declare function runDeterministicStep(prompt: Pick<PromptWithModel, "filePath">, step: DeterministicStep, cwd: string): Promise<DeterministicExecutionResult>;
+//# sourceMappingURL=deterministic-step.d.ts.map

package/dist/builtin-extensions/pi-prompt-template-model/deterministic-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-step.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/deterministic-step.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,sBAAsB,EAAoB,MAAM,oBAAoB,CAAC;AAEvH,eAAO,MAAM,0CAA0C,kCAAkC,CAAC;AAC1F,eAAO,MAAM,qDAAqD,2CAA2C,CAAC;AAgB9G,MAAM,WAAW,4BAA4B;IAC5C,SAAS,EAAE,sBAAsB,CAAC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,4BAA4B;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAmED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,sBAAsB,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAcnH;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,UAAU,CAAC,GAAG,OAAO,CAO3H;AAoBD,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,4BAA4B,EACpC,OAAO,GAAE,4BAAiC,GACxC,MAAM,CA2BR;AAkCD,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EACzC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,4BAA4B,CAAC,CAsFvC","sourcesContent":["// @ts-nocheck\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { dirname, isAbsolute, resolve } from \"node:path\";\nimport type { PromptWithModel, DeterministicStep, DeterministicExecution, DeterministicEnv } from \"./prompt-loader.ts\";\n\nexport const PROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE = \"prompt-template-deterministic\";\nexport const PROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE = \"prompt-template-deterministic-complete\";\n\nconst DEFAULT_MAX_CAPTURE_STDOUT_CHARS = 16_000;\nconst DEFAULT_MAX_CAPTURE_STDERR_CHARS = 16_000;\nconst DEFAULT_TIMEOUT_KILL_AFTER_MS = 1_000;\n\ninterface CapturedOutput {\n\ttext: string;\n\ttotalChars: number;\n\ttotalNewlines: number;\n\ttrailingNewlineRun: number;\n\tsawNonNewline: boolean;\n\ttruncated: boolean;\n\tmaxChars: number;\n}\n\nexport interface DeterministicExecutionResult {\n\texecution: DeterministicExecution;\n\tcwd: string;\n\tnonInteractive: boolean;\n\tresolvedScriptPath?: string;\n\texitCode: number;\n\tsignal?: NodeJS.Signals;\n\tstdout: string;\n\tstdoutTotalChars: number;\n\tstdoutTotalLines: number;\n\tstdoutTruncated: boolean;\n\tstderr: string;\n\tstderrTotalChars: number;\n\tstderrTotalLines: number;\n\tstderrTruncated: boolean;\n\tdurationMs: number;\n\ttimedOut: boolean;\n}\n\nexport interface DeterministicPreambleOptions {\n\tmaxStdoutChars?: number;\n\tmaxStderrChars?: number;\n}\n\nfunction createCapturedOutput(maxChars: number): CapturedOutput {\n\treturn {\n\t\ttext: \"\",\n\t\ttotalChars: 0,\n\t\ttotalNewlines: 0,\n\t\ttrailingNewlineRun: 0,\n\t\tsawNonNewline: false,\n\t\ttruncated: false,\n\t\tmaxChars,\n\t};\n}\n\nfunction appendCapturedOutput(output: CapturedOutput, chunk: string): void {\n\tif (!chunk) return;\n\toutput.totalChars += chunk.length;\n\tconst newlines = chunk.match(/\\n/g)?.length ?? 0;\n\toutput.totalNewlines += newlines;\n\tif (/[^\\n]/.test(chunk)) output.sawNonNewline = true;\n\tconst trailingRun = chunk.match(/\\n+$/)?.[0].length ?? 0;\n\tif (trailingRun === 0) {\n\t\toutput.trailingNewlineRun = 0;\n\t} else if (trailingRun === chunk.length) {\n\t\toutput.trailingNewlineRun += trailingRun;\n\t} else {\n\t\toutput.trailingNewlineRun = trailingRun;\n\t}\n\n\tif (output.text.length < output.maxChars) {\n\t\tconst remaining = output.maxChars - output.text.length;\n\t\toutput.text += chunk.slice(0, remaining);\n\t}\n\tif (output.totalChars > output.maxChars) output.truncated = true;\n}\n\nfunction capturedLineCount(output: Pick<CapturedOutput, \"totalChars\" | \"sawNonNewline\" | \"totalNewlines\" | \"trailingNewlineRun\">): number {\n\tif (output.totalChars === 0) return 0;\n\tif (!output.sawNonNewline) return 1;\n\treturn output.totalNewlines - output.trailingNewlineRun + 1;\n}\n\nfunction countLines(value: string): number {\n\tif (!value) return 0;\n\tconst normalized = value.replace(/\\n+$/g, \"\");\n\tif (!normalized) return 1;\n\treturn normalized.split(\"\\n\").length;\n}\n\nfunction buildTextPreview(label: string, value: string, totalChars: number, maxChars: number): { text: string; truncated: boolean; omittedChars: number } {\n\tconst shownChars = Math.min(value.length, maxChars);\n\tconst preview = value.slice(0, shownChars);\n\tconst omittedChars = Math.max(0, totalChars - shownChars);\n\tif (omittedChars === 0) {\n\t\treturn { text: preview, truncated: false, omittedChars: 0 };\n\t}\n\treturn {\n\t\ttext: `${preview}\\n...[${label} truncated, ${omittedChars} more chars omitted]`,\n\t\ttruncated: true,\n\t\tomittedChars,\n\t};\n}\n\nfunction shellQuote(value: string): string {\n\treturn `'${value.replace(/'/g, `'\"'\"'`)}'`;\n}\n\nexport function formatDeterministicExecution(execution: DeterministicExecution, resolvedScriptPath?: string): string {\n\tswitch (execution.kind) {\n\t\tcase \"run\":\n\t\t\treturn execution.command;\n\t\tcase \"command\": {\n\t\t\tconst parts = [execution.command, ...execution.args].map((part) => shellQuote(part));\n\t\t\treturn execution.shell ? `${parts.join(\" \")} (shell)` : parts.join(\" \");\n\t\t}\n\t\tcase \"script\": {\n\t\t\tconst scriptPath = resolvedScriptPath ?? execution.path;\n\t\t\tconst parts = [scriptPath, ...execution.args].map((part) => shellQuote(part));\n\t\t\treturn parts.join(\" \");\n\t\t}\n\t}\n}\n\nexport function shouldHandoffToLlm(step: DeterministicStep, result: Pick<DeterministicExecutionResult, \"exitCode\">): boolean {\n\tswitch (step.handoff) {\n\t\tcase \"always\": return true;\n\t\tcase \"never\": return false;\n\t\tcase \"on-success\": return result.exitCode === 0;\n\t\tcase \"on-failure\": return result.exitCode !== 0;\n\t}\n}\n\nfunction buildOutputPreambleSectionFromResult(\n\tlabel: \"stdout\" | \"stderr\",\n\tvalue: string,\n\tmeta: { totalChars: number; totalLines: number },\n\tmaxChars: number,\n): string[] {\n\tconst preview = buildTextPreview(label, value, meta.totalChars, maxChars);\n\treturn [\n\t\t`[${label}]`,\n\t\t`lineCount: ${meta.totalLines}`,\n\t\t`charCount: ${meta.totalChars}`,\n\t\t`truncated: ${preview.truncated ? \"true\" : \"false\"}`,\n\t\tpreview.truncated ? `omittedChars: ${preview.omittedChars}` : undefined,\n\t\t\"preview:\",\n\t\tpreview.text || \"(empty)\",\n\t];\n}\n\nexport function buildDeterministicPreamble(\n\tresult: DeterministicExecutionResult,\n\toptions: DeterministicPreambleOptions = {},\n): string {\n\tconst maxStdoutChars = options.maxStdoutChars ?? 8_000;\n\tconst maxStderrChars = options.maxStderrChars ?? 4_000;\n\tconst command = formatDeterministicExecution(result.execution, result.resolvedScriptPath);\n\treturn [\n\t\t\"[Deterministic step]\",\n\t\t`status: ${result.exitCode === 0 ? \"succeeded\" : \"failed\"}`,\n\t\t`executionKind: ${result.execution.kind}`,\n\t\t`command: ${command.includes(\"\\n\") ? JSON.stringify(command) : command}`,\n\t\tresult.resolvedScriptPath ? `resolvedScript: ${result.resolvedScriptPath}` : undefined,\n\t\t`cwd: ${result.cwd}`,\n\t\t`nonInteractive: ${result.nonInteractive ? \"true\" : \"false\"}`,\n\t\t`exitCode: ${result.exitCode}`,\n\t\tresult.signal ? `signal: ${result.signal}` : undefined,\n\t\t`durationMs: ${result.durationMs}`,\n\t\t`timedOut: ${result.timedOut ? \"true\" : \"false\"}`,\n\t\t\"\",\n\t\t...buildOutputPreambleSectionFromResult(\"stdout\", result.stdout, {\n\t\t\ttotalChars: result.stdoutTotalChars,\n\t\t\ttotalLines: result.stdoutTotalLines,\n\t\t}, maxStdoutChars),\n\t\t\"\",\n\t\t...buildOutputPreambleSectionFromResult(\"stderr\", result.stderr, {\n\t\t\ttotalChars: result.stderrTotalChars,\n\t\t\ttotalLines: result.stderrTotalLines,\n\t\t}, maxStderrChars),\n\t].filter((line): line is string => line !== undefined).join(\"\\n\");\n}\n\nfunction resolveScriptPath(prompt: Pick<PromptWithModel, \"filePath\">, cwd: string, execution: Extract<DeterministicExecution, { kind: \"script\" }>): string {\n\tif (isAbsolute(execution.path)) return execution.path;\n\tconst promptRelative = resolve(dirname(prompt.filePath), execution.path);\n\tif (existsSync(promptRelative)) return promptRelative;\n\treturn resolve(cwd, execution.path);\n}\n\nfunction buildDeterministicEnv(step: Pick<DeterministicStep, \"env\" | \"nonInteractive\">): NodeJS.ProcessEnv {\n\tconst nonInteractiveDefaults: DeterministicEnv = step.nonInteractive\n\t\t? {\n\t\t\tCI: \"1\",\n\t\t\tGIT_TERMINAL_PROMPT: \"0\",\n\t\t\tPAGER: \"cat\",\n\t\t\tGIT_PAGER: \"cat\",\n\t\t}\n\t\t: {};\n\treturn {\n\t\t...process.env,\n\t\t...nonInteractiveDefaults,\n\t\t...(step.env ?? {}),\n\t};\n}\n\nfunction spawnProcess(command: string, args: string[], options: { cwd: string; shell?: boolean; env: NodeJS.ProcessEnv }) {\n\treturn spawn(command, args, {\n\t\tcwd: options.cwd,\n\t\tshell: options.shell ?? false,\n\t\tenv: options.env,\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n}\n\nexport async function runDeterministicStep(\n\tprompt: Pick<PromptWithModel, \"filePath\">,\n\tstep: DeterministicStep,\n\tcwd: string,\n): Promise<DeterministicExecutionResult> {\n\tconst startedAt = Date.now();\n\tconst execution = step.execution;\n\tconst resolvedCwd = step.cwd ?? cwd;\n\tconst env = buildDeterministicEnv(step);\n\tconst resolvedScriptPath = execution.kind === \"script\"\n\t\t? resolveScriptPath(prompt, resolvedCwd, execution)\n\t\t: undefined;\n\tconst child = execution.kind === \"run\"\n\t\t? spawnProcess(\"/bin/bash\", [\"-lc\", execution.command], { cwd: resolvedCwd, env })\n\t\t: execution.kind === \"command\"\n\t\t\t? spawnProcess(execution.command, execution.args, { cwd: resolvedCwd, shell: execution.shell, env })\n\t\t\t: spawnProcess(resolvedScriptPath!, execution.args, { cwd: resolvedCwd, env });\n\n\tconst stdout = createCapturedOutput(DEFAULT_MAX_CAPTURE_STDOUT_CHARS);\n\tconst stderr = createCapturedOutput(DEFAULT_MAX_CAPTURE_STDERR_CHARS);\n\tlet timedOut = false;\n\tlet timeoutKillHandle: NodeJS.Timeout | undefined;\n\n\tchild.stdout.on(\"data\", (chunk) => {\n\t\tappendCapturedOutput(stdout, chunk.toString());\n\t});\n\tchild.stderr.on(\"data\", (chunk) => {\n\t\tappendCapturedOutput(stderr, chunk.toString());\n\t});\n\n\tconst timeoutHandle = step.timeoutMs\n\t\t? setTimeout(() => {\n\t\t\ttimedOut = true;\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\ttimeoutKillHandle = setTimeout(() => {\n\t\t\t\tchild.kill(\"SIGKILL\");\n\t\t\t}, DEFAULT_TIMEOUT_KILL_AFTER_MS);\n\t\t}, step.timeoutMs)\n\t\t: undefined;\n\n\treturn await new Promise((resolveResult) => {\n\t\tlet settled = false;\n\t\tchild.on(\"error\", (error) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\tif (timeoutKillHandle) clearTimeout(timeoutKillHandle);\n\t\t\tresolveResult({\n\t\t\t\texecution,\n\t\t\t\tcwd: resolvedCwd,\n\t\t\t\tnonInteractive: step.nonInteractive,\n\t\t\t\tresolvedScriptPath,\n\t\t\t\texitCode: 1,\n\t\t\t\tstdout: stdout.text,\n\t\t\t\tstdoutTotalChars: stdout.totalChars,\n\t\t\t\tstdoutTotalLines: capturedLineCount(stdout),\n\t\t\t\tstdoutTruncated: stdout.truncated,\n\t\t\t\tstderr: stderr.text ? `${stderr.text}\\n${error.message}` : error.message,\n\t\t\t\tstderrTotalChars: stderr.totalChars + (stderr.text ? error.message.length + 1 : error.message.length),\n\t\t\t\tstderrTotalLines: countLines(stderr.text ? `${stderr.text}\\n${error.message}` : error.message),\n\t\t\t\tstderrTruncated: stderr.truncated,\n\t\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\t\ttimedOut,\n\t\t\t});\n\t\t});\n\t\tchild.on(\"close\", (exitCode, signal) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\tif (timeoutKillHandle) clearTimeout(timeoutKillHandle);\n\t\t\tresolveResult({\n\t\t\t\texecution,\n\t\t\t\tcwd: resolvedCwd,\n\t\t\t\tnonInteractive: step.nonInteractive,\n\t\t\t\tresolvedScriptPath,\n\t\t\t\texitCode: exitCode ?? (timedOut ? 124 : 1),\n\t\t\t\tsignal: signal ?? undefined,\n\t\t\t\tstdout: stdout.text,\n\t\t\t\tstdoutTotalChars: stdout.totalChars,\n\t\t\t\tstdoutTotalLines: capturedLineCount(stdout),\n\t\t\t\tstdoutTruncated: stdout.truncated,\n\t\t\t\tstderr: stderr.text,\n\t\t\t\tstderrTotalChars: stderr.totalChars,\n\t\t\t\tstderrTotalLines: capturedLineCount(stderr),\n\t\t\t\tstderrTruncated: stderr.truncated,\n\t\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\t\ttimedOut,\n\t\t\t});\n\t\t});\n\t});\n}\n"]}

package/dist/builtin-extensions/pi-prompt-template-model/deterministic-step.js

@@ -0,0 +1,260 @@
+// @ts-nocheck
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, isAbsolute, resolve } from "node:path";
+export const PROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE = "prompt-template-deterministic";
+export const PROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE = "prompt-template-deterministic-complete";
+const DEFAULT_MAX_CAPTURE_STDOUT_CHARS = 16_000;
+const DEFAULT_MAX_CAPTURE_STDERR_CHARS = 16_000;
+const DEFAULT_TIMEOUT_KILL_AFTER_MS = 1_000;
+function createCapturedOutput(maxChars) {
+    return {
+        text: "",
+        totalChars: 0,
+        totalNewlines: 0,
+        trailingNewlineRun: 0,
+        sawNonNewline: false,
+        truncated: false,
+        maxChars,
+    };
+}
+function appendCapturedOutput(output, chunk) {
+    if (!chunk)
+        return;
+    output.totalChars += chunk.length;
+    const newlines = chunk.match(/\n/g)?.length ?? 0;
+    output.totalNewlines += newlines;
+    if (/[^\n]/.test(chunk))
+        output.sawNonNewline = true;
+    const trailingRun = chunk.match(/\n+$/)?.[0].length ?? 0;
+    if (trailingRun === 0) {
+        output.trailingNewlineRun = 0;
+    }
+    else if (trailingRun === chunk.length) {
+        output.trailingNewlineRun += trailingRun;
+    }
+    else {
+        output.trailingNewlineRun = trailingRun;
+    }
+    if (output.text.length < output.maxChars) {
+        const remaining = output.maxChars - output.text.length;
+        output.text += chunk.slice(0, remaining);
+    }
+    if (output.totalChars > output.maxChars)
+        output.truncated = true;
+}
+function capturedLineCount(output) {
+    if (output.totalChars === 0)
+        return 0;
+    if (!output.sawNonNewline)
+        return 1;
+    return output.totalNewlines - output.trailingNewlineRun + 1;
+}
+function countLines(value) {
+    if (!value)
+        return 0;
+    const normalized = value.replace(/\n+$/g, "");
+    if (!normalized)
+        return 1;
+    return normalized.split("\n").length;
+}
+function buildTextPreview(label, value, totalChars, maxChars) {
+    const shownChars = Math.min(value.length, maxChars);
+    const preview = value.slice(0, shownChars);
+    const omittedChars = Math.max(0, totalChars - shownChars);
+    if (omittedChars === 0) {
+        return { text: preview, truncated: false, omittedChars: 0 };
+    }
+    return {
+        text: `${preview}\n...[${label} truncated, ${omittedChars} more chars omitted]`,
+        truncated: true,
+        omittedChars,
+    };
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+export function formatDeterministicExecution(execution, resolvedScriptPath) {
+    switch (execution.kind) {
+        case "run":
+            return execution.command;
+        case "command": {
+            const parts = [execution.command, ...execution.args].map((part) => shellQuote(part));
+            return execution.shell ? `${parts.join(" ")} (shell)` : parts.join(" ");
+        }
+        case "script": {
+            const scriptPath = resolvedScriptPath ?? execution.path;
+            const parts = [scriptPath, ...execution.args].map((part) => shellQuote(part));
+            return parts.join(" ");
+        }
+    }
+}
+export function shouldHandoffToLlm(step, result) {
+    switch (step.handoff) {
+        case "always": return true;
+        case "never": return false;
+        case "on-success": return result.exitCode === 0;
+        case "on-failure": return result.exitCode !== 0;
+    }
+}
+function buildOutputPreambleSectionFromResult(label, value, meta, maxChars) {
+    const preview = buildTextPreview(label, value, meta.totalChars, maxChars);
+    return [
+        `[${label}]`,
+        `lineCount: ${meta.totalLines}`,
+        `charCount: ${meta.totalChars}`,
+        `truncated: ${preview.truncated ? "true" : "false"}`,
+        preview.truncated ? `omittedChars: ${preview.omittedChars}` : undefined,
+        "preview:",
+        preview.text || "(empty)",
+    ];
+}
+export function buildDeterministicPreamble(result, options = {}) {
+    const maxStdoutChars = options.maxStdoutChars ?? 8_000;
+    const maxStderrChars = options.maxStderrChars ?? 4_000;
+    const command = formatDeterministicExecution(result.execution, result.resolvedScriptPath);
+    return [
+        "[Deterministic step]",
+        `status: ${result.exitCode === 0 ? "succeeded" : "failed"}`,
+        `executionKind: ${result.execution.kind}`,
+        `command: ${command.includes("\n") ? JSON.stringify(command) : command}`,
+        result.resolvedScriptPath ? `resolvedScript: ${result.resolvedScriptPath}` : undefined,
+        `cwd: ${result.cwd}`,
+        `nonInteractive: ${result.nonInteractive ? "true" : "false"}`,
+        `exitCode: ${result.exitCode}`,
+        result.signal ? `signal: ${result.signal}` : undefined,
+        `durationMs: ${result.durationMs}`,
+        `timedOut: ${result.timedOut ? "true" : "false"}`,
+        "",
+        ...buildOutputPreambleSectionFromResult("stdout", result.stdout, {
+            totalChars: result.stdoutTotalChars,
+            totalLines: result.stdoutTotalLines,
+        }, maxStdoutChars),
+        "",
+        ...buildOutputPreambleSectionFromResult("stderr", result.stderr, {
+            totalChars: result.stderrTotalChars,
+            totalLines: result.stderrTotalLines,
+        }, maxStderrChars),
+    ].filter((line) => line !== undefined).join("\n");
+}
+function resolveScriptPath(prompt, cwd, execution) {
+    if (isAbsolute(execution.path))
+        return execution.path;
+    const promptRelative = resolve(dirname(prompt.filePath), execution.path);
+    if (existsSync(promptRelative))
+        return promptRelative;
+    return resolve(cwd, execution.path);
+}
+function buildDeterministicEnv(step) {
+    const nonInteractiveDefaults = step.nonInteractive
+        ? {
+            CI: "1",
+            GIT_TERMINAL_PROMPT: "0",
+            PAGER: "cat",
+            GIT_PAGER: "cat",
+        }
+        : {};
+    return {
+        ...process.env,
+        ...nonInteractiveDefaults,
+        ...(step.env ?? {}),
+    };
+}
+function spawnProcess(command, args, options) {
+    return spawn(command, args, {
+        cwd: options.cwd,
+        shell: options.shell ?? false,
+        env: options.env,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+}
+export async function runDeterministicStep(prompt, step, cwd) {
+    const startedAt = Date.now();
+    const execution = step.execution;
+    const resolvedCwd = step.cwd ?? cwd;
+    const env = buildDeterministicEnv(step);
+    const resolvedScriptPath = execution.kind === "script"
+        ? resolveScriptPath(prompt, resolvedCwd, execution)
+        : undefined;
+    const child = execution.kind === "run"
+        ? spawnProcess("/bin/bash", ["-lc", execution.command], { cwd: resolvedCwd, env })
+        : execution.kind === "command"
+            ? spawnProcess(execution.command, execution.args, { cwd: resolvedCwd, shell: execution.shell, env })
+            : spawnProcess(resolvedScriptPath, execution.args, { cwd: resolvedCwd, env });
+    const stdout = createCapturedOutput(DEFAULT_MAX_CAPTURE_STDOUT_CHARS);
+    const stderr = createCapturedOutput(DEFAULT_MAX_CAPTURE_STDERR_CHARS);
+    let timedOut = false;
+    let timeoutKillHandle;
+    child.stdout.on("data", (chunk) => {
+        appendCapturedOutput(stdout, chunk.toString());
+    });
+    child.stderr.on("data", (chunk) => {
+        appendCapturedOutput(stderr, chunk.toString());
+    });
+    const timeoutHandle = step.timeoutMs
+        ? setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+            timeoutKillHandle = setTimeout(() => {
+                child.kill("SIGKILL");
+            }, DEFAULT_TIMEOUT_KILL_AFTER_MS);
+        }, step.timeoutMs)
+        : undefined;
+    return await new Promise((resolveResult) => {
+        let settled = false;
+        child.on("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            if (timeoutKillHandle)
+                clearTimeout(timeoutKillHandle);
+            resolveResult({
+                execution,
+                cwd: resolvedCwd,
+                nonInteractive: step.nonInteractive,
+                resolvedScriptPath,
+                exitCode: 1,
+                stdout: stdout.text,
+                stdoutTotalChars: stdout.totalChars,
+                stdoutTotalLines: capturedLineCount(stdout),
+                stdoutTruncated: stdout.truncated,
+                stderr: stderr.text ? `${stderr.text}\n${error.message}` : error.message,
+                stderrTotalChars: stderr.totalChars + (stderr.text ? error.message.length + 1 : error.message.length),
+                stderrTotalLines: countLines(stderr.text ? `${stderr.text}\n${error.message}` : error.message),
+                stderrTruncated: stderr.truncated,
+                durationMs: Date.now() - startedAt,
+                timedOut,
+            });
+        });
+        child.on("close", (exitCode, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            if (timeoutKillHandle)
+                clearTimeout(timeoutKillHandle);
+            resolveResult({
+                execution,
+                cwd: resolvedCwd,
+                nonInteractive: step.nonInteractive,
+                resolvedScriptPath,
+                exitCode: exitCode ?? (timedOut ? 124 : 1),
+                signal: signal ?? undefined,
+                stdout: stdout.text,
+                stdoutTotalChars: stdout.totalChars,
+                stdoutTotalLines: capturedLineCount(stdout),
+                stdoutTruncated: stdout.truncated,
+                stderr: stderr.text,
+                stderrTotalChars: stderr.totalChars,
+                stderrTotalLines: capturedLineCount(stderr),
+                stderrTruncated: stderr.truncated,
+                durationMs: Date.now() - startedAt,
+                timedOut,
+            });
+        });
+    });
+}
+//# sourceMappingURL=deterministic-step.js.map

package/dist/builtin-extensions/pi-prompt-template-model/deterministic-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deterministic-step.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/deterministic-step.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { dirname, isAbsolute, resolve } from \"node:path\";\nimport type { PromptWithModel, DeterministicStep, DeterministicExecution, DeterministicEnv } from \"./prompt-loader.ts\";\n\nexport const PROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE = \"prompt-template-deterministic\";\nexport const PROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE = \"prompt-template-deterministic-complete\";\n\nconst DEFAULT_MAX_CAPTURE_STDOUT_CHARS = 16_000;\nconst DEFAULT_MAX_CAPTURE_STDERR_CHARS = 16_000;\nconst DEFAULT_TIMEOUT_KILL_AFTER_MS = 1_000;\n\ninterface CapturedOutput {\n\ttext: string;\n\ttotalChars: number;\n\ttotalNewlines: number;\n\ttrailingNewlineRun: number;\n\tsawNonNewline: boolean;\n\ttruncated: boolean;\n\tmaxChars: number;\n}\n\nexport interface DeterministicExecutionResult {\n\texecution: DeterministicExecution;\n\tcwd: string;\n\tnonInteractive: boolean;\n\tresolvedScriptPath?: string;\n\texitCode: number;\n\tsignal?: NodeJS.Signals;\n\tstdout: string;\n\tstdoutTotalChars: number;\n\tstdoutTotalLines: number;\n\tstdoutTruncated: boolean;\n\tstderr: string;\n\tstderrTotalChars: number;\n\tstderrTotalLines: number;\n\tstderrTruncated: boolean;\n\tdurationMs: number;\n\ttimedOut: boolean;\n}\n\nexport interface DeterministicPreambleOptions {\n\tmaxStdoutChars?: number;\n\tmaxStderrChars?: number;\n}\n\nfunction createCapturedOutput(maxChars: number): CapturedOutput {\n\treturn {\n\t\ttext: \"\",\n\t\ttotalChars: 0,\n\t\ttotalNewlines: 0,\n\t\ttrailingNewlineRun: 0,\n\t\tsawNonNewline: false,\n\t\ttruncated: false,\n\t\tmaxChars,\n\t};\n}\n\nfunction appendCapturedOutput(output: CapturedOutput, chunk: string): void {\n\tif (!chunk) return;\n\toutput.totalChars += chunk.length;\n\tconst newlines = chunk.match(/\\n/g)?.length ?? 0;\n\toutput.totalNewlines += newlines;\n\tif (/[^\\n]/.test(chunk)) output.sawNonNewline = true;\n\tconst trailingRun = chunk.match(/\\n+$/)?.[0].length ?? 0;\n\tif (trailingRun === 0) {\n\t\toutput.trailingNewlineRun = 0;\n\t} else if (trailingRun === chunk.length) {\n\t\toutput.trailingNewlineRun += trailingRun;\n\t} else {\n\t\toutput.trailingNewlineRun = trailingRun;\n\t}\n\n\tif (output.text.length < output.maxChars) {\n\t\tconst remaining = output.maxChars - output.text.length;\n\t\toutput.text += chunk.slice(0, remaining);\n\t}\n\tif (output.totalChars > output.maxChars) output.truncated = true;\n}\n\nfunction capturedLineCount(output: Pick<CapturedOutput, \"totalChars\" | \"sawNonNewline\" | \"totalNewlines\" | \"trailingNewlineRun\">): number {\n\tif (output.totalChars === 0) return 0;\n\tif (!output.sawNonNewline) return 1;\n\treturn output.totalNewlines - output.trailingNewlineRun + 1;\n}\n\nfunction countLines(value: string): number {\n\tif (!value) return 0;\n\tconst normalized = value.replace(/\\n+$/g, \"\");\n\tif (!normalized) return 1;\n\treturn normalized.split(\"\\n\").length;\n}\n\nfunction buildTextPreview(label: string, value: string, totalChars: number, maxChars: number): { text: string; truncated: boolean; omittedChars: number } {\n\tconst shownChars = Math.min(value.length, maxChars);\n\tconst preview = value.slice(0, shownChars);\n\tconst omittedChars = Math.max(0, totalChars - shownChars);\n\tif (omittedChars === 0) {\n\t\treturn { text: preview, truncated: false, omittedChars: 0 };\n\t}\n\treturn {\n\t\ttext: `${preview}\\n...[${label} truncated, ${omittedChars} more chars omitted]`,\n\t\ttruncated: true,\n\t\tomittedChars,\n\t};\n}\n\nfunction shellQuote(value: string): string {\n\treturn `'${value.replace(/'/g, `'\"'\"'`)}'`;\n}\n\nexport function formatDeterministicExecution(execution: DeterministicExecution, resolvedScriptPath?: string): string {\n\tswitch (execution.kind) {\n\t\tcase \"run\":\n\t\t\treturn execution.command;\n\t\tcase \"command\": {\n\t\t\tconst parts = [execution.command, ...execution.args].map((part) => shellQuote(part));\n\t\t\treturn execution.shell ? `${parts.join(\" \")} (shell)` : parts.join(\" \");\n\t\t}\n\t\tcase \"script\": {\n\t\t\tconst scriptPath = resolvedScriptPath ?? execution.path;\n\t\t\tconst parts = [scriptPath, ...execution.args].map((part) => shellQuote(part));\n\t\t\treturn parts.join(\" \");\n\t\t}\n\t}\n}\n\nexport function shouldHandoffToLlm(step: DeterministicStep, result: Pick<DeterministicExecutionResult, \"exitCode\">): boolean {\n\tswitch (step.handoff) {\n\t\tcase \"always\": return true;\n\t\tcase \"never\": return false;\n\t\tcase \"on-success\": return result.exitCode === 0;\n\t\tcase \"on-failure\": return result.exitCode !== 0;\n\t}\n}\n\nfunction buildOutputPreambleSectionFromResult(\n\tlabel: \"stdout\" | \"stderr\",\n\tvalue: string,\n\tmeta: { totalChars: number; totalLines: number },\n\tmaxChars: number,\n): string[] {\n\tconst preview = buildTextPreview(label, value, meta.totalChars, maxChars);\n\treturn [\n\t\t`[${label}]`,\n\t\t`lineCount: ${meta.totalLines}`,\n\t\t`charCount: ${meta.totalChars}`,\n\t\t`truncated: ${preview.truncated ? \"true\" : \"false\"}`,\n\t\tpreview.truncated ? `omittedChars: ${preview.omittedChars}` : undefined,\n\t\t\"preview:\",\n\t\tpreview.text || \"(empty)\",\n\t];\n}\n\nexport function buildDeterministicPreamble(\n\tresult: DeterministicExecutionResult,\n\toptions: DeterministicPreambleOptions = {},\n): string {\n\tconst maxStdoutChars = options.maxStdoutChars ?? 8_000;\n\tconst maxStderrChars = options.maxStderrChars ?? 4_000;\n\tconst command = formatDeterministicExecution(result.execution, result.resolvedScriptPath);\n\treturn [\n\t\t\"[Deterministic step]\",\n\t\t`status: ${result.exitCode === 0 ? \"succeeded\" : \"failed\"}`,\n\t\t`executionKind: ${result.execution.kind}`,\n\t\t`command: ${command.includes(\"\\n\") ? JSON.stringify(command) : command}`,\n\t\tresult.resolvedScriptPath ? `resolvedScript: ${result.resolvedScriptPath}` : undefined,\n\t\t`cwd: ${result.cwd}`,\n\t\t`nonInteractive: ${result.nonInteractive ? \"true\" : \"false\"}`,\n\t\t`exitCode: ${result.exitCode}`,\n\t\tresult.signal ? `signal: ${result.signal}` : undefined,\n\t\t`durationMs: ${result.durationMs}`,\n\t\t`timedOut: ${result.timedOut ? \"true\" : \"false\"}`,\n\t\t\"\",\n\t\t...buildOutputPreambleSectionFromResult(\"stdout\", result.stdout, {\n\t\t\ttotalChars: result.stdoutTotalChars,\n\t\t\ttotalLines: result.stdoutTotalLines,\n\t\t}, maxStdoutChars),\n\t\t\"\",\n\t\t...buildOutputPreambleSectionFromResult(\"stderr\", result.stderr, {\n\t\t\ttotalChars: result.stderrTotalChars,\n\t\t\ttotalLines: result.stderrTotalLines,\n\t\t}, maxStderrChars),\n\t].filter((line): line is string => line !== undefined).join(\"\\n\");\n}\n\nfunction resolveScriptPath(prompt: Pick<PromptWithModel, \"filePath\">, cwd: string, execution: Extract<DeterministicExecution, { kind: \"script\" }>): string {\n\tif (isAbsolute(execution.path)) return execution.path;\n\tconst promptRelative = resolve(dirname(prompt.filePath), execution.path);\n\tif (existsSync(promptRelative)) return promptRelative;\n\treturn resolve(cwd, execution.path);\n}\n\nfunction buildDeterministicEnv(step: Pick<DeterministicStep, \"env\" | \"nonInteractive\">): NodeJS.ProcessEnv {\n\tconst nonInteractiveDefaults: DeterministicEnv = step.nonInteractive\n\t\t? {\n\t\t\tCI: \"1\",\n\t\t\tGIT_TERMINAL_PROMPT: \"0\",\n\t\t\tPAGER: \"cat\",\n\t\t\tGIT_PAGER: \"cat\",\n\t\t}\n\t\t: {};\n\treturn {\n\t\t...process.env,\n\t\t...nonInteractiveDefaults,\n\t\t...(step.env ?? {}),\n\t};\n}\n\nfunction spawnProcess(command: string, args: string[], options: { cwd: string; shell?: boolean; env: NodeJS.ProcessEnv }) {\n\treturn spawn(command, args, {\n\t\tcwd: options.cwd,\n\t\tshell: options.shell ?? false,\n\t\tenv: options.env,\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n}\n\nexport async function runDeterministicStep(\n\tprompt: Pick<PromptWithModel, \"filePath\">,\n\tstep: DeterministicStep,\n\tcwd: string,\n): Promise<DeterministicExecutionResult> {\n\tconst startedAt = Date.now();\n\tconst execution = step.execution;\n\tconst resolvedCwd = step.cwd ?? cwd;\n\tconst env = buildDeterministicEnv(step);\n\tconst resolvedScriptPath = execution.kind === \"script\"\n\t\t? resolveScriptPath(prompt, resolvedCwd, execution)\n\t\t: undefined;\n\tconst child = execution.kind === \"run\"\n\t\t? spawnProcess(\"/bin/bash\", [\"-lc\", execution.command], { cwd: resolvedCwd, env })\n\t\t: execution.kind === \"command\"\n\t\t\t? spawnProcess(execution.command, execution.args, { cwd: resolvedCwd, shell: execution.shell, env })\n\t\t\t: spawnProcess(resolvedScriptPath!, execution.args, { cwd: resolvedCwd, env });\n\n\tconst stdout = createCapturedOutput(DEFAULT_MAX_CAPTURE_STDOUT_CHARS);\n\tconst stderr = createCapturedOutput(DEFAULT_MAX_CAPTURE_STDERR_CHARS);\n\tlet timedOut = false;\n\tlet timeoutKillHandle: NodeJS.Timeout | undefined;\n\n\tchild.stdout.on(\"data\", (chunk) => {\n\t\tappendCapturedOutput(stdout, chunk.toString());\n\t});\n\tchild.stderr.on(\"data\", (chunk) => {\n\t\tappendCapturedOutput(stderr, chunk.toString());\n\t});\n\n\tconst timeoutHandle = step.timeoutMs\n\t\t? setTimeout(() => {\n\t\t\ttimedOut = true;\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t\ttimeoutKillHandle = setTimeout(() => {\n\t\t\t\tchild.kill(\"SIGKILL\");\n\t\t\t}, DEFAULT_TIMEOUT_KILL_AFTER_MS);\n\t\t}, step.timeoutMs)\n\t\t: undefined;\n\n\treturn await new Promise((resolveResult) => {\n\t\tlet settled = false;\n\t\tchild.on(\"error\", (error) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\tif (timeoutKillHandle) clearTimeout(timeoutKillHandle);\n\t\t\tresolveResult({\n\t\t\t\texecution,\n\t\t\t\tcwd: resolvedCwd,\n\t\t\t\tnonInteractive: step.nonInteractive,\n\t\t\t\tresolvedScriptPath,\n\t\t\t\texitCode: 1,\n\t\t\t\tstdout: stdout.text,\n\t\t\t\tstdoutTotalChars: stdout.totalChars,\n\t\t\t\tstdoutTotalLines: capturedLineCount(stdout),\n\t\t\t\tstdoutTruncated: stdout.truncated,\n\t\t\t\tstderr: stderr.text ? `${stderr.text}\\n${error.message}` : error.message,\n\t\t\t\tstderrTotalChars: stderr.totalChars + (stderr.text ? error.message.length + 1 : error.message.length),\n\t\t\t\tstderrTotalLines: countLines(stderr.text ? `${stderr.text}\\n${error.message}` : error.message),\n\t\t\t\tstderrTruncated: stderr.truncated,\n\t\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\t\ttimedOut,\n\t\t\t});\n\t\t});\n\t\tchild.on(\"close\", (exitCode, signal) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tif (timeoutHandle) clearTimeout(timeoutHandle);\n\t\t\tif (timeoutKillHandle) clearTimeout(timeoutKillHandle);\n\t\t\tresolveResult({\n\t\t\t\texecution,\n\t\t\t\tcwd: resolvedCwd,\n\t\t\t\tnonInteractive: step.nonInteractive,\n\t\t\t\tresolvedScriptPath,\n\t\t\t\texitCode: exitCode ?? (timedOut ? 124 : 1),\n\t\t\t\tsignal: signal ?? undefined,\n\t\t\t\tstdout: stdout.text,\n\t\t\t\tstdoutTotalChars: stdout.totalChars,\n\t\t\t\tstdoutTotalLines: capturedLineCount(stdout),\n\t\t\t\tstdoutTruncated: stdout.truncated,\n\t\t\t\tstderr: stderr.text,\n\t\t\t\tstderrTotalChars: stderr.totalChars,\n\t\t\t\tstderrTotalLines: capturedLineCount(stderr),\n\t\t\t\tstderrTruncated: stderr.truncated,\n\t\t\t\tdurationMs: Date.now() - startedAt,\n\t\t\t\ttimedOut,\n\t\t\t});\n\t\t});\n\t});\n}\n"]}

package/dist/builtin-extensions/pi-prompt-template-model/index.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export default function promptModelExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/builtin-extensions/pi-prompt-template-model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-prompt-template-model/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAA6C,MAAM,iCAAiC,CAAC;AA4G/G,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAE,EAAE,YAAY,QAwoD5D","sourcesContent":["// @ts-nocheck\nimport { existsSync } from \"node:fs\";\nimport { resolve as resolvePath } from \"node:path\";\nimport type { Model } from \"@earendil-works/pi-ai\";\nimport type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport {\n\textractChainContextFlag,\n\textractLineupOverrides,\n\textractLoopCount,\n\textractLoopFlags,\n\textractSubagentOverride,\n\textractWorktreeFlag,\n\tparseCommandArgs,\n\tsubstituteArgs,\n\ttype LineupOverrideAction,\n\ttype SubagentOverride,\n} from \"./args.ts\";\nimport { parseChainSteps, parseChainDeclaration, type ChainStep, type ChainStepOrParallel, type ParallelChainStep } from \"./chain-parser.ts\";\nimport { generateBoomerangSummary, generateChainStepSummary, generateIterationSummary, didIterationMakeChanges, getIterationEntries, wasIterationAborted } from \"./loop-utils.ts\";\nimport { selectModelCandidate } from \"./model-selection.ts\";\nimport { notify, summarizePromptDiagnostics, diagnosticsFingerprint } from \"./notifications.ts\";\nimport { preparePromptExecution, renderPromptForResolvedModel } from \"./prompt-execution.ts\";\nimport {\n\tbuildPromptCommandDescription,\n\texpandCwdPath,\n\tloadPromptsWithModel,\n\treadSkillContent,\n\tresolveSkillPath,\n\ttype DelegationLineupSlot,\n\ttype PromptWithModel,\n} from \"./prompt-loader.ts\";\nimport { renderSkillLoaded, type SkillLoadedDetails } from \"./skill-loaded-renderer.ts\";\nimport { createToolManager } from \"./tool-manager.ts\";\nimport { executeSubagentPromptStep, type DelegatedPromptParallelResult } from \"./subagent-step.ts\";\nimport { DEFAULT_SUBAGENT_NAME, PROMPT_TEMPLATE_SUBAGENT_MESSAGE_TYPE } from \"./subagent-runtime.ts\";\nimport { renderDelegatedSubagentResult } from \"./subagent-renderer.ts\";\nimport {\n\tPROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE,\n\tPROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE,\n\tbuildDeterministicPreamble,\n\trunDeterministicStep,\n\tshouldHandoffToLlm,\n} from \"./deterministic-step.ts\";\nimport { renderDeterministicCompletion, renderDeterministicResult } from \"./deterministic-renderer.ts\";\n\ninterface LoopState {\n\tcurrentIteration: number;\n\ttotalIterations: number | null;\n\trotationLabel?: string;\n}\n\ninterface FreshCollapse {\n\ttargetId: string;\n\ttask: string;\n\titeration: number;\n\ttotalIterations: number | null;\n}\n\ninterface BoomerangCollapse {\n\ttargetId: string;\n\ttask: string;\n\tpreviousSummaries: string[];\n}\n\ninterface PendingSkillMessage {\n\tcustomType: \"skill-loaded\";\n\tcontent: string;\n\tdisplay: true;\n\tdetails: SkillLoadedDetails;\n}\n\ntype SkillMessageResolution =\n\t| { kind: \"none\" }\n\t| { kind: \"ready\"; message: PendingSkillMessage }\n\t| { kind: \"error\"; error: string };\n\ninterface ExecutionErrorState {\n\thasError: boolean;\n\terror: unknown;\n}\n\ninterface PromptStepResult {\n\tchanged: boolean;\n\ttext?: string;\n}\n\ninterface PromptTurnRestore {\n\toriginalModel: Model<any> | undefined;\n\toriginalThinking: ThinkingLevel | undefined;\n}\n\nconst DEFAULT_COMPARE_REVIEWER_TASK = [\n\t\"Review the worker variants and produce findings only.\",\n\t\"Required output:\",\n\t\"1. Summarize concrete strengths with patch/diff evidence, including worktree change summaries when present.\",\n\t\"2. Call out concrete correctness risks and regression risks.\",\n\t\"3. Extract cherry-pick ideas from non-winning variants.\",\n\t\"4. Do not rank variants or select a winner.\",\n\t\"5. Do not include manual apply commands.\",\n].join(\"\\n\");\n\nconst DEFAULT_COMPARE_FINAL_APPLIER_TASK = [\n\t\"Apply the final implementation directly in the current repo.\",\n\t\"Required output:\",\n\t\"1. Pick the best single variant or synthesize/cherry-pick across variants.\",\n\t\"2. Apply changes directly on the current branch.\",\n\t\"3. Keep edits minimal and focused on the implementation task.\",\n\t\"4. Run obvious relevant verification when practical.\",\n\t\"5. Report changed files and verification commands run.\",\n].join(\"\\n\");\n\nexport default function promptModelExtension(pi: ExtensionAPI) {\n\tlet prompts = new Map<string, PromptWithModel>();\n\tlet chainPrompts = new Map<string, PromptWithModel>();\n\tlet previousModel: Model<any> | undefined;\n\tlet previousThinking: ThinkingLevel | undefined;\n\tlet pendingSkillMessage: PendingSkillMessage | undefined;\n\tlet runtimeModel: Model<any> | undefined;\n\tlet chainActive = false;\n\tlet loopState: LoopState | null = null;\n\tlet freshCollapse: FreshCollapse | null = null;\n\tlet boomerangCollapse: BoomerangCollapse | null = null;\n\tlet accumulatedSummaries: string[] = [];\n\tlet lastDiagnostics = \"\";\n\tlet storedCommandCtx: ExtensionCommandContext | null = null;\n\tconst UNLIMITED_LOOP_CAP = 999;\n\n\tconst toolManager = createToolManager(pi, {\n\t\tisActive: () => !!(loopState || chainActive),\n\t\tgetStoredCtx: () => storedCommandCtx,\n\t\tsetStoredCtx: (ctx) => {\n\t\t\tstoredCommandCtx = ctx;\n\t\t},\n\t\texecuteCommand: executeToolCommand,\n\t});\n\n\tfunction sameModel(a: Model<any> | undefined, b: Model<any> | undefined): boolean {\n\t\tif (!a || !b) return a === b;\n\t\treturn a.provider === b.provider && a.id === b.id;\n\t}\n\n\tfunction getCurrentModel(ctx: Pick<ExtensionContext, \"model\">): Model<any> | undefined {\n\t\treturn runtimeModel ?? ctx.model;\n\t}\n\n\tpi.registerMessageRenderer<SkillLoadedDetails>(\"skill-loaded\", renderSkillLoaded);\n\tpi.registerMessageRenderer(PROMPT_TEMPLATE_SUBAGENT_MESSAGE_TYPE, renderDelegatedSubagentResult);\n\tpi.registerMessageRenderer(PROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE, renderDeterministicResult);\n\tpi.registerMessageRenderer(PROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE, renderDeterministicCompletion);\n\n\tfunction registerPromptCommand(name: string) {\n\t\tpi.registerCommand(name, {\n\t\t\tdescription: buildPromptCommandDescription(prompts.get(name)!),\n\t\t\thandler: async (args, ctx) => {\n\t\t\t\tawait runPromptCommand(name, args, ctx);\n\t\t\t},\n\t\t});\n\t}\n\n\tfunction refreshPrompts(cwd: string, ctx?: ExtensionContext) {\n\t\tconst result = loadPromptsWithModel(cwd);\n\t\tconst chainResult = loadPromptsWithModel(cwd, true);\n\t\tprompts = result.prompts;\n\t\tchainPrompts = chainResult.prompts;\n\n\t\tfor (const name of prompts.keys()) {\n\t\t\tregisterPromptCommand(name);\n\t\t}\n\n\t\tconst summary = summarizePromptDiagnostics(result.diagnostics);\n\t\tconst fingerprint = diagnosticsFingerprint(result.diagnostics);\n\t\tif (summary && fingerprint !== lastDiagnostics) {\n\t\t\tnotify(ctx, summary, \"warning\");\n\t\t}\n\t\tlastDiagnostics = fingerprint;\n\t}\n\n\tfunction consumePendingSkillMessage() {\n\t\tif (!pendingSkillMessage) return undefined;\n\t\tconst message = pendingSkillMessage;\n\t\tpendingSkillMessage = undefined;\n\t\treturn message;\n\t}\n\n\tfunction normalizeSkillName(skillName: string): string {\n\t\treturn skillName.startsWith(\"skill:\") ? skillName.slice(\"skill:\".length) : skillName;\n\t}\n\n\tfunction isPathResolvableSkillName(skillName: string): boolean {\n\t\tif (skillName === \".\" || skillName === \"..\") return false;\n\t\tif (skillName.includes(\"/\")) return false;\n\t\tif (skillName.includes(\"\\\\\")) return false;\n\t\treturn true;\n\t}\n\n\tfunction resolveRegisteredSkillPath(skillName: string): string | undefined {\n\t\tconst normalizedSkillName = normalizeSkillName(skillName);\n\t\tif (!normalizedSkillName) return undefined;\n\t\tconst candidates = new Set([normalizedSkillName, `skill:${normalizedSkillName}`]);\n\n\t\tfor (const command of pi.getCommands()) {\n\t\t\tif (command.source !== \"skill\") continue;\n\t\t\tconst sourceInfo = \"sourceInfo\" in command\n\t\t\t\t? (command as { sourceInfo?: { path?: string } }).sourceInfo\n\t\t\t\t: undefined;\n\t\t\tif (!sourceInfo?.path) continue;\n\t\t\tif (!candidates.has(command.name)) continue;\n\t\t\treturn sourceInfo.path;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\tfunction resolveSkillMessage(skillName: string | undefined, cwd: string): SkillMessageResolution {\n\t\tif (!skillName) {\n\t\t\treturn { kind: \"none\" };\n\t\t}\n\n\t\tconst normalizedSkillName = normalizeSkillName(skillName);\n\t\tif (!normalizedSkillName) {\n\t\t\treturn { kind: \"error\", error: `Skill \"${skillName}\" not found` };\n\t\t}\n\n\t\tconst skillPath =\n\t\t\tresolveRegisteredSkillPath(skillName) ?? (isPathResolvableSkillName(normalizedSkillName) ? resolveSkillPath(normalizedSkillName, cwd) : undefined);\n\t\tif (!skillPath) {\n\t\t\treturn { kind: \"error\", error: `Skill \"${skillName}\" not found` };\n\t\t}\n\n\t\ttry {\n\t\t\tconst skillContent = readSkillContent(skillPath);\n\t\t\treturn {\n\t\t\t\tkind: \"ready\",\n\t\t\t\tmessage: {\n\t\t\t\t\tcustomType: \"skill-loaded\",\n\t\t\t\t\tcontent: `<skill name=\"${normalizedSkillName}\">\\n${skillContent}\\n</skill>`,\n\t\t\t\t\tdisplay: true,\n\t\t\t\t\tdetails: { skillName: normalizedSkillName, skillContent, skillPath },\n\t\t\t\t},\n\t\t\t};\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tkind: \"error\",\n\t\t\t\terror: `Failed to read skill \"${skillName}\": ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\t}\n\n\tasync function waitForTurnStart(ctx: ExtensionContext) {\n\t\twhile (ctx.isIdle()) {\n\t\t\tawait new Promise((resolve) => setTimeout(resolve, 10));\n\t\t}\n\t}\n\n\tfunction shouldDelegatePrompt(prompt: PromptWithModel, override?: SubagentOverride): boolean {\n\t\treturn prompt.subagent !== undefined || override?.enabled === true;\n\t}\n\n\tfunction isParallelChainStep(step: ChainStepOrParallel): step is ParallelChainStep {\n\t\treturn \"parallel\" in step;\n\t}\n\n\tasync function executePromptStep(\n\t\tprompt: PromptWithModel,\n\t\targs: string[],\n\t\tctx: ExtensionCommandContext,\n\t\tcurrentModel: Model<any> | undefined,\n\t\toverride?: SubagentOverride,\n\t\tinheritedModel?: Model<any>,\n\t\ttaskPreamble?: string,\n\t\tloopContext?: string,\n\t\tpromptTurnRestore?: PromptTurnRestore,\n\t): Promise<PromptStepResult | \"aborted\"> {\n\t\tlet deterministicPreamble: string | undefined;\n\t\tif (prompt.deterministic) {\n\t\t\ttry {\n\t\t\t\tconst deterministicResult = await runDeterministicStep(prompt, prompt.deterministic, ctx.cwd);\n\t\t\t\tconst deterministicPreambleText = buildDeterministicPreamble(deterministicResult);\n\t\t\t\tpi.sendMessage({\n\t\t\t\t\tcustomType: PROMPT_TEMPLATE_DETERMINISTIC_MESSAGE_TYPE,\n\t\t\t\t\tcontent: deterministicPreambleText,\n\t\t\t\t\tdisplay: true,\n\t\t\t\t\tdetails: deterministicResult,\n\t\t\t\t});\n\t\t\t\tif (!shouldHandoffToLlm(prompt.deterministic, deterministicResult)) {\n\t\t\t\t\tpi.sendMessage({\n\t\t\t\t\t\tcustomType: PROMPT_TEMPLATE_DETERMINISTIC_COMPLETION_MESSAGE_TYPE,\n\t\t\t\t\t\tcontent: `[Deterministic complete: ${prompt.name}]`,\n\t\t\t\t\t\tdisplay: true,\n\t\t\t\t\t\tdetails: {\n\t\t\t\t\t\t\tpromptName: prompt.name,\n\t\t\t\t\t\t\texitCode: deterministicResult.exitCode,\n\t\t\t\t\t\t\ttimedOut: deterministicResult.timedOut,\n\t\t\t\t\t\t\tstatus: deterministicResult.exitCode === 0 ? \"succeeded\" : \"failed\",\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t\treturn { changed: false };\n\t\t\t\t}\n\t\t\t\tdeterministicPreamble = deterministicPreambleText;\n\t\t\t} catch (error) {\n\t\t\t\tnotify(ctx, `Deterministic step failed: ${error instanceof Error ? error.message : String(error)}`, \"error\");\n\t\t\t\treturn \"aborted\";\n\t\t\t}\n\t\t}\n\n\t\tconst combinedTaskPreamble = [taskPreamble, deterministicPreamble].filter(Boolean).join(\"\\n\\n\");\n\n\t\tif (shouldDelegatePrompt(prompt, override)) {\n\t\t\ttry {\n\t\t\t\tconst delegated =\n\t\t\t\t\tprompt.parallel && prompt.parallel > 1\n\t\t\t\t\t\t? await executeSubagentPromptStep({\n\t\t\t\t\t\t\tpi,\n\t\t\t\t\t\t\tctx,\n\t\t\t\t\t\t\tcurrentModel,\n\t\t\t\t\t\t\toverride,\n\t\t\t\t\t\t\tsignal: ctx.signal,\n\t\t\t\t\t\t\tinheritedModel,\n\t\t\t\t\t\t\ttaskPreamble: combinedTaskPreamble || undefined,\n\t\t\t\t\t\t\tparallel: Array.from({ length: prompt.parallel }, (_, index) => ({\n\t\t\t\t\t\t\t\tprompt,\n\t\t\t\t\t\t\t\targs,\n\t\t\t\t\t\t\t\ttaskPrefix: `[Parallel subagent ${index + 1}/${prompt.parallel}]`,\n\t\t\t\t\t\t\t})),\n\t\t\t\t\t\t\tworktree: prompt.worktree === true,\n\t\t\t\t\t\t})\n\t\t\t\t\t\t: await executeSubagentPromptStep({\n\t\t\t\t\t\t\tpi,\n\t\t\t\t\t\t\tprompt,\n\t\t\t\t\t\t\targs,\n\t\t\t\t\t\t\tctx,\n\t\t\t\t\t\t\tcurrentModel,\n\t\t\t\t\t\t\toverride,\n\t\t\t\t\t\t\tsignal: ctx.signal,\n\t\t\t\t\t\t\tinheritedModel,\n\t\t\t\t\t\t\ttaskPreamble: combinedTaskPreamble || undefined,\n\t\t\t\t\t\t});\n\t\t\t\tif (!delegated) {\n\t\t\t\t\tnotify(ctx, `Prompt \\`${prompt.name}\\` is not configured for delegated execution.`, \"error\");\n\t\t\t\t\treturn \"aborted\";\n\t\t\t\t}\n\t\t\t\treturn { changed: delegated.changed, text: delegated.text };\n\t\t\t} catch (error) {\n\t\t\t\tnotify(ctx, error instanceof Error ? error.message : String(error), \"error\");\n\t\t\t\treturn { changed: false };\n\t\t\t}\n\t\t}\n\n\t\tconst prepared =\n\t\t\tinheritedModel === undefined\n\t\t\t\t? await preparePromptExecution(prompt, args, currentModel, ctx.modelRegistry)\n\t\t\t\t: await preparePromptExecution(prompt, args, currentModel, ctx.modelRegistry, { inheritedModel });\n\t\tif (!prepared) {\n\t\t\tnotify(ctx, `No available model from: ${prompt.models.join(\", \")}`, \"error\");\n\t\t\treturn \"aborted\";\n\t\t}\n\t\tif (\"message\" in prepared) {\n\t\t\tif (prepared.warning) notify(ctx, prepared.warning, \"warning\");\n\t\t\tnotify(ctx, prepared.message, \"error\");\n\t\t\treturn \"aborted\";\n\t\t}\n\t\tif (prepared.warning) {\n\t\t\tnotify(ctx, prepared.warning, \"warning\");\n\t\t}\n\n\t\tconst skillResolution = resolveSkillMessage(prompt.skill, ctx.cwd);\n\t\tif (skillResolution.kind === \"error\") {\n\t\t\tnotify(ctx, skillResolution.error, \"error\");\n\t\t\treturn \"aborted\";\n\t\t}\n\n\t\tif (!prepared.selectedModel.alreadyActive) {\n\t\t\tconst switched = await pi.setModel(prepared.selectedModel.model);\n\t\t\tif (!switched) {\n\t\t\t\tnotify(ctx, `Failed to switch to model ${prepared.selectedModel.model.provider}/${prepared.selectedModel.model.id}`, \"error\");\n\t\t\t\treturn \"aborted\";\n\t\t\t}\n\t\t\truntimeModel = prepared.selectedModel.model;\n\t\t}\n\n\t\tif (prompt.thinking) {\n\t\t\tpi.setThinkingLevel(prompt.thinking);\n\t\t}\n\t\tpendingSkillMessage = skillResolution.kind === \"ready\" ? skillResolution.message : undefined;\n\n\t\tif (promptTurnRestore) {\n\t\t\tconst currentModel = getCurrentModel(ctx);\n\t\t\tif (promptTurnRestore.originalModel && currentModel && !sameModel(promptTurnRestore.originalModel, currentModel)) {\n\t\t\t\tpreviousModel = promptTurnRestore.originalModel;\n\t\t\t\tpreviousThinking = promptTurnRestore.originalThinking;\n\t\t\t}\n\t\t\tif (prompt.thinking && previousThinking === undefined && prompt.thinking !== promptTurnRestore.originalThinking) {\n\t\t\t\tpreviousThinking = promptTurnRestore.originalThinking;\n\t\t\t}\n\t\t}\n\n\t\tconst startId = ctx.sessionManager.getLeafId();\n\t\tconst effectiveContent = combinedTaskPreamble\n\t\t\t? `${combinedTaskPreamble}\\n\\n${prepared.content}`\n\t\t\t: prepared.content;\n\t\tconst content = loopContext ? `[${loopContext}]\\n\\n${effectiveContent}` : effectiveContent;\n\t\tpi.sendUserMessage(content);\n\t\tawait waitForTurnStart(ctx);\n\t\tawait ctx.waitForIdle();\n\n\t\tconst entries = getIterationEntries(ctx, startId);\n\t\tif (wasIterationAborted(entries)) return \"aborted\";\n\t\treturn { changed: didIterationMakeChanges(entries) };\n\t}\n\n\tasync function restoreSessionState(\n\t\tctx: ExtensionContext,\n\t\toriginalModel: Model<any> | undefined,\n\t\toriginalThinking: ThinkingLevel | undefined,\n\t\tcurrentModel?: Model<any>,\n\t\tcurrentThinking?: ThinkingLevel,\n\t) {\n\t\tconst restoredParts: string[] = [];\n\t\tconst shouldRestoreThinking =\n\t\t\toriginalThinking !== undefined && (currentThinking === undefined || currentThinking !== originalThinking);\n\n\t\tif (originalModel && !sameModel(originalModel, currentModel)) {\n\t\t\tconst restoredModel = await pi.setModel(originalModel);\n\t\t\tif (restoredModel) {\n\t\t\t\truntimeModel = originalModel;\n\t\t\t\trestoredParts.push(originalModel.id);\n\t\t\t} else {\n\t\t\t\tnotify(ctx, `Failed to restore model ${originalModel.provider}/${originalModel.id}`, \"error\");\n\t\t\t}\n\t\t}\n\t\tif (shouldRestoreThinking) {\n\t\t\trestoredParts.push(`thinking:${originalThinking}`);\n\t\t\tpi.setThinkingLevel(originalThinking);\n\t\t}\n\t\tif (restoredParts.length > 0) {\n\t\t\tnotify(ctx, `Restored to ${restoredParts.join(\", \")}`, \"info\");\n\t\t}\n\t}\n\n\tasync function restoreAfterExecution(\n\t\tctx: ExtensionContext,\n\t\tshouldRestore: boolean,\n\t\toriginalModel: Model<any> | undefined,\n\t\toriginalThinking: ThinkingLevel | undefined,\n\t\tcurrentModel: Model<any> | undefined,\n\t\tcurrentThinking: ThinkingLevel | undefined,\n\t\terrorState: ExecutionErrorState,\n\t\tphase: \"loop\" | \"chain\",\n\t): Promise<ExecutionErrorState> {\n\t\tif (!shouldRestore) return errorState;\n\n\t\ttry {\n\t\t\tawait restoreSessionState(ctx, originalModel, originalThinking, currentModel, currentThinking);\n\t\t} catch (error) {\n\t\t\tif (errorState.hasError) {\n\t\t\t\tnotify(\n\t\t\t\t\tctx,\n\t\t\t\t\t`Failed to restore session state after ${phase} error: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t\t\"error\",\n\t\t\t\t);\n\t\t\t\treturn errorState;\n\t\t\t}\n\t\t\treturn { hasError: true, error };\n\t\t}\n\n\t\treturn errorState;\n\t}\n\n\tfunction notifyLoopCompletion(\n\t\tctx: ExtensionContext,\n\t\tcompletedIterations: number,\n\t\ttotalIterations: number | null,\n\t\teffectiveMax: number,\n\t\tconverged: boolean,\n\t\trequireMultipleIterations: boolean,\n\t) {\n\t\tif (converged) {\n\t\t\tconst convergedLabel = totalIterations !== null ? `${completedIterations}/${totalIterations}` : `${completedIterations}`;\n\t\t\tnotify(ctx, `Loop converged at ${convergedLabel} (no changes)`, \"info\");\n\t\t\treturn;\n\t\t}\n\n\t\tif (completedIterations === 0) return;\n\t\tif (requireMultipleIterations && effectiveMax <= 1) return;\n\n\t\tif (totalIterations !== null) {\n\t\t\tnotify(ctx, `Loop finished: ${completedIterations}/${totalIterations} iterations`, \"info\");\n\t\t\treturn;\n\t\t}\n\t\tif (completedIterations === effectiveMax) {\n\t\t\tnotify(ctx, `Loop finished: ${completedIterations} iterations (cap reached)`, \"info\");\n\t\t\treturn;\n\t\t}\n\t\tnotify(ctx, `Loop finished: ${completedIterations} iterations`, \"info\");\n\t}\n\n\tfunction updateLoopStatus(ctx: ExtensionContext) {\n\t\tif (!ctx.hasUI) return;\n\t\tif (loopState) {\n\t\t\tconst suffix = loopState.rotationLabel ? ` · ${loopState.rotationLabel}` : \"\";\n\t\t\tconst label =\n\t\t\t\tloopState.totalIterations !== null\n\t\t\t\t\t? `loop ${loopState.currentIteration}/${loopState.totalIterations}${suffix}`\n\t\t\t\t\t: `loop ${loopState.currentIteration}${suffix}`;\n\t\t\tctx.ui.setStatus(\"prompt-loop\", ctx.ui.theme.fg(\"warning\", label));\n\t\t} else {\n\t\t\tctx.ui.setStatus(\"prompt-loop\", undefined);\n\t\t}\n\t}\n\n\tasync function executeToolCommand(command: string, ctx: ExtensionCommandContext) {\n\t\tconst stripped = command.startsWith(\"/\") ? command.slice(1) : command;\n\t\tconst spaceIdx = stripped.indexOf(\" \");\n\t\tconst name = spaceIdx >= 0 ? stripped.slice(0, spaceIdx) : stripped;\n\t\tconst args = spaceIdx >= 0 ? stripped.slice(spaceIdx + 1) : \"\";\n\n\t\tif (name === \"chain-prompts\") {\n\t\t\tawait runChainCommand(args, ctx);\n\t\t} else {\n\t\t\tawait runPromptCommand(name, args, ctx);\n\t\t}\n\t}\n\n\tfunction cloneLineup(slots: DelegationLineupSlot[] | undefined): DelegationLineupSlot[] | undefined {\n\t\treturn slots?.map((slot) => ({ ...slot }));\n\t}\n\n\tfunction expandLineupCounts(slots: DelegationLineupSlot[]): DelegationLineupSlot[] {\n\t\tconst expanded: DelegationLineupSlot[] = [];\n\t\tfor (const slot of slots) {\n\t\t\tconst { count, ...concreteSlot } = slot;\n\t\t\tfor (let index = 0; index < (count ?? 1); index++) {\n\t\t\t\texpanded.push({ ...concreteSlot });\n\t\t\t}\n\t\t}\n\t\treturn expanded;\n\t}\n\n\tfunction applyLineupActions(\n\t\tdefaultSlots: DelegationLineupSlot[] | undefined,\n\t\tactions: LineupOverrideAction[],\n\t\ttarget: \"workers\" | \"reviewers\",\n\t): DelegationLineupSlot[] | undefined {\n\t\tlet lineup = cloneLineup(defaultSlots);\n\t\tfor (const action of actions) {\n\t\t\tif (action.target !== target) continue;\n\t\t\tconst incoming = action.slots.map((slot) => ({ ...slot }));\n\t\t\tlineup = action.mode === \"replace\" ? incoming : [...(lineup ?? []), ...incoming];\n\t\t}\n\t\treturn lineup;\n\t}\n\n\tfunction applyFinalApplierAction(\n\t\tdefaultSlot: DelegationLineupSlot | undefined,\n\t\tactions: LineupOverrideAction[],\n\t): DelegationLineupSlot | undefined {\n\t\tlet slot = defaultSlot ? { ...defaultSlot } : undefined;\n\t\tfor (const action of actions) {\n\t\t\tif (action.target !== \"finalApplier\") continue;\n\t\t\tslot = action.slots[0] ? { ...action.slots[0] } : undefined;\n\t\t}\n\t\treturn slot;\n\t}\n\n\tasync function resolveCompareBaseModel(\n\t\tprompt: PromptWithModel,\n\t\tcurrentModel: Model<any> | undefined,\n\t\tctx: ExtensionCommandContext,\n\t\tmodelOverride?: string,\n\t): Promise<Model<any> | undefined> {\n\t\tconst requestedModels = modelOverride ? [modelOverride] : prompt.models;\n\t\tif (requestedModels.length > 0) {\n\t\t\tconst selected = await selectModelCandidate(requestedModels, currentModel, ctx.modelRegistry);\n\t\t\tif (!selected) {\n\t\t\t\tnotify(ctx, `No available model from: ${requestedModels.join(\", \")}`, \"error\");\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn selected.model;\n\t\t}\n\t\tif (currentModel) return currentModel;\n\t\tnotify(ctx, `Prompt \\`${prompt.name}\\` requires an active model or a runtime --model override.`, \"error\");\n\t\treturn undefined;\n\t}\n\n\tfunction resolveCompareCwd(raw: string, ctx: ExtensionCommandContext): string {\n\t\treturn expandCwdPath(raw) ?? resolvePath(ctx.cwd, raw);\n\t}\n\n\tfunction normalizeLineupCwds(\n\t\tslots: DelegationLineupSlot[],\n\t\tdefaultCwd: string,\n\t\tctx: ExtensionCommandContext,\n\t): DelegationLineupSlot[] | undefined {\n\t\tconst normalized: DelegationLineupSlot[] = [];\n\t\tfor (const slot of slots) {\n\t\t\tconst slotCwd = slot.cwd ? resolveCompareCwd(slot.cwd, ctx) : defaultCwd;\n\t\t\tif (!existsSync(slotCwd)) {\n\t\t\t\tnotify(ctx, `cwd directory does not exist: ${slotCwd}`, \"error\");\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tnormalized.push({\n\t\t\t\t...slot,\n\t\t\t\tcwd: slotCwd,\n\t\t\t});\n\t\t}\n\t\treturn normalized;\n\t}\n\n\tfunction formatCompareSlotLabel(slot: DelegationLineupSlot, fallbackAgent: string): string {\n\t\treturn slot.model ? `${fallbackAgent}, ${slot.model}` : fallbackAgent;\n\t}\n\n\tfunction renderComparePhaseResults(\n\t\tlabel: string,\n\t\tentries: Array<{ index: number; slot: DelegationLineupSlot; result: DelegatedPromptParallelResult }>,\n\t): string {\n\t\treturn entries\n\t\t\t.map(({ index, slot, result }) => {\n\t\t\t\tconst body = result.text || \"(no assistant text)\";\n\t\t\t\treturn `=== ${label} ${index + 1} (${formatCompareSlotLabel(slot, result.agent)}) ===\\n${body}`;\n\t\t\t})\n\t\t\t.join(\"\\n\\n\");\n\t}\n\n\tfunction formatPhaseFailureSummary(\n\t\tlabel: string,\n\t\tentries: Array<{ index: number; slot: DelegationLineupSlot; result: DelegatedPromptParallelResult }>,\n\t): string | undefined {\n\t\tif (entries.length === 0) return undefined;\n\t\treturn [\n\t\t\t`[${label} failures]`,\n\t\t\t...entries.map(({ index, slot, result }) =>\n\t\t\t\t`- ${label} ${index + 1} (${formatCompareSlotLabel(slot, result.agent)}): ${result.errorText || \"unknown delegated error\"}`,\n\t\t\t),\n\t\t].join(\"\\n\");\n\t}\n\n\tfunction extractSuccessfulWorktreeChanges(aggregateText: string | undefined, successfulIndexes: number[]): string | undefined {\n\t\tif (!aggregateText) return undefined;\n\t\tconst marker = \"=== Worktree Changes ===\";\n\t\tconst markerIndex = aggregateText.indexOf(marker);\n\t\tif (markerIndex < 0) return undefined;\n\t\tconst worktreeText = aggregateText.slice(markerIndex + marker.length).trim();\n\t\tif (!worktreeText) return undefined;\n\t\tconst successfulTaskNumbers = new Set(successfulIndexes.map((index) => index + 1));\n\t\tconst sections = worktreeText\n\t\t\t.split(/\\n(?=--- Task \\d+ \\()/)\n\t\t\t.map((section) => section.trim())\n\t\t\t.filter(Boolean)\n\t\t\t.filter((section) => {\n\t\t\t\tconst match = section.match(/^--- Task (\\d+) \\(/);\n\t\t\t\treturn match ? successfulTaskNumbers.has(parseInt(match[1]!, 10)) : false;\n\t\t\t});\n\t\tif (sections.length === 0) return undefined;\n\t\treturn `${marker}\\n\\n${sections.join(\"\\n\\n\")}`;\n\t}\n\n\tfunction buildReviewerPreamble(sharedTask: string, workerAggregation: string, workerFailureSummary?: string): string {\n\t\treturn [\n\t\t\t\"[Original implementation task]\",\n\t\t\tsharedTask,\n\t\t\t\"\",\n\t\t\t\"[Worker outputs and worktree summaries]\",\n\t\t\tworkerAggregation,\n\t\t\t...(workerFailureSummary ? [\"\", workerFailureSummary] : []),\n\t\t].join(\"\\n\");\n\t}\n\n\tfunction buildFinalApplierPreamble(\n\t\tsharedTask: string,\n\t\tworkerAggregation: string,\n\t\tworkerFailureSummary?: string,\n\t\treviewerAggregation?: string,\n\t\treviewerFailureSummary?: string,\n\t): string {\n\t\treturn [\n\t\t\t\"[Original implementation task]\",\n\t\t\tsharedTask,\n\t\t\t\"\",\n\t\t\t\"[Worker outputs and worktree summaries]\",\n\t\t\tworkerAggregation,\n\t\t\t...(workerFailureSummary ? [\"\", workerFailureSummary] : []),\n\t\t\t\"\",\n\t\t\t\"[Reviewer findings]\",\n\t\t\treviewerAggregation ?? \"All reviewer runs failed. Synthesize directly from the worker variants.\",\n\t\t\t...(reviewerFailureSummary ? [\"\", reviewerFailureSummary] : []),\n\t\t\t\"\",\n\t\t\t\"[Final apply instructions]\",\n\t\t\t\"Pick one winner or synthesize/cherry-pick from multiple variants, apply the final patch directly in the current repo, keep edits minimal, run obvious relevant verification when practical, and report changed files plus verification run.\",\n\t\t].join(\"\\n\");\n\t}\n\n\tfunction buildLineupSlotTask(\n\t\tbaseTask: string,\n\t\tslot: DelegationLineupSlot,\n\t\ttaskArgs: string[],\n\t): string {\n\t\tconst effectiveBaseTask = slot.task ? substituteArgs(slot.task, taskArgs) : baseTask;\n\t\tif (!slot.taskSuffix) return effectiveBaseTask;\n\t\treturn `${effectiveBaseTask}\\n\\n${substituteArgs(slot.taskSuffix, taskArgs)}`;\n\t}\n\n\tfunction buildComparePrompt(\n\t\tbase: PromptWithModel,\n\t\toptions: {\n\t\t\tname: string;\n\t\t\tagent: string;\n\t\t\ttask: string;\n\t\t\tmodel?: string;\n\t\t\tcwd: string;\n\t\t\tinheritContext?: boolean;\n\t\t},\n\t): PromptWithModel {\n\t\treturn {\n\t\t\t...base,\n\t\t\tname: options.name,\n\t\t\tcontent: options.task,\n\t\t\tmodels: options.model ? [options.model] : [],\n\t\t\tchain: undefined,\n\t\t\tchainContext: undefined,\n\t\t\tparallel: undefined,\n\t\t\tworktree: undefined,\n\t\t\tsubagent: options.agent,\n\t\t\tinheritContext: options.inheritContext ? true : undefined,\n\t\t\tcwd: options.cwd,\n\t\t\tworkers: undefined,\n\t\t\treviewers: undefined,\n\t\t\tfinalApplier: undefined,\n\t\t};\n\t}\n\n\tasync function runComparePrompt(\n\t\tname: string,\n\t\tprompt: PromptWithModel,\n\t\targs: string,\n\t\tctx: ExtensionCommandContext,\n\t\tcurrentModel: Model<any> | undefined,\n\t\truntime: { cwd?: string; model?: string; subagentOverride?: SubagentOverride; fork?: boolean },\n\t) {\n\t\tif (runtime.subagentOverride) {\n\t\t\tnotify(ctx, `--subagent is not supported for compare prompts (ignored)`, \"warning\");\n\t\t}\n\t\tif (runtime.fork) {\n\t\t\tnotify(ctx, `--fork is not supported for compare prompts (ignored)`, \"warning\");\n\t\t}\n\n\t\tconst lineupExtraction = extractLineupOverrides(args);\n\t\tif (lineupExtraction.errors.length > 0) {\n\t\t\tfor (const error of lineupExtraction.errors) {\n\t\t\t\tnotify(ctx, error, \"error\");\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tlet taskArgs = parseCommandArgs(lineupExtraction.args);\n\t\tlet compareCwd = runtime.cwd ?? prompt.cwd ?? ctx.cwd;\n\t\tif (name === \"parallel-patch-compare-at-path\") {\n\t\t\tif (taskArgs.length === 0) {\n\t\t\t\tnotify(ctx, \"parallel-patch-compare-at-path requires a repo path as the first argument.\", \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (runtime.cwd) {\n\t\t\t\tnotify(ctx, \"--cwd is ignored for parallel-patch-compare-at-path (using first positional path).\", \"warning\");\n\t\t\t}\n\t\t\tcompareCwd = resolveCompareCwd(taskArgs[0]!, ctx);\n\t\t\ttaskArgs = taskArgs.slice(1);\n\t\t\tif (taskArgs.length === 0) {\n\t\t\t\tnotify(ctx, \"parallel-patch-compare-at-path requires an implementation task after the repo path.\", \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\tif (!existsSync(compareCwd)) {\n\t\t\tnotify(ctx, `cwd directory does not exist: ${compareCwd}`, \"error\");\n\t\t\treturn;\n\t\t}\n\n\t\tconst baseModel = await resolveCompareBaseModel(prompt, currentModel, ctx, runtime.model);\n\t\tif (!baseModel) return;\n\n\t\tconst rendered = renderPromptForResolvedModel(prompt, taskArgs, baseModel);\n\t\tif (rendered.warning) notify(ctx, rendered.warning, \"warning\");\n\t\tif (rendered.empty || !rendered.content) {\n\t\t\tnotify(ctx, rendered.empty ?? `Prompt \\`${prompt.name}\\` rendered to an empty message.`, \"error\");\n\t\t\treturn;\n\t\t}\n\t\tconst sharedTask = rendered.content;\n\n\t\tconst requestedWorkers = applyLineupActions(prompt.workers, lineupExtraction.actions, \"workers\") ?? [];\n\t\tconst requestedReviewers = applyLineupActions(prompt.reviewers, lineupExtraction.actions, \"reviewers\") ?? [];\n\t\tconst requestedFinalApplier = applyFinalApplierAction(prompt.finalApplier, lineupExtraction.actions);\n\t\tif (requestedFinalApplier && prompt.worktree !== true) {\n\t\t\tnotify(ctx, \"Compare prompts with finalApplier require worktree: true.\", \"error\");\n\t\t\treturn;\n\t\t}\n\n\t\tconst workerSlots = expandLineupCounts(\n\t\t\trequestedWorkers.length > 0\n\t\t\t\t? requestedWorkers\n\t\t\t\t: [{ agent: DEFAULT_SUBAGENT_NAME }],\n\t\t);\n\t\tconst reviewerSlots = expandLineupCounts(\n\t\t\trequestedReviewers.length > 0\n\t\t\t\t? requestedReviewers\n\t\t\t\t: [{ agent: \"reviewer\" }],\n\t\t);\n\n\t\tconst normalizedWorkers = normalizeLineupCwds(workerSlots, compareCwd, ctx);\n\t\tif (!normalizedWorkers) return;\n\t\tconst normalizedReviewers = normalizeLineupCwds(reviewerSlots, compareCwd, ctx);\n\t\tif (!normalizedReviewers) return;\n\t\tconst normalizedFinalApplier = requestedFinalApplier\n\t\t\t? {\n\t\t\t\t...requestedFinalApplier,\n\t\t\t\tcwd: compareCwd,\n\t\t\t}\n\t\t\t: undefined;\n\n\t\tif (prompt.worktree === true) {\n\t\t\tconst uniqueWorkerCwds = new Set(normalizedWorkers.map((slot) => slot.cwd));\n\t\t\tif (uniqueWorkerCwds.size > 1) {\n\t\t\t\tnotify(ctx, \"worktree compare runs require all worker slots to use the same cwd.\", \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\ttry {\n\t\t\tconst workerResult = await executeSubagentPromptStep({\n\t\t\t\tpi,\n\t\t\t\tctx,\n\t\t\t\tcurrentModel: baseModel,\n\t\t\t\tsignal: ctx.signal,\n\t\t\t\tworktree: prompt.worktree === true,\n\t\t\t\tallowPartialFailures: true,\n\t\t\t\tparallel: normalizedWorkers.map((slot, index) => ({\n\t\t\t\t\tprompt: buildComparePrompt(prompt, {\n\t\t\t\t\t\tname: `${prompt.name}-worker-${index + 1}`,\n\t\t\t\t\t\tagent: slot.agent,\n\t\t\t\t\t\ttask: buildLineupSlotTask(sharedTask, slot, taskArgs),\n\t\t\t\t\t\tmodel: slot.model,\n\t\t\t\t\t\tcwd: slot.cwd!,\n\t\t\t\t\t\tinheritContext: true,\n\t\t\t\t\t}),\n\t\t\t\t\targs: [],\n\t\t\t\t})),\n\t\t\t});\n\t\t\tconst workerPairs = (workerResult?.parallelResults ?? []).map((result, index) => ({\n\t\t\t\tindex,\n\t\t\t\tslot: normalizedWorkers[index]!,\n\t\t\t\tresult,\n\t\t\t}));\n\t\t\tif (workerPairs.length === 0) return;\n\t\t\tconst successfulWorkers = workerPairs.filter((entry) => !entry.result.isError);\n\t\t\tconst failedWorkers = workerPairs.filter((entry) => entry.result.isError);\n\t\t\tif (successfulWorkers.length === 0) {\n\t\t\t\tnotify(ctx, `Compare worker phase failed: all worker slots failed.`, \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst successfulWorkerText = [\n\t\t\t\trenderComparePhaseResults(\"Worker\", successfulWorkers),\n\t\t\t\textractSuccessfulWorktreeChanges(workerResult.text, successfulWorkers.map((entry) => entry.index)),\n\t\t\t]\n\t\t\t\t.filter((value): value is string => Boolean(value))\n\t\t\t\t.join(\"\\n\\n\");\n\t\t\tconst workerFailureSummary = formatPhaseFailureSummary(\"Worker\", failedWorkers);\n\n\t\t\tconst reviewerPreamble = buildReviewerPreamble(sharedTask, successfulWorkerText, workerFailureSummary);\n\t\t\tconst reviewerResult = await executeSubagentPromptStep({\n\t\t\t\tpi,\n\t\t\t\tctx,\n\t\t\t\tcurrentModel: baseModel,\n\t\t\t\tsignal: ctx.signal,\n\t\t\t\ttaskPreamble: reviewerPreamble,\n\t\t\t\tallowPartialFailures: true,\n\t\t\t\tparallel: normalizedReviewers.map((slot, index) => ({\n\t\t\t\t\tprompt: buildComparePrompt(prompt, {\n\t\t\t\t\t\tname: `${prompt.name}-reviewer-${index + 1}`,\n\t\t\t\t\t\tagent: slot.agent,\n\t\t\t\t\t\ttask: buildLineupSlotTask(DEFAULT_COMPARE_REVIEWER_TASK, slot, taskArgs),\n\t\t\t\t\t\tmodel: slot.model,\n\t\t\t\t\t\tcwd: slot.cwd!,\n\t\t\t\t\t\tinheritContext: false,\n\t\t\t\t\t}),\n\t\t\t\t\targs: [],\n\t\t\t\t})),\n\t\t\t});\n\t\t\tconst reviewerPairs = (reviewerResult?.parallelResults ?? []).map((result, index) => ({\n\t\t\t\tindex,\n\t\t\t\tslot: normalizedReviewers[index]!,\n\t\t\t\tresult,\n\t\t\t}));\n\t\t\tif (reviewerPairs.length === 0) return;\n\t\t\tconst successfulReviewers = reviewerPairs.filter((entry) => !entry.result.isError);\n\t\t\tconst failedReviewers = reviewerPairs.filter((entry) => entry.result.isError);\n\t\t\tconst successfulReviewerText = successfulReviewers.length > 0\n\t\t\t\t? renderComparePhaseResults(\"Reviewer\", successfulReviewers)\n\t\t\t\t: undefined;\n\t\t\tconst reviewerFailureSummary = formatPhaseFailureSummary(\"Reviewer\", failedReviewers);\n\n\t\t\tif (!normalizedFinalApplier) {\n\t\t\t\tif (!successfulReviewerText) {\n\t\t\t\t\tnotify(ctx, `Compare reviewer phase failed: all reviewer slots failed.`, \"error\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst finalText = reviewerFailureSummary\n\t\t\t\t\t? `${successfulReviewerText}\\n\\n${reviewerFailureSummary}`\n\t\t\t\t\t: successfulReviewerText;\n\t\t\t\tpi.sendUserMessage(`[Compare review complete: ${name}]\\n\\n${finalText}`);\n\t\t\t\tawait waitForTurnStart(ctx);\n\t\t\t\tawait ctx.waitForIdle();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst finalResult = await executeSubagentPromptStep({\n\t\t\t\tpi,\n\t\t\t\tctx,\n\t\t\t\tcurrentModel: baseModel,\n\t\t\t\tsignal: ctx.signal,\n\t\t\t\ttaskPreamble: buildFinalApplierPreamble(\n\t\t\t\t\tsharedTask,\n\t\t\t\t\tsuccessfulWorkerText,\n\t\t\t\t\tworkerFailureSummary,\n\t\t\t\t\tsuccessfulReviewerText,\n\t\t\t\t\treviewerFailureSummary,\n\t\t\t\t),\n\t\t\t\tprompt: buildComparePrompt(prompt, {\n\t\t\t\t\tname: `${prompt.name}-final-applier`,\n\t\t\t\t\tagent: normalizedFinalApplier.agent,\n\t\t\t\t\ttask: buildLineupSlotTask(DEFAULT_COMPARE_FINAL_APPLIER_TASK, normalizedFinalApplier, taskArgs),\n\t\t\t\t\tmodel: normalizedFinalApplier.model,\n\t\t\t\t\tcwd: compareCwd,\n\t\t\t\t\tinheritContext: false,\n\t\t\t\t}),\n\t\t\t\targs: [],\n\t\t\t});\n\t\t\tif (!finalResult?.text) return;\n\t\t\tpi.sendUserMessage(`[Compare apply complete: ${name}]\\n\\n${finalResult.text}`);\n\t\t\tawait waitForTurnStart(ctx);\n\t\t\tawait ctx.waitForIdle();\n\t\t} catch (error) {\n\t\t\tnotify(ctx, error instanceof Error ? error.message : String(error), \"error\");\n\t\t}\n\t}\n\n\tasync function collapseBoomerangPrompt(\n\t\tctx: ExtensionContext,\n\t\tname: string,\n\t\ttargetId: string | null,\n\t\tpreviousSummaries: string[] = [],\n\t) {\n\t\tif (!targetId) {\n\t\t\tnotify(ctx, `Cannot boomerang prompt \\`${name}\\`: no session entry to return to.`, \"warning\");\n\t\t\treturn;\n\t\t}\n\n\t\tboomerangCollapse = { targetId, task: name, previousSummaries };\n\t\ttry {\n\t\t\t(globalThis as typeof globalThis & { __boomerangCollapseInProgress?: boolean }).__boomerangCollapseInProgress = true;\n\t\t\tconst result = await ctx.navigateTree(targetId, { summarize: true });\n\t\t\tif (result.cancelled) notify(ctx, `Boomerang cancelled for prompt \\`${name}\\``, \"warning\");\n\t\t} finally {\n\t\t\t(globalThis as typeof globalThis & { __boomerangCollapseInProgress?: boolean }).__boomerangCollapseInProgress = false;\n\t\t\tboomerangCollapse = null;\n\t\t}\n\t}\n\n\tasync function runPromptLoop(\n\t\tname: string,\n\t\tcleanedArgs: string,\n\t\ttotalIterations: number | null,\n\t\tfreshFlag: boolean,\n\t\tconverge: boolean,\n\t\tctx: ExtensionCommandContext,\n\t\tsubagentOverride?: SubagentOverride,\n\t\tcwdOverride?: string,\n\t\tpromptOverrides?: Partial<Pick<PromptWithModel, \"models\" | \"inheritContext\">>,\n\t) {\n\t\trefreshPrompts(ctx.cwd, ctx);\n\t\tconst initialPrompt = prompts.get(name);\n\t\tif (!initialPrompt) {\n\t\t\tnotify(ctx, `Prompt \"${name}\" no longer exists`, \"error\");\n\t\t\treturn;\n\t\t}\n\n\t\tconst savedModel = getCurrentModel(ctx);\n\t\tconst savedThinking = pi.getThinkingLevel();\n\t\tlet currentModel = savedModel;\n\t\tlet currentThinking = savedThinking;\n\t\tconst shouldRestore = initialPrompt.restore;\n\t\tconst useFresh = freshFlag || initialPrompt.fresh === true;\n\t\tconst shouldBoomerang = initialPrompt.boomerang === true;\n\t\tconst effectiveMax = totalIterations ?? UNLIMITED_LOOP_CAP;\n\t\tconst isUnlimited = totalIterations === null;\n\t\tconst useConverge = converge && initialPrompt.converge !== false;\n\t\tconst anchorId = useFresh || shouldBoomerang ? ctx.sessionManager.getLeafId() : null;\n\n\t\tloopState = { currentIteration: 1, totalIterations };\n\t\taccumulatedSummaries = [];\n\t\tupdateLoopStatus(ctx);\n\t\tlet completedIterations = 0;\n\t\tlet converged = false;\n\t\tlet loopErrorState: ExecutionErrorState = { hasError: false, error: undefined };\n\t\tlet lastDelegatedText: string | undefined;\n\t\tlet loopAborted = false;\n\t\tlet boomerangPreviousSummaries: string[] = [];\n\n\t\ttry {\n\t\t\tfor (let i = 0; i < effectiveMax; i++) {\n\t\t\t\tloopState.currentIteration = i + 1;\n\t\t\t\tconst iterationLabel = totalIterations !== null ? `${i + 1}/${totalIterations}` : `${i + 1}`;\n\n\t\t\t\trefreshPrompts(ctx.cwd, ctx);\n\t\t\t\tconst prompt = prompts.get(name);\n\t\t\t\tif (!prompt) {\n\t\t\t\t\tnotify(ctx, `Prompt \"${name}\" no longer exists`, \"error\");\n\t\t\t\t\tloopAborted = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tconst effectivePrompt = { ...prompt, ...(cwdOverride ? { cwd: cwdOverride } : {}), ...promptOverrides };\n\t\t\t\tlet iterationPrompt = effectivePrompt;\n\t\t\t\tloopState!.rotationLabel = undefined;\n\t\t\t\tif (effectivePrompt.rotate && effectivePrompt.models.length > 1) {\n\t\t\t\t\tconst rotationIndex = i % effectivePrompt.models.length;\n\t\t\t\t\tconst rotatedThinking = effectivePrompt.thinkingLevels\n\t\t\t\t\t\t? effectivePrompt.thinkingLevels[rotationIndex]\n\t\t\t\t\t\t: effectivePrompt.thinking;\n\t\t\t\t\titerationPrompt = {\n\t\t\t\t\t\t...effectivePrompt,\n\t\t\t\t\t\tmodels: [effectivePrompt.models[rotationIndex]],\n\t\t\t\t\t\tthinking: rotatedThinking,\n\t\t\t\t\t};\n\t\t\t\t\tconst shortModel = effectivePrompt.models[rotationIndex].split(\"/\").pop() || effectivePrompt.models[rotationIndex];\n\t\t\t\t\tconst thinkingLabel = rotatedThinking ? ` ${rotatedThinking}` : \"\";\n\t\t\t\t\tloopState!.rotationLabel = `${shortModel}${thinkingLabel}`;\n\t\t\t\t}\n\t\t\t\tupdateLoopStatus(ctx);\n\t\t\t\tconst rotationSuffix = loopState!.rotationLabel ? ` [${loopState!.rotationLabel}]` : \"\";\n\t\t\t\tnotify(ctx, `Loop ${iterationLabel}: ${name}${rotationSuffix}`, \"info\");\n\n\t\t\t\tconst loopContext = loopState!.rotationLabel\n\t\t\t\t\t? `Loop ${iterationLabel} · ${loopState!.rotationLabel}`\n\t\t\t\t\t: `Loop ${iterationLabel}`;\n\t\t\t\tconst iterationStartId = ctx.sessionManager.getLeafId();\n\t\t\t\tconst stepResult = await executePromptStep(\n\t\t\t\t\titerationPrompt,\n\t\t\t\t\tparseCommandArgs(cleanedArgs),\n\t\t\t\t\tctx,\n\t\t\t\t\tcurrentModel,\n\t\t\t\t\tsubagentOverride,\n\t\t\t\t\tundefined,\n\t\t\t\t\tundefined,\n\t\t\t\t\tloopContext,\n\t\t\t\t);\n\t\t\t\tif (stepResult === \"aborted\") {\n\t\t\t\t\tloopAborted = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tconst delegatedStep = shouldDelegatePrompt(iterationPrompt, subagentOverride);\n\t\t\t\tif (delegatedStep) {\n\t\t\t\t\tlastDelegatedText = stepResult.text;\n\t\t\t\t}\n\n\t\t\t\tcurrentModel = getCurrentModel(ctx);\n\t\t\t\tcurrentThinking = pi.getThinkingLevel();\n\t\t\t\tcompletedIterations++;\n\n\t\t\t\tconst iterationChanged = delegatedStep\n\t\t\t\t\t? stepResult.changed\n\t\t\t\t\t: didIterationMakeChanges(getIterationEntries(ctx, iterationStartId));\n\t\t\t\tif (useConverge && (isUnlimited || effectiveMax > 1) && !iterationChanged) {\n\t\t\t\t\tconverged = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (useFresh && anchorId && i < effectiveMax - 1) {\n\t\t\t\t\tfreshCollapse = { targetId: anchorId, task: name, iteration: i + 1, totalIterations };\n\t\t\t\t\tconst result = await ctx.navigateTree(anchorId, { summarize: true });\n\t\t\t\t\tfreshCollapse = null;\n\t\t\t\t\tif (result.cancelled) {\n\t\t\t\t\t\tloopAborted = true;\n\t\t\t\t\t\tnotify(ctx, \"Loop cancelled\", \"warning\");\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tloopErrorState = { hasError: true, error };\n\t\t} finally {\n\t\t\tloopErrorState = await restoreAfterExecution(\n\t\t\t\tctx,\n\t\t\t\tshouldRestore,\n\t\t\t\tsavedModel,\n\t\t\t\tsavedThinking,\n\t\t\t\tgetCurrentModel(ctx),\n\t\t\t\tpi.getThinkingLevel(),\n\t\t\t\tloopErrorState,\n\t\t\t\t\"loop\",\n\t\t\t);\n\n\t\t\tboomerangPreviousSummaries = accumulatedSummaries;\n\t\t\tloopState = null;\n\t\t\tpendingSkillMessage = undefined;\n\t\t\tfreshCollapse = null;\n\t\t\tboomerangCollapse = null;\n\t\t\taccumulatedSummaries = [];\n\t\t\tupdateLoopStatus(ctx);\n\n\t\t\tif (!loopErrorState.hasError) {\n\t\t\t\tnotifyLoopCompletion(ctx, completedIterations, totalIterations, effectiveMax, converged, false);\n\t\t\t}\n\t\t}\n\n\t\tif (lastDelegatedText && !loopErrorState.hasError && !loopAborted) {\n\t\t\tconst label = converged\n\t\t\t\t? `Delegated loop converged after ${completedIterations} iteration(s): ${name}`\n\t\t\t\t: `Delegated loop completed ${completedIterations} iteration(s): ${name}`;\n\t\t\tpi.sendUserMessage(`[${label}]\\n\\n${lastDelegatedText}`);\n\t\t\tawait waitForTurnStart(ctx);\n\t\t\tawait ctx.waitForIdle();\n\t\t}\n\n\t\tif (!loopErrorState.hasError && !loopAborted && shouldBoomerang) {\n\t\t\tawait collapseBoomerangPrompt(ctx, name, anchorId, boomerangPreviousSummaries);\n\t\t}\n\n\t\tif (loopErrorState.hasError) {\n\t\t\tthrow loopErrorState.error;\n\t\t}\n\t}\n\n\tasync function runSharedChainExecution(\n\t\tsteps: ChainStepOrParallel[],\n\t\tsharedArgs: string[],\n\t\ttotalIterations: number | null,\n\t\tfresh: boolean,\n\t\tconverge: boolean,\n\t\tshouldRestore: boolean,\n\t\tctx: ExtensionCommandContext,\n\t\tsubagentOverride?: SubagentOverride,\n\t\tcwdOverride?: string,\n\t\tchainContextEnabled = false,\n\t\tchainTemplateWorktree = false,\n\t\tcliWorktree = false,\n\t) {\n\t\tlet worktreeEnabled = chainTemplateWorktree || cliWorktree;\n\t\tif (worktreeEnabled && !steps.some(isParallelChainStep)) {\n\t\t\tnotify(ctx, `--worktree ignored: chain has no parallel() steps`, \"warning\");\n\t\t\tworktreeEnabled = false;\n\t\t}\n\t\tconst flattenChainSteps = (): ChainStep[] => {\n\t\t\tconst flattened: ChainStep[] = [];\n\t\t\tfor (const step of steps) {\n\t\t\t\tif (isParallelChainStep(step)) {\n\t\t\t\t\tflattened.push(...step.parallel);\n\t\t\t\t} else {\n\t\t\t\t\tflattened.push(step);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn flattened;\n\t\t};\n\n\t\tconst validateChainSteps = (): boolean => {\n\t\t\tconst flattened = flattenChainSteps();\n\t\t\tconst missingTemplates = flattened.filter((step) => !chainPrompts.has(step.name));\n\t\t\tif (missingTemplates.length > 0) {\n\t\t\t\tnotify(ctx, `Templates not found: ${missingTemplates.map((step) => step.name).join(\", \")}`, \"error\");\n\t\t\t\treturn false;\n\t\t\t}\n\n\t\t\tfor (const step of steps) {\n\t\t\t\tif (isParallelChainStep(step)) {\n\t\t\t\t\tfor (const parallelStep of step.parallel) {\n\t\t\t\t\t\tif (parallelStep.loopCount !== undefined) {\n\t\t\t\t\t\t\tnotify(ctx, `Step \"${parallelStep.name}\" in parallel() does not support per-task --loop.`, \"error\");\n\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (parallelStep.withContext === true) {\n\t\t\t\t\t\t\tnotify(ctx, `Step \"${parallelStep.name}\" in parallel() does not support per-task --with-context.`, \"error\");\n\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst stepPrompt = chainPrompts.get(parallelStep.name);\n\t\t\t\t\t\tif (!stepPrompt) continue;\n\t\t\t\t\t\tif (stepPrompt.chain) {\n\t\t\t\t\t\t\tnotify(ctx, `Step \"${parallelStep.name}\" is a chain template. Chain nesting is not supported.`, \"error\");\n\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (!shouldDelegatePrompt(stepPrompt, subagentOverride)) {\n\t\t\t\t\t\t\tnotify(ctx, `Step \"${parallelStep.name}\" in parallel() must use delegated execution (subagent).`, \"error\");\n\t\t\t\t\t\t\treturn false;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tconst stepPrompt = chainPrompts.get(step.name);\n\t\t\t\tif (!stepPrompt) continue;\n\t\t\t\tif (stepPrompt.chain) {\n\t\t\t\t\tnotify(ctx, `Step \"${step.name}\" is a chain template. Chain nesting is not supported.`, \"error\");\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn true;\n\t\t};\n\n\t\tif (!validateChainSteps()) return;\n\n\t\tconst originalModel = getCurrentModel(ctx);\n\t\tconst chainInheritedModel = originalModel;\n\t\tconst originalThinking = pi.getThinkingLevel();\n\t\tlet currentModel = originalModel;\n\t\tlet currentThinking = originalThinking;\n\t\tchainActive = true;\n\t\tpendingSkillMessage = undefined;\n\t\tconst effectiveMax = totalIterations ?? UNLIMITED_LOOP_CAP;\n\t\tconst isUnlimited = totalIterations === null;\n\t\tconst useConverge = converge;\n\n\t\tconst anchorId = fresh ? ctx.sessionManager.getLeafId() : null;\n\t\tconst chainStepNames = steps\n\t\t\t.map((step) => (isParallelChainStep(step) ? `parallel(${step.parallel.map((item) => item.name).join(\", \")})` : step.name))\n\t\t\t.join(\" -> \");\n\t\tlet completedIterations = 0;\n\t\tlet converged = false;\n\t\tlet chainErrorState: ExecutionErrorState = { hasError: false, error: undefined };\n\t\tlet lastDelegatedText: string | undefined;\n\t\tlet chainAborted = false;\n\t\tif (effectiveMax > 1) {\n\t\t\tloopState = { currentIteration: 1, totalIterations };\n\t\t\taccumulatedSummaries = [];\n\t\t\tupdateLoopStatus(ctx);\n\t\t}\n\n\t\ttry {\n\t\t\tfor (let iteration = 0; iteration < effectiveMax; iteration++) {\n\t\t\t\tif (effectiveMax > 1) {\n\t\t\t\t\tloopState!.currentIteration = iteration + 1;\n\t\t\t\t\tupdateLoopStatus(ctx);\n\t\t\t\t\trefreshPrompts(ctx.cwd, ctx);\n\t\t\t\t\tif (!validateChainSteps()) {\n\t\t\t\t\t\tchainAborted = true;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tconst templates = steps.map((step) =>\n\t\t\t\t\tisParallelChainStep(step)\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\tkind: \"parallel\" as const,\n\t\t\t\t\t\t\ttasks: step.parallel.map((item) => ({\n\t\t\t\t\t\t\t\tname: item.name,\n\t\t\t\t\t\t\t\targs: item.args,\n\t\t\t\t\t\t\t\tprompt: {\n\t\t\t\t\t\t\t\t\t...chainPrompts.get(item.name)!,\n\t\t\t\t\t\t\t\t\t...(cwdOverride ? { cwd: cwdOverride } : {}),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t})),\n\t\t\t\t\t\t}\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\tkind: \"single\" as const,\n\t\t\t\t\t\t\tsingleStep: {\n\t\t\t\t\t\t\t\tprompt: {\n\t\t\t\t\t\t\t\t\t...chainPrompts.get(step.name)!,\n\t\t\t\t\t\t\t\t\t...(cwdOverride ? { cwd: cwdOverride } : {}),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tstepArgs: step.args,\n\t\t\t\t\t\t\t\tstepLoop: step.loopCount !== undefined ? step.loopCount : 1,\n\t\t\t\t\t\t\t\tstepWithContext: step.withContext === true,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t);\n\t\t\t\tconst chainStepSummaries: string[] = [];\n\t\t\t\tlet aborted = false;\n\t\t\t\tlet iterationChanged = false;\n\t\t\t\tlet loopPrefix = \"\";\n\t\t\t\tif (effectiveMax > 1) {\n\t\t\t\t\tconst label = totalIterations !== null ? `${iteration + 1}/${totalIterations}` : `${iteration + 1}`;\n\t\t\t\t\tloopPrefix = `Loop ${label}, `;\n\t\t\t\t}\n\n\t\t\t\tfor (const [index, stepTemplate] of templates.entries()) {\n\t\t\t\t\tconst stepNumber = index + 1;\n\t\t\t\t\tif (stepTemplate.kind === \"parallel\") {\n\t\t\t\t\t\tconst stepNames = stepTemplate.tasks.map((task) => task.name).join(\", \");\n\t\t\t\t\t\tconst stepLabel = `parallel(${stepNames})`;\n\t\t\t\t\t\tnotify(ctx, `${loopPrefix}Step ${stepNumber}/${templates.length}: parallel(${stepNames})`, \"info\");\n\t\t\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\t\t\tctx.ui.setStatus(\"prompt-chain\", ctx.ui.theme.fg(\"warning\", `step ${stepNumber}/${templates.length}: parallel(${stepNames})`));\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst stepStartId = ctx.sessionManager.getLeafId();\n\t\t\t\t\t\tlet taskPreamble: string | undefined;\n\t\t\t\t\t\tconst isForkedParallelContext = stepTemplate.tasks.some((task) => task.prompt.inheritContext === true);\n\t\t\t\t\t\tif (chainContextEnabled && !isForkedParallelContext && chainStepSummaries.length > 0) {\n\t\t\t\t\t\t\ttaskPreamble = `[Previous chain steps]\\n\\n${chainStepSummaries.join(\"\\n\\n\")}`;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tlet delegated;\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\tdelegated = await executeSubagentPromptStep({\n\t\t\t\t\t\t\t\tpi,\n\t\t\t\t\t\t\t\tctx,\n\t\t\t\t\t\t\t\tcurrentModel,\n\t\t\t\t\t\t\t\toverride: subagentOverride,\n\t\t\t\t\t\t\t\tsignal: ctx.signal,\n\t\t\t\t\t\t\t\tinheritedModel: chainInheritedModel,\n\t\t\t\t\t\t\t\tparallel: stepTemplate.tasks.map((task) => ({\n\t\t\t\t\t\t\t\t\tprompt: task.prompt,\n\t\t\t\t\t\t\t\t\targs: task.args.length > 0 ? task.args : sharedArgs,\n\t\t\t\t\t\t\t\t})),\n\t\t\t\t\t\t\t\ttaskPreamble,\n\t\t\t\t\t\t\t\tworktree: worktreeEnabled,\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tnotify(ctx, error instanceof Error ? error.message : String(error), \"error\");\n\t\t\t\t\t\t\taborted = true;\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (!delegated) {\n\t\t\t\t\t\t\tnotify(ctx, \"Parallel chain step was not delegated.\", \"error\");\n\t\t\t\t\t\t\taborted = true;\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tlastDelegatedText = delegated.text;\n\n\t\t\t\t\t\tcurrentModel = getCurrentModel(ctx);\n\t\t\t\t\t\tcurrentThinking = pi.getThinkingLevel();\n\t\t\t\t\t\tconst stepEntries = getIterationEntries(ctx, stepStartId);\n\t\t\t\t\t\tif (delegated.changed) iterationChanged = true;\n\t\t\t\t\t\tchainStepSummaries.push(generateChainStepSummary(stepEntries, stepLabel, stepNumber));\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst singleStep = stepTemplate.singleStep;\n\t\t\t\t\tconst stepLoopTotal = singleStep.stepLoop;\n\t\t\t\t\tconst stepLoopMax = stepLoopTotal ?? UNLIMITED_LOOP_CAP;\n\t\t\t\t\tconst isStepLooping = stepLoopMax > 1;\n\t\t\t\t\tconst effectiveArgs = singleStep.stepArgs.length > 0 ? singleStep.stepArgs : sharedArgs;\n\t\t\t\t\tconst shouldInjectSummary =\n\t\t\t\t\t\tshouldDelegatePrompt(singleStep.prompt, subagentOverride) &&\n\t\t\t\t\t\tsingleStep.prompt.inheritContext !== true &&\n\t\t\t\t\t\t(chainContextEnabled || singleStep.stepWithContext === true);\n\t\t\t\t\tconst outerLoopState = loopState ? { ...loopState } : null;\n\t\t\t\t\tconst stepStartId = ctx.sessionManager.getLeafId();\n\t\t\t\t\tif (isStepLooping) {\n\t\t\t\t\t\tloopState = { currentIteration: 1, totalIterations: stepLoopTotal };\n\t\t\t\t\t\tupdateLoopStatus(ctx);\n\t\t\t\t\t}\n\n\t\t\t\t\ttry {\n\t\t\t\t\t\tfor (let stepIteration = 0; stepIteration < stepLoopMax; stepIteration++) {\n\t\t\t\t\t\t\tif (isStepLooping) {\n\t\t\t\t\t\t\t\tloopState = { currentIteration: stepIteration + 1, totalIterations: stepLoopTotal };\n\t\t\t\t\t\t\t\tupdateLoopStatus(ctx);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst iterSuffix = isStepLooping\n\t\t\t\t\t\t\t\t? stepLoopTotal !== null\n\t\t\t\t\t\t\t\t\t? ` (iter ${stepIteration + 1}/${stepLoopTotal})`\n\t\t\t\t\t\t\t\t\t: ` (iter ${stepIteration + 1})`\n\t\t\t\t\t\t\t\t: \"\";\n\t\t\t\t\t\t\tnotify(\n\t\t\t\t\t\t\t\tctx,\n\t\t\t\t\t\t\t\t`${loopPrefix}Step ${stepNumber}/${templates.length}: ${singleStep.prompt.name}${iterSuffix} ${buildPromptCommandDescription(singleStep.prompt)}`,\n\t\t\t\t\t\t\t\t\"info\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tif (ctx.hasUI) {\n\t\t\t\t\t\t\t\tctx.ui.setStatus(\"prompt-chain\", ctx.ui.theme.fg(\"warning\", `step ${stepNumber}/${templates.length}: ${singleStep.prompt.name}`));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst taskPreamble = shouldInjectSummary && chainStepSummaries.length > 0\n\t\t\t\t\t\t\t\t? `[Previous chain steps]\\n\\n${chainStepSummaries.join(\"\\n\\n\")}`\n\t\t\t\t\t\t\t\t: undefined;\n\n\t\t\t\t\t\t\tconst stepLoopContext = isStepLooping\n\t\t\t\t\t\t\t\t? `Step ${stepNumber}/${templates.length}: ${singleStep.prompt.name}${iterSuffix}`\n\t\t\t\t\t\t\t\t: undefined;\n\t\t\t\t\t\t\tconst stepIterationStartId = ctx.sessionManager.getLeafId();\n\t\t\t\t\t\t\tconst stepResult = await executePromptStep(\n\t\t\t\t\t\t\t\tsingleStep.prompt,\n\t\t\t\t\t\t\t\teffectiveArgs,\n\t\t\t\t\t\t\t\tctx,\n\t\t\t\t\t\t\t\tcurrentModel,\n\t\t\t\t\t\t\t\tsubagentOverride,\n\t\t\t\t\t\t\t\tchainInheritedModel,\n\t\t\t\t\t\t\t\ttaskPreamble,\n\t\t\t\t\t\t\t\tstepLoopContext,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tif (stepResult === \"aborted\") {\n\t\t\t\t\t\t\t\tchainAborted = true;\n\t\t\t\t\t\t\t\taborted = true;\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tif (shouldDelegatePrompt(singleStep.prompt, subagentOverride)) {\n\t\t\t\t\t\t\t\tlastDelegatedText = stepResult.text;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tcurrentModel = getCurrentModel(ctx);\n\t\t\t\t\t\t\tcurrentThinking = pi.getThinkingLevel();\n\n\t\t\t\t\t\t\tconst stepIterationEntries = getIterationEntries(ctx, stepIterationStartId);\n\t\t\t\t\t\t\tconst stepIterationChanged = didIterationMakeChanges(stepIterationEntries);\n\t\t\t\t\t\t\tif (isStepLooping && singleStep.prompt.converge !== false && !stepIterationChanged) {\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tif (isStepLooping) {\n\t\t\t\t\t\t\tloopState = outerLoopState ? { ...outerLoopState } : null;\n\t\t\t\t\t\t\tupdateLoopStatus(ctx);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tif (aborted) break;\n\t\t\t\t\tconst stepEntries = getIterationEntries(ctx, stepStartId);\n\t\t\t\t\tif (didIterationMakeChanges(stepEntries)) iterationChanged = true;\n\t\t\t\t\tchainStepSummaries.push(generateChainStepSummary(stepEntries, singleStep.prompt.name, stepNumber));\n\t\t\t\t}\n\n\t\t\t\tif (aborted) {\n\t\t\t\t\tchainAborted = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tcompletedIterations++;\n\n\t\t\t\tif (useConverge && (isUnlimited || effectiveMax > 1) && !iterationChanged) {\n\t\t\t\t\tconverged = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tif (anchorId && iteration < effectiveMax - 1) {\n\t\t\t\t\tfreshCollapse = { targetId: anchorId, task: chainStepNames, iteration: iteration + 1, totalIterations };\n\t\t\t\t\tconst result = await ctx.navigateTree(anchorId, { summarize: true });\n\t\t\t\t\tfreshCollapse = null;\n\t\t\t\t\tif (result.cancelled) {\n\t\t\t\t\t\tchainAborted = true;\n\t\t\t\t\t\tnotify(ctx, \"Loop cancelled\", \"warning\");\n\t\t\t\t\t\tbreak;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t} catch (error) {\n\t\t\tchainErrorState = { hasError: true, error };\n\t\t} finally {\n\t\t\tchainErrorState = await restoreAfterExecution(\n\t\t\t\tctx,\n\t\t\t\tshouldRestore,\n\t\t\t\toriginalModel,\n\t\t\t\toriginalThinking,\n\t\t\t\tgetCurrentModel(ctx),\n\t\t\t\tpi.getThinkingLevel(),\n\t\t\t\tchainErrorState,\n\t\t\t\t\"chain\",\n\t\t\t);\n\n\t\t\tpendingSkillMessage = undefined;\n\t\t\tchainActive = false;\n\t\t\tloopState = null;\n\t\t\tfreshCollapse = null;\n\t\t\tboomerangCollapse = null;\n\t\t\taccumulatedSummaries = [];\n\t\t\tupdateLoopStatus(ctx);\n\t\t\tif (ctx.hasUI) {\n\t\t\t\tctx.ui.setStatus(\"prompt-chain\", undefined);\n\t\t\t}\n\n\t\t\tif (!chainErrorState.hasError) {\n\t\t\t\tnotifyLoopCompletion(ctx, completedIterations, totalIterations, effectiveMax, converged, true);\n\t\t\t}\n\t\t}\n\n\t\tif (lastDelegatedText && !chainErrorState.hasError && !chainAborted) {\n\t\t\tpi.sendUserMessage(`[Delegated chain complete: ${chainStepNames}]\\n\\n${lastDelegatedText}`);\n\t\t\tawait waitForTurnStart(ctx);\n\t\t\tawait ctx.waitForIdle();\n\t\t}\n\n\t\tif (chainErrorState.hasError) {\n\t\t\tthrow chainErrorState.error;\n\t\t}\n\t}\n\n\tasync function runPromptCommand(name: string, args: string, ctx: ExtensionCommandContext) {\n\t\tstoredCommandCtx = ctx;\n\t\trefreshPrompts(ctx.cwd, ctx);\n\t\tconst prompt = prompts.get(name);\n\t\tif (!prompt) {\n\t\t\tnotify(ctx, `Prompt \"${name}\" no longer exists`, \"error\");\n\t\t\treturn;\n\t\t}\n\n\t\tconst subagent = extractSubagentOverride(args);\n\t\tconst runtimeCwd = subagent.cwd ? expandCwdPath(subagent.cwd) : undefined;\n\t\tif (subagent.cwd && !runtimeCwd) {\n\t\t\tnotify(ctx, `Invalid --cwd path: must be absolute`, \"error\");\n\t\t\treturn;\n\t\t}\n\t\tconst argsWithoutSubagent = subagent.args;\n\t\tif (prompt.deterministic) {\n\t\t\tif (subagent.override || subagent.fork) {\n\t\t\t\tnotify(ctx, `Deterministic prompts do not support runtime --subagent/--fork in v1`, \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (extractLoopCount(argsWithoutSubagent)) {\n\t\t\t\tnotify(ctx, `Deterministic prompts do not support runtime --loop in v1`, \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t}\n\n\t\tconst hasCompareLineup = prompt.workers !== undefined || prompt.reviewers !== undefined || prompt.finalApplier !== undefined;\n\t\tif (hasCompareLineup) {\n\t\t\tawait runComparePrompt(\n\t\t\t\tname,\n\t\t\t\tprompt,\n\t\t\t\targsWithoutSubagent,\n\t\t\t\tctx,\n\t\t\t\tgetCurrentModel(ctx),\n\t\t\t\t{\n\t\t\t\t\tcwd: runtimeCwd,\n\t\t\t\t\tmodel: subagent.model,\n\t\t\t\t\tsubagentOverride: subagent.override,\n\t\t\t\t\tfork: subagent.fork,\n\t\t\t\t},\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tif (prompt.chain) {\n\t\t\tif (subagent.model) notify(ctx, `--model is not supported on chain prompts (ignored)`, \"warning\");\n\t\t\tif (subagent.fork) notify(ctx, `--fork is not supported on chain prompts (ignored)`, \"warning\");\n\t\t\tconst worktreeExtraction = extractWorktreeFlag(argsWithoutSubagent);\n\t\t\tconst extracted = extractChainContextFlag(worktreeExtraction.args);\n\t\t\tconst chainContextEnabled = extracted.chainContext || prompt.chainContext === \"summary\";\n\t\t\tconst cliWorktree = worktreeExtraction.worktree;\n\t\t\tconst loop = extractLoopCount(extracted.args);\n\t\t\tlet totalIterations: number | null = prompt.loop !== undefined ? prompt.loop : 1;\n\t\t\tlet fresh = false;\n\t\t\tlet converge = true;\n\t\t\tlet cleanedArgs = extracted.args;\n\n\t\t\tif (loop) {\n\t\t\t\ttotalIterations = loop.loopCount;\n\t\t\t\tfresh = loop.fresh;\n\t\t\t\tconverge = loop.converge;\n\t\t\t\tcleanedArgs = loop.args;\n\t\t\t} else if (prompt.loop !== undefined) {\n\t\t\t\tconst flags = extractLoopFlags(extracted.args);\n\t\t\t\tfresh = flags.fresh;\n\t\t\t\tconverge = flags.converge;\n\t\t\t\tcleanedArgs = flags.args;\n\t\t\t}\n\n\t\t\tconst { steps, invalidSegments } = parseChainDeclaration(prompt.chain);\n\t\t\tif (invalidSegments.length > 0) {\n\t\t\t\tnotify(ctx, `Invalid chain step: ${invalidSegments[0]}`, \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (steps.length === 0) {\n\t\t\t\tnotify(ctx, \"No templates specified\", \"error\");\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst cwdOverride = runtimeCwd ?? prompt.cwd;\n\t\t\tawait runSharedChainExecution(\n\t\t\t\tsteps,\n\t\t\t\tparseCommandArgs(cleanedArgs),\n\t\t\t\ttotalIterations,\n\t\t\t\tfresh || prompt.fresh === true,\n\t\t\t\tconverge && prompt.converge !== false,\n\t\t\t\tprompt.restore,\n\t\t\t\tctx,\n\t\t\t\tsubagent.override,\n\t\t\t\tcwdOverride,\n\t\t\t\tchainContextEnabled,\n\t\t\t\tprompt.worktree === true,\n\t\t\t\tcliWorktree,\n\t\t\t);\n\t\t\treturn;\n\t\t}\n\n\t\tconst promptOverrides: Partial<Pick<PromptWithModel, \"models\" | \"inheritContext\">> = {\n\t\t\t...(subagent.model ? { models: [subagent.model] } : {}),\n\t\t\t...(subagent.fork ? { inheritContext: true } : {}),\n\t\t};\n\n\t\tconst loop = extractLoopCount(argsWithoutSubagent);\n\t\tif (loop) {\n\t\t\tawait runPromptLoop(name, loop.args, loop.loopCount, loop.fresh, loop.converge, ctx, subagent.override, runtimeCwd, promptOverrides);\n\t\t\treturn;\n\t\t}\n\n\t\tif (prompt.loop !== undefined) {\n\t\t\tconst flags = extractLoopFlags(argsWithoutSubagent);\n\t\t\tawait runPromptLoop(name, flags.args, prompt.loop, flags.fresh, flags.converge, ctx, subagent.override, runtimeCwd, promptOverrides);\n\t\t\treturn;\n\t\t}\n\n\t\tconst effectivePrompt = {\n\t\t\t...prompt,\n\t\t\t...(runtimeCwd ? {\n\t\t\t\tcwd: runtimeCwd,\n\t\t\t\t...(prompt.deterministic ? { deterministic: { ...prompt.deterministic, cwd: runtimeCwd } } : {}),\n\t\t\t} : {}),\n\t\t\t...promptOverrides,\n\t\t};\n\t\tconst savedModel = getCurrentModel(ctx);\n\t\tconst savedThinking = pi.getThinkingLevel();\n\t\tconst isDelegatedPrompt = shouldDelegatePrompt(effectivePrompt, subagent.override);\n\t\tconst promptTurnRestore = !isDelegatedPrompt && prompt.restore\n\t\t\t? { originalModel: savedModel, originalThinking: savedThinking }\n\t\t\t: undefined;\n\t\tconst boomerangTargetId = effectivePrompt.boomerang ? ctx.sessionManager.getLeafId() : null;\n\t\tconst stepResult = await executePromptStep(\n\t\t\teffectivePrompt,\n\t\t\tparseCommandArgs(argsWithoutSubagent),\n\t\t\tctx,\n\t\t\tsavedModel,\n\t\t\tsubagent.override,\n\t\t\tundefined,\n\t\t\tundefined,\n\t\t\tundefined,\n\t\t\tpromptTurnRestore,\n\t\t);\n\t\tif (stepResult === \"aborted\") return;\n\t\tif (isDelegatedPrompt && stepResult.text) {\n\t\t\tpi.sendUserMessage(`[Delegated result: ${name}]\\n\\n${stepResult.text}`);\n\t\t\tawait waitForTurnStart(ctx);\n\t\t\tawait ctx.waitForIdle();\n\t\t}\n\n\t\tif (effectivePrompt.boomerang) {\n\t\t\tawait collapseBoomerangPrompt(ctx, name, boomerangTargetId);\n\t\t}\n\t}\n\n\tfunction resetSessionScopedState(ctx: ExtensionContext) {\n\t\tstoredCommandCtx = null;\n\t\tpendingSkillMessage = undefined;\n\t\tpreviousModel = undefined;\n\t\tpreviousThinking = undefined;\n\t\truntimeModel = ctx.model;\n\t\tboomerangCollapse = null;\n\t\ttoolManager.clearQueue();\n\t\trefreshPrompts(ctx.cwd, ctx);\n\t}\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tresetSessionScopedState(ctx);\n\t});\n\n\tpi.on(\"model_select\", async (event) => {\n\t\truntimeModel = event.model;\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => {\n\t\tlet systemPrompt = event.systemPrompt;\n\n\t\tif (toolManager.isEnabled() && !loopState && !chainActive) {\n\t\t\tconst toolGuidance = toolManager.getGuidance();\n\t\t\tconst guidance = toolGuidance\n\t\t\t\t? `The run-prompt tool is available for running prompt template commands. ${toolGuidance}`\n\t\t\t\t: \"The run-prompt tool is available for running prompt template commands.\";\n\t\t\tsystemPrompt += `\\n\\n${guidance}`;\n\t\t}\n\n\t\tif (loopState) {\n\t\t\tconst iterText =\n\t\t\t\tloopState.totalIterations !== null\n\t\t\t\t\t? `iteration ${loopState.currentIteration} of ${loopState.totalIterations}`\n\t\t\t\t\t: `iteration ${loopState.currentIteration}`;\n\t\t\tsystemPrompt += `\\n\\nYou are on ${iterText} of the same prompt. Previous iterations and their results are visible in the conversation above. Build on that work — focus on what remains to improve.`;\n\t\t}\n\n\t\tconst skillMessage = consumePendingSkillMessage();\n\t\tconst hasSystemPromptOverride = systemPrompt !== event.systemPrompt;\n\t\tif (!hasSystemPromptOverride && !skillMessage) return;\n\n\t\treturn {\n\t\t\t...(hasSystemPromptOverride ? { systemPrompt } : {}),\n\t\t\t...(skillMessage ? { message: skillMessage } : {}),\n\t\t};\n\t});\n\n\tpi.on(\"agent_end\", async (_event, ctx) => {\n\t\tif (chainActive) return;\n\t\tif (loopState) return;\n\n\t\tconst restoreModel = previousModel;\n\t\tconst restoreThinking = previousThinking;\n\t\tif (!restoreModel && restoreThinking === undefined && !toolManager.hasQueuedCommand()) return;\n\n\t\truntimeModel = ctx.model;\n\n\t\tpreviousModel = undefined;\n\t\tpreviousThinking = undefined;\n\n\t\tconst restoreFn = async () => {\n\t\t\tif (restoreModel || restoreThinking !== undefined) {\n\t\t\t\tawait restoreSessionState(ctx, restoreModel, restoreThinking, getCurrentModel(ctx), pi.getThinkingLevel());\n\t\t\t}\n\t\t};\n\t\tconst processed = await toolManager.processQueue(ctx, restoreFn);\n\t\tif (processed) return;\n\t\tawait restoreFn();\n\t});\n\n\tpi.on(\"session_before_tree\", async (event) => {\n\t\tif (boomerangCollapse && event.preparation.targetId === boomerangCollapse.targetId) {\n\t\t\tconst summary = generateBoomerangSummary(event.preparation.entriesToSummarize, boomerangCollapse.task);\n\t\t\treturn {\n\t\t\t\tsummary: {\n\t\t\t\t\tsummary: [...boomerangCollapse.previousSummaries, summary].join(\"\\n\\n---\\n\\n\"),\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\tif (!freshCollapse) return;\n\t\tif (event.preparation.targetId !== freshCollapse.targetId) return;\n\n\t\tconst summary = generateIterationSummary(\n\t\t\tevent.preparation.entriesToSummarize,\n\t\t\tfreshCollapse.task,\n\t\t\tfreshCollapse.iteration,\n\t\t\tfreshCollapse.totalIterations,\n\t\t);\n\t\taccumulatedSummaries.push(summary);\n\n\t\treturn {\n\t\t\tsummary: {\n\t\t\t\tsummary: accumulatedSummaries.join(\"\\n\\n---\\n\\n\"),\n\t\t\t},\n\t\t};\n\t});\n\n\tasync function runChainCommand(args: string, ctx: ExtensionCommandContext) {\n\t\tstoredCommandCtx = ctx;\n\t\trefreshPrompts(ctx.cwd, ctx);\n\n\t\tconst subagent = extractSubagentOverride(args);\n\t\tconst runtimeCwd = subagent.cwd ? expandCwdPath(subagent.cwd) : undefined;\n\t\tif (subagent.cwd && !runtimeCwd) {\n\t\t\tnotify(ctx, `Invalid --cwd path: must be absolute`, \"error\");\n\t\t\treturn;\n\t\t}\n\t\tconst worktreeExtraction = extractWorktreeFlag(subagent.args);\n\t\tconst extracted = extractChainContextFlag(worktreeExtraction.args);\n\t\tconst loop = extractLoopCount(extracted.args);\n\t\tconst cleanedArgs = loop ? loop.args : extracted.args;\n\n\t\tconst { steps, sharedArgs, invalidSegments } = parseChainSteps(cleanedArgs);\n\t\tif (invalidSegments.length > 0) {\n\t\t\tnotify(ctx, `Invalid chain step: ${invalidSegments[0]}`, \"error\");\n\t\t\treturn;\n\t\t}\n\t\tif (steps.length === 0) {\n\t\t\tnotify(ctx, \"No templates specified\", \"error\");\n\t\t\treturn;\n\t\t}\n\n\t\tawait runSharedChainExecution(\n\t\t\tsteps,\n\t\t\tsharedArgs,\n\t\t\tloop ? loop.loopCount : 1,\n\t\t\tloop?.fresh === true,\n\t\t\tloop?.converge ?? true,\n\t\t\ttrue,\n\t\t\tctx,\n\t\t\tsubagent.override,\n\t\t\truntimeCwd,\n\t\t\textracted.chainContext,\n\t\t\tfalse,\n\t\t\tworktreeExtraction.worktree,\n\t\t);\n\t}\n\n\tif (toolManager.isEnabled()) toolManager.ensureRegistered();\n\n\tpi.registerCommand(\"chain-prompts\", {\n\t\tdescription: \"Chain prompt templates sequentially [template -> template -> ...]\",\n\t\thandler: async (args, ctx) => {\n\t\t\tawait runChainCommand(args, ctx);\n\t\t},\n\t});\n\ttoolManager.registerCommand();\n}\n"]}