coding-agent-adapters 0.2.3 → 0.2.5

package/dist/index.d.cts

@@ -30,6 +30,15 @@ interface InstallationInfo {
     /** Minimum required version (if known) */
     minVersion?: string;
 }
+/**
+ * Model tier recommendations for an adapter
+ */
+interface ModelRecommendations {
+    /** Most capable model for complex tasks */
+    powerful: string;
+    /** Fastest/cheapest model for simple tasks */
+    fast: string;
+}
 /**
  * Extended config with credentials and mode support
  */
@@ -40,6 +49,12 @@ interface CodingAgentConfig extends SpawnConfig {
          * Use this when you want the full interactive CLI experience.
          */
         interactive?: boolean;
+        /**
+         * Preferred provider for multi-provider adapters (e.g., Aider).
+         * Only the API key for this provider is passed, letting the CLI
+         * pick its best model for that provider automatically.
+         */
+        provider?: 'anthropic' | 'openai' | 'google';
     } & Record<string, unknown>;
 }
 /**
@@ -59,6 +74,11 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * When true, skip non-interactive flags (--print, --quiet, etc.)
      */
     protected isInteractive(config: SpawnConfig): boolean;
+    /**
+     * Get recommended models for this adapter.
+     * Returns powerful (most capable) and fast (cheapest/fastest) model names.
+     */
+    abstract getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     /**
      * Override detectExit to include installation instructions
      */
