@claude-flow/hooks 3.0.0-alpha.1

package/dist/executor/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * V3 Hook Executor
+ *
+ * Executes hooks in priority order with timeout handling,
+ * error recovery, and result aggregation.
+ */
+import type { HookEvent, HookContext, HookExecutionOptions, HookExecutionResult } from '../types.js';
+import { HookRegistry } from '../registry/index.js';
+/**
+ * Hook Executor - executes hooks for events
+ */
+export declare class HookExecutor {
+    private registry;
+    private eventEmitter?;
+    constructor(registry?: HookRegistry);
+    /**
+     * Set event emitter for hook execution events
+     */
+    setEventEmitter(emitter: {
+        emit: (event: string, data: unknown) => void;
+    }): void;
+    /**
+     * Execute all hooks for an event
+     */
+    execute<T = unknown>(event: HookEvent, context: Partial<HookContext<T>>, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute a single hook with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Execute hooks for pre-tool-use event
+     */
+    preToolUse(toolName: string, parameters: Record<string, unknown>, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for post-tool-use event
+     */
+    postToolUse(toolName: string, parameters: Record<string, unknown>, duration: number, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for pre-edit event
+     */
+    preEdit(filePath: string, operation: 'create' | 'modify' | 'delete', options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for post-edit event
+     */
+    postEdit(filePath: string, operation: 'create' | 'modify' | 'delete', duration: number, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for pre-command event
+     */
+    preCommand(command: string, workingDirectory?: string, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for post-command event
+     */
+    postCommand(command: string, exitCode: number, output?: string, error?: string, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for session-start event
+     */
+    sessionStart(sessionId: string, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for session-end event
+     */
+    sessionEnd(sessionId: string, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for agent-spawn event
+     */
+    agentSpawn(agentId: string, agentType: string, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+    /**
+     * Execute hooks for agent-terminate event
+     */
+    agentTerminate(agentId: string, agentType: string, status: string, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+}
+/**
+ * Default global executor instance
+ */
+export declare const defaultExecutor: HookExecutor;
+/**
+ * Convenience function to execute hooks on the default executor
+ */
+export declare function executeHooks<T = unknown>(event: HookEvent, context: Partial<HookContext<T>>, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+export { HookExecutor as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/executor/index.d.ts.map

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

package/dist/executor/index.js

@@ -0,0 +1,273 @@
+/**
+ * V3 Hook Executor
+ *
+ * Executes hooks in priority order with timeout handling,
+ * error recovery, and result aggregation.
+ */
+import { defaultRegistry } from '../registry/index.js';
+/**
+ * Default execution options
+ */
+const DEFAULT_OPTIONS = {
+    continueOnError: false,
+    timeout: 5000,
+    emitEvents: true,
+};
+/**
+ * Hook Executor - executes hooks for events
+ */
+export class HookExecutor {
+    registry;
+    eventEmitter;
+    constructor(registry) {
+        this.registry = registry ?? defaultRegistry;
+    }
+    /**
+     * Set event emitter for hook execution events
+     */
+    setEventEmitter(emitter) {
+        this.eventEmitter = emitter;
+    }
+    /**
+     * Execute all hooks for an event
+     */
+    async execute(event, context, options) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        const startTime = Date.now();
+        // Build full context
+        const fullContext = {
+            event,
+            timestamp: new Date(),
+            ...context,
+        };
+        // Get hooks for event
+        const hooks = this.registry.getForEvent(event, true);
+        if (hooks.length === 0) {
+            return {
+                success: true,
+                hooksExecuted: 0,
+                hooksFailed: 0,
+                executionTime: Date.now() - startTime,
+                results: [],
+                finalContext: fullContext,
+            };
+        }
+        // Execute hooks in priority order
+        const results = [];
+        const warnings = [];
+        const messages = [];
+        let aborted = false;
+        let hooksFailed = 0;
+        for (const hook of hooks) {
+            if (aborted)
+                break;
+            const hookStart = Date.now();
+            let result;
+            try {
+                result = await this.executeWithTimeout(hook, fullContext, opts.timeout);
+            }
+            catch (error) {
+                result = {
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+            const hookDuration = Date.now() - hookStart;
+            results.push({
+                hookId: hook.id,
+                hookName: hook.name,
+                success: result.success,
+                duration: hookDuration,
+                error: result.error,
+            });
+            // Collect warnings and messages
+            if (result.warnings) {
+                warnings.push(...result.warnings);
+            }
+            if (result.message) {
+                messages.push(result.message);
+            }
+            // Update context with hook data
+            if (result.data) {
+                Object.assign(fullContext, { metadata: { ...fullContext.metadata, ...result.data } });
+            }
+            // Record stats
+            this.registry.recordExecution(result.success, hookDuration);
+            // Handle failure
+            if (!result.success) {
+                hooksFailed++;
+                if (opts.emitEvents && this.eventEmitter) {
+                    this.eventEmitter.emit('hook:failed', {
+                        hookId: hook.id,
+                        hookName: hook.name,
+                        event,
+                        error: result.error,
+                    });
+                }
+                if (!opts.continueOnError) {
+                    aborted = true;
+                    break;
+                }
+            }
+            // Handle abort request
+            if (result.abort) {
+                aborted = true;
+                break;
+            }
+            // Emit success event
+            if (opts.emitEvents && this.eventEmitter && result.success) {
+                this.eventEmitter.emit('hook:executed', {
+                    hookId: hook.id,
+                    hookName: hook.name,
+                    event,
+                    duration: hookDuration,
+                });
+            }
+        }
+        const executionTime = Date.now() - startTime;
+        // Emit completion event
+        if (opts.emitEvents && this.eventEmitter) {
+            this.eventEmitter.emit('hooks:completed', {
+                event,
+                hooksExecuted: results.length,
+                hooksFailed,
+                executionTime,
+                aborted,
+            });
+        }
+        return {
+            success: hooksFailed === 0 && !aborted,
+            aborted,
+            hooksExecuted: results.length,
+            hooksFailed,
+            executionTime,
+            results,
+            finalContext: fullContext,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            messages: messages.length > 0 ? messages : undefined,
+        };
+    }
+    /**
+     * Execute a single hook with timeout
+     */
+    async executeWithTimeout(hook, context, timeout) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Hook ${hook.id} timed out after ${timeout}ms`));
+            }, timeout);
+            Promise.resolve(hook.handler(context))
+                .then((result) => {
+                clearTimeout(timer);
+                resolve(result);
+            })
+                .catch((error) => {
+                clearTimeout(timer);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Execute hooks for pre-tool-use event
+     */
+    async preToolUse(toolName, parameters, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.PreToolUse, {
+            tool: { name: toolName, parameters },
+        }, options);
+    }
+    /**
+     * Execute hooks for post-tool-use event
+     */
+    async postToolUse(toolName, parameters, duration, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.PostToolUse, {
+            tool: { name: toolName, parameters },
+            duration,
+        }, options);
+    }
+    /**
+     * Execute hooks for pre-edit event
+     */
+    async preEdit(filePath, operation, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.PreEdit, {
+            file: { path: filePath, operation },
+        }, options);
+    }
+    /**
+     * Execute hooks for post-edit event
+     */
+    async postEdit(filePath, operation, duration, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.PostEdit, {
+            file: { path: filePath, operation },
+            duration,
+        }, options);
+    }
+    /**
+     * Execute hooks for pre-command event
+     */
+    async preCommand(command, workingDirectory, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.PreCommand, {
+            command: { raw: command, workingDirectory },
+        }, options);
+    }
+    /**
+     * Execute hooks for post-command event
+     */
+    async postCommand(command, exitCode, output, error, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.PostCommand, {
+            command: { raw: command, exitCode, output, error },
+        }, options);
+    }
+    /**
+     * Execute hooks for session-start event
+     */
+    async sessionStart(sessionId, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.SessionStart, {
+            session: { id: sessionId, startedAt: new Date() },
+        }, options);
+    }
+    /**
+     * Execute hooks for session-end event
+     */
+    async sessionEnd(sessionId, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.SessionEnd, {
+            session: { id: sessionId, startedAt: new Date() },
+        }, options);
+    }
+    /**
+     * Execute hooks for agent-spawn event
+     */
+    async agentSpawn(agentId, agentType, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.AgentSpawn, {
+            agent: { id: agentId, type: agentType },
+        }, options);
+    }
+    /**
+     * Execute hooks for agent-terminate event
+     */
+    async agentTerminate(agentId, agentType, status, options) {
+        const { HookEvent } = await import('../types.js');
+        return this.execute(HookEvent.AgentTerminate, {
+            agent: { id: agentId, type: agentType, status },
+        }, options);
+    }
+}
+/**
+ * Default global executor instance
+ */
+export const defaultExecutor = new HookExecutor();
+/**
+ * Convenience function to execute hooks on the default executor
+ */
+export async function executeHooks(event, context, options) {
+    return defaultExecutor.execute(event, context, options);
+}
+export { HookExecutor as default };
+//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @claude-flow/hooks - V3 Hooks System
+ *
+ * Event-driven lifecycle hooks with ReasoningBank learning integration.
+ *
+ * Features:
+ * - Hook registration and execution
+ * - Background daemons for metrics and learning
+ * - Statusline integration
+ * - MCP tool definitions
+ * - V2 compatibility layer
+ *
+ * @packageDocumentation
+ */
+export * from './types.js';
+export { ReasoningBank, reasoningBank, type GuidancePattern, type GuidanceResult, type RoutingResult, type ReasoningBankConfig, type ReasoningBankMetrics, } from './reasoningbank/index.js';
+export { GuidanceProvider, guidanceProvider, type ClaudeHookOutput, } from './reasoningbank/guidance-provider.js';
+export { HookRegistry, defaultRegistry, registerHook, unregisterHook, } from './registry/index.js';
+export { HookExecutor, defaultExecutor, executeHooks, } from './executor/index.js';
+export { DaemonManager, MetricsDaemon, SwarmMonitorDaemon, HooksLearningDaemon, defaultDaemonManager, } from './daemons/index.js';
+export { StatuslineGenerator, createShellStatusline, parseStatuslineData, defaultStatuslineGenerator, } from './statusline/index.js';
+export { hooksMCPTools, getHooksTool, preEditTool, postEditTool, routeTaskTool, metricsTool, preCommandTool, postCommandTool, daemonStatusTool, statuslineTool, type MCPTool, } from './mcp/index.js';
+export { OfficialHooksBridge, V3_TO_OFFICIAL_HOOK_MAP, V3_TOOL_MATCHERS, processOfficialHookInput, outputOfficialHookResult, executeWithBridge, type OfficialHookEvent, type OfficialHookInput, type OfficialHookOutput, } from './bridge/official-hooks-bridge.js';
+export { SwarmCommunication, swarmComm, type SwarmMessage, type PatternBroadcast, type ConsensusRequest, type TaskHandoff, type SwarmAgentState, type SwarmConfig, } from './swarm/index.js';
+export { WorkerManager, WorkerPriority, AlertSeverity, WORKER_CONFIGS, DEFAULT_THRESHOLDS, createWorkerManager, workerManager, createPerformanceWorker, createHealthWorker, createSwarmWorker, createGitWorker, createLearningWorker, createADRWorker, createDDDWorker, createSecurityWorker, createPatternsWorker, createCacheWorker, type WorkerConfig, type WorkerResult, type WorkerMetrics, type WorkerManagerStatus, type WorkerHandler, type WorkerAlert, type AlertThreshold, type PersistedWorkerState, type HistoricalMetric, type StatuslineData, } from './workers/index.js';
+export { workerMCPTools, createWorkerToolHandler, workerRunTool, workerStatusTool, workerAlertsTool, workerHistoryTool, workerStatuslineTool, workerRunAllTool, workerStartTool, workerStopTool, type MCPToolDefinition, type MCPToolResult, } from './workers/mcp-tools.js';
+export { onSessionStart, onSessionEnd, formatSessionStartOutput, generateShellHook, getGlobalManager, setGlobalManager, initializeGlobalManager, type SessionHookConfig, type SessionHookResult, } from './workers/session-hook.js';
+export declare const VERSION = "3.0.0-alpha.1";
+/**
+ * Initialize hooks system with default configuration
+ */
+export declare function initializeHooks(options?: {
+    enableDaemons?: boolean;
+    enableStatusline?: boolean;
+}): Promise<{
+    registry: import('./registry/index.js').HookRegistry;
+    executor: import('./executor/index.js').HookExecutor;
+    statusline: import('./statusline/index.js').StatuslineGenerator;
+}>;
+/**
+ * Quick hooks execution helper
+ */
+export declare function runHook(event: import('./types.js').HookEvent, context: Partial<import('./types.js').HookContext>): Promise<import('./types.js').HookExecutionResult>;
+/**
+ * Register a new hook with simplified API
+ */
+export declare function addHook(event: import('./types.js').HookEvent, handler: import('./types.js').HookHandler, options?: {
+    priority?: import('./types.js').HookPriority;
+    name?: string;
+}): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * @claude-flow/hooks - V3 Hooks System
+ *
+ * Event-driven lifecycle hooks with ReasoningBank learning integration.
+ *
+ * Features:
+ * - Hook registration and execution
+ * - Background daemons for metrics and learning
+ * - Statusline integration
+ * - MCP tool definitions
+ * - V2 compatibility layer
+ *
+ * @packageDocumentation
+ */
+// Types
+export * from './types.js';
+// ReasoningBank - Vector-based pattern learning
+export { ReasoningBank, reasoningBank, } from './reasoningbank/index.js';
+// Guidance Provider - Claude-visible output generation
+export { GuidanceProvider, guidanceProvider, } from './reasoningbank/guidance-provider.js';
+// Registry
+export { HookRegistry, defaultRegistry, registerHook, unregisterHook, } from './registry/index.js';
+// Executor
+export { HookExecutor, defaultExecutor, executeHooks, } from './executor/index.js';
+// Daemons
+export { DaemonManager, MetricsDaemon, SwarmMonitorDaemon, HooksLearningDaemon, defaultDaemonManager, } from './daemons/index.js';
+// Statusline
+export { StatuslineGenerator, createShellStatusline, parseStatuslineData, defaultStatuslineGenerator, } from './statusline/index.js';
+// MCP Tools
+export { hooksMCPTools, getHooksTool, preEditTool, postEditTool, routeTaskTool, metricsTool, preCommandTool, postCommandTool, daemonStatusTool, statuslineTool, } from './mcp/index.js';
+// Official Claude Code Hooks Bridge
+export { OfficialHooksBridge, V3_TO_OFFICIAL_HOOK_MAP, V3_TOOL_MATCHERS, processOfficialHookInput, outputOfficialHookResult, executeWithBridge, } from './bridge/official-hooks-bridge.js';
+// Swarm Communication
+export { SwarmCommunication, swarmComm, } from './swarm/index.js';
+// Workers - Cross-platform background workers
+export { WorkerManager, WorkerPriority, AlertSeverity, WORKER_CONFIGS, DEFAULT_THRESHOLDS, createWorkerManager, workerManager, 
+// Worker factories
+createPerformanceWorker, createHealthWorker, createSwarmWorker, createGitWorker, createLearningWorker, createADRWorker, createDDDWorker, createSecurityWorker, createPatternsWorker, createCacheWorker, } from './workers/index.js';
+// Workers - MCP Tools
+export { workerMCPTools, createWorkerToolHandler, workerRunTool, workerStatusTool, workerAlertsTool, workerHistoryTool, workerStatuslineTool, workerRunAllTool, workerStartTool, workerStopTool, } from './workers/mcp-tools.js';
+// Workers - Session Integration
+export { onSessionStart, onSessionEnd, formatSessionStartOutput, generateShellHook, getGlobalManager, setGlobalManager, initializeGlobalManager, } from './workers/session-hook.js';
+// Version
+export const VERSION = '3.0.0-alpha.1';
+/**
+ * Initialize hooks system with default configuration
+ */
+export async function initializeHooks(options) {
+    const { HookRegistry } = await import('./registry/index.js');
+    const { HookExecutor } = await import('./executor/index.js');
+    const { StatuslineGenerator } = await import('./statusline/index.js');
+    const { DaemonManager, MetricsDaemon, SwarmMonitorDaemon, HooksLearningDaemon } = await import('./daemons/index.js');
+    const registry = new HookRegistry();
+    const executor = new HookExecutor(registry);
+    const statusline = new StatuslineGenerator();
+    // Start daemons if enabled
+    if (options?.enableDaemons !== false) {
+        const daemonManager = new DaemonManager();
+        const metricsDaemon = new MetricsDaemon(daemonManager);
+        const swarmDaemon = new SwarmMonitorDaemon(daemonManager);
+        const learningDaemon = new HooksLearningDaemon(daemonManager);
+        await Promise.all([
+            metricsDaemon.start(),
+            swarmDaemon.start(),
+            learningDaemon.start(),
+        ]);
+    }
+    return { registry, executor, statusline };
+}
+/**
+ * Quick hooks execution helper
+ */
+export async function runHook(event, context) {
+    const { executeHooks } = await import('./executor/index.js');
+    return executeHooks(event, context);
+}
+/**
+ * Register a new hook with simplified API
+ */
+export function addHook(event, handler, options) {
+    const { registerHook: register } = require('./registry/index.js');
+    const { HookPriority } = require('./types.js');
+    return register(event, handler, options?.priority ?? HookPriority.Normal, { name: options?.name });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/llm/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * V3 LLM Hooks Module
+ *
+ * Exports LLM-specific hooks for request caching,
+ * optimization, cost tracking, and pattern learning.
+ *
+ * @module @claude-flow/hooks/llm
+ */
+export * from './llm-hooks.js';
+export { llmHooks as default } from './llm-hooks.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,11 @@
+/**
+ * V3 LLM Hooks Module
+ *
+ * Exports LLM-specific hooks for request caching,
+ * optimization, cost tracking, and pattern learning.
+ *
+ * @module @claude-flow/hooks/llm
+ */
+export * from './llm-hooks.js';
+export { llmHooks as default } from './llm-hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/llm/llm-hooks.d.ts

@@ -0,0 +1,93 @@
+/**
+ * V3 LLM Hooks System
+ *
+ * Provides pre/post operation hooks for all LLM calls with:
+ * - Request caching with memory persistence
+ * - Provider-specific optimizations
+ * - Cost tracking and optimization
+ * - Performance metrics
+ * - Pattern learning
+ *
+ * @module @claude-flow/hooks/llm/llm-hooks
+ */
+export interface LLMHookContext {
+    correlationId: string;
+    sessionId?: string;
+    agentId?: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+export interface LLMHookPayload {
+    provider: string;
+    model: string;
+    operation: 'complete' | 'stream' | 'embed';
+    request: LLMRequestPayload;
+    response?: LLMResponsePayload;
+    metrics?: LLMMetrics;
+}
+export interface LLMRequestPayload {
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    temperature?: number;
+    maxTokens?: number;
+    [key: string]: unknown;
+}
+export interface LLMResponsePayload {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    cost?: {
+        promptCost: number;
+        completionCost: number;
+        totalCost: number;
+    };
+    latency?: number;
+    [key: string]: unknown;
+}
+export interface LLMMetrics {
+    requestStart: number;
+    responseEnd?: number;
+    latency?: number;
+    cacheHit?: boolean;
+    tokenEstimate?: number;
+    costEstimate?: number;
+}
+export interface LLMHookResult {
+    continue: boolean;
+    modified: boolean;
+    payload?: LLMHookPayload;
+    sideEffects?: LLMSideEffect[];
+    cachedResponse?: LLMResponsePayload;
+}
+export interface LLMSideEffect {
+    type: 'memory' | 'metric' | 'log' | 'pattern';
+    action: string;
+    data: Record<string, unknown>;
+}
+export declare function preLLMCallHook(payload: LLMHookPayload, context: LLMHookContext): Promise<LLMHookResult>;
+export declare function postLLMCallHook(payload: LLMHookPayload, context: LLMHookContext): Promise<LLMHookResult>;
+export declare function errorLLMCallHook(payload: LLMHookPayload, error: Error, context: LLMHookContext): Promise<LLMHookResult>;
+export declare function clearLLMCache(): void;
+export declare function getLLMCacheStats(): {
+    size: number;
+    totalHits: number;
+    entries: Array<{
+        key: string;
+        hits: number;
+        age: number;
+    }>;
+};
+export declare const llmHooks: {
+    preLLMCall: typeof preLLMCallHook;
+    postLLMCall: typeof postLLMCallHook;
+    errorLLMCall: typeof errorLLMCallHook;
+    clearCache: typeof clearLLMCache;
+    getCacheStats: typeof getLLMCacheStats;
+};
+export default llmHooks;
+//# sourceMappingURL=llm-hooks.d.ts.map

package/dist/llm/llm-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-hooks.d.ts","sourceRoot":"","sources":["../../src/llm/llm-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;IAC9B,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAwHD,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAwExB;AAID,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA2GxB;AAID,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAuDxB;AA4DD,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAkBA;AAID,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAC;AAEF,eAAe,QAAQ,CAAC"}