jiva-core 0.3.3-dev.dc3cf03 → 0.3.4-dev.3c78d8b

package/dist/code/tools/grep.js

@@ -0,0 +1,147 @@
+import path from 'path';
+import fs from 'fs';
+const MAX_MATCHES = 100;
+const MAX_FILE_SIZE = 1 * 1024 * 1024; // 1MB per file
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', '.next', 'build', '.cache',
+    '__pycache__', '.mypy_cache', 'target', 'vendor',
+]);
+export const GrepTool = {
+    name: 'grep',
+    description: `Search for a regex pattern across files in the workspace.
+
+REQUIRED parameter: "pattern" (string) — the regex to search for.
+Example: {"pattern": "class UserService"}
+Example: {"pattern": "TODO|FIXME", "include": "*.ts"}
+
+Returns matches in the format: file:line: content`,
+    parameters: {
+        type: 'object',
+        properties: {
+            pattern: {
+                type: 'string',
+                description: 'Regular expression pattern to search for',
+            },
+            path: {
+                type: 'string',
+                description: 'File or directory to search in (default: workspace root)',
+            },
+            include: {
+                type: 'string',
+                description: 'Glob pattern to filter files (e.g. "*.ts", "*.py")',
+            },
+            case_insensitive: {
+                type: 'boolean',
+                description: 'Case-insensitive search (default: false)',
+            },
+        },
+        required: ['pattern'],
+    },
+    async execute(args, ctx) {
+        const patternStr = args.pattern;
+        const searchPath = args.path
+            ? (path.isAbsolute(args.path) ? args.path : path.resolve(ctx.workspaceDir, args.path))
+            : ctx.workspaceDir;
+        const includePattern = args.include;
+        const caseInsensitive = args.case_insensitive ?? false;
+        let regex;
+        try {
+            regex = new RegExp(patternStr, caseInsensitive ? 'i' : '');
+        }
+        catch (e) {
+            return `Error: Invalid regex pattern: ${e instanceof Error ? e.message : String(e)}`;
+        }
+        const results = [];
+        let truncated = false;
+        try {
+            const stat = fs.statSync(searchPath);
+            if (stat.isFile()) {
+                searchFile(searchPath, regex, ctx.workspaceDir, results, { max: MAX_MATCHES });
+            }
+            else {
+                searchDir(searchPath, regex, ctx.workspaceDir, results, includePattern, {
+                    max: MAX_MATCHES,
+                    truncated: () => { truncated = true; },
+                });
+            }
+        }
+        catch (e) {
+            return `Error: ${e instanceof Error ? e.message : String(e)}`;
+        }
+        if (results.length === 0) {
+            return `No matches found for: ${patternStr}`;
+        }
+        let output = results.join('\n');
+        if (truncated) {
+            output += `\n\n[Results truncated at ${MAX_MATCHES} matches. Narrow the search path or pattern.]`;
+        }
+        return output;
+    },
+};
+function matchesInclude(filename, include) {
+    if (!include)
+        return true;
+    // Simple glob matching: support *.ext patterns
+    if (include.startsWith('*.')) {
+        const ext = include.slice(1);
+        return filename.endsWith(ext);
+    }
+    return filename.includes(include);
+}
+function searchFile(filePath, regex, workspaceDir, results, opts) {
+    if (results.length >= opts.max)
+        return;
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    }
+    catch {
+        return;
+    }
+    if (stat.size > MAX_FILE_SIZE)
+        return;
+    let content;
+    try {
+        content = fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return;
+    }
+    const relPath = path.relative(workspaceDir, filePath);
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length && results.length < opts.max; i++) {
+        if (regex.test(lines[i])) {
+            results.push(`${relPath}:${i + 1}: ${lines[i].trim()}`);
+        }
+    }
+}
+function searchDir(dirPath, regex, workspaceDir, results, include, opts) {
+    if (results.length >= opts.max) {
+        opts.truncated();
+        return;
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (results.length >= opts.max) {
+            opts.truncated();
+            return;
+        }
+        if (entry.isDirectory()) {
+            if (IGNORE_DIRS.has(entry.name) || entry.name.startsWith('.'))
+                continue;
+            searchDir(path.join(dirPath, entry.name), regex, workspaceDir, results, include, opts);
+        }
+        else if (entry.isFile()) {
+            if (!matchesInclude(entry.name, include))
+                continue;
+            searchFile(path.join(dirPath, entry.name), regex, workspaceDir, results, opts);
+        }
+    }
+}
+//# sourceMappingURL=grep.js.map

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

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

