@stevederico/dotbot 0.25.0 → 0.27.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+0.27
+
+  Add interactive API key prompt
+  Add key saving to dotbotrc
+  Add provider signup URLs
+  Update thinking spinner display
+
+0.26
+
+  Update REPL prompt style
+  Add visible thinking output
+  Add /help, /show, /bye commands
+  Add multi-line input mode
+
 0.25
 
   Add delete subcommands for memory, jobs, tasks, sessions

package/bin/dotbot.js

@@ -22,7 +22,7 @@ process.emit = function (event, error) {
  */
 
 import { parseArgs } from 'node:util';
-import { readFileSync, existsSync } from 'node:fs';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
@@ -162,7 +162,18 @@ function loadConfig() {
   }
   try {
     const content = readFileSync(CONFIG_PATH, 'utf8');
-    return JSON.parse(content);
+    const config = JSON.parse(content);
+
+    // Inject saved API keys into process.env (don't override existing)
+    if (config.env && typeof config.env === 'object') {
+      for (const [key, value] of Object.entries(config.env)) {
+        if (!process.env[key]) {
+          process.env[key] = value;
+        }
+      }
+    }
+
+    return config;
   } catch (err) {
     console.error(`Warning: Invalid config file at ${CONFIG_PATH}: ${err.message}`);
     return {};
@@ -214,7 +225,42 @@ function parseCliArgs() {
 }
 
 /**
- * Get provider config with API key from environment.
+ * Prompt user for input via readline.
+ *
+ * @param {string} question - Prompt text
+ * @returns {Promise<string>} User input
+ */
+function askUser(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Save or update a key in ~/.dotbotrc config file.
+ *
+ * @param {string} key - Config key
+ * @param {*} value - Config value
+ */
+function saveToConfig(key, value) {
+  let config = {};
+  if (existsSync(CONFIG_PATH)) {
+    try {
+      config = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));
+    } catch {
+      config = {};
+    }
+  }
+  config[key] = value;
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+
+/**
+ * Get provider config with API key from environment or interactive prompt.
  *
  * @param {string} providerId - Provider ID
  * @returns {Object} Provider config with headers
@@ -228,25 +274,60 @@ async function getProviderConfig(providerId) {
     process.exit(1);
   }
 
-  const envKey = base.envKey;
-  const apiKey = process.env[envKey];
-
-  if (!apiKey && providerId !== 'ollama') {
-    console.error(`Missing ${envKey} environment variable`);
-    process.exit(1);
-  }
-
   if (providerId === 'ollama') {
     const baseUrl = process.env.OLLAMA_BASE_URL || 'http://localhost:11434';
     return { ...base, apiUrl: `${baseUrl}/api/chat` };
   }
 
+  const envKey = base.envKey;
+  let apiKey = process.env[envKey];
+
+  if (!apiKey) {
+    if (!process.stdin.isTTY) {
+      console.error(`Missing ${envKey} environment variable.`);
+      console.error(`Get one at: ${getProviderSignupUrl(providerId)}`);
+      process.exit(1);
+    }
+
+    console.log(`\n${base.name} API key not found (${envKey}). Get one at: ${getProviderSignupUrl(providerId)}\n`);
+
+    apiKey = await askUser(`Paste your ${base.name} API key: `);
+    if (!apiKey) {
+      console.error('No API key provided.');
+      process.exit(1);
+    }
+
+    const save = await askUser('Save to ~/.dotbotrc for next time? (Y/n) ');
+    if (save.toLowerCase() !== 'n') {
+      saveToConfig('env', { ...loadConfig().env, [envKey]: apiKey });
+      console.log(`Saved to ${CONFIG_PATH}\n`);
+    }
+
+    process.env[envKey] = apiKey;
+  }
+
   return {
     ...base,
     headers: () => base.headers(apiKey),
   };
 }
 
+/**
+ * Get signup/API key URL for a provider.
+ *
+ * @param {string} providerId - Provider ID
+ * @returns {string} URL to get an API key
+ */
+function getProviderSignupUrl(providerId) {
+  const urls = {
+    xai: 'https://console.x.ai',
+    openai: 'https://platform.openai.com/api-keys',
+    anthropic: 'https://console.anthropic.com/settings/keys',
+    cerebras: 'https://cloud.cerebras.ai',
+  };
+  return urls[providerId] || 'the provider\'s website';
+}
+
 /**
  * Initialize stores.
  *
@@ -331,7 +412,10 @@ async function runChat(message, options) {
     ...storesObj,
   };
 
-  process.stdout.write('\n[thinking] ');
+  let hasThinkingText = false;
+  let thinkingDone = false;
+
+  process.stdout.write('Thinking');
   startSpinner();
 
   for await (const event of agentLoop({
@@ -343,14 +427,35 @@ async function runChat(message, options) {
   })) {
     switch (event.type) {
       case 'thinking':
-        // Already showing spinner, ignore thinking events
+        if (event.text) {
+          if (!hasThinkingText) {
+            stopSpinner('');
+            process.stdout.write('\n');
+            hasThinkingText = true;
+          }
+          process.stdout.write(event.text);
+        }
         break;
       case 'text_delta':
-        stopSpinner('');  // Stop thinking spinner silently
+        if (!thinkingDone) {
+          if (hasThinkingText) {
+            process.stdout.write('\n...done thinking.\n\n');
+          } else {
+            stopSpinner('');
+          }
+          thinkingDone = true;
+        }
         process.stdout.write(event.text);
         break;
       case 'tool_start':
-        stopSpinner('');  // Stop thinking spinner silently
+        if (!thinkingDone) {
+          if (hasThinkingText) {
+            process.stdout.write('\n...done thinking.\n\n');
+          } else {
+            stopSpinner('');
+          }
+          thinkingDone = true;
+        }
         process.stdout.write(`[${event.name}] `);
         startSpinner();
         break;
@@ -410,18 +515,55 @@ async function runRepl(options) {
   if (options.session) {
     console.log(`Resuming session: ${session.id}`);
   }
-  console.log('Type /quit to exit, /clear to reset conversation\n');
+  console.log('Type /? for help\n');
+
+  const showHelp = () => {
+    console.log('Available Commands:');
+    console.log('  /show            Show model information');
+    console.log('  /clear           Clear session context');
+    console.log('  /bye             Exit');
+    console.log('  /?, /help        Help for a command');
+    console.log('');
+    console.log('Use """ to begin a multi-line message.\n');
+  };
 
-  const prompt = () => {
-    rl.question('> ', async (input) => {
+  const showModel = () => {
+    console.log(`  Model:    ${options.model}`);
+    console.log(`  Provider: ${options.provider}`);
+    console.log(`  Session:  ${session.id}\n`);
+  };
+
+  const promptUser = () => {
+    rl.question('>>> ', async (input) => {
       const trimmed = input.trim();
 
       if (!trimmed) {
-        prompt();
+        promptUser();
+        return;
+      }
+
+      // Multi-line input mode
+      if (trimmed === '"""') {
+        let multiLine = '';
+        const collectLines = () => {
+          rl.question('... ', (line) => {
+            if (line.trim() === '"""') {
+              if (multiLine.trim()) {
+                handleMessage(multiLine.trim());
+              } else {
+                promptUser();
+              }
+            } else {
+              multiLine += (multiLine ? '\n' : '') + line;
+              collectLines();
+            }
+          });
+        };
+        collectLines();
         return;
       }
 
-      if (trimmed === '/quit' || trimmed === '/exit') {
+      if (trimmed === '/bye' || trimmed === '/quit' || trimmed === '/exit') {
         console.log('Goodbye!');
         rl.close();
         process.exit(0);
@@ -430,64 +572,104 @@ async function runRepl(options) {
       if (trimmed === '/clear') {
         messages.length = 0;
         console.log('Conversation cleared.\n');
-        prompt();
+        promptUser();
         return;
       }
 
-      messages.push({ role: 'user', content: trimmed });
+      if (trimmed === '/?' || trimmed === '/help') {
+        showHelp();
+        promptUser();
+        return;
+      }
 
-      process.stdout.write('\n[thinking] ');
-      startSpinner();
-      let assistantContent = '';
+      if (trimmed === '/show') {
+        showModel();
+        promptUser();
+        return;
+      }
 
-      try {
-        for await (const event of agentLoop({
-          model: options.model,
-          messages: [...messages],
-          tools: coreTools,
-          provider,
-          context,
-        })) {
-          switch (event.type) {
-            case 'thinking':
-              // Already showing spinner, ignore thinking events
-              break;
-            case 'text_delta':
-              stopSpinner('');  // Stop thinking spinner silently
+      await handleMessage(trimmed);
+    });
+  };
+
+  const handleMessage = async (text) => {
+    messages.push({ role: 'user', content: text });
+
+    let hasThinkingText = false;
+    let thinkingDone = false;
+    let assistantContent = '';
+
+    process.stdout.write('Thinking');
+    startSpinner();
+
+    try {
+      for await (const event of agentLoop({
+        model: options.model,
+        messages: [...messages],
+        tools: coreTools,
+        provider,
+        context,
+      })) {
+        switch (event.type) {
+          case 'thinking':
+            if (event.text) {
+              if (!hasThinkingText) {
+                stopSpinner('');
+                process.stdout.write('\n');
+                hasThinkingText = true;
+              }
               process.stdout.write(event.text);
-              assistantContent += event.text;
-              break;
-            case 'tool_start':
-              stopSpinner('');  // Stop thinking spinner silently
-              process.stdout.write(`[${event.name}] `);
-              startSpinner();
-              break;
-            case 'tool_result':
-              stopSpinner('done');
-              break;
-            case 'tool_error':
-              stopSpinner('error');
-              break;
-            case 'error':
-              stopSpinner();
-              console.error(`\nError: ${event.error}`);
-              break;
-          }
+            }
+            break;
+          case 'text_delta':
+            if (!thinkingDone) {
+              if (hasThinkingText) {
+                process.stdout.write('\n...done thinking.\n\n');
+              } else {
+                stopSpinner('');
+              }
+              thinkingDone = true;
+            }
+            process.stdout.write(event.text);
+            assistantContent += event.text;
+            break;
+          case 'tool_start':
+            if (!thinkingDone) {
+              if (hasThinkingText) {
+                process.stdout.write('\n...done thinking.\n\n');
+              } else {
+                stopSpinner('');
+              }
+              thinkingDone = true;
+            }
+            process.stdout.write(`[${event.name}] `);
+            startSpinner();
+            break;
+          case 'tool_result':
+            stopSpinner('done');
+            break;
+          case 'tool_error':
+            stopSpinner('error');
+            break;
+          case 'error':
+            stopSpinner();
+            console.error(`\nError: ${event.error}`);
+            break;
         }
+      }
 
-        if (assistantContent) {
-          messages.push({ role: 'assistant', content: assistantContent });
-        }
-      } catch (err) {
-        console.error(`\nError: ${err.message}`);
+      if (assistantContent) {
+        messages.push({ role: 'assistant', content: assistantContent });
       }
+    } catch (err) {
+      console.error(`\nError: ${err.message}`);
+    }
 
-      process.stdout.write('\n\n');
-      prompt();
-    });
+    process.stdout.write('\n\n');
+    promptUser();
   };
 
-  prompt();
+  promptUser();
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stevederico/dotbot",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "AI agent CLI and library for Node.js — streaming, multi-provider, tool execution, autonomous tasks",
   "type": "module",
   "main": "index.js",