coding-agent-adapters 0.6.0 → 0.7.1

package/dist/index.d.cts

@@ -187,11 +187,17 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      */
     abstract getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     /**
-     * Override stripAnsi to handle TUI cursor movement codes.
+     * Override stripAnsi to handle TUI cursor movement codes, spinner/box-drawing
+     * characters, bare control characters, and extra whitespace.
+     *
      * TUI CLIs (Claude Code, Gemini CLI, Codex) use cursor positioning
-     * sequences instead of literal spaces. Replace ALL cursor movement
-     * codes with spaces before stripping other ANSI codes so regex
-     * patterns can match the visible text.
+     * sequences instead of literal spaces, and render decorative Unicode
+     * characters (spinners, box-drawing). All of these must be stripped so
+     * adapter detection methods (detectReady, detectTaskComplete, etc.) can
+     * match visible text with their regex patterns.
+     *
+     * Note: ❯ and › are preserved — they are prompt indicators used by
+     * detectReady / detectTaskComplete.
      */
     protected stripAnsi(str: string): string;
     /**
@@ -214,6 +220,12 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * Extract the main content from CLI output, removing common artifacts
      */
     protected extractContent(output: string, promptPattern: RegExp): string;
+    /**
+     * Detect if the CLI is actively loading/processing (thinking spinner,
+     * file reading, model streaming, etc.). When true, stall detection is
+     * suppressed because the agent is provably working.
+     */
+    abstract detectLoading(output: string): boolean;
     /**
      * Detect if the CLI has completed a task and returned to its idle prompt.
      * More specific than detectReady() — matches high-confidence completion indicators
@@ -275,6 +287,14 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
      * Detect blocking prompts specific to Claude Code CLI
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Claude Code is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - claude_active_reading_files: "Reading N files…"
+     *   - General: "esc to interrupt" spinner status line
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Claude Code.
      *
@@ -316,6 +336,14 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     getEnv(config: SpawnConfig): Record<string, string>;
     detectLogin(output: string): LoginDetection;
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Gemini CLI is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - gemini_active_loading_line: "(esc to cancel, Xs)"
+     *   - gemini_active_waiting_user_confirmation: "Waiting for user confirmation..."
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Gemini CLI.
      *
@@ -369,6 +397,15 @@ declare class CodexAdapter extends BaseCodingAdapter {
      * Source: approval_overlay.rs, chatwidget.rs, request_user_input/mod.rs
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Codex CLI is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - codex_active_status_row: "• Working (0s • esc to interrupt)"
+     *   - codex_active_booting_mcp: "Booting MCP server: ..."
+     *   - codex_active_web_search: "Searching the web"
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Codex CLI.
      *
@@ -432,6 +469,15 @@ declare class AiderAdapter extends BaseCodingAdapter {
      * Source: io.py, onboarding.py, base_coder.py, report.py
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Aider is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - aider_active_waiting_model: "Waiting for <model>"
+     *   - aider_active_waiting_llm_default: "Waiting for LLM"
+     *   - aider_active_generating_commit_message: "Generating commit message with ..."
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Aider.
      *

package/dist/index.d.ts

@@ -187,11 +187,17 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      */
     abstract getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     /**
-     * Override stripAnsi to handle TUI cursor movement codes.
+     * Override stripAnsi to handle TUI cursor movement codes, spinner/box-drawing
+     * characters, bare control characters, and extra whitespace.
+     *
      * TUI CLIs (Claude Code, Gemini CLI, Codex) use cursor positioning
-     * sequences instead of literal spaces. Replace ALL cursor movement
-     * codes with spaces before stripping other ANSI codes so regex
-     * patterns can match the visible text.
+     * sequences instead of literal spaces, and render decorative Unicode
+     * characters (spinners, box-drawing). All of these must be stripped so
+     * adapter detection methods (detectReady, detectTaskComplete, etc.) can
+     * match visible text with their regex patterns.
+     *
+     * Note: ❯ and › are preserved — they are prompt indicators used by
+     * detectReady / detectTaskComplete.
      */
     protected stripAnsi(str: string): string;
     /**
@@ -214,6 +220,12 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * Extract the main content from CLI output, removing common artifacts
      */
     protected extractContent(output: string, promptPattern: RegExp): string;
