/**
 * Built-in Tracing Hooks
 *
 * Pre-built hooks for common tracing patterns that integrate with the HooksManager.
 * These hooks automatically create spans for LLM calls, tool executions, and iterations.
 */
import type { HooksConfig } from '../hooks/types.js';
import type { TracingHooksConfig } from './types.js';
import { TracingManager } from './manager.js';
/**
 * Create tracing hooks that automatically instrument agent execution
 *
 * @param manager - TracingManager instance
 * @param config - Tracing hooks configuration
 * @returns HooksConfig with tracing hooks
 *
 * @example
 * ```typescript
 * const tracingManager = new TracingManager({ serviceName: 'my-agent' });
 * const tracingHooks = createTracingHooks(tracingManager, {
 *   traceLLM: true,
 *   traceTools: true,
 *   traceIterations: true,
 * });
 *
 * const agent = new Agent({
 *   provider,
 *   hooks: tracingHooks,
 * });
 * ```
 */
export declare function createTracingHooks(manager: TracingManager, config?: TracingHooksConfig): HooksConfig;
/**
 * Create a simple logging hook that logs all agent events
 *
 * @param logger - Logger function (default: console.log)
 * @returns HooksConfig with logging hooks
 *
 * @example
 * ```typescript
 * const loggingHooks = createLoggingHooks((msg) => myLogger.info(msg));
 * const agent = new Agent({ provider, hooks: loggingHooks });
 * ```
 */
export declare function createLoggingHooks(logger?: (message: string, data?: Record<string, unknown>) => void): HooksConfig;
/**
 * Merge multiple HooksConfig objects
 *
 * @param configs - HooksConfig objects to merge
 * @returns Merged HooksConfig
 *
 * @example
 * ```typescript
 * const hooks = mergeHooks(tracingHooks, loggingHooks, customHooks);
 * const agent = new Agent({ provider, hooks });
 * ```
 */
export declare function mergeHooks(...configs: HooksConfig[]): HooksConfig;