coding-agent-adapters 0.3.0 → 0.4.1

package/README.md

@@ -94,6 +94,27 @@ 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 |
 
+### 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.
+
+| Adapter | Completion Indicators | Source Patterns |
+|---------|----------------------|----------------|
+| Claude | Turn duration (`Cooked for 3m 12s`, custom verb) + `❯` prompt (tolerates trailing status bar) | `claude_completed_turn_duration` |
+| Gemini | `◇ Ready` window title, `Type your message` composer | `gemini_ready_title` |
+| Codex | `Worked for 1m 05s` separator + `›` prompt | `codex_completed_worked_for_separator`, `codex_ready_prompt` |
+| Aider | `Aider is waiting for your input`, mode prompts with edit/cost markers | `aider_completed_llm_response_ready` |
+
+```typescript
+const claude = new ClaudeAdapter();
+claude.detectTaskComplete('Cooked for 3m 12s\n❯ ');  // true
+claude.detectTaskComplete('Reading 5 files…');         // false
+
+const aider = new AiderAdapter();
+aider.detectTaskComplete('Applied edit to main.ts\nTokens: 1234\ncode> ');  // true
+aider.detectTaskComplete('Waiting for claude-sonnet-4-20250514');            // false
+```
+
 ### Exit Detection
 
 Adapters detect when a CLI session has ended:
@@ -390,6 +411,11 @@ export class CursorAdapter extends BaseCodingAdapter {
     return /cursor>\s*$/m.test(output);
   }
 
+  detectTaskComplete(output: string): boolean {
+    // High-confidence: task summary + idle prompt
+    return /completed in \d+s/.test(output) && /cursor>\s*$/m.test(output);
+  }
+
   parseOutput(output: string): ParsedOutput | null {
     return { type: 'response', content: output.trim(), isComplete: true, isQuestion: output.includes('?') };
   }

package/dist/index.cjs

@@ -56,6 +56,8 @@ var CLAUDE_TOOL_CATEGORIES = {
   // file_write
   Write: "file_write",
   Edit: "file_write",
+  MultiEdit: "file_write",
+  NotebookEdit: "file_write",
   // shell
   Bash: "shell",
   BashOutput: "shell",
@@ -747,15 +749,40 @@ var ClaudeAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect task completion for Claude Code.
+   *
+   * High-confidence pattern: turn duration summary + idle prompt.
+   * Claude Code shows "<Verb> for Xm Ys" (e.g. "Cooked for 3m 12s")
+   * when a turn completes, followed by the ❯ input prompt.
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - claude_completed_turn_duration
+   *   - claude_completed_turn_duration_custom_verb
+   */
+  detectTaskComplete(output) {
+    const stripped = this.stripAnsi(output);
+    const hasDuration = /[A-Z][A-Za-z' -]{2,40}\s+for\s+\d+(?:h\s+\d{1,2}m\s+\d{1,2}s|m\s+\d{1,2}s|s)/.test(stripped);
+    const tail = stripped.slice(-300);
+    const hasIdlePrompt = /❯/.test(tail);
+    if (hasDuration && hasIdlePrompt) {
+      return true;
+    }
+    if (hasIdlePrompt && stripped.includes("for shortcuts")) {
+      return true;
+    }
+    return false;
+  }
   detectReady(output) {
     const stripped = this.stripAnsi(output);
     if (/trust.*directory|do you want to|needs? your permission/i.test(stripped)) {
       return false;
     }
+    const tail = stripped.slice(-300);
     return stripped.includes("How can I help") || stripped.includes("What would you like") || // v2.1+ shows "for shortcuts" hint when ready
     stripped.includes("for shortcuts") || // Match "claude> " or similar specific prompts, not bare ">"
-    /claude>\s*$/i.test(stripped) || // v2.1+ uses ❯ as the input prompt
-    /❯\s*$/.test(stripped);
+    /claude>/i.test(tail) || // v2.1+ uses ❯ as the input prompt
+    /❯/.test(tail);
   }
   parseOutput(output) {
     const stripped = this.stripAnsi(output);
@@ -1004,6 +1031,26 @@ var GeminiAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect task completion for Gemini CLI.
+   *
+   * High-confidence patterns:
+   *   - "◇ Ready" window title signal (OSC sequence, may survive ANSI stripping)
+   *   - "Type your message" composer placeholder after agent output
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - gemini_ready_title
+   */
+  detectTaskComplete(output) {
+    const stripped = this.stripAnsi(output);
+    if (/◇\s+Ready/.test(stripped)) {
+      return true;
+    }
+    if (/type.?your.?message/i.test(stripped)) {
+      return true;
+    }
+    return false;
+  }
   detectReady(output) {
     const stripped = this.stripAnsi(output);
     if (/type.?your.?message/i.test(stripped)) {
@@ -1314,6 +1361,32 @@ var CodexAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect task completion for Codex CLI.
+   *
+   * High-confidence patterns:
+   *   - "Worked for Xm Ys" separator after work-heavy turns
+   *   - "› Ask Codex to do anything" ready prompt
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - codex_completed_worked_for_separator
+   *   - codex_ready_prompt
+   */
+  detectTaskComplete(output) {
+    const stripped = this.stripAnsi(output);
+    const hasWorkedFor = /Worked\s+for\s+\d+(?:h\s+\d{2}m\s+\d{2}s|m\s+\d{2}s|s)/.test(stripped);
+    const hasReadyPrompt = /›\s+Ask\s+Codex\s+to\s+do\s+anything/.test(stripped);
+    if (hasWorkedFor && hasReadyPrompt) {
+      return true;
+    }
+    if (hasReadyPrompt) {
+      return true;
+    }
+    if (hasWorkedFor && /›\s+/m.test(stripped)) {
+      return true;
+    }
+    return false;
+  }
   detectReady(output) {
     const stripped = this.stripAnsi(output);
     if (/do.?you.?trust.?the.?contents/i.test(stripped) || /sign.?in.?with.?chatgpt/i.test(stripped) || /update.?available/i.test(stripped) || /enable.?full.?access/i.test(stripped) || /choose.?working.?directory/i.test(stripped)) {
@@ -1718,6 +1791,31 @@ var AiderAdapter = class extends BaseCodingAdapter {
     }
     return super.detectBlockingPrompt(output);
   }
+  /**
+   * Detect task completion for Aider.
+   *
+   * High-confidence patterns:
+   *   - "Aider is waiting for your input" notification (bell message)
+   *   - Edit-format mode prompts (ask>, code>, architect>) after output
+   *
+   * Patterns from: AGENT_LOADING_STATUS_PATTERNS.json
+   *   - aider_completed_llm_response_ready
+   */
+  detectTaskComplete(output) {
+    const stripped = this.stripAnsi(output);
+    if (/Aider\s+is\s+waiting\s+for\s+your\s+input/.test(stripped)) {
+      return true;
+    }
+    const hasPrompt = /(?:ask|code|architect)(?:\s+multi)?>\s*$/m.test(stripped);
+    if (hasPrompt) {
+      const hasEditMarkers = /Applied edit to|Commit [a-f0-9]+|wrote to|Updated/i.test(stripped);
+      const hasTokenUsage = /Tokens:|Cost:/i.test(stripped);
+      if (hasEditMarkers || hasTokenUsage) {
+        return true;
+      }
+    }
+    return false;
+  }
   detectReady(output) {
     const stripped = this.stripAnsi(output);
     if (/login to openrouter/i.test(stripped) || /open this url in your browser/i.test(stripped) || /waiting up to 5 minutes/i.test(stripped)) {