@yuaone/tools 0.1.0

package/dist/dev-server-manager.js

@@ -0,0 +1,183 @@
+/**
+ * @yuaone/tools — DevServerManager
+ *
+ * Detects framework, starts/stops dev servers, detects port from stdout.
+ */
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createServer } from "node:net";
+import { EventEmitter } from "node:events";
+const FRAMEWORK_DETECTORS = [
+    { key: "next", framework: "nextjs", defaultCommand: "next dev" },
+    { key: "vite", framework: "vite", defaultCommand: "vite" },
+    { key: "react-scripts", framework: "cra", defaultCommand: "react-scripts start" },
+    { key: "astro", framework: "astro", defaultCommand: "astro dev" },
+    { key: "svelte", framework: "svelte", defaultCommand: "vite" },
+];
+const PORT_PATTERNS = [
+    /https?:\/\/(?:localhost|127\.0\.0\.1|0\.0\.0\.0|\[::\]):(\d+)/,
+    /port\s+(\d+)/i,
+    /listening\s+(?:on\s+)?(?:port\s+)?(\d+)/i,
+];
+export class DevServerManager extends EventEmitter {
+    process = null;
+    state = null;
+    async detectFramework(workDir) {
+        try {
+            const raw = await readFile(join(workDir, "package.json"), "utf8");
+            const pkg = JSON.parse(raw);
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            for (const detector of FRAMEWORK_DETECTORS) {
+                if (allDeps[detector.key]) {
+                    const devScript = pkg.scripts?.dev ?? detector.defaultCommand;
+                    return { framework: detector.framework, devCommand: devScript };
+                }
+            }
+            if (pkg.scripts?.dev) {
+                return { framework: "unknown", devCommand: pkg.scripts.dev };
+            }
+            return { framework: "unknown", devCommand: "npm run dev" };
+        }
+        catch {
+            return { framework: "unknown", devCommand: "npm run dev" };
+        }
+    }
+    async isPortInUse(port) {
+        return new Promise((resolve) => {
+            const server = createServer();
+            server.once("error", () => resolve(true));
+            server.once("listening", () => {
+                server.close();
+                resolve(false);
+            });
+            server.listen(port, "127.0.0.1");
+        });
+    }
+    async start(workDir, options) {
+        const { framework, devCommand } = await this.detectFramework(workDir);
+        const command = options?.command ?? devCommand;
+        const timeout = options?.timeout ?? 30_000;
+        const expectedPort = options?.port ?? 3000;
+        if (await this.isPortInUse(expectedPort)) {
+            const state = {
+                framework,
+                command,
+                url: `http://localhost:${expectedPort}`,
+                port: expectedPort,
+                pid: 0,
+                managed: false,
+            };
+            this.state = state;
+            this.emit("started", state);
+            return state;
+        }
+        let pm = "npm";
+        try {
+            await readFile(join(workDir, "pnpm-lock.yaml"), "utf8");
+            pm = "pnpm";
+        }
+        catch {
+            try {
+                await readFile(join(workDir, "yarn.lock"), "utf8");
+                pm = "yarn";
+            }
+            catch {
+                // npm default
+            }
+        }
+        const fullCommand = command.startsWith(pm) ? command : `${pm} run dev`;
+        return new Promise((resolve, reject) => {
+            const [cmd, ...args] = fullCommand.split(/\s+/);
+            this.process = spawn(cmd, args, {
+                cwd: workDir,
+                stdio: ["pipe", "pipe", "pipe"],
+                env: { ...process.env, FORCE_COLOR: "0" },
+                shell: true,
+            });
+            let resolved = false;
+            const timer = setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    const state = {
+                        framework,
+                        command: fullCommand,
+                        url: `http://localhost:${expectedPort}`,
+                        port: expectedPort,
+                        pid: this.process?.pid ?? 0,
+                        managed: true,
+                    };
+                    this.state = state;
+                    this.emit("started", state);
+                    resolve(state);
+                }
+            }, timeout);
+            const handleOutput = (data) => {
+                const text = data.toString();
+                this.emit("stdout", text);
+                if (resolved)
+                    return;
+                for (const pattern of PORT_PATTERNS) {
+                    const match = text.match(pattern);
+                    if (match) {
+                        resolved = true;
+                        clearTimeout(timer);
+                        const port = parseInt(match[1], 10);
+                        const state = {
+                            framework,
+                            command: fullCommand,
+                            url: `http://localhost:${port}`,
+                            port,
+                            pid: this.process?.pid ?? 0,
+                            managed: true,
+                        };
+                        this.state = state;
+                        this.emit("started", state);
+                        resolve(state);
+                        return;
+                    }
+                }
+            };
+            this.process.stdout?.on("data", handleOutput);
+            this.process.stderr?.on("data", (data) => {
+                this.emit("stderr", data.toString());
+                handleOutput(data);
+            });
+            this.process.on("error", (err) => {
+                clearTimeout(timer);
+                if (!resolved) {
+                    resolved = true;
+                    reject(err);
+                }
+                this.emit("error", err);
+            });
+            this.process.on("exit", () => {
+                this.emit("stopped");
+            });
+        });
+    }
+    async stop() {
+        if (this.process && this.state?.managed) {
+            this.process.kill("SIGTERM");
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    this.process?.kill("SIGKILL");
+                    resolve();
+                }, 3000);
+                this.process?.on("exit", () => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+        this.process = null;
+        this.state = null;
+    }
+    getState() {
+        return this.state;
+    }
+    isRunning() {
+        return this.state !== null;
+    }
+}
+//# sourceMappingURL=dev-server-manager.js.map

