@yuaone/tools 0.1.0

package/dist/file-write.js

@@ -0,0 +1,139 @@
+/**
+ * @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 { readFile, mkdir, stat, copyFile, open as fsOpen } from 'node:fs/promises';
+import { constants as fsConstants } from 'node:fs';
+import { dirname } from 'node:path';
+import { BaseTool } from './base-tool.js';
+import { isSensitiveFile } from './validators.js';
+export class FileWriteTool extends BaseTool {
+    name = 'file_write';
+    description = 'Write content to a file. Creates directories automatically. ' +
+        'Backs up existing files before overwrite.';
+    riskLevel = 'high';
+    parameters = {
+        path: {
+            type: 'string',
+            description: 'Relative path from project root',
+            required: true,
+        },
+        content: {
+            type: 'string',
+            description: 'File content to write',
+            required: true,
+        },
+        createDirectories: {
+            type: 'boolean',
+            description: 'Auto-create intermediate directories (default: true)',
+            required: false,
+            default: true,
+        },
+    };
+    async execute(args, workDir) {
+        const toolCallId = args._toolCallId ?? '';
+        const path = args.path;
+        const content = args.content;
+        const createDirectories = args.createDirectories ?? true;
+        if (!path) {
+            return this.fail(toolCallId, 'Missing required parameter: path');
+        }
+        if (content === undefined || content === null) {
+            return this.fail(toolCallId, 'Missing required parameter: content');
+        }
+        let resolvedPath;
+        try {
+            resolvedPath = this.validatePath(path, workDir);
+        }
+        catch (err) {
+            return this.fail(toolCallId, err.message);
+        }
+        // Sensitive file warning
+        if (isSensitiveFile(path)) {
+            return this.fail(toolCallId, `Sensitive file detected: "${path}". ` +
+                'Writing to credential/secret files is blocked for security.');
+        }
+        // Write size limit (10MB)
+        const contentStr = String(content);
+        const MAX_WRITE_SIZE = 10 * 1024 * 1024;
+        if (Buffer.byteLength(contentStr, 'utf-8') > MAX_WRITE_SIZE) {
+            return this.fail(toolCallId, `Content exceeds maximum write size (10MB)`);
+        }
+        // Check if file already exists
+        let existed = false;
+        try {
+            const s = await stat(resolvedPath);
+            if (s.isDirectory()) {
+                return this.fail(toolCallId, `Path is a directory: ${path}`);
+            }
+            existed = true;
+        }
+        catch {
+            // File doesn't exist — will be created
+        }
+        // Create directories if needed
+        if (createDirectories) {
+            try {
+                await mkdir(dirname(resolvedPath), { recursive: true });
+            }
+            catch (err) {
+                return this.fail(toolCallId, `Failed to create directories: ${err.message}`);
+            }
+        }
+        // Backup existing file
+        if (existed) {
+            try {
+                const backupPath = resolvedPath + '.yuan-backup';
+                await copyFile(resolvedPath, backupPath);
+            }
+            catch {
+                // Best-effort backup — don't block write on backup failure
+            }
+        }
+        // Write file using O_NOFOLLOW to atomically prevent symlink TOCTOU attacks.
+        // This eliminates the race window between symlink check and write.
+        try {
+            const flags = existed
+                ? fsConstants.O_WRONLY | fsConstants.O_TRUNC | fsConstants.O_NOFOLLOW
+                : fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_TRUNC | fsConstants.O_NOFOLLOW;
+            const fh = await fsOpen(resolvedPath, flags, 0o644);
+            try {
+                await fh.writeFile(contentStr, 'utf-8');
+            }
+            finally {
+                await fh.close();
+            }
+            const bytesWritten = Buffer.byteLength(contentStr, 'utf-8');
+            let output = existed
+                ? `File overwritten: ${path} (${bytesWritten} bytes, backup created)`
+                : `File created: ${path} (${bytesWritten} bytes)`;
+            // If the file existed, show a brief diff hint
+            if (existed) {
+                try {
+                    const originalContent = await readFile(resolvedPath + '.yuan-backup', 'utf-8');
+                    const origLines = originalContent.split('\n').length;
+                    const newLines = contentStr.split('\n').length;
+                    output += `\nPrevious: ${origLines} lines → New: ${newLines} lines`;
+                }
+                catch {
+                    // Backup read failed — skip diff info
+                }
+            }
+            return this.ok(toolCallId, output, {
+                bytesWritten,
+                created: !existed,
+            });
+        }
+        catch (err) {
+            const msg = err.code === 'ELOOP'
+                ? `Refusing to write through symlink: ${path}`
+                : `Failed to write file: ${err.message}`;
+            return this.fail(toolCallId, msg);
+        }
+    }
+}
+//# sourceMappingURL=file-write.js.map

package/dist/file-write.js.map

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

package/dist/git-ops.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @yuaone/tools — git_ops tool
+ *
+ * Git operations: status, diff, log, add, commit, create_branch, stash, restore.
+ * - commit/create_branch require approval (riskLevel dynamically elevated)
+ * - Uses execFile (no shell interpretation)
+ */
+import type { ParameterDef, RiskLevel, ToolResult } from './types.js';
+import { BaseTool } from './base-tool.js';
+export declare class GitOpsTool extends BaseTool {
+    readonly name = "git_ops";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+    private gitStatus;
+    private gitDiff;
+    private gitLog;
+    private gitAdd;
+    private gitCommit;
+    private gitCreateBranch;
+    private gitStash;
+    private gitRestore;
+}
+//# sourceMappingURL=git-ops.d.ts.map

