dotdotdot-cli 1.0.0

package/lib/tokens.js

@@ -0,0 +1,291 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// tokens.js — Token usage tracking & cumulative stats
+// ─────────────────────────────────────────────────────────────────────────────
+
+const fs   = require('fs');
+const path = require('path');
+const { CONFIG_DIR, ensureDirs } = require('./config');
+const { dim, cyan, yellow, green, gray, bold, brightWhite, c256 } = require('./colors');
+
+const TOKENS_FILE = path.join(CONFIG_DIR, 'token-usage.json');
+
+// ─── Pricing per 1M tokens (USD) ───────────────────────────────────────────
+// Format: { input: $/1M input tokens, output: $/1M output tokens }
+// Prices sourced from provider pricing pages. Update as needed.
+
+const PRICING = {
+  // ── OpenRouter models ──
+  'google/gemma-4-26b-a4b-it':                   { input: 0.10, output: 0.10 },
+  'google/gemini-2.5-flash-preview:thinking':     { input: 0.15, output: 3.50 },
+  'openai/gpt-4o-mini':                           { input: 0.15, output: 0.60 },
+  'anthropic/claude-3.5-haiku':                   { input: 0.80, output: 4.00 },
+  'meta-llama/llama-3.1-70b-instruct':            { input: 0.40, output: 0.40 },
+  'google/gemini-2.0-flash-001':                  { input: 0.10, output: 0.40 },
+
+  // ── Anthropic direct ──
+  'claude-haiku-4-5-20251001':                    { input: 0.80, output: 4.00 },
+  'claude-sonnet-4-20250514':                     { input: 3.00, output: 15.00 },
+  'claude-3-5-haiku-20241022':                    { input: 0.80, output: 4.00 },
+
+  // ── OpenAI direct ──
+  'gpt-4o-mini':                                  { input: 0.15, output: 0.60 },
+  'gpt-4o':                                       { input: 2.50, output: 10.00 },
+  'gpt-4-turbo':                                  { input: 10.00, output: 30.00 },
+
+  // ── Google Gemini direct ──
+  'gemini-2.0-flash':                             { input: 0.10, output: 0.40 },
+  'gemini-2.0-flash-lite':                        { input: 0.075, output: 0.30 },
+  'gemini-1.5-pro':                               { input: 1.25, output: 5.00 },
+};
+
+// ─── User-defined pricing (from config.json) ───────────────────────────────
+
+function loadUserPricing() {
+  try {
+    const { loadConfig } = require('./config');
+    const config = loadConfig();
+    return config.pricing || {};
+  } catch { return {}; }
+}
+
+// Check user pricing first, then hardcoded, with fuzzy fallback
+function getModelPricing(model) {
+  // 1. User-defined exact match
+  const userPricing = loadUserPricing();
+  if (userPricing[model]) return userPricing[model];
+
+  // 2. Hardcoded exact match
+  if (PRICING[model]) return PRICING[model];
+
+  // 3. Fuzzy match across both (user first, then hardcoded)
+  for (const [key, val] of Object.entries(userPricing)) {
+    if (key.includes(model) || model.includes(key)) return val;
+  }
+  for (const [key, val] of Object.entries(PRICING)) {
+    if (key.includes(model) || model.includes(key)) return val;
+  }
+  return null;
+}
+
+function saveUserPricing(model, input, output) {
+  const { loadConfig, saveConfig } = require('./config');
+  const config = loadConfig();
+  if (!config.pricing) config.pricing = {};
+  config.pricing[model] = { input, output };
+  saveConfig(config);
+}
+
+// ─── Estimate cost for a single request ─────────────────────────────────────
+
+function estimateCost(tokenUsage, provider, model) {
+  if (!tokenUsage) return null;
+  const pricing = getModelPricing(model);
+  if (!pricing) return null;
+  const inputCost  = (tokenUsage.inputTokens / 1_000_000) * pricing.input;
+  const outputCost = (tokenUsage.outputTokens / 1_000_000) * pricing.output;
+  const total = inputCost + outputCost;
+  if (total < 0.000001) return '0.000000';
+  if (total < 0.01) return total.toFixed(6);
+  if (total < 1) return total.toFixed(4);
+  return total.toFixed(2);
+}
+
+// ─── Load / Save ────────────────────────────────────────────────────────────
+
+function loadUsage() {
+  try {
+    const raw = fs.readFileSync(TOKENS_FILE, 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return {
+      totalInputTokens: 0,
+      totalOutputTokens: 0,
+      totalTokens: 0,
+      requestCount: 0,
+      history: [],        // last 50 entries
+      firstUsed: null,
+    };
+  }
+}
+
+function saveUsage(data) {
+  ensureDirs();
+  fs.writeFileSync(TOKENS_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });
+}
+
+// ─── Record a request ───────────────────────────────────────────────────────
+
+function recordUsage(tokenUsage, provider, model) {
+  if (!tokenUsage) return;
+
+  const cost = estimateCost(tokenUsage, provider, model);
+  const costNum = cost ? parseFloat(cost) : 0;
+
+  const data = loadUsage();
+  const entry = {
+    inputTokens: tokenUsage.inputTokens || 0,
+    outputTokens: tokenUsage.outputTokens || 0,
+    totalTokens: tokenUsage.totalTokens || 0,
+    estimated: !!tokenUsage.estimated,
+    cost: costNum,
+    provider,
+    model,
+    timestamp: new Date().toISOString(),
+  };
+
+  data.totalInputTokens  += entry.inputTokens;
+  data.totalOutputTokens += entry.outputTokens;
+  data.totalTokens       += entry.totalTokens;
+  data.totalCost          = (data.totalCost || 0) + costNum;
+  data.requestCount      += 1;
+  if (!data.firstUsed) data.firstUsed = entry.timestamp;
+
+  // Keep last 50 entries
+  data.history.push(entry);
+  while (data.history.length > 50) data.history.shift();
+
+  saveUsage(data);
+  return entry;
+}
+
+// ─── Format token count for display ─────────────────────────────────────────
+
+function formatTokens(n) {
+  if (n >= 1000000) return (n / 1000000).toFixed(1) + 'M';
+  if (n >= 1000) return (n / 1000).toFixed(1) + 'k';
+  return String(n);
+}
+
+// ─── Inline display (after a request) ───────────────────────────────────────
+
+const subtle = c256(240);
+const tokenColor = c256(39);
+
+function tokenLine(tokenUsage) {
+  if (!tokenUsage) return '';
+  const est = tokenUsage.estimated ? ' ~' : '';
+  const input  = formatTokens(tokenUsage.inputTokens);
+  const output = formatTokens(tokenUsage.outputTokens);
+  const total  = formatTokens(tokenUsage.totalTokens);
+  return `${subtle('tokens:')} ${tokenColor(input)}${subtle(' in')} ${tokenColor(output)}${subtle(' out')} ${subtle('(')}${tokenColor(total)}${subtle(' total')}${est}${subtle(')')}`;
+}
+
+// ─── Full stats display (for --tokens flag) ─────────────────────────────────
+
+function formatCost(cost) {
+  if (!cost || cost === 0) return '$0.00';
+  if (cost < 0.01) return `$${cost.toFixed(6)}`;
+  if (cost < 1) return `$${cost.toFixed(4)}`;
+  return `$${cost.toFixed(2)}`;
+}
+
+function printTokenStats() {
+  const { printBanner } = require('./renderer');
+  const data = loadUsage();
+
+  printBanner();
+
+  if (data.requestCount === 0) {
+    console.log();
+    console.log(`  ${subtle('No usage recorded yet. Start with:')} ${brightWhite('... <your request>')}`);
+    console.log();
+    return;
+  }
+
+  const avgInput  = Math.round(data.totalInputTokens / data.requestCount);
+  const avgOutput = Math.round(data.totalOutputTokens / data.requestCount);
+  const avgTotal  = Math.round(data.totalTokens / data.requestCount);
+  const totalCost = data.totalCost || 0;
+  const avgCost   = totalCost / data.requestCount;
+  const costColor = c256(220); // gold
+  const headerColor = c256(39); // bright blue
+  const lineChar = '\u2500';
+  const w = 44;
+
+  console.log();
+
+  // ── Totals ──
+  console.log(`  ${headerColor(bold('Totals'))}`);
+  console.log(`  ${subtle(lineChar.repeat(w))}`);
+  console.log(`    ${subtle('Requests')}       ${brightWhite(String(data.requestCount))}`);
+  console.log(`    ${subtle('Input')}          ${tokenColor(formatTokens(data.totalInputTokens))} ${subtle('tokens')}`);
+  console.log(`    ${subtle('Output')}         ${tokenColor(formatTokens(data.totalOutputTokens))} ${subtle('tokens')}`);
+  console.log(`    ${subtle('Combined')}       ${tokenColor(formatTokens(data.totalTokens))} ${subtle('tokens')}`);
+  console.log(`    ${subtle('Cost')}           ${costColor(formatCost(totalCost))}`);
+  console.log();
+
+  // ── Averages ──
+  console.log(`  ${headerColor(bold('Per Request'))}`);
+  console.log(`  ${subtle(lineChar.repeat(w))}`);
+  console.log(`    ${subtle('Input')}          ${tokenColor(formatTokens(avgInput))}`);
+  console.log(`    ${subtle('Output')}         ${tokenColor(formatTokens(avgOutput))}`);
+  console.log(`    ${subtle('Combined')}       ${tokenColor(formatTokens(avgTotal))}`);
+  console.log(`    ${subtle('Cost')}           ${costColor(formatCost(avgCost))}`);
+
+  // ── Recent ──
+  if (data.history.length > 0) {
+    console.log();
+    console.log(`  ${headerColor(bold('Recent'))}`);
+    console.log(`  ${subtle(lineChar.repeat(w))}`);
+    const recent = data.history.slice(-5);
+    for (let i = 0; i < recent.length; i++) {
+      const entry = recent[i];
+      const date = new Date(entry.timestamp);
+      const ts = `${(date.getMonth()+1).toString().padStart(2,'0')}/${date.getDate().toString().padStart(2,'0')} ${date.getHours().toString().padStart(2,'0')}:${date.getMinutes().toString().padStart(2,'0')}`;
+      const model = entry.model.split('/').pop();
+      const est = entry.estimated ? subtle('~') : '';
+      const entryCost = entry.cost ? costColor(formatCost(entry.cost)) : subtle('—');
+      console.log(`    ${subtle(ts)}  ${tokenColor(formatTokens(entry.totalTokens))}${est} ${subtle('tokens')}  ${entryCost}  ${subtle(model)}`);
+    }
+  }
+
+  // ── Footer ──
+  if (data.firstUsed) {
+    console.log();
+    console.log(`  ${subtle('tracking since ' + new Date(data.firstUsed).toLocaleDateString())}`);
+  }
+  console.log();
+}
+
+async function printTokenStatsInteractive() {
+  const { selectMenu } = require('./menu');
+  const { printSuccess } = require('./renderer');
+
+  printTokenStats();
+
+  const choice = await selectMenu([
+    { label: 'Exit', key: 'q' },
+    { label: 'Reset usage', key: 'r' },
+  ]);
+
+  if (choice === 'r') {
+    resetUsage();
+    printSuccess('Usage stats reset.');
+    console.log();
+  }
+}
+
+// ─── Reset stats ────────────────────────────────────────────────────────────
+
+function resetUsage() {
+  try {
+    fs.unlinkSync(TOKENS_FILE);
+  } catch { /* ignore */ }
+}
+
+module.exports = {
+  recordUsage,
+  tokenLine,
+  estimateCost,
+  getModelPricing,
+  saveUserPricing,
+  printTokenStats,
+  printTokenStatsInteractive,
+  resetUsage,
+  formatTokens,
+  formatCost,
+  loadUsage,
+  PRICING,
+};

