rackmind-cli 0.1.2

package/README.md

@@ -0,0 +1,179 @@
+# rackmind-cli
+
+AI-powered infrastructure management for MSPs. A Claude Code-style terminal experience for managing Proxmox servers, LXC containers, and QEMU VMs through natural language.
+
+## Installation
+
+```bash
+npm install -g rackmind-cli
+```
+
+Or link locally for development:
+
+```bash
+git clone https://github.com/rackmind-ai/rackmind-cli.git
+cd rackmind-cli
+npm install
+npm run build
+npm link
+```
+
+## Quick Start
+
+```bash
+# Add your first server
+rackmind connect my-proxmox
+
+# Set your Anthropic API key
+rackmind config set-api-key
+
+# Launch interactive REPL
+rackmind
+
+# Or ask a one-shot question
+rackmind "what containers are running?"
+```
+
+## Usage
+
+### Interactive Mode (REPL)
+
+Launch with no arguments to enter the full interactive terminal:
+
+```bash
+rackmind
+```
+
+Features:
+
+- Natural language queries about your infrastructure
+- AI-powered command execution with tool use
+- Streaming responses with markdown rendering
+- Slash commands: `/connect`, `/servers`, `/clear`, `/model`, `/help`, `/exit`
+- Keyboard shortcuts: Up/Down for history, Ctrl+C to exit, Ctrl+L to clear
+
+### One-shot Mode
+
+Ask a single question and get a streamed response:
+
+```bash
+rackmind "check disk usage on all containers"
+rackmind ask "restart container 106"
+```
+
+Fully pipeable:
+
+```bash
+rackmind "list running containers" --json | jq '.response'
+rackmind "what is the uptime?" --quiet 2>/dev/null
+```
+
+### Subcommands
+
+#### Server Management
+
+```bash
+rackmind connect <alias>          # Connect to (or create) a server profile
+rackmind servers list              # List all server profiles
+rackmind servers add <alias>       # Add a new server profile
+rackmind servers remove <alias>    # Remove a server profile
+rackmind servers switch <alias>    # Switch the active server
+```
+
+#### Infrastructure Status
+
+```bash
+rackmind status                    # Show config, connection status, server list
+rackmind containers                # List all LXC containers
+rackmind vms                       # List all QEMU virtual machines
+rackmind report                    # Generate a full health report
+```
+
+#### Guest Lifecycle
+
+```bash
+rackmind start <vmid>              # Start a container or VM
+rackmind stop <vmid>               # Stop a container or VM (with confirmation)
+rackmind restart <vmid>            # Restart a container or VM (with confirmation)
+rackmind stop <vmid> --force       # Skip confirmation prompt
+```
+
+#### Command Execution
+
+```bash
+rackmind exec "uptime"                     # Run on the Proxmox host
+rackmind exec "apt update" --target=106    # Run inside LXC container 106
+```
+
+#### Logs
+
+```bash
+rackmind logs <vmid>               # Tail logs for a container or VM
+rackmind logs <vmid> -n 100        # Show last 100 lines
+rackmind logs <vmid> -f            # Follow log output
+```
+
+#### Configuration
+
+```bash
+rackmind config                    # Show current configuration
+rackmind config set <key> <value>  # Set a preference
+rackmind config reset              # Reset preferences to defaults
+rackmind config set-api-key        # Set or update the Anthropic API key
+rackmind config path               # Print the config file path
+```
+
+Available preference keys:
+
+- `model` -- AI model (default: `claude-sonnet-4-5`)
+- `theme` -- Color theme: `dark` or `light`
+- `confirmDestructive` -- Require confirmation for destructive actions (`true`/`false`)
+- `timestampMessages` -- Show timestamps on messages (`true`/`false`)
+
+### Global Flags
+
+These flags work with any command:
+
+| Flag                | Description                                               |
+| ------------------- | --------------------------------------------------------- |
+| `--json`            | Output in JSON format (implies `--quiet`)                 |
+| `--quiet`           | Suppress spinners, banners, and non-essential output      |
+| `--no-color`        | Disable colored output (also respects `NO_COLOR` env var) |
+| `--server <url>`    | Override the RackMind server URL                          |
+| `-i, --interactive` | Force interactive REPL mode                               |
+
+## Configuration
+
+Config is stored at `~/.config/rackmind/config.json` (XDG-compliant).
+
+Credentials (API keys, passwords, token secrets) are encrypted using Node.js `crypto` with a machine-derived key. They are never stored in plaintext.
+
+Config writes are atomic (write to temp file, then rename) to prevent corruption.
+
+## Requirements
+
+- Node.js 20+
+- A Proxmox VE server with API token access
+- An Anthropic API key (for AI features)
+
+## Development
+
+```bash
+npm run dev            # Run in dev mode (tsx)
+npm run build          # Compile TypeScript
+npm run lint           # Run ESLint
+npm run format         # Format with Prettier
+npm run type-check     # Type-check with tsc
+```
+
+All three quality gates must pass before every commit:
+
+```bash
+tsc --noEmit
+npx eslint .
+npx prettier --check .
+```
+
+## License
+
+All rights reserved.

