coding-agent-adapters 0.6.0 → 0.7.0

package/README.md

@@ -105,6 +105,28 @@ 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.
@@ -425,6 +447,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

@@ -760,6 +760,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 +1069,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 +1423,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 +1877,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.
    *