agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/utils/agentdb-runtime-patch.js

@@ -0,0 +1,178 @@
+/**
+ * AgentDB Runtime Patch
+ *
+ * Automatically fixes AgentDB v1.3.9 import resolution issues at runtime.
+ * This patch works in all contexts: npm install, npm install -g, and npx.
+ *
+ * Issue: agentdb v1.3.9 missing .js extensions in ESM exports
+ * Solution: Patch the controller index.js file at runtime before first import
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+let patched = false;
+let patchAttempted = false;
+/**
+ * Apply AgentDB import fix at runtime
+ * Safe to call multiple times - only patches once
+ */
+export function applyAgentDBPatch() {
+    // Only attempt once per process
+    if (patchAttempted) {
+        return patched;
+    }
+    patchAttempted = true;
+    try {
+        // Find agentdb installation
+        const agentdbPath = findAgentDBPath();
+        if (!agentdbPath) {
+            return false;
+        }
+        // Try both v2 and v3 paths
+        let controllerIndexPath = join(agentdbPath, 'dist', 'controllers', 'index.js');
+        // AgentDB v3+ has controllers at dist/src/controllers/
+        if (!existsSync(controllerIndexPath)) {
+            controllerIndexPath = join(agentdbPath, 'dist', 'src', 'controllers', 'index.js');
+        }
+        if (!existsSync(controllerIndexPath)) {
+            // No controllers index found — patch not needed
+            return false;
+        }
+        // Read current content
+        let content = readFileSync(controllerIndexPath, 'utf8');
+        // Check if already patched
+        if (content.includes("from './ReflexionMemory.js'")) {
+            patched = true;
+            return true;
+        }
+        // Apply patches
+        const patches = [
+            { from: "from './ReflexionMemory'", to: "from './ReflexionMemory.js'" },
+            { from: "from './SkillLibrary'", to: "from './SkillLibrary.js'" },
+            { from: "from './EmbeddingService'", to: "from './EmbeddingService.js'" },
+            { from: "from './CausalMemoryGraph'", to: "from './CausalMemoryGraph.js'" },
+            { from: "from './CausalRecall'", to: "from './CausalRecall.js'" },
+            { from: "from './NightlyLearner'", to: "from './NightlyLearner.js'" }
+        ];
+        let modified = false;
+        for (const patch of patches) {
+            if (content.includes(patch.from) && !content.includes(patch.to)) {
+                content = content.replace(new RegExp(patch.from, 'g'), patch.to);
+                modified = true;
+            }
+        }
+        if (modified) {
+            try {
+                writeFileSync(controllerIndexPath, content, 'utf8');
+                patched = true;
+                console.log('[AgentDB Patch] ✅ Successfully patched AgentDB imports');
+                return true;
+            }
+            catch (writeError) {
+                // If we can't write (npx temp dir permissions), that's OK - imports will fail gracefully
+                console.warn('[AgentDB Patch] ⚠️  Could not write patch (read-only):', writeError.message);
+                return false;
+            }
+        }
+        return false;
+    }
+    catch (error) {
+        console.warn('[AgentDB Patch] Error applying patch:', error.message);
+        return false;
+    }
+}
+/**
+ * Find AgentDB installation directory
+ * Checks multiple possible locations
+ */
+function findAgentDBPath() {
+    const possiblePaths = [
+        // Local node_modules (most common)
+        join(process.cwd(), 'node_modules', 'agentdb'),
+        // Parent directory node_modules (monorepo)
+        join(process.cwd(), '..', 'node_modules', 'agentdb'),
+        // Global npm installation
+        join(process.execPath, '..', '..', 'lib', 'node_modules', 'agentdb'),
+        // Relative to this file (for bundled installations)
+        ...(typeof __dirname !== 'undefined'
+            ? [
+                join(__dirname, '..', '..', 'node_modules', 'agentdb'),
+                join(__dirname, '..', '..', '..', 'agentdb')
+            ]
+            : []),
+        // Using import.meta.url (ESM)
+        ...(typeof import.meta !== 'undefined' && import.meta.url
+            ? (() => {
+                try {
+                    const currentDir = dirname(fileURLToPath(import.meta.url));
+                    return [
+                        join(currentDir, '..', '..', 'node_modules', 'agentdb'),
+                        join(currentDir, '..', '..', '..', 'agentdb')
+                    ];
+                }
+                catch {
+                    return [];
+                }
+            })()
+            : [])
+    ];
+    // Try each path
+    for (const path of possiblePaths) {
+        if (existsSync(join(path, 'package.json'))) {
+            try {
+                const pkg = JSON.parse(readFileSync(join(path, 'package.json'), 'utf8'));
+                if (pkg.name === 'agentdb') {
+                    return path;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    // Try require.resolve as fallback
+    try {
+        const resolved = require.resolve('agentdb/package.json');
+        return dirname(resolved);
+    }
+    catch {
+        // Not found via require.resolve
+    }
+    return null;
+}
+/**
+ * Check if AgentDB patch is needed
+ */
+export function isAgentDBPatchNeeded() {
+    const agentdbPath = findAgentDBPath();
+    if (!agentdbPath)
+        return false;
+    const controllerIndexPath = join(agentdbPath, 'dist', 'controllers', 'index.js');
+    if (!existsSync(controllerIndexPath))
+        return false;
+    const content = readFileSync(controllerIndexPath, 'utf8');
+    return !content.includes("from './ReflexionMemory.js'");
+}
+/**
+ * Get patch status information
+ */
+export function getAgentDBPatchStatus() {
+    return {
+        needed: isAgentDBPatchNeeded(),
+        applied: patched,
+        attempted: patchAttempted,
+        location: findAgentDBPath()
+    };
+}
+// Auto-apply patch on module load (SYNCHRONOUS - must happen before any AgentDB imports)
+// This ensures the patch is applied before any imports
+if (typeof process !== 'undefined' && !process.env.SKIP_AGENTDB_PATCH) {
+    // MUST be synchronous - async won't work because imports happen immediately
+    try {
+        applyAgentDBPatch();
+    }
+    catch (error) {
+        // Silently fail - patch will be attempted again on explicit call
+    }
+}
+//# sourceMappingURL=agentdb-runtime-patch.js.map

package/dist/agentic-flow/src/utils/agentdb-runtime-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentdb-runtime-patch.js","sourceRoot":"","sources":["../../../../src/utils/agentdb-runtime-patch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AgentDB Runtime Patch\n *\n * Automatically fixes AgentDB v1.3.9 import resolution issues at runtime.\n * This patch works in all contexts: npm install, npm install -g, and npx.\n *\n * Issue: agentdb v1.3.9 missing .js extensions in ESM exports\n * Solution: Patch the controller index.js file at runtime before first import\n */\n\nimport { readFileSync, writeFileSync, existsSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nlet patched = false;\nlet patchAttempted = false;\n\n/**\n * Apply AgentDB import fix at runtime\n * Safe to call multiple times - only patches once\n */\nexport function applyAgentDBPatch(): boolean {\n  // Only attempt once per process\n  if (patchAttempted) {\n    return patched;\n  }\n  patchAttempted = true;\n\n  try {\n    // Find agentdb installation\n    const agentdbPath = findAgentDBPath();\n    if (!agentdbPath) {\n      return false;\n    }\n\n    // Try both v2 and v3 paths\n    let controllerIndexPath = join(agentdbPath, 'dist', 'controllers', 'index.js');\n\n    // AgentDB v3+ has controllers at dist/src/controllers/\n    if (!existsSync(controllerIndexPath)) {\n      controllerIndexPath = join(agentdbPath, 'dist', 'src', 'controllers', 'index.js');\n    }\n\n    if (!existsSync(controllerIndexPath)) {\n      // No controllers index found — patch not needed\n      return false;\n    }\n\n    // Read current content\n    let content = readFileSync(controllerIndexPath, 'utf8');\n\n    // Check if already patched\n    if (content.includes(\"from './ReflexionMemory.js'\")) {\n      patched = true;\n      return true;\n    }\n\n    // Apply patches\n    const patches = [\n      { from: \"from './ReflexionMemory'\", to: \"from './ReflexionMemory.js'\" },\n      { from: \"from './SkillLibrary'\", to: \"from './SkillLibrary.js'\" },\n      { from: \"from './EmbeddingService'\", to: \"from './EmbeddingService.js'\" },\n      { from: \"from './CausalMemoryGraph'\", to: \"from './CausalMemoryGraph.js'\" },\n      { from: \"from './CausalRecall'\", to: \"from './CausalRecall.js'\" },\n      { from: \"from './NightlyLearner'\", to: \"from './NightlyLearner.js'\" }\n    ];\n\n    let modified = false;\n    for (const patch of patches) {\n      if (content.includes(patch.from) && !content.includes(patch.to)) {\n        content = content.replace(new RegExp(patch.from, 'g'), patch.to);\n        modified = true;\n      }\n    }\n\n    if (modified) {\n      try {\n        writeFileSync(controllerIndexPath, content, 'utf8');\n        patched = true;\n        console.log('[AgentDB Patch] ✅ Successfully patched AgentDB imports');\n        return true;\n      } catch (writeError: any) {\n        // If we can't write (npx temp dir permissions), that's OK - imports will fail gracefully\n        console.warn('[AgentDB Patch] ⚠️  Could not write patch (read-only):', writeError.message);\n        return false;\n      }\n    }\n\n    return false;\n  } catch (error: any) {\n    console.warn('[AgentDB Patch] Error applying patch:', error.message);\n    return false;\n  }\n}\n\n/**\n * Find AgentDB installation directory\n * Checks multiple possible locations\n */\nfunction findAgentDBPath(): string | null {\n  const possiblePaths = [\n    // Local node_modules (most common)\n    join(process.cwd(), 'node_modules', 'agentdb'),\n\n    // Parent directory node_modules (monorepo)\n    join(process.cwd(), '..', 'node_modules', 'agentdb'),\n\n    // Global npm installation\n    join(process.execPath, '..', '..', 'lib', 'node_modules', 'agentdb'),\n\n    // Relative to this file (for bundled installations)\n    ...(typeof __dirname !== 'undefined'\n      ? [\n          join(__dirname, '..', '..', 'node_modules', 'agentdb'),\n          join(__dirname, '..', '..', '..', 'agentdb')\n        ]\n      : []),\n\n    // Using import.meta.url (ESM)\n    ...(typeof import.meta !== 'undefined' && import.meta.url\n      ? (() => {\n          try {\n            const currentDir = dirname(fileURLToPath(import.meta.url));\n            return [\n              join(currentDir, '..', '..', 'node_modules', 'agentdb'),\n              join(currentDir, '..', '..', '..', 'agentdb')\n            ];\n          } catch {\n            return [];\n          }\n        })()\n      : [])\n  ];\n\n  // Try each path\n  for (const path of possiblePaths) {\n    if (existsSync(join(path, 'package.json'))) {\n      try {\n        const pkg = JSON.parse(readFileSync(join(path, 'package.json'), 'utf8'));\n        if (pkg.name === 'agentdb') {\n          return path;\n        }\n      } catch {\n        continue;\n      }\n    }\n  }\n\n  // Try require.resolve as fallback\n  try {\n    const resolved = require.resolve('agentdb/package.json');\n    return dirname(resolved);\n  } catch {\n    // Not found via require.resolve\n  }\n\n  return null;\n}\n\n/**\n * Check if AgentDB patch is needed\n */\nexport function isAgentDBPatchNeeded(): boolean {\n  const agentdbPath = findAgentDBPath();\n  if (!agentdbPath) return false;\n\n  const controllerIndexPath = join(agentdbPath, 'dist', 'controllers', 'index.js');\n  if (!existsSync(controllerIndexPath)) return false;\n\n  const content = readFileSync(controllerIndexPath, 'utf8');\n  return !content.includes(\"from './ReflexionMemory.js'\");\n}\n\n/**\n * Get patch status information\n */\nexport function getAgentDBPatchStatus(): {\n  needed: boolean;\n  applied: boolean;\n  attempted: boolean;\n  location: string | null;\n} {\n  return {\n    needed: isAgentDBPatchNeeded(),\n    applied: patched,\n    attempted: patchAttempted,\n    location: findAgentDBPath()\n  };\n}\n\n// Auto-apply patch on module load (SYNCHRONOUS - must happen before any AgentDB imports)\n// This ensures the patch is applied before any imports\nif (typeof process !== 'undefined' && !process.env.SKIP_AGENTDB_PATCH) {\n  // MUST be synchronous - async won't work because imports happen immediately\n  try {\n    applyAgentDBPatch();\n  } catch (error) {\n    // Silently fail - patch will be attempted again on explicit call\n  }\n}\n"]}

package/dist/agentic-flow/src/utils/auth.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Simple API key authentication for proxy
+ */
+export declare class AuthManager {
+    private validKeys;
+    constructor(apiKeys?: string[]);
+    authenticate(headers: Record<string, string | string[] | undefined>): boolean;
+    private extractApiKey;
+    addKey(key: string): void;
+    removeKey(key: string): void;
+    hasKeys(): boolean;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/agentic-flow/src/utils/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/utils/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAc;gBAEnB,OAAO,CAAC,EAAE,MAAM,EAAE;IAa9B,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,OAAO;IAgB7E,OAAO,CAAC,aAAa;IAmBrB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B,OAAO,IAAI,OAAO;CAGnB"}

package/dist/agentic-flow/src/utils/auth.js

@@ -0,0 +1,53 @@
+/**
+ * Simple API key authentication for proxy
+ */
+export class AuthManager {
+    validKeys;
+    constructor(apiKeys) {
+        // Load from environment or provided keys
+        const envKeys = process.env.PROXY_API_KEYS?.split(',').map(k => k.trim()).filter(Boolean) || [];
+        const allKeys = [...(apiKeys || []), ...envKeys];
+        this.validKeys = new Set(allKeys);
+        if (this.validKeys.size === 0) {
+            console.warn('⚠️  Warning: No API keys configured for authentication');
+            console.warn('   Set PROXY_API_KEYS environment variable or pass keys to constructor');
+        }
+    }
+    authenticate(headers) {
+        // If no keys configured, allow all (development mode)
+        if (this.validKeys.size === 0) {
+            return true;
+        }
+        // Check x-api-key header
+        const apiKey = this.extractApiKey(headers);
+        if (!apiKey) {
+            return false;
+        }
+        return this.validKeys.has(apiKey);
+    }
+    extractApiKey(headers) {
+        // Try x-api-key header
+        let key = headers['x-api-key'];
+        // Try authorization header (Bearer token)
+        if (!key) {
+            const auth = headers['authorization'];
+            if (typeof auth === 'string' && auth.startsWith('Bearer ')) {
+                key = auth.substring(7);
+            }
+        }
+        if (Array.isArray(key)) {
+            key = key[0];
+        }
+        return (typeof key === 'string' && key.length > 0) ? key : null;
+    }
+    addKey(key) {
+        this.validKeys.add(key);
+    }
+    removeKey(key) {
+        this.validKeys.delete(key);
+    }
+    hasKeys() {
+        return this.validKeys.size > 0;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/agentic-flow/src/utils/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../src/utils/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,WAAW;IACd,SAAS,CAAc;IAE/B,YAAY,OAAkB;QAC5B,yCAAyC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChG,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC;QAEjD,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,YAAY,CAAC,OAAsD;QACjE,sDAAsD;QACtD,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,yBAAyB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAEO,aAAa,CAAC,OAAsD;QAC1E,uBAAuB;QACvB,IAAI,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAE/B,0CAA0C;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;YACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3D,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QAED,OAAO,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC;IACjC,CAAC;CACF","sourcesContent":["/**\n * Simple API key authentication for proxy\n */\n\nexport class AuthManager {\n  private validKeys: Set<string>;\n\n  constructor(apiKeys?: string[]) {\n    // Load from environment or provided keys\n    const envKeys = process.env.PROXY_API_KEYS?.split(',').map(k => k.trim()).filter(Boolean) || [];\n    const allKeys = [...(apiKeys || []), ...envKeys];\n\n    this.validKeys = new Set(allKeys);\n\n    if (this.validKeys.size === 0) {\n      console.warn('⚠️  Warning: No API keys configured for authentication');\n      console.warn('   Set PROXY_API_KEYS environment variable or pass keys to constructor');\n    }\n  }\n\n  authenticate(headers: Record<string, string | string[] | undefined>): boolean {\n    // If no keys configured, allow all (development mode)\n    if (this.validKeys.size === 0) {\n      return true;\n    }\n\n    // Check x-api-key header\n    const apiKey = this.extractApiKey(headers);\n\n    if (!apiKey) {\n      return false;\n    }\n\n    return this.validKeys.has(apiKey);\n  }\n\n  private extractApiKey(headers: Record<string, string | string[] | undefined>): string | null {\n    // Try x-api-key header\n    let key = headers['x-api-key'];\n\n    // Try authorization header (Bearer token)\n    if (!key) {\n      const auth = headers['authorization'];\n      if (typeof auth === 'string' && auth.startsWith('Bearer ')) {\n        key = auth.substring(7);\n      }\n    }\n\n    if (Array.isArray(key)) {\n      key = key[0];\n    }\n\n    return (typeof key === 'string' && key.length > 0) ? key : null;\n  }\n\n  addKey(key: string): void {\n    this.validKeys.add(key);\n  }\n\n  removeKey(key: string): void {\n    this.validKeys.delete(key);\n  }\n\n  hasKeys(): boolean {\n    return this.validKeys.size > 0;\n  }\n}\n"]}

package/dist/agentic-flow/src/utils/cli.d.ts

@@ -0,0 +1,31 @@
+export interface CliOptions {
+    mode: 'agent' | 'parallel' | 'list' | 'mcp' | 'mcp-manager' | 'config' | 'agent-manager' | 'proxy' | 'quic' | 'claude-code' | 'reasoningbank' | 'federation' | 'daemon' | 'hive-mind' | 'hivemind' | 'hooks' | 'session' | 'swarm' | 'memory' | 'task' | 'doctor' | 'autopilot';
+    agent?: string;
+    task?: string;
+    model?: string;
+    provider?: string;
+    anthropicApiKey?: string;
+    openrouterApiKey?: string;
+    stream?: boolean;
+    temperature?: number;
+    maxTokens?: number;
+    agentsDir?: string;
+    outputFormat?: 'text' | 'json' | 'markdown';
+    verbose?: boolean;
+    timeout?: number;
+    retryOnError?: boolean;
+    optimize?: boolean;
+    optimizePriority?: 'quality' | 'balanced' | 'cost' | 'speed' | 'privacy';
+    maxCost?: number;
+    claudeCode?: boolean;
+    agentBooster?: boolean;
+    boosterThreshold?: number;
+    help?: boolean;
+    version?: boolean;
+    mcpCommand?: string;
+    mcpServer?: string;
+}
+export declare function parseArgs(): CliOptions;
+export declare function printHelp(): void;
+export declare function validateOptions(options: CliOptions): string | null;
+//# sourceMappingURL=cli.d.ts.map

package/dist/agentic-flow/src/utils/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../../src/utils/cli.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC;IAChR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,SAAS,IAAI,UAAU,CA4LtC;AAED,wBAAgB,SAAS,IAAI,IAAI,CAiLhC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAWlE"}

package/dist/agentic-flow/src/utils/cli.js

@@ -0,0 +1,344 @@
+// CLI argument parsing and help utilities
+export function parseArgs() {
+    const args = process.argv.slice(2);
+    const options = {
+        mode: 'parallel'
+    };
+    // Check for proxy command first
+    if (args[0] === 'proxy') {
+        options.mode = 'proxy';
+        return options;
+    }
+    // Check for claude-code command
+    if (args[0] === 'claude-code') {
+        options.mode = 'claude-code';
+        return options;
+    }
+    // Check for quic command
+    if (args[0] === 'quic') {
+        options.mode = 'quic';
+        return options;
+    }
+    // Check for MCP command
+    if (args[0] === 'mcp') {
+        const mcpSubcommand = args[1];
+        // MCP Manager commands (CLI configuration)
+        const managerCommands = ['add', 'list', 'remove', 'enable', 'disable', 'update', 'test', 'info', 'export', 'import'];
+        if (managerCommands.includes(mcpSubcommand)) {
+            options.mode = 'mcp-manager';
+            return options;
+        }
+        // MCP Server commands (start/stop server)
+        options.mode = 'mcp';
+        options.mcpCommand = mcpSubcommand || 'start'; // default to start
+        options.mcpServer = args[2] || 'all'; // default to all servers
+        return options;
+    }
+    // Check for config command
+    if (args[0] === 'config') {
+        options.mode = 'config';
+        return options;
+    }
+    // Check for agent management command
+    if (args[0] === 'agent') {
+        options.mode = 'agent-manager';
+        return options;
+    }
+    // Check for federation command
+    if (args[0] === 'federation') {
+        options.mode = 'federation';
+        return options;
+    }
+    // Check for reasoningbank command
+    if (args[0] === 'reasoningbank') {
+        options.mode = 'reasoningbank';
+        return options;
+    }
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--help':
+            case '-h':
+                options.help = true;
+                break;
+            case '--version':
+            case '-v':
+                options.version = true;
+                break;
+            case '--agent':
+            case '-a':
+                options.mode = 'agent';
+                options.agent = args[++i];
+                break;
+            case '--task':
+            case '-t':
+                options.task = args[++i];
+                break;
+            case '--model':
+            case '-m':
+                options.model = args[++i];
+                break;
+            case '--provider':
+            case '-p':
+                options.provider = args[++i];
+                break;
+            case '--stream':
+            case '-s':
+                options.stream = true;
+                break;
+            case '--list':
+            case '-l':
+                options.mode = 'list';
+                break;
+            // API Configuration
+            case '--anthropic-key':
+                options.anthropicApiKey = args[++i];
+                break;
+            case '--openrouter-key':
+                options.openrouterApiKey = args[++i];
+                break;
+            // Agent Behavior
+            case '--temperature':
+                options.temperature = parseFloat(args[++i]);
+                break;
+            case '--max-tokens':
+                options.maxTokens = parseInt(args[++i], 10);
+                break;
+            // Directory Configuration
+            case '--agents-dir':
+                options.agentsDir = args[++i];
+                break;
+            // Output Options
+            case '--output':
+                options.outputFormat = args[++i];
+                break;
+            case '--verbose':
+                options.verbose = true;
+                break;
+            // Execution Control
+            case '--timeout':
+                options.timeout = parseInt(args[++i], 10);
+                break;
+            case '--retry':
+                options.retryOnError = true;
+                break;
+            // Model Optimization
+            case '--optimize':
+            case '-O':
+                options.optimize = true;
+                break;
+            case '--priority':
+                options.optimizePriority = args[++i];
+                break;
+            case '--max-cost':
+                options.maxCost = parseFloat(args[++i]);
+                break;
+            // Agent Booster
+            case '--agent-booster':
+            case '--booster':
+                options.agentBooster = true;
+                break;
+            case '--booster-threshold':
+                options.boosterThreshold = parseFloat(args[++i]);
+                break;
+        }
+    }
+    // Check environment variable for Agent Booster
+    if (process.env.AGENTIC_FLOW_AGENT_BOOSTER === 'true') {
+        options.agentBooster = true;
+    }
+    if (process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD) {
+        options.boosterThreshold = parseFloat(process.env.AGENTIC_FLOW_BOOSTER_THRESHOLD);
+    }
+    return options;
+}
+export function printHelp() {
+    console.log(`
+🤖 Agentic Flow - AI Agent Orchestration CLI
+
+USAGE:
+  npx agentic-flow [COMMAND] [OPTIONS]
+
+COMMANDS:
+  reasoningbank <cmd>     Memory system that learns from experience (demo, test, init)
+  claude-code [options]   Spawn Claude Code with proxy + Agent Booster (57x faster edits)
+  mcp <command> [server]  Manage MCP servers (start, stop, status, list)
+  config [command]        Configuration wizard (set, get, list, delete, reset)
+  agent <command>         Agent management (list, create, info, conflicts)
+  --list, -l              List all available agents
+  --agent, -a <name>      Run specific agent mode
+  (default)               Run parallel mode (3 agents)
+
+REASONINGBANK COMMANDS:
+  npx agentic-flow reasoningbank demo         Run interactive demo comparison
+  npx agentic-flow reasoningbank test         Run validation tests
+  npx agentic-flow reasoningbank init         Initialize database
+  npx agentic-flow reasoningbank benchmark    Run performance benchmarks
+  npx agentic-flow reasoningbank status       Show memory statistics
+
+MCP COMMANDS:
+  npx agentic-flow mcp start [server]    Start MCP server(s)
+  npx agentic-flow mcp stop [server]     Stop MCP server(s)
+  npx agentic-flow mcp status [server]   Check MCP server status
+  npx agentic-flow mcp list              List all available MCP tools
+
+  Available servers: claude-flow, flow-nexus, agentic-payments, all (default)
+
+OPTIONS:
+  --task, -t <task>           Task description for agent mode
+  --model, -m <model>         Model to use (supports OpenRouter models)
+  --provider, -p <name>       Provider (anthropic, openrouter, onnx)
+  --stream, -s                Enable real-time streaming output
+
+  API CONFIGURATION:
+  --anthropic-key <key>       Override ANTHROPIC_API_KEY
+  --openrouter-key <key>      Override OPENROUTER_API_KEY
+
+  AGENT BEHAVIOR:
+  --temperature <0.0-1.0>     Sampling temperature (creativity)
+  --max-tokens <number>       Maximum response tokens
+
+  DIRECTORY:
+  --agents-dir <path>         Custom agents directory
+
+  OUTPUT:
+  --output <text|json|md>     Output format
+  --verbose                   Enable verbose logging
+
+  EXECUTION:
+  --timeout <ms>              Execution timeout
+  --retry                     Auto-retry on errors
+
+  MODEL OPTIMIZATION:
+  --optimize, -O              Auto-select best model for agent/task
+  --priority <type>           Optimization priority (quality|balanced|cost|speed|privacy)
+  --max-cost <dollars>        Maximum cost per task in dollars
+
+  AGENT BOOSTER (200x faster code edits!):
+  --agent-booster             Enable Agent Booster pre-processing
+  --booster-threshold <0-1>   Confidence threshold (default: 0.7)
+
+  --help, -h                  Show this help message
+
+EXAMPLES:
+  # ReasoningBank (Learn from agent experience!)
+  npx agentic-flow reasoningbank demo       # See 0% → 100% success transformation
+  npx agentic-flow reasoningbank test       # Run 27 validation tests
+  npx agentic-flow reasoningbank init       # Setup memory database
+  export ANTHROPIC_API_KEY=sk-ant-...      # Enable LLM-based learning
+
+  # Agent Booster Integration (200x faster code edits!)
+  npx agentic-flow --agent coder --task "Convert var to const in utils.js" --agent-booster
+  npx agentic-flow --agent coder --task "Add types to api.ts" --agent-booster --provider openrouter
+  export AGENTIC_FLOW_AGENT_BOOSTER=true  # Enable for all tasks
+
+  # Claude Code with Agent Booster
+  npx agentic-flow claude-code --provider openrouter --agent-booster
+  npx agentic-flow claude-code --provider gemini "Write a REST API"
+  npx agentic-flow claude-code --help     # See all claude-code options
+
+  # Agent Management
+  npx agentic-flow agent list             # List all agents with sources
+  npx agentic-flow agent create           # Interactive agent creator
+  npx agentic-flow agent info coder       # Get agent details
+  npx agentic-flow agent conflicts        # Check for conflicts
+
+  # Configuration
+  npx agentic-flow config                 # Interactive config wizard
+  npx agentic-flow config set PROVIDER openrouter
+  npx agentic-flow config list            # View all settings
+
+  # MCP Server Management
+  npx agentic-flow mcp start              # Start all MCP servers
+  npx agentic-flow mcp list               # List all 209+ MCP tools
+
+  # Agent Execution (Basic)
+  npx agentic-flow --list                 # List all agents
+  npx agentic-flow --agent coder --task "Build REST API"
+
+  # Agent Execution (Advanced)
+  npx agentic-flow --agent coder --task "Build API" \\
+    --provider openrouter \\
+    --model "meta-llama/llama-3.1-8b-instruct" \\
+    --temperature 0.7 \\
+    --max-tokens 2000 \\
+    --output json \\
+    --verbose
+
+  # Agent Execution (Custom)
+  npx agentic-flow --agent my-custom-agent --task "Your task" \\
+    --agents-dir ./my-agents
+
+  # Parallel Mode
+  npx agentic-flow  # Run 3 agents in parallel
+
+  # Model Optimization (Auto-select best model)
+  npx agentic-flow --agent coder --task "Build API" --optimize
+  npx agentic-flow --agent coder --task "Build API" --optimize --priority cost
+  npx agentic-flow --agent researcher --task "Analyze data" --optimize --priority quality
+  npx agentic-flow --agent coder --task "Simple function" --optimize --max-cost 0.001
+
+ENVIRONMENT VARIABLES:
+  ANTHROPIC_API_KEY       Anthropic API key (for Claude models)
+  OPENROUTER_API_KEY      OpenRouter API key (for alternative models)
+  USE_ONNX                Set to 'true' to force ONNX local inference
+  AGENT                   Agent name for agent mode
+  TASK                    Task description for agent mode
+  MODEL                   Model override for agent mode
+  PROVIDER                Provider to use (anthropic, openrouter, onnx)
+  TOPIC                   Research topic for parallel mode
+  DIFF                    Code diff for parallel mode
+  DATASET                 Dataset hint for parallel mode
+  ENABLE_STREAMING        Enable streaming (true/false)
+  HEALTH_PORT             Health check port (default: 8080)
+
+MCP TOOLS (209+ available):
+  • agentic-flow: 6 tools (agent execution, creation, management)
+  • claude-flow: 101 tools (neural networks, GitHub, workflows, DAA)
+  • flow-nexus: 96 cloud tools (sandboxes, distributed swarms, templates)
+  • agentic-payments: 6 tools (payment authorization, multi-agent consensus)
+
+PARALLEL EXECUTION & SWARM OPTIMIZATION (v2.0):
+  • Automatic Topology Selection: AI recommends optimal swarm configuration
+  • Self-Learning System: Learns from 100+ execution patterns (0.6 → 0.95 confidence)
+  • Pattern Recognition: ReasoningBank stores & retrieves successful strategies
+  • Performance Tracking: 3.5-5.0x speedup with hierarchical topology
+  • Reward System: Multi-factor scoring (speedup, success rate, efficiency)
+  • Adaptive Optimization: Improves recommendations over time
+
+  Supported Topologies:
+    - Mesh (1-10 agents): Full peer-to-peer coordination (2.5x speedup)
+    - Hierarchical (6-50 agents): Coordinator delegation (3.5-4.0x speedup) ⭐ BEST
+    - Ring (1-20 agents): Sequential token passing + parallel processing
+    - Star (1-30 agents): Central coordinator pattern
+
+  Usage Example (CLI subprocess spawning):
+    const results = await Promise.all([
+      exec('npx agentic-flow --agent researcher --task "domain1"'),
+      exec('npx agentic-flow --agent researcher --task "domain2"'),
+      exec('npx agentic-flow --agent coder --task "implement"')
+    ]);
+
+  Auto-Optimization Example:
+    import { autoSelectSwarmConfig } from './hooks/swarm-learning-optimizer';
+    const config = await autoSelectSwarmConfig(reasoningBank, taskDesc, options);
+    // Returns: recommendedTopology, expectedSpeedup, confidence, reasoning
+
+  See: /agentic-flow/src/prompts/parallel-execution-guide.md (v2.0)
+       /docs/swarm-optimization-report.md
+
+For more information, visit: https://github.com/ruvnet/agentic-flow
+  `);
+}
+export function validateOptions(options) {
+    if (options.mode === 'agent') {
+        if (!options.agent && !process.env.AGENT) {
+            return 'Agent mode requires --agent <name> or AGENT env variable';
+        }
+        if (!options.task && !process.env.TASK) {
+            return 'Agent mode requires --task <description> or TASK env variable';
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=cli.js.map