@xandout/libra-harness 0.1.34 → 0.1.91

package/dist/extensions/code-tools/tools/find.js

@@ -0,0 +1,83 @@
+import { existsSync, statSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { makeToolName, getChildProcessEnv } from './shared.js';
+let fdBinary;
+function getFdCommand() {
+    if (fdBinary)
+        return fdBinary;
+    const env = getChildProcessEnv();
+    try {
+        execSync('fd --version', { stdio: 'ignore', env });
+        fdBinary = 'fd';
+        return fdBinary;
+    }
+    catch { }
+    try {
+        execSync('fdfind --version', { stdio: 'ignore', env });
+        fdBinary = 'fdfind';
+        return fdBinary;
+    }
+    catch { }
+    return 'fd';
+}
+export const findFileByNameTool = (cfg) => ({
+    name: makeToolName(cfg.toolPrefix, 'find_file_by_name'),
+    description: 'Search for files and subdirectories within a specified directory using fd. ' +
+        'Search uses smart case and will ignore gitignored files by default. ' +
+        'Returns the relative paths of up to 200 matches.',
+    parameters: {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Glob pattern to match file paths against.',
+            },
+            path: {
+                type: 'string',
+                description: 'Directory to search in. Default: current working directory.',
+            },
+        },
+        required: ['pattern'],
+    },
+    async execute(args) {
+        const pattern = String(args.pattern ?? '');
+        if (!pattern) {
+            return { toolCallId: '', content: 'Error: pattern is required' };
+        }
+        const searchDir = String(args.path ?? process.cwd());
+        if (!existsSync(searchDir)) {
+            return { toolCallId: '', content: `Directory not found: ${searchDir}` };
+        }
+        const stat = statSync(searchDir);
+        if (!stat.isDirectory()) {
+            return { toolCallId: '', content: `Path is not a directory: ${searchDir}` };
+        }
+        try {
+            const bin = getFdCommand();
+            const env = getChildProcessEnv();
+            const output = execSync(`${bin} -g "${pattern}" -c never`, { cwd: searchDir, env, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] });
+            const files = output.split('\n').map(f => f.trim()).filter(Boolean);
+            if (files.length === 0) {
+                return { toolCallId: '', content: `No files matching "${pattern}" found in ${searchDir}` };
+            }
+            const maxResults = 200;
+            const truncated = files.length > maxResults;
+            const displayed = files.slice(0, maxResults);
+            const header = `Found ${files.length} file${files.length === 1 ? '' : 's'} matching "${pattern}" in ${searchDir}:`;
+            const footer = truncated ? `\n\n[showing first ${maxResults} of ${files.length} results]` : '';
+            return {
+                toolCallId: '',
+                content: `${header}\n${displayed.join('\n')}${footer}`,
+            };
+        }
+        catch (err) {
+            // execSync throws if exit code is non-zero
+            // fd exits with 1 if no files are found.
+            if (err.status === 1) {
+                return { toolCallId: '', content: `No files matching "${pattern}" found in ${searchDir}` };
+            }
+            return { toolCallId: '', content: `Error running fd: ${err.message || String(err)}` };
+        }
+    },
+});
+//# sourceMappingURL=find.js.map

package/dist/extensions/code-tools/tools/find.js.map

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

package/dist/extensions/code-tools/tools/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../../src/extensions/code-tools/tools/grep.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjF,eAAO,MAAM,QAAQ,EAAE,WA6FrB,CAAC"}

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

