@code-yeongyu/senpi 0.74.0

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

@@ -0,0 +1,302 @@
+import { Text } from "@earendil-works/pi-tui";
+import { Type } from "typebox";
+import { DEPTH_ENV_VAR, MAX_SUBAGENT_DEPTH, TASK_ENTRY_TYPE } from "./types.js";
+function buildTaskMetadata(args) {
+    const overview = [
+        args.agentType,
+        args.model,
+        args.activeToolNames && args.activeToolNames.length > 0 ? `tools: ${args.activeToolNames.join(", ")}` : undefined,
+    ].filter((value) => typeof value === "string" && value.length > 0);
+    return {
+        headline: `${args.description}${args.runInBackground ? " [async]" : " [sync]"}`,
+        ...(overview.length > 0 ? { overview: overview.join(" · ") } : {}),
+    };
+}
+function buildTaskOverviewItems(details) {
+    if (!details) {
+        return [];
+    }
+    return [
+        details.agentType,
+        details.model,
+        details.activeToolNames && details.activeToolNames.length > 0
+            ? `tools: ${details.activeToolNames.join(", ")}`
+            : undefined,
+    ].filter((value) => typeof value === "string" && value.length > 0);
+}
+const TaskToolParams = Type.Object({
+    description: Type.String({
+        description: "A short (3-5 words) description of the task",
+    }),
+    prompt: Type.String({
+        description: "The task for the agent to perform",
+    }),
+    run_in_background: Type.Boolean({
+        description: "REQUIRED. true=async (returns task_id, system notifies on completion), false=sync (waits for result).",
+    }),
+    session_id: Type.Optional(Type.String({ description: "Existing Task session to continue" })),
+    model: Type.Optional(Type.String({ description: "Model to use for this task" })),
+    agent_type: Type.Optional(Type.String({
+        description: "Agent type to use for this task (e.g. 'explore', 'general'). Determines available tools and permissions.",
+    })),
+});
+function createErrorResult(text) {
+    return {
+        content: [{ type: "text", text }],
+        details: {},
+        isError: true,
+    };
+}
+function resolveModel(params, ctx) {
+    if (params.model) {
+        return params.model;
+    }
+    if (!ctx.model) {
+        return undefined;
+    }
+    return `${ctx.model.provider}/${ctx.model.id}`;
+}
+function isCancelledTask(manager, taskId) {
+    return manager.getTask(taskId)?.status === "cancelled";
+}
+export function createTaskTool(manager, spawner, pi, agentDescriptions) {
+    const baseDescription = `Run a sub-agent in sync or async mode.
+
+Sync mode (run_in_background=false): waits for the sub-agent to finish and returns its text output directly.
+Async mode (run_in_background=true): starts the sub-agent, returns a task_id immediately. System sends a notification when done.
+
+session_id is optional and continues an existing session when provided.
+model is optional and defaults to the current model.`;
+    const fullDescription = agentDescriptions
+        ? `${baseDescription}\n\nAvailable agent types:\n${agentDescriptions}`
+        : baseDescription;
+    const taskTool = {
+        name: "task",
+        label: "Task",
+        description: fullDescription,
+        promptSnippet: "Run a sub-agent either synchronously for direct output or asynchronously for a background task_id.",
+        promptGuidelines: [
+            "Use run_in_background=false when you need the sub-agent result in the same turn.",
+            "Use run_in_background=true for parallel work. System notifies on completion via <system-reminder>.",
+            "After launching a background task, do NOT call background_output - wait for the <system-reminder> notification first.",
+            "Pass session_id to continue an existing sub-agent session.",
+        ],
+        parameters: TaskToolParams,
+        async execute(_toolCallId, params, signal, onUpdate, ctx) {
+            if (!params.description.trim()) {
+                return createErrorResult("Error: description is required");
+            }
+            const currentDepth = Number.parseInt(process.env[DEPTH_ENV_VAR] ?? "0", 10);
+            if (currentDepth >= MAX_SUBAGENT_DEPTH) {
+                return createErrorResult(`Error: max subagent depth (${MAX_SUBAGENT_DEPTH}) exceeded`);
+            }
+            const model = resolveModel(params, ctx);
+            const taskDetails = {
+                agentType: params.agent_type,
+                model,
+                activeToolNames: [],
+            };
+            const permissionFlag = typeof pi.getFlag === "function"
+                ? (pi.getFlag("permission") ?? undefined)
+                : undefined;
+            if (!params.run_in_background) {
+                const spawned = spawner({
+                    prompt: params.prompt,
+                    cwd: ctx.cwd,
+                    model,
+                    agentType: params.agent_type,
+                    sessionPath: params.session_id,
+                    permissionFlag: permissionFlag ?? undefined,
+                    signal,
+                });
+                const result = await spawned.result;
+                return {
+                    content: [{ type: "text", text: result.text || "(no output)" }],
+                    details: taskDetails,
+                };
+            }
+            let executeReturned = false;
+            try {
+                const task = manager.launch({
+                    description: params.description,
+                    prompt: params.prompt,
+                    model,
+                    agentType: params.agent_type,
+                    pid: undefined,
+                    sessionPath: params.session_id,
+                    activeToolNames: [],
+                    completedAt: undefined,
+                    result: undefined,
+                    error: undefined,
+                    parentSessionId: "unknown",
+                });
+                pi.appendEntry(TASK_ENTRY_TYPE, task);
+                const spawned = spawner({
+                    prompt: params.prompt,
+                    cwd: ctx.cwd,
+                    model,
+                    agentType: params.agent_type,
+                    sessionPath: params.session_id,
+                    permissionFlag: permissionFlag ?? undefined,
+                    signal,
+                    onEvent: (() => {
+                        const activeToolCalls = new Map();
+                        return (event) => {
+                            if (event.type === "tool_execution_start") {
+                                activeToolCalls.set(event.toolCallId, event.toolName);
+                            }
+                            else if (event.type === "tool_execution_end") {
+                                activeToolCalls.delete(event.toolCallId);
+                            }
+                            const currentTask = manager.getTask(task.id);
+                            if (!currentTask) {
+                                return;
+                            }
+                            const activeToolNames = Array.from(activeToolCalls.values());
+                            manager.updateTask(task.id, {
+                                activeToolNames,
+                                ...(activeToolCalls.size > 0 && currentTask.status === "pending" ? { status: "running" } : {}),
+                            });
+                            if (!executeReturned) {
+                                onUpdate?.({
+                                    content: [],
+                                    details: {
+                                        ...taskDetails,
+                                        activeToolNames,
+                                    },
+                                });
+                            }
+                            const activeTask = manager.getTask(task.id);
+                            if (activeTask) {
+                                pi.appendEntry(TASK_ENTRY_TYPE, activeTask);
+                            }
+                        };
+                    })(),
+                });
+                if (spawned.process.pid !== undefined) {
+                    manager.updateTask(task.id, { pid: spawned.process.pid, status: "running" });
+                    onUpdate?.({ content: [], details: taskDetails });
+                    const runningTask = manager.getTask(task.id);
+                    if (runningTask) {
+                        pi.appendEntry(TASK_ENTRY_TYPE, runningTask);
+                    }
+                }
+                spawned.result
+                    .then((result) => {
+                    if (isCancelledTask(manager, task.id)) {
+                        return;
+                    }
+                    manager.updateTask(task.id, {
+                        status: result.exitCode === 0 ? "completed" : "error",
+                        completedAt: new Date(),
+                        activeToolNames: [],
+                        result: result.text,
+                        error: result.exitCode === 0 ? undefined : `Sub-agent exited with code ${result.exitCode}`,
+                    });
+                    const completedTask = manager.getTask(task.id);
+                    if (completedTask) {
+                        pi.appendEntry(TASK_ENTRY_TYPE, completedTask);
+                    }
+                    pi.sendMessage({
+                        customType: "background-task.complete",
+                        display: true,
+                        content: [
+                            {
+                                type: "text",
+                                text: [
+                                    `Task ${task.id} completed: ${params.description}`,
+                                    "",
+                                    "Result:",
+                                    result.text || "(no output)",
+                                ].join("\n"),
+                            },
+                        ],
+                    }, { triggerTurn: true, deliverAs: "followUp" });
+                })
+                    .catch((error) => {
+                    if (isCancelledTask(manager, task.id)) {
+                        return;
+                    }
+                    manager.updateTask(task.id, {
+                        status: "error",
+                        completedAt: new Date(),
+                        activeToolNames: [],
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    const erroredTask = manager.getTask(task.id);
+                    if (erroredTask) {
+                        pi.appendEntry(TASK_ENTRY_TYPE, erroredTask);
+                    }
+                    const errorMsg = error instanceof Error ? error.message : String(error);
+                    pi.sendMessage({
+                        customType: "background-task.complete",
+                        display: true,
+                        content: [
+                            {
+                                type: "text",
+                                text: [`Task ${task.id} failed: ${params.description}`, "", "Error:", errorMsg].join("\n"),
+                            },
+                        ],
+                    }, { triggerTurn: true, deliverAs: "followUp" });
+                });
+                executeReturned = true;
+                const sessionIdBlock = params.session_id
+                    ? `\n\n<task_metadata>\nsession_id: ${params.session_id}\ntask_id: ${task.id}\nbackground_task_id: ${task.id}\n</task_metadata>\n\nto continue: task(session_id="${params.session_id}", run_in_background=false, prompt="...")`
+                    : `\n\n<task_metadata>\ntask_id: ${task.id}\nbackground_task_id: ${task.id}\n</task_metadata>`;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Background task launched.
+
+Background Task ID: ${task.id}
+Description: ${params.description}
+Agent: ${params.agent_type ?? "default"}
+Status: ${task.status}
+
+System notifies on completion. Use \`background_output\` with task_id="${task.id}" to check.
+
+Do NOT call background_output now. Wait for <system-reminder> notification first.${sessionIdBlock}`,
+                        },
+                    ],
+                    details: taskDetails,
+                };
+            }
+            catch (error) {
+                return createErrorResult(error instanceof Error ? error.message : String(error));
+            }
+        },
+        renderCall(args, theme) {
+            const metadata = buildTaskMetadata({
+                description: args.description,
+                runInBackground: args.run_in_background,
+                agentType: args.agent_type,
+                model: args.model,
+            });
+            return new Text([
+                theme.fg("toolTitle", theme.bold("Task ")) + theme.fg("accent", metadata.headline),
+                ...(metadata.overview ? [theme.fg("muted", `  ${metadata.overview}`)] : []),
+            ].join("\n"), 0, 0);
+        },
+        renderResult(result, options, theme, context) {
+            const firstContent = result.content[0];
+            const text = firstContent?.type === "text" ? firstContent.text : undefined;
+            const argDetails = {
+                agentType: context.args.agent_type,
+                model: context.args.model,
+            };
+            const callOverviewItems = new Set(buildTaskOverviewItems(argDetails));
+            const extraOverviewItems = buildTaskOverviewItems(result.details).filter((item) => !callOverviewItems.has(item));
+            const overview = extraOverviewItems.length > 0 ? extraOverviewItems.join(" · ") : undefined;
+            if (!text && !overview) {
+                return new Text("", 0, 0);
+            }
+            if (options.isPartial && !text) {
+                return new Text(overview ? theme.fg("muted", overview) : "", 0, 0);
+            }
+            return new Text([...(overview ? [theme.fg("muted", overview)] : []), ...(text ? [theme.fg("muted", text)] : [])].join("\n\n"), 0, 0);
+        },
+    };
+    return taskTool;
+}
+//# sourceMappingURL=task-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-tool.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/task-tool.ts"],"names":[],"mappings":"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","sourcesContent":["import { Text } from \"@earendil-works/pi-tui\";\nimport { Type } from \"typebox\";\nimport type { ExtensionAPI, ExtensionContext, ToolDefinition } from \"../../types.js\";\nimport type { BackgroundManager } from \"./manager.js\";\nimport type { spawnSubagent } from \"./spawner.js\";\nimport { DEPTH_ENV_VAR, MAX_SUBAGENT_DEPTH, TASK_ENTRY_TYPE } from \"./types.js\";\n\ntype TaskToolDetails = {\n\tagentType?: string;\n\tmodel?: string;\n\tactiveToolNames?: string[];\n};\n\nfunction buildTaskMetadata(args: {\n\tdescription: string;\n\trunInBackground: boolean;\n\tagentType?: string;\n\tmodel?: string;\n\tactiveToolNames?: string[];\n}): { headline: string; overview?: string } {\n\tconst overview = [\n\t\targs.agentType,\n\t\targs.model,\n\t\targs.activeToolNames && args.activeToolNames.length > 0 ? `tools: ${args.activeToolNames.join(\", \")}` : undefined,\n\t].filter((value): value is string => typeof value === \"string\" && value.length > 0);\n\n\treturn {\n\t\theadline: `${args.description}${args.runInBackground ? \" [async]\" : \" [sync]\"}`,\n\t\t...(overview.length > 0 ? { overview: overview.join(\" · \") } : {}),\n\t};\n}\n\nfunction buildTaskOverviewItems(details: TaskToolDetails | undefined): string[] {\n\tif (!details) {\n\t\treturn [];\n\t}\n\n\treturn [\n\t\tdetails.agentType,\n\t\tdetails.model,\n\t\tdetails.activeToolNames && details.activeToolNames.length > 0\n\t\t\t? `tools: ${details.activeToolNames.join(\", \")}`\n\t\t\t: undefined,\n\t].filter((value): value is string => typeof value === \"string\" && value.length > 0);\n}\n\nconst TaskToolParams = Type.Object({\n\tdescription: Type.String({\n\t\tdescription: \"A short (3-5 words) description of the task\",\n\t}),\n\tprompt: Type.String({\n\t\tdescription: \"The task for the agent to perform\",\n\t}),\n\trun_in_background: Type.Boolean({\n\t\tdescription:\n\t\t\t\"REQUIRED. true=async (returns task_id, system notifies on completion), false=sync (waits for result).\",\n\t}),\n\tsession_id: Type.Optional(Type.String({ description: \"Existing Task session to continue\" })),\n\tmodel: Type.Optional(Type.String({ description: \"Model to use for this task\" })),\n\tagent_type: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Agent type to use for this task (e.g. 'explore', 'general'). Determines available tools and permissions.\",\n\t\t}),\n\t),\n});\n\nfunction createErrorResult(text: string): {\n\tcontent: [{ type: \"text\"; text: string }];\n\tdetails: TaskToolDetails;\n\tisError: true;\n} {\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\tdetails: {},\n\t\tisError: true,\n\t};\n}\n\nfunction resolveModel(params: { model?: string }, ctx: ExtensionContext): string | undefined {\n\tif (params.model) {\n\t\treturn params.model;\n\t}\n\n\tif (!ctx.model) {\n\t\treturn undefined;\n\t}\n\n\treturn `${ctx.model.provider}/${ctx.model.id}`;\n}\n\nfunction isCancelledTask(manager: BackgroundManager, taskId: string): boolean {\n\treturn manager.getTask(taskId)?.status === \"cancelled\";\n}\n\nexport function createTaskTool(\n\tmanager: BackgroundManager,\n\tspawner: typeof spawnSubagent,\n\tpi: ExtensionAPI,\n\tagentDescriptions?: string,\n): ToolDefinition<typeof TaskToolParams, TaskToolDetails> {\n\tconst baseDescription = `Run a sub-agent in sync or async mode.\n\nSync mode (run_in_background=false): waits for the sub-agent to finish and returns its text output directly.\nAsync mode (run_in_background=true): starts the sub-agent, returns a task_id immediately. System sends a notification when done.\n\nsession_id is optional and continues an existing session when provided.\nmodel is optional and defaults to the current model.`;\n\n\tconst fullDescription = agentDescriptions\n\t\t? `${baseDescription}\\n\\nAvailable agent types:\\n${agentDescriptions}`\n\t\t: baseDescription;\n\n\tconst taskTool: ToolDefinition<typeof TaskToolParams, TaskToolDetails> = {\n\t\tname: \"task\",\n\t\tlabel: \"Task\",\n\t\tdescription: fullDescription,\n\t\tpromptSnippet:\n\t\t\t\"Run a sub-agent either synchronously for direct output or asynchronously for a background task_id.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Use run_in_background=false when you need the sub-agent result in the same turn.\",\n\t\t\t\"Use run_in_background=true for parallel work. System notifies on completion via <system-reminder>.\",\n\t\t\t\"After launching a background task, do NOT call background_output - wait for the <system-reminder> notification first.\",\n\t\t\t\"Pass session_id to continue an existing sub-agent session.\",\n\t\t],\n\t\tparameters: TaskToolParams,\n\t\tasync execute(_toolCallId, params, signal, onUpdate, ctx) {\n\t\t\tif (!params.description.trim()) {\n\t\t\t\treturn createErrorResult(\"Error: description is required\");\n\t\t\t}\n\n\t\t\tconst currentDepth = Number.parseInt(process.env[DEPTH_ENV_VAR] ?? \"0\", 10);\n\t\t\tif (currentDepth >= MAX_SUBAGENT_DEPTH) {\n\t\t\t\treturn createErrorResult(`Error: max subagent depth (${MAX_SUBAGENT_DEPTH}) exceeded`);\n\t\t\t}\n\n\t\t\tconst model = resolveModel(params, ctx);\n\t\t\tconst taskDetails: TaskToolDetails = {\n\t\t\t\tagentType: params.agent_type,\n\t\t\t\tmodel,\n\t\t\t\tactiveToolNames: [],\n\t\t\t};\n\n\t\t\tconst permissionFlag =\n\t\t\t\ttypeof pi.getFlag === \"function\"\n\t\t\t\t\t? ((pi.getFlag(\"permission\") as string | undefined) ?? undefined)\n\t\t\t\t\t: undefined;\n\n\t\t\tif (!params.run_in_background) {\n\t\t\t\tconst spawned = spawner({\n\t\t\t\t\tprompt: params.prompt,\n\t\t\t\t\tcwd: ctx.cwd,\n\t\t\t\t\tmodel,\n\t\t\t\t\tagentType: params.agent_type,\n\t\t\t\t\tsessionPath: params.session_id,\n\t\t\t\t\tpermissionFlag: permissionFlag ?? undefined,\n\t\t\t\t\tsignal,\n\t\t\t\t});\n\t\t\t\tconst result = await spawned.result;\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: result.text || \"(no output)\" }],\n\t\t\t\t\tdetails: taskDetails,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet executeReturned = false;\n\t\t\ttry {\n\t\t\t\tconst task = manager.launch({\n\t\t\t\t\tdescription: params.description,\n\t\t\t\t\tprompt: params.prompt,\n\t\t\t\t\tmodel,\n\t\t\t\t\tagentType: params.agent_type,\n\t\t\t\t\tpid: undefined,\n\t\t\t\t\tsessionPath: params.session_id,\n\t\t\t\t\tactiveToolNames: [],\n\t\t\t\t\tcompletedAt: undefined,\n\t\t\t\t\tresult: undefined,\n\t\t\t\t\terror: undefined,\n\t\t\t\t\tparentSessionId: \"unknown\",\n\t\t\t\t});\n\n\t\t\t\tpi.appendEntry(TASK_ENTRY_TYPE, task);\n\n\t\t\t\tconst spawned = spawner({\n\t\t\t\t\tprompt: params.prompt,\n\t\t\t\t\tcwd: ctx.cwd,\n\t\t\t\t\tmodel,\n\t\t\t\t\tagentType: params.agent_type,\n\t\t\t\t\tsessionPath: params.session_id,\n\t\t\t\t\tpermissionFlag: permissionFlag ?? undefined,\n\t\t\t\t\tsignal,\n\t\t\t\t\tonEvent: (() => {\n\t\t\t\t\t\tconst activeToolCalls = new Map<string, string>();\n\t\t\t\t\t\treturn (event) => {\n\t\t\t\t\t\t\tif (event.type === \"tool_execution_start\") {\n\t\t\t\t\t\t\t\tactiveToolCalls.set(event.toolCallId, event.toolName);\n\t\t\t\t\t\t\t} else if (event.type === \"tool_execution_end\") {\n\t\t\t\t\t\t\t\tactiveToolCalls.delete(event.toolCallId);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst currentTask = manager.getTask(task.id);\n\t\t\t\t\t\t\tif (!currentTask) {\n\t\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\tconst activeToolNames = Array.from(activeToolCalls.values());\n\n\t\t\t\t\t\t\tmanager.updateTask(task.id, {\n\t\t\t\t\t\t\t\tactiveToolNames,\n\t\t\t\t\t\t\t\t...(activeToolCalls.size > 0 && currentTask.status === \"pending\" ? { status: \"running\" } : {}),\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\tif (!executeReturned) {\n\t\t\t\t\t\t\t\tonUpdate?.({\n\t\t\t\t\t\t\t\t\tcontent: [],\n\t\t\t\t\t\t\t\t\tdetails: {\n\t\t\t\t\t\t\t\t\t\t...taskDetails,\n\t\t\t\t\t\t\t\t\t\tactiveToolNames,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tconst activeTask = manager.getTask(task.id);\n\t\t\t\t\t\t\tif (activeTask) {\n\t\t\t\t\t\t\t\tpi.appendEntry(TASK_ENTRY_TYPE, activeTask);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t};\n\t\t\t\t\t})(),\n\t\t\t\t});\n\n\t\t\t\tif (spawned.process.pid !== undefined) {\n\t\t\t\t\tmanager.updateTask(task.id, { pid: spawned.process.pid, status: \"running\" });\n\t\t\t\t\tonUpdate?.({ content: [], details: taskDetails });\n\t\t\t\t\tconst runningTask = manager.getTask(task.id);\n\t\t\t\t\tif (runningTask) {\n\t\t\t\t\t\tpi.appendEntry(TASK_ENTRY_TYPE, runningTask);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tspawned.result\n\t\t\t\t\t.then((result) => {\n\t\t\t\t\t\tif (isCancelledTask(manager, task.id)) {\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tmanager.updateTask(task.id, {\n\t\t\t\t\t\t\tstatus: result.exitCode === 0 ? \"completed\" : \"error\",\n\t\t\t\t\t\t\tcompletedAt: new Date(),\n\t\t\t\t\t\t\tactiveToolNames: [],\n\t\t\t\t\t\t\tresult: result.text,\n\t\t\t\t\t\t\terror: result.exitCode === 0 ? undefined : `Sub-agent exited with code ${result.exitCode}`,\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tconst completedTask = manager.getTask(task.id);\n\t\t\t\t\t\tif (completedTask) {\n\t\t\t\t\t\t\tpi.appendEntry(TASK_ENTRY_TYPE, completedTask);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tpi.sendMessage(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tcustomType: \"background-task.complete\",\n\t\t\t\t\t\t\t\tdisplay: true,\n\t\t\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\t\t\ttext: [\n\t\t\t\t\t\t\t\t\t\t\t`Task ${task.id} completed: ${params.description}`,\n\t\t\t\t\t\t\t\t\t\t\t\"\",\n\t\t\t\t\t\t\t\t\t\t\t\"Result:\",\n\t\t\t\t\t\t\t\t\t\t\tresult.text || \"(no output)\",\n\t\t\t\t\t\t\t\t\t\t].join(\"\\n\"),\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{ triggerTurn: true, deliverAs: \"followUp\" },\n\t\t\t\t\t\t);\n\t\t\t\t\t})\n\t\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\t\tif (isCancelledTask(manager, task.id)) {\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tmanager.updateTask(task.id, {\n\t\t\t\t\t\t\tstatus: \"error\",\n\t\t\t\t\t\t\tcompletedAt: new Date(),\n\t\t\t\t\t\t\tactiveToolNames: [],\n\t\t\t\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t\t\t\t});\n\n\t\t\t\t\t\tconst erroredTask = manager.getTask(task.id);\n\t\t\t\t\t\tif (erroredTask) {\n\t\t\t\t\t\t\tpi.appendEntry(TASK_ENTRY_TYPE, erroredTask);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst errorMsg = error instanceof Error ? error.message : String(error);\n\t\t\t\t\t\tpi.sendMessage(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tcustomType: \"background-task.complete\",\n\t\t\t\t\t\t\t\tdisplay: true,\n\t\t\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\ttype: \"text\",\n\t\t\t\t\t\t\t\t\t\ttext: [`Task ${task.id} failed: ${params.description}`, \"\", \"Error:\", errorMsg].join(\n\t\t\t\t\t\t\t\t\t\t\t\"\\n\",\n\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t{ triggerTurn: true, deliverAs: \"followUp\" },\n\t\t\t\t\t\t);\n\t\t\t\t\t});\n\n\t\t\t\texecuteReturned = true;\n\n\t\t\t\tconst sessionIdBlock = params.session_id\n\t\t\t\t\t? `\\n\\n<task_metadata>\\nsession_id: ${params.session_id}\\ntask_id: ${task.id}\\nbackground_task_id: ${task.id}\\n</task_metadata>\\n\\nto continue: task(session_id=\"${params.session_id}\", run_in_background=false, prompt=\"...\")`\n\t\t\t\t\t: `\\n\\n<task_metadata>\\ntask_id: ${task.id}\\nbackground_task_id: ${task.id}\\n</task_metadata>`;\n\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: `Background task launched.\n\nBackground Task ID: ${task.id}\nDescription: ${params.description}\nAgent: ${params.agent_type ?? \"default\"}\nStatus: ${task.status}\n\nSystem notifies on completion. Use \\`background_output\\` with task_id=\"${task.id}\" to check.\n\nDo NOT call background_output now. Wait for <system-reminder> notification first.${sessionIdBlock}`,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\tdetails: taskDetails,\n\t\t\t\t};\n\t\t\t} catch (error: unknown) {\n\t\t\t\treturn createErrorResult(error instanceof Error ? error.message : String(error));\n\t\t\t}\n\t\t},\n\t\trenderCall(args, theme) {\n\t\t\tconst metadata = buildTaskMetadata({\n\t\t\t\tdescription: args.description,\n\t\t\t\trunInBackground: args.run_in_background,\n\t\t\t\tagentType: args.agent_type,\n\t\t\t\tmodel: args.model,\n\t\t\t});\n\t\t\treturn new Text(\n\t\t\t\t[\n\t\t\t\t\ttheme.fg(\"toolTitle\", theme.bold(\"Task \")) + theme.fg(\"accent\", metadata.headline),\n\t\t\t\t\t...(metadata.overview ? [theme.fg(\"muted\", `  ${metadata.overview}`)] : []),\n\t\t\t\t].join(\"\\n\"),\n\t\t\t\t0,\n\t\t\t\t0,\n\t\t\t);\n\t\t},\n\t\trenderResult(result, options, theme, context) {\n\t\t\tconst firstContent = result.content[0];\n\t\t\tconst text = firstContent?.type === \"text\" ? firstContent.text : undefined;\n\t\t\tconst argDetails: TaskToolDetails = {\n\t\t\t\tagentType: context.args.agent_type,\n\t\t\t\tmodel: context.args.model,\n\t\t\t};\n\t\t\tconst callOverviewItems = new Set(buildTaskOverviewItems(argDetails));\n\t\t\tconst extraOverviewItems = buildTaskOverviewItems(result.details).filter(\n\t\t\t\t(item) => !callOverviewItems.has(item),\n\t\t\t);\n\t\t\tconst overview = extraOverviewItems.length > 0 ? extraOverviewItems.join(\" · \") : undefined;\n\n\t\t\tif (!text && !overview) {\n\t\t\t\treturn new Text(\"\", 0, 0);\n\t\t\t}\n\n\t\t\tif (options.isPartial && !text) {\n\t\t\t\treturn new Text(overview ? theme.fg(\"muted\", overview) : \"\", 0, 0);\n\t\t\t}\n\n\t\t\treturn new Text(\n\t\t\t\t[...(overview ? [theme.fg(\"muted\", overview)] : []), ...(text ? [theme.fg(\"muted\", text)] : [])].join(\n\t\t\t\t\t\"\\n\\n\",\n\t\t\t\t),\n\t\t\t\t0,\n\t\t\t\t0,\n\t\t\t);\n\t\t},\n\t};\n\n\treturn taskTool;\n}\n"]}

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

