@poping/yome 0.0.2

package/dist/tools/edit.js

@@ -0,0 +1,103 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { resolve, dirname } from 'path';
+import { isContentAllowed, isContentDenied } from '../permissions/checker.js';
+function buildDiffLines(fileContent, oldStr, newStr, contextLines = 3) {
+    const allLines = fileContent.split('\n');
+    const oldLines = oldStr.split('\n');
+    const newLines = newStr.split('\n');
+    // Find where old_string starts in the file
+    const matchIdx = fileContent.indexOf(oldStr);
+    if (matchIdx < 0)
+        return [];
+    const startLine = fileContent.slice(0, matchIdx).split('\n').length - 1;
+    const result = [];
+    // Context before
+    const ctxStart = Math.max(0, startLine - contextLines);
+    for (let i = ctxStart; i < startLine; i++) {
+        result.push(`@@CTX:${i + 1}:${allLines[i]}`);
+    }
+    // Removed lines
+    for (let i = 0; i < oldLines.length; i++) {
+        result.push(`@@-:${startLine + i + 1}:${oldLines[i]}`);
+    }
+    // Added lines
+    for (let i = 0; i < newLines.length; i++) {
+        result.push(`@@+:${startLine + i + 1}:${newLines[i]}`);
+    }
+    // Context after
+    const afterStart = startLine + oldLines.length;
+    const ctxEnd = Math.min(allLines.length, afterStart + contextLines);
+    for (let i = afterStart; i < ctxEnd; i++) {
+        result.push(`@@CTX:${i + 1}:${allLines[i]}`);
+    }
+    return result;
+}
+export const editTool = {
+    name: 'Edit',
+    description: 'Edit a file by replacing old_string with new_string. The old_string must be unique in the file (or use replace_all). To create a new file, use empty old_string and provide new_string as the full content.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file_path: { type: 'string', description: 'Absolute path to the file to edit' },
+            old_string: { type: 'string', description: 'The exact text to find and replace' },
+            new_string: { type: 'string', description: 'The replacement text' },
+            replace_all: { type: 'boolean', description: 'Replace all occurrences (default: false)' },
+        },
+        required: ['file_path', 'old_string', 'new_string'],
+    },
+    isReadOnly() { return false; },
+    checkPermissions(input, ctx) {
+        const filePath = input.file_path ?? '';
+        if (isContentDenied(ctx, 'Edit', filePath)) {
+            return { behavior: 'deny', message: `Editing denied for: ${filePath}` };
+        }
+        if (isContentAllowed(ctx, 'Edit', filePath)) {
+            return { behavior: 'allow' };
+        }
+        return { behavior: 'passthrough', message: `Allow editing ${filePath}?` };
+    },
+    validateInput(input) {
+        if (typeof input.file_path !== 'string' || !input.file_path.trim()) {
+            return { valid: false, error: 'file_path is required' };
+        }
+        return { valid: true };
+    },
+    getPath(input) { return input.file_path; },
+    async execute(input) {
+        const filePath = resolve(input.file_path);
+        const oldStr = input.old_string;
+        const newStr = input.new_string;
+        const replaceAll = input.replace_all ?? false;
+        if (oldStr === '') {
+            await mkdir(dirname(filePath), { recursive: true });
+            await writeFile(filePath, newStr, 'utf-8');
+            const lines = newStr.split('\n');
+            const diff = lines.map((l, i) => `@@+:${i + 1}:${l}`).join('\n');
+            return `@@FILE:${filePath}\n@@NEW\n${diff}`;
+        }
+        let content;
+        try {
+            content = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            return `Error: File not found: ${filePath}`;
+        }
+        const count = content.split(oldStr).length - 1;
+        if (count === 0) {
+            return `Error: old_string not found in file.`;
+        }
+        if (count > 1 && !replaceAll) {
+            return `Error: Found ${count} matches. Set replace_all=true or provide more context.`;
+        }
+        // Build diff BEFORE writing (need original content for context)
+        const diffLines = buildDiffLines(content, oldStr, newStr);
+        const updated = replaceAll
+            ? content.replaceAll(oldStr, newStr)
+            : content.replace(oldStr, newStr);
+        await writeFile(filePath, updated, 'utf-8');
+        const addCount = newStr.split('\n').length;
+        const rmCount = oldStr.split('\n').length;
+        return `@@FILE:${filePath}\n@@EDIT:+${addCount}:-${rmCount}\n${diffLines.join('\n')}`;
+    },
+};
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

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

