agentic-flow 1.10.1 → 2.0.0-alpha

package/agentic-flow/dist/proxy/provider-instructions.js

@@ -0,0 +1,347 @@
+// Provider-specific and model-specific tool instructions
+// Optimized for different LLM families to improve tool calling success rate
+// Base structured command format (works for most models)
+export const BASE_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+Example: Create a file
+<file_write path="hello.js">
+function hello() {
+  console.log("Hello!");
+}
+</file_write>
+`,
+    emphasis: 'IMPORTANT: Use these structured commands in your response. The system will automatically execute them.'
+};
+// Anthropic models - Native tool calling, minimal instructions needed
+export const ANTHROPIC_INSTRUCTIONS = {
+    format: 'native',
+    commands: {
+        write: 'Use Write tool with file_path and content parameters',
+        read: 'Use Read tool with file_path parameter',
+        bash: 'Use Bash tool with command parameter'
+    },
+    emphasis: 'You have native access to file system tools. Use them directly.'
+};
+// OpenAI/GPT models - Prefer function calling style
+export const OPENAI_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+When you need to create a file, respond with:
+<file_write path="example.txt">
+File content here
+</file_write>
+
+The system will create the file for you.
+`,
+    emphasis: 'CRITICAL: You must use these exact XML tag formats. Do not just describe the file - actually use the tags.'
+};
+// Google/Gemini models - Detailed, explicit instructions
+export const GOOGLE_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+Step-by-step file creation:
+1. Determine the filename
+2. Write the content
+3. Use this exact format:
+
+<file_write path="your_file.txt">
+Your content here
+</file_write>
+
+The file will be automatically created.
+`,
+    emphasis: 'IMPORTANT: Always use the XML tags. Just writing code blocks will NOT create files. You MUST use <file_write> tags.'
+};
+// Meta/Llama models - Clear, concise instructions
+export const META_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+To create files, use:
+<file_write path="file.txt">content</file_write>
+
+To read files, use:
+<file_read path="file.txt"/>
+
+To run commands, use:
+<bash_command>ls -la</bash_command>
+`,
+    emphasis: 'Use these tags to perform actual file operations. Code blocks alone will not create files.'
+};
+// DeepSeek models - Technical, precise instructions
+export const DEEPSEEK_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+File system operations use XML-like structured commands:
+
+<file_write path="example.py">
+def main():
+    print("Hello")
+</file_write>
+
+These commands are parsed and executed by the system.
+`,
+    emphasis: 'Use structured commands for file I/O. Standard code blocks are for display only.'
+};
+// Mistral models - Direct, action-oriented
+export const MISTRAL_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+ACTION REQUIRED: To create actual files, you must use these tags:
+
+<file_write path="file.txt">
+content
+</file_write>
+
+Do not just show code - use the tags to create real files.
+`,
+    emphasis: 'CRITICAL: File operations require XML tags. Code blocks alone will not create files on disk.'
+};
+// X.AI/Grok models - Balanced, clear instructions
+export const XAI_INSTRUCTIONS = {
+    format: 'xml',
+    commands: {
+        write: '<file_write path="filename.ext">\ncontent here\n</file_write>',
+        read: '<file_read path="filename.ext"/>',
+        bash: '<bash_command>\ncommand here\n</bash_command>'
+    },
+    examples: `
+File system commands:
+- Create: <file_write path="file.txt">content</file_write>
+- Read: <file_read path="file.txt"/>
+- Execute: <bash_command>command</bash_command>
+`,
+    emphasis: 'Use structured commands to interact with the file system.'
+};
+// Map provider/model patterns to instruction sets
+export function getInstructionsForModel(modelId, provider) {
+    const normalizedModel = modelId.toLowerCase();
+    // Anthropic models - native tool calling
+    if (normalizedModel.includes('claude') || provider === 'anthropic') {
+        return ANTHROPIC_INSTRUCTIONS;
+    }
+    // OpenAI models
+    if (normalizedModel.includes('gpt') || normalizedModel.includes('openai') || provider === 'openai') {
+        return OPENAI_INSTRUCTIONS;
+    }
+    // Google/Gemini models
+    if (normalizedModel.includes('gemini') || normalizedModel.includes('gemma') || provider === 'google') {
+        return GOOGLE_INSTRUCTIONS;
+    }
+    // Meta/Llama models
+    if (normalizedModel.includes('llama') || provider === 'meta-llama' || provider === 'meta') {
+        return META_INSTRUCTIONS;
+    }
+    // DeepSeek models
+    if (normalizedModel.includes('deepseek') || provider === 'deepseek') {
+        return DEEPSEEK_INSTRUCTIONS;
+    }
+    // Mistral models
+    if (normalizedModel.includes('mistral') || provider === 'mistralai') {
+        return MISTRAL_INSTRUCTIONS;
+    }
+    // X.AI/Grok models
+    if (normalizedModel.includes('grok') || provider === 'x-ai') {
+        return XAI_INSTRUCTIONS;
+    }
+    // Qwen models
+    if (normalizedModel.includes('qwen')) {
+        return DEEPSEEK_INSTRUCTIONS; // Similar to DeepSeek
+    }
+    // Default to base instructions
+    return BASE_INSTRUCTIONS;
+}
+// Check if task requires file/tool operations based on prompt content
+export function taskRequiresFileOps(systemPrompt, userMessages) {
+    const combined = systemPrompt + ' ' + JSON.stringify(userMessages);
+    // Regex patterns that suggest file operations are needed
+    const filePatterns = [
+        /create\s+.*?file/i, // "create a file", "create file", "create the file"
+        /write\s+.*?file/i, // "write a file", "write to file"
+        /save\s+.*?file/i, // "save to file", "save as file"
+        /save\s+.*?to/i, // "save to disk", "save code to"
+        /write\s+to\s+disk/i, // "write to disk"
+        /create\s+.*?script/i, // "create a script", "create script"
+        /make\s+.*?file/i, // "make a file"
+        /generate\s+.*?file/i, // "generate a file"
+        /put\s+.*?in\s+.*?file/i, // "put code in a file"
+        /store\s+.*?in\s+.*?file/i, // "store in a file"
+        /run\s+bash/i, // "run bash command"
+        /execute\s+command/i, // "execute command"
+        /run\s+command/i, // "run command"
+        /shell\s+command/i, // "shell command"
+        /use\s+bash/i // "use bash"
+    ];
+    return filePatterns.some(pattern => pattern.test(combined));
+}
+// Generate formatted instruction string for injection
+// Only include XML instructions if task actually requires file operations
+export function formatInstructions(instructions, includeXmlInstructions = true) {
+    if (instructions.format === 'native') {
+        return `${instructions.emphasis}\n\n${instructions.commands.write}\n${instructions.commands.read}\n${instructions.commands.bash}`;
+    }
+    // For simple code generation without file ops, skip XML instructions
+    if (!includeXmlInstructions) {
+        return 'Provide clean, well-formatted code in your response. Use markdown code blocks for code.';
+    }
+    let formatted = `${instructions.emphasis}\n\n`;
+    formatted += `Available commands:\n`;
+    formatted += `${instructions.commands.write}\n`;
+    formatted += `${instructions.commands.read}\n`;
+    formatted += `${instructions.commands.bash}\n`;
+    if (instructions.examples) {
+        formatted += `\n${instructions.examples}`;
+    }
+    return formatted;
+}
+// Parallel execution instructions for concurrent agent coordination
+export const PARALLEL_EXECUTION_INSTRUCTIONS = `
+═══════════════════════════════════════════════════════════════
+CRITICAL: Concurrent Execution System
+═══════════════════════════════════════════════════════════════
+
+This system supports parallel agent execution via CLI subprocesses and
+ReasoningBank coordination. Follow these patterns for optimal performance:
+
+1. SUBPROCESS SPAWNING
+   When decomposing tasks, spawn subagents via CLI:
+
+   \`\`\`typescript
+   const results = await Promise.all([
+     exec('npx agentic-flow --agent researcher --task "analyze security"'),
+     exec('npx agentic-flow --agent coder --task "implement features"'),
+     exec('npx agentic-flow --agent tester --task "create tests"')
+   ]);
+   \`\`\`
+
+2. REASONINGBANK COORDINATION
+   Each subagent stores results in ReasoningBank:
+
+   \`\`\`typescript
+   // Subagent stores results
+   await reasoningBank.storePattern({
+     sessionId: 'swarm/task-123/agent-1',
+     task: 'Research security patterns',
+     output: findings,
+     reward: 0.95,
+     success: true
+   });
+
+   // Parent retrieves all results
+   const allResults = await reasoningBank.searchPatterns('swarm/task-123');
+   \`\`\`
+
+3. PERFORMANCE BENEFITS
+   - 2.8-4.4x speedup with parallel execution
+   - 50-70% time reduction with QUIC transport
+   - 32.3% token reduction via batching
+
+See /agentic-flow/src/prompts/parallel-execution-guide.md for detailed examples.
+═══════════════════════════════════════════════════════════════
+`;
+// Get appropriate max_tokens for model
+export function getMaxTokensForModel(modelId, requestedMaxTokens) {
+    const normalizedModel = modelId.toLowerCase();
+    // If user requested specific max_tokens, use it
+    if (requestedMaxTokens) {
+        return requestedMaxTokens;
+    }
+    // DeepSeek needs higher max_tokens
+    if (normalizedModel.includes('deepseek')) {
+        return 8000;
+    }
+    // Llama 3.1/3.3 - moderate
+    if (normalizedModel.includes('llama')) {
+        return 4096;
+    }
+    // GPT models - standard
+    if (normalizedModel.includes('gpt')) {
+        return 4096;
+    }
+    // Default
+    return 4096;
+}
+// Get parallel execution capabilities for model
+export function getParallelCapabilities(modelId) {
+    const normalized = modelId.toLowerCase();
+    // High-capability models (Claude, GPT-4)
+    if (normalized.includes('claude') || normalized.includes('gpt-4')) {
+        return {
+            maxConcurrency: 10,
+            recommendedBatchSize: 5,
+            supportsSubprocesses: true,
+            supportsReasoningBank: true
+        };
+    }
+    // Mid-tier models (DeepSeek, Llama 3.1)
+    if (normalized.includes('deepseek') || normalized.includes('llama-3.1')) {
+        return {
+            maxConcurrency: 5,
+            recommendedBatchSize: 3,
+            supportsSubprocesses: true,
+            supportsReasoningBank: true
+        };
+    }
+    // Lower-tier models
+    return {
+        maxConcurrency: 3,
+        recommendedBatchSize: 2,
+        supportsSubprocesses: true,
+        supportsReasoningBank: false
+    };
+}
+// Enhanced instruction builder
+export function buildInstructions(modelId, provider, options = {}) {
+    const { enableParallel = false, batchSize, enableReasoningBank = false, includeXmlInstructions = true } = options;
+    const baseInstructions = getInstructionsForModel(modelId, provider);
+    let formatted = formatInstructions(baseInstructions, includeXmlInstructions);
+    // Add parallel execution instructions if enabled
+    if (enableParallel) {
+        const capabilities = getParallelCapabilities(modelId);
+        const effectiveBatchSize = batchSize || capabilities.recommendedBatchSize;
+        formatted += '\n\n' + PARALLEL_EXECUTION_INSTRUCTIONS;
+        formatted += `\n\nRECOMMENDED BATCH SIZE: ${effectiveBatchSize} concurrent subagents`;
+        formatted += `\nMAX CONCURRENCY: ${capabilities.maxConcurrency} agents`;
+    }
+    // Add ReasoningBank instructions if enabled
+    if (enableReasoningBank) {
+        formatted += `\n\n
+REASONINGBANK MEMORY COORDINATION:
+- Store: await reasoningBank.storePattern({ sessionId: 'swarm/TASK_ID/AGENT_ID', task, output, reward, success })
+- Retrieve: await reasoningBank.retrieve('swarm/TASK_ID/AGENT_ID')
+- Search: await reasoningBank.searchPatterns('swarm/TASK_ID', { k: 10 })
+    `;
+    }
+    return formatted;
+}
+//# sourceMappingURL=provider-instructions.js.map

