agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/services/cost-optimizer-service.js

@@ -0,0 +1,244 @@
+/**
+ * CostOptimizerService - Intelligent Model Selection & Cost Tracking
+ *
+ * Provides 90% cost savings through:
+ * - Automatic model selection based on task complexity
+ * - Budget enforcement with alerts
+ * - Real-time cost tracking
+ * - Agent Booster prioritization (free + 1ms)
+ */
+export class CostOptimizerService {
+    static instance = null;
+    costs = new Map();
+    budgetLimit = 100; // $100/month default
+    currentSpend = 0;
+    operationHistory = [];
+    constructor() {
+        this.initializeModelCosts();
+    }
+    static getInstance() {
+        if (!CostOptimizerService.instance) {
+            CostOptimizerService.instance = new CostOptimizerService();
+        }
+        return CostOptimizerService.instance;
+    }
+    initializeModelCosts() {
+        // Agent Booster (local, free, instant)
+        this.costs.set('agent-booster', {
+            modelId: 'agent-booster',
+            inputCostPer1K: 0,
+            outputCostPer1K: 0,
+            latency: 1,
+            qualityScore: 70
+        });
+        // Claude Haiku (cheapest, fast, good quality)
+        this.costs.set('claude-haiku-4', {
+            modelId: 'claude-haiku-4',
+            inputCostPer1K: 0.00025,
+            outputCostPer1K: 0.00125,
+            latency: 500,
+            qualityScore: 80
+        });
+        // Claude Sonnet (balanced)
+        this.costs.set('claude-sonnet-4', {
+            modelId: 'claude-sonnet-4',
+            inputCostPer1K: 0.003,
+            outputCostPer1K: 0.015,
+            latency: 1000,
+            qualityScore: 90
+        });
+        // Claude Opus (highest quality, most expensive)
+        this.costs.set('claude-opus-4', {
+            modelId: 'claude-opus-4',
+            inputCostPer1K: 0.015,
+            outputCostPer1K: 0.075,
+            latency: 2000,
+            qualityScore: 95
+        });
+        // GPT-4 Turbo (OpenRouter fallback)
+        this.costs.set('gpt-4-turbo', {
+            modelId: 'gpt-4-turbo',
+            inputCostPer1K: 0.01,
+            outputCostPer1K: 0.03,
+            latency: 1500,
+            qualityScore: 92
+        });
+        // GPT-3.5 Turbo (cheap fallback)
+        this.costs.set('gpt-3.5-turbo', {
+            modelId: 'gpt-3.5-turbo',
+            inputCostPer1K: 0.0005,
+            outputCostPer1K: 0.0015,
+            latency: 400,
+            qualityScore: 75
+        });
+    }
+    /**
+     * Select optimal model based on task requirements
+     * Returns the best value: Quality / (Cost × Latency)
+     */
+    selectOptimalModel(task) {
+        // PRIORITY 1: Use Agent Booster for simple tasks (free + instant)
+        if (task.complexity < 30) {
+            return {
+                modelId: 'agent-booster',
+                estimatedCost: 0,
+                reasoning: `Simple task (complexity ${task.complexity}) - using Agent Booster (free, 1ms latency)`,
+                alternatives: [
+                    { modelId: 'claude-haiku-4', cost: this.estimateCost('claude-haiku-4', task) }
+                ]
+            };
+        }
+        // PRIORITY 2: Filter models by requirements
+        const candidates = Array.from(this.costs.values()).filter(model => {
+            // Skip Agent Booster (already tried above)
+            if (model.modelId === 'agent-booster')
+                return false;
+            // Check latency requirement
+            if (task.maxLatency && model.latency > task.maxLatency)
+                return false;
+            // Check quality requirement
+            if (task.minQuality && model.qualityScore < task.minQuality)
+                return false;
+            return true;
+        });
+        if (candidates.length === 0) {
+            // No candidates meet requirements - use Opus as fallback
+            const cost = this.estimateCost('claude-opus-4', task);
+            return {
+                modelId: 'claude-opus-4',
+                estimatedCost: cost,
+                reasoning: 'No models meet requirements - using Opus as fallback'
+            };
+        }
+        // PRIORITY 3: Calculate value score for each candidate
+        const scored = candidates.map(model => {
+            const cost = this.estimateCost(model.modelId, task);
+            // Value formula: Quality / (Cost × Latency)
+            // Higher quality, lower cost, lower latency = higher value
+            const value = model.qualityScore / ((cost + 0.0001) * model.latency);
+            return { model, cost, value };
+        });
+        // Sort by value (highest first)
+        scored.sort((a, b) => b.value - a.value);
+        // PRIORITY 4: Check budget constraints
+        const selected = scored[0];
+        // If budget exceeded, force cheapest option
+        if (this.currentSpend + selected.cost > this.budgetLimit) {
+            const cheapest = scored[scored.length - 1];
+            return {
+                modelId: cheapest.model.modelId,
+                estimatedCost: cheapest.cost,
+                reasoning: `Budget limit reached ($${this.currentSpend.toFixed(2)}/$${this.budgetLimit}) - using cheapest option`,
+                alternatives: scored.slice(0, 3).map(s => ({ modelId: s.model.modelId, cost: s.cost }))
+            };
+        }
+        // Return best value option
+        return {
+            modelId: selected.model.modelId,
+            estimatedCost: selected.cost,
+            reasoning: `Best value: ${selected.model.qualityScore} quality, $${selected.cost.toFixed(4)} cost, ${selected.model.latency}ms latency`,
+            alternatives: scored.slice(1, 4).map(s => ({ modelId: s.model.modelId, cost: s.cost }))
+        };
+    }
+    /**
+     * Estimate cost for a specific model and task
+     */
+    estimateCost(modelId, task) {
+        const model = this.costs.get(modelId);
+        if (!model)
+            return 0;
+        const inputCost = (task.inputTokens / 1000) * model.inputCostPer1K;
+        const outputCost = (task.outputTokens / 1000) * model.outputCostPer1K;
+        return inputCost + outputCost;
+    }
+    /**
+     * Record actual spend for tracking
+     */
+    recordSpend(modelId, inputTokens, outputTokens) {
+        const model = this.costs.get(modelId);
+        if (!model) {
+            console.warn(`[CostOptimizer] Unknown model: ${modelId}`);
+            return;
+        }
+        const cost = (inputTokens / 1000) * model.inputCostPer1K +
+            (outputTokens / 1000) * model.outputCostPer1K;
+        this.currentSpend += cost;
+        this.operationHistory.push({
+            model: modelId,
+            cost,
+            timestamp: Date.now()
+        });
+        // Alert at 80% budget utilization
+        if (this.currentSpend > this.budgetLimit * 0.8 && this.currentSpend - cost <= this.budgetLimit * 0.8) {
+            console.warn(`[CostOptimizer] ⚠️  Budget alert: ${(this.currentSpend / this.budgetLimit * 100).toFixed(1)}% utilized`);
+        }
+    }
+    /**
+     * Get comprehensive spending report
+     */
+    getSpendingReport() {
+        // Calculate savings vs all-Opus baseline
+        const opusCost = this.costs.get('claude-opus-4');
+        const avgOpusCostPerOp = (opusCost.inputCostPer1K + opusCost.outputCostPer1K) / 2 * 0.15; // Assume 150 tokens avg
+        const estimatedOpusSpend = this.operationHistory.length * avgOpusCostPerOp;
+        // Breakdown by model
+        const breakdown = {};
+        for (const op of this.operationHistory) {
+            if (!breakdown[op.model]) {
+                breakdown[op.model] = { count: 0, totalCost: 0 };
+            }
+            breakdown[op.model].count++;
+            breakdown[op.model].totalCost += op.cost;
+        }
+        return {
+            totalSpend: this.currentSpend,
+            budgetRemaining: Math.max(0, this.budgetLimit - this.currentSpend),
+            utilizationPercent: (this.currentSpend / this.budgetLimit) * 100,
+            savingsVsOpus: Math.max(0, estimatedOpusSpend - this.currentSpend),
+            breakdown
+        };
+    }
+    /**
+     * Set monthly budget limit
+     */
+    setBudget(limit) {
+        if (limit <= 0) {
+            throw new Error('Budget limit must be positive');
+        }
+        this.budgetLimit = limit;
+        console.log(`[CostOptimizer] Budget set to $${limit}/month`);
+    }
+    /**
+     * Reset spending (for new billing period)
+     */
+    resetSpending() {
+        this.currentSpend = 0;
+        this.operationHistory = [];
+        console.log('[CostOptimizer] Spending reset for new period');
+    }
+    /**
+     * Get current budget status
+     */
+    getBudgetStatus() {
+        return {
+            limit: this.budgetLimit,
+            spent: this.currentSpend,
+            remaining: Math.max(0, this.budgetLimit - this.currentSpend),
+            percentUsed: (this.currentSpend / this.budgetLimit) * 100
+        };
+    }
+    /**
+     * Add custom model pricing
+     */
+    addCustomModel(model) {
+        this.costs.set(model.modelId, model);
+        console.log(`[CostOptimizer] Added custom model: ${model.modelId}`);
+    }
+    /**
+     * Get all available models
+     */
+    getAvailableModels() {
+        return Array.from(this.costs.values());
+    }
+}
+//# sourceMappingURL=cost-optimizer-service.js.map