package/bin/rackmind.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import('../dist/index.js').catch((err) => {
+    console.error('Failed to start rackmind:', err.message);
+    process.exit(1);
+});

package/dist/ai/client.d.ts

@@ -0,0 +1,71 @@
+import Anthropic from '@anthropic-ai/sdk';
+import type { ServerClient } from '../server/client.js';
+export interface AIClientOptions {
+    /** Anthropic API key */
+    apiKey: string;
+    /** Model to use (default: claude-sonnet-4-5) */
+    model?: string;
+    /** Max tokens for the response */
+    maxTokens?: number;
+    /** API request timeout in milliseconds (default: 120000) */
+    timeoutMs?: number;
+}
+export interface StreamCallbacks {
+    /** Called for each text chunk as it streams in */
+    onText: (text: string) => void;
+    /** Called when a tool is about to be executed */
+    onToolStart: (toolName: string, label: string) => void;
+    /** Called when a tool finishes executing */
+    onToolEnd: (toolName: string, label: string, isError: boolean) => void;
+    /** Called when an error occurs */
+    onError: (error: string) => void;
+}
+export interface ConversationMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface ToolExecution {
+    toolName: string;
+    label: string;
+    isError: boolean;
+    content: string;
+}
+export interface MultiTurnCallbacks extends StreamCallbacks {
+    /** Called when a tool execution result is available (for display in REPL) */
+    onToolResult?: (execution: ToolExecution) => void;
+}
+export declare class AIClient {
+    private readonly anthropic;
+    private readonly model;
+    private readonly maxTokens;
+    constructor(options: AIClientOptions);
+    /**
+     * 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")
+     */
+    chat(query: string, serverClient: ServerClient, serverAlias: string, callbacks: StreamCallbacks): Promise<void>;
+    /**
+     * 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.
+     */
+    chatMultiTurn(query: string, history: Anthropic.Messages.MessageParam[], serverClient: ServerClient, serverAlias: string, callbacks: MultiTurnCallbacks): Promise<Anthropic.Messages.MessageParam[]>;
+    /**
+     * Create a message with retry logic for transient errors.
+     * Rate limits and overload errors trigger exponential backoff.
+     */
+    private createWithRetry;
+    /** Get the current model name */
+    getModel(): string;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai/client.ts"],"names":[],"mappings":"AASA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWxD,MAAM,WAAW,eAAe;IAC5B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC5B,kDAAkD;IAClD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iDAAiD;IACjD,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,4CAA4C;IAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,kCAAkC;IAClC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AASD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,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,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACvD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,CAAC;CACrD;AAMD,qBAAa,QAAQ;IACjB,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;IASpC;;;;;;;;;OASG;IACG,IAAI,CACN,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,GAC3B,OAAO,CAAC,IAAI,CAAC;IAwEhB;;;;;;;;OAQG;IACG,aAAa,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,EAC1C,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,kBAAkB,GAC9B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IAsF7C;;;OAGG;IACH,OAAO,CAAC,eAAe;IAiCvB,iCAAiC;IACjC,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/ai/client.js

@@ -0,0 +1,198 @@
+// ---------------------------------------------------------------------------
+// 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

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

package/dist/ai/system-prompt.d.ts

@@ -0,0 +1,20 @@
+import type { ServerClient } from '../server/client.js';
+export interface ServerContext {
+    nodeName: string;
+    nodeInfo: string;
+    containers: string;
+    vms: string;
+    containerCount: number;
+    vmCount: number;
+}
+/**
+ * Fetch live server context from the Proxmox API.
+ * Gracefully handles partial failures — if containers can't be listed,
+ * the prompt still includes node info and VMs.
+ */
+export declare function fetchServerContext(client: ServerClient): Promise<ServerContext>;
+/**
+ * Build the full system prompt with live server context.
+ */
+export declare function buildSystemPrompt(context: ServerContext, serverAlias: string): string;
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/ai/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/ai/system-prompt.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAqExD,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA8DrF;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA8BrF"}

package/dist/ai/system-prompt.js

@@ -0,0 +1,169 @@
+// ---------------------------------------------------------------------------
+// System prompt construction — builds context-rich prompts for Claude
+// ---------------------------------------------------------------------------
+// Fetches live server state (containers, VMs, node info) from the Proxmox API
+// and injects it into the system prompt so Claude has full situational awareness.
+// ---------------------------------------------------------------------------
+import { logger } from '../utils/logger.js';
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const value = bytes / Math.pow(1024, i);
+    return `${value.toFixed(1)} ${units[i]}`;
+}
+function formatUptime(seconds) {
+    if (seconds === 0)
+        return 'not running';
+    const days = Math.floor(seconds / 86400);
+    const hours = Math.floor((seconds % 86400) / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const parts = [];
+    if (days > 0)
+        parts.push(`${days}d`);
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    if (minutes > 0)
+        parts.push(`${minutes}m`);
+    return parts.join(' ') || '< 1m';
+}
+function formatContainer(ct) {
+    const memPercent = ct.maxmem > 0 ? ((ct.mem / ct.maxmem) * 100).toFixed(1) : '0';
+    const diskPercent = ct.maxdisk > 0 ? ((ct.disk / ct.maxdisk) * 100).toFixed(1) : '0';
+    return [
+        `  - CT ${ct.vmid} "${ct.name}": ${ct.status}`,
+        `    CPUs: ${ct.cpus} | Memory: ${formatBytes(ct.mem)}/${formatBytes(ct.maxmem)} (${memPercent}%)`,
+        `    Disk: ${formatBytes(ct.disk)}/${formatBytes(ct.maxdisk)} (${diskPercent}%)`,
+        `    Network: in=${formatBytes(ct.netin)} out=${formatBytes(ct.netout)}`,
+        `    Uptime: ${formatUptime(ct.uptime)}`,
+    ].join('\n');
+}
+function formatVM(vm) {
+    const memPercent = vm.maxmem > 0 ? ((vm.mem / vm.maxmem) * 100).toFixed(1) : '0';
+    const diskPercent = vm.maxdisk > 0 ? ((vm.disk / vm.maxdisk) * 100).toFixed(1) : '0';
+    return [
+        `  - VM ${vm.vmid} "${vm.name}": ${vm.status}`,
+        `    CPUs: ${vm.cpus} | Memory: ${formatBytes(vm.mem)}/${formatBytes(vm.maxmem)} (${memPercent}%)`,
+        `    Disk: ${formatBytes(vm.disk)}/${formatBytes(vm.maxdisk)} (${diskPercent}%)`,
+        `    Network: in=${formatBytes(vm.netin)} out=${formatBytes(vm.netout)}`,
+        `    Uptime: ${formatUptime(vm.uptime)}`,
+    ].join('\n');
+}
+function formatNode(node) {
+    const cpuPercent = (node.cpu * 100).toFixed(1);
+    const memPercent = node.maxmem > 0 ? ((node.mem / node.maxmem) * 100).toFixed(1) : '0';
+    const diskPercent = node.maxdisk > 0 ? ((node.disk / node.maxdisk) * 100).toFixed(1) : '0';
+    return [
+        `Node: ${node.node} (${node.status})`,
+        `  CPU: ${cpuPercent}% of ${node.maxcpu} cores`,
+        `  Memory: ${formatBytes(node.mem)}/${formatBytes(node.maxmem)} (${memPercent}%)`,
+        `  Disk: ${formatBytes(node.disk)}/${formatBytes(node.maxdisk)} (${diskPercent}%)`,
+        `  Uptime: ${formatUptime(node.uptime)}`,
+    ].join('\n');
+}
+/**
+ * Fetch live server context from the Proxmox API.
+ * Gracefully handles partial failures — if containers can't be listed,
+ * the prompt still includes node info and VMs.
+ */
+export async function fetchServerContext(client) {
+    const nodeName = await client.getNodeName();
+    let nodeInfo = 'Node status unavailable';
+    let containers = 'Container list unavailable';
+    let vms = 'VM list unavailable';
+    let containerCount = 0;
+    let vmCount = 0;
+    // Fetch all in parallel
+    const [nodeResult, ctResult, vmResult] = await Promise.allSettled([
+        client.getNodeStatus(),
+        client.listContainers(),
+        client.listVMs(),
+    ]);
+    if (nodeResult.status === 'fulfilled') {
+        nodeInfo = formatNode(nodeResult.value);
+    }
+    else {
+        logger.warn('Failed to fetch node status', {
+            error: nodeResult.reason instanceof Error
+                ? nodeResult.reason.message
+                : String(nodeResult.reason),
+        });
+    }
+    if (ctResult.status === 'fulfilled') {
+        const cts = ctResult.value;
+        containerCount = cts.length;
+        if (cts.length === 0) {
+            containers = 'No LXC containers found';
+        }
+        else {
+            containers = cts.map(formatContainer).join('\n');
+        }
+    }
+    else {
+        logger.warn('Failed to fetch containers', {
+            error: ctResult.reason instanceof Error
+                ? ctResult.reason.message
+                : String(ctResult.reason),
+        });
+    }
+    if (vmResult.status === 'fulfilled') {
+        const vmList = vmResult.value;
+        vmCount = vmList.length;
+        if (vmList.length === 0) {
+            vms = 'No QEMU VMs found';
+        }
+        else {
+            vms = vmList.map(formatVM).join('\n');
+        }
+    }
+    else {
+        logger.warn('Failed to fetch VMs', {
+            error: vmResult.reason instanceof Error
+                ? vmResult.reason.message
+                : String(vmResult.reason),
+        });
+    }
+    return { nodeName, nodeInfo, containers, vms, containerCount, vmCount };
+}
+// ---------------------------------------------------------------------------
+// System prompt builder
+// ---------------------------------------------------------------------------
+/**
+ * Build the full system prompt with live server context.
+ */
+export function buildSystemPrompt(context, serverAlias) {
+    return `You are RackMind, an AI assistant specialized in Proxmox server management and Linux system administration. You help MSPs (Managed Service Providers) and IT professionals manage their infrastructure through natural language.
+
+## Connected Server
+Server profile: "${serverAlias}"
+${context.nodeInfo}
+
+## LXC Containers (${context.containerCount} total)
+${context.containers}
+
+## QEMU Virtual Machines (${context.vmCount} total)
+${context.vms}
+
+## Your Capabilities
+You have access to tools that let you:
+- Execute shell commands on the Proxmox host via SSH
+- Execute commands inside LXC containers via pct exec
+- Query container, VM, and node status from the Proxmox API
+- Start, stop, and restart containers and VMs
+- List and refresh container/VM inventories
+
+## Guidelines
+1. When the user asks about server state, use the context above first. Only call tools if you need fresher data or details not included above.
+2. When the user asks you to run a command, use the execute_command or execute_command_in_container tool. Show the command you're running and explain the output.
+3. For DESTRUCTIVE actions (stop, restart, delete, format, rm -rf, etc.), always explain what will happen and ask for confirmation before executing. Never proceed without explicit user consent.
+4. Format output clearly. Use bullet points, tables, or structured text for readability.
+5. If a command fails, explain what went wrong and suggest fixes.
+6. When discussing resource usage, include both absolute values and percentages.
+7. Be concise but thorough. MSPs are busy — get to the point but don't skip important details.
+8. If you don't know something or can't do something, say so clearly rather than guessing.`;
+}
+//# sourceMappingURL=system-prompt.js.map