agent-world 0.11.1 → 0.12.0

package/dist/core/anthropic-direct.js

@@ -0,0 +1,301 @@
+/**
+ * Anthropic Direct Integration Module - Pure Client (LLM Provider Refactoring Phase 3)
+ *
+ * Features:
+ * - Direct Anthropic API integration bypassing AI SDK tool calling issues
+ * - Streaming and non-streaming responses returning LLMResponse
+ * - Function/tool calling detection (NO execution)
+ * - Proper error handling and retry logic
+ * - Browser-safe configuration injection
+ * - Pure client: only calls APIs and returns structured data
+ *
+ * Implementation Details:
+ * - Uses official @anthropic-ai/sdk package for reliable API access
+ * - Converts AI SDK message format to Anthropic format
+ * - Returns LLMResponse with type='text' or type='tool_calls'
+ * - Streaming support with chunk-by-chunk processing via onChunk callback
+ * - Error handling with descriptive messages
+ * - Configuration injection from llm-config module
+ * - NO event emission, NO storage, NO tool execution
+ *
+ * Recent Changes:
+ * - 2026-02-13: Added abort-signal support for streaming and non-streaming calls to enable chat stop cancellation.
+ * - 2025-11-09: Phase 3 - Removed ALL tool execution logic (~200 lines)
+ * - Provider is now a pure client - only API calls and data transformation
+ * - Returns LLMResponse interface with type discriminator
+ * - Filters invalid tool calls (empty/missing names) and logs warnings
+ * - Includes usage tracking (input_tokens, output_tokens) for non-streaming
+ * - 2025-11-08: Removed ALL event emission from provider
+ * - Streaming uses onChunk callback instead of direct SSE emission
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { getLLMProviderConfig } from './llm-config.js';
+import { createCategoryLogger } from './logger.js';
+const logger = createCategoryLogger('anthropic');
+const mcpLogger = createCategoryLogger('mcp.execution');
+/**
+ * Anthropic client factory
+ */
+export function createAnthropicClient(config) {
+    return new Anthropic({
+        apiKey: config.apiKey,
+    });
+}
+/**
+ * Convert AI SDK messages to Anthropic format
+ */
+function convertMessagesToAnthropic(messages) {
+    return messages
+        .filter(msg => msg.role !== 'system') // System prompt handled separately
+        .map(msg => {
+        if (msg.role === 'tool') {
+            return {
+                role: 'user',
+                content: [
+                    {
+                        type: 'tool_result',
+                        tool_use_id: msg.tool_call_id || '',
+                        content: msg.content || '',
+                    },
+                ],
+            };
+        }
+        if (msg.role === 'assistant' && msg.tool_calls) {
+            const content = [];
+            if (msg.content) {
+                content.push({
+                    type: 'text',
+                    text: msg.content,
+                });
+            }
+            msg.tool_calls.forEach(toolCall => {
+                content.push({
+                    type: 'tool_use',
+                    id: toolCall.id,
+                    name: toolCall.function.name,
+                    input: JSON.parse(toolCall.function.arguments || '{}'),
+                });
+            });
+            return {
+                role: 'assistant',
+                content,
+            };
+        }
+        return {
+            role: msg.role,
+            content: msg.content || '',
+        };
+    });
+}
+/**
+ * Convert MCP tools to Anthropic format
+ */
+function convertMCPToolsToAnthropic(mcpTools) {
+    return Object.entries(mcpTools).map(([name, tool]) => ({
+        name,
+        description: tool.description || '',
+        input_schema: tool.inputSchema || { type: 'object', properties: {} },
+    }));
+}
+/**
+ * Extract system prompt from messages
+ */
+function extractSystemPrompt(messages) {
+    const systemMessage = messages.find(msg => msg.role === 'system');
+    return systemMessage?.content || 'You are a helpful assistant.';
+}
+/**
+ * Streaming Anthropic response handler - Pure client (no tool execution)
+ * Returns LLMResponse with type='text' or type='tool_calls'
+ */
+export async function streamAnthropicResponse(client, model, messages, agent, mcpTools, world, onChunk, messageId, abortSignal) {
+    const anthropicMessages = convertMessagesToAnthropic(messages);
+    const anthropicTools = Object.keys(mcpTools).length > 0 ? convertMCPToolsToAnthropic(mcpTools) : undefined;
+    const systemPrompt = extractSystemPrompt(messages);
+    const requestParams = {
+        model,
+        messages: anthropicMessages,
+        system: systemPrompt,
+        stream: true,
+        temperature: agent.temperature,
+        max_tokens: agent.maxTokens || 4096,
+        ...(anthropicTools && { tools: anthropicTools }),
+    };
+    logger.debug(`Anthropic Direct: Starting streaming request for agent=${agent.id}, model=${model}`, {
+        messageCount: messages.length,
+        hasTools: !!anthropicTools,
+        toolCount: anthropicTools?.length || 0,
+    });
+    const stream = await client.messages.create(requestParams, abortSignal ? { signal: abortSignal } : undefined);
+    let fullResponse = '';
+    let toolUses = [];
+    try {
+        for await (const chunk of stream) {
+            if (abortSignal?.aborted) {
+                throw new DOMException('Anthropic stream aborted', 'AbortError');
+            }
+            if (chunk.type === 'content_block_delta') {
+                if (chunk.delta.type === 'text_delta') {
+                    const textDelta = chunk.delta.text;
+                    fullResponse += textDelta;
+                    onChunk(textDelta);
+                }
+            }
+            else if (chunk.type === 'content_block_start') {
+                if (chunk.content_block.type === 'tool_use') {
+                    toolUses.push(chunk.content_block);
+                }
+            }
+        }
+        // Return LLMResponse based on whether we have tool calls or text
+        if (toolUses.length > 0) {
+            // Normalize toolUses to function call format
+            const toolCalls = toolUses
+                .filter(tu => tu.name && tu.name.trim() !== '')
+                .map(toolUse => ({
+                id: toolUse.id,
+                type: 'function',
+                function: {
+                    name: toolUse.name,
+                    arguments: JSON.stringify(toolUse.input),
+                },
+            }));
+            const invalidCount = toolUses.length - toolCalls.length;
+            if (invalidCount > 0) {
+                logger.warn(`Anthropic Direct: Filtered ${invalidCount} invalid tool calls (streaming)`, {
+                    agentId: agent.id,
+                    totalToolUses: toolUses.length
+                });
+            }
+            logger.debug(`Anthropic Direct: Completed streaming request with tool calls for agent=${agent.id}`, {
+                toolCount: toolCalls.length,
+                toolNames: toolCalls.map(tc => tc.function.name)
+            });
+            return {
+                type: 'tool_calls',
+                content: fullResponse,
+                tool_calls: toolCalls,
+                assistantMessage: {
+                    role: 'assistant',
+                    content: fullResponse || '',
+                    tool_calls: toolCalls,
+                },
+                usage: undefined, // Anthropic streaming doesn't provide usage in final chunk
+            };
+        }
+        logger.debug(`Anthropic Direct: Completed streaming request for agent=${agent.id}, responseLength=${fullResponse.length}`);
+        return {
+            type: 'text',
+            content: fullResponse,
+            assistantMessage: {
+                role: 'assistant',
+                content: fullResponse,
+            },
+            usage: undefined, // Anthropic streaming doesn't provide usage in final chunk
+        };
+    }
+    catch (error) {
+        logger.error(`Anthropic Direct: Streaming error for agent=${agent.id}:`, error);
+        throw error;
+    }
+}
+/**
+ * Non-streaming Anthropic response handler - Pure client (no tool execution)
+ * Returns LLMResponse with type='text' or type='tool_calls'
+ */
+export async function generateAnthropicResponse(client, model, messages, agent, mcpTools, world, abortSignal) {
+    const anthropicMessages = convertMessagesToAnthropic(messages);
+    const anthropicTools = Object.keys(mcpTools).length > 0 ? convertMCPToolsToAnthropic(mcpTools) : undefined;
+    const systemPrompt = extractSystemPrompt(messages);
+    const requestParams = {
+        model,
+        messages: anthropicMessages,
+        system: systemPrompt,
+        temperature: agent.temperature,
+        max_tokens: agent.maxTokens || 4096,
+        ...(anthropicTools && { tools: anthropicTools }),
+    };
+    logger.debug(`Anthropic Direct: Starting non-streaming request for agent=${agent.id}, model=${model}`, {
+        messageCount: messages.length,
+        hasTools: !!anthropicTools,
+        toolCount: anthropicTools?.length || 0,
+    });
+    try {
+        const response = await client.messages.create(requestParams, abortSignal ? { signal: abortSignal } : undefined);
+        let content = '';
+        let toolUses = [];
+        // Extract content and tool uses from response
+        response.content.forEach(block => {
+            if (block.type === 'text') {
+                content += block.text;
+            }
+            else if (block.type === 'tool_use') {
+                toolUses.push(block);
+            }
+        });
+        // Return LLMResponse based on whether we have tool calls or text
+        if (toolUses.length > 0) {
+            // Normalize toolUses to function call format
+            const toolCalls = toolUses
+                .filter(tu => tu.name && tu.name.trim() !== '')
+                .map(toolUse => ({
+                id: toolUse.id,
+                type: 'function',
+                function: {
+                    name: toolUse.name,
+                    arguments: JSON.stringify(toolUse.input),
+                },
+            }));
+            const invalidCount = toolUses.length - toolCalls.length;
+            if (invalidCount > 0) {
+                logger.warn(`Anthropic Direct: Filtered ${invalidCount} invalid tool calls (non-streaming)`, {
+                    agentId: agent.id,
+                    totalToolUses: toolUses.length
+                });
+            }
+            logger.debug(`Anthropic Direct: Completed non-streaming request with tool calls for agent=${agent.id}`, {
+                toolCount: toolCalls.length,
+                toolNames: toolCalls.map(tc => tc.function.name)
+            });
+            return {
+                type: 'tool_calls',
+                content: content,
+                tool_calls: toolCalls,
+                assistantMessage: {
+                    role: 'assistant',
+                    content: content,
+                    tool_calls: toolCalls,
+                },
+                usage: response.usage ? {
+                    inputTokens: response.usage.input_tokens,
+                    outputTokens: response.usage.output_tokens,
+                } : undefined,
+            };
+        }
+        logger.debug(`Anthropic Direct: Completed non-streaming request for agent=${agent.id}, responseLength=${content.length}`);
+        return {
+            type: 'text',
+            content: content,
+            assistantMessage: {
+                role: 'assistant',
+                content: content,
+            },
+            usage: response.usage ? {
+                inputTokens: response.usage.input_tokens,
+                outputTokens: response.usage.output_tokens,
+            } : undefined,
+        };
+    }
+    catch (error) {
+        logger.error(`Anthropic Direct: Generation error for agent=${agent.id}:`, error);
+        throw error;
+    }
+}
+/**
+ * Factory function to create Anthropic client for agent
+ */
+export function createAnthropicClientForAgent(agent) {
+    const config = getLLMProviderConfig(agent.provider);
+    return createAnthropicClient(config);
+}
+//# sourceMappingURL=anthropic-direct.js.map

