@code-yeongyu/senpi 0.74.0

package/dist/core/extensions/builtin/background-task/index.js

@@ -0,0 +1,207 @@
+import { sendBuiltinCustomMessage } from "../system-messages.js";
+import { createBackgroundCancelTool } from "./cancel-tool.js";
+import { BackgroundManager, getWidgetLines } from "./manager.js";
+import { sendCompletionNotification } from "./notification.js";
+import { createBackgroundOutputTool } from "./output-tool.js";
+import { spawnSubagent } from "./spawner.js";
+import { createTaskTool } from "./task-tool.js";
+import { TASK_ENTRY_TYPE } from "./types.js";
+function isTaskStatus(value) {
+    return (value === "pending" || value === "running" || value === "completed" || value === "error" || value === "cancelled");
+}
+function parseDate(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value instanceof Date) {
+        return Number.isNaN(value.getTime()) ? undefined : value;
+    }
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const parsedDate = new Date(value);
+    return Number.isNaN(parsedDate.getTime()) ? undefined : parsedDate;
+}
+function parseBackgroundTask(value) {
+    if (typeof value !== "object" || value === null) {
+        return undefined;
+    }
+    const taskRecord = value;
+    const startedAt = parseDate(taskRecord.startedAt);
+    const completedAt = parseDate(taskRecord.completedAt);
+    if (typeof taskRecord.id !== "string" ||
+        typeof taskRecord.description !== "string" ||
+        typeof taskRecord.prompt !== "string" ||
+        !isTaskStatus(taskRecord.status) ||
+        (taskRecord.model !== undefined && typeof taskRecord.model !== "string") ||
+        (taskRecord.agentType !== undefined && typeof taskRecord.agentType !== "string") ||
+        (taskRecord.pid !== undefined && typeof taskRecord.pid !== "number") ||
+        (taskRecord.sessionPath !== undefined && typeof taskRecord.sessionPath !== "string") ||
+        (taskRecord.activeToolNames !== undefined &&
+            (!Array.isArray(taskRecord.activeToolNames) ||
+                taskRecord.activeToolNames.some((toolName) => typeof toolName !== "string"))) ||
+        startedAt === undefined ||
+        (taskRecord.completedAt !== undefined && completedAt === undefined) ||
+        (taskRecord.result !== undefined && typeof taskRecord.result !== "string") ||
+        (taskRecord.error !== undefined && typeof taskRecord.error !== "string") ||
+        typeof taskRecord.parentSessionId !== "string") {
+        return undefined;
+    }
+    return {
+        id: taskRecord.id,
+        description: taskRecord.description,
+        prompt: taskRecord.prompt,
+        model: taskRecord.model,
+        agentType: taskRecord.agentType,
+        status: taskRecord.status,
+        pid: taskRecord.pid,
+        sessionPath: taskRecord.sessionPath,
+        activeToolNames: Array.isArray(taskRecord.activeToolNames) ? taskRecord.activeToolNames : [],
+        startedAt,
+        completedAt,
+        result: taskRecord.result,
+        error: taskRecord.error,
+        parentSessionId: taskRecord.parentSessionId,
+    };
+}
+function isTerminalTask(task) {
+    return task.status === "completed" || task.status === "error" || task.status === "cancelled";
+}
+function getRestoredTasks(entries) {
+    const restoredTasks = new Map();
+    for (const entry of entries) {
+        if (entry.type !== "custom" || entry.customType !== TASK_ENTRY_TYPE) {
+            continue;
+        }
+        const task = parseBackgroundTask(entry.data);
+        if (!task) {
+            continue;
+        }
+        if (isTerminalTask(task)) {
+            restoredTasks.set(task.id, task);
+        }
+        else {
+            restoredTasks.delete(task.id);
+        }
+    }
+    return Array.from(restoredTasks.values());
+}
+function getCompletionTaskId(message) {
+    if (!Array.isArray(message.content)) {
+        return undefined;
+    }
+    for (const part of message.content) {
+        if (typeof part !== "object" || part === null) {
+            continue;
+        }
+        const contentPart = part;
+        if (contentPart.type !== "text" || typeof contentPart.text !== "string") {
+            continue;
+        }
+        const match = contentPart.text.match(/\b(bg_[0-9a-f]{8})\b/);
+        if (match?.[1]) {
+            return match[1];
+        }
+    }
+    return undefined;
+}
+class ObservableBackgroundManager extends BackgroundManager {
+    onChange;
+    persistTask;
+    constructor(onChange, persistTask) {
+        super();
+        this.onChange = onChange;
+        this.persistTask = persistTask;
+    }
+    launch(task) {
+        const launchedTask = super.launch(task);
+        this.onChange();
+        return launchedTask;
+    }
+    updateTask(id, updates) {
+        super.updateTask(id, updates);
+        this.onChange();
+    }
+    cancelTask(id) {
+        const wasCancelled = super.cancelTask(id);
+        if (wasCancelled) {
+            const cancelledTask = this.getTask(id);
+            if (cancelledTask) {
+                this.persistTask(cancelledTask);
+            }
+            this.onChange();
+        }
+        return wasCancelled;
+    }
+    cancelAll() {
+        const cancelledTasks = super.cancelAll();
+        for (const task of cancelledTasks) {
+            this.persistTask(task);
+        }
+        if (cancelledTasks.length > 0) {
+            this.onChange();
+        }
+        return cancelledTasks;
+    }
+    replaceTasks(tasks) {
+        this.clearTasks();
+        for (const task of tasks) {
+            this.restoreTask(task);
+        }
+        this.onChange();
+    }
+}
+export default function backgroundTaskExtension(pi) {
+    let currentContext;
+    const syncWidget = () => {
+        currentContext?.ui.setWidget("background-tasks", getWidgetLines(manager));
+    };
+    const manager = new ObservableBackgroundManager(() => {
+        syncWidget();
+    }, (task) => {
+        pi.appendEntry(TASK_ENTRY_TYPE, task);
+    });
+    const syncFromSession = (ctx) => {
+        currentContext = ctx;
+        manager.replaceTasks(getRestoredTasks(ctx.sessionManager.getBranch()));
+    };
+    const notifyingPi = {
+        ...pi,
+        sendMessage(message, options) {
+            if (message.customType === "background-task.complete") {
+                const taskId = getCompletionTaskId(message);
+                if (taskId) {
+                    const task = manager.getTask(taskId);
+                    if (task && isTerminalTask(task)) {
+                        sendCompletionNotification(pi, task, manager);
+                        return;
+                    }
+                }
+                sendBuiltinCustomMessage(pi, "background-task.notification", message, options);
+                return;
+            }
+            pi.sendMessage(message, options);
+        },
+    };
+    pi.on("session_start", async (_event, ctx) => {
+        syncFromSession(ctx);
+    });
+    pi.on("session_tree", async (_event, ctx) => {
+        syncFromSession(ctx);
+    });
+    pi.registerTool(createTaskTool(manager, spawnSubagent, notifyingPi));
+    pi.registerTool(createBackgroundOutputTool(manager));
+    pi.registerTool(createBackgroundCancelTool(manager));
+    process.on("exit", () => {
+        for (const task of manager.getActiveTasks()) {
+            if (task.pid === undefined) {
+                continue;
+            }
+            try {
+                process.kill(task.pid, "SIGTERM");
+            }
+            catch { }
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/background-task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI, ExtensionContext } from \"../../types.js\";\nimport { sendBuiltinCustomMessage } from \"../system-messages.js\";\nimport { createBackgroundCancelTool } from \"./cancel-tool.js\";\nimport { BackgroundManager, getWidgetLines } from \"./manager.js\";\nimport { sendCompletionNotification } from \"./notification.js\";\nimport { createBackgroundOutputTool } from \"./output-tool.js\";\nimport { spawnSubagent } from \"./spawner.js\";\nimport { createTaskTool } from \"./task-tool.js\";\nimport { type BackgroundTask, TASK_ENTRY_TYPE } from \"./types.js\";\n\ntype SessionEntry = {\n\ttype: string;\n\tcustomType?: string;\n\tdata?: unknown;\n\tmessage?: unknown;\n};\n\nfunction isTaskStatus(value: unknown): value is BackgroundTask[\"status\"] {\n\treturn (\n\t\tvalue === \"pending\" || value === \"running\" || value === \"completed\" || value === \"error\" || value === \"cancelled\"\n\t);\n}\n\nfunction parseDate(value: unknown): Date | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\n\tif (value instanceof Date) {\n\t\treturn Number.isNaN(value.getTime()) ? undefined : value;\n\t}\n\n\tif (typeof value !== \"string\") {\n\t\treturn undefined;\n\t}\n\n\tconst parsedDate = new Date(value);\n\treturn Number.isNaN(parsedDate.getTime()) ? undefined : parsedDate;\n}\n\nfunction parseBackgroundTask(value: unknown): BackgroundTask | undefined {\n\tif (typeof value !== \"object\" || value === null) {\n\t\treturn undefined;\n\t}\n\n\tconst taskRecord = value as Record<string, unknown>;\n\tconst startedAt = parseDate(taskRecord.startedAt);\n\tconst completedAt = parseDate(taskRecord.completedAt);\n\n\tif (\n\t\ttypeof taskRecord.id !== \"string\" ||\n\t\ttypeof taskRecord.description !== \"string\" ||\n\t\ttypeof taskRecord.prompt !== \"string\" ||\n\t\t!isTaskStatus(taskRecord.status) ||\n\t\t(taskRecord.model !== undefined && typeof taskRecord.model !== \"string\") ||\n\t\t(taskRecord.agentType !== undefined && typeof taskRecord.agentType !== \"string\") ||\n\t\t(taskRecord.pid !== undefined && typeof taskRecord.pid !== \"number\") ||\n\t\t(taskRecord.sessionPath !== undefined && typeof taskRecord.sessionPath !== \"string\") ||\n\t\t(taskRecord.activeToolNames !== undefined &&\n\t\t\t(!Array.isArray(taskRecord.activeToolNames) ||\n\t\t\t\ttaskRecord.activeToolNames.some((toolName) => typeof toolName !== \"string\"))) ||\n\t\tstartedAt === undefined ||\n\t\t(taskRecord.completedAt !== undefined && completedAt === undefined) ||\n\t\t(taskRecord.result !== undefined && typeof taskRecord.result !== \"string\") ||\n\t\t(taskRecord.error !== undefined && typeof taskRecord.error !== \"string\") ||\n\t\ttypeof taskRecord.parentSessionId !== \"string\"\n\t) {\n\t\treturn undefined;\n\t}\n\n\treturn {\n\t\tid: taskRecord.id,\n\t\tdescription: taskRecord.description,\n\t\tprompt: taskRecord.prompt,\n\t\tmodel: taskRecord.model,\n\t\tagentType: taskRecord.agentType,\n\t\tstatus: taskRecord.status,\n\t\tpid: taskRecord.pid,\n\t\tsessionPath: taskRecord.sessionPath,\n\t\tactiveToolNames: Array.isArray(taskRecord.activeToolNames) ? taskRecord.activeToolNames : [],\n\t\tstartedAt,\n\t\tcompletedAt,\n\t\tresult: taskRecord.result,\n\t\terror: taskRecord.error,\n\t\tparentSessionId: taskRecord.parentSessionId,\n\t};\n}\n\nfunction isTerminalTask(task: BackgroundTask): boolean {\n\treturn task.status === \"completed\" || task.status === \"error\" || task.status === \"cancelled\";\n}\n\nfunction getRestoredTasks(entries: SessionEntry[]): BackgroundTask[] {\n\tconst restoredTasks = new Map<string, BackgroundTask>();\n\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"custom\" || entry.customType !== TASK_ENTRY_TYPE) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst task = parseBackgroundTask(entry.data);\n\t\tif (!task) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (isTerminalTask(task)) {\n\t\t\trestoredTasks.set(task.id, task);\n\t\t} else {\n\t\t\trestoredTasks.delete(task.id);\n\t\t}\n\t}\n\n\treturn Array.from(restoredTasks.values());\n}\n\nfunction getCompletionTaskId(message: { content?: unknown }): string | undefined {\n\tif (!Array.isArray(message.content)) {\n\t\treturn undefined;\n\t}\n\n\tfor (const part of message.content) {\n\t\tif (typeof part !== \"object\" || part === null) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst contentPart = part as Record<string, unknown>;\n\t\tif (contentPart.type !== \"text\" || typeof contentPart.text !== \"string\") {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst match = contentPart.text.match(/\\b(bg_[0-9a-f]{8})\\b/);\n\t\tif (match?.[1]) {\n\t\t\treturn match[1];\n\t\t}\n\t}\n\n\treturn undefined;\n}\n\nclass ObservableBackgroundManager extends BackgroundManager {\n\tconstructor(\n\t\tprivate readonly onChange: () => void,\n\t\tprivate readonly persistTask: (task: BackgroundTask) => void,\n\t) {\n\t\tsuper();\n\t}\n\n\toverride launch(task: Omit<BackgroundTask, \"id\" | \"status\" | \"startedAt\">): BackgroundTask {\n\t\tconst launchedTask = super.launch(task);\n\t\tthis.onChange();\n\t\treturn launchedTask;\n\t}\n\n\toverride updateTask(id: string, updates: Partial<BackgroundTask>): void {\n\t\tsuper.updateTask(id, updates);\n\t\tthis.onChange();\n\t}\n\n\toverride cancelTask(id: string): boolean {\n\t\tconst wasCancelled = super.cancelTask(id);\n\t\tif (wasCancelled) {\n\t\t\tconst cancelledTask = this.getTask(id);\n\t\t\tif (cancelledTask) {\n\t\t\t\tthis.persistTask(cancelledTask);\n\t\t\t}\n\t\t\tthis.onChange();\n\t\t}\n\t\treturn wasCancelled;\n\t}\n\n\toverride cancelAll(): BackgroundTask[] {\n\t\tconst cancelledTasks = super.cancelAll();\n\t\tfor (const task of cancelledTasks) {\n\t\t\tthis.persistTask(task);\n\t\t}\n\t\tif (cancelledTasks.length > 0) {\n\t\t\tthis.onChange();\n\t\t}\n\t\treturn cancelledTasks;\n\t}\n\n\treplaceTasks(tasks: BackgroundTask[]): void {\n\t\tthis.clearTasks();\n\t\tfor (const task of tasks) {\n\t\t\tthis.restoreTask(task);\n\t\t}\n\t\tthis.onChange();\n\t}\n}\n\nexport default function backgroundTaskExtension(pi: ExtensionAPI): void {\n\tlet currentContext: ExtensionContext | undefined;\n\n\tconst syncWidget = (): void => {\n\t\tcurrentContext?.ui.setWidget(\"background-tasks\", getWidgetLines(manager));\n\t};\n\n\tconst manager = new ObservableBackgroundManager(\n\t\t() => {\n\t\t\tsyncWidget();\n\t\t},\n\t\t(task) => {\n\t\t\tpi.appendEntry(TASK_ENTRY_TYPE, task);\n\t\t},\n\t);\n\n\tconst syncFromSession = (ctx: ExtensionContext): void => {\n\t\tcurrentContext = ctx;\n\t\tmanager.replaceTasks(getRestoredTasks(ctx.sessionManager.getBranch() as SessionEntry[]));\n\t};\n\n\tconst notifyingPi = {\n\t\t...pi,\n\t\tsendMessage(message, options) {\n\t\t\tif (message.customType === \"background-task.complete\") {\n\t\t\t\tconst taskId = getCompletionTaskId(message);\n\t\t\t\tif (taskId) {\n\t\t\t\t\tconst task = manager.getTask(taskId);\n\t\t\t\t\tif (task && isTerminalTask(task)) {\n\t\t\t\t\t\tsendCompletionNotification(pi, task, manager);\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tsendBuiltinCustomMessage(pi, \"background-task.notification\", message, options);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tpi.sendMessage(message, options);\n\t\t},\n\t} satisfies ExtensionAPI;\n\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.on(\"session_tree\", async (_event, ctx) => {\n\t\tsyncFromSession(ctx);\n\t});\n\n\tpi.registerTool(createTaskTool(manager, spawnSubagent, notifyingPi));\n\tpi.registerTool(createBackgroundOutputTool(manager));\n\tpi.registerTool(createBackgroundCancelTool(manager));\n\n\tprocess.on(\"exit\", () => {\n\t\tfor (const task of manager.getActiveTasks()) {\n\t\t\tif (task.pid === undefined) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tprocess.kill(task.pid, \"SIGTERM\");\n\t\t\t} catch {}\n\t\t}\n\t});\n}\n"]}

package/dist/core/extensions/builtin/background-task/manager.d.ts

@@ -0,0 +1,17 @@
+import type { BackgroundTask } from "./types.js";
+export declare class BackgroundManager {
+    private tasks;
+    constructor();
+    launch(task: Omit<BackgroundTask, "id" | "status" | "startedAt">): BackgroundTask;
+    getTask(id: string): BackgroundTask | undefined;
+    getAllTasks(): BackgroundTask[];
+    getActiveTasks(): BackgroundTask[];
+    updateTask(id: string, updates: Partial<BackgroundTask>): void;
+    cancelTask(id: string): boolean;
+    cancelAll(): BackgroundTask[];
+    getTasksByParent(parentSessionId: string): BackgroundTask[];
+    restoreTask(task: BackgroundTask): void;
+    clearTasks(): void;
+}
+export declare function getWidgetLines(manager: BackgroundManager): string[] | undefined;
+//# sourceMappingURL=manager.d.ts.map

package/dist/core/extensions/builtin/background-task/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,KAAK,CAA8B;IAE3C,cAEC;IAED,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAC,GAAG,cAAc,CAiBhF;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE9C;IAED,WAAW,IAAI,cAAc,EAAE,CAE9B;IAED,cAAc,IAAI,cAAc,EAAE,CAEjC;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAQ7D;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAY9B;IAED,SAAS,IAAI,cAAc,EAAE,CAW5B;IAED,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1D;IAED,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEtC;IAED,UAAU,IAAI,IAAI,CAEjB;CACD;AA2BD,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,GAAG,SAAS,CAyB/E","sourcesContent":["import type { BackgroundTask } from \"./types.js\";\nimport { MAX_CONCURRENT_TASKS } from \"./types.js\";\n\nexport class BackgroundManager {\n\tprivate tasks: Map<string, BackgroundTask>;\n\n\tconstructor() {\n\t\tthis.tasks = new Map();\n\t}\n\n\tlaunch(task: Omit<BackgroundTask, \"id\" | \"status\" | \"startedAt\">): BackgroundTask {\n\t\tconst activeTasks = this.getActiveTasks();\n\t\tif (activeTasks.length >= MAX_CONCURRENT_TASKS) {\n\t\t\tthrow new Error(\n\t\t\t\t`Maximum concurrent tasks (${MAX_CONCURRENT_TASKS}) reached. Cancel some tasks before launching new ones.`,\n\t\t\t);\n\t\t}\n\n\t\tconst newTask: BackgroundTask = {\n\t\t\t...task,\n\t\t\tid: generateTaskId(),\n\t\t\tstatus: \"pending\",\n\t\t\tstartedAt: new Date(),\n\t\t};\n\n\t\tthis.tasks.set(newTask.id, newTask);\n\t\treturn newTask;\n\t}\n\n\tgetTask(id: string): BackgroundTask | undefined {\n\t\treturn this.tasks.get(id);\n\t}\n\n\tgetAllTasks(): BackgroundTask[] {\n\t\treturn Array.from(this.tasks.values());\n\t}\n\n\tgetActiveTasks(): BackgroundTask[] {\n\t\treturn this.getAllTasks().filter((task) => task.status === \"pending\" || task.status === \"running\");\n\t}\n\n\tupdateTask(id: string, updates: Partial<BackgroundTask>): void {\n\t\tconst task = this.tasks.get(id);\n\t\tif (!task) {\n\t\t\tthrow new Error(`Task ${id} not found`);\n\t\t}\n\n\t\tconst updatedTask = { ...task, ...updates };\n\t\tthis.tasks.set(id, updatedTask);\n\t}\n\n\tcancelTask(id: string): boolean {\n\t\tconst task = this.tasks.get(id);\n\t\tif (!task) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (task.status === \"pending\" || task.status === \"running\") {\n\t\t\tthis.tasks.set(id, { ...task, status: \"cancelled\" });\n\t\t\treturn true;\n\t\t}\n\n\t\treturn false;\n\t}\n\n\tcancelAll(): BackgroundTask[] {\n\t\tconst cancelled: BackgroundTask[] = [];\n\n\t\tfor (const task of this.tasks.values()) {\n\t\t\tif (task.status === \"pending\" || task.status === \"running\") {\n\t\t\t\tthis.tasks.set(task.id, { ...task, status: \"cancelled\" });\n\t\t\t\tcancelled.push(this.tasks.get(task.id)!);\n\t\t\t}\n\t\t}\n\n\t\treturn cancelled;\n\t}\n\n\tgetTasksByParent(parentSessionId: string): BackgroundTask[] {\n\t\treturn this.getAllTasks().filter((task) => task.parentSessionId === parentSessionId);\n\t}\n\n\trestoreTask(task: BackgroundTask): void {\n\t\tthis.tasks.set(task.id, task);\n\t}\n\n\tclearTasks(): void {\n\t\tthis.tasks.clear();\n\t}\n}\n\nfunction formatTaskMetadata(task: BackgroundTask): string | undefined {\n\tconst metadata = [task.agentType, task.model].filter(\n\t\t(value): value is string => typeof value === \"string\" && value.length > 0,\n\t);\n\tif (metadata.length === 0) {\n\t\treturn undefined;\n\t}\n\treturn metadata.join(\" · \");\n}\n\nfunction formatActiveTools(task: BackgroundTask): string | undefined {\n\tif (task.activeToolNames.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tconst counts = new Map<string, number>();\n\tfor (const toolName of task.activeToolNames) {\n\t\tcounts.set(toolName, (counts.get(toolName) ?? 0) + 1);\n\t}\n\n\treturn Array.from(counts.entries())\n\t\t.map(([toolName, count]) => (count > 1 ? `${toolName}×${count}` : toolName))\n\t\t.join(\", \");\n}\n\nexport function getWidgetLines(manager: BackgroundManager): string[] | undefined {\n\tconst activeTasks = manager.getActiveTasks();\n\n\tif (activeTasks.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tconst taskLines = activeTasks.flatMap((task) => {\n\t\tconst indicator = task.status === \"pending\" ? \"[⏳]\" : \"[▶]\";\n\t\tconst lines = [`${indicator} ${task.description}`];\n\t\tconst metadata = formatTaskMetadata(task);\n\t\tconst activeTools = formatActiveTools(task);\n\n\t\tif (metadata) {\n\t\t\tlines.push(`    ${metadata}`);\n\t\t}\n\n\t\tif (activeTools) {\n\t\t\tlines.push(`    tools: ${activeTools}`);\n\t\t}\n\n\t\treturn lines;\n\t});\n\n\treturn [\"Background Tasks\", ...taskLines];\n}\n\nfunction generateTaskId(): string {\n\treturn (\n\t\t\"bg_\" +\n\t\tMath.floor(Math.random() * 0xffffffff)\n\t\t\t.toString(16)\n\t\t\t.padStart(8, \"0\")\n\t);\n}\n"]}

