@aetherai/aether 0.0.3

package/dist/CLI/packages/core/src/hooks/hookEventHandler.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { HookPlanner } from './hookPlanner.js';
+import type { HookRunner } from './hookRunner.js';
+import type { HookAggregator, AggregatedHookResult } from './hookAggregator.js';
+import type { SessionStartSource, SessionEndReason, AgentType, PreCompactTrigger, NotificationType, PermissionSuggestion } from './types.js';
+import { PermissionMode } from './types.js';
+/**
+ * Hook event bus that coordinates hook execution across the system
+ */
+export declare class HookEventHandler {
+    private readonly config;
+    private readonly hookPlanner;
+    private readonly hookRunner;
+    private readonly hookAggregator;
+    constructor(config: Config, hookPlanner: HookPlanner, hookRunner: HookRunner, hookAggregator: HookAggregator);
+    /**
+     * Fire a UserPromptSubmit event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireUserPromptSubmitEvent(prompt: string, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a Stop event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireStopEvent(stopHookActive?: boolean, lastAssistantMessage?: string, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a SessionStart event
+     * Called when a new session starts or resumes
+     */
+    fireSessionStartEvent(source: SessionStartSource, model: string, permissionMode?: PermissionMode, agentType?: AgentType, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a SessionEnd event
+     * Called when a session ends
+     */
+    fireSessionEndEvent(reason: SessionEndReason, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a PreToolUse event
+     * Called before tool execution begins
+     */
+    firePreToolUseEvent(toolName: string, toolInput: Record<string, unknown>, toolUseId: string, permissionMode: PermissionMode, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a PostToolUse event
+     * Called after successful tool execution
+     */
+    firePostToolUseEvent(toolName: string, toolInput: Record<string, unknown>, toolResponse: Record<string, unknown>, toolUseId: string, permissionMode: PermissionMode, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a PostToolUseFailure event
+     * Called when tool execution fails
+     */
+    firePostToolUseFailureEvent(toolUseId: string, toolName: string, toolInput: Record<string, unknown>, errorMessage: string, isInterrupt?: boolean, permissionMode?: PermissionMode, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a PreCompact event
+     * Called before conversation compaction begins
+     */
+    firePreCompactEvent(trigger: PreCompactTrigger, customInstructions?: string, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a Notification event
+     */
+    fireNotificationEvent(message: string, notificationType: NotificationType, title?: string, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a PermissionRequest event
+     * Called when a permission dialog is about to be shown to the user
+     */
+    firePermissionRequestEvent(toolName: string, toolInput: Record<string, unknown>, permissionMode: PermissionMode, permissionSuggestions?: PermissionSuggestion[], signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a SubagentStart event
+     * Called when a subagent is spawned via the Agent tool
+     */
+    fireSubagentStartEvent(agentId: string, agentType: AgentType | string, permissionMode: PermissionMode, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Fire a SubagentStop event
+     * Called when a subagent has finished responding
+     */
+    fireSubagentStopEvent(agentId: string, agentType: AgentType | string, agentTranscriptPath: string, lastAssistantMessage: string, stopHookActive: boolean, permissionMode: PermissionMode, signal?: AbortSignal): Promise<AggregatedHookResult>;
+    /**
+     * Execute hooks for a specific event (direct execution without MessageBus)
+     * Used as fallback when MessageBus is not available
+     */
+    private executeHooks;
+    /**
+     * Create base hook input with common fields
+     */
+    private createBaseInput;
+    /**
+     * Process common hook output fields centrally
+     */
+    private processCommonHookOutputFields;
+    /**
+     * Log hook execution for observability
+     */
+    private logHookExecution;
+    /**
+     * Get hook name from config for display or telemetry
+     */
+    private getHookName;
+    /**
+     * Get hook name from execution result for telemetry
+     */
+    private getHookNameFromResult;
+    /**
+     * Get hook type from execution result for telemetry
+     */
+    private getHookTypeFromResult;
+}

package/dist/CLI/packages/core/src/hooks/hookEventHandler.js

@@ -0,0 +1,345 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HookEventName } from './types.js';
+import { PermissionMode } from './types.js';
+import { createDebugLogger } from '../utils/debugLogger.js';
+import { logHookCall } from '../telemetry/loggers.js';
+import { HookCallEvent } from '../telemetry/types.js';
+const debugLogger = createDebugLogger('TRUSTED_HOOKS');
+/**
+ * Hook event bus that coordinates hook execution across the system
+ */
+export class HookEventHandler {
+    config;
+    hookPlanner;
+    hookRunner;
+    hookAggregator;
+    constructor(config, hookPlanner, hookRunner, hookAggregator) {
+        this.config = config;
+        this.hookPlanner = hookPlanner;
+        this.hookRunner = hookRunner;
+        this.hookAggregator = hookAggregator;
+    }
+    /**
+     * Fire a UserPromptSubmit event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireUserPromptSubmitEvent(prompt, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.UserPromptSubmit),
+            prompt,
+        };
+        return this.executeHooks(HookEventName.UserPromptSubmit, input, undefined, signal);
+    }
+    /**
+     * Fire a Stop event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    async fireStopEvent(stopHookActive = false, lastAssistantMessage = '', signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.Stop),
+            stop_hook_active: stopHookActive,
+            last_assistant_message: lastAssistantMessage,
+        };
+        return this.executeHooks(HookEventName.Stop, input, undefined, signal);
+    }
+    /**
+     * Fire a SessionStart event
+     * Called when a new session starts or resumes
+     */
+    async fireSessionStartEvent(source, model, permissionMode, agentType, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.SessionStart),
+            permission_mode: permissionMode ?? PermissionMode.Default,
+            source,
+            model,
+            agent_type: agentType,
+        };
+        // Pass source as context for matcher filtering
+        return this.executeHooks(HookEventName.SessionStart, input, {
+            trigger: source,
+        }, signal);
+    }
+    /**
+     * Fire a SessionEnd event
+     * Called when a session ends
+     */
+    async fireSessionEndEvent(reason, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.SessionEnd),
+            reason,
+        };
+        // Pass reason as context for matcher filtering
+        return this.executeHooks(HookEventName.SessionEnd, input, {
+            trigger: reason,
+        }, signal);
+    }
+    /**
+     * Fire a PreToolUse event
+     * Called before tool execution begins
+     */
+    async firePreToolUseEvent(toolName, toolInput, toolUseId, permissionMode, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.PreToolUse),
+            permission_mode: permissionMode,
+            tool_name: toolName,
+            tool_input: toolInput,
+            tool_use_id: toolUseId,
+        };
+        // Pass tool name as context for matcher filtering
+        return this.executeHooks(HookEventName.PreToolUse, input, {
+            toolName,
+        }, signal);
+    }
+    /**
+     * Fire a PostToolUse event
+     * Called after successful tool execution
+     */
+    async firePostToolUseEvent(toolName, toolInput, toolResponse, toolUseId, permissionMode, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.PostToolUse),
+            permission_mode: permissionMode,
+            tool_name: toolName,
+            tool_input: toolInput,
+            tool_response: toolResponse,
+            tool_use_id: toolUseId,
+        };
+        // Pass tool name as context for matcher filtering
+        return this.executeHooks(HookEventName.PostToolUse, input, {
+            toolName,
+        }, signal);
+    }
+    /**
+     * Fire a PostToolUseFailure event
+     * Called when tool execution fails
+     */
+    async firePostToolUseFailureEvent(toolUseId, toolName, toolInput, errorMessage, isInterrupt, permissionMode, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.PostToolUseFailure),
+            permission_mode: permissionMode ?? PermissionMode.Default,
+            tool_use_id: toolUseId,
+            tool_name: toolName,
+            tool_input: toolInput,
+            error: errorMessage,
+            is_interrupt: isInterrupt,
+        };
+        // Pass tool name as context for matcher filtering
+        return this.executeHooks(HookEventName.PostToolUseFailure, input, {
+            toolName,
+        }, signal);
+    }
+    /**
+     * Fire a PreCompact event
+     * Called before conversation compaction begins
+     */
+    async firePreCompactEvent(trigger, customInstructions = '', signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.PreCompact),
+            trigger,
+            custom_instructions: customInstructions,
+        };
+        // Pass trigger as context for matcher filtering
+        return this.executeHooks(HookEventName.PreCompact, input, {
+            trigger,
+        }, signal);
+    }
+    /**
+     * Fire a Notification event
+     */
+    async fireNotificationEvent(message, notificationType, title, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.Notification),
+            message,
+            notification_type: notificationType,
+            title,
+        };
+        // Pass notification_type as context for matcher filtering
+        return this.executeHooks(HookEventName.Notification, input, {
+            notificationType,
+        }, signal);
+    }
+    /**
+     * Fire a PermissionRequest event
+     * Called when a permission dialog is about to be shown to the user
+     */
+    async firePermissionRequestEvent(toolName, toolInput, permissionMode, permissionSuggestions, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.PermissionRequest),
+            permission_mode: permissionMode,
+            tool_name: toolName,
+            tool_input: toolInput,
+            permission_suggestions: permissionSuggestions,
+        };
+        // Pass tool name as context for matcher filtering
+        return this.executeHooks(HookEventName.PermissionRequest, input, {
+            toolName,
+        }, signal);
+    }
+    /**
+     * Fire a SubagentStart event
+     * Called when a subagent is spawned via the Agent tool
+     */
+    async fireSubagentStartEvent(agentId, agentType, permissionMode, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.SubagentStart),
+            permission_mode: permissionMode,
+            agent_id: agentId,
+            agent_type: agentType,
+        };
+        // Pass agentType as context for matcher filtering
+        return this.executeHooks(HookEventName.SubagentStart, input, {
+            agentType: String(agentType),
+        }, signal);
+    }
+    /**
+     * Fire a SubagentStop event
+     * Called when a subagent has finished responding
+     */
+    async fireSubagentStopEvent(agentId, agentType, agentTranscriptPath, lastAssistantMessage, stopHookActive, permissionMode, signal) {
+        const input = {
+            ...this.createBaseInput(HookEventName.SubagentStop),
+            permission_mode: permissionMode,
+            stop_hook_active: stopHookActive,
+            agent_id: agentId,
+            agent_type: agentType,
+            agent_transcript_path: agentTranscriptPath,
+            last_assistant_message: lastAssistantMessage,
+        };
+        // Pass agentType as context for matcher filtering
+        return this.executeHooks(HookEventName.SubagentStop, input, {
+            agentType: String(agentType),
+        }, signal);
+    }
+    /**
+     * Execute hooks for a specific event (direct execution without MessageBus)
+     * Used as fallback when MessageBus is not available
+     */
+    async executeHooks(eventName, input, context, signal) {
+        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) => {
+                const hookName = this.getHookName(config);
+                debugLogger.debug(`Hook ${hookName} started for event ${eventName} (${index + 1}/${plan.hookConfigs.length})`);
+            };
+            const onHookEnd = (config, result) => {
+                const hookName = this.getHookName(config);
+                debugLogger.debug(`Hook ${hookName} ended for event ${eventName}: ${result.success ? 'success' : 'failed'}`);
+            };
+            // Execute hooks according to the plan's strategy
+            const results = plan.sequential
+                ? await this.hookRunner.executeHooksSequential(plan.hookConfigs, eventName, input, onHookStart, onHookEnd, signal)
+                : await this.hookRunner.executeHooksParallel(plan.hookConfigs, eventName, input, onHookStart, onHookEnd, signal);
+            // Aggregate results
+            const aggregated = this.hookAggregator.aggregateResults(results, eventName);
+            // Process common hook output fields centrally
+            this.processCommonHookOutputFields(aggregated);
+            // Log hook execution for telemetry
+            this.logHookExecution(eventName, input, results, aggregated);
+            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 Config
+        const transcriptPath = this.config.getTranscriptPath();
+        return {
+            session_id: this.config.getSessionId(),
+            transcript_path: transcriptPath,
+            cwd: this.config.getWorkingDir(),
+            hook_event_name: eventName,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * 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 continue=false - this should stop the entire agent execution
+        if (aggregated.finalOutput.continue === false) {
+            const stopReason = aggregated.finalOutput.stopReason ||
+                aggregated.finalOutput.reason ||
+                'No reason provided';
+            debugLogger.debug(`Hook requested to stop execution: ${stopReason}`);
+        }
+    }
+    /**
+     * Log hook execution for observability
+     */
+    logHookExecution(eventName, input, results, aggregated) {
+        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(', ');
+            debugLogger.warn(`Hook(s) [${failedNames}] failed for event ${eventName}. Check debug logs for more details.`);
+        }
+        else {
+            debugLogger.debug(`Hook execution for ${eventName}: ${successCount} hooks executed successfully, ` +
+                `total duration: ${aggregated.totalDuration}ms`);
+        }
+        for (const result of results) {
+            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);
+        }
+        for (const error of aggregated.errors) {
+            debugLogger.warn(`Hook execution error: ${error.message}`);
+        }
+    }
+    /**
+     * Get hook name from config for display or telemetry
+     */
+    getHookName(config) {
+        if (config.type === 'command') {
+            return config.name || config.command || 'unknown-command';
+        }
+        return config.name || 'unknown-hook';
+    }
+    /**
+     * 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/CLI/packages/core/src/hooks/hookEventHandler.js.map

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

package/dist/CLI/packages/core/src/hooks/hookPlanner.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2026 Qwen Team
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { HookRegistry } from './hookRegistry.js';
+import type { HookExecutionPlan } from './types.js';
+import { 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.
+     * Uses explicit event-based dispatch to avoid ambiguity between events
+     * that share similar context fields (e.g., SessionStart and SubagentStart
+     * both have agentType, but use different matcher semantics).
+     */
+    private matchesContext;
+    /**
+     * Match notification type against matcher pattern
+     */
+    private matchesNotificationType;
+    /**
+     * Match session source or end reason against matcher pattern
+     */
+    private matchesSessionTrigger;
+    /**
+     * Match tool name against matcher pattern
+     */
+    private matchesToolName;
+    /**
+     * Match trigger/source against matcher pattern
+     */
+    private matchesTrigger;
+    /**
+     * Match agent type against matcher pattern.
+     * Supports regex matching, same as tool name matching.
+     */
+    private matchesAgentType;
+    /**
+     * Deduplicate identical hook configurations
+     */
+    private deduplicateHooks;
+}
+/**
+ * Context information for hook event matching
+ */
+export interface HookEventContext {
+    toolName?: string;
+    trigger?: string;
+    notificationType?: string;
+    /** Agent type for SubagentStart/SubagentStop matcher filtering */
+    agentType?: string;
+}