@tryfridayai/cli 0.2.0

package/src/commands/chat/smartAffordances.js

@@ -0,0 +1,139 @@
+/**
+ * chat/smartAffordances.js — Intent detection and contextual hints
+ *
+ * Pre-query: Scans user input for image/voice/video/schedule keywords.
+ *   If the matching capability requires a missing API key, shows a hint.
+ *
+ * Post-response: After `complete`, if agent mentioned missing keys or
+ *   unavailable plugins, shows a tip.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { ORANGE, DIM, RESET, BOLD } from './ui.js';
+
+const CONFIG_DIR = process.env.FRIDAY_CONFIG_DIR || path.join(os.homedir(), '.friday');
+const ENV_FILE = path.join(CONFIG_DIR, '.env');
+
+// ── Intent patterns ──────────────────────────────────────────────────────
+
+const INTENT_PATTERNS = [
+  {
+    capability: 'image',
+    patterns: [
+      /\b(generate|create|make|draw|design)\s+(an?\s+)?image/i,
+      /\b(generate|create|make|draw|design)\s+(an?\s+)?(picture|illustration|photo|artwork|graphic)/i,
+      /\bimage\s+(of|for|with)\b/i,
+    ],
+    requiredKeys: ['OPENAI_API_KEY', 'GOOGLE_API_KEY'],
+    keyLabel: 'OpenAI or Google',
+    hint: 'images',
+  },
+  {
+    capability: 'voice',
+    patterns: [
+      /\b(text.to.speech|tts|speak|say|read\s+aloud|voice|narrate)\b/i,
+      /\bconvert\s+.*\s+to\s+speech/i,
+      /\b(generate|create|make)\s+.*\s+(audio|voice|speech)/i,
+    ],
+    requiredKeys: ['OPENAI_API_KEY', 'ELEVENLABS_API_KEY', 'GOOGLE_API_KEY'],
+    keyLabel: 'OpenAI, ElevenLabs, or Google',
+    hint: 'voice',
+  },
+  {
+    capability: 'video',
+    patterns: [
+      /\b(generate|create|make)\s+(a\s+)?video/i,
+      /\bvideo\s+(of|for|with)\b/i,
+    ],
+    requiredKeys: ['OPENAI_API_KEY', 'GOOGLE_API_KEY'],
+    keyLabel: 'OpenAI or Google',
+    hint: 'video',
+  },
+  {
+    capability: 'schedule',
+    patterns: [
+      /\bschedule\b/i,
+      /\bevery\s+(day|morning|evening|hour|week|monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i,
+      /\b(remind|recurring|automate|cron)\b/i,
+    ],
+    requiredKeys: null, // no key needed, just a tip
+    keyLabel: null,
+    hint: null,
+  },
+];
+
+// ── Helpers ──────────────────────────────────────────────────────────────
+
+function envHasAnyKey(keyNames) {
+  for (const keyName of keyNames) {
+    if (process.env[keyName]) return true;
+  }
+  // Check ~/.friday/.env
+  try {
+    if (fs.existsSync(ENV_FILE)) {
+      const content = fs.readFileSync(ENV_FILE, 'utf8');
+      for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#') || !trimmed.includes('=')) continue;
+        const [key, ...rest] = trimmed.split('=');
+        if (keyNames.includes(key.trim()) && rest.join('=').trim().length > 0) return true;
+      }
+    }
+  } catch { /* ignore */ }
+  return false;
+}
+
+// ── Pre-query hint ───────────────────────────────────────────────────────
+
+/**
+ * Check user input for intent patterns and return a hint string if
+ * a required API key is missing. Returns null if no hint needed.
+ *
+ * @param {string} input - User's message text
+ * @returns {string|null} Hint message to display, or null
+ */
+export function checkPreQueryHint(input) {
+  for (const intent of INTENT_PATTERNS) {
+    const matches = intent.patterns.some(p => p.test(input));
+    if (!matches) continue;
+
+    // If this intent needs keys, check if any are available
+    if (intent.requiredKeys && !envHasAnyKey(intent.requiredKeys)) {
+      return `  ${ORANGE}You need a ${intent.keyLabel} key for ${intent.hint}. Try ${BOLD}/keys${RESET}`;
+    }
+
+    // Schedule intent — offer the /schedule command
+    if (intent.capability === 'schedule') {
+      return `  ${DIM}Tip: Use ${BOLD}/schedule${RESET}${DIM} to manage recurring tasks.${RESET}`;
+    }
+  }
+  return null;
+}
+
+// ── Post-response hint ───────────────────────────────────────────────────
+
+/**
+ * Check the accumulated response text for patterns that suggest
+ * the user should take an action. Returns a hint string or null.
+ *
+ * @param {string} responseText - The accumulated text from the agent response
+ * @returns {string|null} Hint message to display, or null
+ */
+export function checkPostResponseHint(responseText) {
+  if (!responseText) return null;
+  const lower = responseText.toLowerCase();
+
+  // Agent mentioned missing API key
+  if (lower.includes('api key') && (lower.includes('missing') || lower.includes('not set') || lower.includes('not configured') || lower.includes('need'))) {
+    return `  ${DIM}Tip: Use ${BOLD}/keys${RESET}${DIM} to add API keys.${RESET}`;
+  }
+
+  // Agent mentioned a plugin not being available
+  if (lower.includes('plugin') && (lower.includes('not installed') || lower.includes('not available') || lower.includes('not enabled'))) {
+    return `  ${DIM}Tip: Use ${BOLD}/plugins${RESET}${DIM} to install plugins.${RESET}`;
+  }
+
+  return null;
+}