package/dist/core/anthropic-direct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-direct.js","sourceRoot":"","sources":["../../core/anthropic-direct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAmB,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;AACjD,MAAM,SAAS,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,OAAO,IAAI,SAAS,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,QAAuB;IACzD,OAAO,QAAQ;SACZ,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,mCAAmC;SACxE,GAAG,CAAC,GAAG,CAAC,EAAE;QACT,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO;gBACL,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,aAAsB;wBAC5B,WAAW,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE;wBACnC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;qBAC3B;iBACF;aACF,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAU,EAAE,CAAC;YAE1B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,GAAG,CAAC,OAAO;iBAClB,CAAC,CAAC;YACL,CAAC;YAED,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAChC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,UAAU;oBAChB,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;oBAC5B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAAC;iBACvD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,WAAoB;gBAC1B,OAAO;aACR,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAA4B;YACtC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,QAA6B;IAC/D,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,YAAY,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;KACrE,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,QAAuB;IAClD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAClE,OAAO,aAAa,EAAE,OAAO,IAAI,8BAA8B,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAiB,EACjB,KAAa,EACb,QAAuB,EACvB,KAAY,EACZ,QAA6B,EAC7B,KAAY,EACZ,OAAkC,EAClC,SAAiB,EACjB,WAAyB;IAEzB,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEnD,MAAM,aAAa,GAAoD;QACrE,KAAK;QACL,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QACnC,GAAG,CAAC,cAAc,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;KACjD,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,0DAA0D,KAAK,CAAC,EAAE,WAAW,KAAK,EAAE,EAAE;QACjG,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,QAAQ,EAAE,CAAC,CAAC,cAAc;QAC1B,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;KACvC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CACzC,aAAa,EACb,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CACzD,CAAC;IACF,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,QAAQ,GAAU,EAAE,CAAC;IAEzB,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACjC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,YAAY,CAAC,0BAA0B,EAAE,YAAY,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACzC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBACtC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;oBACnC,YAAY,IAAI,SAAS,CAAC;oBAC1B,OAAO,CAAC,SAAS,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAChD,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBAC5C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,6CAA6C;YAC7C,MAAM,SAAS,GAAG,QAAQ;iBACvB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;iBAC9C,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACf,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,IAAI,EAAE,UAAmB;gBACzB,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;iBACzC;aACF,CAAC,CAAC,CAAC;YAEN,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YACxD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,8BAA8B,YAAY,iCAAiC,EAAE;oBACvF,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,aAAa,EAAE,QAAQ,CAAC,MAAM;iBAC/B,CAAC,CAAC;YACL,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,2EAA2E,KAAK,CAAC,EAAE,EAAE,EAAE;gBAClG,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;aACjD,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,YAAY;gBACrB,UAAU,EAAE,SAAS;gBACrB,gBAAgB,EAAE;oBAChB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,YAAY,IAAI,EAAE;oBAC3B,UAAU,EAAE,SAAS;iBACtB;gBACD,KAAK,EAAE,SAAS,EAAE,2DAA2D;aAC9E,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,2DAA2D,KAAK,CAAC,EAAE,oBAAoB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3H,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,YAAY;YACrB,gBAAgB,EAAE;gBAChB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,YAAY;aACtB;YACD,KAAK,EAAE,SAAS,EAAE,2DAA2D;SAC9E,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,+CAA+C,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAChF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAiB,EACjB,KAAa,EACb,QAAuB,EACvB,KAAY,EACZ,QAA6B,EAC7B,KAAY,EACZ,WAAyB;IAEzB,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEnD,MAAM,aAAa,GAAuD;QACxE,KAAK;QACL,QAAQ,EAAE,iBAAiB;QAC3B,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;QACnC,GAAG,CAAC,cAAc,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;KACjD,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,8DAA8D,KAAK,CAAC,EAAE,WAAW,KAAK,EAAE,EAAE;QACrG,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,QAAQ,EAAE,CAAC,CAAC,cAAc;QAC1B,SAAS,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;KACvC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC3C,aAAa,EACb,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAkB,EAAE,CAAC,CAAC,CAAC,SAAS,CACzD,CAAC;QAEF,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,GAAU,EAAE,CAAC;QAEzB,8CAA8C;QAC9C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC;YACxB,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iEAAiE;QACjE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,6CAA6C;YAC7C,MAAM,SAAS,GAAG,QAAQ;iBACvB,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;iBAC9C,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBACf,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,IAAI,EAAE,UAAmB;gBACzB,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC;iBACzC;aACF,CAAC,CAAC,CAAC;YAEN,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YACxD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CAAC,8BAA8B,YAAY,qCAAqC,EAAE;oBAC3F,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,aAAa,EAAE,QAAQ,CAAC,MAAM;iBAC/B,CAAC,CAAC;YACL,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,+EAA+E,KAAK,CAAC,EAAE,EAAE,EAAE;gBACtG,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;aACjD,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,SAAS;gBACrB,gBAAgB,EAAE;oBAChB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,OAAO;oBAChB,UAAU,EAAE,SAAS;iBACtB;gBACD,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;oBACtB,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;oBACxC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;iBAC3C,CAAC,CAAC,CAAC,SAAS;aACd,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,+DAA+D,KAAK,CAAC,EAAE,oBAAoB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1H,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO;YAChB,gBAAgB,EAAE;gBAChB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO;aACjB;YACD,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtB,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;gBACxC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;aAC3C,CAAC,CAAC,CAAC,SAAS;SACd,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,gDAAgD,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACjF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAY;IACxD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,QAAQ,CAAoB,CAAC;IACvE,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/approval-cache.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Tool Approval Cache Module
+ *
+ * Features:
+ * - Session-scoped approval caching for tool execution
+ * - Isolated cache per chatId to prevent cross-chat approval leakage
+ * - Timestamp tracking for audit and expiration capabilities
+ * - Singleton pattern for global cache access
+ *
+ * Implementation:
+ * - Two-level Map structure: chatId -> (toolName -> entry)
+ * - Thread-safe operations (no async needed for in-memory cache)
+ * - Automatic cleanup on chat deletion (external trigger)
+ *
+ * Changes:
+ * - 2025-11-03: Initial implementation for tool approval system
+ */
+export interface ApprovalCacheEntry {
+    approved: boolean;
+    timestamp: Date;
+}
+/**
+ * Approval cache for storing session-scoped tool approvals.
+ *
+ * Architecture:
+ * - chatId isolation: Each chat has its own approval cache
+ * - Session lifecycle: Cleared when chat ends or deleted
+ * - No persistence: In-memory only (cleared on server restart)
+ *
+ * Usage:
+ * ```typescript
+ * // Grant session approval
+ * approvalCache.set('chat-123', 'mcp__filesystem__write_file', true);
+ *
+ * // Check approval
+ * if (approvalCache.get('chat-123', 'mcp__filesystem__write_file')) {
+ *   await executeTool();
+ * }
+ *
+ * // Clear on chat end
+ * approvalCache.clear('chat-123');
+ * ```
+ */
+export declare class ApprovalCache {
+    private cache;
+    /**
+     * Set approval status for a tool in a specific chat session
+     *
+     * @param chatId - Chat session identifier
+     * @param toolName - Full tool name (e.g., 'mcp__server__toolName')
+     * @param approved - Whether tool is approved
+     */
+    set(chatId: string, toolName: string, approved: boolean): void;
+    /**
+     * Get approval status for a tool in a specific chat session
+     *
+     * @param chatId - Chat session identifier
+     * @param toolName - Full tool name
+     * @returns true if approved, false if denied, undefined if not cached
+     */
+    get(chatId: string, toolName: string): boolean | undefined;
+    /**
+     * Check if approval exists for a tool in a specific chat session
+     *
+     * @param chatId - Chat session identifier
+     * @param toolName - Full tool name
+     * @returns true if approval decision exists (approved or denied)
+     */
+    has(chatId: string, toolName: string): boolean;
+    /**
+     * Clear all approvals for a specific chat session
+     * Called when chat ends or is deleted
+     *
+     * @param chatId - Chat session identifier
+     */
+    clear(chatId: string): void;
+    /**
+     * Clear all approvals across all chats
+     * Primarily for testing and server restart scenarios
+     */
+    clearAll(): void;
+    /**
+     * Get all cached tools for a specific chat (for debugging/UI)
+     *
+     * @param chatId - Chat session identifier
+     * @returns Array of [toolName, entry] pairs
+     */
+    getChatApprovals(chatId: string): Array<[string, ApprovalCacheEntry]>;
+    /**
+     * Get statistics about cache usage (for monitoring)
+     */
+    getStats(): {
+        totalChats: number;
+        totalApprovals: number;
+        chatsWithApprovals: Array<{
+            chatId: string;
+            approvalCount: number;
+        }>;
+    };
+}
+/**
+ * Global singleton approval cache instance
+ */
+export declare const approvalCache: ApprovalCache;

