coding-agent-adapters 0.4.3 → 0.6.0

package/README.md

@@ -44,12 +44,12 @@ session.send('Help me refactor this function to use async/await');
 
 ## Available Adapters
 
-| Adapter | CLI | Type | Input Style | Auto-Response Rules |
-|---------|-----|------|-------------|---------------------|
-| `ClaudeAdapter` | Claude Code | `claude` | TUI menus | 5 rules |
-| `GeminiAdapter` | Gemini CLI | `gemini` | TUI menus | 3 rules |
-| `CodexAdapter` | OpenAI Codex | `codex` | TUI menus | 6 rules |
-| `AiderAdapter` | Aider | `aider` | Text `(Y)es/(N)o` | 17 rules |
+| Adapter | CLI | Type | Input Style | Auto-Response Rules | Ready Settle |
+|---------|-----|------|-------------|---------------------|-------------|
+| `ClaudeAdapter` | Claude Code | `claude` | TUI menus | 5 rules | 500ms |
+| `GeminiAdapter` | Gemini CLI | `gemini` | TUI menus | 3 rules | 300ms |
+| `CodexAdapter` | OpenAI Codex | `codex` | TUI menus | 6 rules | 300ms |
+| `AiderAdapter` | Aider | `aider` | Text `(Y)es/(N)o` | 17 rules | 200ms |
 
 ## Session Lifecycle Detection
 
@@ -83,6 +83,17 @@ Each adapter knows exactly what "ready for input" looks like:
 | Codex | `>` glyph, placeholder suggestions | `chat_composer.rs` |
 | Aider | `ask>`, `code>`, `architect>`, `help>`, `multi>`, startup banner | `io.py`, `base_coder.py` |
 
+### Ready Settle Delay
+
+Each adapter sets `readySettleMs` to control how long pty-manager waits after `detectReady()` matches before emitting `session_ready`. This prevents the orchestrator from sending input while the TUI is still rendering (status bar, shortcuts, update notices). The base default is 300ms; adapters override based on their rendering weight.
+
+| Adapter | `readySettleMs` | Rationale |
+|---------|----------------|-----------|
+| Claude Code | 500ms | Heaviest TUI — status bar, shortcuts, update notices, /ide suggestions |
+| Gemini CLI | 300ms | Moderate Ink TUI (inherits base default) |
+| Codex | 300ms | Moderate Rust TUI (inherits base default) |
+| Aider | 200ms | Minimal TUI, mostly text output |
+
 ### Blocking Prompt Detection
 
 Adapters detect prompts that block the session and require user action:
@@ -382,6 +393,9 @@ export class CursorAdapter extends BaseCodingAdapter {
   // Set to false if the CLI uses text prompts instead of TUI menus
   override readonly usesTuiMenus = false;
 
+  // Tune ready settle delay for this CLI's rendering speed (base default: 300ms)
+  override readonly readySettleMs = 250;
+
   readonly autoResponseRules: AutoResponseRule[] = [
     { pattern: /accept terms/i, type: 'tos', response: 'y', responseType: 'text', description: 'Accept TOS', safe: true, once: true },
   ];

package/dist/index.cjs

@@ -368,6 +368,12 @@ var BaseCodingAdapter = class extends ptyManager.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().
@@ -535,6 +541,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: [
@@ -985,6 +993,15 @@ var GeminiAdapter = class extends BaseCodingAdapter {
         instructions: "Gemini is asking to apply a change (file write, shell command, etc.)"
       };
     }
+    if (/Interactive\s+shell\s+awaiting\s+input/i.test(stripped)) {
+      return {
+        detected: true,
+        type: "tool_wait",
+        prompt: "Gemini interactive shell needs user focus",
+        canAutoRespond: false,
+        instructions: "Press Tab to focus the interactive shell, or wait for it to complete"
+      };
+    }
     const loginDetection = this.detectLogin(output);
     if (loginDetection.required) {
       return {
@@ -1106,6 +1123,12 @@ var GeminiAdapter = class extends BaseCodingAdapter {
         code: 0
       };
     }
+    if (/Agent\s+powering\s+down/i.test(stripped)) {
+      return {
+        exited: true,
+        code: 0
+      };
+    }
     return super.detectExit(output);
   }
   getPromptPattern() {
@@ -1451,6 +1474,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.
    */
@@ -1903,6 +1928,15 @@ var BASELINE_PATTERNS = {
       "update available",
       "[y/n]"
     ],
+    loading: [
+      "Reading X files\u2026"
+    ],
+    turnComplete: [
+      "Cooked for 1m 6s",
+      "<CustomVerb> for 4m 39s"
+    ],
+    toolWait: [],
+    exit: [],
     source: "baseline"
   },
   gemini: {
@@ -1924,6 +1958,20 @@ var BASELINE_PATTERNS = {
       "update available",
       "[y/n]"
     ],
+    loading: [
+      "<phrase> (esc to cancel, 25s)",
+      "Waiting for user confirmation...",
+      "Generating witty retort\u2026",
+      "Reticulating splines",
+      "Warming up the AI hamsters"
+    ],
+    turnComplete: [],
+    toolWait: [
+      "Interactive shell awaiting input... press tab to focus shell"
+    ],
+    exit: [
+      "Agent powering down. Goodbye!"
+    ],
     source: "baseline"
   },
   codex: {
@@ -1942,6 +1990,18 @@ var BASELINE_PATTERNS = {
       "update available",
       "[y/n]"
     ],
+    loading: [
+      "\u2022 Working (0s \u2022 esc to interrupt)",
+      "Booting MCP server: alpha"
+    ],
+    turnComplete: [
+      "Worked for 1m 05s"
+    ],
+    toolWait: [
+      "Waiting for background terminal \xB7 <command>",
+      "Searching the web"
+    ],
+    exit: [],
     source: "baseline"
   },
   aider: {
@@ -1960,6 +2020,16 @@ var BASELINE_PATTERNS = {
       "(Y)es/(N)o",
       "[y/n]"
     ],
+    loading: [
+      "Waiting for <model>",
+      "Waiting for LLM",
+      "Generating commit message with <model>"
+    ],
+    turnComplete: [
+      "Aider is waiting for your input"
+    ],
+    toolWait: [],
+    exit: [],
     source: "baseline"
   }
 };
@@ -1977,6 +2047,10 @@ async function tryLoadFromMonitor(adapter, version) {
         ready: patterns.readyPatterns || [],
         auth: patterns.authPatterns || [],
         blocking: patterns.blockingPatterns || [],
+        loading: patterns.loadingPatterns || [],
+        turnComplete: patterns.turnCompletePatterns || [],
+        toolWait: patterns.toolWaitPatterns || [],
+        exit: patterns.exitPatterns || [],
         source: "snapshot",
         version: patterns.version
       };