package/dist/core/extensions/builtin/background-task/manager.js

@@ -0,0 +1,114 @@
+import { MAX_CONCURRENT_TASKS } from "./types.js";
+export class BackgroundManager {
+    tasks;
+    constructor() {
+        this.tasks = new Map();
+    }
+    launch(task) {
+        const activeTasks = this.getActiveTasks();
+        if (activeTasks.length >= MAX_CONCURRENT_TASKS) {
+            throw new Error(`Maximum concurrent tasks (${MAX_CONCURRENT_TASKS}) reached. Cancel some tasks before launching new ones.`);
+        }
+        const newTask = {
+            ...task,
+            id: generateTaskId(),
+            status: "pending",
+            startedAt: new Date(),
+        };
+        this.tasks.set(newTask.id, newTask);
+        return newTask;
+    }
+    getTask(id) {
+        return this.tasks.get(id);
+    }
+    getAllTasks() {
+        return Array.from(this.tasks.values());
+    }
+    getActiveTasks() {
+        return this.getAllTasks().filter((task) => task.status === "pending" || task.status === "running");
+    }
+    updateTask(id, updates) {
+        const task = this.tasks.get(id);
+        if (!task) {
+            throw new Error(`Task ${id} not found`);
+        }
+        const updatedTask = { ...task, ...updates };
+        this.tasks.set(id, updatedTask);
+    }
+    cancelTask(id) {
+        const task = this.tasks.get(id);
+        if (!task) {
+            return false;
+        }
+        if (task.status === "pending" || task.status === "running") {
+            this.tasks.set(id, { ...task, status: "cancelled" });
+            return true;
+        }
+        return false;
+    }
+    cancelAll() {
+        const cancelled = [];
+        for (const task of this.tasks.values()) {
+            if (task.status === "pending" || task.status === "running") {
+                this.tasks.set(task.id, { ...task, status: "cancelled" });
+                cancelled.push(this.tasks.get(task.id));
+            }
+        }
+        return cancelled;
+    }
+    getTasksByParent(parentSessionId) {
+        return this.getAllTasks().filter((task) => task.parentSessionId === parentSessionId);
+    }
+    restoreTask(task) {
+        this.tasks.set(task.id, task);
+    }
+    clearTasks() {
+        this.tasks.clear();
+    }
+}
+function formatTaskMetadata(task) {
+    const metadata = [task.agentType, task.model].filter((value) => typeof value === "string" && value.length > 0);
+    if (metadata.length === 0) {
+        return undefined;
+    }
+    return metadata.join(" · ");
+}
+function formatActiveTools(task) {
+    if (task.activeToolNames.length === 0) {
+        return undefined;
+    }
+    const counts = new Map();
+    for (const toolName of task.activeToolNames) {
+        counts.set(toolName, (counts.get(toolName) ?? 0) + 1);
+    }
+    return Array.from(counts.entries())
+        .map(([toolName, count]) => (count > 1 ? `${toolName}×${count}` : toolName))
+        .join(", ");
+}
+export function getWidgetLines(manager) {
+    const activeTasks = manager.getActiveTasks();
+    if (activeTasks.length === 0) {
+        return undefined;
+    }
+    const taskLines = activeTasks.flatMap((task) => {
+        const indicator = task.status === "pending" ? "[⏳]" : "[▶]";
+        const lines = [`${indicator} ${task.description}`];
+        const metadata = formatTaskMetadata(task);
+        const activeTools = formatActiveTools(task);
+        if (metadata) {
+            lines.push(`    ${metadata}`);
+        }
+        if (activeTools) {
+            lines.push(`    tools: ${activeTools}`);
+        }
+        return lines;
+    });
+    return ["Background Tasks", ...taskLines];
+}
+function generateTaskId() {
+    return ("bg_" +
+        Math.floor(Math.random() * 0xffffffff)
+            .toString(16)
+            .padStart(8, "0"));
+}
+//# sourceMappingURL=manager.js.map

