@kilnai/core 0.23.2 → 1.0.1

package/dist/tools/infrastructure/grep-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 GrepCommandRunner = (binary: string, args: readonly string[], cwd: string, timeoutMs: number) => Promise<CommandResult>;
+type EnvironmentProvider = () => Promise<ToolEnvironment>;
+export interface GrepToolOptions {
+    readonly commandRunner?: GrepCommandRunner;
+    readonly environmentProvider?: EnvironmentProvider;
+}
+export declare class GrepTool implements DevTool {
+    readonly name = "grep";
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations: import("../domain/tool.js").DevToolAnnotations;
+    private readonly commandRunner;
+    private readonly environmentProvider;
+    constructor(options?: GrepToolOptions);
+    execute(input: ToolInput, sandbox?: unknown): Promise<ToolResult>;
+    private executeFastPath;
+    private executeFallback;
+}
+export {};
+//# sourceMappingURL=grep-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/grep-tool.ts"],"names":[],"mappings":"AAEA,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;AAM3B,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;YAiDzD,eAAe;YAkDf,eAAe;CAkE9B"}

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

@@ -0,0 +1,146 @@
+import { readFile } from "node:fs/promises";
+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 GrepTool {
+    name = "grep";
+    description = TOOL_SCHEMAS.grep.description;
+    inputSchema = TOOL_SCHEMAS.grep.inputSchema;
+    annotations = TOOL_SCHEMAS.grep.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 });
+        }
+        const globFilter = optionalString(input, "glob");
+        const modeValue = optionalString(input, "outputMode");
+        const outputMode = isGrepOutputMode(modeValue) ? modeValue : "content";
+        try {
+            const environment = await this.environmentProvider();
+            const rgPath = environment.rg?.path;
+            if (rgPath) {
+                return await this.executeFastPath(rgPath, searchRoot, patternInput.value, globFilter, outputMode);
+            }
+            return await this.executeFallback(searchRoot, patternInput.value, globFilter, outputMode, sandbox);
+        }
+        catch (error) {
+            const err = error;
+            return toErrorResult(err.message, {
+                path: searchRoot,
+            });
+        }
+    }
+    async executeFastPath(rgPath, searchRoot, pattern, globFilter, outputMode) {
+        const args = buildFastPathArgs(pattern, globFilter, outputMode);
+        try {
+            const result = await this.commandRunner(rgPath, args, searchRoot, DEFAULT_TIMEOUT_MS);
+            return toSuccessResult(result.stdout.trim(), {
+                path: searchRoot,
+                strategy: "rg",
+                outputMode,
+            });
+        }
+        catch (error) {
+            const err = error;
+            if (String(err.code) === "1") {
+                return toSuccessResult("", {
+                    path: searchRoot,
+                    strategy: "rg",
+                    outputMode,
+                    noMatches: true,
+                });
+            }
+            const message = [err.stderr, err.stdout].filter(Boolean).join("").trim() ||
+                err.message ||
+                "rg execution failed";
+            return toErrorResult(message, {
+                path: searchRoot,
+                strategy: "rg",
+            });
+        }
+    }
+    async executeFallback(searchRoot, pattern, globFilter, outputMode, sandbox) {
+        let expression;
+        try {
+            expression = new RegExp(pattern);
+        }
+        catch {
+            return toErrorResult("Invalid input: \"pattern\" must be a valid regular expression");
+        }
+        const files = await walkFiles(searchRoot);
+        const resultsContent = [];
+        const resultsFiles = [];
+        const resultsCount = [];
+        for (const filePath of files) {
+            const readError = validateReadPath(filePath, sandbox);
+            if (readError) {
+                continue;
+            }
+            const relativePath = normalizePath(relative(searchRoot, filePath) || basename(filePath));
+            if (globFilter && !matchesGlob(relativePath, globFilter)) {
+                continue;
+            }
+            const content = await readFile(filePath, "utf8");
+            const lines = content.split(/\r?\n/);
+            let matchedLines = 0;
+            for (let index = 0; index < lines.length; index++) {
+                if (expression.test(lines[index] ?? "")) {
+                    matchedLines += 1;
+                    if (outputMode === "content") {
+                        resultsContent.push(`${relativePath}:${index + 1}:${lines[index] ?? ""}`);
+                    }
+                }
+            }
+            if (matchedLines > 0) {
+                if (outputMode === "files_with_matches") {
+                    resultsFiles.push(relativePath);
+                }
+                else if (outputMode === "count") {
+                    resultsCount.push(`${relativePath}:${matchedLines}`);
+                }
+            }
+        }
+        const output = outputMode === "content"
+            ? resultsContent.join("\n")
+            : outputMode === "files_with_matches"
+                ? resultsFiles.join("\n")
+                : resultsCount.join("\n");
+        return toSuccessResult(output, {
+            path: searchRoot,
+            strategy: "fallback",
+            outputMode,
+        });
+    }
+}
+function isGrepOutputMode(value) {
+    return value === "content" || value === "files_with_matches" || value === "count";
+}
+function buildFastPathArgs(pattern, globFilter, outputMode) {
+    const args = ["--no-heading", "--line-number"];
+    if (globFilter) {
+        args.push("--glob", globFilter);
+    }
+    if (outputMode === "files_with_matches") {
+        args.push("--files-with-matches");
+    }
+    else if (outputMode === "count") {
+        args.push("--count");
+    }
+    args.push(pattern, ".");
+    return args;
+}
+//# sourceMappingURL=grep-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep-tool.js","sourceRoot":"","sources":["../../../src/tools/infrastructure/grep-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,qBAAqB,GAEtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,GAIb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,EACX,UAAU,IAAI,iBAAiB,EAC/B,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAE3B,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAkBlC,MAAM,OAAO,QAAQ;IACV,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5C,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5C,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IAEpC,aAAa,CAAoB;IACjC,mBAAmB,CAAsB;IAE1D,YAAY,UAA2B,EAAE;QACvC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC;QAChE,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,qBAAqB,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,OAAiB;QAC/C,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YACrB,OAAO,YAAY,CAAC,MAAM,CAAC;QAC7B,CAAC;QAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,WAAW,CAC5B,cAAc,CAAC,KAAK,EAAC,MAAM,CAAC,IAAI,cAAc,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EACpE,OAAO,CACR,CAAC;QACF,MAAM,aAAa,GAAG,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,EAAC,MAAM,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAC,YAAY,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC;YAEpC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,IAAI,CAAC,eAAe,CAC/B,MAAM,EACN,UAAU,EACV,YAAY,CAAC,KAAK,EAClB,UAAU,EACV,UAAU,CACX,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,eAAe,CAC/B,UAAU,EACV,YAAY,CAAC,KAAK,EAClB,UAAU,EACV,UAAU,EACV,OAAO,CACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAc,CAAC;YAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE;gBAChC,IAAI,EAAE,UAAU;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,MAAc,EACd,UAAkB,EAClB,OAAe,EACf,UAA8B,EAC9B,UAA0B;QAE1B,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CACrC,MAAM,EACN,IAAI,EACJ,UAAU,EACV,kBAAkB,CACnB,CAAC;YAEF,OAAO,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;gBAC3C,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,IAAI;gBACd,UAAU;aACX,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAIX,CAAC;YAEF,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC7B,OAAO,eAAe,CAAC,EAAE,EAAE;oBACzB,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,IAAI;oBACd,UAAU;oBACV,SAAS,EAAE,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;YAED,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,qBAAqB,CAAC;YAExB,OAAO,aAAa,CAAC,OAAO,EAAE;gBAC5B,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,UAAkB,EAClB,OAAe,EACf,UAA8B,EAC9B,UAA0B,EAC1B,OAAiB;QAEjB,IAAI,UAAkB,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,CAAC,+DAA+D,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzF,IAAI,UAAU,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAErC,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;gBAClD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBACxC,YAAY,IAAI,CAAC,CAAC;oBAElB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC7B,cAAc,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAC5E,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,IAAI,UAAU,KAAK,oBAAoB,EAAE,CAAC;oBACxC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAClC,CAAC;qBAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;oBAClC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,YAAY,EAAE,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GACV,UAAU,KAAK,SAAS;YACtB,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,CAAC,CAAC,UAAU,KAAK,oBAAoB;gBACnC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gBACzB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhC,OAAO,eAAe,CAAC,MAAM,EAAE;YAC7B,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,UAAU;YACpB,UAAU;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,oBAAoB,IAAI,KAAK,KAAK,OAAO,CAAC;AACpF,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAe,EACf,UAA8B,EAC9B,UAA0B;IAE1B,MAAM,IAAI,GAAa,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IACzD,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,UAAU,KAAK,oBAAoB,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/read-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAUhG,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;CAqCxE"}

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

