@revealui/ai 0.2.0 → 0.2.2

package/dist/tools/cms/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAyBtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC;QACV,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;IAEF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1D,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAExF,MAAM,CAAC,OAAO,EAAE;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC9B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEpB,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEvE,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACzF;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,YAAY,CAAA;IAEvB,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAElC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;IAE1B,mDAAmD;IACnD,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,CAggB7D"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAyBvC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QACV,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzF,MAAM,CAAC,OAAO,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,UAAU,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1F;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,SAAS,EAAE,YAAY,CAAC;IAExB,kEAAkE;IAClE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAE3B,mDAAmD;IACnD,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,CAggB7D"}

package/dist/tools/cms/global-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/global-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAwB3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA+B9B,CAAA"}
+{"version":3,"file":"global-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/global-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IA6B7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAwB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IA+B9B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/tools/cms/media-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/media-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAqC3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,IAsB1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAyC7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAuB7B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAoC7B,CAAA"}
+{"version":3,"file":"media-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/media-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAqC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,IAsB1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAyC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAuB7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,IAoC7B,CAAC"}

package/dist/tools/cms/user-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/user-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAoBhC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAiC3B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAuB5B,CAAA"}
+{"version":3,"file":"user-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/cms/user-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,IAoBhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,IAiC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAuB5B,CAAC"}

package/dist/tools/coding/file-edit.d.ts

@@ -0,0 +1,6 @@
+/**
+ * file_edit — Surgical string replacement in a file
+ */
+import type { Tool } from '../base.js';
+export declare const fileEditTool: Tool;
+//# sourceMappingURL=file-edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-edit.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-edit.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,YAAY,EAAE,IA4E1B,CAAC"}

package/dist/tools/coding/file-edit.js

@@ -0,0 +1,73 @@
+/**
+ * file_edit — Surgical string replacement in a file
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { z } from 'zod/v4';
+import { getSafetyConfig, resolveSafePath, validatePath } from './safety.js';
+export const fileEditTool = {
+    name: 'file_edit',
+    label: 'Edit File',
+    description: 'Replace an exact string in a file. The old_text must appear exactly once in the file. For creating new files or full rewrites, use file_write instead.',
+    parameters: z.object({
+        path: z.string().describe('File path relative to project root'),
+        old_text: z
+            .string()
+            .describe('The exact text to find and replace (must be unique in the file)'),
+        new_text: z.string().describe('The replacement text'),
+    }),
+    async execute(params) {
+        const { path, old_text, new_text } = params;
+        const config = getSafetyConfig();
+        const check = validatePath(path, config);
+        if (!check.safe) {
+            return { success: false, error: check.reason };
+        }
+        if (old_text === new_text) {
+            return { success: false, error: 'old_text and new_text are identical — nothing to change' };
+        }
+        const resolvedPath = resolveSafePath(path, config);
+        try {
+            const content = readFileSync(resolvedPath, 'utf8');
+            // Count occurrences
+            let count = 0;
+            let idx = 0;
+            while (idx < content.length) {
+                const found = content.indexOf(old_text, idx);
+                if (found === -1)
+                    break;
+                count++;
+                idx = found + old_text.length;
+            }
+            if (count === 0) {
+                return {
+                    success: false,
+                    error: `old_text not found in ${path}. Verify the exact text including whitespace.`,
+                };
+            }
+            if (count > 1) {
+                return {
+                    success: false,
+                    error: `old_text found ${count} times in ${path}. Provide more surrounding context to make it unique.`,
+                };
+            }
+            const updated = content.replace(old_text, new_text);
+            writeFileSync(resolvedPath, updated, 'utf8');
+            const addedLines = new_text.split('\n').length - old_text.split('\n').length;
+            const sign = addedLines >= 0 ? '+' : '';
+            return {
+                success: true,
+                data: { path, addedLines },
+                content: `Edited ${path} (${sign}${addedLines} lines)`,
+            };
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT')
+                return { success: false, error: `File not found: ${path}` };
+            return {
+                success: false,
+                error: `Failed to edit ${path}: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+};

package/dist/tools/coding/file-glob.d.ts

@@ -0,0 +1,6 @@
+/**
+ * file_glob — Fast file pattern matching with picomatch-style globs
+ */
+import type { Tool } from '../base.js';
+export declare const fileGlobTool: Tool;
+//# sourceMappingURL=file-glob.d.ts.map

package/dist/tools/coding/file-glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-glob.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-glob.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AA+DnD,eAAO,MAAM,YAAY,EAAE,IAgE1B,CAAC"}

package/dist/tools/coding/file-glob.js