package/dist/core/extensions/builtin/background-task/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/manager.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BackgroundTask } from \"./types.js\";\nimport { MAX_CONCURRENT_TASKS } from \"./types.js\";\n\nexport class BackgroundManager {\n\tprivate tasks: Map<string, BackgroundTask>;\n\n\tconstructor() {\n\t\tthis.tasks = new Map();\n\t}\n\n\tlaunch(task: Omit<BackgroundTask, \"id\" | \"status\" | \"startedAt\">): BackgroundTask {\n\t\tconst activeTasks = this.getActiveTasks();\n\t\tif (activeTasks.length >= MAX_CONCURRENT_TASKS) {\n\t\t\tthrow new Error(\n\t\t\t\t`Maximum concurrent tasks (${MAX_CONCURRENT_TASKS}) reached. Cancel some tasks before launching new ones.`,\n\t\t\t);\n\t\t}\n\n\t\tconst newTask: BackgroundTask = {\n\t\t\t...task,\n\t\t\tid: generateTaskId(),\n\t\t\tstatus: \"pending\",\n\t\t\tstartedAt: new Date(),\n\t\t};\n\n\t\tthis.tasks.set(newTask.id, newTask);\n\t\treturn newTask;\n\t}\n\n\tgetTask(id: string): BackgroundTask | undefined {\n\t\treturn this.tasks.get(id);\n\t}\n\n\tgetAllTasks(): BackgroundTask[] {\n\t\treturn Array.from(this.tasks.values());\n\t}\n\n\tgetActiveTasks(): BackgroundTask[] {\n\t\treturn this.getAllTasks().filter((task) => task.status === \"pending\" || task.status === \"running\");\n\t}\n\n\tupdateTask(id: string, updates: Partial<BackgroundTask>): void {\n\t\tconst task = this.tasks.get(id);\n\t\tif (!task) {\n\t\t\tthrow new Error(`Task ${id} not found`);\n\t\t}\n\n\t\tconst updatedTask = { ...task, ...updates };\n\t\tthis.tasks.set(id, updatedTask);\n\t}\n\n\tcancelTask(id: string): boolean {\n\t\tconst task = this.tasks.get(id);\n\t\tif (!task) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (task.status === \"pending\" || task.status === \"running\") {\n\t\t\tthis.tasks.set(id, { ...task, status: \"cancelled\" });\n\t\t\treturn true;\n\t\t}\n\n\t\treturn false;\n\t}\n\n\tcancelAll(): BackgroundTask[] {\n\t\tconst cancelled: BackgroundTask[] = [];\n\n\t\tfor (const task of this.tasks.values()) {\n\t\t\tif (task.status === \"pending\" || task.status === \"running\") {\n\t\t\t\tthis.tasks.set(task.id, { ...task, status: \"cancelled\" });\n\t\t\t\tcancelled.push(this.tasks.get(task.id)!);\n\t\t\t}\n\t\t}\n\n\t\treturn cancelled;\n\t}\n\n\tgetTasksByParent(parentSessionId: string): BackgroundTask[] {\n\t\treturn this.getAllTasks().filter((task) => task.parentSessionId === parentSessionId);\n\t}\n\n\trestoreTask(task: BackgroundTask): void {\n\t\tthis.tasks.set(task.id, task);\n\t}\n\n\tclearTasks(): void {\n\t\tthis.tasks.clear();\n\t}\n}\n\nfunction formatTaskMetadata(task: BackgroundTask): string | undefined {\n\tconst metadata = [task.agentType, task.model].filter(\n\t\t(value): value is string => typeof value === \"string\" && value.length > 0,\n\t);\n\tif (metadata.length === 0) {\n\t\treturn undefined;\n\t}\n\treturn metadata.join(\" · \");\n}\n\nfunction formatActiveTools(task: BackgroundTask): string | undefined {\n\tif (task.activeToolNames.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tconst counts = new Map<string, number>();\n\tfor (const toolName of task.activeToolNames) {\n\t\tcounts.set(toolName, (counts.get(toolName) ?? 0) + 1);\n\t}\n\n\treturn Array.from(counts.entries())\n\t\t.map(([toolName, count]) => (count > 1 ? `${toolName}×${count}` : toolName))\n\t\t.join(\", \");\n}\n\nexport function getWidgetLines(manager: BackgroundManager): string[] | undefined {\n\tconst activeTasks = manager.getActiveTasks();\n\n\tif (activeTasks.length === 0) {\n\t\treturn undefined;\n\t}\n\n\tconst taskLines = activeTasks.flatMap((task) => {\n\t\tconst indicator = task.status === \"pending\" ? \"[⏳]\" : \"[▶]\";\n\t\tconst lines = [`${indicator} ${task.description}`];\n\t\tconst metadata = formatTaskMetadata(task);\n\t\tconst activeTools = formatActiveTools(task);\n\n\t\tif (metadata) {\n\t\t\tlines.push(`    ${metadata}`);\n\t\t}\n\n\t\tif (activeTools) {\n\t\t\tlines.push(`    tools: ${activeTools}`);\n\t\t}\n\n\t\treturn lines;\n\t});\n\n\treturn [\"Background Tasks\", ...taskLines];\n}\n\nfunction generateTaskId(): string {\n\treturn (\n\t\t\"bg_\" +\n\t\tMath.floor(Math.random() * 0xffffffff)\n\t\t\t.toString(16)\n\t\t\t.padStart(8, \"0\")\n\t);\n}\n"]}

