coding-agent-adapters 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -207,6 +207,14 @@ 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 has completed a task and returned to its idle prompt.
+     * More specific than detectReady() — matches high-confidence completion indicators
+     * (e.g. duration summaries, explicit "done" messages) alongside the idle prompt.
+     *
+     * Used as a fast-path in stall detection to avoid expensive LLM classifier calls.
+     */
+    abstract detectTaskComplete(output: string): boolean;
     /**
      * Extract the approval preset from a spawn config, if set.
      */
@@ -258,6 +266,18 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
      * Detect blocking prompts specific to Claude Code CLI
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     getPromptPattern(): RegExp;
@@ -287,6 +307,17 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     getEnv(config: SpawnConfig): Record<string, string>;
     detectLogin(output: string): LoginDetection;
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**
@@ -329,6 +360,18 @@ declare class CodexAdapter extends BaseCodingAdapter {
      * Source: approval_overlay.rs, chatwidget.rs, request_user_input/mod.rs
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**
@@ -378,6 +421,17 @@ declare class AiderAdapter extends BaseCodingAdapter {
      * Source: io.py, onboarding.py, base_coder.py, report.py
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**

package/dist/index.d.ts

@@ -207,6 +207,14 @@ 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 has completed a task and returned to its idle prompt.
+     * More specific than detectReady() — matches high-confidence completion indicators
+     * (e.g. duration summaries, explicit "done" messages) alongside the idle prompt.
+     *
+     * Used as a fast-path in stall detection to avoid expensive LLM classifier calls.
+     */
+    abstract detectTaskComplete(output: string): boolean;
     /**
      * Extract the approval preset from a spawn config, if set.
      */
@@ -258,6 +266,18 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
      * Detect blocking prompts specific to Claude Code CLI
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     getPromptPattern(): RegExp;
@@ -287,6 +307,17 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     getEnv(config: SpawnConfig): Record<string, string>;
     detectLogin(output: string): LoginDetection;
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**
@@ -329,6 +360,18 @@ declare class CodexAdapter extends BaseCodingAdapter {
      * Source: approval_overlay.rs, chatwidget.rs, request_user_input/mod.rs
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**
@@ -378,6 +421,17 @@ declare class AiderAdapter extends BaseCodingAdapter {
      * Source: io.py, onboarding.py, base_coder.py, report.py
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
+    /**
+     * 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: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**

package/dist/index.js

@@ -54,6 +54,8 @@ var CLAUDE_TOOL_CATEGORIES = {
   // file_write
   Write: "file_write",
   Edit: "file_write",
+  MultiEdit: "file_write",
+  NotebookEdit: "file_write",
   // shell
   Bash: "shell",
   BashOutput: "shell",
@@ -745,6 +747,29 @@ 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 hasIdlePrompt = /❯\s*$/.test(stripped);
+    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)) {
@@ -1002,6 +1027,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)) {
@@ -1312,6 +1357,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)) {
@@ -1716,6 +1787,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)) {