@codemieai/code 0.0.31 → 0.0.33

package/dist/hooks/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../src/hooks/decision.ts"],"names":[],"mappings":"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"}

package/dist/hooks/executor.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Hook Executor
+ *
+ * Orchestrates execution of hooks at various lifecycle points.
+ * Handles pattern matching, deduplication, parallel execution, and timeout management.
+ */
+import type { HooksConfiguration, AggregatedHookResult, HookExecutionContext } from './types.js';
+/**
+ * LLM configuration for prompt hooks
+ */
+export interface PromptHookLLMConfig {
+    apiKey: string;
+    baseUrl?: string;
+    model?: string;
+    timeout?: number;
+    debug?: boolean;
+}
+/**
+ * Hook execution engine
+ * Manages lifecycle hook execution with pattern matching, deduplication, and aggregation
+ */
+export declare class HookExecutor {
+    /** Hooks configuration */
+    private config;
+    /** Execution context (session ID, working directory, etc.) */
+    private context;
+    /** Cache of executed hooks (for deduplication) */
+    private executedHooks;
+    /** Prompt hook executor (for LLM-based hooks) */
+    private promptExecutor;
+    constructor(config: HooksConfiguration, context: HookExecutionContext, llmConfig?: PromptHookLLMConfig);
+    /**
+     * 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
+     */
+    executePreToolUse(toolName: string, toolInput: Record<string, unknown>, toolUseId?: string): Promise<AggregatedHookResult>;
+    /**
+     * 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
+     */
+    executePostToolUse(toolName: string, toolInput: Record<string, unknown>, toolOutput: string, toolMetadata?: Record<string, unknown>): Promise<AggregatedHookResult>;
+    /**
+     * 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
+     */
+    executeUserPromptSubmit(prompt: string): Promise<AggregatedHookResult>;
+    /**
+     * 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
+     */
+    executeStop(executionSteps?: Array<any>, stats?: {
+        toolCalls: number;
+        successfulTools: number;
+        failedTools: number;
+    }): Promise<AggregatedHookResult>;
+    /**
+     * Execute SessionStart hooks
+     * Runs at the beginning of a session, can block session start and inject context
+     *
+     * @returns Aggregated result from all hooks
+     */
+    executeSessionStart(): Promise<AggregatedHookResult>;
+    /**
+     * 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
+     */
+    private findMatchingHooks;
+    /**
+     * 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
+     */
+    private executeHooks;
+    /**
+     * 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
+     */
+    private deduplicateHooks;
+    /**
+     * Compute hash of hook configuration for deduplication
+     *
+     * @param hook - Hook configuration
+     * @returns SHA-256 hash of hook config
+     */
+    private hashHook;
+    /**
+     * Execute a single hook (command or prompt)
+     *
+     * @param hook - Hook configuration
+     * @param input - Input data for hook
+     * @returns Hook result
+     */
+    private executeSingleHook;
+    /**
+     * 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
+     */
+    private executeCommandHook;
+    /**
+     * Execute a prompt hook (LLM-based)
+     *
+     * @param hook - Hook configuration
+     * @param input - Input data
+     * @returns Hook result
+     */
+    private executePromptHook;
+    /**
+     * Build environment variables for hook execution
+     *
+     * @param input - Hook input data
+     * @returns Environment variables object
+     */
+    private buildEnvironment;
+    /**
+     * Create empty result (no hooks executed)
+     *
+     * @returns Empty aggregated result
+     */
+    private createEmptyResult;
+    /**
+     * Clear executed hooks cache (for new event cycle)
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/hooks/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EACX,kBAAkB,EAKlB,oBAAoB,EACpB,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACxB,0BAA0B;IAC1B,OAAO,CAAC,MAAM,CAAqB;IAEnC,8DAA8D;IAC9D,OAAO,CAAC,OAAO,CAAuB;IAEtC,kDAAkD;IAClD,OAAO,CAAC,aAAa,CAA0B;IAE/C,iDAAiD;IACjD,OAAO,CAAC,cAAc,CAAmC;gBAGxD,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,oBAAoB,EAC7B,SAAS,CAAC,EAAE,mBAAmB;IAWhC;;;;;;;;OAQG;IACG,iBAAiB,CACtB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,oBAAoB,CAAC;IA2BhC;;;;;;;;;OASG;IACG,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,oBAAoB,CAAC;IA4BhC;;;;;;OAMG;IACG,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA0B5E;;;;;;;OAOG;IACG,WAAW,CAChB,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EAC3B,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GACzE,OAAO,CAAC,oBAAoB,CAAC;IA6ChC;;;;;OAKG;IACG,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAyB1D;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;;;;;OAMG;YACW,YAAY;IAoB1B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAWhB;;;;;;OAMG;YACW,iBAAiB;IAuB/B;;;;;;OAMG;YACW,kBAAkB;IAoDhC;;;;;;OAMG;YACW,iBAAiB;IAuB/B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,UAAU,IAAI,IAAI;CAGlB"}

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":"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"}

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"}