package/dist/core/extensions/builtin/background-task/notification.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionAPI } from "../../types.js";
+import type { BackgroundManager } from "./manager.js";
+import type { BackgroundTask } from "./types.js";
+export type NotificationStatus = "COMPLETED" | "CANCELLED" | "ERROR";
+export interface NotificationTask {
+    id: string;
+    description: string;
+    status: BackgroundTask["status"];
+    error?: string;
+    result?: string;
+}
+export interface NotificationInput {
+    task: NotificationTask;
+    duration: string;
+    statusText: NotificationStatus;
+    allComplete: boolean;
+    remainingCount: number;
+    completedTasks: NotificationTask[];
+}
+export declare function formatCompletionNotification(input: NotificationInput): string;
+export declare function sendCompletionNotification(pi: ExtensionAPI, task: BackgroundTask, manager: BackgroundManager): void;
+//# sourceMappingURL=notification.d.ts.map

package/dist/core/extensions/builtin/background-task/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAMD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAqB7E;AAsED,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAkCnH","sourcesContent":["import type { ExtensionAPI } from \"../../types.js\";\nimport { sendBuiltinCustomMessage } from \"../system-messages.js\";\nimport type { BackgroundManager } from \"./manager.js\";\nimport type { BackgroundTask } from \"./types.js\";\n\nexport type NotificationStatus = \"COMPLETED\" | \"CANCELLED\" | \"ERROR\";\n\nexport interface NotificationTask {\n\tid: string;\n\tdescription: string;\n\tstatus: BackgroundTask[\"status\"];\n\terror?: string;\n\tresult?: string;\n}\n\nexport interface NotificationInput {\n\ttask: NotificationTask;\n\tduration: string;\n\tstatusText: NotificationStatus;\n\tallComplete: boolean;\n\tremainingCount: number;\n\tcompletedTasks: NotificationTask[];\n}\n\nfunction safeDescription(task: NotificationTask): string {\n\treturn task.description || task.id;\n}\n\nexport function formatCompletionNotification(input: NotificationInput): string {\n\tconst { task, duration, statusText, allComplete, remainingCount, completedTasks } = input;\n\tconst errorInfo = task.error ? `\\n**Error:** ${task.error}` : \"\";\n\n\tif (allComplete) {\n\t\treturn formatAllCompleteNotification(task, completedTasks);\n\t}\n\n\tconst isFailure = statusText !== \"COMPLETED\";\n\n\treturn `<system-reminder>\n[BACKGROUND TASK ${statusText}]\n**ID:** \\`${task.id}\\`\n**Description:** ${safeDescription(task)}\n**Duration:** ${duration}${errorInfo}\n\n**${remainingCount} task${remainingCount === 1 ? \"\" : \"s\"} still in progress.** You WILL be notified when ALL complete.\n${isFailure ? \"**ACTION REQUIRED:** This task failed. Check the error and decide whether to retry, cancel remaining tasks, or continue.\" : \"Do NOT poll - continue productive work.\"}\n\nUse \\`background_output(task_id=\"${task.id}\")\\` to retrieve this result when ready.\n</system-reminder>`;\n}\n\nfunction formatAllCompleteNotification(task: NotificationTask, completedTasks: NotificationTask[]): string {\n\tconst succeededTasks = completedTasks.filter((t) => t.status === \"completed\");\n\tconst failedTasks = completedTasks.filter((t) => t.status !== \"completed\");\n\n\tconst succeededText =\n\t\tsucceededTasks.length > 0 ? succeededTasks.map((t) => `- \\`${t.id}\\`: ${safeDescription(t)}`).join(\"\\n\") : \"\";\n\tconst failedText =\n\t\tfailedTasks.length > 0\n\t\t\t? failedTasks\n\t\t\t\t\t.map(\n\t\t\t\t\t\t(t) =>\n\t\t\t\t\t\t\t`- \\`${t.id}\\`: ${safeDescription(t)} [${t.status.toUpperCase()}]${t.error ? ` - ${t.error}` : \"\"}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\")\n\t\t\t: \"\";\n\n\tconst hasFailures = failedTasks.length > 0;\n\tconst header = hasFailures\n\t\t? `[ALL BACKGROUND TASKS FINISHED - ${failedTasks.length} FAILED]`\n\t\t: \"[ALL BACKGROUND TASKS COMPLETE]\";\n\n\tlet body = \"\";\n\tif (succeededText) {\n\t\tbody += `**Completed:**\\n${succeededText}\\n`;\n\t}\n\tif (failedText) {\n\t\tbody += `\\n**Failed:**\\n${failedText}\\n`;\n\t}\n\tif (!body) {\n\t\tbody = `- \\`${task.id}\\`: ${safeDescription(task)} [${task.status.toUpperCase()}]${task.error ? ` - ${task.error}` : \"\"}\\n`;\n\t}\n\n\treturn `<system-reminder>\n${header}\n\n${body.trim()}\n\nUse \\`background_output(task_id=\"<id>\")\\` to retrieve each result.${hasFailures ? `\\n\\n**ACTION REQUIRED:** ${failedTasks.length} task(s) failed. Check errors above and decide whether to retry or proceed.` : \"\"}\n</system-reminder>`;\n}\n\nfunction formatDuration(startedAt: Date, completedAt: Date | undefined): string {\n\tconst end = completedAt ?? new Date();\n\tconst milliseconds = end.getTime() - startedAt.getTime();\n\tif (milliseconds < 1000) {\n\t\treturn `${milliseconds}ms`;\n\t}\n\tif (milliseconds < 60000) {\n\t\treturn `${(milliseconds / 1000).toFixed(1)}s`;\n\t}\n\treturn `${Math.floor(milliseconds / 60000)}m ${Math.floor((milliseconds % 60000) / 1000)}s`;\n}\n\nfunction mapStatus(task: BackgroundTask): NotificationStatus {\n\tswitch (task.status) {\n\t\tcase \"cancelled\":\n\t\t\treturn \"CANCELLED\";\n\t\tcase \"error\":\n\t\t\treturn \"ERROR\";\n\t\tdefault:\n\t\t\treturn \"COMPLETED\";\n\t}\n}\n\nfunction isTerminalStatus(status: BackgroundTask[\"status\"]): boolean {\n\treturn status === \"completed\" || status === \"error\" || status === \"cancelled\";\n}\n\nexport function sendCompletionNotification(pi: ExtensionAPI, task: BackgroundTask, manager: BackgroundManager): void {\n\tconst activeTasks = manager.getActiveTasks();\n\tconst allComplete = activeTasks.length === 0;\n\tconst remainingCount = activeTasks.length;\n\n\tconst completedTasks: NotificationTask[] = allComplete\n\t\t? manager\n\t\t\t\t.getAllTasks()\n\t\t\t\t.filter((t) => isTerminalStatus(t.status))\n\t\t\t\t.map((t) => ({ id: t.id, description: t.description, status: t.status, error: t.error, result: t.result }))\n\t\t: [];\n\n\tconst duration = formatDuration(task.startedAt, task.completedAt);\n\tconst statusText = mapStatus(task);\n\n\tconst message = formatCompletionNotification({\n\t\ttask: { id: task.id, description: task.description, status: task.status, error: task.error, result: task.result },\n\t\tduration,\n\t\tstatusText,\n\t\tallComplete,\n\t\tremainingCount,\n\t\tcompletedTasks,\n\t});\n\n\tsendBuiltinCustomMessage(\n\t\tpi,\n\t\t\"background-task.notification\",\n\t\t{\n\t\t\tcustomType: \"background-task.complete\",\n\t\t\tdisplay: true,\n\t\t\tcontent: [{ type: \"text\", text: message }],\n\t\t},\n\t\t{ triggerTurn: true, deliverAs: \"followUp\", sessionId: task.parentSessionId },\n\t);\n}\n"]}