@@ -0,0 +1,72 @@
+import { type Static, Type } from "typebox";
+export type SpawnOptions = {
+    prompt: string;
+    cwd: string;
+    model?: string;
+    agentType?: string;
+    sessionPath?: string;
+    permissionFlag?: string;
+    signal?: AbortSignal;
+    env?: Record<string, string>;
+    onEvent?: (event: SpawnEvent) => void;
+};
+export type SpawnEvent = {
+    type: "tool_execution_start";
+    toolCallId: string;
+    toolName: string;
+} | {
+    type: "tool_execution_end";
+    toolCallId: string;
+    toolName: string;
+};
+export type SpawnedAgent = {
+    process: import("node:child_process").ChildProcess;
+    result: Promise<{
+        text: string;
+        exitCode: number;
+    }>;
+};
+export type BackgroundTask = {
+    id: string;
+    description: string;
+    prompt: string;
+    model: string | undefined;
+    agentType: string | undefined;
+    status: "pending" | "running" | "completed" | "error" | "cancelled";
+    pid: number | undefined;
+    sessionPath: string | undefined;
+    activeToolNames: string[];
+    startedAt: Date;
+    completedAt: Date | undefined;
+    result: string | undefined;
+    error: string | undefined;
+    parentSessionId: string;
+};
+export declare const TaskToolParams: Type.TObject<{
+    description: Type.TString;
+    prompt: Type.TString;
+    run_in_background: Type.TBoolean;
+    session_id: Type.TOptional<Type.TString>;
+    model: Type.TOptional<Type.TString>;
+    agent_type: Type.TOptional<Type.TString>;
+}>;
+export type TaskToolParamsType = Static<typeof TaskToolParams>;
+export declare const BackgroundOutputParams: Type.TObject<{
+    task_id: Type.TString;
+    block: Type.TOptional<Type.TBoolean>;
+    timeout: Type.TOptional<Type.TNumber>;
+}>;
+export type BackgroundOutputParamsType = Static<typeof BackgroundOutputParams>;
+export declare const BackgroundCancelParams: Type.TObject<{
+    taskId: Type.TOptional<Type.TString>;
+    all: Type.TOptional<Type.TBoolean>;
+}>;
+export type BackgroundCancelParamsType = Static<typeof BackgroundCancelParams>;
+export declare const MAX_CONCURRENT_TASKS: number;
+export declare const MAX_SUBAGENT_DEPTH = 1;
+export declare const DEPTH_ENV_VAR = "SANEPI_SUBAGENT_DEPTH";
+export declare const AGENT_TYPE_ENV_VAR = "SANEPI_AGENT_TYPE";
+export declare const TASK_ENTRY_TYPE = "background-task.state";
+export declare const DEFAULT_BLOCK_TIMEOUT = 60000;
+export declare const MAX_BLOCK_TIMEOUT = 300000;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,UAAU,GACnB;IACA,IAAI,EAAE,sBAAsB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAChB,GACD;IACA,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAChB,CAAC;AAEL,MAAM,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,OAAO,oBAAoB,EAAE,YAAY,CAAC;IACnD,MAAM,EAAE,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;IACpE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;EAezB,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAE/D,eAAO,MAAM,sBAAsB;;;;EAQjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/E,eAAO,MAAM,sBAAsB;;;EAGjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB,QAAW,CAAC;AAC7C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,kBAAkB,sBAAsB,CAAC;AACtD,eAAO,MAAM,eAAe,0BAA0B,CAAC;AACvD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,iBAAiB,SAAS,CAAC","sourcesContent":["import { type Static, Type } from \"typebox\";\n\nexport type SpawnOptions = {\n\tprompt: string;\n\tcwd: string;\n\tmodel?: string;\n\tagentType?: string;\n\tsessionPath?: string;\n\tpermissionFlag?: string;\n\tsignal?: AbortSignal;\n\tenv?: Record<string, string>;\n\tonEvent?: (event: SpawnEvent) => void;\n};\n\nexport type SpawnEvent =\n\t| {\n\t\t\ttype: \"tool_execution_start\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t  }\n\t| {\n\t\t\ttype: \"tool_execution_end\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t  };\n\nexport type SpawnedAgent = {\n\tprocess: import(\"node:child_process\").ChildProcess;\n\tresult: Promise<{ text: string; exitCode: number }>;\n};\n\nexport type BackgroundTask = {\n\tid: string;\n\tdescription: string;\n\tprompt: string;\n\tmodel: string | undefined;\n\tagentType: string | undefined;\n\tstatus: \"pending\" | \"running\" | \"completed\" | \"error\" | \"cancelled\";\n\tpid: number | undefined;\n\tsessionPath: string | undefined;\n\tactiveToolNames: string[];\n\tstartedAt: Date;\n\tcompletedAt: Date | undefined;\n\tresult: string | undefined;\n\terror: string | undefined;\n\tparentSessionId: string;\n};\n\nexport const TaskToolParams = Type.Object({\n\tdescription: Type.String({ description: \"A short (3-5 words) description of the task\" }),\n\tprompt: Type.String({ description: \"The task for the agent to perform\" }),\n\trun_in_background: Type.Boolean({\n\t\tdescription:\n\t\t\t\"REQUIRED. true=async (returns task_id, system notifies on completion), false=sync (waits for result).\",\n\t}),\n\tsession_id: Type.Optional(Type.String({ description: \"Existing Task session to continue\" })),\n\tmodel: Type.Optional(Type.String({ description: \"Model to use for this task\" })),\n\tagent_type: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Agent type to use for this task (e.g. 'explore', 'general'). Determines available tools and permissions.\",\n\t\t}),\n\t),\n});\n\nexport type TaskToolParamsType = Static<typeof TaskToolParams>;\n\nexport const 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\nexport type BackgroundOutputParamsType = Static<typeof BackgroundOutputParams>;\n\nexport const BackgroundCancelParams = Type.Object({\n\ttaskId: Type.Optional(Type.String({ description: \"Task ID to cancel (required if all=false)\" })),\n\tall: Type.Optional(Type.Boolean({ description: \"Cancel all running background tasks (default: false)\" })),\n});\n\nexport type BackgroundCancelParamsType = Static<typeof BackgroundCancelParams>;\n\nexport const MAX_CONCURRENT_TASKS = Infinity;\nexport const MAX_SUBAGENT_DEPTH = 1;\nexport const DEPTH_ENV_VAR = \"SANEPI_SUBAGENT_DEPTH\";\nexport const AGENT_TYPE_ENV_VAR = \"SANEPI_AGENT_TYPE\";\nexport const TASK_ENTRY_TYPE = \"background-task.state\";\nexport const DEFAULT_BLOCK_TIMEOUT = 60000;\nexport const MAX_BLOCK_TIMEOUT = 300000;\n"]}

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

