@anthropic-field/core 0.1.0

package/dist/src/hooks/hookEventHandler.js

@@ -0,0 +1,325 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HookEventName } from './types.js';
+import { defaultHookTranslator } from './hookTranslator.js';
+import { logHookCall } from '../telemetry/loggers.js';
+import { HookCallEvent } from '../telemetry/types.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { coreEvents } from '../utils/events.js';
+/**
+ * Hook event bus that coordinates hook execution across the system
+ */
+export class HookEventHandler {
+    config;
+    hookPlanner;
+    hookRunner;
+    hookAggregator;
+    /**
+     * Track reported failures to suppress duplicate warnings during streaming.
+     * Uses a WeakMap with the original request object as a key to ensure
+     * failures are only reported once per logical model interaction.
+     */
+    reportedFailures = new WeakMap();
+    constructor(config, hookPlanner, hookRunner, hookAggregator) {
+        this.config = config;
+        this.hookPlanner = hookPlanner;
+        this.hookRunner = hookRunner;
+        this.hookAggregator = hookAggregator;
+    }
+    /**
+     * Fire a BeforeTool event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireBeforeToolEvent(toolName, toolInput, mcpContext) {
+        const input = {
+            ...this.createBaseInput(HookEventName.BeforeTool),
+            tool_name: toolName,
+            tool_input: toolInput,
+            ...(mcpContext && { mcp_context: mcpContext }),
+        };
+        const context = { toolName };
+        return this.executeHooks(HookEventName.BeforeTool, input, context);
+    }
+    /**
+     * Fire an AfterTool event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireAfterToolEvent(toolName, toolInput, toolResponse, mcpContext) {
+        const input = {
+            ...this.createBaseInput(HookEventName.AfterTool),
+            tool_name: toolName,
+            tool_input: toolInput,
+            tool_response: toolResponse,
+            ...(mcpContext && { mcp_context: mcpContext }),
+        };
+        const context = { toolName };
+        return this.executeHooks(HookEventName.AfterTool, input, context);
+    }
+    /**
+     * Fire a BeforeAgent event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireBeforeAgentEvent(prompt) {
+        const input = {
+            ...this.createBaseInput(HookEventName.BeforeAgent),
+            prompt,
+        };
+        return this.executeHooks(HookEventName.BeforeAgent, input);
+    }
+    /**
+     * Fire a Notification event
+     */
+    async fireNotificationEvent(type, message, details) {
+        const input = {
+            ...this.createBaseInput(HookEventName.Notification),
+            notification_type: type,
+            message,
+            details,
+        };
+        return this.executeHooks(HookEventName.Notification, input);
+    }
+    /**
+     * Fire an AfterAgent event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireAfterAgentEvent(prompt, promptResponse, stopHookActive = false) {
+        const input = {
+            ...this.createBaseInput(HookEventName.AfterAgent),
+            prompt,
+            prompt_response: promptResponse,
+            stop_hook_active: stopHookActive,
+        };
+        return this.executeHooks(HookEventName.AfterAgent, input);
+    }
+    /**
+     * Fire a SessionStart event
+     */
+    async fireSessionStartEvent(source) {
+        const input = {
+            ...this.createBaseInput(HookEventName.SessionStart),
+            source,
+        };
+        const context = { trigger: source };
+        return this.executeHooks(HookEventName.SessionStart, input, context);
+    }
+    /**
+     * Fire a SessionEnd event
+     */
+    async fireSessionEndEvent(reason) {
+        const input = {
+            ...this.createBaseInput(HookEventName.SessionEnd),
+            reason,
+        };
+        const context = { trigger: reason };
+        return this.executeHooks(HookEventName.SessionEnd, input, context);
+    }
+    /**
+     * Fire a PreCompress event
+     */
+    async firePreCompressEvent(trigger) {
+        const input = {
+            ...this.createBaseInput(HookEventName.PreCompress),
+            trigger,
+        };
+        const context = { trigger };
+        return this.executeHooks(HookEventName.PreCompress, input, context);
+    }
+    /**
+     * Fire a BeforeModel event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireBeforeModelEvent(llmRequest) {
+        const input = {
+            ...this.createBaseInput(HookEventName.BeforeModel),
+            llm_request: defaultHookTranslator.toHookLLMRequest(llmRequest),
+        };
+        return this.executeHooks(HookEventName.BeforeModel, input, undefined, llmRequest);
+    }
+    /**
+     * Fire an AfterModel event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireAfterModelEvent(llmRequest, llmResponse) {
+        const input = {
+            ...this.createBaseInput(HookEventName.AfterModel),
+            llm_request: defaultHookTranslator.toHookLLMRequest(llmRequest),
+            llm_response: defaultHookTranslator.toHookLLMResponse(llmResponse),
+        };
+        return this.executeHooks(HookEventName.AfterModel, input, undefined, llmRequest);
+    }
+    /**
+     * Fire a BeforeToolSelection event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireBeforeToolSelectionEvent(llmRequest) {
+        const input = {
+            ...this.createBaseInput(HookEventName.BeforeToolSelection),
+            llm_request: defaultHookTranslator.toHookLLMRequest(llmRequest),
+        };
+        return this.executeHooks(HookEventName.BeforeToolSelection, input, undefined, llmRequest);
+    }
+    /**
+     * Execute hooks for a specific event (direct execution without MessageBus)
+     * Used as fallback when MessageBus is not available
+     */
+    async executeHooks(eventName, input, context, requestContext) {
+        try {
+            // Create execution plan
+            const plan = this.hookPlanner.createExecutionPlan(eventName, context);
+            if (!plan || plan.hookConfigs.length === 0) {
+                return {
+                    success: true,
+                    allOutputs: [],
+                    errors: [],
+                    totalDuration: 0,
+                };
+            }
+            const onHookStart = (config, index) => {
+                coreEvents.emitHookStart({
+                    hookName: this.getHookName(config),
+                    eventName,
+                    hookIndex: index + 1,
+                    totalHooks: plan.hookConfigs.length,
+                });
+            };
+            const onHookEnd = (config, result) => {
+                coreEvents.emitHookEnd({
+                    hookName: this.getHookName(config),
+                    eventName,
+                    success: result.success,
+                });
+            };
+            // Execute hooks according to the plan's strategy
+            const results = plan.sequential
+                ? await this.hookRunner.executeHooksSequential(plan.hookConfigs, eventName, input, onHookStart, onHookEnd)
+                : await this.hookRunner.executeHooksParallel(plan.hookConfigs, eventName, input, onHookStart, onHookEnd);
+            // Aggregate results
+            const aggregated = this.hookAggregator.aggregateResults(results, eventName);
+            // Process common hook output fields centrally
+            this.processCommonHookOutputFields(aggregated);
+            // Log hook execution
+            this.logHookExecution(eventName, input, results, aggregated, requestContext);
+            return aggregated;
+        }
+        catch (error) {
+            debugLogger.error(`Hook event bus error for ${eventName}: ${error}`);
+            return {
+                success: false,
+                allOutputs: [],
+                errors: [error instanceof Error ? error : new Error(String(error))],
+                totalDuration: 0,
+            };
+        }
+    }
+    /**
+     * Create base hook input with common fields
+     */
+    createBaseInput(eventName) {
+        // Get the transcript path from the ChatRecordingService if available
+        const transcriptPath = this.config
+            .getGeminiClient()
+            ?.getChatRecordingService()
+            ?.getConversationFilePath() ?? '';
+        return {
+            session_id: this.config.getSessionId(),
+            transcript_path: transcriptPath,
+            cwd: this.config.getWorkingDir(),
+            hook_event_name: eventName,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * Log hook execution for observability
+     */
+    logHookExecution(eventName, input, results, aggregated, requestContext) {
+        const failedHooks = results.filter((r) => !r.success);
+        const successCount = results.length - failedHooks.length;
+        const errorCount = failedHooks.length;
+        if (errorCount > 0) {
+            const failedNames = failedHooks
+                .map((r) => this.getHookNameFromResult(r))
+                .join(', ');
+            let shouldEmit = true;
+            if (requestContext) {
+                let reportedSet = this.reportedFailures.get(requestContext);
+                if (!reportedSet) {
+                    reportedSet = new Set();
+                    this.reportedFailures.set(requestContext, reportedSet);
+                }
+                const failureKey = `${eventName}:${failedNames}`;
+                if (reportedSet.has(failureKey)) {
+                    shouldEmit = false;
+                }
+                else {
+                    reportedSet.add(failureKey);
+                }
+            }
+            debugLogger.warn(`Hook execution for ${eventName}: ${successCount} succeeded, ${errorCount} failed (${failedNames}), ` +
+                `total duration: ${aggregated.totalDuration}ms`);
+            if (shouldEmit) {
+                coreEvents.emitFeedback('warning', `Hook(s) [${failedNames}] failed for event ${eventName}. Press F12 to see the debug drawer for more details.\n`);
+            }
+        }
+        else {
+            debugLogger.debug(`Hook execution for ${eventName}: ${successCount} hooks executed successfully, ` +
+                `total duration: ${aggregated.totalDuration}ms`);
+        }
+        // Log individual hook calls to telemetry
+        for (const result of results) {
+            // Determine hook name and type for telemetry
+            const hookName = this.getHookNameFromResult(result);
+            const hookType = this.getHookTypeFromResult(result);
+            const hookCallEvent = new HookCallEvent(eventName, hookType, hookName, { ...input }, result.duration, result.success, result.output ? { ...result.output } : undefined, result.exitCode, result.stdout, result.stderr, result.error?.message);
+            logHookCall(this.config, hookCallEvent);
+        }
+        // Log individual errors
+        for (const error of aggregated.errors) {
+            debugLogger.warn(`Hook execution error: ${error.message}`);
+        }
+    }
+    /**
+     * Process common hook output fields centrally
+     */
+    processCommonHookOutputFields(aggregated) {
+        if (!aggregated.finalOutput) {
+            return;
+        }
+        // Handle systemMessage - show to user in transcript mode (not to agent)
+        const systemMessage = aggregated.finalOutput.systemMessage;
+        if (systemMessage && !aggregated.finalOutput.suppressOutput) {
+            debugLogger.warn(`Hook system message: ${systemMessage}`);
+        }
+        // Handle suppressOutput - already handled by not logging above when true
+        // Handle continue=false - this should stop the entire agent execution
+        if (aggregated.finalOutput.shouldStopExecution()) {
+            const stopReason = aggregated.finalOutput.getEffectiveReason();
+            debugLogger.log(`Hook requested to stop execution: ${stopReason}`);
+            // Note: The actual stopping of execution must be handled by integration points
+            // as they need to interpret this signal in the context of their specific workflow
+            // This is just logging the request centrally
+        }
+        // Other common fields like decision/reason are handled by specific hook output classes
+    }
+    /**
+     * Get hook name from config for display or telemetry
+     */
+    getHookName(config) {
+        return config.name || config.command || 'unknown-command';
+    }
+    /**
+     * Get hook name from execution result for telemetry
+     */
+    getHookNameFromResult(result) {
+        return this.getHookName(result.hookConfig);
+    }
+    /**
+     * Get hook type from execution result for telemetry
+     */
+    getHookTypeFromResult(result) {
+        return result.hookConfig.type;
+    }
+}
+//# sourceMappingURL=hookEventHandler.js.map

package/dist/src/hooks/hookEventHandler.js.map

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

package/dist/src/hooks/hookPlanner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { HookRegistry } from './hookRegistry.js';
+import type { HookExecutionPlan } from './types.js';
+import { type HookEventName } from './types.js';
+/**
+ * Hook planner that selects matching hooks and creates execution plans
+ */
+export declare class HookPlanner {
+    private readonly hookRegistry;
+    constructor(hookRegistry: HookRegistry);
+    /**
+     * Create execution plan for a hook event
+     */
+    createExecutionPlan(eventName: HookEventName, context?: HookEventContext): HookExecutionPlan | null;
+    /**
+     * Check if a hook entry matches the given context
+     */
+    private matchesContext;
+    /**
+     * Match tool name against matcher pattern
+     */
+    private matchesToolName;
+    /**
+     * Match trigger/source against matcher pattern
+     */
+    private matchesTrigger;
+    /**
+     * Deduplicate identical hook configurations
+     */
+    private deduplicateHooks;
+}
+/**
+ * Context information for hook event matching
+ */
+export interface HookEventContext {
+    toolName?: string;
+    trigger?: string;
+}

package/dist/src/hooks/hookPlanner.js

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getHookKey } from './types.js';
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Hook planner that selects matching hooks and creates execution plans
+ */
+export class HookPlanner {
+    hookRegistry;
+    constructor(hookRegistry) {
+        this.hookRegistry = hookRegistry;
+    }
+    /**
+     * Create execution plan for a hook event
+     */
+    createExecutionPlan(eventName, context) {
+        const hookEntries = this.hookRegistry.getHooksForEvent(eventName);
+        if (hookEntries.length === 0) {
+            return null;
+        }
+        // Filter hooks by matcher
+        const matchingEntries = hookEntries.filter((entry) => this.matchesContext(entry, context));
+        if (matchingEntries.length === 0) {
+            return null;
+        }
+        // Deduplicate identical hooks
+        const deduplicatedEntries = this.deduplicateHooks(matchingEntries);
+        // Extract hook configs
+        const hookConfigs = deduplicatedEntries.map((entry) => entry.config);
+        // Determine execution strategy - if ANY hook definition has sequential=true, run all sequentially
+        const sequential = deduplicatedEntries.some((entry) => entry.sequential === true);
+        const plan = {
+            eventName,
+            hookConfigs,
+            sequential,
+        };
+        debugLogger.debug(`Created execution plan for ${eventName}: ${hookConfigs.length} hook(s) to execute ${sequential ? 'sequentially' : 'in parallel'}`);
+        return plan;
+    }
+    /**
+     * Check if a hook entry matches the given context
+     */
+    matchesContext(entry, context) {
+        if (!entry.matcher || !context) {
+            return true; // No matcher means match all
+        }
+        const matcher = entry.matcher.trim();
+        if (matcher === '' || matcher === '*') {
+            return true; // Empty string or wildcard matches all
+        }
+        // For tool events, match against tool name
+        if (context.toolName) {
+            return this.matchesToolName(matcher, context.toolName);
+        }
+        // For other events, match against trigger/source
+        if (context.trigger) {
+            return this.matchesTrigger(matcher, context.trigger);
+        }
+        return true;
+    }
+    /**
+     * Match tool name against matcher pattern
+     */
+    matchesToolName(matcher, toolName) {
+        try {
+            // Attempt to treat the matcher as a regular expression.
+            const regex = new RegExp(matcher);
+            return regex.test(toolName);
+        }
+        catch {
+            // If it's not a valid regex, treat it as a literal string for an exact match.
+            return matcher === toolName;
+        }
+    }
+    /**
+     * Match trigger/source against matcher pattern
+     */
+    matchesTrigger(matcher, trigger) {
+        return matcher === trigger;
+    }
+    /**
+     * Deduplicate identical hook configurations
+     */
+    deduplicateHooks(entries) {
+        const seen = new Set();
+        const deduplicated = [];
+        for (const entry of entries) {
+            const key = getHookKey(entry.config);
+            if (!seen.has(key)) {
+                seen.add(key);
+                deduplicated.push(entry);
+            }
+            else {
+                debugLogger.debug(`Deduplicated hook: ${key}`);
+            }
+        }
+        return deduplicated;
+    }
+}
+//# sourceMappingURL=hookPlanner.js.map

package/dist/src/hooks/hookPlanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookPlanner.js","sourceRoot":"","sources":["../../../src/hooks/hookPlanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,WAAW;IACL,YAAY,CAAe;IAE5C,YAAY,YAA0B;QACpC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,SAAwB,EACxB,OAA0B;QAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAElE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,0BAA0B;QAC1B,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACnD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CACpC,CAAC;QAEF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8BAA8B;QAC9B,MAAM,mBAAmB,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAEnE,uBAAuB;QACvB,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAErE,kGAAkG;QAClG,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CACzC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,CACrC,CAAC;QAEF,MAAM,IAAI,GAAsB;YAC9B,SAAS;YACT,WAAW;YACX,UAAU;SACX,CAAC;QAEF,WAAW,CAAC,KAAK,CACf,8BAA8B,SAAS,KAAK,WAAW,CAAC,MAAM,uBAAuB,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,EAAE,CACnI,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,KAAwB,EACxB,OAA0B;QAE1B,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,CAAC,6BAA6B;QAC5C,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAErC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,CAAC,uCAAuC;QACtD,CAAC;QAED,2CAA2C;QAC3C,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzD,CAAC;QAED,iDAAiD;QACjD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,OAAe,EAAE,QAAgB;QACvD,IAAI,CAAC;YACH,wDAAwD;YACxD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,8EAA8E;YAC9E,OAAO,OAAO,KAAK,QAAQ,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAe,EAAE,OAAe;QACrD,OAAO,OAAO,KAAK,OAAO,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAA4B;QACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,YAAY,GAAwB,EAAE,CAAC;QAE7C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAErC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}

