voyageai-cli 1.30.0 → 1.30.2

package/src/workflows/code-review.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://vai.dev/schemas/workflow-v1.json",
+  "name": "Code Review Assistant",
+  "description": "Index a codebase, find similar patterns, and surface related code for review. Paste a code snippet and get context from across the project — similar implementations, related functions, and architectural patterns.",
+  "version": "1.0.0",
+  "branding": {
+    "icon": "code",
+    "color": "#06B6D4"
+  },
+  "inputs": {
+    "source": {
+      "type": "string",
+      "description": "Local directory path or GitHub repo URL to analyze",
+      "required": true
+    },
+    "code": {
+      "type": "string",
+      "description": "Code snippet to review — finds similar patterns and related implementations",
+      "required": true
+    },
+    "question": {
+      "type": "string",
+      "description": "Optional question about the code (e.g., 'are there any other retry implementations?')",
+      "default": ""
+    },
+    "language": {
+      "type": "string",
+      "description": "Filter results to a specific language (e.g., 'js', 'py', 'go')"
+    },
+    "limit": {
+      "type": "number",
+      "description": "Maximum results per search step",
+      "default": 5
+    }
+  },
+  "defaults": {
+    "db": "vai_code_search"
+  },
+  "steps": [
+    {
+      "id": "check_index",
+      "name": "Check if codebase is already indexed",
+      "tool": "code_status",
+      "inputs": {
+        "db": "{{ defaults.db }}"
+      }
+    },
+    {
+      "id": "index_codebase",
+      "name": "Index codebase (skip if already indexed and fresh)",
+      "tool": "code_index",
+      "inputs": {
+        "source": "{{ inputs.source }}",
+        "db": "{{ defaults.db }}",
+        "refresh": true
+      },
+      "condition": "{{ !check_index.output || check_index.output.totalChunks === 0 }}"
+    },
+    {
+      "id": "find_similar",
+      "name": "Find similar code patterns across the codebase",
+      "tool": "code_find_similar",
+      "inputs": {
+        "code": "{{ inputs.code }}",
+        "db": "{{ defaults.db }}",
+        "collection": "{{ index_codebase.output.collection || check_index.output.collection }}",
+        "limit": "{{ inputs.limit }}",
+        "language": "{{ inputs.language }}",
+        "threshold": 0.4
+      }
+    },
+    {
+      "id": "contextual_search",
+      "name": "Search for related architectural context",
+      "tool": "code_search",
+      "inputs": {
+        "query": "{{ inputs.question || 'functions and modules related to: ' + inputs.code }}",
+        "db": "{{ defaults.db }}",
+        "collection": "{{ index_codebase.output.collection || check_index.output.collection }}",
+        "limit": "{{ inputs.limit }}",
+        "language": "{{ inputs.language }}",
+        "rerank": true
+      }
+    },
+    {
+      "id": "deep_query",
+      "name": "Answer specific question about the code",
+      "tool": "code_query",
+      "inputs": {
+        "query": "{{ inputs.question }}",
+        "db": "{{ defaults.db }}",
+        "collection": "{{ index_codebase.output.collection || check_index.output.collection }}",
+        "limit": 3,
+        "language": "{{ inputs.language }}"
+      },
+      "condition": "{{ inputs.question && inputs.question.length > 0 }}"
+    }
+  ],
+  "output": {
+    "similarPatterns": "{{ find_similar.output.results }}",
+    "similarCount": "{{ find_similar.output.metadata.resultCount }}",
+    "relatedCode": "{{ contextual_search.output.results }}",
+    "relatedCount": "{{ contextual_search.output.metadata.resultCount }}",
+    "answer": "{{ deep_query.output.results }}",
+    "indexStatus": {
+      "totalFiles": "{{ check_index.output.uniqueFiles || index_codebase.output.filesIndexed }}",
+      "totalChunks": "{{ check_index.output.totalChunks || index_codebase.output.chunksCreated }}"
+    }
+  }
+}

package/src/workflows/cost-analysis.json

@@ -69,5 +69,10 @@
     "docs": "{{ inputs.docs }}",
     "queriesPerMonth": "{{ inputs.queries }}",
     "months": "{{ inputs.months }}"
