codevf 1.0.0 → 1.0.1

package/dist/mcp/index.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * CodeVF MCP Server
+ * Enables Claude Code to delegate tasks to human engineers
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { ConfigManager } from '../lib/config/manager.js';
+import { TokenManager } from '../lib/auth/token-manager.js';
+import { ApiClient } from '../lib/api/client.js';
+import { TasksApi } from '../lib/api/tasks.js';
+import { InstantTool } from './tools/instant.js';
+import { ChatTool } from './tools/chat.js';
+import { logger, LogLevel } from '../lib/utils/logger.js';
+/**
+ * Initialize MCP Server
+ */
+async function main() {
+    // Set log level from environment
+    if (process.env.DEBUG) {
+        logger.setLevel(LogLevel.DEBUG);
+    }
+    // Check if configured
+    const configManager = new ConfigManager('mcp-config.json');
+    if (!configManager.exists()) {
+        console.error('Error: Not configured. Run: codevf setup');
+        process.exit(1);
+    }
+    // Load configuration
+    let config;
+    try {
+        config = configManager.load();
+    }
+    catch (error) {
+        console.error('Error loading config:', error.message);
+        process.exit(1);
+    }
+    // Initialize components
+    const tokenManager = new TokenManager(configManager);
+    const apiClient = new ApiClient(config.baseUrl, tokenManager);
+    const defaultProjectId = config.defaults?.projectId || '1';
+    const tasksApi = new TasksApi(apiClient, config.baseUrl, defaultProjectId);
+    const instantTool = new InstantTool(tasksApi, tokenManager, config.baseUrl);
+    const chatTool = new ChatTool(tasksApi, config.baseUrl);
+    // Create MCP server
+    const server = new Server({
+        name: 'codevf',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: [
+                {
+                    name: 'codevf-instant',
+                    description: 'Get quick validation from human engineer (1-10 credits). Use for: testing if fix works, identifying errors, quick questions. Returns single response from engineer.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            message: {
+                                type: 'string',
+                                description: 'Question or request for the engineer',
+                            },
+                            maxCredits: {
+                                type: 'number',
+                                description: 'Maximum credits to spend (1-10, default: 10)',
+                                default: 10,
+                                minimum: 1,
+                                maximum: 10,
+                            },
+                        },
+                        required: ['message'],
+                    },
+                },
+                {
+                    name: 'codevf-chat',
+                    description: 'Start extended debugging session with human engineer (4-1920 credits). Use for: complex bugs, multi-step debugging, architecture questions. Returns session URL for monitoring.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            message: {
+                                type: 'string',
+                                description: 'Initial message or problem description for the engineer',
+                            },
+                            maxCredits: {
+                                type: 'number',
+                                description: 'Maximum credits to spend (4-1920, default: 240). Rate: 2 credits/minute',
+                                default: 240,
+                                minimum: 4,
+                                maximum: 1920,
+                            },
+                        },
+                        required: ['message'],
+                    },
+                },
+            ],
+        };
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            let result;
+            switch (name) {
+                case 'codevf-instant':
+                    result = await instantTool.execute(args);
+                    break;
+                case 'codevf-chat':
+                    result = await chatTool.execute(args);
+                    break;
+                default:
+                    result = {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Unknown tool: ${name}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+            }
+            return result;
+        }
+        catch (error) {
+            logger.error('Tool execution error', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Start server
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('CodeVF MCP Server started');
+    // Handle shutdown
+    process.on('SIGINT', async () => {
+        logger.info('Shutting down...');
+        await server.close();
+        process.exit(0);
+    });
+}
+// Run server
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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

package/dist/mcp/tools/chat.d.ts

@@ -0,0 +1,30 @@
+/**
+ * codevf-chat tool implementation
+ * Extended collaboration sessions
+ */
+import { TasksApi } from '../../lib/api/tasks.js';
+export interface ChatToolArgs {
+    message: string;
+    maxCredits?: number;
+}
+export interface ChatToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare class ChatTool {
+    private tasksApi;
+    private baseUrl;
+    constructor(tasksApi: TasksApi, baseUrl: string);
+    /**
+     * Handle codevf-chat tool call
+     */
+    execute(args: ChatToolArgs): Promise<ChatToolResult>;
+    /**
+     * Format chat session info
+     */
+    private formatResponse;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/mcp/tools/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGlD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM;IAK/C;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAwD1D;;OAEG;IACH,OAAO,CAAC,cAAc;CAyBvB"}

package/dist/mcp/tools/chat.js

@@ -0,0 +1,82 @@
+/**
+ * codevf-chat tool implementation
+ * Extended collaboration sessions
+ */
+import { logger } from '../../lib/utils/logger.js';
+export class ChatTool {
+    constructor(tasksApi, baseUrl) {
+        this.tasksApi = tasksApi;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Handle codevf-chat tool call
+     */
+    async execute(args) {
+        try {
+            logger.info('Executing codevf-chat', { message: args.message });
+            // Validate credits
+            const maxCredits = args.maxCredits || 240;
+            if (maxCredits < 4 || maxCredits > 1920) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: maxCredits must be between 4 and 1920 for chat sessions',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Create task
+            const task = await this.tasksApi.create({
+                message: args.message,
+                taskMode: 'realtime_chat',
+                maxCredits,
+            });
+            logger.info('Chat session created', {
+                taskId: task.taskId,
+                actionId: task.actionId,
+            });
+            // Format response with session info
+            const formattedResponse = this.formatResponse(task, maxCredits);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formattedResponse,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('codevf-chat failed', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Format chat session info
+     */
+    formatResponse(task, maxCredits) {
+        const sessionUrl = `${this.baseUrl}/session/${task.actionId}`;
+        let output = 'Chat session started with engineer.\n\n';
+        output += `Session URL: ${sessionUrl}\n\n`;
+        output += 'Share this link with your user to monitor the conversation.\n\n';
+        output += `Max credits: ${maxCredits}\n`;
+        output += `Rate: 2 credits/minute\n`;
+        output += `Estimated duration: ${Math.floor(maxCredits / 2)} minutes\n`;
+        if (task.warning) {
+            output += `\n⚠️  ${task.warning}\n`;
+        }
+        output += `\nCredits remaining: ${task.creditsRemaining}\n`;
+        return output;
+    }
+}
+//# sourceMappingURL=chat.js.map

package/dist/mcp/tools/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/mcp/tools/chat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAYnD,MAAM,OAAO,QAAQ;IAInB,YAAY,QAAkB,EAAE,OAAe;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAkB;QAC9B,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAEhE,mBAAmB;YACnB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;YAC1C,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;gBACxC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,gEAAgE;yBACvE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,cAAc;YACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACtC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,eAAe;gBACzB,UAAU;aACX,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE;gBAClC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YAEH,oCAAoC;YACpC,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAEhE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iBAAiB;qBACxB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;YAE1C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,IAIC,EACD,UAAkB;QAElB,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE9D,IAAI,MAAM,GAAG,yCAAyC,CAAC;QACvD,MAAM,IAAI,gBAAgB,UAAU,MAAM,CAAC;QAC3C,MAAM,IAAI,iEAAiE,CAAC;QAC5E,MAAM,IAAI,gBAAgB,UAAU,IAAI,CAAC;QACzC,MAAM,IAAI,0BAA0B,CAAC;QACrC,MAAM,IAAI,uBAAuB,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,YAAY,CAAC;QAExE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,SAAS,IAAI,CAAC,OAAO,IAAI,CAAC;QACtC,CAAC;QAED,MAAM,IAAI,wBAAwB,IAAI,CAAC,gBAAgB,IAAI,CAAC;QAE5D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/mcp/tools/instant.d.ts

@@ -0,0 +1,36 @@
+/**
+ * codevf-instant tool implementation
+ * Quick validation queries with single response
+ */
+import { TasksApi } from '../../lib/api/tasks.js';
+import { TokenManager } from '../../lib/auth/token-manager.js';
+export interface InstantToolArgs {
+    message: string;
+    maxCredits?: number;
+}
+export interface InstantToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare class InstantTool {
+    private tasksApi;
+    private tokenManager;
+    private baseUrl;
+    constructor(tasksApi: TasksApi, tokenManager: TokenManager, baseUrl: string);
+    /**
+     * Handle codevf-instant tool call
+     */
+    execute(args: InstantToolArgs): Promise<InstantToolResult>;
+    /**
+     * Get WebSocket connection URL
+     */
+    private getWebSocketUrl;
+    /**
+     * Format engineer response
+     */
+    private formatResponse;
+}
+//# sourceMappingURL=instant.d.ts.map

package/dist/mcp/tools/instant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/instant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAG/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM;IAM3E;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyEhE;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/mcp/tools/instant.js

@@ -0,0 +1,100 @@
+/**
+ * codevf-instant tool implementation
+ * Quick validation queries with single response
+ */
+import { WebSocketClient } from '../../lib/api/websocket.js';
+import { logger } from '../../lib/utils/logger.js';
+export class InstantTool {
+    constructor(tasksApi, tokenManager, baseUrl) {
+        this.tasksApi = tasksApi;
+        this.tokenManager = tokenManager;
+        this.baseUrl = baseUrl;
+    }
+    /**
+     * Handle codevf-instant tool call
+     */
+    async execute(args) {
+        try {
+            logger.info('Executing codevf-instant', { message: args.message });
+            // Validate credits
+            const maxCredits = args.maxCredits || 10;
+            if (maxCredits < 1 || maxCredits > 10) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: maxCredits must be between 1 and 10 for instant queries',
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Create task
+            const task = await this.tasksApi.create({
+                message: args.message,
+                taskMode: 'realtime_answer',
+                maxCredits,
+            });
+            logger.info('Task created', { taskId: task.taskId });
+            // Show warning if low balance
+            if (task.warning) {
+                logger.warn('Credit warning', { warning: task.warning });
+            }
+            // Connect WebSocket
+            const token = await this.tokenManager.getValidToken();
+            const wsUrl = this.getWebSocketUrl(task.taskId, token);
+            const ws = new WebSocketClient(wsUrl);
+            await ws.connect();
+            logger.info('Waiting for engineer response...');
+            // Wait for response (5 min timeout)
+            const response = await ws.waitForResponse(300000);
+            // Disconnect
+            ws.disconnect();
+            // Format response
+            const formattedResponse = this.formatResponse(response, task.warning);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: formattedResponse,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('codevf-instant failed', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Get WebSocket connection URL
+     */
+    getWebSocketUrl(taskId, token) {
+        const wsProtocol = this.baseUrl.startsWith('https://') ? 'wss://' : 'ws://';
+        const host = this.baseUrl.replace(/^https?:\/\//, '');
+        return `${wsProtocol}${host}/ws?taskId=${taskId}&userType=customer&token=${token}`;
+    }
+    /**
+     * Format engineer response
+     */
+    formatResponse(response, warning) {
+        let output = 'Engineer Response:\n\n';
+        output += response.text + '\n\n';
+        output += '---\n';
+        output += `Credits used: ${response.creditsUsed}\n`;
+        output += `Session time: ${response.duration}\n`;
+        if (warning) {
+            output += `\n⚠️  ${warning}\n`;
+        }
+        return output;
+    }
+}
+//# sourceMappingURL=instant.js.map

package/dist/mcp/tools/instant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.js","sourceRoot":"","sources":["../../../src/mcp/tools/instant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAYnD,MAAM,OAAO,WAAW;IAKtB,YAAY,QAAkB,EAAE,YAA0B,EAAE,OAAe;QACzE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,IAAqB;QACjC,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAEnE,mBAAmB;YACnB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;YACzC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,gEAAgE;yBACvE;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,cAAc;YACd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACtC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,QAAQ,EAAE,iBAAiB;gBAC3B,UAAU;aACX,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAErD,8BAA8B;YAC9B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,oBAAoB;YACpB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACvD,MAAM,EAAE,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;YAEtC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YAEnB,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YAEhD,oCAAoC;YACpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAElD,aAAa;YACb,EAAE,CAAC,UAAU,EAAE,CAAC;YAEhB,kBAAkB;YAClB,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEtE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iBAAiB;qBACxB;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAE7C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAc,EAAE,KAAa;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACtD,OAAO,GAAG,UAAU,GAAG,IAAI,cAAc,MAAM,4BAA4B,KAAK,EAAE,CAAC;IACrF,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,QAAiE,EACjE,OAAgB;QAEhB,IAAI,MAAM,GAAG,wBAAwB,CAAC;QACtC,MAAM,IAAI,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC;QACjC,MAAM,IAAI,OAAO,CAAC;QAClB,MAAM,IAAI,iBAAiB,QAAQ,CAAC,WAAW,IAAI,CAAC;QACpD,MAAM,IAAI,iBAAiB,QAAQ,CAAC,QAAQ,IAAI,CAAC;QAEjD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,SAAS,OAAO,IAAI,CAAC;QACjC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/modules/aiAgent.d.ts

@@ -0,0 +1,75 @@
+import { ConfigManager } from './config.js';
+import { AiTool } from '../types/index.js';
+export interface AiRunResult {
+    output: string;
+    transcript: string[];
+    confidence?: 'high' | 'low' | 'failed';
+    suggestFallback?: boolean;
+    needsMoreInfo?: boolean;
+    clarificationQuestion?: string;
+}
+/**
+ * Wrapper around the opencode SDK using the client-only mode.
+ * - Uses dynamic import so the CLI still works without the SDK installed.
+ * - Avoids starting a local server by using `createOpencodeClient` (caller must have a server running).
+ * - Creates a session per request, sends prompt, prints response parts, and logs transcripts locally.
+ */
+export declare class AiAgent {
+    private static clientCache;
+    private static baseUrlCache;
+    private static serverStarted;
+    private static serverCloser;
+    private configManager;
+    constructor(configManager?: ConfigManager);
+    run(prompt: string, opts?: {
+        timeoutMs?: number | null;
+        baseUrl?: string;
+        startServer?: boolean;
+        verbose?: boolean;
+        signal?: AbortSignal;
+        agent?: 'plan' | 'build';
+        spinner?: any;
+    }): Promise<AiRunResult>;
+    /**
+     * Run AI with tool calling support
+     *
+     * This method wraps the standard run() method to add tool calling capabilities.
+     * It detects TOOL_CALL patterns in the AI's response, executes the requested tools,
+     * and feeds the results back to the AI in a conversation loop.
+     */
+    runWithTools(prompt: string, tools: AiTool[], opts?: {
+        timeoutMs?: number | null;
+        baseUrl?: string;
+        startServer?: boolean;
+        verbose?: boolean;
+        signal?: AbortSignal;
+        maxToolCalls?: number;
+        agent?: 'plan' | 'build';
+        spinner?: any;
+    }): Promise<AiRunResult>;
+    /**
+     * Execute a tool directly from the tools array
+     */
+    private executeTool;
+    /**
+     * Build system prompt with tool definitions
+     */
+    private buildSystemPromptWithTools;
+    /**
+     * Detect TOOL_CALL pattern in AI output
+     */
+    private detectToolCall;
+    /**
+     * Format tool result for AI consumption
+     */
+    private formatToolResult;
+    private executeWithClient;
+    private setupExitCleanup;
+    private invoke;
+    private analyzeResponseQuality;
+    private detectClarificationQuestion;
+    private appendTranscript;
+    private highlightOutput;
+    private withTimeout;
+}
+//# sourceMappingURL=aiAgent.d.ts.map

package/dist/modules/aiAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiAgent.d.ts","sourceRoot":"","sources":["../../src/modules/aiAgent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAc,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAClD,OAAO,CAAC,MAAM,CAAC,aAAa,CAAS;IACrC,OAAO,CAAC,MAAM,CAAC,YAAY,CAA6C;IAExE,OAAO,CAAC,aAAa,CAAgB;gBAEzB,aAAa,gBAAsB;IAIzC,GAAG,CACP,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACzB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,GACA,OAAO,CAAC,WAAW,CAAC;IAmIvB;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QACzB,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,GACA,OAAO,CAAC,WAAW,CAAC;IA8DvB;;OAEG;YACW,WAAW;IAoBzB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA6ClC;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;YAkBV,iBAAiB;IAoD/B,OAAO,CAAC,gBAAgB;YAoBV,MAAM;IAyQpB,OAAO,CAAC,sBAAsB;IAuC9B,OAAO,CAAC,2BAA2B;IAuBnC,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,eAAe;YAsET,WAAW;CAW1B"}