@revenium/perplexity 1.0.23 → 1.0.25

package/examples/v2/basic.ts

@@ -0,0 +1,49 @@
+import { PerplexityV2Controller } from "../../src/index";
+
+const basicV2Example = async () => {
+  console.log("=".repeat(50));
+  console.log(
+    "🚀 Perplexity V2 Basic Example (Enhanced Response Format - OpenAI Responses API)"
+  );
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV2Controller();
+
+    // Basic chat completion with V2 enhanced response
+    const result = await controller.createChat([
+      "What is artificial intelligence and how does it work?",
+    ]);
+
+    console.log("📝 Response:");
+    console.log(result.choices[0].message.content);
+
+    console.log("\n📊 Enhanced Usage Info (V2):");
+    console.log(`Prompt tokens: ${result.usage.prompt_tokens}`);
+    console.log(`Completion tokens: ${result.usage.completion_tokens}`);
+    console.log(`Total tokens: ${result.usage.total_tokens}`);
+
+    console.log("\n🔧 Enhanced Metadata (V2):");
+    console.log(`ID: ${result.id}`);
+    console.log(`Object: ${result.object}`);
+    console.log(`Created: ${new Date(result.created * 1000).toISOString()}`);
+    console.log(`Model: ${result.model}`);
+    console.log(`Transaction ID: ${result.metadata.transactionId}`);
+    console.log(`Processing Time: ${result.metadata.processingTime}ms`);
+    console.log(`Version: ${result.metadata.version}`);
+
+    // Test V2 enhanced features
+    console.log("\n🎯 V2 Enhanced Features:");
+    const modelInfo = controller.getModelInfo("sonar-pro");
+    console.log(`Enhanced Model Info:`, modelInfo);
+
+    const recommendation = controller.getRecommendedModel("online-search");
+    console.log(
+      `Recommended for online search: ${recommendation.model} - ${recommendation.reason}`
+    );
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+basicV2Example();

package/examples/v2/chat.ts

@@ -0,0 +1,60 @@
+import { PerplexityV2Controller } from "../../src/index";
+
+const chatV2Example = async () => {
+  console.log("=".repeat(50));
+  console.log("💬 Perplexity V2 Enhanced Chat Example (OpenAI Responses API)");
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV2Controller();
+
+    // Multi-turn conversation with V2 enhanced features
+    const messages = [
+      { role: "user", content: "What are the latest developments in renewable energy technology?" },
+      { role: "assistant", content: "Recent developments include improved solar panel efficiency, advanced battery storage systems, and offshore wind technology innovations." },
+      { role: "user", content: "Tell me more about the battery storage improvements" }
+    ];
+
+    const result = await controller.createChat(messages, "sonar-pro");
+
+    console.log("📝 V2 Enhanced Chat Response:");
+    console.log(result.choices[0].message.content);
+    
+    console.log("\n📊 V2 Enhanced Usage Statistics:");
+    console.log(`Prompt tokens: ${result.usage.prompt_tokens}`);
+    console.log(`Completion tokens: ${result.usage.completion_tokens}`);
+    console.log(`Total tokens: ${result.usage.total_tokens}`);
+    
+    console.log("\n🔧 V2 Enhanced Response Metadata:");
+    console.log(`ID: ${result.id}`);
+    console.log(`Object: ${result.object}`);
+    console.log(`Created: ${new Date(result.created * 1000).toISOString()}`);
+    console.log(`Model: ${result.model}`);
+    console.log(`Finish Reason: ${result.choices[0].finish_reason}`);
+    console.log(`Processing Time: ${result.metadata.processingTime}ms`);
+    console.log(`Transaction ID: ${result.metadata.transactionId}`);
+    console.log(`Version: ${result.metadata.version}`);
+
+    // V2 Enhanced Features
+    console.log("\n🚀 V2 Enhanced Model Features:");
+    const modelInfo = controller.getModelInfo("sonar-pro");
+    console.log(`Enhanced: ${modelInfo.enhanced}`);
+    console.log(`Response Format: ${modelInfo.responseFormat}`);
+    
+    const performance = controller.getModelPerformance("sonar-pro");
+    console.log(`Estimated Latency: ${performance.estimatedLatency}`);
+    console.log(`Cost Tier: ${performance.costTier}`);
+
+    // Model recommendations
+    console.log("\n🎯 V2 Model Recommendations:");
+    const onlineRec = controller.getRecommendedModel("online-search");
+    const offlineRec = controller.getRecommendedModel("offline-chat");
+    console.log(`For online search: ${onlineRec.model} - ${onlineRec.reason}`);
+    console.log(`For offline chat: ${offlineRec.model} - ${offlineRec.reason}`);
+
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+chatV2Example();

package/examples/v2/metadata.ts

@@ -0,0 +1,71 @@
+import { PerplexityV2Controller, IUsageMetadata } from "../../src/index";
+
+const metadataV2Example = async () => {
+  console.log("=".repeat(50));
+  console.log("📊 Perplexity V2 Enhanced Metadata Example (OpenAI Responses API)");
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV2Controller();
+
+    // Enhanced custom metadata for V2
+    const customMetadata: IUsageMetadata = {
+      traceId: "trace-v2-67890",
+      taskType: "advanced-research",
+      subscriberEmail: "researcher@example.com",
+      subscriberId: "user-v2-123",
+      organizationId: "org-v2-456",
+      agent: "perplexity-v2-enhanced",
+      responseQualityScore: 0.95,
+      operationType: "chat-completion",
+    };
+
+    const result = await controller.createChat([
+      "Provide a comprehensive analysis of the impact of artificial intelligence on modern healthcare systems"
+    ], "sonar-pro", customMetadata);
+
+    console.log("📝 V2 Enhanced Response:");
+    console.log(result.choices[0].message.content);
+    
+    console.log("\n📊 V2 Enhanced Usage Statistics:");
+    console.log(`Prompt tokens: ${result.usage.prompt_tokens}`);
+    console.log(`Completion tokens: ${result.usage.completion_tokens}`);
+    console.log(`Total tokens: ${result.usage.total_tokens}`);
+    
+    console.log("\n🔧 V2 Enhanced Response Structure:");
+    console.log(`ID: ${result.id}`);
+    console.log(`Object: ${result.object}`);
+    console.log(`Created: ${new Date(result.created * 1000).toISOString()}`);
+    console.log(`Model: ${result.model}`);
+    console.log(`Choice Index: ${result.choices[0].index}`);
+    console.log(`Message Role: ${result.choices[0].message.role}`);
+    console.log(`Finish Reason: ${result.choices[0].finish_reason}`);
+    
+    console.log("\n🏷️ V2 Enhanced Metadata:");
+    console.log(`Transaction ID: ${result.metadata.transactionId}`);
+    console.log(`Processing Time: ${result.metadata.processingTime}ms`);
+    console.log(`Version: ${result.metadata.version}`);
+    
+    console.log("\n📋 Custom Metadata Sent:");
+    console.log(`Trace ID: ${customMetadata.traceId}`);
+    console.log(`Task Type: ${customMetadata.taskType}`);
+    console.log(`Subscriber: ${customMetadata.subscriberEmail}`);
+    console.log(`Organization: ${customMetadata.organizationId}`);
+    console.log(`Agent: ${customMetadata.agent}`);
+    console.log(`Quality Score: ${customMetadata.responseQualityScore}`);
+    console.log(`Operation Type: ${customMetadata.operationType}`);
+
+    // V2 Enhanced Analytics
+    console.log("\n📈 V2 Enhanced Analytics:");
+    const performance = controller.getModelPerformance("sonar-pro");
+    console.log(`Context Window: ${performance.contextWindow} tokens`);
+    console.log(`Online Capabilities: ${performance.online}`);
+    console.log(`Estimated Latency: ${performance.estimatedLatency}`);
+    console.log(`Cost Tier: ${performance.costTier}`);
+
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+metadataV2Example();

package/examples/v2/streaming.ts

@@ -0,0 +1,61 @@
+import { PerplexityV2Controller } from "../../src/index";
+
+const streamingV2Example = async () => {
+  console.log("=".repeat(50));
+  console.log("🌊 Perplexity V2 Streaming Example (Enhanced Response Format)");
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV2Controller();
+
+    // Streaming chat completion with V2 enhanced response
+    const result = await controller.createStreaming([
+      "Write a detailed explanation of how machine learning algorithms work, including examples."
+    ], "sonar-pro");
+
+    console.log("📝 V2 Streaming Response:");
+    console.log("-".repeat(30));
+
+    let fullResponse = "";
+    let chunkCount = 0;
+    let lastUsage: any = null;
+
+    for await (const chunk of result.stream) {
+      chunkCount++;
+      const content = chunk.choices?.[0]?.delta?.content || "";
+      
+      if (content) {
+        process.stdout.write(content);
+        fullResponse += content;
+      }
+
+      // Capture usage data from the last chunk
+      if (chunk.usage) {
+        lastUsage = chunk.usage;
+      }
+    }
+
+    console.log("\n" + "-".repeat(30));
+    console.log(`\n📊 V2 Enhanced Streaming Stats:`);
+    console.log(`Total chunks received: ${chunkCount}`);
+    console.log(`Response length: ${fullResponse.length} characters`);
+    
+    if (lastUsage) {
+      console.log(`Prompt tokens: ${lastUsage.prompt_tokens}`);
+      console.log(`Completion tokens: ${lastUsage.completion_tokens}`);
+      console.log(`Total tokens: ${lastUsage.total_tokens}`);
+    }
+    
+    console.log(`\n🔧 V2 Metadata:`);
+    console.log(`Stream ID: ${result.id}`);
+    console.log(`Object: ${result.object}`);
+    console.log(`Transaction ID: ${result.metadata.transactionId}`);
+    console.log(`Start Time: ${new Date(result.metadata.startTime).toISOString()}`);
+    console.log(`Version: ${result.metadata.version}`);
+
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+streamingV2Example();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@revenium/perplexity",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "NodeJS middleware for perplexity's AI API",
   "homepage": "https://github.com/revenium/revenium-middleware-perplexity-node#readme",
   "bugs": {
@@ -14,16 +14,31 @@
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc -b",
-    "p-basic": "npx ts-node playground/basic.js",
-    "p-streaming": "npx ts-node playground/streaming.js",
-    "p-enhanced": "npx ts-node playground/enhanced.js",
-    "p-chat-completions": "npx ts-node playground/chat-completions.js",
-    "p-metadata": "npx ts-node playground/metadata.js",
-    "e-basic": "npx ts-node examples/basic.ts",
-    "e-streaming": "npx ts-node examples/streaming.ts",
-    "e-chat-completions": "npx ts-node examples/chat-completions.ts",
-    "e-enhanced": "npx ts-node examples/enhanced.ts",
-    "e-metadata": "npx ts-node examples/metadata.ts"
+    "p-v1-basic": "node playground/v1/basic.js",
+    "p-v1-streaming": "node playground/v1/streaming.js",
+    "p-v1-chat": "node playground/v1/chat.js",
+    "p-v1-metadata": "node playground/v1/metadata.js",
+    "p-v2-basic": "node playground/v2/basic.js",
+    "p-v2-streaming": "node playground/v2/streaming.js",
+    "p-v2-chat": "node playground/v2/chat.js",
+    "p-v2-metadata": "node playground/v2/metadata.js",
+    "e-v1-basic": "npx ts-node examples/v1/basic.ts",
+    "e-v1-streaming": "npx ts-node examples/v1/streaming.ts",
+    "e-v1-chat": "npx ts-node examples/v1/chat.ts",
+    "e-v1-metadata": "npx ts-node examples/v1/metadata.ts",
+    "e-v2-basic": "npx ts-node examples/v2/basic.ts",
+    "e-v2-streaming": "npx ts-node examples/v2/streaming.ts",
+    "e-v2-chat": "npx ts-node examples/v2/chat.ts",
+    "e-v2-metadata": "npx ts-node examples/v2/metadata.ts",
+    "examples:v1": "npm run e-v1-basic",
+    "examples:v2": "npm run e-v2-basic",
+    "examples:all": "npm run examples:v1 && echo '\n=== V2 EXAMPLES ===\n' && npm run examples:v2",
+    "playground:v1": "npm run p-v1-basic",
+    "playground:v2": "npm run p-v2-basic",
+    "playground:all": "npm run playground:v1 && echo '\n=== V2 PLAYGROUND ===\n' && npm run playground:v2",
+    "test:v1": "npm run e-v1-basic && npm run e-v1-chat && npm run e-v1-streaming && npm run e-v1-metadata",
+    "test:v2": "npm run e-v2-basic && npm run e-v2-chat && npm run e-v2-streaming && npm run e-v2-metadata",
+    "test:all": "npm run test:v1 && echo '\n=== TESTING V2 ===\n' && npm run test:v2"
   },
   "keywords": [
     "revenium",

package/playground/v1/basic.js

@@ -0,0 +1,50 @@
+import { PerplexityV1Controller } from "@revenium/perplexity";
+
+const basicV1Example = async () => {
+  console.log("=".repeat(50));
+  console.log(
+    "🔥 Perplexity V1 Basic Example (JavaScript - @revenium/perplexity)"
+  );
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV1Controller();
+
+    // Basic chat completion
+    const result = await controller.createChat([
+      "What is artificial intelligence and how does it work?",
+    ]);
+
+    console.log("📝 Response:");
+    console.log(result.responses[0].text);
+
+    console.log("\n📊 Usage Metadata:");
+    console.log(`Input tokens: ${result.usageMetadata.inputTokenCount}`);
+    console.log(`Output tokens: ${result.usageMetadata.outputTokenCount}`);
+    console.log(`Total tokens: ${result.usageMetadata.totalTokenCount}`);
+
+    console.log("\n🔧 Model Info:");
+    console.log(`Model: ${result.modelVersion}`);
+    console.log(`Transaction ID: ${result.transactionId}`);
+
+    // Test model capabilities
+    console.log("\n🎯 Model Capabilities:");
+    const models = controller.getAvailableModels();
+    console.log(`Available models: ${models.slice(0, 3).join(", ")}...`);
+
+    const supportsChat = controller.supportsCapability("sonar-pro", "chat");
+    const supportsStreaming = controller.supportsCapability(
+      "sonar-pro",
+      "streaming"
+    );
+    const supportsOnline = controller.supportsCapability("sonar-pro", "online");
+
+    console.log(
+      `Sonar-pro capabilities: chat=${supportsChat}, streaming=${supportsStreaming}, online=${supportsOnline}`
+    );
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+basicV1Example();

package/playground/v1/chat.js

@@ -0,0 +1,46 @@
+import { PerplexityV1Controller } from "@revenium/perplexity";
+
+const chatV1Example = async () => {
+  console.log("=".repeat(50));
+  console.log("💬 Perplexity V1 Multi-turn Chat Example (JavaScript)");
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV1Controller();
+
+    // Multi-turn conversation using message objects
+    const messages = [
+      { role: "user", content: "What are the benefits of renewable energy?" },
+      {
+        role: "assistant",
+        content:
+          "Renewable energy offers several key benefits including environmental sustainability, reduced greenhouse gas emissions, and long-term cost savings.",
+      },
+      {
+        role: "user",
+        content: "Can you elaborate on the cost savings aspect?",
+      },
+    ];
+
+    const result = await controller.createChat(messages, "sonar-pro");
+
+    console.log("📝 Multi-turn Chat Response:");
+    console.log(result.responses[0].text);
+
+    console.log("\n📊 Usage Statistics:");
+    console.log(`Input tokens: ${result.usageMetadata.inputTokenCount}`);
+    console.log(`Output tokens: ${result.usageMetadata.outputTokenCount}`);
+    console.log(`Total tokens: ${result.usageMetadata.totalTokenCount}`);
+
+    console.log("\n🔧 Model Information:");
+    const modelInfo = controller.getModelInfo("sonar-pro");
+    console.log(`Model: ${modelInfo.model}`);
+    console.log(`Version: ${modelInfo.version}`);
+    console.log(`Context Window: ${modelInfo.contextWindow} tokens`);
+    console.log(`Capabilities:`, modelInfo.capabilities);
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+chatV1Example();

package/playground/v1/metadata.js

@@ -0,0 +1,50 @@
+import { PerplexityV1Controller } from "@revenium/perplexity";
+
+const metadataV1Example = async () => {
+  console.log("=".repeat(50));
+  console.log("📊 Perplexity V1 Custom Metadata Example (JavaScript)");
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV1Controller();
+
+    // Custom metadata for tracking
+    const customMetadata = {
+      traceId: "trace-js-12345",
+      taskType: "research-query",
+      subscriberEmail: "user@example.com",
+      subscriberId: "user-js-456",
+      organizationId: "org-js-789",
+      agent: "perplexity-v1-js-demo",
+    };
+
+    const result = await controller.createChat(
+      ["Explain quantum computing in simple terms"],
+      "sonar-pro",
+      customMetadata
+    );
+
+    console.log("📝 Response:");
+    console.log(result.responses[0].text);
+
+    console.log("\n📊 Usage Metadata:");
+    console.log(`Input tokens: ${result.usageMetadata.inputTokenCount}`);
+    console.log(`Output tokens: ${result.usageMetadata.outputTokenCount}`);
+    console.log(`Total tokens: ${result.usageMetadata.totalTokenCount}`);
+
+    console.log("\n🏷️ Custom Metadata Sent:");
+    console.log(`Trace ID: ${customMetadata.traceId}`);
+    console.log(`Task Type: ${customMetadata.taskType}`);
+    console.log(`Subscriber: ${customMetadata.subscriberEmail}`);
+    console.log(`Organization: ${customMetadata.organizationId}`);
+    console.log(`Agent: ${customMetadata.agent}`);
+
+    console.log("\n🔧 Transaction Info:");
+    console.log(`Model: ${result.modelVersion}`);
+    console.log(`Transaction ID: ${result.transactionId}`);
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+metadataV1Example();

package/playground/v1/streaming.js

@@ -0,0 +1,44 @@
+import { PerplexityV1Controller } from "@revenium/perplexity";
+
+const streamingV1Example = async () => {
+  console.log("=".repeat(50));
+  console.log(
+    "🌊 Perplexity V1 Streaming Example (JavaScript - @revenium/perplexity)"
+  );
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV1Controller();
+
+    // Streaming chat completion
+    const result = await controller.createStreaming(
+      [
+        "Write a short story about a robot learning to paint. Make it creative and engaging.",
+      ],
+      "sonar-pro"
+    );
+
+    console.log("📝 Streaming Response:");
+    console.log("-".repeat(30));
+
+    let fullResponse = "";
+    for await (const chunk of result.stream) {
+      const content = chunk.choices?.[0]?.delta?.content || "";
+      if (content) {
+        process.stdout.write(content);
+        fullResponse += content;
+      }
+    }
+
+    console.log("\n" + "-".repeat(30));
+    console.log(
+      `\n📊 Total response length: ${fullResponse.length} characters`
+    );
+    console.log(`🔧 Model: ${result.modelVersion}`);
+    console.log(`🆔 Transaction ID: ${result.transactionId}`);
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+streamingV1Example();

package/playground/v2/basic.js

@@ -0,0 +1,49 @@
+import { PerplexityV2Controller } from "@revenium/perplexity";
+
+const basicV2Example = async () => {
+  console.log("=".repeat(50));
+  console.log(
+    "🚀 Perplexity V2 Basic Example (JavaScript - Enhanced Response Format)"
+  );
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV2Controller();
+
+    // Basic chat completion with V2 enhanced response
+    const result = await controller.createChat([
+      "What is artificial intelligence and how does it work?",
+    ]);
+
+    console.log("📝 Response:");
+    console.log(result.choices[0].message.content);
+
+    console.log("\n📊 Enhanced Usage Info (V2):");
+    console.log(`Prompt tokens: ${result.usage.prompt_tokens}`);
+    console.log(`Completion tokens: ${result.usage.completion_tokens}`);
+    console.log(`Total tokens: ${result.usage.total_tokens}`);
+
+    console.log("\n🔧 Enhanced Metadata (V2):");
+    console.log(`ID: ${result.id}`);
+    console.log(`Object: ${result.object}`);
+    console.log(`Created: ${new Date(result.created * 1000).toISOString()}`);
+    console.log(`Model: ${result.model}`);
+    console.log(`Transaction ID: ${result.metadata.transactionId}`);
+    console.log(`Processing Time: ${result.metadata.processingTime}ms`);
+    console.log(`Version: ${result.metadata.version}`);
+
+    // Test V2 enhanced features
+    console.log("\n🎯 V2 Enhanced Features:");
+    const modelInfo = controller.getModelInfo("sonar-pro");
+    console.log(`Enhanced Model Info:`, modelInfo);
+
+    const recommendation = controller.getRecommendedModel("online-search");
+    console.log(
+      `Recommended for online search: ${recommendation.model} - ${recommendation.reason}`
+    );
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+basicV2Example();

package/playground/v2/chat.js

@@ -0,0 +1,72 @@
+import { PerplexityV2Controller } from "@revenium/perplexity";
+
+const chatV2Example = async () => {
+  console.log("=".repeat(50));
+  console.log(
+    "💬 Perplexity V2 Enhanced Chat Example (JavaScript - OpenAI Responses API)"
+  );
+  console.log("=".repeat(50));
+
+  try {
+    const controller = new PerplexityV2Controller();
+
+    // Multi-turn conversation with V2 enhanced features
+    const messages = [
+      {
+        role: "user",
+        content:
+          "What are the latest developments in renewable energy technology?",
+      },
+      {
+        role: "assistant",
+        content:
+          "Recent developments include improved solar panel efficiency, advanced battery storage systems, and offshore wind technology innovations.",
+      },
+      {
+        role: "user",
+        content: "Tell me more about the battery storage improvements",
+      },
+    ];
+
+    const result = await controller.createChat(messages, "sonar-pro");
+
+    console.log("📝 V2 Enhanced Chat Response:");
+    console.log(result.choices[0].message.content);
+
+    console.log("\n📊 V2 Enhanced Usage Statistics:");
+    console.log(`Prompt tokens: ${result.usage.prompt_tokens}`);
+    console.log(`Completion tokens: ${result.usage.completion_tokens}`);
+    console.log(`Total tokens: ${result.usage.total_tokens}`);
+
+    console.log("\n🔧 V2 Enhanced Response Metadata:");
+    console.log(`ID: ${result.id}`);
+    console.log(`Object: ${result.object}`);
+    console.log(`Created: ${new Date(result.created * 1000).toISOString()}`);
+    console.log(`Model: ${result.model}`);
+    console.log(`Finish Reason: ${result.choices[0].finish_reason}`);
+    console.log(`Processing Time: ${result.metadata.processingTime}ms`);
+    console.log(`Transaction ID: ${result.metadata.transactionId}`);
+    console.log(`Version: ${result.metadata.version}`);
+
+    // V2 Enhanced Features
+    console.log("\n🚀 V2 Enhanced Model Features:");
+    const modelInfo = controller.getModelInfo("sonar-pro");
+    console.log(`Enhanced: ${modelInfo.enhanced}`);
+    console.log(`Response Format: ${modelInfo.responseFormat}`);
+
+    const performance = controller.getModelPerformance("sonar-pro");
+    console.log(`Estimated Latency: ${performance.estimatedLatency}`);
+    console.log(`Cost Tier: ${performance.costTier}`);
+
+    // Model recommendations
+    console.log("\n🎯 V2 Model Recommendations:");
+    const onlineRec = controller.getRecommendedModel("online-search");
+    const offlineRec = controller.getRecommendedModel("offline-chat");
+    console.log(`For online search: ${onlineRec.model} - ${onlineRec.reason}`);
+    console.log(`For offline chat: ${offlineRec.model} - ${offlineRec.reason}`);
+  } catch (error) {
+    console.error("❌ Error:", error);
+  }
+};
+
+chatV2Example();