coding-agent-adapters 0.2.19 → 0.4.0

package/dist/index.d.cts

@@ -1,5 +1,61 @@
 import { BaseCLIAdapter, SpawnConfig, AutoResponseRule, LoginDetection, BlockingPromptDetection, ParsedOutput } from 'pty-manager';
 
+/**
+ * Shared types for coding-agent-adapters
+ */
+/**
+ * Supported adapter types
+ */
+type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider';
+
+/**
+ * Approval Presets
+ *
+ * Unified preset system for controlling tool permissions across all supported
+ * coding agent CLIs. Each preset translates to the correct per-CLI config
+ * format (JSON settings files, CLI flags, env vars).
+ */
+
+type ToolCategory = 'file_read' | 'file_write' | 'shell' | 'web' | 'agent' | 'planning' | 'user_interaction';
+type RiskLevel = 'low' | 'medium' | 'high';
+type ApprovalPreset = 'readonly' | 'standard' | 'permissive' | 'autonomous';
+interface ToolCategoryInfo {
+    category: ToolCategory;
+    risk: RiskLevel;
+    description: string;
+}
+interface PresetDefinition {
+    preset: ApprovalPreset;
+    description: string;
+    autoApprove: ToolCategory[];
+    requireApproval: ToolCategory[];
+    blocked: ToolCategory[];
+}
+interface ApprovalConfig {
+    preset: ApprovalPreset;
+    cliFlags: string[];
+    workspaceFiles: Array<{
+        relativePath: string;
+        content: string;
+        format: 'json' | 'yaml' | 'toml';
+    }>;
+    envVars: Record<string, string>;
+    summary: string;
+}
+declare const TOOL_CATEGORIES: ToolCategoryInfo[];
+declare const PRESET_DEFINITIONS: PresetDefinition[];
+declare const CLAUDE_TOOL_CATEGORIES: Record<string, ToolCategory>;
+declare const GEMINI_TOOL_CATEGORIES: Record<string, ToolCategory>;
+declare const CODEX_TOOL_CATEGORIES: Record<string, ToolCategory>;
+declare const AIDER_COMMAND_CATEGORIES: Record<string, ToolCategory>;
+declare function generateClaudeApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateGeminiApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateCodexApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateAiderApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateApprovalConfig(adapterType: AdapterType, preset: ApprovalPreset): ApprovalConfig;
+declare function listPresets(): PresetDefinition[];
+declare function getPresetDefinition(preset: ApprovalPreset): PresetDefinition;
+
 /**
  * Base Coding Agent Adapter
  *
@@ -80,6 +136,11 @@ interface CodingAgentConfig extends SpawnConfig {
          * pick its best model for that provider automatically.
          */
         provider?: 'anthropic' | 'openai' | 'google';
+        /**
+         * Approval preset controlling tool permissions.
+         * Translates to CLI-specific config files and flags.
+         */
+        approvalPreset?: ApprovalPreset;
     } & Record<string, unknown>;
 }
 /**
@@ -146,6 +207,27 @@ 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.
+     */
+    protected getApprovalPreset(config: SpawnConfig): ApprovalPreset | undefined;
+    /**
+     * Generate the approval config for this adapter, if a preset is set.
+     */
+    getApprovalConfig(config: SpawnConfig): ApprovalConfig | null;
+    /**
+     * Write approval config files to a workspace directory.
+     * Returns the list of files written (absolute paths).
+     */
+    writeApprovalConfig(workspacePath: string, config: SpawnConfig): Promise<string[]>;
     /**
      * Write content to this agent's memory file in a workspace.
      * Creates parent directories as needed.
@@ -184,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;
@@ -213,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;
     /**
@@ -255,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;
     /**
@@ -304,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;
     /**
@@ -319,14 +447,6 @@ declare class AiderAdapter extends BaseCodingAdapter {
     getHealthCheckCommand(): string;
 }
 
-/**
- * Shared types for coding-agent-adapters
- */
-/**
- * Supported adapter types
- */
-type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider';
-
 /**
  * Dynamic Pattern Loader
  *
@@ -481,4 +601,4 @@ declare function checkAllAdapters(): Promise<PreflightResult[]>;
  */
 declare function printMissingAdapters(types?: AdapterType[]): Promise<void>;
 
-export { ADAPTER_TYPES, type AdapterPatterns, type AdapterType, type AgentCredentials, type AgentFileDescriptor, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GeminiAdapter, type InstallationInfo, type ModelRecommendations, type PreflightResult, type WriteMemoryOptions, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, getBaselinePatterns, hasDynamicPatterns, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };
+export { ADAPTER_TYPES, AIDER_COMMAND_CATEGORIES, type AdapterPatterns, type AdapterType, type AgentCredentials, type AgentFileDescriptor, AiderAdapter, type ApprovalConfig, type ApprovalPreset, BaseCodingAdapter, CLAUDE_TOOL_CATEGORIES, CODEX_TOOL_CATEGORIES, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GEMINI_TOOL_CATEGORIES, GeminiAdapter, type InstallationInfo, type ModelRecommendations, PRESET_DEFINITIONS, type PreflightResult, type PresetDefinition, type RiskLevel, TOOL_CATEGORIES, type ToolCategory, type ToolCategoryInfo, type WriteMemoryOptions, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, generateAiderApprovalConfig, generateApprovalConfig, generateClaudeApprovalConfig, generateCodexApprovalConfig, generateGeminiApprovalConfig, getBaselinePatterns, getPresetDefinition, hasDynamicPatterns, listPresets, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };

package/dist/index.d.ts

@@ -1,5 +1,61 @@
 import { BaseCLIAdapter, SpawnConfig, AutoResponseRule, LoginDetection, BlockingPromptDetection, ParsedOutput } from 'pty-manager';
 
+/**
+ * Shared types for coding-agent-adapters
+ */
+/**
+ * Supported adapter types
+ */
+type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider';
+
+/**
+ * Approval Presets
+ *
+ * Unified preset system for controlling tool permissions across all supported
+ * coding agent CLIs. Each preset translates to the correct per-CLI config
+ * format (JSON settings files, CLI flags, env vars).
+ */
+
+type ToolCategory = 'file_read' | 'file_write' | 'shell' | 'web' | 'agent' | 'planning' | 'user_interaction';
+type RiskLevel = 'low' | 'medium' | 'high';
+type ApprovalPreset = 'readonly' | 'standard' | 'permissive' | 'autonomous';
+interface ToolCategoryInfo {
+    category: ToolCategory;
+    risk: RiskLevel;
+    description: string;
+}
+interface PresetDefinition {
+    preset: ApprovalPreset;
+    description: string;
+    autoApprove: ToolCategory[];
+    requireApproval: ToolCategory[];
+    blocked: ToolCategory[];
+}
+interface ApprovalConfig {
+    preset: ApprovalPreset;
+    cliFlags: string[];
+    workspaceFiles: Array<{
+        relativePath: string;
+        content: string;
+        format: 'json' | 'yaml' | 'toml';
+    }>;
+    envVars: Record<string, string>;
+    summary: string;
+}
+declare const TOOL_CATEGORIES: ToolCategoryInfo[];
+declare const PRESET_DEFINITIONS: PresetDefinition[];
+declare const CLAUDE_TOOL_CATEGORIES: Record<string, ToolCategory>;
+declare const GEMINI_TOOL_CATEGORIES: Record<string, ToolCategory>;
+declare const CODEX_TOOL_CATEGORIES: Record<string, ToolCategory>;
+declare const AIDER_COMMAND_CATEGORIES: Record<string, ToolCategory>;
+declare function generateClaudeApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateGeminiApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateCodexApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateAiderApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateApprovalConfig(adapterType: AdapterType, preset: ApprovalPreset): ApprovalConfig;
+declare function listPresets(): PresetDefinition[];
+declare function getPresetDefinition(preset: ApprovalPreset): PresetDefinition;
+
 /**
  * Base Coding Agent Adapter
  *
@@ -80,6 +136,11 @@ interface CodingAgentConfig extends SpawnConfig {
          * pick its best model for that provider automatically.
          */
         provider?: 'anthropic' | 'openai' | 'google';
+        /**
+         * Approval preset controlling tool permissions.
+         * Translates to CLI-specific config files and flags.
+         */
+        approvalPreset?: ApprovalPreset;
     } & Record<string, unknown>;
 }
 /**
@@ -146,6 +207,27 @@ 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.
+     */
+    protected getApprovalPreset(config: SpawnConfig): ApprovalPreset | undefined;
+    /**
+     * Generate the approval config for this adapter, if a preset is set.
+     */
+    getApprovalConfig(config: SpawnConfig): ApprovalConfig | null;
+    /**
+     * Write approval config files to a workspace directory.
+     * Returns the list of files written (absolute paths).
+     */
+    writeApprovalConfig(workspacePath: string, config: SpawnConfig): Promise<string[]>;
     /**
      * Write content to this agent's memory file in a workspace.
      * Creates parent directories as needed.
@@ -184,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;
@@ -213,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;
     /**
@@ -255,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;
     /**
@@ -304,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;
     /**
@@ -319,14 +447,6 @@ declare class AiderAdapter extends BaseCodingAdapter {
     getHealthCheckCommand(): string;
 }
 
-/**
- * Shared types for coding-agent-adapters
- */
-/**
- * Supported adapter types
- */
-type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider';
-
 /**
  * Dynamic Pattern Loader
  *
@@ -481,4 +601,4 @@ declare function checkAllAdapters(): Promise<PreflightResult[]>;
  */
 declare function printMissingAdapters(types?: AdapterType[]): Promise<void>;
 
-export { ADAPTER_TYPES, type AdapterPatterns, type AdapterType, type AgentCredentials, type AgentFileDescriptor, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GeminiAdapter, type InstallationInfo, type ModelRecommendations, type PreflightResult, type WriteMemoryOptions, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, getBaselinePatterns, hasDynamicPatterns, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };
+export { ADAPTER_TYPES, AIDER_COMMAND_CATEGORIES, type AdapterPatterns, type AdapterType, type AgentCredentials, type AgentFileDescriptor, AiderAdapter, type ApprovalConfig, type ApprovalPreset, BaseCodingAdapter, CLAUDE_TOOL_CATEGORIES, CODEX_TOOL_CATEGORIES, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GEMINI_TOOL_CATEGORIES, GeminiAdapter, type InstallationInfo, type ModelRecommendations, PRESET_DEFINITIONS, type PreflightResult, type PresetDefinition, type RiskLevel, TOOL_CATEGORIES, type ToolCategory, type ToolCategoryInfo, type WriteMemoryOptions, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, generateAiderApprovalConfig, generateApprovalConfig, generateClaudeApprovalConfig, generateCodexApprovalConfig, generateGeminiApprovalConfig, getBaselinePatterns, getPresetDefinition, hasDynamicPatterns, listPresets, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };