@studio-foundation/runner 0.3.0-beta.1

package/dist/script-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-executor.d.ts","sourceRoot":"","sources":["../src/script-executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2BD,wBAAsB,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmErF"}

package/dist/script-executor.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runScript = runScript;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const RUNTIME_COMMANDS = {
+    python: 'python3',
+    node: 'node',
+    shell: 'sh',
+};
+function buildEnv(runtime, cwd) {
+    const env = { ...process.env };
+    if (runtime === 'python') {
+        const venvPath = (0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, 'venv'))
+            ? (0, node_path_1.join)(cwd, 'venv')
+            : (0, node_fs_1.existsSync)((0, node_path_1.join)(cwd, '.venv'))
+                ? (0, node_path_1.join)(cwd, '.venv')
+                : null;
+        if (venvPath) {
+            env.VIRTUAL_ENV = venvPath;
+            env.PATH = `${(0, node_path_1.join)(venvPath, 'bin')}:${env.PATH ?? ''}`;
+        }
+    }
+    return env;
+}
+async function runScript(config) {
+    const startTime = Date.now();
+    const cwd = config.cwd ?? process.cwd();
+    const timeoutMs = config.timeoutMs ?? 30_000;
+    const cmd = RUNTIME_COMMANDS[config.runtime];
+    const env = buildEnv(config.runtime, cwd);
+    const stdin = JSON.stringify(config.context);
+    return new Promise((resolve) => {
+        const proc = (0, node_child_process_1.spawn)(cmd, [config.scriptPath], {
+            cwd,
+            env,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let settled = false;
+        const settle = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            proc.kill('SIGTERM');
+            setTimeout(() => proc.kill('SIGKILL'), 1000);
+        }, timeoutMs);
+        proc.stdout.on('data', (chunk) => { stdout += chunk.toString(); });
+        proc.stderr.on('data', (chunk) => { stderr += chunk.toString(); });
+        proc.stdin.write(stdin);
+        proc.stdin.end();
+        proc.on('close', (exitCode) => {
+            const duration_ms = Date.now() - startTime;
+            if (timedOut) {
+                settle({ output: null, tool_calls: [], tool_calls_count: 0, duration_ms, error: `Script timed out after ${timeoutMs}ms` });
+                return;
+            }
+            if (exitCode !== 0) {
+                settle({ output: null, tool_calls: [], tool_calls_count: 0, duration_ms, error: `Script exited with code ${exitCode}: ${stderr.trim()}` });
+                return;
+            }
+            let output;
+            try {
+                output = JSON.parse(stdout.trim());
+            }
+            catch {
+                settle({ output: null, tool_calls: [], tool_calls_count: 0, duration_ms, error: `Script output is not valid JSON: ${stdout.slice(0, 200)}` });
+                return;
+            }
+            settle({ output, tool_calls: [], tool_calls_count: 0, duration_ms });
+        });
+        proc.on('error', (err) => {
+            settle({ output: null, tool_calls: [], tool_calls_count: 0, duration_ms: Date.now() - startTime, error: `Script process error: ${err.message}` });
+        });
+    });
+}
+//# sourceMappingURL=script-executor.js.map

package/dist/script-executor.js.map

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

package/dist/tools/builtin/git.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Git tools - branch, commit, push, pull, status, diff
+ */
+import type { Tool } from '../tool-registry.js';
+export declare function createGitTools(workingDir: string): Tool[];
+//# sourceMappingURL=git.d.ts.map

package/dist/tools/builtin/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAmBhD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,CA6RzD"}

package/dist/tools/builtin/git.js