package/agentic-flow/dist/proxy/provider-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-instructions.js","sourceRoot":"","sources":["../../src/proxy/provider-instructions.ts"],"names":[],"mappings":"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","sourcesContent":["// Provider-specific and model-specific tool instructions\n// Optimized for different LLM families to improve tool calling success rate\n\nexport interface ToolInstructions {\n  format: string; // The instruction format style\n  commands: {\n    write: string;\n    read: string;\n    bash: string;\n  };\n  examples?: string; // Optional example usage\n  emphasis?: string; // Additional emphasis/notes\n}\n\n// Base structured command format (works for most models)\nexport const BASE_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nExample: Create a file\n<file_write path=\"hello.js\">\nfunction hello() {\n  console.log(\"Hello!\");\n}\n</file_write>\n`,\n  emphasis: 'IMPORTANT: Use these structured commands in your response. The system will automatically execute them.'\n};\n\n// Anthropic models - Native tool calling, minimal instructions needed\nexport const ANTHROPIC_INSTRUCTIONS: ToolInstructions = {\n  format: 'native',\n  commands: {\n    write: 'Use Write tool with file_path and content parameters',\n    read: 'Use Read tool with file_path parameter',\n    bash: 'Use Bash tool with command parameter'\n  },\n  emphasis: 'You have native access to file system tools. Use them directly.'\n};\n\n// OpenAI/GPT models - Prefer function calling style\nexport const OPENAI_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nWhen you need to create a file, respond with:\n<file_write path=\"example.txt\">\nFile content here\n</file_write>\n\nThe system will create the file for you.\n`,\n  emphasis: 'CRITICAL: You must use these exact XML tag formats. Do not just describe the file - actually use the tags.'\n};\n\n// Google/Gemini models - Detailed, explicit instructions\nexport const GOOGLE_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nStep-by-step file creation:\n1. Determine the filename\n2. Write the content\n3. Use this exact format:\n\n<file_write path=\"your_file.txt\">\nYour content here\n</file_write>\n\nThe file will be automatically created.\n`,\n  emphasis: 'IMPORTANT: Always use the XML tags. Just writing code blocks will NOT create files. You MUST use <file_write> tags.'\n};\n\n// Meta/Llama models - Clear, concise instructions\nexport const META_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nTo create files, use:\n<file_write path=\"file.txt\">content</file_write>\n\nTo read files, use:\n<file_read path=\"file.txt\"/>\n\nTo run commands, use:\n<bash_command>ls -la</bash_command>\n`,\n  emphasis: 'Use these tags to perform actual file operations. Code blocks alone will not create files.'\n};\n\n// DeepSeek models - Technical, precise instructions\nexport const DEEPSEEK_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nFile system operations use XML-like structured commands:\n\n<file_write path=\"example.py\">\ndef main():\n    print(\"Hello\")\n</file_write>\n\nThese commands are parsed and executed by the system.\n`,\n  emphasis: 'Use structured commands for file I/O. Standard code blocks are for display only.'\n};\n\n// Mistral models - Direct, action-oriented\nexport const MISTRAL_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nACTION REQUIRED: To create actual files, you must use these tags:\n\n<file_write path=\"file.txt\">\ncontent\n</file_write>\n\nDo not just show code - use the tags to create real files.\n`,\n  emphasis: 'CRITICAL: File operations require XML tags. Code blocks alone will not create files on disk.'\n};\n\n// X.AI/Grok models - Balanced, clear instructions\nexport const XAI_INSTRUCTIONS: ToolInstructions = {\n  format: 'xml',\n  commands: {\n    write: '<file_write path=\"filename.ext\">\\ncontent here\\n</file_write>',\n    read: '<file_read path=\"filename.ext\"/>',\n    bash: '<bash_command>\\ncommand here\\n</bash_command>'\n  },\n  examples: `\nFile system commands:\n- Create: <file_write path=\"file.txt\">content</file_write>\n- Read: <file_read path=\"file.txt\"/>\n- Execute: <bash_command>command</bash_command>\n`,\n  emphasis: 'Use structured commands to interact with the file system.'\n};\n\n// Map provider/model patterns to instruction sets\nexport function getInstructionsForModel(modelId: string, provider?: string): ToolInstructions {\n  const normalizedModel = modelId.toLowerCase();\n\n  // Anthropic models - native tool calling\n  if (normalizedModel.includes('claude') || provider === 'anthropic') {\n    return ANTHROPIC_INSTRUCTIONS;\n  }\n\n  // OpenAI models\n  if (normalizedModel.includes('gpt') || normalizedModel.includes('openai') || provider === 'openai') {\n    return OPENAI_INSTRUCTIONS;\n  }\n\n  // Google/Gemini models\n  if (normalizedModel.includes('gemini') || normalizedModel.includes('gemma') || provider === 'google') {\n    return GOOGLE_INSTRUCTIONS;\n  }\n\n  // Meta/Llama models\n  if (normalizedModel.includes('llama') || provider === 'meta-llama' || provider === 'meta') {\n    return META_INSTRUCTIONS;\n  }\n\n  // DeepSeek models\n  if (normalizedModel.includes('deepseek') || provider === 'deepseek') {\n    return DEEPSEEK_INSTRUCTIONS;\n  }\n\n  // Mistral models\n  if (normalizedModel.includes('mistral') || provider === 'mistralai') {\n    return MISTRAL_INSTRUCTIONS;\n  }\n\n  // X.AI/Grok models\n  if (normalizedModel.includes('grok') || provider === 'x-ai') {\n    return XAI_INSTRUCTIONS;\n  }\n\n  // Qwen models\n  if (normalizedModel.includes('qwen')) {\n    return DEEPSEEK_INSTRUCTIONS; // Similar to DeepSeek\n  }\n\n  // Default to base instructions\n  return BASE_INSTRUCTIONS;\n}\n\n// Check if task requires file/tool operations based on prompt content\nexport function taskRequiresFileOps(systemPrompt: string, userMessages: any[]): boolean {\n  const combined = systemPrompt + ' ' + JSON.stringify(userMessages);\n\n  // Regex patterns that suggest file operations are needed\n  const filePatterns = [\n    /create\\s+.*?file/i,           // \"create a file\", \"create file\", \"create the file\"\n    /write\\s+.*?file/i,            // \"write a file\", \"write to file\"\n    /save\\s+.*?file/i,             // \"save to file\", \"save as file\"\n    /save\\s+.*?to/i,               // \"save to disk\", \"save code to\"\n    /write\\s+to\\s+disk/i,          // \"write to disk\"\n    /create\\s+.*?script/i,         // \"create a script\", \"create script\"\n    /make\\s+.*?file/i,             // \"make a file\"\n    /generate\\s+.*?file/i,         // \"generate a file\"\n    /put\\s+.*?in\\s+.*?file/i,      // \"put code in a file\"\n    /store\\s+.*?in\\s+.*?file/i,    // \"store in a file\"\n    /run\\s+bash/i,                 // \"run bash command\"\n    /execute\\s+command/i,          // \"execute command\"\n    /run\\s+command/i,              // \"run command\"\n    /shell\\s+command/i,            // \"shell command\"\n    /use\\s+bash/i                  // \"use bash\"\n  ];\n\n  return filePatterns.some(pattern => pattern.test(combined));\n}\n\n// Generate formatted instruction string for injection\n// Only include XML instructions if task actually requires file operations\nexport function formatInstructions(\n  instructions: ToolInstructions,\n  includeXmlInstructions: boolean = true\n): string {\n  if (instructions.format === 'native') {\n    return `${instructions.emphasis}\\n\\n${instructions.commands.write}\\n${instructions.commands.read}\\n${instructions.commands.bash}`;\n  }\n\n  // For simple code generation without file ops, skip XML instructions\n  if (!includeXmlInstructions) {\n    return 'Provide clean, well-formatted code in your response. Use markdown code blocks for code.';\n  }\n\n  let formatted = `${instructions.emphasis}\\n\\n`;\n  formatted += `Available commands:\\n`;\n  formatted += `${instructions.commands.write}\\n`;\n  formatted += `${instructions.commands.read}\\n`;\n  formatted += `${instructions.commands.bash}\\n`;\n\n  if (instructions.examples) {\n    formatted += `\\n${instructions.examples}`;\n  }\n\n  return formatted;\n}\n\n// Parallel execution instructions for concurrent agent coordination\nexport const PARALLEL_EXECUTION_INSTRUCTIONS = `\n═══════════════════════════════════════════════════════════════\nCRITICAL: Concurrent Execution System\n═══════════════════════════════════════════════════════════════\n\nThis system supports parallel agent execution via CLI subprocesses and\nReasoningBank coordination. Follow these patterns for optimal performance:\n\n1. SUBPROCESS SPAWNING\n   When decomposing tasks, spawn subagents via CLI:\n\n   \\`\\`\\`typescript\n   const results = await Promise.all([\n     exec('npx agentic-flow --agent researcher --task \"analyze security\"'),\n     exec('npx agentic-flow --agent coder --task \"implement features\"'),\n     exec('npx agentic-flow --agent tester --task \"create tests\"')\n   ]);\n   \\`\\`\\`\n\n2. REASONINGBANK COORDINATION\n   Each subagent stores results in ReasoningBank:\n\n   \\`\\`\\`typescript\n   // Subagent stores results\n   await reasoningBank.storePattern({\n     sessionId: 'swarm/task-123/agent-1',\n     task: 'Research security patterns',\n     output: findings,\n     reward: 0.95,\n     success: true\n   });\n\n   // Parent retrieves all results\n   const allResults = await reasoningBank.searchPatterns('swarm/task-123');\n   \\`\\`\\`\n\n3. PERFORMANCE BENEFITS\n   - 2.8-4.4x speedup with parallel execution\n   - 50-70% time reduction with QUIC transport\n   - 32.3% token reduction via batching\n\nSee /agentic-flow/src/prompts/parallel-execution-guide.md for detailed examples.\n═══════════════════════════════════════════════════════════════\n`;\n\n// Enhanced instruction provider with parallel execution support\nexport interface InstructionOptions {\n  enableParallel?: boolean;\n  batchSize?: number;\n  enableReasoningBank?: boolean;\n  includeXmlInstructions?: boolean;\n}\n\n// Get appropriate max_tokens for model\nexport function getMaxTokensForModel(modelId: string, requestedMaxTokens?: number): number {\n  const normalizedModel = modelId.toLowerCase();\n\n  // If user requested specific max_tokens, use it\n  if (requestedMaxTokens) {\n    return requestedMaxTokens;\n  }\n\n  // DeepSeek needs higher max_tokens\n  if (normalizedModel.includes('deepseek')) {\n    return 8000;\n  }\n\n  // Llama 3.1/3.3 - moderate\n  if (normalizedModel.includes('llama')) {\n    return 4096;\n  }\n\n  // GPT models - standard\n  if (normalizedModel.includes('gpt')) {\n    return 4096;\n  }\n\n  // Default\n  return 4096;\n}\n\n// Get parallel execution capabilities for model\nexport function getParallelCapabilities(modelId: string): {\n  maxConcurrency: number;\n  recommendedBatchSize: number;\n  supportsSubprocesses: boolean;\n  supportsReasoningBank: boolean;\n} {\n  const normalized = modelId.toLowerCase();\n\n  // High-capability models (Claude, GPT-4)\n  if (normalized.includes('claude') || normalized.includes('gpt-4')) {\n    return {\n      maxConcurrency: 10,\n      recommendedBatchSize: 5,\n      supportsSubprocesses: true,\n      supportsReasoningBank: true\n    };\n  }\n\n  // Mid-tier models (DeepSeek, Llama 3.1)\n  if (normalized.includes('deepseek') || normalized.includes('llama-3.1')) {\n    return {\n      maxConcurrency: 5,\n      recommendedBatchSize: 3,\n      supportsSubprocesses: true,\n      supportsReasoningBank: true\n    };\n  }\n\n  // Lower-tier models\n  return {\n    maxConcurrency: 3,\n    recommendedBatchSize: 2,\n    supportsSubprocesses: true,\n    supportsReasoningBank: false\n  };\n}\n\n// Enhanced instruction builder\nexport function buildInstructions(\n  modelId: string,\n  provider: string | undefined,\n  options: InstructionOptions = {}\n): string {\n  const {\n    enableParallel = false,\n    batchSize,\n    enableReasoningBank = false,\n    includeXmlInstructions = true\n  } = options;\n\n  const baseInstructions = getInstructionsForModel(modelId, provider);\n  let formatted = formatInstructions(baseInstructions, includeXmlInstructions);\n\n  // Add parallel execution instructions if enabled\n  if (enableParallel) {\n    const capabilities = getParallelCapabilities(modelId);\n    const effectiveBatchSize = batchSize || capabilities.recommendedBatchSize;\n\n    formatted += '\\n\\n' + PARALLEL_EXECUTION_INSTRUCTIONS;\n    formatted += `\\n\\nRECOMMENDED BATCH SIZE: ${effectiveBatchSize} concurrent subagents`;\n    formatted += `\\nMAX CONCURRENCY: ${capabilities.maxConcurrency} agents`;\n  }\n\n  // Add ReasoningBank instructions if enabled\n  if (enableReasoningBank) {\n    formatted += `\\n\\n\nREASONINGBANK MEMORY COORDINATION:\n- Store: await reasoningBank.storePattern({ sessionId: 'swarm/TASK_ID/AGENT_ID', task, output, reward, success })\n- Retrieve: await reasoningBank.retrieve('swarm/TASK_ID/AGENT_ID')\n- Search: await reasoningBank.searchPatterns('swarm/TASK_ID', { k: 10 })\n    `;\n  }\n\n  return formatted;\n}\n"]}