package/dist/code/tools/index.d.ts

@@ -0,0 +1,31 @@
+import type { LspManager } from '../lsp/manager.js';
+export interface CodeToolContext {
+    workspaceDir: string;
+    lsp: LspManager;
+    signal?: AbortSignal;
+    /** Current agent depth — used by spawn tool to limit recursion */
+    depth?: number;
+    /** Max allowed depth */
+    maxDepth?: number;
+    /** Callback to spawn a child CodeAgent (injected by CodeAgent) */
+    spawnChildAgent?: (task: string, context?: string) => Promise<string>;
+}
+export interface ICodeTool {
+    name: string;
+    description: string;
+    /** JSON Schema object for tool parameters */
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    execute(args: Record<string, unknown>, ctx: CodeToolContext): Promise<string>;
+}
+export { ReadFileTool } from './read.js';
+export { EditFileTool } from './edit.js';
+export { WriteFileTool } from './write.js';
+export { GlobTool } from './glob.js';
+export { GrepTool } from './grep.js';
+export { BashTool } from './bash.js';
+export { SpawnCodeAgentTool } from './spawn.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/E;AAGD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/code/tools/index.js

@@ -0,0 +1,9 @@
+// Re-export all tools
+export { ReadFileTool } from './read.js';
+export { EditFileTool } from './edit.js';
+export { WriteFileTool } from './write.js';
+export { GlobTool } from './glob.js';
+export { GrepTool } from './grep.js';
+export { BashTool } from './bash.js';
+export { SpawnCodeAgentTool } from './spawn.js';
+//# sourceMappingURL=index.js.map

package/dist/code/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/code/tools/index.ts"],"names":[],"mappings":"AA0BA,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/code/tools/read.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/code/tools/read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAK7D,eAAO,MAAM,YAAY,EAAE,SAuD1B,CAAC"}

package/dist/code/tools/read.js

