/**
 * Agent Lifecycle Hook Utilities
 * Executes user-defined hooks from agent-health.config.ts
 */
import type { AgentHooks, BeforeRequestContext, AfterResponseContext, BuildTrajectoryContext, TrajectoryStep } from '../types/index.js';
/**
 * Execute the beforeRequest hook if defined on the agent.
 *
 * - Returns the original context unchanged if no hook is defined
 * - Validates the hook return value has required fields
 * - Wraps errors with a descriptive message including the agent key
 */
export declare function executeBeforeRequestHook(hooks: AgentHooks | undefined, context: BeforeRequestContext, agentKey: string): Promise<BeforeRequestContext>;
/**
 * Execute the afterResponse hook if defined on the agent.
 *
 * Use this hook to extract custom runId formats from agent responses
 * (e.g., PER agent's memory_id).
 *
 * - Returns the original context unchanged if no hook is defined
 * - Validates the hook return value has required fields
 * - Wraps errors with a descriptive message including the agent key
 */
export declare function executeAfterResponseHook(hooks: AgentHooks | undefined, context: AfterResponseContext, agentKey: string): Promise<AfterResponseContext>;
/**
 * Execute the buildTrajectory hook if defined on the agent.
 *
 * Use this hook to customize trajectory extraction from OTEL traces
 * for agents with custom span formats.
 *
 * - Returns null if no hook is defined
 * - Validates the hook return value is an array
 * - Wraps errors with a descriptive message including the agent key
 */
export declare function executeBuildTrajectoryHook(hooks: AgentHooks | undefined, context: BuildTrajectoryContext, agentKey: string): Promise<TrajectoryStep[] | null>;
//# sourceMappingURL=hooks.d.ts.map