package/dist/core/extensions/builtin/background-task/notification.js

@@ -0,0 +1,105 @@
+import { sendBuiltinCustomMessage } from "../system-messages.js";
+function safeDescription(task) {
+    return task.description || task.id;
+}
+export function formatCompletionNotification(input) {
+    const { task, duration, statusText, allComplete, remainingCount, completedTasks } = input;
+    const errorInfo = task.error ? `\n**Error:** ${task.error}` : "";
+    if (allComplete) {
+        return formatAllCompleteNotification(task, completedTasks);
+    }
+    const isFailure = statusText !== "COMPLETED";
+    return `<system-reminder>
+[BACKGROUND TASK ${statusText}]
+**ID:** \`${task.id}\`
+**Description:** ${safeDescription(task)}
+**Duration:** ${duration}${errorInfo}
+
+**${remainingCount} task${remainingCount === 1 ? "" : "s"} still in progress.** You WILL be notified when ALL complete.
+${isFailure ? "**ACTION REQUIRED:** This task failed. Check the error and decide whether to retry, cancel remaining tasks, or continue." : "Do NOT poll - continue productive work."}
+
+Use \`background_output(task_id="${task.id}")\` to retrieve this result when ready.
+</system-reminder>`;
+}
+function formatAllCompleteNotification(task, completedTasks) {
+    const succeededTasks = completedTasks.filter((t) => t.status === "completed");
+    const failedTasks = completedTasks.filter((t) => t.status !== "completed");
+    const succeededText = succeededTasks.length > 0 ? succeededTasks.map((t) => `- \`${t.id}\`: ${safeDescription(t)}`).join("\n") : "";
+    const failedText = failedTasks.length > 0
+        ? failedTasks
+            .map((t) => `- \`${t.id}\`: ${safeDescription(t)} [${t.status.toUpperCase()}]${t.error ? ` - ${t.error}` : ""}`)
+            .join("\n")
+        : "";
+    const hasFailures = failedTasks.length > 0;
+    const header = hasFailures
+        ? `[ALL BACKGROUND TASKS FINISHED - ${failedTasks.length} FAILED]`
+        : "[ALL BACKGROUND TASKS COMPLETE]";
+    let body = "";
+    if (succeededText) {
+        body += `**Completed:**\n${succeededText}\n`;
+    }
+    if (failedText) {
+        body += `\n**Failed:**\n${failedText}\n`;
+    }
+    if (!body) {
+        body = `- \`${task.id}\`: ${safeDescription(task)} [${task.status.toUpperCase()}]${task.error ? ` - ${task.error}` : ""}\n`;
+    }
+    return `<system-reminder>
+${header}
+
+${body.trim()}
+
+Use \`background_output(task_id="<id>")\` to retrieve each result.${hasFailures ? `\n\n**ACTION REQUIRED:** ${failedTasks.length} task(s) failed. Check errors above and decide whether to retry or proceed.` : ""}
+</system-reminder>`;
+}
+function formatDuration(startedAt, completedAt) {
+    const end = completedAt ?? new Date();
+    const milliseconds = end.getTime() - startedAt.getTime();
+    if (milliseconds < 1000) {
+        return `${milliseconds}ms`;
+    }
+    if (milliseconds < 60000) {
+        return `${(milliseconds / 1000).toFixed(1)}s`;
+    }
+    return `${Math.floor(milliseconds / 60000)}m ${Math.floor((milliseconds % 60000) / 1000)}s`;
+}
+function mapStatus(task) {
+    switch (task.status) {
+        case "cancelled":
+            return "CANCELLED";
+        case "error":
+            return "ERROR";
+        default:
+            return "COMPLETED";
+    }
+}
+function isTerminalStatus(status) {
+    return status === "completed" || status === "error" || status === "cancelled";
+}
+export function sendCompletionNotification(pi, task, manager) {
+    const activeTasks = manager.getActiveTasks();
+    const allComplete = activeTasks.length === 0;
+    const remainingCount = activeTasks.length;
+    const completedTasks = allComplete
+        ? manager
+            .getAllTasks()
+            .filter((t) => isTerminalStatus(t.status))
+            .map((t) => ({ id: t.id, description: t.description, status: t.status, error: t.error, result: t.result }))
+        : [];
+    const duration = formatDuration(task.startedAt, task.completedAt);
+    const statusText = mapStatus(task);
+    const message = formatCompletionNotification({
+        task: { id: task.id, description: task.description, status: task.status, error: task.error, result: task.result },
+        duration,
+        statusText,
+        allComplete,
+        remainingCount,
+        completedTasks,
+    });
+    sendBuiltinCustomMessage(pi, "background-task.notification", {
+        customType: "background-task.complete",
+        display: true,
+        content: [{ type: "text", text: message }],
+    }, { triggerTurn: true, deliverAs: "followUp", sessionId: task.parentSessionId });
+}
+//# sourceMappingURL=notification.js.map