package/dist/src/hooks/hookRegistry.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { HookConfig } from './types.js';
+import { HookEventName, ConfigSource } from './types.js';
+/**
+ * Hook registry entry with source information
+ */
+export interface HookRegistryEntry {
+    config: HookConfig;
+    source: ConfigSource;
+    eventName: HookEventName;
+    matcher?: string;
+    sequential?: boolean;
+    enabled: boolean;
+}
+/**
+ * Hook registry that loads and validates hook definitions from multiple sources
+ */
+export declare class HookRegistry {
+    private readonly config;
+    private entries;
+    constructor(config: Config);
+    /**
+     * Initialize the registry by processing hooks from config
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get all hook entries for a specific event
+     */
+    getHooksForEvent(eventName: HookEventName): HookRegistryEntry[];
+    /**
+     * Get all registered hooks
+     */
+    getAllHooks(): HookRegistryEntry[];
+    /**
+     * Enable or disable a specific hook
+     */
+    setHookEnabled(hookName: string, enabled: boolean): void;
+    /**
+     * Get hook name for identification and display purposes
+     */
+    private getHookName;
+    /**
+     * Check for untrusted project hooks and warn the user
+     */
+    private checkProjectHooksTrust;
+    /**
+     * Process hooks from the config that was already loaded by the CLI
+     */
+    private processHooksFromConfig;
+    /**
+     * Process hooks configuration and add entries
+     */
+    private processHooksConfiguration;
+    /**
+     * Process a single hook definition
+     */
+    private processHookDefinition;
+    /**
+     * Validate a hook configuration
+     */
+    private validateHookConfig;
+    /**
+     * Check if an event name is valid
+     */
+    private isValidEventName;
+    /**
+     * Get source priority (lower number = higher priority)
+     */
+    private getSourcePriority;
+}