@@ -96,6 +116,7 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
      * These handle common prompts that can be safely auto-responded.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -120,6 +141,7 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     readonly adapterType = "gemini";
     readonly displayName = "Google Gemini";
     readonly installation: InstallationInfo;
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -145,6 +167,7 @@ declare class CodexAdapter extends BaseCodingAdapter {
      * Auto-response rules for OpenAI Codex CLI.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -174,6 +197,7 @@ declare class AiderAdapter extends BaseCodingAdapter {
      * Auto-response rules for Aider CLI.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -185,6 +209,73 @@ 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
+ *
+ * Loads adapter patterns from @parallax/adapter-monitor snapshots when available,
+ * with fallback to hardcoded baseline patterns.
+ */
+
+/**
+ * Pattern set for an adapter
+ */
+interface AdapterPatterns {
+    /** Ready state detection patterns */
+    ready: string[];
+    /** Auth/login detection patterns */
+    auth: string[];
+    /** Blocking prompt detection patterns */
+    blocking: string[];
+    /** Source of patterns */
+    source: 'snapshot' | 'baseline';
+    /** Version these patterns are from (if from snapshot) */
+    version?: string;
+}
+/**
+ * Load patterns for an adapter
+ *
+ * Tries to load from @parallax/adapter-monitor snapshots first,
+ * falls back to hardcoded baseline patterns.
+ *
+ * @param adapter - Adapter type
+ * @param version - Optional specific CLI version to load patterns for
+ * @param forceRefresh - Skip cache and reload
+ */
+declare function loadPatterns(adapter: AdapterType, version?: string, forceRefresh?: boolean): Promise<AdapterPatterns>;
+/**
+ * Load patterns synchronously (uses cache or baseline only)
+ *
+ * Use this in constructors or synchronous code paths.
+ * For best results, call loadPatterns() asynchronously during init.
+ */
+declare function loadPatternsSync(adapter: AdapterType): AdapterPatterns;
+/**
+ * Preload patterns for all adapters
+ *
+ * Call this during application startup to warm the cache.
+ */
+declare function preloadAllPatterns(): Promise<void>;
+/**
+ * Clear the pattern cache
+ */
+declare function clearPatternCache(): void;
+/**
+ * Get baseline patterns (always available, no async)
+ */
+declare function getBaselinePatterns(adapter: AdapterType): AdapterPatterns;
+/**
+ * Check if dynamic patterns are available
+ */
+declare function hasDynamicPatterns(adapter: AdapterType): Promise<boolean>;
+
 /**
  * coding-agent-adapters
  *
@@ -227,16 +318,8 @@ declare class AiderAdapter extends BaseCodingAdapter {
  * Create instances of all available adapters
  */
 declare function createAllAdapters(): (ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter)[];
-/**
- * Adapter type to class mapping
- */
-declare const ADAPTER_TYPES: {
-    readonly claude: typeof ClaudeAdapter;
-    readonly gemini: typeof GeminiAdapter;
-    readonly codex: typeof CodexAdapter;
-    readonly aider: typeof AiderAdapter;
-};
-type AdapterType = keyof typeof ADAPTER_TYPES;
+
+declare const ADAPTER_TYPES: Record<AdapterType, typeof ClaudeAdapter | typeof GeminiAdapter | typeof CodexAdapter | typeof AiderAdapter>;
 /**
  * Create a specific adapter by type
  */
@@ -288,4 +371,4 @@ declare function checkAllAdapters(): Promise<PreflightResult[]>;
  */
 declare function printMissingAdapters(types?: AdapterType[]): Promise<void>;
 
-export { ADAPTER_TYPES, type AdapterType, type AgentCredentials, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GeminiAdapter, type InstallationInfo, type PreflightResult, checkAdapters, checkAllAdapters, createAdapter, createAllAdapters, printMissingAdapters };
+export { ADAPTER_TYPES, type AdapterPatterns, type AdapterType, type AgentCredentials, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GeminiAdapter, type InstallationInfo, type ModelRecommendations, type PreflightResult, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, getBaselinePatterns, hasDynamicPatterns, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };

package/dist/index.d.ts

@@ -30,6 +30,15 @@ interface InstallationInfo {
     /** Minimum required version (if known) */
     minVersion?: string;
 }
+/**
+ * Model tier recommendations for an adapter
+ */
+interface ModelRecommendations {
+    /** Most capable model for complex tasks */
+    powerful: string;
+    /** Fastest/cheapest model for simple tasks */
+    fast: string;
+}
 /**
  * Extended config with credentials and mode support
  */
@@ -40,6 +49,12 @@ interface CodingAgentConfig extends SpawnConfig {
          * Use this when you want the full interactive CLI experience.
          */
         interactive?: boolean;
+        /**
+         * Preferred provider for multi-provider adapters (e.g., Aider).
+         * Only the API key for this provider is passed, letting the CLI
+         * pick its best model for that provider automatically.
+         */
+        provider?: 'anthropic' | 'openai' | 'google';
     } & Record<string, unknown>;
 }
 /**
@@ -59,6 +74,11 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * When true, skip non-interactive flags (--print, --quiet, etc.)
      */
     protected isInteractive(config: SpawnConfig): boolean;
+    /**
+     * Get recommended models for this adapter.
+     * Returns powerful (most capable) and fast (cheapest/fastest) model names.
+     */
+    abstract getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     /**
      * Override detectExit to include installation instructions
      */
@@ -96,6 +116,7 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
      * These handle common prompts that can be safely auto-responded.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -120,6 +141,7 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     readonly adapterType = "gemini";
     readonly displayName = "Google Gemini";
     readonly installation: InstallationInfo;
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -145,6 +167,7 @@ declare class CodexAdapter extends BaseCodingAdapter {
      * Auto-response rules for OpenAI Codex CLI.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -174,6 +197,7 @@ declare class AiderAdapter extends BaseCodingAdapter {
      * Auto-response rules for Aider CLI.
      */
     readonly autoResponseRules: AutoResponseRule[];
+    getRecommendedModels(credentials?: AgentCredentials): ModelRecommendations;
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
@@ -185,6 +209,73 @@ 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
+ *
+ * Loads adapter patterns from @parallax/adapter-monitor snapshots when available,
+ * with fallback to hardcoded baseline patterns.
+ */
+
+/**
+ * Pattern set for an adapter
+ */
+interface AdapterPatterns {
+    /** Ready state detection patterns */
+    ready: string[];
+    /** Auth/login detection patterns */
+    auth: string[];
+    /** Blocking prompt detection patterns */
+    blocking: string[];
+    /** Source of patterns */
+    source: 'snapshot' | 'baseline';
+    /** Version these patterns are from (if from snapshot) */
+    version?: string;
+}
+/**
+ * Load patterns for an adapter
+ *
+ * Tries to load from @parallax/adapter-monitor snapshots first,
+ * falls back to hardcoded baseline patterns.
+ *
+ * @param adapter - Adapter type
+ * @param version - Optional specific CLI version to load patterns for
+ * @param forceRefresh - Skip cache and reload
+ */
+declare function loadPatterns(adapter: AdapterType, version?: string, forceRefresh?: boolean): Promise<AdapterPatterns>;
+/**
+ * Load patterns synchronously (uses cache or baseline only)
+ *
+ * Use this in constructors or synchronous code paths.
+ * For best results, call loadPatterns() asynchronously during init.
+ */
+declare function loadPatternsSync(adapter: AdapterType): AdapterPatterns;
+/**
+ * Preload patterns for all adapters
+ *
+ * Call this during application startup to warm the cache.
+ */
+declare function preloadAllPatterns(): Promise<void>;
+/**
+ * Clear the pattern cache
+ */
+declare function clearPatternCache(): void;
+/**
+ * Get baseline patterns (always available, no async)
+ */
+declare function getBaselinePatterns(adapter: AdapterType): AdapterPatterns;
+/**
+ * Check if dynamic patterns are available
+ */
+declare function hasDynamicPatterns(adapter: AdapterType): Promise<boolean>;
+
 /**
  * coding-agent-adapters
  *
@@ -227,16 +318,8 @@ declare class AiderAdapter extends BaseCodingAdapter {
  * Create instances of all available adapters
  */
 declare function createAllAdapters(): (ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter)[];
-/**
- * Adapter type to class mapping
- */
-declare const ADAPTER_TYPES: {
-    readonly claude: typeof ClaudeAdapter;
-    readonly gemini: typeof GeminiAdapter;
-    readonly codex: typeof CodexAdapter;
-    readonly aider: typeof AiderAdapter;
-};
-type AdapterType = keyof typeof ADAPTER_TYPES;
+
+declare const ADAPTER_TYPES: Record<AdapterType, typeof ClaudeAdapter | typeof GeminiAdapter | typeof CodexAdapter | typeof AiderAdapter>;
 /**
  * Create a specific adapter by type
  */
@@ -288,4 +371,4 @@ declare function checkAllAdapters(): Promise<PreflightResult[]>;
  */
 declare function printMissingAdapters(types?: AdapterType[]): Promise<void>;
 
-export { ADAPTER_TYPES, type AdapterType, type AgentCredentials, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GeminiAdapter, type InstallationInfo, type PreflightResult, checkAdapters, checkAllAdapters, createAdapter, createAllAdapters, printMissingAdapters };
+export { ADAPTER_TYPES, type AdapterPatterns, type AdapterType, type AgentCredentials, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, type CodingAgentConfig, GeminiAdapter, type InstallationInfo, type ModelRecommendations, type PreflightResult, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, getBaselinePatterns, hasDynamicPatterns, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };

package/dist/index.js

@@ -141,6 +141,12 @@ var ClaudeAdapter = class extends BaseCodingAdapter {
       safe: true
     }
   ];
+  getRecommendedModels(_credentials) {
+    return {
+      powerful: "claude-sonnet-4-20250514",
+      fast: "claude-haiku-4-5-20251001"
+    };
+  }
   getCommand() {
     return "claude";
   }
@@ -204,6 +210,15 @@ var ClaudeAdapter = class extends BaseCodingAdapter {
         instructions: loginDetection.instructions
       };
     }
+    if (/Do you want to|wants? (your )?permission|needs your permission/i.test(stripped)) {
+      return {
+        detected: true,
+        type: "permission",
+        prompt: "Claude tool permission",
+        canAutoRespond: false,
+        instructions: "Claude is asking permission to use a tool"
+      };
+    }
     if (/choose.*model|select.*model|available models/i.test(stripped) && /\d+\)|claude-/i.test(stripped)) {
       return {
         detected: true,
@@ -286,6 +301,12 @@ var GeminiAdapter = class extends BaseCodingAdapter {
     ],
     docsUrl: "https://github.com/anthropics/gemini-cli#installation"
   };
+  getRecommendedModels(_credentials) {
+    return {
+      powerful: "gemini-2.5-pro",
+      fast: "gemini-2.5-flash"
+    };
+  }
   getCommand() {
     return "gemini";
   }
@@ -355,6 +376,15 @@ var GeminiAdapter = class extends BaseCodingAdapter {
         instructions: loginDetection.instructions
       };
     }