package/dist/tools/glob.d.ts

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

package/dist/tools/glob.js

@@ -0,0 +1,44 @@
+import fg from 'fast-glob';
+import { resolve } from 'path';
+export const globTool = {
+    name: 'Glob',
+    description: 'Find files matching a glob pattern. Returns file paths.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pattern: { type: 'string', description: 'Glob pattern to match (e.g. "**/*.ts")' },
+            path: { type: 'string', description: 'Directory to search in (default: cwd)' },
+        },
+        required: ['pattern'],
+    },
+    isReadOnly() { return true; },
+    validateInput(input) {
+        if (typeof input.pattern !== 'string' || !input.pattern.trim()) {
+            return { valid: false, error: 'pattern is required' };
+        }
+        return { valid: true };
+    },
+    getPath(input) { return input.path; },
+    async execute(input) {
+        const pattern = input.pattern;
+        const searchPath = resolve(input.path || process.cwd());
+        const files = await fg(pattern, {
+            cwd: searchPath,
+            ignore: ['**/node_modules/**', '**/.git/**'],
+            dot: true,
+            onlyFiles: true,
+            absolute: false,
+        });
+        files.sort();
+        const limit = 100;
+        const truncated = files.length > limit;
+        const shown = truncated ? files.slice(0, limit) : files;
+        if (shown.length === 0)
+            return 'No files found';
+        let result = `Found ${files.length} file(s)\n${shown.join('\n')}`;
+        if (truncated)
+            result += '\n(Results truncated. Use a more specific pattern.)';
+        return result;
+    },
+};
+//# sourceMappingURL=glob.js.map

package/dist/tools/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/tools/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yDAAyD;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;YAClF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;SAC/E;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,UAAU,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7B,aAAa,CAAC,KAAK;QACjB,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAA0B,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAiB,CAAC;QACxC,MAAM,UAAU,GAAG,OAAO,CAAE,KAAK,CAAC,IAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEpE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;YAC9B,GAAG,EAAE,UAAU;YACf,MAAM,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC;YAC5C,GAAG,EAAE,IAAI;YACT,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAG,CAAC;QAClB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACvC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAExD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,gBAAgB,CAAC;QAEhD,IAAI,MAAM,GAAG,SAAS,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClE,IAAI,SAAS;YAAE,MAAM,IAAI,qDAAqD,CAAC;QAC/E,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/tools/grep.d.ts

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

package/dist/tools/grep.js

@@ -0,0 +1,89 @@
+import { spawn } from 'child_process';
+import { resolve } from 'path';
+function runGrep(args, cwd) {
+    return new Promise((resolveP) => {
+        const proc = spawn(args[0], args.slice(1), {
+            cwd,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 15_000,
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (d) => { stdout += d.toString(); });
+        proc.stderr.on('data', (d) => { stderr += d.toString(); });
+        proc.on('close', (code) => {
+            if (code === 1 && !stdout.trim()) {
+                resolveP('No matches found');
+            }
+            else if (code !== 0 && code !== 1) {
+                resolveP(`Error: ${stderr || `exit code ${code}`}`);
+            }
+            else {
+                resolveP(stdout.trim() || 'No matches found');
+            }
+        });
+        proc.on('error', (err) => {
+            resolveP(`Error: ${err.message}`);
+        });
+    });
+}
+function hasRipgrep() {
+    return new Promise((res) => {
+        const proc = spawn('which', ['rg']);
+        proc.on('close', (code) => res(code === 0));
+        proc.on('error', () => res(false));
+    });
+}
+export const grepTool = {
+    name: 'Grep',
+    description: 'Search file contents using grep (or ripgrep if available). Returns matching lines with file paths.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            pattern: { type: 'string', description: 'Regex pattern to search for' },
+            path: { type: 'string', description: 'File or directory to search in (default: cwd)' },
+            case_insensitive: { type: 'boolean', description: 'Case insensitive search (default: false)' },
+            glob: { type: 'string', description: 'File glob filter (e.g. "*.ts")' },
+        },
+        required: ['pattern'],
+    },
+    isReadOnly() { return true; },
+    validateInput(input) {
+        if (typeof input.pattern !== 'string' || !input.pattern.trim()) {
+            return { valid: false, error: 'pattern is required' };
+        }
+        return { valid: true };
+    },
+    getPath(input) { return input.path; },
+    async execute(input) {
+        const pattern = input.pattern;
+        const searchPath = resolve(input.path || process.cwd());
+        const caseInsensitive = input.case_insensitive;
+        const globFilter = input.glob;
+        // Use array args (no shell interpolation = no injection)
+        const useRg = await hasRipgrep();
+        let args;
+        if (useRg) {
+            args = ['rg', '--hidden', '-n', '--max-columns', '500', '--glob', '!.git', '--glob', '!node_modules'];
+            if (caseInsensitive)
+                args.push('-i');
+            if (globFilter)
+                args.push('--glob', globFilter);
+            args.push(pattern, searchPath);
+        }
+        else {
+            args = ['grep', '-rn'];
+            if (caseInsensitive)
+                args.push('-i');
+            args.push(pattern, searchPath);
+        }
+        const output = await runGrep(args, searchPath);
+        const lines = output.split('\n');
+        const limit = 200;
+        if (lines.length > limit) {
+            return lines.slice(0, limit).join('\n') + `\n\n[Showing ${limit} of ${lines.length} matches]`;
+        }
+        return output;
+    },
+};
+//# sourceMappingURL=grep.js.map

