coding-agent-adapters 0.5.0 → 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: [
@@ -1466,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.
    */