wave-agent-sdk 0.4.0 → 0.6.1

package/dist/tools/taskOutputTool.js

@@ -0,0 +1,173 @@
+import { TASK_OUTPUT_TOOL_NAME } from "../constants/tools.js";
+import { stripAnsiColors } from "../utils/stringUtils.js";
+const MAX_OUTPUT_LENGTH = 30000;
+export const taskOutputTool = {
+    name: TASK_OUTPUT_TOOL_NAME,
+    config: {
+        type: "function",
+        function: {
+            name: TASK_OUTPUT_TOOL_NAME,
+            description: "Retrieves output from a running or completed task",
+            parameters: {
+                type: "object",
+                properties: {
+                    task_id: {
+                        type: "string",
+                        description: "The task ID to get output from",
+                    },
+                    block: {
+                        type: "boolean",
+                        default: true,
+                        description: "Whether to wait for completion",
+                    },
+                    timeout: {
+                        type: "number",
+                        minimum: 0,
+                        maximum: 600000,
+                        default: 30000,
+                        description: "Max wait time in ms",
+                    },
+                },
+                required: ["task_id"],
+            },
+        },
+    },
+    prompt: () => `- Retrieves output from a running or completed task (background shell, agent, or remote session)
+- Takes a task_id parameter identifying the task
+- Returns the task output along with status information
+- Use block=true (default) to wait for task completion
+- Use block=false for non-blocking check of current status
+- Task IDs can be found using the /tasks command
+- Works with all task types: background shells, async agents, and remote sessions`,
+    execute: async (args, context) => {
+        const taskId = args.task_id;
+        const filter = args.filter;
+        const block = args.block ?? true;
+        const timeout = args.timeout ?? 30000;
+        if (!taskId || typeof taskId !== "string") {
+            return {
+                success: false,
+                content: "",
+                error: "task_id parameter is required and must be a string",
+            };
+        }
+        const backgroundTaskManager = context?.backgroundTaskManager;
+        if (!backgroundTaskManager) {
+            return {
+                success: false,
+                content: "",
+                error: "Background task manager not available",
+            };
+        }
+        const getResult = () => {
+            const output = backgroundTaskManager.getOutput(taskId, filter);
+            if (!output)
+                return null;
+            let content = "";
+            if (output.stdout) {
+                content += stripAnsiColors(output.stdout);
+            }
+            if (output.stderr) {
+                content += (content ? "\n" : "") + stripAnsiColors(output.stderr);
+            }
+            const finalContent = content || "No output available";
+            const processedContent = finalContent.length > MAX_OUTPUT_LENGTH
+                ? finalContent.substring(0, MAX_OUTPUT_LENGTH) +
+                    "\n\n... (output truncated)"
+                : finalContent;
+            return {
+                success: true,
+                content: processedContent,
+                shortResult: `${taskId}: ${output.status}`,
+            };
+        };
+        if (block) {
+            // Polling for completion
+            return new Promise((resolve) => {
+                let timeoutHandle = null;
+                let isAborted = false;
+                const startTime = Date.now();
+                const cleanup = () => {
+                    if (timeoutHandle) {
+                        clearTimeout(timeoutHandle);
+                        timeoutHandle = null;
+                    }
+                };
+                const onAbort = () => {
+                    isAborted = true;
+                    cleanup();
+                    resolve({
+                        success: false,
+                        content: "",
+                        error: "Task output retrieval was aborted",
+                    });
+                };
+                if (context.abortSignal) {
+                    if (context.abortSignal.aborted) {
+                        onAbort();
+                        return;
+                    }
+                    context.abortSignal.addEventListener("abort", onAbort, {
+                        once: true,
+                    });
+                }
+                const check = () => {
+                    if (isAborted)
+                        return;
+                    if (Date.now() - startTime > timeout) {
+                        if (context.abortSignal) {
+                            context.abortSignal.removeEventListener("abort", onAbort);
+                        }
+                        resolve({
+                            success: true,
+                            content: "Retrieval timed out",
+                            shortResult: `${taskId}: timeout`,
+                        });
+                        return;
+                    }
+                    const task = backgroundTaskManager.getTask(taskId);
+                    if (!task) {
+                        if (context.abortSignal) {
+                            context.abortSignal.removeEventListener("abort", onAbort);
+                        }
+                        resolve({
+                            success: false,
+                            content: "",
+                            error: `Task with ID ${taskId} not found`,
+                        });
+                        return;
+                    }
+                    if (task.status !== "running") {
+                        if (context.abortSignal) {
+                            context.abortSignal.removeEventListener("abort", onAbort);
+                        }
+                        const result = getResult();
+                        resolve(result || {
+                            success: false,
+                            content: "",
+                            error: "Task not found",
+                        });
+                    }
+                    else {
+                        timeoutHandle = setTimeout(check, 500);
+                    }
+                };
+                check();
+            });
+        }
+        const result = getResult();
+        if (!result) {
+            return {
+                success: false,
+                content: "",
+                error: `Task with ID ${taskId} not found`,
+            };
+        }
+        return result;
+    },
+    formatCompactParams: (params) => {
+        const taskId = params.task_id;
+        const block = params.block;
+        return `${taskId}${block ? " (blocking)" : ""}`;
+    },
+};

