coding-agent-adapters 0.6.0 → 0.7.1

package/README.md

@@ -53,7 +53,9 @@ session.send('Help me refactor this function to use async/await');
 
 ## Session Lifecycle Detection
 
-Each adapter implements detection for every stage of a CLI session:
+Each adapter implements detection for every stage of a CLI session.
+
+All detection methods use `stripAnsi()` which strips ANSI escape sequences, cursor positioning codes, bare control characters, TUI spinner/box-drawing characters, and collapses whitespace — ensuring regex patterns match through raw terminal output. Prompt indicators (`❯`, `›`, `◇`) are preserved.
 
 ### Login / Auth Detection
 
@@ -105,9 +107,31 @@ Adapters detect prompts that block the session and require user action:
 | Codex | Directory trust, tool approval, update available, model migration, CWD selection |
 | Aider | File operations, shell commands, git init, pip install, destructive operations |
 
+### Loading / Active-Work Detection
+
+Each adapter implements `detectLoading(output)` to detect when the CLI is actively processing — thinking spinners, file reading, model streaming. When loading is detected, pty-manager suppresses stall detection entirely, avoiding unnecessary LLM classifier calls during normal operation.
+
+| Adapter | Loading Indicators | Source Patterns |
+|---------|-------------------|----------------|
+| Claude | `esc to interrupt`, `Reading N files` | `claude_active_reading_files` |
+| Gemini | `esc to cancel`, `Waiting for user confirmation` | `gemini_active_loading_line` |
+| Codex | `esc to interrupt`, `Booting MCP server`, `Searching the web` | `codex_active_status_row`, `codex_active_booting_mcp` |
+| Aider | `Waiting for LLM/<model>`, `Generating commit message with` | `aider_active_waiting_model`, `aider_active_waiting_llm_default` |
+
+```typescript
+const claude = new ClaudeAdapter();
+claude.detectLoading('• Working (5s • esc to interrupt)');  // true
+claude.detectLoading('Reading 42 files…');                   // true
+claude.detectLoading('❯ ');                                  // false
+
+const aider = new AiderAdapter();
+aider.detectLoading('Waiting for claude-sonnet-4-20250514'); // true
+aider.detectLoading('code> ');                                // false
+```
+
 ### Task Completion Detection
 
-Each adapter implements `detectTaskComplete(output)` to recognize when the CLI has finished a task and returned to its idle prompt. This is more specific than `detectReady()` — it matches high-confidence completion indicators (duration summaries, explicit done messages) that short-circuit the LLM stall classifier in pty-manager.
+Each adapter implements `detectTaskComplete(output)` to recognize when the CLI has finished a task and returned to its idle prompt. This is more specific than `detectReady()` — it matches high-confidence completion indicators (duration summaries, explicit done messages) that short-circuit the LLM stall classifier in pty-manager. Patterns match through raw ANSI-laden TUI output including spinner characters and cursor positioning codes.
 
 | Adapter | Completion Indicators | Source Patterns |
 |---------|----------------------|----------------|
@@ -425,6 +449,11 @@ export class CursorAdapter extends BaseCodingAdapter {
     return /cursor>\s*$/m.test(output);
   }
 
+  detectLoading(output: string): boolean {
+    // Active loading indicator — suppresses stall detection
+    return /processing|thinking/i.test(output);
+  }
+
   detectTaskComplete(output: string): boolean {
     // High-confidence: task summary + idle prompt
     return /completed in \d+s/.test(output) && /cursor>\s*$/m.test(output);

package/dist/index.cjs

@@ -401,17 +401,27 @@ var BaseCodingAdapter = class extends ptyManager.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
@@ -760,6 +770,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.
    *
@@ -1051,6 +1079,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.
    *
@@ -1387,6 +1433,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.
    *
@@ -1819,6 +1887,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.
    *