package/dist/core/extensions/builtin/background-task/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/notification.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExtensionAPI } from \"../../types.js\";\nimport { sendBuiltinCustomMessage } from \"../system-messages.js\";\nimport type { BackgroundManager } from \"./manager.js\";\nimport type { BackgroundTask } from \"./types.js\";\n\nexport type NotificationStatus = \"COMPLETED\" | \"CANCELLED\" | \"ERROR\";\n\nexport interface NotificationTask {\n\tid: string;\n\tdescription: string;\n\tstatus: BackgroundTask[\"status\"];\n\terror?: string;\n\tresult?: string;\n}\n\nexport interface NotificationInput {\n\ttask: NotificationTask;\n\tduration: string;\n\tstatusText: NotificationStatus;\n\tallComplete: boolean;\n\tremainingCount: number;\n\tcompletedTasks: NotificationTask[];\n}\n\nfunction safeDescription(task: NotificationTask): string {\n\treturn task.description || task.id;\n}\n\nexport function formatCompletionNotification(input: NotificationInput): string {\n\tconst { task, duration, statusText, allComplete, remainingCount, completedTasks } = input;\n\tconst errorInfo = task.error ? `\\n**Error:** ${task.error}` : \"\";\n\n\tif (allComplete) {\n\t\treturn formatAllCompleteNotification(task, completedTasks);\n\t}\n\n\tconst isFailure = statusText !== \"COMPLETED\";\n\n\treturn `<system-reminder>\n[BACKGROUND TASK ${statusText}]\n**ID:** \\`${task.id}\\`\n**Description:** ${safeDescription(task)}\n**Duration:** ${duration}${errorInfo}\n\n**${remainingCount} task${remainingCount === 1 ? \"\" : \"s\"} still in progress.** You WILL be notified when ALL complete.\n${isFailure ? \"**ACTION REQUIRED:** This task failed. Check the error and decide whether to retry, cancel remaining tasks, or continue.\" : \"Do NOT poll - continue productive work.\"}\n\nUse \\`background_output(task_id=\"${task.id}\")\\` to retrieve this result when ready.\n</system-reminder>`;\n}\n\nfunction formatAllCompleteNotification(task: NotificationTask, completedTasks: NotificationTask[]): string {\n\tconst succeededTasks = completedTasks.filter((t) => t.status === \"completed\");\n\tconst failedTasks = completedTasks.filter((t) => t.status !== \"completed\");\n\n\tconst succeededText =\n\t\tsucceededTasks.length > 0 ? succeededTasks.map((t) => `- \\`${t.id}\\`: ${safeDescription(t)}`).join(\"\\n\") : \"\";\n\tconst failedText =\n\t\tfailedTasks.length > 0\n\t\t\t? failedTasks\n\t\t\t\t\t.map(\n\t\t\t\t\t\t(t) =>\n\t\t\t\t\t\t\t`- \\`${t.id}\\`: ${safeDescription(t)} [${t.status.toUpperCase()}]${t.error ? ` - ${t.error}` : \"\"}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\")\n\t\t\t: \"\";\n\n\tconst hasFailures = failedTasks.length > 0;\n\tconst header = hasFailures\n\t\t? `[ALL BACKGROUND TASKS FINISHED - ${failedTasks.length} FAILED]`\n\t\t: \"[ALL BACKGROUND TASKS COMPLETE]\";\n\n\tlet body = \"\";\n\tif (succeededText) {\n\t\tbody += `**Completed:**\\n${succeededText}\\n`;\n\t}\n\tif (failedText) {\n\t\tbody += `\\n**Failed:**\\n${failedText}\\n`;\n\t}\n\tif (!body) {\n\t\tbody = `- \\`${task.id}\\`: ${safeDescription(task)} [${task.status.toUpperCase()}]${task.error ? ` - ${task.error}` : \"\"}\\n`;\n\t}\n\n\treturn `<system-reminder>\n${header}\n\n${body.trim()}\n\nUse \\`background_output(task_id=\"<id>\")\\` to retrieve each result.${hasFailures ? `\\n\\n**ACTION REQUIRED:** ${failedTasks.length} task(s) failed. Check errors above and decide whether to retry or proceed.` : \"\"}\n</system-reminder>`;\n}\n\nfunction formatDuration(startedAt: Date, completedAt: Date | undefined): string {\n\tconst end = completedAt ?? new Date();\n\tconst milliseconds = end.getTime() - startedAt.getTime();\n\tif (milliseconds < 1000) {\n\t\treturn `${milliseconds}ms`;\n\t}\n\tif (milliseconds < 60000) {\n\t\treturn `${(milliseconds / 1000).toFixed(1)}s`;\n\t}\n\treturn `${Math.floor(milliseconds / 60000)}m ${Math.floor((milliseconds % 60000) / 1000)}s`;\n}\n\nfunction mapStatus(task: BackgroundTask): NotificationStatus {\n\tswitch (task.status) {\n\t\tcase \"cancelled\":\n\t\t\treturn \"CANCELLED\";\n\t\tcase \"error\":\n\t\t\treturn \"ERROR\";\n\t\tdefault:\n\t\t\treturn \"COMPLETED\";\n\t}\n}\n\nfunction isTerminalStatus(status: BackgroundTask[\"status\"]): boolean {\n\treturn status === \"completed\" || status === \"error\" || status === \"cancelled\";\n}\n\nexport function sendCompletionNotification(pi: ExtensionAPI, task: BackgroundTask, manager: BackgroundManager): void {\n\tconst activeTasks = manager.getActiveTasks();\n\tconst allComplete = activeTasks.length === 0;\n\tconst remainingCount = activeTasks.length;\n\n\tconst completedTasks: NotificationTask[] = allComplete\n\t\t? manager\n\t\t\t\t.getAllTasks()\n\t\t\t\t.filter((t) => isTerminalStatus(t.status))\n\t\t\t\t.map((t) => ({ id: t.id, description: t.description, status: t.status, error: t.error, result: t.result }))\n\t\t: [];\n\n\tconst duration = formatDuration(task.startedAt, task.completedAt);\n\tconst statusText = mapStatus(task);\n\n\tconst message = formatCompletionNotification({\n\t\ttask: { id: task.id, description: task.description, status: task.status, error: task.error, result: task.result },\n\t\tduration,\n\t\tstatusText,\n\t\tallComplete,\n\t\tremainingCount,\n\t\tcompletedTasks,\n\t});\n\n\tsendBuiltinCustomMessage(\n\t\tpi,\n\t\t\"background-task.notification\",\n\t\t{\n\t\t\tcustomType: \"background-task.complete\",\n\t\t\tdisplay: true,\n\t\t\tcontent: [{ type: \"text\", text: message }],\n\t\t},\n\t\t{ triggerTurn: true, deliverAs: \"followUp\", sessionId: task.parentSessionId },\n\t);\n}\n"]}

