rackmind-cli 0.1.5 → 0.2.0

package/dist/ai/{client.js → providers/anthropic-provider.js}

@@ -1,56 +1,55 @@
 // ---------------------------------------------------------------------------
-// AI client — Claude API integration with tool use loop
+// Anthropic provider — original AIClient logic, now behind AIProvider
 // ---------------------------------------------------------------------------
-// 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
+// Wraps @anthropic-ai/sdk with the CLI's tool-use loop. This is the default
+// provider — every unknown/missing model id falls back here via
+// providers/index.ts::getAIProvider().
 // ---------------------------------------------------------------------------
 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
+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';
+import { DEFAULT_ANTHROPIC_MODEL_ID } from '../models.js';
+/** Max iterations of the tool use loop — hard guard against runaway chains. */
 const MAX_TOOL_ITERATIONS = 20;
-// ---------------------------------------------------------------------------
-// AI Client
-// ---------------------------------------------------------------------------
-export class AIClient {
+export class AnthropicProvider {
     anthropic;
     model;
     maxTokens;
+    /** Cached server context — fetched once per session, cleared by /refresh */
+    cachedContext = null;
     constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('Anthropic provider requires an API key.');
+        }
         this.anthropic = new Anthropic({
             apiKey: options.apiKey,
-            timeout: options.timeoutMs ?? 120_000, // 2 minutes default
+            timeout: options.timeoutMs ?? 120_000,
         });
-        this.model = options.model ?? 'claude-sonnet-4-5';
+        this.model = options.model || DEFAULT_ANTHROPIC_MODEL_ID;
         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")
-     */
+    getModel() {
+        return this.model;
+    }
+    /** Clear cached server context so next turn re-fetches from Proxmox API. */
+    invalidateContextCache() {
+        this.cachedContext = null;
+        logger.info('Server context cache cleared — will re-fetch on next turn');
+    }
     async chat(query, serverClient, serverAlias, callbacks) {
-        // Fetch live server context
-        const context = await fetchServerContext(serverClient);
+        if (!this.cachedContext) {
+            this.cachedContext = await fetchServerContext(serverClient);
+        }
+        const context = this.cachedContext;
         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) {
@@ -62,9 +61,7 @@ export class AIClient {
                     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,
@@ -72,12 +69,11 @@ export class AIClient {
                 });
                 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);
+                const result = await executeTool(toolBlock.name, toolInput, serverClient, { confirm: callbacks.confirmDestructive });
                 callbacks.onToolEnd(toolBlock.name, result.label, result.isError);
                 toolResults.push({
                     type: 'tool_result',
@@ -86,38 +82,27 @@ export class AIClient {
                     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);
+        if (!this.cachedContext) {
+            this.cachedContext = await fetchServerContext(serverClient);
+        }
+        const context = this.cachedContext;
         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) {
@@ -130,7 +115,6 @@ export class AIClient {
                 }
             }
             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,
@@ -138,12 +122,11 @@ export class AIClient {
                 });
                 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);
