voyageai-cli 1.29.0 → 1.30.1

package/src/commands/playground.js

@@ -67,6 +67,9 @@ function loadAnnouncementsFromMarkdown() {
       badge: metadata.badge || 'Info',
       published: metadata.published || new Date().toISOString().split('T')[0],
       expires: metadata.expires || '2099-12-31',
+      bg_image: metadata.bg_image || null,
+      bg_color: metadata.bg_color || null,
+      icon: metadata.icon || null,
       cta: {
         label: metadata.cta_label || 'Learn More',
         action: metadata.cta_action || 'link',
@@ -159,7 +162,9 @@ function createPlaygroundServer() {
     try {
       // Serve HTML
       if (req.method === 'GET' && (req.url === '/' || req.url === '/index.html')) {
-        const html = fs.readFileSync(htmlPath, 'utf8');
+        const { getVersion } = require('../lib/banner');
+        let html = fs.readFileSync(htmlPath, 'utf8');
+        html = html.replace('</head>', `<script>window.__VAI_VERSION__="${getVersion()}";</script></head>`);
         res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
         res.end(html);
         return;
@@ -223,6 +228,43 @@ function createPlaygroundServer() {
         return;
       }
 
+      // Serve announcement assets: /assets/announcements/{filename}
+      const assetMatch = req.url.match(/^\/assets\/announcements\/([a-zA-Z0-9_.-]+\.(jpg|jpeg|png|webp|gif))$/);
+      if (req.method === 'GET' && assetMatch) {
+        const assetPath = path.join(__dirname, '..', 'playground', 'assets', 'announcements', assetMatch[1]);
+        if (fs.existsSync(assetPath)) {
+          const mimeTypes = { jpg: 'image/jpeg', jpeg: 'image/jpeg', png: 'image/png', webp: 'image/webp', gif: 'image/gif' };
+          const data = fs.readFileSync(assetPath);
+          res.writeHead(200, {
+            'Content-Type': mimeTypes[assetMatch[2]] || 'application/octet-stream',
+            'Cache-Control': 'public, max-age=86400',
+          });
+          res.end(data);
+        } else {
+          res.writeHead(404);
+          res.end('Asset not found');
+        }
+        return;
+      }
+
+      // Serve vendor assets (bundled JS libraries)
+      const vendorMatch = req.url.match(/^\/vendor\/([a-zA-Z0-9_.-]+\.js)$/);
+      if (req.method === 'GET' && vendorMatch) {
+        const vendorPath = path.join(__dirname, '..', 'playground', 'vendor', vendorMatch[1]);
+        if (fs.existsSync(vendorPath)) {
+          const data = fs.readFileSync(vendorPath);
+          res.writeHead(200, {
+            'Content-Type': 'application/javascript; charset=utf-8',
+            'Cache-Control': 'public, max-age=86400',
+          });
+          res.end(data);
+        } else {
+          res.writeHead(404);
+          res.end('Vendor asset not found');
+        }
+        return;
+      }
+
       // API: Models
       if (req.method === 'GET' && req.url === '/api/models') {
         const models = MODEL_CATALOG.filter(m => !m.legacy && !m.local && !m.unreleased);
@@ -360,6 +402,14 @@ function createPlaygroundServer() {
         return;
       }
 
+      // API: Workflow node help
+      if (req.method === 'GET' && req.url === '/api/workflows/node-help') {
+        const nodeHelp = require('../playground/help/workflow-nodes');
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ nodeHelp }));
+        return;
+      }
+
       // API: Chat config (GET)
       if (req.method === 'GET' && req.url === '/api/chat/config') {
         const { resolveLLMConfig } = require('../lib/llm');
@@ -428,6 +478,62 @@ function createPlaygroundServer() {
         return;
       }
 
+      // API: MCP status — installation status across all tools
+      if (req.method === 'GET' && req.url === '/api/mcp/status') {
+        try {
+          const { statusAll } = require('../mcp/install');
+          const results = statusAll();
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify(results));
+        } catch (err) {
+          res.writeHead(500, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: err.message }));
+        }
+        return;
+      }
+
+      // API: MCP install — install vai into a target tool
+      if (req.method === 'POST' && req.url === '/api/mcp/install') {
+        try {
+          const body = await readBody(req);
+          const { target, force } = JSON.parse(body);
+          if (!target) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'target is required' }));
+            return;
+          }
+          const { installTarget } = require('../mcp/install');
+          const result = installTarget(target, { force: force || false });
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify(result));
+        } catch (err) {
+          res.writeHead(500, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: err.message }));
+        }
+        return;
+      }
+
+      // API: MCP uninstall — remove vai from a target tool
+      if (req.method === 'POST' && req.url === '/api/mcp/uninstall') {
+        try {
+          const body = await readBody(req);
+          const { target } = JSON.parse(body);
+          if (!target) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'target is required' }));
+            return;
+          }
+          const { uninstallTarget } = require('../mcp/install');
+          const result = uninstallTarget(target);
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify(result));
+        } catch (err) {
+          res.writeHead(500, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: err.message }));
+        }
+        return;
+      }
+
       // API: Settings origins — where each config value comes from
       if (req.method === 'GET' && req.url === '/api/settings/origins') {
         const { resolveLLMConfig } = require('../lib/llm');
@@ -656,6 +762,17 @@ function createPlaygroundServer() {
               description: def.description || '',
             }));
 
