coding-agent-adapters 0.13.0 → 0.15.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseCLIAdapter, SpawnConfig, AutoResponseRule, LoginDetection, BlockingPromptDetection, ToolRunningInfo, ParsedOutput } from 'adapter-types';
+import { BaseCLIAdapter, SpawnConfig, AutoResponseRule, LoginDetection, BlockingPromptDetection, ParsedOutput, ToolRunningInfo } from 'adapter-types';
 
 /**
  * Approval Presets
@@ -290,103 +290,93 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
 }
 
 /**
- * Claude Code CLI Adapter
+ * Aider CLI Adapter
  *
- * Adapter for the Claude Code CLI (claude command).
+ * Adapter for the Aider AI pair programming tool.
+ * https://github.com/paul-gauthier/aider
  */
 
-declare class ClaudeAdapter extends BaseCodingAdapter {
-    readonly adapterType = "claude";
-    readonly displayName = "Claude Code";
-    /** Heaviest TUI — status bar, shortcuts, update notices, /ide suggestions */
+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.
+     */
+    readonly usesTuiMenus: boolean;
     readonly installation: InstallationInfo;
     /**
-     * Auto-response rules for Claude Code CLI.
-     * These handle common text-based [y/n] prompts that can be safely auto-responded.
-     * Explicit responseType: 'text' prevents the usesTuiMenus default from kicking in.
+     * Auto-response rules for Aider CLI.
+     * Aider uses plain text prompts via io.py:832 with (Y)es/(N)o format.
+     * All rules are responseType: 'text' — Aider never uses TUI menus.
+     *
+     * Decline rules come first to override the generic accept patterns.
      */
     readonly autoResponseRules: AutoResponseRule[];
     getWorkspaceFiles(): AgentFileDescriptor[];
-    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
+    getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
-    getHookTelemetryProtocol(options?: {
-        scriptPath?: string;
-        markerPrefix?: string;
-        httpUrl?: string;
-        sessionId?: string;
-    }): {
-        markerPrefix: string;
-        scriptPath: string;
-        scriptContent: string;
-        settingsHooks: Record<string, unknown>;
-    };
-    private getHookMarkers;
-    private getLatestHookMarker;
-    private stripHookMarkers;
     detectLogin(output: string): LoginDetection;
     /**
-     * Detect blocking prompts specific to Claude Code CLI
+     * Detect blocking prompts specific to Aider CLI.
+     * Source: io.py, onboarding.py, base_coder.py, report.py
      */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
     /**
-     * Detect if Claude Code is actively loading/processing.
+     * Detect if Aider 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
+     *   - 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 if an external tool/process is running within the Claude session.
-     *
-     * Claude Code can launch external tools (browser, bash, Node, Python, etc.)
-     * that show status lines like "Claude in Chrome[javascript_tool]" or
-     * "[bash_tool]", "[python_tool]", etc.
-     *
-     * When detected, stall detection is suppressed and the UI can display
-     * which tool is active.
-     */
-    detectToolRunning(output: string): ToolRunningInfo | null;
-    /**
-     * Detect task completion for Claude Code.
+     * Detect task completion for Aider.
      *
-     * 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.
+     * 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
-     *   - claude_completed_turn_duration
-     *   - claude_completed_turn_duration_custom_verb
+     *   - aider_completed_llm_response_ready
      */
     detectTaskComplete(output: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
-    getPromptPattern(): RegExp;
-    getHealthCheckCommand(): string;
+    /**
+     * Detect exit conditions specific to Aider.
+     * Source: base_coder.py:994, base_coder.py:998, report.py:77, versioncheck.py:58
+     */
     detectExit(output: string): {
         exited: boolean;
         code?: number;
         error?: string;
     };
+    getPromptPattern(): RegExp;
+    getHealthCheckCommand(): string;
 }
 
 /**
- * Google Gemini CLI Adapter
+ * Claude Code CLI Adapter
  *
- * Adapter for the Google Gemini CLI tool.
+ * Adapter for the Claude Code CLI (claude command).
  */
 
-declare class GeminiAdapter extends BaseCodingAdapter {
-    readonly adapterType = "gemini";
-    readonly displayName = "Google Gemini";
+declare class ClaudeAdapter extends BaseCodingAdapter {
+    readonly adapterType = "claude";
+    readonly displayName = "Claude Code";
+    /** Heaviest TUI — status bar, shortcuts, update notices, /ide suggestions.
+     *  3000ms needed because detectReady fires early during boot rendering. */
+    readonly readySettleMs: number;
     readonly installation: InstallationInfo;
     /**
-     * Auto-response rules for Gemini CLI.
-     * Gemini uses Ink/React TUI with arrow-key radio menus.
-     * Source: FolderTrustDialog.tsx, MultiFolderTrustDialog.tsx, CloudFreePrivacyNotice.tsx
+     * Auto-response rules for Claude Code CLI.
+     * These handle common text-based [y/n] prompts that can be safely auto-responded.
+     * Explicit responseType: 'text' prevents the usesTuiMenus default from kicking in.
      */
     readonly autoResponseRules: AutoResponseRule[];
     getWorkspaceFiles(): AgentFileDescriptor[];
@@ -409,40 +399,50 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     private getLatestHookMarker;
     private stripHookMarkers;
     detectLogin(output: string): LoginDetection;
+    /**
+     * Detect blocking prompts specific to Claude Code CLI
+     */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
     /**
-     * Detect if Gemini CLI is actively loading/processing.
+     * Detect if Claude Code 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..."
+     *   - claude_active_reading_files: "Reading N files…"
+     *   - General: "esc to interrupt" spinner status line
      */
     detectLoading(output: string): boolean;
+    /**
+     * Detect if an external tool/process is running within the Claude session.
+     *
+     * Claude Code can launch external tools (browser, bash, Node, Python, etc.)
+     * that show status lines like "Claude in Chrome[javascript_tool]" or
+     * "[bash_tool]", "[python_tool]", etc.
+     *
+     * When detected, stall detection is suppressed and the UI can display
+     * which tool is active.
+     */
     detectToolRunning(output: string): ToolRunningInfo | null;
     /**
-     * Detect task completion for Gemini CLI.
+     * Detect task completion for Claude Code.
      *
-     * High-confidence patterns:
-     *   - "◇ Ready" window title signal (OSC sequence, may survive ANSI stripping)
-     *   - "Type your message" composer placeholder after agent output
+     * 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
-     *   - gemini_ready_title
+     *   - claude_completed_turn_duration
+     *   - claude_completed_turn_duration_custom_verb
      */
     detectTaskComplete(output: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
-    /**
-     * Detect exit conditions specific to Gemini CLI.
-     * Source: FolderTrustDialog.tsx:127, LogoutConfirmationDialog.tsx:64
-     */
+    getPromptPattern(): RegExp;
+    getHealthCheckCommand(): string;
     detectExit(output: string): {
         exited: boolean;
         code?: number;
         error?: string;
     };
-    getPromptPattern(): RegExp;
-    getHealthCheckCommand(): string;
 }
 
 /**
@@ -454,6 +454,7 @@ declare class GeminiAdapter extends BaseCodingAdapter {
 declare class CodexAdapter extends BaseCodingAdapter {
     readonly adapterType = "codex";
     readonly displayName = "OpenAI Codex";
+    readonly readySettleMs: number;
     readonly installation: InstallationInfo;
     /**
      * Auto-response rules for OpenAI Codex CLI.
@@ -509,66 +510,68 @@ declare class CodexAdapter extends BaseCodingAdapter {
 }
 
 /**
- * Aider CLI Adapter
+ * Google Gemini CLI Adapter
  *
- * Adapter for the Aider AI pair programming tool.
- * https://github.com/paul-gauthier/aider
+ * Adapter for the Google Gemini CLI tool.
  */
 
-declare class AiderAdapter extends BaseCodingAdapter {
-    readonly adapterType = "aider";
-    readonly displayName = "Aider";
-    /** Minimal TUI, mostly text output — shorter settle delay */
+declare class GeminiAdapter extends BaseCodingAdapter {
+    readonly adapterType = "gemini";
+    readonly displayName = "Google Gemini";
     readonly readySettleMs: number;
-    /**
-     * Aider uses plain text [y/n] prompts, NOT TUI arrow-key menus.
-     */
-    readonly usesTuiMenus: boolean;
     readonly installation: InstallationInfo;
     /**
-     * Auto-response rules for Aider CLI.
-     * Aider uses plain text prompts via io.py:832 with (Y)es/(N)o format.
-     * All rules are responseType: 'text' — Aider never uses TUI menus.
-     *
-     * Decline rules come first to override the generic accept patterns.
+     * Auto-response rules for Gemini CLI.
+     * Gemini uses Ink/React TUI with arrow-key radio menus.
+     * Source: FolderTrustDialog.tsx, MultiFolderTrustDialog.tsx, CloudFreePrivacyNotice.tsx
      */
     readonly autoResponseRules: AutoResponseRule[];
     getWorkspaceFiles(): AgentFileDescriptor[];
-    getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
+    getHookTelemetryProtocol(options?: {
+        scriptPath?: string;
+        markerPrefix?: string;
+        httpUrl?: string;
+        sessionId?: string;
+    }): {
+        markerPrefix: string;
+        scriptPath: string;
+        scriptContent: string;
+        settingsHooks: Record<string, unknown>;
+    };
+    private getHookMarkers;
+    private getLatestHookMarker;
+    private stripHookMarkers;
     detectLogin(output: string): LoginDetection;
-    /**
-     * Detect blocking prompts specific to Aider CLI.
-     * Source: io.py, onboarding.py, base_coder.py, report.py
-     */
     detectBlockingPrompt(output: string): BlockingPromptDetection;
     /**
-     * Detect if Aider is actively loading/processing.
+     * Detect if Gemini CLI 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 ..."
+     *   - gemini_active_loading_line: "(esc to cancel, Xs)"
+     *   - gemini_active_waiting_user_confirmation: "Waiting for user confirmation..."
      */
     detectLoading(output: string): boolean;
+    detectToolRunning(output: string): ToolRunningInfo | null;
     /**
-     * Detect task completion for Aider.
+     * Detect task completion for Gemini CLI.
      *
      * High-confidence patterns:
-     *   - "Aider is waiting for your input" notification (bell message)
-     *   - Edit-format mode prompts (ask>, code>, architect>) after output
+     *   - "◇ 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
-     *   - aider_completed_llm_response_ready
+     *   - gemini_ready_title
      */
     detectTaskComplete(output: string): boolean;
     detectReady(output: string): boolean;
     parseOutput(output: string): ParsedOutput | null;
     /**
-     * Detect exit conditions specific to Aider.
-     * Source: base_coder.py:994, base_coder.py:998, report.py:77, versioncheck.py:58
+     * Detect exit conditions specific to Gemini CLI.
+     * Source: FolderTrustDialog.tsx:127, LogoutConfirmationDialog.tsx:64
      */
     detectExit(output: string): {
         exited: boolean;
@@ -614,7 +617,7 @@ declare class HermesAdapter extends BaseCodingAdapter {
 /**
  * Dynamic Pattern Loader
  *
- * Loads adapter patterns from @parallax/adapter-monitor snapshots when available,
+ * Loads adapter patterns from @parallaxai/adapter-monitor snapshots when available,
  * with fallback to hardcoded baseline patterns.
  */
 
@@ -644,7 +647,7 @@ interface AdapterPatterns {
 /**
  * Load patterns for an adapter
  *
- * Tries to load from @parallax/adapter-monitor snapshots first,
+ * Tries to load from @parallaxai/adapter-monitor snapshots first,
  * falls back to hardcoded baseline patterns.
  *
  * @param adapter - Adapter type