agentic-flow 2.0.2-alpha → 2.0.2

package/dist/proxy/quic-proxy.js

@@ -0,0 +1,228 @@
+// QUIC-enabled Proxy for Anthropic API
+// Optional QUIC transport with automatic HTTP/2 fallback
+import { QuicClient, QuicConnectionPool } from '../transport/quic.js';
+import { logger } from '../utils/logger.js';
+import { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';
+export class QuicEnabledProxy extends AnthropicToOpenRouterProxy {
+    quicClient;
+    quicPool;
+    transport;
+    quicEnabled;
+    fallbackToHttp2;
+    constructor(config) {
+        super({
+            openrouterApiKey: config.openrouterApiKey,
+            openrouterBaseUrl: config.openrouterBaseUrl,
+            defaultModel: config.defaultModel
+        });
+        this.transport = config.transport || 'auto';
+        this.quicEnabled = config.enableQuic ?? this.checkQuicFeatureFlag();
+        this.fallbackToHttp2 = config.fallbackToHttp2 ?? true;
+        if (this.quicEnabled) {
+            this.initializeQuic(config.quic || {});
+        }
+    }
+    /**
+     * Check if QUIC is enabled via environment variable
+     */
+    checkQuicFeatureFlag() {
+        const flag = process.env.AGENTIC_FLOW_ENABLE_QUIC;
+        return flag === 'true' || flag === '1';
+    }
+    /**
+     * Initialize QUIC client and connection pool
+     */
+    async initializeQuic(quicConfig) {
+        try {
+            logger.info('Initializing QUIC transport...', { config: quicConfig });
+            this.quicClient = new QuicClient(quicConfig);
+            await this.quicClient.initialize();
+            this.quicPool = new QuicConnectionPool(this.quicClient, 20);
+            logger.info('QUIC transport initialized successfully');
+        }
+        catch (error) {
+            logger.error('Failed to initialize QUIC transport', { error });
+            if (this.fallbackToHttp2) {
+                logger.warn('Falling back to HTTP/2 transport');
+                this.quicEnabled = false;
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Select transport protocol based on configuration and availability
+     */
+    selectTransport() {
+        if (this.transport === 'quic' && this.quicEnabled) {
+            return 'quic';
+        }
+        if (this.transport === 'http2') {
+            return 'http2';
+        }
+        // Auto mode: prefer QUIC if available, fallback to HTTP/2
+        if (this.transport === 'auto') {
+            return this.quicEnabled ? 'quic' : 'http2';
+        }
+        return 'http2';
+    }
+    /**
+     * Send request using selected transport
+     */
+    async sendRequest(url, options) {
+        const selectedTransport = this.selectTransport();
+        logger.debug('Sending request', {
+            transport: selectedTransport,
+            url,
+            method: options.method
+        });
+        if (selectedTransport === 'quic') {
+            return this.sendQuicRequest(url, options);
+        }
+        else {
+            return this.sendHttp2Request(url, options);
+        }
+    }
+    /**
+     * Send request over QUIC
+     */
+    async sendQuicRequest(url, options) {
+        if (!this.quicClient || !this.quicPool) {
+            throw new Error('QUIC client not initialized');
+        }
+        try {
+            const urlObj = new URL(url);
+            const connection = await this.quicPool.getConnection(urlObj.hostname, parseInt(urlObj.port) || 443);
+            logger.debug('Using QUIC connection', {
+                connectionId: connection.id,
+                url
+            });
+            // Prepare headers
+            const headers = {};
+            if (options.headers) {
+                const headerEntries = options.headers instanceof Headers
+                    ? Array.from(options.headers.entries())
+                    : Object.entries(options.headers);
+                for (const entry of headerEntries) {
+                    headers[entry[0]] = entry[1];
+                }
+            }
+            // Convert body to Uint8Array
+            let body;
+            if (options.body) {
+                if (typeof options.body === 'string') {
+                    body = new TextEncoder().encode(options.body);
+                }
+                else if (options.body instanceof Uint8Array) {
+                    body = options.body;
+                }
+                else {
+                    body = new TextEncoder().encode(JSON.stringify(options.body));
+                }
+            }
+            // Send HTTP/3 request over QUIC
+            const response = await this.quicClient.sendRequest(connection.id, options.method || 'GET', urlObj.pathname + urlObj.search, headers, body);
+            logger.info('QUIC request completed', {
+                status: response.status,
+                bytes: response.body.length
+            });
+            // Convert to fetch Response
+            const responseText = new TextDecoder().decode(response.body);
+            return new Response(responseText, {
+                status: response.status,
+                headers: new Headers(response.headers)
+            });
+        }
+        catch (error) {
+            logger.error('QUIC request failed', { error, url });
+            if (this.fallbackToHttp2) {
+                logger.warn('Falling back to HTTP/2 for this request');
+                return this.sendHttp2Request(url, options);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Send request over HTTP/2 (standard fetch)
+     */
+    async sendHttp2Request(url, options) {
+        logger.debug('Using HTTP/2 transport', { url });
+        return fetch(url, options);
+    }
+    /**
+     * Get transport statistics
+     */
+    getTransportStats() {
+        if (this.quicClient) {
+            return {
+                transport: this.selectTransport(),
+                quicEnabled: this.quicEnabled,
+                quicStats: this.quicClient.getStats()
+            };
+        }
+        return {
+            transport: 'http2',
+            quicEnabled: false
+        };
+    }
+    /**
+     * Shutdown and cleanup
+     */
+    async shutdown() {
+        if (this.quicPool) {
+            await this.quicPool.clear();
+        }
+        if (this.quicClient) {
+            await this.quicClient.shutdown();
+        }
+        logger.info('QUIC proxy shutdown complete');
+    }
+}
+/**
+ * Create QUIC-enabled proxy with configuration
+ */
+export function createQuicProxy(config) {
+    const proxy = new QuicEnabledProxy(config);
+    logger.info('QUIC proxy created', {
+        transport: config.transport || 'auto',
+        quicEnabled: config.enableQuic ?? (process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true'),
+        fallbackEnabled: config.fallbackToHttp2 ?? true
+    });
+    return proxy;
+}
+// CLI entry point for QUIC proxy
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const port = parseInt(process.env.PORT || '3000');
+    const openrouterApiKey = process.env.OPENROUTER_API_KEY;
+    if (!openrouterApiKey) {
+        console.error('❌ Error: OPENROUTER_API_KEY environment variable required');
+        process.exit(1);
+    }
+    const proxy = createQuicProxy({
+        openrouterApiKey,
+        openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,
+        defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL,
+        transport: process.env.TRANSPORT || 'auto',
+        enableQuic: process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true',
+        quic: {
+            port: parseInt(process.env.QUIC_PORT || '4433'),
+            serverHost: process.env.QUIC_HOST || 'localhost',
+            certPath: process.env.QUIC_CERT_PATH,
+            keyPath: process.env.QUIC_KEY_PATH
+        }
+    });
+    proxy.start(port);
+    // Graceful shutdown
+    process.on('SIGTERM', async () => {
+        logger.info('Received SIGTERM, shutting down gracefully...');
+        await proxy.shutdown();
+        process.exit(0);
+    });
+    process.on('SIGINT', async () => {
+        logger.info('Received SIGINT, shutting down gracefully...');
+        await proxy.shutdown();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=quic-proxy.js.map

package/dist/proxy/quic-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quic-proxy.js","sourceRoot":"","sources":["../../src/proxy/quic-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["// QUIC-enabled Proxy for Anthropic API\n// Optional QUIC transport with automatic HTTP/2 fallback\n\nimport express, { Request, Response as ExpressResponse, NextFunction } from 'express';\nimport { QuicClient, QuicConnectionPool, QuicConfig } from '../transport/quic.js';\nimport { logger } from '../utils/logger.js';\nimport { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';\n\nexport interface QuicProxyConfig {\n  // Base proxy config\n  openrouterApiKey: string;\n  openrouterBaseUrl?: string;\n  defaultModel?: string;\n\n  // Transport selection\n  transport?: 'quic' | 'http2' | 'auto';\n  enableQuic?: boolean;\n\n  // QUIC configuration\n  quic?: QuicConfig;\n\n  // Fallback behavior\n  fallbackToHttp2?: boolean;\n  fallbackTimeout?: number;\n}\n\nexport class QuicEnabledProxy extends AnthropicToOpenRouterProxy {\n  private quicClient?: QuicClient;\n  private quicPool?: QuicConnectionPool;\n  private transport: 'quic' | 'http2' | 'auto';\n  private quicEnabled: boolean;\n  private fallbackToHttp2: boolean;\n\n  constructor(config: QuicProxyConfig) {\n    super({\n      openrouterApiKey: config.openrouterApiKey,\n      openrouterBaseUrl: config.openrouterBaseUrl,\n      defaultModel: config.defaultModel\n    });\n\n    this.transport = config.transport || 'auto';\n    this.quicEnabled = config.enableQuic ?? this.checkQuicFeatureFlag();\n    this.fallbackToHttp2 = config.fallbackToHttp2 ?? true;\n\n    if (this.quicEnabled) {\n      this.initializeQuic(config.quic || {});\n    }\n  }\n\n  /**\n   * Check if QUIC is enabled via environment variable\n   */\n  private checkQuicFeatureFlag(): boolean {\n    const flag = process.env.AGENTIC_FLOW_ENABLE_QUIC;\n    return flag === 'true' || flag === '1';\n  }\n\n  /**\n   * Initialize QUIC client and connection pool\n   */\n  private async initializeQuic(quicConfig: QuicConfig): Promise<void> {\n    try {\n      logger.info('Initializing QUIC transport...', { config: quicConfig });\n\n      this.quicClient = new QuicClient(quicConfig);\n      await this.quicClient.initialize();\n\n      this.quicPool = new QuicConnectionPool(this.quicClient, 20);\n\n      logger.info('QUIC transport initialized successfully');\n    } catch (error) {\n      logger.error('Failed to initialize QUIC transport', { error });\n\n      if (this.fallbackToHttp2) {\n        logger.warn('Falling back to HTTP/2 transport');\n        this.quicEnabled = false;\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Select transport protocol based on configuration and availability\n   */\n  private selectTransport(): 'quic' | 'http2' {\n    if (this.transport === 'quic' && this.quicEnabled) {\n      return 'quic';\n    }\n\n    if (this.transport === 'http2') {\n      return 'http2';\n    }\n\n    // Auto mode: prefer QUIC if available, fallback to HTTP/2\n    if (this.transport === 'auto') {\n      return this.quicEnabled ? 'quic' : 'http2';\n    }\n\n    return 'http2';\n  }\n\n  /**\n   * Send request using selected transport\n   */\n  protected async sendRequest(url: string, options: RequestInit): Promise<Response> {\n    const selectedTransport = this.selectTransport();\n\n    logger.debug('Sending request', {\n      transport: selectedTransport,\n      url,\n      method: options.method\n    });\n\n    if (selectedTransport === 'quic') {\n      return this.sendQuicRequest(url, options);\n    } else {\n      return this.sendHttp2Request(url, options);\n    }\n  }\n\n  /**\n   * Send request over QUIC\n   */\n  private async sendQuicRequest(url: string, options: RequestInit): Promise<Response> {\n    if (!this.quicClient || !this.quicPool) {\n      throw new Error('QUIC client not initialized');\n    }\n\n    try {\n      const urlObj = new URL(url);\n      const connection = await this.quicPool.getConnection(\n        urlObj.hostname,\n        parseInt(urlObj.port) || 443\n      );\n\n      logger.debug('Using QUIC connection', {\n        connectionId: connection.id,\n        url\n      });\n\n      // Prepare headers\n      const headers: Record<string, string> = {};\n      if (options.headers) {\n        const headerEntries = options.headers instanceof Headers\n          ? Array.from((options.headers as any).entries())\n          : Object.entries(options.headers);\n\n        for (const entry of headerEntries as Array<[string, string]>) {\n          headers[entry[0]] = entry[1];\n        }\n      }\n\n      // Convert body to Uint8Array\n      let body: Uint8Array | undefined;\n      if (options.body) {\n        if (typeof options.body === 'string') {\n          body = new TextEncoder().encode(options.body);\n        } else if (options.body instanceof Uint8Array) {\n          body = options.body;\n        } else {\n          body = new TextEncoder().encode(JSON.stringify(options.body));\n        }\n      }\n\n      // Send HTTP/3 request over QUIC\n      const response = await this.quicClient.sendRequest(\n        connection.id,\n        options.method || 'GET',\n        urlObj.pathname + urlObj.search,\n        headers,\n        body\n      );\n\n      logger.info('QUIC request completed', {\n        status: response.status,\n        bytes: response.body.length\n      });\n\n      // Convert to fetch Response\n      const responseText = new TextDecoder().decode(response.body);\n      return new Response(responseText, {\n        status: response.status,\n        headers: new Headers(response.headers)\n      }) as any;\n\n    } catch (error) {\n      logger.error('QUIC request failed', { error, url });\n\n      if (this.fallbackToHttp2) {\n        logger.warn('Falling back to HTTP/2 for this request');\n        return this.sendHttp2Request(url, options);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Send request over HTTP/2 (standard fetch)\n   */\n  private async sendHttp2Request(url: string, options: RequestInit): Promise<Response> {\n    logger.debug('Using HTTP/2 transport', { url });\n    return fetch(url, options) as any;\n  }\n\n  /**\n   * Get transport statistics\n   */\n  getTransportStats(): any {\n    if (this.quicClient) {\n      return {\n        transport: this.selectTransport(),\n        quicEnabled: this.quicEnabled,\n        quicStats: this.quicClient.getStats()\n      };\n    }\n\n    return {\n      transport: 'http2',\n      quicEnabled: false\n    };\n  }\n\n  /**\n   * Shutdown and cleanup\n   */\n  async shutdown(): Promise<void> {\n    if (this.quicPool) {\n      await this.quicPool.clear();\n    }\n\n    if (this.quicClient) {\n      await this.quicClient.shutdown();\n    }\n\n    logger.info('QUIC proxy shutdown complete');\n  }\n}\n\n/**\n * Create QUIC-enabled proxy with configuration\n */\nexport function createQuicProxy(config: QuicProxyConfig): QuicEnabledProxy {\n  const proxy = new QuicEnabledProxy(config);\n\n  logger.info('QUIC proxy created', {\n    transport: config.transport || 'auto',\n    quicEnabled: config.enableQuic ?? (process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true'),\n    fallbackEnabled: config.fallbackToHttp2 ?? true\n  });\n\n  return proxy;\n}\n\n// CLI entry point for QUIC proxy\nif (import.meta.url === `file://${process.argv[1]}`) {\n  const port = parseInt(process.env.PORT || '3000');\n  const openrouterApiKey = process.env.OPENROUTER_API_KEY;\n\n  if (!openrouterApiKey) {\n    console.error('❌ Error: OPENROUTER_API_KEY environment variable required');\n    process.exit(1);\n  }\n\n  const proxy = createQuicProxy({\n    openrouterApiKey,\n    openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,\n    defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL,\n    transport: (process.env.TRANSPORT as 'quic' | 'http2' | 'auto') || 'auto',\n    enableQuic: process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true',\n    quic: {\n      port: parseInt(process.env.QUIC_PORT || '4433'),\n      serverHost: process.env.QUIC_HOST || 'localhost',\n      certPath: process.env.QUIC_CERT_PATH,\n      keyPath: process.env.QUIC_KEY_PATH\n    }\n  });\n\n  proxy.start(port);\n\n  // Graceful shutdown\n  process.on('SIGTERM', async () => {\n    logger.info('Received SIGTERM, shutting down gracefully...');\n    await proxy.shutdown();\n    process.exit(0);\n  });\n\n  process.on('SIGINT', async () => {\n    logger.info('Received SIGINT, shutting down gracefully...');\n    await proxy.shutdown();\n    process.exit(0);\n  });\n}\n"]}

package/dist/proxy/tool-emulation.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Tool Emulation Layer for Models Without Native Function Calling
+ *
+ * Implements two strategies:
+ * 1. ReAct Pattern - Structured reasoning with tool use
+ * 2. Prompt-Based - Direct JSON tool invocation
+ *
+ * Automatically selected based on model capabilities.
+ */
+export interface Tool {
+    name: string;
+    description?: string;
+    input_schema?: {
+        type: string;
+        properties?: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface ToolCall {
+    name: string;
+    arguments: Record<string, any>;
+    id?: string;
+}
+export interface EmulationResult {
+    toolCalls: ToolCall[];
+    reasoning?: string;
+    finalAnswer?: string;
+    confidence: number;
+}
+/**
+ * ReAct Pattern Implementation
+ * Best for: Models with 32k+ context, complex multi-step tasks
+ */
+export declare class ReActEmulator {
+    private tools;
+    constructor(tools: Tool[]);
+    /**
+     * Build ReAct prompt with tool catalog
+     */
+    buildPrompt(userMessage: string, previousSteps?: string): string;
+    /**
+     * Parse ReAct response and extract tool calls
+     */
+    parseResponse(response: string): {
+        toolCall?: ToolCall;
+        thought?: string;
+        finalAnswer?: string;
+    };
+    /**
+     * Build prompt with observation after tool execution
+     */
+    appendObservation(previousPrompt: string, observation: string): string;
+}
+/**
+ * Prompt-Based Tool Emulation
+ * Best for: Simple tasks, models with limited context
+ */
+export declare class PromptEmulator {
+    private tools;
+    constructor(tools: Tool[]);
+    /**
+     * Build simple prompt for tool invocation
+     */
+    buildPrompt(userMessage: string): string;
+    /**
+     * Parse response - either tool call JSON or regular text
+     */
+    parseResponse(response: string): {
+        toolCall?: ToolCall;
+        textResponse?: string;
+    };
+}
+/**
+ * Unified Tool Emulation Interface
+ */
+export declare class ToolEmulator {
+    private tools;
+    private strategy;
+    private reactEmulator;
+    private promptEmulator;
+    constructor(tools: Tool[], strategy: 'react' | 'prompt');
+    /**
+     * Build prompt based on selected strategy
+     */
+    buildPrompt(userMessage: string, context?: {
+        previousSteps?: string;
+    }): string;
+    /**
+     * Parse model response and extract tool calls
+     */
+    parseResponse(response: string): {
+        toolCall?: ToolCall;
+        finalAnswer?: string;
+        thought?: string;
+        textResponse?: string;
+    };
+    /**
+     * Append observation (ReAct only)
+     */
+    appendObservation(prompt: string, observation: string): string;
+    /**
+     * Validate tool call against schema
+     */
+    validateToolCall(toolCall: ToolCall): {
+        valid: boolean;
+        errors?: string[];
+    };
+    /**
+     * Get confidence score for emulation result
+     * Based on: JSON validity, schema compliance, reasoning quality
+     */
+    getConfidence(parsed: ReturnType<typeof this.parseResponse>): number;
+}
+/**
+ * Execute tool emulation loop
+ */
+export declare function executeEmulation(emulator: ToolEmulator, userMessage: string, modelCall: (prompt: string) => Promise<string>, toolExecutor: (toolCall: ToolCall) => Promise<any>, options?: {
+    maxIterations?: number;
+    verbose?: boolean;
+}): Promise<EmulationResult>;
+//# sourceMappingURL=tool-emulation.d.ts.map

package/dist/proxy/utils/logger.js

@@ -0,0 +1,59 @@
+class Logger {
+    constructor() {
+        this.context = {};
+    }
+    setContext(ctx) {
+        this.context = { ...this.context, ...ctx };
+    }
+    log(level, message, data) {
+        // Skip all logs if QUIET mode is enabled (unless it's an error)
+        if (process.env.QUIET === 'true' && level !== 'error') {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const logEntry = {
+            timestamp,
+            level,
+            message,
+            ...this.context,
+            ...data
+        };
+        // Structured JSON logging for production
+        if (process.env.NODE_ENV === 'production') {
+            console.log(JSON.stringify(logEntry));
+        }
+        else {
+            // Human-readable for development
+            const prefix = `[${timestamp}] ${level.toUpperCase()}`;
+            const contextStr = Object.keys({ ...this.context, ...data }).length > 0
+                ? ` ${JSON.stringify({ ...this.context, ...data })}`
+                : '';
+            console.log(`${prefix}: ${message}${contextStr}`);
+        }
+    }
+    debug(message, data) {
+        // Skip debug logs unless DEBUG or VERBOSE environment variable is set
+        if (!process.env.DEBUG && !process.env.VERBOSE) {
+            return;
+        }
+        this.log('debug', message, data);
+    }
+    info(message, data) {
+        // Skip info logs unless VERBOSE is set
+        if (!process.env.DEBUG && !process.env.VERBOSE) {
+            return;
+        }
+        this.log('info', message, data);
+    }
+    warn(message, data) {
+        // Skip warnings unless VERBOSE is set
+        if (!process.env.DEBUG && !process.env.VERBOSE) {
+            return;
+        }
+        this.log('warn', message, data);
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+}
+export const logger = new Logger();

package/dist/proxy/websocket-proxy.d.ts

@@ -0,0 +1,39 @@
+/**
+ * WebSocket Proxy for LLM Streaming
+ *
+ * Features:
+ * - Bidirectional: Full-duplex communication
+ * - Mobile-friendly: Better for unstable connections
+ * - Lower overhead: No HTTP headers per message
+ * - Reconnection: Automatic retry on disconnect
+ * - Universal support: Works everywhere (browsers, mobile, desktop)
+ *
+ * Use Case: Fallback for unreliable connections (mobile, poor WiFi)
+ */
+export interface WebSocketProxyConfig {
+    port: number;
+    geminiApiKey?: string;
+    geminiBaseUrl?: string;
+    pingInterval?: number;
+    pingTimeout?: number;
+    maxConnections?: number;
+    connectionTimeout?: number;
+}
+export declare class WebSocketProxy {
+    private wss;
+    private server;
+    private config;
+    private clients;
+    private pingInterval?;
+    private activeConnections;
+    constructor(config: WebSocketProxyConfig);
+    private setupHandlers;
+    private setupHeartbeat;
+    private handleStreamingRequest;
+    private handleNonStreamingRequest;
+    private convertAnthropicToGemini;
+    private convertGeminiToAnthropic;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=websocket-proxy.d.ts.map

package/dist/reasoningbank/AdvancedMemory.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Advanced Memory System - Full Implementation for v1.7.1
+ *
+ * Provides high-level memory operations on top of HybridReasoningBank:
+ * - Auto-consolidation (patterns → skills) using NightlyLearner
+ * - Episodic replay (learn from failures)
+ * - Causal reasoning (what-if analysis)
+ * - Skill composition (combine learned skills)
+ *
+ * @example
+ * ```typescript
+ * import { AdvancedMemorySystem } from 'agentic-flow/reasoningbank';
+ *
+ * const memory = new AdvancedMemorySystem();
+ *
+ * // Auto-consolidate patterns into skills
+ * const result = await memory.autoConsolidate({ minUses: 3, minSuccessRate: 0.7 });
+ *
+ * // Learn from failures
+ * const failures = await memory.replayFailures('authentication', 5);
+ *
+ * // Causal what-if analysis
+ * const insight = await memory.whatIfAnalysis('add caching');
+ * ```
+ */
+export interface FailureAnalysis {
+    critique: string;
+    whatWentWrong: string[];
+    howToFix: string[];
+    similarFailures: number;
+}
+export interface SkillComposition {
+    availableSkills: any[];
+    compositionPlan: string;
+    expectedSuccessRate: number;
+}
+export interface ConsolidationResult {
+    skillsCreated: number;
+    causalEdgesCreated: number;
+    patternsAnalyzed: number;
+    executionTimeMs: number;
+    recommendations: string[];
+}
+export declare class AdvancedMemorySystem {
+    private reasoning;
+    private learner;
+    private pool;
+    constructor(options?: {
+        preferWasm?: boolean;
+    });
+    /**
+     * Auto-consolidate successful patterns into skills
+     *
+     * Uses NightlyLearner to:
+     * 1. Discover causal edges from episode patterns
+     * 2. Complete A/B experiments
+     * 3. Calculate uplift for experiments
+     * 4. Prune low-confidence edges
+     * 5. Consolidate high-performing patterns into skills
+     */
+    autoConsolidate(options?: {
+        minUses?: number;
+        minSuccessRate?: number;
+        lookbackDays?: number;
+        dryRun?: boolean;
+    }): Promise<ConsolidationResult>;
+    /**
+     * Learn from past failures with episodic replay
+     *
+     * Retrieves failed attempts, extracts lessons, and provides recommendations
+     */
+    replayFailures(task: string, k?: number): Promise<FailureAnalysis[]>;
+    /**
+     * Extract critique from failure pattern
+     */
+    private extractCritique;
+    /**
+     * Analyze what went wrong in a failure
+     */
+    private analyzeFailure;
+    /**
+     * Generate fix recommendations
+     */
+    private generateFixes;
+    /**
+     * What-if causal analysis
+     *
+     * Analyzes potential outcomes of taking an action based on causal evidence
+     */
+    whatIfAnalysis(action: string): Promise<{
+        action: string;
+        avgReward: number;
+        avgUplift: number;
+        confidence: number;
+        evidenceCount: number;
+        recommendation: 'DO_IT' | 'AVOID' | 'NEUTRAL';
+        expectedImpact: string;
+    }>;
+    /**
+     * Compose multiple skills for a complex task
+     *
+     * Finds relevant skills and creates an execution plan
+     */
+    composeSkills(task: string, k?: number): Promise<SkillComposition>;
+    /**
+     * Run automated learning cycle
+     *
+     * Discovers causal edges, consolidates skills, and optimizes performance
+     */
+    runLearningCycle(): Promise<ConsolidationResult>;
+    /**
+     * Get comprehensive memory statistics
+     */
+    getStats(): {
+        reasoningBank: any;
+        learner: string;
+        memoryPool: any;
+    };
+}
+//# sourceMappingURL=AdvancedMemory.d.ts.map