package/dist/tools/grep.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,15 @@
+import type { ToolDef, AnthropicTool } from '../types.js';
+import type { ToolPermissionContext } from '../permissions/types.js';
+export declare const BASE_TOOLS: ToolDef[];
+export declare function registerTool(tool: ToolDef): void;
+export declare function getToolByName(name: string): ToolDef | undefined;
+export declare function getAllTools(): ToolDef[];
+export declare function getAnthropicTools(): AnthropicTool[];
+export declare function setPermissionContext(ctx: ToolPermissionContext): void;
+export declare function getPermissionContext(): ToolPermissionContext | null;
+/**
+ * Register a callback that will be called when a tool requires user approval.
+ * Return true to allow, false to deny.
+ */
+export declare function setAskPermissionHandler(fn: (toolName: string, message: string, input: Record<string, unknown>) => Promise<boolean>): void;
+export declare function executeTool(name: string, input: Record<string, unknown>, signal?: AbortSignal): Promise<string>;

package/dist/tools/index.js

@@ -0,0 +1,99 @@
+import { checkPermission } from '../permissions/checker.js';
+import { readTool } from './read.js';
+import { editTool } from './edit.js';
+import { writeTool } from './write.js';
+import { bashTool } from './bash.js';
+import { globTool } from './glob.js';
+import { grepTool } from './grep.js';
+import { lsTool } from './ls.js';
+const DEFAULT_MAX_RESULT_CHARS = 20_000;
+export const BASE_TOOLS = [
+    readTool,
+    editTool,
+    writeTool,
+    bashTool,
+    globTool,
+    grepTool,
+    lsTool,
+];
+const toolMap = new Map();
+for (const t of BASE_TOOLS)
+    toolMap.set(t.name, t);
+export function registerTool(tool) {
+    toolMap.set(tool.name, tool);
+}
+export function getToolByName(name) {
+    return toolMap.get(name);
+}
+export function getAllTools() {
+    return Array.from(toolMap.values());
+}
+export function getAnthropicTools() {
+    return getAllTools().map((t) => ({
+        name: t.name,
+        description: t.description,
+        input_schema: t.inputSchema,
+    }));
+}
+/** Current permission context — set via setPermissionContext(). */
+let _permCtx = null;
+/** Callback invoked when a tool needs user approval. */
+let _askPermissionFn = null;
+export function setPermissionContext(ctx) {
+    _permCtx = ctx;
+}
+export function getPermissionContext() {
+    return _permCtx;
+}
+/**
+ * Register a callback that will be called when a tool requires user approval.
+ * Return true to allow, false to deny.
+ */
+export function setAskPermissionHandler(fn) {
+    _askPermissionFn = fn;
+}
+export async function executeTool(name, input, signal) {
+    const tool = toolMap.get(name);
+    if (!tool)
+        return `Error: Unknown tool: ${name}`;
+    // Validate input if the tool supports it
+    if (tool.validateInput) {
+        const validation = tool.validateInput(input);
+        if (!validation.valid) {
+            return `Error: ${validation.error}`;
+        }
+    }
+    // Permission check
+    if (_permCtx) {
+        const toolResult = tool.checkPermissions?.(input, _permCtx);
+        const decision = checkPermission(tool.name, tool.isReadOnly(), _permCtx, toolResult ?? undefined);
+        if (decision.behavior === 'deny') {
+            return `Permission denied: ${decision.message}`;
+        }
+        if (decision.behavior === 'ask') {
+            if (_askPermissionFn) {
+                const allowed = await _askPermissionFn(tool.name, decision.message, input);
+                if (!allowed) {
+                    return `Permission denied by user for ${tool.name}.`;
+                }
+            }
+            // If no handler is registered, fall through and allow (default permissive)
+        }
+    }
+    try {
+        let result = await tool.execute(input, signal);
+        // Truncate oversized results
+        const limit = tool.maxResultChars ?? DEFAULT_MAX_RESULT_CHARS;
+        if (result.length > limit) {
+            result = result.slice(0, limit) + `\n\n[Output truncated at ${limit} chars]`;
+        }
+        return result;
+    }
+    catch (err) {
+        if (err.name === 'AbortError') {
+            return `Tool ${name} was cancelled.`;
+        }
+        return `Error executing ${name}: ${err.message}`;
+    }
+}
+//# 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":"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"}

