@juspay/neurolink 8.26.0 → 8.26.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.26.1](https://github.com/juspay/neurolink/compare/v8.26.0...v8.26.1) (2025-12-31)
+
+### Bug Fixes
+
+- **(providers):** resolve Gemini 3 issues, add utilities, improve tests ([270ef6f](https://github.com/juspay/neurolink/commit/270ef6f225e7861846cf359f2d81edae38592053))
+
 ## [8.26.0](https://github.com/juspay/neurolink/compare/v8.25.0...v8.26.0) (2025-12-30)
 
 ### Features

package/README.md

@@ -25,6 +25,7 @@ Extracted from production systems at Juspay and battle-tested at enterprise scal
 
 ## What's New (Q4 2025)
 
+- 🧠 **Gemini 3 Preview Support** - Full support for gemini-3-flash-preview and gemini-3-pro-preview with extended thinking capabilities
 - **Structured Output with Zod Schemas** – Type-safe JSON generation with automatic validation using `schema` + `output.format: "json"` in `generate()`. → [Structured Output Guide](docs/features/structured-output.md)
 - **CSV File Support** – Attach CSV files to prompts for AI-powered data analysis with auto-detection. → [CSV Guide](docs/features/multimodal-chat.md#csv-file-support)
 - **PDF File Support** – Process PDF documents with native visual analysis for Vertex AI, Anthropic, Bedrock, AI Studio. → [PDF Guide](docs/features/pdf-support.md)
@@ -58,21 +59,21 @@ NeuroLink is a comprehensive AI development platform. Every feature below is pro
 
 **13 providers unified under one API** - Switch providers with a single parameter change.
 
-| Provider              | Models                         | Free Tier       | Tool Support | Status        | Documentation                                                           |
-| --------------------- | ------------------------------ | --------------- | ------------ | ------------- | ----------------------------------------------------------------------- |
-| **OpenAI**            | GPT-4o, GPT-4o-mini, o1        | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openai)            |
-| **Anthropic**         | Claude 3.5/3.7 Sonnet, Opus    | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#anthropic)         |
-| **Google AI Studio**  | Gemini 2.5 Flash/Pro           | ✅ Free Tier    | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#google-ai)         |
-| **AWS Bedrock**       | Claude, Titan, Llama, Nova     | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#bedrock)           |
-| **Google Vertex**     | Gemini via GCP                 | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#vertex)            |
-| **Azure OpenAI**      | GPT-4, GPT-4o, o1              | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#azure)             |
-| **LiteLLM**           | 100+ models unified            | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/LITELLM-INTEGRATION.md)                              |
-| **OpenRouter**        | 300+ models unified            | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openrouter)        |
-| **AWS SageMaker**     | Custom deployed models         | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/SAGEMAKER-INTEGRATION.md)                            |
-| **Mistral AI**        | Mistral Large, Small           | ✅ Free Tier    | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#mistral)           |
-| **Hugging Face**      | 100,000+ models                | ✅ Free         | ⚠️ Partial   | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#huggingface)       |
-| **Ollama**            | Local models (Llama, Mistral)  | ✅ Free (Local) | ⚠️ Partial   | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#ollama)            |
-| **OpenAI Compatible** | Any OpenAI-compatible endpoint | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openai-compatible) |
+| Provider              | Models                             | Free Tier       | Tool Support | Status        | Documentation                                                           |
+| --------------------- | ---------------------------------- | --------------- | ------------ | ------------- | ----------------------------------------------------------------------- |
+| **OpenAI**            | GPT-4o, GPT-4o-mini, o1            | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openai)            |
+| **Anthropic**         | Claude 3.5/3.7 Sonnet, Opus        | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#anthropic)         |
+| **Google AI Studio**  | Gemini 2.5 Flash/Pro               | ✅ Free Tier    | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#google-ai)         |
+| **AWS Bedrock**       | Claude, Titan, Llama, Nova         | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#bedrock)           |
+| **Google Vertex**     | Gemini 3/2.5 (gemini-3-\*-preview) | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#vertex)            |
+| **Azure OpenAI**      | GPT-4, GPT-4o, o1                  | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#azure)             |
+| **LiteLLM**           | 100+ models unified                | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/LITELLM-INTEGRATION.md)                              |
+| **OpenRouter**        | 300+ models unified                | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openrouter)        |
+| **AWS SageMaker**     | Custom deployed models             | ❌              | ✅ Full      | ✅ Production | [Setup Guide](docs/SAGEMAKER-INTEGRATION.md)                            |
+| **Mistral AI**        | Mistral Large, Small               | ✅ Free Tier    | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#mistral)           |
+| **Hugging Face**      | 100,000+ models                    | ✅ Free         | ⚠️ Partial   | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#huggingface)       |
+| **Ollama**            | Local models (Llama, Mistral)      | ✅ Free (Local) | ⚠️ Partial   | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#ollama)            |
+| **OpenAI Compatible** | Any OpenAI-compatible endpoint     | Varies          | ✅ Full      | ✅ Production | [Setup Guide](docs/getting-started/provider-setup.md#openai-compatible) |
 
 **[📖 Provider Comparison Guide](docs/reference/provider-comparison.md)** - Detailed feature matrix and selection criteria
 **[🔬 Provider Feature Compatibility](docs/reference/provider-feature-compatibility.md)** - Test-based compatibility reference for all 19 features across 11 providers
@@ -117,16 +118,17 @@ const result = await neurolink.generate({
 
 **SDK-First Design** with TypeScript, IntelliSense, and type safety:
 
-| Feature                     | Description                    | Documentation                                         |
-| --------------------------- | ------------------------------ | ----------------------------------------------------- |
-| **Auto Provider Selection** | Intelligent provider fallback  | [SDK Guide](docs/sdk/index.md#auto-selection)         |
-| **Streaming Responses**     | Real-time token streaming      | [Streaming Guide](docs/advanced/streaming.md)         |
-| **Conversation Memory**     | Automatic context management   | [Memory Guide](docs/sdk/index.md#memory)              |
-| **Full Type Safety**        | Complete TypeScript types      | [Type Reference](docs/sdk/api-reference.md)           |
-| **Error Handling**          | Graceful provider fallback     | [Error Guide](docs/reference/troubleshooting.md)      |
-| **Analytics & Evaluation**  | Usage tracking, quality scores | [Analytics Guide](docs/advanced/analytics.md)         |
-| **Middleware System**       | Request/response hooks         | [Middleware Guide](docs/CUSTOM-MIDDLEWARE-GUIDE.md)   |
-| **Framework Integration**   | Next.js, SvelteKit, Express    | [Framework Guides](docs/sdk/framework-integration.md) |
+| Feature                     | Description                                                   | Documentation                                             |
+| --------------------------- | ------------------------------------------------------------- | --------------------------------------------------------- |
+| **Auto Provider Selection** | Intelligent provider fallback                                 | [SDK Guide](docs/sdk/index.md#auto-selection)             |
+| **Streaming Responses**     | Real-time token streaming                                     | [Streaming Guide](docs/advanced/streaming.md)             |
+| **Conversation Memory**     | Automatic context management                                  | [Memory Guide](docs/sdk/index.md#memory)                  |
+| **Full Type Safety**        | Complete TypeScript types                                     | [Type Reference](docs/sdk/api-reference.md)               |
+| **Error Handling**          | Graceful provider fallback                                    | [Error Guide](docs/reference/troubleshooting.md)          |
+| **Analytics & Evaluation**  | Usage tracking, quality scores                                | [Analytics Guide](docs/advanced/analytics.md)             |
+| **Middleware System**       | Request/response hooks                                        | [Middleware Guide](docs/CUSTOM-MIDDLEWARE-GUIDE.md)       |
+| **Framework Integration**   | Next.js, SvelteKit, Express                                   | [Framework Guides](docs/sdk/framework-integration.md)     |
+| **Extended Thinking**       | Native thinking/reasoning mode for Gemini 3 and Claude models | [Thinking Guide](docs/features/thinking-configuration.md) |
 
 ---
 
@@ -293,6 +295,26 @@ console.log(result.content);
 console.log(result.evaluation?.overallScore);
 ```
 
+### Gemini 3 with Extended Thinking
+
+```typescript
+import { NeuroLink } from "@juspay/neurolink";
+
+const neurolink = new NeuroLink();
+
+// Use Gemini 3 with extended thinking for complex reasoning
+const result = await neurolink.generate({
+  input: {
+    text: "Solve this step by step: What is the optimal strategy for...",
+  },
+  provider: "vertex",
+  model: "gemini-3-flash-preview",
+  thinkingLevel: "medium", // Options: "minimal", "low", "medium", "high"
+});
+
+console.log(result.content);
+```
+
 Full command and API breakdown lives in [`docs/cli/commands.md`](docs/cli/commands.md) and [`docs/sdk/api-reference.md`](docs/sdk/api-reference.md).
 
 ## Platform Capabilities at a Glance

package/dist/adapters/providerImageAdapter.js

@@ -77,6 +77,10 @@ const VISION_CAPABILITIES = {
         "gemini-3-pro-preview-11-2025",
         "gemini-3-pro-latest",
         "gemini-3-pro-image-preview",
+        // Gemini 3 Flash Series
+        "gemini-3-flash",
+        "gemini-3-flash-preview",
+        "gemini-3-flash-latest",
         // Gemini 2.5 Series
         "gemini-2.5-pro",
         "gemini-2.5-flash",
@@ -151,6 +155,10 @@ const VISION_CAPABILITIES = {
         "gemini-3-pro-latest",
         "gemini-3-pro-preview",
         "gemini-3-pro",
+        // Gemini 3 Flash Series on Vertex AI
+        "gemini-3-flash",
+        "gemini-3-flash-preview",
+        "gemini-3-flash-latest",
         // Gemini 2.5 models on Vertex AI
         "gemini-2.5-pro",
         "gemini-2.5-flash",
@@ -226,6 +234,9 @@ const VISION_CAPABILITIES = {
         "gemini/gemini-2.0-flash",
         "gemini-3-pro-preview",
         "gemini-3-pro-latest",
+        "gemini-3-flash",
+        "gemini-3-flash-preview",
+        "gemini-3-flash-latest",
         "gemini-2.5-pro",
         "gemini-2.5-flash",
         "gemini-2.0-flash-lite",

package/dist/cli/commands/config.js

@@ -13,6 +13,8 @@ import chalk from "chalk";
 import { z } from "zod";
 import { CLI_LIMITS } from "../../lib/core/constants.js";
 import { logger } from "../../lib/utils/logger.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 // Configuration schema for validation
 const ConfigSchema = z.object({
     defaultProvider: z
@@ -52,7 +54,7 @@ const ConfigSchema = z.object({
         vertex: z
             .object({
             projectId: z.string().optional(),
-            location: z.string().default("us-east5"),
+            location: z.string().default("us-central1"),
             credentials: z.string().optional(),
             serviceAccountKey: z.string().optional(),
             clientEmail: z.string().optional(),
@@ -406,6 +408,7 @@ export class ConfigManager {
      * OpenAI provider setup
      */
     async setupOpenAI() {
+        const modelChoices = getTopModelChoices(AIProviderName.OPENAI, 5).filter((c) => c.value !== "custom");
         const answers = await inquirer.prompt([
             {
                 type: "password",
@@ -417,8 +420,7 @@ export class ConfigManager {
                 type: "list",
                 name: "model",
                 message: "Default model:",
-                choices: ["gpt-4", "gpt-4-turbo", "gpt-3.5-turbo"],
-                default: "gpt-4",
+                choices: modelChoices,
             },
             {
                 type: "input",
@@ -492,6 +494,7 @@ export class ConfigManager {
                 ],
             },
         ]);
+        const vertexModelChoices = getTopModelChoices(AIProviderName.VERTEX, 5).filter((c) => c.value !== "custom");
         const commonAnswers = await inquirer.prompt([
             {
                 type: "input",
@@ -503,14 +506,13 @@ export class ConfigManager {
                 type: "input",
                 name: "location",
                 message: "Vertex AI Location:",
-                default: "us-east5",
+                default: "us-central1",
             },
             {
                 type: "list",
                 name: "model",
                 message: "Default model:",
-                choices: ["gemini-2.5-pro", "gemini-2.5-flash", "gemini-pro"],
-                default: "gemini-2.5-pro",
+                choices: vertexModelChoices,
             },
         ]);
         let authConfig = {};
@@ -579,6 +581,7 @@ export class ConfigManager {
      * Anthropic provider setup
      */
     async setupAnthropic() {
+        const anthropicModelChoices = getTopModelChoices(AIProviderName.ANTHROPIC, 5).filter((c) => c.value !== "custom");
         const answers = await inquirer.prompt([
             {
                 type: "password",
@@ -590,12 +593,7 @@ export class ConfigManager {
                 type: "list",
                 name: "model",
                 message: "Default model:",
-                choices: [
-                    "claude-3-5-sonnet-20241022",
-                    "claude-3-5-haiku-20241022",
-                    "claude-3-opus-20240229",
-                ],
-                default: "claude-3-5-sonnet-20241022",
+                choices: anthropicModelChoices,
             },
         ]);
         this.config.providers.anthropic = answers;
@@ -604,6 +602,7 @@ export class ConfigManager {
      * Azure OpenAI provider setup
      */
     async setupAzure() {
+        const azureModelChoices = getTopModelChoices(AIProviderName.AZURE, 5).filter((c) => c.value !== "custom");
         const answers = await inquirer.prompt([
             {
                 type: "password",
@@ -625,8 +624,7 @@ export class ConfigManager {
                 type: "list",
                 name: "model",
                 message: "Model:",
-                choices: ["gpt-4", "gpt-4-turbo", "gpt-35-turbo"],
-                default: "gpt-4",
+                choices: azureModelChoices,
             },
         ]);
         this.config.providers.azure = answers;
@@ -635,6 +633,7 @@ export class ConfigManager {
      * Google AI Studio provider setup
      */
     async setupGoogleAI() {
+        const googleAIModelChoices = getTopModelChoices(AIProviderName.GOOGLE_AI, 5).filter((c) => c.value !== "custom");
         const answers = await inquirer.prompt([
             {
                 type: "password",
@@ -646,8 +645,7 @@ export class ConfigManager {
                 type: "list",
                 name: "model",
                 message: "Default model:",
-                choices: ["gemini-2.5-pro", "gemini-2.5-flash"],
-                default: "gemini-2.5-pro",
+                choices: googleAIModelChoices,
             },
         ]);
         this.config.providers["google-ai"] = answers;
@@ -704,6 +702,7 @@ export class ConfigManager {
      * Mistral AI provider setup
      */
     async setupMistral() {
+        const mistralModelChoices = getTopModelChoices(AIProviderName.MISTRAL, 5).filter((c) => c.value !== "custom");
         const answers = await inquirer.prompt([
             {
                 type: "password",
@@ -715,13 +714,7 @@ export class ConfigManager {
                 type: "list",
                 name: "model",
                 message: "Default model:",
-                choices: [
-                    "mistral-small",
-                    "mistral-medium",
-                    "mistral-large",
-                    "mistral-tiny",
-                ],
-                default: "mistral-small",
+                choices: mistralModelChoices,
             },
         ]);
         this.config.providers.mistral = answers;

package/dist/cli/commands/setup-anthropic.js

@@ -14,6 +14,8 @@ import inquirer from "inquirer";
 import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 export async function handleAnthropicSetup(argv) {
     try {
         const options = {
@@ -266,32 +268,7 @@ async function promptForModel() {
             type: "list",
             name: "modelChoice",
             message: "Select an Anthropic Claude model:",
-            choices: [
-                {
-                    name: "claude-3-5-sonnet-20241022 (Recommended - Latest and most capable)",
-                    value: "claude-3-5-sonnet-20241022",
-                },
-                {
-                    name: "claude-3-5-haiku-20241022 (Fast and cost-effective)",
-                    value: "claude-3-5-haiku-20241022",
-                },
-                {
-                    name: "claude-3-opus-20240229 (Most powerful, slower)",
-                    value: "claude-3-opus-20240229",
-                },
-                {
-                    name: "claude-3-sonnet-20240229 (Balanced performance)",
-                    value: "claude-3-sonnet-20240229",
-                },
-                {
-                    name: "claude-3-haiku-20240307 (Fast and economical)",
-                    value: "claude-3-haiku-20240307",
-                },
-                {
-                    name: "Custom model (enter manually)",
-                    value: "custom",
-                },
-            ],
+            choices: getTopModelChoices(AIProviderName.ANTHROPIC, 5),
         },
     ]);
     if (modelChoice === "custom") {

package/dist/cli/commands/setup-azure.js

@@ -14,6 +14,8 @@ import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { updateEnvFile as updateEnvFileShared, displayEnvUpdateSummary, } from "../utils/envManager.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 export async function handleAzureSetup(argv) {
     try {
         const options = {
@@ -315,28 +317,7 @@ async function promptForModel() {
             type: "list",
             name: "modelChoice",
             message: "Select an Azure OpenAI model:",
-            choices: [
-                {
-                    name: "gpt-4o (Latest multimodal model)",
-                    value: "gpt-4o",
-                },
-                {
-                    name: "gpt-4o-mini (Cost-effective)",
-                    value: "gpt-4o-mini",
-                },
-                {
-                    name: "gpt-4-turbo (Previous generation)",
-                    value: "gpt-4-turbo",
-                },
-                {
-                    name: "gpt-35-turbo (Legacy, most cost-effective)",
-                    value: "gpt-35-turbo",
-                },
-                {
-                    name: "Custom deployment name (enter manually)",
-                    value: "custom",
-                },
-            ],
+            choices: getTopModelChoices(AIProviderName.AZURE, 5),
         },
     ]);
     if (modelChoice === "custom") {

package/dist/cli/commands/setup-bedrock.js

@@ -13,6 +13,8 @@ import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { updateEnvFile as envUpdate } from "../utils/envManager.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 export async function handleBedrockSetup(argv) {
     try {
         const options = {
@@ -375,32 +377,7 @@ async function handleModelSelection(config) {
                 type: "list",
                 name: "model",
                 message: "Select a Bedrock model:",
-                choices: [
-                    {
-                        name: "Claude 3.7 Sonnet (Recommended - Latest)",
-                        value: "arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0",
-                    },
-                    {
-                        name: "Claude 3.5 Sonnet v2",
-                        value: "anthropic.claude-3-5-sonnet-20241022-v2:0",
-                    },
-                    {
-                        name: "Claude 3 Sonnet",
-                        value: "anthropic.claude-3-sonnet-20240229-v1:0",
-                    },
-                    {
-                        name: "Claude 3 Haiku",
-                        value: "anthropic.claude-3-haiku-20240307-v1:0",
-                    },
-                    {
-                        name: "Claude 3 Opus",
-                        value: "anthropic.claude-3-opus-20240229-v1:0",
-                    },
-                    {
-                        name: "Custom model (enter manually)",
-                        value: "custom",
-                    },
-                ],
+                choices: getTopModelChoices(AIProviderName.BEDROCK, 5),
             },
         ]);
         if (model === "custom") {

package/dist/cli/commands/setup-google-ai.js

@@ -15,6 +15,8 @@ import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
 import { GoogleAIModels } from "../../lib/constants/enums.js";
 import { updateEnvFile as updateEnvFileManager, displayEnvUpdateSummary, } from "../utils/envManager.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 /**
  * Get the runtime default model that matches the provider implementation
  */
@@ -267,28 +269,7 @@ async function promptForModel() {
             type: "list",
             name: "modelChoice",
             message: "Select a Google AI model:",
-            choices: [
-                {
-                    name: "gemini-2.5-pro (Recommended - Latest high-capability model)",
-                    value: "gemini-2.5-pro",
-                },
-                {
-                    name: "gemini-2.5-flash (Fast and efficient)",
-                    value: "gemini-2.5-flash",
-                },
-                {
-                    name: "gemini-pro-vision (Multimodal - text and images)",
-                    value: "gemini-pro-vision",
-                },
-                {
-                    name: "gemini-pro (Previous generation)",
-                    value: "gemini-pro",
-                },
-                {
-                    name: "Custom model (enter manually)",
-                    value: "custom",
-                },
-            ],
+            choices: getTopModelChoices(AIProviderName.GOOGLE_AI, 5),
         },
     ]);
     if (modelChoice === "custom") {

package/dist/cli/commands/setup-mistral.js

@@ -4,6 +4,8 @@ import inquirer from "inquirer";
 import fs from "fs";
 import path from "path";
 import { logger } from "../../lib/utils/logger.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 /**
  * Validates Mistral API key format
  * Mistral keys typically start with "sk-" and contain base62 plus "-" or "_".
@@ -141,37 +143,7 @@ export const handleMistralSetup = async (argv) => {
                 type: "list",
                 name: "modelChoice",
                 message: "Select a Mistral model:",
-                choices: [
-                    {
-                        name: "mistral-small (Balanced performance - Recommended)",
-                        value: "mistral-small",
-                    },
-                    {
-                        name: "mistral-tiny (Fastest, most cost-effective)",
-                        value: "mistral-tiny",
-                    },
-                    {
-                        name: "mistral-medium (Enhanced capabilities)",
-                        value: "mistral-medium",
-                    },
-                    {
-                        name: "mistral-large (Most capable model)",
-                        value: "mistral-large",
-                    },
-                    {
-                        name: "open-mistral-7b (Open source model)",
-                        value: "open-mistral-7b",
-                    },
-                    {
-                        name: "open-mixtral-8x7b (Open source mixture of experts)",
-                        value: "open-mixtral-8x7b",
-                    },
-                    {
-                        name: "Custom model name",
-                        value: "custom",
-                    },
-                ],
-                default: "mistral-small",
+                choices: getTopModelChoices(AIProviderName.MISTRAL, 5),
             },
         ]);
         let selectedModel = modelChoice;

package/dist/cli/commands/setup-openai.js

@@ -14,6 +14,8 @@ import inquirer from "inquirer";
 import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../../lib/utils/logger.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 export async function handleOpenAISetup(argv) {
     try {
         const options = {
@@ -259,28 +261,7 @@ async function promptForModel() {
             type: "list",
             name: "modelChoice",
             message: "Select an OpenAI model:",
-            choices: [
-                {
-                    name: "gpt-4o (Recommended - Latest multimodal model)",
-                    value: "gpt-4o",
-                },
-                {
-                    name: "gpt-4o-mini (Cost-effective, fast)",
-                    value: "gpt-4o-mini",
-                },
-                {
-                    name: "gpt-4-turbo (Previous generation)",
-                    value: "gpt-4-turbo",
-                },
-                {
-                    name: "gpt-3.5-turbo (Legacy, most cost-effective)",
-                    value: "gpt-3.5-turbo",
-                },
-                {
-                    name: "Custom model (enter manually)",
-                    value: "custom",
-                },
-            ],
+            choices: getTopModelChoices(AIProviderName.OPENAI, 5),
         },
     ]);
     if (modelChoice === "custom") {

package/dist/cli/factories/commandFactory.js

@@ -2,6 +2,7 @@ import { globalSession } from "../../lib/session/globalSessionState.js";
 import { configManager } from "../commands/config.js";
 import { handleError } from "../errorHandler.js";
 import { normalizeEvaluationData } from "../../lib/utils/evaluationUtils.js";
+import { createThinkingConfigFromRecord } from "../../lib/utils/thinkingConfig.js";
 import { LoopSession } from "../loop/session.js";
 import { initializeCliParser } from "../parser.js";
 // Use TokenUsage from standard types - no local interface needed
@@ -258,6 +259,27 @@ export class CLICommandFactory {
             default: false,
             description: "Auto-play generated audio",
         },
+        thinking: {
+            alias: "think",
+            type: "boolean",
+            description: "Enable extended thinking/reasoning capability",
+            default: false,
+        },
+        thinkingBudget: {
+            type: "number",
+            description: "Token budget for extended thinking - Anthropic Claude and Gemini 2.5+ models (5000-100000)",
+            default: 10000,
+        },
+        thinkingLevel: {
+            type: "string",
+            description: "Thinking level for Gemini 3 models: minimal, low, medium, high",
+            choices: ["minimal", "low", "medium", "high"],
+        },
+        region: {
+            type: "string",
+            description: "Vertex AI region (e.g., us-central1, europe-west1, asia-northeast1)",
+            alias: "r",
+        },
     };
     // Helper method to build options for commands
     static buildOptions(yargs, additionalOptions = {}) {
@@ -381,6 +403,12 @@ export class CLICommandFactory {
             ttsQuality: argv.ttsQuality,
             ttsOutput: argv.ttsOutput,
             ttsPlay: argv.ttsPlay,
+            // Extended thinking options for Claude and Gemini models
+            thinking: argv.thinking,
+            thinkingBudget: argv.thinkingBudget,
+            thinkingLevel: argv.thinkingLevel,
+            // Region option for cloud providers (Vertex AI, Bedrock, etc.)
+            region: argv.region,
         };
     }
     // Helper method to handle output
@@ -1233,6 +1261,8 @@ export class CLICommandFactory {
                 evaluationDomain: enhancedOptions.evaluationDomain,
                 toolUsageContext: enhancedOptions.toolUsageContext,
                 context: context,
+                region: options.region,
+                thinkingConfig: createThinkingConfigFromRecord(options),
                 factoryConfig: enhancedOptions.domain
                     ? {
                         domainType: enhancedOptions.domain,
@@ -1429,6 +1459,8 @@ export class CLICommandFactory {
             evaluationDomain: enhancedOptions.evaluationDomain,
             toolUsageContext: enhancedOptions.toolUsageContext,
             context: context,
+            region: options.region,
+            thinkingConfig: createThinkingConfigFromRecord(options),
             factoryConfig: enhancedOptions.domain
                 ? {
                     domainType: enhancedOptions.domain,

package/dist/cli/factories/ollamaCommandFactory.js

@@ -4,6 +4,8 @@ import ora from "ora";
 import inquirer from "inquirer";
 import { logger } from "../../lib/utils/logger.js";
 import { OllamaUtils } from "../utils/ollamaUtils.js";
+import { getTopModelChoices } from "../../lib/utils/modelChoices.js";
+import { AIProviderName } from "../../lib/types/index.js";
 /**
  * Factory for creating Ollama CLI commands using the Factory Pattern
  */
@@ -330,23 +332,9 @@ export class OllamaCommandFactory {
                         type: "list",
                         name: "selectedModel",
                         message: "Select a model to download:",
-                        choices: [
-                            {
-                                name: "llama2 (7B) - Recommended for general use",
-                                value: "llama2",
-                            },
-                            {
-                                name: "codellama (7B) - Best for code generation",
-                                value: "codellama",
-                            },
-                            { name: "mistral (7B) - Fast and efficient", value: "mistral" },
-                            {
-                                name: "tinyllama (1B) - Lightweight, fast",
-                                value: "tinyllama",
-                            },
-                            { name: "phi (2.7B) - Microsoft's compact model", value: "phi" },
-                            { name: "Other (enter manually)", value: "other" },
-                        ],
+                        choices: getTopModelChoices(AIProviderName.OLLAMA, 5).map((choice) => choice.value === "custom"
+                            ? { name: "Other (enter manually)", value: "other" }
+                            : choice),
                     },
                 ]);
                 let modelToDownload = selectedModel;

package/dist/cli/loop/optionsSchema.d.ts

@@ -5,4 +5,4 @@ import type { OptionSchema } from "../../lib/types/cli.js";
  * This object provides metadata for validation and help text in the CLI loop.
  * It is derived from the main TextGenerationOptions interface to ensure consistency.
  */
-export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region" | "csvOptions" | "tts">, OptionSchema>;
+export declare const textGenerationOptionsSchema: Record<keyof Omit<TextGenerationOptions, "prompt" | "input" | "schema" | "tools" | "context" | "conversationHistory" | "conversationMessages" | "conversationMemoryConfig" | "originalPrompt" | "middleware" | "expectedOutcome" | "evaluationCriteria" | "region" | "csvOptions" | "tts" | "thinkingConfig">, OptionSchema>;