@xandout/libra-harness 0.1.12 → 0.1.14

package/dist/extras/extensions/code-tools/tools/grep.js

@@ -0,0 +1,306 @@
+import { readdirSync, readFileSync, existsSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { makeToolName } from './shared.js';
+// ── Grep implementation ──────────────────────────────────────────────
+// Pure-JS content search. Supports:
+//   - Rust regex syntax (via JS RegExp, with look-around not supported)
+//   - Glob pattern filtering (e.g. "*.ts", "src/**/*.py")
+//   - Output modes: content, files_with_matches, count
+//   - Context lines before/after matches
+//   - Case-insensitive matching
+//   - Max file size (skips files > 4MB, matching ripgrep behavior)
+//   - Max results limit
+const MAX_FILE_SIZE = 4 * 1024 * 1024; // 4MB
+function isNoiseDir(name) {
+    return name === 'node_modules' || name === '.git' || name === 'dist' || name === '.next' || name === 'coverage';
+}
+// Simple glob to regex (same minimal implementation as find.ts)
+function globToRegex(pattern) {
+    let i = 0;
+    let regex = '';
+    while (i < pattern.length) {
+        const c = pattern[i];
+        if (c === '*' && pattern[i + 1] === '*') {
+            regex += '.*';
+            i += 2;
+            if (pattern[i] === '/')
+                i++;
+        }
+        else if (c === '*') {
+            regex += '[^/]*';
+            i++;
+        }
+        else if (c === '?') {
+            regex += '[^/]';
+            i++;
+        }
+        else if (c === '{') {
+            const end = pattern.indexOf('}', i);
+            if (end === -1) {
+                regex += '\\{';
+                i++;
+            }
+            else {
+                const options = pattern.slice(i + 1, end).split(',').map((s) => escapeRegex(s));
+                regex += `(?:${options.join('|')})`;
+                i = end + 1;
+            }
+        }
+        else if (c === '.') {
+            regex += '\\.';
+            i++;
+        }
+        else if ('+()|^$\\'.includes(c)) {
+            regex += '\\' + c;
+            i++;
+        }
+        else {
+            regex += c;
+            i++;
+        }
+    }
+    return new RegExp(`^${regex}$`);
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function shouldSearchFile(filePath, globPattern) {
+    if (globPattern) {
+        const base = filePath.split('/').pop() ?? filePath;
+        // Try matching against full relative path and just the filename
+        if (!globPattern.test(filePath) && !globPattern.test(base))
+            return false;
+    }
+    try {
+        const stat = statSync(filePath);
+        if (stat.size > MAX_FILE_SIZE)
+            return false;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function searchFile(filePath, regex) {
+    const matches = [];
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return { file: filePath, matches: [], count: 0 };
+    }
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        // Reset lastIndex — the regex has the global flag, so test() advances it.
+        regex.lastIndex = 0;
+        if (regex.test(lines[i])) {
+            matches.push({ file: filePath, lineNum: i + 1, line: lines[i] });
+        }
+    }
+    return { file: filePath, matches, count: matches.length };
+}
+function walkDir(dir, globPattern, baseDir) {
+    const files = [];
+    function walk(d) {
+        let entries;
+        try {
+            entries = readdirSync(d, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() && isNoiseDir(entry.name))
+                continue;
+            const fullPath = join(d, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+            }
+            else {
+                const relPath = relative(baseDir, fullPath);
+                if (shouldSearchFile(relPath, globPattern) || shouldSearchFile(fullPath, globPattern)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    walk(dir);
+    return files;
+}
+// ── grep tool ────────────────────────────────────────────────────────
+export const grepTool = (cfg) => ({
+    name: makeToolName(cfg.toolPrefix, 'grep'),
+    description: 'Search file contents using regex. Uses JS RegExp syntax (no look-ahead/look-behind or backreferences). ' +
+        'Files larger than 4MB are skipped. ' +
+        'Output modes: "content" (matching lines with line numbers), "files_with_matches" (just file paths), "count" (match counts per file). ' +
+        'Use context_lines to show lines before/after each match. ' +
+        'Automatically skips node_modules, .git, dist, coverage directories.',
+    parameters: {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Regular expression pattern to search for (JS RegExp syntax).',
+            },
+            path: {
+                type: 'string',
+                description: 'Directory or file to search in. Default: current working directory.',
+            },
+            glob_pattern: {
+                type: 'string',
+                description: 'Glob pattern to filter files (e.g. "*.ts", "src/**/*.py"). Default: search all files.',
+            },
+            output_mode: {
+                type: 'string',
+                enum: ['content', 'files_with_matches', 'count'],
+                description: 'How to format results. Default: "content".',
+            },
+            context_lines: {
+                type: 'integer',
+                description: 'Number of lines to show before and after each match. Default: 0.',
+            },
+            case_insensitive: {
+                type: 'boolean',
+                description: 'If true, perform case-insensitive matching. Default: false.',
+            },
+            max_results: {
+                type: 'integer',
+                description: 'Maximum number of matching lines to return. Default: 100.',
+            },
+        },
+        required: ['pattern'],
+    },
+    async execute(args) {
+        const pattern = String(args.pattern ?? '');
+        if (!pattern) {
+            return { toolCallId: '', content: 'Error: pattern is required' };
+        }
+        const searchPath = String(args.path ?? process.cwd());
+        const outputMode = String(args.output_mode ?? 'content');
+        const contextLines = Math.max(0, Number(args.context_lines ?? 0));
+        const caseInsensitive = args.case_insensitive === true;
+        const maxResults = Math.min(Math.max(1, Number(args.max_results ?? 100)), 10000);
+        const globPattern = args.glob_pattern ? String(args.glob_pattern) : undefined;
+        // Compile the regex.
+        let regex;
+        try {
+            regex = new RegExp(pattern, caseInsensitive ? 'gi' : 'g');
+        }
+        catch (err) {
+            return {
+                toolCallId: '',
+                content: `Error: invalid regex pattern: ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        // Compile glob filter if provided.
+        let globRegex;
+        if (globPattern) {
+            try {
+                globRegex = globToRegex(globPattern);
+            }
+            catch (err) {
+                return {
+                    toolCallId: '',
+                    content: `Error: invalid glob_pattern: ${err instanceof Error ? err.message : String(err)}`,
+                };
+            }
+        }
+        // Determine search scope — single file or directory.
+        if (!existsSync(searchPath)) {
+            return { toolCallId: '', content: `Path not found: ${searchPath}` };
+        }
+        const stat = statSync(searchPath);
+        let files;
+        if (stat.isFile()) {
+            files = [searchPath];
+        }
+        else if (stat.isDirectory()) {
+            files = walkDir(searchPath, globRegex, searchPath);
+        }
+        else {
+            return { toolCallId: '', content: `Path is not a file or directory: ${searchPath}` };
+        }
+        // Search all files.
+        const results = [];
+        let totalMatches = 0;
+        for (const file of files) {
+            // Reset regex lastIndex between files (it has the global flag).
+            regex.lastIndex = 0;
+            const result = searchFile(file, regex);
+            if (result.count > 0) {
+                results.push(result);
+                totalMatches += result.count;
+            }
+        }
+        if (totalMatches === 0) {
+            return { toolCallId: '', content: `No matches found for "${pattern}" in ${searchPath}` };
+        }
+        // Format output based on mode.
+        const baseDir = stat.isDirectory() ? searchPath : '';
+        if (outputMode === 'files_with_matches') {
+            const fileList = results.map((r) => relative(baseDir, r.file) || r.file);
+            const truncated = fileList.length > maxResults;
+            const displayed = fileList.slice(0, maxResults);
+            return {
+                toolCallId: '',
+                content: `${displayed.join('\n')}${truncated ? `\n\n[showing first ${maxResults} of ${fileList.length} files]` : ''}`,
+            };
+        }
+        if (outputMode === 'count') {
+            const lines = results.map((r) => {
+                const rel = relative(baseDir, r.file) || r.file;
+                return `${rel}:${r.count}`;
+            });
+            return {
+                toolCallId: '',
+                content: `${lines.join('\n')}\n\nTotal: ${totalMatches} match${totalMatches === 1 ? '' : 'es'} in ${results.length} file${results.length === 1 ? '' : 's'}`,
+            };
+        }
+        // content mode — show matching lines with line numbers and context.
+        const allMatches = [];
+        for (const r of results) {
+            for (const m of r.matches) {
+                allMatches.push(m);
+            }
+        }
+        const truncated = allMatches.length > maxResults;
+        const displayed = allMatches.slice(0, maxResults);
+        // Read context lines for each match.
+        const outputLines = [];
+        const fileCache = new Map();
+        for (const m of displayed) {
+            if (contextLines > 0) {
+                let fileLines = fileCache.get(m.file);
+                if (!fileLines) {
+                    try {
+                        fileLines = readFileSync(m.file, 'utf-8').split('\n');
+                        fileCache.set(m.file, fileLines);
+                    }
+                    catch {
+                        fileLines = [];
+                    }
+                }
+                const rel = relative(baseDir, m.file) || m.file;
+                const start = Math.max(0, m.lineNum - 1 - contextLines);
+                const end = Math.min(fileLines.length - 1, m.lineNum - 1 + contextLines);
+                for (let i = start; i <= end; i++) {
+                    const prefix = i === m.lineNum - 1 ? '>' : ' ';
+                    outputLines.push(`${rel}:${i + 1}:${prefix} ${fileLines[i]}`);
+                }
+                outputLines.push('');
+            }
+            else {
+                const rel = relative(baseDir, m.file) || m.file;
+                outputLines.push(`${rel}:${m.lineNum}: ${m.line}`);
+            }
+        }
+        const header = `Found ${totalMatches} match${totalMatches === 1 ? '' : 'es'} in ${results.length} file${results.length === 1 ? '' : 's'}:`;
+        const footer = truncated ? `\n\n[showing first ${maxResults} of ${totalMatches} matches]` : '';
+        return {
+            toolCallId: '',
+            content: `${header}\n${outputLines.join('\n')}${footer}`,
+        };
+    },
+});
+//# sourceMappingURL=grep.js.map

package/dist/extras/extensions/code-tools/tools/grep.js.map

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

package/dist/extras/extensions/code-tools/tools/read.d.ts

@@ -0,0 +1,3 @@
+import { type ToolFactory } from './shared.js';
+export declare const readTool: ToolFactory;
+//# sourceMappingURL=read.d.ts.map

package/dist/extras/extensions/code-tools/tools/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../../src/extras/extensions/code-tools/tools/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAgE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7G,eAAO,MAAM,QAAQ,EAAE,WA2GrB,CAAC"}

package/dist/extras/extensions/code-tools/tools/read.js

@@ -0,0 +1,97 @@
+import { readFileSync, statSync, existsSync } from 'node:fs';
+import { makeToolName, getReadSet, isTextFile, isImageFile, imageMime } from './shared.js';
+export const readTool = (cfg) => ({
+    name: makeToolName(cfg.toolPrefix, 'read'),
+    description: 'Read a file from the local filesystem. Returns file contents with line numbers. ' +
+        'Text files are returned as text; binary files as base64; images are returned as base64 data URLs. ' +
+        'You MUST read a file before editing or overwriting it. ' +
+        'Use absolute paths. For large files, use offset (1-based line number) and limit (line count) to read a portion.',
+    parameters: {
+        type: 'object',
+        properties: {
+            file_path: {
+                type: 'string',
+                description: 'The absolute path to the file to read.',
+            },
+            offset: {
+                type: 'integer',
+                description: 'The line number to start reading from (1-based). Default: 1.',
+            },
+            limit: {
+                type: 'integer',
+                description: 'Maximum number of lines to read. Default: 2000.',
+            },
+        },
+        required: ['file_path'],
+    },
+    async execute(args, ctx) {
+        const filePath = String(args.file_path ?? '');
+        if (!filePath) {
+            return { toolCallId: '', content: 'Error: file_path is required' };
+        }
+        if (!existsSync(filePath)) {
+            return { toolCallId: '', content: `File not found: ${filePath}` };
+        }
+        const stat = statSync(filePath);
+        if (stat.isDirectory()) {
+            return {
+                toolCallId: '',
+                content: `Path is a directory, not a file: ${filePath}. Use find_file_by_name or exec with ls to list directory contents.`,
+            };
+        }
+        if (stat.size > cfg.maxReadSize) {
+            return {
+                toolCallId: '',
+                content: `File is too large (${stat.size} bytes, max ${cfg.maxReadSize}). Use offset and limit to read a portion, or use exec with head/tail.`,
+            };
+        }
+        // Track that this file was read — edit and write require it.
+        getReadSet(ctx.metadata).add(filePath);
+        const buf = readFileSync(filePath);
+        // ── Image files: return as base64 data URL ──────────────────────
+        if (isImageFile(filePath)) {
+            const mime = imageMime(filePath);
+            const base64 = buf.toString('base64');
+            return {
+                toolCallId: '',
+                content: `File: ${filePath} (${stat.size}b, ${mime})\ndata:${mime};base64,${base64}`,
+            };
+        }
+        // ── Binary files: return as base64 ──────────────────────────────
+        if (!isTextFile(filePath)) {
+            const base64 = buf.toString('base64');
+            return {
+                toolCallId: '',
+                content: `File: ${filePath} (${stat.size}b, binary)\nbase64: ${base64}`,
+            };
+        }
+        // ── Text files: return with line numbers ────────────────────────
+        const text = buf.toString('utf-8');
+        const allLines = text.split('\n');
+        // Apply offset (1-based)
+        const offset = Math.max(1, Number(args.offset ?? 1));
+        const startIdx = offset - 1;
+        let lines = allLines.slice(startIdx);
+        // Apply limit
+        const limit = Math.min(Number(args.limit ?? cfg.maxReadLines), cfg.maxReadLines);
+        const truncated = lines.length > limit;
+        lines = lines.slice(0, limit);
+        // Format with line numbers, truncating long lines
+        const formatted = lines.map((line, i) => {
+            const lineNum = startIdx + i + 1;
+            const truncatedLine = line.length > cfg.maxLineLength
+                ? line.slice(0, cfg.maxLineLength) + ' [...truncated]'
+                : line;
+            return `${String(lineNum).padStart(6)}\t${truncatedLine}`;
+        }).join('\n');
+        const header = `File: ${filePath} (${stat.size}b)`;
+        const footer = truncated
+            ? `\n\n[showing lines ${offset}-${offset + limit - 1} of ${allLines.length} total]`
+            : '';
+        return {
+            toolCallId: '',
+            content: `${header}\n${formatted}${footer}`,
+        };
+    },
+});
+//# sourceMappingURL=read.js.map

package/dist/extras/extensions/code-tools/tools/read.js.map

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

package/dist/extras/extensions/code-tools/tools/shared.d.ts

@@ -0,0 +1,14 @@
+import type { Tool } from '../../../../tool.js';
+export declare function makeToolName(prefix: string, name: string): string;
+export declare function getReadSet(metadata: Record<string, unknown>): Set<string>;
+export declare function isTextFile(path: string): boolean;
+export declare function isImageFile(path: string): boolean;
+export declare function imageMime(path: string): string;
+export interface ResolvedConfig {
+    toolPrefix: string;
+    maxReadSize: number;
+    maxReadLines: number;
+    maxLineLength: number;
+}
+export type ToolFactory = (cfg: ResolvedConfig) => Tool;
+//# sourceMappingURL=shared.d.ts.map

package/dist/extras/extensions/code-tools/tools/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/extras/extensions/code-tools/tools/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAGhD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAOD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAOzE;AAaD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhD;AAKD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAWD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAGD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAGD,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC"}

package/dist/extras/extensions/code-tools/tools/shared.js

@@ -0,0 +1,53 @@
+import { extname, basename } from 'node:path';
+// ── Tool naming helper ───────────────────────────────────────────────
+export function makeToolName(prefix, name) {
+    return prefix ? `${prefix}_${name}` : name;
+}
+// ── Read tracking ────────────────────────────────────────────────────
+// The edit and write tools require that a file was read first in the
+// current turn. We track read paths per turn via the metadata bag.
+const READ_KEY = '__codeToolsReadPaths';
+export function getReadSet(metadata) {
+    let set = metadata[READ_KEY];
+    if (!set) {
+        set = new Set();
+        metadata[READ_KEY] = set;
+    }
+    return set;
+}
+// ── Text/binary detection ────────────────────────────────────────────
+const TEXT_EXTENSIONS = new Set([
+    '.txt', '.csv', '.json', '.xml', '.yaml', '.yml', '.md', '.markdown',
+    '.js', '.ts', '.tsx', '.jsx', '.mjs', '.cjs', '.py', '.java', '.c',
+    '.cpp', '.h', '.hpp', '.go', '.rs', '.rb', '.php', '.sql', '.html',
+    '.htm', '.css', '.scss', '.less', '.sh', '.bash', '.zsh', '.ini',
+    '.conf', '.log', '.env', '.toml', '.graphql', '.gql', '.svg', '.srt',
+    '.vtt', '.properties', '.dockerfile', '.gitignore', '.editorconfig',
+    '.lock', '.map', '.d.ts', '.d.ts.map',
+]);
+export function isTextFile(path) {
+    const ext = extname(path).toLowerCase();
+    if (TEXT_EXTENSIONS.has(ext))
+        return true;
+    const name = basename(path).toLowerCase();
+    if (['dockerfile', '.gitignore', '.editorconfig', '.env', '.npmrc'].includes(name))
+        return true;
+    return false;
+}
+// ── Image detection ──────────────────────────────────────────────────
+const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp']);
+export function isImageFile(path) {
+    return IMAGE_EXTENSIONS.has(extname(path).toLowerCase());
+}
+const MIME_MAP = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.bmp': 'image/bmp',
+};
+export function imageMime(path) {
+    return MIME_MAP[extname(path).toLowerCase()] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=shared.js.map

package/dist/extras/extensions/code-tools/tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../../src/extras/extensions/code-tools/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG9C,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY;IACvD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,wEAAwE;AACxE,qEAAqE;AACrE,mEAAmE;AACnE,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AAExC,MAAM,UAAU,UAAU,CAAC,QAAiC;IAC1D,IAAI,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAA4B,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAChB,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IACpE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI;IAClE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;IAClE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAChE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACpE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe;IACnE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;CACtC,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,CAAC,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAErF,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC;AAC7E,CAAC"}

package/dist/extras/extensions/code-tools/tools/shell.d.ts

@@ -0,0 +1,49 @@
+import { type ChildProcess } from 'node:child_process';
+import type { Tool } from '../../../../tool.js';
+export interface ShellEntry {
+    id: string;
+    process?: ChildProcess;
+    pid: number;
+    output: string;
+    done: boolean;
+    exitCode: number | null;
+    startedAt: number;
+    command: string;
+    cwd: string;
+    outputFile?: string;
+    inputFifo?: string;
+    detached: boolean;
+    readOffset?: number;
+}
+export declare class ShellRegistry {
+    private shells;
+    private counter;
+    private shellsDir;
+    constructor(shellsDir?: string);
+    private nextId;
+    private metaPath;
+    /**
+     * Create a foreground shell (pipes connected, parent waits).
+     * If background is true, the process is detached and output goes
+     * to a file. Metadata is persisted to disk so a future process
+     * can reconnect.
+     */
+    create(command: string, cwd: string, env: Record<string, string>, background: boolean): Promise<ShellEntry>;
+    /**
+     * Get a shell by ID. If it's not in the in-memory map, try to
+     * reconnect from persisted metadata on disk.
+     */
+    get(id: string): ShellEntry | undefined;
+    delete(id: string): boolean;
+    /** Kill all in-memory backgrounded shells. Called on extension close. */
+    close(): void;
+}
+export type ShellToolFactory = (cfg: {
+    toolPrefix: string;
+    registry: ShellRegistry;
+}) => Tool;
+export declare const execTool: ShellToolFactory;
+export declare const getOutputTool: ShellToolFactory;
+export declare const killShellTool: ShellToolFactory;
+export declare const writeToProcessTool: ShellToolFactory;
+//# sourceMappingURL=shell.d.ts.map

package/dist/extras/extensions/code-tools/tools/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../../src/extras/extensions/code-tools/tools/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAYhD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,SAAS,CAAC,EAAE,MAAM,EAE7B;IAED,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIhB;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA4JhH;IAED;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CA6DtC;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAa1B;IAED,yEAAyE;IACzE,KAAK,IAAI,IAAI,CAgBZ;CACF;AAGD,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,KAAK,IAAI,CAAC;AAG9F,eAAO,MAAM,QAAQ,EAAE,gBAkGrB,CAAC;AAGH,eAAO,MAAM,aAAa,EAAE,gBA0F1B,CAAC;AAGH,eAAO,MAAM,aAAa,EAAE,gBAoD1B,CAAC;AAGH,eAAO,MAAM,kBAAkB,EAAE,gBAiH/B,CAAC"}