+    if (/Apply this change\?/i.test(stripped) || /Waiting for user confirmation/i.test(stripped)) {
+      return {
+        detected: true,
+        type: "permission",
+        prompt: "Gemini tool execution confirmation",
+        canAutoRespond: false,
+        instructions: "Gemini is asking to apply a change (file write, shell command, etc.)"
+      };
+    }
     if (/select.*model|choose.*model|gemini-/i.test(stripped) && /\d+\)/i.test(stripped)) {
       return {
         detected: true,
@@ -460,6 +490,12 @@ var CodexAdapter = class extends BaseCodingAdapter {
       safe: true
     }
   ];
+  getRecommendedModels(_credentials) {
+    return {
+      powerful: "o3",
+      fast: "gpt-4o-mini"
+    };
+  }
   getCommand() {
     return "codex";
   }
@@ -622,6 +658,30 @@ var AiderAdapter = class extends BaseCodingAdapter {
       safe: true
     }
   ];
+  getRecommendedModels(credentials) {
+    if (credentials?.anthropicKey) {
+      return {
+        powerful: "anthropic/claude-sonnet-4-20250514",
+        fast: "anthropic/claude-haiku-4-5-20251001"
+      };
+    }
+    if (credentials?.openaiKey) {
+      return {
+        powerful: "openai/o3",
+        fast: "openai/gpt-4o-mini"
+      };
+    }
+    if (credentials?.googleKey) {
+      return {
+        powerful: "gemini/gemini-2.5-pro",
+        fast: "gemini/gemini-2.5-flash"
+      };
+    }
+    return {
+      powerful: "anthropic/claude-sonnet-4-20250514",
+      fast: "anthropic/claude-haiku-4-5-20251001"
+    };
+  }
   getCommand() {
     return "aider";
   }
