@n8n/fs-proxy 0.1.0-rc1

package/dist/tools/mouse-keyboard/mouse-keyboard.js

@@ -0,0 +1,249 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keyboardShortcutTool = exports.keyboardKeyTapTool = exports.keyboardTypeTool = exports.mouseScrollTool = exports.mouseDragTool = exports.mouseDoubleClickTool = exports.mouseClickTool = exports.mouseMoveTool = void 0;
+const robotjs_1 = __importDefault(require("@jitsi/robotjs"));
+const zod_1 = require("zod");
+const monitor_utils_1 = require("../monitor-utils");
+const IS_MACOS = process.platform === 'darwin';
+const IS_WINDOWS = process.platform === 'win32';
+function normalizeKey(key) {
+    const k = key.toLowerCase();
+    const aliases = {
+        cmd: 'command',
+        meta: 'command',
+        super: 'command',
+        win: 'command',
+        windows: 'command',
+        ctrl: 'control',
+        option: 'alt',
+        return: 'enter',
+        esc: 'escape',
+        del: 'delete',
+        pgup: 'pageup',
+        pgdn: 'pagedown',
+        ins: 'insert',
+        caps: 'capslock',
+    };
+    return aliases[k] ?? k;
+}
+const MODIFIER_KEY_NAMES = IS_MACOS
+    ? '"command" (⌘, aliases: "cmd", "meta", "super"), "shift", "alt" (⌥, alias: "option"), "control" (alias: "ctrl")'
+    : IS_WINDOWS
+        ? '"control" (alias: "ctrl"), "shift", "alt", "command" (Win key, aliases: "win", "windows", "super")'
+        : '"control" (alias: "ctrl"), "shift", "alt", "command"';
+const SHORTCUT_EXAMPLE = IS_MACOS
+    ? '["command","t"] for ⌘T, ["command","shift","z"] for ⌘⇧Z'
+    : '["control","t"] for Ctrl+T, ["control","shift","z"] for Ctrl+Shift+Z';
+const screenSizeParams = {
+    screenWidth: zod_1.z
+        .number()
+        .int()
+        .optional()
+        .describe('Width of the screen as the agent perceived it from the screenshot (pixels). ' +
+        'Use the actual pixel width of the screenshot image you received.'),
+    screenHeight: zod_1.z
+        .number()
+        .int()
+        .optional()
+        .describe('Height of the screen as the agent perceived it from the screenshot (pixels). ' +
+        'Use the actual pixel height of the screenshot image you received.'),
+};
+function scaleCoord(x, y, screenWidth, screenHeight) {
+    if (!screenWidth || !screenHeight)
+        return { x, y };
+    const monitor = (0, monitor_utils_1.getPrimaryMonitor)();
+    return {
+        x: Math.round((x * monitor.width()) / screenWidth),
+        y: Math.round((y * monitor.height()) / screenHeight),
+    };
+}
+const mouseMoveSchema = zod_1.z.object({
+    x: zod_1.z.number().int().describe('Target X coordinate in pixels'),
+    y: zod_1.z.number().int().describe('Target Y coordinate in pixels'),
+    ...screenSizeParams,
+});
+const COMPUTER_RESOURCE = {
+    toolGroup: 'computer',
+    resource: '*',
+    description: 'Access screen/input devices',
+};
+exports.mouseMoveTool = {
+    name: 'mouse_move',
+    description: 'Move the mouse cursor to the specified screen coordinates',
+    inputSchema: mouseMoveSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ x, y, screenWidth, screenHeight }) {
+        const scaled = scaleCoord(x, y, screenWidth, screenHeight);
+        robotjs_1.default.moveMouse(scaled.x, scaled.y);
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const mouseClickSchema = zod_1.z.object({
+    x: zod_1.z.number().int().describe('X coordinate to click'),
+    y: zod_1.z.number().int().describe('Y coordinate to click'),
+    button: zod_1.z.enum(['left', 'right', 'middle']).optional().describe('Mouse button (default: left)'),
+    ...screenSizeParams,
+});
+exports.mouseClickTool = {
+    name: 'mouse_click',
+    description: 'Move the mouse to the specified coordinates and click',
+    inputSchema: mouseClickSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ x, y, button = 'left', screenWidth, screenHeight }) {
+        const scaled = scaleCoord(x, y, screenWidth, screenHeight);
+        robotjs_1.default.moveMouse(scaled.x, scaled.y);
+        robotjs_1.default.mouseClick(button);
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const mouseDoubleClickSchema = zod_1.z.object({
+    x: zod_1.z.number().int().describe('X coordinate to double-click'),
+    y: zod_1.z.number().int().describe('Y coordinate to double-click'),
+    ...screenSizeParams,
+});
+exports.mouseDoubleClickTool = {
+    name: 'mouse_double_click',
+    description: 'Move the mouse to the specified coordinates and double-click',
+    inputSchema: mouseDoubleClickSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ x, y, screenWidth, screenHeight }) {
+        const scaled = scaleCoord(x, y, screenWidth, screenHeight);
+        robotjs_1.default.moveMouse(scaled.x, scaled.y);
+        robotjs_1.default.mouseClick('left', true);
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const mouseDragSchema = zod_1.z.object({
+    fromX: zod_1.z.number().int().describe('Starting X coordinate'),
+    fromY: zod_1.z.number().int().describe('Starting Y coordinate'),
+    toX: zod_1.z.number().int().describe('Target X coordinate'),
+    toY: zod_1.z.number().int().describe('Target Y coordinate'),
+    ...screenSizeParams,
+});
+exports.mouseDragTool = {
+    name: 'mouse_drag',
+    description: 'Click-drag from one coordinate to another',
+    inputSchema: mouseDragSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ fromX, fromY, toX, toY, screenWidth, screenHeight }) {
+        const scaledFrom = scaleCoord(fromX, fromY, screenWidth, screenHeight);
+        const scaledTo = scaleCoord(toX, toY, screenWidth, screenHeight);
+        robotjs_1.default.moveMouse(scaledFrom.x, scaledFrom.y);
+        robotjs_1.default.mouseToggle('down');
+        robotjs_1.default.dragMouse(scaledTo.x, scaledTo.y);
+        robotjs_1.default.mouseToggle('up');
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const mouseScrollSchema = zod_1.z.object({
+    x: zod_1.z.number().int().describe('X coordinate to scroll at'),
+    y: zod_1.z.number().int().describe('Y coordinate to scroll at'),
+    direction: zod_1.z.enum(['up', 'down', 'left', 'right']).describe('Scroll direction'),
+    amount: zod_1.z.number().int().describe('Number of scroll ticks'),
+    ...screenSizeParams,
+});
+exports.mouseScrollTool = {
+    name: 'mouse_scroll',
+    description: 'Scroll at the specified screen coordinates',
+    inputSchema: mouseScrollSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ x, y, direction, amount, screenWidth, screenHeight }) {
+        const scaled = scaleCoord(x, y, screenWidth, screenHeight);
+        robotjs_1.default.moveMouse(scaled.x, scaled.y);
+        const dx = direction === 'right' ? amount : direction === 'left' ? -amount : 0;
+        const dy = direction === 'down' ? amount : direction === 'up' ? -amount : 0;
+        robotjs_1.default.scrollMouse(dx, dy);
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const keyboardTypeSchema = zod_1.z.object({
+    text: zod_1.z.string().describe('Text to type'),
+    delayMs: zod_1.z
+        .number()
+        .int()
+        .optional()
+        .describe('Milliseconds to wait before typing. Use this when the target input field needs time to ' +
+        'gain focus after a prior action (e.g. opening a new tab). Default: 0 (type immediately).'),
+});
+exports.keyboardTypeTool = {
+    name: 'keyboard_type',
+    description: 'Type a string of text using the keyboard',
+    inputSchema: keyboardTypeSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    async execute({ text, delayMs }) {
+        if (delayMs) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+        robotjs_1.default.typeStringDelayed(text, 60 * 4);
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const keyboardKeyTapSchema = zod_1.z.object({
+    key: zod_1.z
+        .string()
+        .describe('Key to press. Special keys: "enter", "escape", "tab", "backspace", "delete", "space", ' +
+        '"up", "down", "left", "right", "home", "end", "pageup", "pagedown", "insert", ' +
+        '"capslock", "printscreen", "menu", "f1"–"f24". ' +
+        'Numpad: "numpad_0"–"numpad_9", "numpad_+", "numpad_-", "numpad_*", "numpad_/", "numpad_.", "numpad_lock". ' +
+        'Media: "audio_mute", "audio_vol_up", "audio_vol_down", "audio_play", "audio_stop", "audio_pause", "audio_prev", "audio_next". ' +
+        'Aliases: "esc"→"escape", "del"→"delete", "pgup"→"pageup", "pgdn"→"pagedown", "ins"→"insert", "return"→"enter", "caps"→"capslock". ' +
+        'For single characters just pass the character directly (e.g. "a", "1", ".").'),
+});
+exports.keyboardKeyTapTool = {
+    name: 'keyboard_key_tap',
+    description: 'Press and release a single key. Use keyboard_shortcut for key combinations.',
+    inputSchema: keyboardKeyTapSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ key }) {
+        robotjs_1.default.keyTap(normalizeKey(key));
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+const keyboardShortcutSchema = zod_1.z.object({
+    keys: zod_1.z
+        .array(zod_1.z.string())
+        .min(1)
+        .describe('Keys in the shortcut. Last element is tapped; all preceding are held as modifiers. ' +
+        `Modifier names: ${MODIFIER_KEY_NAMES}. ` +
+        `Examples: ${SHORTCUT_EXAMPLE}.`),
+});
+exports.keyboardShortcutTool = {
+    name: 'keyboard_shortcut',
+    description: `Press a keyboard shortcut (e.g. ${IS_MACOS ? '⌘C, ⌘⇧Z' : 'Ctrl+C, Ctrl+Shift+Z'})`,
+    inputSchema: keyboardShortcutSchema,
+    annotations: {},
+    getAffectedResources() {
+        return [COMPUTER_RESOURCE];
+    },
+    execute({ keys }) {
+        const modifiers = keys.slice(0, -1).map(normalizeKey);
+        const key = normalizeKey(keys.at(-1));
+        robotjs_1.default.keyTap(key, modifiers);
+        return { content: [{ type: 'text', text: 'ok' }] };
+    },
+};
+//# sourceMappingURL=mouse-keyboard.js.map

package/dist/tools/mouse-keyboard/mouse-keyboard.js.map

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

package/dist/tools/screenshot/index.d.ts

@@ -0,0 +1,2 @@
+import type { ToolModule } from '../types';
+export declare const ScreenshotModule: ToolModule;

package/dist/tools/screenshot/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenshotModule = void 0;
+const node_screenshots_1 = require("node-screenshots");
+const logger_1 = require("../../logger");
+const screenshot_1 = require("./screenshot");
+exports.ScreenshotModule = {
+    isSupported() {
+        try {
+            const monitors = node_screenshots_1.Monitor.all();
+            if (monitors.length === 0) {
+                logger_1.logger.info('Screenshot module not supported', { reason: 'no monitors detected' });
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            logger_1.logger.info('Screenshot module not supported', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    },
+    definitions: [screenshot_1.screenshotTool, screenshot_1.screenshotRegionTool],
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/screenshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/screenshot/index.ts"],"names":[],"mappings":";;;AAAA,uDAA2C;AAE3C,yCAAsC;AAEtC,6CAAoE;AAEvD,QAAA,gBAAgB,GAAe;IAC3C,WAAW;QACV,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,0BAAO,CAAC,GAAG,EAAE,CAAC;YAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,eAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;gBACnF,OAAO,KAAK,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,eAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC9C,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IACD,WAAW,EAAE,CAAC,2BAAc,EAAE,iCAAoB,CAAC;CACnD,CAAC"}

package/dist/tools/screenshot/screenshot.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types';
+declare const screenshotSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+declare const screenshotRegionSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}>;
+export declare const screenshotTool: ToolDefinition<typeof screenshotSchema>;
+export declare const screenshotRegionTool: ToolDefinition<typeof screenshotRegionSchema>;
+export {};

package/dist/tools/screenshot/screenshot.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.screenshotRegionTool = exports.screenshotTool = void 0;
+const zod_1 = require("zod");
+const sharp_1 = __importDefault(require("sharp"));
+const monitor_utils_1 = require("../monitor-utils");
+const screenshotSchema = zod_1.z.object({});
+const screenshotRegionSchema = zod_1.z.object({
+    x: zod_1.z.number().int().describe('Region left position in pixels (absolute screen coordinates)'),
+    y: zod_1.z.number().int().describe('Region top position in pixels (absolute screen coordinates)'),
+    width: zod_1.z.number().int().describe('Region width in pixels'),
+    height: zod_1.z.number().int().describe('Region height in pixels'),
+});
+async function toJpeg(rawBuffer, width, height, logicalWidth, logicalHeight) {
+    let pipeline = (0, sharp_1.default)(rawBuffer, { raw: { width, height, channels: 4 } });
+    if (logicalWidth && logicalHeight && (width !== logicalWidth || height !== logicalHeight)) {
+        pipeline = pipeline.resize(logicalWidth, logicalHeight);
+    }
+    const w = logicalWidth ?? width;
+    const h = logicalHeight ?? height;
+    const maxDim = 1024;
+    if (w > maxDim || h > maxDim) {
+        const scale = maxDim / Math.max(w, h);
+        pipeline = pipeline.resize(Math.round(w * scale), Math.round(h * scale));
+    }
+    return await pipeline.jpeg({ quality: 85 }).toBuffer();
+}
+exports.screenshotTool = {
+    name: 'screen_screenshot',
+    description: 'Capture a screenshot of the full screen and return it as a base64-encoded JPEG',
+    inputSchema: screenshotSchema,
+    annotations: { readOnlyHint: true },
+    getAffectedResources() {
+        return [{ toolGroup: 'computer', resource: '*', description: 'Capture screenshot' }];
+    },
+    async execute(_input, _context) {
+        const monitor = (0, monitor_utils_1.getPrimaryMonitor)();
+        const image = await monitor.captureImage();
+        const rawBuffer = await image.toRaw();
+        const jpegBuffer = await toJpeg(rawBuffer, image.width, image.height, monitor.width(), monitor.height());
+        return {
+            content: [
+                {
+                    type: 'image',
+                    data: jpegBuffer.toString('base64'),
+                    mimeType: 'image/jpeg',
+                },
+            ],
+        };
+    },
+};
+exports.screenshotRegionTool = {
+    name: 'screen_screenshot_region',
+    description: 'Capture a specific region of the screen and return it as a base64-encoded JPEG',
+    inputSchema: screenshotRegionSchema,
+    annotations: { readOnlyHint: true },
+    getAffectedResources() {
+        return [
+            { toolGroup: 'computer', resource: '*', description: 'Capture screenshot region' },
+        ];
+    },
+    async execute({ x, y, width, height }, _context) {
+        const monitor = (0, monitor_utils_1.getPrimaryMonitor)();
+        const image = await monitor.captureImage();
+        const scaleFactor = monitor.scaleFactor();
+        const logicalRelX = Math.max(0, x - monitor.x());
+        const logicalRelY = Math.max(0, y - monitor.y());
+        const logicalClampedW = Math.min(width, monitor.width() - logicalRelX);
+        const logicalClampedH = Math.min(height, monitor.height() - logicalRelY);
+        const physRelX = Math.round(logicalRelX * scaleFactor);
+        const physRelY = Math.round(logicalRelY * scaleFactor);
+        const physW = Math.round(logicalClampedW * scaleFactor);
+        const physH = Math.round(logicalClampedH * scaleFactor);
+        const cropped = await image.crop(physRelX, physRelY, physW, physH);
+        const rawBuffer = await cropped.toRaw();
+        const jpegBuffer = await toJpeg(rawBuffer, cropped.width, cropped.height, logicalClampedW, logicalClampedH);
+        return {
+            content: [
+                {
+                    type: 'image',
+                    data: jpegBuffer.toString('base64'),
+                    mimeType: 'image/jpeg',
+                },
+            ],
+        };
+    },
+};
+//# sourceMappingURL=screenshot.js.map

package/dist/tools/screenshot/screenshot.js.map

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

package/dist/tools/shell/build-shell-resource.d.ts

@@ -0,0 +1 @@
+export declare function buildShellResource(command: string): string;

package/dist/tools/shell/build-shell-resource.js

@@ -0,0 +1,70 @@
+"use strict";
+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.buildShellResource = buildShellResource;
+const path = __importStar(require("node:path"));
+const WRAPPER_COMMANDS = new Set(['sudo', 'env', 'time', 'nice', 'nohup', 'xargs', 'doas']);
+const COMPLEX_TOKENS = ['|', ';', '&', '$(', '`', '<(', '>(', '\n'];
+function isComplex(command) {
+    return COMPLEX_TOKENS.some((token) => command.includes(token));
+}
+function buildShellResource(command) {
+    const trimmed = command.trim();
+    if (isComplex(trimmed))
+        return trimmed;
+    const words = trimmed.split(/\s+/);
+    let programIndex = -1;
+    for (let i = 0; i < words.length; i++) {
+        const word = words[i];
+        if (word.startsWith('-'))
+            continue;
+        if (/^[A-Z_a-z][A-Z0-9_a-z]*=/.test(word))
+            continue;
+        if (WRAPPER_COMMANDS.has(word))
+            continue;
+        programIndex = i;
+        break;
+    }
+    if (programIndex === -1)
+        return trimmed;
+    const program = words[programIndex];
+    if (program.startsWith('$') || program.startsWith('./') || program.startsWith('../')) {
+        return trimmed;
+    }
+    const basename = path.basename(program);
+    const rest = words.slice(programIndex + 1);
+    return rest.length > 0 ? `${basename} ${rest.join(' ')}` : basename;
+}
+//# sourceMappingURL=build-shell-resource.js.map

package/dist/tools/shell/build-shell-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-shell-resource.js","sourceRoot":"","sources":["../../../src/tools/shell/build-shell-resource.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,gDA8BC;AAxDD,gDAAkC;AAElC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAQ5F,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEpE,SAAS,SAAS,CAAC,OAAe;IACjC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC;AAYD,SAAgB,kBAAkB,CAAC,OAAe;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE/B,IAAI,SAAS,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;IAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACpD,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACzC,YAAY,GAAG,CAAC,CAAC;QACjB,MAAM;IACP,CAAC;IAED,IAAI,YAAY,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,MAAM,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;IAGpC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACtF,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IAE3C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrE,CAAC"}

package/dist/tools/shell/index.d.ts

@@ -0,0 +1,2 @@
+import type { ToolModule } from '../types';
+export declare const ShellModule: ToolModule;

package/dist/tools/shell/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShellModule = void 0;
+const shell_execute_1 = require("./shell-execute");
+exports.ShellModule = {
+    isSupported() {
+        return true;
+    },
+    definitions: [shell_execute_1.shellExecuteTool],
+};
+//# sourceMappingURL=index.js.map

package/dist/tools/shell/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/shell/index.ts"],"names":[],"mappings":";;;AACA,mDAAmD;AAEtC,QAAA,WAAW,GAAe;IACtC,WAAW;QACV,OAAO,IAAI,CAAC;IACb,CAAC;IACD,WAAW,EAAE,CAAC,gCAAgB,CAAC;CAC/B,CAAC"}

package/dist/tools/shell/shell-execute.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../types';
+declare const inputSchema: z.ZodObject<{
+    command: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+}, {
+    command: string;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+}>;
+export declare const shellExecuteTool: ToolDefinition<typeof inputSchema>;
+export {};

package/dist/tools/shell/shell-execute.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shellExecuteTool = void 0;
+const sandbox_runtime_1 = require("@anthropic-ai/sandbox-runtime");
+const ripgrep_1 = require("@vscode/ripgrep");
+const child_process_1 = require("child_process");
+const zod_1 = require("zod");
+const utils_1 = require("../utils");
+const build_shell_resource_1 = require("./build-shell-resource");
+async function initializeSandbox({ dir }) {
+    const config = {
+        ripgrep: {
+            command: ripgrep_1.rgPath,
+        },
+        network: {
+            allowedDomains: [],
+            deniedDomains: [],
+        },
+        filesystem: {
+            denyRead: ['~/.ssh'],
+            allowRead: [],
+            allowWrite: [dir],
+            denyWrite: [],
+        },
+    };
+    await sandbox_runtime_1.SandboxManager.initialize(config);
+}
+const inputSchema = zod_1.z.object({
+    command: zod_1.z.string().describe('Shell command to execute'),
+    timeout: zod_1.z.number().int().optional().describe('Timeout in milliseconds (default: 30000)'),
+    cwd: zod_1.z.string().optional().describe('Working directory for the command'),
+});
+exports.shellExecuteTool = {
+    name: 'shell_execute',
+    description: 'Execute a shell command and return stdout, stderr, and exit code',
+    inputSchema,
+    annotations: { destructiveHint: true },
+    getAffectedResources({ command }) {
+        return [
+            {
+                toolGroup: 'shell',
+                resource: (0, build_shell_resource_1.buildShellResource)(command),
+                description: `Execute shell command: ${command}`,
+            },
+        ];
+    },
+    async execute({ command, timeout = 30_000, cwd }, { dir }) {
+        return await runCommand(command, { timeout, dir, cwd: cwd ?? dir });
+    },
+};
+async function spawnCommand(command, { dir, cwd }) {
+    const isWindows = process.platform === 'win32';
+    const isMac = process.platform === 'darwin';
+    if (isWindows) {
+        return (0, child_process_1.spawn)('cmd.exe', ['/C', command], { cwd });
+    }
+    if (isMac) {
+        await initializeSandbox({ dir });
+        const sandboxedCommand = await sandbox_runtime_1.SandboxManager.wrapWithSandbox(command);
+        return (0, child_process_1.spawn)(sandboxedCommand, { shell: true, cwd });
+    }
+    return (0, child_process_1.spawn)('sh', ['-c', command], { cwd });
+}
+async function runCommand(command, { timeout, cwd, dir }) {
+    return await new Promise((resolve, reject) => {
+        spawnCommand(command, { dir, cwd })
+            .then((child) => {
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', (chunk) => {
+                stdout += String(chunk);
+            });
+            child.stderr?.on('data', (chunk) => {
+                stderr += String(chunk);
+            });
+            const timer = setTimeout(() => {
+                child.kill();
+                resolve((0, utils_1.formatCallToolResult)({ stdout, stderr, exitCode: null, timedOut: true }));
+            }, timeout);
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                resolve((0, utils_1.formatCallToolResult)({ stdout, stderr, exitCode: code }));
+            });
+        })
+            .catch(reject);
+    });
+}
+//# sourceMappingURL=shell-execute.js.map

package/dist/tools/shell/shell-execute.js.map

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

package/dist/tools/test-utils.d.ts

@@ -0,0 +1,3 @@
+import type { CallToolResult } from './types';
+export declare function textOf(result: CallToolResult): string;
+export declare function structuredOf(result: CallToolResult): Record<string, unknown>;