package/dist/core/approval-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-cache.d.ts","sourceRoot":"","sources":["../../core/approval-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,aAAa;IAExB,OAAO,CAAC,KAAK,CAAsD;IAEnE;;;;;;OAMG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAiB9D;;;;;;OAMG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAc1D;;;;;;OAMG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAS9C;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ3B;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAIhB;;;;;OAKG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAarE;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtE;CAcF;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/core/approval-cache.js

@@ -0,0 +1,150 @@
+/**
+ * Tool Approval Cache Module
+ *
+ * Features:
+ * - Session-scoped approval caching for tool execution
+ * - Isolated cache per chatId to prevent cross-chat approval leakage
+ * - Timestamp tracking for audit and expiration capabilities
+ * - Singleton pattern for global cache access
+ *
+ * Implementation:
+ * - Two-level Map structure: chatId -> (toolName -> entry)
+ * - Thread-safe operations (no async needed for in-memory cache)
+ * - Automatic cleanup on chat deletion (external trigger)
+ *
+ * Changes:
+ * - 2025-11-03: Initial implementation for tool approval system
+ */
+/**
+ * Approval cache for storing session-scoped tool approvals.
+ *
+ * Architecture:
+ * - chatId isolation: Each chat has its own approval cache
+ * - Session lifecycle: Cleared when chat ends or deleted
+ * - No persistence: In-memory only (cleared on server restart)
+ *
+ * Usage:
+ * ```typescript
+ * // Grant session approval
+ * approvalCache.set('chat-123', 'mcp__filesystem__write_file', true);
+ *
+ * // Check approval
+ * if (approvalCache.get('chat-123', 'mcp__filesystem__write_file')) {
+ *   await executeTool();
+ * }
+ *
+ * // Clear on chat end
+ * approvalCache.clear('chat-123');
+ * ```
+ */
+export class ApprovalCache {
+    // chatId -> (toolName -> entry)
+    cache = new Map();
+    /**
+     * Set approval status for a tool in a specific chat session
+     *
+     * @param chatId - Chat session identifier
+     * @param toolName - Full tool name (e.g., 'mcp__server__toolName')
+     * @param approved - Whether tool is approved
+     */
+    set(chatId, toolName, approved) {
+        if (!chatId || !toolName) {
+            throw new Error('chatId and toolName are required');
+        }
+        let chatCache = this.cache.get(chatId);
+        if (!chatCache) {
+            chatCache = new Map();
+            this.cache.set(chatId, chatCache);
+        }
+        chatCache.set(toolName, {
+            approved,
+            timestamp: new Date()
+        });
+    }
+    /**
+     * Get approval status for a tool in a specific chat session
+     *
+     * @param chatId - Chat session identifier
+     * @param toolName - Full tool name
+     * @returns true if approved, false if denied, undefined if not cached
+     */
+    get(chatId, toolName) {
+        if (!chatId || !toolName) {
+            return undefined;
+        }
+        const chatCache = this.cache.get(chatId);
+        if (!chatCache) {
+            return undefined;
+        }
+        const entry = chatCache.get(toolName);
+        return entry?.approved;
+    }
+    /**
+     * Check if approval exists for a tool in a specific chat session
+     *
+     * @param chatId - Chat session identifier
+     * @param toolName - Full tool name
+     * @returns true if approval decision exists (approved or denied)
+     */
+    has(chatId, toolName) {
+        if (!chatId || !toolName) {
+            return false;
+        }
+        const chatCache = this.cache.get(chatId);
+        return chatCache?.has(toolName) ?? false;
+    }
+    /**
+     * Clear all approvals for a specific chat session
+     * Called when chat ends or is deleted
+     *
+     * @param chatId - Chat session identifier
+     */
+    clear(chatId) {
+        if (!chatId) {
+            return;
+        }
+        this.cache.delete(chatId);
+    }
+    /**
+     * Clear all approvals across all chats
+     * Primarily for testing and server restart scenarios
+     */
+    clearAll() {
+        this.cache.clear();
+    }
+    /**
+     * Get all cached tools for a specific chat (for debugging/UI)
+     *
+     * @param chatId - Chat session identifier
+     * @returns Array of [toolName, entry] pairs
+     */
+    getChatApprovals(chatId) {
+        if (!chatId) {
+            return [];
+        }
+        const chatCache = this.cache.get(chatId);
+        if (!chatCache) {
+            return [];
+        }
+        return Array.from(chatCache.entries());
+    }
+    /**
+     * Get statistics about cache usage (for monitoring)
+     */
+    getStats() {
+        const chatsWithApprovals = Array.from(this.cache.entries()).map(([chatId, chatCache]) => ({
+            chatId,
+            approvalCount: chatCache.size
+        }));
+        const totalApprovals = chatsWithApprovals.reduce((sum, chat) => sum + chat.approvalCount, 0);
+        return {
+            totalChats: this.cache.size,
+            totalApprovals,
+            chatsWithApprovals
+        };
+    }
+}
+/**
+ * Global singleton approval cache instance
+ */
+export const approvalCache = new ApprovalCache();

