coding-agent-adapters 0.11.0 → 0.12.0

package/dist/index.d.cts

@@ -44,6 +44,7 @@ declare function generateClaudeApprovalConfig(preset: ApprovalPreset): ApprovalC
 declare function generateGeminiApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
 declare function generateCodexApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
 declare function generateAiderApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateHermesApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
 declare function generateApprovalConfig(adapterType: AdapterType, preset: ApprovalPreset): ApprovalConfig;
 declare function listPresets(): PresetDefinition[];
 declare function getPresetDefinition(preset: ApprovalPreset): PresetDefinition;
@@ -58,7 +59,7 @@ declare function getPresetDefinition(preset: ApprovalPreset): PresetDefinition;
 /**
  * Supported adapter types
  */
-type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider';
+type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider' | 'hermes';
 /**
  * Credentials that can be passed via SpawnConfig.adapterConfig
  */
@@ -137,6 +138,24 @@ interface CodingAgentConfig extends SpawnConfig {
          * Translates to CLI-specific config files and flags.
          */
         approvalPreset?: ApprovalPreset;
+        /**
+         * Claude-only: enable hook marker telemetry parsing.
+         * Requires Claude hook config that emits PARALLAX_CLAUDE_HOOK lines.
+         */
+        claudeHookTelemetry?: boolean;
+        /**
+         * Claude-only: override hook marker prefix token.
+         */
+        claudeHookMarkerPrefix?: string;
+        /**
+         * Gemini-only: enable hook marker telemetry parsing.
+         * Requires Gemini hook config that emits PARALLAX_GEMINI_HOOK markers.
+         */
+        geminiHookTelemetry?: boolean;
+        /**
+         * Gemini-only: override hook marker prefix token.
+         */
+        geminiHookMarkerPrefix?: string;
     } & Record<string, unknown>;
 }
 /**
@@ -196,6 +215,21 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * detectReady / detectTaskComplete.
      */
     protected stripAnsi(str: string): string;
+    /**
+     * Generate hook telemetry protocol configuration.
+     * Returns null by default — only Claude adapter supports hooks.
+     */
+    getHookTelemetryProtocol(_options?: {
+        scriptPath?: string;
+        markerPrefix?: string;
+        httpUrl?: string;
+        sessionId?: string;
+    }): {
+        markerPrefix: string;
+        scriptPath: string;
+        scriptContent: string;
+        settingsHooks: Record<string, unknown>;
+    } | null;
     /**
      * Override detectExit to include installation instructions
      */
@@ -278,6 +312,20 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
     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
@@ -318,6 +366,11 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
     parseOutput(output: string): ParsedOutput | null;
     getPromptPattern(): RegExp;
     getHealthCheckCommand(): string;
+    detectExit(output: string): {
+        exited: boolean;
+        code?: number;
+        error?: string;
+    };
 }
 
 /**
@@ -341,6 +394,18 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
+    getHookTelemetryProtocol(options?: {
+        scriptPath?: string;
+        markerPrefix?: string;
+    }): {
+        markerPrefix: string;
+        scriptPath: string;
+        scriptContent: string;
+        settingsHooks: Record<string, unknown>;
+    };
+    private getHookMarkers;
+    private getLatestHookMarker;
+    private stripHookMarkers;
     detectLogin(output: string): LoginDetection;
     detectBlockingPrompt(output: string): BlockingPromptDetection;
     /**
@@ -351,6 +416,7 @@ declare class GeminiAdapter extends BaseCodingAdapter {
      *   - gemini_active_waiting_user_confirmation: "Waiting for user confirmation..."
      */
     detectLoading(output: string): boolean;
+    detectToolRunning(output: string): ToolRunningInfo | null;
     /**
      * Detect task completion for Gemini CLI.
      *
@@ -511,6 +577,38 @@ declare class AiderAdapter extends BaseCodingAdapter {
     getHealthCheckCommand(): string;
 }
 
+/**
+ * Hermes Agent CLI Adapter
+ *
+ * Adapter for the Hermes Agent CLI tool.
+ */
+
+declare class HermesAdapter extends BaseCodingAdapter {
+    readonly adapterType = "hermes";
+    readonly displayName = "Hermes Agent";
+    /** Prompt-toolkit TUI + spinner rendering needs a slightly longer settle. */
+    readonly readySettleMs: number;
+    readonly installation: InstallationInfo;
+    getWorkspaceFiles(): AgentFileDescriptor[];
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
+    getCommand(): string;
+    getArgs(_config: SpawnConfig): string[];
+    getEnv(config: SpawnConfig): Record<string, string>;
+    detectLogin(output: string): LoginDetection;
+    detectBlockingPrompt(output: string): BlockingPromptDetection;
+    detectLoading(output: string): boolean;
+    detectTaskComplete(output: string): boolean;
+    detectReady(output: string): boolean;
+    parseOutput(output: string): ParsedOutput | null;
+    getPromptPattern(): RegExp;
+    detectExit(output: string): {
+        exited: boolean;
+        code?: number;
+        error?: string;
+    };
+    getHealthCheckCommand(): string;
+}
+
 /**
  * Dynamic Pattern Loader
  *
@@ -619,13 +717,13 @@ declare function hasDynamicPatterns(adapter: AdapterType): Promise<boolean>;
 /**
  * Create instances of all available adapters
  */
