indusagi-coding-agent 0.1.23 → 0.1.25

package/dist/cli/list-models.js

@@ -1,9 +1,42 @@
 /**
- * List available models with optional fuzzy search
+ * Model List Formatter - Display available models with optional filtering
+ *
+ * Responsibilities:
+ * - Retrieve available models from model registry
+ * - Apply fuzzy search filtering
+ * - Sort models by provider and ID
+ * - Format model information in a readable table
+ * - Display model capabilities (context, max output, thinking, images)
+ *
+ * Based on model listing patterns from indusagi-agent
+ * Original: https://github.com/varunisrani/indusagi-ts/vendor/indusagi-agent
+ *
+ * Adapted to:
+ * - Improve display formatting
+ * - Add comprehensive documentation
+ * - Add model filtering options
+ * - Add model capability indicators
+ * - Enhance UX with better sorting
  */
 import { fuzzyFilter } from "indusagi/tui";
+// ============================================================================
+// UTILITY FUNCTIONS
+// ============================================================================
 /**
- * Format a number as human-readable (e.g., 200000 -> "200K", 1000000 -> "1M")
+ * Format a number as human-readable token count
+ *
+ * Converts large numbers to abbreviated format:
+ * - 1,000,000 -> "1M"
+ * - 200,000 -> "200K"
+ * - 500 -> "500"
+ *
+ * @param count - The number to format
+ * @returns Human-readable string
+ *
+ * @example
+ * formatTokenCount(1_000_000); // "1M"
+ * formatTokenCount(250_000); // "250K"
+ * formatTokenCount(500); // "500"
  */
 function formatTokenCount(count) {
     if (count >= 1_000_000) {
@@ -17,31 +50,164 @@ function formatTokenCount(count) {
     return count.toString();
 }
 /**
- * List available models, optionally filtered by search pattern
+ * Apply filters to models list
+ *
+ * Filters models by:
+ * - Provider name (exact match)
+ * - Thinking/reasoning capability
+ * - Image input support
+ *
+ * @param models - List of models to filter
+ * @param options - Filter options
+ * @returns Filtered list of models
+ */
+function filterModels(models, options) {
+    let filtered = models;
+    // Filter by provider
+    if (options.provider) {
+        filtered = filtered.filter((m) => m.provider === options.provider);
+    }
+    // Filter by thinking capability
+    if (options.thinkingOnly) {
+        filtered = filtered.filter((m) => !!m.reasoning);
+    }
+    // Filter by image support
+    if (options.imageSupport) {
+        filtered = filtered.filter((m) => m.input.includes("image"));
+    }
+    // Apply fuzzy search pattern
+    if (options.searchPattern) {
+        filtered = fuzzyFilter(filtered, options.searchPattern, (m) => `${m.provider} ${m.id}`);
+    }
+    return filtered;
+}
+/**
+ * Sort models by provider and then by model ID
+ *
+ * This provides a predictable, organized display order
+ *
+ * @param models - List of models to sort
+ * @returns Sorted list of models
+ */
+function sortModels(models) {
+    return models.sort((a, b) => {
+        // Primary sort: provider name (alphabetical)
+        const providerCmp = a.provider.localeCompare(b.provider);
+        if (providerCmp !== 0)
+            return providerCmp;
+        // Secondary sort: model ID (alphabetical)
+        return a.id.localeCompare(b.id);
+    });
+}
+/**
+ * Calculate column widths for formatted table output
+ *
+ * Ensures columns are wide enough for headers and all data
+ *
+ * @param rows - Array of formatted model rows
+ * @returns Object with column widths
+ */
+function calculateColumnWidths(headers, rows) {
+    return {
+        provider: Math.max(headers.provider.length, ...rows.map((r) => r.provider.length)),
+        model: Math.max(headers.model.length, ...rows.map((r) => r.model.length)),
+        context: Math.max(headers.context.length, ...rows.map((r) => r.context.length)),
+        maxOut: Math.max(headers.maxOut.length, ...rows.map((r) => r.maxOut.length)),
+        thinking: Math.max(headers.thinking.length, ...rows.map((r) => r.thinking.length)),
+        images: Math.max(headers.images.length, ...rows.map((r) => r.images.length)),
+    };
+}
+// ============================================================================
+// MAIN FUNCTIONS
+// ============================================================================
+/**
+ * List available models, optionally filtered by search pattern or criteria
+ *
+ * This function:
+ * 1. Retrieves available models from the registry
+ * 2. Applies any requested filters (provider, thinking, images, search)
+ * 3. Sorts models by provider and ID
+ * 4. Formats model information into a readable table
+ * 5. Displays the table to stdout
+ *
+ * The table shows:
+ * - Provider name
+ * - Model ID
+ * - Context window size
+ * - Max output tokens
+ * - Thinking/reasoning capability
+ * - Image input support
+ *
+ * @param modelRegistry - Model registry instance
+ * @param searchPattern - Optional fuzzy search pattern for model IDs/providers
+ * @returns Promise that resolves when listing is complete
+ *
+ * @example
+ * ```typescript
+ * // List all models
+ * await listModels(modelRegistry);
+ *
+ * // List models matching "sonnet"
+ * await listModels(modelRegistry, "sonnet");
+ * ```
  */
 export async function listModels(modelRegistry, searchPattern) {
+    // ============================================================================
+    // MODEL RETRIEVAL
+    // ============================================================================
+    /**
+     * Get all available models from registry
+     * Returns empty array if no providers are configured
+     */
     const models = modelRegistry.getAvailable();
+    /**
+     * Handle case where no models are available
+     * This typically means no API keys are configured
+     */
     if (models.length === 0) {
         console.log("No models available. Set API keys in environment variables.");
         return;
     }
-    // Apply fuzzy filter if search pattern provided
-    let filteredModels = models;
-    if (searchPattern) {
-        filteredModels = fuzzyFilter(models, searchPattern, (m) => `${m.provider} ${m.id}`);
-    }
+    // ============================================================================
+    // FILTERING
+    // ============================================================================
+    /**
+     * Parse filter options
+     * Support both string (search pattern) and object (full options) formats
+     */
+    const filterOptions = typeof searchPattern === "string" ? { searchPattern } : searchPattern || {};
+    /**
+     * Apply filters to models
+     * Includes provider, thinking, image, and fuzzy search filters
+     */
+    let filteredModels = filterModels(models, filterOptions);
+    /**
+     * Handle case where filter produces no results
+     */
     if (filteredModels.length === 0) {
-        console.log(`No models matching "${searchPattern}"`);
+        if (filterOptions.searchPattern) {
+            console.log(`No models matching "${filterOptions.searchPattern}"`);
+        }
+        else {
+            console.log("No models match the specified criteria");
+        }
         return;
     }
-    // Sort by provider, then by model id
-    filteredModels.sort((a, b) => {
-        const providerCmp = a.provider.localeCompare(b.provider);
-        if (providerCmp !== 0)
-            return providerCmp;
-        return a.id.localeCompare(b.id);
-    });
-    // Calculate column widths
+    // ============================================================================
+    // SORTING
+    // ============================================================================
+    /**
+     * Sort models by provider and ID
+     * Provides organized, predictable display order
+     */
+    filteredModels = sortModels(filteredModels);
+    // ============================================================================
+    // TABLE FORMATTING
+    // ============================================================================
+    /**
+     * Format models into table rows
+     * Converts numeric values to human-readable format
+     */
     const rows = filteredModels.map((m) => ({
         provider: m.provider,
         model: m.id,
@@ -50,6 +216,9 @@ export async function listModels(modelRegistry, searchPattern) {
         thinking: m.reasoning ? "yes" : "no",
         images: m.input.includes("image") ? "yes" : "no",
     }));
+    /**
+     * Define table headers
+     */
     const headers = {
         provider: "provider",
         model: "model",
@@ -58,15 +227,18 @@ export async function listModels(modelRegistry, searchPattern) {
         thinking: "thinking",
         images: "images",
     };
-    const widths = {
-        provider: Math.max(headers.provider.length, ...rows.map((r) => r.provider.length)),
-        model: Math.max(headers.model.length, ...rows.map((r) => r.model.length)),
-        context: Math.max(headers.context.length, ...rows.map((r) => r.context.length)),
-        maxOut: Math.max(headers.maxOut.length, ...rows.map((r) => r.maxOut.length)),
-        thinking: Math.max(headers.thinking.length, ...rows.map((r) => r.thinking.length)),
-        images: Math.max(headers.images.length, ...rows.map((r) => r.images.length)),
-    };
-    // Print header
+    /**
+     * Calculate column widths based on headers and data
+     * Ensures all content fits without truncation
+     */
+    const widths = calculateColumnWidths(headers, rows);
+    // ============================================================================
+    // OUTPUT
+    // ============================================================================
+    /**
+     * Print header row
+     * Separated by two spaces for readability
+     */
     const headerLine = [
         headers.provider.padEnd(widths.provider),
         headers.model.padEnd(widths.model),
@@ -76,7 +248,10 @@ export async function listModels(modelRegistry, searchPattern) {
         headers.images.padEnd(widths.images),
     ].join("  ");
     console.log(headerLine);
-    // Print rows
+    /**
+     * Print each model row
+     * Aligned with header for clean table appearance
+     */
     for (const row of rows) {
         const line = [
             row.provider.padEnd(widths.provider),

package/dist/cli/list-models.js.map

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

package/dist/cli/login-handler.d.ts

@@ -1,14 +1,44 @@
 /**
- * Login command handler for AI provider authentication
- * Supports OAuth and API key-based authentication
+ * Login Handler - AI provider authentication and credential management
  *
- * MULTI-ACCOUNT SUPPORT: Each provider can have multiple named accounts.
+ * Responsibilities:
+ * - Handle login and logout commands for AI providers
+ * - Support OAuth and API key-based authentication
+ * - Manage multi-account support per provider
+ * - Store and retrieve credentials securely
+ * - Validate credentials before storage
+ * - Display available providers and saved accounts
  *
- * Pattern matched with openclaw implementation:
- * - Check for environment variables (KIMI_API_KEY, MOONSHOT_API_KEY, etc.)
- * - Show info/help URL
- * - Prompt for API key input
- * - Store in auth storage with account name
+ * SECURITY CONSIDERATIONS:
+ * - Credentials are stored in ~/.indusagi/agent/auth.json with restricted file permissions
+ * - API keys are never logged or printed to console
+ * - OAuth tokens are stored with expiration times
+ * - Environment variables are checked before prompting for input
+ * - Credentials are validated before being saved
+ *
+ * MULTI-ACCOUNT SUPPORT:
+ * - Each provider can have multiple named accounts
+ * - Default account can be set for each provider
+ * - Users can switch between accounts using --account flag
+ *
+ * Based on login/logout patterns from openclaw
+ * Original: https://github.com/varunisrani/indusagi-ts/vendor/indusagi-agent
+ *
+ * Adapted to:
+ * - Improve error messages
+ * - Add comprehensive documentation
+ * - Add security-focused comments
+ * - Add credential validation
+ * - Enhance UX with better prompts
+ */
+/**
+ * Login command options
+ *
+ * @interface LoginOptions
+ * @property {string} [provider] - Provider ID to login to
+ * @property {string} [account] - Account name for multi-account providers
+ * @property {boolean} [list] - List saved accounts instead of logging in
+ * @property {boolean} [all] - Logout all accounts for provider
  */
 export interface LoginOptions {
     provider?: string;
@@ -16,5 +46,49 @@ export interface LoginOptions {
     list?: boolean;
     all?: boolean;
 }
+/**
+ * Login/authentication error with helpful suggestions
+ *
+ * @class LoginError
+ * @extends {Error}
+ */
+export declare class LoginError extends Error {
+    readonly code: string;
+    readonly suggestion?: string | undefined;
+    constructor(message: string, code: string, suggestion?: string | undefined);
+}
+/**
+ * Credential validation error
+ *
+ * @class CredentialValidationError
+ * @extends {Error}
+ */
+export declare class CredentialValidationError extends Error {
+    readonly code: string;
+    readonly suggestion?: string | undefined;
+    constructor(message: string, code: string, suggestion?: string | undefined);
+}
+/**
+ * Handle login/logout commands
+ *
+ * Entry point for the login/logout command flow:
+ * 1. Parse command options
+ * 2. Initialize auth storage
+ * 3. Route to appropriate handler (list, logout, login)
+ *
+ * @param args - Command line arguments
+ * @returns Promise resolving to true if command was handled
+ *
+ * @throws {LoginError} If command fails
+ *
+ * @example
+ * ```typescript
+ * // Handle login command
+ * await handleLoginCommand(["login", "--provider", "openai"]);
+ *
+ * // Handle logout command
+ * await handleLoginCommand(["logout", "--provider", "openai"]);
+ * ```
+ */
 export declare function handleLoginCommand(args: string[]): Promise<boolean>;
 //# sourceMappingURL=login-handler.d.ts.map

package/dist/cli/login-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login-handler.d.ts","sourceRoot":"","sources":["../../src/cli/login-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AA2BD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BzE"}
+{"version":3,"file":"login-handler.d.ts","sourceRoot":"","sources":["../../src/cli/login-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAmBH;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;CACd;AAoBD;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGnB,IAAI,EAAE,MAAM;aACZ,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aAGlC,IAAI,EAAE,MAAM;aACZ,UAAU,CAAC,EAAE,MAAM;gBAFnC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA;CAKpC;AAsJD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA0CzE"}