apex-code 0.0.1-alpha.1 → 0.0.1-alpha.11

package/dist/modes/interactive/components/tool-panel.js

@@ -0,0 +1,130 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { paintBackground, theme } from "../theme/theme.js";
+const LIFECYCLE_SYMBOLS = {
+    unicode: { queued: "○", running: "◌", done: "✓", error: "✗" },
+    ascii: { queued: "[ ]", running: "[~]", done: "[x]", error: "[!]" },
+};
+/**
+ * Running takes the brand accent rather than `warning`. Work in progress is
+ * not a caution; amber is reserved for states the user may need to act on.
+ */
+function lifecycleColor(lifecycle) {
+    switch (lifecycle) {
+        case "queued":
+            return "dim";
+        case "running":
+            return "accent";
+        case "done":
+            return "success";
+        case "error":
+            return "error";
+    }
+}
+/**
+ * The status spine drawn down the left edge of a tool panel.
+ *
+ * It is a redundant channel over the lifecycle word in the header, so it is
+ * free to lean on colour. The glyph still distinguishes work that has not
+ * started from work that has, which is the distinction a glance most needs.
+ */
+const SPINE_GLYPHS = {
+    unicode: { queued: "┆", running: "▌", done: "▌", error: "▌" },
+    ascii: { queued: ":", running: "|", done: "|", error: "|" },
+};
+export function formatToolDuration(durationMs) {
+    if (durationMs < 1000)
+        return `${Math.max(0, Math.round(durationMs))}ms`;
+    if (durationMs < 10_000)
+        return `${(durationMs / 1000).toFixed(1)}s`;
+    return `${Math.round(durationMs / 1000)}s`;
+}
+function lifecycleBackground(lifecycle) {
+    if (lifecycle === "done")
+        return "toolSuccessBg";
+    if (lifecycle === "error")
+        return "toolErrorBg";
+    return "toolPendingBg";
+}
+/** Prime-style flat shell for renderer-based tool calls. */
+export class ToolPanelComponent {
+    child;
+    options;
+    constructor(child, options) {
+        this.child = child;
+        this.options = options;
+    }
+    render(width) {
+        if (width <= 0)
+            return [];
+        const padding = Math.min(2, Math.floor((width - 1) / 2));
+        const innerWidth = Math.max(1, width - padding * 2);
+        const childLines = this.child.render(innerWidth);
+        if (childLines.length === 0)
+            return [];
+        const { lifecycle, symbolPreset, durationMs } = this.options;
+        const duration = durationMs === undefined ? "" : ` ${formatToolDuration(durationMs)}`;
+        const state = theme.fg(lifecycleColor(lifecycle), `${LIFECYCLE_SYMBOLS[symbolPreset][lifecycle]} ${lifecycle}${duration}`);
+        const separator = theme.fg("dim", symbolPreset === "ascii" ? " - " : " · ");
+        const stateWidth = visibleWidth(separator) + visibleWidth(state);
+        const label = childLines[0].replace(/\s+$/, "");
+        const header = stateWidth < innerWidth
+            ? `${truncateToWidth(label, innerWidth - stateWidth, "")}${separator}${state}`
+            : truncateToWidth(state, innerWidth, "");
+        const panelLines = [header];
+        if (childLines.length > 1)
+            panelLines.push("", ...childLines.slice(1));
+        const background = lifecycleBackground(lifecycle);
+        // The spine occupies the first column of the existing left padding, so it
+        // marks state without costing the panel a column of content. Below two
+        // columns of padding there is no room for it and it is dropped.
+        const showSpine = padding >= 1;
+        const spine = showSpine
+            ? paintBackground(theme.fg(lifecycleColor(lifecycle), SPINE_GLYPHS[symbolPreset][lifecycle]), background)
+            : "";
+        const leftPadding = " ".repeat(Math.max(0, padding - (showSpine ? 1 : 0)));
+        return panelLines.map((line) => {
+            const clipped = truncateToWidth(line, innerWidth, "");
+            const rightPadding = " ".repeat(Math.max(0, innerWidth - visibleWidth(clipped)));
+            return spine + paintBackground(`${leftPadding}${clipped}${rightPadding}${" ".repeat(padding)}`, background);
+        });
+    }
+    invalidate() {
+        this.child.invalidate?.();
+    }
+}
+/**
+ * Prefixes an existing public tool renderer with Apex-owned lifecycle text.
+ * The wrapped renderer receives the remaining width, so its own wrapping and
+ * cursor-free layout stay intact without a pi-tui hook.
+ */
+export class ToolStatusLineComponent {
+    child;
+    options;
+    constructor(child, options) {
+        this.child = child;
+        this.options = options;
+    }
+    render(width) {
+        if (width <= 0)
+            return [];
+        const { lifecycle, symbolPreset, durationMs } = this.options;
+        const duration = durationMs === undefined ? "" : ` ${formatToolDuration(durationMs)}`;
+        const separator = symbolPreset === "ascii" ? " | " : " · ";
+        const plainPrefix = `${LIFECYCLE_SYMBOLS[symbolPreset][lifecycle]} ${lifecycle}${duration}${separator}`;
+        const prefix = theme.fg(lifecycleColor(lifecycle), plainPrefix);
+        const prefixWidth = visibleWidth(prefix);
+        if (prefixWidth >= width) {
+            return [truncateToWidth(prefix, width, "")];
+        }
+        const childWidth = Math.max(1, width - prefixWidth);
+        const childLines = this.child.render(childWidth);
+        if (childLines.length === 0)
+            return [];
+        const continuation = " ".repeat(prefixWidth);
+        return childLines.map((line, index) => (index === 0 ? prefix : continuation) + line);
+    }
+    invalidate() {
+        this.child.invalidate?.();
+    }
+}
+//# sourceMappingURL=tool-panel.js.map