package/dist/tools/taskStopTool.d.ts

@@ -0,0 +1,3 @@
+import { ToolPlugin } from "./types.js";
+export declare const taskStopTool: ToolPlugin;
+//# sourceMappingURL=taskStopTool.d.ts.map

package/dist/tools/taskStopTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskStopTool.d.ts","sourceRoot":"","sources":["../../src/tools/taskStopTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,UAAU,EAAc,MAAM,YAAY,CAAC;AAEjE,eAAO,MAAM,YAAY,EAAE,UA0E1B,CAAC"}

package/dist/tools/taskStopTool.js

@@ -0,0 +1,71 @@
+import { TASK_STOP_TOOL_NAME } from "../constants/tools.js";
+export const taskStopTool = {
+    name: TASK_STOP_TOOL_NAME,
+    config: {
+        type: "function",
+        function: {
+            name: TASK_STOP_TOOL_NAME,
+            description: "Stop a running background task by ID",
+            parameters: {
+                type: "object",
+                properties: {
+                    task_id: {
+                        type: "string",
+                        description: "The ID of the background task to stop",
+                    },
+                },
+                required: ["task_id"],
+            },
+        },
+    },
+    prompt: () => `
+- Stops a running background task by its ID
+- Takes a task_id parameter identifying the task to stop
+- Returns a success or failure status
+- Use this tool when you need to terminate a long-running task
+`,
+    execute: async (args, context) => {
+        const taskId = args.task_id;
+        if (!taskId || typeof taskId !== "string") {
+            return {
+                success: false,
+                content: "",
+                error: "task_id parameter is required and must be a string",
+            };
+        }
+        const backgroundTaskManager = context?.backgroundTaskManager;
+        if (!backgroundTaskManager) {
+            return {
+                success: false,
+                content: "",
+                error: "Background task manager not available",
+            };
+        }
+        const stopped = backgroundTaskManager.stopTask(taskId);
+        if (stopped) {
+            return {
+                success: true,
+                content: `Task ${taskId} has been stopped`,
+                shortResult: `Stopped ${taskId}`,
+            };
+        }
+        else {
+            const task = backgroundTaskManager.getTask(taskId);
+            if (!task) {
+                return {
+                    success: false,
+                    content: "",
+                    error: `Task with ID ${taskId} not found`,
+                };
+            }
+            return {
+                success: false,
+                content: "",
+                error: `Failed to stop task ${taskId} (status: ${task.status})`,
+            };
+        }
+    },
+    formatCompactParams: (params) => {
+        return params.task_id;
+    },
+};

package/dist/tools/taskTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskTool.d.ts","sourceRoot":"","sources":["../../src/tools/taskTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,eAAe,GAAG,UAAU,CAqI3E"}
+{"version":3,"file":"taskTool.d.ts","sourceRoot":"","sources":["../../src/tools/taskTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,eAAe,GAAG,UAAU,CAmM3E"}

package/dist/tools/taskTool.js

@@ -38,76 +38,123 @@ export function createTaskTool(subagentManager) {
                                 type: "string",
                                 description: `The type or name of subagent to use. Available options: ${availableSubagents.map((c) => c.name).join(", ") || "none"}`,
                             },
+                            run_in_background: {
+                                type: "boolean",
+                                description: "Set to true to run this command in the background. Use TaskOutput to read the output later.",
+                            },
                         },
                         required: ["description", "prompt", "subagent_type"],
                     },
                 },
             };
         },