package/src/commands/chat/ui.js

@@ -0,0 +1,146 @@
+/**
+ * chat/ui.js — Visual system for Friday CLI chat
+ *
+ * Brand palette (ANSI 256-color), box drawing, prompt styling,
+ * and formatting helpers shared across all chat modules.
+ */
+
+// ── Brand palette (ANSI 256-color) ──────────────────────────────────────
+
+export const PURPLE = '\x1b[38;5;141m';   // brand primary — prompt, headers
+export const BLUE = '\x1b[38;5;75m';      // links, URLs
+export const TEAL = '\x1b[38;5;43m';      // success, active status
+export const ORANGE = '\x1b[38;5;215m';   // warnings, costs
+export const PINK = '\x1b[38;5;211m';     // media capabilities
+
+// ── Standard ANSI ────────────────────────────────────────────────────────
+
+export const DIM = '\x1b[2m';
+export const RESET = '\x1b[0m';
+export const BOLD = '\x1b[1m';
+export const YELLOW = '\x1b[33m';
+export const RED = '\x1b[31m';
+export const CYAN = '\x1b[36m';
+export const GREEN = '\x1b[32m';
+
+// ── Prompt ───────────────────────────────────────────────────────────────
+
+export const PROMPT_STRING = `${PURPLE}f${RESET} ${BOLD}>${RESET} `;
+
+// ── Box drawing ──────────────────────────────────────────────────────────
+
+/**
+ * Draw a box around content lines.
+ * @param {string} title - Box title (shown in top border)
+ * @param {string[]} lines - Content lines to render inside the box
+ * @param {number} [width=60] - Outer box width
+ * @returns {string} Rendered box string
+ */
+export function drawBox(title, lines, width = 60) {
+  const innerWidth = width - 2; // account for side borders
+  const titleStr = title ? ` ${title} ` : '';
+  const dashCount = innerWidth - titleStr.length;
+  const topBorder = `${PURPLE}\u256d\u2500${titleStr}${'\u2500'.repeat(Math.max(0, dashCount))}\u256e${RESET}`;
+  const bottomBorder = `${PURPLE}\u2570${'\u2500'.repeat(innerWidth)}\u256f${RESET}`;
+
+  const boxLines = [topBorder];
+  for (const line of lines) {
+    // Calculate visible length (strip ANSI codes)
+    const visible = stripAnsi(line);
+    const padding = Math.max(0, innerWidth - visible.length);
+    boxLines.push(`${PURPLE}\u2502${RESET}${line}${' '.repeat(padding)}${PURPLE}\u2502${RESET}`);
+  }
+  boxLines.push(bottomBorder);
+  return boxLines.join('\n');
+}
+
+/**
+ * Strip ANSI escape codes from a string to get visible length.
+ */
+export function stripAnsi(str) {
+  // eslint-disable-next-line no-control-regex
+  return str.replace(/\x1b\[[0-9;]*m/g, '').replace(/\x1b\]8;;[^\x07]*\x07[^\x1b]*\x1b\]8;;\x07/g, (match) => {
+    // OSC 8 hyperlinks — extract display text
+    const displayMatch = match.match(/\x07([^\x1b]*)\x1b/);
+    return displayMatch ? displayMatch[1] : '';
+  });
+}
+
+// ── Formatting helpers ───────────────────────────────────────────────────
+
+/**
+ * Format a label + value pair with consistent alignment.
+ */
+export function labelValue(label, value, labelWidth = 14) {
+  const padded = (label + ':').padEnd(labelWidth);
+  return `  ${DIM}${padded}${RESET} ${value}`;
+}
+
+/**
+ * Render a status badge: green dot for active, dim dot for inactive.
+ */
+export function statusBadge(active, label) {
+  if (active) {
+    return `${TEAL}\u25cf${RESET} ${label}`;
+  }
+  return `${DIM}\u25cb ${label}${RESET}`;
+}
+
+/**
+ * Format a capability icon with optional dim for unconfigured.
+ */
+export function capabilityIcon(emoji, label, configured) {
+  if (configured) {
+    return `${emoji} ${label}`;
+  }
+  return `${DIM}${emoji} ${label}${RESET}`;
+}
+
+/**
+ * Print a section header.
+ */
+export function sectionHeader(text) {
+  return `\n${PURPLE}${BOLD}${text}${RESET}`;
+}
+
+/**
+ * Print a hint message (orange, indented).
+ */
+export function hint(text) {
+  return `  ${ORANGE}${text}${RESET}`;
+}
+
+/**
+ * Print a success message.
+ */
+export function success(text) {
+  return `  ${TEAL}${text}${RESET}`;
+}
+
+/**
+ * Print an error message.
+ */
+export function error(text) {
+  return `  ${RED}${text}${RESET}`;
+}
+
+/**
+ * Mask a secret value, showing only last 4 chars.
+ */
+export function maskSecret(value) {
+  if (!value || value.length <= 4) return '****';
+  return '*'.repeat(value.length - 4) + value.slice(-4);
+}
+
+/**
+ * Group items by a key.
+ */
+export function groupBy(items, keyFn) {
+  const groups = {};
+  for (const item of items) {
+    const key = keyFn(item);
+    if (!groups[key]) groups[key] = [];
+    groups[key].push(item);
+  }
+  return groups;
+}

