create-byan-agent 2.2.2 → 2.3.0

package/install/templates/workers/README.md

@@ -0,0 +1,148 @@
+# Cost Optimizer Worker Template
+
+Worker BYAN qui optimise automatiquement les coûts LLM en routant vers le modèle optimal.
+
+## Installation
+
+Ce worker est automatiquement installé par Yanstaller si vous sélectionnez "Cost Optimizer".
+
+## Utilisation
+
+### Dans un agent BYAN
+
+```javascript
+const CostOptimizerWorker = require('./_byan/workers/cost-optimizer');
+
+const worker = new CostOptimizerWorker({
+  workerThreshold: 30,
+  agentThreshold: 60,
+  verbose: true
+});
+
+// Router une tâche
+const result = await worker.execute({
+  input: 'Your prompt here',
+  type: 'generate'
+});
+
+console.log(result.content);
+console.log(`Cost: $${result.cost}`);
+```
+
+### Configuration
+
+```javascript
+const worker = new CostOptimizerWorker({
+  workerThreshold: 30,     // < 30 → worker (cheap)
+  agentThreshold: 60,      // ≥ 60 → agent (expensive)
+  fallbackEnabled: true,   // Fallback worker → agent si échec
+  maxRetries: 3,           // Tentatives max
+  testMode: true,          // Mode test (sans vraie API)
+  verbose: false           // Logs détaillés
+});
+```
+
+### Méthodes
+
+**execute(task)** - Route et exécute une tâche
+```javascript
+const result = await worker.execute({
+  input: 'Fix this bug',
+  type: 'simple',
+  contextSize: 1000,
+  steps: 2,
+  outputFormat: 'text'
+});
+```
+
+**getStatistics()** - Obtenir les statistiques
+```javascript
+const stats = worker.getStatistics();
+console.log(`Économies: ${stats.savingsPercent}%`);
+```
+
+**printSummary()** - Afficher résumé formaté
+```javascript
+worker.printSummary();
+```
+
+**analyzeComplexity(task)** - Analyser sans exécuter
+```javascript
+const complexity = worker.analyzeComplexity({ input: prompt });
+console.log(`Score: ${complexity.total}`);
+```
+
+**exportData(format)** - Exporter données
+```javascript
+const json = worker.exportData('json');
+const csv = worker.exportData('csv');
+```
+
+**reset()** - Réinitialiser stats
+```javascript
+worker.reset();
+```
+
+**close()** - Nettoyer ressources
+```javascript
+await worker.close();
+```
+
+## Types de tâches
+
+- **simple** - Corrections simples, typos (score: 0-25)
+- **format** - Formatage, organisation (score: 5-30)
+- **generate** - Génération de code (score: 15-45)
+- **analysis** - Analyse de code (score: 30-60)
+- **reasoning** - Conception, architecture (score: 30-75)
+- **creation** - Création complexe (score: 30-75)
+
+## Économies attendues
+
+- **Workload typique:** 60% worker, 40% agent
+- **Économies:** ~54% sur les coûts LLM
+- **Coût worker:** $0.0003 par appel
+- **Coût agent:** $0.003 par appel (10x plus cher)
+
+## Test
+
+```bash
+cd install/templates/workers
+node cost-optimizer.js
+```
+
+Output attendu:
+```
+🚀 Cost Optimizer Worker Demo
+
+1️⃣  Simple task:
+[CostOptimizer] Routed to: worker
+Result: ✓
+
+2️⃣  Complex task:
+[CostOptimizer] Routed to: worker
+Result: ✓
+
+📊 Statistics:
+Savings: 87.5%
+```
+
+## Production
+
+Pour utiliser avec vraie API:
+
+```javascript
+const worker = new CostOptimizerWorker({
+  testMode: false,  // IMPORTANT
+  verbose: true
+});
+```
+
+Nécessite:
+- GitHub Copilot subscription
+- GITHUB_TOKEN env variable
+
+## Support
+
+- Package: https://npmjs.com/package/byan-copilot-router
+- Issues: https://github.com/byan/copilot-router/issues

package/install/templates/workers/cost-optimizer.js