@@ -0,0 +1,294 @@
+"use strict";
+/**
+ * Git tools - branch, commit, push, pull, status, diff
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGitTools = createGitTools;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const PROTECTED_BRANCHES = ['main', 'master', 'develop', 'production'];
+async function isGitRepo(workingDir) {
+    try {
+        await execAsync('git rev-parse --git-dir', { cwd: workingDir });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function runGit(args, workingDir) {
+    return execAsync(`git ${args}`, { cwd: workingDir, timeout: 30000 });
+}
+function createGitTools(workingDir) {
+    return [
+        {
+            name: 'git-checkout',
+            description: 'Checkout or create a branch',
+            parameters: {
+                type: 'object',
+                properties: {
+                    branch: {
+                        type: 'string',
+                        description: 'Branch name to checkout or create'
+                    },
+                    create: {
+                        type: 'boolean',
+                        description: 'Create the branch if it does not exist (-b flag). Default: false'
+                    }
+                },
+                required: ['branch']
+            },
+            execute: async ({ branch, create }) => {
+                const branchName = branch;
+                const shouldCreate = create ?? false;
+                if (!(await isGitRepo(workingDir))) {
+                    return { success: false, output: null, error: 'Not a git repository' };
+                }
+                if (shouldCreate && PROTECTED_BRANCHES.includes(branchName)) {
+                    return {
+                        success: false,
+                        output: null,
+                        error: `Cannot create protected branch: ${branchName}`
+                    };
+                }
+                try {
+                    const flag = shouldCreate ? '-b ' : '';
+                    const { stdout, stderr } = await runGit(`checkout ${flag}${branchName}`, workingDir);
+                    return {
+                        success: true,
+                        output: { branch: branchName, created: shouldCreate, stdout: stdout.trim(), stderr: stderr.trim() }
+                    };
+                }
+                catch (error) {
+                    const e = error;
+                    return {
+                        success: false,
+                        output: null,
+                        error: e.stderr?.trim() || e.message || 'git checkout failed'
+                    };
+                }
+            }
+        },
+        {
+            name: 'git-commit',
+            description: 'Stage files and commit changes',
+            parameters: {
+                type: 'object',
+                properties: {
+                    message: {
+                        type: 'string',
+                        description: 'Commit message'
+                    },
+                    files: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'Files to stage. If empty or omitted, stages all changes (git add -A)'
+                    }
+                },
+                required: ['message']
+            },
+            execute: async ({ message, files }) => {
+                const commitMessage = message;
+                const filesToStage = files;
+                if (!(await isGitRepo(workingDir))) {
+                    return { success: false, output: null, error: 'Not a git repository' };
+                }
+                try {
+                    // Check for merge conflicts
+                    const { stdout: statusOut } = await runGit('status --porcelain', workingDir);
+                    const hasConflicts = statusOut.split('\n').some(line => line.startsWith('UU') || line.startsWith('AA') || line.startsWith('DD'));
+                    if (hasConflicts) {
+                        return { success: false, output: null, error: 'Cannot commit: merge conflicts detected' };
+                    }
+                    // Stage files
+                    if (filesToStage && filesToStage.length > 0) {
+                        await runGit(`add -- ${filesToStage.map(f => `"${f}"`).join(' ')}`, workingDir);
+                    }
+                    else {
+                        await runGit('add -A', workingDir);
+                    }
+                    // Commit
+                    const { stdout } = await runGit(`commit -m ${JSON.stringify(commitMessage)}`, workingDir);
+                    return {
+                        success: true,
+                        output: { message: commitMessage, stdout: stdout.trim() }
+                    };
+                }
+                catch (error) {
+                    const e = error;
+                    return {
+                        success: false,
+                        output: null,
+                        error: e.stderr?.trim() || e.stdout?.trim() || e.message || 'git commit failed'
+                    };
+                }
+            }
+        },
+        {
+            name: 'git-push',
+            description: 'Push current branch to remote',
+            parameters: {
+                type: 'object',
+                properties: {
+                    remote: {
+                        type: 'string',
+                        description: 'Remote name. Default: origin'
+                    },
+                    set_upstream: {
+                        type: 'boolean',
+                        description: 'Set upstream tracking (-u flag). Default: true'
+                    }
+                },
+                required: []
+            },
+            execute: async ({ remote, set_upstream }) => {
+                const remoteName = remote ?? 'origin';
+                const setUpstream = set_upstream ?? true;
+                if (!(await isGitRepo(workingDir))) {
+                    return { success: false, output: null, error: 'Not a git repository' };
+                }
+                try {
+                    const { stdout: branchOut } = await runGit('rev-parse --abbrev-ref HEAD', workingDir);
+                    const currentBranch = branchOut.trim();
+                    const upstreamFlag = setUpstream ? `-u ` : '';
+                    const { stdout, stderr } = await runGit(`push ${upstreamFlag}${remoteName} ${currentBranch}`, workingDir);
+                    return {
+                        success: true,
+                        output: { remote: remoteName, branch: currentBranch, stdout: stdout.trim(), stderr: stderr.trim() }
+                    };
+                }
+                catch (error) {
+                    const e = error;
+                    return {
+                        success: false,
+                        output: null,
+                        error: e.stderr?.trim() || e.message || 'git push failed'
+                    };
+                }
+            }
+        },
+        {
+            name: 'git-pull',
+            description: 'Pull latest changes from remote',
+            parameters: {
+                type: 'object',
+                properties: {
+                    remote: {
+                        type: 'string',
+                        description: 'Remote name. Default: origin'
+                    },
+                    branch: {
+                        type: 'string',
+                        description: 'Branch to pull. If omitted, pulls current branch'
+                    }
+                },
+                required: []
+            },
+            execute: async ({ remote, branch }) => {
+                const remoteName = remote ?? 'origin';
+                const branchName = branch;
+                if (!(await isGitRepo(workingDir))) {
+                    return { success: false, output: null, error: 'Not a git repository' };
+                }
+                try {
+                    const branchArg = branchName ? ` ${branchName}` : '';
+                    const { stdout, stderr } = await runGit(`pull ${remoteName}${branchArg}`, workingDir);
+                    return {
+                        success: true,
+                        output: { remote: remoteName, branch: branchName ?? 'current', stdout: stdout.trim(), stderr: stderr.trim() }
+                    };
+                }
+                catch (error) {
+                    const e = error;
+                    return {
+                        success: false,
+                        output: null,
+                        error: e.stderr?.trim() || e.stdout?.trim() || e.message || 'git pull failed'
+                    };
+                }
+            }
+        },
+        {
+            name: 'git-status',
+            description: 'Show working tree status (modified, added, deleted files)',
+            parameters: {
+                type: 'object',
+                properties: {},
+                required: []
+            },
+            execute: async () => {
+                if (!(await isGitRepo(workingDir))) {
+                    return { success: false, output: null, error: 'Not a git repository' };
+                }
+                try {
+                    const { stdout: porcelain } = await runGit('status --porcelain', workingDir);
+                    const { stdout: branch } = await runGit('rev-parse --abbrev-ref HEAD', workingDir);
+                    const files = porcelain
+                        .split('\n')
+                        .filter(line => line.trim())
+                        .map(line => ({ status: line.slice(0, 2).trim(), file: line.slice(3) }));
+                    return {
+                        success: true,
+                        output: {
+                            branch: branch.trim(),
+                            clean: files.length === 0,
+                            files
+                        }
+                    };
+                }
+                catch (error) {
+                    const e = error;
+                    return {
+                        success: false,
+                        output: null,
+                        error: e.stderr?.trim() || e.message || 'git status failed'
+                    };
+                }
+            }
+        },
+        {
+            name: 'git-diff',
+            description: 'Show changes in working tree or staged files',
+            parameters: {
+                type: 'object',
+                properties: {
+                    staged: {
+                        type: 'boolean',
+                        description: 'Show staged changes (--cached). Default: false'
+                    },
+                    file: {
+                        type: 'string',
+                        description: 'Diff a specific file. If omitted, shows all changes'
+                    }
+                },
+                required: []
+            },
+            execute: async ({ staged, file }) => {
+                const showStaged = staged ?? false;
+                const filePath = file;
+                if (!(await isGitRepo(workingDir))) {
+                    return { success: false, output: null, error: 'Not a git repository' };
+                }
+                try {
+                    const stagedFlag = showStaged ? '--cached ' : '';
+                    const fileArg = filePath ? `-- "${filePath}"` : '';
+                    const { stdout } = await runGit(`diff ${stagedFlag}${fileArg}`.trim(), workingDir);
+                    return {
+                        success: true,
+                        output: { diff: stdout, staged: showStaged, file: filePath ?? null }
+                    };
+                }
+                catch (error) {
+                    const e = error;
+                    return {
+                        success: false,
+                        output: null,
+                        error: e.stderr?.trim() || e.message || 'git diff failed'
+                    };
+                }
+            }
+        }
+    ];
+}
+//# sourceMappingURL=git.js.map

package/dist/tools/builtin/git.js.map

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

package/dist/tools/builtin/patch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Patch tool - apply unified diffs to files
+ */
+import type { Tool } from '../tool-registry.js';
+export declare function createPatchTools(repoPath: string): Tool[];
+//# sourceMappingURL=patch.d.ts.map

