@toothfairyai/cli 1.0.3 → 1.0.7

package/bin/toothfairy.js

@@ -1,57 +1,63 @@
 #!/usr/bin/env node
 
-const { Command } = require("commander");
-const chalk = require("chalk");
-const ora = require("ora");
-const { table } = require("table");
-require("dotenv").config();
+const { Command } = require('commander');
+const chalk = require('chalk');
+const ora = require('ora');
+const { table } = require('table');
+require('dotenv').config();
 
-const ToothFairyAPI = require("../src/api");
+const ToothFairyAPI = require('../src/api');
 const {
   loadConfig,
   saveConfig,
   ToothFairyConfig,
   getConfigPath,
   validateConfiguration,
-} = require("../src/config");
+} = require('../src/config');
 
 const program = new Command();
 
 program
-  .name("toothfairy")
+  .name('toothfairy')
   .description(
-    "ToothFairy AI CLI - Interact with ToothFairy AI agents via command line"
+    'ToothFairy AI CLI - Interact with ToothFairy AI agents via command line'
   )
-  .version("1.0.0");
+  .version('1.0.0');
 
 program
-  .option("-c, --config <path>", "path to configuration file")
-  .option("-v, --verbose", "enable verbose logging");
+  .option('-c, --config <path>', 'path to configuration file')
+  .option('-v, --verbose', 'enable verbose logging');
 
 // Configure command
 program
-  .command("configure")
-  .description("Configure ToothFairy CLI credentials and settings")
+  .command('configure')
+  .description('Configure ToothFairy CLI credentials and settings')
   .option(
-    "--base-url <url>",
-    "ToothFairy API base URL",
-    "https://api.toothfairyai.com"
+    '--base-url <url>',
+    'ToothFairy API base URL',
+    'https://api.toothfairyai.com'
   )