@@ -0,0 +1,120 @@
+/**
+ * file_glob — Fast file pattern matching with picomatch-style globs
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { z } from 'zod/v4';
+import { getSafetyConfig } from './safety.js';
+/** Simple glob matcher supporting *, **, and ? */
+function matchGlob(pattern, filePath) {
+    const regex = pattern
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '⟨GLOBSTAR⟩')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\?/g, '[^/]')
+        .replace(/⟨GLOBSTAR⟩/g, '.*');
+    return new RegExp(`^${regex}$`).test(filePath);
+}
+/** Recursively walk a directory, yielding relative paths */
+function walkDir(dir, root, maxFiles) {
+    const results = [];
+    function recurse(current) {
+        if (results.length >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (results.length >= maxFiles)
+                return;
+            // Skip common non-useful directories
+            if (entry === 'node_modules' ||
+                entry === '.git' ||
+                entry === 'dist' ||
+                entry === '.turbo' ||
+                entry === '.next' ||
+                entry === 'coverage') {
+                continue;
+            }
+            const fullPath = join(current, entry);
+            let stat;
+            try {
+                stat = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                recurse(fullPath);
+            }
+            else {
+                results.push(relative(root, fullPath));
+            }
+        }
+    }
+    recurse(dir);
+    return results;
+}
+export const fileGlobTool = {
+    name: 'file_glob',
+    label: 'Find Files',
+    description: 'Find files matching a glob pattern. Supports *, **, and ? wildcards. Results sorted by modification time (newest first). Skips node_modules, .git, dist, .turbo.',
+    parameters: z.object({
+        pattern: z.string().describe('Glob pattern (e.g., "**/*.ts", "src/**/*.test.ts")'),
+        path: z
+            .string()
+            .optional()
+            .describe('Directory to search in, relative to project root (default: project root)'),
+    }),
+    async execute(params) {
+        const { pattern, path } = params;
+        const config = getSafetyConfig();
+        const maxFiles = 10_000;
+        const searchRoot = path ? join(config.projectRoot, path) : config.projectRoot;
+        try {
+            const stat = statSync(searchRoot);
+            if (!stat.isDirectory()) {
+                return { success: false, error: `Not a directory: ${path ?? '.'}` };
+            }
+        }
+        catch {
+            return { success: false, error: `Directory not found: ${path ?? '.'}` };
+        }
+        try {
+            const allFiles = walkDir(searchRoot, config.projectRoot, maxFiles);
+            // Filter by glob pattern
+            const matched = allFiles.filter((f) => matchGlob(pattern, f));
+            // Sort by mtime (newest first)
+            const withMtime = matched.map((f) => {
+                try {
+                    const s = statSync(join(config.projectRoot, f));
+                    return { path: f, mtime: s.mtimeMs };
+                }
+                catch {
+                    return { path: f, mtime: 0 };
+                }
+            });
+            withMtime.sort((a, b) => b.mtime - a.mtime);
+            const paths = withMtime.map((f) => f.path);
+            const truncated = paths.length > 200;
+            const display = truncated ? paths.slice(0, 200) : paths;
+            return {
+                success: true,
+                data: { pattern, totalMatches: paths.length, files: display },
+                content: truncated
+                    ? `Found ${paths.length} files matching "${pattern}" (showing first 200):\n${display.join('\n')}`
+                    : `Found ${paths.length} files matching "${pattern}":\n${display.join('\n')}`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Glob failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+};

package/dist/tools/coding/file-grep.d.ts

@@ -0,0 +1,6 @@
+/**
+ * file_grep — Regex content search across files
+ */
+import type { Tool } from '../base.js';
+export declare const fileGrepTool: Tool;
+//# sourceMappingURL=file-grep.d.ts.map

package/dist/tools/coding/file-grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-grep.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-grep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAiGnD,eAAO,MAAM,YAAY,EAAE,IA0H1B,CAAC"}

package/dist/tools/coding/file-grep.js

@@ -0,0 +1,194 @@
+/**
+ * file_grep — Regex content search across files
+ */
+import { readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { z } from 'zod/v4';
+import { getSafetyConfig } from './safety.js';
+/** Simple glob test for file filtering */
+function matchesGlob(filePath, glob) {
+    const regex = glob
+        .replace(/\./g, '\\.')
+        .replace(/\*\*/g, '⟨GLOBSTAR⟩')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\?/g, '[^/]')
+        .replace(/⟨GLOBSTAR⟩/g, '.*');
+    return new RegExp(`^${regex}$`).test(filePath);
+}
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    '.turbo',
+    '.next',
+    'coverage',
+    '.vercel',
+]);
+const BINARY_EXTENSIONS = new Set([
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.ico',
+    '.webp',
+    '.svg',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.eot',
+    '.mp3',
+    '.mp4',
+    '.zip',
+    '.tar',
+    '.gz',
+    '.pdf',
+    '.lock',
+]);
+function isBinary(path) {
+    const ext = path.slice(path.lastIndexOf('.'));
+    return BINARY_EXTENSIONS.has(ext);
+}
+/** Recursively collect file paths */
+function collectFiles(dir, root, glob, maxFiles = 50_000) {
+    const results = [];
+    function recurse(current) {
+        if (results.length >= maxFiles)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (results.length >= maxFiles)
+                return;
+            if (SKIP_DIRS.has(entry))
+                continue;
+            const fullPath = join(current, entry);
+            let stat;
+            try {
+                stat = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                recurse(fullPath);
+            }
+            else if (!isBinary(fullPath)) {
+                const rel = relative(root, fullPath);
+                if (!glob || matchesGlob(rel, glob)) {
+                    results.push(fullPath);
+                }
+            }
+        }
+    }
+    recurse(dir);
+    return results;
+}
+export const fileGrepTool = {
+    name: 'file_grep',
+    label: 'Search Code',
+    description: 'Search file contents with regex. Returns matching lines with context. Use glob to filter by file pattern. Skips binary files and node_modules.',
+    parameters: z.object({
+        pattern: z.string().describe('Regex pattern to search for'),
+        path: z
+            .string()
+            .optional()
+            .describe('Directory to search in, relative to project root (default: project root)'),
+        glob: z.string().optional().describe('File glob to filter (e.g., "**/*.ts", "*.json")'),
+        contextLines: z
+            .number()
+            .optional()
+            .describe('Lines of context before/after each match (default: 0)'),
+    }),
+    async execute(params) {
+        const { pattern, path, glob, contextLines = 0, } = params;
+        const config = getSafetyConfig();
+        const maxMatches = 500;
+        const searchRoot = path ? join(config.projectRoot, path) : config.projectRoot;
+        let regex;
+        try {
+            regex = new RegExp(pattern, 'g');
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Invalid regex: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        try {
+            const files = collectFiles(searchRoot, config.projectRoot, glob);
+            const matches = [];
+            let filesSearched = 0;
+            let filesWithMatches = 0;
+            for (const filePath of files) {
+                if (matches.length >= maxMatches)
+                    break;
+                let content;
+                try {
+                    content = readFileSync(filePath, 'utf8');
+                }
+                catch {
+                    continue;
+                }
+                filesSearched++;
+                const lines = content.split('\n');
+                let fileHasMatch = false;
+                for (let i = 0; i < lines.length; i++) {
+                    if (matches.length >= maxMatches)
+                        break;
+                    regex.lastIndex = 0;
+                    const currentLine = lines[i];
+                    if (currentLine !== undefined && regex.test(currentLine)) {
+                        if (!fileHasMatch) {
+                            fileHasMatch = true;
+                            filesWithMatches++;
+                        }
+                        const rel = relative(config.projectRoot, filePath);
+                        if (contextLines > 0) {
+                            const start = Math.max(0, i - contextLines);
+                            const end = Math.min(lines.length - 1, i + contextLines);
+                            const ctx = lines
+                                .slice(start, end + 1)
+                                .map((l, idx) => {
+                                const lineNum = start + idx + 1;
+                                const marker = start + idx === i ? '>' : ' ';
+                                return `${marker}${String(lineNum).padStart(6)} ${l}`;
+                            })
+                                .join('\n');
+                            matches.push({ file: rel, line: i + 1, content: ctx });
+                        }
+                        else {
+                            matches.push({
+                                file: rel,
+                                line: i + 1,
+                                content: currentLine.trim(),
+                            });
+                        }
+                    }
+                }
+            }
+            const truncated = matches.length >= maxMatches;
+            const summary = `${filesWithMatches} files, ${matches.length} matches${truncated ? ' (truncated)' : ''} across ${filesSearched} files searched`;
+            const display = matches
+                .map((m) => contextLines > 0
+                ? `${m.file}:${m.line}\n${m.content}`
+                : `${m.file}:${m.line}: ${m.content}`)
+                .join('\n');
+            return {
+                success: true,
+                data: { pattern, filesSearched, filesWithMatches, matchCount: matches.length, matches },
+                content: `${summary}\n${display}`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Grep failed: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+};

package/dist/tools/coding/file-read.d.ts

@@ -0,0 +1,6 @@
+/**
+ * file_read — Read file contents with line numbers
+ */
+import type { Tool } from '../base.js';
+export declare const fileReadTool: Tool;
+//# sourceMappingURL=file-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,YAAY,EAAE,IAkE1B,CAAC"}

package/dist/tools/coding/file-read.js

@@ -0,0 +1,69 @@
+/**
+ * file_read — Read file contents with line numbers
+ */
+import { readFileSync, statSync } from 'node:fs';
+import { z } from 'zod/v4';
+import { getSafetyConfig, resolveSafePath, validatePath } from './safety.js';
+export const fileReadTool = {
+    name: 'file_read',
+    label: 'Read File',
+    description: 'Read the contents of a file. Returns line-numbered output. Use offset/limit to read specific sections of large files.',
+    parameters: z.object({
+        path: z.string().describe('File path relative to project root'),
+        offset: z.number().optional().describe('Start reading from this line number (1-based)'),
+        limit: z.number().optional().describe('Maximum number of lines to read (default: 2000)'),
+    }),
+    async execute(params) {
+        const { path, offset, limit } = params;
+        const config = getSafetyConfig();
+        const check = validatePath(path, config);
+        if (!check.safe) {
+            return { success: false, error: check.reason };
+        }
+        const resolvedPath = resolveSafePath(path, config);
+        const maxLines = limit ?? 2000;
+        const startLine = (offset ?? 1) - 1; // Convert to 0-based
+        try {
+            const stat = statSync(resolvedPath);
+            if (stat.isDirectory()) {
+                return {
+                    success: false,
+                    error: `${path} is a directory, not a file. Use file_glob to list directory contents.`,
+                };
+            }
+            const raw = readFileSync(resolvedPath, 'utf8');
+            const allLines = raw.split('\n');
+            const totalLines = allLines.length;
+            const sliced = allLines.slice(startLine, startLine + maxLines);
+            const numbered = sliced
+                .map((line, i) => `${String(startLine + i + 1).padStart(6)}  ${line}`)
+                .join('\n');
+            const truncated = sliced.length < totalLines - startLine;
+            const summary = truncated
+                ? `${path} (lines ${startLine + 1}-${startLine + sliced.length} of ${totalLines})`
+                : `${path} (${totalLines} lines)`;
+            return {
+                success: true,
+                data: {
+                    path,
+                    totalLines,
+                    startLine: startLine + 1,
+                    linesReturned: sliced.length,
+                    content: numbered,
+                },
+                content: `${summary}\n${numbered}`,
+            };
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'ENOENT')
+                return { success: false, error: `File not found: ${path}` };
+            if (code === 'EACCES')
+                return { success: false, error: `Permission denied: ${path}` };
+            return {
+                success: false,
+                error: `Failed to read ${path}: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+};

package/dist/tools/coding/file-write.d.ts

@@ -0,0 +1,6 @@
+/**
+ * file_write — Write entire file contents
+ */
+import type { Tool } from '../base.js';
+export declare const fileWriteTool: Tool;
+//# sourceMappingURL=file-write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-write.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/file-write.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,aAAa,EAAE,IAkD3B,CAAC"}

package/dist/tools/coding/file-write.js

@@ -0,0 +1,49 @@
+/**
+ * file_write — Write entire file contents
+ */
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { z } from 'zod/v4';
+import { getSafetyConfig, resolveSafePath, validatePath } from './safety.js';
+export const fileWriteTool = {
+    name: 'file_write',
+    label: 'Write File',
+    description: 'Write content to a file, creating it if it does not exist. Overwrites existing content. Use file_edit for surgical changes to existing files.',
+    parameters: z.object({
+        path: z.string().describe('File path relative to project root'),
+        content: z.string().describe('The full content to write'),
+        createDirs: z
+            .boolean()
+            .optional()
+            .describe('Create parent directories if they do not exist (default: true)'),
+    }),
+    async execute(params) {
+        const { path, content, createDirs } = params;
+        const config = getSafetyConfig();
+        const check = validatePath(path, config);
+        if (!check.safe) {
+            return { success: false, error: check.reason };
+        }
+        const resolvedPath = resolveSafePath(path, config);
+        try {
+            if (createDirs !== false) {
+                mkdirSync(dirname(resolvedPath), { recursive: true });
+            }
+            // Normalize to trailing newline
+            const normalized = content.endsWith('\n') ? content : `${content}\n`;
+            writeFileSync(resolvedPath, normalized, 'utf8');
+            const lineCount = normalized.split('\n').length - 1;
+            return {
+                success: true,
+                data: { path, bytes: Buffer.byteLength(normalized), lines: lineCount },
+                content: `Wrote ${lineCount} lines to ${path}`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: `Failed to write ${path}: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+    },
+};

package/dist/tools/coding/git-ops.d.ts

@@ -0,0 +1,6 @@
+/**
+ * git_ops — Git operations wrapper (status, diff, log, blame)
+ */
+import type { Tool } from '../base.js';
+export declare const gitOpsTool: Tool;
+//# sourceMappingURL=git-ops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-ops.d.ts","sourceRoot":"","sources":["../../../src/tools/coding/git-ops.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAc,MAAM,YAAY,CAAC;AAyBnD,eAAO,MAAM,UAAU,EAAE,IA4FxB,CAAC"}