-declare function createAllAdapters(): (ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter)[];
+declare function createAllAdapters(): (ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter | HermesAdapter)[];
 
-declare const ADAPTER_TYPES: Record<AdapterType, typeof ClaudeAdapter | typeof GeminiAdapter | typeof CodexAdapter | typeof AiderAdapter>;
+declare const ADAPTER_TYPES: Record<AdapterType, typeof ClaudeAdapter | typeof GeminiAdapter | typeof CodexAdapter | typeof AiderAdapter | typeof HermesAdapter>;
 /**
  * Create a specific adapter by type
  */
-declare function createAdapter(type: AdapterType): ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter;
+declare function createAdapter(type: AdapterType): ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter | HermesAdapter;
 /**
  * Result of checking if a CLI is installed
  */
@@ -673,4 +771,4 @@ declare function checkAllAdapters(): Promise<PreflightResult[]>;
  */
 declare function printMissingAdapters(types?: AdapterType[]): Promise<void>;
 
-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 };
+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, HermesAdapter, 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, generateHermesApprovalConfig, getBaselinePatterns, getPresetDefinition, hasDynamicPatterns, listPresets, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };

package/dist/index.d.ts

@@ -44,6 +44,7 @@ declare function generateClaudeApprovalConfig(preset: ApprovalPreset): ApprovalC
 declare function generateGeminiApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
 declare function generateCodexApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
 declare function generateAiderApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
+declare function generateHermesApprovalConfig(preset: ApprovalPreset): ApprovalConfig;
 declare function generateApprovalConfig(adapterType: AdapterType, preset: ApprovalPreset): ApprovalConfig;
 declare function listPresets(): PresetDefinition[];
 declare function getPresetDefinition(preset: ApprovalPreset): PresetDefinition;
@@ -58,7 +59,7 @@ declare function getPresetDefinition(preset: ApprovalPreset): PresetDefinition;
 /**
  * Supported adapter types
  */
-type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider';
+type AdapterType = 'claude' | 'gemini' | 'codex' | 'aider' | 'hermes';
 /**
  * Credentials that can be passed via SpawnConfig.adapterConfig
  */
@@ -137,6 +138,24 @@ interface CodingAgentConfig extends SpawnConfig {
          * Translates to CLI-specific config files and flags.
          */
         approvalPreset?: ApprovalPreset;
+        /**
+         * Claude-only: enable hook marker telemetry parsing.
+         * Requires Claude hook config that emits PARALLAX_CLAUDE_HOOK lines.
+         */
+        claudeHookTelemetry?: boolean;
+        /**
+         * Claude-only: override hook marker prefix token.
+         */
+        claudeHookMarkerPrefix?: string;
+        /**
+         * Gemini-only: enable hook marker telemetry parsing.
+         * Requires Gemini hook config that emits PARALLAX_GEMINI_HOOK markers.
+         */
+        geminiHookTelemetry?: boolean;
+        /**
+         * Gemini-only: override hook marker prefix token.
+         */
+        geminiHookMarkerPrefix?: string;
     } & Record<string, unknown>;
 }
 /**
@@ -196,6 +215,21 @@ declare abstract class BaseCodingAdapter extends BaseCLIAdapter {
      * detectReady / detectTaskComplete.
      */
     protected stripAnsi(str: string): string;
+    /**
+     * Generate hook telemetry protocol configuration.
+     * Returns null by default — only Claude adapter supports hooks.
+     */
+    getHookTelemetryProtocol(_options?: {
+        scriptPath?: string;
+        markerPrefix?: string;
+        httpUrl?: string;
+        sessionId?: string;
+    }): {
+        markerPrefix: string;
+        scriptPath: string;
+        scriptContent: string;
+        settingsHooks: Record<string, unknown>;
+    } | null;
     /**
      * Override detectExit to include installation instructions
      */
