agentic-flow 2.0.2-alpha → 2.0.2

package/dist/utils/model-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-cache.js","sourceRoot":"","sources":["../../src/utils/model-cache.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Global Model Cache\n *\n * Caches loaded models in memory to avoid repeated initialization overhead.\n * Supports ONNX embeddings, transformers.js pipelines, and other heavy models.\n */\n\ninterface CachedModel {\n  model: any;\n  loadedAt: number;\n  lastUsed: number;\n  useCount: number;\n  sizeEstimate: number; // bytes\n}\n\ninterface CacheStats {\n  models: number;\n  totalSize: number;\n  size?: number;\n  totalHits: number;\n  totalMisses: number;\n  hits: number;\n  misses: number;\n  hitRate: number;\n}\n\nclass ModelCache {\n  private cache = new Map<string, CachedModel>();\n  private maxSize: number; // Max cache size in bytes\n  private totalHits = 0;\n  private totalMisses = 0;\n\n  constructor(maxSizeMB: number = 512) {\n    this.maxSize = maxSizeMB * 1024 * 1024;\n  }\n\n  /**\n   * Get a cached model or load it\n   */\n  async getOrLoad<T>(\n    key: string,\n    loader: () => Promise<T>,\n    sizeEstimate: number = 50 * 1024 * 1024 // Default 50MB estimate\n  ): Promise<T> {\n    const cached = this.cache.get(key);\n    if (cached) {\n      cached.lastUsed = Date.now();\n      cached.useCount++;\n      this.totalHits++;\n      return cached.model as T;\n    }\n\n    this.totalMisses++;\n\n    // Evict if needed\n    this.evictIfNeeded(sizeEstimate);\n\n    // Load model\n    const model = await loader();\n\n    this.cache.set(key, {\n      model,\n      loadedAt: Date.now(),\n      lastUsed: Date.now(),\n      useCount: 1,\n      sizeEstimate\n    });\n\n    return model;\n  }\n\n  /**\n   * Check if model is cached\n   */\n  has(key: string): boolean {\n    return this.cache.has(key);\n  }\n\n  /**\n   * Get cached model without loading\n   */\n  get<T>(key: string): T | undefined {\n    const cached = this.cache.get(key);\n    if (cached) {\n      cached.lastUsed = Date.now();\n      cached.useCount++;\n      return cached.model as T;\n    }\n    return undefined;\n  }\n\n  /**\n   * Manually cache a model\n   */\n  set(key: string, model: any, sizeEstimate: number = 50 * 1024 * 1024): void {\n    this.evictIfNeeded(sizeEstimate);\n    this.cache.set(key, {\n      model,\n      loadedAt: Date.now(),\n      lastUsed: Date.now(),\n      useCount: 1,\n      sizeEstimate\n    });\n  }\n\n  /**\n   * Remove a model from cache\n   */\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n\n  /**\n   * Clear all cached models\n   */\n  clear(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Get cache statistics\n   */\n  getStats(): CacheStats {\n    let totalSize = 0;\n    for (const cached of this.cache.values()) {\n      totalSize += cached.sizeEstimate;\n    }\n    const hits = this.totalHits;\n    const misses = this.totalMisses;\n    const total = hits + misses;\n    return {\n      models: this.cache.size,\n      totalSize,\n      size: this.cache.size,\n      totalHits: hits,\n      totalMisses: misses,\n      hits,\n      misses,\n      hitRate: total > 0 ? hits / total : 0\n    };\n  }\n\n  /**\n   * Evict least recently used models if cache is full\n   */\n  private evictIfNeeded(newSize: number): void {\n    let currentSize = 0;\n    for (const cached of this.cache.values()) {\n      currentSize += cached.sizeEstimate;\n    }\n\n    if (currentSize + newSize <= this.maxSize) {\n      return;\n    }\n\n    // Sort by last used time (LRU)\n    const entries = Array.from(this.cache.entries())\n      .sort((a, b) => a[1].lastUsed - b[1].lastUsed);\n\n    // Evict until we have space\n    for (const [key, cached] of entries) {\n      if (currentSize + newSize <= this.maxSize) {\n        break;\n      }\n      this.cache.delete(key);\n      currentSize -= cached.sizeEstimate;\n    }\n  }\n}\n\n// Global singleton\nexport const modelCache = new ModelCache();\n\n// Convenience functions\nexport async function getCachedOnnxEmbedder(): Promise<any> {\n  return modelCache.getOrLoad(\n    'onnx-embeddings',\n    async () => {\n      // Suppress experimental warning for WASM\n      const originalEmit = process.emit;\n      // @ts-ignore\n      process.emit = function (name, data, ...args) {\n        if (name === 'warning' && typeof data === 'object' &&\n            (data as any).name === 'ExperimentalWarning' &&\n            (data as any).message?.includes('Import')) {\n          return false;\n        }\n        // @ts-ignore\n        return originalEmit.apply(process, [name, data, ...args]);\n      };\n\n      try {\n        const onnxModule = await import('ruvector-onnx-embeddings-wasm') as any;\n        const EmbedderClass = onnxModule.OnnxEmbeddings || onnxModule.default;\n        if (EmbedderClass) {\n          const embedder = new EmbedderClass();\n          await embedder.initialize?.();\n          return embedder;\n        }\n      } finally {\n        process.emit = originalEmit;\n      }\n      return null;\n    },\n    100 * 1024 * 1024 // 100MB estimate for ONNX model\n  );\n}\n\nexport async function getCachedTransformersPipeline(\n  task: string = 'feature-extraction',\n  model: string = 'Xenova/all-MiniLM-L6-v2'\n): Promise<any> {\n  return modelCache.getOrLoad(\n    `transformers:${task}:${model}`,\n    async () => {\n      const { pipeline } = await import('@xenova/transformers');\n      return pipeline(task as any, model);\n    },\n    200 * 1024 * 1024 // 200MB estimate for transformers model\n  );\n}\n\nexport async function getCachedRuvectorCore(): Promise<any> {\n  return modelCache.getOrLoad(\n    'ruvector-core',\n    async () => {\n      const ruvector = await import('ruvector');\n      return ruvector;\n    },\n    50 * 1024 * 1024\n  );\n}\n"]}

package/dist/utils/model-downloader.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Automatic Model Downloader for ONNX Phi-4
+ *
+ * Downloads Phi-4 ONNX model from HuggingFace on first use
+ */
+export interface DownloadProgress {
+    downloaded: number;
+    total: number;
+    percentage: number;
+}
+export interface ModelInfo {
+    repo: string;
+    filename: string;
+    localPath: string;
+    sha256?: string;
+}
+export declare class ModelDownloader {
+    private baseUrl;
+    /**
+     * Phi-4 Mini ONNX INT4 quantized model (CPU optimized)
+     * Size: ~52MB model + ~4.86GB data = ~4.9GB total
+     * Note: Requires TWO files - model.onnx and model.onnx.data
+     */
+    private phi4Model;
+    private phi4ModelData;
+    /**
+     * Check if model exists locally
+     */
+    isModelDownloaded(modelPath?: string): boolean;
+    /**
+     * Get model download URL
+     */
+    private getDownloadUrl;
+    /**
+     * Download model with progress tracking
+     */
+    downloadModel(modelInfo?: ModelInfo, onProgress?: (progress: DownloadProgress) => void): Promise<string>;
+    /**
+     * Download Phi-4 ONNX model if needed (downloads BOTH .onnx and .onnx.data files)
+     */
+    ensurePhi4Model(onProgress?: (progress: DownloadProgress) => void): Promise<string>;
+    /**
+     * Verify model file integrity (optional)
+     */
+    verifyModel(modelPath: string, expectedSha256?: string): Promise<boolean>;
+    /**
+     * Get model info
+     */
+    getModelInfo(): ModelInfo;
+    /**
+     * Format download progress for display
+     */
+    static formatProgress(progress: DownloadProgress): string;
+}
+/**
+ * Global singleton instance
+ */
+export declare const modelDownloader: ModelDownloader;
+/**
+ * Convenience function for downloading Phi-4 model
+ */
+export declare function ensurePhi4Model(onProgress?: (progress: DownloadProgress) => void): Promise<string>;
+//# sourceMappingURL=model-downloader.d.ts.map

package/dist/utils/modelCapabilities.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Model Capability Detection
+ * Determines if a model supports native tool calling or requires emulation
+ */
+export interface ModelCapabilities {
+    supportsNativeTools: boolean;
+    supportsStreaming: boolean;
+    contextWindow: number;
+    requiresEmulation: boolean;
+    emulationStrategy: 'none' | 'react' | 'prompt' | 'hybrid';
+    costPerMillionTokens: number;
+    provider: string;
+}
+/**
+ * Detect capabilities of a model
+ */
+export declare function detectModelCapabilities(modelId: string): ModelCapabilities;
+/**
+ * Check if model can handle a specific number of tools
+ */
+export declare function canHandleToolCount(modelId: string, toolCount: number): boolean;
+/**
+ * Recommend optimal strategy for a model
+ */
+export declare function recommendStrategy(modelId: string, toolCount: number, taskComplexity: 'simple' | 'medium' | 'complex'): 'native' | 'react' | 'prompt' | 'hybrid';
+/**
+ * Get human-readable capability report
+ */
+export declare function getCapabilityReport(modelId: string): string;
+//# sourceMappingURL=modelCapabilities.d.ts.map

package/dist/utils/modelOptimizer.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Smart Model Optimizer - Automatically selects the best model for each agent and task
+ * Balances performance vs cost based on agent requirements
+ */
+export interface ModelRecommendation {
+    provider: string;
+    model: string;
+    modelName: string;
+    reasoning: string;
+    cost_per_1m_input: number;
+    cost_per_1m_output: number;
+    quality_score: number;
+    speed_score: number;
+    cost_score: number;
+    overall_score: number;
+    tier: 'flagship' | 'cost-effective' | 'balanced' | 'budget' | 'local';
+}
+export interface OptimizationCriteria {
+    agent: string;
+    task: string;
+    priority?: 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';
+    maxCostPerTask?: number;
+    requiresReasoning?: boolean;
+    requiresMultimodal?: boolean;
+    requiresTools?: boolean;
+    taskComplexity?: 'simple' | 'moderate' | 'complex' | 'expert';
+}
+declare const MODEL_DATABASE: {
+    'claude-sonnet-4-5': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "flagship";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'gpt-4o': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "flagship";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'gemini-2-5-pro': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "flagship";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'deepseek-r1': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "cost-effective";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'deepseek-chat-v3': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "cost-effective";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'gemini-2-5-flash': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "balanced";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'llama-3-3-8b': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "balanced";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'qwen-2-5-72b': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "balanced";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'llama-3-1-8b': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "budget";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+    'onnx-phi-4': {
+        provider: string;
+        model: string;
+        modelName: string;
+        cost_per_1m_input: number;
+        cost_per_1m_output: number;
+        quality_score: number;
+        speed_score: number;
+        cost_score: number;
+        tier: "local";
+        supports_tools: boolean;
+        strengths: string[];
+        weaknesses: string[];
+        bestFor: string[];
+    };
+};
+export declare class ModelOptimizer {
+    /**
+     * Optimize model selection based on agent, task, and priorities
+     */
+    static optimize(criteria: OptimizationCriteria): ModelRecommendation;
+    /**
+     * Infer task complexity from task description
+     */
+    private static inferComplexity;
+    /**
+     * Estimate cost for a task (rough approximation)
+     */
+    private static estimateCost;
+    /**
+     * Generate human-readable reasoning for model selection
+     */
+    private static generateReasoning;
+    /**
+     * Get all available models with their characteristics
+     */
+    static getAvailableModels(): typeof MODEL_DATABASE;
+    /**
+     * Display optimization recommendations in console
+     */
+    static displayRecommendation(recommendation: ModelRecommendation): void;
+}
+export {};
+//# sourceMappingURL=modelOptimizer.d.ts.map

package/dist/utils/rate-limiter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Simple in-memory rate limiter for proxy protection
+ */
+export interface RateLimiterConfig {
+    points: number;
+    duration: number;
+    blockDuration: number;
+}
+export declare class RateLimiter {
+    private config;
+    private clients;
+    private cleanupInterval;
+    constructor(config: RateLimiterConfig);
+    consume(key: string): Promise<void>;
+    destroy(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/utils/reasoningbankCommands.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ReasoningBank CLI Commands
+ * Handles demo, test, init, benchmark, status, consolidate, list
+ */
+export declare function handleReasoningBankCommand(subcommand: string): Promise<void>;
+//# sourceMappingURL=reasoningbankCommands.d.ts.map

package/dist/utils/response-cache.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Response Cache with LRU Eviction
+ * Provides 50-80% latency reduction for repeated queries
+ */
+export interface CacheConfig {
+    maxSize: number;
+    ttl: number;
+    updateAgeOnGet: boolean;
+    enableStats: boolean;
+}
+export interface CachedResponse {
+    data: Buffer;
+    headers: Record<string, string>;
+    statusCode: number;
+    timestamp: number;
+    hits: number;
+}
+export interface CacheStats {
+    size: number;
+    maxSize: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    evictions: number;
+    totalSavings: number;
+}
+export declare class ResponseCache {
+    private cache;
+    private accessOrder;
+    private config;
+    private stats;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get cached response
+     */
+    get(key: string): CachedResponse | undefined;
+    /**
+     * Set cached response
+     */
+    set(key: string, value: CachedResponse): void;
+    /**
+     * Generate cache key from request
+     */
+    generateKey(req: {
+        model?: string;
+        messages?: unknown[];
+        max_tokens?: number;
+        temperature?: number;
+        stream?: boolean;
+    }): string;
+    /**
+     * Check if response should be cached
+     */
+    shouldCache(req: {
+        stream?: boolean;
+    }, statusCode: number): boolean;
+    /**
+     * Clear expired entries
+     */
+    private cleanup;
+    /**
+     * Evict least recently used entry
+     */
+    private evictLRU;
+    /**
+     * Check if entry is expired
+     */
+    private isExpired;
+    /**
+     * Remove key from access order
+     */
+    private removeFromAccessOrder;
+    /**
+     * Update hit rate statistic
+     */
+    private updateHitRate;
+    /**
+     * Simple hash function for cache keys
+     */
+    private hash;
+    /**
+     * Get cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Clear cache
+     */
+    clear(): void;
+    /**
+     * Destroy cache and cleanup
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=response-cache.d.ts.map

package/dist/utils/retry.d.ts

@@ -0,0 +1,9 @@
+interface RetryOptions {
+    maxAttempts?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    shouldRetry?: (error: any) => boolean;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/safe-exec.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Safe Command Execution Utility
+ *
+ * Prevents command injection by:
+ * 1. Using execFileSync instead of execSync (no shell interpretation)
+ * 2. Validating all inputs against strict patterns
+ * 3. Never passing user input through shell
+ */
+import { ExecFileSyncOptions } from 'child_process';
+/**
+ * Validation patterns for common input types
+ */
+export declare const VALIDATION_PATTERNS: {
+    key: RegExp;
+    namespace: RegExp;
+    pattern: RegExp;
+    swarmId: RegExp;
+    agentName: RegExp;
+    taskId: RegExp;
+    category: RegExp;
+    topology: RegExp;
+    agentType: RegExp;
+    strategy: RegExp;
+    priority: RegExp;
+};
+/**
+ * Validate a string against a pattern
+ */
+export declare function validateInput(value: string, pattern: RegExp, fieldName: string): string;
+/**
+ * Validate and sanitize a key parameter
+ */
+export declare function validateKey(key: string): string;
+/**
+ * Validate and sanitize a namespace parameter
+ */
+export declare function validateNamespace(namespace: string): string;
+/**
+ * Validate and sanitize a pattern parameter
+ */
+export declare function validatePattern(pattern: string): string;
+/**
+ * Validate a value - allow any content but limit size
+ */
+export declare function validateValue(value: string, maxLength?: number): string;
+/**
+ * Safe execution of npx commands
+ * Uses execFileSync with array arguments to prevent shell injection
+ */
+export declare function safeExecNpx(pkg: string, args: string[], options?: ExecFileSyncOptions): string;
+/**
+ * Execute claude-flow memory commands safely
+ */
+export declare function execMemoryStore(key: string, value: string, namespace?: string, ttl?: number): string;
+/**
+ * Execute claude-flow memory retrieve safely
+ */
+export declare function execMemoryRetrieve(key: string, namespace?: string): string;
+/**
+ * Execute claude-flow memory search safely
+ */
+export declare function execMemorySearch(pattern: string, namespace?: string, limit?: number): string;
+/**
+ * Execute claude-flow swarm init safely
+ */
+export declare function execSwarmInit(swarmId: string, topology: string, maxAgents?: number): string;
+/**
+ * Execute claude-flow agent spawn safely
+ */
+export declare function execAgentSpawn(name: string, type: string, swarmId?: string, capabilities?: string[]): string;
+/**
+ * Execute claude-flow task orchestrate safely
+ */
+export declare function execTaskOrchestrate(task: string, strategy?: string, priority?: string): string;
+declare const _default: {
+    validateInput: typeof validateInput;
+    validateKey: typeof validateKey;
+    validateNamespace: typeof validateNamespace;
+    validatePattern: typeof validatePattern;
+    validateValue: typeof validateValue;
+    safeExecNpx: typeof safeExecNpx;
+    execMemoryStore: typeof execMemoryStore;
+    execMemoryRetrieve: typeof execMemoryRetrieve;
+    execMemorySearch: typeof execMemorySearch;
+    execSwarmInit: typeof execSwarmInit;
+    execAgentSpawn: typeof execAgentSpawn;
+    execTaskOrchestrate: typeof execTaskOrchestrate;
+    VALIDATION_PATTERNS: {
+        key: RegExp;
+        namespace: RegExp;
+        pattern: RegExp;
+        swarmId: RegExp;
+        agentName: RegExp;
+        taskId: RegExp;
+        category: RegExp;
+        topology: RegExp;
+        agentType: RegExp;
+        strategy: RegExp;
+        priority: RegExp;
+    };
+};
+export default _default;
+//# sourceMappingURL=safe-exec.d.ts.map