@@ -632,27 +692,24 @@ var AiderAdapter = class extends BaseCodingAdapter {
       args.push("--no-pretty");
       args.push("--no-show-diffs");
     }
-    const credentials = this.getCredentials(config);
+    const provider = config.adapterConfig?.provider;
     if (config.env?.AIDER_MODEL) {
       args.push("--model", config.env.AIDER_MODEL);
+    } else if (provider === "anthropic") {
+      args.push("--model", "sonnet");
+    } else if (provider === "openai") {
+      args.push("--model", "4o");
+    } else if (provider === "google") {
+      args.push("--model", "gemini");
     }
-    if (credentials.anthropicKey && !config.env?.AIDER_MODEL) {
-      args.push("--model", "claude-3-5-sonnet-20241022");
-    }
+    const credentials = this.getCredentials(config);
+    if (credentials.anthropicKey) args.push("--api-key", `anthropic=${credentials.anthropicKey}`);
+    if (credentials.openaiKey) args.push("--api-key", `openai=${credentials.openaiKey}`);
+    if (credentials.googleKey) args.push("--api-key", `google=${credentials.googleKey}`);
     return args;
   }
   getEnv(config) {
     const env = {};
-    const credentials = this.getCredentials(config);
-    if (credentials.anthropicKey) {
-      env.ANTHROPIC_API_KEY = credentials.anthropicKey;
-    }
-    if (credentials.openaiKey) {
-      env.OPENAI_API_KEY = credentials.openaiKey;
-    }
-    if (credentials.googleKey) {
-      env.GOOGLE_API_KEY = credentials.googleKey;
-    }
     if (!this.isInteractive(config)) {
       env.NO_COLOR = "1";
     }
@@ -754,6 +811,144 @@ var AiderAdapter = class extends BaseCodingAdapter {
   }
 };
 
