coding-agent-adapters 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -151,6 +151,12 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * Coding agent CLIs use TUI menus that require arrow-key navigation.
      */
     readonly usesTuiMenus: boolean;
+    /**
+     * Ms of output silence after detectReady match before emitting session_ready.
+     * Allows TUI rendering (status bar, shortcuts, update notices) to complete
+     * before the orchestrator sends input.
+     */
+    readonly readySettleMs: number;
     /**
      * Installation information for this CLI tool
      */
@@ -208,6 +214,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
@@ -250,6 +262,8 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
 declare class ClaudeAdapter extends BaseCodingAdapter {
     readonly adapterType = "claude";
     readonly displayName = "Claude Code";
+    /** Heaviest TUI — status bar, shortcuts, update notices, /ide suggestions */
+    readonly readySettleMs: number;
     readonly installation: InstallationInfo;
     /**
      * Auto-response rules for Claude Code CLI.
@@ -267,6 +281,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.
      *
@@ -308,6 +330,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.
      *
@@ -361,6 +391,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.
      *
@@ -398,6 +437,8 @@ declare class CodexAdapter extends BaseCodingAdapter {
 declare class AiderAdapter extends BaseCodingAdapter {
     readonly adapterType = "aider";
     readonly displayName = "Aider";
+    /** Minimal TUI, mostly text output — shorter settle delay */
+    readonly readySettleMs: number;
     /**
      * Aider uses plain text [y/n] prompts, NOT TUI arrow-key menus.
      */
@@ -422,6 +463,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

@@ -151,6 +151,12 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * Coding agent CLIs use TUI menus that require arrow-key navigation.
      */
     readonly usesTuiMenus: boolean;
+    /**
+     * Ms of output silence after detectReady match before emitting session_ready.
+     * Allows TUI rendering (status bar, shortcuts, update notices) to complete
+     * before the orchestrator sends input.
+     */
+    readonly readySettleMs: number;
     /**
      * Installation information for this CLI tool
      */
@@ -208,6 +214,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
@@ -250,6 +262,8 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
 declare class ClaudeAdapter extends BaseCodingAdapter {
     readonly adapterType = "claude";
     readonly displayName = "Claude Code";
+    /** Heaviest TUI — status bar, shortcuts, update notices, /ide suggestions */
+    readonly readySettleMs: number;
     readonly installation: InstallationInfo;
     /**
      * Auto-response rules for Claude Code CLI.
@@ -267,6 +281,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.
      *
@@ -308,6 +330,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.
      *
@@ -361,6 +391,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.
      *
@@ -398,6 +437,8 @@ declare class CodexAdapter extends BaseCodingAdapter {
 declare class AiderAdapter extends BaseCodingAdapter {
     readonly adapterType = "aider";
     readonly displayName = "Aider";
+    /** Minimal TUI, mostly text output — shorter settle delay */
+    readonly readySettleMs: number;
     /**
      * Aider uses plain text [y/n] prompts, NOT TUI arrow-key menus.
      */
@@ -422,6 +463,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

@@ -366,6 +366,12 @@ var BaseCodingAdapter = class extends BaseCLIAdapter {
    * Coding agent CLIs use TUI menus that require arrow-key navigation.
    */
   usesTuiMenus = true;
+  /**
+   * Ms of output silence after detectReady match before emitting session_ready.
+   * Allows TUI rendering (status bar, shortcuts, update notices) to complete
+   * before the orchestrator sends input.
+   */
+  readySettleMs = 300;
   /**
    * The primary memory file for this CLI (the one it reads for project instructions).
    * Returns the relativePath of the first 'memory' type file from getWorkspaceFiles().
@@ -533,6 +539,8 @@ Docs: ${this.installation.docsUrl}`
 var ClaudeAdapter = class extends BaseCodingAdapter {
   adapterType = "claude";
   displayName = "Claude Code";
+  /** Heaviest TUI — status bar, shortcuts, update notices, /ide suggestions */
+  readySettleMs = 500;
   installation = {
     command: "npm install -g @anthropic-ai/claude-code",
     alternatives: [
@@ -750,6 +758,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.
    *
@@ -1041,6 +1067,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.
    *
@@ -1377,6 +1421,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.
    *
@@ -1464,6 +1530,8 @@ var CodexAdapter = class extends BaseCodingAdapter {
 var AiderAdapter = class extends BaseCodingAdapter {
   adapterType = "aider";
   displayName = "Aider";
+  /** Minimal TUI, mostly text output — shorter settle delay */
+  readySettleMs = 200;
   /**
    * Aider uses plain text [y/n] prompts, NOT TUI arrow-key menus.
    */
@@ -1807,6 +1875,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.
    *