nova-terminal-ai 0.3.4

package/dist/packages/core/src/tools/impl/TaskTool.js

@@ -0,0 +1,172 @@
+// ============================================================================
+// Task Tool - Launch sub-agents for parallel task execution
+// ============================================================================
+import { ToolError } from '../../types/errors.js';
+import { AgentLoop } from '../../session/AgentLoop.js';
+import { buildSystemPrompt } from '../../context/defaultSystemPrompt.js';
+/**
+ * Task handler - launches a sub-agent to perform a specific task
+ *
+ * This enables parallel task execution and specialized agent behaviors:
+ * - code-explorer: Analyzes codebases and provides insights
+ * - research: Gathers information from web and documentation
+ * - executor: Performs actions and executes commands
+ */
+export const taskHandler = async (input) => {
+    // Validate required fields
+    const { description, prompt, subagentType, maxTurns = 10, mode = 'default', name } = input.params;
+    if (typeof description !== 'string' || typeof prompt !== 'string' || typeof subagentType !== 'string') {
+        throw new ToolError('Task requires description, prompt, and subagentType parameters to be strings', 'task');
+    }
+    if (!description || !prompt || !subagentType) {
+        throw new ToolError('Task requires description, prompt, and subagentType parameters', 'task');
+    }
+    const params = {
+        description,
+        prompt,
+        subagentType: subagentType,
+        maxTurns: typeof maxTurns === 'number' ? maxTurns : 10,
+        mode: typeof mode === 'string' ? mode : 'default',
+        name: typeof name === 'string' ? name : undefined,
+    };
+    const sessionManager = input.context.sessionManager;
+    const toolRegistry = input.context.toolRegistry;
+    const modelClient = input.context.modelClient;
+    const contextCompressor = input.context.contextCompressor;
+    if (!sessionManager || !toolRegistry || !modelClient) {
+        throw new ToolError('Task tool requires sessionManager, toolRegistry, and modelClient in context', 'task');
+    }
+    // Create a new session for the sub-agent
+    const subSession = sessionManager.create({
+        workingDirectory: input.context.workingDirectory,
+        model: modelClient.getModel(),
+        streaming: false,
+        parentSessionId: input.context.sessionId,
+    });
+    // Configure approval mode based on task mode
+    let approvalMode = input.context.approvalMode || 'plan';
+    if (mode === 'acceptEdits') {
+        approvalMode = 'plan';
+    }
+    else if (mode === 'bypassPermissions') {
+        approvalMode = 'yolo';
+    }
+    // Build system prompt for sub-agent
+    const subSystemPrompt = buildSystemPrompt({
+        workingDirectory: input.context.workingDirectory,
+        model: modelClient.getModel(),
+        approvalMode,
+    });
+    // Add sub-agent specialization to system prompt
+    const specializations = {
+        'code-explorer': `You are a Code Explorer agent. Your specialty is analyzing codebases, understanding architecture, identifying patterns, and providing code insights. 
+Focus on:
+- Code structure and organization
+- Design patterns and architecture
+- Potential issues and improvements
+- Dependencies and relationships
+
+Be thorough in your analysis and provide actionable insights.`,
+        'research': `You are a Research agent. Your specialty is gathering information, investigating problems, and finding solutions.
+Focus on:
+- Searching for relevant documentation and examples
+- Investigating error messages and issues
+- Finding best practices and patterns
+- Gathering context and background information
+
+Be comprehensive in your research and cite sources when possible.`,
+        'executor': `You are an Executor agent. Your specialty is performing tasks, running commands, and making changes.
+Focus on:
+- Executing commands and scripts
+- Modifying files and code
+- Running tests and builds
+- Implementing solutions
+
+Be careful and precise in your actions, following best practices.`
+    };
+    const specializedSystemPrompt = subSystemPrompt + '\n\n' + specializations[subagentType];
+    // Create agent loop for sub-agent
+    const agentLoop = new AgentLoop({
+        modelClient,
+        sessionManager,
+        toolRegistry,
+        systemPrompt: specializedSystemPrompt,
+        contextCompressor,
+        maxContextTokens: input.context.maxTokens * 8 || 128000,
+        onApprovalRequired: input.context.onApprovalRequired,
+    });
+    // Run the sub-agent
+    const result = await agentLoop.run(subSession.id, prompt);
+    // Get all messages from the sub-session
+    const messages = sessionManager.getMessages(subSession.id);
+    const assistantMessages = messages.filter(m => m.role === 'assistant');
+    // Extract the final response
+    let finalResponse = '';
+    if (assistantMessages.length > 0) {
+        const lastMessage = assistantMessages[assistantMessages.length - 1];
+        const textBlocks = lastMessage.content.filter(block => block.type === 'text');
+        finalResponse = textBlocks.map(block => block.text).join('\n\n');
+    }
+    // Clean up sub-session
+    sessionManager.delete(subSession.id);
+    // Format the result
+    const output = `
+### 🤖 Sub-agent Task Complete
+
+**Task**: ${description}  
+**Type**: ${subagentType}  
+**Agent**: ${name || 'Unnamed'}  
+**Turns**: ${result.turnsCompleted}  
+**Tokens**: ${result.totalInputTokens + result.totalOutputTokens}
+
+---
+
+${finalResponse}
+
+---
+
+**Status**: ✅ Completed successfully
+  `.trim();
+    return { content: output };
+};
+export const taskSchema = {
+    type: 'object',
+    properties: {
+        description: {
+            type: 'string',
+            description: 'Brief description of the task (3-5 words)',
+        },
+        prompt: {
+            type: 'string',
+            description: 'Detailed task description for the sub-agent',
+        },
+        subagentType: {
+            type: 'string',
+            description: 'Type of sub-agent to spawn',
+            enum: ['code-explorer', 'research', 'executor'],
+            default: 'research',
+        },
+        maxTurns: {
+            type: 'number',
+            description: 'Maximum number of agentic turns',
+            default: 10,
+        },
+        mode: {
+            type: 'string',
+            description: 'Permission mode for the sub-agent',
+            enum: ['acceptEdits', 'bypassPermissions', 'default', 'plan'],
+            default: 'default',
+        },
+        name: {
+            type: 'string',
+            description: 'Name for the sub-agent (enables team mode)',
+        },
+        teamName: {
+            type: 'string',
+            description: 'Team to join (enables team mode)',
+        },
+    },
+    required: ['description', 'prompt', 'subagentType'],
+    additionalProperties: false,
+};
+//# sourceMappingURL=TaskTool.js.map