+// src/pattern-loader.ts
+var BASELINE_PATTERNS = {
+  claude: {
+    ready: [
+      "Claude Code",
+      "How can I help",
+      "What would you like",
+      "Ready"
+    ],
+    auth: [
+      "ANTHROPIC_API_KEY",
+      "API key not found",
+      "authentication required",
+      "Please sign in",
+      "Invalid API key"
+    ],
+    blocking: [
+      "update available",
+      "[y/n]"
+    ],
+    source: "baseline"
+  },
+  gemini: {
+    ready: [
+      "Type your message",
+      "How can I help",
+      "What would you like",
+      "Ready"
+    ],
+    auth: [
+      "GOOGLE_API_KEY",
+      "GEMINI_API_KEY",
+      "API key not found",
+      "Sign in with Google",
+      "gcloud auth",
+      "Application Default Credentials"
+    ],
+    blocking: [
+      "update available",
+      "[y/n]"
+    ],
+    source: "baseline"
+  },
+  codex: {
+    ready: [
+      "Codex",
+      "How can I help",
+      "Ready"
+    ],
+    auth: [
+      "OPENAI_API_KEY",
+      "API key not found",
+      "Unauthorized",
+      "Invalid API key"
+    ],
+    blocking: [
+      "update available",
+      "[y/n]"
+    ],
+    source: "baseline"
+  },
+  aider: {
+    ready: [
+      "Aider",
+      "What would you like",
+      "Ready"
+    ],
+    auth: [
+      "API key",
+      "OPENAI_API_KEY",
+      "ANTHROPIC_API_KEY",
+      "No API key"
+    ],
+    blocking: [
+      "(Y)es/(N)o",
+      "[y/n]"
+    ],
+    source: "baseline"
+  }
+};
+var patternCache = /* @__PURE__ */ new Map();
+async function tryLoadFromMonitor(adapter, version) {
+  try {
+    const moduleName = "agent-adapter-monitor";
+    const monitor = await import(
+      /* webpackIgnore: true */
+      moduleName
+    );
+    const patterns = version ? await monitor.getPatternsForVersion(adapter, version) : await monitor.getPatternsForVersion(adapter, "latest");
+    if (patterns) {
+      return {
+        ready: patterns.readyPatterns || [],
+        auth: patterns.authPatterns || [],
+        blocking: patterns.blockingPatterns || [],
+        source: "snapshot",
+        version: patterns.version
+      };
+    }
+  } catch {
+  }
+  return null;
+}
+async function loadPatterns(adapter, version, forceRefresh = false) {
+  const cacheKey = `${adapter}:${version || "latest"}`;
+  if (!forceRefresh && patternCache.has(cacheKey)) {
+    return patternCache.get(cacheKey);
+  }
+  const monitorPatterns = await tryLoadFromMonitor(adapter, version);
+  if (monitorPatterns && monitorPatterns.ready.length > 0) {
+    patternCache.set(cacheKey, monitorPatterns);
+    return monitorPatterns;
+  }
+  const baseline = BASELINE_PATTERNS[adapter];
+  patternCache.set(cacheKey, baseline);
+  return baseline;
+}
+function loadPatternsSync(adapter) {
+  const cacheKey = `${adapter}:latest`;
+  if (patternCache.has(cacheKey)) {
+    return patternCache.get(cacheKey);
+  }
+  return BASELINE_PATTERNS[adapter];
+}
+async function preloadAllPatterns() {
+  const adapters = ["claude", "gemini", "codex", "aider"];
+  await Promise.all(adapters.map((adapter) => loadPatterns(adapter)));
+}
+function clearPatternCache() {
+  patternCache.clear();
+}
+function getBaselinePatterns(adapter) {
+  return BASELINE_PATTERNS[adapter];
+}
+async function hasDynamicPatterns(adapter) {
+  const patterns = await tryLoadFromMonitor(adapter);
+  return patterns !== null;
+}
+
 // src/index.ts
 function createAllAdapters() {
   return [
@@ -814,6 +1009,6 @@ async function printMissingAdapters(types) {
   }
 }
 
-export { ADAPTER_TYPES, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, GeminiAdapter, checkAdapters, checkAllAdapters, createAdapter, createAllAdapters, printMissingAdapters };
+export { ADAPTER_TYPES, AiderAdapter, BaseCodingAdapter, ClaudeAdapter, CodexAdapter, GeminiAdapter, checkAdapters, checkAllAdapters, clearPatternCache, createAdapter, createAllAdapters, getBaselinePatterns, hasDynamicPatterns, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map