+        prompt: () => `
+- When doing file search, prefer to use the ${TASK_TOOL_NAME} tool in order to reduce context usage.
+- You should proactively use the ${TASK_TOOL_NAME} tool with specialized agents when the task at hand matches the agent's description.
+- VERY IMPORTANT: When exploring the codebase to gather context or to answer a question that is not a needle query for a specific file/class/function, it is CRITICAL that you use the ${TASK_TOOL_NAME} tool with subagent_type=Explore instead of running search commands directly.`,
         execute: async (args, context) => {
-            // Input validation
-            const description = args.description;
-            const prompt = args.prompt;
-            const subagent_type = args.subagent_type;
-            if (!description || typeof description !== "string") {
-                return {
-                    success: false,
-                    content: "",
-                    error: "description parameter is required and must be a string",
-                    shortResult: "Task delegation failed",
-                };
-            }
-            if (!prompt || typeof prompt !== "string") {
-                return {
-                    success: false,
-                    content: "",
-                    error: "prompt parameter is required and must be a string",
-                    shortResult: "Task delegation failed",
-                };
-            }
-            if (!subagent_type || typeof subagent_type !== "string") {
-                return {
-                    success: false,
-                    content: "",
-                    error: "subagent_type parameter is required and must be a string",
-                    shortResult: "Task delegation failed",
-                };
-            }
-            try {
-                // Subagent selection logic with explicit name matching only
-                const configuration = await subagentManager.findSubagent(subagent_type);
-                if (!configuration) {
-                    // Error handling for nonexistent subagents with available subagents listing
-                    const allConfigs = subagentManager.getConfigurations();
-                    const availableNames = allConfigs.map((c) => c.name).join(", ");
-                    return {
-                        success: false,
-                        content: "",
-                        error: `No subagent found matching "${subagent_type}". Available subagents: ${availableNames || "none"}`,
-                        shortResult: "Subagent not found",
-                    };
-                }
-                // Create subagent instance and execute task
-                const instance = await subagentManager.createInstance(configuration, {
-                    description,
-                    prompt,
-                    subagent_type,
-                });
-                const response = await subagentManager.executeTask(instance, prompt, context.abortSignal);
-                return {
-                    success: true,
-                    content: response,
-                    shortResult: `Task completed by ${configuration.name}`,
-                };
-            }
-            catch (error) {
-                return {
-                    success: false,
-                    content: "",
-                    error: `Task delegation failed: ${error instanceof Error ? error.message : String(error)}`,
-                    shortResult: "Delegation error",
-                };
-            }
+            return new Promise((resolve) => {
+                (async () => {
+                    // Input validation
+                    const description = args.description;
+                    const prompt = args.prompt;
+                    const subagent_type = args.subagent_type;
+                    const run_in_background = args.run_in_background;
+                    if (!description || typeof description !== "string") {
+                        return resolve({
+                            success: false,
+                            content: "",
+                            error: "description parameter is required and must be a string",
+                            shortResult: "Task delegation failed",
+                        });
+                    }
+                    if (!prompt || typeof prompt !== "string") {
+                        return resolve({
+                            success: false,
+                            content: "",
+                            error: "prompt parameter is required and must be a string",
+                            shortResult: "Task delegation failed",
+                        });
+                    }
+                    if (!subagent_type || typeof subagent_type !== "string") {
+                        return resolve({
+                            success: false,
+                            content: "",
+                            error: "subagent_type parameter is required and must be a string",
+                            shortResult: "Task delegation failed",
+                        });
+                    }
+                    try {
+                        // Subagent selection logic with explicit name matching only
+                        const configuration = await subagentManager.findSubagent(subagent_type);
+                        if (!configuration) {
+                            // Error handling for nonexistent subagents with available subagents listing
+                            const allConfigs = subagentManager.getConfigurations();
+                            const availableNames = allConfigs.map((c) => c.name).join(", ");
+                            return resolve({
+                                success: false,
+                                content: "",
+                                error: `No subagent found matching "${subagent_type}". Available subagents: ${availableNames || "none"}`,
+                                shortResult: "Subagent not found",
+                            });
+                        }
+                        // Create subagent instance and execute task
+                        const instance = await subagentManager.createInstance(configuration, {
+                            description,
+                            prompt,
+                            subagent_type,
+                        }, run_in_background);
+                        let isBackgrounded = false;
+                        // Register for backgrounding if not already in background
+                        if (!run_in_background && context.foregroundTaskManager) {
+                            context.foregroundTaskManager.registerForegroundTask({
+                                id: instance.subagentId,
+                                backgroundHandler: async () => {
+                                    isBackgrounded = true;
+                                    const taskId = await subagentManager.backgroundInstance(instance.subagentId);
+                                    // Resolve the tool execution early so the main agent can continue
+                                    resolve({
+                                        success: true,
+                                        content: `Task moved to background with ID: ${taskId}.`,
+                                        shortResult: "Task backgrounded",
+                                        isManuallyBackgrounded: true,
+                                    });
+                                },
+                            });
+                        }
+                        try {
+                            const result = await subagentManager.executeTask(instance, prompt, context.abortSignal, run_in_background);
+                            if (isBackgrounded)
+                                return;
+                            if (run_in_background) {
+                                return resolve({
+                                    success: true,
+                                    content: `Task started in background with ID: ${result}`,
+                                    shortResult: `Task started in background: ${result}`,
+                                });
+                            }
+                            return resolve({
+                                success: true,
+                                content: result,
+                                shortResult: `Task completed by ${configuration.name}`,
+                            });
+                        }
+                        finally {
+                            if (!run_in_background && context.foregroundTaskManager) {
+                                context.foregroundTaskManager.unregisterForegroundTask(instance.subagentId);
+                            }
+                        }
+                    }
+                    catch (error) {
+                        return resolve({
+                            success: false,
+                            content: "",
+                            error: `Task delegation failed: ${error instanceof Error ? error.message : String(error)}`,
+                            shortResult: "Delegation error",
+                        });
+                    }
+                })();
+            });
         },
         formatCompactParams: (params) => {
             const subagent_type = params.subagent_type;

package/dist/tools/types.d.ts

@@ -8,6 +8,10 @@ export interface ToolPlugin {
     config: ChatCompletionFunctionTool;
     execute: (args: Record<string, unknown>, context: ToolContext) => Promise<ToolResult>;
     formatCompactParams?: (params: Record<string, unknown>, context: ToolContext) => string;
+    /**
+     * Optional function to provide a prompt to be added to the system prompt
+     */
+    prompt?: () => string;
 }
 export interface ToolResult {
     success: boolean;
@@ -19,10 +23,12 @@ export interface ToolResult {
         data: string;
         mediaType?: string;
     }>;
+    isManuallyBackgrounded?: boolean;
 }
 export interface ToolContext {
     abortSignal?: AbortSignal;
     backgroundBashManager?: import("../managers/backgroundBashManager.js").BackgroundBashManager;
+    backgroundTaskManager?: import("../managers/backgroundTaskManager.js").BackgroundTaskManager;
     workdir: string;
     /** Permission mode for this tool execution */
     permissionMode?: PermissionMode;
@@ -38,5 +44,11 @@ export interface ToolContext {
     reversionManager?: import("../managers/reversionManager.js").ReversionManager;
     /** Current message ID for associating snapshots */
     messageId?: string;
+    /** Foreground task manager for backgrounding tasks */
+    foregroundTaskManager?: import("../types/processes.js").IForegroundTaskManager;
+    /** Task manager instance for task management */
+    taskManager: import("../services/taskManager.js").TaskManager;
+    /** Current session ID */
+    sessionId?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,WAAW,KACjB,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,sCAAsC,EAAE,qBAAqB,CAAC;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,OAAO,kCAAkC,EAAE,iBAAiB,CAAC;IACjF,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,2BAA2B,EAAE,UAAU,CAAC;IAC5D,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,iBAAiB,EAAE,WAAW,CAAC;IACnD,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,iCAAiC,EAAE,gBAAgB,CAAC;IAC9E,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,WAAW,KACjB,MAAM,CAAC;IACZ;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IAEH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,sCAAsC,EAAE,qBAAqB,CAAC;IAC7F,qBAAqB,CAAC,EAAE,OAAO,sCAAsC,EAAE,qBAAqB,CAAC;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,OAAO,kCAAkC,EAAE,iBAAiB,CAAC;IACjF,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,2BAA2B,EAAE,UAAU,CAAC;IAC5D,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,iBAAiB,EAAE,WAAW,CAAC;IACnD,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,OAAO,iCAAiC,EAAE,gBAAgB,CAAC;IAC9E,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,qBAAqB,CAAC,EAAE,OAAO,uBAAuB,EAAE,sBAAsB,CAAC;IAC/E,gDAAgD;IAChD,WAAW,EAAE,OAAO,4BAA4B,EAAE,WAAW,CAAC;IAC9D,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/tools/writeTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeTool.d.ts","sourceRoot":"","sources":["../../src/tools/writeTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAGtE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UA0LvB,CAAC"}
+{"version":3,"file":"writeTool.d.ts","sourceRoot":"","sources":["../../src/tools/writeTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAGtE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UAiMvB,CAAC"}

package/dist/tools/writeTool.js

@@ -11,7 +11,7 @@ export const writeTool = {
         type: "function",
         function: {
             name: "Write",
-            description: "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.\n- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.\n- IMPORTANT: Always provide file_path parameter before content parameter when calling this tool.",
+            description: "Writes a file to the local filesystem.",
             parameters: {
                 type: "object",
                 properties: {
@@ -29,6 +29,14 @@ export const writeTool = {
             },
         },
     },
+    prompt: () => `
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
+- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
+- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.
+- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.
+- IMPORTANT: Always provide file_path parameter before content parameter when calling this tool.`,
     execute: async (args, context) => {
         const filePath = args.file_path;
         const content = args.content;

package/dist/types/index.d.ts

@@ -29,4 +29,5 @@ export * from "./plugins.js";
 export * from "./marketplace.js";
 export * from "./memoryRule.js";
 export * from "./history.js";
+export * from "./tasks.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/types/index.js

@@ -31,3 +31,4 @@ export * from "./plugins.js";
 export * from "./marketplace.js";
 export * from "./memoryRule.js";
 export * from "./history.js";
+export * from "./tasks.js";

package/dist/types/marketplace.d.ts

@@ -39,6 +39,7 @@ export interface InstalledPlugin {
     version: string;
     cachePath: string;
     scope?: Scope;
+    projectPath?: string;
 }
 export interface InstalledPluginsRegistry {
     plugins: InstalledPlugin[];

package/dist/types/marketplace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/types/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/types/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACD;IACE,MAAM,EAAE,KAAK,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/dist/types/messaging.d.ts

@@ -15,7 +15,7 @@ export interface Message {
     usage?: Usage;
     additionalFields?: Record<string, unknown>;
 }
-export type MessageBlock = TextBlock | ErrorBlock | ToolBlock | ImageBlock | CommandOutputBlock | CompressBlock | MemoryBlock | SubagentBlock | ReasoningBlock | FileHistoryBlock;
+export type MessageBlock = TextBlock | ErrorBlock | ToolBlock | ImageBlock | CommandOutputBlock | CompressBlock | SubagentBlock | ReasoningBlock | FileHistoryBlock;
 export interface TextBlock {
     type: "text";
     content: string;
@@ -49,6 +49,7 @@ export interface ToolBlock {
     error?: string | Error;
     compactParams?: string;
     parametersChunk?: string;
+    isManuallyBackgrounded?: boolean;
 }
 export interface ImageBlock {
     type: "image";
@@ -66,13 +67,6 @@ export interface CompressBlock {
     content: string;
     sessionId: string;
 }
-export interface MemoryBlock {
-    type: "memory";
-    content: string;
-    isSuccess: boolean;
-    memoryType?: "project" | "user";
-    storagePath?: string;
-}
 export interface SubagentBlock {
     type: "subagent";
     subagentId: string;
@@ -80,6 +74,7 @@ export interface SubagentBlock {
     status: "active" | "completed" | "error" | "aborted";
     sessionId: string;
     configuration: SubagentConfiguration;
+    runInBackground?: boolean;
 }
 export interface ReasoningBlock {
     type: "reasoning";

package/dist/types/messaging.d.ts.map

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