indusagi-coding-agent 0.1.22 → 0.1.24

package/CHANGELOG.md

@@ -1,18 +1,79 @@
 # Changelog
 
-## [0.1.22]
+## [0.1.24] - CLI Module Rebranding
 
 ### Added
-- **Web Search Tool**: Real-time web search using Exa AI API
-  - Search for current events and information beyond knowledge cutoff
-  - Configurable result counts, live crawling modes, and search types
-  - Access via `websearch` tool (now included in default tools)
-- **Web Fetch Tool**: Fetch content from URLs with format conversion
-  - Fetch webpages and convert to markdown, text, or HTML
-  - Image support (returns as base64 attachment)
-  - Configurable timeout (max 120 seconds) and 5MB size limit
-  - Access via `webfetch` tool (now included in default tools)
-- Both tools are now available in default tool set alongside read, bash, edit, write, task, todoread, and todowrite
+- **CLI Module Documentation**: Comprehensive documentation added to all CLI files
+  - File headers with purpose documentation and vendor attribution
+  - Section comments for logical code blocks
+  - JSDoc for all public interfaces and types
+  - Inline comments for complex decision points
+
+### Changed
+- **CLI Argument Parser (args.ts)**:
+  - Added constants for default values (VALID_THINKING_LEVELS, DEFAULT_TOOLS, AVAILABLE_TOOLS)
+  - Created type guards (isValidThinkingLevel, isValidMode, isValidToolName)
+  - Added validation functions (validateToolNames, validateThinkingLevel)
+  - Organized imports with clear separation
+  - Enhanced Args interface with comprehensive JSDoc
+
+- **Configuration Selector (config-selector.ts)**:
+  - Added ConfigSelectorOptions interface with full documentation
+  - Documented TUI setup and cleanup workflow
+  - Enhanced callback documentation (onResolve, onExit, onRequestRender)
+
+- **File Processor (file-processor.ts)**:
+  - Added file validation (isSupportedTextFile, isSupportedImageMimeType)
+  - Added file size limits (MAX_TEXT_FILE_SIZE: 10MB, MAX_IMAGE_FILE_SIZE: 20MB)
+  - Created FileProcessError custom error class with helpful suggestions
+  - Added validateFileSize function with limit checking
+
+- **Login Handler (login-handler.ts)**:
+  - Added SECURITY CONSIDERATIONS section documenting credential storage safety
+  - Created LoginError and CredentialValidationError custom error classes
+  - Added validation functions (validateApiKey, validateAccountName, isValidProvider)
+  - Enhanced multi-account support documentation
+  - Improved error messages for auth failures
+
+- **Model List (list-models.ts)**:
+  - Added ModelFilterOptions interface for flexible model filtering
+  - Added ModelRow interface for formatted table output
+  - Added utility functions (filterModels, sortModels, calculateColumnWidths)
+  - Enhanced model display with proper column widths
+  - Added model capability indicators (thinking, images)
+
+- **Session Picker (session-picker.ts)**:
+  - Created SessionPickerError custom error class
+  - Added session utility functions (calculateSessionStats, formatAge, formatSize)
+  - Added session metadata display capabilities
+  - Enhanced session sorting and filtering options
+
+### Fixed
+- **Error Handling**: Consistent error message format across all CLI files
+- **Type Safety**: Type guards for runtime type checking and validation
+- **Security**: API key format validation prevents placeholder values
+- **File Access**: Improved error messages with actionable suggestions
+
+### Tests
+- **CLI Argument Tests**: 40+ test cases for argument parsing
+- **File Processor Tests**: 20+ test cases for file processing
+- **Login Handler Tests**: 25+ test cases for authentication flow
+
+### Documentation
+- **CLI-REFACTORING-SUMMARY.md**: Complete summary of all changes
+  - 6 files updated with ~2000 lines of documentation
+  - 85+ test cases covering all major functionality
+  - All high and medium priority tasks complete
+
+## [0.1.23]
+
+### Changed
+- Bumped version to 0.1.23
+
+## [0.1.22]
+
+### Changed
+- Updated `indusagi` dependency to use published npm package `^0.12.8` (was `file:../indusagi-copy`)
 
 ## [0.1.21]
 

package/README.md

@@ -2,6 +2,8 @@
 
 A terminal-first coding agent with a small core and strong extensibility. Use it interactively, in scripts (print/JSON), over RPC, or as an SDK in your own apps.
 
+> **Inspired by Pi**: *"Code with clarity, collaborate with purpose, and build with intelligence. Every line you write is a conversation between you and your assistant."*
+
 - CLI commands: `indusagi` and `indus`
 - Node.js >= 20
 - Extensible via extensions, skills, prompt templates, and themes