@@ -0,0 +1,90 @@
+import { existsSync, statSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { makeToolName, getChildProcessEnv } from './shared.js';
+export const grepTool = (cfg) => ({
+    name: makeToolName(cfg.toolPrefix, 'grep'),
+    description: 'Search file contents using ripgrep (rg). ' +
+        'Automatically skips node_modules, .git, and respects .gitignore. ' +
+        'Returns matching lines.',
+    parameters: {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Regular expression pattern to search for.',
+            },
+            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.',
+            },
+            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 (-i). Default: false.',
+            },
+        },
+        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 contextLines = Math.max(0, Number(args.context_lines ?? 0));
+        const caseInsensitive = args.case_insensitive === true;
+        const globPattern = args.glob_pattern ? String(args.glob_pattern) : undefined;
+        if (!existsSync(searchPath)) {
+            return { toolCallId: '', content: `Path not found: ${searchPath}` };
+        }
+        const stat = statSync(searchPath);
+        let target = searchPath;
+        let cwd = process.cwd();
+        if (stat.isDirectory()) {
+            cwd = searchPath;
+            target = '.';
+        }
+        // Build rg command args
+        const cmdArgs = ['rg', '--line-number', '--heading', '--max-count=100'];
+        if (caseInsensitive)
+            cmdArgs.push('-i');
+        if (contextLines > 0)
+            cmdArgs.push(`-C ${contextLines}`);
+        if (globPattern) {
+            cmdArgs.push('-g', `"${globPattern}"`);
+        }
+        // Add pattern and target
+        // Use single quotes around the pattern to prevent shell expansion
+        cmdArgs.push(`'${pattern.replace(/'/g, "'\\''")}'`, target);
+        try {
+            const env = getChildProcessEnv();
+            const output = execSync(cmdArgs.join(' '), { cwd, env, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'ignore'] });
+            const lines = output.trim();
+            if (!lines) {
+                return { toolCallId: '', content: `No matches found for "${pattern}" in ${searchPath}` };
+            }
+            // Output size safety
+            const maxLen = 100000;
+            const truncated = lines.length > maxLen ? lines.slice(0, maxLen) + '\n\n[...truncated]' : lines;
+            return {
+                toolCallId: '',
+                content: `Search results for "${pattern}":\n\n${truncated}`,
+            };
+        }
+        catch (err) {
+            // rg exits with 1 if no matches are found
+            if (err.status === 1) {
+                return { toolCallId: '', content: `No matches found for "${pattern}" in ${searchPath}` };
+            }
+            return { toolCallId: '', content: `Error running ripgrep: ${err.message || String(err)}` };
+        }
+    },
+});
+//# sourceMappingURL=grep.js.map

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

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

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

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

package/dist/{extras/extensions → extensions}/code-tools/tools/read.js