package/agentic-flow/dist/proxy/quic-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quic-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/quic-proxy.ts"],"names":[],"mappings":"AAGA,OAAgB,EAAW,QAAQ,EAAgB,MAAM,SAAS,CAAC;AACnE,OAAO,EAAkC,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,MAAM,WAAW,eAAe;IAE9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,IAAI,CAAC,EAAE,UAAU,CAAC;IAGlB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,gBAAiB,SAAQ,0BAA0B;IAC9D,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,eAAe,CAAU;gBAErB,MAAM,EAAE,eAAe;IAgBnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;YACW,cAAc;IAsB5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;cACa,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgBjF;;OAEG;YACW,eAAe;IA0E7B;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;IACH,iBAAiB,IAAI,GAAG;IAexB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAWhC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAUzE"}

package/agentic-flow/dist/proxy/quic-proxy.js

@@ -0,0 +1,228 @@
+// QUIC-enabled Proxy for Anthropic API
+// Optional QUIC transport with automatic HTTP/2 fallback
+import { QuicClient, QuicConnectionPool } from '../transport/quic.js';
+import { logger } from '../utils/logger.js';
+import { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';
+export class QuicEnabledProxy extends AnthropicToOpenRouterProxy {
+    quicClient;
+    quicPool;
+    transport;
+    quicEnabled;
+    fallbackToHttp2;
+    constructor(config) {
+        super({
+            openrouterApiKey: config.openrouterApiKey,
+            openrouterBaseUrl: config.openrouterBaseUrl,
+            defaultModel: config.defaultModel
+        });
+        this.transport = config.transport || 'auto';
+        this.quicEnabled = config.enableQuic ?? this.checkQuicFeatureFlag();
+        this.fallbackToHttp2 = config.fallbackToHttp2 ?? true;
+        if (this.quicEnabled) {
+            this.initializeQuic(config.quic || {});
+        }
+    }
+    /**
+     * Check if QUIC is enabled via environment variable
+     */
+    checkQuicFeatureFlag() {
+        const flag = process.env.AGENTIC_FLOW_ENABLE_QUIC;
+        return flag === 'true' || flag === '1';
+    }
+    /**
+     * Initialize QUIC client and connection pool
+     */
+    async initializeQuic(quicConfig) {
+        try {
+            logger.info('Initializing QUIC transport...', { config: quicConfig });
+            this.quicClient = new QuicClient(quicConfig);
+            await this.quicClient.initialize();
+            this.quicPool = new QuicConnectionPool(this.quicClient, 20);
+            logger.info('QUIC transport initialized successfully');
+        }
+        catch (error) {
+            logger.error('Failed to initialize QUIC transport', { error });
+            if (this.fallbackToHttp2) {
+                logger.warn('Falling back to HTTP/2 transport');
+                this.quicEnabled = false;
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    /**
+     * Select transport protocol based on configuration and availability
+     */
+    selectTransport() {
+        if (this.transport === 'quic' && this.quicEnabled) {
+            return 'quic';
+        }
+        if (this.transport === 'http2') {
+            return 'http2';
+        }
+        // Auto mode: prefer QUIC if available, fallback to HTTP/2
+        if (this.transport === 'auto') {
+            return this.quicEnabled ? 'quic' : 'http2';
+        }
+        return 'http2';
+    }
+    /**
+     * Send request using selected transport
+     */
+    async sendRequest(url, options) {
+        const selectedTransport = this.selectTransport();
+        logger.debug('Sending request', {
+            transport: selectedTransport,
+            url,
+            method: options.method
+        });
+        if (selectedTransport === 'quic') {
+            return this.sendQuicRequest(url, options);
+        }
+        else {
+            return this.sendHttp2Request(url, options);
+        }
+    }
+    /**
+     * Send request over QUIC
+     */
+    async sendQuicRequest(url, options) {
+        if (!this.quicClient || !this.quicPool) {
+            throw new Error('QUIC client not initialized');
+        }
+        try {
+            const urlObj = new URL(url);
+            const connection = await this.quicPool.getConnection(urlObj.hostname, parseInt(urlObj.port) || 443);
+            logger.debug('Using QUIC connection', {
+                connectionId: connection.id,
+                url
+            });
+            // Prepare headers
+            const headers = {};
+            if (options.headers) {
+                const headerEntries = options.headers instanceof Headers
+                    ? Array.from(options.headers.entries())
+                    : Object.entries(options.headers);
+                for (const [key, value] of headerEntries) {
+                    headers[key] = value;
+                }
+            }
+            // Convert body to Uint8Array
+            let body;
+            if (options.body) {
+                if (typeof options.body === 'string') {
+                    body = new TextEncoder().encode(options.body);
+                }
+                else if (options.body instanceof Uint8Array) {
+                    body = options.body;
+                }
+                else {
+                    body = new TextEncoder().encode(JSON.stringify(options.body));
+                }
+            }
+            // Send HTTP/3 request over QUIC
+            const response = await this.quicClient.sendRequest(connection.id, options.method || 'GET', urlObj.pathname + urlObj.search, headers, body);
+            logger.info('QUIC request completed', {
+                status: response.status,
+                bytes: response.body.length
+            });
+            // Convert to fetch Response
+            const responseText = new TextDecoder().decode(response.body);
+            return new Response(responseText, {
+                status: response.status,
+                headers: new Headers(response.headers)
+            });
+        }
+        catch (error) {
+            logger.error('QUIC request failed', { error, url });
+            if (this.fallbackToHttp2) {
+                logger.warn('Falling back to HTTP/2 for this request');
+                return this.sendHttp2Request(url, options);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Send request over HTTP/2 (standard fetch)
+     */
+    async sendHttp2Request(url, options) {
+        logger.debug('Using HTTP/2 transport', { url });
+        return fetch(url, options);
+    }
+    /**
+     * Get transport statistics
+     */
+    getTransportStats() {
+        if (this.quicClient) {
+            return {
+                transport: this.selectTransport(),
+                quicEnabled: this.quicEnabled,
+                quicStats: this.quicClient.getStats()
+            };
+        }
+        return {
+            transport: 'http2',
+            quicEnabled: false
+        };
+    }
+    /**
+     * Shutdown and cleanup
+     */
+    async shutdown() {
+        if (this.quicPool) {
+            await this.quicPool.clear();
+        }
+        if (this.quicClient) {
+            await this.quicClient.shutdown();
+        }
+        logger.info('QUIC proxy shutdown complete');
+    }
+}
+/**
+ * Create QUIC-enabled proxy with configuration
+ */
+export function createQuicProxy(config) {
+    const proxy = new QuicEnabledProxy(config);
+    logger.info('QUIC proxy created', {
+        transport: config.transport || 'auto',
+        quicEnabled: config.enableQuic ?? (process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true'),
+        fallbackEnabled: config.fallbackToHttp2 ?? true
+    });
+    return proxy;
+}
+// CLI entry point for QUIC proxy
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const port = parseInt(process.env.PORT || '3000');
+    const openrouterApiKey = process.env.OPENROUTER_API_KEY;
+    if (!openrouterApiKey) {
+        console.error('❌ Error: OPENROUTER_API_KEY environment variable required');
+        process.exit(1);
+    }
+    const proxy = createQuicProxy({
+        openrouterApiKey,
+        openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,
+        defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL,
+        transport: process.env.TRANSPORT || 'auto',
+        enableQuic: process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true',
+        quic: {
+            port: parseInt(process.env.QUIC_PORT || '4433'),
+            serverHost: process.env.QUIC_HOST || 'localhost',
+            certPath: process.env.QUIC_CERT_PATH,
+            keyPath: process.env.QUIC_KEY_PATH
+        }
+    });
+    proxy.start(port);
+    // Graceful shutdown
+    process.on('SIGTERM', async () => {
+        logger.info('Received SIGTERM, shutting down gracefully...');
+        await proxy.shutdown();
+        process.exit(0);
+    });
+    process.on('SIGINT', async () => {
+        logger.info('Received SIGINT, shutting down gracefully...');
+        await proxy.shutdown();
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=quic-proxy.js.map

package/agentic-flow/dist/proxy/quic-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quic-proxy.js","sourceRoot":"","sources":["../../src/proxy/quic-proxy.ts"],"names":[],"mappings":"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","sourcesContent":["// QUIC-enabled Proxy for Anthropic API\n// Optional QUIC transport with automatic HTTP/2 fallback\n\nimport express, { Request, Response, NextFunction } from 'express';\nimport { QuicClient, QuicConnectionPool, QuicConfig } from '../transport/quic.js';\nimport { logger } from '../utils/logger.js';\nimport { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';\n\nexport interface QuicProxyConfig {\n  // Base proxy config\n  openrouterApiKey: string;\n  openrouterBaseUrl?: string;\n  defaultModel?: string;\n\n  // Transport selection\n  transport?: 'quic' | 'http2' | 'auto';\n  enableQuic?: boolean;\n\n  // QUIC configuration\n  quic?: QuicConfig;\n\n  // Fallback behavior\n  fallbackToHttp2?: boolean;\n  fallbackTimeout?: number;\n}\n\nexport class QuicEnabledProxy extends AnthropicToOpenRouterProxy {\n  private quicClient?: QuicClient;\n  private quicPool?: QuicConnectionPool;\n  private transport: 'quic' | 'http2' | 'auto';\n  private quicEnabled: boolean;\n  private fallbackToHttp2: boolean;\n\n  constructor(config: QuicProxyConfig) {\n    super({\n      openrouterApiKey: config.openrouterApiKey,\n      openrouterBaseUrl: config.openrouterBaseUrl,\n      defaultModel: config.defaultModel\n    });\n\n    this.transport = config.transport || 'auto';\n    this.quicEnabled = config.enableQuic ?? this.checkQuicFeatureFlag();\n    this.fallbackToHttp2 = config.fallbackToHttp2 ?? true;\n\n    if (this.quicEnabled) {\n      this.initializeQuic(config.quic || {});\n    }\n  }\n\n  /**\n   * Check if QUIC is enabled via environment variable\n   */\n  private checkQuicFeatureFlag(): boolean {\n    const flag = process.env.AGENTIC_FLOW_ENABLE_QUIC;\n    return flag === 'true' || flag === '1';\n  }\n\n  /**\n   * Initialize QUIC client and connection pool\n   */\n  private async initializeQuic(quicConfig: QuicConfig): Promise<void> {\n    try {\n      logger.info('Initializing QUIC transport...', { config: quicConfig });\n\n      this.quicClient = new QuicClient(quicConfig);\n      await this.quicClient.initialize();\n\n      this.quicPool = new QuicConnectionPool(this.quicClient, 20);\n\n      logger.info('QUIC transport initialized successfully');\n    } catch (error) {\n      logger.error('Failed to initialize QUIC transport', { error });\n\n      if (this.fallbackToHttp2) {\n        logger.warn('Falling back to HTTP/2 transport');\n        this.quicEnabled = false;\n      } else {\n        throw error;\n      }\n    }\n  }\n\n  /**\n   * Select transport protocol based on configuration and availability\n   */\n  private selectTransport(): 'quic' | 'http2' {\n    if (this.transport === 'quic' && this.quicEnabled) {\n      return 'quic';\n    }\n\n    if (this.transport === 'http2') {\n      return 'http2';\n    }\n\n    // Auto mode: prefer QUIC if available, fallback to HTTP/2\n    if (this.transport === 'auto') {\n      return this.quicEnabled ? 'quic' : 'http2';\n    }\n\n    return 'http2';\n  }\n\n  /**\n   * Send request using selected transport\n   */\n  protected async sendRequest(url: string, options: RequestInit): Promise<Response> {\n    const selectedTransport = this.selectTransport();\n\n    logger.debug('Sending request', {\n      transport: selectedTransport,\n      url,\n      method: options.method\n    });\n\n    if (selectedTransport === 'quic') {\n      return this.sendQuicRequest(url, options);\n    } else {\n      return this.sendHttp2Request(url, options);\n    }\n  }\n\n  /**\n   * Send request over QUIC\n   */\n  private async sendQuicRequest(url: string, options: RequestInit): Promise<Response> {\n    if (!this.quicClient || !this.quicPool) {\n      throw new Error('QUIC client not initialized');\n    }\n\n    try {\n      const urlObj = new URL(url);\n      const connection = await this.quicPool.getConnection(\n        urlObj.hostname,\n        parseInt(urlObj.port) || 443\n      );\n\n      logger.debug('Using QUIC connection', {\n        connectionId: connection.id,\n        url\n      });\n\n      // Prepare headers\n      const headers: Record<string, string> = {};\n      if (options.headers) {\n        const headerEntries = options.headers instanceof Headers\n          ? Array.from(options.headers.entries())\n          : Object.entries(options.headers);\n\n        for (const [key, value] of headerEntries) {\n          headers[key] = value;\n        }\n      }\n\n      // Convert body to Uint8Array\n      let body: Uint8Array | undefined;\n      if (options.body) {\n        if (typeof options.body === 'string') {\n          body = new TextEncoder().encode(options.body);\n        } else if (options.body instanceof Uint8Array) {\n          body = options.body;\n        } else {\n          body = new TextEncoder().encode(JSON.stringify(options.body));\n        }\n      }\n\n      // Send HTTP/3 request over QUIC\n      const response = await this.quicClient.sendRequest(\n        connection.id,\n        options.method || 'GET',\n        urlObj.pathname + urlObj.search,\n        headers,\n        body\n      );\n\n      logger.info('QUIC request completed', {\n        status: response.status,\n        bytes: response.body.length\n      });\n\n      // Convert to fetch Response\n      const responseText = new TextDecoder().decode(response.body);\n      return new Response(responseText, {\n        status: response.status,\n        headers: new Headers(response.headers)\n      }) as any;\n\n    } catch (error) {\n      logger.error('QUIC request failed', { error, url });\n\n      if (this.fallbackToHttp2) {\n        logger.warn('Falling back to HTTP/2 for this request');\n        return this.sendHttp2Request(url, options);\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Send request over HTTP/2 (standard fetch)\n   */\n  private async sendHttp2Request(url: string, options: RequestInit): Promise<Response> {\n    logger.debug('Using HTTP/2 transport', { url });\n    return fetch(url, options) as any;\n  }\n\n  /**\n   * Get transport statistics\n   */\n  getTransportStats(): any {\n    if (this.quicClient) {\n      return {\n        transport: this.selectTransport(),\n        quicEnabled: this.quicEnabled,\n        quicStats: this.quicClient.getStats()\n      };\n    }\n\n    return {\n      transport: 'http2',\n      quicEnabled: false\n    };\n  }\n\n  /**\n   * Shutdown and cleanup\n   */\n  async shutdown(): Promise<void> {\n    if (this.quicPool) {\n      await this.quicPool.clear();\n    }\n\n    if (this.quicClient) {\n      await this.quicClient.shutdown();\n    }\n\n    logger.info('QUIC proxy shutdown complete');\n  }\n}\n\n/**\n * Create QUIC-enabled proxy with configuration\n */\nexport function createQuicProxy(config: QuicProxyConfig): QuicEnabledProxy {\n  const proxy = new QuicEnabledProxy(config);\n\n  logger.info('QUIC proxy created', {\n    transport: config.transport || 'auto',\n    quicEnabled: config.enableQuic ?? (process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true'),\n    fallbackEnabled: config.fallbackToHttp2 ?? true\n  });\n\n  return proxy;\n}\n\n// CLI entry point for QUIC proxy\nif (import.meta.url === `file://${process.argv[1]}`) {\n  const port = parseInt(process.env.PORT || '3000');\n  const openrouterApiKey = process.env.OPENROUTER_API_KEY;\n\n  if (!openrouterApiKey) {\n    console.error('❌ Error: OPENROUTER_API_KEY environment variable required');\n    process.exit(1);\n  }\n\n  const proxy = createQuicProxy({\n    openrouterApiKey,\n    openrouterBaseUrl: process.env.ANTHROPIC_PROXY_BASE_URL,\n    defaultModel: process.env.COMPLETION_MODEL || process.env.REASONING_MODEL,\n    transport: (process.env.TRANSPORT as 'quic' | 'http2' | 'auto') || 'auto',\n    enableQuic: process.env.AGENTIC_FLOW_ENABLE_QUIC === 'true',\n    quic: {\n      port: parseInt(process.env.QUIC_PORT || '4433'),\n      serverHost: process.env.QUIC_HOST || 'localhost',\n      certPath: process.env.QUIC_CERT_PATH,\n      keyPath: process.env.QUIC_KEY_PATH\n    }\n  });\n\n  proxy.start(port);\n\n  // Graceful shutdown\n  process.on('SIGTERM', async () => {\n    logger.info('Received SIGTERM, shutting down gracefully...');\n    await proxy.shutdown();\n    process.exit(0);\n  });\n\n  process.on('SIGINT', async () => {\n    logger.info('Received SIGINT, shutting down gracefully...');\n    await proxy.shutdown();\n    process.exit(0);\n  });\n}\n"]}