package/dist/tools/ls.d.ts

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

package/dist/tools/ls.js

@@ -0,0 +1,47 @@
+import { readdir, stat } from 'fs/promises';
+import { resolve, join } from 'path';
+export const lsTool = {
+    name: 'LS',
+    description: 'List contents of a directory.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory path to list (default: cwd)' },
+        },
+    },
+    isReadOnly() { return true; },
+    getPath(input) { return input.path; },
+    async execute(input) {
+        const dirPath = resolve(input.path || process.cwd());
+        try {
+            const entries = await readdir(dirPath, { withFileTypes: true });
+            const lines = [];
+            for (const entry of entries) {
+                if (entry.name.startsWith('.') && entry.name !== '.gitignore')
+                    continue;
+                const fullPath = join(dirPath, entry.name);
+                try {
+                    const s = await stat(fullPath);
+                    const size = entry.isDirectory() ? '' : formatSize(s.size);
+                    const type = entry.isDirectory() ? 'd' : '-';
+                    lines.push(`${type}  ${size.padStart(8)}  ${entry.name}${entry.isDirectory() ? '/' : ''}`);
+                }
+                catch {
+                    lines.push(`?           ${entry.name}`);
+                }
+            }
+            return lines.length > 0 ? lines.join('\n') : '(empty directory)';
+        }
+        catch {
+            return `Error: Cannot read directory: ${dirPath}`;
+        }
+    },
+};
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}K`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+}
+//# sourceMappingURL=ls.js.map

package/dist/tools/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../src/tools/ls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGrC,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,IAAI;IACV,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;SAC/E;KACF;IACD,UAAU,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAA0B,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,OAAO,GAAG,OAAO,CAAE,KAAK,CAAC,IAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,MAAM,KAAK,GAAa,EAAE,CAAC;YAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;oBAAE,SAAS;gBACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7F,CAAC;gBAAC,MAAM,CAAC;oBACP,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,iCAAiC,OAAO,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAC;IACrC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAChE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC"}

package/dist/tools/read.d.ts

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

package/dist/tools/read.js

@@ -0,0 +1,52 @@
+import { readFile, stat } from 'fs/promises';
+import { resolve } from 'path';
+function addLineNumbers(content, startLine) {
+    return content
+        .split('\n')
+        .map((line, i) => `${startLine + i}\t${line}`)
+        .join('\n');
+}
+export const readTool = {
+    name: 'Read',
+    description: 'Read the contents of a file. Supports offset and limit for large files.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file_path: { type: 'string', description: 'Absolute path to the file to read' },
+            offset: { type: 'number', description: 'Line number to start reading from (1-based). Default: 1' },
+            limit: { type: 'number', description: 'Maximum number of lines to read. Default: 2000' },
+        },
+        required: ['file_path'],
+    },
+    isReadOnly() { return true; },
+    validateInput(input) {
+        if (typeof input.file_path !== 'string' || !input.file_path.trim()) {
+            return { valid: false, error: 'file_path is required' };
+        }
+        return { valid: true };
+    },
+    getPath(input) { return input.file_path; },
+    async execute(input) {
+        const filePath = resolve(input.file_path);
+        const offset = Math.max(1, input.offset || 1);
+        const limit = input.limit || 2000;
+        try {
+            await stat(filePath);
+        }
+        catch {
+            return `Error: File not found: ${filePath}`;
+        }
+        const raw = await readFile(filePath, 'utf-8');
+        const lines = raw.split('\n');
+        const totalLines = lines.length;
+        const startIdx = offset - 1;
+        const slice = lines.slice(startIdx, startIdx + limit);
+        const numbered = addLineNumbers(slice.join('\n'), offset);
+        let result = numbered;
+        if (startIdx + limit < totalLines) {
+            result += `\n\n[Showing lines ${offset}-${startIdx + limit} of ${totalLines} total]`;
+        }
+        return result;
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,SAAS,cAAc,CAAC,OAAe,EAAE,SAAiB;IACxD,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,yEAAyE;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;YAC/E,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAClG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;SACzF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD,UAAU,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7B,aAAa,CAAC,KAAK;QACjB,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACnE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAC1D,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,SAA+B,CAAC,CAAC,CAAC;IAChE,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAmB,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAG,KAAK,CAAC,MAAiB,IAAI,CAAC,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAI,KAAK,CAAC,KAAgB,IAAI,IAAI,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,0BAA0B,QAAQ,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1D,IAAI,MAAM,GAAG,QAAQ,CAAC;QAEtB,IAAI,QAAQ,GAAG,KAAK,GAAG,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,sBAAsB,MAAM,IAAI,QAAQ,GAAG,KAAK,OAAO,UAAU,SAAS,CAAC;QACvF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/tools/write.d.ts

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

package/dist/tools/write.js

@@ -0,0 +1,46 @@
+import { writeFile, mkdir } from 'fs/promises';
+import { resolve, dirname } from 'path';
+import { isContentAllowed, isContentDenied } from '../permissions/checker.js';
+export const writeTool = {
+    name: 'Write',
+    description: 'Create a new file with the given content. Creates parent directories if needed.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            file_path: { type: 'string', description: 'Absolute path for the new file' },
+            content: { type: 'string', description: 'Content to write to the file' },
+        },
+        required: ['file_path', 'content'],
+    },
+    isReadOnly() { return false; },
+    checkPermissions(input, ctx) {
+        const filePath = input.file_path ?? '';
+        if (isContentDenied(ctx, 'Write', filePath)) {
+            return { behavior: 'deny', message: `Writing denied for: ${filePath}` };
+        }
+        if (isContentAllowed(ctx, 'Write', filePath)) {
+            return { behavior: 'allow' };
+        }
+        return { behavior: 'passthrough', message: `Allow creating ${filePath}?` };
+    },
+    validateInput(input) {
+        if (typeof input.file_path !== 'string' || !input.file_path.trim()) {
+            return { valid: false, error: 'file_path is required' };
+        }
+        if (typeof input.content !== 'string') {
+            return { valid: false, error: 'content is required' };
+        }
+        return { valid: true };
+    },
+    getPath(input) { return input.file_path; },
+    async execute(input) {
+        const filePath = resolve(input.file_path);
+        const content = input.content;
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, content, 'utf-8');
+        const lines = content.split('\n');
+        const diff = lines.map((l, i) => `@@+:${i + 1}:${l}`).join('\n');
+        return `@@FILE:${filePath}\n@@NEW:${lines.length} lines\n${diff}`;
+    },
+};
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAY,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGxC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,iFAAiF;IAC9F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YAC5E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;SACzE;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACnC;IACD,UAAU,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC;IAC9B,gBAAgB,CAAC,KAA8B,EAAE,GAA0B;QACzE,MAAM,QAAQ,GAAI,KAAK,CAAC,SAAoB,IAAI,EAAE,CAAC;QACnD,IAAI,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,QAAQ,EAAE,EAAE,CAAC;QAC1E,CAAC;QACD,IAAI,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,QAAQ,GAAG,EAAE,CAAC;IAC7E,CAAC;IACD,aAAa,CAAC,KAAK;QACjB,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACnE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,SAA+B,CAAC,CAAC,CAAC;IAChE,KAAK,CAAC,OAAO,CAAC,KAAK;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,SAAmB,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAiB,CAAC;QAExC,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO,UAAU,QAAQ,WAAW,KAAK,CAAC,MAAM,WAAW,IAAI,EAAE,CAAC;IACpE,CAAC;CACF,CAAC"}