adaptive-memory-multi-model-router 1.9.5 → 2.0.1

package/dist/index.js

@@ -1,364 +1,85 @@
 "use strict";
-/**
- * A3M Router - Adaptive Memory Multi-Model Router v1.7.1
- *
- * Parallel Multi-LLM Processing with Streaming, Caching, Cost Tracking, Reliability
- * + Reference Architecture to Full TMLPD (Episodic Memory, MCTS, HALO)
- *
- * @example
- * ```typescript
- * import { createTMLPD, HALOOrchestrator, EpisodicMemoryStore } from "tmlpd-pi";
- *
- * // Lightweight usage (core features)
- * const tmlpd = createTMLPD({ cache: { ttl_seconds: 3600 } });
- * const result = await tmlpd.executeParallel(prompt, ["gpt-4o", "claude"]);
- *
- * // Advanced: HALO orchestration with episodic memory
- * const halo = new HALOOrchestrator({ maxConcurrent: 3, enableMCTS: true });
- * const haloResult = await halo.execute("Build a REST API", async (subtask, agent) => {
- *   // Execute via agent
- * });
- *
- * // Query episodic memory
- * const similar = memory.getSimilarTasks("Python async API", 5);
- * ```
- */
+// A3M Router - Main Entry Point
+// Version: 2.0.0
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TMLPD_PI_TOOLS = exports.EagleSpeculative = exports.MedusaPredictor = exports.estimateSpeedupPotential = exports.speculativeBatch = exports.SpeculativeDecoder = exports.createWarmedCache = exports.PrefixCache = exports.MODEL_PROFILES = exports.updateModelProfile = exports.extractQueryFeatures = exports.recommendForTask = exports.routeBatch = exports.routeQuery = exports.executeBatch = exports.BatchProcessor = exports.createLMStudioProvider = exports.createVLLMProvider = exports.createOllamaProvider = exports.LocalProviderManager = exports.LocalProvider = exports.calculateCompressionRatio = exports.truncateToTokenBudget = exports.truncateMessages = exports.compressText = exports.isonDecode = exports.isonEncode = exports.MODEL_COSTS = exports.findCheapestModels = exports.listModelsByCost = exports.getModelCost = exports.estimateCostFromText = exports.estimateCost = exports.countTokens = exports.HALOOrchestrator = exports.MCTSWorkflowOptimizer = exports.EpisodicMemoryStore = exports.DEFAULT_RETRY_CONFIG = exports.isRetryableStatus = exports.calculateRetryDelay = exports.withRetry = exports.CircuitBreaker = exports.ProviderRegistry = exports.CostTracker = exports.ResponseCache = exports.TMLPDTools = exports.createTMLPD = void 0;
-const tmlpdTools_1 = require("./tools/tmlpdTools");
-Object.defineProperty(exports, "createTMLPD", { enumerable: true, get: function () { return tmlpdTools_1.createTMLPD; } });
-Object.defineProperty(exports, "TMLPDTools", { enumerable: true, get: function () { return tmlpdTools_1.TMLPDTools; } });
-const responseCache_1 = require("./cache/responseCache");
-Object.defineProperty(exports, "ResponseCache", { enumerable: true, get: function () { return responseCache_1.ResponseCache; } });
-const costTracker_1 = require("./cost/costTracker");
-Object.defineProperty(exports, "CostTracker", { enumerable: true, get: function () { return costTracker_1.CostTracker; } });
-const registry_1 = require("./providers/registry");
-Object.defineProperty(exports, "ProviderRegistry", { enumerable: true, get: function () { return registry_1.ProviderRegistry; } });
-const providerConfig_1 = require("./providers/providerConfig");
-Object.defineProperty(exports, "loadProviders", { enumerable: true, get: function () { return providerConfig_1.loadProviders; } });
-Object.defineProperty(exports, "getAvailableProviders", { enumerable: true, get: function () { return providerConfig_1.getAvailableProviders; } });
-Object.defineProperty(exports, "healthCheckProvider", { enumerable: true, get: function () { return providerConfig_1.healthCheck; } });
-Object.defineProperty(exports, "registerProvider", { enumerable: true, get: function () { return providerConfig_1.registerProvider; } });
-Object.defineProperty(exports, "deregisterProvider", { enumerable: true, get: function () { return providerConfig_1.deregisterProvider; } });
-Object.defineProperty(exports, "findCheapestAvailableProvider", { enumerable: true, get: function () { return providerConfig_1.findCheapestAvailableProvider; } });
-Object.defineProperty(exports, "findFastestAvailableProvider", { enumerable: true, get: function () { return providerConfig_1.findFastestAvailableProvider; } });
-Object.defineProperty(exports, "DEFAULT_PROVIDERS", { enumerable: true, get: function () { return providerConfig_1.DEFAULT_PROVIDERS; } });
-const reliability_1 = require("./utils/reliability");
-Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return reliability_1.CircuitBreaker; } });
-Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return reliability_1.withRetry; } });
-Object.defineProperty(exports, "calculateRetryDelay", { enumerable: true, get: function () { return reliability_1.calculateRetryDelay; } });
-Object.defineProperty(exports, "isRetryableStatus", { enumerable: true, get: function () { return reliability_1.isRetryableStatus; } });
-Object.defineProperty(exports, "DEFAULT_RETRY_CONFIG", { enumerable: true, get: function () { return reliability_1.DEFAULT_RETRY_CONFIG; } });
-const episodicMemory_1 = require("./memory/episodicMemory");
-Object.defineProperty(exports, "EpisodicMemoryStore", { enumerable: true, get: function () { return episodicMemory_1.EpisodicMemoryStore; } });
-const mctsWorkflow_1 = require("./orchestration/mctsWorkflow");
-Object.defineProperty(exports, "MCTSWorkflowOptimizer", { enumerable: true, get: function () { return mctsWorkflow_1.MCTSWorkflowOptimizer; } });
-const haloOrchestrator_1 = require("./orchestration/haloOrchestrator");
-Object.defineProperty(exports, "HALOOrchestrator", { enumerable: true, get: function () { return haloOrchestrator_1.HALOOrchestrator; } });
-const tokenUtils_1 = require("./utils/tokenUtils");
-Object.defineProperty(exports, "countTokens", { enumerable: true, get: function () { return tokenUtils_1.countTokens; } });
-Object.defineProperty(exports, "estimateCost", { enumerable: true, get: function () { return tokenUtils_1.estimateCost; } });
-Object.defineProperty(exports, "estimateCostFromText", { enumerable: true, get: function () { return tokenUtils_1.estimateCostFromText; } });
-Object.defineProperty(exports, "getModelCost", { enumerable: true, get: function () { return tokenUtils_1.getModelCost; } });
-Object.defineProperty(exports, "listModelsByCost", { enumerable: true, get: function () { return tokenUtils_1.listModelsByCost; } });
-Object.defineProperty(exports, "findCheapestModels", { enumerable: true, get: function () { return tokenUtils_1.findCheapestModels; } });
-Object.defineProperty(exports, "MODEL_COSTS", { enumerable: true, get: function () { return tokenUtils_1.MODEL_COSTS; } });
-const compression_1 = require("./utils/compression");
-Object.defineProperty(exports, "isonEncode", { enumerable: true, get: function () { return compression_1.isonEncode; } });
-Object.defineProperty(exports, "isonDecode", { enumerable: true, get: function () { return compression_1.isonDecode; } });
-Object.defineProperty(exports, "compressText", { enumerable: true, get: function () { return compression_1.compressText; } });
-Object.defineProperty(exports, "truncateMessages", { enumerable: true, get: function () { return compression_1.truncateMessages; } });
-Object.defineProperty(exports, "truncateToTokenBudget", { enumerable: true, get: function () { return compression_1.truncateToTokenBudget; } });
-Object.defineProperty(exports, "calculateCompressionRatio", { enumerable: true, get: function () { return compression_1.calculateCompressionRatio; } });
-const localProvider_1 = require("./providers/localProvider");
-Object.defineProperty(exports, "LocalProvider", { enumerable: true, get: function () { return localProvider_1.LocalProvider; } });
-Object.defineProperty(exports, "LocalProviderManager", { enumerable: true, get: function () { return localProvider_1.LocalProviderManager; } });
-Object.defineProperty(exports, "createOllamaProvider", { enumerable: true, get: function () { return localProvider_1.createOllamaProvider; } });
-Object.defineProperty(exports, "createVLLMProvider", { enumerable: true, get: function () { return localProvider_1.createVLLMProvider; } });
-Object.defineProperty(exports, "createLMStudioProvider", { enumerable: true, get: function () { return localProvider_1.createLMStudioProvider; } });
-const batchProcessor_1 = require("./utils/batchProcessor");
-Object.defineProperty(exports, "BatchProcessor", { enumerable: true, get: function () { return batchProcessor_1.BatchProcessor; } });
-Object.defineProperty(exports, "executeBatch", { enumerable: true, get: function () { return batchProcessor_1.executeBatch; } });
-const advancedRouter_1 = require("./routing/advancedRouter");
+exports.createProxyServer = exports.CostAnalytics = exports.GuardrailEngine = exports.SemanticCache = exports.MODEL_COSTS = exports.estimateTokens = exports.countTokens = exports.MemoryTree = exports.CostTracker = exports.saveConfig = exports.loadConfig = exports.findFastestAvailableProvider = exports.findCheapestAvailableProvider = exports.checkAllProviders = exports.healthCheck = exports.updateProvider = exports.deregisterProvider = exports.registerProvider = exports.getAvailableProviders = exports.DEFAULT_PROVIDERS = exports.getProviderHealth = exports.updateModelProfile = exports.MODEL_PROFILES = exports.extractQueryFeatures = exports.recommendForTask = exports.routeBatch = exports.routeQuery = void 0;
+exports.createA3MRouter = createA3MRouter;
+// ============================================================
+// ROUTING ENGINE
+// ============================================================
+var advancedRouter_1 = require("./routing/advancedRouter");
 Object.defineProperty(exports, "routeQuery", { enumerable: true, get: function () { return advancedRouter_1.routeQuery; } });
 Object.defineProperty(exports, "routeBatch", { enumerable: true, get: function () { return advancedRouter_1.routeBatch; } });
 Object.defineProperty(exports, "recommendForTask", { enumerable: true, get: function () { return advancedRouter_1.recommendForTask; } });
 Object.defineProperty(exports, "extractQueryFeatures", { enumerable: true, get: function () { return advancedRouter_1.extractQueryFeatures; } });