@@ -278,6 +312,20 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
     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
@@ -318,6 +366,11 @@ declare class ClaudeAdapter extends BaseCodingAdapter {
     parseOutput(output: string): ParsedOutput | null;
     getPromptPattern(): RegExp;
     getHealthCheckCommand(): string;
+    detectExit(output: string): {
+        exited: boolean;
+        code?: number;
+        error?: string;
+    };
 }
 
 /**
@@ -341,6 +394,18 @@ declare class GeminiAdapter extends BaseCodingAdapter {
     getCommand(): string;
     getArgs(config: SpawnConfig): string[];
     getEnv(config: SpawnConfig): Record<string, string>;
+    getHookTelemetryProtocol(options?: {
+        scriptPath?: string;
+        markerPrefix?: string;
+    }): {
+        markerPrefix: string;
+        scriptPath: string;
+        scriptContent: string;
+        settingsHooks: Record<string, unknown>;
+    };
+    private getHookMarkers;
+    private getLatestHookMarker;
+    private stripHookMarkers;
     detectLogin(output: string): LoginDetection;
     detectBlockingPrompt(output: string): BlockingPromptDetection;
     /**
@@ -351,6 +416,7 @@ declare class GeminiAdapter extends BaseCodingAdapter {
      *   - gemini_active_waiting_user_confirmation: "Waiting for user confirmation..."
      */
     detectLoading(output: string): boolean;
+    detectToolRunning(output: string): ToolRunningInfo | null;
     /**
      * Detect task completion for Gemini CLI.
      *
@@ -511,6 +577,38 @@ declare class AiderAdapter extends BaseCodingAdapter {
     getHealthCheckCommand(): string;
 }
 
+/**
+ * Hermes Agent CLI Adapter
+ *
+ * Adapter for the Hermes Agent CLI tool.
+ */
+
+declare class HermesAdapter extends BaseCodingAdapter {
+    readonly adapterType = "hermes";
+    readonly displayName = "Hermes Agent";
+    /** Prompt-toolkit TUI + spinner rendering needs a slightly longer settle. */
+    readonly readySettleMs: number;
+    readonly installation: InstallationInfo;
+    getWorkspaceFiles(): AgentFileDescriptor[];
+    getRecommendedModels(_credentials?: AgentCredentials): ModelRecommendations;
+    getCommand(): string;
+    getArgs(_config: SpawnConfig): string[];
+    getEnv(config: SpawnConfig): Record<string, string>;
+    detectLogin(output: string): LoginDetection;
+    detectBlockingPrompt(output: string): BlockingPromptDetection;
+    detectLoading(output: string): boolean;
+    detectTaskComplete(output: string): boolean;
+    detectReady(output: string): boolean;
+    parseOutput(output: string): ParsedOutput | null;
+    getPromptPattern(): RegExp;
+    detectExit(output: string): {
+        exited: boolean;
+        code?: number;
+        error?: string;
+    };
+    getHealthCheckCommand(): string;
+}
+
 /**
  * Dynamic Pattern Loader
  *
@@ -619,13 +717,13 @@ declare function hasDynamicPatterns(adapter: AdapterType): Promise<boolean>;
 /**
  * Create instances of all available adapters
  */
-declare function createAllAdapters(): (ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter)[];
+declare function createAllAdapters(): (ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter | HermesAdapter)[];
 
-declare const ADAPTER_TYPES: Record<AdapterType, typeof ClaudeAdapter | typeof GeminiAdapter | typeof CodexAdapter | typeof AiderAdapter>;
+declare const ADAPTER_TYPES: Record<AdapterType, typeof ClaudeAdapter | typeof GeminiAdapter | typeof CodexAdapter | typeof AiderAdapter | typeof HermesAdapter>;
 /**
  * Create a specific adapter by type
  */
-declare function createAdapter(type: AdapterType): ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter;
+declare function createAdapter(type: AdapterType): ClaudeAdapter | GeminiAdapter | CodexAdapter | AiderAdapter | HermesAdapter;
 /**
  * Result of checking if a CLI is installed
  */
@@ -673,4 +771,4 @@ declare function checkAllAdapters(): Promise<PreflightResult[]>;
  */
 declare function printMissingAdapters(types?: AdapterType[]): Promise<void>;
 
-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 };
+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, HermesAdapter, 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, generateHermesApprovalConfig, getBaselinePatterns, getPresetDefinition, hasDynamicPatterns, listPresets, loadPatterns, loadPatternsSync, preloadAllPatterns, printMissingAdapters };