rackmind-cli 0.1.4 → 0.1.6

package/README.md

@@ -182,14 +182,14 @@ rackmind logout
 
 ### Free vs Pro
 
-| Feature                    | Free            | Pro ($15/mo)     |
-| -------------------------- | --------------- | ---------------- |
-| Server connections         | 1               | Unlimited        |
-| Managed AI interactions/mo | 25              | 200              |
-| Bring Your Own Key (BYOK)  | --              | Unlimited        |
-| Solution memory            | --              | Included         |
-| Historical metrics         | 1 hour          | Unlimited        |
-| Terminal AI                | --              | Included         |
+| Feature                    | Free   | Pro ($15/mo) |
+| -------------------------- | ------ | ------------ |
+| Server connections         | 1      | Unlimited    |
+| Managed AI interactions/mo | 25     | 200          |
+| Bring Your Own Key (BYOK)  | --     | Unlimited    |
+| Solution memory            | --     | Included     |
+| Historical metrics         | 1 hour | Unlimited    |
+| Terminal AI                | --     | Included     |
 
 **Free tier** -- great for trying RackMind on a single server with basic AI assistance.
 

package/dist/ai/models.d.ts

@@ -0,0 +1,40 @@
+export type AIProviderKind = 'anthropic' | 'claude-code';
+export interface ModelOption {
+    /** Model id used in config and passed to getAIProvider(). */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Provider family. */
+    provider: AIProviderKind;
+    /** Whether this is the default model for new conversations. */
+    isDefault?: boolean;
+}
+export declare const DEFAULT_ANTHROPIC_MODEL_ID = "claude-sonnet-4-5";
+/**
+ * Feature flag for the private `claude-code` provider. Invisible to every
+ * user-facing surface unless this returns true. Do NOT document this env
+ * var or mention it in error messages.
+ */
+export declare function isClaudeCodeEnabled(): boolean;
+/** Look up a model by id. Returns undefined if unknown. */
+export declare function getModelById(modelId: string): ModelOption | undefined;
+/**
+ * Models that should be shown in user-facing surfaces right now. Filters
+ * out gated providers whose feature flag is off.
+ */
+export declare function getVisibleModels(): ModelOption[];
+/**
+ * Get the provider kind for a model id, or undefined if the model is
+ * unknown OR gated off in the current environment. Use this instead of
+ * reaching into ALL_MODELS directly when you need to decide whether to
+ * route a request — it enforces the gate.
+ */
+export declare function getVisibleProviderForModel(modelId: string): AIProviderKind | undefined;
+/**
+ * Resolve a preferred model id to one that is actually usable right now.
+ * If the preferred id is unknown or points at a gated-off provider, falls
+ * back to the default Anthropic model so the user isn't left stranded by
+ * a stale config value.
+ */
+export declare function resolveUsableModelId(preferredModelId: string | undefined): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/ai/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/ai/models.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAEzD,MAAM,WAAW,WAAW;IACxB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAiC9D;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAErE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKjF"}

package/dist/ai/models.js

@@ -0,0 +1,90 @@
+// ---------------------------------------------------------------------------
+// Model registry & visibility gating
+// ---------------------------------------------------------------------------
+// Central catalogue of AI models the CLI knows how to route. Every surface
+// that enumerates models for the user (slash commands, config, help text)
+// MUST filter through getVisibleModels() so gated providers stay invisible
+// to normal users.
+// ---------------------------------------------------------------------------
+export const DEFAULT_ANTHROPIC_MODEL_ID = 'claude-sonnet-4-5';
+/**
+ * The full list of models the CLI knows about. Keep tight — every entry
+ * here shows up in the user-facing model picker once its provider is
+ * visible.
+ */
+const ALL_MODELS = [
+    {
+        id: 'claude-sonnet-4-5',
+        name: 'Claude Sonnet 4.5',
+        provider: 'anthropic',
+        isDefault: true,
+    },
+    {
+        id: 'claude-haiku-4-5-20251001',
+        name: 'Claude Haiku 4.5',
+        provider: 'anthropic',
+    },
+    // Intentionally undocumented entries below. Gated — never surface
+    // unless isClaudeCodeEnabled() returns true.
+    {
+        id: 'claude-code:sonnet',
+        name: 'Claude Code (Sonnet)',
+        provider: 'claude-code',
+    },
+    {
+        id: 'claude-code:opus',
+        name: 'Claude Code (Opus)',
+        provider: 'claude-code',
+    },
+];
+/**
+ * Feature flag for the private `claude-code` provider. Invisible to every
+ * user-facing surface unless this returns true. Do NOT document this env
+ * var or mention it in error messages.
+ */
+export function isClaudeCodeEnabled() {
+    return process.env.RACKMIND_CLAUDE_CODE === '1';
+}
+/** Look up a model by id. Returns undefined if unknown. */
+export function getModelById(modelId) {
+    return ALL_MODELS.find((m) => m.id === modelId);
+}
+/**
+ * Models that should be shown in user-facing surfaces right now. Filters
+ * out gated providers whose feature flag is off.
+ */
+export function getVisibleModels() {
+    const claudeCodeEnabled = isClaudeCodeEnabled();
+    return ALL_MODELS.filter((m) => {
+        if (m.provider === 'claude-code')
+            return claudeCodeEnabled;
+        return true;
+    });
+}
+/**
+ * Get the provider kind for a model id, or undefined if the model is
+ * unknown OR gated off in the current environment. Use this instead of
+ * reaching into ALL_MODELS directly when you need to decide whether to
+ * route a request — it enforces the gate.
+ */
+export function getVisibleProviderForModel(modelId) {
+    const model = getModelById(modelId);
+    if (!model)
+        return undefined;
+    if (model.provider === 'claude-code' && !isClaudeCodeEnabled())
+        return undefined;
+    return model.provider;
+}
+/**
+ * Resolve a preferred model id to one that is actually usable right now.
+ * If the preferred id is unknown or points at a gated-off provider, falls
+ * back to the default Anthropic model so the user isn't left stranded by
+ * a stale config value.
+ */
+export function resolveUsableModelId(preferredModelId) {
+    if (preferredModelId && getVisibleProviderForModel(preferredModelId)) {
+        return preferredModelId;
+    }
+    return DEFAULT_ANTHROPIC_MODEL_ID;
+}
+//# sourceMappingURL=models.js.map