package/dist/modes/interactive/components/tool-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-panel.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/tool-panel.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Component, truncateToWidth, visibleWidth } from \"@earendil-works/pi-tui\";\nimport { paintBackground, theme } from \"../theme/theme.ts\";\n\nexport type ToolLifecycle = \"queued\" | \"running\" | \"done\" | \"error\";\nexport type ToolSymbolPreset = \"unicode\" | \"ascii\";\n\nconst LIFECYCLE_SYMBOLS: Record<ToolSymbolPreset, Record<ToolLifecycle, string>> = {\n\tunicode: { queued: \"○\", running: \"◌\", done: \"✓\", error: \"✗\" },\n\tascii: { queued: \"[ ]\", running: \"[~]\", done: \"[x]\", error: \"[!]\" },\n};\n\n/**\n * Running takes the brand accent rather than `warning`. Work in progress is\n * not a caution; amber is reserved for states the user may need to act on.\n */\nfunction lifecycleColor(lifecycle: ToolLifecycle): \"dim\" | \"accent\" | \"success\" | \"error\" {\n\tswitch (lifecycle) {\n\t\tcase \"queued\":\n\t\t\treturn \"dim\";\n\t\tcase \"running\":\n\t\t\treturn \"accent\";\n\t\tcase \"done\":\n\t\t\treturn \"success\";\n\t\tcase \"error\":\n\t\t\treturn \"error\";\n\t}\n}\n\n/**\n * The status spine drawn down the left edge of a tool panel.\n *\n * It is a redundant channel over the lifecycle word in the header, so it is\n * free to lean on colour. The glyph still distinguishes work that has not\n * started from work that has, which is the distinction a glance most needs.\n */\nconst SPINE_GLYPHS: Record<ToolSymbolPreset, Record<ToolLifecycle, string>> = {\n\tunicode: { queued: \"┆\", running: \"▌\", done: \"▌\", error: \"▌\" },\n\tascii: { queued: \":\", running: \"|\", done: \"|\", error: \"|\" },\n};\n\nexport function formatToolDuration(durationMs: number): string {\n\tif (durationMs < 1000) return `${Math.max(0, Math.round(durationMs))}ms`;\n\tif (durationMs < 10_000) return `${(durationMs / 1000).toFixed(1)}s`;\n\treturn `${Math.round(durationMs / 1000)}s`;\n}\n\nexport interface ToolStatusLineOptions {\n\tlifecycle: ToolLifecycle;\n\tsymbolPreset: ToolSymbolPreset;\n\tdurationMs?: number;\n}\n\nfunction lifecycleBackground(lifecycle: ToolLifecycle): \"toolPendingBg\" | \"toolSuccessBg\" | \"toolErrorBg\" {\n\tif (lifecycle === \"done\") return \"toolSuccessBg\";\n\tif (lifecycle === \"error\") return \"toolErrorBg\";\n\treturn \"toolPendingBg\";\n}\n\n/** Prime-style flat shell for renderer-based tool calls. */\nexport class ToolPanelComponent implements Component {\n\tprivate readonly child: Component;\n\tprivate readonly options: ToolStatusLineOptions;\n\n\tconstructor(child: Component, options: ToolStatusLineOptions) {\n\t\tthis.child = child;\n\t\tthis.options = options;\n\t}\n\n\trender(width: number): string[] {\n\t\tif (width <= 0) return [];\n\t\tconst padding = Math.min(2, Math.floor((width - 1) / 2));\n\t\tconst innerWidth = Math.max(1, width - padding * 2);\n\t\tconst childLines = this.child.render(innerWidth);\n\t\tif (childLines.length === 0) return [];\n\n\t\tconst { lifecycle, symbolPreset, durationMs } = this.options;\n\t\tconst duration = durationMs === undefined ? \"\" : ` ${formatToolDuration(durationMs)}`;\n\t\tconst state = theme.fg(\n\t\t\tlifecycleColor(lifecycle),\n\t\t\t`${LIFECYCLE_SYMBOLS[symbolPreset][lifecycle]} ${lifecycle}${duration}`,\n\t\t);\n\t\tconst separator = theme.fg(\"dim\", symbolPreset === \"ascii\" ? \" - \" : \" · \");\n\t\tconst stateWidth = visibleWidth(separator) + visibleWidth(state);\n\t\tconst label = childLines[0].replace(/\\s+$/, \"\");\n\t\tconst header =\n\t\t\tstateWidth < innerWidth\n\t\t\t\t? `${truncateToWidth(label, innerWidth - stateWidth, \"\")}${separator}${state}`\n\t\t\t\t: truncateToWidth(state, innerWidth, \"\");\n\t\tconst panelLines = [header];\n\t\tif (childLines.length > 1) panelLines.push(\"\", ...childLines.slice(1));\n\n\t\tconst background = lifecycleBackground(lifecycle);\n\t\t// The spine occupies the first column of the existing left padding, so it\n\t\t// marks state without costing the panel a column of content. Below two\n\t\t// columns of padding there is no room for it and it is dropped.\n\t\tconst showSpine = padding >= 1;\n\t\tconst spine = showSpine\n\t\t\t? paintBackground(theme.fg(lifecycleColor(lifecycle), SPINE_GLYPHS[symbolPreset][lifecycle]), background)\n\t\t\t: \"\";\n\t\tconst leftPadding = \" \".repeat(Math.max(0, padding - (showSpine ? 1 : 0)));\n\t\treturn panelLines.map((line) => {\n\t\t\tconst clipped = truncateToWidth(line, innerWidth, \"\");\n\t\t\tconst rightPadding = \" \".repeat(Math.max(0, innerWidth - visibleWidth(clipped)));\n\t\t\treturn spine + paintBackground(`${leftPadding}${clipped}${rightPadding}${\" \".repeat(padding)}`, background);\n\t\t});\n\t}\n\n\tinvalidate(): void {\n\t\tthis.child.invalidate?.();\n\t}\n}\n\n/**\n * Prefixes an existing public tool renderer with Apex-owned lifecycle text.\n * The wrapped renderer receives the remaining width, so its own wrapping and\n * cursor-free layout stay intact without a pi-tui hook.\n */\nexport class ToolStatusLineComponent implements Component {\n\tprivate readonly child: Component;\n\tprivate readonly options: ToolStatusLineOptions;\n\n\tconstructor(child: Component, options: ToolStatusLineOptions) {\n\t\tthis.child = child;\n\t\tthis.options = options;\n\t}\n\n\trender(width: number): string[] {\n\t\tif (width <= 0) return [];\n\t\tconst { lifecycle, symbolPreset, durationMs } = this.options;\n\t\tconst duration = durationMs === undefined ? \"\" : ` ${formatToolDuration(durationMs)}`;\n\t\tconst separator = symbolPreset === \"ascii\" ? \" | \" : \" · \";\n\t\tconst plainPrefix = `${LIFECYCLE_SYMBOLS[symbolPreset][lifecycle]} ${lifecycle}${duration}${separator}`;\n\t\tconst prefix = theme.fg(lifecycleColor(lifecycle), plainPrefix);\n\t\tconst prefixWidth = visibleWidth(prefix);\n\n\t\tif (prefixWidth >= width) {\n\t\t\treturn [truncateToWidth(prefix, width, \"\")];\n\t\t}\n\n\t\tconst childWidth = Math.max(1, width - prefixWidth);\n\t\tconst childLines = this.child.render(childWidth);\n\t\tif (childLines.length === 0) return [];\n\n\t\tconst continuation = \" \".repeat(prefixWidth);\n\t\treturn childLines.map((line, index) => (index === 0 ? prefix : continuation) + line);\n\t}\n\n\tinvalidate(): void {\n\t\tthis.child.invalidate?.();\n\t}\n}\n"]}

