rackmind-cli 0.1.6 → 0.2.0

package/dist/ai/client.js

@@ -1,198 +0,0 @@
-// ---------------------------------------------------------------------------
-// AI client — Claude API integration with tool use loop
-// ---------------------------------------------------------------------------
-// Wraps @anthropic-ai/sdk to handle:
-// 1. Sending messages with system prompt + tools
-// 2. Streaming text responses to a callback
-// 3. Executing tool calls and feeding results back until a final text response
-// ---------------------------------------------------------------------------
-import Anthropic from '@anthropic-ai/sdk';
-import { getToolDefinitions } from './tools.js';
-import { fetchServerContext, buildSystemPrompt } from './system-prompt.js';
-import { executeTool } from './tool-executor.js';
-import { logger } from '../utils/logger.js';
-import { withRetry, isTransientError, isRateLimitError } from '../utils/retry.js';
-// Max iterations for the tool use loop to prevent infinite loops
-const MAX_TOOL_ITERATIONS = 20;
-// ---------------------------------------------------------------------------
-// AI Client
-// ---------------------------------------------------------------------------
-export class AIClient {
-    anthropic;
-    model;
-    maxTokens;
-    constructor(options) {
-        this.anthropic = new Anthropic({
-            apiKey: options.apiKey,
-            timeout: options.timeoutMs ?? 120_000, // 2 minutes default
-        });
-        this.model = options.model ?? 'claude-sonnet-4-5';
-        this.maxTokens = options.maxTokens ?? 4096;
-    }
-    /**
-     * Send a one-shot query to Claude with full server context and tool use.
-     *
-     * This method:
-     * 1. Fetches live server context from the Proxmox API
-     * 2. Builds a system prompt with the context
-     * 3. Sends the user's query to Claude with tool definitions
-     * 4. Streams the response, executing any tool calls in a loop
-     * 5. Returns when Claude produces a final text response (stop_reason = "end_turn")
-     */
-    async chat(query, serverClient, serverAlias, callbacks) {
-        // Fetch live server context
-        const context = await fetchServerContext(serverClient);
-        const systemPrompt = buildSystemPrompt(context, serverAlias);
-        const tools = getToolDefinitions();
-        // Build initial messages
-        const messages = [{ role: 'user', content: query }];
-        // Tool use loop — keep going until Claude gives a final text response
-        for (let iteration = 0; iteration < MAX_TOOL_ITERATIONS; iteration++) {
-            logger.debug('AI request iteration', { iteration, messageCount: messages.length });
-            const response = await this.createWithRetry(systemPrompt, tools, messages, callbacks);
-            // Process the response content blocks
-            const assistantContent = [];
-            const toolUseBlocks = [];
-            for (const block of response.content) {
-                assistantContent.push(block);
-                if (block.type === 'text') {
-                    callbacks.onText(block.text);
-                }
-                else if (block.type === 'tool_use') {
-                    toolUseBlocks.push(block);
-                }
-            }
-            // Add the assistant's response to the conversation
-            messages.push({ role: 'assistant', content: assistantContent });
-            // If Claude is done (no more tool calls), we're finished
-            if (response.stop_reason === 'end_turn' || toolUseBlocks.length === 0) {
-                logger.debug('AI conversation complete', {
-                    iterations: iteration + 1,
-                    stopReason: response.stop_reason,
-                });
-                return;
-            }
-            // Execute all tool calls and collect results
-            const toolResults = [];
-            for (const toolBlock of toolUseBlocks) {
-                const toolInput = toolBlock.input;
-                callbacks.onToolStart(toolBlock.name, toolBlock.name);
-                const result = await executeTool(toolBlock.name, toolInput, serverClient);
-                callbacks.onToolEnd(toolBlock.name, result.label, result.isError);
-                toolResults.push({
-                    type: 'tool_result',
-                    tool_use_id: toolBlock.id,
-                    content: result.content,
-                    is_error: result.isError,
-                });
-            }
-            // Add tool results to the conversation and loop back
-            messages.push({ role: 'user', content: toolResults });
-        }
-        callbacks.onError('Reached maximum tool iterations. The AI may be stuck in a loop.');
-    }
-    /**
-     * Multi-turn conversation method for the interactive REPL.
-     *
-     * Unlike `chat()`, this accepts the full conversation history so far
-     * and appends the new user query. It returns the updated history
-     * (including the assistant's response) for the caller to persist.
-     *
-     * The caller is responsible for building up `history` across turns.
-     */
-    async chatMultiTurn(query, history, serverClient, serverAlias, callbacks) {
-        // Fetch live server context
-        const context = await fetchServerContext(serverClient);
-        const systemPrompt = buildSystemPrompt(context, serverAlias);
-        const tools = getToolDefinitions();
-        // Clone history and append the new user message
-        const messages = [
-            ...history,
-            { role: 'user', content: query },
-        ];
-        // Tool use loop
-        for (let iteration = 0; iteration < MAX_TOOL_ITERATIONS; iteration++) {
-            logger.debug('AI multi-turn request iteration', {
-                iteration,
-                messageCount: messages.length,
-            });
-            const response = await this.createWithRetry(systemPrompt, tools, messages, callbacks);
-            // Process content blocks
-            const assistantContent = [];
-            const toolUseBlocks = [];
-            for (const block of response.content) {
-                assistantContent.push(block);
-                if (block.type === 'text') {
-                    callbacks.onText(block.text);
-                }
-                else if (block.type === 'tool_use') {
-                    toolUseBlocks.push(block);
-                }
-            }
-            messages.push({ role: 'assistant', content: assistantContent });
-            // If done, return the full updated history
-            if (response.stop_reason === 'end_turn' || toolUseBlocks.length === 0) {
-                logger.debug('AI multi-turn conversation turn complete', {
-                    iterations: iteration + 1,
-                    stopReason: response.stop_reason,
-                });
-                return messages;
-            }
-            // Execute tool calls
-            const toolResults = [];
-            for (const toolBlock of toolUseBlocks) {
-                const toolInput = toolBlock.input;
-                callbacks.onToolStart(toolBlock.name, toolBlock.name);
-                const result = await executeTool(toolBlock.name, toolInput, serverClient);
-                callbacks.onToolEnd(toolBlock.name, result.label, result.isError);
-                if (callbacks.onToolResult) {
-                    callbacks.onToolResult({
-                        toolName: toolBlock.name,
-                        label: result.label,
-                        isError: result.isError,
-                        content: result.content,
-                    });
-                }
-                toolResults.push({
-                    type: 'tool_result',
-                    tool_use_id: toolBlock.id,
-                    content: result.content,
-                    is_error: result.isError,
-                });
-            }
-            messages.push({ role: 'user', content: toolResults });
-        }
-        callbacks.onError('Reached maximum tool iterations. The AI may be stuck in a loop.');
-        return messages;
-    }
-    /**
-     * Create a message with retry logic for transient errors.
-     * Rate limits and overload errors trigger exponential backoff.
-     */
-    createWithRetry(system, tools, messages, callbacks) {
-        return withRetry(() => this.anthropic.messages.create({
-            model: this.model,
-            max_tokens: this.maxTokens,
-            system,
-            tools,
-            messages,
-        }), {
-            maxAttempts: 3,
-            initialDelayMs: 2000,
-            maxDelayMs: 30_000,
-            isRetryable: isTransientError,
-            onRetry: (attempt, error, delayMs) => {
-                const msg = error instanceof Error ? error.message : String(error);
-                const isRateLimit = isRateLimitError(error);
-                const label = isRateLimit ? 'Rate limited' : 'API error';
-                callbacks.onError(`${label}, retrying in ${Math.round(delayMs / 1000)}s (attempt ${attempt + 1}/3)...`);
-                logger.warn('API call retry', { attempt, delayMs, error: msg });
-            },
-        });
-    }
-    /** Get the current model name */
-    getModel() {
-        return this.model;
-    }
-}
-//# sourceMappingURL=client.js.map

package/dist/ai/client.js.map

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