@codemieai/code 0.0.31 → 0.0.32

package/dist/hooks/executor.js

@@ -0,0 +1,415 @@
+/**
+ * Hook Executor
+ *
+ * Orchestrates execution of hooks at various lifecycle points.
+ * Handles pattern matching, deduplication, parallel execution, and timeout management.
+ */
+import crypto from 'crypto';
+import { exec } from '../utils/exec.js';
+import { logger } from '../utils/logger.js';
+import { sanitizeValue } from '../utils/security.js';
+import { HookMatcher } from './matcher.js';
+import { DecisionParser } from './decision.js';
+import { PromptHookExecutor } from './prompt-executor.js';
+/**
+ * Default timeout for hook execution (60 seconds)
+ */
+const DEFAULT_HOOK_TIMEOUT = 60000;
+/**
+ * Hook execution engine
+ * Manages lifecycle hook execution with pattern matching, deduplication, and aggregation
+ */
+export class HookExecutor {
+    /** Hooks configuration */
+    config;
+    /** Execution context (session ID, working directory, etc.) */
+    context;
+    /** Cache of executed hooks (for deduplication) */
+    executedHooks = new Set();
+    /** Prompt hook executor (for LLM-based hooks) */
+    promptExecutor = null;
+    constructor(config, context, llmConfig) {
+        this.config = config;
+        this.context = context;
+        // Initialize prompt executor if LLM config provided
+        if (llmConfig) {
+            this.promptExecutor = new PromptHookExecutor(llmConfig);
+        }
+    }
+    /**
+     * Execute PreToolUse hooks
+     * Runs before tool execution, can block or modify tool input
+     *
+     * @param toolName - Name of tool being executed
+     * @param toolInput - Tool input arguments
+     * @param toolUseId - Unique identifier for this tool use
+     * @returns Aggregated result from all matching hooks
+     */
+    async executePreToolUse(toolName, toolInput, toolUseId) {
+        logger.debug(`Executing PreToolUse hooks for tool: ${toolName}`);
+        const matchers = this.config.PreToolUse || [];
+        const matchingHooks = this.findMatchingHooks(matchers, toolName);
+        if (matchingHooks.length === 0) {
+            logger.debug(`No PreToolUse hooks matched for: ${toolName}`);
+            return this.createEmptyResult();
+        }
+        const input = {
+            hook_event_name: 'PreToolUse',
+            session_id: this.context.sessionId,
+            transcript_path: this.context.transcriptPath,
+            cwd: this.context.workingDir,
+            permission_mode: this.context.permissionMode,
+            tool_name: toolName,
+            tool_input: toolInput,
+            tool_use_id: toolUseId,
+            agent_name: this.context.agentName,
+            profile_name: this.context.profileName,
+        };
+        return this.executeHooks(matchingHooks, input);
+    }
+    /**
+     * Execute PostToolUse hooks
+     * Runs after tool completes, informational only (cannot block)
+     *
+     * @param toolName - Name of tool that was executed
+     * @param toolInput - Tool input arguments
+     * @param toolOutput - Tool output/result
+     * @param toolMetadata - Additional tool metadata
+     * @returns Aggregated result from all matching hooks
+     */
+    async executePostToolUse(toolName, toolInput, toolOutput, toolMetadata) {
+        logger.debug(`Executing PostToolUse hooks for tool: ${toolName}`);
+        const matchers = this.config.PostToolUse || [];
+        const matchingHooks = this.findMatchingHooks(matchers, toolName);
+        if (matchingHooks.length === 0) {
+            logger.debug(`No PostToolUse hooks matched for: ${toolName}`);
+            return this.createEmptyResult();
+        }
+        const input = {
+            hook_event_name: 'PostToolUse',
+            session_id: this.context.sessionId,
+            transcript_path: this.context.transcriptPath,
+            cwd: this.context.workingDir,
+            permission_mode: this.context.permissionMode,
+            tool_name: toolName,
+            tool_input: toolInput,
+            tool_output: toolOutput,
+            tool_metadata: toolMetadata,
+            agent_name: this.context.agentName,
+            profile_name: this.context.profileName,
+        };
+        return this.executeHooks(matchingHooks, input);
+    }
+    /**
+     * Execute UserPromptSubmit hooks
+     * Runs before processing user input, can block or add context
+     *
+     * @param prompt - User's prompt text
+     * @returns Aggregated result from all hooks
+     */
+    async executeUserPromptSubmit(prompt) {
+        logger.debug('Executing UserPromptSubmit hooks');
+        const matchers = this.config.UserPromptSubmit || [];
+        // UserPromptSubmit hooks don't use matchers (always run)
+        const allHooks = matchers.flatMap((m) => m.hooks);
+        if (allHooks.length === 0) {
+            logger.debug('No UserPromptSubmit hooks configured');
+            return this.createEmptyResult();
+        }
+        const input = {
+            hook_event_name: 'UserPromptSubmit',
+            session_id: this.context.sessionId,
+            transcript_path: this.context.transcriptPath,
+            cwd: this.context.workingDir,
+            permission_mode: this.context.permissionMode,
+            prompt,
+            agent_name: this.context.agentName,
+            profile_name: this.context.profileName,
+        };
+        return this.executeHooks(allHooks, input);
+    }
+    /**
+     * Execute Stop hooks
+     * Runs when agent completes, can prevent stopping and continue execution
+     *
+     * @param executionSteps - Optional array of execution steps with tool history
+     * @param stats - Optional execution statistics
+     * @returns Aggregated result from all hooks
+     */
+    async executeStop(executionSteps, stats) {
+        logger.debug('Executing Stop hooks');
+        const matchers = this.config.Stop || [];
+        // Stop hooks don't use matchers (always run)
+        const allHooks = matchers.flatMap((m) => m.hooks);
+        if (allHooks.length === 0) {
+            logger.debug('No Stop hooks configured');
+            return this.createEmptyResult();
+        }
+        // Format tool execution history from execution steps
+        const toolExecutionHistory = executionSteps
+            ?.filter((step) => step.type === 'tool_execution')
+            .map((step) => ({
+            toolName: step.toolName || 'unknown',
+            success: step.toolSuccess ?? false,
+            exitCode: step.toolMetadata?.exitCode,
+            duration: step.duration,
+            errorMessage: step.error || step.toolMetadata?.errorMessage,
+        })) || [];
+        const input = {
+            hook_event_name: 'Stop',
+            session_id: this.context.sessionId,
+            transcript_path: this.context.transcriptPath,
+            cwd: this.context.workingDir,
+            permission_mode: this.context.permissionMode,
+            agent_name: this.context.agentName,
+            profile_name: this.context.profileName,
+            tool_execution_history: toolExecutionHistory.length > 0 ? toolExecutionHistory : undefined,
+            execution_stats: stats
+                ? {
+                    totalToolCalls: stats.toolCalls,
+                    successfulTools: stats.successfulTools,
+                    failedTools: stats.failedTools,
+                }
+                : undefined,
+        };
+        return this.executeHooks(allHooks, input);
+    }
+    /**
+     * Execute SessionStart hooks
+     * Runs at the beginning of a session, can block session start and inject context
+     *
+     * @returns Aggregated result from all hooks
+     */
+    async executeSessionStart() {
+        logger.debug('Executing SessionStart hooks');
+        const matchers = this.config.SessionStart || [];
+        // SessionStart hooks don't use matchers (always run)
+        const allHooks = matchers.flatMap((m) => m.hooks);
+        if (allHooks.length === 0) {
+            logger.debug('No SessionStart hooks configured');
+            return this.createEmptyResult();
+        }
+        const input = {
+            hook_event_name: 'SessionStart',
+            session_id: this.context.sessionId,
+            transcript_path: this.context.transcriptPath,
+            cwd: this.context.workingDir,
+            permission_mode: this.context.permissionMode,
+            agent_name: this.context.agentName,
+            profile_name: this.context.profileName,
+        };
+        return this.executeHooks(allHooks, input);
+    }
+    /**
+     * Find hooks that match a tool name
+     *
+     * @param matchers - Array of hook matchers with patterns
+     * @param toolName - Tool name to match against
+     * @returns Array of matching hook configurations
+     */
+    findMatchingHooks(matchers, toolName) {
+        const matchingHooks = [];
+        for (const matcher of matchers) {
+            const pattern = matcher.matcher || '*';
+            if (HookMatcher.matches(pattern, toolName)) {
+                logger.debug(`Pattern "${pattern}" matched tool: ${toolName}`);
+                matchingHooks.push(...matcher.hooks);
+            }
+        }
+        return matchingHooks;
+    }
+    /**
+     * Execute multiple hooks in parallel with deduplication
+     *
+     * @param hooks - Hooks to execute
+     * @param input - Input data to pass to hooks
+     * @returns Aggregated result from all hooks
+     */
+    async executeHooks(hooks, input) {
+        // Deduplicate hooks by hash
+        const uniqueHooks = this.deduplicateHooks(hooks);
+        logger.debug(`Executing ${uniqueHooks.length} unique hooks (${hooks.length} total after deduplication)`);
+        // Execute hooks in parallel
+        const results = await Promise.allSettled(uniqueHooks.map((hook) => this.executeSingleHook(hook, input)));
+        // Merge results according to priority rules
+        return DecisionParser.merge(results);
+    }
+    /**
+     * Deduplicate hooks by computing hash of configuration
+     * Identical hooks (same command/prompt/timeout) run only once per event
+     *
+     * @param hooks - Hooks to deduplicate
+     * @returns Unique hooks
+     */
+    deduplicateHooks(hooks) {
+        const uniqueHooks = [];
+        const seenHashes = new Set();
+        for (const hook of hooks) {
+            const hash = this.hashHook(hook);
+            // Check if already executed in this event cycle
+            if (this.executedHooks.has(hash)) {
+                logger.debug('Skipping hook (already executed this event)');
+                continue;
+            }
+            // Check if duplicate in current batch
+            if (seenHashes.has(hash)) {
+                logger.debug('Skipping duplicate hook in batch');
+                continue;
+            }
+            seenHashes.add(hash);
+            this.executedHooks.add(hash);
+            uniqueHooks.push(hook);
+        }
+        return uniqueHooks;
+    }
+    /**
+     * Compute hash of hook configuration for deduplication
+     *
+     * @param hook - Hook configuration
+     * @returns SHA-256 hash of hook config
+     */
+    hashHook(hook) {
+        const data = JSON.stringify({
+            type: hook.type,
+            command: hook.command,
+            prompt: hook.prompt,
+            timeout: hook.timeout || DEFAULT_HOOK_TIMEOUT,
+        });
+        return crypto.createHash('sha256').update(data).digest('hex');
+    }
+    /**
+     * Execute a single hook (command or prompt)
+     *
+     * @param hook - Hook configuration
+     * @param input - Input data for hook
+     * @returns Hook result
+     */
+    async executeSingleHook(hook, input) {
+        try {
+            if (hook.type === 'command') {
+                return await this.executeCommandHook(hook, input);
+            }
+            else if (hook.type === 'prompt') {
+                return await this.executePromptHook(hook, input);
+            }
+            else {
+                logger.warn(`Unknown hook type: ${hook.type}`);
+                return { decision: 'allow', reason: `Unknown hook type: ${hook.type}` };
+            }
+        }
+        catch (error) {
+            logger.error(`Hook execution failed: ${error}`);
+            // Fail open (allow execution to continue)
+            return {
+                decision: 'allow',
+                reason: `Hook failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Execute a command hook (shell script)
+     *
+     * @param hook - Hook configuration
+     * @param input - Input data (passed as JSON via stdin)
+     * @returns Hook result parsed from stdout
+     */
+    async executeCommandHook(hook, input) {
+        if (!hook.command) {
+            throw new Error('Command hook missing required field: command');
+        }
+        logger.debug(`Executing command hook: ${hook.command}`);
+        // Build environment variables
+        const env = this.buildEnvironment(input);
+        // Sanitize input before passing to hook
+        const sanitizedInput = {
+            ...input,
+            tool_input: input.tool_input ? sanitizeValue(input.tool_input) : undefined,
+            tool_output: input.tool_output ? sanitizeValue(input.tool_output) : undefined,
+        };
+        // Prepare stdin (JSON)
+        const stdin = JSON.stringify(sanitizedInput, null, 2);
+        // Execute command with timeout
+        // Note: We're passing stdin via environment variable for now
+        // In production, we'd use a proper stdin pipe
+        const result = await exec(hook.command, [], {
+            timeout: hook.timeout || DEFAULT_HOOK_TIMEOUT,
+            env: {
+                ...env,
+                CODEMIE_HOOK_INPUT: stdin, // Pass input via env for now
+            },
+            cwd: this.context.workingDir,
+            shell: true, // Enable shell execution for proper command parsing
+        });
+        // Log raw output for debugging
+        if (result.stdout) {
+            logger.debug(`Hook stdout: ${result.stdout}`);
+        }
+        if (result.stderr) {
+            logger.debug(`Hook stderr: ${result.stderr}`);
+        }
+        // Parse result based on exit code and output
+        return DecisionParser.parse(result.stdout, result.stderr, result.code);
+    }
+    /**
+     * Execute a prompt hook (LLM-based)
+     *
+     * @param hook - Hook configuration
+     * @param input - Input data
+     * @returns Hook result
+     */
+    async executePromptHook(hook, input) {
+        if (!hook.prompt) {
+            throw new Error('Prompt hook missing required field: prompt');
+        }
+        // Check if prompt executor is available
+        if (!this.promptExecutor) {
+            logger.warn('Prompt hook requested but no LLM configuration provided, allowing by default');
+            return {
+                decision: 'allow',
+                reason: 'Prompt hooks require LLM configuration',
+            };
+        }
+        logger.debug('Executing prompt hook');
+        // Execute prompt hook via LLM
+        return this.promptExecutor.execute(hook.prompt, input);
+    }
+    /**
+     * Build environment variables for hook execution
+     *
+     * @param input - Hook input data
+     * @returns Environment variables object
+     */
+    buildEnvironment(input) {
+        return {
+            ...process.env,
+            CODEMIE_PROJECT_DIR: this.context.workingDir,
+            CODEMIE_SESSION_ID: this.context.sessionId,
+            CODEMIE_HOOK_EVENT: input.hook_event_name,
+            CODEMIE_TOOL_NAME: input.tool_name || '',
+            CODEMIE_AGENT_NAME: this.context.agentName || '',
+            CODEMIE_PROFILE_NAME: this.context.profileName || '',
+            CODEMIE_TRANSCRIPT_PATH: this.context.transcriptPath,
+            CODEMIE_PERMISSION_MODE: this.context.permissionMode,
+        };
+    }
+    /**
+     * Create empty result (no hooks executed)
+     *
+     * @returns Empty aggregated result
+     */
+    createEmptyResult() {
+        return {
+            decision: 'allow',
+            hooksExecuted: 0,
+            hooksSucceeded: 0,
+            hooksFailed: 0,
+        };
+    }
+    /**
+     * Clear executed hooks cache (for new event cycle)
+     */
+    clearCache() {
+        this.executedHooks.clear();
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/hooks/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAW1D;;GAEG;AACH,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAanC;;;GAGG;AACH,MAAM,OAAO,YAAY;IACxB,0BAA0B;IAClB,MAAM,CAAqB;IAEnC,8DAA8D;IACtD,OAAO,CAAuB;IAEtC,kDAAkD;IAC1C,aAAa,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE/C,iDAAiD;IACzC,cAAc,GAA8B,IAAI,CAAC;IAEzD,YACC,MAA0B,EAC1B,OAA6B,EAC7B,SAA+B;QAE/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,oDAAoD;QACpD,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,CAAC,cAAc,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,CAAC;QACzD,CAAC;IACF,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,iBAAiB,CACtB,QAAgB,EAChB,SAAkC,EAClC,SAAkB;QAElB,MAAM,CAAC,KAAK,CAAC,wCAAwC,QAAQ,EAAE,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEjE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,GAAc;YACxB,eAAe,EAAE,YAAY;YAC7B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,SAAS,EAAE,QAAQ;YACnB,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,SAAS;YACtB,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;SACtC,CAAC;QAEF,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,kBAAkB,CACvB,QAAgB,EAChB,SAAkC,EAClC,UAAkB,EAClB,YAAsC;QAEtC,MAAM,CAAC,KAAK,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEjE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,GAAc;YACxB,eAAe,EAAE,aAAa;YAC9B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,SAAS,EAAE,QAAQ;YACnB,UAAU,EAAE,SAAS;YACrB,WAAW,EAAE,UAAU;YACvB,aAAa,EAAE,YAAY;YAC3B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;SACtC,CAAC;QAEF,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,uBAAuB,CAAC,MAAc;QAC3C,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;QACpD,yDAAyD;QACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAElD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;YACrD,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,GAAc;YACxB,eAAe,EAAE,kBAAkB;YACnC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;SACtC,CAAC;QAEF,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CAChB,cAA2B,EAC3B,KAA2E;QAE3E,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACxC,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAElD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjC,CAAC;QAED,qDAAqD;QACrD,MAAM,oBAAoB,GACzB,cAAc;YACb,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC;aACjD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;YACpC,OAAO,EAAE,IAAI,CAAC,WAAW,IAAI,KAAK;YAClC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ;YACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,YAAY;SAC3D,CAAC,CAAC,IAAI,EAAE,CAAC;QAEZ,MAAM,KAAK,GAAc;YACxB,eAAe,EAAE,MAAM;YACvB,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;YACtC,sBAAsB,EAAE,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS;YAC1F,eAAe,EAAE,KAAK;gBACrB,CAAC,CAAC;oBACA,cAAc,EAAE,KAAK,CAAC,SAAS;oBAC/B,eAAe,EAAE,KAAK,CAAC,eAAe;oBACtC,WAAW,EAAE,KAAK,CAAC,WAAW;iBAC9B;gBACF,CAAC,CAAC,SAAS;SACZ,CAAC;QAEF,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,mBAAmB;QACxB,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;QAChD,qDAAqD;QACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAElD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,KAAK,GAAc;YACxB,eAAe,EAAE,cAAc;YAC/B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5B,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YAC5C,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAClC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;SACtC,CAAC;QAEF,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CACxB,QAA6B,EAC7B,QAAgB;QAEhB,MAAM,aAAa,GAAiB,EAAE,CAAC;QAEvC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;YACvC,IAAI,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,mBAAmB,QAAQ,EAAE,CAAC,CAAC;gBAC/D,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACF,CAAC;QAED,OAAO,aAAa,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,YAAY,CACzB,KAAmB,EACnB,KAAgB;QAEhB,4BAA4B;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,CAAC,KAAK,CACX,aAAa,WAAW,CAAC,MAAM,kBAAkB,KAAK,CAAC,MAAM,6BAA6B,CAC1F,CAAC;QAEF,4BAA4B;QAC5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAC9D,CAAC;QAEF,4CAA4C;QAC5C,OAAO,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACK,gBAAgB,CAAC,KAAmB;QAC3C,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAEjC,gDAAgD;YAChD,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;gBAC5D,SAAS;YACV,CAAC;YAED,sCAAsC;YACtC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACjD,SAAS;YACV,CAAC;YAED,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,WAAW,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACK,QAAQ,CAAC,IAAgB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,oBAAoB;SAC7C,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,iBAAiB,CAC9B,IAAgB,EAChB,KAAgB;QAEhB,IAAI,CAAC;YACJ,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACnD,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,sBAAsB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACzE,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;YAChD,0CAA0C;YAC1C,OAAO;gBACN,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAChF,CAAC;QACH,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,kBAAkB,CAC/B,IAAgB,EAChB,KAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,2BAA2B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAExD,8BAA8B;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAEzC,wCAAwC;QACxC,MAAM,cAAc,GAAG;YACtB,GAAG,KAAK;YACR,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;YAC1E,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;SAC7E,CAAC;QAEF,uBAAuB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAEtD,+BAA+B;QAC/B,6DAA6D;QAC7D,8CAA8C;QAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,CACxB,IAAI,CAAC,OAAO,EACZ,EAAE,EACF;YACC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,oBAAoB;YAC7C,GAAG,EAAE;gBACJ,GAAG,GAAG;gBACN,kBAAkB,EAAE,KAAK,EAAE,6BAA6B;aACxD;YACD,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5B,KAAK,EAAE,IAAI,EAAE,oDAAoD;SACjE,CACD,CAAC;QAEF,+BAA+B;QAC/B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,6CAA6C;QAC7C,OAAO,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,iBAAiB,CAC9B,IAAgB,EAChB,KAAgB;QAEhB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC/D,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;YAC5F,OAAO;gBACN,QAAQ,EAAE,OAAO;gBACjB,MAAM,EAAE,wCAAwC;aAChD,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAEtC,8BAA8B;QAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,KAAgB;QACxC,OAAO;YACN,GAAG,OAAO,CAAC,GAAG;YACd,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;YAC5C,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YAC1C,kBAAkB,EAAE,KAAK,CAAC,eAAe;YACzC,iBAAiB,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;YACxC,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE;YAChD,oBAAoB,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE;YACpD,uBAAuB,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;YACpD,uBAAuB,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;SACpD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,iBAAiB;QACxB,OAAO;YACN,QAAQ,EAAE,OAAO;YACjB,aAAa,EAAE,CAAC;YAChB,cAAc,EAAE,CAAC;YACjB,WAAW,EAAE,CAAC;SACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACT,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/hooks/matcher.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Hook Matcher
+ *
+ * Provides pattern matching logic for determining which hooks should execute
+ * for a given tool name. Supports literal matches, wildcards, and regex patterns.
+ */
+export declare class HookMatcher {
+    /**
+     * Check if a pattern matches a tool name
+     *
+     * @param pattern - Pattern to match (regex, wildcard *, or literal string)
+     * @param toolName - Tool name to test against pattern
+     * @returns true if pattern matches tool name
+     *
+     * @example
+     * HookMatcher.matches('*', 'Bash') // true (wildcard)
+     * HookMatcher.matches('Bash|Write', 'Bash') // true (regex)
+     * HookMatcher.matches('Bash', 'Bash') // true (literal)
+     * HookMatcher.matches('Bash', 'Read') // false
+     */
+    static matches(pattern: string, toolName: string): boolean;
+    /**
+     * Find all patterns that match a tool name
+     *
+     * @param patterns - Array of patterns to test
+     * @param toolName - Tool name to match against
+     * @returns Array of matching patterns
+     */
+    static findMatches(patterns: string[], toolName: string): string[];
+    /**
+     * Validate a pattern for common mistakes
+     *
+     * @param pattern - Pattern to validate
+     * @returns Validation result with any warnings
+     */
+    static validate(pattern: string): {
+        valid: boolean;
+        warnings: string[];
+    };
+}
+//# sourceMappingURL=matcher.d.ts.map

package/dist/hooks/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/hooks/matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qBAAa,WAAW;IACvB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IA6B1D;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAIlE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;CA8BxE"}

package/dist/hooks/matcher.js

@@ -0,0 +1,93 @@
+/**
+ * Hook Matcher
+ *
+ * Provides pattern matching logic for determining which hooks should execute
+ * for a given tool name. Supports literal matches, wildcards, and regex patterns.
+ */
+import { logger } from '../utils/logger.js';
+export class HookMatcher {
+    /**
+     * Check if a pattern matches a tool name
+     *
+     * @param pattern - Pattern to match (regex, wildcard *, or literal string)
+     * @param toolName - Tool name to test against pattern
+     * @returns true if pattern matches tool name
+     *
+     * @example
+     * HookMatcher.matches('*', 'Bash') // true (wildcard)
+     * HookMatcher.matches('Bash|Write', 'Bash') // true (regex)
+     * HookMatcher.matches('Bash', 'Bash') // true (literal)
+     * HookMatcher.matches('Bash', 'Read') // false
+     */
+    static matches(pattern, toolName) {
+        try {
+            // Handle wildcard - matches everything
+            if (pattern === '*') {
+                return true;
+            }
+            // Handle regex patterns (contains special regex characters)
+            // Common regex chars: | (alternation), [] (character class), {} (quantifier), () (group)
+            if (/[|[\]{}()]/.test(pattern)) {
+                try {
+                    // Wrap pattern with anchors to match full tool name
+                    const regex = new RegExp(`^(${pattern})$`);
+                    return regex.test(toolName);
+                }
+                catch (error) {
+                    // Invalid regex, treat as literal string
+                    logger.warn(`Invalid regex pattern "${pattern}", treating as literal: ${error}`);
+                    return pattern === toolName;
+                }
+            }
+            // Literal string match
+            return pattern === toolName;
+        }
+        catch (error) {
+            logger.error(`Error matching pattern "${pattern}" against "${toolName}": ${error}`);
+            return false;
+        }
+    }
+    /**
+     * Find all patterns that match a tool name
+     *
+     * @param patterns - Array of patterns to test
+     * @param toolName - Tool name to match against
+     * @returns Array of matching patterns
+     */
+    static findMatches(patterns, toolName) {
+        return patterns.filter((pattern) => this.matches(pattern, toolName));
+    }
+    /**
+     * Validate a pattern for common mistakes
+     *
+     * @param pattern - Pattern to validate
+     * @returns Validation result with any warnings
+     */
+    static validate(pattern) {
+        const warnings = [];
+        // Check for empty pattern
+        if (!pattern || pattern.trim() === '') {
+            return { valid: false, warnings: ['Pattern cannot be empty'] };
+        }
+        // Check for potential regex mistakes
+        if (/[|[\]{}()]/.test(pattern)) {
+            try {
+                new RegExp(`^(${pattern})$`);
+            }
+            catch (error) {
+                warnings.push(`Pattern appears to be regex but is invalid: ${error}`);
+                return { valid: false, warnings };
+            }
+            // Warn about unescaped dots (likely mistake)
+            if (/(?<!\\)\./.test(pattern)) {
+                warnings.push('Pattern contains unescaped dots (.) which match any character in regex');
+            }
+        }
+        // Warn about trailing/leading spaces
+        if (pattern !== pattern.trim()) {
+            warnings.push('Pattern contains leading/trailing spaces');
+        }
+        return { valid: true, warnings };
+    }
+}
+//# sourceMappingURL=matcher.js.map

package/dist/hooks/matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../src/hooks/matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,WAAW;IACvB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,OAAO,CAAC,OAAe,EAAE,QAAgB;QAC/C,IAAI,CAAC;YACJ,uCAAuC;YACvC,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC;YACb,CAAC;YAED,4DAA4D;YAC5D,yFAAyF;YACzF,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACJ,oDAAoD;oBACpD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC;oBAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC7B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,yCAAyC;oBACzC,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,2BAA2B,KAAK,EAAE,CAAC,CAAC;oBACjF,OAAO,OAAO,KAAK,QAAQ,CAAC;gBAC7B,CAAC;YACF,CAAC;YAED,uBAAuB;YACvB,OAAO,OAAO,KAAK,QAAQ,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,cAAc,QAAQ,MAAM,KAAK,EAAE,CAAC,CAAC;YACpF,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,QAAkB,EAAE,QAAgB;QACtD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAe;QAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,0BAA0B;QAC1B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAChE,CAAC;QAED,qCAAqC;QACrC,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACJ,IAAI,MAAM,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,QAAQ,CAAC,IAAI,CAAC,+CAA+C,KAAK,EAAE,CAAC,CAAC;gBACtE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YACnC,CAAC;YAED,6CAA6C;YAC7C,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;YACzF,CAAC;QACF,CAAC;QAED,qCAAqC;QACrC,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAClC,CAAC;CACD"}

package/dist/hooks/prompt-executor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Prompt Hook Executor
+ *
+ * Executes LLM-based hooks using prompt templates.
+ * Allows users to define hooks that call an LLM to make decisions
+ * about tool execution, user prompts, etc.
+ */
+import type { HookInput, HookResult } from './types.js';
+/**
+ * Configuration for prompt hook executor
+ */
+export interface PromptHookConfig {
+    /** LLM API key */
+    apiKey: string;
+    /** LLM base URL */
+    baseUrl?: string;
+    /** Model name (default: gpt-3.5-turbo for speed) */
+    model?: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Debug mode */
+    debug?: boolean;
+}
+/**
+ * Prompt hook executor
+ * Uses LLM to evaluate hooks based on prompt templates
+ */
+export declare class PromptHookExecutor {
+    private llm;
+    private config;
+    constructor(config: PromptHookConfig);
+    /**
+     * Execute a prompt hook
+     *
+     * @param prompt - Prompt template (can contain $ARGUMENTS placeholder)
+     * @param input - Hook input data
+     * @returns Hook result from LLM
+     */
+    execute(prompt: string, input: HookInput): Promise<HookResult>;
+    /**
+     * Resolve prompt template by replacing placeholders
+     *
+     * @param prompt - Prompt template
+     * @param input - Hook input data
+     * @returns Resolved prompt
+     */
+    private resolvePrompt;
+    /**
+     * Parse LLM response into hook result
+     * Expects JSON response, but handles plain text gracefully
+     *
+     * @param content - LLM response content
+     * @returns Parsed hook result
+     */
+    private parseResponse;
+}
+//# sourceMappingURL=prompt-executor.d.ts.map

package/dist/hooks/prompt-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-executor.d.ts","sourceRoot":"","sources":["../../src/hooks/prompt-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAmBpC;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBpE;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAsCrB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAsCrB"}