@@ -0,0 +1,32 @@
+import { Type } from "typebox";
+export const TaskToolParams = Type.Object({
+    description: Type.String({ description: "A short (3-5 words) description of the task" }),
+    prompt: Type.String({ description: "The task for the agent to perform" }),
+    run_in_background: Type.Boolean({
+        description: "REQUIRED. true=async (returns task_id, system notifies on completion), false=sync (waits for result).",
+    }),
+    session_id: Type.Optional(Type.String({ description: "Existing Task session to continue" })),
+    model: Type.Optional(Type.String({ description: "Model to use for this task" })),
+    agent_type: Type.Optional(Type.String({
+        description: "Agent type to use for this task (e.g. 'explore', 'general'). Determines available tools and permissions.",
+    })),
+});
+export const BackgroundOutputParams = Type.Object({
+    task_id: Type.String({ description: "Task ID to get output from" }),
+    block: Type.Optional(Type.Boolean({
+        description: "Wait for completion (default: false). System notifies when done, so blocking is rarely needed.",
+    })),
+    timeout: Type.Optional(Type.Number({ description: "Max wait time in ms (default: 60000, max: 300000)" })),
+});
+export const BackgroundCancelParams = Type.Object({
+    taskId: Type.Optional(Type.String({ description: "Task ID to cancel (required if all=false)" })),
+    all: Type.Optional(Type.Boolean({ description: "Cancel all running background tasks (default: false)" })),
+});
+export const MAX_CONCURRENT_TASKS = Infinity;
+export const MAX_SUBAGENT_DEPTH = 1;
+export const DEPTH_ENV_VAR = "SANEPI_SUBAGENT_DEPTH";
+export const AGENT_TYPE_ENV_VAR = "SANEPI_AGENT_TYPE";
+export const TASK_ENTRY_TYPE = "background-task.state";
+export const DEFAULT_BLOCK_TIMEOUT = 60000;
+export const MAX_BLOCK_TIMEOUT = 300000;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/background-task/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAgD5C,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,6CAA6C,EAAE,CAAC;IACxF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC;IACzE,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC;QAC/B,WAAW,EACV,uGAAuG;KACxG,CAAC;IACF,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mCAAmC,EAAE,CAAC,CAAC;IAC5F,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAChF,UAAU,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,MAAM,CAAC;QACX,WAAW,EACV,0GAA0G;KAC3G,CAAC,CACF;CACD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IACnE,KAAK,EAAE,IAAI,CAAC,QAAQ,CACnB,IAAI,CAAC,OAAO,CAAC;QACZ,WAAW,EAAE,gGAAgG;KAC7G,CAAC,CACF;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mDAAmD,EAAE,CAAC,CAAC;CACzG,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAAC;IAChG,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC,CAAC;CACzG,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC","sourcesContent":["import { type Static, Type } from \"typebox\";\n\nexport type SpawnOptions = {\n\tprompt: string;\n\tcwd: string;\n\tmodel?: string;\n\tagentType?: string;\n\tsessionPath?: string;\n\tpermissionFlag?: string;\n\tsignal?: AbortSignal;\n\tenv?: Record<string, string>;\n\tonEvent?: (event: SpawnEvent) => void;\n};\n\nexport type SpawnEvent =\n\t| {\n\t\t\ttype: \"tool_execution_start\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t  }\n\t| {\n\t\t\ttype: \"tool_execution_end\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t  };\n\nexport type SpawnedAgent = {\n\tprocess: import(\"node:child_process\").ChildProcess;\n\tresult: Promise<{ text: string; exitCode: number }>;\n};\n\nexport type BackgroundTask = {\n\tid: string;\n\tdescription: string;\n\tprompt: string;\n\tmodel: string | undefined;\n\tagentType: string | undefined;\n\tstatus: \"pending\" | \"running\" | \"completed\" | \"error\" | \"cancelled\";\n\tpid: number | undefined;\n\tsessionPath: string | undefined;\n\tactiveToolNames: string[];\n\tstartedAt: Date;\n\tcompletedAt: Date | undefined;\n\tresult: string | undefined;\n\terror: string | undefined;\n\tparentSessionId: string;\n};\n\nexport const TaskToolParams = Type.Object({\n\tdescription: Type.String({ description: \"A short (3-5 words) description of the task\" }),\n\tprompt: Type.String({ description: \"The task for the agent to perform\" }),\n\trun_in_background: Type.Boolean({\n\t\tdescription:\n\t\t\t\"REQUIRED. true=async (returns task_id, system notifies on completion), false=sync (waits for result).\",\n\t}),\n\tsession_id: Type.Optional(Type.String({ description: \"Existing Task session to continue\" })),\n\tmodel: Type.Optional(Type.String({ description: \"Model to use for this task\" })),\n\tagent_type: Type.Optional(\n\t\tType.String({\n\t\t\tdescription:\n\t\t\t\t\"Agent type to use for this task (e.g. 'explore', 'general'). Determines available tools and permissions.\",\n\t\t}),\n\t),\n});\n\nexport type TaskToolParamsType = Static<typeof TaskToolParams>;\n\nexport const 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\nexport type BackgroundOutputParamsType = Static<typeof BackgroundOutputParams>;\n\nexport const BackgroundCancelParams = Type.Object({\n\ttaskId: Type.Optional(Type.String({ description: \"Task ID to cancel (required if all=false)\" })),\n\tall: Type.Optional(Type.Boolean({ description: \"Cancel all running background tasks (default: false)\" })),\n});\n\nexport type BackgroundCancelParamsType = Static<typeof BackgroundCancelParams>;\n\nexport const MAX_CONCURRENT_TASKS = Infinity;\nexport const MAX_SUBAGENT_DEPTH = 1;\nexport const DEPTH_ENV_VAR = \"SANEPI_SUBAGENT_DEPTH\";\nexport const AGENT_TYPE_ENV_VAR = \"SANEPI_AGENT_TYPE\";\nexport const TASK_ENTRY_TYPE = \"background-task.state\";\nexport const DEFAULT_BLOCK_TIMEOUT = 60000;\nexport const MAX_BLOCK_TIMEOUT = 300000;\n"]}

