@hoangsonw/forge 0.1.0

package/dist/tools/move-file.js

@@ -0,0 +1,100 @@
+"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.moveFileTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const errors_1 = require("../types/errors");
+const fs_1 = require("../sandbox/fs");
+exports.moveFileTool = {
+    schema: {
+        name: 'move_file',
+        description: 'Move (rename) a file or directory within the sandbox.',
+        sideEffect: 'write',
+        risk: 'medium',
+        permissionDefault: 'ask',
+        sensitivity: 'medium',
+        timeoutMs: 10_000,
+        inputSchema: {
+            type: 'object',
+            required: ['from', 'to'],
+            properties: {
+                from: { type: 'string' },
+                to: { type: 'string' },
+                overwrite: { type: 'boolean' },
+                createDirs: { type: 'boolean' },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            const src = (0, fs_1.resolveSafe)(args.from, { projectRoot: ctx.projectRoot }, 'write');
+            const dst = (0, fs_1.resolveSafe)(args.to, { projectRoot: ctx.projectRoot }, 'write');
+            if (!fs.existsSync(src)) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'not_found',
+                    message: `source not found: ${args.from}`,
+                    retryable: false,
+                });
+            }
+            if (fs.existsSync(dst) && !args.overwrite) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'conflict',
+                    message: `destination exists: ${args.to}. pass overwrite=true to replace.`,
+                    retryable: false,
+                });
+            }
+            if (args.createDirs)
+                fs.mkdirSync(path.dirname(dst), { recursive: true });
+            fs.renameSync(src, dst);
+            return {
+                success: true,
+                output: { from: args.from, to: args.to },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=move-file.js.map

package/dist/tools/move-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-file.js","sourceRoot":"","sources":["../../src/tools/move-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAE7B,4CAAoD;AACpD,sCAA4C;AAS/B,QAAA,YAAY,GAA6C;IACpE,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,uDAAuD;QACpE,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,QAAQ;QACd,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;YACxB,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACtB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC9B,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;aAChC;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAA,gBAAW,EAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;YAC9E,MAAM,GAAG,GAAG,IAAA,gBAAW,EAAC,IAAI,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;YAC5E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,WAAW;oBAClB,OAAO,EAAE,qBAAqB,IAAI,CAAC,IAAI,EAAE;oBACzC,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1C,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,UAAU;oBACjB,OAAO,EAAE,uBAAuB,IAAI,CAAC,EAAE,mCAAmC;oBAC1E,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,IAAI,CAAC,UAAU;gBAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1E,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;gBACxC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;gBACrE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/read-file.d.ts

@@ -0,0 +1,14 @@
+import { Tool } from '../types';
+interface Args {
+    path: string;
+    maxBytes?: number;
+    startLine?: number;
+    endLine?: number;
+}
+export declare const readFileTool: Tool<Args, {
+    content: string;
+    lines: number;
+    truncated: boolean;
+}>;
+export {};
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CA6D3F,CAAC"}

package/dist/tools/read-file.js

@@ -0,0 +1,99 @@
+"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.readFileTool = void 0;
+const fs = __importStar(require("fs"));
+const errors_1 = require("../types/errors");
+const fs_1 = require("../sandbox/fs");
+exports.readFileTool = {
+    schema: {
+        name: 'read_file',
+        description: 'Read a text file from the project sandbox.',
+        sideEffect: 'readonly',
+        risk: 'low',
+        permissionDefault: 'allow',
+        sensitivity: 'low',
+        timeoutMs: 15_000,
+        inputSchema: {
+            type: 'object',
+            required: ['path'],
+            properties: {
+                path: { type: 'string' },
+                maxBytes: { type: 'number' },
+                startLine: { type: 'number' },
+                endLine: { type: 'number' },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            const real = (0, fs_1.resolveSafe)(args.path, { projectRoot: ctx.projectRoot }, 'read');
+            const stat = fs.statSync(real);
+            if (!stat.isFile()) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'tool_error',
+                    message: `${args.path} is not a regular file.`,
+                    retryable: false,
+                });
+            }
+            const max = args.maxBytes ?? 2 * 1024 * 1024;
+            const buf = fs.readFileSync(real);
+            const truncated = buf.length > max;
+            let content = buf.slice(0, max).toString('utf8');
+            if (args.startLine || args.endLine) {
+                const lines = content.split('\n');
+                const s = Math.max(1, args.startLine ?? 1);
+                const e = Math.min(lines.length, args.endLine ?? lines.length);
+                content = lines.slice(s - 1, e).join('\n');
+            }
+            return {
+                success: true,
+                output: { content, lines: content.split('\n').length, truncated },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from '../types';
+type AnyTool = Tool<any, any>;
+export declare const registerTool: (tool: AnyTool) => void;
+export declare const getTool: (name: string) => AnyTool;
+export declare const allTools: () => AnyTool[];
+export declare const toolsByName: (names: string[]) => AnyTool[];
+export declare const hasTool: (name: string) => boolean;
+export declare const clearTools: () => void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAMhC,KAAK,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAI9B,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,KAAG,IAE5C,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OAUtC,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,OAAO,EAA4B,CAAC;AAEhE,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,KAAG,OAAO,EAAkC,CAAC;AAExF,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,KAAG,OAA6B,CAAC;AAErE,eAAO,MAAM,UAAU,QAAO,IAAwB,CAAC"}

package/dist/tools/registry.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearTools = exports.hasTool = exports.toolsByName = exports.allTools = exports.getTool = exports.registerTool = void 0;
+const errors_1 = require("../types/errors");
+const registry = new Map();
+const registerTool = (tool) => {
+    registry.set(tool.schema.name, tool);
+};
+exports.registerTool = registerTool;
+const getTool = (name) => {
+    const t = registry.get(name);
+    if (!t) {
+        throw new errors_1.ForgeRuntimeError({
+            class: 'not_found',
+            message: `Tool '${name}' is not registered.`,
+            retryable: false,
+        });
+    }
+    return t;
+};
+exports.getTool = getTool;
+const allTools = () => [...registry.values()];
+exports.allTools = allTools;
+const toolsByName = (names) => names.map((n) => (0, exports.getTool)(n));
+exports.toolsByName = toolsByName;
+const hasTool = (name) => registry.has(name);
+exports.hasTool = hasTool;
+const clearTools = () => registry.clear();
+exports.clearTools = clearTools;
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":";;;AACA,4CAAoD;AAOpD,MAAM,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;AAE1C,MAAM,YAAY,GAAG,CAAC,IAAa,EAAQ,EAAE;IAClD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC;AAFW,QAAA,YAAY,gBAEvB;AAEK,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE;IAC/C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,0BAAiB,CAAC;YAC1B,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,SAAS,IAAI,sBAAsB;YAC5C,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAVW,QAAA,OAAO,WAUlB;AAEK,MAAM,QAAQ,GAAG,GAAc,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAAnD,QAAA,QAAQ,YAA2C;AAEzD,MAAM,WAAW,GAAG,CAAC,KAAe,EAAa,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,eAAO,EAAC,CAAC,CAAC,CAAC,CAAC;AAA3E,QAAA,WAAW,eAAgE;AAEjF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAAxD,QAAA,OAAO,WAAiD;AAE9D,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;AAA1C,QAAA,UAAU,cAAgC"}

package/dist/tools/run-command.d.ts

@@ -0,0 +1,17 @@
+import { Tool } from '../types';
+interface Args {
+    command: string;
+    timeoutMs?: number;
+    env?: Record<string, string>;
+    stdin?: string;
+}
+interface Output {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    signal: NodeJS.Signals | null;
+    timedOut: boolean;
+}
+export declare const runCommandTool: Tool<Args, Output>;
+export {};
+//# sourceMappingURL=run-command.d.ts.map

package/dist/tools/run-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,IAAI;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,MAAM;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAkE7C,CAAC"}

package/dist/tools/run-command.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCommandTool = void 0;
+const errors_1 = require("../types/errors");
+const shell_1 = require("../sandbox/shell");
+exports.runCommandTool = {
+    schema: {
+        name: 'run_command',
+        description: 'Execute a shell command inside the project sandbox.',
+        sideEffect: 'execute',
+        risk: 'high',
+        permissionDefault: 'ask',
+        sensitivity: 'high',
+        timeoutMs: 120_000,
+        inputSchema: {
+            type: 'object',
+            required: ['command'],
+            properties: {
+                command: { type: 'string' },
+                timeoutMs: { type: 'number' },
+                env: { type: 'object' },
+                stdin: { type: 'string' },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            if ((0, shell_1.isBlocked)(args.command)) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'sandbox_violation',
+                    message: `Blocked command: ${args.command}`,
+                    retryable: false,
+                });
+            }
+            const risk = (0, shell_1.classifyCommandRisk)(args.command);
+            if (risk === 'critical') {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'sandbox_violation',
+                    message: `Critical-risk command blocked: ${args.command}`,
+                    retryable: false,
+                });
+            }
+            const res = await (0, shell_1.runCommand)(args.command, {
+                cwd: ctx.projectRoot,
+                timeoutMs: args.timeoutMs ?? 120_000,
+                env: args.env,
+                stdin: args.stdin,
+            });
+            return {
+                success: res.exitCode === 0 && !res.timedOut,
+                output: {
+                    stdout: res.stdout,
+                    stderr: res.stderr,
+                    exitCode: res.exitCode,
+                    signal: res.signal,
+                    timedOut: res.timedOut,
+                },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=run-command.js.map

package/dist/tools/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":";;;AACA,4CAAoD;AACpD,4CAA8E;AAiBjE,QAAA,cAAc,GAAuB;IAChD,MAAM,EAAE;QACN,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,qDAAqD;QAClE,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,MAAM;QACZ,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,OAAO;QAClB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,SAAS,CAAC;YACrB,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACvB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC1B;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,IAAI,IAAA,iBAAS,EAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,oBAAoB,IAAI,CAAC,OAAO,EAAE;oBAC3C,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,IAAI,GAAG,IAAA,2BAAmB,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;gBACxB,MAAM,IAAI,0BAAiB,CAAC;oBAC1B,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,kCAAkC,IAAI,CAAC,OAAO,EAAE;oBACzD,SAAS,EAAE,KAAK;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,IAAA,kBAAU,EAAC,IAAI,CAAC,OAAO,EAAE;gBACzC,GAAG,EAAE,GAAG,CAAC,WAAW;gBACpB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,OAAO;gBACpC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAC5C,MAAM,EAAE;oBACN,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;iBACvB;gBACD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;gBACrE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/run-tests.d.ts

@@ -0,0 +1,16 @@
+import { Tool } from '../types';
+interface Args {
+    framework?: 'auto' | 'npm' | 'pnpm' | 'yarn' | 'pytest' | 'go' | 'cargo';
+    target?: string;
+    timeoutMs?: number;
+}
+interface Output {
+    framework: string;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    passed: boolean;
+}
+export declare const runTestsTool: Tool<Args, Output>;
+export {};
+//# sourceMappingURL=run-tests.d.ts.map

package/dist/tools/run-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests.d.ts","sourceRoot":"","sources":["../../src/tools/run-tests.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAI5C,UAAU,IAAI;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,MAAM;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAyCD,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CA4D3C,CAAC"}

package/dist/tools/run-tests.js

@@ -0,0 +1,140 @@
+"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.runTestsTool = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const shell_1 = require("../sandbox/shell");
+const errors_1 = require("../types/errors");
+const detectFramework = (root) => {
+    if (fs.existsSync(path.join(root, 'package.json'))) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+            if (pkg?.scripts?.test)
+                return 'npm';
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (fs.existsSync(path.join(root, 'pyproject.toml')) ||
+        fs.existsSync(path.join(root, 'pytest.ini'))) {
+        return 'pytest';
+    }
+    if (fs.existsSync(path.join(root, 'go.mod')))
+        return 'go';
+    if (fs.existsSync(path.join(root, 'Cargo.toml')))
+        return 'cargo';
+    return 'none';
+};
+const commandFor = (framework, target) => {
+    switch (framework) {
+        case 'npm':
+            return `npm test${target ? ` -- ${target}` : ''}`;
+        case 'pnpm':
+            return `pnpm test${target ? ` -- ${target}` : ''}`;
+        case 'yarn':
+            return `yarn test${target ? ` ${target}` : ''}`;
+        case 'pytest':
+            return `pytest${target ? ` ${target}` : ''}`;
+        case 'go':
+            return `go test ${target ?? './...'}`;
+        case 'cargo':
+            return `cargo test${target ? ` ${target}` : ''}`;
+        default:
+            return null;
+    }
+};
+exports.runTestsTool = {
+    schema: {
+        name: 'run_tests',
+        description: 'Run the project test suite (auto-detects framework).',
+        sideEffect: 'execute',
+        risk: 'medium',
+        permissionDefault: 'ask',
+        sensitivity: 'medium',
+        timeoutMs: 600_000,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                framework: { type: 'string' },
+                target: { type: 'string' },
+                timeoutMs: { type: 'number' },
+            },
+        },
+    },
+    async execute(args, ctx) {
+        const start = Date.now();
+        try {
+            const framework = args.framework && args.framework !== 'auto'
+                ? args.framework
+                : detectFramework(ctx.projectRoot);
+            const cmd = commandFor(framework, args.target);
+            if (!cmd) {
+                throw new errors_1.ForgeRuntimeError({
+                    class: 'not_found',
+                    message: 'No test framework detected.',
+                    retryable: false,
+                    recoveryHint: 'Specify framework explicitly or add a test runner.',
+                });
+            }
+            const res = await (0, shell_1.runCommand)(cmd, {
+                cwd: ctx.projectRoot,
+                timeoutMs: args.timeoutMs ?? 300_000,
+            });
+            return {
+                success: res.exitCode === 0,
+                output: {
+                    framework,
+                    stdout: res.stdout,
+                    stderr: res.stderr,
+                    exitCode: res.exitCode,
+                    passed: res.exitCode === 0,
+                },
+                durationMs: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: false },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=run-tests.js.map

package/dist/tools/run-tests.js.map

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

package/dist/tools/web-browse.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from '../types';
+import { BrowseStep, BrowseOutput } from '../web/browse';
+interface Args {
+    steps: BrowseStep[];
+    headless?: boolean;
+    timeoutMs?: number;
+}
+export declare const webBrowseTool: Tool<Args, BrowseOutput>;
+export {};
+//# sourceMappingURL=web-browse.d.ts.map

package/dist/tools/web-browse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-browse.d.ts","sourceRoot":"","sources":["../../src/tools/web-browse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAkB,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGzE,UAAU,IAAI;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAuClD,CAAC"}

package/dist/tools/web-browse.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webBrowseTool = void 0;
+const browse_1 = require("../web/browse");
+const errors_1 = require("../types/errors");
+exports.webBrowseTool = {
+    schema: {
+        name: 'web.browse',
+        description: 'Run a sequence of browser actions (goto/click/type/press/waitFor/extract) via Playwright.',
+        sideEffect: 'network',
+        risk: 'high',
+        permissionDefault: 'ask',
+        sensitivity: 'high',
+        timeoutMs: 120_000,
+        inputSchema: {
+            type: 'object',
+            required: ['steps'],
+            properties: {
+                steps: { type: 'array' },
+                headless: { type: 'boolean' },
+                timeoutMs: { type: 'number' },
+            },
+        },
+    },
+    async execute(args) {
+        const start = Date.now();
+        try {
+            const out = await (0, browse_1.runBrowseSteps)(args.steps, {
+                headless: args.headless,
+                timeoutMs: args.timeoutMs,
+            });
+            return { success: true, output: out, durationMs: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof errors_1.ForgeRuntimeError
+                    ? err.toJSON()
+                    : { class: 'tool_error', message: String(err), retryable: true },
+                durationMs: Date.now() - start,
+            };
+        }
+    },
+};
+//# sourceMappingURL=web-browse.js.map

package/dist/tools/web-browse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-browse.js","sourceRoot":"","sources":["../../src/tools/web-browse.ts"],"names":[],"mappings":";;;AACA,0CAAyE;AACzE,4CAAoD;AAQvC,QAAA,aAAa,GAA6B;IACrD,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,2FAA2F;QAC7F,UAAU,EAAE,SAAS;QACrB,IAAI,EAAE,MAAM;QACZ,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,OAAO;QAClB,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;gBACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC7B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC9B;SACF;KACF;IACD,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAA,uBAAc,EAAC,IAAI,CAAC,KAAK,EAAE;gBAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EACH,GAAG,YAAY,0BAAiB;oBAC9B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE;oBACd,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;gBACpE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/web-fetch.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from '../types';
+import { FetchResult } from '../web/fetch';
+interface Args {
+    url: string;
+    maxBytes?: number;
+    maxChars?: number;
+    timeoutMs?: number;
+}
+export declare const webFetchTool: Tool<Args, FetchResult>;
+export {};
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../src/tools/web-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAY,WAAW,EAAE,MAAM,cAAc,CAAC;AAGrD,UAAU,IAAI;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAoChD,CAAC"}