@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/single-output.d.ts

@@ -0,0 +1,50 @@
+import type { Message } from "@earendil-works/pi-ai";
+import type { OutputMode, SavedOutputReference } from "../../shared/types.ts";
+export interface SingleOutputSnapshot {
+    exists: boolean;
+    mtimeMs?: number;
+    size?: number;
+}
+/**
+ * Content the child itself sent to the configured output path, taken from its
+ * last `write` tool call whose tool result reports success. Unlike reading the
+ * path from disk, this cannot be polluted by a sibling run writing the same
+ * path (#420); requiring the successful tool result keeps failed, cancelled,
+ * or unanswered write calls from counting as authored output. Returns
+ * undefined when no such write exists (e.g. bash or edit-based construction),
+ * in which case callers must not assume file authorship.
+ */
+export declare function extractChildWrittenOutput(messages: Message[] | undefined, outputPath: string | undefined, cwd?: string): string | undefined;
+export declare function normalizeSingleOutputOverride(output: string | boolean | undefined, defaultOutput: string | undefined): string | false | undefined;
+export declare function resolveSingleOutputPath(output: string | boolean | undefined, runtimeCwd: string, requestedCwd?: string, relativeBaseDir?: string): string | undefined;
+interface OutputInstructionCapabilities {
+    tools?: string[];
+    mcpDirectTools?: string[];
+}
+export declare function injectSingleOutputInstruction(task: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string;
+export declare function injectOutputPathSystemPrompt(systemPrompt: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string;
+export declare function formatSavedOutputReference(savedPath: string, fullOutput: string): SavedOutputReference;
+export declare function validateFileOnlyOutputMode(outputMode: OutputMode | undefined, outputPath: string | undefined, context: string): string | undefined;
+export declare function captureSingleOutputSnapshot(outputPath: string | undefined): SingleOutputSnapshot | undefined;
+export declare function resolveSingleOutput(outputPath: string | undefined, fallbackOutput: string, beforeRun: SingleOutputSnapshot | undefined): {
+    fullOutput: string;
+    savedPath?: string;
+    saveError?: string;
+};
+export declare function finalizeSingleOutput(params: {
+    fullOutput: string;
+    truncatedOutput?: string;
+    outputPath?: string;
+    outputMode?: OutputMode;
+    exitCode: number;
+    savedPath?: string;
+    outputReference?: SavedOutputReference;
+    saveError?: string;
+}): {
+    displayOutput: string;
+    savedPath?: string;
+    outputReference?: SavedOutputReference;
+    saveError?: string;
+};
+export {};
+//# sourceMappingURL=single-output.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/single-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-output.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/single-output.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG9E,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,GAAG,CAAC,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CA0BpB;AAED,wBAAgB,6BAA6B,CAC5C,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACpC,aAAa,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,KAAK,GAAG,SAAS,CAK5B;AAED,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,eAAe,CAAC,EAAE,MAAM,GACtB,MAAM,GAAG,SAAS,CAQpB;AAED,UAAU,6BAA6B;IACtC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAiBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAGhJ;AAED,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAIvJ;AAoBD,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAUtG;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKlJ;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAS5G;AAgBD,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,oBAAoB,GAAG,SAAS,GACzC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAiChE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,oBAAoB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAe5G","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { Message } from \"@earendil-works/pi-ai\";\nimport type { OutputMode, SavedOutputReference } from \"../../shared/types.ts\";\nimport { hasMutationToolCapability } from \"./completion-guard.ts\";\n\nexport interface SingleOutputSnapshot {\n\texists: boolean;\n\tmtimeMs?: number;\n\tsize?: number;\n}\n\n/**\n * Content the child itself sent to the configured output path, taken from its\n * last `write` tool call whose tool result reports success. Unlike reading the\n * path from disk, this cannot be polluted by a sibling run writing the same\n * path (#420); requiring the successful tool result keeps failed, cancelled,\n * or unanswered write calls from counting as authored output. Returns\n * undefined when no such write exists (e.g. bash or edit-based construction),\n * in which case callers must not assume file authorship.\n */\nexport function extractChildWrittenOutput(\n\tmessages: Message[] | undefined,\n\toutputPath: string | undefined,\n\tcwd?: string,\n): string | undefined {\n\tif (!messages?.length || !outputPath) return undefined;\n\tconst resolvedTarget = path.resolve(cwd ?? \".\", outputPath);\n\tconst comparableTarget = process.platform === \"win32\" ? resolvedTarget.toLowerCase() : resolvedTarget;\n\tconst successfulCallIds = new Set<string>();\n\tfor (const message of messages) {\n\t\tif (message.role === \"toolResult\" && message.isError === false && typeof message.toolCallId === \"string\") {\n\t\t\tsuccessfulCallIds.add(message.toolCallId);\n\t\t}\n\t}\n\tlet content: string | undefined;\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"toolCall\" || part.name !== \"write\" || !successfulCallIds.has(part.id)) continue;\n\t\t\tconst args = typeof part.arguments === \"object\" && part.arguments !== null && !Array.isArray(part.arguments)\n\t\t\t\t? part.arguments as Record<string, unknown>\n\t\t\t\t: {};\n\t\t\tif (typeof args.path !== \"string\" || typeof args.content !== \"string\") continue;\n\t\t\tconst resolvedWritePath = path.resolve(cwd ?? \".\", args.path);\n\t\t\tconst comparableWritePath = process.platform === \"win32\" ? resolvedWritePath.toLowerCase() : resolvedWritePath;\n\t\t\tif (comparableWritePath !== comparableTarget) continue;\n\t\t\tcontent = args.content;\n\t\t}\n\t}\n\treturn content;\n}\n\nexport function normalizeSingleOutputOverride(\n\toutput: string | boolean | undefined,\n\tdefaultOutput: string | undefined,\n): string | false | undefined {\n\tif (output === false || output === \"false\") return false;\n\tif (output === true || output === \"true\") return defaultOutput;\n\tif (typeof output === \"string\" && output.length > 0) return output;\n\treturn undefined;\n}\n\nexport function resolveSingleOutputPath(\n\toutput: string | boolean | undefined,\n\truntimeCwd: string,\n\trequestedCwd?: string,\n\trelativeBaseDir?: string,\n): string | undefined {\n\tif (typeof output !== \"string\" || !output || output === \"false\" || output === \"true\") return undefined;\n\tif (path.isAbsolute(output)) return output;\n\tif (relativeBaseDir) return path.resolve(relativeBaseDir, output);\n\tconst baseCwd = requestedCwd\n\t\t? (path.isAbsolute(requestedCwd) ? requestedCwd : path.resolve(runtimeCwd, requestedCwd))\n\t\t: runtimeCwd;\n\treturn path.resolve(baseCwd, output);\n}\n\ninterface OutputInstructionCapabilities {\n\ttools?: string[];\n\tmcpDirectTools?: string[];\n}\n\nfunction formatOutputPathInstruction(outputPath: string, capabilities?: OutputInstructionCapabilities): string {\n\tconst delivery = !capabilities || hasMutationToolCapability(capabilities.tools, capabilities.mcpDirectTools)\n\t\t? `Write your findings to exactly this path: ${outputPath}`\n\t\t: [\n\t\t\t\"Return the complete artifact in your final response.\",\n\t\t\t`The runtime will persist it to exactly this path: ${outputPath}`,\n\t\t\t\"Do not call contact_supervisor merely because no write-capable tool is available.\",\n\t\t].join(\"\\n\");\n\treturn [\n\t\tdelivery,\n\t\t\"This path is authoritative for this run.\",\n\t\t\"Ignore any other output filename or output path mentioned elsewhere, including output destinations in the base agent prompt, system prompt, or task instructions.\",\n\t].join(\"\\n\");\n}\n\nexport function injectSingleOutputInstruction(task: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string {\n\tif (!outputPath) return task;\n\treturn `${task}\\n\\n---\\n**Output:**\\n${formatOutputPathInstruction(outputPath, capabilities)}`;\n}\n\nexport function injectOutputPathSystemPrompt(systemPrompt: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string {\n\tif (!outputPath) return systemPrompt;\n\tconst instruction = `Runtime output path override:\\n${formatOutputPathInstruction(outputPath, capabilities)}`;\n\treturn systemPrompt ? `${systemPrompt}\\n\\n${instruction}` : instruction;\n}\n\nfunction countLines(text: string): number {\n\tif (!text) return 0;\n\tconst newlineMatches = text.match(/\\r\\n|\\r|\\n/g);\n\treturn (newlineMatches?.length ?? 0) + (/[\\r\\n]$/.test(text) ? 0 : 1);\n}\n\nfunction formatByteSize(bytes: number): string {\n\tif (bytes < 1024) return `${bytes} B`;\n\tconst units = [\"KB\", \"MB\", \"GB\", \"TB\"];\n\tlet value = bytes / 1024;\n\tlet unitIndex = 0;\n\twhile (value >= 1024 && unitIndex < units.length - 1) {\n\t\tvalue /= 1024;\n\t\tunitIndex++;\n\t}\n\treturn `${value.toFixed(1)} ${units[unitIndex]}`;\n}\n\nexport function formatSavedOutputReference(savedPath: string, fullOutput: string): SavedOutputReference {\n\tconst absolutePath = path.resolve(savedPath);\n\tconst bytes = Buffer.byteLength(fullOutput, \"utf-8\");\n\tconst lines = countLines(fullOutput);\n\treturn {\n\t\tpath: absolutePath,\n\t\tbytes,\n\t\tlines,\n\t\tmessage: `Output saved to: ${absolutePath} (${formatByteSize(bytes)}, ${lines} ${lines === 1 ? \"line\" : \"lines\"}). Read this file if needed.`,\n\t};\n}\n\nexport function validateFileOnlyOutputMode(outputMode: OutputMode | undefined, outputPath: string | undefined, context: string): string | undefined {\n\tif (outputMode === \"file-only\" && !outputPath) {\n\t\treturn `${context} sets outputMode: \"file-only\" but does not configure an output file. Set output to a path or use outputMode: \"inline\".`;\n\t}\n\treturn undefined;\n}\n\nexport function captureSingleOutputSnapshot(outputPath: string | undefined): SingleOutputSnapshot | undefined {\n\tif (!outputPath) return undefined;\n\ttry {\n\t\tconst stat = fs.statSync(outputPath);\n\t\treturn { exists: true, mtimeMs: stat.mtimeMs, size: stat.size };\n\t} catch {\n\t\t// The snapshot is advisory; resolveSingleOutput reports concrete read/write failures.\n\t\treturn { exists: false };\n\t}\n}\n\nfunction persistSingleOutput(\n\toutputPath: string | undefined,\n\tfullOutput: string,\n): { savedPath?: string; error?: string } {\n\tif (!outputPath) return {};\n\ttry {\n\t\tfs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\t\tfs.writeFileSync(outputPath, fullOutput, \"utf-8\");\n\t\treturn { savedPath: outputPath };\n\t} catch (err) {\n\t\treturn { error: err instanceof Error ? err.message : String(err) };\n\t}\n}\n\nexport function resolveSingleOutput(\n\toutputPath: string | undefined,\n\tfallbackOutput: string,\n\tbeforeRun: SingleOutputSnapshot | undefined,\n): { fullOutput: string; savedPath?: string; saveError?: string } {\n\tif (!outputPath) return { fullOutput: fallbackOutput };\n\n\tlet changedSinceStart = false;\n\ttry {\n\t\tconst stat = fs.statSync(outputPath);\n\t\tchangedSinceStart = !beforeRun?.exists\n\t\t\t|| stat.mtimeMs !== beforeRun.mtimeMs\n\t\t\t|| stat.size !== beforeRun.size;\n\t} catch (error) {\n\t\tconst code = error && typeof error === \"object\" && \"code\" in error ? (error as { code?: unknown }).code : undefined;\n\t\tif (code !== \"ENOENT\" && code !== \"ENOTDIR\") {\n\t\t\treturn {\n\t\t\t\tfullOutput: fallbackOutput,\n\t\t\t\tsaveError: `Failed to inspect output file: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\t}\n\n\tif (changedSinceStart) {\n\t\ttry {\n\t\t\treturn { fullOutput: fs.readFileSync(outputPath, \"utf-8\"), savedPath: outputPath };\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tfullOutput: fallbackOutput,\n\t\t\t\tsaveError: `Failed to read changed output file: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\t}\n\n\tconst save = persistSingleOutput(outputPath, fallbackOutput);\n\tif (save.savedPath) return { fullOutput: fallbackOutput, savedPath: save.savedPath };\n\treturn { fullOutput: fallbackOutput, saveError: save.error };\n}\n\nexport function finalizeSingleOutput(params: {\n\tfullOutput: string;\n\ttruncatedOutput?: string;\n\toutputPath?: string;\n\toutputMode?: OutputMode;\n\texitCode: number;\n\tsavedPath?: string;\n\toutputReference?: SavedOutputReference;\n\tsaveError?: string;\n}): { displayOutput: string; savedPath?: string; outputReference?: SavedOutputReference; saveError?: string } {\n\tlet displayOutput = params.truncatedOutput || params.fullOutput;\n\tif (params.exitCode === 0 && params.savedPath) {\n\t\tconst outputReference = params.outputReference ?? formatSavedOutputReference(params.savedPath, params.fullOutput);\n\t\tif (params.outputMode === \"file-only\") {\n\t\t\treturn { displayOutput: outputReference.message, savedPath: params.savedPath, outputReference };\n\t\t}\n\t\tdisplayOutput += `\\n\\n${outputReference.message}`;\n\t\treturn { displayOutput, savedPath: params.savedPath, outputReference };\n\t}\n\tif (params.exitCode === 0 && params.saveError && params.outputPath) {\n\t\tdisplayOutput += `\\n\\nOutput file error: ${params.outputPath}\\n${params.saveError}`;\n\t\treturn { displayOutput, saveError: params.saveError };\n\t}\n\treturn { displayOutput };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/single-output.js

@@ -0,0 +1,202 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { hasMutationToolCapability } from "./completion-guard.js";
+/**
+ * Content the child itself sent to the configured output path, taken from its
+ * last `write` tool call whose tool result reports success. Unlike reading the
+ * path from disk, this cannot be polluted by a sibling run writing the same
+ * path (#420); requiring the successful tool result keeps failed, cancelled,
+ * or unanswered write calls from counting as authored output. Returns
+ * undefined when no such write exists (e.g. bash or edit-based construction),
+ * in which case callers must not assume file authorship.
+ */
+export function extractChildWrittenOutput(messages, outputPath, cwd) {
+    if (!messages?.length || !outputPath)
+        return undefined;
+    const resolvedTarget = path.resolve(cwd ?? ".", outputPath);
+    const comparableTarget = process.platform === "win32" ? resolvedTarget.toLowerCase() : resolvedTarget;
+    const successfulCallIds = new Set();
+    for (const message of messages) {
+        if (message.role === "toolResult" && message.isError === false && typeof message.toolCallId === "string") {
+            successfulCallIds.add(message.toolCallId);
+        }
+    }
+    let content;
+    for (const message of messages) {
+        if (message.role !== "assistant")
+            continue;
+        for (const part of message.content) {
+            if (part.type !== "toolCall" || part.name !== "write" || !successfulCallIds.has(part.id))
+                continue;
+            const args = typeof part.arguments === "object" && part.arguments !== null && !Array.isArray(part.arguments)
+                ? part.arguments
+                : {};
+            if (typeof args.path !== "string" || typeof args.content !== "string")
+                continue;
+            const resolvedWritePath = path.resolve(cwd ?? ".", args.path);
+            const comparableWritePath = process.platform === "win32" ? resolvedWritePath.toLowerCase() : resolvedWritePath;
+            if (comparableWritePath !== comparableTarget)
+                continue;
+            content = args.content;
+        }
+    }
+    return content;
+}
+export function normalizeSingleOutputOverride(output, defaultOutput) {
+    if (output === false || output === "false")
+        return false;
+    if (output === true || output === "true")
+        return defaultOutput;
+    if (typeof output === "string" && output.length > 0)
+        return output;
+    return undefined;
+}
+export function resolveSingleOutputPath(output, runtimeCwd, requestedCwd, relativeBaseDir) {
+    if (typeof output !== "string" || !output || output === "false" || output === "true")
+        return undefined;
+    if (path.isAbsolute(output))
+        return output;
+    if (relativeBaseDir)
+        return path.resolve(relativeBaseDir, output);
+    const baseCwd = requestedCwd
+        ? (path.isAbsolute(requestedCwd) ? requestedCwd : path.resolve(runtimeCwd, requestedCwd))
+        : runtimeCwd;
+    return path.resolve(baseCwd, output);
+}
+function formatOutputPathInstruction(outputPath, capabilities) {
+    const delivery = !capabilities || hasMutationToolCapability(capabilities.tools, capabilities.mcpDirectTools)
+        ? `Write your findings to exactly this path: ${outputPath}`
+        : [
+            "Return the complete artifact in your final response.",
+            `The runtime will persist it to exactly this path: ${outputPath}`,
+            "Do not call contact_supervisor merely because no write-capable tool is available.",
+        ].join("\n");
+    return [
+        delivery,
+        "This path is authoritative for this run.",
+        "Ignore any other output filename or output path mentioned elsewhere, including output destinations in the base agent prompt, system prompt, or task instructions.",
+    ].join("\n");
+}
+export function injectSingleOutputInstruction(task, outputPath, capabilities) {
+    if (!outputPath)
+        return task;
+    return `${task}\n\n---\n**Output:**\n${formatOutputPathInstruction(outputPath, capabilities)}`;
+}
+export function injectOutputPathSystemPrompt(systemPrompt, outputPath, capabilities) {
+    if (!outputPath)
+        return systemPrompt;
+    const instruction = `Runtime output path override:\n${formatOutputPathInstruction(outputPath, capabilities)}`;
+    return systemPrompt ? `${systemPrompt}\n\n${instruction}` : instruction;
+}
+function countLines(text) {
+    if (!text)
+        return 0;
+    const newlineMatches = text.match(/\r\n|\r|\n/g);
+    return (newlineMatches?.length ?? 0) + (/[\r\n]$/.test(text) ? 0 : 1);
+}
+function formatByteSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ["KB", "MB", "GB", "TB"];
+    let value = bytes / 1024;
+    let unitIndex = 0;
+    while (value >= 1024 && unitIndex < units.length - 1) {
+        value /= 1024;
+        unitIndex++;
+    }
+    return `${value.toFixed(1)} ${units[unitIndex]}`;
+}
+export function formatSavedOutputReference(savedPath, fullOutput) {
+    const absolutePath = path.resolve(savedPath);
+    const bytes = Buffer.byteLength(fullOutput, "utf-8");
+    const lines = countLines(fullOutput);
+    return {
+        path: absolutePath,
+        bytes,
+        lines,
+        message: `Output saved to: ${absolutePath} (${formatByteSize(bytes)}, ${lines} ${lines === 1 ? "line" : "lines"}). Read this file if needed.`,
+    };
+}
+export function validateFileOnlyOutputMode(outputMode, outputPath, context) {
+    if (outputMode === "file-only" && !outputPath) {
+        return `${context} sets outputMode: "file-only" but does not configure an output file. Set output to a path or use outputMode: "inline".`;
+    }
+    return undefined;
+}
+export function captureSingleOutputSnapshot(outputPath) {
+    if (!outputPath)
+        return undefined;
+    try {
+        const stat = fs.statSync(outputPath);
+        return { exists: true, mtimeMs: stat.mtimeMs, size: stat.size };
+    }
+    catch {
+        // The snapshot is advisory; resolveSingleOutput reports concrete read/write failures.
+        return { exists: false };
+    }
+}
+function persistSingleOutput(outputPath, fullOutput) {
+    if (!outputPath)
+        return {};
+    try {
+        fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+        fs.writeFileSync(outputPath, fullOutput, "utf-8");
+        return { savedPath: outputPath };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export function resolveSingleOutput(outputPath, fallbackOutput, beforeRun) {
+    if (!outputPath)
+        return { fullOutput: fallbackOutput };
+    let changedSinceStart = false;
+    try {
+        const stat = fs.statSync(outputPath);
+        changedSinceStart = !beforeRun?.exists
+            || stat.mtimeMs !== beforeRun.mtimeMs
+            || stat.size !== beforeRun.size;
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? error.code : undefined;
+        if (code !== "ENOENT" && code !== "ENOTDIR") {
+            return {
+                fullOutput: fallbackOutput,
+                saveError: `Failed to inspect output file: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    if (changedSinceStart) {
+        try {
+            return { fullOutput: fs.readFileSync(outputPath, "utf-8"), savedPath: outputPath };
+        }
+        catch (error) {
+            return {
+                fullOutput: fallbackOutput,
+                saveError: `Failed to read changed output file: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    const save = persistSingleOutput(outputPath, fallbackOutput);
+    if (save.savedPath)
+        return { fullOutput: fallbackOutput, savedPath: save.savedPath };
+    return { fullOutput: fallbackOutput, saveError: save.error };
+}
+export function finalizeSingleOutput(params) {
+    let displayOutput = params.truncatedOutput || params.fullOutput;
+    if (params.exitCode === 0 && params.savedPath) {
+        const outputReference = params.outputReference ?? formatSavedOutputReference(params.savedPath, params.fullOutput);
+        if (params.outputMode === "file-only") {
+            return { displayOutput: outputReference.message, savedPath: params.savedPath, outputReference };
+        }
+        displayOutput += `\n\n${outputReference.message}`;
+        return { displayOutput, savedPath: params.savedPath, outputReference };
+    }
+    if (params.exitCode === 0 && params.saveError && params.outputPath) {
+        displayOutput += `\n\nOutput file error: ${params.outputPath}\n${params.saveError}`;
+        return { displayOutput, saveError: params.saveError };
+    }
+    return { displayOutput };
+}
+//# sourceMappingURL=single-output.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/single-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-output.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/single-output.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAQlE;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACxC,QAA+B,EAC/B,UAA8B,EAC9B,GAAY,EACS;IACrB,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IACtG,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1G,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;IACF,CAAC;IACD,IAAI,OAA2B,CAAC;IAChC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YACnG,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3G,CAAC,CAAC,IAAI,CAAC,SAAoC;gBAC3C,CAAC,CAAC,EAAE,CAAC;YACN,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;gBAAE,SAAS;YAChF,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,mBAAmB,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;YAC/G,IAAI,mBAAmB,KAAK,gBAAgB;gBAAE,SAAS;YACvD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACxB,CAAC;IACF,CAAC;IACD,OAAO,OAAO,CAAC;AAAA,CACf;AAED,MAAM,UAAU,6BAA6B,CAC5C,MAAoC,EACpC,aAAiC,EACJ;IAC7B,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,aAAa,CAAC;IAC/D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACnE,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,MAAM,UAAU,uBAAuB,CACtC,MAAoC,EACpC,UAAkB,EAClB,YAAqB,EACrB,eAAwB,EACH;IACrB,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IACvG,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,eAAe;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,YAAY;QAC3B,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACzF,CAAC,CAAC,UAAU,CAAC;IACd,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAAA,CACrC;AAOD,SAAS,2BAA2B,CAAC,UAAkB,EAAE,YAA4C,EAAU;IAC9G,MAAM,QAAQ,GAAG,CAAC,YAAY,IAAI,yBAAyB,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,cAAc,CAAC;QAC3G,CAAC,CAAC,6CAA6C,UAAU,EAAE;QAC3D,CAAC,CAAC;YACD,sDAAsD;YACtD,qDAAqD,UAAU,EAAE;YACjE,mFAAmF;SACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;QACN,QAAQ;QACR,0CAA0C;QAC1C,mKAAmK;KACnK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACb;AAED,MAAM,UAAU,6BAA6B,CAAC,IAAY,EAAE,UAA8B,EAAE,YAA4C,EAAU;IACjJ,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,GAAG,IAAI,yBAAyB,2BAA2B,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;AAAA,CAC/F;AAED,MAAM,UAAU,4BAA4B,CAAC,YAAoB,EAAE,UAA8B,EAAE,YAA4C,EAAU;IACxJ,IAAI,CAAC,UAAU;QAAE,OAAO,YAAY,CAAC;IACrC,MAAM,WAAW,GAAG,kCAAkC,2BAA2B,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,CAAC;IAC9G,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,OAAO,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AAAA,CACxE;AAED,SAAS,UAAU,CAAC,IAAY,EAAU;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAAA,CACtE;AAED,SAAS,cAAc,CAAC,KAAa,EAAU;IAC9C,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IACzB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,KAAK,IAAI,IAAI,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,KAAK,IAAI,IAAI,CAAC;QACd,SAAS,EAAE,CAAC;IACb,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AAAA,CACjD;AAED,MAAM,UAAU,0BAA0B,CAAC,SAAiB,EAAE,UAAkB,EAAwB;IACvG,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACrC,OAAO;QACN,IAAI,EAAE,YAAY;QAClB,KAAK;QACL,KAAK;QACL,OAAO,EAAE,oBAAoB,YAAY,KAAK,cAAc,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,8BAA8B;KAC7I,CAAC;AAAA,CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAkC,EAAE,UAA8B,EAAE,OAAe,EAAsB;IACnJ,IAAI,UAAU,KAAK,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/C,OAAO,GAAG,OAAO,wHAAwH,CAAC;IAC3I,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB;AAED,MAAM,UAAU,2BAA2B,CAAC,UAA8B,EAAoC;IAC7G,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACR,sFAAsF;QACtF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;AAAA,CACD;AAED,SAAS,mBAAmB,CAC3B,UAA8B,EAC9B,UAAkB,EACuB;IACzC,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,CAAC;QACJ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACpE,CAAC;AAAA,CACD;AAED,MAAM,UAAU,mBAAmB,CAClC,UAA8B,EAC9B,cAAsB,EACtB,SAA2C,EACsB;IACjE,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;IAEvD,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM;eAClC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO;eAClC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAE,KAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACpH,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7C,OAAO;gBACN,UAAU,EAAE,cAAc;gBAC1B,SAAS,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACrG,CAAC;QACH,CAAC;IACF,CAAC;IAED,IAAI,iBAAiB,EAAE,CAAC;QACvB,IAAI,CAAC;YACJ,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO;gBACN,UAAU,EAAE,cAAc;gBAC1B,SAAS,EAAE,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAC1G,CAAC;QACH,CAAC;IACF,CAAC;IAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACrF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;AAAA,CAC7D;AAED,MAAM,UAAU,oBAAoB,CAAC,MASpC,EAA6G;IAC7G,IAAI,aAAa,GAAG,MAAM,CAAC,eAAe,IAAI,MAAM,CAAC,UAAU,CAAC;IAChE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QAC/C,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,0BAA0B,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClH,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YACvC,OAAO,EAAE,aAAa,EAAE,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,CAAC;QACjG,CAAC;QACD,aAAa,IAAI,OAAO,eAAe,CAAC,OAAO,EAAE,CAAC;QAClD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpE,aAAa,IAAI,0BAA0B,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QACpF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,CAAC;AAAA,CACzB","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { Message } from \"@earendil-works/pi-ai\";\nimport type { OutputMode, SavedOutputReference } from \"../../shared/types.ts\";\nimport { hasMutationToolCapability } from \"./completion-guard.ts\";\n\nexport interface SingleOutputSnapshot {\n\texists: boolean;\n\tmtimeMs?: number;\n\tsize?: number;\n}\n\n/**\n * Content the child itself sent to the configured output path, taken from its\n * last `write` tool call whose tool result reports success. Unlike reading the\n * path from disk, this cannot be polluted by a sibling run writing the same\n * path (#420); requiring the successful tool result keeps failed, cancelled,\n * or unanswered write calls from counting as authored output. Returns\n * undefined when no such write exists (e.g. bash or edit-based construction),\n * in which case callers must not assume file authorship.\n */\nexport function extractChildWrittenOutput(\n\tmessages: Message[] | undefined,\n\toutputPath: string | undefined,\n\tcwd?: string,\n): string | undefined {\n\tif (!messages?.length || !outputPath) return undefined;\n\tconst resolvedTarget = path.resolve(cwd ?? \".\", outputPath);\n\tconst comparableTarget = process.platform === \"win32\" ? resolvedTarget.toLowerCase() : resolvedTarget;\n\tconst successfulCallIds = new Set<string>();\n\tfor (const message of messages) {\n\t\tif (message.role === \"toolResult\" && message.isError === false && typeof message.toolCallId === \"string\") {\n\t\t\tsuccessfulCallIds.add(message.toolCallId);\n\t\t}\n\t}\n\tlet content: string | undefined;\n\tfor (const message of messages) {\n\t\tif (message.role !== \"assistant\") continue;\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"toolCall\" || part.name !== \"write\" || !successfulCallIds.has(part.id)) continue;\n\t\t\tconst args = typeof part.arguments === \"object\" && part.arguments !== null && !Array.isArray(part.arguments)\n\t\t\t\t? part.arguments as Record<string, unknown>\n\t\t\t\t: {};\n\t\t\tif (typeof args.path !== \"string\" || typeof args.content !== \"string\") continue;\n\t\t\tconst resolvedWritePath = path.resolve(cwd ?? \".\", args.path);\n\t\t\tconst comparableWritePath = process.platform === \"win32\" ? resolvedWritePath.toLowerCase() : resolvedWritePath;\n\t\t\tif (comparableWritePath !== comparableTarget) continue;\n\t\t\tcontent = args.content;\n\t\t}\n\t}\n\treturn content;\n}\n\nexport function normalizeSingleOutputOverride(\n\toutput: string | boolean | undefined,\n\tdefaultOutput: string | undefined,\n): string | false | undefined {\n\tif (output === false || output === \"false\") return false;\n\tif (output === true || output === \"true\") return defaultOutput;\n\tif (typeof output === \"string\" && output.length > 0) return output;\n\treturn undefined;\n}\n\nexport function resolveSingleOutputPath(\n\toutput: string | boolean | undefined,\n\truntimeCwd: string,\n\trequestedCwd?: string,\n\trelativeBaseDir?: string,\n): string | undefined {\n\tif (typeof output !== \"string\" || !output || output === \"false\" || output === \"true\") return undefined;\n\tif (path.isAbsolute(output)) return output;\n\tif (relativeBaseDir) return path.resolve(relativeBaseDir, output);\n\tconst baseCwd = requestedCwd\n\t\t? (path.isAbsolute(requestedCwd) ? requestedCwd : path.resolve(runtimeCwd, requestedCwd))\n\t\t: runtimeCwd;\n\treturn path.resolve(baseCwd, output);\n}\n\ninterface OutputInstructionCapabilities {\n\ttools?: string[];\n\tmcpDirectTools?: string[];\n}\n\nfunction formatOutputPathInstruction(outputPath: string, capabilities?: OutputInstructionCapabilities): string {\n\tconst delivery = !capabilities || hasMutationToolCapability(capabilities.tools, capabilities.mcpDirectTools)\n\t\t? `Write your findings to exactly this path: ${outputPath}`\n\t\t: [\n\t\t\t\"Return the complete artifact in your final response.\",\n\t\t\t`The runtime will persist it to exactly this path: ${outputPath}`,\n\t\t\t\"Do not call contact_supervisor merely because no write-capable tool is available.\",\n\t\t].join(\"\\n\");\n\treturn [\n\t\tdelivery,\n\t\t\"This path is authoritative for this run.\",\n\t\t\"Ignore any other output filename or output path mentioned elsewhere, including output destinations in the base agent prompt, system prompt, or task instructions.\",\n\t].join(\"\\n\");\n}\n\nexport function injectSingleOutputInstruction(task: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string {\n\tif (!outputPath) return task;\n\treturn `${task}\\n\\n---\\n**Output:**\\n${formatOutputPathInstruction(outputPath, capabilities)}`;\n}\n\nexport function injectOutputPathSystemPrompt(systemPrompt: string, outputPath: string | undefined, capabilities?: OutputInstructionCapabilities): string {\n\tif (!outputPath) return systemPrompt;\n\tconst instruction = `Runtime output path override:\\n${formatOutputPathInstruction(outputPath, capabilities)}`;\n\treturn systemPrompt ? `${systemPrompt}\\n\\n${instruction}` : instruction;\n}\n\nfunction countLines(text: string): number {\n\tif (!text) return 0;\n\tconst newlineMatches = text.match(/\\r\\n|\\r|\\n/g);\n\treturn (newlineMatches?.length ?? 0) + (/[\\r\\n]$/.test(text) ? 0 : 1);\n}\n\nfunction formatByteSize(bytes: number): string {\n\tif (bytes < 1024) return `${bytes} B`;\n\tconst units = [\"KB\", \"MB\", \"GB\", \"TB\"];\n\tlet value = bytes / 1024;\n\tlet unitIndex = 0;\n\twhile (value >= 1024 && unitIndex < units.length - 1) {\n\t\tvalue /= 1024;\n\t\tunitIndex++;\n\t}\n\treturn `${value.toFixed(1)} ${units[unitIndex]}`;\n}\n\nexport function formatSavedOutputReference(savedPath: string, fullOutput: string): SavedOutputReference {\n\tconst absolutePath = path.resolve(savedPath);\n\tconst bytes = Buffer.byteLength(fullOutput, \"utf-8\");\n\tconst lines = countLines(fullOutput);\n\treturn {\n\t\tpath: absolutePath,\n\t\tbytes,\n\t\tlines,\n\t\tmessage: `Output saved to: ${absolutePath} (${formatByteSize(bytes)}, ${lines} ${lines === 1 ? \"line\" : \"lines\"}). Read this file if needed.`,\n\t};\n}\n\nexport function validateFileOnlyOutputMode(outputMode: OutputMode | undefined, outputPath: string | undefined, context: string): string | undefined {\n\tif (outputMode === \"file-only\" && !outputPath) {\n\t\treturn `${context} sets outputMode: \"file-only\" but does not configure an output file. Set output to a path or use outputMode: \"inline\".`;\n\t}\n\treturn undefined;\n}\n\nexport function captureSingleOutputSnapshot(outputPath: string | undefined): SingleOutputSnapshot | undefined {\n\tif (!outputPath) return undefined;\n\ttry {\n\t\tconst stat = fs.statSync(outputPath);\n\t\treturn { exists: true, mtimeMs: stat.mtimeMs, size: stat.size };\n\t} catch {\n\t\t// The snapshot is advisory; resolveSingleOutput reports concrete read/write failures.\n\t\treturn { exists: false };\n\t}\n}\n\nfunction persistSingleOutput(\n\toutputPath: string | undefined,\n\tfullOutput: string,\n): { savedPath?: string; error?: string } {\n\tif (!outputPath) return {};\n\ttry {\n\t\tfs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\t\tfs.writeFileSync(outputPath, fullOutput, \"utf-8\");\n\t\treturn { savedPath: outputPath };\n\t} catch (err) {\n\t\treturn { error: err instanceof Error ? err.message : String(err) };\n\t}\n}\n\nexport function resolveSingleOutput(\n\toutputPath: string | undefined,\n\tfallbackOutput: string,\n\tbeforeRun: SingleOutputSnapshot | undefined,\n): { fullOutput: string; savedPath?: string; saveError?: string } {\n\tif (!outputPath) return { fullOutput: fallbackOutput };\n\n\tlet changedSinceStart = false;\n\ttry {\n\t\tconst stat = fs.statSync(outputPath);\n\t\tchangedSinceStart = !beforeRun?.exists\n\t\t\t|| stat.mtimeMs !== beforeRun.mtimeMs\n\t\t\t|| stat.size !== beforeRun.size;\n\t} catch (error) {\n\t\tconst code = error && typeof error === \"object\" && \"code\" in error ? (error as { code?: unknown }).code : undefined;\n\t\tif (code !== \"ENOENT\" && code !== \"ENOTDIR\") {\n\t\t\treturn {\n\t\t\t\tfullOutput: fallbackOutput,\n\t\t\t\tsaveError: `Failed to inspect output file: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\t}\n\n\tif (changedSinceStart) {\n\t\ttry {\n\t\t\treturn { fullOutput: fs.readFileSync(outputPath, \"utf-8\"), savedPath: outputPath };\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tfullOutput: fallbackOutput,\n\t\t\t\tsaveError: `Failed to read changed output file: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\t}\n\n\tconst save = persistSingleOutput(outputPath, fallbackOutput);\n\tif (save.savedPath) return { fullOutput: fallbackOutput, savedPath: save.savedPath };\n\treturn { fullOutput: fallbackOutput, saveError: save.error };\n}\n\nexport function finalizeSingleOutput(params: {\n\tfullOutput: string;\n\ttruncatedOutput?: string;\n\toutputPath?: string;\n\toutputMode?: OutputMode;\n\texitCode: number;\n\tsavedPath?: string;\n\toutputReference?: SavedOutputReference;\n\tsaveError?: string;\n}): { displayOutput: string; savedPath?: string; outputReference?: SavedOutputReference; saveError?: string } {\n\tlet displayOutput = params.truncatedOutput || params.fullOutput;\n\tif (params.exitCode === 0 && params.savedPath) {\n\t\tconst outputReference = params.outputReference ?? formatSavedOutputReference(params.savedPath, params.fullOutput);\n\t\tif (params.outputMode === \"file-only\") {\n\t\t\treturn { displayOutput: outputReference.message, savedPath: params.savedPath, outputReference };\n\t\t}\n\t\tdisplayOutput += `\\n\\n${outputReference.message}`;\n\t\treturn { displayOutput, savedPath: params.savedPath, outputReference };\n\t}\n\tif (params.exitCode === 0 && params.saveError && params.outputPath) {\n\t\tdisplayOutput += `\\n\\nOutput file error: ${params.outputPath}\\n${params.saveError}`;\n\t\treturn { displayOutput, saveError: params.saveError };\n\t}\n\treturn { displayOutput };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/structured-output.d.ts

@@ -0,0 +1,22 @@
+import type { JsonSchemaObject } from "../../shared/types.ts";
+export declare const STRUCTURED_OUTPUT_SCHEMA_ENV = "PI_SUBAGENT_STRUCTURED_OUTPUT_SCHEMA";
+export declare const STRUCTURED_OUTPUT_CAPTURE_ENV = "PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE";
+export interface StructuredOutputRuntime {
+    schema: JsonSchemaObject;
+    schemaPath: string;
+    outputPath: string;
+}
+export declare function assertJsonSchemaObject(schema: unknown, label?: string): asserts schema is JsonSchemaObject;
+export declare function createStructuredOutputRuntime(schema: JsonSchemaObject, baseDir?: string): StructuredOutputRuntime;
+export declare function validateStructuredOutputValue(schema: JsonSchemaObject, value: unknown): {
+    status: "valid";
+} | {
+    status: "invalid";
+    message: string;
+};
+export declare function readStructuredOutput(runtime: StructuredOutputRuntime): {
+    value?: unknown;
+    error?: string;
+};
+export declare function cleanupStructuredOutputRuntime(runtime: StructuredOutputRuntime | undefined): void;
+//# sourceMappingURL=structured-output.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/structured-output.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,eAAO,MAAM,4BAA4B,yCAAyC,CAAC;AACnF,eAAO,MAAM,6BAA6B,0CAA0C,CAAC;AAErF,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,SAAiB,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAIlH;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,uBAAuB,CASjH;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAepJ;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAa1G;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAOjG","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { Compile } from \"typebox/compile\";\nimport type { JsonSchemaObject } from \"../../shared/types.ts\";\n\nexport const STRUCTURED_OUTPUT_SCHEMA_ENV = \"PI_SUBAGENT_STRUCTURED_OUTPUT_SCHEMA\";\nexport const STRUCTURED_OUTPUT_CAPTURE_ENV = \"PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE\";\n\nexport interface StructuredOutputRuntime {\n\tschema: JsonSchemaObject;\n\tschemaPath: string;\n\toutputPath: string;\n}\n\ninterface CompiledJsonSchema {\n\tCheck(value: unknown): boolean;\n\tErrors(value: unknown): Iterable<{ instancePath?: string; message?: string }>;\n}\n\nexport function assertJsonSchemaObject(schema: unknown, label = \"outputSchema\"): asserts schema is JsonSchemaObject {\n\tif (!schema || typeof schema !== \"object\" || Array.isArray(schema)) {\n\t\tthrow new Error(`${label} must be a JSON Schema object.`);\n\t}\n}\n\nexport function createStructuredOutputRuntime(schema: JsonSchemaObject, baseDir?: string): StructuredOutputRuntime {\n\tassertJsonSchemaObject(schema);\n\tconst rootDir = baseDir ?? os.tmpdir();\n\tfs.mkdirSync(rootDir, { recursive: true });\n\tconst dir = fs.mkdtempSync(path.join(rootDir, \"pi-subagent-structured-\"));\n\tconst schemaPath = path.join(dir, \"schema.json\");\n\tconst outputPath = path.join(dir, \"output.json\");\n\tfs.writeFileSync(schemaPath, JSON.stringify(schema), { mode: 0o600 });\n\treturn { schema, schemaPath, outputPath };\n}\n\nexport function validateStructuredOutputValue(schema: JsonSchemaObject, value: unknown): { status: \"valid\" } | { status: \"invalid\"; message: string } {\n\tlet validator: CompiledJsonSchema;\n\ttry {\n\t\tvalidator = (Compile as (schema: unknown) => CompiledJsonSchema)(schema);\n\t} catch (error) {\n\t\treturn { status: \"invalid\", message: `invalid outputSchema: ${error instanceof Error ? error.message : String(error)}` };\n\t}\n\tif (validator.Check(value)) return { status: \"valid\" };\n\tconst errors = [...validator.Errors(value)]\n\t\t.slice(0, 8)\n\t\t.map((error) => {\n\t\t\tconst pathText = error.instancePath ? error.instancePath.replace(/^\\//, \"\").replace(/\\//g, \".\") : \"root\";\n\t\t\treturn `${pathText}: ${error.message}`;\n\t\t});\n\treturn { status: \"invalid\", message: errors.join(\"; \") || \"schema validation failed\" };\n}\n\nexport function readStructuredOutput(runtime: StructuredOutputRuntime): { value?: unknown; error?: string } {\n\tif (!fs.existsSync(runtime.outputPath)) {\n\t\treturn { error: \"Missing structured_output call; this step has outputSchema and must finish by calling structured_output.\" };\n\t}\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(fs.readFileSync(runtime.outputPath, \"utf-8\"));\n\t} catch (error) {\n\t\treturn { error: `Failed to read structured output: ${error instanceof Error ? error.message : String(error)}` };\n\t}\n\tconst validation = validateStructuredOutputValue(runtime.schema, value);\n\tif (validation.status === \"invalid\") return { error: `Structured output validation failed: ${validation.message}` };\n\treturn { value };\n}\n\nexport function cleanupStructuredOutputRuntime(runtime: StructuredOutputRuntime | undefined): void {\n\tif (!runtime) return;\n\ttry {\n\t\tfs.rmSync(path.dirname(runtime.schemaPath), { recursive: true, force: true });\n\t} catch {\n\t\t// Best-effort temp cleanup.\n\t}\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/structured-output.js

@@ -0,0 +1,67 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { Compile } from "typebox/compile";
+export const STRUCTURED_OUTPUT_SCHEMA_ENV = "PI_SUBAGENT_STRUCTURED_OUTPUT_SCHEMA";
+export const STRUCTURED_OUTPUT_CAPTURE_ENV = "PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE";
+export function assertJsonSchemaObject(schema, label = "outputSchema") {
+    if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
+        throw new Error(`${label} must be a JSON Schema object.`);
+    }
+}
+export function createStructuredOutputRuntime(schema, baseDir) {
+    assertJsonSchemaObject(schema);
+    const rootDir = baseDir ?? os.tmpdir();
+    fs.mkdirSync(rootDir, { recursive: true });
+    const dir = fs.mkdtempSync(path.join(rootDir, "pi-subagent-structured-"));
+    const schemaPath = path.join(dir, "schema.json");
+    const outputPath = path.join(dir, "output.json");
+    fs.writeFileSync(schemaPath, JSON.stringify(schema), { mode: 0o600 });
+    return { schema, schemaPath, outputPath };
+}
+export function validateStructuredOutputValue(schema, value) {
+    let validator;
+    try {
+        validator = Compile(schema);
+    }
+    catch (error) {
+        return { status: "invalid", message: `invalid outputSchema: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    if (validator.Check(value))
+        return { status: "valid" };
+    const errors = [...validator.Errors(value)]
+        .slice(0, 8)
+        .map((error) => {
+        const pathText = error.instancePath ? error.instancePath.replace(/^\//, "").replace(/\//g, ".") : "root";
+        return `${pathText}: ${error.message}`;
+    });
+    return { status: "invalid", message: errors.join("; ") || "schema validation failed" };
+}
+export function readStructuredOutput(runtime) {
+    if (!fs.existsSync(runtime.outputPath)) {
+        return { error: "Missing structured_output call; this step has outputSchema and must finish by calling structured_output." };
+    }
+    let value;
+    try {
+        value = JSON.parse(fs.readFileSync(runtime.outputPath, "utf-8"));
+    }
+    catch (error) {
+        return { error: `Failed to read structured output: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    const validation = validateStructuredOutputValue(runtime.schema, value);
+    if (validation.status === "invalid")
+        return { error: `Structured output validation failed: ${validation.message}` };
+    return { value };
+}
+export function cleanupStructuredOutputRuntime(runtime) {
+    if (!runtime)
+        return;
+    try {
+        fs.rmSync(path.dirname(runtime.schemaPath), { recursive: true, force: true });
+    }
+    catch {
+        // Best-effort temp cleanup.
+    }
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-output.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/structured-output.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { Compile } from \"typebox/compile\";\nimport type { JsonSchemaObject } from \"../../shared/types.ts\";\n\nexport const STRUCTURED_OUTPUT_SCHEMA_ENV = \"PI_SUBAGENT_STRUCTURED_OUTPUT_SCHEMA\";\nexport const STRUCTURED_OUTPUT_CAPTURE_ENV = \"PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE\";\n\nexport interface StructuredOutputRuntime {\n\tschema: JsonSchemaObject;\n\tschemaPath: string;\n\toutputPath: string;\n}\n\ninterface CompiledJsonSchema {\n\tCheck(value: unknown): boolean;\n\tErrors(value: unknown): Iterable<{ instancePath?: string; message?: string }>;\n}\n\nexport function assertJsonSchemaObject(schema: unknown, label = \"outputSchema\"): asserts schema is JsonSchemaObject {\n\tif (!schema || typeof schema !== \"object\" || Array.isArray(schema)) {\n\t\tthrow new Error(`${label} must be a JSON Schema object.`);\n\t}\n}\n\nexport function createStructuredOutputRuntime(schema: JsonSchemaObject, baseDir?: string): StructuredOutputRuntime {\n\tassertJsonSchemaObject(schema);\n\tconst rootDir = baseDir ?? os.tmpdir();\n\tfs.mkdirSync(rootDir, { recursive: true });\n\tconst dir = fs.mkdtempSync(path.join(rootDir, \"pi-subagent-structured-\"));\n\tconst schemaPath = path.join(dir, \"schema.json\");\n\tconst outputPath = path.join(dir, \"output.json\");\n\tfs.writeFileSync(schemaPath, JSON.stringify(schema), { mode: 0o600 });\n\treturn { schema, schemaPath, outputPath };\n}\n\nexport function validateStructuredOutputValue(schema: JsonSchemaObject, value: unknown): { status: \"valid\" } | { status: \"invalid\"; message: string } {\n\tlet validator: CompiledJsonSchema;\n\ttry {\n\t\tvalidator = (Compile as (schema: unknown) => CompiledJsonSchema)(schema);\n\t} catch (error) {\n\t\treturn { status: \"invalid\", message: `invalid outputSchema: ${error instanceof Error ? error.message : String(error)}` };\n\t}\n\tif (validator.Check(value)) return { status: \"valid\" };\n\tconst errors = [...validator.Errors(value)]\n\t\t.slice(0, 8)\n\t\t.map((error) => {\n\t\t\tconst pathText = error.instancePath ? error.instancePath.replace(/^\\//, \"\").replace(/\\//g, \".\") : \"root\";\n\t\t\treturn `${pathText}: ${error.message}`;\n\t\t});\n\treturn { status: \"invalid\", message: errors.join(\"; \") || \"schema validation failed\" };\n}\n\nexport function readStructuredOutput(runtime: StructuredOutputRuntime): { value?: unknown; error?: string } {\n\tif (!fs.existsSync(runtime.outputPath)) {\n\t\treturn { error: \"Missing structured_output call; this step has outputSchema and must finish by calling structured_output.\" };\n\t}\n\tlet value: unknown;\n\ttry {\n\t\tvalue = JSON.parse(fs.readFileSync(runtime.outputPath, \"utf-8\"));\n\t} catch (error) {\n\t\treturn { error: `Failed to read structured output: ${error instanceof Error ? error.message : String(error)}` };\n\t}\n\tconst validation = validateStructuredOutputValue(runtime.schema, value);\n\tif (validation.status === \"invalid\") return { error: `Structured output validation failed: ${validation.message}` };\n\treturn { value };\n}\n\nexport function cleanupStructuredOutputRuntime(runtime: StructuredOutputRuntime | undefined): void {\n\tif (!runtime) return;\n\ttry {\n\t\tfs.rmSync(path.dirname(runtime.schemaPath), { recursive: true, force: true });\n\t} catch {\n\t\t// Best-effort temp cleanup.\n\t}\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/subagent-control.d.ts

@@ -0,0 +1,35 @@
+import { type ActivityState, type ControlConfig, type ControlEvent, type ControlEventType, type ResolvedControlConfig } from "../../shared/types.ts";
+export declare const DEFAULT_CONTROL_CONFIG: ResolvedControlConfig;
+export declare function resolveControlConfig(globalConfig?: ControlConfig, override?: ControlConfig): ResolvedControlConfig;
+export declare function deriveActivityState(input: {
+    config: ResolvedControlConfig;
+    startedAt: number;
+    lastActivityAt?: number;
+    now?: number;
+}): ActivityState | undefined;
+export declare function buildControlEvent(input: {
+    type?: ControlEventType;
+    from?: ActivityState;
+    to: ActivityState;
+    runId: string;
+    agent: string;
+    index?: number;
+    ts?: number;
+    lastActivityAt?: number;
+    message?: string;
+    reason?: ControlEvent["reason"];
+    turns?: number;
+    tokens?: number;
+    toolCount?: number;
+    currentTool?: string;
+    currentToolDurationMs?: number;
+    currentPath?: string;
+    elapsedMs?: number;
+    recentFailureSummary?: string;
+}): ControlEvent;
+export declare function shouldNotifyControlEvent(config: ResolvedControlConfig, event: ControlEvent): boolean;
+export declare function controlNotificationKey(event: ControlEvent, childIntercomTarget?: string): string;
+export declare function claimControlNotification(config: ResolvedControlConfig, event: ControlEvent, seenKeys: Set<string>, childIntercomTarget?: string): boolean;
+export declare function formatControlNoticeMessage(event: ControlEvent, childIntercomTarget?: string): string;
+export declare function formatControlIntercomMessage(event: ControlEvent, childIntercomTarget?: string): string;
+//# sourceMappingURL=subagent-control.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/subagent-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-control.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/subagent-control.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAErB,KAAK,qBAAqB,EAC1B,MAAM,uBAAuB,CAAC;AAM/B,eAAO,MAAM,sBAAsB,EAAE,qBAOpC,CAAC;AAgBF,wBAAgB,oBAAoB,CACnC,YAAY,CAAC,EAAE,aAAa,EAC5B,QAAQ,CAAC,EAAE,aAAa,GACtB,qBAAqB,CA+BvB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAC1C,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,aAAa,GAAG,SAAS,CAM5B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACxC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,YAAY,CA6Bf;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAEpG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhG;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAMzJ;AAaD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,YAAY,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAwCpG;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,YAAY,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBtG","sourcesContent":["// @ts-nocheck\nimport {\n\ttype ActivityState,\n\ttype ControlConfig,\n\ttype ControlEvent,\n\ttype ControlEventType,\n\ttype ControlNotificationChannel,\n\ttype ResolvedControlConfig,\n} from \"../../shared/types.ts\";\n\nconst CONTROL_EVENT_TYPES: ControlEventType[] = [\"active_long_running\", \"needs_attention\"];\nconst CONTROL_NOTIFICATION_CHANNELS: ControlNotificationChannel[] = [\"event\", \"async\", \"intercom\"];\nconst DEFAULT_NOTIFY_ON: ControlEventType[] = [\"active_long_running\", \"needs_attention\"];\n\nexport const DEFAULT_CONTROL_CONFIG: ResolvedControlConfig = {\n\tenabled: true,\n\tneedsAttentionAfterMs: 60_000,\n\tactiveNoticeAfterMs: 240_000,\n\tfailedToolAttemptsBeforeAttention: 3,\n\tnotifyOn: DEFAULT_NOTIFY_ON,\n\tnotifyChannels: CONTROL_NOTIFICATION_CHANNELS,\n};\n\nfunction parsePositiveInt(value: unknown): number | undefined {\n\tif (typeof value !== \"number\") return undefined;\n\tif (!Number.isFinite(value) || !Number.isInteger(value) || value < 1) return undefined;\n\treturn value;\n}\n\nfunction parseControlList<T extends string>(value: unknown, allowed: readonly T[]): T[] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tif (value.length === 0) return [];\n\tconst allowedSet = new Set(allowed);\n\tconst parsed = value.filter((entry): entry is T => typeof entry === \"string\" && allowedSet.has(entry as T));\n\treturn parsed.length > 0 ? Array.from(new Set(parsed)) : undefined;\n}\n\nexport function resolveControlConfig(\n\tglobalConfig?: ControlConfig,\n\toverride?: ControlConfig,\n): ResolvedControlConfig {\n\tconst enabled = override?.enabled ?? globalConfig?.enabled ?? DEFAULT_CONTROL_CONFIG.enabled;\n\tconst needsAttentionAfterMs = parsePositiveInt(override?.needsAttentionAfterMs)\n\t\t?? parsePositiveInt(globalConfig?.needsAttentionAfterMs)\n\t\t?? DEFAULT_CONTROL_CONFIG.needsAttentionAfterMs;\n\tconst activeNoticeAfterMs = parsePositiveInt(override?.activeNoticeAfterMs)\n\t\t?? parsePositiveInt(globalConfig?.activeNoticeAfterMs)\n\t\t?? DEFAULT_CONTROL_CONFIG.activeNoticeAfterMs;\n\tconst activeNoticeAfterTurns = parsePositiveInt(override?.activeNoticeAfterTurns)\n\t\t?? parsePositiveInt(globalConfig?.activeNoticeAfterTurns);\n\tconst activeNoticeAfterTokens = parsePositiveInt(override?.activeNoticeAfterTokens)\n\t\t?? parsePositiveInt(globalConfig?.activeNoticeAfterTokens);\n\tconst failedToolAttemptsBeforeAttention = parsePositiveInt(override?.failedToolAttemptsBeforeAttention)\n\t\t?? parsePositiveInt(globalConfig?.failedToolAttemptsBeforeAttention)\n\t\t?? DEFAULT_CONTROL_CONFIG.failedToolAttemptsBeforeAttention;\n\tconst notifyOn = parseControlList(override?.notifyOn, CONTROL_EVENT_TYPES)\n\t\t?? parseControlList(globalConfig?.notifyOn, CONTROL_EVENT_TYPES)\n\t\t?? DEFAULT_CONTROL_CONFIG.notifyOn;\n\tconst notifyChannels = parseControlList(override?.notifyChannels, CONTROL_NOTIFICATION_CHANNELS)\n\t\t?? parseControlList(globalConfig?.notifyChannels, CONTROL_NOTIFICATION_CHANNELS)\n\t\t?? DEFAULT_CONTROL_CONFIG.notifyChannels;\n\treturn {\n\t\tenabled,\n\t\tneedsAttentionAfterMs,\n\t\tactiveNoticeAfterMs,\n\t\tactiveNoticeAfterTurns,\n\t\tactiveNoticeAfterTokens,\n\t\tfailedToolAttemptsBeforeAttention,\n\t\tnotifyOn: [...notifyOn],\n\t\tnotifyChannels: [...notifyChannels],\n\t};\n}\n\nexport function deriveActivityState(input: {\n\tconfig: ResolvedControlConfig;\n\tstartedAt: number;\n\tlastActivityAt?: number;\n\tnow?: number;\n}): ActivityState | undefined {\n\tif (!input.config.enabled) return undefined;\n\tconst now = input.now ?? Date.now();\n\tconst lastActivity = input.lastActivityAt ?? input.startedAt;\n\tconst ageMs = Math.max(0, now - lastActivity);\n\treturn ageMs > input.config.needsAttentionAfterMs ? \"needs_attention\" : undefined;\n}\n\nexport function buildControlEvent(input: {\n\ttype?: ControlEventType;\n\tfrom?: ActivityState;\n\tto: ActivityState;\n\trunId: string;\n\tagent: string;\n\tindex?: number;\n\tts?: number;\n\tlastActivityAt?: number;\n\tmessage?: string;\n\treason?: ControlEvent[\"reason\"];\n\tturns?: number;\n\ttokens?: number;\n\ttoolCount?: number;\n\tcurrentTool?: string;\n\tcurrentToolDurationMs?: number;\n\tcurrentPath?: string;\n\telapsedMs?: number;\n\trecentFailureSummary?: string;\n}): ControlEvent {\n\tconst ts = input.ts ?? Date.now();\n\tconst type = input.type ?? (input.to === \"active_long_running\" ? \"active_long_running\" : \"needs_attention\");\n\tconst elapsedMs = input.elapsedMs ?? (input.lastActivityAt ? Math.max(0, ts - input.lastActivityAt) : undefined);\n\tconst elapsedSeconds = elapsedMs !== undefined ? Math.floor(elapsedMs / 1000) : undefined;\n\tconst message = input.message ?? (type === \"active_long_running\"\n\t\t? `${input.agent} is still active but long-running`\n\t\t: elapsedSeconds !== undefined\n\t\t\t? `${input.agent} needs attention (no observed activity for ${elapsedSeconds}s)`\n\t\t\t: `${input.agent} needs attention`);\n\treturn {\n\t\ttype,\n\t\t...(input.from ? { from: input.from } : {}),\n\t\tto: input.to,\n\t\tts,\n\t\trunId: input.runId,\n\t\tagent: input.agent,\n\t\t...(input.index !== undefined ? { index: input.index } : {}),\n\t\tmessage,\n\t\treason: input.reason ?? (type === \"active_long_running\" ? \"active_long_running\" : \"idle\"),\n\t\t...(input.turns !== undefined ? { turns: input.turns } : {}),\n\t\t...(input.tokens !== undefined ? { tokens: input.tokens } : {}),\n\t\t...(input.toolCount !== undefined ? { toolCount: input.toolCount } : {}),\n\t\t...(input.currentTool ? { currentTool: input.currentTool } : {}),\n\t\t...(input.currentToolDurationMs !== undefined ? { currentToolDurationMs: input.currentToolDurationMs } : {}),\n\t\t...(input.currentPath ? { currentPath: input.currentPath } : {}),\n\t\t...(elapsedMs !== undefined ? { elapsedMs } : {}),\n\t\t...(input.recentFailureSummary ? { recentFailureSummary: input.recentFailureSummary } : {}),\n\t};\n}\n\nexport function shouldNotifyControlEvent(config: ResolvedControlConfig, event: ControlEvent): boolean {\n\treturn config.enabled && config.notifyOn.includes(event.type);\n}\n\nexport function controlNotificationKey(event: ControlEvent, childIntercomTarget?: string): string {\n\tconst childKey = childIntercomTarget ?? (event.index !== undefined ? `${event.runId}:${event.index}` : event.runId);\n\treturn `${childKey}:${event.type}:${event.reason ?? \"idle\"}`;\n}\n\nexport function claimControlNotification(config: ResolvedControlConfig, event: ControlEvent, seenKeys: Set<string>, childIntercomTarget?: string): boolean {\n\tif (!shouldNotifyControlEvent(config, event)) return false;\n\tconst key = controlNotificationKey(event, childIntercomTarget);\n\tif (seenKeys.has(key)) return false;\n\tseenKeys.add(key);\n\treturn true;\n}\n\nfunction formatLongRunningFacts(event: ControlEvent): string | undefined {\n\tconst facts: string[] = [];\n\tif (event.elapsedMs !== undefined) facts.push(`elapsed ${Math.floor(Math.max(0, event.elapsedMs) / 1000)}s`);\n\tif (event.turns !== undefined) facts.push(`${event.turns} turns`);\n\tif (event.tokens !== undefined) facts.push(`${event.tokens} tokens`);\n\tif (event.toolCount !== undefined) facts.push(`${event.toolCount} tools`);\n\tif (event.currentTool) facts.push(`tool ${event.currentTool}${event.currentToolDurationMs !== undefined ? ` ${Math.floor(Math.max(0, event.currentToolDurationMs) / 1000)}s` : \"\"}`);\n\tif (event.currentPath) facts.push(`path ${event.currentPath}`);\n\treturn facts.length > 0 ? facts.join(\" | \") : undefined;\n}\n\nexport function formatControlNoticeMessage(event: ControlEvent, childIntercomTarget?: string): string {\n\tconst runTarget = event.runId;\n\tif (event.reason === \"completion_guard\") {\n\t\treturn [\n\t\t\t`Subagent failed: ${event.agent}`,\n\t\t\t`Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : \"\"}`,\n\t\t\t`Signal: ${event.message}`,\n\t\t\t\"Next: read the output artifact or session from the subagent result, then retry with a more explicit implementation prompt or handle the fix directly.\",\n\t\t\tchildIntercomTarget ? `Run intercom target (may be inactive): ${childIntercomTarget}` : undefined,\n\t\t].filter((line): line is string => Boolean(line)).join(\"\\n\");\n\t}\n\n\tconst nudgeMessage = \"What are you blocked on? Reply with the smallest next step or ask for a decision.\";\n\tconst nudgeCommand = `subagent({ action: \"resume\", id: \"${runTarget}\", ${event.index !== undefined ? `index: ${event.index}, ` : \"\"}message: \"${nudgeMessage}\" })`;\n\tif (event.type === \"active_long_running\") {\n\t\tconst facts = formatLongRunningFacts(event);\n\t\treturn [\n\t\t\t`Subagent active but long-running: ${event.agent}`,\n\t\t\t`Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : \"\"}`,\n\t\t\t`Signal: ${event.message}`,\n\t\t\tfacts ? `Facts: ${facts}` : undefined,\n\t\t\t\"Hint: Inspect status, then nudge if the work seems stuck. Live async nudges interrupt the child before sending the follow-up.\",\n\t\t\t`Nudge: ${nudgeCommand}`,\n\t\t\tchildIntercomTarget ? `Direct intercom target: ${childIntercomTarget}` : undefined,\n\t\t\t`Status: subagent({ action: \"status\", id: \"${runTarget}\" })`,\n\t\t\t`Interrupt: subagent({ action: \"interrupt\", id: \"${runTarget}\" })`,\n\t\t].filter((line): line is string => Boolean(line)).join(\"\\n\");\n\t}\n\n\treturn [\n\t\t`Subagent needs attention: ${event.agent}`,\n\t\t`Run: ${runTarget}${event.index !== undefined ? ` step ${event.index + 1}` : \"\"}`,\n\t\t`Signal: ${event.message}`,\n\t\tevent.recentFailureSummary ? `Recent failures: ${event.recentFailureSummary}` : undefined,\n\t\t\"Hint: Inspect status first unless the run is clearly blocked. Live async nudges interrupt the child before sending the follow-up.\",\n\t\t`Nudge: ${nudgeCommand}`,\n\t\tchildIntercomTarget ? `Direct intercom target: ${childIntercomTarget}` : undefined,\n\t\t`Status: subagent({ action: \"status\", id: \"${runTarget}\" })`,\n\t\t`Interrupt: subagent({ action: \"interrupt\", id: \"${runTarget}\" })`,\n\t].filter((line): line is string => Boolean(line)).join(\"\\n\");\n}\n\nexport function formatControlIntercomMessage(event: ControlEvent, childIntercomTarget?: string): string {\n\tconst statusLabel = event.reason === \"completion_guard\"\n\t\t? \"subagent failed\"\n\t\t: event.type === \"active_long_running\"\n\t\t\t? \"subagent active but long-running\"\n\t\t\t: \"subagent needs attention\";\n\treturn [\n\t\tstatusLabel,\n\t\t\"\",\n\t\tevent.reason === \"completion_guard\"\n\t\t\t? `${event.agent} failed in run ${event.runId}.`\n\t\t\t: event.type === \"active_long_running\"\n\t\t\t\t? `${event.agent} is still active but long-running in run ${event.runId}.`\n\t\t\t\t: `${event.agent} needs attention in run ${event.runId}.`,\n\t\t\"\",\n\t\tformatControlNoticeMessage(event, childIntercomTarget),\n\t].join(\"\\n\");\n}\n"]}