package/dist/core/extensions/builtin/bash-timeout/index.d.ts

@@ -0,0 +1,5 @@
+import type { ExtensionAPI } from "../../types.js";
+export type { BashTimeoutDefaults, BashToolInputLike } from "./timeout.js";
+export { applyBashTimeout, BASH_DEFAULT_TIMEOUT_SECONDS, BASH_MAX_TIMEOUT_SECONDS, buildBashTimeoutPrompt, resolveBashTimeoutDefaults, } from "./timeout.js";
+export default function bashTimeoutExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/extensions/builtin/bash-timeout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/bash-timeout/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AASnD,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACN,gBAAgB,EAChB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,GAC1B,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAiBnE","sourcesContent":["import type { ExtensionAPI } from \"../../types.js\";\n\nimport {\n\tapplyBashTimeout,\n\ttype BashToolInputLike,\n\tbuildBashTimeoutPrompt,\n\tresolveBashTimeoutDefaults,\n} from \"./timeout.js\";\n\nexport type { BashTimeoutDefaults, BashToolInputLike } from \"./timeout.js\";\nexport {\n\tapplyBashTimeout,\n\tBASH_DEFAULT_TIMEOUT_SECONDS,\n\tBASH_MAX_TIMEOUT_SECONDS,\n\tbuildBashTimeoutPrompt,\n\tresolveBashTimeoutDefaults,\n} from \"./timeout.js\";\n\nexport default function bashTimeoutExtension(pi: ExtensionAPI): void {\n\tconst env = typeof process !== \"undefined\" ? process.env : {};\n\tconst defaults = resolveBashTimeoutDefaults(env);\n\tconst promptSection = buildBashTimeoutPrompt(defaults);\n\n\tpi.on(\"tool_call\", async (event) => {\n\t\tif (event.toolName !== \"bash\") return;\n\t\tconst input = event.input as BashToolInputLike;\n\t\tconst updated = applyBashTimeout(input, defaults);\n\t\tif (updated !== input) {\n\t\t\tinput.timeout = updated.timeout;\n\t\t}\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => ({\n\t\tsystemPrompt: `${event.systemPrompt}${promptSection}`,\n\t}));\n}\n"]}