package/dist/packages/core/src/tools/impl/TaskTool.js.map

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

package/dist/packages/core/src/tools/impl/TodoTool.d.ts

@@ -0,0 +1,31 @@
+import type { ToolHandler } from '../../types/tools.js';
+export declare const todoHandler: ToolHandler;
+export declare const todoSchema: {
+    type: "object";
+    properties: {
+        action: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        items: {
+            type: string;
+            description: string;
+        };
+        id: {
+            type: string;
+            description: string;
+        };
+        content: {
+            type: string;
+            description: string;
+        };
+        status: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+    };
+    additionalProperties: boolean;
+};
+//# sourceMappingURL=TodoTool.d.ts.map

package/dist/packages/core/src/tools/impl/TodoTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TodoTool.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/TodoTool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,sBAAsB,CAAC;AA6B7F,eAAO,MAAM,WAAW,EAAE,WA2DzB,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BtB,CAAC"}

package/dist/packages/core/src/tools/impl/TodoTool.js

@@ -0,0 +1,102 @@
+// ============================================================================
+// Todo Tool - Task tracking and progress display
+// ============================================================================
+import { ToolError } from '../../types/errors.js';
+/** In-memory todo storage per session */
+const sessionTodos = new Map();
+function getTodos(sessionId) {
+    if (!sessionTodos.has(sessionId)) {
+        sessionTodos.set(sessionId, []);
+    }
+    return sessionTodos.get(sessionId);
+}
+function renderTodos(todos) {
+    if (todos.length === 0)
+        return 'No tasks tracked.';
+    const statusIcons = {
+        pending: '○',
+        in_progress: '◉',
+        completed: '●',
+    };
+    return todos.map((t) => `${statusIcons[t.status]} [${t.status.padEnd(12)}] ${t.content}`).join('\n');
+}
+export const todoHandler = async (input) => {
+    const { action, items, id, content, status } = input.params;
+    const sessionId = input.context.sessionId;
+    const todos = getTodos(sessionId);
+    switch (action) {
+        case 'list': {
+            return { content: renderTodos(todos) };
+        }
+        case 'create': {
+            if (!items) {
+                throw new ToolError('Missing "items" parameter. Provide a JSON array of task strings.', 'todo');
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(typeof items === 'string' ? items : JSON.stringify(items));
+            }
+            catch {
+                parsed = [String(items)];
+            }
+            for (const item of parsed) {
+                todos.push({ id: `t${todos.length + 1}`, content: String(item), status: 'pending' });
+            }
+            return { content: `Added ${parsed.length} task(s).\n${renderTodos(todos)}` };
+        }
+        case 'update': {
+            if (!id || !status) {
+                throw new ToolError('Missing "id" or "status" parameter.', 'todo');
+            }
+            const target = todos.find((t) => t.id === id || t.id === `t${id}`);
+            if (!target) {
+                throw new ToolError(`Task "${id}" not found.`, 'todo');
+            }
+            const validStatuses = ['pending', 'in_progress', 'completed'];
+            if (!validStatuses.includes(status)) {
+                throw new ToolError(`Invalid status "${status}". Use: ${validStatuses.join(', ')}`, 'todo');
+            }
+            if (content)
+                target.content = content;
+            target.status = status;
+            return { content: renderTodos(todos) };
+        }
+        case 'clear': {
+            todos.length = 0;
+            return { content: 'All tasks cleared.' };
+        }
+        default: {
+            // If no action, show current state
+            return { content: renderTodos(todos) };
+        }
+    }
+};
+export const todoSchema = {
+    type: 'object',
+    properties: {
+        action: {
+            type: 'string',
+            enum: ['list', 'create', 'update', 'clear'],
+            description: 'Action to perform: list (show tasks), create (add tasks), update (change status), clear (remove all)',
+        },
+        items: {
+            type: 'string',
+            description: 'JSON array of task strings to create (for action=create). Example: \'["Task 1", "Task 2"]\'',
+        },
+        id: {
+            type: 'string',
+            description: 'Task ID to update (for action=update)',
+        },
+        content: {
+            type: 'string',
+            description: 'New content for the task (for action=update)',
+        },
+        status: {
+            type: 'string',
+            enum: ['pending', 'in_progress', 'completed'],
+            description: 'New status for the task (for action=update)',
+        },
+    },
+    additionalProperties: false,
+};
+//# sourceMappingURL=TodoTool.js.map

