agentic-flow 1.10.0 → 1.10.2

package/dist/utils/lazy-auth.js

@@ -0,0 +1,311 @@
+/**
+ * Lazy Authentication with Session Caching
+ * Reduces auth overhead by 5-10% through session caching and lazy validation
+ * Phase 3 Optimization
+ */
+/**
+ * Lazy Authentication Manager
+ * Caches validated sessions to avoid repeated authentication overhead
+ */
+export class LazyAuthManager {
+    config;
+    sessions = new Map();
+    stats;
+    cleanupTimer;
+    validationQueue = new Set();
+    constructor(config) {
+        this.config = {
+            enabled: config.enabled,
+            ttl: config.ttl || 3600000, // 1 hour default
+            maxSessions: config.maxSessions || 1000,
+            checkInterval: config.checkInterval || 60000 // 1 minute
+        };
+        this.stats = {
+            totalValidations: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            sessionsActive: 0,
+            sessionsCleaned: 0,
+            avgValidationTime: 0
+        };
+        if (this.config.enabled) {
+            this.startCleanupTimer();
+        }
+    }
+    /**
+     * Authenticate a token (lazy validation)
+     */
+    async authenticate(token, validateFn) {
+        if (!this.config.enabled) {
+            // No caching, always validate
+            const userId = await validateFn(token);
+            return this.createSession(token, userId, true);
+        }
+        // Check cache first
+        const cached = this.sessions.get(token);
+        if (cached && !this.isExpired(cached)) {
+            this.stats.cacheHits++;
+            cached.lastAccessedAt = Date.now();
+            return cached;
+        }
+        this.stats.cacheMisses++;
+        // Lazy validation: check if already being validated
+        if (this.validationQueue.has(token)) {
+            // Wait for ongoing validation
+            return this.waitForValidation(token);
+        }
+        // Perform validation
+        return this.validateAndCache(token, validateFn);
+    }
+    /**
+     * Validate token and cache the session
+     */
+    async validateAndCache(token, validateFn) {
+        this.validationQueue.add(token);
+        try {
+            const startTime = Date.now();
+            const userId = await validateFn(token);
+            const validationTime = Date.now() - startTime;
+            // Update average validation time
+            this.updateAvgValidationTime(validationTime);
+            this.stats.totalValidations++;
+            // Create and cache session
+            const session = this.createSession(token, userId, true);
+            this.cacheSession(session);
+            return session;
+        }
+        catch (error) {
+            return null;
+        }
+        finally {
+            this.validationQueue.delete(token);
+        }
+    }
+    /**
+     * Wait for ongoing validation
+     */
+    async waitForValidation(token) {
+        // Poll for validation completion (max 5 seconds)
+        const maxAttempts = 50;
+        let attempts = 0;
+        while (this.validationQueue.has(token) && attempts < maxAttempts) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+            attempts++;
+        }
+        // Check cache after validation
+        const session = this.sessions.get(token);
+        return session && !this.isExpired(session) ? session : null;
+    }
+    /**
+     * Create a session object
+     */
+    createSession(token, userId, validated) {
+        const now = Date.now();
+        return {
+            token,
+            userId,
+            validated,
+            createdAt: now,
+            lastAccessedAt: now,
+            expiresAt: now + this.config.ttl
+        };
+    }
+    /**
+     * Cache a session
+     */
+    cacheSession(session) {
+        // Check max sessions limit
+        if (this.sessions.size >= this.config.maxSessions) {
+            this.evictOldest();
+        }
+        this.sessions.set(session.token, session);
+        this.stats.sessionsActive = this.sessions.size;
+    }
+    /**
+     * Check if session is expired
+     */
+    isExpired(session) {
+        return Date.now() > session.expiresAt;
+    }
+    /**
+     * Evict oldest session (LRU)
+     */
+    evictOldest() {
+        let oldest = null;
+        let oldestToken = null;
+        for (const [token, session] of this.sessions) {
+            if (!oldest || session.lastAccessedAt < oldest.lastAccessedAt) {
+                oldest = session;
+                oldestToken = token;
+            }
+        }
+        if (oldestToken) {
+            this.sessions.delete(oldestToken);
+            this.stats.sessionsCleaned++;
+        }
+    }
+    /**
+     * Update average validation time
+     */
+    updateAvgValidationTime(newTime) {
+        const total = this.stats.totalValidations;
+        const currentAvg = this.stats.avgValidationTime;
+        this.stats.avgValidationTime = (currentAvg * total + newTime) / (total + 1);
+    }
+    /**
+     * Start cleanup timer for expired sessions
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, this.config.checkInterval);
+    }
+    /**
+     * Clean up expired sessions
+     */
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [token, session] of this.sessions) {
+            if (now > session.expiresAt) {
+                this.sessions.delete(token);
+                cleaned++;
+            }
+        }
+        this.stats.sessionsCleaned += cleaned;
+        this.stats.sessionsActive = this.sessions.size;
+    }
+    /**
+     * Invalidate a session
+     */
+    invalidate(token) {
+        return this.sessions.delete(token);
+    }
+    /**
+     * Invalidate all sessions for a user
+     */
+    invalidateUser(userId) {
+        let count = 0;
+        for (const [token, session] of this.sessions) {
+            if (session.userId === userId) {
+                this.sessions.delete(token);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get session if exists and valid
+     */
+    getSession(token) {
+        const session = this.sessions.get(token);
+        if (!session || this.isExpired(session)) {
+            return null;
+        }
+        session.lastAccessedAt = Date.now();
+        return session;
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get cache hit rate
+     */
+    getCacheHitRate() {
+        const total = this.stats.cacheHits + this.stats.cacheMisses;
+        return total > 0 ? (this.stats.cacheHits / total) * 100 : 0;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalValidations: 0,
+            cacheHits: 0,
+            cacheMisses: 0,
+            sessionsActive: this.sessions.size,
+            sessionsCleaned: 0,
+            avgValidationTime: 0
+        };
+    }
+    /**
+     * Clear all sessions
+     */
+    clear() {
+        this.sessions.clear();
+        this.stats.sessionsActive = 0;
+    }
+    /**
+     * Destroy manager and cleanup
+     */
+    destroy() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+        }
+        this.clear();
+    }
+}
+/**
+ * Token-based authentication helper
+ */
+export class TokenAuth {
+    authManager;
+    validateFn;
+    constructor(authManager, validateFn) {
+        this.authManager = authManager;
+        this.validateFn = validateFn;
+    }
+    /**
+     * Authenticate a request
+     */
+    async authenticate(authHeader) {
+        // Extract token from header
+        const token = this.extractToken(authHeader);
+        if (!token) {
+            return null;
+        }
+        return this.authManager.authenticate(token, this.validateFn);
+    }
+    /**
+     * Extract token from Authorization header
+     */
+    extractToken(authHeader) {
+        if (!authHeader) {
+            return null;
+        }
+        // Support "Bearer <token>" and raw token
+        if (authHeader.startsWith('Bearer ')) {
+            return authHeader.substring(7);
+        }
+        return authHeader;
+    }
+    /**
+     * Invalidate token
+     */
+    invalidate(token) {
+        return this.authManager.invalidate(token);
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return this.authManager.getStats();
+    }
+}
+/**
+ * Calculate auth overhead reduction
+ */
+export function calculateAuthSavings(stats) {
+    const hitRate = stats.cacheHits / (stats.cacheHits + stats.cacheMisses);
+    const savingsPercentage = hitRate * 100;
+    const avgSavedTime = stats.avgValidationTime * hitRate;
+    const totalSavedTime = stats.avgValidationTime * stats.cacheHits;
+    return {
+        savingsPercentage,
+        avgSavedTime,
+        totalSavedTime
+    };
+}