package/dist/core/approval-cache.js.map

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

package/dist/core/chat-constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Chat Constants
+ *
+ * Purpose:
+ * - Provide shared chat-session constants and helpers used by core chat flows.
+ *
+ * Features:
+ * - Central default chat title constant for reusable untitled sessions.
+ * - Helper to evaluate whether a chat is still in default-title state.
+ *
+ * Implementation Notes:
+ * - Kept framework-agnostic to avoid importing manager/event modules.
+ * - Used by both chat lifecycle management and auto-title update paths.
+ *
+ * Recent Changes:
+ * - 2026-02-13: Added shared default-title constant and helper for session title logic.
+ */
+export declare const NEW_CHAT_TITLE = "New Chat";
+export declare function isDefaultChatTitle(name: string | null | undefined): boolean;
+//# sourceMappingURL=chat-constants.d.ts.map

package/dist/core/chat-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-constants.d.ts","sourceRoot":"","sources":["../../core/chat-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE3E"}

package/dist/core/chat-constants.js

@@ -0,0 +1,22 @@
+/**
+ * Chat Constants
+ *
+ * Purpose:
+ * - Provide shared chat-session constants and helpers used by core chat flows.
+ *
+ * Features:
+ * - Central default chat title constant for reusable untitled sessions.
+ * - Helper to evaluate whether a chat is still in default-title state.
+ *
+ * Implementation Notes:
+ * - Kept framework-agnostic to avoid importing manager/event modules.
+ * - Used by both chat lifecycle management and auto-title update paths.
+ *
+ * Recent Changes:
+ * - 2026-02-13: Added shared default-title constant and helper for session title logic.
+ */
+export const NEW_CHAT_TITLE = 'New Chat';
+export function isDefaultChatTitle(name) {
+    return String(name ?? '').trim() === NEW_CHAT_TITLE;
+}
+//# sourceMappingURL=chat-constants.js.map

package/dist/core/chat-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-constants.js","sourceRoot":"","sources":["../../core/chat-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,cAAc,CAAC;AACtD,CAAC"}