@@ -0,0 +1,45 @@
+import { readFile } from "node:fs/promises";
+import { TOOL_SCHEMAS } from "../domain/tool.js";
+import { optionalNumber, requireString, resolvePath, toErrorResult, toSuccessResult, validateReadPath, } from "./tool-helpers.js";
+export class ReadTool {
+    name = "read";
+    description = TOOL_SCHEMAS.read.description;
+    inputSchema = TOOL_SCHEMAS.read.inputSchema;
+    annotations = TOOL_SCHEMAS.read.annotations;
+    async execute(input, sandbox) {
+        const filePathInput = requireString(input, "filePath");
+        if (!filePathInput.ok) {
+            return filePathInput.result;
+        }
+        const absolutePath = resolvePath(filePathInput.value, sandbox);
+        const readError = validateReadPath(absolutePath, sandbox);
+        if (readError) {
+            return toErrorResult(readError, { filePath: absolutePath });
+        }
+        const offset = optionalNumber(input, "offset") ?? 0;
+        const limit = optionalNumber(input, "limit");
+        if (offset < 0) {
+            return toErrorResult('Invalid input: "offset" must be >= 0');
+        }
+        if (limit !== undefined && limit < 0) {
+            return toErrorResult('Invalid input: "limit" must be >= 0');
+        }
+        try {
+            const content = await readFile(absolutePath, "utf8");
+            const lines = content.split(/\r?\n/);
+            const sliced = limit !== undefined ? lines.slice(offset, offset + limit) : lines.slice(offset);
+            const windowed = sliced.join("\n");
+            return toSuccessResult(windowed, {
+                filePath: absolutePath,
+                offset,
+                limit,
+                totalLines: lines.length,
+            });
+        }
+        catch (error) {
+            const err = error;
+            return toErrorResult(err.message, { filePath: absolutePath, code: err.code });
+        }
+    }
+}
+//# sourceMappingURL=read-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-tool.js","sourceRoot":"","sources":["../../../src/tools/infrastructure/read-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAiD,MAAM,mBAAmB,CAAC;AAChG,OAAO,EACL,cAAc,EACd,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,OAAO,QAAQ;IACV,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5C,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IAC5C,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC;IAErD,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,OAAiB;QAC/C,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;YACtB,OAAO,aAAa,CAAC,MAAM,CAAC;QAC9B,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,SAAS,GAAG,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1D,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,aAAa,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,sCAAsC,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,qCAAqC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/F,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,eAAe,CAAC,QAAQ,EAAE;gBAC/B,QAAQ,EAAE,YAAY;gBACtB,MAAM;gBACN,KAAK;gBACL,UAAU,EAAE,KAAK,CAAC,MAAM;aACzB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAA8B,CAAC;YAC3C,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,37 @@
+import { PathValidator } from "../../sandbox/path-validator.js";
+import { SandboxPolicy } from "../../sandbox/policies.js";
+import type { ToolInput, ToolResult } from "../domain/tool.js";
+export interface ToolSandboxContext {
+    readonly cwd?: string;
+    readonly policy?: SandboxPolicy;
+    readonly pathValidator?: PathValidator;
+}
+export declare function toErrorResult(message: string, metadata?: Record<string, unknown>): ToolResult;
+export declare function toSuccessResult(output: string, metadata?: Record<string, unknown>): ToolResult;
+export declare function getSandboxContext(sandbox?: unknown): ToolSandboxContext | undefined;
+export declare function resolvePath(filePath: string, sandbox?: unknown): string;
+export declare function validateReadPath(filePath: string, sandbox?: unknown): string | undefined;
+export declare function validateWritePath(filePath: string, sandbox?: unknown): string | undefined;
+export declare function requireString(input: ToolInput, key: string, options?: {
+    allowEmpty?: boolean;
+}): {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    result: ToolResult;
+};
+export declare function optionalNumber(input: ToolInput, key: string): number | undefined;
+export declare function optionalString(input: ToolInput, key: string): string | undefined;
+export declare function optionalBoolean(input: ToolInput, key: string): boolean | undefined;
+export declare function validateCommand(command: string, cwd: string, sandbox?: unknown): string | undefined;
+export type CommandResult = {
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export declare function runCommand(binary: string, args: readonly string[], cwd: string, timeoutMs: number): Promise<CommandResult>;
+export declare function walkFiles(rootPath: string): Promise<string[]>;
+export declare function matchesGlob(candidatePath: string, globPattern: string): boolean;
+export declare function globToRegExp(pattern: string): RegExp;
+export declare function normalizePath(value: string): string;
+//# sourceMappingURL=tool-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/tool-helpers.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI/D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAM7F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAM9F;AAED,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAwBnF;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAOvE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQxF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQzF;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GACA;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAejE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOhF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAGlF;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,GAAG,SAAS,CAQpB;AAID,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAQxB;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAInE;AAeD,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAM/E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD"}

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

@@ -0,0 +1,145 @@
+import { execFile as execFileCallback } from "node:child_process";
+import { readdir } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { promisify } from "node:util";
+const execFile = promisify(execFileCallback);
+import { PathValidator } from "../../sandbox/path-validator.js";
+import { SandboxPolicy } from "../../sandbox/policies.js";
+export function toErrorResult(message, metadata) {
+    return {
+        output: message,
+        isError: true,
+        metadata,
+    };
+}
+export function toSuccessResult(output, metadata) {
+    return {
+        output,
+        isError: false,
+        metadata,
+    };
+}
+export function getSandboxContext(sandbox) {
+    if (!sandbox || typeof sandbox !== "object") {
+        return undefined;
+    }
+    const context = sandbox;
+    const policy = context.policy instanceof SandboxPolicy ? context.policy : undefined;
+    const pathValidator = context.pathValidator instanceof PathValidator
+        ? context.pathValidator
+        : policy
+            ? new PathValidator({ policy })
+            : undefined;
+    return {
+        cwd: typeof context.cwd === "string" ? context.cwd : undefined,
+        policy,
+        pathValidator,
+    };
+}
+export function resolvePath(filePath, sandbox) {
+    const context = getSandboxContext(sandbox);
+    if (context?.cwd) {
+        return resolve(context.cwd, filePath);
+    }
+    return resolve(filePath);
+}
+export function validateReadPath(filePath, sandbox) {
+    const context = getSandboxContext(sandbox);
+    if (!context?.pathValidator) {
+        return undefined;
+    }
+    const result = context.pathValidator.validateRead(filePath);
+    return result.allowed ? undefined : result.reason ?? "Read access denied";
+}
+export function validateWritePath(filePath, sandbox) {
+    const context = getSandboxContext(sandbox);
+    if (!context?.pathValidator) {
+        return undefined;
+    }
+    const result = context.pathValidator.validateWrite(filePath);
+    return result.allowed ? undefined : result.reason ?? "Write access denied";
+}
+export function requireString(input, key, options) {
+    const value = input.input[key];
+    const allowEmpty = options?.allowEmpty ?? false;
+    if (typeof value !== "string" || (!allowEmpty && value.length === 0)) {
+        return {
+            ok: false,
+            result: toErrorResult(allowEmpty
+                ? `Invalid input: "${key}" must be a string`
+                : `Invalid input: "${key}" must be a non-empty string`),
+        };
+    }
+    return { ok: true, value };
+}
+export function optionalNumber(input, key) {
+    const value = input.input[key];
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    return undefined;
+}
+export function optionalString(input, key) {
+    const value = input.input[key];
+    return typeof value === "string" ? value : undefined;
+}
+export function optionalBoolean(input, key) {
+    const value = input.input[key];
+    return typeof value === "boolean" ? value : undefined;
+}
+export function validateCommand(command, cwd, sandbox) {
+    const context = getSandboxContext(sandbox);
+    if (!context?.pathValidator) {
+        return undefined;
+    }
+    const result = context.pathValidator.validateExecute(command, cwd);
+    return result.allowed ? undefined : result.reason ?? "Command execution denied";
+}
+export async function runCommand(binary, args, cwd, timeoutMs) {
+    const { stdout, stderr } = await execFile(binary, args, {
+        cwd,
+        timeout: timeoutMs,
+        windowsHide: true,
+        maxBuffer: 2 * 1024 * 1024,
+    });
+    return { stdout, stderr };
+}
+export async function walkFiles(rootPath) {
+    const out = [];
+    await walk(rootPath, out);
+    return out;
+}
+async function walk(currentPath, out) {
+    const entries = await readdir(currentPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        const fullPath = `${currentPath}/${entry.name}`;
+        if (entry.isDirectory()) {
+            await walk(fullPath, out);
+            continue;
+        }
+        if (entry.isFile())
+            out.push(fullPath);
+    }
+}
+export function matchesGlob(candidatePath, globPattern) {
+    const normalizedPath = normalizePath(candidatePath);
+    const normalizedPattern = normalizePath(globPattern);
+    const matcher = globToRegExp(normalizedPattern);
+    if (normalizedPattern.includes("/"))
+        return matcher.test(normalizedPath);
+    return matcher.test(basename(normalizedPath));
+}
+export function globToRegExp(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    const withDoubleStar = escaped.replace(/\*\*/g, "::DOUBLE_STAR::");
+    const withSingleStar = withDoubleStar.replace(/\*/g, "[^/]*");
+    const withQuestion = withSingleStar.replace(/\?/g, ".");
+    const source = withQuestion.replace(/::DOUBLE_STAR::/g, ".*");
+    return new RegExp(`^${source}$`);
+}
+export function normalizePath(value) {
+    return value.replace(/\\/g, "/");
+}
+//# sourceMappingURL=tool-helpers.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/write-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAShG,qBAAa,SAAU,YAAW,OAAO;IACvC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,WAAW,SAAkC;IACtD,QAAQ,CAAC,WAAW,0BAAkC;IACtD,QAAQ,CAAC,WAAW,iDAAkC;IAEhD,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;CAiCxE"}

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

@@ -0,0 +1,38 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { TOOL_SCHEMAS } from "../domain/tool.js";
+import { requireString, resolvePath, toErrorResult, toSuccessResult, validateWritePath, } from "./tool-helpers.js";
+export class WriteTool {
+    name = "write";
+    description = TOOL_SCHEMAS.write.description;
+    inputSchema = TOOL_SCHEMAS.write.inputSchema;
+    annotations = TOOL_SCHEMAS.write.annotations;
+    async execute(input, sandbox) {
+        const filePathInput = requireString(input, "filePath");
+        if (!filePathInput.ok) {
+            return filePathInput.result;
+        }
+        const contentInput = requireString(input, "content", { allowEmpty: true });
+        if (!contentInput.ok) {
+            return contentInput.result;
+        }
+        const absolutePath = resolvePath(filePathInput.value, sandbox);
+        const writeError = validateWritePath(absolutePath, sandbox);
+        if (writeError) {
+            return toErrorResult(writeError, { filePath: absolutePath });
+        }
+        try {
+            await mkdir(dirname(absolutePath), { recursive: true });
+            await writeFile(absolutePath, contentInput.value, "utf8");
+            return toSuccessResult(`Wrote ${contentInput.value.length} characters to ${absolutePath}`, {
+                filePath: absolutePath,
+                bytesWritten: Buffer.byteLength(contentInput.value, "utf8"),
+            });
+        }
+        catch (error) {
+            const err = error;
+            return toErrorResult(err.message, { filePath: absolutePath, code: err.code });
+        }
+    }
+}
+//# sourceMappingURL=write-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-tool.js","sourceRoot":"","sources":["../../../src/tools/infrastructure/write-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAiD,MAAM,mBAAmB,CAAC;AAChG,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,OAAO,SAAS;IACX,IAAI,GAAG,OAAO,CAAC;IACf,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC;IAC7C,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC;IAC7C,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC;IAEtD,KAAK,CAAC,OAAO,CAAC,KAAgB,EAAE,OAAiB;QAC/C,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;YACtB,OAAO,aAAa,CAAC,MAAM,CAAC;QAC9B,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;YACrB,OAAO,YAAY,CAAC,MAAM,CAAC;QAC7B,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAE1D,OAAO,eAAe,CACpB,SAAS,YAAY,CAAC,KAAK,CAAC,MAAM,kBAAkB,YAAY,EAAE,EAClE;gBACE,QAAQ,EAAE,YAAY;gBACtB,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC;aAC5D,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAA8B,CAAC;YAC3C,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;CACF"}

package/dist/tools/mcp/dev-tools-server.d.ts

@@ -0,0 +1,37 @@
+import { DevToolExecutionBridge } from "../tool-executor.js";
+interface McpServerInstance {
+    setRequestHandler(schema: unknown, handler: (request: {
+        params: Record<string, unknown>;
+    }) => unknown): void;
+}
+export interface DevToolsMcpServerOptions {
+    readonly bridge: DevToolExecutionBridge;
+}
+export interface DevToolsMcpToolSchema {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+}
+export interface DevToolsMcpCallResult {
+    readonly content: readonly {
+        type: "text";
+        text: string;
+    }[];
+    readonly isError?: boolean;
+}
+export declare class DevToolsMcpServer {
+    private readonly bridge;
+    private sdk;
+    private sdkPromise;
+    constructor(options: DevToolsMcpServerOptions);
+    initialize(): Promise<void>;
+    close(): void;
+    listTools(): readonly DevToolsMcpToolSchema[];
+    callTool(name: string, args?: Record<string, unknown>): Promise<DevToolsMcpCallResult>;
+    createServer(): McpServerInstance;
+    private jsonResult;
+    private errorResult;
+    private formatErrorMessage;
+}
+export {};
+//# sourceMappingURL=dev-tools-server.d.ts.map

package/dist/tools/mcp/dev-tools-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-tools-server.d.ts","sourceRoot":"","sources":["../../../src/tools/mcp/dev-tools-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAK7D,UAAU,iBAAiB;IACzB,iBAAiB,CACf,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,GACjE,IAAI,CAAC;CACT;AAsBD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,UAAU,CAAkC;gBAExC,OAAO,EAAE,wBAAwB;IAIvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,SAAS,qBAAqB,EAAE;IAQvC,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,qBAAqB,CAAC;IAqBjC,YAAY,IAAI,iBAAiB;IA6BjC,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/tools/mcp/dev-tools-server.js

@@ -0,0 +1,94 @@
+import { KilnError } from "../../engine/errors.js";
+import { TOOL_SCHEMAS } from "../domain/tool.js";
+const SERVER_NAME = "kilnai-dev-tools";
+const SERVER_VERSION = "0.1.0";
+function loadSdkModules() {
+    return Promise.all([
+        import("@modelcontextprotocol/sdk/server/index.js"),
+        import("@modelcontextprotocol/sdk/types.js"),
+    ]).then(([serverModule, typesModule]) => ({
+        Server: serverModule.Server,
+        ListToolsRequestSchema: typesModule.ListToolsRequestSchema,
+        CallToolRequestSchema: typesModule.CallToolRequestSchema,
+    }));
+}
+export class DevToolsMcpServer {
+    bridge;
+    sdk;
+    sdkPromise;
+    constructor(options) {
+        this.bridge = options.bridge;
+    }
+    async initialize() {
+        this.sdkPromise ??= loadSdkModules();
+        try {
+            this.sdk = await this.sdkPromise;
+        }
+        catch (error) {
+            this.sdkPromise = undefined;
+            throw error;
+        }
+    }
+    close() {
+        this.sdk = undefined;
+    }
+    listTools() {
+        return Object.values(TOOL_SCHEMAS).map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }));
+    }
+    async callTool(name, args = {}) {
+        try {
+            const execution = await this.bridge.execute({
+                name,
+                input: args,
+            });
+            if (execution.result.isError) {
+                return this.errorResult(execution.result.output);
+            }
+            return this.jsonResult({
+                result: execution.result,
+                attempts: execution.attempts,
+                fallbackUsed: execution.fallbackUsed,
+            });
+        }
+        catch (error) {
+            return this.errorResult(this.formatErrorMessage(error));
+        }
+    }
+    createServer() {
+        if (!this.sdk) {
+            throw new Error("Dev tools MCP server not initialized");
+        }
+        const { Server, ListToolsRequestSchema, CallToolRequestSchema } = this.sdk;
+        const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+        server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: this.listTools(),
+        }));
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const params = request.params;
+            return this.callTool(params.name, params.arguments ?? {});
+        });
+        return server;
+    }
+    jsonResult(data) {
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    }
+    errorResult(message) {
+        return {
+            content: [{ type: "text", text: message }],
+            isError: true,
+        };
+    }
+    formatErrorMessage(error) {
+        if (error instanceof KilnError) {
+            return `${error.code}: ${error.message}`;
+        }
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+//# sourceMappingURL=dev-tools-server.js.map