@kilnai/core 0.23.2 → 1.0.0

package/dist/tools/domain/tool.js

@@ -0,0 +1,123 @@
+// Engine domain: developer tool types for Phase 9a (native runtime)
+export const TOOL_SCHEMAS = {
+    bash: {
+        name: "bash",
+        description: "Run a shell command.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                command: { type: "string" },
+                timeout: { type: "number" },
+                cwd: { type: "string" },
+            },
+            required: ["command"],
+        },
+        annotations: {
+            destructive: true,
+        },
+    },
+    read: {
+        name: "read",
+        description: "Read file content from disk.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string" },
+                offset: { type: "number", description: "Line offset to start reading from (0-based)" },
+                limit: { type: "number", description: "Maximum number of lines to read" },
+            },
+            required: ["filePath"],
+        },
+        annotations: {
+            readOnly: true,
+            idempotent: true,
+        },
+    },
+    write: {
+        name: "write",
+        description: "Write full content to a file.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string" },
+                content: { type: "string" },
+            },
+            required: ["filePath", "content"],
+        },
+        annotations: {
+            destructive: true,
+        },
+    },
+    edit: {
+        name: "edit",
+        description: "Replace text content in a file.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                filePath: { type: "string" },
+                oldString: { type: "string" },
+                newString: { type: "string" },
+                replaceAll: { type: "boolean" },
+            },
+            required: ["filePath", "oldString", "newString"],
+        },
+        annotations: {
+            destructive: false,
+        },
+    },
+    grep: {
+        name: "grep",
+        description: "Search file content by pattern.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string" },
+                path: { type: "string" },
+                glob: { type: "string" },
+                outputMode: {
+                    enum: ["content", "files_with_matches", "count"],
+                },
+            },
+            required: ["pattern"],
+        },
+        annotations: {
+            readOnly: true,
+            idempotent: true,
+        },
+    },
+    glob: {
+        name: "glob",
+        description: "Match files by glob pattern.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                pattern: { type: "string" },
+                path: { type: "string" },
+            },
+            required: ["pattern"],
+        },
+        annotations: {
+            readOnly: true,
+            idempotent: true,
+        },
+    },
+    git: {
+        name: "git",
+        description: "Run a git subcommand.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                subcommand: { type: "string" },
+                args: {
+                    type: "array",
+                    items: { type: "string" },
+                },
+            },
+            required: ["subcommand"],
+        },
+        annotations: {
+            destructive: false,
+        },
+    },
+};
+//# sourceMappingURL=tool.js.map

package/dist/tools/domain/tool.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,18 @@
+export type { DevTool, DevToolAnnotations, DevToolName, ToolInput, ToolResult, } from "./domain/tool.js";
+export { TOOL_SCHEMAS } from "./domain/tool.js";
+export { DevToolRegistry } from "./domain/tool-registry.js";
+export type { BinaryInfo, ToolEnvironment, ToolEnvironmentOptions, } from "./domain/tool-environment.js";
+export { clearToolEnvironmentCache, detectToolEnvironment, } from "./domain/tool-environment.js";
+export type { ToolSandboxContext } from "./infrastructure/tool-helpers.js";
+export { BashTool } from "./infrastructure/bash-tool.js";
+export { ReadTool } from "./infrastructure/read-tool.js";
+export { WriteTool } from "./infrastructure/write-tool.js";
+export { EditTool } from "./infrastructure/edit-tool.js";
+export { GrepTool } from "./infrastructure/grep-tool.js";
+export { GlobTool } from "./infrastructure/glob-tool.js";
+export { GitTool } from "./infrastructure/git-tool.js";
+export type { DevToolExecutionBridgeOptions, DevToolAuthorizationDecision, DevToolExecutionRequest, DevToolExecutionResult, } from "./tool-executor.js";
+export { DevToolExecutionBridge } from "./tool-executor.js";
+export type { DevToolsMcpCallResult, DevToolsMcpServerOptions, DevToolsMcpToolSchema, } from "./mcp/dev-tools-server.js";
+export { DevToolsMcpServer } from "./mcp/dev-tools-server.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,YAAY,EACV,UAAU,EACV,eAAe,EACf,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,13 @@
+export { TOOL_SCHEMAS } from "./domain/tool.js";
+export { DevToolRegistry } from "./domain/tool-registry.js";
+export { clearToolEnvironmentCache, detectToolEnvironment, } from "./domain/tool-environment.js";
+export { BashTool } from "./infrastructure/bash-tool.js";
+export { ReadTool } from "./infrastructure/read-tool.js";
+export { WriteTool } from "./infrastructure/write-tool.js";
+export { EditTool } from "./infrastructure/edit-tool.js";
+export { GrepTool } from "./infrastructure/grep-tool.js";
+export { GlobTool } from "./infrastructure/glob-tool.js";
+export { GitTool } from "./infrastructure/git-tool.js";
+export { DevToolExecutionBridge } from "./tool-executor.js";
+export { DevToolsMcpServer } from "./mcp/dev-tools-server.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAO5D,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAOvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAO5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/tools/infrastructure/bash-tool.d.ts