package/dist/tools/builtin/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/patch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,qBAAqB,CAAC;AAwJ5D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAkGzD"}

package/dist/tools/builtin/patch.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * Patch tool - apply unified diffs to files
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPatchTools = createPatchTools;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Parse a unified diff string into hunks.
+ */
+function parseHunks(patch) {
+    const rawLines = patch.split('\n');
+    // Remove the trailing empty string that split() produces when the patch ends
+    // with '\n'. Without this, the '' is treated as a blank context line and gets
+    // appended to getOldBlock(), causing spurious "Ambiguous match" errors when
+    // the file contains blank lines.
+    if (rawLines.length > 0 && rawLines[rawLines.length - 1] === '') {
+        rawLines.pop();
+    }
+    // Filter out --- / +++ headers
+    const lines = rawLines.filter((l) => !l.startsWith('---') && !l.startsWith('+++'));
+    const hunks = [];
+    let current = null;
+    for (const line of lines) {
+        const hunkHeader = line.match(/^@@\s+-(\d+)(?:,(\d+))?\s+\+\d+(?:,\d+)?\s*@@/);
+        if (hunkHeader) {
+            current = {
+                oldStart: parseInt(hunkHeader[1], 10),
+                oldCount: parseInt(hunkHeader[2] ?? '1', 10),
+                lines: [],
+            };
+            hunks.push(current);
+            continue;
+        }
+        if (!current)
+            continue;
+        if (line.startsWith('+')) {
+            current.lines.push({ type: 'add', content: line.slice(1) });
+        }
+        else if (line.startsWith('-')) {
+            current.lines.push({ type: 'remove', content: line.slice(1) });
+        }
+        else if (line.startsWith(' ') || line === '') {
+            // Context line — space prefix or empty line
+            const content = line.startsWith(' ') ? line.slice(1) : line;
+            current.lines.push({ type: 'context', content });
+        }
+        // Ignore lines like ""
+    }
+    return hunks;
+}
+/**
+ * Build the "old block" — context + removed lines that must match the file.
+ */
+function getOldBlock(hunk) {
+    return hunk.lines
+        .filter((l) => l.type === 'context' || l.type === 'remove')
+        .map((l) => l.content);
+}
+/**
+ * Build the "new block" — context + added lines that replace the old block.
+ */
+function getNewBlock(hunk) {
+    return hunk.lines
+        .filter((l) => l.type === 'context' || l.type === 'add')
+        .map((l) => l.content);
+}
+/**
+ * Compare two strings with trailing whitespace tolerance.
+ */
+function fuzzyMatch(a, b) {
+    return a.trimEnd() === b.trimEnd();
+}
+/**
+ * Check if oldBlock matches fileLines starting at position `start`.
+ */
+function blockMatchesAt(fileLines, oldBlock, start) {
+    if (start + oldBlock.length > fileLines.length)
+        return false;
+    return oldBlock.every((line, i) => fuzzyMatch(fileLines[start + i], line));
+}
+/**
+ * Find where the old block matches in the file.
+ * Tries the hinted line first, then scans the full file.
+ * Returns the 0-based start index.
+ */
+function findMatch(fileLines, oldBlock, hintLine, hunkIndex) {
+    // Convert 1-based hint to 0-based
+    const hint = hintLine - 1;
+    // Pure-insertion hunk: @@ -N,0 ... has no context or removed lines.
+    // Scanning for an empty block would vacuously match every position, so we
+    // insert directly at the hinted position instead.
+    if (oldBlock.length === 0) {
+        return Math.max(0, hint);
+    }
+    // Fast path: try at the hinted position
+    if (hint >= 0 && blockMatchesAt(fileLines, oldBlock, hint)) {
+        return hint;
+    }
+    // Slow path: scan the whole file
+    const matches = [];
+    for (let i = 0; i < fileLines.length; i++) {
+        if (blockMatchesAt(fileLines, oldBlock, i)) {
+            matches.push(i);
+        }
+    }
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length === 0) {
+        const expected = oldBlock[0] ?? '(empty)';
+        throw new Error(`Context mismatch at hunk ${hunkIndex + 1}: could not find context "${expected}" in file`);
+    }
+    throw new Error(`Ambiguous match at hunk ${hunkIndex + 1}: context found at lines ${matches.map((m) => m + 1).join(', ')}. Add more context lines.`);
+}
+function createPatchTools(repoPath) {
+    return [
+        {
+            name: 'repo_manager-apply_patch',
+            description: 'Apply a unified diff patch to a file. The patch must include enough context lines for unambiguous matching. Fails loudly if context doesn\'t match the file content.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Relative path to the file to patch (from workspace root)',
+                    },
+                    patch: {
+                        type: 'string',
+                        description: 'Unified diff format patch. Must start with @@ hunk headers. Use - for removed lines, + for added lines, space for context lines. Include at least 3 context lines before and after changes.',
+                    },
+                },
+                required: ['path', 'patch'],
+            },
+            execute: async ({ path: filePath, patch: patchStr }) => {
+                try {
+                    const fullPath = path.join(repoPath, filePath);
+                    // Read file
+                    let fileContent;
+                    try {
+                        fileContent = await fs.readFile(fullPath, 'utf-8');
+                    }
+                    catch {
+                        return {
+                            success: false,
+                            output: null,
+                            error: `File not found: ${filePath}`,
+                        };
+                    }
+                    // Parse hunks
+                    const hunks = parseHunks(patchStr);
+                    if (hunks.length === 0) {
+                        return {
+                            success: false,
+                            output: null,
+                            error: 'Invalid patch format: no hunks found (expected @@ headers)',
+                        };
+                    }
+                    const fileLines = fileContent.split('\n');
+                    let totalAdded = 0;
+                    let totalRemoved = 0;
+                    // Find all match positions first (before any modifications)
+                    const matchPositions = [];
+                    for (let i = 0; i < hunks.length; i++) {
+                        const oldBlock = getOldBlock(hunks[i]);
+                        const pos = findMatch(fileLines, oldBlock, hunks[i].oldStart, i);
+                        matchPositions.push(pos);
+                    }
+                    // Apply hunks in reverse order to preserve line numbers
+                    const indices = hunks.map((_, i) => i);
+                    indices.sort((a, b) => matchPositions[b] - matchPositions[a]);
+                    for (const i of indices) {
+                        const hunk = hunks[i];
+                        const pos = matchPositions[i];
+                        const oldBlock = getOldBlock(hunk);
+                        const newBlock = getNewBlock(hunk);
+                        fileLines.splice(pos, oldBlock.length, ...newBlock);
+                        totalAdded += hunk.lines.filter((l) => l.type === 'add').length;
+                        totalRemoved += hunk.lines.filter((l) => l.type === 'remove').length;
+                    }
+                    // Write file back
+                    await fs.writeFile(fullPath, fileLines.join('\n'), 'utf-8');
+                    const result = {
+                        success: true,
+                        path: filePath,
+                        hunks_applied: hunks.length,
+                        hunks_total: hunks.length,
+                        lines_added: totalAdded,
+                        lines_removed: totalRemoved,
+                    };
+                    return { success: true, output: result };
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    return {
+                        success: false,
+                        output: null,
+                        error: errorMessage,
+                    };
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=patch.js.map