package/dist/git-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../src/git-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK1C,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,SAE2C;IAC/D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAY;IAEzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CA6B/C;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAuCpE,SAAS;YAMT,OAAO;YAqBP,MAAM;YAUN,MAAM;YAuCN,SAAS;YA0BT,eAAe;YAcf,QAAQ;YAUR,UAAU;CAkBzB"}

package/dist/git-ops.js

@@ -0,0 +1,219 @@
+/**
+ * @yuaone/tools — git_ops tool
+ *
+ * Git operations: status, diff, log, add, commit, create_branch, stash, restore.
+ * - commit/create_branch require approval (riskLevel dynamically elevated)
+ * - Uses execFile (no shell interpretation)
+ */
+import { execFile } from 'node:child_process';
+import { BaseTool } from './base-tool.js';
+import { validatePath, isSensitiveFile } from './validators.js';
+const GIT_TIMEOUT = 15_000; // 15s
+export class GitOpsTool extends BaseTool {
+    name = 'git_ops';
+    description = 'Perform git operations: status, diff, log, add, commit, create_branch, stash, restore. ' +
+        'commit and create_branch operations require user approval.';
+    riskLevel = 'medium';
+    parameters = {
+        operation: {
+            type: 'string',
+            description: 'Git operation to perform',
+            required: true,
+            enum: ['status', 'diff', 'log', 'add', 'commit', 'create_branch', 'stash', 'restore'],
+        },
+        message: {
+            type: 'string',
+            description: 'Commit message (required for commit operation)',
+            required: false,
+        },
+        files: {
+            type: 'array',
+            description: 'Files to add/commit (default: all changed files for add)',
+            required: false,
+            items: { type: 'string', description: 'File path' },
+        },
+        count: {
+            type: 'number',
+            description: 'Number of log entries (default: 10, for log operation)',
+            required: false,
+            default: 10,
+        },
+        branch: {
+            type: 'string',
+            description: 'Branch name (for create_branch operation)',
+            required: false,
+        },
+    };
+    async execute(args, workDir) {
+        const toolCallId = args._toolCallId ?? '';
+        const operation = args.operation;
+        if (!operation) {
+            return this.fail(toolCallId, 'Missing required parameter: operation');
+        }
+        const validOps = ['status', 'diff', 'log', 'add', 'commit', 'create_branch', 'stash', 'restore'];
+        if (!validOps.includes(operation)) {
+            return this.fail(toolCallId, `Invalid operation: ${operation}. Must be one of: ${validOps.join(', ')}`);
+        }
+        try {
+            switch (operation) {
+                case 'status':
+                    return await this.gitStatus(toolCallId, workDir);
+                case 'diff':
+                    return await this.gitDiff(toolCallId, workDir);
+                case 'log':
+                    return await this.gitLog(toolCallId, workDir, args.count ?? 10);
+                case 'add':
+                    return await this.gitAdd(toolCallId, workDir, args.files);
+                case 'commit':
+                    return await this.gitCommit(toolCallId, workDir, args.message, args.files);
+                case 'create_branch':
+                    return await this.gitCreateBranch(toolCallId, workDir, args.branch);
+                case 'stash':
+                    return await this.gitStash(toolCallId, workDir, args.message);
+                case 'restore':
+                    return await this.gitRestore(toolCallId, workDir, args.files);
+                default:
+                    return this.fail(toolCallId, `Unknown operation: ${operation}`);
+            }
+        }
+        catch (err) {
+            return this.fail(toolCallId, `Git operation failed: ${err.message}`);
+        }
+    }
+    async gitStatus(toolCallId, cwd) {
+        const result = await runGit(['status', '--porcelain', '-u'], cwd);
+        const output = result.stdout || '(clean working tree)';
+        return this.ok(toolCallId, output, { operation: 'status' });
+    }
+    async gitDiff(toolCallId, cwd) {
+        // Show both staged and unstaged changes
+        const [unstaged, staged] = await Promise.all([
+            runGit(['diff'], cwd),
+            runGit(['diff', '--cached'], cwd),
+        ]);
+        let output = '';
+        if (staged.stdout) {
+            output += `[Staged changes]\n${staged.stdout}\n`;
+        }
+        if (unstaged.stdout) {
+            output += `[Unstaged changes]\n${unstaged.stdout}\n`;
+        }
+        if (!output) {
+            output = '(no changes)';
+        }
+        return this.ok(toolCallId, output, { operation: 'diff' });
+    }
+    async gitLog(toolCallId, cwd, count) {
+        const safeCount = Math.min(Math.max(1, count), 50);
+        const result = await runGit(['log', `--max-count=${safeCount}`, '--oneline', '--decorate'], cwd);
+        const output = result.stdout || '(no commits)';
+        return this.ok(toolCallId, output, { operation: 'log' });
+    }
+    async gitAdd(toolCallId, cwd, files) {
+        const gitArgs = ['add'];
+        if (files && files.length > 0) {
+            // Validate each file path
+            for (const f of files) {
+                try {
+                    validatePath(f, cwd);
+                }
+                catch (err) {
+                    return this.fail(toolCallId, err.message);
+                }
+            }
+            gitArgs.push('--', ...files);
+        }
+        else {
+            gitArgs.push('-A');
+        }
+        await runGit(gitArgs, cwd);
+        // Warn about sensitive files when using -A
+        if (!files || files.length === 0) {
+            const statusResult = await runGit(['status', '--porcelain', '-u'], cwd);
+            const stagedFiles = statusResult.stdout.split('\n').filter(Boolean);
+            const sensitiveFiles = stagedFiles
+                .map((line) => line.slice(3).trim())
+                .filter((f) => isSensitiveFile(f));
+            if (sensitiveFiles.length > 0) {
+                return this.ok(toolCallId, `Files staged.\n${statusResult.stdout}\n\n⚠️ WARNING: Sensitive files staged: ${sensitiveFiles.join(', ')}. Consider unstaging them before commit.`, { operation: 'add', sensitiveFiles });
+            }
+            return this.ok(toolCallId, `Files staged.\n${statusResult.stdout}`, { operation: 'add' });
+        }
+        const statusResult = await runGit(['status', '--porcelain', '-u'], cwd);
+        return this.ok(toolCallId, `Files staged.\n${statusResult.stdout}`, { operation: 'add' });
+    }
+    async gitCommit(toolCallId, cwd, message, files) {
+        if (!message) {
+            return this.fail(toolCallId, 'Missing required parameter: message (for commit operation)');
+        }
+        // If specific files provided, validate paths and add them first
+        if (files && files.length > 0) {
+            for (const f of files) {
+                try {
+                    validatePath(f, cwd);
+                }
+                catch (err) {
+                    return this.fail(toolCallId, err.message);
+                }
+            }
+            await runGit(['add', '--', ...files], cwd);
+        }
+        const result = await runGit(['commit', '-m', message], cwd);
+        return this.ok(toolCallId, result.stdout || 'Commit created.', { operation: 'commit' });
+    }
+    async gitCreateBranch(toolCallId, cwd, branch) {
+        if (!branch) {
+            return this.fail(toolCallId, 'Missing required parameter: branch (for create_branch operation)');
+        }
+        // Validate branch name: no spaces, no shell metacharacters
+        if (!/^[a-zA-Z0-9._\-/]+$/.test(branch)) {
+            return this.fail(toolCallId, `Invalid branch name: "${branch}". Use alphanumeric, dots, hyphens, underscores, and slashes only.`);
+        }
+        const result = await runGit(['checkout', '-b', branch], cwd);
+        return this.ok(toolCallId, result.stdout || `Branch "${branch}" created and checked out.`, { operation: 'create_branch' });
+    }
+    async gitStash(toolCallId, cwd, message) {
+        const gitArgs = ['stash', 'push'];
+        if (message) {
+            gitArgs.push('-m', message);
+        }
+        const result = await runGit(gitArgs, cwd);
+        return this.ok(toolCallId, result.stdout || 'Changes stashed.', { operation: 'stash' });
+    }
+    async gitRestore(toolCallId, cwd, files) {
+        const gitArgs = ['restore'];
+        if (files && files.length > 0) {
+            // Validate each file path to prevent argument injection
+            for (const f of files) {
+                try {
+                    validatePath(f, cwd);
+                }
+                catch (err) {
+                    return this.fail(toolCallId, err.message);
+                }
+            }
+            gitArgs.push('--', ...files);
+        }
+        else {
+            gitArgs.push('.');
+        }
+        const result = await runGit(gitArgs, cwd);
+        return this.ok(toolCallId, result.stdout || 'Files restored.', { operation: 'restore' });
+    }
+}
+function runGit(args, cwd) {
+    return new Promise((resolve, reject) => {
+        execFile('git', args, { cwd, timeout: GIT_TIMEOUT, maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error && !stdout && !stderr) {
+                reject(error);
+                return;
+            }
+            resolve({
+                stdout: String(stdout ?? '').trim(),
+                stderr: String(stderr ?? '').trim(),
+                exitCode: error ? (typeof error.code === 'number' ? error.code : 1) : 0,
+            });
+        });
+    });
+}
+//# sourceMappingURL=git-ops.js.map