@@ -0,0 +1,20 @@
+import { type DevTool, type ToolInput, type ToolResult } from "../domain/tool.js";
+type BashCommandResult = {
+    readonly stdout: string;
+    readonly stderr: string;
+};
+type BashCommandRunner = (command: string, cwd: string, timeoutMs: number) => Promise<BashCommandResult>;
+export interface BashToolOptions {
+    readonly commandRunner?: BashCommandRunner;
+}
+export declare class BashTool implements DevTool {
+    readonly name = "bash";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: import("../domain/tool.js").DevToolAnnotations;
+    private readonly commandRunner;
+    constructor(options?: BashToolOptions);
+    execute(input: ToolInput, sandbox?: unknown): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=bash-tool.d.ts.map

package/dist/tools/infrastructure/bash-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/bash-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBhG,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,iBAAiB,GAAG,CACvB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;CAC5C;AAED,qBAAa,QAAS,YAAW,OAAO;IACtC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,SAAiC;IACrD,QAAQ,CAAC,WAAW,0BAAiC;IACrD,QAAQ,CAAC,WAAW,iDAAiC;IAErD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;gBAEtC,OAAO,GAAE,eAAoB;IAInC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAuDxE"}

package/dist/tools/infrastructure/bash-tool.js

@@ -0,0 +1,84 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { promisify } from "node:util";
+import { TOOL_SCHEMAS } from "../domain/tool.js";
+import { getSandboxContext, optionalNumber, optionalString, requireString, resolvePath, toErrorResult, toSuccessResult, validateCommand, validateReadPath, } from "./tool-helpers.js";
+const execFile = promisify(execFileCallback);
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 300_000;
+const MAX_BUFFER = 2 * 1024 * 1024;
+export class BashTool {
+    name = "bash";
+    description = TOOL_SCHEMAS.bash.description;
+    inputSchema = TOOL_SCHEMAS.bash.inputSchema;
+    annotations = TOOL_SCHEMAS.bash.annotations;
+    commandRunner;
+    constructor(options = {}) {
+        this.commandRunner = options.commandRunner ?? runBashCommand;
+    }
+    async execute(input, sandbox) {
+        const commandInput = requireString(input, "command");
+        if (!commandInput.ok) {
+            return commandInput.result;
+        }
+        const timeoutInput = parseTimeout(input);
+        if (!timeoutInput.ok) {
+            return toErrorResult(timeoutInput.message);
+        }
+        const sandboxContext = getSandboxContext(sandbox);
+        const cwd = resolvePath(optionalString(input, "cwd") ?? sandboxContext?.cwd ?? process.cwd(), sandbox);
+        // Validate cwd is within sandbox boundaries (read access implies path containment)
+        const cwdError = validateReadPath(cwd, sandbox);
+        if (cwdError) {
+            return toErrorResult(cwdError, { cwd });
+        }
+        const commandError = validateCommand(commandInput.value, cwd, sandbox);
+        if (commandError) {
+            return toErrorResult(commandError, { cwd, command: commandInput.value });
+        }
+        try {
+            const result = await this.commandRunner(commandInput.value, cwd, timeoutInput.value);
+            const output = [result.stdout, result.stderr].filter(Boolean).join("").trim();
+            return toSuccessResult(output, {
+                cwd,
+                command: commandInput.value,
+                timeoutMs: timeoutInput.value,
+            });
+        }
+        catch (error) {
+            const err = error;
+            const message = [err.stderr, err.stdout].filter(Boolean).join("").trim() ||
+                err.message ||
+                "bash command failed";
+            return toErrorResult(message, {
+                cwd,
+                command: commandInput.value,
+                timeoutMs: timeoutInput.value,
+                code: err.code,
+                signal: err.signal,
+            });
+        }
+    }
+}
+function parseTimeout(input) {
+    const timeout = optionalNumber(input, "timeout");
+    if (timeout === undefined) {
+        if (input.input["timeout"] !== undefined) {
+            return { ok: false, message: 'Invalid input: "timeout" must be a finite number' };
+        }
+        return { ok: true, value: DEFAULT_TIMEOUT_MS };
+    }
+    if (timeout <= 0) {
+        return { ok: false, message: 'Invalid input: "timeout" must be > 0' };
+    }
+    return { ok: true, value: Math.min(timeout, MAX_TIMEOUT_MS) };
+}
+async function runBashCommand(command, cwd, timeoutMs) {
+    const { stdout, stderr } = await execFile("bash", ["-c", command], {
+        cwd,
+        timeout: timeoutMs,
+        windowsHide: true,
+        maxBuffer: MAX_BUFFER,
+    });
+    return { stdout, stderr };
+}
+//# sourceMappingURL=bash-tool.js.map

package/dist/tools/infrastructure/bash-tool.js.map

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

package/dist/tools/infrastructure/edit-tool.d.ts

@@ -0,0 +1,9 @@
+import { type DevTool, type ToolInput, type ToolResult } from "../domain/tool.js";
+export declare class EditTool implements DevTool {
+    readonly name = "edit";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: import("../domain/tool.js").DevToolAnnotations;
+    execute(input: ToolInput, sandbox?: unknown): Promise<ToolResult>;
+}
+//# sourceMappingURL=edit-tool.d.ts.map

package/dist/tools/infrastructure/edit-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/edit-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA0ChG,qBAAa,QAAS,YAAW,OAAO;IACtC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,SAAiC;IACrD,QAAQ,CAAC,WAAW,0BAAiC;IACrD,QAAQ,CAAC,WAAW,iDAAiC;IAE/C,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAwDxE"}

package/dist/tools/infrastructure/edit-tool.js

@@ -0,0 +1,80 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { TOOL_SCHEMAS } from "../domain/tool.js";
+import { optionalBoolean, requireString, resolvePath, toErrorResult, toSuccessResult, validateReadPath, validateWritePath, } from "./tool-helpers.js";
+function replaceSingle(source, oldString, newString) {
+    const index = source.indexOf(oldString);
+    if (index < 0) {
+        return { value: source, count: 0 };
+    }
+    const value = `${source.slice(0, index)}${newString}${source.slice(index + oldString.length)}`;
+    return { value, count: 1 };
+}
+function replaceAll(source, oldString, newString) {
+    let count = 0;
+    let cursor = 0;
+    let output = "";
+    while (cursor < source.length) {
+        const match = source.indexOf(oldString, cursor);
+        if (match < 0) {
+            output += source.slice(cursor);
+            break;
+        }
+        output += source.slice(cursor, match);
+        output += newString;
+        cursor = match + oldString.length;
+        count += 1;
+    }
+    return { value: output, count };
+}
+export class EditTool {
+    name = "edit";
+    description = TOOL_SCHEMAS.edit.description;
+    inputSchema = TOOL_SCHEMAS.edit.inputSchema;
+    annotations = TOOL_SCHEMAS.edit.annotations;
+    async execute(input, sandbox) {
+        const filePathInput = requireString(input, "filePath");
+        if (!filePathInput.ok) {
+            return filePathInput.result;
+        }
+        const oldStringInput = requireString(input, "oldString");
+        if (!oldStringInput.ok) {
+            return oldStringInput.result;
+        }
+        const newStringInput = requireString(input, "newString", { allowEmpty: true });
+        if (!newStringInput.ok) {
+            return newStringInput.result;
+        }
+        const absolutePath = resolvePath(filePathInput.value, sandbox);
+        const readError = validateReadPath(absolutePath, sandbox);
+        if (readError) {
+            return toErrorResult(readError, { filePath: absolutePath });
+        }
+        const writeError = validateWritePath(absolutePath, sandbox);
+        if (writeError) {
+            return toErrorResult(writeError, { filePath: absolutePath });
+        }
+        const replaceEveryMatch = optionalBoolean(input, "replaceAll") ?? false;
+        try {
+            const content = await readFile(absolutePath, "utf8");
+            const replacement = replaceEveryMatch
+                ? replaceAll(content, oldStringInput.value, newStringInput.value)
+                : replaceSingle(content, oldStringInput.value, newStringInput.value);
+            if (replacement.count === 0) {
+                return toErrorResult(`No match found for "${oldStringInput.value}"`, {
+                    filePath: absolutePath,
+                });
+            }
+            await writeFile(absolutePath, replacement.value, "utf8");
+            return toSuccessResult(`Applied ${replacement.count} replacement${replacement.count === 1 ? "" : "s"} in ${absolutePath}`, {
+                filePath: absolutePath,
+                replacements: replacement.count,
+                replaceAll: replaceEveryMatch,
+            });
+        }
+        catch (error) {
+            const err = error;
+            return toErrorResult(err.message, { filePath: absolutePath, code: err.code });
+        }
+    }
+}
+//# sourceMappingURL=edit-tool.js.map

package/dist/tools/infrastructure/edit-tool.js.map

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

package/dist/tools/infrastructure/git-tool.d.ts

@@ -0,0 +1,20 @@
+import { type DevTool, type ToolInput, type ToolResult } from "../domain/tool.js";
+type GitCommandResult = {
+    readonly stdout: string;
+    readonly stderr: string;
+};
+type GitCommandRunner = (args: readonly string[], cwd: string, timeoutMs: number) => Promise<GitCommandResult>;
+export interface GitToolOptions {
+    readonly commandRunner?: GitCommandRunner;
+}
+export declare class GitTool implements DevTool {
+    readonly name = "git";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: import("../domain/tool.js").DevToolAnnotations;
+    private readonly commandRunner;
+    constructor(options?: GitToolOptions);
+    execute(input: ToolInput, sandbox?: unknown): Promise<ToolResult>;
+}
+export {};
+//# sourceMappingURL=git-tool.d.ts.map

package/dist/tools/infrastructure/git-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/git-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAehG,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,gBAAgB,GAAG,CACtB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC;CAC3C;AAED,qBAAa,OAAQ,YAAW,OAAO;IACrC,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,SAAgC;IACpD,QAAQ,CAAC,WAAW,0BAAgC;IACpD,QAAQ,CAAC,WAAW,iDAAgC;IAEpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;gBAErC,OAAO,GAAE,cAAmB;IAIlC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAuDxE"}

package/dist/tools/infrastructure/git-tool.js

@@ -0,0 +1,85 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { promisify } from "node:util";
+import { TOOL_SCHEMAS } from "../domain/tool.js";
+import { getSandboxContext, resolvePath, requireString, toErrorResult, toSuccessResult, validateCommand, validateReadPath, } from "./tool-helpers.js";
+const execFile = promisify(execFileCallback);
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_BUFFER = 2 * 1024 * 1024;
+export class GitTool {
+    name = "git";
+    description = TOOL_SCHEMAS.git.description;
+    inputSchema = TOOL_SCHEMAS.git.inputSchema;
+    annotations = TOOL_SCHEMAS.git.annotations;
+    commandRunner;
+    constructor(options = {}) {
+        this.commandRunner = options.commandRunner ?? runGitCommand;
+    }
+    async execute(input, sandbox) {
+        const subcommandInput = requireString(input, "subcommand");
+        if (!subcommandInput.ok) {
+            return subcommandInput.result;
+        }
+        const argsInput = readArgs(input);
+        if (!argsInput.ok) {
+            return toErrorResult(argsInput.message);
+        }
+        const sandboxContext = getSandboxContext(sandbox);
+        const cwd = resolvePath(sandboxContext?.cwd ?? process.cwd(), sandbox);
+        const cwdError = validateReadPath(cwd, sandbox);
+        if (cwdError) {
+            return toErrorResult(cwdError, { cwd });
+        }
+        const commandString = toCommandString(subcommandInput.value, argsInput.value);
+        const commandError = validateCommand(commandString, cwd, sandbox);
+        if (commandError) {
+            return toErrorResult(commandError, { cwd, command: commandString });
+        }
+        const allArgs = [subcommandInput.value, ...argsInput.value];
+        try {
+            const result = await this.commandRunner(allArgs, cwd, DEFAULT_TIMEOUT_MS);
+            const output = [result.stdout, result.stderr].filter(Boolean).join("").trim();
+            return toSuccessResult(output, {
+                cwd,
+                command: commandString,
+            });
+        }
+        catch (error) {
+            const err = error;
+            const message = [err.stderr, err.stdout].filter(Boolean).join("").trim() ||
+                err.message ||
+                "git command failed";
+            return toErrorResult(message, {
+                cwd,
+                command: commandString,
+                code: err.code,
+                signal: err.signal,
+            });
+        }
+    }
+}
+function readArgs(input) {
+    const rawArgs = input.input["args"];
+    if (rawArgs === undefined) {
+        return { ok: true, value: [] };
+    }
+    if (!Array.isArray(rawArgs) || rawArgs.some((value) => typeof value !== "string")) {
+        return { ok: false, message: "Invalid input: \"args\" must be an array of strings" };
+    }
+    return { ok: true, value: [...rawArgs] };
+}
+function toCommandString(subcommand, args) {
+    if (args.length === 0) {
+        return `git ${subcommand}`;
+    }
+    return `git ${subcommand} ${args.join(" ")}`;
+}
+async function runGitCommand(args, cwd, timeoutMs) {
+    const { stdout, stderr } = await execFile("git", args, {
+        cwd,
+        timeout: timeoutMs,
+        windowsHide: true,
+        maxBuffer: MAX_BUFFER,
+    });
+    return { stdout, stderr };
+}
+//# sourceMappingURL=git-tool.js.map

package/dist/tools/infrastructure/git-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tool.js","sourceRoot":"","sources":["../../../src/tools/infrastructure/git-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAiD,MAAM,mBAAmB,CAAC;AAChG,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAC7C,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAiBnC,MAAM,OAAO,OAAO;IACT,IAAI,GAAG,KAAK,CAAC;IACb,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3C,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3C,WAAW,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC;IAEnC,aAAa,CAAmB;IAEjD,YAAY,UAA0B,EAAE;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,aAAa,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,OAAiB;QAC/C,MAAM,eAAe,GAAG,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE,CAAC;YACxB,OAAO,eAAe,CAAC,MAAM,CAAC;QAChC,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,WAAW,CAAC,cAAc,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAEvE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,aAAa,GAAG,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9E,MAAM,YAAY,GAAG,eAAe,CAAC,aAAa,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,aAAa,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;YAC1E,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9E,OAAO,eAAe,CAAC,MAAM,EAAE;gBAC7B,GAAG;gBACH,OAAO,EAAE,aAAa;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAKX,CAAC;YAEF,MAAM,OAAO,GACX,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;gBACxD,GAAG,CAAC,OAAO;gBACX,oBAAoB,CAAC;YAEvB,OAAO,aAAa,CAAC,OAAO,EAAE;gBAC5B,GAAG;gBACH,OAAO,EAAE,aAAa;gBACtB,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAgB;IAChC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QAClF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC;IACvF,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB,EAAE,IAAuB;IAClE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,OAAO,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,OAAO,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,IAAuB,EACvB,GAAW,EACX,SAAiB;IAEjB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE;QACrD,GAAG;QACH,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,UAAU;KACtB,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/tools/infrastructure/glob-tool.d.ts

@@ -0,0 +1,23 @@
+import { type ToolEnvironment } from "../domain/tool-environment.js";
+import { type DevTool, type ToolInput, type ToolResult } from "../domain/tool.js";
+import { type CommandResult } from "./tool-helpers.js";
+type GlobCommandRunner = (binary: string, args: readonly string[], cwd: string, timeoutMs: number) => Promise<CommandResult>;
+type EnvironmentProvider = () => Promise<ToolEnvironment>;
+export interface GlobToolOptions {
+    readonly commandRunner?: GlobCommandRunner;
+    readonly environmentProvider?: EnvironmentProvider;
+}
+export declare class GlobTool implements DevTool {
+    readonly name = "glob";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: import("../domain/tool.js").DevToolAnnotations;
+    private readonly commandRunner;
+    private readonly environmentProvider;
+    constructor(options?: GlobToolOptions);
+    execute(input: ToolInput, sandbox?: unknown): Promise<ToolResult>;
+    private executeFastPath;
+    private executeFallback;
+}
+export {};
+//# sourceMappingURL=glob-tool.d.ts.map

package/dist/tools/infrastructure/glob-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/glob-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,aAAa,EAYnB,MAAM,mBAAmB,CAAC;AAI3B,KAAK,iBAAiB,GAAG,CACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B,KAAK,mBAAmB,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CACpD;AAED,qBAAa,QAAS,YAAW,OAAO;IACtC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,SAAiC;IACrD,QAAQ,CAAC,WAAW,0BAAiC;IACrD,QAAQ,CAAC,WAAW,iDAAiC;IAErD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;gBAE9C,OAAO,GAAE,eAAoB;IAKnC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;YA+BzD,eAAe;YA4Cf,eAAe;CA0B9B"}

package/dist/tools/infrastructure/glob-tool.js

@@ -0,0 +1,88 @@
+import { basename, relative } from "node:path";
+import { detectToolEnvironment, } from "../domain/tool-environment.js";
+import { TOOL_SCHEMAS, } from "../domain/tool.js";
+import { getSandboxContext, matchesGlob, normalizePath, optionalString, requireString, resolvePath, runCommand as defaultRunCommand, toErrorResult, toSuccessResult, validateReadPath, walkFiles, } from "./tool-helpers.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class GlobTool {
+    name = "glob";
+    description = TOOL_SCHEMAS.glob.description;
+    inputSchema = TOOL_SCHEMAS.glob.inputSchema;
+    annotations = TOOL_SCHEMAS.glob.annotations;
+    commandRunner;
+    environmentProvider;
+    constructor(options = {}) {
+        this.commandRunner = options.commandRunner ?? defaultRunCommand;
+        this.environmentProvider = options.environmentProvider ?? detectToolEnvironment;
+    }
+    async execute(input, sandbox) {
+        const patternInput = requireString(input, "pattern");
+        if (!patternInput.ok) {
+            return patternInput.result;
+        }
+        const sandboxContext = getSandboxContext(sandbox);
+        const searchRoot = resolvePath(optionalString(input, "path") ?? sandboxContext?.cwd ?? process.cwd(), sandbox);
+        const rootReadError = validateReadPath(searchRoot, sandbox);
+        if (rootReadError) {
+            return toErrorResult(rootReadError, { path: searchRoot });
+        }
+        try {
+            const environment = await this.environmentProvider();
+            const fdPath = environment.fd?.path;
+            if (fdPath) {
+                return await this.executeFastPath(fdPath, searchRoot, patternInput.value);
+            }
+            return await this.executeFallback(searchRoot, patternInput.value, sandbox);
+        }
+        catch (error) {
+            const err = error;
+            return toErrorResult(err.message, { path: searchRoot });
+        }
+    }
+    async executeFastPath(fdPath, searchRoot, pattern) {
+        const args = ["--glob", "--type", "f", pattern, "."];
+        try {
+            const result = await this.commandRunner(fdPath, args, searchRoot, DEFAULT_TIMEOUT_MS);
+            return toSuccessResult(result.stdout.trim(), {
+                path: searchRoot,
+                strategy: "fd",
+            });
+        }
+        catch (error) {
+            const err = error;
+            if (String(err.code) === "1") {
+                return toSuccessResult("", {
+                    path: searchRoot,
+                    strategy: "fd",
+                    noMatches: true,
+                });
+            }
+            const message = [err.stderr, err.stdout].filter(Boolean).join("").trim() ||
+                err.message ||
+                "fd execution failed";
+            return toErrorResult(message, {
+                path: searchRoot,
+                strategy: "fd",
+            });
+        }
+    }
+    async executeFallback(searchRoot, pattern, sandbox) {
+        const files = await walkFiles(searchRoot);
+        const matches = [];
+        for (const filePath of files) {
+            const readError = validateReadPath(filePath, sandbox);
+            if (readError) {
+                continue;
+            }
+            const relativePath = normalizePath(relative(searchRoot, filePath) || basename(filePath));
+            if (matchesGlob(relativePath, pattern)) {
+                matches.push(relativePath);
+            }
+        }
+        return toSuccessResult(matches.join("\n"), {
+            path: searchRoot,
+            strategy: "fallback",
+            count: matches.length,
+        });
+    }
+}
+//# sourceMappingURL=glob-tool.js.map

package/dist/tools/infrastructure/glob-tool.js.map

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