axon-code 2.4.0

package/dist/types/config.d.ts

@@ -0,0 +1,1259 @@
+/**
+ * Configuration Type Definitions for Axon CLI
+ *
+ * This file provides comprehensive type definitions for all configuration
+ * aspects of the Axon CLI, including API settings, permissions,
+ * hooks, MCP servers, plugins, UI preferences, and more.
+ *
+ * @module types/config
+ * @version 2.1.4
+ */
+/**
+ * Supported Claude model identifiers
+ */
+export type ModelName = 'claude-opus-4-6' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5-20250929' | 'claude-haiku-4-5-20251001' | 'opus' | 'sonnet' | 'haiku';
+/**
+ * Model display name mapping
+ */
+export type ModelDisplayName = 'Claude Opus 4.6' | 'Claude Opus 4.5' | 'Claude Sonnet 4.5' | 'Claude Haiku 4.5';
+/**
+ * API backend provider type
+ */
+export type APIBackend = 'anthropic' | 'bedrock' | 'vertex';
+/**
+ * API configuration
+ */
+export interface APIConfig {
+    /** Anthropic API key */
+    apiKey?: string;
+    /** OAuth token for authenticated sessions */
+    oauthToken?: string;
+    /** Use AWS Bedrock backend */
+    useBedrock?: boolean;
+    /** Use Google Cloud Vertex AI backend */
+    useVertex?: boolean;
+    /** Maximum number of retry attempts for API calls */
+    maxRetries?: number;
+    /** Request timeout in milliseconds */
+    requestTimeout?: number;
+    /** Base URL for API requests (for custom endpoints) */
+    baseURL?: string;
+    /** Additional headers to include in API requests */
+    headers?: Record<string, string>;
+}
+/**
+ * Model generation parameters
+ */
+export interface ModelConfig {
+    /** Model identifier */
+    model?: ModelName;
+    /** Maximum tokens to generate in response */
+    maxTokens?: number;
+    /** Temperature for response generation (0-1) */
+    temperature?: number;
+    /** Top-p sampling parameter */
+    topP?: number;
+    /** Top-k sampling parameter */
+    topK?: number;
+    /** Custom system prompt override */
+    systemPrompt?: string;
+    /** Stop sequences */
+    stopSequences?: string[];
+}
+/**
+ * Permission mode for tool execution
+ */
+export type PermissionMode = 'acceptEdits' | 'bypassPermissions' | 'default' | 'delegate' | 'dontAsk' | 'plan';
+/**
+ * Permission action type
+ */
+export type PermissionAction = 'allow' | 'deny' | 'ask';
+/**
+ * Permission scope
+ */
+export type PermissionScope = 'once' | 'session' | 'always';
+/**
+ * Tool-level permission settings
+ */
+export interface ToolPermissionSettings {
+    /** List of allowed tool names */
+    allow?: string[];
+    /** List of denied tool names */
+    deny?: string[];
+}
+/**
+ * Path-level permission settings (supports glob patterns)
+ */
+export interface PathPermissionSettings {
+    /** List of allowed path patterns */
+    allow?: string[];
+    /** List of denied path patterns */
+    deny?: string[];
+}
+/**
+ * Command-level permission settings for Bash tool
+ */
+export interface CommandPermissionSettings {
+    /** List of allowed command patterns */
+    allow?: string[];
+    /** List of denied command patterns */
+    deny?: string[];
+}
+/**
+ * Network permission settings
+ */
+export interface NetworkPermissionSettings {
+    /** List of allowed domain/URL patterns */
+    allow?: string[];
+    /** List of denied domain/URL patterns */
+    deny?: string[];
+}
+/**
+ * Audit logging configuration
+ */
+export interface AuditSettings {
+    /** Enable audit logging */
+    enabled?: boolean;
+    /** Path to audit log file */
+    logFile?: string;
+    /** Maximum log file size in bytes */
+    maxSize?: number;
+    /** Log rotation count */
+    rotationCount?: number;
+    /** Include sensitive data in logs */
+    includeSensitiveData?: boolean;
+}
+/**
+ * Complete permission configuration
+ */
+export interface PermissionSettings {
+    /** Default permission mode */
+    mode?: PermissionMode;
+    /** Tool-level permissions */
+    tools?: ToolPermissionSettings;
+    /** Path-level permissions */
+    paths?: PathPermissionSettings;
+    /** Command-level permissions */
+    commands?: CommandPermissionSettings;
+    /** Network permissions */
+    network?: NetworkPermissionSettings;
+    /** Audit logging settings */
+    audit?: AuditSettings;
+    /** Remember permission decisions */
+    rememberDecisions?: boolean;
+    /** Default permission scope for remembered decisions */
+    defaultScope?: PermissionScope;
+}
+/**
+ * Hook event types (12 official events)
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PermissionRequest' | 'Setup';
+/**
+ * Hook type
+ */
+export type HookType = 'command' | 'url';
+/**
+ * Command hook configuration
+ */
+export interface CommandHookConfig {
+    /** Hook type */
+    type: 'command';
+    /** Command to execute (supports env var substitution like $TOOL_NAME) */
+    command: string;
+    /** Command arguments */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Blocking mode - wait for completion (default: true) */
+    blocking?: boolean;
+    /** Matcher for filtering events (tool name or regex) */
+    matcher?: string;
+    /** Working directory for command execution */
+    cwd?: string;
+}
+/**
+ * URL hook configuration
+ */
+export interface UrlHookConfig {
+    /** Hook type */
+    type: 'url';
+    /** Callback URL */
+    url: string;
+    /** HTTP method (default: POST) */
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Timeout in milliseconds (default: 10000) */
+    timeout?: number;
+    /** Blocking mode - wait for response (default: false) */
+    blocking?: boolean;
+    /** Matcher for filtering events */
+    matcher?: string;
+    /** Retry configuration */
+    retry?: {
+        attempts?: number;
+        backoff?: number;
+    };
+}
+/**
+ * Hook configuration (union type)
+ */
+export type HookConfig = CommandHookConfig | UrlHookConfig;
+/**
+ * Hook settings - map of events to hook configs
+ */
+export interface HookSettings {
+    /** Map of hook events to their configurations */
+    [event: string]: HookConfig | HookConfig[] | boolean | number | undefined;
+    /** Enable/disable all hooks */
+    enabled?: boolean;
+    /** Global timeout for all hooks */
+    globalTimeout?: number;
+    /** Maximum concurrent hook executions */
+    maxConcurrent?: number;
+}
+/**
+ * MCP server transport type
+ */
+export type MCPTransportType = 'stdio' | 'sse' | 'http';
+/**
+ * MCP server configuration
+ */
+export interface MCPServerConfig {
+    /** Transport type */
+    type: MCPTransportType;
+    /** Command to execute (for stdio transport) */
+    command?: string;
+    /** Command arguments */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Server URL (for http/sse transport) */
+    url?: string;
+    /** HTTP headers (for http/sse transport) */
+    headers?: Record<string, string>;
+    /** Timeout for server initialization (ms) */
+    timeout?: number;
+    /** Enable/disable this server */
+    enabled?: boolean;
+    /** Auto-restart on failure */
+    autoRestart?: boolean;
+    /** Maximum restart attempts */
+    maxRestarts?: number;
+}
+/**
+ * MCP settings
+ */
+export interface MCPSettings {
+    /** Map of server name to configuration */
+    servers?: Record<string, MCPServerConfig>;
+    /** Enable/disable MCP system */
+    enabled?: boolean;
+    /** Auto-discover MCP servers */
+    autoDiscover?: boolean;
+    /** Search paths for auto-discovery */
+    discoveryPaths?: string[];
+    /** Global timeout for MCP operations (ms) */
+    globalTimeout?: number;
+    /** Maximum concurrent MCP requests */
+    maxConcurrentRequests?: number;
+}
+/**
+ * Plugin metadata
+ */
+export interface PluginMetadata {
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version: string;
+    /** Plugin description */
+    description?: string;
+    /** Plugin author */
+    author?: string;
+    /** Plugin homepage */
+    homepage?: string;
+    /** Plugin license */
+    license?: string;
+    /** Main entry point */
+    main?: string;
+    /** Engine requirements */
+    engines?: {
+        node?: string;
+        'claude-code'?: string;
+    };
+    /** Plugin dependencies */
+    dependencies?: Record<string, string>;
+}
+/**
+ * Plugin configuration
+ */
+export interface PluginConfig {
+    /** Enable/disable this plugin */
+    enabled?: boolean;
+    /** Plugin-specific settings */
+    settings?: Record<string, unknown>;
+    /** Plugin priority (lower = higher priority) */
+    priority?: number;
+    /** Auto-load on startup */
+    autoLoad?: boolean;
+}
+/**
+ * Plugin settings
+ */
+export interface PluginSettings {
+    /** Map of plugin name to configuration */
+    plugins?: Record<string, PluginConfig>;
+    /** Enable/disable plugin system */
+    enabled?: boolean;
+    /** Plugin search paths */
+    searchPaths?: string[];
+    /** Auto-load plugins from search paths */
+    autoLoad?: boolean;
+    /** Sandbox plugins (restrict capabilities) */
+    sandboxed?: boolean;
+    /** Maximum memory per plugin (bytes) */
+    maxMemoryPerPlugin?: number;
+    /** Plugin timeout (ms) */
+    timeout?: number;
+}
+/**
+ * Theme type
+ */
+export type ThemeType = 'dark' | 'light' | 'auto';
+/**
+ * Color scheme
+ */
+export interface ColorScheme {
+    /** Primary color */
+    primary?: string;
+    /** Secondary color */
+    secondary?: string;
+    /** Success color */
+    success?: string;
+    /** Warning color */
+    warning?: string;
+    /** Error color */
+    error?: string;
+    /** Info color */
+    info?: string;
+    /** Background color */
+    background?: string;
+    /** Foreground/text color */
+    foreground?: string;
+    /** Border color */
+    border?: string;
+}
+/**
+ * UI component visibility settings
+ */
+export interface UIComponentSettings {
+    /** Show header */
+    showHeader?: boolean;
+    /** Show status bar */
+    showStatusBar?: boolean;
+    /** Show todo list */
+    showTodoList?: boolean;
+    /** Show spinner */
+    showSpinner?: boolean;
+    /** Show diff view for file edits */
+    showDiffView?: boolean;
+    /** Show progress bar */
+    showProgressBar?: boolean;
+}
+/**
+ * UI formatting settings
+ */
+export interface UIFormattingSettings {
+    /** Enable syntax highlighting */
+    syntaxHighlighting?: boolean;
+    /** Enable markdown rendering */
+    markdownRendering?: boolean;
+    /** Code block theme */
+    codeBlockTheme?: string;
+    /** Line wrapping */
+    lineWrapping?: boolean;
+    /** Maximum line length before wrapping */
+    maxLineLength?: number;
+    /** Show line numbers in code blocks */
+    showLineNumbers?: boolean;
+}
+/**
+ * UI settings
+ */
+export interface UISettings {
+    /** Theme preference */
+    theme?: ThemeType;
+    /** Custom color scheme */
+    colors?: ColorScheme;
+    /** Component visibility */
+    components?: UIComponentSettings;
+    /** Formatting preferences */
+    formatting?: UIFormattingSettings;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Compact mode (minimal UI) */
+    compact?: boolean;
+    /** Animation settings */
+    animations?: {
+        enabled?: boolean;
+        speed?: 'slow' | 'normal' | 'fast';
+    };
+    /** Terminal width override */
+    terminalWidth?: number;
+    /** Enable unicode symbols */
+    useUnicode?: boolean;
+    /**
+     * v2.1.23: Custom spinner verbs configuration
+     * Allows customizing the verbs shown during loading
+     */
+    spinnerVerbs?: {
+        /** Mode: 'append' adds to default list, 'replace' uses only custom verbs */
+        mode: 'append' | 'replace';
+        /** Custom verbs list */
+        verbs: string[];
+    };
+}
+/**
+ * Telemetry level
+ */
+export type TelemetryLevel = 'off' | 'error' | 'minimal' | 'full';
+/**
+ * Telemetry settings
+ */
+export interface TelemetrySettings {
+    /** Enable telemetry */
+    enabled?: boolean;
+    /** Telemetry level */
+    level?: TelemetryLevel;
+    /** Anonymize user data */
+    anonymize?: boolean;
+    /** Include performance metrics */
+    includePerformance?: boolean;
+    /** Include error reports */
+    includeErrors?: boolean;
+    /** Include usage statistics */
+    includeUsage?: boolean;
+    /** Custom telemetry endpoint */
+    endpoint?: string;
+    /** Telemetry batch size */
+    batchSize?: number;
+    /** Telemetry flush interval (ms) */
+    flushInterval?: number;
+}
+/**
+ * Context compression strategy
+ */
+export type CompressionStrategy = 'summarize' | 'truncate' | 'selective' | 'hybrid';
+/**
+ * Context settings
+ */
+export interface ContextSettings {
+    /** Maximum context size (tokens) */
+    maxTokens?: number;
+    /** Context compression threshold (percentage) */
+    compressionThreshold?: number;
+    /** Compression strategy */
+    compressionStrategy?: CompressionStrategy;
+    /** Preserve important messages during compression */
+    preserveImportant?: boolean;
+    /** Include system information in context */
+    includeSystemInfo?: boolean;
+    /** Include file tree in context */
+    includeFileTree?: boolean;
+    /** Maximum file tree depth */
+    fileTreeDepth?: number;
+    /** Auto-summarization */
+    autoSummarize?: boolean;
+    /** Summarization model */
+    summarizationModel?: ModelName;
+}
+/**
+ * Sandbox type
+ */
+export type SandboxType = 'none' | 'bubblewrap' | 'docker' | 'vm';
+/**
+ * Sandbox settings
+ */
+export interface SandboxSettings {
+    /** Sandbox type */
+    type?: SandboxType;
+    /** Enable sandboxing */
+    enabled?: boolean;
+    /** Allowed directories (bind mounts) */
+    allowedPaths?: string[];
+    /** Network access in sandbox */
+    allowNetwork?: boolean;
+    /** Sandbox timeout (ms) */
+    timeout?: number;
+    /** Resource limits */
+    limits?: {
+        /** Maximum CPU usage (cores) */
+        cpu?: number;
+        /** Maximum memory (bytes) */
+        memory?: number;
+        /** Maximum disk usage (bytes) */
+        disk?: number;
+        /** Maximum processes */
+        processes?: number;
+    };
+    /** Docker-specific settings */
+    docker?: {
+        /** Docker image */
+        image?: string;
+        /** Container name prefix */
+        containerPrefix?: string;
+        /** Remove container after execution */
+        autoRemove?: boolean;
+    };
+}
+/**
+ * Session settings
+ */
+export interface SessionSettings {
+    /** Auto-save session */
+    autoSave?: boolean;
+    /** Save interval (ms) */
+    saveInterval?: number;
+    /** Session expiration time (ms) */
+    expirationTime?: number;
+    /** Maximum session count */
+    maxSessions?: number;
+    /** Session directory */
+    sessionDir?: string;
+    /** Compress old sessions */
+    compressOld?: boolean;
+    /** Include environment in session */
+    includeEnvironment?: boolean;
+    /** Encryption for sensitive data */
+    encryption?: {
+        enabled?: boolean;
+        algorithm?: string;
+    };
+}
+/**
+ * Checkpoint settings
+ */
+export interface CheckpointSettings {
+    /** Enable file checkpointing */
+    enabled?: boolean;
+    /** Checkpoint directory */
+    checkpointDir?: string;
+    /** Maximum checkpoints per file */
+    maxCheckpointsPerFile?: number;
+    /** Checkpoint retention period (ms) */
+    retentionPeriod?: number;
+    /** Auto-cleanup old checkpoints */
+    autoCleanup?: boolean;
+    /** Compression for checkpoints */
+    compression?: boolean;
+}
+/**
+ * Tool-specific settings
+ */
+export interface ToolSettings {
+    /** List of allowed tools (whitelist) */
+    allowedTools?: string[];
+    /** List of disallowed tools (blacklist) */
+    disallowedTools?: string[];
+    /** Maximum concurrent tool executions */
+    maxConcurrentTasks?: number;
+    /** Default tool timeout (ms) */
+    defaultTimeout?: number;
+    /** Tool-specific configurations */
+    toolConfig?: {
+        /** Bash tool settings */
+        bash?: {
+            /** Default shell */
+            shell?: string;
+            /** Shell arguments */
+            shellArgs?: string[];
+            /** Default timeout */
+            timeout?: number;
+            /** Enable background execution */
+            allowBackground?: boolean;
+        };
+        /** Grep tool settings */
+        grep?: {
+            /** Default context lines */
+            contextLines?: number;
+            /** Case sensitive by default */
+            caseSensitive?: boolean;
+            /** Max results */
+            maxResults?: number;
+        };
+        /** WebFetch tool settings */
+        webFetch?: {
+            /** User agent */
+            userAgent?: string;
+            /** Follow redirects */
+            followRedirects?: boolean;
+            /** Maximum redirects */
+            maxRedirects?: number;
+            /** Timeout */
+            timeout?: number;
+        };
+        /** WebSearch tool settings */
+        webSearch?: {
+            /** Default search engine */
+            engine?: string;
+            /** Results per page */
+            resultsPerPage?: number;
+            /** Safe search */
+            safeSearch?: boolean;
+        };
+    };
+}
+/**
+ * Notification settings
+ */
+export interface NotificationSettings {
+    /** Enable notifications */
+    enabled?: boolean;
+    /** Notification types to enable */
+    types?: {
+        /** Session events */
+        session?: boolean;
+        /** Tool execution */
+        tools?: boolean;
+        /** Errors */
+        errors?: boolean;
+        /** Warnings */
+        warnings?: boolean;
+        /** Completion */
+        completion?: boolean;
+    };
+    /** Desktop notifications */
+    desktop?: boolean;
+    /** Sound notifications */
+    sound?: boolean;
+    /** Webhook for notifications */
+    webhook?: {
+        url?: string;
+        method?: string;
+        headers?: Record<string, string>;
+    };
+}
+/**
+ * Update settings
+ */
+export interface UpdateSettings {
+    /** Enable auto-update checks */
+    autoCheck?: boolean;
+    /** Check interval (ms) */
+    checkInterval?: number;
+    /** Auto-install updates */
+    autoInstall?: boolean;
+    /** Update channel */
+    channel?: 'stable' | 'beta' | 'canary';
+    /** Notify about updates */
+    notify?: boolean;
+    /** Custom update server */
+    updateServer?: string;
+}
+/**
+ * Attribution settings for git commits and PRs
+ */
+export interface AttributionSettings {
+    /**
+     * Attribution text for git commits, including any trailers.
+     * Empty string hides attribution.
+     * Default includes Co-Authored-By trailer with model name.
+     */
+    commit?: string;
+    /**
+     * Attribution text for pull request descriptions.
+     * Empty string hides attribution.
+     * Default includes link to Axon.
+     */
+    pr?: string;
+}
+/**
+ * Plan mode settings
+ * @since 2.1.9
+ */
+export interface PlanSettings {
+    /**
+     * Custom directory for plan files, relative to project root.
+     * If not set, defaults to ~/.axon/plans/
+     * @since 2.1.9
+     */
+    plansDirectory?: string;
+}
+/**
+ * Advanced/experimental settings
+ */
+export interface AdvancedSettings {
+    /** Default working directory */
+    defaultWorkingDir?: string;
+    /** Debug logs directory */
+    debugLogsDir?: string;
+    /** Enable experimental features */
+    experimentalFeatures?: boolean;
+    /** Feature flags */
+    features?: Record<string, boolean>;
+    /** Custom API endpoint */
+    customEndpoint?: string;
+    /** Proxy configuration */
+    proxy?: {
+        http?: string;
+        https?: string;
+        no?: string[];
+    };
+    /** Certificate settings */
+    certificates?: {
+        ca?: string[];
+        cert?: string;
+        key?: string;
+        rejectUnauthorized?: boolean;
+    };
+    /** Rate limiting */
+    rateLimit?: {
+        enabled?: boolean;
+        requestsPerMinute?: number;
+        tokensPerMinute?: number;
+    };
+}
+/**
+ * Complete Axon configuration
+ *
+ * This is the main configuration object that combines all settings.
+ * It can be loaded from settings.json files and environment variables.
+ */
+export interface ClaudeConfig {
+    /** Configuration version */
+    version?: string;
+    /** API key */
+    apiKey?: string;
+    /** OAuth token */
+    oauthToken?: string;
+    /** Model selection */
+    model?: ModelName;
+    /** Max tokens to generate */
+    maxTokens?: number;
+    /** Temperature (0-1) */
+    temperature?: number;
+    /** Top-p sampling */
+    topP?: number;
+    /** Top-k sampling */
+    topK?: number;
+    /** Use AWS Bedrock */
+    useBedrock?: boolean;
+    /** Use Google Vertex AI */
+    useVertex?: boolean;
+    /** Enable telemetry */
+    enableTelemetry?: boolean;
+    /** Disable file checkpointing */
+    disableFileCheckpointing?: boolean;
+    /** Enable auto-save */
+    enableAutoSave?: boolean;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Request timeout (ms) */
+    requestTimeout?: number;
+    /** Maximum concurrent tasks */
+    maxConcurrentTasks?: number;
+    /** UI theme */
+    theme?: ThemeType;
+    /** Verbose output */
+    verbose?: boolean;
+    /** Allowed tools */
+    allowedTools?: string[];
+    /** Disallowed tools */
+    disallowedTools?: string[];
+    /** Custom system prompt */
+    systemPrompt?: string;
+    /** Default working directory */
+    defaultWorkingDir?: string;
+    /** Debug logs directory */
+    debugLogsDir?: string;
+    /** API configuration */
+    api?: APIConfig;
+    /** Model configuration */
+    modelConfig?: ModelConfig;
+    /** Permission settings */
+    permissions?: PermissionSettings;
+    /** Hook settings */
+    hooks?: HookSettings;
+    /** MCP server settings */
+    mcpServers?: Record<string, MCPServerConfig>;
+    /** MCP global settings */
+    mcp?: MCPSettings;
+    /** Plugin settings */
+    plugins?: PluginSettings;
+    /** UI settings */
+    ui?: UISettings;
+    /** Telemetry settings */
+    telemetry?: TelemetrySettings;
+    /** Context management settings */
+    context?: ContextSettings;
+    /** Sandbox settings */
+    sandbox?: SandboxSettings;
+    /** Session settings */
+    session?: SessionSettings;
+    /** Checkpoint settings */
+    checkpoint?: CheckpointSettings;
+    /** Tool settings */
+    tools?: ToolSettings;
+    /** Notification settings */
+    notifications?: NotificationSettings;
+    /** Update settings */
+    updates?: UpdateSettings;
+    /** Advanced settings */
+    advanced?: AdvancedSettings;
+    /**
+     * Attribution settings for git commits and pull requests
+     * @since 2.1.4
+     */
+    attribution?: AttributionSettings;
+    /**
+     * Deprecated: Use attribution instead.
+     * Whether to include Claude's co-authored by attribution in commits and PRs.
+     * Defaults to true.
+     * @deprecated Use attribution.commit and attribution.pr instead
+     */
+    includeCoAuthoredBy?: boolean;
+    /**
+     * Main agent selection
+     * Can be set via --agent CLI flag or in settings.json
+     * When a non-built-in agent is selected, its system prompt and model override defaults
+     * @since 2.1.32
+     */
+    agent?: string;
+    /**
+     * Plan mode settings
+     * @since 2.1.9
+     */
+    plan?: PlanSettings;
+    /**
+     * Custom directory for plan files, relative to project root.
+     * If not set, defaults to ~/.axon/plans/
+     * Shorthand for plan.plansDirectory
+     * @since 2.1.9
+     */
+    plansDirectory?: string;
+}
+/**
+ * User configuration (alias for ClaudeConfig)
+ *
+ * This is the configuration format stored in ~/.axon/settings.json
+ */
+export type UserConfig = ClaudeConfig;
+/**
+ * Settings (alias for ClaudeConfig)
+ *
+ * Alternative name for the configuration object
+ */
+export type Settings = ClaudeConfig;
+/**
+ * Legacy Config interface (for backward compatibility)
+ */
+export interface Config {
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+/**
+ * Legacy McpServerConfig (exported from index.ts)
+ */
+export interface McpServerConfig {
+    type: 'stdio' | 'sse' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    url?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Session state
+ */
+export interface SessionState {
+    sessionId: string;
+    cwd: string;
+    originalCwd?: string;
+    startTime: number;
+    totalCostUSD: number;
+    totalAPIDuration: number;
+    totalAPIDurationWithoutRetries?: number;
+    totalToolDuration?: number;
+    totalLinesAdded?: number;
+    totalLinesRemoved?: number;
+    modelUsage: Record<string, ModelUsageStats>;
+    alwaysAllowedTools?: string[];
+    lastCompactedUuid?: string;
+    todos: Array<{
+        content: string;
+        status: 'pending' | 'in_progress' | 'completed';
+        activeForm: string;
+    }>;
+}
+/**
+ * T151/T152: 详细的模型使用统计
+ */
+export interface ModelUsageStats {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    thinkingTokens?: number;
+    webSearchRequests?: number;
+    requests?: number;
+    costUSD: number;
+    contextWindow: number;
+}
+/**
+ * Output format
+ */
+export type OutputFormat = 'text' | 'json' | 'stream-json';
+/**
+ * Input format
+ */
+export type InputFormat = 'text' | 'stream-json';
+/**
+ * Environment variable configuration
+ *
+ * Maps environment variables to configuration options
+ */
+export interface EnvironmentConfig {
+    /** ANTHROPIC_API_KEY or AXON_API_KEY */
+    ANTHROPIC_API_KEY?: string;
+    AXON_API_KEY?: string;
+    /** AXON_OAUTH_TOKEN */
+    AXON_OAUTH_TOKEN?: string;
+    /** AXON_USE_BEDROCK */
+    AXON_USE_BEDROCK?: string;
+    /** AXON_USE_VERTEX */
+    AXON_USE_VERTEX?: string;
+    /** AXON_MAX_OUTPUT_TOKENS */
+    AXON_MAX_OUTPUT_TOKENS?: string;
+    /** AXON_MAX_RETRIES */
+    AXON_MAX_RETRIES?: string;
+    /** AXON_DEBUG_LOGS_DIR */
+    AXON_DEBUG_LOGS_DIR?: string;
+    /** AXON_ENABLE_TELEMETRY */
+    AXON_ENABLE_TELEMETRY?: string;
+    /** AXON_DISABLE_FILE_CHECKPOINTING */
+    AXON_DISABLE_FILE_CHECKPOINTING?: string;
+    /** AXON_CONFIG_DIR */
+    AXON_CONFIG_DIR?: string;
+    /** HTTP_PROXY */
+    HTTP_PROXY?: string;
+    /** HTTPS_PROXY */
+    HTTPS_PROXY?: string;
+    /** NO_PROXY */
+    NO_PROXY?: string;
+}
+/**
+ * Runtime configuration (CLI arguments + environment + config files)
+ *
+ * This represents the final merged configuration at runtime
+ */
+export interface RuntimeConfig extends ClaudeConfig {
+    /** Current working directory */
+    cwd: string;
+    /** Session ID (if resuming) */
+    sessionId?: string;
+    /** Initial prompt */
+    initialPrompt?: string;
+    /** Print mode (non-interactive) */
+    printMode?: boolean;
+    /** Resume last session */
+    resume?: boolean;
+    /** Accept all edits without prompting */
+    acceptEdits?: boolean;
+    /** Bypass all permissions */
+    bypassPermissions?: boolean;
+    /** Plan mode (no execution) */
+    planMode?: boolean;
+    /** Input format */
+    inputFormat?: 'text' | 'stream-json';
+    /** Output format */
+    outputFormat?: 'text' | 'json' | 'stream-json';
+    /** Compute start time */
+    startTime?: number;
+}
+/**
+ * Configuration validation result
+ */
+export interface ConfigValidationResult {
+    /** Validation successful */
+    valid: boolean;
+    /** Validation errors */
+    errors?: Array<{
+        path: string;
+        message: string;
+        value?: unknown;
+    }>;
+    /** Validation warnings */
+    warnings?: Array<{
+        path: string;
+        message: string;
+        value?: unknown;
+    }>;
+}
+/**
+ * Configuration migration
+ */
+export interface ConfigMigration {
+    /** Source version */
+    fromVersion: string;
+    /** Target version */
+    toVersion: string;
+    /** Migration function */
+    migrate: (config: Partial<ClaudeConfig>) => Partial<ClaudeConfig>;
+    /** Migration description */
+    description?: string;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Partial<ClaudeConfig>;
+/**
+ * Environment variable names (完整的 130+ 个变量)
+ *
+ * 来源：从官方 @anthropic-ai/claude-code v2.1.4 提取
+ * 提取日期：2026-01-07
+ */
+export declare const ENV_VAR_NAMES: {
+    /** API 认证 */
+    readonly API_KEY: readonly ["ANTHROPIC_API_KEY", "AXON_API_KEY"];
+    readonly AUTH_TOKEN: "ANTHROPIC_AUTH_TOKEN";
+    /** API 配置 */
+    readonly BASE_URL: "ANTHROPIC_BASE_URL";
+    readonly MODEL: "ANTHROPIC_MODEL";
+    readonly BETAS: "ANTHROPIC_BETAS";
+    readonly CUSTOM_HEADERS: "ANTHROPIC_CUSTOM_HEADERS";
+    /** 默认模型 */
+    readonly DEFAULT_HAIKU_MODEL: "ANTHROPIC_DEFAULT_HAIKU_MODEL";
+    readonly DEFAULT_OPUS_MODEL: "ANTHROPIC_DEFAULT_OPUS_MODEL";
+    readonly DEFAULT_SONNET_MODEL: "ANTHROPIC_DEFAULT_SONNET_MODEL";
+    readonly SMALL_FAST_MODEL: "ANTHROPIC_SMALL_FAST_MODEL";
+    readonly SMALL_FAST_MODEL_AWS_REGION: "ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION";
+    /** Bedrock 配置 */
+    readonly BEDROCK_BASE_URL: "ANTHROPIC_BEDROCK_BASE_URL";
+    /** Foundry 配置 */
+    readonly FOUNDRY_API_KEY: "ANTHROPIC_FOUNDRY_API_KEY";
+    readonly FOUNDRY_BASE_URL: "ANTHROPIC_FOUNDRY_BASE_URL";
+    readonly FOUNDRY_RESOURCE: "ANTHROPIC_FOUNDRY_RESOURCE";
+    /** Vertex AI 配置 */
+    readonly VERTEX_PROJECT_ID: "ANTHROPIC_VERTEX_PROJECT_ID";
+    /** OAuth 认证 */
+    readonly OAUTH_TOKEN: "AXON_OAUTH_TOKEN";
+    readonly OAUTH_TOKEN_FILE_DESCRIPTOR: "AXON_OAUTH_TOKEN_FILE_DESCRIPTOR";
+    /** API Key 辅助 */
+    readonly API_KEY_FILE_DESCRIPTOR: "AXON_API_KEY_FILE_DESCRIPTOR";
+    readonly API_KEY_HELPER_TTL_MS: "AXON_API_KEY_HELPER_TTL_MS";
+    /** 后端选择 */
+    readonly USE_BEDROCK: "AXON_USE_BEDROCK";
+    readonly USE_VERTEX: "AXON_USE_VERTEX";
+    readonly USE_FOUNDRY: "AXON_USE_FOUNDRY";
+    /** 后端认证跳过 */
+    readonly SKIP_BEDROCK_AUTH: "AXON_SKIP_BEDROCK_AUTH";
+    readonly SKIP_FOUNDRY_AUTH: "AXON_SKIP_FOUNDRY_AUTH";
+    readonly SKIP_VERTEX_AUTH: "AXON_SKIP_VERTEX_AUTH";
+    /** 性能配置 */
+    readonly MAX_OUTPUT_TOKENS: "AXON_MAX_OUTPUT_TOKENS";
+    readonly MAX_RETRIES: "AXON_MAX_RETRIES";
+    readonly MAX_TOOL_USE_CONCURRENCY: "AXON_MAX_TOOL_USE_CONCURRENCY";
+    /** Git 集成 */
+    readonly GIT_BASH_PATH: "AXON_GIT_BASH_PATH";
+    /** 会话管理 */
+    readonly SESSION_ID: "AXON_SESSION_ID";
+    readonly PARENT_SESSION_ID: "AXON_PARENT_SESSION_ID";
+    readonly SESSION_ACCESS_TOKEN: "AXON_SESSION_ACCESS_TOKEN";
+    readonly SKIP_PROMPT_HISTORY: "AXON_SKIP_PROMPT_HISTORY";
+    /** Agent 系统 */
+    readonly AGENT_ID: "AXON_AGENT_ID";
+    readonly AGENT_NAME: "AXON_AGENT_NAME";
+    readonly AGENT_TYPE: "AXON_AGENT_TYPE";
+    readonly SUBAGENT_MODEL: "AXON_SUBAGENT_MODEL";
+    readonly PLAN_V2_AGENT_COUNT: "AXON_PLAN_V2_AGENT_COUNT";
+    readonly PLAN_V2_EXPLORE_AGENT_COUNT: "AXON_PLAN_V2_EXPLORE_AGENT_COUNT";
+    /** 远程会话 */
+    readonly REMOTE: "AXON_REMOTE";
+    readonly REMOTE_ENVIRONMENT_TYPE: "AXON_REMOTE_ENVIRONMENT_TYPE";
+    readonly REMOTE_SESSION_ID: "AXON_REMOTE_SESSION_ID";
+    /** IDE 集成 */
+    readonly AUTO_CONNECT_IDE: "AXON_AUTO_CONNECT_IDE";
+    readonly IDE_HOST_OVERRIDE: "AXON_IDE_HOST_OVERRIDE";
+    readonly IDE_SKIP_AUTO_INSTALL: "AXON_IDE_SKIP_AUTO_INSTALL";
+    readonly IDE_SKIP_VALID_CHECK: "AXON_IDE_SKIP_VALID_CHECK";
+    /** 调试和日志 */
+    readonly DEBUG_LOGS_DIR: "AXON_DEBUG_LOGS_DIR";
+    readonly DIAGNOSTICS_FILE: "AXON_DIAGNOSTICS_FILE";
+    readonly PROFILE_QUERY: "AXON_PROFILE_QUERY";
+    readonly PROFILE_STARTUP: "AXON_PROFILE_STARTUP";
+    /** 遥测配置 */
+    readonly ENABLE_TELEMETRY: "AXON_ENABLE_TELEMETRY";
+    readonly OTEL_SHUTDOWN_TIMEOUT_MS: "AXON_OTEL_SHUTDOWN_TIMEOUT_MS";
+    readonly OTEL_FLUSH_TIMEOUT_MS: "AXON_OTEL_FLUSH_TIMEOUT_MS";
+    readonly OTEL_HEADERS_HELPER_DEBOUNCE_MS: "AXON_OTEL_HEADERS_HELPER_DEBOUNCE_MS";
+    /** 功能禁用 */
+    readonly DISABLE_FILE_CHECKPOINTING: "AXON_DISABLE_FILE_CHECKPOINTING";
+    readonly DISABLE_NONESSENTIAL_TRAFFIC: "AXON_DISABLE_NONESSENTIAL_TRAFFIC";
+    readonly DISABLE_ATTACHMENTS: "AXON_DISABLE_ATTACHMENTS";
+    readonly DISABLE_AXON_MDS: "AXON_DISABLE_AXON_MDS";
+    readonly DISABLE_FEEDBACK_SURVEY: "AXON_DISABLE_FEEDBACK_SURVEY";
+    readonly DISABLE_TERMINAL_TITLE: "AXON_DISABLE_TERMINAL_TITLE";
+    readonly DISABLE_EXPERIMENTAL_BETAS: "AXON_DISABLE_EXPERIMENTAL_BETAS";
+    readonly DISABLE_COMMAND_INJECTION_CHECK: "AXON_DISABLE_COMMAND_INJECTION_CHECK";
+    /** 功能启用 */
+    readonly ENABLE_CFC: "AXON_ENABLE_CFC";
+    readonly ENABLE_PROMPT_SUGGESTION: "AXON_ENABLE_PROMPT_SUGGESTION";
+    readonly ENABLE_SDK_FILE_CHECKPOINTING: "AXON_ENABLE_SDK_FILE_CHECKPOINTING";
+    readonly ENABLE_TOKEN_USAGE_ATTACHMENT: "AXON_ENABLE_TOKEN_USAGE_ATTACHMENT";
+    /** UI/UX 配置 */
+    readonly FORCE_FULL_LOGO: "AXON_FORCE_FULL_LOGO";
+    readonly SYNTAX_HIGHLIGHT: "AXON_SYNTAX_HIGHLIGHT";
+    /** 沙箱配置 */
+    readonly BASH_SANDBOX_SHOW_INDICATOR: "AXON_BASH_SANDBOX_SHOW_INDICATOR";
+    readonly BUBBLEWRAP: "AXON_BUBBLEWRAP";
+    readonly CONTAINER_ID: "AXON_CONTAINER_ID";
+    readonly SHELL: "AXON_SHELL";
+    readonly SHELL_PREFIX: "AXON_SHELL_PREFIX";
+    /** 网络配置 */
+    readonly PROXY_RESOLVES_HOSTS: "AXON_PROXY_RESOLVES_HOSTS";
+    readonly SSE_PORT: "AXON_SSE_PORT";
+    readonly WEBSOCKET_AUTH_FILE_DESCRIPTOR: "AXON_WEBSOCKET_AUTH_FILE_DESCRIPTOR";
+    /** 安全配置 */
+    readonly CLIENT_CERT: "AXON_CLIENT_CERT";
+    readonly CLIENT_KEY: "AXON_CLIENT_KEY";
+    readonly CLIENT_KEY_PASSPHRASE: "AXON_CLIENT_KEY_PASSPHRASE";
+    readonly ADDITIONAL_PROTECTION: "AXON_ADDITIONAL_PROTECTION";
+    /** 环境隔离 */
+    readonly DONT_INHERIT_ENV: "AXON_DONT_INHERIT_ENV";
+    /** 其他配置 */
+    readonly ACTION: "AXON_ACTION";
+    readonly EFFORT_LEVEL: "AXON_EFFORT_LEVEL";
+    readonly ENTRYPOINT: "AXON_ENTRYPOINT";
+    readonly EXIT_AFTER_STOP_DELAY: "AXON_EXIT_AFTER_STOP_DELAY";
+    readonly EXTRA_BODY: "AXON_EXTRA_BODY";
+    readonly TAGS: "AXON_TAGS";
+    readonly TEAM_NAME: "AXON_TEAM_NAME";
+    /** v2.1.32: Agent Teams 实验性功能开关 */
+    readonly EXPERIMENTAL_AGENT_TEAMS: "AXON_EXPERIMENTAL_AGENT_TEAMS";
+    /** v2.1.32: Plan 模式要求 */
+    readonly PLAN_MODE_REQUIRED: "AXON_PLAN_MODE_REQUIRED";
+    readonly TEST_FIXTURES_ROOT: "AXON_TEST_FIXTURES_ROOT";
+    readonly USE_NATIVE_FILE_SEARCH: "AXON_USE_NATIVE_FILE_SEARCH";
+    /** 通用配置目录 */
+    readonly CONFIG_DIR: "AXON_CONFIG_DIR";
+    /** Extended Thinking */
+    readonly DISABLE_INTERLEAVED_THINKING: "DISABLE_INTERLEAVED_THINKING";
+    /** Prompt Caching */
+    readonly DISABLE_PROMPT_CACHING: "DISABLE_PROMPT_CACHING";
+    readonly DISABLE_PROMPT_CACHING_HAIKU: "DISABLE_PROMPT_CACHING_HAIKU";
+    readonly DISABLE_PROMPT_CACHING_OPUS: "DISABLE_PROMPT_CACHING_OPUS";
+    readonly DISABLE_PROMPT_CACHING_SONNET: "DISABLE_PROMPT_CACHING_SONNET";
+    /** 命令禁用 */
+    readonly DISABLE_BUG_COMMAND: "DISABLE_BUG_COMMAND";
+    readonly DISABLE_DOCTOR_COMMAND: "DISABLE_DOCTOR_COMMAND";
+    readonly DISABLE_EXTRA_USAGE_COMMAND: "DISABLE_EXTRA_USAGE_COMMAND";
+    readonly DISABLE_FEEDBACK_COMMAND: "DISABLE_FEEDBACK_COMMAND";
+    readonly DISABLE_INSTALL_GITHUB_APP_COMMAND: "DISABLE_INSTALL_GITHUB_APP_COMMAND";
+    readonly DISABLE_LOGIN_COMMAND: "DISABLE_LOGIN_COMMAND";
+    readonly DISABLE_LOGOUT_COMMAND: "DISABLE_LOGOUT_COMMAND";
+    readonly DISABLE_UPGRADE_COMMAND: "DISABLE_UPGRADE_COMMAND";
+    /** 自动化和优化 */
+    readonly DISABLE_AUTOUPDATER: "DISABLE_AUTOUPDATER";
+    readonly DISABLE_AUTO_MIGRATE_TO_NATIVE: "DISABLE_AUTO_MIGRATE_TO_NATIVE";
+    readonly DISABLE_COMPACT: "DISABLE_COMPACT";
+    readonly DISABLE_MICROCOMPACT: "DISABLE_MICROCOMPACT";
+    readonly DISABLE_COST_WARNINGS: "DISABLE_COST_WARNINGS";
+    readonly DISABLE_ERROR_REPORTING: "DISABLE_ERROR_REPORTING";
+    readonly DISABLE_INSTALLATION_CHECKS: "DISABLE_INSTALLATION_CHECKS";
+    readonly DISABLE_TELEMETRY: "DISABLE_TELEMETRY";
+    /** Bash 匹配 */
+    readonly ENABLE_BASH_ENV_VAR_MATCHING: "ENABLE_BASH_ENV_VAR_MATCHING";
+    readonly ENABLE_BASH_WRAPPER_MATCHING: "ENABLE_BASH_WRAPPER_MATCHING";
+    /** Beta 功能 */
+    readonly ENABLE_BETA_TRACING_DETAILED: "ENABLE_BETA_TRACING_DETAILED";
+    readonly ENABLE_CODE_GUIDE_SUBAGENT: "ENABLE_CODE_GUIDE_SUBAGENT";
+    readonly ENABLE_ENHANCED_TELEMETRY_BETA: "ENABLE_ENHANCED_TELEMETRY_BETA";
+    /** MCP CLI */
+    readonly ENABLE_EXPERIMENTAL_MCP_CLI: "ENABLE_EXPERIMENTAL_MCP_CLI";
+    readonly ENABLE_MCP_CLI: "ENABLE_MCP_CLI";
+    readonly ENABLE_MCP_CLI_ENDPOINT: "ENABLE_MCP_CLI_ENDPOINT";
+    readonly ENABLE_MCP_LARGE_OUTPUT_FILES: "ENABLE_MCP_LARGE_OUTPUT_FILES";
+    /** UI */
+    readonly ENABLE_INCREMENTAL_TUI: "ENABLE_INCREMENTAL_TUI";
+    /** 工具搜索 */
+    readonly ENABLE_TOOL_SEARCH: "ENABLE_TOOL_SEARCH";
+    /** Extended Thinking 预算 */
+    readonly MAX_THINKING_TOKENS: "MAX_THINKING_TOKENS";
+    /** Structured Output 重试 */
+    readonly MAX_STRUCTURED_OUTPUT_RETRIES: "MAX_STRUCTURED_OUTPUT_RETRIES";
+    /** MCP 输出 Token */
+    readonly MAX_MCP_OUTPUT_TOKENS: "MAX_MCP_OUTPUT_TOKENS";
+    /** MCP 超时 */
+    readonly MCP_TIMEOUT: "MCP_TIMEOUT";
+    readonly MCP_TOOL_TIMEOUT: "MCP_TOOL_TIMEOUT";
+    /** MCP OAuth */
+    readonly MCP_OAUTH_CALLBACK_PORT: "MCP_OAUTH_CALLBACK_PORT";
+    /** MCP 连接 */
+    readonly MCP_SERVER_CONNECTION_BATCH_SIZE: "MCP_SERVER_CONNECTION_BATCH_SIZE";
+};
+/**
+ * Configuration file paths
+ */
+export declare const CONFIG_PATHS: {
+    /** Global config directory */
+    readonly GLOBAL_DIR: "~/.axon";
+    /** Global config file */
+    readonly GLOBAL_FILE: "~/.axon/settings.json";
+    /** Project config directory */
+    readonly PROJECT_DIR: ".axon";
+    /** Project config file */
+    readonly PROJECT_FILE: ".axon/settings.json";
+    /** Session directory */
+    readonly SESSION_DIR: "~/.axon/sessions";
+    /** Plugin directory */
+    readonly PLUGIN_DIR: "~/.axon/plugins";
+    /** Hook directory */
+    readonly HOOK_DIR: "~/.axon/hooks";
+    /** Skills directory */
+    readonly SKILLS_DIR: "~/.axon/skills";
+};
+/**
+ * Session 配置接口
+ *
+ * 用于配置 Session 类的行为和初始状态
+ */
+export interface SessionConfig {
+    /** 会话 ID (如果指定，使用此 ID 而不是生成新 ID) */
+    id?: string;
+    /** 父会话 ID (用于 fork) */
+    parentId?: string;
+    /** 会话访问令牌 */
+    accessToken?: string;
+    /** 跳过提示历史 */
+    skipPromptHistory?: boolean;
+    /** 停止后延迟退出 (ms) */
+    exitAfterStopDelay?: number;
+    /** SSE 端口 */
+    ssePort?: number;
+    /** 配置目录 (默认: ~/.axon) */
+    configDir?: string;
+    /** 工作目录 */
+    cwd?: string;
+}
+/**
+ * SessionManager 配置接口
+ *
+ * 用于配置 SessionManager 的持久化和清理行为
+ */
+export interface SessionManagerConfig {
+    /** 自动保存开关 */
+    autoSave?: boolean;
+    /** 自动保存间隔 (ms) */
+    autoSaveIntervalMs?: number;
+    /** 会话目录 */
+    sessionDir?: string;
+    /** 最大会话数 */
+    maxSessions?: number;
+    /** 会话过期天数 */
+    sessionExpiryDays?: number;
+}
+//# sourceMappingURL=config.d.ts.map