package/dist/ai/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/ai/models.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAC9E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,mBAAmB;AACnB,8EAA8E;AAe9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,GAAkB;IAC9B;QACI,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,IAAI;KAClB;IACD;QACI,EAAE,EAAE,2BAA2B;QAC/B,IAAI,EAAE,kBAAkB;QACxB,QAAQ,EAAE,WAAW;KACxB;IACD,kEAAkE;IAClE,6CAA6C;IAC7C;QACI,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,aAAa;KAC1B;IACD;QACI,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,aAAa;KAC1B;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,CAAC;AACpD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,OAAe;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC5B,MAAM,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;IAChD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,IAAI,CAAC,CAAC,QAAQ,KAAK,aAAa;YAAE,OAAO,iBAAiB,CAAC;QAC3D,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACtD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,mBAAmB,EAAE;QAAE,OAAO,SAAS,CAAC;IACjF,OAAO,KAAK,CAAC,QAAQ,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,gBAAoC;IACrE,IAAI,gBAAgB,IAAI,0BAA0B,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnE,OAAO,gBAAgB,CAAC;IAC5B,CAAC;IACD,OAAO,0BAA0B,CAAC;AACtC,CAAC"}

package/dist/ai/providers/anthropic-provider.d.ts

@@ -0,0 +1,18 @@
+import type { ServerClient } from '../../server/client.js';
+import type { AIProvider, ChatHistory, MultiTurnCallbacks, ProviderOptions, StreamCallbacks } from './base.js';
+export declare class AnthropicProvider implements AIProvider {
+    private readonly anthropic;
+    private readonly model;
+    private readonly maxTokens;
+    constructor(options: ProviderOptions);
+    getModel(): string;
+    chat(query: string, serverClient: ServerClient, serverAlias: string, callbacks: StreamCallbacks): Promise<void>;
+    chatMultiTurn(query: string, history: ChatHistory, serverClient: ServerClient, serverAlias: string, callbacks: MultiTurnCallbacks): Promise<ChatHistory>;
+    dispose(): Promise<void>;
+    /**
+     * Create a message with retry logic for transient errors.
+     * Rate limits and overload errors trigger exponential backoff.
+     */
+    private createWithRetry;
+}
+//# sourceMappingURL=anthropic-provider.d.ts.map

package/dist/ai/providers/anthropic-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-provider.d.ts","sourceRoot":"","sources":["../../../src/ai/providers/anthropic-provider.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAO3D,OAAO,KAAK,EACR,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,eAAe,EAClB,MAAM,WAAW,CAAC;AAKnB,qBAAa,iBAAkB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,eAAe;IAYpC,QAAQ,IAAI,MAAM;IAIZ,IAAI,CACN,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,GAC3B,OAAO,CAAC,IAAI,CAAC;IAyDV,aAAa,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAwEjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACH,OAAO,CAAC,eAAe;CAgC1B"}

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

@@ -0,0 +1,167 @@
+// ---------------------------------------------------------------------------
+// Anthropic provider — original AIClient logic, now behind AIProvider
+// ---------------------------------------------------------------------------
+// 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';
+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;
+export class AnthropicProvider {
+    anthropic;
+    model;
+    maxTokens;
+    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,
+        });
+        this.model = options.model || DEFAULT_ANTHROPIC_MODEL_ID;
+        this.maxTokens = options.maxTokens ?? 4096;
+    }
+    getModel() {
+        return this.model;
+    }
+    async chat(query, serverClient, serverAlias, callbacks) {
+        const context = await fetchServerContext(serverClient);
+        const systemPrompt = buildSystemPrompt(context, serverAlias);
+        const tools = getToolDefinitions();
+        const messages = [{ role: 'user', content: query }];
+        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);
+            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 (response.stop_reason === 'end_turn' || toolUseBlocks.length === 0) {
+                logger.debug('AI conversation complete', {
+                    iterations: iteration + 1,
+                    stopReason: response.stop_reason,
+                });
+                return;
+            }
+            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,
+                });
+            }
+            messages.push({ role: 'user', content: toolResults });
+        }
+        callbacks.onError('Reached maximum tool iterations. The AI may be stuck in a loop.');
+    }
+    async chatMultiTurn(query, history, serverClient, serverAlias, callbacks) {
+        const context = await fetchServerContext(serverClient);
+        const systemPrompt = buildSystemPrompt(context, serverAlias);
+        const tools = getToolDefinitions();
+        const messages = [
+            ...history,
+            { role: 'user', content: query },
+        ];
+        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);
+            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 (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;
+            }
+            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;
+    }
+    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.
+     */
+    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 });
+            },
+        });
+    }
+}
+//# 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,67 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { ServerClient } from '../../server/client.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;
+}
+/** 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>;
+}
+/** 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;AAE3D,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;CACpC;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;CAC5B;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,44 @@
+/**
+ * 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';
+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;
+}
+/**
+ * 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,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;CACxB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAkP3F"}