patchwork-os 0.2.0-alpha.0

package/dist/tools/resumeClaudeTask.js

@@ -0,0 +1,149 @@
+import { ToolErrorCodes } from "../errors.js";
+import { error, successStructured } from "./utils.js";
+export function createResumeClaudeTaskTool(orchestrator, sessionId) {
+    return {
+        schema: {
+            name: "resumeClaudeTask",
+            description: "Re-run a failed, cancelled, or completed Claude task with same prompt. Returns new taskId.",
+            annotations: {
+                title: "Resume Claude Task",
+                readOnlyHint: false,
+                destructiveHint: false,
+                openWorldHint: true,
+            },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    taskId: {
+                        type: "string",
+                        description: "The ID of the task to resume (must be in done, error, or cancelled state).",
+                    },
+                    timeoutMs: {
+                        type: "integer",
+                        description: "Override the timeout for the resumed task (ms, 5000–600000). Defaults to the original task's timeoutMs.",
+                    },
+                    effort: {
+                        type: "string",
+                        enum: ["low", "medium", "high", "max"],
+                        description: "Override the effort level for the resumed task. Defaults to the original task's effort.",
+                    },
+                    fallbackModel: {
+                        type: "string",
+                        description: "Override the fallback model for the resumed task. Defaults to the original task's fallbackModel.",
+                    },
+                    maxBudgetUsd: {
+                        type: "number",
+                        description: "Override the spend cap in USD for the resumed task. Defaults to the original task's maxBudgetUsd.",
+                    },
+                    startupTimeoutMs: {
+                        type: "integer",
+                        description: "Override the startup timeout for the resumed task. Defaults to the original task's startupTimeoutMs.",
+                    },
+                },
+                required: ["taskId"],
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    newTaskId: { type: "string" },
+                    originalTaskId: { type: "string" },
+                    prompt: { type: "string" },
+                    status: { type: "string" },
+                },
+                required: ["newTaskId", "originalTaskId", "prompt", "status"],
+            },
+        },
+        handler: async (args) => {
+            const taskId = args.taskId;
+            if (typeof taskId !== "string" || taskId.trim() === "") {
+                return error("taskId must be a non-empty string", ToolErrorCodes.INVALID_ARGS);
+            }
+            // Resume auth is strict: only own session's tasks are visible.
+            const resolved = orchestrator.findTaskByPrefix(taskId, (t) => t.sessionId === sessionId);
+            if (resolved.ambiguous) {
+                return error(`Task ID prefix "${taskId}" is ambiguous — matches ${resolved.candidates?.length ?? 0} tasks: ${(resolved.candidates ?? []).map((c) => c.slice(0, 8)).join(", ")}. Provide a longer prefix.`, ToolErrorCodes.AMBIGUOUS_TASK_ID);
+            }
+            const original = resolved.task;
+            if (!original) {
+                return error(`Task "${taskId}" not found`, ToolErrorCodes.TASK_NOT_FOUND);
+            }
+            // Authorization: sessions may only resume their own tasks
+            if (original.sessionId !== sessionId) {
+                return error(`Task "${taskId}" not found`, ToolErrorCodes.TASK_NOT_FOUND);
+            }
+            if (original.status === "running" || original.status === "pending") {
+                return error(`Task "${taskId}" is still ${original.status} — cannot resume a task that has not yet reached a terminal state`, ToolErrorCodes.INVALID_ARGS);
+            }
+            // Validate optional overrides
+            const MIN_TIMEOUT_MS = 5_000;
+            const MAX_TIMEOUT_MS = 600_000;
+            let timeoutMs = original.timeoutMs;
+            if (args.timeoutMs !== undefined) {
+                const t = args.timeoutMs;
+                if (typeof t !== "number" ||
+                    !Number.isInteger(t) ||
+                    t < MIN_TIMEOUT_MS ||
+                    t > MAX_TIMEOUT_MS) {
+                    return error(`timeoutMs must be an integer between ${MIN_TIMEOUT_MS} and ${MAX_TIMEOUT_MS}`, ToolErrorCodes.INVALID_ARGS);
+                }
+                timeoutMs = t;
+            }
+            const VALID_EFFORT = ["low", "medium", "high", "max"];
+            let effort = original.effort;
+            if (args.effort !== undefined) {
+                if (typeof args.effort !== "string" ||
+                    !VALID_EFFORT.includes(args.effort)) {
+                    return error(`effort must be one of: ${VALID_EFFORT.join(", ")}`, ToolErrorCodes.INVALID_ARGS);
+                }
+                effort = args.effort;
+            }
+            const fallbackModel = args.fallbackModel !== undefined
+                ? typeof args.fallbackModel === "string" &&
+                    args.fallbackModel.trim() !== ""
+                    ? args.fallbackModel.trim()
+                    : original.fallbackModel
+                : original.fallbackModel;
+            let maxBudgetUsd = original.maxBudgetUsd;
+            if (args.maxBudgetUsd !== undefined) {
+                if (typeof args.maxBudgetUsd !== "number" || args.maxBudgetUsd <= 0) {
+                    return error("maxBudgetUsd must be a positive number", ToolErrorCodes.INVALID_ARGS);
+                }
+                maxBudgetUsd = args.maxBudgetUsd;
+            }
+            let startupTimeoutMs = original.startupTimeoutMs;
+            if (args.startupTimeoutMs !== undefined) {
+                const s = args.startupTimeoutMs;
+                if (typeof s !== "number" ||
+                    !Number.isInteger(s) ||
+                    s < MIN_TIMEOUT_MS ||
+                    s > MAX_TIMEOUT_MS) {
+                    return error(`startupTimeoutMs must be an integer between ${MIN_TIMEOUT_MS} and ${MAX_TIMEOUT_MS}`, ToolErrorCodes.INVALID_ARGS);
+                }
+                startupTimeoutMs = s;
+            }
+            try {
+                const newTaskId = orchestrator.enqueue({
+                    prompt: original.prompt,
+                    contextFiles: original.contextFiles,
+                    timeoutMs,
+                    sessionId,
+                    model: original.model,
+                    effort,
+                    fallbackModel,
+                    maxBudgetUsd,
+                    startupTimeoutMs,
+                });
+                return successStructured({
+                    newTaskId,
+                    originalTaskId: taskId,
+                    prompt: original.prompt,
+                    status: "pending",
+                });
+            }
+            catch (e) {
+                return error(`Failed to enqueue resumed task: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=resumeClaudeTask.js.map

package/dist/tools/resumeClaudeTask.js.map

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

package/dist/tools/runClaudeTask.d.ts

@@ -0,0 +1,97 @@
+import type { ClaudeOrchestrator } from "../claudeOrchestrator.js";
+import type { ProgressFn } from "../transport.js";
+export declare function createRunClaudeTaskTool(orchestrator: ClaudeOrchestrator, sessionId: string, workspace: string): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            title: string;
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            type: string;
+            properties: {
+                prompt: {
+                    type: string;
+                    description: string;
+                };
+                contextFiles: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                timeoutMs: {
+                    type: string;
+                    description: string;
+                };
+                stream: {
+                    type: string;
+                    description: string;
+                };
+                model: {
+                    type: string;
+                    description: string;
+                };
+                effort: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                fallbackModel: {
+                    type: string;
+                    description: string;
+                };
+                maxBudgetUsd: {
+                    type: string;
+                    description: string;
+                };
+                startupTimeoutMs: {
+                    type: string;
+                    description: string;
+                };
+                systemPrompt: {
+                    type: string;
+                    maxLength: number;
+                    description: string;
+                };
+                useAnt: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                taskId: {
+                    type: string;
+                };
+                status: {
+                    type: string;
+                };
+                output: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    handler: (args: Record<string, unknown>, _signal?: AbortSignal, progressFn?: ProgressFn) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        structuredContent: unknown;
+    } | {
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+        isError: true;
+    }>;
+};

package/dist/tools/runClaudeTask.js

@@ -0,0 +1,224 @@
+import { ToolErrorCodes } from "../errors.js";
+import { error, resolveFilePath, successStructured } from "./utils.js";
+const MAX_CONTEXT_FILES = 20;
+const MIN_TIMEOUT_MS = 5_000;
+const MAX_TIMEOUT_MS = 600_000;
+/** 32 KB prompt cap — prevents ARG_MAX exhaustion and queue memory abuse */
+const MAX_PROMPT_BYTES = 32 * 1024;
+/** 4 KB system prompt cap — matches automationSystemPrompt validation in loadPolicy() */
+const MAX_SYSTEM_PROMPT_CHARS = 4096;
+export function createRunClaudeTaskTool(orchestrator, sessionId, workspace) {
+    return {
+        schema: {
+            name: "runClaudeTask",
+            description: "Enqueue Claude subprocess task. Returns taskId for getClaudeTaskStatus, or stream=true to block.",
+            annotations: {
+                title: "Run Claude Task",
+                readOnlyHint: false,
+                destructiveHint: false,
+                openWorldHint: true,
+            },
+            inputSchema: {
+                type: "object",
+                properties: {
+                    prompt: {
+                        type: "string",
+                        description: "Prompt to send to Claude",
+                    },
+                    contextFiles: {
+                        type: "array",
+                        items: { type: "string" },
+                        description: `Workspace-relative or absolute paths to add as context (max ${MAX_CONTEXT_FILES}).`,
+                    },
+                    timeoutMs: {
+                        type: "integer",
+                        description: `Task timeout in ms (${MIN_TIMEOUT_MS}–${MAX_TIMEOUT_MS}). Default: 120000.`,
+                    },
+                    stream: {
+                        type: "boolean",
+                        description: "Block + stream via progress. Default: false (return taskId).",
+                    },
+                    model: {
+                        type: "string",
+                        description: 'Model override, e.g. "claude-haiku-4-5-20251001".',
+                    },
+                    effort: {
+                        type: "string",
+                        enum: ["low", "medium", "high", "max"],
+                        description: "Thinking budget: low/medium/high/max.",
+                    },
+                    fallbackModel: {
+                        type: "string",
+                        description: "Fallback model if primary overloaded/unavailable.",
+                    },
+                    maxBudgetUsd: {
+                        type: "number",
+                        description: "Spend cap in USD. Omit for no cap.",
+                    },
+                    startupTimeoutMs: {
+                        type: "integer",
+                        description: "Abort if no output within this ms of spawn.",
+                    },
+                    systemPrompt: {
+                        type: "string",
+                        maxLength: MAX_SYSTEM_PROMPT_CHARS,
+                        description: `System prompt override. Max ${MAX_SYSTEM_PROMPT_CHARS} chars.`,
+                    },
+                    useAnt: {
+                        type: "boolean",
+                        description: "Run this task with the ant binary instead of claude. Requires ant on PATH or --ant-binary configured.",
+                    },
+                },
+                required: ["prompt"],
+            },
+            outputSchema: {
+                type: "object",
+                properties: {
+                    taskId: { type: "string" },
+                    status: { type: "string" },
+                    output: { type: "string" },
+                },
+                required: ["taskId", "status"],
+            },
+        },
+        handler: async (args, _signal, progressFn) => {
+            const prompt = args.prompt;
+            if (typeof prompt !== "string" || prompt.trim() === "") {
+                return error("prompt must be a non-empty string", ToolErrorCodes.INVALID_ARGS);
+            }
+            if (Buffer.byteLength(prompt, "utf-8") > MAX_PROMPT_BYTES) {
+                return error(`prompt exceeds maximum size of ${MAX_PROMPT_BYTES / 1024} KB`, ToolErrorCodes.INVALID_ARGS);
+            }
+            // Validate contextFiles
+            const rawFiles = args.contextFiles;
+            const contextFiles = [];
+            if (rawFiles !== undefined) {
+                if (!Array.isArray(rawFiles)) {
+                    return error("contextFiles must be an array", ToolErrorCodes.INVALID_ARGS);
+                }
+                if (rawFiles.length > MAX_CONTEXT_FILES) {
+                    return error(`contextFiles must have at most ${MAX_CONTEXT_FILES} entries`, ToolErrorCodes.INVALID_ARGS);
+                }
+                for (const f of rawFiles) {
+                    if (typeof f !== "string") {
+                        return error("contextFiles entries must be strings", ToolErrorCodes.INVALID_ARGS);
+                    }
+                    try {
+                        // Resolve and validate against workspace (read-only — no write: true)
+                        const resolved = resolveFilePath(f, workspace, { write: false });
+                        contextFiles.push(resolved);
+                    }
+                    catch (e) {
+                        return error(`Invalid contextFile "${f}": ${e instanceof Error ? e.message : String(e)}`, ToolErrorCodes.WORKSPACE_ESCAPE);
+                    }
+                }
+            }
+            // Validate timeoutMs
+            let timeoutMs;
+            if (args.timeoutMs !== undefined) {
+                const t = args.timeoutMs;
+                if (typeof t !== "number" ||
+                    !Number.isInteger(t) ||
+                    t < MIN_TIMEOUT_MS ||
+                    t > MAX_TIMEOUT_MS) {
+                    return error(`timeoutMs must be an integer between ${MIN_TIMEOUT_MS} and ${MAX_TIMEOUT_MS}`, ToolErrorCodes.INVALID_ARGS);
+                }
+                timeoutMs = t;
+            }
+            const stream = args.stream === true;
+            const model = typeof args.model === "string" && args.model.trim() !== ""
+                ? args.model.trim()
+                : undefined;
+            const VALID_EFFORT = ["low", "medium", "high", "max"];
+            const effort = typeof args.effort === "string" &&
+                VALID_EFFORT.includes(args.effort)
+                ? args.effort
+                : undefined;
+            if (args.effort !== undefined && effort === undefined) {
+                return error(`effort must be one of: ${VALID_EFFORT.join(", ")}`, ToolErrorCodes.INVALID_ARGS);
+            }
+            const fallbackModel = typeof args.fallbackModel === "string" &&
+                args.fallbackModel.trim() !== ""
+                ? args.fallbackModel.trim()
+                : undefined;
+            let maxBudgetUsd;
+            if (args.maxBudgetUsd !== undefined) {
+                if (typeof args.maxBudgetUsd !== "number" || args.maxBudgetUsd <= 0) {
+                    return error("maxBudgetUsd must be a positive number", ToolErrorCodes.INVALID_ARGS);
+                }
+                maxBudgetUsd = args.maxBudgetUsd;
+            }
+            let startupTimeoutMs;
+            if (args.startupTimeoutMs !== undefined) {
+                const s = args.startupTimeoutMs;
+                if (typeof s !== "number" ||
+                    !Number.isInteger(s) ||
+                    s < MIN_TIMEOUT_MS ||
+                    s > MAX_TIMEOUT_MS) {
+                    return error(`startupTimeoutMs must be an integer between ${MIN_TIMEOUT_MS} and ${MAX_TIMEOUT_MS}`, ToolErrorCodes.INVALID_ARGS);
+                }
+                startupTimeoutMs = s;
+            }
+            const useAnt = args.useAnt === true ? true : undefined;
+            let systemPrompt;
+            if (args.systemPrompt !== undefined) {
+                if (typeof args.systemPrompt !== "string" ||
+                    args.systemPrompt.length > MAX_SYSTEM_PROMPT_CHARS) {
+                    return error(`systemPrompt must be a string of at most ${MAX_SYSTEM_PROMPT_CHARS} characters`, ToolErrorCodes.INVALID_ARGS);
+                }
+                systemPrompt = args.systemPrompt;
+            }
+            if (!stream) {
+                // Non-streaming: enqueue and return taskId immediately
+                try {
+                    const taskId = orchestrator.enqueue({
+                        prompt,
+                        contextFiles,
+                        timeoutMs,
+                        sessionId,
+                        model,
+                        effort,
+                        fallbackModel,
+                        maxBudgetUsd,
+                        startupTimeoutMs,
+                        systemPrompt,
+                        useAnt,
+                    });
+                    return successStructured({ taskId, status: "pending" });
+                }
+                catch (e) {
+                    return error(`Failed to enqueue task: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            // Streaming: block until done, send chunks via progressFn
+            let chunkIndex = 0;
+            try {
+                const task = await orchestrator.runAndWait({
+                    prompt,
+                    contextFiles,
+                    timeoutMs,
+                    sessionId,
+                    model,
+                    effort,
+                    fallbackModel,
+                    maxBudgetUsd,
+                    startupTimeoutMs,
+                    systemPrompt,
+                    useAnt,
+                    onChunk: (chunk) => {
+                        progressFn?.(++chunkIndex, -1, chunk);
+                    },
+                });
+                return successStructured({
+                    taskId: task.id,
+                    status: task.status,
+                    output: task.output,
+                });
+            }
+            catch (e) {
+                return error(`Task execution failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=runClaudeTask.js.map

package/dist/tools/runClaudeTask.js.map

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

package/dist/tools/runCommand.d.ts

@@ -0,0 +1,82 @@
+import type { Config } from "../config.js";
+export declare function createRunCommandTool(workspace: string, config: Config): {
+    schema: {
+        name: string;
+        description: string;
+        annotations: {
+            destructiveHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            type: "object";
+            properties: {
+                command: {
+                    type: string;
+                    description: string;
+                };
+                args: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                cwd: {
+                    type: string;
+                    description: string;
+                };
+                timeout: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            additionalProperties: false;
+        };
+        outputSchema: {
+            type: string;
+            properties: {
+                exitCode: {
+                    type: string;
+                };
+                stdout: {
+                    type: string;
+                };
+                stderr: {
+                    type: string;
+                };
+                durationMs: {
+                    type: string;
+                };
+                timedOut: {
+                    type: string;
+                };
+                truncated: {
+                    type: string;
+                };
+                stdoutTruncated: {
+                    type: string;
+                };
+                stderrTruncated: {
+                    type: string;
+                };
+                maxBytes: {
+                    type: string;
+                };
+                note: {
+                    type: string;
+                };
+            };
+            required: string[];
+        };
+    };
+    timeoutMs: number;
+    handler: (args: Record<string, unknown>, signal?: AbortSignal, progress?: (value: number, total?: number, message?: string) => void) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+            _meta?: Record<string, unknown>;
+        }>;
+        structuredContent: unknown;
+    }>;
+};