+  },
+  "formatters": {
+    "default": "table",
+    "title": "Cost Analysis",
+    "arrayField": "comparison"
   }
 }

package/src/workflows/rag-chat.json

@@ -0,0 +1,165 @@
+{
+  "$schema": "https://vai.dev/schemas/workflow-v1.json",
+  "name": "RAG Chat",
+  "description": "Retrieval-Augmented Generation chat: searches your knowledge base, reranks for relevance, filters low-quality matches, and generates a grounded answer with source citations",
+  "version": "1.0.0",
+  "branding": {
+    "icon": "message-circle",
+    "color": "#7C3AED"
+  },
+  "inputs": {
+    "question": {
+      "type": "string",
+      "description": "The user's question or message",
+      "required": true
+    },
+    "collection": {
+      "type": "string",
+      "description": "Knowledge base collection to search",
+      "required": true
+    },
+    "collection2": {
+      "type": "string",
+      "description": "Optional second collection for broader search (leave empty to skip)",
+      "default": ""
+    },
+    "limit": {
+      "type": "number",
+      "description": "Maximum documents to retrieve per collection",
+      "default": 10
+    },
+    "min_score": {
+      "type": "number",
+      "description": "Minimum relevance score (0-1) to include a document",
+      "default": 0.3
+    },
+    "system_prompt": {
+      "type": "string",
+      "description": "Custom system prompt for the LLM",
+      "default": "You are a knowledgeable assistant. Answer questions accurately based on the provided context. Always cite your sources by referencing the document name or source field. If the context does not contain enough information to answer fully, say so clearly and explain what information is missing. Never fabricate information that is not in the provided context."
+    },
+    "chat_history": {
+      "type": "string",
+      "description": "Previous conversation turns (for multi-turn context)",
+      "default": ""
+    }
+  },
+  "defaults": {},
+  "steps": [
+    {
+      "id": "search_primary",
+      "name": "Search primary knowledge base",
+      "tool": "query",
+      "inputs": {
+        "query": "{{ inputs.question }}",
+        "collection": "{{ inputs.collection }}",
+        "limit": "{{ inputs.limit }}",
+        "rerank": false
+      }
+    },
+    {
+      "id": "check_multi",
+      "name": "Check if second collection is configured",
+      "tool": "conditional",
+      "inputs": {
+        "condition": "{{ inputs.collection2.length > 0 }}",
+        "then": ["search_secondary"],
+        "else": ["skip_merge"]
+      }
+    },
+    {
+      "id": "search_secondary",
+      "name": "Search secondary knowledge base",
+      "tool": "query",
+      "inputs": {
+        "query": "{{ inputs.question }}",
+        "collection": "{{ inputs.collection2 }}",
+        "limit": "{{ inputs.limit }}",
+        "rerank": false
+      }
+    },
+    {
+      "id": "skip_merge",
+      "name": "Pass primary results through",
+      "tool": "template",
+      "inputs": {
+        "text": "Using {{ search_primary.output.resultCount }} results from primary collection"
+      }
+    },
+    {
+      "id": "merge_results",
+      "name": "Merge results from all collections",
+      "tool": "merge",
+      "inputs": {
+        "arrays": [
+          "{{ search_primary.output.results }}",
+          "{{ search_secondary.output.results }}"
+        ],
+        "dedup": true,
+        "dedup_field": "source"
+      },
+      "condition": "{{ inputs.collection2.length > 0 }}"
+    },
+    {
+      "id": "rerank",
+      "name": "Rerank by relevance to question",
+      "tool": "rerank",
+      "inputs": {
+        "query": "{{ inputs.question }}",
+        "documents": "{{ merge_results.output.results || search_primary.output.results }}"
+      }
+    },
+    {
+      "id": "filter_relevant",
+      "name": "Filter out low-relevance documents",
+      "tool": "filter",
+      "inputs": {
+        "array": "{{ rerank.output.results }}",
+        "condition": "item.score >= {{ inputs.min_score }}"
+      }
+    },
+    {
+      "id": "check_context",
+      "name": "Check if any relevant context was found",
+      "tool": "conditional",
+      "inputs": {
+        "condition": "{{ filter_relevant.output.resultCount > 0 }}",
+        "then": ["build_prompt", "generate_answer"],
+        "else": ["no_context_response"]
+      }
+    },
+    {
+      "id": "build_prompt",
+      "name": "Assemble prompt with context and history",
+      "tool": "template",
+      "inputs": {
+        "text": "{{ inputs.chat_history ? 'Previous conversation:\\n' + inputs.chat_history + '\\n\\n' : '' }}Based on the following knowledge base documents, answer this question: {{ inputs.question }}"
+      }
+    },
+    {
+      "id": "generate_answer",
+      "name": "Generate grounded answer with LLM",
+      "tool": "generate",
+      "inputs": {
+        "prompt": "{{ build_prompt.output.text }}",
+        "context": "{{ filter_relevant.output.results }}",
+        "systemPrompt": "{{ inputs.system_prompt }}"
+      }
+    },
+    {
+      "id": "no_context_response",
+      "name": "Handle no relevant context found",
+      "tool": "template",
+      "inputs": {
+        "text": "I searched the knowledge base but didn't find documents relevant enough to answer your question confidently. The query '{{ inputs.question }}' returned {{ rerank.output.resultCount }} results, but none met the minimum relevance threshold of {{ inputs.min_score }}. Try rephrasing your question or lowering the min_score threshold."
+      }
+    }
+  ],
+  "output": {
+    "answer": "{{ generate_answer.output.text || no_context_response.output.text }}",
+    "sources": "{{ filter_relevant.output.results }}",
+    "sourceCount": "{{ filter_relevant.output.resultCount }}",
+    "model": "{{ generate_answer.output.model }}",
+    "question": "{{ inputs.question }}"
+  }
+}