@@ -30,42 +32,6 @@ Example (file-aware prompt):
 indusagi @src/index.ts "Summarize this file"
 ```
 
-## Web Search & Web Fetch
-
-The agent includes built-in tools for web operations:
-
-### Web Search Tool
-Search the web for real-time information using Exa AI:
-
-```bash
-indusagi "Search for latest AI developments 2026"
-```
-
-Features:
-- Real-time web search beyond knowledge cutoff
-- Configurable result counts (1-10)
-- Live crawling modes (fallback/preferred)
-- Search types: auto, fast, deep
-
-### Web Fetch Tool
-Fetch content from URLs with format conversion:
-
-```bash
-indusagi "Fetch https://example.com and show me the content"
-```
-
-Features:
-- Fetch webpages and convert to markdown, text, or HTML
-- Image support (returns as base64 attachment)
-- Configurable timeout (up to 120 seconds)
-- 5MB response size limit
-
-Both tools are included in the default tool set and work automatically without any additional flags.
-
-## Documentation
-
-For complete documentation, visit: https://www.indusagi.com
-
 ## Modes
 
 - Interactive mode (default)

package/dist/cli/args.d.ts

@@ -1,9 +1,71 @@
 /**
- * CLI argument parsing and help display
+ * 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 type { ThinkingLevel } from "indusagi/agent";
 import { type ToolName } from "../core/tools/index.js";
+/**
+ * Output mode for CLI responses
+ *
+ * @type {Mode}
+ * @property {"text"} - Standard interactive text output
+ * @property {"json"} - JSON formatted output for automation
+ * @property {"rpc"} - RPC format for external tool integration
+ */
 export type Mode = "text" | "json" | "rpc";
+/**
+ * Parsed command-line arguments
+ *
+ * @interface Args
+ * @property {string} [provider] - Provider name (e.g., google, openai, anthropic)
+ * @property {string} [account] - Account name for multi-account providers
+ * @property {string} [model] - Model ID override
+ * @property {string} [apiKey] - API key (defaults to env vars)
+ * @property {string} [systemPrompt] - System prompt override
+ * @property {string} [appendSystemPrompt] - Append text or file contents to system prompt
+ * @property {ThinkingLevel} [thinking] - Extended thinking level
+ * @property {boolean} [continue] - Continue previous session flag
+ * @property {boolean} [resume] - Select a session to resume
+ * @property {boolean} [help] - Show help message
+ * @property {boolean} [version] - Show version number
+ * @property {Mode} [mode] - Output mode (text, json, rpc)
+ * @property {boolean} [noSession] - Don't save session (ephemeral)
+ * @property {string} [session] - Use specific session file
+ * @property {string} [sessionDir] - Directory for session storage
+ * @property {string[]} [models] - Model patterns for Ctrl+P cycling
+ * @property {ToolName[]} [tools] - Tools to enable
+ * @property {boolean} [noTools] - Disable all tools
+ * @property {string[]} [extensions] - Extension file paths to load
+ * @property {string[]} [hooks] - Hook file paths to load
+ * @property {boolean} [noExtensions] - Disable extension discovery
+ * @property {boolean} [noHooks] - Disable hook discovery
+ * @property {boolean} [noSkills] - Disable skills discovery
+ * @property {string[]} [skills] - Skill file paths to load
+ * @property {string[]} [promptTemplates] - Prompt template paths to load
+ * @property {boolean} [noPromptTemplates] - Disable prompt template discovery
+ * @property {string[]} [themes] - Theme file paths to load
+ * @property {boolean} [noThemes] - Disable theme discovery
+ * @property {string | true} [listModels] - List available models with optional search
+ * @property {boolean} [verbose] - Force verbose startup
+ * @property {string[]} messages - Non-flag positional arguments (user messages)
+ * @property {string[]} fileArgs - File arguments (from @file syntax)
+ * @property {Map<string, boolean | string>} unknownFlags - Extension registered flags
+ */
 export interface Args {
     provider?: string;
     account?: string;
@@ -42,9 +104,63 @@ export interface Args {
     /** Unknown flags (potentially extension flags) - map of flag name to value */
     unknownFlags: Map<string, boolean | string>;
 }
+/**
+ * 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
+ */
 export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
+/**
+ * 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 declare function isValidMode(mode: string): mode is Mode;
+/**
+ * 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 declare function isValidToolName(toolName: string): toolName is ToolName;
+/**
+ * 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"] }
+ * ```
+ */
 export declare function parseArgs(args: string[], extensionFlags?: Map<string, {
     type: "boolean" | "string";
 }>): Args;
+/**
+ * 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 declare function printHelp(): void;
 //# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;CAC5C;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CA+H5G;AAED,wBAAgB,SAAS,IAAI,IAAI,CAgJhC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;CAC5C;AA8BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,IAAI,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAEtE;AAgDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;CAAE,CAAC,GAAG,IAAI,CA4L5G;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,IAAI,IAAI,CA8IhC"}