package/dist/core/extensions/builtin/bash-timeout/index.js

@@ -0,0 +1,20 @@
+import { applyBashTimeout, buildBashTimeoutPrompt, resolveBashTimeoutDefaults, } from "./timeout.js";
+export { applyBashTimeout, BASH_DEFAULT_TIMEOUT_SECONDS, BASH_MAX_TIMEOUT_SECONDS, buildBashTimeoutPrompt, resolveBashTimeoutDefaults, } from "./timeout.js";
+export default function bashTimeoutExtension(pi) {
+    const env = typeof process !== "undefined" ? process.env : {};
+    const defaults = resolveBashTimeoutDefaults(env);
+    const promptSection = buildBashTimeoutPrompt(defaults);
+    pi.on("tool_call", async (event) => {
+        if (event.toolName !== "bash")
+            return;
+        const input = event.input;
+        const updated = applyBashTimeout(input, defaults);
+        if (updated !== input) {
+            input.timeout = updated.timeout;
+        }
+    });
+    pi.on("before_agent_start", async (event) => ({
+        systemPrompt: `${event.systemPrompt}${promptSection}`,
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/core/extensions/builtin/bash-timeout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/bash-timeout/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,EAEhB,sBAAsB,EACtB,0BAA0B,GAC1B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACN,gBAAgB,EAChB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,GAC1B,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,EAAgB,EAAQ;IACpE,MAAM,GAAG,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,QAAQ,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,aAAa,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAEvD,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO;QACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAA0B,CAAC;QAC/C,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YACvB,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,CAAC;IAAA,CACD,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,YAAY,EAAE,GAAG,KAAK,CAAC,YAAY,GAAG,aAAa,EAAE;KACrD,CAAC,CAAC,CAAC;AAAA,CACJ","sourcesContent":["import type { ExtensionAPI } from \"../../types.js\";\n\nimport {\n\tapplyBashTimeout,\n\ttype BashToolInputLike,\n\tbuildBashTimeoutPrompt,\n\tresolveBashTimeoutDefaults,\n} from \"./timeout.js\";\n\nexport type { BashTimeoutDefaults, BashToolInputLike } from \"./timeout.js\";\nexport {\n\tapplyBashTimeout,\n\tBASH_DEFAULT_TIMEOUT_SECONDS,\n\tBASH_MAX_TIMEOUT_SECONDS,\n\tbuildBashTimeoutPrompt,\n\tresolveBashTimeoutDefaults,\n} from \"./timeout.js\";\n\nexport default function bashTimeoutExtension(pi: ExtensionAPI): void {\n\tconst env = typeof process !== \"undefined\" ? process.env : {};\n\tconst defaults = resolveBashTimeoutDefaults(env);\n\tconst promptSection = buildBashTimeoutPrompt(defaults);\n\n\tpi.on(\"tool_call\", async (event) => {\n\t\tif (event.toolName !== \"bash\") return;\n\t\tconst input = event.input as BashToolInputLike;\n\t\tconst updated = applyBashTimeout(input, defaults);\n\t\tif (updated !== input) {\n\t\t\tinput.timeout = updated.timeout;\n\t\t}\n\t});\n\n\tpi.on(\"before_agent_start\", async (event) => ({\n\t\tsystemPrompt: `${event.systemPrompt}${promptSection}`,\n\t}));\n}\n"]}

package/dist/core/extensions/builtin/bash-timeout/timeout.d.ts

@@ -0,0 +1,17 @@
+export declare const BASH_DEFAULT_TIMEOUT_SECONDS = 120;
+export declare const BASH_MAX_TIMEOUT_SECONDS = 600;
+export interface BashTimeoutDefaults {
+    defaultSeconds: number;
+    maxSeconds: number;
+}
+type EnvLike = Record<string, string | undefined>;
+export declare function resolveBashTimeoutDefaults(env: EnvLike): BashTimeoutDefaults;
+export interface BashToolInputLike {
+    command: string;
+    timeout?: number;
+    [key: string]: unknown;
+}
+export declare function applyBashTimeout<TInput extends BashToolInputLike>(input: TInput, defaults: BashTimeoutDefaults): TInput;
+export declare function buildBashTimeoutPrompt(defaults: BashTimeoutDefaults): string;
+export {};
+//# sourceMappingURL=timeout.d.ts.map

package/dist/core/extensions/builtin/bash-timeout/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/bash-timeout/timeout.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,MAAM,WAAW,mBAAmB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AASlD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAK5E;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,iBAAiB,EAChE,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,mBAAmB,GAC3B,MAAM,CAMR;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAG5E","sourcesContent":["export const BASH_DEFAULT_TIMEOUT_SECONDS = 120;\nexport const BASH_MAX_TIMEOUT_SECONDS = 600;\n\nexport interface BashTimeoutDefaults {\n\tdefaultSeconds: number;\n\tmaxSeconds: number;\n}\n\ntype EnvLike = Record<string, string | undefined>;\n\nfunction parsePositiveInt(value: string | undefined): number | undefined {\n\tif (!value) return undefined;\n\tconst parsed = Number.parseInt(value, 10);\n\tif (!Number.isFinite(parsed) || parsed <= 0) return undefined;\n\treturn parsed;\n}\n\nexport function resolveBashTimeoutDefaults(env: EnvLike): BashTimeoutDefaults {\n\tconst defaultSeconds = parsePositiveInt(env.PI_BASH_DEFAULT_TIMEOUT_SECONDS) ?? BASH_DEFAULT_TIMEOUT_SECONDS;\n\tconst rawMax = parsePositiveInt(env.PI_BASH_MAX_TIMEOUT_SECONDS) ?? BASH_MAX_TIMEOUT_SECONDS;\n\tconst maxSeconds = Math.max(rawMax, defaultSeconds);\n\treturn { defaultSeconds, maxSeconds };\n}\n\nexport interface BashToolInputLike {\n\tcommand: string;\n\ttimeout?: number;\n\t[key: string]: unknown;\n}\n\nexport function applyBashTimeout<TInput extends BashToolInputLike>(\n\tinput: TInput,\n\tdefaults: BashTimeoutDefaults,\n): TInput {\n\tconst current = input.timeout;\n\tif (current === undefined || current <= 0) {\n\t\treturn { ...input, timeout: defaults.defaultSeconds };\n\t}\n\treturn input;\n}\n\nexport function buildBashTimeoutPrompt(defaults: BashTimeoutDefaults): string {\n\tconst minutes = (seconds: number): string => (seconds % 60 === 0 ? `${seconds / 60} min` : `${seconds}s`);\n\treturn `\\n## Bash Tool Timeout Policy\\n\\nThe \\`bash\\` tool enforces timeouts even when you omit the \\`timeout\\` parameter:\\n\\n- Default timeout: ${defaults.defaultSeconds}s (${minutes(defaults.defaultSeconds)}). Applied automatically when you do not set \\`timeout\\`.\\n- Recommended maximum timeout: ${defaults.maxSeconds}s (${minutes(defaults.maxSeconds)}). Explicit \\`timeout\\` values are preserved because different hosts may use different timeout units.\\n- For long-running commands (builds, installs, test suites), set an explicit \\`timeout\\` that fits the workload. Do not assume commands run forever.\\n- For commands that legitimately need to run beyond the recommended maximum, run them in the background via tmux or a similar mechanism instead of relying on bash timeout.\\n`;\n}\n"]}

package/dist/core/extensions/builtin/bash-timeout/timeout.js

@@ -0,0 +1,28 @@
+export const BASH_DEFAULT_TIMEOUT_SECONDS = 120;
+export const BASH_MAX_TIMEOUT_SECONDS = 600;
+function parsePositiveInt(value) {
+    if (!value)
+        return undefined;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return undefined;
+    return parsed;
+}
+export function resolveBashTimeoutDefaults(env) {
+    const defaultSeconds = parsePositiveInt(env.PI_BASH_DEFAULT_TIMEOUT_SECONDS) ?? BASH_DEFAULT_TIMEOUT_SECONDS;
+    const rawMax = parsePositiveInt(env.PI_BASH_MAX_TIMEOUT_SECONDS) ?? BASH_MAX_TIMEOUT_SECONDS;
+    const maxSeconds = Math.max(rawMax, defaultSeconds);
+    return { defaultSeconds, maxSeconds };
+}
+export function applyBashTimeout(input, defaults) {
+    const current = input.timeout;
+    if (current === undefined || current <= 0) {
+        return { ...input, timeout: defaults.defaultSeconds };
+    }
+    return input;
+}
+export function buildBashTimeoutPrompt(defaults) {
+    const minutes = (seconds) => (seconds % 60 === 0 ? `${seconds / 60} min` : `${seconds}s`);
+    return `\n## Bash Tool Timeout Policy\n\nThe \`bash\` tool enforces timeouts even when you omit the \`timeout\` parameter:\n\n- Default timeout: ${defaults.defaultSeconds}s (${minutes(defaults.defaultSeconds)}). Applied automatically when you do not set \`timeout\`.\n- Recommended maximum timeout: ${defaults.maxSeconds}s (${minutes(defaults.maxSeconds)}). Explicit \`timeout\` values are preserved because different hosts may use different timeout units.\n- For long-running commands (builds, installs, test suites), set an explicit \`timeout\` that fits the workload. Do not assume commands run forever.\n- For commands that legitimately need to run beyond the recommended maximum, run them in the background via tmux or a similar mechanism instead of relying on bash timeout.\n`;
+}
+//# sourceMappingURL=timeout.js.map

package/dist/core/extensions/builtin/bash-timeout/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../../../../src/core/extensions/builtin/bash-timeout/timeout.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAS5C,SAAS,gBAAgB,CAAC,KAAyB,EAAsB;IACxE,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9D,OAAO,MAAM,CAAC;AAAA,CACd;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAY,EAAuB;IAC7E,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAG,CAAC,+BAA+B,CAAC,IAAI,4BAA4B,CAAC;IAC7G,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,2BAA2B,CAAC,IAAI,wBAAwB,CAAC;IAC7F,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AAAA,CACtC;AAQD,MAAM,UAAU,gBAAgB,CAC/B,KAAa,EACb,QAA6B,EACpB;IACT,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AAAA,CACb;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA6B,EAAU;IAC7E,MAAM,OAAO,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,CAAC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;IAC1G,OAAO,4IAA4I,QAAQ,CAAC,cAAc,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,6FAA6F,QAAQ,CAAC,UAAU,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,4aAA4a,CAAC;AAAA,CAC/wB","sourcesContent":["export const BASH_DEFAULT_TIMEOUT_SECONDS = 120;\nexport const BASH_MAX_TIMEOUT_SECONDS = 600;\n\nexport interface BashTimeoutDefaults {\n\tdefaultSeconds: number;\n\tmaxSeconds: number;\n}\n\ntype EnvLike = Record<string, string | undefined>;\n\nfunction parsePositiveInt(value: string | undefined): number | undefined {\n\tif (!value) return undefined;\n\tconst parsed = Number.parseInt(value, 10);\n\tif (!Number.isFinite(parsed) || parsed <= 0) return undefined;\n\treturn parsed;\n}\n\nexport function resolveBashTimeoutDefaults(env: EnvLike): BashTimeoutDefaults {\n\tconst defaultSeconds = parsePositiveInt(env.PI_BASH_DEFAULT_TIMEOUT_SECONDS) ?? BASH_DEFAULT_TIMEOUT_SECONDS;\n\tconst rawMax = parsePositiveInt(env.PI_BASH_MAX_TIMEOUT_SECONDS) ?? BASH_MAX_TIMEOUT_SECONDS;\n\tconst maxSeconds = Math.max(rawMax, defaultSeconds);\n\treturn { defaultSeconds, maxSeconds };\n}\n\nexport interface BashToolInputLike {\n\tcommand: string;\n\ttimeout?: number;\n\t[key: string]: unknown;\n}\n\nexport function applyBashTimeout<TInput extends BashToolInputLike>(\n\tinput: TInput,\n\tdefaults: BashTimeoutDefaults,\n): TInput {\n\tconst current = input.timeout;\n\tif (current === undefined || current <= 0) {\n\t\treturn { ...input, timeout: defaults.defaultSeconds };\n\t}\n\treturn input;\n}\n\nexport function buildBashTimeoutPrompt(defaults: BashTimeoutDefaults): string {\n\tconst minutes = (seconds: number): string => (seconds % 60 === 0 ? `${seconds / 60} min` : `${seconds}s`);\n\treturn `\\n## Bash Tool Timeout Policy\\n\\nThe \\`bash\\` tool enforces timeouts even when you omit the \\`timeout\\` parameter:\\n\\n- Default timeout: ${defaults.defaultSeconds}s (${minutes(defaults.defaultSeconds)}). Applied automatically when you do not set \\`timeout\\`.\\n- Recommended maximum timeout: ${defaults.maxSeconds}s (${minutes(defaults.maxSeconds)}). Explicit \\`timeout\\` values are preserved because different hosts may use different timeout units.\\n- For long-running commands (builds, installs, test suites), set an explicit \\`timeout\\` that fits the workload. Do not assume commands run forever.\\n- For commands that legitimately need to run beyond the recommended maximum, run them in the background via tmux or a similar mechanism instead of relying on bash timeout.\\n`;\n}\n"]}