-  .option("--ai-url <url>", "ToothFairy AI URL", "https://ai.toothfairyai.com")
-  .requiredOption("--api-key <key>", "API key")
-  .requiredOption("--workspace-id <id>", "Workspace ID")
-  .option("--config-path <path>", "Path to save config file")
+  .option('--ai-url <url>', 'ToothFairy AI URL', 'https://ai.toothfairyai.com')
+  .option(
+    '--ai-stream-url <url>',
+    'ToothFairy AI Streaming URL',
+    'https://ais.toothfairyai.com'
+  )
+  .requiredOption('--api-key <key>', 'API key')
+  .requiredOption('--workspace-id <id>', 'Workspace ID')
+  .option('--config-path <path>', 'Path to save config file')
   .action(async (options) => {
     try {
       const config = new ToothFairyConfig(
         options.baseUrl,
         options.aiUrl,
+        options.aiStreamUrl,
         options.apiKey,
         options.workspaceId
       );
 
       saveConfig(config, options.configPath);
-      console.log(chalk.green("Configuration saved successfully!"));
+      console.log(chalk.green('Configuration saved successfully!'));
       if (!options.configPath) {
         console.log(`Config saved to: ${getConfigPath()}`);
       }
@@ -63,16 +69,16 @@ program
 
 // Send command
 program
-  .command("send")
-  .description("Send a message to a ToothFairy AI agent")
-  .argument("<message>", "message to send")
-  .requiredOption("--agent-id <id>", "Agent ID to send message to")
-  .option("--phone-number <number>", "Phone number for SMS channel")
-  .option("--customer-id <id>", "Customer ID")
-  .option("--provider-id <id>", "SMS provider ID")
-  .option("--customer-info <json>", "Customer info as JSON string")
-  .option("-o, --output <format>", "Output format (json|text)", "text")
-  .option("-v, --verbose", "Show detailed response information")
+  .command('send')
+  .description('Send a message to a ToothFairy AI agent')
+  .argument('<message>', 'message to send')
+  .requiredOption('--agent-id <id>', 'Agent ID to send message to')
+  .option('--phone-number <number>', 'Phone number for SMS channel')
+  .option('--customer-id <id>', 'Customer ID')
+  .option('--provider-id <id>', 'SMS provider ID')
+  .option('--customer-info <json>', 'Customer info as JSON string')
+  .option('-o, --output <format>', 'Output format (json|text)', 'text')
+  .option('-v, --verbose', 'Show detailed response information')
   .action(async (message, options, command) => {
     try {
       const globalOptions = command.parent.opts();
@@ -82,6 +88,7 @@ program
       const api = new ToothFairyAPI(
         config.baseUrl,
         config.aiUrl,
+        config.aiStreamUrl,
         config.apiKey,
         config.workspaceId,
         globalOptions.verbose || options.verbose
@@ -93,12 +100,12 @@ program
         try {
           customerInfo = JSON.parse(options.customerInfo);
         } catch (error) {
-          console.error(chalk.red("Invalid JSON in customer-info"));
+          console.error(chalk.red('Invalid JSON in customer-info'));
           process.exit(1);
         }
       }
 
-      const spinner = ora("Sending message to agent...").start();
+      const spinner = ora('Sending message to agent...').start();
 
       const response = await api.sendMessageToAgent(
         message,
@@ -111,36 +118,36 @@ program
 
       spinner.stop();
 
-      if (options.output === "json") {
+      if (options.output === 'json') {
         console.log(JSON.stringify(response, null, 2));
       } else {
         const agentResp = response.agentResponse;
 
         if (options.verbose) {
           // Verbose mode: show all details
-          console.log(chalk.green.bold("Message sent successfully!"));
+          console.log(chalk.green.bold('Message sent successfully!'));
           console.log();
 
           const data = [
-            ["Field", "Value"],
-            ["Chat ID", response.chatId],
-            ["Message ID", response.messageId],
+            ['Field', 'Value'],
+            ['Chat ID', response.chatId],
+            ['Message ID', response.messageId],
           ];
 
           console.log(
             table(data, {
               header: {
-                alignment: "center",
-                content: "Response Details",
+                alignment: 'center',
+                content: 'Response Details',
               },
             })
           );
 
           // Show full agent response
-          console.log(chalk.blue.bold("Agent Response (Full):"));
-          console.log("─".repeat(50));
+          console.log(chalk.blue.bold('Agent Response (Full):'));
+          console.log('─'.repeat(50));
           console.log(JSON.stringify(agentResp, null, 2));
-          console.log("─".repeat(50));
+          console.log('─'.repeat(50));
         } else {
           // Default mode: show only the clean agent text
           if (agentResp.contents && agentResp.contents.content) {
@@ -153,7 +160,7 @@ program
             // Fallback if no recognizable text format
             console.log(
               chalk.yellow(
-                "No text response found. Use --verbose for full details."
+                'No text response found. Use --verbose for full details.'
               )
             );
           }
@@ -165,24 +172,272 @@ program
     }
   });
 
+// Send Stream command
+program
+  .command('send-stream')
+  .description(
+    'Send a message to a ToothFairy AI agent with real-time streaming response'
+  )
+  .argument('<message>', 'message to send')
+  .requiredOption('--agent-id <id>', 'Agent ID to send message to')
+  .option('--phone-number <number>', 'Phone number for SMS channel')
+  .option('--customer-id <id>', 'Customer ID')
+  .option('--provider-id <id>', 'SMS provider ID')
+  .option('--customer-info <json>', 'Customer info as JSON string')
+  .option('-o, --output <format>', 'Output format (json|text)', 'text')
+  .option('-v, --verbose', 'Show detailed streaming information')
+  .option('--show-progress', 'Show agent processing status updates')
+  .action(async (message, options, command) => {
+    /*
+    STREAMING BEHAVIOR EXPLAINED:
+    
+    🔄 STATUS UPDATES: The agent goes through several processing phases:
+    
+    • 'connected': Connection established with streaming server
+    • 'init': Agent initialization started  
+    • 'initial_setup_completed': Basic setup and context loading finished
+    • 'tools_processing_completed': Any required tools/functions processed
+    • 'replying': Agent begins generating the actual response (text starts streaming)
+    • 'updating_memory': Agent updates conversation memory
+    • 'memory_updated': Memory update completed
+    • 'complete': Stream finished successfully
+    
+    📝 TEXT STREAMING: Once the agent reaches 'replying' status, you'll see the response
+    text being built progressively, word by word, just like ChatGPT or similar AI assistants.
+    
+    💡 TIP: Use --show-progress to see detailed status updates, or --verbose for full debug info.
+    */
+
+    try {
+      const globalOptions = command.parent.opts();
+      const config = loadConfig(globalOptions.config);
+      validateConfiguration(config);
+
+      const api = new ToothFairyAPI(
+        config.baseUrl,
+        config.aiUrl,
+        config.aiStreamUrl,
+        config.apiKey,
+        config.workspaceId,
+        globalOptions.verbose || options.verbose
+      );
+
+      // Parse customer info if provided
+      let customerInfo = {};
+      if (options.customerInfo) {
+        try {
+          customerInfo = JSON.parse(options.customerInfo);
+        } catch (error) {
+          console.error(chalk.red('Invalid JSON in customer-info'));
+          process.exit(1);
+        }
+      }
+
+      console.log(
+        chalk.cyan(`Streaming message to agent ${options.agentId}...`)
+      );
+      console.log(chalk.dim(`Message: ${message}`));
+      console.log();
+
+      // Initialize variables for streaming
+      let currentText = '';
+      let finalResponse = null;
+      let processingStatus = null;
+
+      const formatStatusMessage = (status) => {
+        const statusMessages = {
+          connected: '🔗 Connected to streaming server',
+          init: '🚀 Initializing agent...',
+          initial_setup_completed: '✅ Agent setup completed',
+          tools_processing_completed: '🛠️  Tools processing finished',
+          replying: '💭 Agent is thinking and responding...',
+          updating_memory: '💾 Updating conversation memory...',
+          memory_updated: '✅ Memory updated successfully',
+          complete: '🎉 Response complete!',
+        };
+        return statusMessages[status] || `📊 Status: ${status}`;
+      };
+
+      if (options.output === 'json') {
+        // JSON mode: collect all events and output at the end
+        const allEvents = [];
+
+        await api.sendMessageToAgentStream(
+          message,
+          options.agentId,
+          options.phoneNumber,
+          options.customerId,
+          options.providerId,
+          customerInfo,
+          (eventType, eventData) => {
+            allEvents.push({ event_type: eventType, event_data: eventData });
+
+            if (eventType === 'error') {
+              console.error(
+                chalk.red(
+                  `Streaming error: ${eventData.message || 'Unknown error'}`
+                )
+              );
+            }
+          }
+        );
+
+        console.log(JSON.stringify(allEvents, null, 2));
+      } else {
+        // Text mode: show live streaming
+        let currentSpinner = null;
+
+        // Function to update display
+        const updateDisplay = (text, type = 'response') => {
+          if (currentSpinner) {
+            currentSpinner.stop();
+            currentSpinner = null;
+          }
+
+          // Clear previous lines if we're updating the same response
+          if (text && type === 'response') {
+            // For real-time streaming, we overwrite the current line
+            process.stdout.write('\r\x1b[K'); // Clear current line
+            process.stdout.write(chalk.green('🧚 Response: ') + text);
+          }
+        };
+
+        try {
+          await api.sendMessageToAgentStream(
+            message,
+            options.agentId,
+            options.phoneNumber,
+            options.customerId,
+            options.providerId,
+            customerInfo,
+            (eventType, eventData) => {
+              if (options.verbose) {
+                // Verbose mode: show all event details
+                console.log(
+                  chalk.dim(
+                    `\nEvent: ${eventType} | Data: ${JSON.stringify(
+                      eventData,
+                      null,
+                      2
+                    )}`
+                  )
+                );
+              }
+
+              if (eventType === 'status') {
+                if (eventData.status === 'connected') {
+                  if (options.showProgress) {
+                    console.log(
+                      chalk.green('🔗 Connected to streaming server')
+                    );
+                  }
+                } else if (eventData.status === 'complete') {
+                  if (options.showProgress) {
+                    console.log(
+                      chalk.green('\n🎉 Stream completed successfully!')
+                    );
+                  }
+                }
+              } else if (eventType === 'progress') {
+                // Agent processing status updates
+                const newStatus = eventData.processing_status;
+                if (newStatus && newStatus !== processingStatus) {
+                  processingStatus = newStatus;
+                  if (options.showProgress) {
+                    const statusMsg = formatStatusMessage(processingStatus);
+                    if (currentSpinner) {
+                      currentSpinner.stop();
+                    }
+                    currentSpinner = ora(chalk.yellow(statusMsg)).start();
+                  }
+                }
+              } else if (eventType === 'data') {
+                // Streaming text data
+                if (eventData.text) {
+                  currentText = eventData.text;
+                  updateDisplay(currentText.trim());
+                }
+              } else if (eventType === 'complete') {
+                // Final response with all metadata
+                finalResponse = eventData;
+                if (currentText) {
+                  // Ensure we have a clean final display - just add the final emoji
+                  if (currentSpinner) {
+                    currentSpinner.stop();
+                    currentSpinner = null;
+                  }
+                  process.stdout.write('\r\x1b[K'); // Clear current line
+                  process.stdout.write(chalk.blue('🪄 ') + currentText.trim());
+                }
+              } else if (eventType === 'error') {
+                const errorMsg = eventData.message || 'Unknown streaming error';
+                if (currentSpinner) {
+                  currentSpinner.stop();
+                }
+                console.error(chalk.red(`\n❌ Error: ${errorMsg}`));
+                process.exit(1);
+              }
+            }
+          );
+
+          // Clean up spinner after streaming completes
+          if (currentSpinner) {
+            currentSpinner.stop();
+          }
+
+          console.log(); // Add newline after streaming
+
+          if (options.verbose && finalResponse) {
+            // Show final response metadata in verbose mode
+            console.log(chalk.cyan.bold('📊 Final Response Metadata'));
+            console.log('─'.repeat(40));
+
+            if (finalResponse.metadata_parsed) {
+              const metadata = finalResponse.metadata_parsed;
+              for (const [key, value] of Object.entries(metadata)) {
+                if (key !== 'agent_processing_status') {
+                  // Already shown during streaming
+                  console.log(chalk.cyan(`${key}:`), String(value));
+                }
+              }
+            }
+            console.log('─'.repeat(40));
+          }
+
+          if (!currentText) {
+            console.log(chalk.yellow('No text response received from agent.'));
+          }
+        } catch (streamError) {
+          if (currentSpinner) {
+            currentSpinner.stop();
+          }
+          throw streamError;
+        }
+      }
+    } catch (error) {
+      console.error(chalk.red(`Error during streaming: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
 // Search command
 program
-  .command("search")
-  .description("Search for documents in the knowledge hub")
-  .argument("<query>", "search query text")
+  .command('search')
+  .description('Search for documents in the knowledge hub')
+  .argument('<query>', 'search query text')
   .option(
-    "-k, --top-k <number>",
-    "Number of documents to retrieve (1-50)",
-    "10"
+    '-k, --top-k <number>',
+    'Number of documents to retrieve (1-50)',
+    '10'
   )
   .option(
-    "--status <status>",
-    "Filter by document status (published|suspended)"
+    '--status <status>',
+    'Filter by document status (published|suspended)'
   )
-  .option("--document-id <id>", "Search within specific document ID")
-  .option("--topics <topics>", "Comma-separated topic IDs to filter by")
-  .option("-o, --output <format>", "Output format (json|text)", "text")
-  .option("-v, --verbose", "Show detailed search information")
+  .option('--document-id <id>', 'Search within specific document ID')
+  .option('--topics <topics>', 'Comma-separated topic IDs to filter by')
+  .option('-o, --output <format>', 'Output format (json|text)', 'text')
+  .option('-v, --verbose', 'Show detailed search information')
   .action(async (query, options, command) => {
     try {
       const globalOptions = command.parent.opts();
@@ -192,6 +447,7 @@ program
       const api = new ToothFairyAPI(
         config.baseUrl,
         config.aiUrl,
+        config.aiStreamUrl,
         config.apiKey,
         config.workspaceId,
         globalOptions.verbose || options.verbose
@@ -201,7 +457,7 @@ program
       const topK = parseInt(options.topK);
       if (isNaN(topK) || topK < 1 || topK > 50) {
         console.error(
-          chalk.red("Error: --top-k must be a number between 1 and 50")
+          chalk.red('Error: --top-k must be a number between 1 and 50')
         );
         process.exit(1);
       }
@@ -209,7 +465,7 @@ program
       // Build metadata filters
       const metadata = {};
       if (options.status) {
-        if (!["published", "suspended"].includes(options.status)) {
+        if (!['published', 'suspended'].includes(options.status)) {
           console.error(
             chalk.red(
               'Error: --status must be either "published" or "suspended"'
@@ -224,7 +480,7 @@ program
       }
       if (options.topics) {
         const topicList = options.topics
-          .split(",")
+          .split(',')
           .map((t) => t.trim())
           .filter((t) => t);
         if (topicList.length > 0) {
@@ -232,7 +488,7 @@ program
         }
       }
 
-      const spinner = ora("Searching knowledge hub...").start();
+      const spinner = ora('Searching knowledge hub...').start();
 
       const results = await api.searchDocuments(
         query,
@@ -242,7 +498,7 @@ program
 
       spinner.stop();
 
-      if (options.output === "json") {
+      if (options.output === 'json') {
         console.log(JSON.stringify(results, null, 2));
       } else {
         // Handle different response formats - results might be array or dict
@@ -251,22 +507,22 @@ program
           : results.results || [];
 
         if (!documents || documents.length === 0) {
-          console.log(chalk.yellow("No documents found for your query"));
+          console.log(chalk.yellow('No documents found for your query'));
           return;
         }
 
         console.log(chalk.green.bold(`Found ${documents.length} document(s)`));
-        console.log("=".repeat(50));
+        console.log('='.repeat(50));
 
-        documents.forEach((doc, index) => {
+        documents.forEach((doc) => {
           const score = doc.cosinesim || 0;
-          const docId = doc.doc_id || doc.chunk_id || "N/A";
+          const docId = doc.doc_id || doc.chunk_id || 'N/A';
 
           // Extract text content directly from document
-          const textContent = doc.raw_text || "No content available";
-          const docStatus = doc.status || "unknown";
+          const textContent = doc.raw_text || 'No content available';
+          const docStatus = doc.status || 'unknown';
           const docTopics = doc.topics || [];
-          const docTitle = doc.title || "Untitled";
+          const docTitle = doc.title || 'Untitled';
 
           console.log(
             chalk.cyan.bold(`\n${docTitle}`),
@@ -276,16 +532,16 @@ program
           if (options.verbose) {
             // Verbose mode: show all details
             const data = [
-              ["Field", "Value"],
-              ["Document ID", docId],
-              ["Title", docTitle],
-              ["Relevance Score", score.toFixed(4)],
-              ["Status", docStatus],
-              ["Topics", docTopics.length > 0 ? docTopics.join(", ") : "None"],
+              ['Field', 'Value'],
+              ['Document ID', docId],
+              ['Title', docTitle],
+              ['Relevance Score', score.toFixed(4)],
+              ['Status', docStatus],
+              ['Topics', docTopics.length > 0 ? docTopics.join(', ') : 'None'],
               [
-                "Content Preview",
+                'Content Preview',
                 textContent.length > 200
-                  ? textContent.substring(0, 200) + "..."
+                  ? textContent.substring(0, 200) + '...'
                   : textContent,
               ],
             ];
@@ -293,13 +549,13 @@ program
             console.log(table(data));
           } else {
             // Default mode: show clean content
-            console.log("─".repeat(50));
+            console.log('─'.repeat(50));
             const displayContent =
               textContent.length > 500
-                ? textContent.substring(0, 500) + "..."
+                ? textContent.substring(0, 500) + '...'
                 : textContent;
             console.log(displayContent);
-            console.log("─".repeat(50));
+            console.log('─'.repeat(50));
           }
         });
       }
@@ -311,9 +567,9 @@ program
 
 // Chats command
 program
-  .command("chats")
-  .description("List all chats in the workspace")
-  .option("-o, --output <format>", "Output format (json|text)", "text")
+  .command('chats')
+  .description('List all chats in the workspace')
+  .option('-o, --output <format>', 'Output format (json|text)', 'text')
   .action(async (options, command) => {
     try {
       const globalOptions = command.parent.opts();
@@ -323,23 +579,24 @@ program
       const api = new ToothFairyAPI(
         config.baseUrl,
         config.aiUrl,
+        config.aiStreamUrl,
         config.apiKey,
         config.workspaceId,
         globalOptions.verbose || options.verbose
       );
 
-      const spinner = ora("Fetching chats...").start();
+      const spinner = ora('Fetching chats...').start();
       const chatsData = await api.getAllChats();
       spinner.stop();
 
-      if (options.output === "json") {
+      if (options.output === 'json') {
         console.log(JSON.stringify(chatsData, null, 2));
       } else {
         if (
           !chatsData ||
           (Array.isArray(chatsData) && chatsData.length === 0)
         ) {
-          console.log(chalk.yellow("No chats found"));
+          console.log(chalk.yellow('No chats found'));
           return;
         }
 
@@ -347,22 +604,22 @@ program
           ? chatsData
           : chatsData.items || [];
 
-        const data = [["Chat ID", "Name", "Customer ID", "Created"]];
+        const data = [['Chat ID', 'Name', 'Customer ID', 'Created']];
 
         chatList.forEach((chat) => {
           data.push([
-            chat.id || "N/A",
-            chat.name || "N/A",
-            chat.customerId || "N/A",
-            chat.createdAt || "N/A",
+            chat.id || 'N/A',
+            chat.name || 'N/A',
+            chat.customerId || 'N/A',
+            chat.createdAt || 'N/A',
           ]);
         });
 
         console.log(
           table(data, {
             header: {
-              alignment: "center",
-              content: "Workspace Chats",
+              alignment: 'center',
+              content: 'Workspace Chats',
             },
           })
         );
@@ -375,10 +632,10 @@ program
 
 // Chat command (get specific chat)
 program
-  .command("chat")
-  .description("Get details of a specific chat")
-  .argument("<chat-id>", "Chat ID to retrieve")
-  .option("-o, --output <format>", "Output format (json|text)", "text")
+  .command('chat')
+  .description('Get details of a specific chat')
+  .argument('<chat-id>', 'Chat ID to retrieve')
+  .option('-o, --output <format>', 'Output format (json|text)', 'text')
   .action(async (chatId, options, command) => {
     try {
       const globalOptions = command.parent.opts();
@@ -388,6 +645,7 @@ program
       const api = new ToothFairyAPI(
         config.baseUrl,
         config.aiUrl,
+        config.aiStreamUrl,
         config.apiKey,
         config.workspaceId,
         globalOptions.verbose || options.verbose
@@ -397,17 +655,17 @@ program
       const chatData = await api.getChat(chatId);
       spinner.stop();
 
-      if (options.output === "json") {
+      if (options.output === 'json') {
         console.log(JSON.stringify(chatData, null, 2));
       } else {
-        console.log(chalk.green.bold("Chat Details"));
+        console.log(chalk.green.bold('Chat Details'));
         console.log();
 
-        const data = [["Field", "Value"]];
+        const data = [['Field', 'Value']];
 
         Object.entries(chatData).forEach(([key, value]) => {
           let displayValue = value;
-          if (typeof value === "object" && value !== null) {
+          if (typeof value === 'object' && value !== null) {
             displayValue = JSON.stringify(value, null, 2);
           }
           data.push([key, String(displayValue)]);
@@ -423,31 +681,31 @@ program
 
 // Config show command
 program
-  .command("config-show")
-  .description("Show current configuration")
+  .command('config-show')
+  .description('Show current configuration')
   .action(async (options, command) => {
     try {
       const globalOptions = command.parent.opts();
       const config = loadConfig(globalOptions.config);
 
       const data = [
-        ["Setting", "Value"],
-        ["Base URL", config.baseUrl],
-        ["AI URL", config.aiUrl],
+        ['Setting', 'Value'],
+        ['Base URL', config.baseUrl],
+        ['AI URL', config.aiUrl],
         [
-          "API Key",
+          'API Key',
           config.apiKey
-            ? `${"*".repeat(20)}...${config.apiKey.slice(-4)}`
-            : "Not set",
+            ? `${'*'.repeat(20)}...${config.apiKey.slice(-4)}`
+            : 'Not set',
         ],
-        ["Workspace ID", config.workspaceId],
+        ['Workspace ID', config.workspaceId],
       ];
 
       console.log(
         table(data, {
           header: {
-            alignment: "center",
-            content: "Current Configuration",
+            alignment: 'center',
+            content: 'Current Configuration',
           },
         })
       );
@@ -459,196 +717,196 @@ program
 
 // Help guide command
 program
-  .command("help-guide")
-  .description("Show detailed help and usage examples")
+  .command('help-guide')
+  .description('Show detailed help and usage examples')
   .action(() => {
-    console.log(chalk.cyan.bold("🚀 ToothFairy AI CLI - Quick Start Guide"));
-    console.log("=".repeat(50));
+    console.log(chalk.cyan.bold('🚀 ToothFairy AI CLI - Quick Start Guide'));
+    console.log('='.repeat(50));
 
-    console.log(chalk.green.bold("\n🚀 Getting Started"));
-    console.log("1. First, configure your credentials:");
+    console.log(chalk.green.bold('\n🚀 Getting Started'));
+    console.log('1. First, configure your credentials:');
     console.log(
       chalk.dim(
-        "   tf configure --api-key YOUR_KEY --workspace-id YOUR_WORKSPACE"
+        '   tf configure --api-key YOUR_KEY --workspace-id YOUR_WORKSPACE'
       )
     );
 
-    console.log("\n2. Send a message to an agent:");
+    console.log('\n2. Send a message to an agent:');
     console.log(
       chalk.dim('   tf send "Hello, I need help" --agent-id YOUR_AGENT_ID')
     );
 
-    console.log("\n3. Search the knowledge hub:");
+    console.log('\n3. Search the knowledge hub:');
     console.log(chalk.dim('   tf search "AI configuration help"'));
 
-    console.log("\n4. Explore your workspace:");
+    console.log('\n4. Explore your workspace:');
     console.log(
-      chalk.dim("   tf chats                    # List all conversations")
+      chalk.dim('   tf chats                    # List all conversations')
     );
     console.log(
-      chalk.dim("   tf config-show              # View current settings")
+      chalk.dim('   tf config-show              # View current settings')
     );
 
-    console.log(chalk.blue.bold("\n💬 Agent Communication Examples"));
+    console.log(chalk.blue.bold('\n💬 Agent Communication Examples'));
 
     const agentExamples = [
       [
-        "Simple message",
+        'Simple message',
         'tf send "What are your hours?" --agent-id "info-agent"',
       ],
       [
-        "With customer info",
+        'With customer info',
         'tf send "Schedule appointment" --agent-id "scheduler" --customer-info \'{"name": "John"}\'',
       ],
-      ["Verbose output", 'tf send "Hello" --agent-id "agent-123" --verbose'],
+      ['Verbose output', 'tf send "Hello" --agent-id "agent-123" --verbose'],
       [
-        "JSON for scripting",
+        'JSON for scripting',
         'tf send "Help" --agent-id "agent-123" --output json',
       ],
     ];
 
-    const agentData = [["Use Case", "Command"], ...agentExamples];
+    const agentData = [['Use Case', 'Command'], ...agentExamples];
     console.log(
       table(agentData, {
         header: {
-          alignment: "center",
-          content: "Agent Communication",
+          alignment: 'center',
+          content: 'Agent Communication',
         },
       })
     );
 
-    console.log(chalk.magenta.bold("\n🔍 Knowledge Hub Search Examples"));
+    console.log(chalk.magenta.bold('\n🔍 Knowledge Hub Search Examples'));
 
     const searchExamples = [
-      ["Basic search", 'tf search "AI agent configuration"'],
-      ["Filter by status", 'tf search "machine learning" --status published'],
-      ["Limit results", 'tf search "troubleshooting" --top-k 3'],
+      ['Basic search', 'tf search "AI agent configuration"'],
+      ['Filter by status', 'tf search "machine learning" --status published'],
+      ['Limit results', 'tf search "troubleshooting" --top-k 3'],
       [
-        "Topic filtering",
+        'Topic filtering',
         'tf search "automation" --topics "topic_123,topic_456"',
       ],
-      ["Specific document", 'tf search "settings" --document-id "doc_550..."'],
-      ["Verbose details", 'tf search "deployment" --verbose'],
-      ["JSON output", 'tf search "API docs" --output json'],
+      ['Specific document', 'tf search "settings" --document-id "doc_550..."'],
+      ['Verbose details', 'tf search "deployment" --verbose'],
+      ['JSON output', 'tf search "API docs" --output json'],
     ];
 
-    const searchData = [["Use Case", "Command"], ...searchExamples];
+    const searchData = [['Use Case', 'Command'], ...searchExamples];
     console.log(
       table(searchData, {
         header: {
-          alignment: "center",
-          content: "Knowledge Hub Search",
+          alignment: 'center',
+          content: 'Knowledge Hub Search',
         },
       })
     );
 
-    console.log(chalk.green.bold("\n📋 Workspace Management Examples"));
+    console.log(chalk.green.bold('\n📋 Workspace Management Examples'));
 
     const mgmtExamples = [
-      ["List all chats", "tf chats"],
-      ["View chat details", "tf chat CHAT_ID"],
-      ["Show config", "tf config-show"],
-      ["Detailed help", "tf help-guide"],
+      ['List all chats', 'tf chats'],
+      ['View chat details', 'tf chat CHAT_ID'],
+      ['Show config', 'tf config-show'],
+      ['Detailed help', 'tf help-guide'],
     ];
 
-    const mgmtData = [["Use Case", "Command"], ...mgmtExamples];
+    const mgmtData = [['Use Case', 'Command'], ...mgmtExamples];
     console.log(
       table(mgmtData, {
         header: {
-          alignment: "center",
-          content: "Workspace Management",
+          alignment: 'center',
+          content: 'Workspace Management',
         },
       })
     );
 
-    console.log(chalk.yellow.bold("\n🔧 Configuration Options"));
+    console.log(chalk.yellow.bold('\n🔧 Configuration Options'));
     const configOptions = [
-      ["Method", "Description", "Example"],
+      ['Method', 'Description', 'Example'],
       [
-        "Environment",
-        "Set environment variables",
-        "export TF_API_KEY=your_key",
+        'Environment',
+        'Set environment variables',
+        'export TF_API_KEY=your_key',
       ],
       [
-        "Config file",
-        "Use ~/.toothfairy/config.yml",
-        "api_key: your_key\\nworkspace_id: your_workspace",
+        'Config file',
+        'Use ~/.toothfairy/config.yml',
+        'api_key: your_key\\nworkspace_id: your_workspace',
       ],
       [
-        "CLI arguments",
-        "Pass config file path",
-        "tf --config /path/to/config.yml send ...",
+        'CLI arguments',
+        'Pass config file path',
+        'tf --config /path/to/config.yml send ...',
       ],
     ];
 
     console.log(table(configOptions));
 
-    console.log(chalk.red.bold("\n⚠️  Common Issues & Solutions"));
+    console.log(chalk.red.bold('\n⚠️  Common Issues & Solutions'));
     const issues = [
-      ["Issue", "Solution"],
+      ['Issue', 'Solution'],
       [
-        "Configuration incomplete",
-        "Run: tf configure --api-key YOUR_KEY --workspace-id YOUR_WORKSPACE",
+        'Configuration incomplete',
+        'Run: tf configure --api-key YOUR_KEY --workspace-id YOUR_WORKSPACE',
       ],
       [
-        "No text response found",
-        "Use --verbose flag to see full response details",
+        'No text response found',
+        'Use --verbose flag to see full response details',
       ],
-      ["Agent not responding", "Check agent-id is correct and agent is active"],
+      ['Agent not responding', 'Check agent-id is correct and agent is active'],
       [
-        "Network errors",
-        "Verify API endpoints are accessible and credentials are valid",
+        'Network errors',
+        'Verify API endpoints are accessible and credentials are valid',
       ],
     ];
 
     console.log(table(issues));
 
-    console.log(chalk.cyan.bold("\n🔍 Search Filtering Guide"));
-    console.log("Knowledge Hub search supports powerful filtering options:");
+    console.log(chalk.cyan.bold('\n🔍 Search Filtering Guide'));
+    console.log('Knowledge Hub search supports powerful filtering options:');
     console.log(
-      "• " +
-        chalk.cyan("--status") +
-        ": Filter documents by 'published' or 'suspended' status"
+      '• ' +
+        chalk.cyan('--status') +
+        ': Filter documents by \'published\' or \'suspended\' status'
     );
     console.log(
-      "• " +
-        chalk.cyan("--topics") +
-        ": Use topic IDs from ToothFairyAI (comma-separated)"
+      '• ' +
+        chalk.cyan('--topics') +
+        ': Use topic IDs from ToothFairyAI (comma-separated)'
     );
     console.log(
-      "• " + chalk.cyan("--document-id") + ": Search within a specific document"
+      '• ' + chalk.cyan('--document-id') + ': Search within a specific document'
     );
     console.log(
-      "• " + chalk.cyan("--top-k") + ": Control number of results (1-50)"
+      '• ' + chalk.cyan('--top-k') + ': Control number of results (1-50)'
     );
     console.log(
-      "• " + chalk.cyan("--verbose") + ": Show relevance scores and metadata"
+      '• ' + chalk.cyan('--verbose') + ': Show relevance scores and metadata'
     );
 
-    console.log(chalk.magenta.bold("\n📖 More Help"));
+    console.log(chalk.magenta.bold('\n📖 More Help'));
     console.log(
-      "• Use " + chalk.cyan("tf COMMAND --help") + " for command-specific help"
+      '• Use ' + chalk.cyan('tf COMMAND --help') + ' for command-specific help'
     );
     console.log(
-      "• Use " +
-        chalk.cyan("--verbose") +
-        " flag to see detailed request/response information"
+      '• Use ' +
+        chalk.cyan('--verbose') +
+        ' flag to see detailed request/response information'
     );
     console.log(
-      "• Use " + chalk.cyan("--output json") + " for machine-readable output"
+      '• Use ' + chalk.cyan('--output json') + ' for machine-readable output'
     );
     console.log(
-      "• Configuration is loaded from: environment variables → ~/.toothfairy/config.yml → CLI args"
+      '• Configuration is loaded from: environment variables → ~/.toothfairy/config.yml → CLI args'
     );
 
-    console.log(chalk.green.bold("\n✨ Pro Tips"));
+    console.log(chalk.green.bold('\n✨ Pro Tips'));
     const tips = [
-      "💾 Save time: Configure once with 'tf configure', then just use 'tf send' and 'tf search'",
-      "🔍 Debug issues: Use '--verbose' to see full API responses and troubleshoot",
-      "📝 Scripting: Use '--output json' and tools like 'jq' to parse responses",
-      "⚡ Quick tests: Only --agent-id is required for send, only query for search",
-      "🎯 Better search: Use --status, --topics, and --document-id for targeted results",
-      "🔧 Multiple environments: Use different config files with '--config' flag",
+      '💾 Save time: Configure once with \'tf configure\', then just use \'tf send\' and \'tf search\'',
+      '🔍 Debug issues: Use \'--verbose\' to see full API responses and troubleshoot',
+      '📝 Scripting: Use \'--output json\' and tools like \'jq\' to parse responses',
+      '⚡ Quick tests: Only --agent-id is required for send, only query for search',
+      '🎯 Better search: Use --status, --topics, and --document-id for targeted results',
+      '🔧 Multiple environments: Use different config files with \'--config\' flag',
     ];
 
     tips.forEach((tip) => {
@@ -657,7 +915,7 @@ program
 
     console.log(
       chalk.dim(
-        "\nToothFairy CLI v1.0.0 - For more help, visit the documentation"
+        '\nToothFairy CLI v1.0.0 - For more help, visit the documentation'
       )
     );
   });