indusagi-coding-agent 0.1.37 → 0.1.39

package/dist/cli/args.js

@@ -1,32 +1,6 @@
-/**
- * CLI Argument Parser - Command-line argument handling and validation
- *
- * Responsibilities:
- * - Parse command-line arguments into structured format
- * - Validate argument combinations
- * - Provide helpful error messages for invalid args
- * - Generate help documentation
- * - Support extension flags registration
- *
- * Based on argument parsing patterns from indusagi CLI
- * Original: https://github.com/varunisrani/indusagi-ts/vendor/indusagi-agent
- *
- * Adapted to:
- * - Improve error messages
- * - Add comprehensive documentation
- * - Enhance validation
- * - Improve UX with better prompts
- */
 import chalk from "chalk";
 import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR } from "../config.js";
-// ============================================================================
-// CONSTANTS
-// ============================================================================
-/** Valid thinking levels for the --thinking flag */
 const VALID_THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
-/** Default tools enabled when no --tools or --no-tools is specified */
-const DEFAULT_TOOLS = ["read", "bash", "edit", "write", "task", "todoread", "todowrite"];
-/** All available tool names for validation */
 const AVAILABLE_TOOLS = [
     "read",
     "bash",
@@ -39,472 +13,303 @@ const AVAILABLE_TOOLS = [
     "todoread",
     "todowrite",
 ];
-// ============================================================================
-// TYPE GUARDS
-// ============================================================================
-/**
- * Type guard to check if a string is a valid ThinkingLevel
- *
- * @param level - The string to check
- * @returns True if the string is a valid ThinkingLevel
- */
+const FLAG_ALIASES = {
+    "-h": "help",
+    "-v": "version",
+    "-c": "continue",
+    "-r": "resume",
+    "-p": "print",
+};
 export function isValidThinkingLevel(level) {
     return VALID_THINKING_LEVELS.includes(level);
 }
-/**
- * Type guard to check if a string is a valid Mode
- *
- * @param mode - The string to check
- * @returns True if the string is a valid Mode
- */
 export function isValidMode(mode) {
     return mode === "text" || mode === "json" || mode === "rpc";
 }
-/**
- * Type guard to check if a tool name is valid
- *
- * @param toolName - The tool name to check
- * @returns True if the tool name is in the available tools list
- */
 export function isValidToolName(toolName) {
     return AVAILABLE_TOOLS.includes(toolName);
 }
-// ============================================================================
-// VALIDATION FUNCTIONS
-// ============================================================================
-/**
- * Validate tool names and filter out invalid ones
- *
- * @param toolNames - Array of tool names to validate
- * @returns Array of valid tool names
- */
-function validateToolNames(toolNames) {
-    const validTools = [];
-    for (const name of toolNames) {
+function createArgsResult() {
+    return {
+        messages: [],
+        fileArgs: [],
+        unknownFlags: new Map(),
+    };
+}
+function peekNextValue(state) {
+    return state.args[state.index + 1];
+}
+function consumeFlagValue(state, flag) {
+    const next = peekNextValue(state);
+    if (next === undefined) {
+        console.error(chalk.yellow(`Warning: ${flag} requires a value.`));
+        return undefined;
+    }
+    state.index += 1;
+    return next;
+}
+function pushListValue(target, value) {
+    return [...(target ?? []), value];
+}
+function parseCommaSeparatedList(value) {
+    return value
+        .split(",")
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+function parseToolList(value) {
+    const valid = [];
+    for (const name of parseCommaSeparatedList(value)) {
         if (isValidToolName(name)) {
-            validTools.push(name);
-        }
-        else {
-            console.error(chalk.yellow(`Warning: Unknown tool "${name}". Valid tools: ${AVAILABLE_TOOLS.join(", ")}`));
+            valid.push(name);
+            continue;
         }
+        console.error(chalk.yellow(`Warning: Unknown tool "${name}". Valid tools: ${AVAILABLE_TOOLS.join(", ")}`));
+    }
+    return valid;
+}
+function parseModeFlag(value) {
+    if (!value) {
+        return undefined;
     }
-    return validTools;
+    if (isValidMode(value)) {
+        return value;
+    }
+    console.error(chalk.yellow(`Warning: Invalid mode "${value}". Valid values: text, json, rpc`));
+    return undefined;
 }
-/**
- * Validate thinking level and provide warning if invalid
- *
- * @param level - The thinking level to validate
- * @returns The validated thinking level or undefined if invalid
- */
-function validateThinkingLevel(level) {
-    if (isValidThinkingLevel(level)) {
-        return level;
+function parseThinkingFlag(value) {
+    if (!value) {
+        return undefined;
     }
-    console.error(chalk.yellow(`Warning: Invalid thinking level "${level}". Valid values: ${VALID_THINKING_LEVELS.join(", ")}`));
+    if (isValidThinkingLevel(value)) {
+        return value;
+    }
+    console.error(chalk.yellow(`Warning: Invalid thinking level "${value}". Valid values: ${VALID_THINKING_LEVELS.join(", ")}`));
     return undefined;
 }
-// ============================================================================
-// ARGUMENT PARSING
-// ============================================================================
-/**
- * Parse command-line arguments into structured Args object
- *
- * This function processes raw command-line arguments and converts them into
- * a structured Args object. It handles:
- * - Short and long flag formats (--flag, -f)
- * - Flag values that follow (--flag value)
- * - Boolean flags (--no-flag)
- * - File arguments prefixed with @
- * - Extension-registered flags (if extensionFlags provided)
- * - Positional arguments (messages)
- *
- * @param args - Array of command-line argument strings (typically process.argv.slice(2))
- * @param extensionFlags - Optional map of extension-registered flags with their types
- * @returns Parsed Args object
- *
- * @example
- * ```typescript
- * const args = parseArgs(["--model", "gpt-4", "--verbose", "hello", "@file.txt"]);
- * // Returns: { model: "gpt-4", verbose: true, messages: ["hello"], fileArgs: ["file.txt"] }
- * ```
- */
+function parseListModelsValue(state) {
+    const next = peekNextValue(state);
+    if (next && !next.startsWith("-") && !next.startsWith("@")) {
+        state.index += 1;
+        return next;
+    }
+    return true;
+}
+function parseUnknownExtensionFlag(state, arg) {
+    if (!arg.startsWith("--") || !state.extensionFlags) {
+        return false;
+    }
+    const flagName = arg.slice(2);
+    const definition = state.extensionFlags.get(flagName);
+    if (!definition) {
+        return false;
+    }
+    if (definition.type === "boolean") {
+        state.result.unknownFlags.set(flagName, true);
+        return true;
+    }
+    const value = consumeFlagValue(state, `--${flagName}`);
+    if (value !== undefined) {
+        state.result.unknownFlags.set(flagName, value);
+    }
+    return true;
+}
+function handleAlias(state, arg) {
+    const alias = FLAG_ALIASES[arg];
+    if (!alias) {
+        return false;
+    }
+    state.result[alias] = true;
+    return true;
+}
+function handleScalarFlags(state, arg) {
+    switch (arg) {
+        case "--help":
+            state.result.help = true;
+            return true;
+        case "--version":
+            state.result.version = true;
+            return true;
+        case "--continue":
+            state.result.continue = true;
+            return true;
+        case "--resume":
+            state.result.resume = true;
+            return true;
+        case "--no-session":
+            state.result.noSession = true;
+            return true;
+        case "--no-tools":
+            state.result.noTools = true;
+            return true;
+        case "--print":
+            state.result.print = true;
+            return true;
+        case "--verbose":
+            state.result.verbose = true;
+            return true;
+        case "--no-extensions":
+            state.result.noExtensions = true;
+            return true;
+        case "--no-hooks":
+            state.result.noHooks = true;
+            return true;
+        case "--no-skills":
+            state.result.noSkills = true;
+            return true;
+        case "--no-prompt-templates":
+            state.result.noPromptTemplates = true;
+            return true;
+        case "--no-themes":
+            state.result.noThemes = true;
+            return true;
+        case "--mcp":
+            state.result.mcp = true;
+            return true;
+        case "--no-mcp":
+            state.result.noMcp = true;
+            return true;
+        case "--memory":
+            state.result.memory = true;
+            return true;
+        case "--no-memory":
+            state.result.noMemory = true;
+            return true;
+        case "--list-models":
+            state.result.listModels = parseListModelsValue(state);
+            return true;
+        default:
+            return false;
+    }
+}
+function handleValueFlags(state, arg) {
+    switch (arg) {
+        case "--mode":
+            state.result.mode = parseModeFlag(consumeFlagValue(state, arg));
+            return true;
+        case "--session":
+            state.result.session = consumeFlagValue(state, arg);
+            return true;
+        case "--session-dir":
+            state.result.sessionDir = consumeFlagValue(state, arg);
+            return true;
+        case "--provider":
+            state.result.provider = consumeFlagValue(state, arg);
+            return true;
+        case "--account":
+            state.result.account = consumeFlagValue(state, arg);
+            return true;
+        case "--api-key":
+            state.result.apiKey = consumeFlagValue(state, arg);
+            return true;
+        case "--model":
+            state.result.model = consumeFlagValue(state, arg);
+            return true;
+        case "--models": {
+            const value = consumeFlagValue(state, arg);
+            state.result.models = value ? parseCommaSeparatedList(value) : undefined;
+            return true;
+        }
+        case "--system-prompt":
+            state.result.systemPrompt = consumeFlagValue(state, arg);
+            return true;
+        case "--append-system-prompt":
+            state.result.appendSystemPrompt = consumeFlagValue(state, arg);
+            return true;
+        case "--tools": {
+            const value = consumeFlagValue(state, arg);
+            state.result.tools = value ? parseToolList(value) : undefined;
+            return true;
+        }
+        case "--thinking":
+            state.result.thinking = parseThinkingFlag(consumeFlagValue(state, arg));
+            return true;
+        case "--export":
+            state.result.export = consumeFlagValue(state, arg);
+            return true;
+        case "--mcp-config":
+            state.result.mcpConfig = consumeFlagValue(state, arg);
+            return true;
+        case "--memory-config":
+            state.result.memoryConfig = consumeFlagValue(state, arg);
+            return true;
+        default:
+            return false;
+    }
+}
+function handleRepeatedPathFlags(state, arg) {
+    const value = arg === "--extension" || arg === "-e" || arg === "--hook" || arg === "--skill" || arg === "--prompt-template" || arg === "--theme"
+        ? consumeFlagValue(state, arg)
+        : undefined;
+    if (!value) {
+        return false;
+    }
+    switch (arg) {
+        case "--extension":
+        case "-e":
+            state.result.extensions = pushListValue(state.result.extensions, value);
+            return true;
+        case "--hook":
+            state.result.hooks = pushListValue(state.result.hooks, value);
+            return true;
+        case "--skill":
+            state.result.skills = pushListValue(state.result.skills, value);
+            return true;
+        case "--prompt-template":
+            state.result.promptTemplates = pushListValue(state.result.promptTemplates, value);
+            return true;
+        case "--theme":
+            state.result.themes = pushListValue(state.result.themes, value);
+            return true;
+        default:
+            return false;
+    }
+}
+function handlePositionalArgument(result, arg) {
+    if (arg.startsWith("@")) {
+        result.fileArgs.push(arg.slice(1));
+        return;
+    }
+    if (!arg.startsWith("-")) {
+        result.messages.push(arg);
+    }
+}
 export function parseArgs(args, extensionFlags) {
-    const result = {
-        messages: [],
-        fileArgs: [],
-        unknownFlags: new Map(),
+    const state = {
+        index: 0,
+        args,
+        result: createArgsResult(),
+        extensionFlags,
     };
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        // ============================================================================
-        // HELP AND VERSION FLAGS
-        // ============================================================================
-        if (arg === "--help" || arg === "-h") {
-            result.help = true;
-        }
-        else if (arg === "--version" || arg === "-v") {
-            result.version = true;
-        }
-        // ============================================================================
-        // MODE FLAGS
-        // ============================================================================
-        else if (arg === "--mode" && i + 1 < args.length) {
-            const mode = args[++i];
-            if (isValidMode(mode)) {
-                result.mode = mode;
-            }
-        }
-        // ============================================================================
-        // SESSION FLAGS
-        // ============================================================================
-        else if (arg === "--continue" || arg === "-c") {
-            result.continue = true;
-        }
-        else if (arg === "--resume" || arg === "-r") {
-            result.resume = true;
-        }
-        else if (arg === "--no-session") {
-            result.noSession = true;
-        }
-        else if (arg === "--session" && i + 1 < args.length) {
-            result.session = args[++i];
-        }
-        else if (arg === "--session-dir" && i + 1 < args.length) {
-            result.sessionDir = args[++i];
-        }
-        // ============================================================================
-        // PROVIDER AND AUTH FLAGS
-        // ============================================================================
-        else if (arg === "--provider" && i + 1 < args.length) {
-            result.provider = args[++i];
-        }
-        else if (arg === "--account" && i + 1 < args.length) {
-            result.account = args[++i];
-        }
-        else if (arg === "--api-key" && i + 1 < args.length) {
-            result.apiKey = args[++i];
-        }
-        // ============================================================================
-        // MODEL FLAGS
-        // ============================================================================
-        else if (arg === "--model" && i + 1 < args.length) {
-            result.model = args[++i];
-        }
-        else if (arg === "--models" && i + 1 < args.length) {
-            result.models = args[++i].split(",").map((s) => s.trim());
-        }
-        else if (arg === "--list-models") {
-            // Check if next arg is a search pattern (not a flag or file arg)
-            if (i + 1 < args.length && !args[i + 1].startsWith("-") && !args[i + 1].startsWith("@")) {
-                result.listModels = args[++i];
-            }
-            else {
-                result.listModels = true;
-            }
-        }
-        // ============================================================================
-        // SYSTEM PROMPT FLAGS
-        // ============================================================================
-        else if (arg === "--system-prompt" && i + 1 < args.length) {
-            result.systemPrompt = args[++i];
-        }
-        else if (arg === "--append-system-prompt" && i + 1 < args.length) {
-            result.appendSystemPrompt = args[++i];
-        }
-        // ============================================================================
-        // TOOL FLAGS
-        // ============================================================================
-        else if (arg === "--no-tools") {
-            result.noTools = true;
-        }
-        else if (arg === "--tools" && i + 1 < args.length) {
-            const toolNames = args[++i].split(",").map((s) => s.trim());
-            result.tools = validateToolNames(toolNames);
-        }
-        // ============================================================================
-        // THINKING FLAG
-        // ============================================================================
-        else if (arg === "--thinking" && i + 1 < args.length) {
-            const level = args[++i];
-            result.thinking = validateThinkingLevel(level);
-        }
-        // ============================================================================
-        // OUTPUT FLAGS
-        // ============================================================================
-        else if (arg === "--print" || arg === "-p") {
-            result.print = true;
-        }
-        else if (arg === "--export" && i + 1 < args.length) {
-            result.export = args[++i];
-        }
-        else if (arg === "--verbose") {
-            result.verbose = true;
-        }
-        // ============================================================================
-        // EXTENSION FLAGS
-        // ============================================================================
-        else if ((arg === "--extension" || arg === "-e") && i + 1 < args.length) {
-            result.extensions = result.extensions ?? [];
-            result.extensions.push(args[++i]);
-        }
-        else if (arg === "--no-extensions") {
-            result.noExtensions = true;
-        }
-        else if (arg === "--hook" && i + 1 < args.length) {
-            result.hooks = result.hooks ?? [];
-            result.hooks.push(args[++i]);
-        }
-        else if (arg === "--no-hooks") {
-            result.noHooks = true;
-        }
-        // ============================================================================
-        // SKILL FLAGS
-        // ============================================================================
-        else if (arg === "--skill" && i + 1 < args.length) {
-            result.skills = result.skills ?? [];
-            result.skills.push(args[++i]);
-        }
-        else if (arg === "--no-skills") {
-            result.noSkills = true;
-        }
-        // ============================================================================
-        // PROMPT TEMPLATE FLAGS
-        // ============================================================================
-        else if (arg === "--prompt-template" && i + 1 < args.length) {
-            result.promptTemplates = result.promptTemplates ?? [];
-            result.promptTemplates.push(args[++i]);
-        }
-        else if (arg === "--no-prompt-templates") {
-            result.noPromptTemplates = true;
-        }
-        // ============================================================================
-        // THEME FLAGS
-        // ============================================================================
-        else if (arg === "--theme" && i + 1 < args.length) {
-            result.themes = result.themes ?? [];
-            result.themes.push(args[++i]);
-        }
-        else if (arg === "--no-themes") {
-            result.noThemes = true;
-        }
-        // ============================================================================
-        // MCP FLAGS (Model Context Protocol)
-        // ============================================================================
-        else if (arg === "--mcp") {
-            result.mcp = true;
-        }
-        else if (arg === "--no-mcp") {
-            result.noMcp = true;
-        }
-        else if (arg === "--mcp-config" && i + 1 < args.length) {
-            result.mcpConfig = args[++i];
-        }
-        // ============================================================================
-        // MEMORY FLAGS
-        // ============================================================================
-        else if (arg === "--memory") {
-            result.memory = true;
-        }
-        else if (arg === "--no-memory") {
-            result.noMemory = true;
-        }
-        else if (arg === "--memory-config" && i + 1 < args.length) {
-            result.memoryConfig = args[++i];
-        }
-        // ============================================================================
-        // FILE ARGUMENTS
-        // ============================================================================
-        else if (arg.startsWith("@")) {
-            result.fileArgs.push(arg.slice(1)); // Remove @ prefix
-        }
-        // ============================================================================
-        // EXTENSION FLAGS (VENDOR CODE)
-        // ============================================================================
-        else if (arg.startsWith("--") && extensionFlags) {
-            // Check if it's an extension-registered flag
-            const flagName = arg.slice(2);
-            const extFlag = extensionFlags.get(flagName);
-            if (extFlag) {
-                if (extFlag.type === "boolean") {
-                    result.unknownFlags.set(flagName, true);
-                }
-                else if (extFlag.type === "string" && i + 1 < args.length) {
-                    result.unknownFlags.set(flagName, args[++i]);
-                }
-            }
-            // Unknown flags without extensionFlags are silently ignored (first pass)
-        }
-        // ============================================================================
-        // POSITIONAL ARGUMENTS (MESSAGES)
-        // ============================================================================
-        else if (!arg.startsWith("-")) {
-            result.messages.push(arg);
-        }
+    for (; state.index < state.args.length; state.index++) {
+        const arg = state.args[state.index];
+        if (handleAlias(state, arg))
+            continue;
+        if (handleScalarFlags(state, arg))
+            continue;
+        if (handleValueFlags(state, arg))
+            continue;
+        if (handleRepeatedPathFlags(state, arg))
+            continue;
+        if (parseUnknownExtensionFlag(state, arg))
+            continue;
+        handlePositionalArgument(state.result, arg);
     }
-    return result;
+    return state.result;
+}
+function buildHelpSections() {
+    return [
+        `${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools`,
+        `${chalk.bold("Usage:")}\n  ${APP_NAME} [options] [@files...] [messages...]`,
+        `${chalk.bold("Commands:")}\n  ${APP_NAME} login [--provider <name>] Authenticate with an AI provider (OAuth or API key)\n                     [--method oauth|api-key]\n  ${APP_NAME} install <source> [-l]    Install extension source and add to settings\n  ${APP_NAME} remove <source> [-l]     Remove extension source from settings\n  ${APP_NAME} update [source]          Update installed extensions (skips pinned sources)\n  ${APP_NAME} list                     List installed extensions from settings\n  ${APP_NAME} config                   Open TUI to enable/disable package resources`,
+        `${chalk.bold("Options:")}\n  --provider <name>              Provider name (default: google)\n  --account <name>               Account name for multi-account providers (default: default)\n  --model <id>                   Model ID (default: gemini-2.5-flash)\n  --api-key <key>                API key (defaults to env vars)\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\n  --append-system-prompt <text>  Append text or file contents to system prompt\n  --mode <mode>                  Output mode: text (default), json, or rpc\n  --print, -p                    Non-interactive mode: process prompt and exit\n  --continue, -c                 Continue previous session\n  --resume, -r                   Select a session to resume\n  --session <path>               Use specific session file\n  --session-dir <dir>            Directory for session storage and lookup\n  --no-session                   Don't save session (ephemeral)\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n  --no-tools                     Disable all built-in tools\n  --tools <tools>                Comma-separated list of tools to enable\n                                 Available: ${AVAILABLE_TOOLS.join(", ")}\n  --thinking <level>             Set thinking level: ${VALID_THINKING_LEVELS.join(", ")}\n  --extension, -e <path>         Load an extension file (can be used multiple times)\n  --no-extensions                Disable extension discovery (explicit -e paths still work)\n  --hook <path>                  Load a hook file or directory (can be used multiple times)\n  --no-hooks                     Disable hook discovery (explicit --hook paths still work)\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\n  --no-skills                    Disable skills discovery and loading\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\n  --no-prompt-templates          Disable prompt template discovery and loading\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\n  --no-themes                    Disable theme discovery and loading\n  --mcp                          Enable MCP tool integration (default: auto-detect)\n  --no-mcp                       Disable MCP tools\n  --mcp-config <file>            Path to MCP servers config (default: ~/.indusagi/agent/mcp-servers.json)\n  --memory                       Enable memory system (default: auto-detect)\n  --no-memory                    Disable memory system\n  --memory-config <file>         Path to memory config (default: ~/.indusagi/agent/memory.json)\n  --export <file>                Export session file to HTML and exit\n  --list-models [search]         List available models (with optional fuzzy search)\n  --verbose                      Force verbose startup (overrides quietStartup setting)\n  --help, -h                     Show this help\n  --version, -v                  Show version number\n\nExtensions can register additional flags (e.g., --plan from plan-mode extension).`,
+        `${chalk.bold("Examples:")}\n  # Interactive mode\n  ${APP_NAME}\n\n  # Interactive mode with initial prompt\n  ${APP_NAME} "List all .ts files in src/"\n\n  # Include files in initial message\n  ${APP_NAME} @prompt.md @image.png "What color is the sky?"\n\n  # Non-interactive mode (process and exit)\n  ${APP_NAME} -p "List all .ts files in src/"\n\n  # Multiple messages (interactive)\n  ${APP_NAME} "Read package.json" "What dependencies do we have?"\n\n  # Continue previous session\n  ${APP_NAME} --continue "What did we discuss?"\n\n  # Use different model\n  ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"\n\n  # Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n  # Limit to a specific provider with glob pattern\n  ${APP_NAME} --models "github-copilot/*"\n\n  # Cycle models with fixed thinking levels\n  ${APP_NAME} --models sonnet:high,haiku:low\n\n  # Start with a specific thinking level\n  ${APP_NAME} --thinking high "Solve this complex problem"\n\n  # Read-only mode (no file modifications possible)\n  ${APP_NAME} --tools read,grep,find,ls -p "Review the code in src/"\n\n  # Export a session file to HTML\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n  ${APP_NAME} --export session.jsonl output.html\n\n  # Authentication / Login\n  ${APP_NAME} login\n  ${APP_NAME} login --provider kimi\n  ${APP_NAME} login --provider anthropic\n  ${APP_NAME} login --provider minimax --account prod\n  ${APP_NAME} login --list\n  ${APP_NAME} logout --provider minimax --account dev`,
+        `${chalk.bold("Environment Variables:")}\n  ANTHROPIC_AINDUSAGI_KEY                - Anthropic Claude API key\n  ANTHROPIC_OAUTH_TOKEN                  - Anthropic OAuth token (alternative to API key)\n  OPENAI_AINDUSAGI_KEY                   - OpenAI GPT API key\n  AZURE_OPENAI_AINDUSAGI_KEY             - Azure OpenAI API key\n  AZURE_OPENAI_BASE_URL                  - Azure OpenAI base URL\n  AZURE_OPENAI_RESOURCE_NAME             - Azure OpenAI resource name\n  AZURE_OPENAI_AINDUSAGI_VERSION         - Azure OpenAI API version\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP       - Azure OpenAI model=deployment map\n  GEMINI_AINDUSAGI_KEY                   - Google Gemini API key\n  GROQ_AINDUSAGI_KEY                     - Groq API key\n  CEREBRAS_AINDUSAGI_KEY                 - Cerebras API key\n  XAI_AINDUSAGI_KEY                      - xAI Grok API key\n  OPENROUTER_AINDUSAGI_KEY               - OpenRouter API key\n  AI_GATEWAY_AINDUSAGI_KEY               - Vercel AI Gateway API key\n  ZAI_AINDUSAGI_KEY                      - ZAI API key\n  MISTRAL_AINDUSAGI_KEY                  - Mistral API key\n  MINIMAX_AINDUSAGI_KEY                  - MiniMax API key\n  KIMI_AINDUSAGI_KEY                     - Kimi (Moonshot AI) API key\n  KIMICODE_AINDUSAGI_KEY                 - Kimi Code (subscription) API key\n  AWS_PROFILE                            - AWS profile for Amazon Bedrock\n  AWS_ACCESS_KEY_ID                      - AWS access key for Amazon Bedrock\n  AWS_SECRET_ACCESS_KEY                  - AWS secret key for Amazon Bedrock\n  AWS_BEARER_TOKEN_BEDROCK               - Bedrock API key (bearer token)\n  AWS_REGION                             - AWS region for Amazon Bedrock\n  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)\n  INDUSAGI_SHARE_VIEWER_URL              - Base URL for /share command (default: https://buildwithindusagi.ai/session/)`,
+        `${chalk.bold("Available Tools:")}\n  read      - Read file contents\n  bash      - Execute bash commands\n  edit      - Edit files with find/replace\n  write     - Write files (creates/overwrites)\n  task      - Delegate work to a subagent\n  grep      - Search file contents (read-only, off by default)\n  find      - Find files by glob pattern (read-only, off by default)\n  ls        - List directory contents (read-only, off by default)\n  todoread  - Read the current todo list\n  todowrite - Update the current todo list`,
+    ];
 }
-// ============================================================================
-// HELP DOCUMENTATION
-// ============================================================================
-/**
- * Print comprehensive help documentation to stdout
- *
- * Displays:
- * - Application name and brief description
- * - Usage syntax
- * - Available commands
- * - All options with descriptions
- * - Environment variables
- * - Available tools
- * - Example usage
- */
 export function printHelp() {
-    console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
-
-${chalk.bold("Usage:")}
-  ${APP_NAME} [options] [@files...] [messages...]
-
-${chalk.bold("Commands:")}
-  ${APP_NAME} login [--provider <name>] Authenticate with an AI provider (OAuth or API key)
-                     [--method oauth|api-key]
-  ${APP_NAME} install <source> [-l]    Install extension source and add to settings
-  ${APP_NAME} remove <source> [-l]     Remove extension source from settings
-  ${APP_NAME} update [source]          Update installed extensions (skips pinned sources)
-  ${APP_NAME} list                     List installed extensions from settings
-  ${APP_NAME} config                   Open TUI to enable/disable package resources
-
-${chalk.bold("Options:")}
-  --provider <name>              Provider name (default: google)
-  --account <name>               Account name for multi-account providers (default: default)
-  --model <id>                   Model ID (default: gemini-2.5-flash)
-  --api-key <key>                API key (defaults to env vars)
-  --system-prompt <text>         System prompt (default: coding assistant prompt)
-  --append-system-prompt <text>  Append text or file contents to system prompt
-  --mode <mode>                  Output mode: text (default), json, or rpc
-  --print, -p                    Non-interactive mode: process prompt and exit
-  --continue, -c                 Continue previous session
-  --resume, -r                   Select a session to resume
-  --session <path>               Use specific session file
-  --session-dir <dir>            Directory for session storage and lookup
-  --no-session                   Don't save session (ephemeral)
-  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
-                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
-  --no-tools                     Disable all built-in tools
-  --tools <tools>                Comma-separated list of tools to enable (default: read,bash,edit,write,task,todoread,todowrite)
-                                 Available: read, bash, edit, write, task, grep, find, ls, todoread, todowrite
-  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh
-  --extension, -e <path>         Load an extension file (can be used multiple times)
-  --no-extensions                Disable extension discovery (explicit -e paths still work)
-  --hook <path>                  Load a hook file or directory (can be used multiple times)
-  --no-hooks                     Disable hook discovery (explicit --hook paths still work)
-  --skill <path>                 Load a skill file or directory (can be used multiple times)
-  --no-skills                    Disable skills discovery and loading
-  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
-  --no-prompt-templates          Disable prompt template discovery and loading
-  --theme <path>                 Load a theme file or directory (can be used multiple times)
-  --no-themes                    Disable theme discovery and loading
-  --mcp                          Enable MCP tool integration (default: auto-detect)
-  --no-mcp                       Disable MCP tools
-  --mcp-config <file>            Path to MCP servers config (default: ~/.indusagi/agent/mcp-servers.json)
-  --memory                       Enable memory system (default: auto-detect)
-  --no-memory                    Disable memory system
-  --memory-config <file>         Path to memory config (default: ~/.indusagi/agent/memory.json)
-  --export <file>                Export session file to HTML and exit
-  --list-models [search]         List available models (with optional fuzzy search)
-  --verbose                      Force verbose startup (overrides quietStartup setting)
-  --help, -h                     Show this help
-  --version, -v                  Show version number
-
-Extensions can register additional flags (e.g., --plan from plan-mode extension).
-
-${chalk.bold("Examples:")}
-  # Interactive mode
-  ${APP_NAME}
-
-  # Interactive mode with initial prompt
-  ${APP_NAME} "List all .ts files in src/"
-
-  # Include files in initial message
-  ${APP_NAME} @prompt.md @image.png "What color is the sky?"
-
-  # Non-interactive mode (process and exit)
-  ${APP_NAME} -p "List all .ts files in src/"
-
-  # Multiple messages (interactive)
-  ${APP_NAME} "Read package.json" "What dependencies do we have?"
-
-  # Continue previous session
-  ${APP_NAME} --continue "What did we discuss?"
-
-  # Use different model
-  ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"
-
-  # Limit model cycling to specific models
-  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o
-
-  # Limit to a specific provider with glob pattern
-  ${APP_NAME} --models "github-copilot/*"
-
-  # Cycle models with fixed thinking levels
-  ${APP_NAME} --models sonnet:high,haiku:low
-
-  # Start with a specific thinking level
-  ${APP_NAME} --thinking high "Solve this complex problem"
-
-  # Read-only mode (no file modifications possible)
-  ${APP_NAME} --tools read,grep,find,ls -p "Review the code in src/"
-
-  # Export a session file to HTML
-  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl
-  ${APP_NAME} --export session.jsonl output.html
-
-  # Authentication / Login
-  ${APP_NAME} login                              # Show available providers for login
-  ${APP_NAME} login --provider kimi              # Login to Kimi with API key
-  ${APP_NAME} login --provider kimi-coding       # Login to Kimi Code with API key
-  ${APP_NAME} login --provider anthropic         # Login to Anthropic with OAuth
-  ${APP_NAME} login --provider openai            # Login to OpenAI with API key
-  ${APP_NAME} login --provider minimax --account prod   # Login to MiniMax (prod account)
-  ${APP_NAME} login --provider minimax --account dev    # Login to MiniMax (dev account)
-  ${APP_NAME} login --list                       # List all saved accounts
-  ${APP_NAME} logout --provider minimax --account dev   # Logout specific account
-
-${chalk.bold("Environment Variables:")}
-  ANTHROPIC_AINDUSAGI_KEY                - Anthropic Claude API key
-  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
-  OPENAI_AINDUSAGI_KEY                   - OpenAI GPT API key
-  AZURE_OPENAI_AINDUSAGI_KEY             - Azure OpenAI API key
-  AZURE_OPENAI_BASE_URL            - Azure OpenAI base URL (https://{resource}.openai.azure.com/openai/v1)
-  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
-  AZURE_OPENAI_AINDUSAGI_VERSION         - Azure OpenAI API version (default: v1)
-  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
-  GEMINI_AINDUSAGI_KEY                   - Google Gemini API key
-  GROQ_AINDUSAGI_KEY                     - Groq API key
-  CEREBRAS_AINDUSAGI_KEY                 - Cerebras API key
-  XAI_AINDUSAGI_KEY                      - xAI Grok API key
-  OPENROUTER_AINDUSAGI_KEY               - OpenRouter API key
-  AI_GATEWAY_AINDUSAGI_KEY               - Vercel AI Gateway API key
-  ZAI_AINDUSAGI_KEY                      - ZAI API key
-  MISTRAL_AINDUSAGI_KEY                  - Mistral API key
-  MINIMAX_AINDUSAGI_KEY                  - MiniMax API key
-  KIMI_AINDUSAGI_KEY                     - Kimi (Moonshot AI) API key
-  KIMICODE_AINDUSAGI_KEY                 - Kimi Code (subscription) API key
-  AWS_PROFILE                      - AWS profile for Amazon Bedrock
-  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
-  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
-  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
-  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
-  ${ENV_AGENT_DIR.padEnd(32)} - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
-  INDUSAGI_SHARE_VIEWER_URL        - Base URL for /share command (default: https://buildwithindusagi.ai/session/)
-
-${chalk.bold("Available Tools (default: read, bash, edit, write):")}
-  read   - Read file contents
-  bash   - Execute bash commands
-  edit   - Edit files with find/replace
-  write  - Write files (creates/overwrites)
-  grep   - Search file contents (read-only, off by default)
-  find   - Find files by glob pattern (read-only, off by default)
-  ls     - List directory contents (read-only, off by default)
-`);
+    console.log(buildHelpSections().join("\n\n"));
 }
 //# sourceMappingURL=args.js.map