agentic-flow 2.0.7 → 3.0.0-alpha.2

package/dist/agentic-flow/src/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/dist/agentic-flow/src/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/dist/agentic-flow/src/proxy/quic-proxy.d.ts

@@ -0,0 +1,58 @@
+import { type Response } from 'express';
+import { QuicConfig } from '../transport/quic.js';
+import { AnthropicToOpenRouterProxy } from './anthropic-to-openrouter.js';
+export interface QuicProxyConfig {
+    openrouterApiKey: string;
+    openrouterBaseUrl?: string;
+    defaultModel?: string;
+    transport?: 'quic' | 'http2' | 'auto';
+    enableQuic?: boolean;
+    quic?: QuicConfig;
+    fallbackToHttp2?: boolean;
+    fallbackTimeout?: number;
+}
+export declare class QuicEnabledProxy extends AnthropicToOpenRouterProxy {
+    private quicClient?;
+    private quicPool?;
+    private transport;
+    private quicEnabled;
+    private fallbackToHttp2;
+    constructor(config: QuicProxyConfig);
+    /**
+     * Check if QUIC is enabled via environment variable
+     */
+    private checkQuicFeatureFlag;
+    /**
+     * Initialize QUIC client and connection pool
+     */
+    private initializeQuic;
+    /**
+     * Select transport protocol based on configuration and availability
+     */
+    private selectTransport;
+    /**
+     * Send request using selected transport
+     */
+    protected sendRequest(url: string, options: RequestInit): Promise<Response>;
+    /**
+     * Send request over QUIC
+     */
+    private sendQuicRequest;
+    /**
+     * Send request over HTTP/2 (standard fetch)
+     */
+    private sendHttp2Request;
+    /**
+     * Get transport statistics
+     */
+    getTransportStats(): any;
+    /**
+     * Shutdown and cleanup
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create QUIC-enabled proxy with configuration
+ */
+export declare function createQuicProxy(config: QuicProxyConfig): QuicEnabledProxy;
+//# sourceMappingURL=quic-proxy.d.ts.map

package/dist/agentic-flow/src/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,KAAK,QAAQ,EAAgB,MAAM,SAAS,CAAC;AACxE,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;IAgF7B;;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"}