import type { AgentEvent } from './events.js';
/** Runtime hook kinds supported by agent-mux. */
export type RuntimeHookKind = 'preToolUse' | 'postToolUse' | 'sessionStart' | 'sessionEnd' | 'stop' | 'userPromptSubmit';
/** How an adapter supports a given runtime hook kind. */
export type RuntimeHookMode = 'unsupported' | 'nonblocking' | 'blocking';
/** Adapter capability declaration for runtime hooks. */
export interface RuntimeHookCapabilities {
    preToolUse: RuntimeHookMode;
    postToolUse: RuntimeHookMode;
    sessionStart: RuntimeHookMode;
    sessionEnd: RuntimeHookMode;
    stop: RuntimeHookMode;
    userPromptSubmit: RuntimeHookMode;
}
/** Context passed to runtime hook handlers. */
export interface HookContext {
    signal: AbortSignal;
    emit(event: AgentEvent): void | Promise<void>;
}
/** Decision returned by blocking runtime hooks. */
export type HookDecision = {
    decision: 'allow';
} | {
    decision: 'deny';
    reason?: string;
};
/** Handler invoked before a tool executes. */
export type PreToolUseHook<TPayload = unknown> = (payload: TPayload, context: HookContext) => Promise<HookDecision> | HookDecision;
/** Handler invoked when the user submits a prompt. */
export type UserPromptSubmitHook<TPayload = unknown> = (payload: TPayload, context: HookContext) => Promise<HookDecision> | HookDecision;
/** Handler invoked for non-blocking runtime hook notifications. */
export type NotificationHook<TPayload = unknown> = (payload: TPayload, context: HookContext) => Promise<void> | void;
/** Per-run runtime hooks attached through RunOptions. */
export interface RuntimeHooks {
    preToolUse?: PreToolUseHook;
    postToolUse?: NotificationHook;
    sessionStart?: NotificationHook;
    sessionEnd?: NotificationHook;
    stop?: NotificationHook;
    userPromptSubmit?: UserPromptSubmitHook;
}
/** Optional native harness bridge returned by adapters that support runtime hooks. */
export interface RuntimeHookSetup {
    env?: Record<string, string>;
    cleanup?: () => Promise<void> | void;
}
export type { RuntimeHookDispatcher } from './runtime-hook-dispatcher.js';