@@ -5,7 +5,7 @@ export const readTool = (cfg) => ({
     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.',
+        'Use absolute paths. For large files, specify startLine and endLine to view a portion.',
     parameters: {
         type: 'object',
         properties: {
@@ -13,13 +13,13 @@ export const readTool = (cfg) => ({
                 type: 'string',
                 description: 'The absolute path to the file to read.',
             },
-            offset: {
+            startLine: {
                 type: 'integer',
-                description: 'The line number to start reading from (1-based). Default: 1.',
+                description: 'The line number to start reading from (1-based, inclusive).',
             },
-            limit: {
+            endLine: {
                 type: 'integer',
-                description: 'Maximum number of lines to read. Default: 2000.',
+                description: 'The line number to stop reading at (1-based, inclusive).',
             },
         },
         required: ['file_path'],
@@ -36,19 +36,12 @@ export const readTool = (cfg) => ({
         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.`,
+                content: `Path is a directory, not a file: ${filePath}.`,
             };
         }
         // 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');
@@ -57,7 +50,6 @@ export const readTool = (cfg) => ({
                 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 {
@@ -65,18 +57,18 @@ export const readTool = (cfg) => ({
                 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 start = args.startLine !== undefined ? Math.max(1, Number(args.startLine)) : 1;
+        let end = args.endLine !== undefined ? Number(args.endLine) : start + cfg.maxReadLines - 1;
+        // Enforce max read size
+        if (end - start + 1 > cfg.maxReadLines) {
+            end = start + cfg.maxReadLines - 1;
+        }
+        const startIdx = start - 1;
+        const endIdx = end; // slice is exclusive
+        const lines = allLines.slice(startIdx, endIdx);
+        const truncated = allLines.length > endIdx;
         const formatted = lines.map((line, i) => {
             const lineNum = startIdx + i + 1;
             const truncatedLine = line.length > cfg.maxLineLength
@@ -86,7 +78,7 @@ export const readTool = (cfg) => ({
         }).join('\n');
         const header = `File: ${filePath} (${stat.size}b)`;
         const footer = truncated
-            ? `\n\n[showing lines ${offset}-${offset + limit - 1} of ${allLines.length} total]`
+            ? `\n\n[showing lines ${start}-${end} of ${allLines.length} total]`
             : '';
         return {
             toolCallId: '',

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

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

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

@@ -1,9 +1,13 @@
-import type { Tool } from '../../../../tool.js';
+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 declare function getChildProcessEnv(): NodeJS.ProcessEnv;
+export declare function isNoiseDir(name: string): boolean;
+export declare function escapeRegex(s: string): string;
+export declare function globToRegex(pattern: string): RegExp;
 export interface ResolvedConfig {
     toolPrefix: string;
     maxReadSize: number;

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/extensions/code-tools/tools/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,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,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,UAAU,CAatD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwCnD;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 → extensions}/code-tools/tools/shared.js

@@ -50,4 +50,72 @@ const MIME_MAP = {
 export function imageMime(path) {
     return MIME_MAP[extname(path).toLowerCase()] ?? 'application/octet-stream';
 }
+// ── Shared Utilities ──────────────────────────────────────────────────
+export function getChildProcessEnv() {
+    const defaultPaths = ['/usr/local/bin', '/opt/homebrew/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin'];
+    const currentPath = process.env.PATH || '';
+    const currentParts = currentPath.split(':').filter(Boolean);
+    for (const p of defaultPaths) {
+        if (!currentParts.includes(p)) {
+            currentParts.push(p);
+        }
+    }
+    return {
+        ...process.env,
+        PATH: currentParts.join(':'),
+    };
+}
+export function isNoiseDir(name) {
+    return name === 'node_modules' || name === '.git' || name === 'dist' || name === '.next' || name === 'coverage' ||
+        name === '.cache' || name === '.npm' || name === '.local' || name === '.config' || name === '.libra';
+}
+export function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export 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}$`);
+}
 //# sourceMappingURL=shared.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { ChildProcess } from 'node:child_process';
+import { type ToolFactory } from './shared.js';
+export interface ShellToolConfig {
+    toolPrefix: string;
+    registry: ShellRegistry;
+}
+export type ShellToolFactory = (cfg: ShellToolConfig) => ReturnType<ToolFactory>;
+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;
+    onTaskComplete?: (id: string, code: number, output: string) => void;
+    constructor(shellsDir?: string);
+    private nextId;
+    private metaPath;
+    create(command: string, cwd: string, env: Record<string, string>, background?: boolean): Promise<ShellEntry>;
+    get(id: string): ShellEntry | undefined;
+    delete(id: string): boolean;
+    close(): void;
+}
+export declare const runCommandTool: ShellToolFactory;
+export declare const execTool: ShellToolFactory;
+export declare const manageTaskTool: ShellToolFactory;
+//# sourceMappingURL=shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../src/extensions/code-tools/tools/shell.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,UAAU,CAAC,WAAW,CAAC,CAAC;AAEjF,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;AAYD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAS;IACnB,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAE3E,YAAY,SAAS,CAAC,EAAE,MAAM,EAE7B;IAED,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIV,MAAM,CACV,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,UAAU,CAAC,CA4HrB;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAyEtC;IAED,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAqB1B;IAED,KAAK,SAcJ;CACF;AAGD,eAAO,MAAM,cAAc,EAAE,gBAqF3B,CAAC;AAEH,eAAO,MAAM,QAAQ,EAAE,gBAOtB,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,gBAmG3B,CAAC"}