+                const result = await executeTool(toolBlock.name, toolInput, serverClient, { confirm: callbacks.confirmDestructive });
                 callbacks.onToolEnd(toolBlock.name, result.label, result.isError);
                 if (callbacks.onToolResult) {
                     callbacks.onToolResult({
@@ -165,6 +148,9 @@ export class AIClient {
         callbacks.onError('Reached maximum tool iterations. The AI may be stuck in a loop.');
         return messages;
     }
+    async dispose() {
+        // Anthropic SDK has no persistent resources to release.
+    }
     /**
      * Create a message with retry logic for transient errors.
      * Rate limits and overload errors trigger exponential backoff.
@@ -190,9 +176,5 @@ export class AIClient {
             },
         });
     }
-    /** Get the current model name */
-    getModel() {
-        return this.model;
-    }
 }
-//# sourceMappingURL=client.js.map
+//# sourceMappingURL=anthropic-provider.js.map

package/dist/ai/providers/anthropic-provider.js.map

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

package/dist/ai/providers/base.d.ts

@@ -0,0 +1,82 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { ServerClient } from '../../server/client.js';
+import type { ConfirmDestructiveFn } from '../tool-executor.js';
+export type { ConfirmDestructiveFn, PendingDestructiveAction } from '../tool-executor.js';
+/** Callbacks the provider invokes while a chat turn is in flight. */
+export interface StreamCallbacks {
+    /** Streaming text chunk from the assistant. */
+    onText: (text: string) => void;
+    /** A tool call is about to run (or has started). */
+    onToolStart: (toolName: string, label: string) => void;
+    /** A tool call finished (success or error). */
+    onToolEnd: (toolName: string, label: string, isError: boolean) => void;
+    /** A non-fatal error occurred (rate limit retries, warnings, etc.). */
+    onError: (error: string) => void;
+    /**
+     * Optional: asked before a destructive tool runs. Return true to proceed,
+     * false to cancel. If omitted, the provider may execute without prompting
+     * (only intended for non-interactive surfaces that have already validated
+     * the user opted into auto-confirm).
+     */
+    confirmDestructive?: ConfirmDestructiveFn;
+}
+/** A single tool execution observed during a turn (shown in REPL history). */
+export interface ToolExecution {
+    toolName: string;
+    label: string;
+    isError: boolean;
+    content: string;
+}
+/** Extended callbacks for multi-turn mode (captures full tool result for UI). */
+export interface MultiTurnCallbacks extends StreamCallbacks {
+    onToolResult?: (execution: ToolExecution) => void;
+}
+/**
+ * Conversation history shape used by multi-turn mode. We reuse Anthropic's
+ * MessageParam for wire compatibility with the anthropic provider and for
+ * easy mirroring when the user switches providers mid-conversation.
+ */
+export type ChatHistory = Anthropic.Messages.MessageParam[];
+/**
+ * Every provider implements this. `chat` is one-shot (no history);
+ * `chatMultiTurn` takes the prior history, appends the new turn, and
+ * returns the updated history for the caller to persist.
+ */
+export interface AIProvider {
+    /** The model id this provider instance was constructed for. */
+    getModel(): string;
+    /**
+     * Send a single query with no prior history. Streams results via
+     * callbacks. Throws on fatal errors.
+     */
+    chat(query: string, serverClient: ServerClient, serverAlias: string, callbacks: StreamCallbacks): Promise<void>;
+    /**
+     * Send a new user message given the prior conversation history.
+     * Returns the updated history (with the new user turn and the
+     * assistant's response appended).
+     */
+    chatMultiTurn(query: string, history: ChatHistory, serverClient: ServerClient, serverAlias: string, callbacks: MultiTurnCallbacks): Promise<ChatHistory>;
+    /**
+     * Release any resources this provider holds (HTTP bridge, child
+     * processes, etc.). Safe to call multiple times.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Optional: clear any cached server context so the next chat turn
+     * re-fetches fresh data from the Proxmox API.
+     * Not all providers cache context — callers should treat as a no-op if absent.
+     */
+    invalidateContextCache?(): void;
+}
+/** Construction options common to every provider. */
+export interface ProviderOptions {
+    /** Anthropic API key (required for the anthropic provider, ignored otherwise). */
+    apiKey?: string;
+    /** Model id to route with. */
+    model: string;
+    /** Max tokens per response (anthropic only). */
+    maxTokens?: number;
+    /** Request timeout (anthropic only), ms. */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/ai/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/base.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,oDAAoD;IACpD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,+CAA+C;IAC/C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,uEAAuE;IACvE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACvD,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;CACrD;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACvB,+DAA+D;IAC/D,QAAQ,IAAI,MAAM,CAAC;IAEnB;;;OAGG;IACH,IAAI,CACA,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;OAIG;IACH,aAAa,CACT,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;OAIG;IACH,sBAAsB,CAAC,IAAI,IAAI,CAAC;CACnC;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC5B,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/ai/providers/base.js

@@ -0,0 +1,9 @@
+// ---------------------------------------------------------------------------
+// AIProvider interface — minimum surface every provider must implement
+// ---------------------------------------------------------------------------
+// Callers (oneshot/run.ts, interactive/useRackMind.ts) depend ONLY on this
+// interface. Concrete providers (anthropic, claude-code) live in sibling
+// files and are wired up by providers/index.ts via getAIProvider(modelId).
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=base.js.map

package/dist/ai/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/ai/providers/base.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,8EAA8E"}

package/dist/ai/providers/claude-code-bridge.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ClaudeCodeBridge — loopback HTTP tool bridge for the spawned `claude`
+ * CLI child. Ported from the desktop app's bridge with one adaptation:
+ * the executor here runs the CLI's in-process tools (src/ai/tool-executor.ts)
+ * instead of delegating to Electron IPC. The security model (loopback bind,
+ * random shared secret, Host header check, body cap, request timeout) is
+ * identical to the desktop version.
+ */
+import type Anthropic from '@anthropic-ai/sdk';
+import type { ServerClient } from '../../server/client.js';
+import { type ConfirmDestructiveFn } from '../tool-executor.js';
+export interface BridgeToolCallback {
+    (toolName: string, label: string, isError: boolean, content: string): void;
+}
+export interface BridgeHandle {
+    bridgeDir: string;
+    port: number;
+    secret: string;
+    stop(): Promise<void>;
+}
+/**
+ * Build a concise manifest of RackMind tools for injection into the Claude
+ * Code system prompt. Lists every available tool with its description,
+ * input schema, and an example invocation so the model knows what to call
+ * via `rackmind-bridge`.
+ */
+export declare function buildToolManifest(tools: Anthropic.Messages.Tool[]): string;
+export interface StartBridgeOptions {
+    /** Server client the in-process tool executor dispatches to. */
+    serverClient: ServerClient;
+    /**
+     * Optional observer called for every bridge tool invocation — lets the
+     * caller forward a display label into the REPL's tool-event stream.
+     */
+    onToolCall?: BridgeToolCallback;
+    /** Signal that aborts pending/future tool calls (returns `cancelled`). */
+    signal?: AbortSignal;
+    /**
+     * Confirmation callback for destructive tools (stop/restart/start of guests).
+     * Returning false from this callback cancels the action — the bridge returns
+     * a non-error result describing the cancellation so the model can react.
+     */
+    confirmDestructive?: ConfirmDestructiveFn;
+}
+/**
+ * Start the local HTTP bridge and write the `rackmind-bridge` helper
+ * script. Returns a handle with the PATH dir and port the child should
+ * see in its env.
+ */
+export declare function startClaudeCodeBridge(opts: StartBridgeOptions): Promise<BridgeHandle>;
+//# sourceMappingURL=claude-code-bridge.d.ts.map

package/dist/ai/providers/claude-code-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-bridge.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/claude-code-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAe,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAa7E,MAAM,WAAW,kBAAkB;IAC/B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9E;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAwCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,MAAM,CA+C1E;AA6CD,MAAM,WAAW,kBAAkB;IAC/B,gEAAgE;IAChE,YAAY,EAAE,YAAY,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmP3F"}