package/dist/core/extensions/builtin/background-task/output-tool.d.ts

@@ -0,0 +1,11 @@
+import { Type } from "typebox";
+import type { ToolDefinition } from "../../types.js";
+import type { BackgroundManager } from "./manager.js";
+declare const BackgroundOutputParams: Type.TObject<{
+    task_id: Type.TString;
+    block: Type.TOptional<Type.TBoolean>;
+    timeout: Type.TOptional<Type.TNumber>;
+}>;
+export declare function createBackgroundOutputTool(manager: BackgroundManager): ToolDefinition<typeof BackgroundOutputParams>;
+export {};
+//# sourceMappingURL=output-tool.d.ts.map

package/dist/core/extensions/builtin/background-task/output-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-tool.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/output-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAItD,QAAA,MAAM,sBAAsB;;;;EAQ1B,CAAC;AA+BH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iBAAiB,GAAG,cAAc,CAAC,OAAO,sBAAsB,CAAC,CA8FpH","sourcesContent":["import { Text } from \"@earendil-works/pi-tui\";\nimport { Type } from \"typebox\";\nimport type { ToolDefinition } from \"../../types.js\";\nimport type { BackgroundManager } from \"./manager.js\";\nimport type { BackgroundTask } from \"./types.js\";\nimport { DEFAULT_BLOCK_TIMEOUT, MAX_BLOCK_TIMEOUT } from \"./types.js\";\n\nconst BackgroundOutputParams = Type.Object({\n\ttask_id: Type.String({ description: \"Task ID to get output from\" }),\n\tblock: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription: \"Wait for completion (default: false). System notifies when done, so blocking is rarely needed.\",\n\t\t}),\n\t),\n\ttimeout: Type.Optional(Type.Number({ description: \"Max wait time in ms (default: 60000, max: 300000)\" })),\n});\n\nfunction formatDuration(startedAt: Date, completedAt: Date | undefined): string {\n\tconst end = completedAt ?? new Date();\n\tconst ms = end.getTime() - startedAt.getTime();\n\tif (ms < 1000) return `${ms}ms`;\n\tif (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;\n\treturn `${Math.floor(ms / 60000)}m ${Math.floor((ms % 60000) / 1000)}s`;\n}\n\nfunction formatTaskOutput(task: BackgroundTask): string {\n\tconst lines: string[] = [`Task: ${task.id}`, `Description: ${task.description}`, `Status: ${task.status}`];\n\n\tif (task.status === \"completed\") {\n\t\tlines.push(`Duration: ${formatDuration(task.startedAt, task.completedAt)}`);\n\t\tlines.push(\"Result:\");\n\t\tlines.push(task.result ?? \"(no output)\");\n\t} else if (task.status === \"error\") {\n\t\tlines.push(`Duration: ${formatDuration(task.startedAt, task.completedAt)}`);\n\t\tlines.push(\"Error:\");\n\t\tlines.push(task.error ?? \"(unknown error)\");\n\t} else if (task.status === \"cancelled\") {\n\t\tlines.push(`Duration: ${formatDuration(task.startedAt, task.completedAt)}`);\n\t\tlines.push(\"Status: Cancelled\");\n\t} else {\n\t\tlines.push(`Elapsed: ${formatDuration(task.startedAt, undefined)}`);\n\t}\n\n\treturn lines.join(\"\\n\");\n}\n\nexport function createBackgroundOutputTool(manager: BackgroundManager): ToolDefinition<typeof BackgroundOutputParams> {\n\treturn {\n\t\tname: \"background_output\",\n\t\tlabel: \"BackgroundOutput\",\n\t\tdescription: `Get output from background task. System notifies on completion, so block=true rarely needed.\n\nIMPORTANT: ONLY call this tool AFTER receiving a <system-reminder> notification for the task. Do NOT call immediately after launching a background task - wait for the notification first.`,\n\t\tpromptSnippet: \"Retrieve results from a completed background task by task_id.\",\n\t\tpromptGuidelines: [\n\t\t\t\"ONLY call this tool AFTER receiving a <system-reminder> notification for the task.\",\n\t\t\t\"Do NOT call this immediately after launching a background task - wait for the notification first.\",\n\t\t\t\"Set block=true only if you must wait synchronously (rarely needed).\",\n\t\t],\n\t\tparameters: BackgroundOutputParams,\n\t\tasync execute(_toolCallId, params, _signal, _onUpdate, _ctx) {\n\t\t\tconst task = manager.getTask(params.task_id);\n\n\t\t\tif (!task) {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Error: Task not found: ${params.task_id}` }],\n\t\t\t\t\tdetails: undefined,\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (task.status === \"completed\" || task.status === \"error\" || task.status === \"cancelled\") {\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: formatTaskOutput(task) }],\n\t\t\t\t\tdetails: { task },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (!params.block) {\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: `Task ${params.task_id} is still running. Do NOT call BackgroundOutput again for this task - the system will notify you when it completes. Continue with other work or end your response.`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: { task },\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tconst timeoutMs = Math.min(params.timeout ?? DEFAULT_BLOCK_TIMEOUT, MAX_BLOCK_TIMEOUT);\n\t\t\tconst startTime = Date.now();\n\n\t\t\ttry {\n\t\t\t\tconst finalTask = await new Promise<BackgroundTask>((resolve, reject) => {\n\t\t\t\t\tconst interval = setInterval(() => {\n\t\t\t\t\t\tconst current = manager.getTask(params.task_id);\n\t\t\t\t\t\tif (!current) {\n\t\t\t\t\t\t\tclearInterval(interval);\n\t\t\t\t\t\t\treject(new Error(`Task not found: ${params.task_id}`));\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (current.status === \"completed\" || current.status === \"error\" || current.status === \"cancelled\") {\n\t\t\t\t\t\t\tclearInterval(interval);\n\t\t\t\t\t\t\tresolve(current);\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (Date.now() - startTime >= timeoutMs) {\n\t\t\t\t\t\t\tclearInterval(interval);\n\t\t\t\t\t\t\treject(new Error(`Timeout waiting for task ${params.task_id}`));\n\t\t\t\t\t\t}\n\t\t\t\t\t}, 100);\n\t\t\t\t});\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: formatTaskOutput(finalTask) }],\n\t\t\t\t\tdetails: { task: finalTask },\n\t\t\t\t};\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Error: ${message}` }],\n\t\t\t\t\tdetails: undefined,\n\t\t\t\t\tisError: true,\n\t\t\t\t};\n\t\t\t}\n\t\t},\n\t\trenderCall(args, theme) {\n\t\t\treturn new Text(\n\t\t\t\ttheme.fg(\"toolTitle\", theme.bold(\"BackgroundOutput \")) + theme.fg(\"accent\", args.task_id),\n\t\t\t\t0,\n\t\t\t\t0,\n\t\t\t);\n\t\t},\n\t\trenderResult(result, _options, theme) {\n\t\t\tconst firstContent = result.content[0];\n\t\t\tconst text = firstContent?.type === \"text\" ? firstContent.text : \"(no output)\";\n\t\t\treturn new Text(theme.fg(\"muted\", text), 0, 0);\n\t\t},\n\t};\n}\n"]}