/**
 * src/plugin/pipeline.ts — Central Hook Dispatch Pipeline for Weavetab Plugins
 *
 * Dispatches lifecycle events:
 * - onBeforeAction / beforeToolCall: Intercept tool calls, modify arguments, or block unauthorized actions
 * - onAfterAction / afterToolCall: Transform, redact, or augment tool return results
 * - onDOMMutation: Stream real-time DOM mutation deltas to registered plugins
 * - onPageNavigate: Notify plugins upon browser navigation
 */
import type { DOMMutationDelta } from "./interface.js";
export type BeforeToolCallHook = (toolName: string, args: Record<string, any>, session?: any) => Promise<Record<string, any> | {
    __blocked: boolean;
    reason?: string;
} | void> | Record<string, any> | {
    __blocked: boolean;
    reason?: string;
} | void;
export type AfterToolCallHook = (toolName: string, args: Record<string, any>, result: any, session?: any) => Promise<any | void> | any | void;
export type PageNavigateHook = (url: string, session?: any) => Promise<void> | void;
export type DOMMutationHook = (delta: DOMMutationDelta, session?: any) => Promise<void> | void;
export interface PluginHooksRegistry {
    beforeToolCall?: BeforeToolCallHook[] | BeforeToolCallHook;
    afterToolCall?: AfterToolCallHook[] | AfterToolCallHook;
    onBeforeAction?: BeforeToolCallHook[] | BeforeToolCallHook;
    onAfterAction?: Array<(tool: string, result: any, session?: any, args?: Record<string, any>) => any> | ((tool: string, result: any, session?: any, args?: Record<string, any>) => any);
    onDOMMutation?: DOMMutationHook[] | DOMMutationHook;
    onPageNavigate?: PageNavigateHook[] | PageNavigateHook;
}
declare class HookPipeline {
    private beforeToolCallHooks;
    private afterToolCallHooks;
    private onDOMMutationHooks;
    private onPageNavigateHooks;
    /**
     * Register hooks for a specific plugin.
     */
    registerPluginHooks(pluginName: string, hooks: Partial<PluginHooksRegistry> & Record<string, any>): void;
    /**
     * Remove all hooks registered by a plugin on unload.
     */
    unregisterPluginHooks(pluginName: string): void;
    /**
     * Dispatches beforeAction / beforeToolCall hooks in sequence.
     * If a hook returns an object, arguments are augmented/modified.
     * If a hook returns { __blocked: true, reason } or throws, execution is aborted.
     */
    dispatchBeforeToolCall(toolName: string, args: Record<string, any>, session?: any): Promise<Record<string, any>>;
    /**
     * Alias for dispatchBeforeToolCall.
     */
    dispatchBeforeAction(toolName: string, args: Record<string, any>, session?: any): Promise<Record<string, any>>;
    /**
     * Dispatches afterAction / afterToolCall hooks in sequence.
     * Allows plugins to inspect, transform, or redact tool results.
     */
    dispatchAfterToolCall(toolName: string, args: Record<string, any>, result: any, session?: any): Promise<any>;
    /**
     * Alias for dispatchAfterToolCall.
     */
    dispatchAfterAction(toolName: string, result: any, session?: any, args?: Record<string, any>): Promise<any>;
    /**
     * Dispatches DOM mutation deltas to all listening plugins.
     */
    dispatchDOMMutation(delta: DOMMutationDelta, session?: any): Promise<void>;
    /**
     * Dispatches onPageNavigate hooks when navigation occurs.
     */
    dispatchPageNavigate(url: string, session?: any): Promise<void>;
    /**
     * Clears all registered hooks.
     */
    clearAllHooks(): void;
}
export declare const hookPipeline: HookPipeline;
export {};