@astralyn/pi 0.84.3 → 0.84.5

package/dist/extensions/background/index.js

@@ -0,0 +1,332 @@
+/**
+ * background — run bash commands in the background.
+ *
+ * Tools: bg_bash starts a task and returns immediately; the result arrives as
+ * a <background-task> notification (queued behind the current run while
+ * streaming, waking the agent when idle). bg_logs reads a bounded slice of a
+ * task's output file; bg_kill stops a single task. /bg opens the interactive
+ * task manager. Running counts surface in the footer via ctx.ui.setStatus.
+ */
+import { Type } from "typebox";
+import { getAgentDir } from "../../config.js";
+import { SettingsManager } from "../../core/settings-manager.js";
+import { createLocalBashOperations, resolveSpawnContext } from "../../core/tools/bash.js";
+import { DEFAULT_MAX_BYTES, formatSize } from "../../core/tools/truncate.js";
+import { sanitizeBinaryOutput } from "../../utils/shell.js";
+import { BackgroundTasksMenu } from "./manager.js";
+import { BackgroundTaskRegistry, formatDuration, readOutputSlice, } from "./registry.js";
+import { commandLabel, renderBackgroundNotification, renderBgBashCall, renderBgBashResult, renderBgKillCall, renderBgLogsCall, } from "./render.js";
+export const BG_NOTIFICATION_TYPE = "background-task";
+const BG_LOGS_DEFAULT_BYTES = 8 * 1024;
+const BG_LOGS_MIN_BYTES = 256;
+const bgBashSchema = Type.Object({
+    command: Type.String({ description: "Bash command to run in the background" }),
+    timeout: Type.Optional(Type.Number({
+        description: "Timeout in seconds (optional, no default; must be positive). On expiry the task is killed and reported as timeout.",
+    })),
+});
+const bgLogsSchema = Type.Object({
+    taskId: Type.String({ description: "Task id; a unique prefix is accepted (e.g. 'bg-3f' or '3f')" }),
+    mode: Type.Optional(Type.Union([Type.Literal("tail"), Type.Literal("head")], {
+        description: "Read from the end (default) or the start of the output",
+    })),
+    bytes: Type.Optional(Type.Number({
+        description: `Max bytes to return (default ${BG_LOGS_DEFAULT_BYTES}, max ${DEFAULT_MAX_BYTES})`,
+    })),
+});
+const bgKillSchema = Type.Object({
+    taskId: Type.String({ description: "Task id; a unique prefix is accepted" }),
+});
+export function escapeXml(text) {
+    return text
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+export function buildNotificationContent(notification) {
+    const task = notification.task;
+    const runtime = formatDuration((task.endedAt ?? task.startedAt) - task.startedAt);
+    const exitCode = task.exitCode === undefined || task.exitCode === null ? "" : ` exitCode="${task.exitCode}"`;
+    const lines = [
+        `<background-task id="${task.id}" status="${task.status}"${exitCode} runtime="${runtime}">`,
+        `<command>${escapeXml(task.command)}</command>`,
+        `<output-file>${escapeXml(task.outputPath)}</output-file>`,
+    ];
+    if (task.error) {
+        lines.push(`<error>${escapeXml(task.error)}</error>`);
+    }
+    if (notification.tailError) {
+        lines.push(`<output-tail unavailable="${escapeXml(notification.tailError)}"/>`);
+    }
+    else {
+        const attrs = [
+            `bytes="${notification.tailBytes}"`,
+            `totalBytes="${notification.totalBytes}"`,
+            notification.tailTruncated ? 'truncated="true"' : "",
+            notification.tailStartsMidLine ? 'startsMidLine="true"' : "",
+        ]
+            .filter(Boolean)
+            .join(" ");
+        const tail = notification.tailText.length > 0 ? escapeXml(notification.tailText) : "(no output)";
+        lines.push(`<output-tail ${attrs}>`, tail.trimEnd(), "</output-tail>");
+    }
+    lines.push("</background-task>");
+    return lines.join("\n");
+}
+export function formatStatusline(counts) {
+    if (counts.total === 0)
+        return undefined;
+    const ended = counts.total - counts.running;
+    const parts = [];
+    if (counts.running > 0)
+        parts.push(`${counts.running} running`);
+    if (ended > 0)
+        parts.push(`${ended} done`);
+    return `bg ${parts.join(" · ")}`;
+}
+function describeResolveFailure(input, result) {
+    if (result.reason === "ambiguous") {
+        const lines = result.candidates.map((task) => `  ${task.id} (${task.status})  ${commandLabel(task.command, 60)}`);
+        return `Task id "${input}" is ambiguous. Candidates:\n${lines.join("\n")}`;
+    }
+    return `No background task matches "${input}". Check the id returned by bg_bash or open /bg.`;
+}
+function describeTaskLine(task, now) {
+    const duration = formatDuration((task.endedAt ?? now) - task.startedAt);
+    const exit = task.exitCode !== undefined && task.exitCode !== null ? ` exit ${task.exitCode}` : "";
+    return `  ${task.id}  ${task.status}${exit}  ${duration}  ${commandLabel(task.command, 40)}`;
+}
+function toNotificationDetails(notification) {
+    const task = notification.task;
+    return {
+        taskId: task.id,
+        command: task.command,
+        status: task.status,
+        exitCode: task.exitCode,
+        runtimeMs: (task.endedAt ?? task.startedAt) - task.startedAt,
+        outputPath: task.outputPath,
+        totalBytes: notification.totalBytes,
+        tailText: notification.tailText,
+        tailTruncated: notification.tailTruncated,
+        error: task.error,
+        tailError: notification.tailError,
+    };
+}
+/** Local shell operations honoring the session's configured shell path. */
+function createSessionBashOperations(ctx) {
+    const settings = SettingsManager.create(ctx.cwd, getAgentDir(), {
+        projectTrusted: ctx.isProjectTrusted(),
+    });
+    return createLocalBashOperations({ shellPath: settings.getShellPath() });
+}
+/** Factory with injectable seams for tests; the default export uses production wiring. */
+export function createBackgroundExtension(overrides) {
+    return (pi) => {
+        let registry;
+        let sessionCtx;
+        const requireRegistry = () => {
+            if (!registry)
+                throw new Error("Background tasks are not available yet (no active session).");
+            return registry;
+        };
+        const resolveTaskOrThrow = (taskId) => {
+            const resolved = requireRegistry().resolveTask(taskId);
+            if (!resolved.ok)
+                throw new Error(describeResolveFailure(taskId, resolved));
+            return resolved.task;
+        };
+        const updateStatus = () => {
+            if (!registry || registry.isShuttingDown)
+                return;
+            sessionCtx?.ui.setStatus("background", formatStatusline(registry.counts()));
+        };
+        pi.on("session_start", (_event, ctx) => {
+            sessionCtx = ctx;
+            // Defensive: a leftover registry (session_shutdown not seen) must not leak processes.
+            if (registry)
+                void registry.shutdown();
+            registry = new BackgroundTaskRegistry({
+                operations: overrides?.operations ?? createSessionBashOperations(ctx),
+                outputDir: overrides?.outputDir,
+                maxOutputBytes: overrides?.maxOutputBytes,
+                onNotify: (notification) => {
+                    pi.sendMessage({
+                        customType: BG_NOTIFICATION_TYPE,
+                        content: buildNotificationContent(notification),
+                        display: true,
+                        details: toNotificationDetails(notification),
+                    }, { deliverAs: "followUp", triggerTurn: true });
+                },
+                onChange: updateStatus,
+            });
+            updateStatus();
+        });
+        pi.on("session_shutdown", async (_event, ctx) => {
+            ctx.ui.setStatus("background", undefined);
+            sessionCtx = undefined;
+            const active = registry;
+            registry = undefined;
+            await active?.shutdown();
+        });
+        pi.registerTool({
+            name: "bg_bash",
+            label: "bg bash",
+            description: "Run a bash command in the background and return immediately with a task id and output file path. " +
+                "The result (status, exit code, output tail) arrives automatically as a <background-task> notification " +
+                "when the task ends. Use for long-running commands such as dev servers, watch builds, or slow tests. " +
+                "Optionally provide a timeout in seconds.",
+            promptSnippet: "Run bash commands in the background (bg_bash); results arrive automatically",
+            promptGuidelines: [
+                "Use bg_bash for long-running commands (servers, builds, slow tests). Never poll for completion with sleep loops or repeated bg_logs; the <background-task> notification arrives automatically when the task ends. Use bg_logs for an early peek at a running task and bg_kill to stop one.",
+            ],
+            parameters: bgBashSchema,
+            async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+                if (params.timeout !== undefined && (!Number.isFinite(params.timeout) || params.timeout <= 0)) {
+                    throw new Error("Invalid timeout: must be a positive number of seconds.");
+                }
+                // Same PI_* session variables as the built-in bash tool, snapshotted at start.
+                const spawnContext = resolveSpawnContext(params.command, ctx.cwd, undefined, true, ctx);
+                // Deliberately ignore the turn signal: aborting the current turn must
+                // not kill the background task (that is what bg_kill is for).
+                const task = requireRegistry().startTask({
+                    command: params.command,
+                    cwd: ctx.cwd,
+                    timeoutSeconds: params.timeout,
+                    env: spawnContext.env,
+                });
+                const text = [
+                    `Started background task ${task.id}.`,
+                    `Output file: ${task.outputPath}`,
+                    "",
+                    "Do NOT poll for completion (no sleep loops, no repeated bg_logs). A <background-task> " +
+                        "notification with the result and output tail arrives automatically when the task ends — " +
+                        "continue independent work or end the turn. Use bg_logs for an early peek, bg_kill to stop it.",
+                ].join("\n");
+                return {
+                    content: [{ type: "text", text }],
+                    details: { taskId: task.id, outputPath: task.outputPath, command: params.command },
+                };
+            },
+            renderCall(args, theme, context) {
+                return renderBgBashCall(args, theme, context);
+            },
+            renderResult(result, options, theme, context) {
+                return renderBgBashResult(result, options, theme, context);
+            },
+        });
+        pi.registerTool({
+            name: "bg_logs",
+            label: "bg logs",
+            description: `Read a bounded slice of a background task's output file (default: last ${formatSize(BG_LOGS_DEFAULT_BYTES)}, ` +
+                `max ${formatSize(DEFAULT_MAX_BYTES)}). Works while the task is still running. ` +
+                "Do not call this in a polling loop; completion arrives as a notification.",
+            parameters: bgLogsSchema,
+            async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+                const task = resolveTaskOrThrow(params.taskId);
+                const mode = params.mode ?? "tail";
+                const maxBytes = Math.min(DEFAULT_MAX_BYTES, Math.max(BG_LOGS_MIN_BYTES, Math.floor(params.bytes ?? BG_LOGS_DEFAULT_BYTES)));
+                let slice;
+                try {
+                    slice = await readOutputSlice(task.outputPath, { mode, maxBytes });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    throw new Error(`Could not read output for ${task.id} (${task.status}): ${message}\nOutput file: ${task.outputPath}`);
+                }
+                const text = sanitizeBinaryOutput(slice.text);
+                const noticeParts = slice.truncated
+                    ? [
+                        `${mode} ${formatSize(slice.sliceBytes)} of ${formatSize(slice.totalBytes)}`,
+                        `task ${task.id} ${task.status}`,
+                        ...(slice.startsMidLine ? ["first line may be partial"] : []),
+                        `full output: ${task.outputPath}`,
+                    ]
+                    : [
+                        `task ${task.id} ${task.status}`,
+                        `${formatSize(slice.totalBytes)} total`,
+                        `output: ${task.outputPath}`,
+                    ];
+                const body = text.length > 0 ? text : "(no output yet)";
+                return {
+                    content: [{ type: "text", text: `[${noticeParts.join(" · ")}]\n${body}` }],
+                    details: {
+                        taskId: task.id,
+                        mode,
+                        sliceBytes: slice.sliceBytes,
+                        totalBytes: slice.totalBytes,
+                        outputPath: task.outputPath,
+                    },
+                };
+            },
+            renderCall(args, theme) {
+                return renderBgLogsCall(args, theme);
+            },
+        });
+        pi.registerTool({
+            name: "bg_kill",
+            label: "bg kill",
+            description: "Kill a running background task (the whole process tree). The terminal status and output tail " +
+                "still arrive as the task's completion notification.",
+            parameters: bgKillSchema,
+            async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+                const task = resolveTaskOrThrow(params.taskId);
+                const result = requireRegistry().killTask(task.id);
+                if (!result.killed) {
+                    const exit = task.exitCode !== undefined && task.exitCode !== null ? `, exit ${task.exitCode}` : "";
+                    throw new Error(`Task ${task.id} is not running (status: ${task.status}${exit}).`);
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Killed task ${task.id}. A completion notification follows once the process tree is reaped.`,
+                        },
+                    ],
+                    details: { taskId: task.id, command: task.command },
+                };
+            },
+            renderCall(args, theme) {
+                return renderBgKillCall(args, theme);
+            },
+        });
+        pi.registerMessageRenderer(BG_NOTIFICATION_TYPE, renderBackgroundNotification);
+        pi.registerCommand("bg", {
+            description: "View and manage background tasks",
+            handler: async (_args, ctx) => {
+                const active = registry;
+                if (!active || active.counts().total === 0) {
+                    ctx.ui.notify("No background tasks.", "info");
+                    return;
+                }
+                if (ctx.mode !== "tui") {
+                    // RPC/print: ctx.ui.custom is unavailable — show a bounded summary.
+                    const lines = active
+                        .listTasks()
+                        .slice(0, 10)
+                        .map((task) => describeTaskLine(task, Date.now()));
+                    ctx.ui.notify(`Background tasks:\n${lines.join("\n")}\nUse bg_kill <id> to stop a task.`, "info");
+                    return;
+                }
+                await showBackgroundManager(ctx, active);
+            },
+        });
+    };
+}
+async function showBackgroundManager(ctx, registry) {
+    // No overlay options: the component mounts inline in the editor slot, like /model.
+    await ctx.ui.custom((tui, theme, keybindings, done) => new BackgroundTasksMenu({
+        tui,
+        theme,
+        keybindings,
+        host: {
+            listTasks: () => registry.listTasks(),
+            killTask: (id) => registry.killTask(id),
+            readSlice: (filePath, options) => readOutputSlice(filePath, options),
+        },
+        onClose: () => done(undefined),
+    }));
+}
+export default createBackgroundExtension();
+//# sourceMappingURL=index.js.map

package/dist/extensions/background/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/background/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * background — run bash commands in the background.\n *\n * Tools: bg_bash starts a task and returns immediately; the result arrives as\n * a <background-task> notification (queued behind the current run while\n * streaming, waking the agent when idle). bg_logs reads a bounded slice of a\n * task's output file; bg_kill stops a single task. /bg opens the interactive\n * task manager. Running counts surface in the footer via ctx.ui.setStatus.\n */\n\nimport { type Static, Type } from \"typebox\";\nimport { getAgentDir } from \"../../config.ts\";\nimport type {\n\tAgentToolResult,\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n} from \"../../core/extensions/types.ts\";\nimport { SettingsManager } from \"../../core/settings-manager.ts\";\nimport { type BashOperations, createLocalBashOperations, resolveSpawnContext } from \"../../core/tools/bash.ts\";\nimport { DEFAULT_MAX_BYTES, formatSize } from \"../../core/tools/truncate.ts\";\nimport { sanitizeBinaryOutput } from \"../../utils/shell.ts\";\nimport { BackgroundTasksMenu } from \"./manager.ts\";\nimport {\n\tBackgroundTaskRegistry,\n\ttype BgTask,\n\ttype BgTaskNotification,\n\ttype BgTaskStatus,\n\tformatDuration,\n\ttype ResolveTaskResult,\n\treadOutputSlice,\n} from \"./registry.ts\";\nimport {\n\tcommandLabel,\n\trenderBackgroundNotification,\n\trenderBgBashCall,\n\trenderBgBashResult,\n\trenderBgKillCall,\n\trenderBgLogsCall,\n} from \"./render.ts\";\n\nexport const BG_NOTIFICATION_TYPE = \"background-task\";\nconst BG_LOGS_DEFAULT_BYTES = 8 * 1024;\nconst BG_LOGS_MIN_BYTES = 256;\n\nconst bgBashSchema = Type.Object({\n\tcommand: Type.String({ description: \"Bash command to run in the background\" }),\n\ttimeout: Type.Optional(\n\t\tType.Number({\n\t\t\tdescription:\n\t\t\t\t\"Timeout in seconds (optional, no default; must be positive). On expiry the task is killed and reported as timeout.\",\n\t\t}),\n\t),\n});\n\nconst bgLogsSchema = Type.Object({\n\ttaskId: Type.String({ description: \"Task id; a unique prefix is accepted (e.g. 'bg-3f' or '3f')\" }),\n\tmode: Type.Optional(\n\t\tType.Union([Type.Literal(\"tail\"), Type.Literal(\"head\")], {\n\t\t\tdescription: \"Read from the end (default) or the start of the output\",\n\t\t}),\n\t),\n\tbytes: Type.Optional(\n\t\tType.Number({\n\t\t\tdescription: `Max bytes to return (default ${BG_LOGS_DEFAULT_BYTES}, max ${DEFAULT_MAX_BYTES})`,\n\t\t}),\n\t),\n});\n\nconst bgKillSchema = Type.Object({\n\ttaskId: Type.String({ description: \"Task id; a unique prefix is accepted\" }),\n});\n\nexport type BgBashInput = Static<typeof bgBashSchema>;\nexport type BgLogsInput = Static<typeof bgLogsSchema>;\nexport type BgKillInput = Static<typeof bgKillSchema>;\n\nexport interface BgBashDetails {\n\ttaskId: string;\n\toutputPath: string;\n\tcommand: string;\n}\n\nexport interface BgLogsDetails {\n\ttaskId: string;\n\tmode: \"head\" | \"tail\";\n\tsliceBytes: number;\n\ttotalBytes: number;\n\toutputPath: string;\n}\n\nexport interface BgKillDetails {\n\ttaskId: string;\n\tcommand: string;\n}\n\nexport interface BgNotificationDetails {\n\ttaskId: string;\n\tcommand: string;\n\tstatus: BgTaskStatus;\n\texitCode: number | null | undefined;\n\truntimeMs: number;\n\toutputPath: string;\n\ttotalBytes: number;\n\ttailText: string;\n\ttailTruncated: boolean;\n\terror?: string;\n\ttailError?: string;\n}\n\nexport function escapeXml(text: string): string {\n\treturn text\n\t\t.replaceAll(\"&\", \"&amp;\")\n\t\t.replaceAll(\"<\", \"&lt;\")\n\t\t.replaceAll(\">\", \"&gt;\")\n\t\t.replaceAll('\"', \"&quot;\")\n\t\t.replaceAll(\"'\", \"&apos;\");\n}\n\nexport function buildNotificationContent(notification: BgTaskNotification): string {\n\tconst task = notification.task;\n\tconst runtime = formatDuration((task.endedAt ?? task.startedAt) - task.startedAt);\n\tconst exitCode = task.exitCode === undefined || task.exitCode === null ? \"\" : ` exitCode=\"${task.exitCode}\"`;\n\tconst lines = [\n\t\t`<background-task id=\"${task.id}\" status=\"${task.status}\"${exitCode} runtime=\"${runtime}\">`,\n\t\t`<command>${escapeXml(task.command)}</command>`,\n\t\t`<output-file>${escapeXml(task.outputPath)}</output-file>`,\n\t];\n\tif (task.error) {\n\t\tlines.push(`<error>${escapeXml(task.error)}</error>`);\n\t}\n\tif (notification.tailError) {\n\t\tlines.push(`<output-tail unavailable=\"${escapeXml(notification.tailError)}\"/>`);\n\t} else {\n\t\tconst attrs = [\n\t\t\t`bytes=\"${notification.tailBytes}\"`,\n\t\t\t`totalBytes=\"${notification.totalBytes}\"`,\n\t\t\tnotification.tailTruncated ? 'truncated=\"true\"' : \"\",\n\t\t\tnotification.tailStartsMidLine ? 'startsMidLine=\"true\"' : \"\",\n\t\t]\n\t\t\t.filter(Boolean)\n\t\t\t.join(\" \");\n\t\tconst tail = notification.tailText.length > 0 ? escapeXml(notification.tailText) : \"(no output)\";\n\t\tlines.push(`<output-tail ${attrs}>`, tail.trimEnd(), \"</output-tail>\");\n\t}\n\tlines.push(\"</background-task>\");\n\treturn lines.join(\"\\n\");\n}\n\nexport function formatStatusline(counts: { running: number; total: number }): string | undefined {\n\tif (counts.total === 0) return undefined;\n\tconst ended = counts.total - counts.running;\n\tconst parts: string[] = [];\n\tif (counts.running > 0) parts.push(`${counts.running} running`);\n\tif (ended > 0) parts.push(`${ended} done`);\n\treturn `bg ${parts.join(\" · \")}`;\n}\n\nfunction describeResolveFailure(input: string, result: ResolveTaskResult & { ok: false }): string {\n\tif (result.reason === \"ambiguous\") {\n\t\tconst lines = result.candidates.map((task) => `  ${task.id} (${task.status})  ${commandLabel(task.command, 60)}`);\n\t\treturn `Task id \"${input}\" is ambiguous. Candidates:\\n${lines.join(\"\\n\")}`;\n\t}\n\treturn `No background task matches \"${input}\". Check the id returned by bg_bash or open /bg.`;\n}\n\nfunction describeTaskLine(task: BgTask, now: number): string {\n\tconst duration = formatDuration((task.endedAt ?? now) - task.startedAt);\n\tconst exit = task.exitCode !== undefined && task.exitCode !== null ? ` exit ${task.exitCode}` : \"\";\n\treturn `  ${task.id}  ${task.status}${exit}  ${duration}  ${commandLabel(task.command, 40)}`;\n}\n\nfunction toNotificationDetails(notification: BgTaskNotification): BgNotificationDetails {\n\tconst task = notification.task;\n\treturn {\n\t\ttaskId: task.id,\n\t\tcommand: task.command,\n\t\tstatus: task.status,\n\t\texitCode: task.exitCode,\n\t\truntimeMs: (task.endedAt ?? task.startedAt) - task.startedAt,\n\t\toutputPath: task.outputPath,\n\t\ttotalBytes: notification.totalBytes,\n\t\ttailText: notification.tailText,\n\t\ttailTruncated: notification.tailTruncated,\n\t\terror: task.error,\n\t\ttailError: notification.tailError,\n\t};\n}\n\nexport interface BackgroundExtensionOverrides {\n\toperations?: BashOperations;\n\toutputDir?: string;\n\tmaxOutputBytes?: number;\n}\n\n/** Local shell operations honoring the session's configured shell path. */\nfunction createSessionBashOperations(ctx: ExtensionContext): BashOperations {\n\tconst settings = SettingsManager.create(ctx.cwd, getAgentDir(), {\n\t\tprojectTrusted: ctx.isProjectTrusted(),\n\t});\n\treturn createLocalBashOperations({ shellPath: settings.getShellPath() });\n}\n\n/** Factory with injectable seams for tests; the default export uses production wiring. */\nexport function createBackgroundExtension(overrides?: BackgroundExtensionOverrides): (pi: ExtensionAPI) => void {\n\treturn (pi: ExtensionAPI) => {\n\t\tlet registry: BackgroundTaskRegistry | undefined;\n\t\tlet sessionCtx: ExtensionContext | undefined;\n\n\t\tconst requireRegistry = (): BackgroundTaskRegistry => {\n\t\t\tif (!registry) throw new Error(\"Background tasks are not available yet (no active session).\");\n\t\t\treturn registry;\n\t\t};\n\n\t\tconst resolveTaskOrThrow = (taskId: string): BgTask => {\n\t\t\tconst resolved = requireRegistry().resolveTask(taskId);\n\t\t\tif (!resolved.ok) throw new Error(describeResolveFailure(taskId, resolved));\n\t\t\treturn resolved.task;\n\t\t};\n\n\t\tconst updateStatus = () => {\n\t\t\tif (!registry || registry.isShuttingDown) return;\n\t\t\tsessionCtx?.ui.setStatus(\"background\", formatStatusline(registry.counts()));\n\t\t};\n\n\t\tpi.on(\"session_start\", (_event, ctx) => {\n\t\t\tsessionCtx = ctx;\n\t\t\t// Defensive: a leftover registry (session_shutdown not seen) must not leak processes.\n\t\t\tif (registry) void registry.shutdown();\n\t\t\tregistry = new BackgroundTaskRegistry({\n\t\t\t\toperations: overrides?.operations ?? createSessionBashOperations(ctx),\n\t\t\t\toutputDir: overrides?.outputDir,\n\t\t\t\tmaxOutputBytes: overrides?.maxOutputBytes,\n\t\t\t\tonNotify: (notification) => {\n\t\t\t\t\tpi.sendMessage(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tcustomType: BG_NOTIFICATION_TYPE,\n\t\t\t\t\t\t\tcontent: buildNotificationContent(notification),\n\t\t\t\t\t\t\tdisplay: true,\n\t\t\t\t\t\t\tdetails: toNotificationDetails(notification),\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{ deliverAs: \"followUp\", triggerTurn: true },\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t\tonChange: updateStatus,\n\t\t\t});\n\t\t\tupdateStatus();\n\t\t});\n\n\t\tpi.on(\"session_shutdown\", async (_event, ctx) => {\n\t\t\tctx.ui.setStatus(\"background\", undefined);\n\t\t\tsessionCtx = undefined;\n\t\t\tconst active = registry;\n\t\t\tregistry = undefined;\n\t\t\tawait active?.shutdown();\n\t\t});\n\n\t\tpi.registerTool<typeof bgBashSchema, BgBashDetails>({\n\t\t\tname: \"bg_bash\",\n\t\t\tlabel: \"bg bash\",\n\t\t\tdescription:\n\t\t\t\t\"Run a bash command in the background and return immediately with a task id and output file path. \" +\n\t\t\t\t\"The result (status, exit code, output tail) arrives automatically as a <background-task> notification \" +\n\t\t\t\t\"when the task ends. Use for long-running commands such as dev servers, watch builds, or slow tests. \" +\n\t\t\t\t\"Optionally provide a timeout in seconds.\",\n\t\t\tpromptSnippet: \"Run bash commands in the background (bg_bash); results arrive automatically\",\n\t\t\tpromptGuidelines: [\n\t\t\t\t\"Use bg_bash for long-running commands (servers, builds, slow tests). Never poll for completion with sleep loops or repeated bg_logs; the <background-task> notification arrives automatically when the task ends. Use bg_logs for an early peek at a running task and bg_kill to stop one.\",\n\t\t\t],\n\t\t\tparameters: bgBashSchema,\n\t\t\tasync execute(_toolCallId, params, _signal, _onUpdate, ctx): Promise<AgentToolResult<BgBashDetails>> {\n\t\t\t\tif (params.timeout !== undefined && (!Number.isFinite(params.timeout) || params.timeout <= 0)) {\n\t\t\t\t\tthrow new Error(\"Invalid timeout: must be a positive number of seconds.\");\n\t\t\t\t}\n\t\t\t\t// Same PI_* session variables as the built-in bash tool, snapshotted at start.\n\t\t\t\tconst spawnContext = resolveSpawnContext(params.command, ctx.cwd, undefined, true, ctx);\n\t\t\t\t// Deliberately ignore the turn signal: aborting the current turn must\n\t\t\t\t// not kill the background task (that is what bg_kill is for).\n\t\t\t\tconst task = requireRegistry().startTask({\n\t\t\t\t\tcommand: params.command,\n\t\t\t\t\tcwd: ctx.cwd,\n\t\t\t\t\ttimeoutSeconds: params.timeout,\n\t\t\t\t\tenv: spawnContext.env,\n\t\t\t\t});\n\t\t\t\tconst text = [\n\t\t\t\t\t`Started background task ${task.id}.`,\n\t\t\t\t\t`Output file: ${task.outputPath}`,\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Do NOT poll for completion (no sleep loops, no repeated bg_logs). A <background-task> \" +\n\t\t\t\t\t\t\"notification with the result and output tail arrives automatically when the task ends — \" +\n\t\t\t\t\t\t\"continue independent work or end the turn. Use bg_logs for an early peek, bg_kill to stop it.\",\n\t\t\t\t].join(\"\\n\");\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text }],\n\t\t\t\t\tdetails: { taskId: task.id, outputPath: task.outputPath, command: params.command },\n\t\t\t\t};\n\t\t\t},\n\t\t\trenderCall(args, theme, context) {\n\t\t\t\treturn renderBgBashCall(args, theme, context);\n\t\t\t},\n\t\t\trenderResult(result, options, theme, context) {\n\t\t\t\treturn renderBgBashResult(result, options, theme, context);\n\t\t\t},\n\t\t});\n\n\t\tpi.registerTool<typeof bgLogsSchema, BgLogsDetails>({\n\t\t\tname: \"bg_logs\",\n\t\t\tlabel: \"bg logs\",\n\t\t\tdescription:\n\t\t\t\t`Read a bounded slice of a background task's output file (default: last ${formatSize(BG_LOGS_DEFAULT_BYTES)}, ` +\n\t\t\t\t`max ${formatSize(DEFAULT_MAX_BYTES)}). Works while the task is still running. ` +\n\t\t\t\t\"Do not call this in a polling loop; completion arrives as a notification.\",\n\t\t\tparameters: bgLogsSchema,\n\t\t\tasync execute(_toolCallId, params, _signal, _onUpdate, _ctx): Promise<AgentToolResult<BgLogsDetails>> {\n\t\t\t\tconst task = resolveTaskOrThrow(params.taskId);\n\t\t\t\tconst mode = params.mode ?? \"tail\";\n\t\t\t\tconst maxBytes = Math.min(\n\t\t\t\t\tDEFAULT_MAX_BYTES,\n\t\t\t\t\tMath.max(BG_LOGS_MIN_BYTES, Math.floor(params.bytes ?? BG_LOGS_DEFAULT_BYTES)),\n\t\t\t\t);\n\t\t\t\tlet slice: Awaited<ReturnType<typeof readOutputSlice>>;\n\t\t\t\ttry {\n\t\t\t\t\tslice = await readOutputSlice(task.outputPath, { mode, maxBytes });\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Could not read output for ${task.id} (${task.status}): ${message}\\nOutput file: ${task.outputPath}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst text = sanitizeBinaryOutput(slice.text);\n\t\t\t\tconst noticeParts = slice.truncated\n\t\t\t\t\t? [\n\t\t\t\t\t\t\t`${mode} ${formatSize(slice.sliceBytes)} of ${formatSize(slice.totalBytes)}`,\n\t\t\t\t\t\t\t`task ${task.id} ${task.status}`,\n\t\t\t\t\t\t\t...(slice.startsMidLine ? [\"first line may be partial\"] : []),\n\t\t\t\t\t\t\t`full output: ${task.outputPath}`,\n\t\t\t\t\t\t]\n\t\t\t\t\t: [\n\t\t\t\t\t\t\t`task ${task.id} ${task.status}`,\n\t\t\t\t\t\t\t`${formatSize(slice.totalBytes)} total`,\n\t\t\t\t\t\t\t`output: ${task.outputPath}`,\n\t\t\t\t\t\t];\n\t\t\t\tconst body = text.length > 0 ? text : \"(no output yet)\";\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `[${noticeParts.join(\" · \")}]\\n${body}` }],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\ttaskId: task.id,\n\t\t\t\t\t\tmode,\n\t\t\t\t\t\tsliceBytes: slice.sliceBytes,\n\t\t\t\t\t\ttotalBytes: slice.totalBytes,\n\t\t\t\t\t\toutputPath: task.outputPath,\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t},\n\t\t\trenderCall(args, theme) {\n\t\t\t\treturn renderBgLogsCall(args, theme);\n\t\t\t},\n\t\t});\n\n\t\tpi.registerTool<typeof bgKillSchema, BgKillDetails>({\n\t\t\tname: \"bg_kill\",\n\t\t\tlabel: \"bg kill\",\n\t\t\tdescription:\n\t\t\t\t\"Kill a running background task (the whole process tree). The terminal status and output tail \" +\n\t\t\t\t\"still arrive as the task's completion notification.\",\n\t\t\tparameters: bgKillSchema,\n\t\t\tasync execute(_toolCallId, params, _signal, _onUpdate, _ctx): Promise<AgentToolResult<BgKillDetails>> {\n\t\t\t\tconst task = resolveTaskOrThrow(params.taskId);\n\t\t\t\tconst result = requireRegistry().killTask(task.id);\n\t\t\t\tif (!result.killed) {\n\t\t\t\t\tconst exit = task.exitCode !== undefined && task.exitCode !== null ? `, exit ${task.exitCode}` : \"\";\n\t\t\t\t\tthrow new Error(`Task ${task.id} is not running (status: ${task.status}${exit}).`);\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\ttext: `Killed task ${task.id}. A completion notification follows once the process tree is reaped.`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: { taskId: task.id, command: task.command },\n\t\t\t\t};\n\t\t\t},\n\t\t\trenderCall(args, theme) {\n\t\t\t\treturn renderBgKillCall(args, theme);\n\t\t\t},\n\t\t});\n\n\t\tpi.registerMessageRenderer<BgNotificationDetails>(BG_NOTIFICATION_TYPE, renderBackgroundNotification);\n\n\t\tpi.registerCommand(\"bg\", {\n\t\t\tdescription: \"View and manage background tasks\",\n\t\t\thandler: async (_args, ctx: ExtensionCommandContext) => {\n\t\t\t\tconst active = registry;\n\t\t\t\tif (!active || active.counts().total === 0) {\n\t\t\t\t\tctx.ui.notify(\"No background tasks.\", \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (ctx.mode !== \"tui\") {\n\t\t\t\t\t// RPC/print: ctx.ui.custom is unavailable — show a bounded summary.\n\t\t\t\t\tconst lines = active\n\t\t\t\t\t\t.listTasks()\n\t\t\t\t\t\t.slice(0, 10)\n\t\t\t\t\t\t.map((task) => describeTaskLine(task, Date.now()));\n\t\t\t\t\tctx.ui.notify(`Background tasks:\\n${lines.join(\"\\n\")}\\nUse bg_kill <id> to stop a task.`, \"info\");\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait showBackgroundManager(ctx, active);\n\t\t\t},\n\t\t});\n\t};\n}\n\nasync function showBackgroundManager(ctx: ExtensionCommandContext, registry: BackgroundTaskRegistry): Promise<void> {\n\t// No overlay options: the component mounts inline in the editor slot, like /model.\n\tawait ctx.ui.custom(\n\t\t(tui, theme, keybindings, done) =>\n\t\t\tnew BackgroundTasksMenu({\n\t\t\t\ttui,\n\t\t\t\ttheme,\n\t\t\t\tkeybindings,\n\t\t\t\thost: {\n\t\t\t\t\tlistTasks: () => registry.listTasks(),\n\t\t\t\t\tkillTask: (id) => registry.killTask(id),\n\t\t\t\t\treadSlice: (filePath, options) => readOutputSlice(filePath, options),\n\t\t\t\t},\n\t\t\t\tonClose: () => done(undefined),\n\t\t\t}),\n\t);\n}\n\nexport default createBackgroundExtension();\n"]}

package/dist/extensions/background/manager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * /bg task manager — an inline, /model-style menu that mounts in the editor
+ * slot. Two views in one component: a task list, and a live output viewport
+ * for the selected task (Enter to open, Esc to go back). The host dependency
+ * is narrowed to three callbacks so the component stays testable.
+ */
+import { type Component, type Focusable } from "@earendil-works/pi-tui";
+import type { KeybindingsManager } from "../../core/keybindings.ts";
+import type { Theme } from "../../modes/interactive/theme/theme.ts";
+import { type BgTask, type OutputSlice } from "./registry.ts";
+export interface BackgroundManagerHost {
+    listTasks(): BgTask[];
+    killTask(id: string): {
+        killed: boolean;
+    };
+    readSlice(filePath: string, options: {
+        mode: "tail";
+        maxBytes: number;
+    }): Promise<OutputSlice>;
+}
+interface MenuTui {
+    requestRender(): void;
+    terminal: {
+        rows: number;
+        columns: number;
+    };
+}
+export interface BackgroundTasksMenuOptions {
+    tui: MenuTui;
+    theme: Theme;
+    keybindings: Pick<KeybindingsManager, "matches" | "getKeys">;
+    host: BackgroundManagerHost;
+    onClose: () => void;
+    pollIntervalMs?: number;
+}
+export declare class BackgroundTasksMenu implements Component, Focusable {
+    private readonly tui;
+    private readonly theme;
+    private readonly keybindings;
+    private readonly host;
+    private readonly onClose;
+    private readonly pollIntervalMs;
+    private view;
+    private tasks;
+    private selectedTaskId;
+    private listScrollTop;
+    private follow;
+    private tailOffsetLines;
+    private tailCache;
+    private killFeedback;
+    private pollTimer;
+    private readBusy;
+    private disposed;
+    private _focused;
+    constructor(options: BackgroundTasksMenuOptions);
+    get focused(): boolean;
+    set focused(value: boolean);
+    invalidate(): void;
+    dispose(): void;
+    handleInput(data: string): void;
+    private handleListInput;
+    private handleDetailInput;
+    render(width: number): string[];
+    private renderList;
+    private renderTaskRow;
+    private countsLabel;
+    private renderDetail;
+    private detailHeader;
+    private detailBodyHeight;
+    private footerLine;
+    private selectedTask;
+    private moveSelection;
+    private resetFollow;
+    private currentLines;
+    private maxTailOffset;
+    private killSelected;
+    private tick;
+    private refreshViewport;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/extensions/background/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/extensions/background/manager.ts"],"names":[],"mappings":"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"}