package/dist/utils/logger.d.ts

@@ -0,0 +1,19 @@
+interface LogContext {
+    agent?: string;
+    task?: string;
+    duration?: number;
+    error?: unknown;
+    [key: string]: any;
+}
+declare class Logger {
+    private context;
+    setContext(ctx: Record<string, any>): void;
+    private log;
+    debug(message: string, data?: LogContext): void;
+    info(message: string, data?: LogContext): void;
+    warn(message: string, data?: LogContext): void;
+    error(message: string, data?: LogContext): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,OAAO,CAA2B;IAE1C,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAInC,OAAO,CAAC,GAAG;IA4BX,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU;IAQxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU;IAQvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU;IAQvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU;CAGzC;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -55,3 +55,4 @@ class Logger {
     }
 }
 export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM;IACF,OAAO,GAAwB,EAAE,CAAC;IAE1C,UAAU,CAAC,GAAwB;QACjC,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IAC7C,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAAiB;QAC7D,gEAAgE;QAChE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG;YACf,SAAS;YACT,KAAK;YACL,OAAO;YACP,GAAG,IAAI,CAAC,OAAO;YACf,GAAG,IAAI;SACR,CAAC;QAEF,yCAAyC;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,MAAM,MAAM,GAAG,IAAI,SAAS,KAAK,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC;gBACrE,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE;gBACpD,CAAC,CAAC,EAAE,CAAC;YACP,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,KAAK,OAAO,GAAG,UAAU,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAiB;QACtC,sEAAsE;QACtE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAiB;QACrC,uCAAuC;QACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAiB;QACrC,sCAAsC;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAiB;QACtC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC","sourcesContent":["// Structured logging utility\ntype LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\ninterface LogContext {\n  agent?: string;\n  task?: string;\n  duration?: number;\n  error?: unknown;\n  [key: string]: any;\n}\n\nclass Logger {\n  private context: Record<string, any> = {};\n\n  setContext(ctx: Record<string, any>) {\n    this.context = { ...this.context, ...ctx };\n  }\n\n  private log(level: LogLevel, message: string, data?: LogContext) {\n    // Skip all logs if QUIET mode is enabled (unless it's an error)\n    if (process.env.QUIET === 'true' && level !== 'error') {\n      return;\n    }\n\n    const timestamp = new Date().toISOString();\n    const logEntry = {\n      timestamp,\n      level,\n      message,\n      ...this.context,\n      ...data\n    };\n\n    // Structured JSON logging for production\n    if (process.env.NODE_ENV === 'production') {\n      console.log(JSON.stringify(logEntry));\n    } else {\n      // Human-readable for development\n      const prefix = `[${timestamp}] ${level.toUpperCase()}`;\n      const contextStr = Object.keys({ ...this.context, ...data }).length > 0\n        ? ` ${JSON.stringify({ ...this.context, ...data })}`\n        : '';\n      console.log(`${prefix}: ${message}${contextStr}`);\n    }\n  }\n\n  debug(message: string, data?: LogContext) {\n    // Skip debug logs unless DEBUG or VERBOSE environment variable is set\n    if (!process.env.DEBUG && !process.env.VERBOSE) {\n      return;\n    }\n    this.log('debug', message, data);\n  }\n\n  info(message: string, data?: LogContext) {\n    // Skip info logs unless VERBOSE is set\n    if (!process.env.DEBUG && !process.env.VERBOSE) {\n      return;\n    }\n    this.log('info', message, data);\n  }\n\n  warn(message: string, data?: LogContext) {\n    // Skip warnings unless VERBOSE is set\n    if (!process.env.DEBUG && !process.env.VERBOSE) {\n      return;\n    }\n    this.log('warn', message, data);\n  }\n\n  error(message: string, data?: LogContext) {\n    this.log('error', message, data);\n  }\n}\n\nexport const logger = new Logger();\n"]}

package/dist/utils/math.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Simple math utility functions
+ */
+/**
+ * Adds 2 and 2 together
+ * @returns The sum of 2 + 2
+ * @example
+ * const result = addTwoPlusTwo();
+ * console.log(result); // Output: 4
+ */
+export declare const addTwoPlusTwo: () => number;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,QAAO,MAEhC,CAAC"}

package/dist/utils/math.js

@@ -11,3 +11,4 @@
 export const addTwoPlusTwo = () => {
     return 2 + 2;
 };
+//# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAW,EAAE;IACxC,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC,CAAC","sourcesContent":["/**\n * Simple math utility functions\n */\n\n/**\n * Adds 2 and 2 together\n * @returns The sum of 2 + 2\n * @example\n * const result = addTwoPlusTwo();\n * console.log(result); // Output: 4\n */\nexport const addTwoPlusTwo = (): number => {\n  return 2 + 2;\n};\n"]}

package/dist/utils/mcpCommands.d.ts

@@ -0,0 +1,2 @@
+export declare function handleMCPCommand(command: string, server?: string): Promise<void>;
+//# sourceMappingURL=mcpCommands.d.ts.map

package/dist/utils/mcpCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpCommands.d.ts","sourceRoot":"","sources":["../../src/utils/mcpCommands.ts"],"names":[],"mappings":"AAsCA,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7F"}

package/dist/utils/mcpCommands.js

@@ -212,3 +212,4 @@ function getExampleTools(serverName) {
             return [];
     }
 }
+//# sourceMappingURL=mcpCommands.js.map

