@codedir/mimir-code 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,754 @@
+import { z } from 'zod';
+
+/**
+ * Core type definitions for Mimir
+ */
+interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+    name?: string;
+    toolCalls?: ToolCall[];
+    metadata?: MessageMetadata;
+}
+interface MessageMetadata {
+    timestamp?: number;
+    duration?: number;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    cost?: number;
+    model?: string;
+    provider?: string;
+}
+interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+interface ToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+interface ChatResponse {
+    content: string;
+    toolCalls?: ToolCall[];
+    finishReason: 'stop' | 'tool_calls' | 'length' | 'error';
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+}
+interface ChatChunk {
+    content: string;
+    done: boolean;
+}
+type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+interface PermissionDecision {
+    command: string;
+    riskLevel: RiskLevel;
+    decision: 'allow' | 'deny' | 'always' | 'never';
+    timestamp: number;
+}
+interface Action {
+    type: 'tool_call' | 'finish';
+    toolName?: string;
+    arguments?: Record<string, unknown>;
+    result?: unknown;
+}
+interface Observation {
+    type: 'tool_result' | 'permission_denied' | 'error';
+    data?: unknown;
+    error?: string;
+}
+interface LLMConfig {
+    provider: string;
+    model: string;
+    apiKey?: string;
+    baseURL?: string;
+    temperature: number;
+    maxTokens: number;
+}
+interface PermissionsConfig {
+    autoAccept: boolean;
+    acceptRiskLevel: RiskLevel;
+    alwaysAcceptCommands: string[];
+}
+interface DockerConfig {
+    enabled: boolean;
+    baseImage: string;
+    cpuLimit?: number;
+    memoryLimit?: string;
+}
+type Result<T, E = Error> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: E;
+};
+declare const createOk: <T>(value: T) => Result<T>;
+declare const createErr: <E = Error>(error: E) => Result<never, E>;
+
+/**
+ * LLM Provider abstraction interface
+ * All providers (DeepSeek, Anthropic, OpenAI, etc.) implement this interface
+ */
+
+interface LLMTool {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+}
+interface ILLMProvider {
+    /**
+     * Send chat completion request
+     */
+    chat(messages: Message[], tools?: LLMTool[]): Promise<ChatResponse>;
+    /**
+     * Stream chat completion response
+     */
+    streamChat(messages: Message[], tools?: LLMTool[]): AsyncGenerator<ChatChunk>;
+    /**
+     * Count tokens in text
+     */
+    countTokens(text: string): number;
+    /**
+     * Calculate cost based on token usage
+     */
+    calculateCost(inputTokens: number, outputTokens: number): number;
+    /**
+     * Get provider name
+     */
+    getProviderName(): string;
+    /**
+     * Get model name
+     */
+    getModelName(): string;
+}
+
+/**
+ * Tool interface and registry
+ */
+
+interface Tool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<never>;
+    execute(args: unknown): Promise<ToolResult>;
+}
+declare class ToolRegistry {
+    private tools;
+    register(tool: Tool): void;
+    unregister(toolName: string): void;
+    get(toolName: string): Tool | undefined;
+    getAll(): Tool[];
+    has(toolName: string): boolean;
+    execute(toolName: string, args: unknown): Promise<ToolResult>;
+}
+
+/**
+ * Core Agent implementation (ReAct loop)
+ */
+
+interface AgentConfig {
+    maxIterations: number;
+    budgetLimit?: number;
+}
+declare class Agent {
+    private toolRegistry;
+    private config;
+    private conversationHistory;
+    private currentIteration;
+    constructor(_provider: ILLMProvider, toolRegistry: ToolRegistry, config: AgentConfig);
+    run(task: string): Promise<Result<unknown>>;
+    private reason;
+    private act;
+    private observe;
+}
+
+/**
+ * Risk assessment for commands with detailed explanations
+ */
+
+interface RiskAssessment {
+    level: RiskLevel;
+    reasons: string[];
+    score: number;
+}
+
+/**
+ * Permission system for command execution
+ */
+
+declare class PermissionManager {
+    private riskAssessor;
+    private allowlist;
+    private blocklist;
+    private auditLog;
+    constructor();
+    checkPermission(command: string): Promise<{
+        allowed: boolean;
+        assessment: RiskAssessment;
+    }>;
+    addToAllowlist(pattern: string): void;
+    addToBlocklist(pattern: string): void;
+    private logDecision;
+    getAuditLog(): PermissionDecision[];
+}
+
+/**
+ * Base LLM Provider implementation
+ * Contains common logic for retry, error handling, etc.
+ */
+
+interface RetryConfig {
+    maxRetries: number;
+    retryDelay: number;
+    backoffMultiplier: number;
+}
+declare abstract class BaseLLMProvider implements ILLMProvider {
+    protected config: LLMConfig;
+    protected retryConfig: RetryConfig;
+    constructor(config: LLMConfig, retryConfig?: RetryConfig);
+    abstract chat(messages: Message[], tools?: LLMTool[]): Promise<ChatResponse>;
+    abstract streamChat(messages: Message[], tools?: LLMTool[]): AsyncGenerator<ChatChunk>;
+    abstract countTokens(text: string): number;
+    abstract calculateCost(inputTokens: number, outputTokens: number): number;
+    getProviderName(): string;
+    getModelName(): string;
+    /**
+     * Retry wrapper for API calls
+     * Only retries on NetworkError (5xx server errors)
+     * Does NOT retry on auth errors, rate limits, or client errors
+     */
+    protected withRetry<T>(fn: () => Promise<T>): Promise<T>;
+    private sleep;
+}
+
+/**
+ * Factory for creating LLM provider instances
+ */
+
+declare class ProviderFactory {
+    static create(config: LLMConfig): ILLMProvider;
+}
+
+/**
+ * Configuration schemas with Zod validation
+ */
+
+declare const ConfigSchema: z.ZodObject<{
+    llm: z.ZodObject<{
+        provider: z.ZodEnum<["deepseek", "anthropic", "openai", "google", "gemini", "qwen", "ollama"]>;
+        model: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseURL: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodDefault<z.ZodNumber>;
+        maxTokens: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: "deepseek" | "anthropic" | "openai" | "google" | "gemini" | "qwen" | "ollama";
+        model: string;
+        temperature: number;
+        maxTokens: number;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+    }, {
+        provider: "deepseek" | "anthropic" | "openai" | "google" | "gemini" | "qwen" | "ollama";
+        model: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+    }>;
+    permissions: z.ZodObject<{
+        autoAccept: z.ZodDefault<z.ZodBoolean>;
+        acceptRiskLevel: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
+        alwaysAcceptCommands: z.ZodEffects<z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>, string[], string[] | null | undefined>;
+    }, "strip", z.ZodTypeAny, {
+        autoAccept: boolean;
+        acceptRiskLevel: "low" | "medium" | "high" | "critical";
+        alwaysAcceptCommands: string[];
+    }, {
+        autoAccept?: boolean | undefined;
+        acceptRiskLevel?: "low" | "medium" | "high" | "critical" | undefined;
+        alwaysAcceptCommands?: string[] | null | undefined;
+    }>;
+    keyBindings: z.ZodObject<{
+        interrupt: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        accept: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        modeSwitch: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        editCommand: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        showTooltip: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        navigateUp: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        navigateDown: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        help: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        clearScreen: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        undo: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        redo: z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>;
+        reject: z.ZodOptional<z.ZodDefault<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>, string[], string | string[]>>>;
+    }, "strip", z.ZodTypeAny, {
+        interrupt: string[];
+        accept: string[];
+        modeSwitch: string[];
+        editCommand: string[];
+        showTooltip: string[];
+        navigateUp: string[];
+        navigateDown: string[];
+        help: string[];
+        clearScreen: string[];
+        undo: string[];
+        redo: string[];
+        reject?: string[] | undefined;
+    }, {
+        interrupt?: string | string[] | undefined;
+        accept?: string | string[] | undefined;
+        modeSwitch?: string | string[] | undefined;
+        editCommand?: string | string[] | undefined;
+        showTooltip?: string | string[] | undefined;
+        navigateUp?: string | string[] | undefined;
+        navigateDown?: string | string[] | undefined;
+        help?: string | string[] | undefined;
+        clearScreen?: string | string[] | undefined;
+        undo?: string | string[] | undefined;
+        redo?: string | string[] | undefined;
+        reject?: string | string[] | undefined;
+    }>;
+    docker: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        baseImage: z.ZodDefault<z.ZodString>;
+        cpuLimit: z.ZodOptional<z.ZodNumber>;
+        memoryLimit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        baseImage: string;
+        cpuLimit?: number | undefined;
+        memoryLimit?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        baseImage?: string | undefined;
+        cpuLimit?: number | undefined;
+        memoryLimit?: string | undefined;
+    }>;
+    ui: z.ZodObject<{
+        theme: z.ZodDefault<z.ZodEnum<["mimir", "dark", "light", "dark-colorblind", "light-colorblind", "dark-ansi", "light-ansi"]>>;
+        syntaxHighlighting: z.ZodDefault<z.ZodBoolean>;
+        showLineNumbers: z.ZodDefault<z.ZodBoolean>;
+        compactMode: z.ZodDefault<z.ZodBoolean>;
+        autocompleteAutoShow: z.ZodDefault<z.ZodBoolean>;
+        autocompleteExecuteOnSelect: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        theme: "mimir" | "dark" | "light" | "dark-colorblind" | "light-colorblind" | "dark-ansi" | "light-ansi";
+        syntaxHighlighting: boolean;
+        showLineNumbers: boolean;
+        compactMode: boolean;
+        autocompleteAutoShow: boolean;
+        autocompleteExecuteOnSelect: boolean;
+    }, {
+        theme?: "mimir" | "dark" | "light" | "dark-colorblind" | "light-colorblind" | "dark-ansi" | "light-ansi" | undefined;
+        syntaxHighlighting?: boolean | undefined;
+        showLineNumbers?: boolean | undefined;
+        compactMode?: boolean | undefined;
+        autocompleteAutoShow?: boolean | undefined;
+        autocompleteExecuteOnSelect?: boolean | undefined;
+    }>;
+    monitoring: z.ZodObject<{
+        metricsRetentionDays: z.ZodDefault<z.ZodNumber>;
+        enableHealthChecks: z.ZodDefault<z.ZodBoolean>;
+        healthCheckIntervalSeconds: z.ZodDefault<z.ZodNumber>;
+        slowOperationThresholdMs: z.ZodDefault<z.ZodNumber>;
+        batchWriteIntervalSeconds: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        metricsRetentionDays: number;
+        enableHealthChecks: boolean;
+        healthCheckIntervalSeconds: number;
+        slowOperationThresholdMs: number;
+        batchWriteIntervalSeconds: number;
+    }, {
+        metricsRetentionDays?: number | undefined;
+        enableHealthChecks?: boolean | undefined;
+        healthCheckIntervalSeconds?: number | undefined;
+        slowOperationThresholdMs?: number | undefined;
+        batchWriteIntervalSeconds?: number | undefined;
+    }>;
+    budget: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        dailyLimit: z.ZodOptional<z.ZodNumber>;
+        weeklyLimit: z.ZodOptional<z.ZodNumber>;
+        monthlyLimit: z.ZodOptional<z.ZodNumber>;
+        warningThreshold: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        warningThreshold: number;
+        dailyLimit?: number | undefined;
+        weeklyLimit?: number | undefined;
+        monthlyLimit?: number | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        dailyLimit?: number | undefined;
+        weeklyLimit?: number | undefined;
+        monthlyLimit?: number | undefined;
+        warningThreshold?: number | undefined;
+    }>;
+    rateLimit: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        commandsPerMinute: z.ZodDefault<z.ZodNumber>;
+        toolExecutionsPerMinute: z.ZodDefault<z.ZodNumber>;
+        llmCallsPerMinute: z.ZodDefault<z.ZodNumber>;
+        maxFileSizeMB: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        commandsPerMinute: number;
+        toolExecutionsPerMinute: number;
+        llmCallsPerMinute: number;
+        maxFileSizeMB: number;
+    }, {
+        enabled?: boolean | undefined;
+        commandsPerMinute?: number | undefined;
+        toolExecutionsPerMinute?: number | undefined;
+        llmCallsPerMinute?: number | undefined;
+        maxFileSizeMB?: number | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    permissions: {
+        autoAccept: boolean;
+        acceptRiskLevel: "low" | "medium" | "high" | "critical";
+        alwaysAcceptCommands: string[];
+    };
+    llm: {
+        provider: "deepseek" | "anthropic" | "openai" | "google" | "gemini" | "qwen" | "ollama";
+        model: string;
+        temperature: number;
+        maxTokens: number;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+    };
+    keyBindings: {
+        interrupt: string[];
+        accept: string[];
+        modeSwitch: string[];
+        editCommand: string[];
+        showTooltip: string[];
+        navigateUp: string[];
+        navigateDown: string[];
+        help: string[];
+        clearScreen: string[];
+        undo: string[];
+        redo: string[];
+        reject?: string[] | undefined;
+    };
+    docker: {
+        enabled: boolean;
+        baseImage: string;
+        cpuLimit?: number | undefined;
+        memoryLimit?: string | undefined;
+    };
+    ui: {
+        theme: "mimir" | "dark" | "light" | "dark-colorblind" | "light-colorblind" | "dark-ansi" | "light-ansi";
+        syntaxHighlighting: boolean;
+        showLineNumbers: boolean;
+        compactMode: boolean;
+        autocompleteAutoShow: boolean;
+        autocompleteExecuteOnSelect: boolean;
+    };
+    monitoring: {
+        metricsRetentionDays: number;
+        enableHealthChecks: boolean;
+        healthCheckIntervalSeconds: number;
+        slowOperationThresholdMs: number;
+        batchWriteIntervalSeconds: number;
+    };
+    budget: {
+        enabled: boolean;
+        warningThreshold: number;
+        dailyLimit?: number | undefined;
+        weeklyLimit?: number | undefined;
+        monthlyLimit?: number | undefined;
+    };
+    rateLimit: {
+        enabled: boolean;
+        commandsPerMinute: number;
+        toolExecutionsPerMinute: number;
+        llmCallsPerMinute: number;
+        maxFileSizeMB: number;
+    };
+}, {
+    permissions: {
+        autoAccept?: boolean | undefined;
+        acceptRiskLevel?: "low" | "medium" | "high" | "critical" | undefined;
+        alwaysAcceptCommands?: string[] | null | undefined;
+    };
+    llm: {
+        provider: "deepseek" | "anthropic" | "openai" | "google" | "gemini" | "qwen" | "ollama";
+        model: string;
+        apiKey?: string | undefined;
+        baseURL?: string | undefined;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+    };
+    keyBindings: {
+        interrupt?: string | string[] | undefined;
+        accept?: string | string[] | undefined;
+        modeSwitch?: string | string[] | undefined;
+        editCommand?: string | string[] | undefined;
+        showTooltip?: string | string[] | undefined;
+        navigateUp?: string | string[] | undefined;
+        navigateDown?: string | string[] | undefined;
+        help?: string | string[] | undefined;
+        clearScreen?: string | string[] | undefined;
+        undo?: string | string[] | undefined;
+        redo?: string | string[] | undefined;
+        reject?: string | string[] | undefined;
+    };
+    docker: {
+        enabled?: boolean | undefined;
+        baseImage?: string | undefined;
+        cpuLimit?: number | undefined;
+        memoryLimit?: string | undefined;
+    };
+    ui: {
+        theme?: "mimir" | "dark" | "light" | "dark-colorblind" | "light-colorblind" | "dark-ansi" | "light-ansi" | undefined;
+        syntaxHighlighting?: boolean | undefined;
+        showLineNumbers?: boolean | undefined;
+        compactMode?: boolean | undefined;
+        autocompleteAutoShow?: boolean | undefined;
+        autocompleteExecuteOnSelect?: boolean | undefined;
+    };
+    monitoring: {
+        metricsRetentionDays?: number | undefined;
+        enableHealthChecks?: boolean | undefined;
+        healthCheckIntervalSeconds?: number | undefined;
+        slowOperationThresholdMs?: number | undefined;
+        batchWriteIntervalSeconds?: number | undefined;
+    };
+    budget: {
+        enabled?: boolean | undefined;
+        dailyLimit?: number | undefined;
+        weeklyLimit?: number | undefined;
+        monthlyLimit?: number | undefined;
+        warningThreshold?: number | undefined;
+    };
+    rateLimit: {
+        enabled?: boolean | undefined;
+        commandsPerMinute?: number | undefined;
+        toolExecutionsPerMinute?: number | undefined;
+        llmCallsPerMinute?: number | undefined;
+        maxFileSizeMB?: number | undefined;
+    };
+}>;
+type Config = z.infer<typeof ConfigSchema>;
+
+/**
+ * Platform-agnostic file system interface
+ * Implementation will use fs/promises + globby
+ */
+interface Stats {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    size: number;
+    mtime: Date;
+}
+interface IFileSystem {
+    /**
+     * Read file contents as string
+     */
+    readFile(path: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Write content to file
+     */
+    writeFile(path: string, content: string, encoding?: BufferEncoding): Promise<void>;
+    /**
+     * Check if file or directory exists
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Create directory (recursive)
+     */
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * Read directory contents
+     */
+    readdir(path: string): Promise<string[]>;
+    /**
+     * Get file/directory stats
+     */
+    stat(path: string): Promise<Stats>;
+    /**
+     * Delete file
+     */
+    unlink(path: string): Promise<void>;
+    /**
+     * Remove directory (recursive)
+     */
+    rmdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * Copy file
+     */
+    copyFile(src: string, dest: string): Promise<void>;
+    /**
+     * Find files matching glob pattern
+     */
+    glob(pattern: string, options?: {
+        cwd?: string;
+        ignore?: string[];
+    }): Promise<string[]>;
+}
+
+/**
+ * Allowlist loader for team-shared command permissions
+ * Loads from .mimir/allowlist.yml
+ */
+
+/**
+ * Allowlist schema
+ */
+declare const AllowlistSchema: z.ZodObject<{
+    commands: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    urls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    envVars: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    bashCommands: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    commands: string[];
+    files: string[];
+    urls: string[];
+    envVars: string[];
+    bashCommands: string[];
+}, {
+    commands?: string[] | undefined;
+    files?: string[] | undefined;
+    urls?: string[] | undefined;
+    envVars?: string[] | undefined;
+    bashCommands?: string[] | undefined;
+}>;
+type Allowlist = z.infer<typeof AllowlistSchema>;
+
+/**
+ * Configuration loader with hierarchy support
+ * Priority: CLI flags > env vars > project config > global config > defaults
+ */
+
+interface ConfigLoadOptions {
+    projectRoot?: string;
+    cliFlags?: Partial<Config>;
+}
+interface ConfigLoadResult {
+    config: Config;
+    allowlist: Allowlist;
+}
+declare class ConfigLoader {
+    private fs;
+    private allowlistLoader;
+    constructor(fs: IFileSystem);
+    /**
+     * Load configuration with full hierarchy:
+     * 1. Default config
+     * 2. Global (~/.mimir/config.yml)
+     * 3. Project (.mimir/config.yml)
+     * 4. Environment variables (.env)
+     * 5. CLI flags
+     *
+     * Also loads allowlist from:
+     * 1. Global (~/.mimir/allowlist.yml)
+     * 2. Project (.mimir/allowlist.yml)
+     */
+    load(options?: ConfigLoadOptions): Promise<ConfigLoadResult>;
+    private getDefaults;
+    private loadGlobalConfig;
+    private loadProjectConfig;
+    private loadEnvConfig;
+    private merge;
+    save(config: Partial<Config>, scope: 'global' | 'project', projectRoot?: string): Promise<void>;
+    validate(config: unknown): Config;
+}
+
+/**
+ * FileSystemAdapter - Cross-platform file system implementation
+ * Uses Node.js fs/promises + globby for file operations
+ */
+
+declare class FileSystemAdapter implements IFileSystem {
+    readFile(path: string, encoding?: BufferEncoding): Promise<string>;
+    writeFile(path: string, content: string, encoding?: BufferEncoding): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    stat(path: string): Promise<Stats>;
+    unlink(path: string): Promise<void>;
+    rmdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    copyFile(src: string, dest: string): Promise<void>;
+    glob(pattern: string, options?: {
+        cwd?: string;
+        ignore?: string[];
+    }): Promise<string[]>;
+}
+
+/**
+ * Logging utility using winston
+ */
+type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+declare class Logger {
+    private logger;
+    private fileLoggingEnabled;
+    private consoleTransport;
+    constructor(logDir?: string);
+    error(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    /**
+     * Disable console logging (useful when Ink UI is active)
+     */
+    disableConsole(): void;
+    /**
+     * Enable console logging
+     */
+    enableConsole(): void;
+}
+declare const logger: Logger;
+
+/**
+ * Custom error classes
+ */
+declare class MimirError extends Error {
+    constructor(message: string);
+}
+declare class ConfigurationError extends MimirError {
+    constructor(message: string);
+}
+declare class ProviderError extends MimirError {
+    readonly provider?: string | undefined;
+    constructor(message: string, provider?: string | undefined);
+}
+declare class ToolExecutionError extends MimirError {
+    readonly toolName?: string | undefined;
+    constructor(message: string, toolName?: string | undefined);
+}
+declare class PermissionDeniedError extends MimirError {
+    readonly command?: string | undefined;
+    constructor(message: string, command?: string | undefined);
+}
+declare class DockerError extends MimirError {
+    constructor(message: string);
+}
+declare class NetworkError extends MimirError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined);
+}
+declare class RateLimitError extends MimirError {
+    readonly retryAfter?: number | undefined;
+    constructor(message: string, retryAfter?: number | undefined);
+}
+
+export { type Action, Agent, type AgentConfig, BaseLLMProvider, type ChatChunk, type ChatResponse, type ConfigLoadOptions, type ConfigLoadResult, ConfigLoader, ConfigurationError, type DockerConfig, DockerError, FileSystemAdapter, type IFileSystem, type ILLMProvider, type LLMConfig, type LLMTool, type LogLevel, Logger, type Message, type MessageMetadata, MimirError, NetworkError, type Observation, type PermissionDecision, PermissionDeniedError, PermissionManager, type PermissionsConfig, ProviderError, ProviderFactory, RateLimitError, type Result, type RetryConfig, type RiskLevel, type Tool, type ToolCall, ToolExecutionError, ToolRegistry, type ToolResult, createErr, createOk, logger };