@@ -0,0 +1,120 @@
+import path from 'path';
+import fs from 'fs';
+const MAX_LINES = 2000;
+const MAX_BYTES = 50 * 1024; // 50KB
+export const ReadFileTool = {
+    name: 'read_file',
+    description: `Read the contents of a file or list a directory.
+
+REQUIRED parameter: "path" (string) — absolute path to file or directory.
+Example: {"path": "/workspace/src/index.ts"}
+Example: {"path": "/workspace/src/index.ts", "offset": 100, "limit": 50}
+
+Do NOT pass "command", "query", or "pattern" to this tool — use bash or grep for those.
+
+For files:
+- Returns file content with line numbers (cat -n style)
+- Limits to ${MAX_LINES} lines and ${MAX_BYTES / 1024}KB
+- Use offset and limit to paginate large files
+- Binary files return "[binary file, cannot display]"
+
+For directories:
+- Returns a listing with [FILE] and [DIR] prefixes`,
+    parameters: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Absolute path to the file or directory to read',
+            },
+            offset: {
+                type: 'number',
+                description: 'Line number to start reading from (1-indexed, default: 1)',
+            },
+            limit: {
+                type: 'number',
+                description: `Max lines to read (default: ${MAX_LINES})`,
+            },
+        },
+        required: ['path'],
+    },
+    async execute(args, ctx) {
+        const rawPath = args.path;
+        const filePath = path.isAbsolute(rawPath) ? rawPath : path.resolve(ctx.workspaceDir, rawPath);
+        let stat;
+        try {
+            stat = fs.statSync(filePath);
+        }
+        catch {
+            return `Error: Path not found: ${filePath}`;
+        }
+        if (stat.isDirectory()) {
+            return listDirectory(filePath);
+        }
+        return readFile(filePath, args.offset, args.limit);
+    },
+};
+function listDirectory(dirPath) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    }
+    catch (e) {
+        return `Error reading directory: ${e instanceof Error ? e.message : String(e)}`;
+    }
+    const lines = [`Directory: ${dirPath}`, ''];
+    entries.sort((a, b) => {
+        // Dirs first, then files, alphabetically
+        if (a.isDirectory() !== b.isDirectory())
+            return a.isDirectory() ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+    for (const entry of entries) {
+        const tag = entry.isDirectory() ? '[DIR] ' : '[FILE]';
+        lines.push(`${tag} ${entry.name}`);
+    }
+    return lines.join('\n');
+}
+function readFile(filePath, offset, limit) {
+    let buffer;
+    try {
+        buffer = fs.readFileSync(filePath);
+    }
+    catch (e) {
+        return `Error reading file: ${e instanceof Error ? e.message : String(e)}`;
+    }
+    // Binary detection: look for null bytes in the first 8KB
+    if (isBinary(buffer)) {
+        return `[binary file: ${filePath}]`;
+    }
+    // Enforce byte limit
+    let text = buffer.slice(0, MAX_BYTES).toString('utf-8');
+    const wasTruncatedByBytes = buffer.length > MAX_BYTES;
+    const allLines = text.split('\n');
+    const startLine = Math.max(1, (offset ?? 1));
+    const maxLines = Math.min(limit ?? MAX_LINES, MAX_LINES);
+    const slice = allLines.slice(startLine - 1, startLine - 1 + maxLines);
+    const truncatedByLines = startLine - 1 + maxLines < allLines.length;
+    const numbered = slice.map((line, i) => {
+        const lineNo = String(startLine + i).padStart(6);
+        return `${lineNo}\t${line}`;
+    });
+    let result = numbered.join('\n');
+    if (wasTruncatedByBytes) {
+        result += `\n\n[File truncated at ${MAX_BYTES / 1024}KB. Use offset/limit to read more.]`;
+    }
+    else if (truncatedByLines) {
+        const remaining = allLines.length - (startLine - 1 + maxLines);
+        result += `\n\n[${remaining} more line(s). Use offset=${startLine + maxLines} to continue.]`;
+    }
+    return result;
+}
+function isBinary(buffer) {
+    const checkLength = Math.min(8192, buffer.length);
+    for (let i = 0; i < checkLength; i++) {
+        if (buffer[i] === 0)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=read.js.map

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

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

package/dist/code/tools/spawn.d.ts

@@ -0,0 +1,3 @@
+import type { ICodeTool } from './index.js';
+export declare const SpawnCodeAgentTool: ICodeTool;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/code/tools/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/code/tools/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAE7D,eAAO,MAAM,kBAAkB,EAAE,SAoDhC,CAAC"}

package/dist/code/tools/spawn.js

@@ -0,0 +1,49 @@
+export const SpawnCodeAgentTool = {
+    name: 'spawn_code_agent',
+    description: `Spawn a child code agent to handle a focused sub-task.
+
+Use when you need to delegate a specific, well-scoped coding task to a focused sub-agent.
+The child agent has access to the same tools (read, edit, write, glob, grep, bash).
+
+Examples:
+- "Write unit tests for the authentication module in src/auth/"
+- "Refactor the UserService class to use dependency injection"
+- "Fix all TypeScript errors in the src/models/ directory"
+
+The child agent completes its task and returns a summary of what it did.
+Depth is limited to prevent infinite nesting.`,
+    parameters: {
+        type: 'object',
+        properties: {
+            task: {
+                type: 'string',
+                description: 'The specific coding task for the child agent to complete',
+            },
+            context: {
+                type: 'string',
+                description: 'Additional context or constraints for the child agent',
+            },
+        },
+        required: ['task'],
+    },
+    async execute(args, ctx) {
+        const task = args.task;
+        const context = args.context;
+        if (!ctx.spawnChildAgent) {
+            return 'Error: Sub-agent spawning is not available in this context.';
+        }
+        const currentDepth = ctx.depth ?? 0;
+        const maxDepth = ctx.maxDepth ?? 2;
+        if (currentDepth >= maxDepth) {
+            return `Error: Maximum agent depth (${maxDepth}) reached. Cannot spawn further sub-agents.`;
+        }
+        try {
+            const result = await ctx.spawnChildAgent(task, context);
+            return `Sub-agent completed task.\n\nResult:\n${result}`;
+        }
+        catch (e) {
+            return `Sub-agent failed: ${e instanceof Error ? e.message : String(e)}`;
+        }
+    },
+};
+//# sourceMappingURL=spawn.js.map

package/dist/code/tools/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/code/tools/spawn.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;8CAW+B;IAE5C,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uDAAuD;aACrE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAoB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAA6B,CAAC;QAEnD,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,6DAA6D,CAAC;QACvE,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEnC,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,+BAA+B,QAAQ,6CAA6C,CAAC;QAC9F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxD,OAAO,yCAAyC,MAAM,EAAE,CAAC;QAC3D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,qBAAqB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/code/tools/write.d.ts

@@ -0,0 +1,3 @@
+import type { ICodeTool } from './index.js';
+export declare const WriteFileTool: ICodeTool;
+//# sourceMappingURL=write.d.ts.map

package/dist/code/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../src/code/tools/write.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAE7D,eAAO,MAAM,aAAa,EAAE,SA+E3B,CAAC"}

package/dist/code/tools/write.js

@@ -0,0 +1,82 @@
+import path from 'path';
+import fs from 'fs';
+import { diffLines } from 'diff';
+import { fileLock } from '../file-lock.js';
+export const WriteFileTool = {
+    name: 'write_file',
+    description: `Create a new file or completely overwrite an existing file with new content.
+
+Use this when:
+- Creating a new file from scratch
+- Rewriting an entire file
+
+Prefer edit_file for partial edits. write_file is for when you need to replace the whole file.
+
+Returns a summary of changes and LSP diagnostics (if any errors).`,
+    parameters: {
+        type: 'object',
+        properties: {
+            file_path: {
+                type: 'string',
+                description: 'Absolute path to the file to write',
+            },
+            content: {
+                type: 'string',
+                description: 'The full content to write to the file',
+            },
+        },
+        required: ['file_path', 'content'],
+    },
+    async execute(args, ctx) {
+        const rawPath = args.file_path;
+        const filePath = path.isAbsolute(rawPath) ? rawPath : path.resolve(ctx.workspaceDir, rawPath);
+        const content = args.content;
+        return fileLock.withLock(filePath, async () => {
+            // Read existing content for diff
+            let before = '';
+            const existed = fs.existsSync(filePath);
+            if (existed) {
+                try {
+                    before = fs.readFileSync(filePath, 'utf-8');
+                }
+                catch {
+                    before = '';
+                }
+            }
+            // Write the file
+            try {
+                const dir = path.dirname(filePath);
+                fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(filePath, content, 'utf-8');
+            }
+            catch (e) {
+                return `Error writing file: ${e instanceof Error ? e.message : String(e)}`;
+            }
+            // Count changes
+            let additions = 0;
+            let deletions = 0;
+            for (const change of diffLines(before, content)) {
+                if (change.added)
+                    additions += change.count ?? 0;
+                if (change.removed)
+                    deletions += change.count ?? 0;
+            }
+            const relPath = path.relative(ctx.workspaceDir, filePath);
+            const action = existed ? 'Updated' : 'Created';
+            // LSP diagnostics
+            let diagnosticsOutput = '';
+            try {
+                await ctx.lsp.touchFile(filePath);
+                const errors = ctx.lsp.getErrorsForFile(filePath);
+                if (errors) {
+                    diagnosticsOutput = `\n\nLSP errors detected — please fix:\n<diagnostics file="${filePath}">\n${errors}\n</diagnostics>`;
+                }
+            }
+            catch {
+                // LSP should not block the write result
+            }
+            return `${action} ${relPath} (+${additions}/-${deletions} lines).${diagnosticsOutput}`;
+        });
+    },
+};
+//# sourceMappingURL=write.js.map

package/dist/code/tools/write.js.map

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

package/dist/core/agent-interface.d.ts

@@ -0,0 +1,54 @@
+/**
+ * IAgent - Shared interface implemented by both DualAgent and CodeAgent.
+ *
+ * Placing this in src/core/ allows both the CLI and HTTP layers to import
+ * it without creating circular dependencies.
+ */
+import type { WorkspaceManager } from './workspace.js';
+import type { ConversationManager } from './conversation-manager.js';
+import type { Message } from '../models/base.js';
+export interface AgentChatResponse {
+    content: string;
+    toolsUsed: string[];
+    iterations: number;
+    /**
+     * Present only in DualAgent responses (contains the plan produced by the manager).
+     * Absent in CodeAgent responses.
+     */
+    plan?: {
+        subtasks: string[];
+        reasoning: string;
+    };
+}
+export interface IAgent {
+    chat(message: string): Promise<AgentChatResponse>;
+    cleanup(): Promise<void>;
+    getWorkspace(): WorkspaceManager;
+    getMCPManager(): {
+        getServerStatus(): Array<{
+            name: string;
+            connected: boolean;
+            enabled: boolean;
+            toolCount: number;
+        }>;
+        getClient(): {
+            getAllTools(): Array<{
+                name: string;
+                description: string;
+            }>;
+        };
+    };
+    resetConversation(): void;
+    getConversationHistory(): Message[];
+    getConversationManager(): ConversationManager | null | undefined;
+    saveConversation(): Promise<string | null>;
+    loadConversation(id: string): Promise<void>;
+    listConversations(): Promise<Array<{
+        id: string;
+        title?: string;
+        updated: string | number;
+        messageCount: number;
+        workspace?: string;
+    }>>;
+}
+//# sourceMappingURL=agent-interface.d.ts.map

package/dist/core/agent-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-interface.d.ts","sourceRoot":"","sources":["../../src/core/agent-interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,YAAY,IAAI,gBAAgB,CAAC;IACjC,aAAa,IAAI;QACf,eAAe,IAAI,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAC;YAAC,OAAO,EAAE,OAAO,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpG,SAAS,IAAI;YAAE,WAAW,IAAI,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,WAAW,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC9E,CAAC;IACF,iBAAiB,IAAI,IAAI,CAAC;IAC1B,sBAAsB,IAAI,OAAO,EAAE,CAAC;IACpC,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,GAAG,SAAS,CAAC;IACjE,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC;QACjC,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC,CAAC;CACL"}

package/dist/core/agent-interface.js

@@ -0,0 +1,8 @@
+/**
+ * IAgent - Shared interface implemented by both DualAgent and CodeAgent.
+ *
+ * Placing this in src/core/ allows both the CLI and HTTP layers to import
+ * it without creating circular dependencies.
+ */
+export {};
+//# sourceMappingURL=agent-interface.js.map

package/dist/core/agent-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-interface.js","sourceRoot":"","sources":["../../src/core/agent-interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/client-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-agent.d.ts","sourceRoot":"","sources":["../../src/core/client-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAKhE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBjD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY,CAAM,0BAA0B;IACnD,QAAQ,aAAa,CAAI,mCAAmC;IAC5D,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,GAAG,mBAAmB,GAAG,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;IACnG,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAYD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB;IAQzE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB,+DAA+D;IAC/D,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAmBjC;;;;;;;;OAQG;YACW,uBAAuB;IAmHrC;;OAEG;IACG,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IA8G5B;;;OAGG;YACW,4BAA4B;IAkE1C;;;;;OAKG;YACW,sBAAsB;IAgFpC;;OAEG;IACH,OAAO,CAAC,eAAe;IA+CvB;;OAEG;YACW,eAAe;IAsC7B;;;OAGG;YACW,UAAU;IA2BxB;;;;OAIG;YACW,6BAA6B;IAuD3C;;OAEG;YACW,oBAAoB;IAoDlC;;;;OAIG;YACW,iBAAiB;IA+C/B;;;OAGG;YACW,uBAAuB;IA+ErC;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;CAG7B"}
+{"version":3,"file":"client-agent.d.ts","sourceRoot":"","sources":["../../src/core/client-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAKhE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAgBjD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY,CAAM,0BAA0B;IACnD,QAAQ,aAAa,CAAI,mCAAmC;IAC5D,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,GAAG,mBAAmB,GAAG,SAAS,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;IACnG,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAYD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAAa;IAGjC,OAAO,CAAC,eAAe,CAAyB;gBAEpC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB;IAQzE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB,+DAA+D;IAC/D,cAAc,IAAI,IAAI;IAItB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAmBjC;;;;;;;;OAQG;YACW,uBAAuB;IAmHrC;;OAEG;IACG,QAAQ,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,YAAY,EAAE,YAAY,EAC1B,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IA8G5B;;;OAGG;YACW,4BAA4B;IAkE1C;;;;;OAKG;YACW,sBAAsB;IAgFpC;;OAEG;IACH,OAAO,CAAC,eAAe;IAsDvB;;OAEG;YACW,eAAe;IAsC7B;;;OAGG;YACW,UAAU;IA2BxB;;;;OAIG;YACW,6BAA6B;IAuD3C;;OAEG;YACW,oBAAoB;IAoDlC;;;;OAIG;YACW,iBAAiB;IA+C/B;;;OAGG;YACW,uBAAuB;IAgGrC;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;CAG7B"}

package/dist/core/client-agent.js

@@ -423,7 +423,10 @@ Respond ONLY with valid JSON:
         const issues = [];
         // Zero-tools guard: if Worker used no tools at all and this is not a purely
         // informational/conversational task, reject immediately
-        if (workerResult.toolsUsed.length === 0 && involvementLevel !== InvolvementLevel.MINIMAL) {
+        // Exception: if the Worker has structured failedTools, it DID try — the
+        // tools simply errored. Raising a "no tools used" issue on top of real
+        // failures creates a misleading retry loop rather than an honest exit.
+        if (workerResult.toolsUsed.length === 0 && workerResult.failedTools.length === 0 && involvementLevel !== InvolvementLevel.MINIMAL) {
             const isConversational = requirements.every(r => r.type === 'information' || r.type === 'other');
             if (!isConversational) {
                 issues.push('Worker completed the task without using any tools. ' +
@@ -442,8 +445,12 @@ Respond ONLY with valid JSON:
                 }
             }
         }
-        // Check if Worker succeeded
-        if (!workerResult.success) {
+        // Check if Worker succeeded.
+        // If failedTools is non-empty the Worker already proved it tried — the failure
+        // is evidence-backed. Raising a generic "retry with appropriate tool usage"
+        // issue would just queue another pointless attempt. Let it through; synthesis
+        // will report the specific failures to the user.
+        if (!workerResult.success && workerResult.failedTools.length === 0) {
             issues.push('Worker did not complete the task successfully. The task needs to be retried with appropriate tool usage.');
         }
         return { issues };
@@ -667,6 +674,22 @@ Respond ONLY with the correction instruction text, nothing else.`;
         if (issues.length === 0) {
             return { confidence: 'high', progressMade: true };
         }
+        // Data-driven short-circuit: if the Worker reported structured tool failures,
+        // we know exactly what happened — no LLM inference needed.
+        // suggestedStrategy is 'escalate' because rephrasing the instruction cannot
+        // fix a tool that is fundamentally erroring (wrong path, permissions, etc.).
+        if (workerResult.failedTools.length > 0) {
+            const failureSummary = workerResult.failedTools
+                .map(f => `${f.toolName} (${f.attempts} attempt${f.attempts !== 1 ? 's' : ''}) — ${f.lastError}`)
+                .join('; ');
+            logger.info(`[Client] Data-driven CompletionSignal: tool_failure — ${failureSummary}`);
+            return {
+                confidence: 'none',
+                progressMade: false,
+                blockerType: 'tool_failure',
+                suggestedStrategy: 'escalate',
+            };
+        }
         const contextBlock = agentContext ? `\n${serializeAgentContext(agentContext, 'client')}` : '';
         const signalPrompt = `You are analyzing a subtask execution to produce a CompletionSignal.