package/src/commands/chat/welcomeScreen.js

@@ -0,0 +1,161 @@
+/**
+ * chat/welcomeScreen.js — Branded welcome screen for Friday CLI chat
+ *
+ * Renders on `ready` message. Reads local config files directly
+ * (instant, no server round-trip) to show capabilities and plugin status.
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { createRequire } from 'module';
+import {
+  PURPLE, TEAL, DIM, RESET, BOLD, ORANGE,
+  drawBox, capabilityIcon, hint,
+} from './ui.js';
+
+const require = createRequire(import.meta.url);
+
+// ── Resolve paths ────────────────────────────────────────────────────────
+
+let runtimeDir;
+try {
+  const runtimePkg = require.resolve('friday-runtime/package.json');
+  runtimeDir = path.dirname(runtimePkg);
+} catch {
+  runtimeDir = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', '..', '..', '..', 'runtime');
+}
+
+const CONFIG_DIR = process.env.FRIDAY_CONFIG_DIR || path.join(os.homedir(), '.friday');
+const PLUGINS_FILE = path.join(CONFIG_DIR, 'plugins.json');
+const ENV_FILE = path.join(CONFIG_DIR, '.env');
+
+// ── Helpers ──────────────────────────────────────────────────────────────
+
+function readJsonSafe(filePath) {
+  try {
+    if (fs.existsSync(filePath)) {
+      return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+  } catch { /* ignore */ }
+  return null;
+}
+
+function envHasKey(keyName) {
+  // Check process.env first, then ~/.friday/.env
+  if (process.env[keyName]) return true;
+  try {
+    if (fs.existsSync(ENV_FILE)) {
+      const content = fs.readFileSync(ENV_FILE, 'utf8');
+      for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#') || !trimmed.includes('=')) continue;
+        const [key, ...rest] = trimmed.split('=');
+        if (key.trim() === keyName && rest.join('=').trim().length > 0) return true;
+      }
+    }
+  } catch { /* ignore */ }
+  // Also check the project-level .env
+  try {
+    const projectEnv = path.join(runtimeDir, '..', '.env');
+    if (fs.existsSync(projectEnv)) {
+      const content = fs.readFileSync(projectEnv, 'utf8');
+      for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('#') || !trimmed.includes('=')) continue;
+        const [key, ...rest] = trimmed.split('=');
+        if (key.trim() === keyName && rest.join('=').trim().length > 0) return true;
+      }
+    }
+  } catch { /* ignore */ }
+  return false;
+}
+
+// ── Main render ──────────────────────────────────────────────────────────
+
+/**
+ * Render the branded welcome screen.
+ * @returns {string} The welcome screen string to print
+ */
+export function renderWelcome() {
+  // Read version from package.json
+  let version = '0.2.0';
+  try {
+    const cliPkgPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', '..', '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(cliPkgPath, 'utf8'));
+    version = pkg.version || version;
+  } catch { /* ignore */ }
+
+  // Check API key availability
+  const hasAnthropic = envHasKey('ANTHROPIC_API_KEY');
+  const hasOpenAI = envHasKey('OPENAI_API_KEY');
+  const hasGoogle = envHasKey('GOOGLE_API_KEY');
+  const hasElevenLabs = envHasKey('ELEVENLABS_API_KEY');
+
+  // Determine capabilities
+  const chatOk = hasAnthropic || hasOpenAI || hasGoogle;
+  const imageOk = hasOpenAI || hasGoogle;
+  const voiceOk = hasOpenAI || hasElevenLabs || hasGoogle;
+  const videoOk = hasOpenAI || hasGoogle;
+
+  // Read installed plugins
+  const pluginsData = readJsonSafe(PLUGINS_FILE);
+  const installedPlugins = pluginsData?.plugins ? Object.keys(pluginsData.plugins) : [];
+
+  // Read catalog for total count
+  let totalPlugins = 0;
+  let installedNames = [];
+  try {
+    const catalogPath = path.join(runtimeDir, 'src', 'plugins', 'catalog.json');
+    const catalog = readJsonSafe(catalogPath);
+    if (catalog?.plugins) {
+      totalPlugins = Object.keys(catalog.plugins).length;
+      installedNames = installedPlugins
+        .map(id => catalog.plugins[id]?.name || id)
+        .filter(Boolean);
+    }
+  } catch { /* ignore */ }
+
+  // Build capability line
+  const caps = [
+    capabilityIcon('\ud83d\udcac', 'Chat', chatOk),
+    capabilityIcon('\ud83c\udfa8', 'Images', imageOk),
+    capabilityIcon('\ud83d\udd0a', 'Voice', voiceOk),
+    capabilityIcon('\ud83c\udfac', 'Video', videoOk),
+  ].join('   ');
+
+  // Build plugin line
+  let pluginLine;
+  if (installedNames.length > 0) {
+    const names = installedNames.slice(0, 4).join(', ');
+    const suffix = installedNames.length > 4 ? ` +${installedNames.length - 4} more` : '';
+    pluginLine = `  Plugins: ${TEAL}${names}${suffix}${RESET}`;
+    pluginLine += `${DIM}  ${installedNames.length} of ${totalPlugins} installed${RESET}`;
+  } else {
+    pluginLine = `  ${DIM}Plugins: none installed${RESET}${DIM}  0 of ${totalPlugins} available${RESET}`;
+  }
+
+  // Build missing-key hints
+  const hints = [];
+  if (!imageOk || !voiceOk || !videoOk) {
+    hints.push(`  ${DIM}\u2191 ${ORANGE}/keys${DIM} to enable more capabilities${RESET}`);
+  }
+
+  // Assemble box content
+  const boxLines = [
+    '',
+    `  ${caps}`,
+    '',
+    pluginLine,
+    '',
+    `  Type ${BOLD}/help${RESET} for commands, or just start talking.`,
+  ];
+  if (hints.length > 0) {
+    boxLines.push('');
+    boxLines.push(...hints);
+  }
+  boxLines.push('');
+
+  const title = `Friday v${version}`;
+  return '\n' + drawBox(title, boxLines);
+}