package/dist/dev-server-manager.js.map

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

package/dist/file-edit.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @yuaone/tools — file_edit tool
+ *
+ * Performs exact string replacement in files.
+ * - old_string must exist in file
+ * - Ambiguity check: if old_string matches multiple times and replace_all=false → error
+ * - Generates unified diff preview
+ * - Fuzzy match suggestion on failure
+ */
+import type { ParameterDef, RiskLevel, ToolResult } from './types.js';
+import { BaseTool } from './base-tool.js';
+export declare class FileEditTool extends BaseTool {
+    readonly name = "file_edit";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+}
+//# sourceMappingURL=file-edit.d.ts.map

package/dist/file-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.d.ts","sourceRoot":"","sources":["../src/file-edit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,SAEyE;IAC7F,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAY;IAEzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAsB/C;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAoGnF"}

package/dist/file-edit.js

@@ -0,0 +1,217 @@
+/**
+ * @yuaone/tools — file_edit tool
+ *
+ * Performs exact string replacement in files.
+ * - old_string must exist in file
+ * - Ambiguity check: if old_string matches multiple times and replace_all=false → error
+ * - Generates unified diff preview
+ * - Fuzzy match suggestion on failure
+ */
+import { readFile, stat, open as fsOpen } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+import { BaseTool } from './base-tool.js';
+import { isSensitiveFile } from './validators.js';
+export class FileEditTool extends BaseTool {
+    name = 'file_edit';
+    description = 'Edit a file by replacing an exact string match. ' +
+        'Fails if old_string is not found or is ambiguous (multiple matches without replace_all).';
+    riskLevel = 'medium';
+    parameters = {
+        path: {
+            type: 'string',
+            description: 'Relative path from project root',
+            required: true,
+        },
+        old_string: {
+            type: 'string',
+            description: 'Exact string to find and replace',
+            required: true,
+        },
+        new_string: {
+            type: 'string',
+            description: 'Replacement string',
+            required: true,
+        },
+        replace_all: {
+            type: 'boolean',
+            description: 'Replace all occurrences (default: false)',
+            required: false,
+            default: false,
+        },
+    };
+    async execute(args, workDir) {
+        const toolCallId = args._toolCallId ?? '';
+        const path = args.path;
+        const oldString = args.old_string;
+        const newString = args.new_string;
+        const replaceAll = args.replace_all ?? false;
+        if (!path)
+            return this.fail(toolCallId, 'Missing required parameter: path');
+        if (oldString === undefined)
+            return this.fail(toolCallId, 'Missing required parameter: old_string');
+        if (newString === undefined)
+            return this.fail(toolCallId, 'Missing required parameter: new_string');
+        let resolvedPath;
+        try {
+            resolvedPath = this.validatePath(path, workDir);
+        }
+        catch (err) {
+            return this.fail(toolCallId, err.message);
+        }
+        // Sensitive file check
+        if (isSensitiveFile(path)) {
+            return this.fail(toolCallId, `Sensitive file detected: "${path}". ` +
+                'Editing credential/secret files is blocked for security.');
+        }
+        // Check file exists
+        try {
+            const s = await stat(resolvedPath);
+            if (s.isDirectory()) {
+                return this.fail(toolCallId, `Path is a directory: ${path}`);
+            }
+        }
+        catch {
+            return this.fail(toolCallId, `File not found: ${path}`);
+        }
+        // Read file
+        let content;
+        try {
+            content = await readFile(resolvedPath, 'utf-8');
+        }
+        catch (err) {
+            return this.fail(toolCallId, `Failed to read file: ${err.message}`);
+        }
+        // Count occurrences
+        const occurrences = countOccurrences(content, oldString);
+        if (occurrences === 0) {
+            // Try fuzzy match suggestion
+            const suggestion = findFuzzyMatch(content, oldString);
+            const msg = suggestion
+                ? `old_string not found in ${path}. Did you mean:\n${suggestion}`
+                : `old_string not found in ${path}. Verify the exact content to replace.`;
+            return this.fail(toolCallId, msg);
+        }
+        if (occurrences > 1 && !replaceAll) {
+            return this.fail(toolCallId, `old_string matches ${occurrences} times in ${path}. ` +
+                'Set replace_all=true to replace all occurrences, ' +
+                'or provide a more specific old_string with surrounding context.');
+        }
+        // Perform replacement
+        const newContent = replaceAll
+            ? content.split(oldString).join(newString)
+            : content.replace(oldString, newString);
+        const replacements = replaceAll ? occurrences : 1;
+        // Generate preview (unified diff style)
+        const preview = generatePreview(content, newContent, path);
+        // Write file using O_NOFOLLOW to prevent symlink TOCTOU attacks
+        try {
+            const fh = await fsOpen(resolvedPath, fsConstants.O_WRONLY | fsConstants.O_TRUNC | fsConstants.O_NOFOLLOW);
+            try {
+                await fh.writeFile(newContent, 'utf-8');
+            }
+            finally {
+                await fh.close();
+            }
+        }
+        catch (err) {
+            const msg = err.code === 'ELOOP'
+                ? `Refusing to edit through symlink: ${path}`
+                : `Failed to write file: ${err.message}`;
+            return this.fail(toolCallId, msg);
+        }
+        return this.ok(toolCallId, `${replacements} replacement(s) in ${path}\n\n${preview}`, { replacements, preview });
+    }
+}
+function countOccurrences(content, search) {
+    let count = 0;
+    let pos = 0;
+    while (true) {
+        const idx = content.indexOf(search, pos);
+        if (idx === -1)
+            break;
+        count++;
+        pos = idx + search.length;
+    }
+    return count;
+}
+/**
+ * Generate a unified-diff-style preview showing changed lines.
+ */
+function generatePreview(oldContent, newContent, filePath) {
+    const oldLines = oldContent.split('\n');
+    const newLines = newContent.split('\n');
+    const diffs = [`--- a/${filePath}`, `+++ b/${filePath}`];
+    // Simple line-by-line diff with context
+    const contextSize = 3;
+    const changedLineIndices = new Set();
+    // Find changed ranges
+    const maxLen = Math.max(oldLines.length, newLines.length);
+    for (let i = 0; i < maxLen; i++) {
+        if (oldLines[i] !== newLines[i]) {
+            for (let c = Math.max(0, i - contextSize); c <= Math.min(maxLen - 1, i + contextSize); c++) {
+                changedLineIndices.add(c);
+            }
+        }
+    }
+    if (changedLineIndices.size === 0)
+        return 'No changes detected.';
+    // Build hunks
+    const sortedIndices = [...changedLineIndices].sort((a, b) => a - b);
+    if (sortedIndices.length === 0)
+        return 'No changes detected.';
+    let hunkStart = sortedIndices[0];
+    let hunkLines = [];
+    for (const idx of sortedIndices) {
+        const oldLine = idx < oldLines.length ? oldLines[idx] : undefined;
+        const newLine = idx < newLines.length ? newLines[idx] : undefined;
+        if (oldLine === newLine) {
+            hunkLines.push(` ${oldLine ?? ''}`);
+        }
+        else {
+            if (oldLine !== undefined)
+                hunkLines.push(`-${oldLine}`);
+            if (newLine !== undefined)
+                hunkLines.push(`+${newLine}`);
+        }
+    }
+    diffs.push(`@@ -${hunkStart + 1} @@`);
+    diffs.push(...hunkLines);
+    // Limit preview size
+    const result = diffs.join('\n');
+    if (result.length > 2000) {
+        return result.slice(0, 2000) + '\n... (preview truncated)';
+    }
+    return result;
+}
+/**
+ * Try to find a fuzzy match in the content when exact match fails.
+ * Returns a suggestion string or null.
+ */
+function findFuzzyMatch(content, search) {
+    // Trim whitespace and try again
+    const trimmed = search.trim();
+    if (trimmed !== search && content.includes(trimmed)) {
+        return `"${trimmed}" (whitespace-trimmed version found)`;
+    }
+    // Try case-insensitive match
+    const lowerContent = content.toLowerCase();
+    const lowerSearch = search.toLowerCase();
+    const idx = lowerContent.indexOf(lowerSearch);
+    if (idx !== -1) {
+        const found = content.slice(idx, idx + search.length);
+        return `"${found}" (case-insensitive match found)`;
+    }
+    // Try first line match
+    const firstLine = search.split('\n')[0].trim();
+    if (firstLine.length > 10) {
+        const lineIdx = content.indexOf(firstLine);
+        if (lineIdx !== -1) {
+            const lineStart = content.lastIndexOf('\n', lineIdx) + 1;
+            const lineEnd = content.indexOf('\n', lineIdx + firstLine.length);
+            const contextEnd = lineEnd === -1 ? content.length : lineEnd;
+            return `First line found at offset ${lineIdx}. Context:\n${content.slice(lineStart, contextEnd)}`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=file-edit.js.map

package/dist/file-edit.js.map

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

package/dist/file-read.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @yuaone/tools — file_read tool
+ *
+ * Reads a file with optional offset/limit.
+ * - 50KB size limit (auto-split guidance on overflow)
+ * - UTF-8 decoding
+ * - Binary file detection and rejection
+ * - Image file base64 conversion
+ */
+import type { ParameterDef, RiskLevel, ToolResult } from './types.js';
+import { BaseTool } from './base-tool.js';
+export declare class FileReadTool extends BaseTool {
+    readonly name = "file_read";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+}
+//# sourceMappingURL=file-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../src/file-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK1C,qBAAa,YAAa,SAAQ,QAAQ;IACxC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,SAE0B;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAgB/C;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAkHnF"}

package/dist/file-read.js

@@ -0,0 +1,142 @@
+/**
+ * @yuaone/tools — file_read tool
+ *
+ * Reads a file with optional offset/limit.
+ * - 50KB size limit (auto-split guidance on overflow)
+ * - UTF-8 decoding
+ * - Binary file detection and rejection
+ * - Image file base64 conversion
+ */
+import { readFile, stat, open as fsOpen } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+import { BaseTool } from './base-tool.js';
+import { isBinaryFile, isImageFile, detectLanguage } from './validators.js';
+const MAX_FILE_SIZE = 50_000; // 50KB
+export class FileReadTool extends BaseTool {
+    name = 'file_read';
+    description = 'Read a file from the project. Returns content with line numbers. ' +
+        'Use offset/limit for large files (>50KB).';
+    riskLevel = 'low';
+    parameters = {
+        path: {
+            type: 'string',
+            description: 'Relative path from project root',
+            required: true,
+        },
+        offset: {
+            type: 'number',
+            description: 'Start line number (1-based)',
+            required: false,
+        },
+        limit: {
+            type: 'number',
+            description: 'Number of lines to read',
+            required: false,
+        },
+    };
+    async execute(args, workDir) {
+        const toolCallId = args._toolCallId ?? '';
+        const path = args.path;
+        if (!path) {
+            return this.fail(toolCallId, 'Missing required parameter: path');
+        }
+        let resolvedPath;
+        try {
+            resolvedPath = this.validatePath(path, workDir);
+        }
+        catch (err) {
+            return this.fail(toolCallId, err.message);
+        }
+        // Check if file exists and get size
+        let fileStat;
+        try {
+            fileStat = await stat(resolvedPath);
+        }
+        catch {
+            return this.fail(toolCallId, `File not found: ${path}`);
+        }
+        if (fileStat.isDirectory()) {
+            return this.fail(toolCallId, `Path is a directory, not a file: ${path}`);
+        }
+        // Image file → base64 (uses O_NOFOLLOW to prevent symlink TOCTOU)
+        if (isImageFile(resolvedPath)) {
+            try {
+                const fh = await fsOpen(resolvedPath, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW);
+                try {
+                    const buf = await fh.readFile();
+                    const b64 = buf.toString('base64');
+                    const language = detectLanguage(resolvedPath);
+                    return this.ok(toolCallId, `[base64 image: ${language}]\n${b64}`, {
+                        totalLines: 0,
+                        language,
+                        truncated: false,
+                    });
+                }
+                finally {
+                    await fh.close();
+                }
+            }
+            catch (err) {
+                const msg = err.code === 'ELOOP'
+                    ? `Refusing to read through symlink: ${path}`
+                    : `Failed to read image: ${err.message}`;
+                return this.fail(toolCallId, msg);
+            }
+        }
+        // Binary file → reject
+        if (await isBinaryFile(resolvedPath)) {
+            return this.fail(toolCallId, `Binary file detected: ${path}. Use a specialized tool or download it directly.`);
+        }
+        // Check size limit (without offset/limit)
+        const offset = args.offset ?? undefined;
+        const limit = args.limit ?? undefined;
+        if (fileStat.size > MAX_FILE_SIZE && offset === undefined && limit === undefined) {
+            const totalLines = await countLines(resolvedPath);
+            return this.fail(toolCallId, `File is ${fileStat.size} bytes (limit: ${MAX_FILE_SIZE}). ` +
+                `Total lines: ${totalLines}. ` +
+                `Use offset and limit parameters to read in chunks.`);
+        }
+        // Read file using O_NOFOLLOW to atomically prevent symlink TOCTOU attacks
+        try {
+            const fh = await fsOpen(resolvedPath, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW);
+            let raw;
+            try {
+                const buf = await fh.readFile();
+                raw = buf.toString('utf-8');
+            }
+            finally {
+                await fh.close();
+            }
+            const allLines = raw.split('\n');
+            const totalLines = allLines.length;
+            // Apply offset/limit
+            const startLine = offset !== undefined ? Math.max(1, offset) : 1;
+            const endLine = limit !== undefined ? startLine + limit - 1 : totalLines;
+            const selectedLines = allLines.slice(startLine - 1, endLine);
+            // Format with line numbers
+            const numbered = selectedLines
+                .map((line, i) => `${String(startLine + i).padStart(6, ' ')}\t${line}`)
+                .join('\n');
+            const truncated = endLine < totalLines || startLine > 1;
+            const language = detectLanguage(resolvedPath);
+            // Check output size after formatting
+            const output = this.truncateOutput(numbered);
+            return this.ok(toolCallId, output, {
+                totalLines,
+                language,
+                truncated,
+            });
+        }
+        catch (err) {
+            const msg = err.code === 'ELOOP'
+                ? `Refusing to read through symlink: ${path}`
+                : `Failed to read file: ${err.message}`;
+            return this.fail(toolCallId, msg);
+        }
+    }
+}
+async function countLines(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    return content.split('\n').length;
+}
+//# sourceMappingURL=file-read.js.map

package/dist/file-read.js.map

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

package/dist/file-write.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @yuaone/tools — file_write tool
+ *
+ * Writes content to a file.
+ * - Auto-creates directories (mkdir -p)
+ * - Backs up existing files before overwrite (.yuan-backup)
+ * - Detects and warns about sensitive files (.env, credentials, etc.)
+ */
+import type { ParameterDef, RiskLevel, ToolResult } from './types.js';
+import { BaseTool } from './base-tool.js';
+export declare class FileWriteTool extends BaseTool {
+    readonly name = "file_write";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+}
+//# sourceMappingURL=file-write.d.ts.map

package/dist/file-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.d.ts","sourceRoot":"","sources":["../src/file-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,SAE0B;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAU;IAEvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAiB/C;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA4GnF"}