package/dist/modes/interactive/external-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"external-editor.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/external-editor.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElG,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgCxG","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { mkdtempSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface ExternalEditorOptions {\n\tcommand: string;\n\tcontent: string;\n}\n\nexport type ExternalEditorResult = { status: \"complete\"; content: string } | { status: \"failed\" };\n\nexport async function editInExternalEditor(options: ExternalEditorOptions): Promise<ExternalEditorResult> {\n\tconst directory = mkdtempSync(join(tmpdir(), \"pi-editor-\"));\n\tconst filePath = join(directory, \"prompt.md\");\n\ttry {\n\t\twriteFileSync(filePath, options.content, \"utf-8\");\n\t\tconst [editor, ...editorArgs] = options.command.split(\" \");\n\t\tprocess.stdout.write(`Launching external editor: ${options.command}\\nPi will resume when the editor exits.\\n`);\n\n\t\t// Do not use spawnSync here. On Windows, synchronous child_process calls can keep\n\t\t// Node/libuv's console input read active after the parent pauses stdin, racing\n\t\t// vim/nvim for the console input buffer until Ctrl+C cancels the pending read.\n\t\tconst exitCode = await new Promise<number | null>((resolve) => {\n\t\t\tconst child = spawn(editor, [...editorArgs, filePath], {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t\tshell: process.platform === \"win32\",\n\t\t\t});\n\t\t\tchild.on(\"error\", () => resolve(null));\n\t\t\tchild.on(\"close\", (code) => resolve(code));\n\t\t});\n\n\t\tif (exitCode !== 0) {\n\t\t\treturn { status: \"failed\" };\n\t\t}\n\n\t\treturn { status: \"complete\", content: readFileSync(filePath, \"utf-8\").replace(/\\n$/, \"\") };\n\t} finally {\n\t\ttry {\n\t\t\trmSync(directory, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Cleanup is best effort.\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"external-editor.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/external-editor.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAiDlG,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA+BxG","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { mkdtempSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { stripBom } from \"../../utils/text.ts\";\n\nexport interface ExternalEditorOptions {\n\tcommand: string;\n\tcontent: string;\n}\n\nexport type ExternalEditorResult = { status: \"complete\"; content: string } | { status: \"failed\" };\n\nfunction parseCommand(command: string): string[] | undefined {\n\tconst args: string[] = [];\n\tlet current = \"\";\n\tlet quote: '\"' | \"'\" | undefined;\n\tlet escaped = false;\n\tlet started = false;\n\n\tfor (const character of command) {\n\t\tif (escaped) {\n\t\t\tcurrent += character;\n\t\t\tescaped = false;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === \"\\\\\" && quote !== \"'\") {\n\t\t\tescaped = true;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (quote) {\n\t\t\tif (character === quote) quote = undefined;\n\t\t\telse current += character;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\"' || character === \"'\") {\n\t\t\tquote = character;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(character)) {\n\t\t\tif (started) {\n\t\t\t\targs.push(current);\n\t\t\t\tcurrent = \"\";\n\t\t\t\tstarted = false;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tcurrent += character;\n\t\tstarted = true;\n\t}\n\tif (escaped || quote || (!started && args.length === 0)) return undefined;\n\tif (started) args.push(current);\n\tif (!args[0]) return undefined;\n\treturn args;\n}\n\nexport async function editInExternalEditor(options: ExternalEditorOptions): Promise<ExternalEditorResult> {\n\tconst command = parseCommand(options.command);\n\tif (!command) return { status: \"failed\" };\n\n\tconst directory = mkdtempSync(join(tmpdir(), \"apex-code-editor-\"));\n\tconst filePath = join(directory, \"prompt.md\");\n\ttry {\n\t\twriteFileSync(filePath, options.content, \"utf-8\");\n\t\tconst [editor, ...editorArgs] = command;\n\t\tprocess.stdout.write(\n\t\t\t`Launching external editor: ${options.command}\\nApex Code will resume when the editor exits.\\n`,\n\t\t);\n\n\t\t// Do not use spawnSync here. On Windows, synchronous child_process calls can keep\n\t\t// Node/libuv's console input read active after the parent pauses stdin, racing\n\t\t// vim/nvim for the console input buffer until Ctrl+C cancels the pending read.\n\t\tconst exitCode = await new Promise<number | null>((resolve) => {\n\t\t\tconst child = spawn(editor, [...editorArgs, filePath], { stdio: \"inherit\", shell: false });\n\t\t\tchild.on(\"error\", () => resolve(null));\n\t\t\tchild.on(\"close\", (code) => resolve(code));\n\t\t});\n\n\t\tif (exitCode !== 0) return { status: \"failed\" };\n\t\treturn { status: \"complete\", content: stripBom(readFileSync(filePath, \"utf-8\")).replace(/\\n$/, \"\") };\n\t} finally {\n\t\ttry {\n\t\t\trmSync(directory, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Cleanup is best effort.\n\t\t}\n\t}\n}\n"]}