-Object.defineProperty(exports, "updateModelProfile", { enumerable: true, get: function () { return advancedRouter_1.updateModelProfile; } });
 Object.defineProperty(exports, "MODEL_PROFILES", { enumerable: true, get: function () { return advancedRouter_1.MODEL_PROFILES; } });
-const prefixCache_1 = require("./cache/prefixCache");
-Object.defineProperty(exports, "PrefixCache", { enumerable: true, get: function () { return prefixCache_1.PrefixCache; } });
-Object.defineProperty(exports, "createWarmedCache", { enumerable: true, get: function () { return prefixCache_1.createWarmedCache; } });
-const speculativeDecoding_1 = require("./utils/speculativeDecoding");
-Object.defineProperty(exports, "SpeculativeDecoder", { enumerable: true, get: function () { return speculativeDecoding_1.SpeculativeDecoder; } });
-Object.defineProperty(exports, "speculativeBatch", { enumerable: true, get: function () { return speculativeDecoding_1.speculativeBatch; } });
-Object.defineProperty(exports, "estimateSpeedupPotential", { enumerable: true, get: function () { return speculativeDecoding_1.estimateSpeedupPotential; } });
-Object.defineProperty(exports, "MedusaPredictor", { enumerable: true, get: function () { return speculativeDecoding_1.MedusaPredictor; } });
-Object.defineProperty(exports, "EagleSpeculative", { enumerable: true, get: function () { return speculativeDecoding_1.EagleSpeculative; } });
-// PI Tool definitions (for PI agent integration)
-exports.TMLPD_PI_TOOLS = [
-    {
-        name: "tmlpd_execute",
-        description: "Execute prompt across multiple LLM providers in parallel. Optimizes for cost-quality tradeoff with automatic model selection. Use when comparing multiple AI responses or needing faster results via parallel execution.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                prompt: { type: "string", description: "The prompt to execute" },
-                models: { type: "array", items: { type: "string" }, description: "Optional model list (auto-selects if omitted)" },
-                streaming: { type: "object", properties: { enabled: { type: "boolean" }, chunk_size: { type: "number" } } }
-            },
-            required: ["prompt"]
-        }
-    },
-    {
-        name: "tmlpd_execute_single",
-        description: "Execute with single model via smart routing. Analyzes prompt to select optimal agent based on task type (coding, explanation, analysis, etc.) with cost-quality optimization.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                prompt: { type: "string", description: "The prompt to execute" },
-                model: { type: "string", description: "Optional specific model" }
-            },
-            required: ["prompt"]
-        }
-    },
-    {
-        name: "tmlpd_cost_summary",
-        description: "Get real-time cost tracking summary. Shows spending by provider, model, daily/monthly breakdowns, and remaining budget. Essential for cost monitoring in production.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "tmlpd_cache_stats",
-        description: "Get response cache statistics. Shows hit rate, cache size, and effectiveness. Cache hits cost $0 and provide instant responses.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "tmlpd_provider_status",
-        description: "Get status of all configured LLM providers. Shows readiness, cooldown status, failure counts. Use for debugging or selecting specific providers.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "tmlpd_invalidate_cache",
-        description: "Invalidate cached responses. Use when prompt content has changed and fresh response needed, or to clear stale cache entries.",
-        inputSchema: {
-            type: "object",
-            properties: { model: { type: "string", description: "Optional model to invalidate (all if omitted)" } }
-        }
-    },
-    {
-        name: "tmlpd_get_budget",
-        description: "Get remaining budget for cost controls. Returns daily, monthly, and per-model limits. Use for budget enforcement and alerting.",
-        inputSchema: { type: "object", properties: {} }
-    },
-    {
-        name: "tmlpd_halo_execute",
-        description: "Execute via HALO (Hierarchical Autonomous Logic-Oriented) orchestrator with 3-tier planning: decompose → assign → execute. Includes episodic memory for learning from past executions. For complex multi-step tasks.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_description: { type: "string", description: "Task to execute" },
-                max_concurrent: { type: "number", description: "Max parallel executions (default: 3)" },
-                enable_mcts: { type: "boolean", description: "Enable MCTS optimization (slower but better)" }
-            },
-            required: ["task_description"]
-        }
-    },
-    {
-        name: "tmlpd_episodic_query",
-        description: "Query episodic memory for similar past tasks. Useful for learning from past executions and improving future routing decisions.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                task_description: { type: "string", description: "Task to find similar executions for" },
-                limit: { type: "number", description: "Max results (default: 5)" }
-            },
-            required: ["task_description"]
-        }
-    },
-    {
-        name: "tmlpd_count_tokens",
-        description: "Count tokens in text for cost estimation. Supports all major models (GPT-4, Claude, Gemini, Llama). Use for estimating costs before execution or calculating context window usage.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                text: { type: "string", description: "Text to count tokens in" },
-                model: { type: "string", description: "Model for tokenization (default: gpt-4o)" }
-            },
-            required: ["text"]
-        }
-    },
-    {
-        name: "tmlpd_compress_context",
-        description: "Compress context/messages using ISON encoding for token reduction. Reduces context by ~20-40% while preserving meaning. Useful for fitting more content in context windows.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                messages: { type: "array", description: "Messages to compress", items: { type: "object" } },
-                strategy: { type: "string", enum: ["smart", "first", "last"], description: "Compression strategy (default: smart)" },
-                max_tokens: { type: "number", description: "Target token budget" }
-            },
-            required: ["messages"]
-        }
-    },
-    {
-        name: "tmlpd_local_generate",
-        description: "Generate using local LLM runtime (Ollama, vLLM, LM Studio). Zero cost, privacy-preserving. Use for development, testing, or when local GPU available. Falls back to cloud if local unavailable.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                prompt: { type: "string", description: "Prompt for generation" },
-                runtime: { type: "string", enum: ["ollama", "vllm", "lmstudio"], description: "Local runtime type" },
-                model: { type: "string", description: "Model name (default: llama-3.3-70b)" }
-            },
-            required: ["prompt", "runtime"]
-        }
-    },
-    {
-        name: "tmlpd_batch_execute",
-        description: "Execute batch of prompts with concurrency control. Supports priority queuing, progress callbacks, rate limiting. Use for processing multiple prompts efficiently.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                prompts: { type: "array", items: { type: "string" }, description: "Prompts to execute" },
-                concurrency: { type: "number", description: "Max parallel executions (default: 5)" },
-                model: { type: "string", description: "Model to use (default: gpt-4o)" }
-            },
-            required: ["prompts"]
-        }
-    }
-];
-/**
- * Reference to Full TMLPD
- *
- * This package provides:
- * - Core: streaming, caching, cost tracking, reliability
- * - Reference: episodic memory, MCTS, HALO orchestrator
- *
- * For production with full features:
- * - Python TMLPD: https://github.com/Das-rebel/tmlpd-skill
- * - Full memory: 3-tier (episodic + semantic + working)
- * - Full MCTS: UCB1, deterministic rollouts, strategy caching
- * - Full HALO: NLP decomposition, capability matching, verification
- */
-exports.default = {
-    createTMLPD: tmlpdTools_1.createTMLPD,
-    TMLPDTools: tmlpdTools_1.TMLPDTools,
-    TMLPD_PI_TOOLS: exports.TMLPD_PI_TOOLS
-};
-//# sourceMappingURL=index.js.map
-// ============================================
-// A3M Router - Adaptive Memory Multi-Model Router
-// Re-exports for the A3M Router package
-// ============================================
-
-// Memory
-const memoryTree_1 = require("./memory/memoryTree");
+Object.defineProperty(exports, "updateModelProfile", { enumerable: true, get: function () { return advancedRouter_1.updateModelProfile; } });
+Object.defineProperty(exports, "getProviderHealth", { enumerable: true, get: function () { return advancedRouter_1.getProviderHealth; } });
+// ============================================================
+// PROVIDERS
+// ============================================================
+var providerConfig_1 = require("./providers/providerConfig");
+Object.defineProperty(exports, "DEFAULT_PROVIDERS", { enumerable: true, get: function () { return providerConfig_1.DEFAULT_PROVIDERS; } });
+Object.defineProperty(exports, "getAvailableProviders", { enumerable: true, get: function () { return providerConfig_1.getAvailableProviders; } });
+Object.defineProperty(exports, "registerProvider", { enumerable: true, get: function () { return providerConfig_1.registerProvider; } });
+Object.defineProperty(exports, "deregisterProvider", { enumerable: true, get: function () { return providerConfig_1.deregisterProvider; } });
+Object.defineProperty(exports, "updateProvider", { enumerable: true, get: function () { return providerConfig_1.updateProvider; } });
+Object.defineProperty(exports, "healthCheck", { enumerable: true, get: function () { return providerConfig_1.healthCheck; } });
+Object.defineProperty(exports, "checkAllProviders", { enumerable: true, get: function () { return providerConfig_1.checkAllProviders; } });
+Object.defineProperty(exports, "findCheapestAvailableProvider", { enumerable: true, get: function () { return providerConfig_1.findCheapestAvailableProvider; } });
+Object.defineProperty(exports, "findFastestAvailableProvider", { enumerable: true, get: function () { return providerConfig_1.findFastestAvailableProvider; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return providerConfig_1.loadConfig; } });
+Object.defineProperty(exports, "saveConfig", { enumerable: true, get: function () { return providerConfig_1.saveConfig; } });
+// ============================================================
+// COST TRACKING
+// ============================================================
+var costTracker_1 = require("./cost/costTracker");
+Object.defineProperty(exports, "CostTracker", { enumerable: true, get: function () { return costTracker_1.CostTracker; } });
+// ============================================================
+// MEMORY
+// ============================================================
+var memoryTree_1 = require("./memory/memoryTree");
 Object.defineProperty(exports, "MemoryTree", { enumerable: true, get: function () { return memoryTree_1.MemoryTree; } });