package/dist/utils/mcpCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpCommands.js","sourceRoot":"","sources":["../../src/utils/mcpCommands.ts"],"names":[],"mappings":"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","sourcesContent":["// MCP server management commands\nimport { spawn, exec } from 'child_process';\nimport { promisify } from 'util';\n\nconst execAsync = promisify(exec);\n\ninterface MCPServerConfig {\n  name: string;\n  command: string;\n  args: string[];\n  description: string;\n  toolCount: number;\n}\n\nconst MCP_SERVERS: Record<string, MCPServerConfig> = {\n  'claude-flow': {\n    name: 'claude-flow',\n    command: 'npx',\n    args: ['claude-flow@alpha', 'mcp', 'start'],\n    description: '101 tools (neural networks, GitHub, workflows, DAA)',\n    toolCount: 101\n  },\n  'flow-nexus': {\n    name: 'flow-nexus',\n    command: 'npx',\n    args: ['flow-nexus@latest', 'mcp', 'start'],\n    description: '96 cloud tools (sandboxes, distributed swarms, templates)',\n    toolCount: 96\n  },\n  'agentic-payments': {\n    name: 'agentic-payments',\n    command: 'npx',\n    args: ['-y', 'agentic-payments', 'mcp'],\n    description: 'Payment authorization and multi-agent consensus',\n    toolCount: 10\n  }\n};\n\nexport async function handleMCPCommand(command: string, server: string = 'all'): Promise<void> {\n  switch (command) {\n    case 'start':\n      await startMCPServers(server);\n      break;\n    case 'stop':\n      await stopMCPServers(server);\n      break;\n    case 'status':\n      await checkMCPStatus(server);\n      break;\n    case 'list':\n      await listMCPTools(server);\n      break;\n    default:\n      console.error(`❌ Unknown MCP command: ${command}`);\n      console.error('Available commands: start, stop, status, list');\n      process.exit(1);\n  }\n}\n\nasync function startMCPServers(server: string): Promise<void> {\n  console.log(`\\n🚀 Starting MCP Server(s): ${server}\\n`);\n\n  const serversToStart = server === 'all'\n    ? Object.keys(MCP_SERVERS)\n    : [server];\n\n  for (const serverName of serversToStart) {\n    const config = MCP_SERVERS[serverName];\n    if (!config) {\n      console.error(`❌ Unknown server: ${serverName}`);\n      continue;\n    }\n\n    console.log(`📦 ${config.name}`);\n    console.log(`   ${config.description}`);\n    console.log(`   Command: ${config.command} ${config.args.join(' ')}`);\n    console.log(`   Status: Starting as subprocess...\\n`);\n\n    // Start server in background\n    const child = spawn(config.command, config.args, {\n      detached: true,\n      stdio: 'inherit',\n      env: {\n        ...process.env,\n        MCP_AUTO_START: 'true'\n      }\n    });\n\n    child.unref(); // Allow parent to exit independently\n  }\n\n  console.log(`\\n✅ MCP server(s) started in background`);\n  console.log(`💡 Tip: Use 'npx agentic-flow mcp status' to check server status\\n`);\n}\n\nasync function stopMCPServers(server: string): Promise<void> {\n  console.log(`\\n🛑 Stopping MCP Server(s): ${server}\\n`);\n\n  const serversToStop = server === 'all'\n    ? Object.keys(MCP_SERVERS)\n    : [server];\n\n  for (const serverName of serversToStop) {\n    const config = MCP_SERVERS[serverName];\n    if (!config) {\n      console.error(`❌ Unknown server: ${serverName}`);\n      continue;\n    }\n\n    try {\n      // Try to kill processes by name\n      const killCommand = process.platform === 'win32'\n        ? `taskkill /F /IM node.exe /FI \"WINDOWTITLE eq ${serverName}*\"`\n        : `pkill -f \"${serverName}\"`;\n\n      await execAsync(killCommand);\n      console.log(`✅ Stopped ${config.name}`);\n    } catch (error: any) {\n      if (error.code === 1) {\n        console.log(`⚠️  ${config.name} not running`);\n      } else {\n        console.error(`❌ Error stopping ${config.name}:`, error.message);\n      }\n    }\n  }\n\n  console.log();\n}\n\nasync function checkMCPStatus(server: string): Promise<void> {\n  console.log(`\\n📊 MCP Server Status: ${server}\\n`);\n\n  const serversToCheck = server === 'all'\n    ? Object.keys(MCP_SERVERS)\n    : [server];\n\n  for (const serverName of serversToCheck) {\n    const config = MCP_SERVERS[serverName];\n    if (!config) {\n      console.error(`❌ Unknown server: ${serverName}`);\n      continue;\n    }\n\n    console.log(`📦 ${config.name}`);\n    console.log(`   Description: ${config.description}`);\n    console.log(`   Tool Count: ${config.toolCount}`);\n\n    try {\n      // Check if process is running\n      const checkCommand = process.platform === 'win32'\n        ? `tasklist /FI \"IMAGENAME eq node.exe\" /FO CSV | findstr /C:\"${serverName}\"`\n        : `pgrep -f \"${serverName}\"`;\n\n      const { stdout } = await execAsync(checkCommand);\n      const isRunning = stdout.trim().length > 0;\n\n      console.log(`   Status: ${isRunning ? '✅ Running' : '⚠️  Not running'}`);\n    } catch (error) {\n      console.log(`   Status: ⚠️  Not running`);\n    }\n    console.log();\n  }\n}\n\nasync function listMCPTools(server: string): Promise<void> {\n  console.log(`\\n📋 MCP Tools Available\\n`);\n\n  const serversToList = server === 'all'\n    ? Object.keys(MCP_SERVERS)\n    : [server];\n\n  let totalTools = 0;\n\n  for (const serverName of serversToList) {\n    const config = MCP_SERVERS[serverName];\n    if (!config) {\n      console.error(`❌ Unknown server: ${serverName}`);\n      continue;\n    }\n\n    console.log(`\\n📦 ${config.name.toUpperCase()} (${config.toolCount} tools)`);\n    console.log(`   ${config.description}`);\n    console.log();\n\n    totalTools += config.toolCount;\n\n    // Show example tools based on server\n    const examples = getExampleTools(serverName);\n    examples.forEach(tool => {\n      console.log(`   • ${tool}`);\n    });\n  }\n\n  // Add in-SDK tools\n  console.log(`\\n📦 CLAUDE-FLOW-SDK (6 in-process tools)`);\n  console.log(`   Fast, zero-latency tools running in-process`);\n  console.log();\n  console.log(`   • memory_store - Store values in persistent memory`);\n  console.log(`   • memory_retrieve - Retrieve values from memory`);\n  console.log(`   • memory_list - List all memory keys`);\n  console.log(`   • swarm_init - Initialize agent swarms`);\n  console.log(`   • agent_spawn - Spawn specialized agents`);\n  console.log(`   • coordination_sync - Synchronize agent coordination`);\n\n  totalTools += 6;\n\n  console.log(`\\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);\n  console.log(`📊 TOTAL: ${totalTools} MCP tools available`);\n  console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n`);\n\n  console.log(`💡 Usage: Tools are automatically available to agents`);\n  console.log(`   npx agentic-flow --agent coder --task \"Your task\"\\n`);\n}\n\nfunction getExampleTools(serverName: string): string[] {\n  switch (serverName) {\n    case 'claude-flow':\n      return [\n        'swarm_init - Initialize multi-agent swarms',\n        'agent_spawn - Create specialized AI agents',\n        'task_orchestrate - Orchestrate complex tasks',\n        'neural_train - Train neural networks with WASM',\n        'github_repo_analyze - Analyze GitHub repositories',\n        'workflow_create - Create automated workflows',\n        'daa_agent_create - Create autonomous agents',\n        'performance_report - Generate performance metrics',\n        '... and 93 more tools'\n      ];\n    case 'flow-nexus':\n      return [\n        'sandbox_create - Create isolated E2B sandboxes',\n        'sandbox_execute - Execute code in sandboxes',\n        'swarm_init - Initialize cloud-based swarms',\n        'neural_train - Distributed neural training',\n        'workflow_create - Event-driven workflows',\n        'template_deploy - Deploy project templates',\n        'user_login - Authenticate Flow Nexus users',\n        'storage_upload - Cloud file storage',\n        '... and 88 more tools'\n      ];\n    case 'agentic-payments':\n      return [\n        'create_active_mandate - Create payment authorization',\n        'sign_mandate - Sign with Ed25519 cryptography',\n        'verify_mandate - Verify payment signatures',\n        'revoke_mandate - Revoke authorizations',\n        'verify_consensus - Multi-agent consensus',\n        'generate_agent_identity - Create agent identities',\n        '... and 4 more tools'\n      ];\n    default:\n      return [];\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/model-downloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-downloader.d.ts","sourceRoot":"","sources":["../../src/utils/model-downloader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAA4B;IAE3C;;;;OAIG;IACH,OAAO,CAAC,SAAS,CAIf;IAEF,OAAO,CAAC,aAAa,CAInB;IAEF;;OAEG;IACH,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAK9C;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,aAAa,CACjB,SAAS,CAAC,EAAE,SAAS,EACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,MAAM,CAAC;IAkFlB;;OAEG;IACG,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BzF;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB/E;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM;CAI1D;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAErD;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,GAChD,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/utils/model-downloader.js