package/src/workflows/tests/code-review.fresh-index.test.json

@@ -0,0 +1,83 @@
+{
+  "name": "code-review: fresh index required (no existing index)",
+  "inputs": {
+    "source": "https://github.com/mrlynn/voyageai-cli",
+    "code": "function generateEmbeddings(texts, model) { ... }",
+    "limit": 5
+  },
+  "mocks": {
+    "code_status": {
+      "totalChunks": 0,
+      "uniqueFiles": 0,
+      "languages": {},
+      "lastIndexed": null,
+      "indexes": []
+    },
+    "code_index": {
+      "source": "https://github.com/mrlynn/voyageai-cli",
+      "sourceType": "github",
+      "db": "vai_code_search",
+      "collection": "voyageai_cli_code",
+      "model": "voyage-code-3",
+      "filesFound": 89,
+      "filesIndexed": 89,
+      "chunksCreated": 642,
+      "totalTokens": 185000,
+      "errors": [],
+      "timeMs": 8400,
+      "refresh": true,
+      "indexName": "code_search_index"
+    },
+    "code_find_similar": {
+      "results": [
+        {
+          "source": "src/lib/api.js",
+          "language": "js",
+          "startLine": 45,
+          "endLine": 78,
+          "symbols": ["generateEmbeddings", "batchEmbed"],
+          "content": "async function generateEmbeddings(texts, model, opts) { ... }",
+          "score": 0.962,
+          "chunkType": "boundary"
+        }
+      ],
+      "metadata": {
+        "collection": "voyageai_cli_code",
+        "model": "voyage-code-3",
+        "resultCount": 1,
+        "timeMs": 145
+      }
+    },
+    "code_search": {
+      "results": [
+        {
+          "source": "src/lib/api.js",
+          "language": "js",
+          "startLine": 1,
+          "endLine": 30,
+          "symbols": ["apiRequest", "BASE_URL"],
+          "content": "const BASE_URL = process.env.VOYAGE_API_URL || 'https://ai.mongodb.com/v1/'; ...",
+          "score": 0.834
+        }
+      ],
+      "metadata": {
+        "collection": "voyageai_cli_code",
+        "model": "voyage-code-3",
+        "reranked": true,
+        "resultCount": 1,
+        "timeMs": 210
+      }
+    },
+    "code_query": null
+  },
+  "expect": {
+    "steps": {
+      "check_index": { "status": "completed" },
+      "index_codebase": { "status": "completed" },
+      "find_similar": { "status": "completed" },
+      "contextual_search": { "status": "completed" },
+      "deep_query": { "status": "skipped" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/code-review.happy-path.test.json

@@ -0,0 +1,121 @@
+{
+  "name": "code-review: find similar patterns with contextual search",
+  "inputs": {
+    "source": "/Users/dev/myapp",
+    "code": "async function retryWithBackoff(fn, maxRetries = 3) {\n  for (let i = 0; i < maxRetries; i++) {\n    try { return await fn(); }\n    catch (e) { if (i === maxRetries - 1) throw e; await sleep(Math.pow(2, i) * 1000); }\n  }\n}",
+    "question": "are there other retry or backoff implementations?",
+    "language": "js",
+    "limit": 5
+  },
+  "mocks": {
+    "code_status": {
+      "totalChunks": 1823,
+      "uniqueFiles": 247,
+      "collection": "myapp_code",
+      "languages": { "js": 180, "ts": 45, "json": 22 },
+      "lastIndexed": "2026-02-16T12:00:00.000Z",
+      "indexes": [{ "name": "code_search_index", "status": "READY" }]
+    },
+    "code_index": null,
+    "code_find_similar": {
+      "results": [
+        {
+          "source": "src/lib/http-client.js",
+          "language": "js",
+          "startLine": 88,
+          "endLine": 112,
+          "symbols": ["retryRequest", "exponentialDelay"],
+          "content": "async function retryRequest(url, opts, retries = 5) {\n  const exponentialDelay = (attempt) => Math.pow(2, attempt) * 500;\n  for (let attempt = 0; attempt < retries; attempt++) { ... }",
+          "score": 0.921,
+          "chunkType": "boundary"
+        },
+        {
+          "source": "src/lib/queue.js",
+          "language": "js",
+          "startLine": 34,
+          "endLine": 58,
+          "symbols": ["processWithRetry"],
+          "content": "async function processWithRetry(task, { maxAttempts = 3, backoff = 'exponential' }) { ... }",
+          "score": 0.867,
+          "chunkType": "boundary"
+        },
+        {
+          "source": "src/utils/resilience.js",
+          "language": "js",
+          "startLine": 1,
+          "endLine": 30,
+          "symbols": ["circuitBreaker", "withTimeout"],
+          "content": "function circuitBreaker(fn, { threshold = 5, resetMs = 30000 }) { ... }",
+          "score": 0.743,
+          "chunkType": "boundary"
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "resultCount": 3,
+        "timeMs": 187
+      }
+    },
+    "code_search": {
+      "results": [
+        {
+          "source": "src/lib/http-client.js",
+          "language": "js",
+          "startLine": 1,
+          "endLine": 25,
+          "symbols": ["createClient", "DEFAULT_TIMEOUT"],
+          "content": "const DEFAULT_TIMEOUT = 30000;\nfunction createClient(baseUrl, opts) { ... }",
+          "score": 0.856
+        },
+        {
+          "source": "docs/resilience.md",
+          "language": "md",
+          "startLine": 1,
+          "endLine": 40,
+          "symbols": [],
+          "content": "# Resilience Patterns\n\nThis project uses exponential backoff with jitter for all HTTP retries...",
+          "score": 0.812
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "rerankModel": "rerank-2.5",
+        "reranked": true,
+        "resultCount": 2,
+        "timeMs": 234
+      }
+    },
+    "code_query": {
+      "results": [
+        {
+          "source": "src/lib/http-client.js",
+          "language": "js",
+          "startLine": 88,
+          "endLine": 112,
+          "symbols": ["retryRequest", "exponentialDelay"],
+          "content": "async function retryRequest(url, opts, retries = 5) { ... }",
+          "score": 0.943
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "reranked": true,
+        "resultCount": 1,
+        "timeMs": 198
+      }
+    }
+  },
+  "expect": {
+    "steps": {
+      "check_index": { "status": "completed" },
+      "index_codebase": { "status": "skipped" },
+      "find_similar": { "status": "completed" },
+      "contextual_search": { "status": "completed" },
+      "deep_query": { "status": "completed" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/code-review.no-question.test.json

@@ -0,0 +1,70 @@
+{
+  "name": "code-review: no question — skip deep_query, auto-generate search from snippet",
+  "inputs": {
+    "source": "/Users/dev/myapp",
+    "code": "class DatabasePool {\n  constructor(uri, { maxSize = 10, idleTimeoutMs = 30000 }) {\n    this.pool = [];\n    this.maxSize = maxSize;\n  }\n  async acquire() { ... }\n  release(conn) { ... }\n}",
+    "limit": 3
+  },
+  "mocks": {
+    "code_status": {
+      "totalChunks": 500,
+      "uniqueFiles": 80,
+      "collection": "myapp_code",
+      "languages": { "js": 60, "ts": 20 },
+      "lastIndexed": "2026-02-16T10:00:00.000Z",
+      "indexes": [{ "name": "code_search_index", "status": "READY" }]
+    },
+    "code_index": null,
+    "code_find_similar": {
+      "results": [
+        {
+          "source": "src/lib/redis-pool.js",
+          "language": "js",
+          "startLine": 5,
+          "endLine": 45,
+          "symbols": ["RedisPool", "acquire", "release"],
+          "content": "class RedisPool { constructor(opts) { ... } async acquire() { ... } }",
+          "score": 0.889,
+          "chunkType": "boundary"
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "resultCount": 1,
+        "timeMs": 156
+      }
+    },
+    "code_search": {
+      "results": [
+        {
+          "source": "src/lib/mongo.js",
+          "language": "js",
+          "startLine": 12,
+          "endLine": 50,
+          "symbols": ["getMongoCollection", "closeClient"],
+          "content": "async function getMongoCollection(db, collection) { ... }",
+          "score": 0.801
+        }
+      ],
+      "metadata": {
+        "collection": "myapp_code",
+        "model": "voyage-code-3",
+        "reranked": true,
+        "resultCount": 1,
+        "timeMs": 189
+      }
+    },
+    "code_query": null
+  },
+  "expect": {
+    "steps": {
+      "check_index": { "status": "completed" },
+      "index_codebase": { "status": "skipped" },
+      "find_similar": { "status": "completed" },
+      "contextual_search": { "status": "completed" },
+      "deep_query": { "status": "skipped" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/consistency-check.happy-path.test.json

@@ -0,0 +1,28 @@
+{
+  "name": "consistency-check: happy path (both sources have results)",
+  "inputs": {
+    "topic": "authentication best practices",
+    "collection1": "api_docs",
+    "collection2": "tutorials"
+  },
+  "mocks": {
+    "query": {
+      "results": [
+        { "text": "Use OAuth2 for API authentication", "score": 0.92, "source": "auth.md" }
+      ],
+      "resultCount": 1
+    },
+    "similarity": {
+      "similarity": 0.87,
+      "model": "voyage-4-large"
+    }
+  },
+  "expect": {
+    "steps": {
+      "search_source_a": { "status": "completed" },
+      "search_source_b": { "status": "completed" },
+      "compare": { "status": "completed" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/consistency-check.missing-source.test.json

@@ -0,0 +1,26 @@
+{
+  "name": "consistency-check: one source empty (comparison skipped)",
+  "inputs": {
+    "topic": "obscure topic",
+    "collection1": "api_docs",
+    "collection2": "tutorials"
+  },
+  "mocks": {
+    "query": {
+      "results": [],
+      "resultCount": 0
+    },
+    "similarity": {
+      "similarity": 0.0,
+      "model": "voyage-4-large"
+    }
+  },
+  "expect": {
+    "steps": {
+      "search_source_a": { "status": "completed" },
+      "search_source_b": { "status": "completed" },
+      "compare": { "status": "skipped" }
+    },
+    "noErrors": true
+  }
+}

package/src/workflows/tests/cost-analysis.happy-path.test.json

@@ -0,0 +1,28 @@
+{
+  "name": "cost-analysis: happy path",
+  "inputs": {
+    "docs": 10000,
+    "queries": 5000,
+    "months": 12
+  },
+  "mocks": {
+    "estimate": {
+      "model": "voyage-4-large",
+      "embeddingCost": 12.50,
+      "queryCost": 8.25,
+      "totalCost": 20.75,
+      "currency": "USD"
+    }
+  },
+  "expect": {
+    "steps": {
+      "cost_large": { "status": "completed" },
+      "cost_balanced": { "status": "completed" },
+      "cost_lite": { "status": "completed" }
+    },
+    "output": {
+      "comparison": { "type": "array", "minLength": 3 }
+    },
+    "noErrors": true
+  }
+}