@@ -0,0 +1,169 @@
+/**
+ * Cost Optimizer Worker
+ * 
+ * Automatically routes LLM calls to optimal model based on complexity.
+ * Integrates with byan-copilot-router for cost optimization.
+ * 
+ * @module workers/cost-optimizer
+ */
+
+const { CopilotRouter } = require('byan-copilot-router');
+
+class CostOptimizerWorker {
+  constructor(config = {}) {
+    this.router = new CopilotRouter({
+      workerThreshold: config.workerThreshold || 30,
+      agentThreshold: config.agentThreshold || 60,
+      fallbackEnabled: config.fallbackEnabled !== false,
+      maxRetries: config.maxRetries || 3,
+      clientOptions: {
+        testMode: config.testMode !== false // Default to test mode
+      }
+    });
+    
+    this.role = 'worker';
+    this.model = 'auto'; // Auto-select based on complexity
+    this.verbose = config.verbose || false;
+  }
+
+  /**
+   * Execute task with automatic routing
+   * 
+   * @param {Object} task - Task to execute
+   * @param {string} task.input - User prompt
+   * @param {string} task.type - Task type (simple/generate/analysis/reasoning)
+   * @param {number} [task.contextSize] - Context size in characters
+   * @param {number} [task.steps] - Number of steps
+   * @param {string} [task.outputFormat] - Output format (text/json/complex)
+   * @returns {Promise<Object>} Execution result
+   */
+  async execute(task) {
+    if (this.verbose) {
+      console.log('[CostOptimizer] Routing task:', task.type);
+    }
+
+    try {
+      const result = await this.router.route({
+        input: task.input || task.prompt,
+        type: task.type || 'generate',
+        contextSize: task.contextSize || (task.context?.length || 0),
+        steps: task.steps,
+        outputFormat: task.outputFormat
+      });
+
+      if (this.verbose) {
+        console.log(`[CostOptimizer] Routed to: ${result.route}`);
+        console.log(`[CostOptimizer] Cost: $${result.cost.toFixed(6)}`);
+        console.log(`[CostOptimizer] Complexity: ${result.complexityScore.total}`);
+      }
+
+      return {
+        success: true,
+        content: result.content,
+        route: result.route,
+        model: result.model,
+        cost: result.cost,
+        tokens: result.tokens,
+        complexity: result.complexityScore.total
+      };
+
+    } catch (error) {
+      console.error('[CostOptimizer] Error:', error.message);
+      return {
+        success: false,
+        error: error.message
+      };
+    }
+  }
+
+  /**
+   * Get routing statistics
+   * 
+   * @returns {Object} Statistics with costs and savings
+   */
+  getStatistics() {
+    return this.router.getTracker().getStatistics();
+  }
+
+  /**
+   * Print cost summary
+   */
+  printSummary() {
+    console.log(this.router.getTracker().printSummary());
+  }
+
+  /**
+   * Export cost data
+   * 
+   * @param {string} format - Format (json/csv)
+   * @returns {string} Exported data
+   */
+  exportData(format = 'json') {
+    const tracker = this.router.getTracker();
+    return format === 'csv' ? tracker.exportCSV() : tracker.exportJSON();
+  }
+
+  /**
+   * Reset statistics
+   */
+  reset() {
+    this.router.getTracker().reset();
+  }
+
+  /**
+   * Cleanup resources
+   */
+  async close() {
+    await this.router.close();
+  }
+
+  /**
+   * Get complexity score for a task without executing
+   * 
+   * @param {Object} task - Task to analyze
+   * @returns {Object} Complexity score
+   */
+  analyzeComplexity(task) {
+    return this.router.analyzer.calculateComplexity({
+      input: task.input || task.prompt,
+      type: task.type || 'generate',
+      contextSize: task.contextSize || 0,
+      steps: task.steps,
+      outputFormat: task.outputFormat
+    });
+  }
+}
+
+module.exports = CostOptimizerWorker;
+
+// Example usage
+if (require.main === module) {
+  (async () => {
+    console.log('🚀 Cost Optimizer Worker Demo\n');
+    
+    const worker = new CostOptimizerWorker({ verbose: true });
+
+    // Simple task
+    console.log('1️⃣  Simple task:');
+    const r1 = await worker.execute({
+      input: 'Fix typo in code',
+      type: 'simple'
+    });
+    console.log('Result:', r1.success ? '✓' : '✗', '\n');
+
+    // Complex task
+    console.log('2️⃣  Complex task:');
+    const r2 = await worker.execute({
+      input: 'Design microservices architecture',
+      type: 'reasoning',
+      steps: 5
+    });
+    console.log('Result:', r2.success ? '✓' : '✗', '\n');
+
+    // Show statistics
+    console.log('📊 Statistics:');
+    worker.printSummary();
+
+    await worker.close();
+  })();
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-byan-agent",
-  "version": "2.2.2",
-  "description": "BYAN v2.2.2 - Intelligent AI agent creator with Multi-platform native support (Copilot CLI, Claude Code, Codex)",
+  "version": "2.3.0",
+  "description": "BYAN v2.3.0 - Intelligent AI agent creator with Multi-platform native support (Copilot CLI, Claude Code, Codex) + Automatic LLM cost optimization",
   "main": "src/index.js",
   "bin": {
     "create-byan-agent": "./install/bin/create-byan-agent-v2.js",
@@ -83,5 +83,8 @@
         "statements": 80
       }
     }
+  },
+  "optionalDependencies": {
+    "byan-copilot-router": "^1.0.1"
   }
 }