@@ -180,3 +180,4 @@ export const modelDownloader = new ModelDownloader();
 export async function ensurePhi4Model(onProgress) {
     return modelDownloader.ensurePhi4Model(onProgress);
 }
+//# sourceMappingURL=model-downloader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-downloader.js","sourceRoot":"","sources":["../../src/utils/model-downloader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Automatic Model Downloader for ONNX Phi-4\n *\n * Downloads Phi-4 ONNX model from HuggingFace on first use\n */\n\nimport { createWriteStream, existsSync, mkdirSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { pipeline } from 'stream/promises';\nimport { createHash } from 'crypto';\nimport { readFileSync } from 'fs';\n\nexport interface DownloadProgress {\n  downloaded: number;\n  total: number;\n  percentage: number;\n}\n\nexport interface ModelInfo {\n  repo: string;\n  filename: string;\n  localPath: string;\n  sha256?: string;\n}\n\nexport class ModelDownloader {\n  private baseUrl = 'https://huggingface.co';\n\n  /**\n   * Phi-4 Mini ONNX INT4 quantized model (CPU optimized)\n   * Size: ~52MB model + ~4.86GB data = ~4.9GB total\n   * Note: Requires TWO files - model.onnx and model.onnx.data\n   */\n  private phi4Model: ModelInfo = {\n    repo: 'microsoft/Phi-4-mini-instruct-onnx',\n    filename: 'cpu_and_mobile/cpu-int4-rtn-block-32-acc-level-4/model.onnx',\n    localPath: './models/phi-4-mini/cpu_and_mobile/cpu-int4-rtn-block-32-acc-level-4/model.onnx'\n  };\n\n  private phi4ModelData: ModelInfo = {\n    repo: 'microsoft/Phi-4-mini-instruct-onnx',\n    filename: 'cpu_and_mobile/cpu-int4-rtn-block-32-acc-level-4/model.onnx.data',\n    localPath: './models/phi-4-mini/cpu_and_mobile/cpu-int4-rtn-block-32-acc-level-4/model.onnx.data'\n  };\n\n  /**\n   * Check if model exists locally\n   */\n  isModelDownloaded(modelPath?: string): boolean {\n    const path = modelPath || this.phi4Model.localPath;\n    return existsSync(path);\n  }\n\n  /**\n   * Get model download URL\n   */\n  private getDownloadUrl(model: ModelInfo): string {\n    return `${this.baseUrl}/${model.repo}/resolve/main/${model.filename}`;\n  }\n\n  /**\n   * Download model with progress tracking\n   */\n  async downloadModel(\n    modelInfo?: ModelInfo,\n    onProgress?: (progress: DownloadProgress) => void\n  ): Promise<string> {\n    const model = modelInfo || this.phi4Model;\n\n    // Check if already downloaded\n    if (this.isModelDownloaded(model.localPath)) {\n      console.log(`✅ Model already exists at ${model.localPath}`);\n      return model.localPath;\n    }\n\n    // Create directory\n    const dir = dirname(model.localPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    const url = this.getDownloadUrl(model);\n    console.log(`📦 Downloading Phi-4 ONNX model from HuggingFace...`);\n    console.log(`   URL: ${url}`);\n    console.log(`   Destination: ${model.localPath}`);\n\n    try {\n      const response = await fetch(url);\n\n      if (!response.ok) {\n        throw new Error(`Download failed: ${response.statusText}`);\n      }\n\n      const totalSize = parseInt(response.headers.get('content-length') || '0', 10);\n      let downloadedSize = 0;\n\n      if (!response.body) {\n        throw new Error('Response body is null');\n      }\n\n      const fileStream = createWriteStream(model.localPath);\n\n      // Track progress\n      const reader = response.body.getReader();\n      const chunks: Uint8Array[] = [];\n\n      while (true) {\n        const { done, value } = await reader.read();\n\n        if (done) break;\n\n        if (value) {\n          chunks.push(value);\n          downloadedSize += value.length;\n\n          if (onProgress && totalSize > 0) {\n            onProgress({\n              downloaded: downloadedSize,\n              total: totalSize,\n              percentage: (downloadedSize / totalSize) * 100\n            });\n          }\n\n          // Write chunk\n          fileStream.write(value);\n        }\n      }\n\n      fileStream.end();\n\n      // Wait for file stream to finish\n      await new Promise<void>((resolve, reject) => {\n        fileStream.on('finish', () => resolve());\n        fileStream.on('error', reject);\n      });\n\n      console.log(`✅ Model downloaded successfully`);\n      console.log(`   Size: ${(downloadedSize / (1024 * 1024)).toFixed(2)} MB`);\n      console.log(`   Path: ${model.localPath}`);\n\n      return model.localPath;\n\n    } catch (error) {\n      console.error(`❌ Model download failed:`, error);\n      throw new Error(`Failed to download model: ${error}`);\n    }\n  }\n\n  /**\n   * Download Phi-4 ONNX model if needed (downloads BOTH .onnx and .onnx.data files)\n   */\n  async ensurePhi4Model(onProgress?: (progress: DownloadProgress) => void): Promise<string> {\n    const mainFileExists = this.isModelDownloaded(this.phi4Model.localPath);\n    const dataFileExists = this.isModelDownloaded(this.phi4ModelData.localPath);\n\n    if (mainFileExists && dataFileExists) {\n      return this.phi4Model.localPath;\n    }\n\n    console.log(`🔍 Phi-4-mini ONNX model not found locally`);\n    console.log(`📥 Starting automatic download...`);\n    console.log(`   This is a one-time download (~4.9GB total)`);\n    console.log(`   Model: microsoft/Phi-4-mini-instruct-onnx (INT4 quantized)`);\n    console.log(`   Files: model.onnx (~52MB) + model.onnx.data (~4.86GB)`);\n    console.log(``);\n\n    // Download main model file if missing\n    if (!mainFileExists) {\n      console.log(`📦 Downloading model.onnx...`);\n      await this.downloadModel(this.phi4Model, onProgress);\n      console.log(``);\n    }\n\n    // Download data file if missing\n    if (!dataFileExists) {\n      console.log(`📦 Downloading model.onnx.data (this is the large 4.86GB file)...`);\n      await this.downloadModel(this.phi4ModelData, onProgress);\n    }\n\n    return this.phi4Model.localPath;\n  }\n\n  /**\n   * Verify model file integrity (optional)\n   */\n  async verifyModel(modelPath: string, expectedSha256?: string): Promise<boolean> {\n    if (!expectedSha256) {\n      return true; // Skip verification if no hash provided\n    }\n\n    try {\n      const fileBuffer = readFileSync(modelPath);\n      const hash = createHash('sha256').update(fileBuffer).digest('hex');\n\n      if (hash !== expectedSha256) {\n        console.error(`❌ Model verification failed`);\n        console.error(`   Expected: ${expectedSha256}`);\n        console.error(`   Got:      ${hash}`);\n        return false;\n      }\n\n      console.log(`✅ Model verification passed`);\n      return true;\n\n    } catch (error) {\n      console.error(`❌ Model verification error:`, error);\n      return false;\n    }\n  }\n\n  /**\n   * Get model info\n   */\n  getModelInfo(): ModelInfo {\n    return this.phi4Model;\n  }\n\n  /**\n   * Format download progress for display\n   */\n  static formatProgress(progress: DownloadProgress): string {\n    const mb = (bytes: number) => (bytes / (1024 * 1024)).toFixed(2);\n    return `${progress.percentage.toFixed(1)}% (${mb(progress.downloaded)}/${mb(progress.total)} MB)`;\n  }\n}\n\n/**\n * Global singleton instance\n */\nexport const modelDownloader = new ModelDownloader();\n\n/**\n * Convenience function for downloading Phi-4 model\n */\nexport async function ensurePhi4Model(\n  onProgress?: (progress: DownloadProgress) => void\n): Promise<string> {\n  return modelDownloader.ensurePhi4Model(onProgress);\n}\n"]}

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/modelCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCapabilities.d.ts","sourceRoot":"","sources":["../../src/utils/modelCapabilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4LD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA0C1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAU9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAC9C,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAiB1C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuB3D"}