package/dist/packages/core/src/tools/impl/TodoTool.js.map

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

package/dist/packages/core/src/tools/impl/WebFetchTool.d.ts

@@ -0,0 +1,3 @@
+import type { ToolHandler } from '../../types/tools.js';
+export declare const webFetchHandler: ToolHandler;
+//# sourceMappingURL=WebFetchTool.d.ts.map

package/dist/packages/core/src/tools/impl/WebFetchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebFetchTool.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/WebFetchTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,sBAAsB,CAAC;AAG7F,eAAO,MAAM,eAAe,EAAE,WA+E7B,CAAC"}

package/dist/packages/core/src/tools/impl/WebFetchTool.js

@@ -0,0 +1,77 @@
+import { ToolError, TimeoutError } from '../../types/errors.js';
+export const webFetchHandler = async (input) => {
+    const { url, method = 'GET', headers: extraHeaders, body, timeout = 15000, followRedirects = true, maxLength = 50000, } = input.params;
+    try {
+        // Basic URL validation
+        const parsedUrl = new URL(url);
+        if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+            throw new Error(`Unsupported protocol: ${parsedUrl.protocol}`);
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        const response = await fetch(url, {
+            method,
+            headers: {
+                'User-Agent': 'NovaCLI/0.1.0 (Research Agent)',
+                'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,text/markdown;q=0.9,*/*;q=0.8',
+                ...extraHeaders,
+            },
+            body: method !== 'GET' ? body : undefined,
+            signal: controller.signal,
+            redirect: followRedirects ? 'follow' : 'manual',
+        });
+        clearTimeout(timer);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const contentType = response.headers.get('content-type') || '';
+        let content = await response.text();
+        // Truncate if too long
+        if (content.length > maxLength) {
+            content = content.slice(0, maxLength) + `\n\n[Content truncated: showing ${maxLength} of ${content.length} characters]`;
+        }
+        // Basic HTML to text conversion
+        if (contentType.includes('text/html')) {
+            content = htmlToText(content);
+        }
+        return {
+            content,
+            metadata: {
+                url,
+                status: response.status,
+                contentType,
+                contentLength: content.length,
+                finalUrl: response.url,
+            },
+        };
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'AbortError') {
+            throw new TimeoutError(`Fetch timed out after ${timeout}ms`, timeout);
+        }
+        if (err instanceof TypeError && err.message.includes('URL')) {
+            throw new ToolError(`Invalid URL: ${url}`, 'web_fetch');
+        }
+        throw new ToolError(`Failed to fetch URL: ${err.message}`, 'web_fetch');
+    }
+};
+/** Basic HTML to text converter */
+function htmlToText(html) {
+    return html
+        // Remove scripts and styles
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        // Remove HTML tags
+        .replace(/<[^>]+>/g, ' ')
+        // Decode HTML entities
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        // Collapse whitespace
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=WebFetchTool.js.map

package/dist/packages/core/src/tools/impl/WebFetchTool.js.map

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

package/dist/packages/core/src/tools/impl/WebSearchTool.d.ts

@@ -0,0 +1,3 @@
+import type { ToolHandler } from '../../types/tools.js';
+export declare const webSearchHandler: ToolHandler;
+//# sourceMappingURL=WebSearchTool.d.ts.map

package/dist/packages/core/src/tools/impl/WebSearchTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSearchTool.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/WebSearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,sBAAsB,CAAC;AAG7F,eAAO,MAAM,gBAAgB,EAAE,WAqF9B,CAAC"}

package/dist/packages/core/src/tools/impl/WebSearchTool.js

@@ -0,0 +1,67 @@
+import { ToolError } from '../../types/errors.js';
+export const webSearchHandler = async (input) => {
+    const { query, maxResults = 10, language, region, safeSearch = true, freshness } = input.params;
+    // This is a placeholder implementation. In production, integrate with a search API
+    // such as Google Custom Search, Bing Web Search, or Serper API.
+    const apiKey = process.env.NOVA_SEARCH_API_KEY || process.env.SERPER_API_KEY;
+    if (!apiKey) {
+        // Fallback: provide a helpful message about configuration
+        return {
+            content: `[Web Search Not Configured]\n\nQuery: ${query}\n\nTo enable web search, you need a Serper.dev API key:\n\n  1. Register at https://serper.dev (free tier: 2500 queries/month)\n  2. Get your API key from the dashboard\n  3. Configure by ONE of:\n     - Environment variable: set NOVA_SEARCH_API_KEY=<your-key>\n     - Config file: add to ~/.nova/config.yaml under search.apiKey`,
+            metadata: { query, configured: false },
+        };
+    }
+    try {
+        // Serper.dev API integration
+        const response = await fetch('https://google.serper.dev/search', {
+            method: 'POST',
+            headers: {
+                'X-API-KEY': apiKey,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                q: query,
+                num: maxResults,
+                gl: region,
+                hl: language,
+                safe: safeSearch ? 'active' : 'off',
+                tbs: freshness ? `qdr:${freshness}` : undefined,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Search API returned ${response.status}: ${response.statusText}`);
+        }
+        const data = await response.json();
+        const organic = (data.organic || []);
+        if (organic.length === 0) {
+            return {
+                content: `No results found for: "${query}"`,
+                metadata: { query, count: 0 },
+            };
+        }
+        const results = organic
+            .map((r, i) => `${i + 1}. ${r.title}\n   ${r.link}\n   ${r.snippet}`)
+            .join('\n\n');
+        const knowledgeGraph = data.knowledgeGraph;
+        let output = '';
+        if (knowledgeGraph?.title) {
+            output += `Knowledge Graph: ${knowledgeGraph.title}\n`;
+            if (knowledgeGraph.description)
+                output += `${knowledgeGraph.description}\n`;
+            output += '\n';
+        }
+        output += results;
+        return {
+            content: output,
+            metadata: {
+                query,
+                count: organic.length,
+                hasKnowledgeGraph: !!knowledgeGraph,
+            },
+        };
+    }
+    catch (err) {
+        throw new ToolError(`Web search failed: ${err.message}`, 'web_search');
+    }
+};
+//# sourceMappingURL=WebSearchTool.js.map

package/dist/packages/core/src/tools/impl/WebSearchTool.js.map

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

package/dist/packages/core/src/tools/impl/WriteFileTool.d.ts

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

package/dist/packages/core/src/tools/impl/WriteFileTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteFileTool.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/WriteFileTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAuC,MAAM,sBAAsB,CAAC;AAG7F,eAAO,MAAM,gBAAgB,EAAE,WA2C9B,CAAC"}

package/dist/packages/core/src/tools/impl/WriteFileTool.js

@@ -0,0 +1,41 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ToolError } from '../../types/errors.js';
+export const writeFileHandler = async (input) => {
+    const { filePath, content, createDirectories = false, encoding = 'utf-8' } = input.params;
+    const resolvedPath = path.resolve(filePath);
+    try {
+        if (createDirectories) {
+            const dir = path.dirname(resolvedPath);
+            await fs.mkdir(dir, { recursive: true });
+        }
+        // Verify parent directory exists
+        const dir = path.dirname(resolvedPath);
+        try {
+            await fs.access(dir, fs.constants.W_OK);
+        }
+        catch {
+            throw new ToolError(`Cannot write to directory: ${dir}`, 'write_file');
+        }
+        await fs.writeFile(resolvedPath, content, { encoding });
+        return {
+            content: `Successfully wrote ${content.length} characters to ${resolvedPath}`,
+            metadata: {
+                path: resolvedPath,
+                size: Buffer.byteLength(content, encoding),
+                encoding,
+            },
+            filesAffected: [resolvedPath],
+        };
+    }
+    catch (err) {
+        if (err instanceof ToolError)
+            throw err;
+        const code = err.code;
+        if (code === 'EACCES') {
+            throw new ToolError(`Permission denied: ${filePath}`, 'write_file', undefined, { code });
+        }
+        throw new ToolError(`Failed to write file: ${err.message}`, 'write_file');
+    }
+};
+//# sourceMappingURL=WriteFileTool.js.map

package/dist/packages/core/src/tools/impl/WriteFileTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteFileTool.js","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/WriteFileTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAgB,KAAK,EAAE,KAAuB,EAA8B,EAAE;IACzG,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,GAAG,KAAK,EAAE,QAAQ,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC,MAKlF,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACvC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,iCAAiC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,SAAS,CAAC,8BAA8B,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAExD,OAAO;YACL,OAAO,EAAE,sBAAsB,OAAO,CAAC,MAAM,kBAAkB,YAAY,EAAE;YAC7E,QAAQ,EAAE;gBACR,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAC1C,QAAQ;aACT;YACD,aAAa,EAAE,CAAC,YAAY,CAAC;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS;YAAE,MAAM,GAAG,CAAC;QACxC,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CAAC,sBAAsB,QAAQ,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,yBAA0B,GAAa,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;IACvF,CAAC;AACH,CAAC,CAAC"}

package/dist/packages/core/src/tools/impl/index.d.ts

@@ -0,0 +1,14 @@
+export { readFileHandler } from './ReadFileTool.js';
+export { writeFileHandler } from './WriteFileTool.js';
+export { editFileHandler } from './EditFileTool.js';
+export { listDirectoryHandler } from './ListDirectoryTool.js';
+export { searchFileHandler } from './SearchFileTool.js';
+export { searchContentHandler } from './SearchContentTool.js';
+export { shellHandler } from './ShellTool.js';
+export { webSearchHandler } from './WebSearchTool.js';
+export { webFetchHandler } from './WebFetchTool.js';
+export { memoryReadHandler, memoryWriteHandler } from './MemoryTool.js';
+export { todoHandler } from './TodoTool.js';
+export { taskHandler } from './TaskTool.js';
+export { imageProcessorHandler, extractTextFromImage, processImage } from './ImageProcessorTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/tools/impl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACb,MAAM,yBAAyB,CAAC"}

package/dist/packages/core/src/tools/impl/index.js

@@ -0,0 +1,21 @@
+// ============================================================================
+// Tool Implementations Barrel Export
+// ============================================================================
+// File operations
+export { readFileHandler } from './ReadFileTool.js';
+export { writeFileHandler } from './WriteFileTool.js';
+export { editFileHandler } from './EditFileTool.js';
+export { listDirectoryHandler } from './ListDirectoryTool.js';
+export { searchFileHandler } from './SearchFileTool.js';
+export { searchContentHandler } from './SearchContentTool.js';
+// Shell and web
+export { shellHandler } from './ShellTool.js';
+export { webSearchHandler } from './WebSearchTool.js';
+export { webFetchHandler } from './WebFetchTool.js';
+// Memory and task management
+export { memoryReadHandler, memoryWriteHandler } from './MemoryTool.js';
+export { todoHandler } from './TodoTool.js';
+export { taskHandler } from './TaskTool.js';
+// New capabilities - Image Processing (OCR)
+export { imageProcessorHandler, extractTextFromImage, processImage } from './ImageProcessorTool.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/core/src/tools/impl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../core/src/tools/impl/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,6BAA6B;AAC7B,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,4CAA4C;AAC5C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACb,MAAM,yBAAyB,CAAC"}

package/dist/packages/core/src/tools/index.d.ts

@@ -0,0 +1,16 @@
+export { FileProcessorTool, fileProcessorTool } from './impl/FileProcessorTool.js';
+export { fileProcessor, FileProcessor } from './impl/FileProcessor.js';
+export { fileProcessorSchema, fileProcessorToolDefinition } from './schemas/fileProcessorSchema.js';
+export { readFileHandler } from './impl/ReadFileTool.js';
+export { writeFileHandler } from './impl/WriteFileTool.js';
+export { editFileHandler } from './impl/EditFileTool.js';
+export { listDirectoryHandler } from './impl/ListDirectoryTool.js';
+export { searchFileHandler } from './impl/SearchFileTool.js';
+export { searchContentHandler } from './impl/SearchContentTool.js';
+export { shellHandler } from './impl/ShellTool.js';
+export { webSearchHandler } from './impl/WebSearchTool.js';
+export { webFetchHandler } from './impl/WebFetchTool.js';
+export { memoryReadHandler, memoryWriteHandler } from './impl/MemoryTool.js';
+export { todoHandler } from './impl/TodoTool.js';
+export { taskHandler } from './impl/TaskTool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/packages/core/src/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../core/src/tools/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAGpG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}