+    /**
+     * Detect if the CLI is actively loading/processing (thinking spinner,
+     * file reading, model streaming, etc.). When true, stall detection is
+     * suppressed because the agent is provably working.
+     */
+    abstract detectLoading(output: string): boolean;
     /**
      * Detect if the CLI has completed a task and returned to its idle prompt.
      * More specific than detectReady() — matches high-confidence completion indicators
@@ -275,6 +287,14 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
      * Detect blocking prompts specific to Claude Code CLI
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Claude Code is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - claude_active_reading_files: "Reading N files…"
+     *   - General: "esc to interrupt" spinner status line
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Claude Code.
      *
@@ -316,6 +336,14 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     getEnv(config: SpawnConfig): Record<string, string>;
     detectLogin(output: string): LoginDetection;
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Gemini CLI is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - gemini_active_loading_line: "(esc to cancel, Xs)"
+     *   - gemini_active_waiting_user_confirmation: "Waiting for user confirmation..."
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Gemini CLI.
      *
@@ -369,6 +397,15 @@ declare class CodexAdapter extends BaseCodingAdapter {
      * Source: approval_overlay.rs, chatwidget.rs, request_user_input/mod.rs
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Codex CLI is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - codex_active_status_row: "• Working (0s • esc to interrupt)"
+     *   - codex_active_booting_mcp: "Booting MCP server: ..."
+     *   - codex_active_web_search: "Searching the web"
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Codex CLI.
      *
@@ -432,6 +469,15 @@ declare class AiderAdapter extends BaseCodingAdapter {
      * Source: io.py, onboarding.py, base_coder.py, report.py
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * Detect if Aider is actively loading/processing.
+     *
+     * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+     *   - aider_active_waiting_model: "Waiting for <model>"
+     *   - aider_active_waiting_llm_default: "Waiting for LLM"
+     *   - aider_active_generating_commit_message: "Generating commit message with ..."
+     */
+    detectLoading(output: string): boolean;
     /**
      * Detect task completion for Aider.
      *

package/dist/index.js

@@ -399,17 +399,27 @@ var BaseCodingAdapter = class extends BaseCLIAdapter {
     return adapterConfig?.interactive === true;
   }
   /**
-   * Override stripAnsi to handle TUI cursor movement codes.
+   * Override stripAnsi to handle TUI cursor movement codes, spinner/box-drawing
+   * characters, bare control characters, and extra whitespace.
+   *
    * TUI CLIs (Claude Code, Gemini CLI, Codex) use cursor positioning
-   * sequences instead of literal spaces. Replace ALL cursor movement
-   * codes with spaces before stripping other ANSI codes so regex
-   * patterns can match the visible text.
+   * sequences instead of literal spaces, and render decorative Unicode
+   * characters (spinners, box-drawing). All of these must be stripped so
+   * adapter detection methods (detectReady, detectTaskComplete, etc.) can
+   * match visible text with their regex patterns.
+   *
+   * Note: ❯ and › are preserved — they are prompt indicators used by
+   * detectReady / detectTaskComplete.
    */
   stripAnsi(str) {
     let result = str.replace(/\x1b\[\d*[CDABGdEF]/g, " ");
     result = result.replace(/\x1b\[\d*(?:;\d+)?[Hf]/g, " ");
     result = result.replace(/\x1b\[\d*[JK]/g, " ");
-    return super.stripAnsi(result);
+    result = super.stripAnsi(result);
+    result = result.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, "");
+    result = result.replace(/[│╭╰╮╯─═╌║╔╗╚╝╠╣╦╩╬┌┐└┘├┤┬┴┼●○❮▶◀⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏⣾⣽⣻⢿⡿⣟⣯⣷✻✶✳✢⏺←→↑↓⬆⬇◆▪▫■□▲△▼▽◈⟨⟩⌘⏎⏏⌫⌦⇧⇪⌥]/g, " ");
+    result = result.replace(/ {2,}/g, " ");
+    return result;
   }
   /**
    * Override detectExit to include installation instructions
@@ -758,6 +768,24 @@ var ClaudeAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect if Claude Code is actively loading/processing.
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - claude_active_reading_files: "Reading N files…"
+   *   - General: "esc to interrupt" spinner status line
+   */
+  detectLoading(output) {
+    const stripped = this.stripAnsi(output);
+    const tail = stripped.slice(-500);
+    if (/esc\s+to\s+interrupt/i.test(tail)) {
+      return true;
+    }
+    if (/Reading\s+\d+\s+files/i.test(tail)) {
+      return true;
+    }
+    return false;
+  }
   /**
    * Detect task completion for Claude Code.
    *
@@ -1049,6 +1077,24 @@ var GeminiAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect if Gemini CLI is actively loading/processing.
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - gemini_active_loading_line: "(esc to cancel, Xs)"
+   *   - gemini_active_waiting_user_confirmation: "Waiting for user confirmation..."
+   */
+  detectLoading(output) {
+    const stripped = this.stripAnsi(output);
+    const tail = stripped.slice(-500);
+    if (/esc\s+to\s+cancel/i.test(tail)) {
+      return true;
+    }
+    if (/Waiting\s+for\s+user\s+confirmation/i.test(tail)) {
+      return true;
+    }
+    return false;
+  }
   /**
    * Detect task completion for Gemini CLI.
    *
@@ -1385,6 +1431,28 @@ var CodexAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect if Codex CLI is actively loading/processing.
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - codex_active_status_row: "• Working (0s • esc to interrupt)"
+   *   - codex_active_booting_mcp: "Booting MCP server: ..."
+   *   - codex_active_web_search: "Searching the web"
+   */
+  detectLoading(output) {
+    const stripped = this.stripAnsi(output);
+    const tail = stripped.slice(-500);
+    if (/esc\s+to\s+interrupt/i.test(tail)) {
+      return true;
+    }
+    if (/Booting\s+MCP\s+server/i.test(tail)) {
+      return true;
+    }
+    if (/Searching\s+the\s+web/i.test(tail)) {
+      return true;
+    }
+    return false;
+  }
   /**
    * Detect task completion for Codex CLI.
    *
@@ -1817,6 +1885,25 @@ var AiderAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect if Aider is actively loading/processing.
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - aider_active_waiting_model: "Waiting for <model>"
+   *   - aider_active_waiting_llm_default: "Waiting for LLM"
+   *   - aider_active_generating_commit_message: "Generating commit message with ..."
+   */
+  detectLoading(output) {
+    const stripped = this.stripAnsi(output);
+    const tail = stripped.slice(-500);
+    if (/Waiting\s+for\s+(?:LLM|[A-Za-z0-9_./:@-]+)/i.test(tail)) {
+      return true;
+    }
+    if (/Generating\s+commit\s+message\s+with\s+/i.test(tail)) {
+      return true;
+    }
+    return false;
+  }
   /**
    * Detect task completion for Aider.
    *