package/dist/services/cost-optimizer-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-optimizer-service.js","sourceRoot":"","sources":["../../src/services/cost-optimizer-service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CostOptimizerService - Intelligent Model Selection & Cost Tracking\n *\n * Provides 90% cost savings through:\n * - Automatic model selection based on task complexity\n * - Budget enforcement with alerts\n * - Real-time cost tracking\n * - Agent Booster prioritization (free + 1ms)\n */\n\nexport interface ModelCost {\n  modelId: string;\n  inputCostPer1K: number;\n  outputCostPer1K: number;\n  latency: number;\n  qualityScore: number;\n}\n\nexport interface TaskRequirements {\n  complexity: number;      // 0-100 (0=trivial, 100=expert-level)\n  maxLatency?: number;     // Maximum acceptable latency in ms\n  minQuality?: number;     // Minimum quality score (0-100)\n  inputTokens: number;     // Expected input token count\n  outputTokens: number;    // Expected output token count\n}\n\nexport interface ModelSelection {\n  modelId: string;\n  estimatedCost: number;\n  reasoning: string;\n  alternatives?: Array<{ modelId: string; cost: number }>;\n}\n\nexport interface SpendingReport {\n  totalSpend: number;\n  budgetRemaining: number;\n  utilizationPercent: number;\n  savingsVsOpus: number;\n  breakdown: Record<string, { count: number; totalCost: number }>;\n}\n\nexport class CostOptimizerService {\n  private static instance: CostOptimizerService | null = null;\n  private costs: Map<string, ModelCost> = new Map();\n  private budgetLimit: number = 100; // $100/month default\n  private currentSpend: number = 0;\n  private operationHistory: Array<{ model: string; cost: number; timestamp: number }> = [];\n\n  private constructor() {\n    this.initializeModelCosts();\n  }\n\n  static getInstance(): CostOptimizerService {\n    if (!CostOptimizerService.instance) {\n      CostOptimizerService.instance = new CostOptimizerService();\n    }\n    return CostOptimizerService.instance;\n  }\n\n  private initializeModelCosts(): void {\n    // Agent Booster (local, free, instant)\n    this.costs.set('agent-booster', {\n      modelId: 'agent-booster',\n      inputCostPer1K: 0,\n      outputCostPer1K: 0,\n      latency: 1,\n      qualityScore: 70\n    });\n\n    // Claude Haiku (cheapest, fast, good quality)\n    this.costs.set('claude-haiku-4', {\n      modelId: 'claude-haiku-4',\n      inputCostPer1K: 0.00025,\n      outputCostPer1K: 0.00125,\n      latency: 500,\n      qualityScore: 80\n    });\n\n    // Claude Sonnet (balanced)\n    this.costs.set('claude-sonnet-4', {\n      modelId: 'claude-sonnet-4',\n      inputCostPer1K: 0.003,\n      outputCostPer1K: 0.015,\n      latency: 1000,\n      qualityScore: 90\n    });\n\n    // Claude Opus (highest quality, most expensive)\n    this.costs.set('claude-opus-4', {\n      modelId: 'claude-opus-4',\n      inputCostPer1K: 0.015,\n      outputCostPer1K: 0.075,\n      latency: 2000,\n      qualityScore: 95\n    });\n\n    // GPT-4 Turbo (OpenRouter fallback)\n    this.costs.set('gpt-4-turbo', {\n      modelId: 'gpt-4-turbo',\n      inputCostPer1K: 0.01,\n      outputCostPer1K: 0.03,\n      latency: 1500,\n      qualityScore: 92\n    });\n\n    // GPT-3.5 Turbo (cheap fallback)\n    this.costs.set('gpt-3.5-turbo', {\n      modelId: 'gpt-3.5-turbo',\n      inputCostPer1K: 0.0005,\n      outputCostPer1K: 0.0015,\n      latency: 400,\n      qualityScore: 75\n    });\n  }\n\n  /**\n   * Select optimal model based on task requirements\n   * Returns the best value: Quality / (Cost × Latency)\n   */\n  selectOptimalModel(task: TaskRequirements): ModelSelection {\n    // PRIORITY 1: Use Agent Booster for simple tasks (free + instant)\n    if (task.complexity < 30) {\n      return {\n        modelId: 'agent-booster',\n        estimatedCost: 0,\n        reasoning: `Simple task (complexity ${task.complexity}) - using Agent Booster (free, 1ms latency)`,\n        alternatives: [\n          { modelId: 'claude-haiku-4', cost: this.estimateCost('claude-haiku-4', task) }\n        ]\n      };\n    }\n\n    // PRIORITY 2: Filter models by requirements\n    const candidates = Array.from(this.costs.values()).filter(model => {\n      // Skip Agent Booster (already tried above)\n      if (model.modelId === 'agent-booster') return false;\n\n      // Check latency requirement\n      if (task.maxLatency && model.latency > task.maxLatency) return false;\n\n      // Check quality requirement\n      if (task.minQuality && model.qualityScore < task.minQuality) return false;\n\n      return true;\n    });\n\n    if (candidates.length === 0) {\n      // No candidates meet requirements - use Opus as fallback\n      const cost = this.estimateCost('claude-opus-4', task);\n      return {\n        modelId: 'claude-opus-4',\n        estimatedCost: cost,\n        reasoning: 'No models meet requirements - using Opus as fallback'\n      };\n    }\n\n    // PRIORITY 3: Calculate value score for each candidate\n    const scored = candidates.map(model => {\n      const cost = this.estimateCost(model.modelId, task);\n\n      // Value formula: Quality / (Cost × Latency)\n      // Higher quality, lower cost, lower latency = higher value\n      const value = model.qualityScore / ((cost + 0.0001) * model.latency);\n\n      return { model, cost, value };\n    });\n\n    // Sort by value (highest first)\n    scored.sort((a, b) => b.value - a.value);\n\n    // PRIORITY 4: Check budget constraints\n    const selected = scored[0];\n\n    // If budget exceeded, force cheapest option\n    if (this.currentSpend + selected.cost > this.budgetLimit) {\n      const cheapest = scored[scored.length - 1];\n      return {\n        modelId: cheapest.model.modelId,\n        estimatedCost: cheapest.cost,\n        reasoning: `Budget limit reached ($${this.currentSpend.toFixed(2)}/$${this.budgetLimit}) - using cheapest option`,\n        alternatives: scored.slice(0, 3).map(s => ({ modelId: s.model.modelId, cost: s.cost }))\n      };\n    }\n\n    // Return best value option\n    return {\n      modelId: selected.model.modelId,\n      estimatedCost: selected.cost,\n      reasoning: `Best value: ${selected.model.qualityScore} quality, $${selected.cost.toFixed(4)} cost, ${selected.model.latency}ms latency`,\n      alternatives: scored.slice(1, 4).map(s => ({ modelId: s.model.modelId, cost: s.cost }))\n    };\n  }\n\n  /**\n   * Estimate cost for a specific model and task\n   */\n  private estimateCost(modelId: string, task: TaskRequirements): number {\n    const model = this.costs.get(modelId);\n    if (!model) return 0;\n\n    const inputCost = (task.inputTokens / 1000) * model.inputCostPer1K;\n    const outputCost = (task.outputTokens / 1000) * model.outputCostPer1K;\n\n    return inputCost + outputCost;\n  }\n\n  /**\n   * Record actual spend for tracking\n   */\n  recordSpend(modelId: string, inputTokens: number, outputTokens: number): void {\n    const model = this.costs.get(modelId);\n    if (!model) {\n      console.warn(`[CostOptimizer] Unknown model: ${modelId}`);\n      return;\n    }\n\n    const cost = (inputTokens / 1000) * model.inputCostPer1K +\n                 (outputTokens / 1000) * model.outputCostPer1K;\n\n    this.currentSpend += cost;\n    this.operationHistory.push({\n      model: modelId,\n      cost,\n      timestamp: Date.now()\n    });\n\n    // Alert at 80% budget utilization\n    if (this.currentSpend > this.budgetLimit * 0.8 && this.currentSpend - cost <= this.budgetLimit * 0.8) {\n      console.warn(`[CostOptimizer] ⚠️  Budget alert: ${(this.currentSpend / this.budgetLimit * 100).toFixed(1)}% utilized`);\n    }\n  }\n\n  /**\n   * Get comprehensive spending report\n   */\n  getSpendingReport(): SpendingReport {\n    // Calculate savings vs all-Opus baseline\n    const opusCost = this.costs.get('claude-opus-4')!;\n    const avgOpusCostPerOp = (opusCost.inputCostPer1K + opusCost.outputCostPer1K) / 2 * 0.15; // Assume 150 tokens avg\n    const estimatedOpusSpend = this.operationHistory.length * avgOpusCostPerOp;\n\n    // Breakdown by model\n    const breakdown: Record<string, { count: number; totalCost: number }> = {};\n    for (const op of this.operationHistory) {\n      if (!breakdown[op.model]) {\n        breakdown[op.model] = { count: 0, totalCost: 0 };\n      }\n      breakdown[op.model].count++;\n      breakdown[op.model].totalCost += op.cost;\n    }\n\n    return {\n      totalSpend: this.currentSpend,\n      budgetRemaining: Math.max(0, this.budgetLimit - this.currentSpend),\n      utilizationPercent: (this.currentSpend / this.budgetLimit) * 100,\n      savingsVsOpus: Math.max(0, estimatedOpusSpend - this.currentSpend),\n      breakdown\n    };\n  }\n\n  /**\n   * Set monthly budget limit\n   */\n  setBudget(limit: number): void {\n    if (limit <= 0) {\n      throw new Error('Budget limit must be positive');\n    }\n    this.budgetLimit = limit;\n    console.log(`[CostOptimizer] Budget set to $${limit}/month`);\n  }\n\n  /**\n   * Reset spending (for new billing period)\n   */\n  resetSpending(): void {\n    this.currentSpend = 0;\n    this.operationHistory = [];\n    console.log('[CostOptimizer] Spending reset for new period');\n  }\n\n  /**\n   * Get current budget status\n   */\n  getBudgetStatus(): { limit: number; spent: number; remaining: number; percentUsed: number } {\n    return {\n      limit: this.budgetLimit,\n      spent: this.currentSpend,\n      remaining: Math.max(0, this.budgetLimit - this.currentSpend),\n      percentUsed: (this.currentSpend / this.budgetLimit) * 100\n    };\n  }\n\n  /**\n   * Add custom model pricing\n   */\n  addCustomModel(model: ModelCost): void {\n    this.costs.set(model.modelId, model);\n    console.log(`[CostOptimizer] Added custom model: ${model.modelId}`);\n  }\n\n  /**\n   * Get all available models\n   */\n  getAvailableModels(): ModelCost[] {\n    return Array.from(this.costs.values());\n  }\n}\n"]}

package/dist/services/direct-call-bridge.d.ts

@@ -0,0 +1,72 @@
+/**
+ * DirectCallBridge - Eliminates CLI spawning anti-pattern
+ *
+ * Provides direct method calls instead of execSync('npx agentic-flow ...')
+ * Performance improvement: 100-200ms CLI spawn -> <1ms direct call
+ *
+ * This bridge wraps AgentDBService and SwarmService with a simplified
+ * interface that mirrors the CLI command structure, making it easy to
+ * replace execSync calls in MCP tools.
+ */
+import type { AgentDBService, EpisodeData, SkillData, PatternData, TrajectoryStep } from './agentdb-service.js';
+import type { SwarmService, SwarmTopology } from './swarm-service.js';
+export declare class DirectCallBridge {
+    private agentDB;
+    private swarm;
+    constructor(agentDB: AgentDBService, swarm?: SwarmService);
+    /**
+     * Store an episode in memory (replaces `npx agentic-flow memory store`)
+     */
+    memoryStore(key: string, value: string, namespace?: string, ttl?: number): Promise<{
+        id: string;
+    }>;
+    /**
+     * Search memory (replaces `npx agentic-flow memory search`)
+     */
+    memorySearch(query: string, namespace?: string, limit?: number): Promise<any[]>;
+    /**
+     * Retrieve a specific memory by key (replaces `npx agentic-flow memory retrieve`)
+     */
+    memoryRetrieve(key: string, namespace?: string): Promise<any | null>;
+    /**
+     * List memories in a namespace (replaces `npx agentic-flow memory list`)
+     */
+    memoryList(namespace?: string, limit?: number): Promise<any[]>;
+    episodeStore(episode: EpisodeData): Promise<string>;
+    episodeRecall(query: string, limit?: number): Promise<any[]>;
+    episodeRecallDiverse(query: string, limit?: number, lambda?: number): Promise<any[]>;
+    patternStore(pattern: PatternData): Promise<string>;
+    patternSearch(query: string, limit?: number, diverse?: boolean): Promise<any[]>;
+    skillPublish(skill: SkillData): Promise<string>;
+    skillFind(description: string, limit?: number): Promise<any[]>;
+    causalEdgeRecord(from: string, to: string, metadata: unknown): Promise<void>;
+    causalPathQuery(from: string, to: string): Promise<any[]>;
+    graphStore(nodes: any[], edges: any[]): Promise<void>;
+    graphQuery(query: string): Promise<any[]>;
+    trajectoryRecord(steps: TrajectoryStep[], reward: number): Promise<void>;
+    actionPredict(state: any): Promise<any>;
+    routeSemantic(taskDescription: string): Promise<any>;
+    explainDecision(decisionId: string): Promise<any>;
+    getMetrics(): Promise<any>;
+    getAttentionService(): any;
+    getAttentionStats(): any;
+    synthesizeContext(query: string, limit?: number): Promise<any>;
+    swarmInit(topology: SwarmTopology, maxAgents: number, config?: any): Promise<void>;
+    agentSpawn(type: string, capabilities?: string[], name?: string): Promise<string>;
+    agentTerminate(agentId: string): Promise<void>;
+    taskOrchestrate(tasks: any[], strategy?: string): Promise<any[]>;
+    swarmStatus(): Promise<any>;
+    swarmShutdown(): Promise<void>;
+    runNightlyLearner(): Promise<any>;
+    consolidateEpisodes(sessionId?: string): Promise<any>;
+    syncWithRemote(onProgress?: (progress: any) => void): Promise<any>;
+    getSyncStatus(): any;
+    getPhase4Status(): any;
+    get hasSwarm(): boolean;
+    get hasAgentDB(): boolean;
+    /**
+     * Attach a SwarmService after construction
+     */
+    setSwarmService(swarm: SwarmService): void;
+}
+//# sourceMappingURL=direct-call-bridge.d.ts.map

package/dist/services/direct-call-bridge.d.ts.map

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

package/dist/services/direct-call-bridge.js

@@ -0,0 +1,180 @@
+export class DirectCallBridge {
+    agentDB;
+    swarm;
+    constructor(agentDB, swarm) {
+        this.agentDB = agentDB;
+        this.swarm = swarm || null;
+    }
+    // -- Memory operations (replace CLI memory commands) -----------------------
+    /**
+     * Store an episode in memory (replaces `npx agentic-flow memory store`)
+     */
+    async memoryStore(key, value, namespace = 'default', ttl) {
+        const id = await this.agentDB.storeEpisode({
+            sessionId: namespace,
+            task: key,
+            output: value,
+            reward: 0.5,
+            success: true,
+            metadata: { namespace, ttl, storedAt: Date.now() },
+        });
+        return { id };
+    }
+    /**
+     * Search memory (replaces `npx agentic-flow memory search`)
+     */
+    async memorySearch(query, namespace, limit = 10) {
+        const episodes = await this.agentDB.recallEpisodes(query, limit);
+        if (namespace) {
+            return episodes.filter(ep => ep.sessionId === namespace);
+        }
+        return episodes;
+    }
+    /**
+     * Retrieve a specific memory by key (replaces `npx agentic-flow memory retrieve`)
+     */
+    async memoryRetrieve(key, namespace = 'default') {
+        const results = await this.agentDB.recallEpisodes(key, 1);
+        if (results.length > 0 && results[0].sessionId === namespace) {
+            return results[0];
+        }
+        return null;
+    }
+    /**
+     * List memories in a namespace (replaces `npx agentic-flow memory list`)
+     */
+    async memoryList(namespace, limit = 100) {
+        const query = namespace || '*';
+        return this.agentDB.recallEpisodes(query, limit);
+    }
+    // -- Episode operations (direct AgentDB) -----------------------------------
+    async episodeStore(episode) {
+        return this.agentDB.storeEpisode(episode);
+    }
+    async episodeRecall(query, limit = 5) {
+        return this.agentDB.recallEpisodes(query, limit);
+    }
+    async episodeRecallDiverse(query, limit = 5, lambda = 0.5) {
+        return this.agentDB.recallDiverseEpisodes(query, limit, lambda);
+    }
+    // -- Pattern operations (direct AgentDB) -----------------------------------
+    async patternStore(pattern) {
+        return this.agentDB.storePattern(pattern);
+    }
+    async patternSearch(query, limit = 10, diverse = false) {
+        return this.agentDB.searchPatterns(query, limit, diverse);
+    }
+    // -- Skill operations (direct AgentDB) -------------------------------------
+    async skillPublish(skill) {
+        return this.agentDB.publishSkill(skill);
+    }
+    async skillFind(description, limit = 10) {
+        return this.agentDB.findSkills(description, limit);
+    }
+    // -- Causal graph operations -----------------------------------------------
+    async causalEdgeRecord(from, to, metadata) {
+        return this.agentDB.recordCausalEdge(from, to, metadata);
+    }
+    async causalPathQuery(from, to) {
+        return this.agentDB.queryCausalPath(from, to);
+    }
+    // -- Graph operations ------------------------------------------------------
+    async graphStore(nodes, edges) {
+        return this.agentDB.storeGraphState(nodes, edges);
+    }
+    async graphQuery(query) {
+        return this.agentDB.queryGraph(query);
+    }
+    // -- Learning operations ---------------------------------------------------
+    async trajectoryRecord(steps, reward) {
+        return this.agentDB.recordTrajectory(steps, reward);
+    }
+    async actionPredict(state) {
+        return this.agentDB.predictAction(state);
+    }
+    // -- Routing operations ----------------------------------------------------
+    async routeSemantic(taskDescription) {
+        return this.agentDB.routeSemantic(taskDescription);
+    }
+    // -- Explain operations ----------------------------------------------------
+    async explainDecision(decisionId) {
+        return this.agentDB.explainDecision(decisionId);
+    }
+    // -- Metrics ---------------------------------------------------------------
+    async getMetrics() {
+        return this.agentDB.getMetrics();
+    }
+    // -- Attention operations --------------------------------------------------
+    getAttentionService() {
+        return this.agentDB.getAttentionService();
+    }
+    getAttentionStats() {
+        return this.agentDB.getAttentionStats();
+    }
+    // -- Context synthesis -----------------------------------------------------
+    async synthesizeContext(query, limit = 10) {
+        const episodes = await this.agentDB.recallEpisodes(query, limit);
+        return this.agentDB.synthesizeContext(episodes);
+    }
+    // -- Swarm operations (if SwarmService available) --------------------------
+    async swarmInit(topology, maxAgents, config) {
+        if (!this.swarm)
+            throw new Error('SwarmService not available');
+        return this.swarm.initialize(topology, maxAgents, config);
+    }
+    async agentSpawn(type, capabilities, name) {
+        if (!this.swarm)
+            throw new Error('SwarmService not available');
+        return this.swarm.spawnAgent(type, capabilities, name);
+    }
+    async agentTerminate(agentId) {
+        if (!this.swarm)
+            throw new Error('SwarmService not available');
+        return this.swarm.terminateAgent(agentId);
+    }
+    async taskOrchestrate(tasks, strategy = 'parallel') {
+        if (!this.swarm)
+            throw new Error('SwarmService not available');
+        return this.swarm.orchestrateTasks(tasks, strategy);
+    }
+    async swarmStatus() {
+        if (!this.swarm)
+            throw new Error('SwarmService not available');
+        return this.swarm.getStatus();
+    }
+    async swarmShutdown() {
+        if (!this.swarm)
+            throw new Error('SwarmService not available');
+        return this.swarm.shutdown();
+    }
+    // -- Phase 4 operations ----------------------------------------------------
+    async runNightlyLearner() {
+        return this.agentDB.runNightlyLearner();
+    }
+    async consolidateEpisodes(sessionId) {
+        return this.agentDB.consolidateEpisodes(sessionId);
+    }
+    async syncWithRemote(onProgress) {
+        return this.agentDB.syncWithRemote(onProgress);
+    }
+    getSyncStatus() {
+        return this.agentDB.getSyncStatus();
+    }
+    getPhase4Status() {
+        return this.agentDB.getPhase4Status();
+    }
+    // -- Convenience: check availability ---------------------------------------
+    get hasSwarm() {
+        return this.swarm !== null;
+    }
+    get hasAgentDB() {
+        return this.agentDB !== null;
+    }
+    /**
+     * Attach a SwarmService after construction
+     */
+    setSwarmService(swarm) {
+        this.swarm = swarm;
+    }
+}
+//# sourceMappingURL=direct-call-bridge.js.map

package/dist/services/direct-call-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-call-bridge.js","sourceRoot":"","sources":["../../src/services/direct-call-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DirectCallBridge - Eliminates CLI spawning anti-pattern\n *\n * Provides direct method calls instead of execSync('npx agentic-flow ...')\n * Performance improvement: 100-200ms CLI spawn -> <1ms direct call\n *\n * This bridge wraps AgentDBService and SwarmService with a simplified\n * interface that mirrors the CLI command structure, making it easy to\n * replace execSync calls in MCP tools.\n */\nimport type { AgentDBService, EpisodeData, SkillData, PatternData, TrajectoryStep } from './agentdb-service.js';\nimport type { SwarmService, SwarmTopology } from './swarm-service.js';\n\nexport class DirectCallBridge {\n  private agentDB: AgentDBService;\n  private swarm: SwarmService | null;\n\n  constructor(agentDB: AgentDBService, swarm?: SwarmService) {\n    this.agentDB = agentDB;\n    this.swarm = swarm || null;\n  }\n\n  // -- Memory operations (replace CLI memory commands) -----------------------\n\n  /**\n   * Store an episode in memory (replaces `npx agentic-flow memory store`)\n   */\n  async memoryStore(key: string, value: string, namespace = 'default', ttl?: number): Promise<{ id: string }> {\n    const id = await this.agentDB.storeEpisode({\n      sessionId: namespace,\n      task: key,\n      output: value,\n      reward: 0.5,\n      success: true,\n      metadata: { namespace, ttl, storedAt: Date.now() },\n    });\n    return { id };\n  }\n\n  /**\n   * Search memory (replaces `npx agentic-flow memory search`)\n   */\n  async memorySearch(query: string, namespace?: string, limit = 10): Promise<any[]> {\n    const episodes = await this.agentDB.recallEpisodes(query, limit);\n    if (namespace) {\n      return episodes.filter(ep => ep.sessionId === namespace);\n    }\n    return episodes;\n  }\n\n  /**\n   * Retrieve a specific memory by key (replaces `npx agentic-flow memory retrieve`)\n   */\n  async memoryRetrieve(key: string, namespace = 'default'): Promise<any | null> {\n    const results = await this.agentDB.recallEpisodes(key, 1);\n    if (results.length > 0 && results[0].sessionId === namespace) {\n      return results[0];\n    }\n    return null;\n  }\n\n  /**\n   * List memories in a namespace (replaces `npx agentic-flow memory list`)\n   */\n  async memoryList(namespace?: string, limit = 100): Promise<any[]> {\n    const query = namespace || '*';\n    return this.agentDB.recallEpisodes(query, limit);\n  }\n\n  // -- Episode operations (direct AgentDB) -----------------------------------\n\n  async episodeStore(episode: EpisodeData): Promise<string> {\n    return this.agentDB.storeEpisode(episode);\n  }\n\n  async episodeRecall(query: string, limit = 5): Promise<any[]> {\n    return this.agentDB.recallEpisodes(query, limit);\n  }\n\n  async episodeRecallDiverse(query: string, limit = 5, lambda = 0.5): Promise<any[]> {\n    return this.agentDB.recallDiverseEpisodes(query, limit, lambda);\n  }\n\n  // -- Pattern operations (direct AgentDB) -----------------------------------\n\n  async patternStore(pattern: PatternData): Promise<string> {\n    return this.agentDB.storePattern(pattern);\n  }\n\n  async patternSearch(query: string, limit = 10, diverse = false): Promise<any[]> {\n    return this.agentDB.searchPatterns(query, limit, diverse);\n  }\n\n  // -- Skill operations (direct AgentDB) -------------------------------------\n\n  async skillPublish(skill: SkillData): Promise<string> {\n    return this.agentDB.publishSkill(skill);\n  }\n\n  async skillFind(description: string, limit = 10): Promise<any[]> {\n    return this.agentDB.findSkills(description, limit);\n  }\n\n  // -- Causal graph operations -----------------------------------------------\n\n  async causalEdgeRecord(from: string, to: string, metadata: unknown): Promise<void> {\n    return this.agentDB.recordCausalEdge(from, to, metadata);\n  }\n\n  async causalPathQuery(from: string, to: string): Promise<any[]> {\n    return this.agentDB.queryCausalPath(from, to);\n  }\n\n  // -- Graph operations ------------------------------------------------------\n\n  async graphStore(nodes: any[], edges: any[]): Promise<void> {\n    return this.agentDB.storeGraphState(nodes, edges);\n  }\n\n  async graphQuery(query: string): Promise<any[]> {\n    return this.agentDB.queryGraph(query);\n  }\n\n  // -- Learning operations ---------------------------------------------------\n\n  async trajectoryRecord(steps: TrajectoryStep[], reward: number): Promise<void> {\n    return this.agentDB.recordTrajectory(steps, reward);\n  }\n\n  async actionPredict(state: any): Promise<any> {\n    return this.agentDB.predictAction(state);\n  }\n\n  // -- Routing operations ----------------------------------------------------\n\n  async routeSemantic(taskDescription: string): Promise<any> {\n    return this.agentDB.routeSemantic(taskDescription);\n  }\n\n  // -- Explain operations ----------------------------------------------------\n\n  async explainDecision(decisionId: string): Promise<any> {\n    return this.agentDB.explainDecision(decisionId);\n  }\n\n  // -- Metrics ---------------------------------------------------------------\n\n  async getMetrics(): Promise<any> {\n    return this.agentDB.getMetrics();\n  }\n\n  // -- Attention operations --------------------------------------------------\n\n  getAttentionService(): any {\n    return this.agentDB.getAttentionService();\n  }\n\n  getAttentionStats(): any {\n    return this.agentDB.getAttentionStats();\n  }\n\n  // -- Context synthesis -----------------------------------------------------\n\n  async synthesizeContext(query: string, limit = 10): Promise<any> {\n    const episodes = await this.agentDB.recallEpisodes(query, limit);\n    return this.agentDB.synthesizeContext(episodes);\n  }\n\n  // -- Swarm operations (if SwarmService available) --------------------------\n\n  async swarmInit(topology: SwarmTopology, maxAgents: number, config?: any): Promise<void> {\n    if (!this.swarm) throw new Error('SwarmService not available');\n    return this.swarm.initialize(topology, maxAgents, config);\n  }\n\n  async agentSpawn(type: string, capabilities?: string[], name?: string): Promise<string> {\n    if (!this.swarm) throw new Error('SwarmService not available');\n    return this.swarm.spawnAgent(type, capabilities, name);\n  }\n\n  async agentTerminate(agentId: string): Promise<void> {\n    if (!this.swarm) throw new Error('SwarmService not available');\n    return this.swarm.terminateAgent(agentId);\n  }\n\n  async taskOrchestrate(tasks: any[], strategy = 'parallel'): Promise<any[]> {\n    if (!this.swarm) throw new Error('SwarmService not available');\n    return this.swarm.orchestrateTasks(tasks, strategy);\n  }\n\n  async swarmStatus(): Promise<any> {\n    if (!this.swarm) throw new Error('SwarmService not available');\n    return this.swarm.getStatus();\n  }\n\n  async swarmShutdown(): Promise<void> {\n    if (!this.swarm) throw new Error('SwarmService not available');\n    return this.swarm.shutdown();\n  }\n\n  // -- Phase 4 operations ----------------------------------------------------\n\n  async runNightlyLearner(): Promise<any> {\n    return this.agentDB.runNightlyLearner();\n  }\n\n  async consolidateEpisodes(sessionId?: string): Promise<any> {\n    return this.agentDB.consolidateEpisodes(sessionId);\n  }\n\n  async syncWithRemote(onProgress?: (progress: any) => void): Promise<any> {\n    return this.agentDB.syncWithRemote(onProgress);\n  }\n\n  getSyncStatus(): any {\n    return this.agentDB.getSyncStatus();\n  }\n\n  getPhase4Status(): any {\n    return this.agentDB.getPhase4Status();\n  }\n\n  // -- Convenience: check availability ---------------------------------------\n\n  get hasSwarm(): boolean {\n    return this.swarm !== null;\n  }\n\n  get hasAgentDB(): boolean {\n    return this.agentDB !== null;\n  }\n\n  /**\n   * Attach a SwarmService after construction\n   */\n  setSwarmService(swarm: SwarmService): void {\n    this.swarm = swarm;\n  }\n}\n"]}