package/dist/utils/modelCapabilities.js

@@ -274,3 +274,4 @@ export function getCapabilityReport(modelId) {
     report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;
     return report;
 }
+//# sourceMappingURL=modelCapabilities.js.map

package/dist/utils/modelCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCapabilities.js","sourceRoot":"","sources":["../../src/utils/modelCapabilities.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Model Capability Detection\n * Determines if a model supports native tool calling or requires emulation\n */\n\nexport interface ModelCapabilities {\n  supportsNativeTools: boolean;\n  supportsStreaming: boolean;\n  contextWindow: number;\n  requiresEmulation: boolean;\n  emulationStrategy: 'none' | 'react' | 'prompt' | 'hybrid';\n  costPerMillionTokens: number;\n  provider: string;\n}\n\n/**\n * Database of known model capabilities\n * Updated periodically as new models are released\n */\nconst MODEL_CAPABILITIES: Record<string, Partial<ModelCapabilities>> = {\n  // OpenRouter - Native Tool Support\n  'deepseek/deepseek-chat': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'deepseek/deepseek-chat-v3': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'meta-llama/llama-3.3-70b-instruct': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.40\n  },\n  'qwen/qwen-2.5-coder-32b-instruct': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.23\n  },\n  'mistralai/mistral-small-3.1-24b-instruct': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.30\n  },\n\n  // OpenAI Models (via OpenRouter/Requesty)\n  'openai/gpt-4o': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 2.50\n  },\n  'openai/gpt-4o-mini': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'openai/gpt-4-turbo': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 10.00\n  },\n\n  // OpenRouter - No Native Tool Support (Require Emulation)\n  'mistralai/mistral-7b-instruct': {\n    supportsNativeTools: false,\n    contextWindow: 32000,\n    requiresEmulation: true,\n    emulationStrategy: 'react',  // Best for this model\n    costPerMillionTokens: 0.07\n  },\n  'meta-llama/llama-2-13b-chat': {\n    supportsNativeTools: false,\n    contextWindow: 4096,\n    requiresEmulation: true,\n    emulationStrategy: 'prompt',  // Simple prompting works best\n    costPerMillionTokens: 0.05\n  },\n  'google/gemma-7b-it': {\n    supportsNativeTools: false,\n    contextWindow: 8192,\n    requiresEmulation: true,\n    emulationStrategy: 'prompt',\n    costPerMillionTokens: 0.07\n  },\n  'thudm/glm-4-9b:free': {\n    supportsNativeTools: false,  // Free tier limited\n    contextWindow: 32000,\n    requiresEmulation: true,\n    emulationStrategy: 'react',\n    costPerMillionTokens: 0.0  // FREE\n  },\n\n  // Anthropic - Native Tool Support\n  'claude-3-5-sonnet-20241022': {\n    supportsNativeTools: true,\n    contextWindow: 200000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 3.0\n  },\n  'claude-3-5-haiku-20241022': {\n    supportsNativeTools: true,\n    contextWindow: 200000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.80\n  },\n\n  // Gemini - Native Tool Support\n  'gemini-2.0-flash-exp': {\n    supportsNativeTools: true,\n    contextWindow: 1000000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.0  // FREE tier\n  },\n\n  // OpenAI - Native Tool Support\n  'gpt-4o': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 2.50\n  },\n  'gpt-4o-mini': {\n    supportsNativeTools: true,\n    contextWindow: 128000,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.15\n  },\n  'gpt-3.5-turbo': {\n    supportsNativeTools: true,\n    contextWindow: 16385,\n    requiresEmulation: false,\n    emulationStrategy: 'none',\n    costPerMillionTokens: 0.50\n  }\n};\n\n/**\n * Pattern matching for model families\n */\nconst MODEL_PATTERNS: Array<{\n  pattern: RegExp;\n  capabilities: Partial<ModelCapabilities>;\n}> = [\n  {\n    pattern: /^claude-3/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /^gpt-(4|3\\.5)/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /^gemini-/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /deepseek\\/deepseek-(chat|coder)/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /llama-3\\.(3|2|1)-.*instruct/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /qwen.*2\\.5/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  {\n    pattern: /mistral.*large|mistral.*small/,\n    capabilities: { supportsNativeTools: true, requiresEmulation: false }\n  },\n  // Older models typically don't support tools\n  {\n    pattern: /llama-2|mistral-7b|gemma-.*7b/,\n    capabilities: { supportsNativeTools: false, requiresEmulation: true, emulationStrategy: 'react' }\n  }\n];\n\n/**\n * Detect capabilities of a model\n */\nexport function detectModelCapabilities(modelId: string): ModelCapabilities {\n  // Direct lookup\n  if (MODEL_CAPABILITIES[modelId]) {\n    return {\n      supportsNativeTools: false,\n      supportsStreaming: true,\n      contextWindow: 4096,\n      requiresEmulation: true,\n      emulationStrategy: 'prompt',\n      costPerMillionTokens: 0.5,\n      provider: 'unknown',\n      ...MODEL_CAPABILITIES[modelId]\n    };\n  }\n\n  // Pattern matching\n  for (const { pattern, capabilities } of MODEL_PATTERNS) {\n    if (pattern.test(modelId)) {\n      return {\n        supportsNativeTools: false,\n        supportsStreaming: true,\n        contextWindow: 4096,\n        requiresEmulation: true,\n        emulationStrategy: 'prompt',\n        costPerMillionTokens: 0.5,\n        provider: 'unknown',\n        ...capabilities\n      };\n    }\n  }\n\n  // Unknown model - assume needs emulation (conservative)\n  console.warn(`⚠️  Unknown model: ${modelId}. Assuming no native tool support.`);\n  return {\n    supportsNativeTools: false,\n    supportsStreaming: true,\n    contextWindow: 4096,\n    requiresEmulation: true,\n    emulationStrategy: 'prompt',\n    costPerMillionTokens: 0.5,\n    provider: 'unknown'\n  };\n}\n\n/**\n * Check if model can handle a specific number of tools\n */\nexport function canHandleToolCount(modelId: string, toolCount: number): boolean {\n  const capabilities = detectModelCapabilities(modelId);\n\n  // Estimate: Each tool ~100 tokens of schema\n  const estimatedTokens = toolCount * 100;\n\n  // Need at least 20% of context window free for actual conversation\n  const maxToolTokens = capabilities.contextWindow * 0.8;\n\n  return estimatedTokens <= maxToolTokens;\n}\n\n/**\n * Recommend optimal strategy for a model\n */\nexport function recommendStrategy(\n  modelId: string,\n  toolCount: number,\n  taskComplexity: 'simple' | 'medium' | 'complex'\n): 'native' | 'react' | 'prompt' | 'hybrid' {\n  const capabilities = detectModelCapabilities(modelId);\n\n  if (capabilities.supportsNativeTools) {\n    return 'native';\n  }\n\n  // For emulation, choose based on context and complexity\n  if (toolCount > 10 || taskComplexity === 'complex') {\n    return 'react';  // More robust for complex scenarios\n  }\n\n  if (capabilities.contextWindow < 8000) {\n    return 'prompt';  // Simpler for small context windows\n  }\n\n  return 'react';  // Default to ReAct pattern\n}\n\n/**\n * Get human-readable capability report\n */\nexport function getCapabilityReport(modelId: string): string {\n  const cap = detectModelCapabilities(modelId);\n\n  let report = `\\n📊 Model Capabilities: ${modelId}\\n`;\n  report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n`;\n  report += `Native Tool Support:  ${cap.supportsNativeTools ? '✅ Yes' : '❌ No'}\\n`;\n  report += `Context Window:       ${cap.contextWindow.toLocaleString()} tokens\\n`;\n  report += `Streaming:            ${cap.supportsStreaming ? '✅ Yes' : '❌ No'}\\n`;\n  report += `Cost per 1M tokens:   $${cap.costPerMillionTokens}\\n`;\n\n  if (cap.requiresEmulation) {\n    report += `\\n⚙️  Emulation Required\\n`;\n    report += `Recommended Strategy: ${cap.emulationStrategy.toUpperCase()}\\n`;\n    report += `\\nNote: This model will use prompt-based tool emulation.\\n`;\n    report += `Expect 70-85% reliability vs 95%+ for native tool support.\\n`;\n  } else {\n    report += `\\n✅ No Emulation Needed\\n`;\n    report += `This model natively supports function calling.\\n`;\n  }\n\n  report += `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\\n`;\n\n  return report;\n}\n"]}