package/lib/ui.js

@@ -0,0 +1,207 @@
+'use strict';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ui.js — Help, config display, setup wizard
+// ─────────────────────────────────────────────────────────────────────────────
+
+const path = require('path');
+const { bold, dim, cyan, gray, green, yellow, red, brightWhite, brightCyan, symbols, c256 } = require('./colors');
+const { loadConfig, saveConfig, maskKey, PROVIDERS, getAllProviderIds, CONFIG_FILE } = require('./config');
+const { textInput, selectMenu } = require('./menu');
+const { printBanner, keyValue, printError, printSuccess, accent, subtle, mid, dot1, dot2, dot3 } = require('./renderer');
+const { getModelPricing, PRICING } = require('./tokens');
+
+const pkg = require(path.join(__dirname, '..', 'package.json'));
+
+// ─── Help ───────────────────────────────────────────────────────────────────
+
+function printHelp() {
+  printBanner();
+  console.log(`  ${subtle('say what you need. it handles the rest.')}`);
+  console.log();
+  const pad = (s, w) => s + ' '.repeat(Math.max(0, w - s.length));
+  console.log(`  ${subtle('$')} ${pad('... kill node', 26)} ${subtle('$')} ... find .tmp then delete`);
+  console.log(`  ${subtle('$')} ${pad('... show disk usage', 26)} ${subtle('$')} ... read desktop, reorganize`);
+  console.log(`  ${subtle('$')} ${pad('... compress this folder', 26)} ${subtle('$')} ... build then deploy`);
+  console.log();
+  console.log(`  ${accent('-t')} ${subtle('task')}  ${accent('-p')} ${subtle('provider')}  ${accent('-u')} ${subtle('usage')}  ${accent('-c')} ${subtle('config')}  ${accent('-d')} ${subtle('debug')}`);
+  console.log();
+}
+
+// ─── Provider list helper ───────────────────────────────────────────────────
+
+function printProviderList(config) {
+  const providerIds = getAllProviderIds();
+  for (let i = 0; i < providerIds.length; i++) {
+    const id = providerIds[i];
+    const prov = config.providers[id];
+    const info = PROVIDERS[id];
+    const isActive = id === config.provider;
+    const hasKey = !!prov.apiKey;
+    const num = subtle(`${i + 1}`);
+    const mark = isActive ? green(symbols.check) : hasKey ? subtle(symbols.check) : subtle(symbols.cross);
+    const name = isActive ? brightWhite(info.name) : hasKey ? mid(info.name) : subtle(info.name);
+    const key = hasKey ? subtle(' ' + maskKey(prov.apiKey)) : '';
+    console.log(`    ${mark} ${num} ${name}${key}`);
+  }
+}
+
+// ─── Config ─────────────────────────────────────────────────────────────────
+
+function showConfig(config) {
+  printBanner();
+  console.log();
+  console.log(keyValue('provider ', `${config.provider} ${subtle('(' + config.model + ')')}`));
+  console.log(keyValue('api key  ', maskKey(config.apiKey)));
+  console.log(keyValue('auto-exec', config.autoExec ? green('on') : subtle('off')));
+  console.log(keyValue('config   ', CONFIG_FILE));
+  console.log();
+  printProviderList(config);
+  console.log();
+}
+
+async function printConfig(config) {
+  showConfig(config);
+
+  const choice = await selectMenu([
+    { label: 'Exit', key: 'q' },
+    { label: 'Edit', key: 'e' },
+  ]);
+
+  if (choice === 'e') {
+    await runSetup();
+  }
+}
+
+// ─── Setup wizard ───────────────────────────────────────────────────────────
+
+async function runSetup() {
+  const config = loadConfig();
+
+  printBanner();
+  console.log();
+  printProviderList(config);
+  console.log();
+
+  const providerIds = getAllProviderIds();
+  const total = providerIds.length;
+  const selection = await textInput(
+    `Configure which? ${subtle(`(1-${total}, all, or name)`)}`,
+    'all'
+  );
+
+  let selectedIds;
+  if (selection.toLowerCase() === 'all') {
+    selectedIds = providerIds;
+  } else {
+    selectedIds = selection.split(/[,\s]+/).map(s => {
+      const num = parseInt(s);
+      if (num >= 1 && num <= providerIds.length) return providerIds[num - 1];
+      if (providerIds.includes(s)) return s;
+      return null;
+    }).filter(Boolean);
+  }
+
+  if (!selectedIds.length) { printError('No valid provider.'); return; }
+
+  const enterHint = subtle('enter to keep current');
+
+  for (const id of selectedIds) {
+    const info = PROVIDERS[id];
+    const prov = config.providers[id];
+    const isCustom = id === 'custom';
+
+    console.log(`\n  ${bold(info.name)}`);
+
+    // API key — masked, never exposed
+    const newKey = await textInput(`  Key ${enterHint}`, prov.apiKey, {
+      displayDefault: prov.apiKey ? maskKey(prov.apiKey) : 'not set',
+    });
+    if (newKey) config.providers[id].apiKey = newKey;
+
+    // Custom provider needs API URL
+    if (isCustom) {
+      const urlChoice = await textInput(`  API URL ${enterHint}`, prov.apiUrl || '', {
+        displayDefault: prov.apiUrl || 'https://your-api.com/v1/chat/completions',
+      });
+      if (urlChoice) config.providers[id].apiUrl = urlChoice;
+    }
+
+    // Model
+    const modelChoice = await textInput(`  Model ${enterHint}`, prov.model);
+    if (modelChoice) config.providers[id].model = modelChoice;
+
+    // Pricing — simple "set or skip"
+    const activeModel = config.providers[id].model;
+    const existing = getModelPricing(activeModel);
+
+    const inputPrice = await textInput(
+      `  Price $/1M input ${subtle('enter to skip')}`,
+      '', { displayDefault: existing ? `current: ${existing.input}` : '' }
+    );
+    if (inputPrice) {
+      const outputPrice = await textInput(
+        `  Price $/1M output ${subtle('enter to skip')}`,
+        '', { displayDefault: existing ? `current: ${existing.output}` : '' }
+      );
+      const inP = parseFloat(inputPrice);
+      const outP = parseFloat(outputPrice);
+      if (!isNaN(inP) && outP && !isNaN(outP)) {
+        if (!config.pricing) config.pricing = {};
+        config.pricing[activeModel] = { input: inP, output: outP };
+      } else if (!isNaN(inP)) {
+        if (!config.pricing) config.pricing = {};
+        config.pricing[activeModel] = { input: inP, output: existing ? existing.output : 0 };
+      }
+    }
+  }
+
+  // ─── Default provider ───────────────────────────────────────────────
+  const configured = providerIds.filter(id => config.providers[id].apiKey);
+  if (configured.length > 0) {
+    console.log(`\n  ${bold('Default Provider')}`);
+    for (let i = 0; i < configured.length; i++) {
+      const id = configured[i];
+      const info = PROVIDERS[id];
+      const isActive = id === config.provider;
+      const mark = isActive ? green(symbols.check) : subtle(symbols.check);
+      const name = isActive ? brightWhite(info.name) : mid(info.name);
+      console.log(`    ${mark} ${subtle(String(i + 1))} ${name}`);
+    }
+    console.log();
+    const choice = await textInput(
+      `Set default ${enterHint}`,
+      '', { displayDefault: config.provider }
+    );
+    if (choice) {
+      const num = parseInt(choice);
+      if (num >= 1 && num <= configured.length) config.provider = configured[num - 1];
+      else if (configured.includes(choice)) config.provider = choice;
+    }
+  } else if (configured.length === 1) {
+    config.provider = configured[0];
+  }
+
+  // ─── Auto-execute ───────────────────────────────────────────────────
+  console.log();
+  const autoChoice = await textInput(
+    `Auto-execute ${subtle('skip menu, run commands directly')}`,
+    config.autoExec ? 'on' : 'off'
+  );
+  const lower = autoChoice.toLowerCase();
+  config.autoExec = (lower === 'on' || lower === 'yes' || lower === 'y' || lower === 'true' || lower === '1');
+
+  // ─── Save ───────────────────────────────────────────────────────────
+  const active = config.providers[config.provider];
+  config.apiKey = active?.apiKey || '';
+  config.model = active?.model || '';
+  config.apiUrl = active?.apiUrl || '';
+  saveConfig(config);
+
+  console.log();
+  const provName = PROVIDERS[config.provider]?.name || config.provider;
+  printSuccess(`Saved. Using ${bold(provName)} (${config.model})${config.autoExec ? bold(' auto-exec on') : ''}`);
+  console.log();
+}
+
+module.exports = { printHelp, printConfig, runSetup };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "dotdotdot-cli",
+  "version": "1.0.0",
+  "description": "Say what you need. It handles the rest. Natural language terminal commands & multi-step tasks. Zero dependencies.",
+  "main": "lib/index.js",
+  "bin": {
+    "...": "bin/dotdotdot.js",
+    "dotdotdot": "bin/dotdotdot.js"
+  },
+  "scripts": {
+    "postinstall": "node lib/postinstall.js",
+    "test": "node bin/dotdotdot.js --help"
+  },
+  "engines": {
+    "node": ">= 18.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "keywords": [
+    "cli",
+    "ai",
+    "terminal",
+    "shell",
+    "natural-language",
+    "llm",
+    "command-line",
+    "dotdotdot",
+    "zero-dependencies",
+    "multi-step",
+    "task-planner",
+    "openrouter",
+    "anthropic",
+    "openai",
+    "gemini",
+    "devtools"
+  ],
+  "author": "Shell3Dots",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Shell3Dots/dotdotdot.git"
+  },
+  "homepage": "https://github.com/Shell3Dots/dotdotdot#readme",
+  "bugs": {
+    "url": "https://github.com/Shell3Dots/dotdotdot/issues"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ]
+}