-
-const autoFetch_1 = require("./memory/autoFetch");
-Object.defineProperty(exports, "AutoFetch", { enumerable: true, get: function () { return autoFetch_1.AutoFetch; } });
-
-const obsidianVault_1 = require("./memory/obsidianVault");
-Object.defineProperty(exports, "ObsidianVault", { enumerable: true, get: function () { return obsidianVault_1.ObsidianVault; } });
-
-const enhancedCompression_1 = require("./utils/enhancedCompression");
-Object.defineProperty(exports, "EnhancedCompression", { enumerable: true, get: function () { return enhancedCompression_1.EnhancedCompression; } });
-
-// OAuth
-const oauth_1 = require("./integrations/oauth");
-Object.defineProperty(exports, "OAuthManager", { enumerable: true, get: function () { return oauth_1.OAuthManager; } });
-Object.defineProperty(exports, "OAUTH_PROVIDERS", { enumerable: true, get: function () { return oauth_1.OAUTH_PROVIDERS; } });
-
-// Integrations
-const integrations_1 = require("./integrations/index");
-Object.defineProperty(exports, "GitHubIntegration", { enumerable: true, get: function () { return integrations_1.GitHubIntegration; } });
-Object.defineProperty(exports, "SlackIntegration", { enumerable: true, get: function () { return integrations_1.SlackIntegration; } });
-Object.defineProperty(exports, "TelegramIntegration", { enumerable: true, get: function () { return integrations_1.TelegramIntegration; } });
-Object.defineProperty(exports, "NotionIntegration", { enumerable: true, get: function () { return integrations_1.NotionIntegration; } });
-Object.defineProperty(exports, "LinearIntegration", { enumerable: true, get: function () { return integrations_1.LinearIntegration; } });
-Object.defineProperty(exports, "JiraIntegration", { enumerable: true, get: function () { return integrations_1.JiraIntegration; } });
-Object.defineProperty(exports, "GmailIntegration", { enumerable: true, get: function () { return integrations_1.GmailIntegration; } });
-Object.defineProperty(exports, "DiscordIntegration", { enumerable: true, get: function () { return integrations_1.DiscordIntegration; } });
-Object.defineProperty(exports, "AirtableIntegration", { enumerable: true, get: function () { return integrations_1.AirtableIntegration; } });
-Object.defineProperty(exports, "GoogleCalendarIntegration", { enumerable: true, get: function () { return integrations_1.GoogleCalendarIntegration; } });
-Object.defineProperty(exports, "createIntegration", { enumerable: true, get: function () { return integrations_1.createIntegration; } });
-
-// Convenience: createA3MRouter factory
-/**
- * Create a configured A3M Router instance
- * @param {Object} config - Router configuration
- * @param {Object} config.providers - LLM provider configs
- * @param {Object} config.memory - Memory settings
- * @param {Object} config.cache - Cache settings
- * @param {Object} config.cost - Cost tracking settings
- * @returns {Object} Router instance with route(), routeBatch(), recommend(), memory, cache, compression, oauth, vault, providers properties
- */
-function createA3MRouter(config = {}) {
-  const { providers = {}, memory = {}, cache = {}, cost = {} } = config;
-  
-  const memoryTree = new memoryTree_1.MemoryTree(memory);
-  const prefixCache = new (require("./cache/prefixCache").PrefixCache)(cache);
-  const costTracker = new (require("./cost/costTracker").CostTracker)(cost);
-  // Alias getSummary as getStatus for convenience
-  if (typeof costTracker.getSummary === "function" && !costTracker.getStatus) {
-    costTracker.getStatus = costTracker.getSummary.bind(costTracker);
-  }
-  const autoFetch = new autoFetch_1.AutoFetch(memory);
-  const compression = new enhancedCompression_1.EnhancedCompression();
-  const oauth = new oauth_1.OAuthManager();
-  const vault = new obsidianVault_1.ObsidianVault();
-  
-  return {
-    // Routing
-    route: (query, options) => (0, require("./routing/advancedRouter").routeQuery)(query, options),
-    routeBatch: (queries, options) => (0, require("./routing/advancedRouter").routeBatch)(queries, options),
-    recommend: (task) => (0, require("./routing/advancedRouter").recommendForTask)(task),
-    
-    // Memory
-    memory: memoryTree,
-    autoFetch,
-    vault,
-    compression,
-    
-    // Cache & Cost
-    cache: prefixCache,
-    costTracker,
-    
-    // Auth
-    oauth,
-    
-    // Providers (from existing TMLPD)
-    providers: new (require("./providers/registry").ProviderRegistry)(),
-    
-    // Integrations
-    createIntegration: integrations_1.createIntegration,
-    
-    // Utils
-    countTokens: require("./utils/tokenUtils").countTokens,
-    estimateCost: require("./utils/tokenUtils").estimateCost,
-  };
+// ============================================================
+// UTILITIES
+// ============================================================
+var tokenUtils_1 = require("./utils/tokenUtils");
+Object.defineProperty(exports, "countTokens", { enumerable: true, get: function () { return tokenUtils_1.countTokens; } });
+Object.defineProperty(exports, "estimateTokens", { enumerable: true, get: function () { return tokenUtils_1.estimateTokens; } });
+var tokenUtils_2 = require("./utils/tokenUtils");
+Object.defineProperty(exports, "MODEL_COSTS", { enumerable: true, get: function () { return tokenUtils_2.MODEL_COSTS; } });
+// ============================================================
+// v2.0.0 FEATURES
+// ============================================================
+var semanticCache_1 = require("./cache/semanticCache");
+Object.defineProperty(exports, "SemanticCache", { enumerable: true, get: function () { return semanticCache_1.SemanticCache; } });
+var guardrails_1 = require("./security/guardrails");
+Object.defineProperty(exports, "GuardrailEngine", { enumerable: true, get: function () { return guardrails_1.GuardrailEngine; } });
+var costAnalytics_1 = require("./analytics/costAnalytics");
+Object.defineProperty(exports, "CostAnalytics", { enumerable: true, get: function () { return costAnalytics_1.CostAnalytics; } });
+var proxyServer_1 = require("./server/proxyServer");
+Object.defineProperty(exports, "createProxyServer", { enumerable: true, get: function () { return proxyServer_1.createProxyServer; } });
+// ============================================================
+// CONVENIENCE: Create a router instance
+// ============================================================
+const advancedRouter_2 = require("./routing/advancedRouter");
+const providerConfig_2 = require("./providers/providerConfig");
+const costTracker_2 = require("./cost/costTracker");
+const memoryTree_2 = require("./memory/memoryTree");
+function createA3MRouter(options) {
+    const costTracker = new costTracker_2.CostTracker();
+    const memoryTree = new memoryTree_2.MemoryTree();
+    return {
+        route: advancedRouter_2.routeQuery,
+        routeBatch: advancedRouter_2.routeBatch,
+        recommendForTask: advancedRouter_2.recommendForTask,
+        getAvailableProviders: providerConfig_2.getAvailableProviders,
+        healthCheck: providerConfig_2.healthCheck,
+        costTracker,
+        memoryTree,
+        options: options || {},
+    };
 }
-exports.createA3MRouter = createA3MRouter;
-
-// Provider Configuration (generic, user-configurable) - additional exports
-const providerConfig = require("./providers/providerConfig");
-Object.defineProperty(exports, "providerConfig", { enumerable: true, get: function () { return providerConfig; } });
-Object.defineProperty(exports, "saveProviderConfig", { enumerable: true, get: function () { return providerConfig.saveConfig; } });
-
-// Security features
-const inputValidation = require("./security/inputValidation");
-Object.defineProperty(exports, "InputValidator", { enumerable: true, get: function () { return inputValidation.InputValidator; } });
-Object.defineProperty(exports, "sanitizeInput", { enumerable: true, get: function () { return inputValidation.sanitizeInput; } });
-Object.defineProperty(exports, "validateInput", { enumerable: true, get: function () { return inputValidation.validateInput; } });
-Object.defineProperty(exports, "detectInjection", { enumerable: true, get: function () { return inputValidation.detectInjection; } });
-Object.defineProperty(exports, "detectPII", { enumerable: true, get: function () { return inputValidation.detectPII; } });
-
-// GEO (Generative Engine Optimization) features
-const generativeEngineOptimization = require("./geo/generativeEngineOptimization");
-Object.defineProperty(exports, "GenerativeEngineOptimizer", { enumerable: true, get: function () { return generativeEngineOptimization.GenerativeEngineOptimizer; } });
-Object.defineProperty(exports, "getCodeForIntent", { enumerable: true, get: function () { return generativeEngineOptimization.getCodeForIntent; } });
-Object.defineProperty(exports, "searchIntents", { enumerable: true, get: function () { return generativeEngineOptimization.searchIntents; } });
-Object.defineProperty(exports, "getPackageMetadata", { enumerable: true, get: function () { return generativeEngineOptimization.getPackageMetadata; } });
-Object.defineProperty(exports, "generateAIDocumentation", { enumerable: true, get: function () { return generativeEngineOptimization.generateAIDocumentation; } });
-Object.defineProperty(exports, "INTENT_MAP", { enumerable: true, get: function () { return generativeEngineOptimization.INTENT_MAP; } });
-Object.defineProperty(exports, "AI_INDEXING_KEYWORDS", { enumerable: true, get: function () { return generativeEngineOptimization.AI_INDEXING_KEYWORDS; } });
+// Default export
+exports.default = createA3MRouter;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,gCAAgC;AAChC,iBAAiB;;;AAgFjB,0CAcC;AA5FD,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAC/D,2DAQkC;AAPhC,4GAAA,UAAU,OAAA;AACV,4GAAA,UAAU,OAAA;AACV,kHAAA,gBAAgB,OAAA;AAChB,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AACd,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AAGnB,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAC/D,6DAYoC;AAXlC,mHAAA,iBAAiB,OAAA;AACjB,uHAAA,qBAAqB,OAAA;AACrB,kHAAA,gBAAgB,OAAA;AAChB,oHAAA,kBAAkB,OAAA;AAClB,gHAAA,cAAc,OAAA;AACd,6GAAA,WAAW,OAAA;AACX,mHAAA,iBAAiB,OAAA;AACjB,+HAAA,6BAA6B,OAAA;AAC7B,8HAAA,4BAA4B,OAAA;AAC5B,4GAAA,UAAU,OAAA;AACV,4GAAA,UAAU,OAAA;AAWZ,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAC/D,kDAAiD;AAAxC,0GAAA,WAAW,OAAA;AAEpB,+DAA+D;AAC/D,SAAS;AACT,+DAA+D;AAC/D,kDAAiD;AAAxC,wGAAA,UAAU,OAAA;AAGnB,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAC/D,iDAAiE;AAAxD,yGAAA,WAAW,OAAA;AAAE,4GAAA,cAAc,OAAA;AACpC,iDAAiD;AAAxC,yGAAA,WAAW,OAAA;AAEpB,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAC/D,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AACtB,oDAAwD;AAA/C,6GAAA,eAAe,OAAA;AACxB,2DAA0D;AAAjD,8GAAA,aAAa,OAAA;AACtB,oDAAyD;AAAhD,gHAAA,iBAAiB,OAAA;AAE1B,+DAA+D;AAC/D,wCAAwC;AACxC,+DAA+D;AAC/D,6DAAoF;AACpF,+DAAgF;AAChF,oDAAiD;AACjD,oDAAiD;AASjD,SAAgB,eAAe,CAAC,OAA0B;IACxD,MAAM,WAAW,GAAG,IAAI,yBAAW,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,uBAAU,EAAE,CAAC;IAEpC,OAAO;QACL,KAAK,EAAE,2BAAU;QACjB,UAAU,EAAV,2BAAU;QACV,gBAAgB,EAAhB,iCAAgB;QAChB,qBAAqB,EAArB,sCAAqB;QACrB,WAAW,EAAX,4BAAW;QACX,WAAW;QACX,UAAU;QACV,OAAO,EAAE,OAAO,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,iBAAiB;AACjB,kBAAe,eAAe,CAAC"}

package/dist/integrations/langchainAdapter.d.ts

@@ -0,0 +1,146 @@
+/**
+ * A3M Router - LangChain Adapter
+ *
+ * Drop-in replacement for ChatOpenAI from @langchain/openai.
+ * Routes all LLM calls through the A3M Router for cost optimization,
+ * load balancing, and intelligent provider selection.
+ *
+ * @example
+ * ```typescript
+ * import { A3MChatModel } from 'adaptive-memory-multi-model-router/langchain';
+ * import { HumanMessage } from '@langchain/core/messages';
+ *
+ * const model = new A3MChatModel({
+ *   modelName: 'auto', // or 'groq/llama-3.3-70b-versatile'
+ *   temperature: 0.7,
+ * });
+ *
+ * const response = await model.invoke([
+ *   new HumanMessage("What is 2+2?")
+ * ]);
+ *
+ * // Streaming
+ * const stream = await model.stream([
+ *   new HumanMessage("Tell me a story")
+ * ]);
+ * for await (const chunk of stream) {
+ *   process.stdout.write(chunk.content as string);
+ * }
+ * ```
+ *
+ * LangChain is a PEER DEPENDENCY. Install it separately:
+ *   npm install @langchain/core @langchain/openai
+ */
+import type { BaseChatModelCallOptions } from '@langchain/core/language_models/chat_models';
+import type { BaseMessage } from '@langchain/core/messages';
+import type { ChatGenerationChunk, ChatResult } from '@langchain/core/outputs';
+import type { StructuredOutputMethodParams } from '@langchain/core/language_models/structured_output';
+import { type ProviderDefinition } from '../providers/providerConfig.js';
+export interface A3MChatModelOptions {
+    /** A3M router instance (creates default if not provided) */
+    router?: any;
+    /** Model to use: 'auto' for router selection, or 'provider/model' */
+    modelName?: string;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /** Max output tokens */
+    maxTokens?: number;
+    /** Top-p sampling */
+    topP?: number;
+    /** Frequency penalty (-2 to 2) */
+    frequencyPenalty?: number;
+    /** Presence penalty (-2 to 2) */
+    presencePenalty?: number;
+    /** Stop sequences */
+    stop?: string[];
+    /** Timeout in ms */
+    timeout?: number;
+    /** API key override (uses env vars if not set) */
+    apiKey?: string;
+    /** Base URL override */
+    baseUrl?: string;
+    /** Provider format hint */
+    format?: 'openai' | 'anthropic' | 'google';
+    /** Extra headers to send with requests */
+    headers?: Record<string, string>;
+    /** Tags for tracing */
+    tags?: string[];
+    /** Metadata for tracing */
+    metadata?: Record<string, any>;
+    /** Verbose logging */
+    verbose?: boolean;
+}
+export interface A3MToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export declare class A3MChatModel {
+    lc_namespace: string[];
+    lc_sequential: boolean;
+    lc_runnable: boolean;
+    private modelName;
+    private temperature;
+    private maxTokens;
+    private topP?;
+    private frequencyPenalty?;
+    private presencePenalty?;
+    private stop?;
+    private timeout;
+    private apiKey?;
+    private baseUrl?;
+    private format?;
+    private extraHeaders?;
+    private verbose;
+    private boundTools;
+    private registry;
+    constructor(options?: A3MChatModelOptions & Record<string, any>);
+    get model(): string;
+    get identifyingParams(): Record<string, any>;
+    get lc_aliases(): Record<string, string>;
+    toJSON(): Record<string, any>;
+    static deserialize(data: Record<string, any>): Promise<A3MChatModel>;
+    _generate(messages: BaseMessage[], options?: BaseChatModelCallOptions & {
+        tools?: any[];
+    }): Promise<ChatResult>;
+    invoke(input: BaseMessage[] | string, options?: BaseChatModelCallOptions & {
+        tools?: any[];
+    }): Promise<any>;
+    _streamResponseChunks(messages: BaseMessage[], options?: BaseChatModelCallOptions & {
+        tools?: any[];
+    }): AsyncGenerator<ChatGenerationChunk>;
+    stream(input: BaseMessage[] | string, options?: BaseChatModelCallOptions & {
+        tools?: any[];
+    }): AsyncGenerator<any>;
+    bindTools(tools: any[]): A3MChatModel;
+    withStructuredOutput<T extends Record<string, any>>(schema: any, config?: StructuredOutputMethodParams | boolean): any;
+    /**
+     * Get the list of available providers
+     */
+    getAvailableProviders(): Record<string, ProviderDefinition>;
+    /**
+     * Get provider status from the registry
+     */
+    getProviderStatus(): any;
+    /**
+     * Switch the model at runtime
+     */
+    withModel(modelName: string): A3MChatModel;
+    /**
+     * Set temperature
+     */
+    withTemperature(temperature: number): A3MChatModel;
+    /** LLM type identifier for LangChain compatibility */
+    _llmType(): string;
+}
+/**
+ * Create an A3MChatModel pre-configured for a specific provider
+ */
+export declare function createA3MChatModel(provider: string, options?: Omit<A3MChatModelOptions, 'modelName'>): A3MChatModel;
+/**
+ * Create an A3MChatModel with automatic routing
+ */
+export declare function createAutoRoutingChatModel(options?: Omit<A3MChatModelOptions, 'modelName'>): A3MChatModel;