+            // Derive capabilities from tools
+            const toolsList = vai.tools || [];
+            const capabilities = [];
+            if (toolsList.includes('http')) capabilities.push('NETWORK');
+            if (toolsList.includes('ingest') || toolsList.includes('aggregate')) capabilities.push('WRITE_DB');
+            if (toolsList.includes('generate')) capabilities.push('LLM');
+            if (toolsList.includes('loop') || toolsList.includes('forEach')) capabilities.push('LOOP');
+            if (toolsList.some(t => ['query','search','collections','aggregate'].includes(t))) capabilities.push('READ_DB');
+
+            const isOfficial = (r.name || '').startsWith('@vaicli/');
+
             return {
               name: shortName,
               packageName: r.name,
@@ -663,11 +780,10 @@ function createPlaygroundServer() {
               description: r.description || '',
               category,
               tags: vai.tags || [],
-              tools: vai.tools || [],
-              steps: vai.steps || (vai.tools || []).length || 0,
-              tools: vai.tools || [],
-              toolCount: (vai.tools || []).length,
-              tier: (r.name || '').startsWith('@vaicli/') ? 'official' : 'community',
+              tools: toolsList,
+              steps: vai.steps || toolsList.length || 0,
+              toolCount: toolsList.length,
+              tier: isOfficial ? 'official' : 'community',
               downloads: 0,
               featured: FEATURED.includes(shortName),
               installed: installedNames.has(r.name),
@@ -676,6 +792,10 @@ function createPlaygroundServer() {
               author,
               assets,
               inputs,
+              capabilities,
+              verified: isOfficial,
+              security: [],
+              rating: null,
             };
           });
 
@@ -1374,15 +1494,23 @@ function createPlaygroundServer() {
         // API: Validate a workflow definition
         if (req.url === '/api/workflows/validate') {
           const { validateWorkflow } = require('../lib/workflow');
-          const { definition } = parsed;
+          const { definition, mode } = parsed;
           if (!definition) {
             res.writeHead(400, { 'Content-Type': 'application/json' });
             res.end(JSON.stringify({ error: 'definition is required' }));
             return;
           }
-          const errors = validateWorkflow(definition);
+          const validationMode = mode || 'strict';
+          const result = validateWorkflow(definition, { mode: validationMode });
+          
           res.writeHead(200, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ valid: errors.length === 0, errors }));
+          
+          if (validationMode === 'draft') {
+            res.end(JSON.stringify(result));
+          } else {
+            // Backward compatible format for strict mode
+            res.end(JSON.stringify({ valid: result.length === 0, errors: result }));
+          }
           return;
         }
 
@@ -1486,6 +1614,32 @@ function createPlaygroundServer() {
         }
       }
 
+      // ── Export API endpoints ──
+      const exportMatch = req.url.match(/^\/api\/export\/(workflow|chat|search|benchmark)$/);
+      if (req.method === 'POST' && exportMatch) {
+        const context = exportMatch[1];
+        try {
+          const body = JSON.parse(await readBody(req));
+          const { exportArtifact } = require('../lib/export');
+          const result = await exportArtifact({
+            context,
+            format: body.format || 'json',
+            data: body.data || {},
+            options: body.options || {},
+          });
+          const isBinary = Buffer.isBuffer(result.content);
+          res.writeHead(200, {
+            'Content-Type': result.mimeType,
+            'Content-Disposition': `attachment; filename="${result.suggestedFilename}"`,
+          });
+          res.end(isBinary ? result.content : result.content);
+        } catch (err) {
+          res.writeHead(400, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: err.message }));
+        }
+        return;
+      }
+
       // 404
       res.writeHead(404, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ error: 'Not found' }));

package/src/commands/query.js

@@ -5,6 +5,7 @@ const { generateEmbeddings, apiRequest } = require('../lib/api');
 const { getMongoCollection } = require('../lib/mongo');
 const { loadProject } = require('../lib/project');
 const ui = require('../lib/ui');
+const { showCombinedCostSummary } = require('../lib/cost-display');
 
 /**
  * Register the query command on a Commander program.
@@ -33,6 +34,7 @@ function registerQuery(program) {
     .option('-q, --quiet', 'Suppress non-essential output')
     .action(async (text, opts) => {
       let client;
+      const telemetry = require('../lib/telemetry');
       try {
         // Merge project config
         const { config: proj } = loadProject();
@@ -51,6 +53,14 @@ function registerQuery(program) {
           process.exit(1);
         }
 
+        const done = telemetry.timer('cli_query', {
+          model,
+          rerankModel: doRerank ? rerankModel : undefined,
+          rerank: doRerank,
+          limit: opts.limit,
+          topK: opts.topK,
+        });
+
         const useColor = !opts.json;
         const useSpinner = useColor && !opts.quiet;
 
@@ -242,8 +252,14 @@ function registerQuery(program) {
         if (!opts.quiet) {
           const totalTokens = embedTokens + rerankTokens;
           console.log(ui.dim(`  Tokens: ${totalTokens} (embed: ${embedTokens}${rerankTokens ? `, rerank: ${rerankTokens}` : ''})`));
+          const costOps = [{ model, tokens: embedTokens, label: `embed (${model})` }];
+          if (rerankTokens) costOps.push({ model: rerankModel, tokens: rerankTokens, label: `rerank (${rerankModel})` });
+          showCombinedCostSummary(costOps, opts);
         }
+
+        done({ resultCount: finalResults.length });
       } catch (err) {
+        telemetry.send('cli_error', { command: 'query', errorType: err.constructor.name });
         console.error(ui.error(err.message));
         process.exit(1);
       } finally {

package/src/commands/rerank.js

@@ -4,6 +4,7 @@ const fs = require('fs');
 const { DEFAULT_RERANK_MODEL } = require('../lib/catalog');
 const { apiRequest } = require('../lib/api');
 const ui = require('../lib/ui');
+const { showCostSummary } = require('../lib/cost-display');
 
 /**
  * Register the rerank command on a Commander program.
@@ -25,6 +26,7 @@ function registerRerank(program) {
     .option('--json', 'Machine-readable JSON output')
     .option('-q, --quiet', 'Suppress non-essential output')
     .action(async (opts) => {
+      const telemetry = require('../lib/telemetry');
       try {
         let documents = opts.documents;
 
@@ -81,6 +83,12 @@ function registerRerank(program) {
           opts.model = chosenModel;
         }
 
+        const done = telemetry.timer('cli_rerank', {
+          model: opts.model,
+          docCount: documents.length,
+          topK: opts.topK,
+        });
+
         const body = {
           query: opts.query,
           documents,
@@ -120,6 +128,7 @@ function registerRerank(program) {
           if (result.usage) {
             console.log(ui.label('Tokens', ui.dim(String(result.usage.total_tokens))));
           }
+          showCostSummary(result.model || opts.model, result.usage?.total_tokens || 0, opts);
           console.log('');
         }
 
@@ -134,7 +143,10 @@ function registerRerank(program) {
 
         console.log('');
         console.log(ui.success('Reranking complete'));
+
+        done();
       } catch (err) {
+        telemetry.send('cli_error', { command: 'rerank', errorType: err.constructor.name });
         console.error(ui.error(err.message));
         process.exit(1);
       }

package/src/commands/scaffold.js

@@ -55,7 +55,9 @@ function registerScaffold(program) {
     .option('--dry-run', 'Show what would be created without writing')
     .option('-q, --quiet', 'Suppress non-essential output')
     .action(async (name, opts) => {
+      const telemetry = require('../lib/telemetry');
       try {
+        telemetry.send('cli_scaffold', { template: opts.target });
         const target = opts.target;
         const projectDir = path.resolve(process.cwd(), name);
         

package/src/commands/search.js

@@ -4,6 +4,7 @@ const { getDefaultModel } = require('../lib/catalog');
 const { generateEmbeddings } = require('../lib/api');
 const { getMongoCollection } = require('../lib/mongo');
 const ui = require('../lib/ui');
+const { showCostSummary } = require('../lib/cost-display');
 
 /**
  * Register the search command on a Commander program.
@@ -29,7 +30,13 @@ function registerSearch(program) {
     .option('-q, --quiet', 'Suppress non-essential output')
     .action(async (opts) => {
       let client;
+      const telemetry = require('../lib/telemetry');
       try {
+        const done = telemetry.timer('cli_search', {
+          model: opts.model,
+          limit: opts.limit,
+        });
+
         const useColor = !opts.json;
         const useSpinner = useColor && !opts.quiet;
         let spin;
@@ -93,9 +100,12 @@ function registerSearch(program) {
         if (!opts.quiet) {
           console.log(ui.label('Query', ui.cyan(`"${opts.query}"`)));
           console.log(ui.label('Results', String(cleanResults.length)));
+          showCostSummary(opts.model, embedResult.usage?.total_tokens || 0, opts);
           console.log('');
         }
 
+        done({ resultCount: cleanResults.length });
+
         if (cleanResults.length === 0) {
           console.log(ui.yellow('No results found.'));
           return;
@@ -113,6 +123,7 @@ function registerSearch(program) {
           console.log('');
         }
       } catch (err) {
+        telemetry.send('cli_error', { command: 'search', errorType: err.constructor.name });
         console.error(ui.error(err.message));
         process.exit(1);
       } finally {

package/src/commands/similarity.js

@@ -5,6 +5,7 @@ const { generateEmbeddings } = require('../lib/api');
 const { cosineSimilarity } = require('../lib/math');
 const { getDefaultModel } = require('../lib/catalog');
 const ui = require('../lib/ui');
+const { showCostSummary } = require('../lib/cost-display');
 
 /**
  * Register the similarity command on a Commander program.
@@ -23,6 +24,7 @@ function registerSimilarity(program) {
     .option('--json', 'Machine-readable JSON output')
     .option('-q, --quiet', 'Suppress non-essential output')
     .action(async (texts, opts) => {
+      const telemetry = require('../lib/telemetry');
       try {
         let textA = null;
         let compareTexts = [];
@@ -57,6 +59,8 @@ function registerSimilarity(program) {
           process.exit(1);
         }
 
+        const done = telemetry.timer('cli_similarity', { model: opts.model });
+
         // Batch all texts into one API call
         const allTexts = [textA, ...compareTexts];
 
@@ -113,6 +117,7 @@ function registerSimilarity(program) {
           console.log(ui.label('Text B', `"${truncate(compareTexts[0], 70)}"`));
           console.log(ui.label('Model', ui.cyan(model)));
           console.log(ui.label('Tokens', ui.dim(String(tokens))));
+          showCostSummary(model, tokens, opts);
           console.log('');
         } else {
           // One-vs-many comparison
@@ -152,9 +157,13 @@ function registerSimilarity(program) {
 
           console.log('');
           console.log(`  ${ui.dim(`${results.length} comparisons, ${tokens} tokens`)}`);
+          showCostSummary(model, tokens, opts);
           console.log('');
         }
+
+        done();
       } catch (err) {
+        telemetry.send('cli_error', { command: 'similarity', errorType: err.constructor.name });
         console.error(ui.error(err.message));
         process.exit(1);
       }

package/src/commands/store.js

@@ -29,6 +29,8 @@ function registerStore(program) {
     .option('-q, --quiet', 'Suppress non-essential output')
     .action(async (opts) => {
       let client;
+      const telemetry = require('../lib/telemetry');
+      const done = telemetry.timer('cli_store', { model: opts.model });
       try {
         // Batch mode: .jsonl file
         if (opts.file && opts.file.endsWith('.jsonl')) {
@@ -102,7 +104,9 @@ function registerStore(program) {
             console.log(ui.label('Tokens', String(embedResult.usage.total_tokens)));
           }
         }
+        done();
       } catch (err) {
+        telemetry.send('cli_error', { command: 'store', errorType: err.constructor.name });
         console.error(ui.error(err.message));
         process.exit(1);
       } finally {