package/dist/modes/interactive/external-editor.js

@@ -2,28 +2,78 @@ import { spawn } from "node:child_process";
 import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { stripBom } from "../../utils/text.js";
+function parseCommand(command) {
+    const args = [];
+    let current = "";
+    let quote;
+    let escaped = false;
+    let started = false;
+    for (const character of command) {
+        if (escaped) {
+            current += character;
+            escaped = false;
+            started = true;
+            continue;
+        }
+        if (character === "\\" && quote !== "'") {
+            escaped = true;
+            started = true;
+            continue;
+        }
+        if (quote) {
+            if (character === quote)
+                quote = undefined;
+            else
+                current += character;
+            started = true;
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            quote = character;
+            started = true;
+            continue;
+        }
+        if (/\s/.test(character)) {
+            if (started) {
+                args.push(current);
+                current = "";
+                started = false;
+            }
+            continue;
+        }
+        current += character;
+        started = true;
+    }
+    if (escaped || quote || (!started && args.length === 0))
+        return undefined;
+    if (started)
+        args.push(current);
+    if (!args[0])
+        return undefined;
+    return args;
+}
 export async function editInExternalEditor(options) {
-    const directory = mkdtempSync(join(tmpdir(), "pi-editor-"));
+    const command = parseCommand(options.command);
+    if (!command)
+        return { status: "failed" };
+    const directory = mkdtempSync(join(tmpdir(), "apex-code-editor-"));
     const filePath = join(directory, "prompt.md");
     try {
         writeFileSync(filePath, options.content, "utf-8");
-        const [editor, ...editorArgs] = options.command.split(" ");
-        process.stdout.write(`Launching external editor: ${options.command}\nPi will resume when the editor exits.\n`);
+        const [editor, ...editorArgs] = command;
+        process.stdout.write(`Launching external editor: ${options.command}\nApex Code will resume when the editor exits.\n`);
         // Do not use spawnSync here. On Windows, synchronous child_process calls can keep
         // Node/libuv's console input read active after the parent pauses stdin, racing
         // vim/nvim for the console input buffer until Ctrl+C cancels the pending read.
         const exitCode = await new Promise((resolve) => {
-            const child = spawn(editor, [...editorArgs, filePath], {
-                stdio: "inherit",
-                shell: process.platform === "win32",
-            });
+            const child = spawn(editor, [...editorArgs, filePath], { stdio: "inherit", shell: false });
             child.on("error", () => resolve(null));
             child.on("close", (code) => resolve(code));
         });
-        if (exitCode !== 0) {
+        if (exitCode !== 0)
             return { status: "failed" };
-        }
-        return { status: "complete", content: readFileSync(filePath, "utf-8").replace(/\n$/, "") };
+        return { status: "complete", content: stripBom(readFileSync(filePath, "utf-8")).replace(/\n$/, "") };
     }
     finally {
         try {

package/dist/modes/interactive/external-editor.js.map

@@ -1 +1 @@
-{"version":3,"file":"external-editor.js","sourceRoot":"","sources":["../../../src/modes/interactive/external-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAA8B,EAAiC;IACzG,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC;QACJ,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,OAAO,CAAC,OAAO,2CAA2C,CAAC,CAAC;QAE/G,kFAAkF;QAClF,+EAA+E;QAC/E,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACtD,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;aACnC,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAA,CAC3C,CAAC,CAAC;QAEH,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC7B,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5F,CAAC;YAAS,CAAC;QACV,IAAI,CAAC;YACJ,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACR,0BAA0B;QAC3B,CAAC;IACF,CAAC;AAAA,CACD","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { mkdtempSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\n\nexport interface ExternalEditorOptions {\n\tcommand: string;\n\tcontent: string;\n}\n\nexport type ExternalEditorResult = { status: \"complete\"; content: string } | { status: \"failed\" };\n\nexport async function editInExternalEditor(options: ExternalEditorOptions): Promise<ExternalEditorResult> {\n\tconst directory = mkdtempSync(join(tmpdir(), \"pi-editor-\"));\n\tconst filePath = join(directory, \"prompt.md\");\n\ttry {\n\t\twriteFileSync(filePath, options.content, \"utf-8\");\n\t\tconst [editor, ...editorArgs] = options.command.split(\" \");\n\t\tprocess.stdout.write(`Launching external editor: ${options.command}\\nPi will resume when the editor exits.\\n`);\n\n\t\t// Do not use spawnSync here. On Windows, synchronous child_process calls can keep\n\t\t// Node/libuv's console input read active after the parent pauses stdin, racing\n\t\t// vim/nvim for the console input buffer until Ctrl+C cancels the pending read.\n\t\tconst exitCode = await new Promise<number | null>((resolve) => {\n\t\t\tconst child = spawn(editor, [...editorArgs, filePath], {\n\t\t\t\tstdio: \"inherit\",\n\t\t\t\tshell: process.platform === \"win32\",\n\t\t\t});\n\t\t\tchild.on(\"error\", () => resolve(null));\n\t\t\tchild.on(\"close\", (code) => resolve(code));\n\t\t});\n\n\t\tif (exitCode !== 0) {\n\t\t\treturn { status: \"failed\" };\n\t\t}\n\n\t\treturn { status: \"complete\", content: readFileSync(filePath, \"utf-8\").replace(/\\n$/, \"\") };\n\t} finally {\n\t\ttry {\n\t\t\trmSync(directory, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Cleanup is best effort.\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"external-editor.js","sourceRoot":"","sources":["../../../src/modes/interactive/external-editor.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { mkdtempSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { stripBom } from \"../../utils/text.ts\";\n\nexport interface ExternalEditorOptions {\n\tcommand: string;\n\tcontent: string;\n}\n\nexport type ExternalEditorResult = { status: \"complete\"; content: string } | { status: \"failed\" };\n\nfunction parseCommand(command: string): string[] | undefined {\n\tconst args: string[] = [];\n\tlet current = \"\";\n\tlet quote: '\"' | \"'\" | undefined;\n\tlet escaped = false;\n\tlet started = false;\n\n\tfor (const character of command) {\n\t\tif (escaped) {\n\t\t\tcurrent += character;\n\t\t\tescaped = false;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === \"\\\\\" && quote !== \"'\") {\n\t\t\tescaped = true;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (quote) {\n\t\t\tif (character === quote) quote = undefined;\n\t\t\telse current += character;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\"' || character === \"'\") {\n\t\t\tquote = character;\n\t\t\tstarted = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(character)) {\n\t\t\tif (started) {\n\t\t\t\targs.push(current);\n\t\t\t\tcurrent = \"\";\n\t\t\t\tstarted = false;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tcurrent += character;\n\t\tstarted = true;\n\t}\n\tif (escaped || quote || (!started && args.length === 0)) return undefined;\n\tif (started) args.push(current);\n\tif (!args[0]) return undefined;\n\treturn args;\n}\n\nexport async function editInExternalEditor(options: ExternalEditorOptions): Promise<ExternalEditorResult> {\n\tconst command = parseCommand(options.command);\n\tif (!command) return { status: \"failed\" };\n\n\tconst directory = mkdtempSync(join(tmpdir(), \"apex-code-editor-\"));\n\tconst filePath = join(directory, \"prompt.md\");\n\ttry {\n\t\twriteFileSync(filePath, options.content, \"utf-8\");\n\t\tconst [editor, ...editorArgs] = command;\n\t\tprocess.stdout.write(\n\t\t\t`Launching external editor: ${options.command}\\nApex Code will resume when the editor exits.\\n`,\n\t\t);\n\n\t\t// Do not use spawnSync here. On Windows, synchronous child_process calls can keep\n\t\t// Node/libuv's console input read active after the parent pauses stdin, racing\n\t\t// vim/nvim for the console input buffer until Ctrl+C cancels the pending read.\n\t\tconst exitCode = await new Promise<number | null>((resolve) => {\n\t\t\tconst child = spawn(editor, [...editorArgs, filePath], { stdio: \"inherit\", shell: false });\n\t\t\tchild.on(\"error\", () => resolve(null));\n\t\t\tchild.on(\"close\", (code) => resolve(code));\n\t\t});\n\n\t\tif (exitCode !== 0) return { status: \"failed\" };\n\t\treturn { status: \"complete\", content: stripBom(readFileSync(filePath, \"utf-8\")).replace(/\\n$/, \"\") };\n\t} finally {\n\t\ttry {\n\t\t\trmSync(directory, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Cleanup is best effort.\n\t\t}\n\t}\n}\n"]}

package/dist/modes/interactive/interactive-mode.d.ts

@@ -6,9 +6,10 @@ import type { ImageContent } from "@earendil-works/pi-ai/compat";
 import type { Terminal } from "@earendil-works/pi-tui";
 import { type TUI, TuiAltScreen, TuiMainScreen } from "@earendil-works/pi-tui";
 import { type AgentSessionRuntime } from "../../core/agent-session-runtime.ts";
+import type { AgentSessionRuntimeDiagnostic } from "../../core/agent-session-services.ts";
 import { SessionManager } from "../../core/session-manager.ts";
-import type { TuiMode } from "../../core/settings-manager.ts";
-import { type LatestPiRelease } from "../../utils/version-check.ts";
+import type { FullscreenExitOutput, TuiMode } from "../../core/settings-manager.ts";
+import { type LatestApexCodeRelease } from "../../utils/version-check.ts";
 export declare function formatResumeCommand(sessionManager: SessionManager): string | undefined;
 /**
  * Options for InteractiveMode initialization.
@@ -16,6 +17,8 @@ export declare function formatResumeCommand(sessionManager: SessionManager): str
 export interface InteractiveModeOptions {
     /** Providers that were migrated to auth.json (shows warning) */
     migratedProviders?: string[];
+    /** Diagnostics collected before the interactive TUI was initialized. */
+    startupDiagnostics?: AgentSessionRuntimeDiagnostic[];
     /** Warning message if session model couldn't be restored */
     modelFallbackMessage?: string;
     /** Cwd to trust after reload if it gained a .pi directory during this implicitly trusted session. */
@@ -30,6 +33,8 @@ export interface InteractiveModeOptions {
     verbose?: boolean;
     /** TUI layout mode. */
     tuiMode?: TuiMode;
+    /** Initial interactive theme setting for this invocation. */
+    initialThemeSetting?: string;
 }
 interface InteractiveTuiOptions {
     tuiMode: TuiMode;
@@ -44,6 +49,8 @@ export declare function createInteractiveTui(options: InteractiveTuiOptions): Tu
 export declare function createInteractiveTuiReference(getTui: () => TUI): TUI;
 export declare class InteractiveMode {
     private runtimeHost;
+    /** Settled once the most recent /settings permission-mode write has hit disk. */
+    private pendingPermissionModeWrite;
     private renderer;
     private ui;
     private mainScreenRenderState;
@@ -66,6 +73,14 @@ export declare class InteractiveMode {
     private footer;
     private footerContainer;
     private footerDataProvider;
+    /**
+     * Whether the startup screen is showing its counted inventory line.
+     *
+     * Warnings are only allowed to collapse into that count when the count is
+     * actually on screen. Under a quiet startup there is no splash header, so
+     * collapsing them would hide conflicts entirely rather than summarise them.
+     */
+    private startupInventoryVisible;
     private keybindings;
     private version;
     private isInitialized;
@@ -86,6 +101,7 @@ export declare class InteractiveMode {
     private anthropicSubscriptionWarningShown;
     private lastStatusSpacer;
     private lastStatusText;
+    private managedToolStatusStarted;
     private streamingComponent;
     private streamingMessage;
     private pendingTools;
@@ -97,7 +113,9 @@ export declare class InteractiveMode {
     private unsubscribe?;
     private signalCleanupHandlers;
     private isBashMode;
+    private firstUseHints;
     private bashComponent;
+    private isHandlingBashCommand;
     private pendingBashComponents;
     private autoCompactionEscapeHandler?;
     private retryEscapeHandler?;
@@ -123,10 +141,26 @@ export declare class InteractiveMode {
     private get agent();
     private get sessionManager();
     private get settingsManager();
+    private offerFirstUseHint;
     constructor(runtimeHost: AgentSessionRuntime, options?: InteractiveModeOptions);
     private getAutocompleteSourceTag;
     private prefixAutocompleteDescription;
     private getBuiltInCommandConflictDiagnostics;
+    /**
+     * Every *registered* command: builtin, prompt template, extension, and skill.
+     *
+     * One function rather than two because `/help` renders this list and autocomplete
+     * completes it. Built in two places they would disagree the first time either grew a
+     * source, and the disagreement would show up as a command a user can complete but not
+     * find, or find but not run.
+     *
+     * A few commands are dispatched without being registered -- `/debug`, and the
+     * `/arminsayshi` and `/dementedelves` easter eggs. They are absent here on purpose,
+     * which is also why autocomplete has never offered them. "Registered" is the boundary
+     * both surfaces share; listing them in `/help` would advertise what completion cannot
+     * complete.
+     */
+    private collectSessionCommands;
     private createBaseAutocompleteProvider;
     private setupAutocompleteProvider;
     private showStartupNoticesIfNeeded;
@@ -150,7 +184,6 @@ export declare class InteractiveMode {
      * Only shows new entries since last seen version, skips for resumed sessions.
      */
     private getChangelogForDisplay;
-    private reportInstallTelemetry;
     private getMarkdownThemeWithSettings;
     private formatDisplayPath;
     private formatExtensionDisplayPath;
@@ -175,12 +208,37 @@ export declare class InteractiveMode {
     private formatPathWithSource;
     private formatDiagnostics;
     private showLoadedResources;
+    /**
+     * Every startup diagnostic, grouped by the resource kind that produced it.
+     *
+     * One list feeds both the counted line in the header and the detailed
+     * listing, so the two can never disagree about how many issues exist.
+     */
+    private collectDiagnosticGroups;
+    /**
+     * The counted line in the ruled band under the mark.
+     *
+     * The startup screen used to print all 152 skill names across fifteen rows.
+     * A count answers the only question that screen can usefully answer, which
+     * is what got loaded; the names live behind /resources now.
+     */
+    /**
+     * The sigil row under the hint: how to reach commands, bash, and files.
+     *
+     * These are the only three characters that change what the composer does, so
+     * they take the accent and everything around them stays quiet.
+     */
+    /** Live keybindings under the autocomplete dropdown. */
+    private buildAutocompleteFooter;
+    private buildStartupShortcuts;
+    private buildStartupInventory;
     private bindCurrentSessionExtensions;
     private applyFullscreenScrollbarSetting;
     private applyRuntimeSettings;
     private rebindCurrentSession;
     private handleFatalRuntimeError;
     private renderCurrentSessionState;
+    private clearPendingTools;
     /**
      * Get a registered tool definition by name (for custom rendering).
      */
@@ -235,6 +293,13 @@ export declare class InteractiveMode {
      * Hide the extension selector.
      */
     private hideExtensionSelector;
+    private showConfigurationIndex;
+    /**
+     * Report configured MCP servers and their live connection state. Replaces a string
+     * that offered MCP management from `apex-code config`, which manages package
+     * resources and has never been able to configure a server.
+     */
+    private describeMcpServers;
     private showExtensionConfirm;
     private promptForMissingSessionCwd;
     /**
@@ -270,11 +335,14 @@ export declare class InteractiveMode {
     private setupKeyHandlers;
     private handleRightClickPaste;
     private handleClipboardPaste;
+    private handleStartupSubmit;
     private setupEditorSubmitHandler;
     private subscribeToAgent;
     private handleEvent;
     /** Extract text content from a user message */
     private getUserMessageText;
+    /** Show a managed-tool status update in the chat. */
+    private showManagedToolStatus;
     /**
      * Show a status message in the chat.
      *
@@ -292,6 +360,11 @@ export declare class InteractiveMode {
      * @param options.populateHistory Add user messages to editor history
      */
     private renderSessionEntries;
+    /**
+     * Render billing usage for a compaction or branch summary. The notice is derived
+     * from persisted summary usage and is not stored as a separate session entry.
+     */
+    private addCompactionCostNotice;
     /**
      * Show a transcript notice when a completed assistant message paid for a
      * significant cache miss. Only states observable facts: the miss itself,
@@ -341,7 +414,7 @@ export declare class InteractiveMode {
     clearEditor(): void;
     showError(errorMessage: string): void;
     showWarning(warningMessage: string): void;
-    showNewVersionNotification(release: LatestPiRelease): void;
+    showNewVersionNotification(release: LatestApexCodeRelease): void;
     showPackageUpdateNotification(packages: string[]): void;
     /**
      * Get all queued messages (read-only).
@@ -366,7 +439,12 @@ export declare class InteractiveMode {
      * @param create Factory that receives a `done` callback and returns the component and focus target
      */
     private showSelector;
+    private refreshFooterPermissionMode;
+    private applyPermissionMode;
     private showSettingsSelector;
+    private handleThinkingCommand;
+    private selectThinkingLevel;
+    private showThinkingSelector;
     private handleModelCommand;
     private findExactModelMatch;
     /** Update the footer's available provider count from the current snapshot without refreshing catalogs. */
@@ -415,6 +493,12 @@ export declare class InteractiveMode {
      */
     private getEditorKeyDisplay;
     private handleHotkeysCommand;
+    /**
+     * Renders what `collectSessionCommands` returns, so the list a user reads and the list
+     * autocomplete offers are the same list rather than two that agree today. Unregistered
+     * dispatch-only commands are outside that boundary; see the note there.
+     */
+    private handleHelpCommand;
     private handleClearCommand;
     private handleDebugCommand;
     private handleArminSaysHi;
@@ -422,8 +506,9 @@ export declare class InteractiveMode {
     private handleDaxnuts;
     private checkDaxnutsEasterEgg;
     private handleBashCommand;
+    private runBashCommand;
     private handleCompactCommand;
-    stop(): void;
+    stop(fullscreenExitOutput?: FullscreenExitOutput): void;
 }
 export {};
 //# sourceMappingURL=interactive-mode.d.ts.map