rackmind-cli 0.1.2

package/dist/utils/markdown.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Render a markdown string to terminal-formatted output.
+ * Handles code blocks, bold, italic, lists, headers, links, etc.
+ */
+export declare function renderMarkdown(text: string): string;
+/**
+ * Render markdown for streaming output — handles partial markdown gracefully.
+ * This is less aggressive than full rendering to avoid broken partial blocks.
+ * Applies inline formatting only (bold, italic, code spans).
+ */
+export declare function renderMarkdownInline(text: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AA4CA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBnD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYzD"}

package/dist/utils/markdown.js

@@ -0,0 +1,76 @@
+// ---------------------------------------------------------------------------
+// Markdown rendering — converts AI markdown responses to terminal output
+// ---------------------------------------------------------------------------
+// Uses `marked` + `marked-terminal` for rendering markdown with proper
+// formatting: headers, bold, italic, lists, code blocks with syntax
+// highlighting via `marked-terminal`.
+// ---------------------------------------------------------------------------
+import { marked } from 'marked';
+import { markedTerminal } from 'marked-terminal';
+import chalk from 'chalk';
+// ---------------------------------------------------------------------------
+// Initialization — configure marked with terminal renderer
+// ---------------------------------------------------------------------------
+let initialized = false;
+function ensureInitialized() {
+    if (initialized)
+        return;
+    // marked-terminal returns an object with { renderer, useNewRenderer }
+    // but @types/marked-terminal declares it as returning TerminalRenderer.
+    // Cast to MarkedExtension to satisfy TypeScript — runtime is correct.
+    const terminalExtension = markedTerminal({
+        // Style overrides for terminal rendering
+        strong: chalk.bold,
+        em: chalk.italic,
+        heading: chalk.cyan.bold,
+        hr: () => chalk.dim('-'.repeat(60)),
+        tableOptions: {
+            style: { head: ['cyan'] },
+        },
+    });
+    marked.use(terminalExtension);
+    initialized = true;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Render a markdown string to terminal-formatted output.
+ * Handles code blocks, bold, italic, lists, headers, links, etc.
+ */
+export function renderMarkdown(text) {
+    ensureInitialized();
+    try {
+        const rendered = marked.parse(text);
+        if (typeof rendered !== 'string') {
+            // marked.parse can return a Promise if async extensions are used;
+            // we only use synchronous extensions, so this shouldn't happen
+            return text;
+        }
+        // Trim trailing whitespace but preserve structure
+        return rendered.replace(/\n{3,}/g, '\n\n').trimEnd();
+    }
+    catch {
+        // If rendering fails, return the raw text
+        return text;
+    }
+}
+/**
+ * Render markdown for streaming output — handles partial markdown gracefully.
+ * This is less aggressive than full rendering to avoid broken partial blocks.
+ * Applies inline formatting only (bold, italic, code spans).
+ */
+export function renderMarkdownInline(text) {
+    ensureInitialized();
+    try {
+        const rendered = marked.parseInline(text);
+        if (typeof rendered !== 'string') {
+            return text;
+        }
+        return rendered;
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/utils/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,uEAAuE;AACvE,oEAAoE;AACpE,sCAAsC;AACtC,8EAA8E;AAE9E,OAAO,EAAE,MAAM,EAAwB,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAE9E,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,SAAS,iBAAiB;IACtB,IAAI,WAAW;QAAE,OAAO;IAExB,sEAAsE;IACtE,wEAAwE;IACxE,sEAAsE;IACtE,MAAM,iBAAiB,GAAG,cAAc,CAAC;QACrC,yCAAyC;QACzC,MAAM,EAAE,KAAK,CAAC,IAAI;QAClB,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;QACxB,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,YAAY,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;SAC5B;KACJ,CAA+B,CAAC;IAEjC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAE9B,WAAW,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,iBAAiB,EAAE,CAAC;IAEpB,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,kEAAkE;YAClE,+DAA+D;YAC/D,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,kDAAkD;QAClD,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACL,0CAA0C;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC7C,iBAAiB,EAAE,CAAC;IAEpB,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC"}

package/dist/utils/prompt.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt for a text value. Returns the trimmed input or the default value.
+ */
+export declare function promptText(message: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt for a number. Returns the parsed number or the default value.
+ */
+export declare function promptNumber(message: string, defaultValue: number): Promise<number>;
+/**
+ * Prompt for a secret value (password, token). Masks input with asterisks.
+ */
+export declare function promptSecret(message: string): Promise<string>;
+/**
+ * Prompt for a yes/no confirmation. Returns true for yes.
+ */
+export declare function promptConfirm(message: string, defaultYes?: boolean): Promise<boolean>;
+/**
+ * Prompt for a selection from a list of options.
+ * Returns the selected option value.
+ */
+export declare function promptSelect<T extends string>(message: string, options: Array<{
+    label: string;
+    value: T;
+}>, defaultValue?: T): Promise<T>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/utils/prompt.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWlF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkE7D;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,EAC3C,YAAY,CAAC,EAAE,CAAC,GACjB,OAAO,CAAC,CAAC,CAAC,CAsBZ"}

package/dist/utils/prompt.js

@@ -0,0 +1,133 @@
+// ---------------------------------------------------------------------------
+// Interactive prompts — minimal readline-based prompts for CLI flows
+// ---------------------------------------------------------------------------
+// Uses Node's built-in readline module. No external deps needed.
+// ---------------------------------------------------------------------------
+import readline from 'node:readline';
+function createInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stderr, // prompts go to stderr so stdout stays pipeable
+        terminal: true,
+    });
+}
+/**
+ * Prompt for a text value. Returns the trimmed input or the default value.
+ */
+export function promptText(message, defaultValue) {
+    const rl = createInterface();
+    const suffix = defaultValue ? ` (${defaultValue})` : '';
+    return new Promise((resolve) => {
+        rl.question(`${message}${suffix}: `, (answer) => {
+            rl.close();
+            const trimmed = answer.trim();
+            resolve(trimmed || defaultValue || '');
+        });
+    });
+}
+/**
+ * Prompt for a number. Returns the parsed number or the default value.
+ */
+export async function promptNumber(message, defaultValue) {
+    const raw = await promptText(message, String(defaultValue));
+    const parsed = parseInt(raw, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Prompt for a secret value (password, token). Masks input with asterisks.
+ */
+export function promptSecret(message) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stderr,
+            terminal: true,
+        });
+        // Mask input characters
+        const originalWrite = rl.write.bind(rl);
+        let masked = false;
+        process.stderr.write(`${message}: `);
+        masked = true;
+        // We need to handle the raw mode ourselves for masking
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        let secret = '';
+        const onData = (key) => {
+            const char = key.toString('utf8');
+            if (char === '\n' || char === '\r') {
+                // Enter pressed
+                process.stderr.write('\n');
+                if (process.stdin.isTTY) {
+                    process.stdin.setRawMode(false);
+                }
+                process.stdin.removeListener('data', onData);
+                rl.close();
+                resolve(secret);
+            }
+            else if (char === '\u0003') {
+                // Ctrl+C
+                process.stderr.write('\n');
+                if (process.stdin.isTTY) {
+                    process.stdin.setRawMode(false);
+                }
+                process.stdin.removeListener('data', onData);
+                rl.close();
+                process.exit(130);
+            }
+            else if (char === '\u007F' || char === '\b') {
+                // Backspace
+                if (secret.length > 0) {
+                    secret = secret.slice(0, -1);
+                    process.stderr.write('\b \b');
+                }
+            }
+            else if (masked && char.length === 1 && char.charCodeAt(0) >= 32) {
+                secret += char;
+                process.stderr.write('*');
+            }
+        };
+        // Suppress the default readline behavior when in raw mode
+        rl.write = (...args) => {
+            if (!masked) {
+                return originalWrite(...args);
+            }
+            // Suppress default output during masked input
+            return undefined;
+        };
+        process.stdin.on('data', onData);
+    });
+}
+/**
+ * Prompt for a yes/no confirmation. Returns true for yes.
+ */
+export async function promptConfirm(message, defaultYes = false) {
+    const hint = defaultYes ? '[Y/n]' : '[y/N]';
+    const raw = await promptText(`${message} ${hint}`);
+    if (!raw)
+        return defaultYes;
+    return raw.toLowerCase().startsWith('y');
+}
+/**
+ * Prompt for a selection from a list of options.
+ * Returns the selected option value.
+ */
+export async function promptSelect(message, options, defaultValue) {
+    process.stderr.write(`\n${message}\n`);
+    for (let i = 0; i < options.length; i++) {
+        const marker = options[i].value === defaultValue ? ' (default)' : '';
+        process.stderr.write(`  ${i + 1}. ${options[i].label}${marker}\n`);
+    }
+    const raw = await promptText('Select', defaultValue ? '1' : undefined);
+    const index = parseInt(raw, 10) - 1;
+    if (index >= 0 && index < options.length) {
+        return options[index].value;
+    }
+    // Try matching by value
+    const match = options.find((o) => o.value === raw || o.label.toLowerCase() === raw.toLowerCase());
+    if (match)
+        return match.value;
+    // Fall back to default
+    return defaultValue ?? options[0].value;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/utils/prompt.js.map

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

package/dist/utils/retry.d.ts

@@ -0,0 +1,37 @@
+export interface RetryOptions {
+    /** Maximum number of attempts (including the first) */
+    maxAttempts: number;
+    /** Initial delay in milliseconds before first retry */
+    initialDelayMs: number;
+    /** Maximum delay in milliseconds between retries */
+    maxDelayMs: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+    /** Optional predicate to decide if an error is retryable */
+    isRetryable?: (error: unknown) => boolean;
+    /** Optional callback called before each retry */
+    onRetry?: (attempt: number, error: unknown, delayMs: number) => void;
+}
+/**
+ * Check if an error is likely a transient failure worth retrying.
+ */
+export declare function isTransientError(error: unknown): boolean;
+/**
+ * Check if an error is an Anthropic rate limit specifically.
+ * These get special treatment with longer backoff.
+ */
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Execute a function with retry logic and exponential backoff.
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration
+ * @returns The result of the function
+ * @throws The last error if all attempts fail
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+/** Retry options for Claude API calls (rate limit + overload) */
+export declare const CLAUDE_API_RETRY: RetryOptions;
+/** Retry options for SSH reconnection */
+export declare const SSH_RECONNECT_RETRY: RetryOptions;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IACzB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA+BxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIxD;AAMD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAuC1F;AAcD,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,EAAE,YAK9B,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,mBAAmB,EAAE,YAejC,CAAC"}

package/dist/utils/retry.js

@@ -0,0 +1,122 @@
+// ---------------------------------------------------------------------------
+// Retry utility — exponential backoff for transient failures
+// ---------------------------------------------------------------------------
+// Used for Claude API rate limits, SSH reconnects, and Proxmox API retries.
+// ---------------------------------------------------------------------------
+import { logger } from './logger.js';
+// ---------------------------------------------------------------------------
+// Default retryable error detection
+// ---------------------------------------------------------------------------
+/**
+ * Check if an error is likely a transient failure worth retrying.
+ */
+export function isTransientError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const lc = message.toLowerCase();
+    // Rate limits
+    if (lc.includes('429') || lc.includes('rate_limit') || lc.includes('rate limit')) {
+        return true;
+    }
+    // API overloaded
+    if (lc.includes('overloaded') || lc.includes('529') || lc.includes('503')) {
+        return true;
+    }
+    // Network errors
+    if (lc.includes('econnreset') ||
+        lc.includes('etimedout') ||
+        lc.includes('socket hang up') ||
+        lc.includes('epipe') ||
+        lc.includes('network')) {
+        return true;
+    }
+    // Server errors (5xx)
+    if (lc.includes('500') || lc.includes('502') || lc.includes('504')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if an error is an Anthropic rate limit specifically.
+ * These get special treatment with longer backoff.
+ */
+export function isRateLimitError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const lc = message.toLowerCase();
+    return lc.includes('429') || lc.includes('rate_limit') || lc.includes('rate limit');
+}
+// ---------------------------------------------------------------------------
+// Retry function
+// ---------------------------------------------------------------------------
+/**
+ * Execute a function with retry logic and exponential backoff.
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration
+ * @returns The result of the function
+ * @throws The last error if all attempts fail
+ */
+export async function withRetry(fn, options) {
+    const { maxAttempts, initialDelayMs, maxDelayMs, backoffMultiplier = 2 } = options;
+    const isRetryable = options.isRetryable ?? isTransientError;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry if we've exhausted attempts or error isn't retryable
+            if (attempt >= maxAttempts || !isRetryable(error)) {
+                throw error;
+            }
+            // Calculate delay with exponential backoff + jitter
+            const baseDelay = initialDelayMs * Math.pow(backoffMultiplier, attempt - 1);
+            const jitter = Math.random() * 0.3 * baseDelay; // 0-30% jitter
+            const delay = Math.min(baseDelay + jitter, maxDelayMs);
+            logger.info('Retrying after transient error', {
+                attempt,
+                maxAttempts,
+                delayMs: Math.round(delay),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (options.onRetry) {
+                options.onRetry(attempt, error, Math.round(delay));
+            }
+            await sleep(delay);
+        }
+    }
+    // Should not reach here, but TypeScript needs it
+    throw lastError;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ---------------------------------------------------------------------------
+// Presets
+// ---------------------------------------------------------------------------
+/** Retry options for Claude API calls (rate limit + overload) */
+export const CLAUDE_API_RETRY = {
+    maxAttempts: 3,
+    initialDelayMs: 2000,
+    maxDelayMs: 30_000,
+    isRetryable: isTransientError,
+};
+/** Retry options for SSH reconnection */
+export const SSH_RECONNECT_RETRY = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 10_000,
+    isRetryable: (error) => {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (msg.includes('ECONNRESET') ||
+            msg.includes('ECONNREFUSED') ||
+            msg.includes('ETIMEDOUT') ||
+            msg.includes('not connected') ||
+            msg.includes('SSH') ||
+            msg.includes('socket hang up'));
+    },
+};
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/shutdown.d.ts

@@ -0,0 +1,22 @@
+type CleanupFn = () => void | Promise<void>;
+/**
+ * Register a cleanup function to be called on shutdown.
+ * Functions are called in reverse order (LIFO).
+ */
+export declare function onShutdown(fn: CleanupFn): void;
+/**
+ * Remove a previously registered cleanup function.
+ */
+export declare function removeShutdownHandler(fn: CleanupFn): void;
+/**
+ * Run all cleanup functions. Called automatically on SIGINT/SIGTERM,
+ * but can also be called manually for controlled shutdown.
+ */
+export declare function runCleanup(): Promise<void>;
+/**
+ * Register SIGINT and SIGTERM signal handlers for graceful shutdown.
+ * Call once at application startup. Safe to call multiple times.
+ */
+export declare function registerSignalHandlers(): void;
+export {};
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/utils/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/utils/shutdown.ts"],"names":[],"mappings":"AAaA,KAAK,SAAS,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAS5C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAE9C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAKzD;AAED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAoBhD;AAQD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAqC7C"}

package/dist/utils/shutdown.js

@@ -0,0 +1,94 @@
+// ---------------------------------------------------------------------------
+// Graceful shutdown — clean up resources on exit
+// ---------------------------------------------------------------------------
+// Registers SIGINT/SIGTERM handlers and tracks resources that need cleanup.
+// Ensures SSH connections are closed and optional conversation history is saved.
+// ---------------------------------------------------------------------------
+import { logger } from './logger.js';
+// ---------------------------------------------------------------------------
+// Cleanup registry
+// ---------------------------------------------------------------------------
+const cleanupFns = [];
+let shutdownInitiated = false;
+/**
+ * Register a cleanup function to be called on shutdown.
+ * Functions are called in reverse order (LIFO).
+ */
+export function onShutdown(fn) {
+    cleanupFns.push(fn);
+}
+/**
+ * Remove a previously registered cleanup function.
+ */
+export function removeShutdownHandler(fn) {
+    const index = cleanupFns.indexOf(fn);
+    if (index >= 0) {
+        cleanupFns.splice(index, 1);
+    }
+}
+/**
+ * Run all cleanup functions. Called automatically on SIGINT/SIGTERM,
+ * but can also be called manually for controlled shutdown.
+ */
+export async function runCleanup() {
+    if (shutdownInitiated)
+        return;
+    shutdownInitiated = true;
+    logger.info('Running shutdown cleanup', { handlerCount: cleanupFns.length });
+    // Run in reverse order (LIFO)
+    const fns = [...cleanupFns].reverse();
+    for (const fn of fns) {
+        try {
+            await fn();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logger.error('Cleanup handler failed', { error: message });
+            // Continue with other cleanup handlers
+        }
+    }
+    cleanupFns.length = 0;
+}
+// ---------------------------------------------------------------------------
+// Signal handlers
+// ---------------------------------------------------------------------------
+let handlersRegistered = false;
+/**
+ * Register SIGINT and SIGTERM signal handlers for graceful shutdown.
+ * Call once at application startup. Safe to call multiple times.
+ */
+export function registerSignalHandlers() {
+    if (handlersRegistered)
+        return;
+    handlersRegistered = true;
+    const handleSignal = (signal) => {
+        logger.info('Received signal', { signal });
+        runCleanup()
+            .then(() => {
+            process.exit(0);
+        })
+            .catch(() => {
+            process.exit(1);
+        });
+    };
+    process.on('SIGINT', () => handleSignal('SIGINT'));
+    process.on('SIGTERM', () => handleSignal('SIGTERM'));
+    // Handle uncaught exceptions gracefully
+    process.on('uncaughtException', (error) => {
+        logger.error('Uncaught exception', { error: error.message, stack: error.stack });
+        runCleanup()
+            .then(() => {
+            process.exit(1);
+        })
+            .catch(() => {
+            process.exit(1);
+        });
+    });
+    // Handle unhandled promise rejections
+    process.on('unhandledRejection', (reason) => {
+        const message = reason instanceof Error ? reason.message : String(reason);
+        logger.error('Unhandled rejection', { error: message });
+        // Don't exit on unhandled rejections — log and continue
+    });
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/utils/shutdown.js.map

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

package/dist/utils/table.d.ts

@@ -0,0 +1,38 @@
+import Table from 'cli-table3';
+export declare const TABLE_CHARS: Table.TableConstructorOptions['chars'];
+/**
+ * Format bytes into a human-readable string (e.g., 1.23 GiB).
+ * Uses binary units (1 GiB = 1024^3 bytes).
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format a ratio (0-1) as a colored percentage string.
+ * Green: 0-59%, Yellow: 60-84%, Red: 85-100%
+ */
+export declare function formatPercent(ratio: number): string;
+/**
+ * Format a usage bar with percentage (e.g., "45% [████████░░░░░░░]").
+ */
+export declare function formatUsageBar(ratio: number, width?: number): string;
+/**
+ * Format uptime in seconds into a human-readable string (e.g., "3d 12h 5m").
+ */
+export declare function formatUptime(seconds: number): string;
+/**
+ * Color-code a guest status string.
+ * running = green, stopped = yellow, paused = cyan, error/unknown = red
+ */
+export declare function colorStatus(status: string): string;
+/**
+ * Truncate a string to the given max length, appending an ellipsis if needed.
+ */
+export declare function truncate(str: string, maxLen: number): string;
+/**
+ * Create a styled cli-table3 instance with consistent formatting.
+ */
+export declare function createTable(head: string[]): Table.Table;
+/**
+ * Print a section header with a title and optional count.
+ */
+export declare function printSectionHeader(title: string, count?: number): void;
+//# sourceMappingURL=table.d.ts.map

package/dist/utils/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/utils/table.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,YAAY,CAAC;AAM/B,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,uBAAuB,CAAC,OAAO,CAgB9D,CAAC;AAMF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUjD;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,CAQhE;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAapD;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAclD;AAMD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAMvD;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAGtE"}