package/dist/git-ops.js.map

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

package/dist/glob.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @yuaone/tools — glob tool
+ *
+ * Finds files matching glob patterns.
+ * - Uses fast-glob for performance
+ * - Auto-excludes node_modules, .git
+ * - Max 100 results by default
+ */
+import type { ParameterDef, RiskLevel, ToolResult } from './types.js';
+import { BaseTool } from './base-tool.js';
+export declare class GlobTool extends BaseTool {
+    readonly name = "glob";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+}
+//# sourceMappingURL=glob.d.ts.map

package/dist/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,SAEiC;IACrD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,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;CA0DnF"}

package/dist/glob.js

@@ -0,0 +1,91 @@
+/**
+ * @yuaone/tools — glob tool
+ *
+ * Finds files matching glob patterns.
+ * - Uses fast-glob for performance
+ * - Auto-excludes node_modules, .git
+ * - Max 100 results by default
+ */
+import fg from 'fast-glob';
+import { BaseTool } from './base-tool.js';
+const DEFAULT_MAX_RESULTS = 100;
+export class GlobTool extends BaseTool {
+    name = 'glob';
+    description = 'Find files matching a glob pattern. ' +
+        'Auto-excludes node_modules and .git directories.';
+    riskLevel = 'low';
+    parameters = {
+        pattern: {
+            type: 'string',
+            description: 'Glob pattern (e.g., "src/**/*.tsx", "**/*.test.ts")',
+            required: true,
+        },
+        path: {
+            type: 'string',
+            description: 'Base directory relative to project root (default: project root)',
+            required: false,
+        },
+        maxResults: {
+            type: 'number',
+            description: `Maximum results (default: ${DEFAULT_MAX_RESULTS})`,
+            required: false,
+            default: DEFAULT_MAX_RESULTS,
+        },
+    };
+    async execute(args, workDir) {
+        const toolCallId = args._toolCallId ?? '';
+        const pattern = args.pattern;
+        const basePath = args.path;
+        const maxResults = args.maxResults ?? DEFAULT_MAX_RESULTS;
+        if (!pattern) {
+            return this.fail(toolCallId, 'Missing required parameter: pattern');
+        }
+        // Resolve base directory
+        let cwd = workDir;
+        if (basePath) {
+            try {
+                cwd = this.validatePath(basePath, workDir);
+            }
+            catch (err) {
+                return this.fail(toolCallId, err.message);
+            }
+        }
+        try {
+            const allFiles = await fg(pattern, {
+                cwd,
+                ignore: [
+                    '**/node_modules/**',
+                    '**/.git/**',
+                    '**/dist/**',
+                    '**/build/**',
+                    '**/.next/**',
+                    '**/coverage/**',
+                ],
+                onlyFiles: true,
+                followSymbolicLinks: false,
+            });
+            const totalMatches = allFiles.length;
+            const truncated = totalMatches > maxResults;
+            const files = allFiles.slice(0, maxResults);
+            let output;
+            if (files.length === 0) {
+                output = `No files found matching pattern: ${pattern}`;
+            }
+            else {
+                output = files.join('\n');
+                if (truncated) {
+                    output += `\n\n... (showing ${maxResults} of ${totalMatches} total matches)`;
+                }
+            }
+            return this.ok(toolCallId, output, {
+                totalMatches,
+                filesReturned: files.length,
+                truncated,
+            });
+        }
+        catch (err) {
+            return this.fail(toolCallId, `Glob search failed: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=glob.js.map

package/dist/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,WAAW,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAC3B,IAAI,GAAG,MAAM,CAAC;IACd,WAAW,GAClB,sCAAsC;QACtC,kDAAkD,CAAC;IAC5C,SAAS,GAAc,KAAK,CAAC;IAE7B,UAAU,GAAiC;QAClD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,qDAAqD;YAClE,QAAQ,EAAE,IAAI;SACf;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,KAAK;SAChB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,6BAA6B,mBAAmB,GAAG;YAChE,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,mBAAmB;SAC7B;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAAe;QAC1D,MAAM,UAAU,GAAI,IAAI,CAAC,WAAsB,IAAI,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAA6B,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAA0B,CAAC;QACjD,MAAM,UAAU,GAAI,IAAI,CAAC,UAAqB,IAAI,mBAAmB,CAAC;QAEtE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qCAAqC,CAAC,CAAC;QACtE,CAAC;QAED,yBAAyB;QACzB,IAAI,GAAG,GAAG,OAAO,CAAC;QAClB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;gBACjC,GAAG;gBACH,MAAM,EAAE;oBACN,oBAAoB;oBACpB,YAAY;oBACZ,YAAY;oBACZ,aAAa;oBACb,aAAa;oBACb,gBAAgB;iBACjB;gBACD,SAAS,EAAE,IAAI;gBACf,mBAAmB,EAAE,KAAK;aAC3B,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;YACrC,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,CAAC;YAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAE5C,IAAI,MAAc,CAAC;YACnB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,GAAG,oCAAoC,OAAO,EAAE,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1B,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,IAAI,oBAAoB,UAAU,OAAO,YAAY,iBAAiB,CAAC;gBAC/E,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE;gBACjC,YAAY;gBACZ,aAAa,EAAE,KAAK,CAAC,MAAM;gBAC3B,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,uBAAwB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;CACF"}

package/dist/grep.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @yuaone/tools — grep tool
+ *
+ * Searches file contents using regex patterns.
+ * - Node.js built-in implementation (no ripgrep dependency)
+ * - Glob-based file filtering
+ * - Context lines support
+ * - Max 100 result lines
+ */
+import type { ParameterDef, RiskLevel, ToolResult } from './types.js';
+import { BaseTool } from './base-tool.js';
+export declare class GrepTool extends BaseTool {
+    readonly name = "grep";
+    readonly description: string;
+    readonly riskLevel: RiskLevel;
+    readonly parameters: Record<string, ParameterDef>;
+    execute(args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+}
+//# sourceMappingURL=grep.d.ts.map

package/dist/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../src/grep.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,qBAAa,QAAS,SAAQ,QAAQ;IACpC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,WAAW,SAEyC;IAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAS;IAEtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CA4B/C;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAiJnF"}