nothumanallowed 8.5.1 → 8.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nothumanallowed",
-  "version": "8.5.1",
+  "version": "8.6.0",
   "description": "NotHumanAllowed — 38 AI agents + unified productivity suite. Gmail, Calendar, Drive, Contacts, Tasks, GitHub, Notion, Slack, voice chat, smart scheduler. Zero-dependency CLI.",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -8,7 +8,7 @@ import { spawnCore } from './spawn.mjs';
 import { loadConfig, setConfigValue } from './config.mjs';
 import { checkForUpdates, runUpdate, checkNpmVersion } from './updater.mjs';
 import { download } from './downloader.mjs';
-import { cmdAsk } from './commands/ask.mjs';
+import { cmdAsk, cmdAgentCreate } from './commands/ask.mjs';
 import { cmdPlan } from './commands/plan.mjs';
 import { cmdTasks } from './commands/tasks.mjs';
 import { cmdOps } from './commands/ops.mjs';
@@ -57,6 +57,9 @@ export async function main(argv) {
     case 'ask':
       return cmdAsk(args);
 
+    case 'agent:create':
+      return cmdAgentCreate(args);
+
     case 'run':
       return cmdRun(args);
 

package/src/commands/ask.mjs

@@ -18,9 +18,12 @@ export async function cmdAsk(args) {
   if (!agentName || agentName.startsWith('-')) {
     fail('Usage: nha ask <agent> "your question"');
     fail('       nha ask saber "Audit this Express app for OWASP Top 10"');
-    fail('       nha ask oracle "Analyze this CSV for trends" --file data.csv');
+    fail('       nha ask oracle "Analyze this CSV" --file data.csv');
+    fail('       nha ask forge "What\'s in this?" --image screenshot.png');
     console.log('');
     info('Available agents: ' + AGENTS.join(', '));
+    info('Custom agents in ~/.nha/agents/ are also available.');
+    info('Create one: nha agent:create myagent "Expert in X" "You are..."');
     process.exit(1);
   }
 
@@ -28,6 +31,7 @@ export async function cmdAsk(args) {
   if (!fs.existsSync(agentFile)) {
     fail(`Agent "${agentName}" not found in ~/.nha/agents/`);
     info('Available: ' + AGENTS.join(', '));
+    info('Create custom: nha agent:create <name> <tagline> <system-prompt>');
     process.exit(1);
   }
 
@@ -36,32 +40,33 @@ export async function cmdAsk(args) {
   let model = null;
   let stream = true;
   let attachFile = null;
+  let attachImage = null;
 
   for (let i = 1; i < args.length; i++) {
     if (args[i] === '--provider' && args[i + 1]) { provider = args[++i]; continue; }
     if (args[i] === '--model' && args[i + 1]) { model = args[++i]; continue; }
     if (args[i] === '--no-stream') { stream = false; continue; }
     if (args[i] === '--file' && args[i + 1]) { attachFile = args[++i]; continue; }
+    if (args[i] === '--image' && args[i + 1]) { attachImage = args[++i]; continue; }
     promptParts.push(args[i]);
   }
 
   let userMessage = promptParts.join(' ');
-  if (!userMessage) {
-    fail('No prompt provided.');
-    fail('Usage: nha ask saber "your question here"');
-    process.exit(1);
-  }
 
   if (attachFile) {
     const filePath = path.resolve(attachFile);
-    if (!fs.existsSync(filePath)) {
-      fail(`File not found: ${attachFile}`);
-      process.exit(1);
-    }
+    if (!fs.existsSync(filePath)) { fail(`File not found: ${attachFile}`); process.exit(1); }
     const content = fs.readFileSync(filePath, 'utf-8');
     const maxChars = 100_000;
     const truncated = content.length > maxChars ? content.slice(0, maxChars) + '\n\n[... truncated ...]' : content;
-    userMessage += `\n\n--- Attached file: ${path.basename(filePath)} ---\n${truncated}`;
+    info(`Attached: ${path.basename(filePath)} (${Math.round(content.length / 1024)} KB)`);
+    userMessage = (userMessage || 'Analyze this file') + `\n\n--- Attached file: ${path.basename(filePath)} ---\n${truncated}`;
+  }
+
+  if (!userMessage && !attachImage) {
+    fail('No prompt provided.');
+    fail('Usage: nha ask saber "your question here"');
+    process.exit(1);
   }
 
   const config = loadConfig();
@@ -85,16 +90,92 @@ export async function cmdAsk(args) {
   console.log(`\n  ${BOLD}${card?.displayName || agentName.toUpperCase()}${NC} ${D}(${card?.tagline || card?.category || 'agent'})${NC}`);
   console.log(`  ${D}Provider: ${provider}${model ? ' / ' + model : ''} | Direct call — no server${NC}\n`);
 
-  const callFn = getProviderCall(provider);
-  if (!callFn) {
-    fail(`Unknown provider: ${provider}`);
-    info('Supported: anthropic, openai, gemini, deepseek, grok, mistral, cohere');
-    process.exit(1);
-  }
-
   const startTime = Date.now();
 
   try {
+    // Image attachment — use vision API
+    if (attachImage) {
+      const imagePath = path.resolve(attachImage);
+      if (!fs.existsSync(imagePath)) { fail(`Image not found: ${attachImage}`); process.exit(1); }
+      const imageBuffer = fs.readFileSync(imagePath);
+      const base64 = imageBuffer.toString('base64');
+      const ext = path.extname(imagePath).toLowerCase();
+      const mimeMap = { '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png', '.webp': 'image/webp', '.gif': 'image/gif' };
+      const mimeType = mimeMap[ext] || 'image/jpeg';
+      info(`Attached image: ${path.basename(imagePath)} (${Math.round(base64.length * 3 / 4 / 1024)} KB)`);
+
+      const imagePrompt = userMessage || 'Describe this image in detail. Extract any text, data, or important information.';
+      let response = '';
+
+      if (provider === 'anthropic') {
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' },
+          body: JSON.stringify({
+            model: model || 'claude-sonnet-4-20250514', max_tokens: 8192, system: systemPrompt,
+            messages: [{ role: 'user', content: [
+              { type: 'image', source: { type: 'base64', media_type: mimeType, data: base64 } },
+              { type: 'text', text: imagePrompt },
+            ]}],
+          }),
+        });
+        if (!res.ok) throw new Error(`Anthropic ${res.status}: ${(await res.text()).slice(0, 300)}`);
+        const data = await res.json();
+        response = data.content?.[0]?.text || '';
+      } else if (provider === 'openai') {
+        const res = await fetch('https://api.openai.com/v1/chat/completions', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
+          body: JSON.stringify({
+            model: model || 'gpt-4o-mini', max_tokens: 8192,
+            messages: [
+              { role: 'system', content: systemPrompt },
+              { role: 'user', content: [
+                { type: 'image_url', image_url: { url: `data:${mimeType};base64,${base64}` } },
+                { type: 'text', text: imagePrompt },
+              ]},
+            ],
+          }),
+        });
+        if (!res.ok) throw new Error(`OpenAI ${res.status}: ${(await res.text()).slice(0, 300)}`);
+        const data = await res.json();
+        response = data.choices?.[0]?.message?.content || '';
+      } else if (provider === 'gemini') {
+        const m = model || 'gemini-2.0-flash';
+        const res = await fetch(`https://generativelanguage.googleapis.com/v1beta/models/${m}:generateContent?key=${apiKey}`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            system_instruction: { parts: [{ text: systemPrompt }] },
+            contents: [{ parts: [
+              { inline_data: { mime_type: mimeType, data: base64 } },
+              { text: imagePrompt },
+            ]}],
+            generationConfig: { maxOutputTokens: 8192 },
+          }),
+        });
+        if (!res.ok) throw new Error(`Gemini ${res.status}: ${(await res.text()).slice(0, 300)}`);
+        const data = await res.json();
+        response = data.candidates?.[0]?.content?.parts?.[0]?.text || '';
+      } else {
+        fail(`Vision not supported for "${provider}". Use anthropic, openai, or gemini.`);
+        process.exit(1);
+      }
+
+      console.log(response);
+      const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+      console.log(`\n  ${D}${elapsed}s | ${provider}${model ? ' / ' + model : ''} | ${card?.displayName || agentName}${NC}\n`);
+      return;
+    }
+
+    // Text / file — standard LLM call
+    const callFn = getProviderCall(provider);
+    if (!callFn) {
+      fail(`Unknown provider: ${provider}`);
+      info('Supported: anthropic, openai, gemini, deepseek, grok, mistral, cohere');
+      process.exit(1);
+    }
+
     const useStream = stream && (provider === 'anthropic' || provider === 'openai' || provider === 'deepseek' || provider === 'grok' || provider === 'mistral');
     const result = await callFn(apiKey, model, systemPrompt, userMessage, useStream);
 
@@ -109,3 +190,52 @@ export async function cmdAsk(args) {
     process.exit(1);
   }
 }
+
+/**
+ * nha agent:create <name> <tagline> <system-prompt>
+ * Creates a custom agent file in ~/.nha/agents/
+ */
+export async function cmdAgentCreate(args) {
+  const name = (args[0] || '').toLowerCase().replace(/[^a-z0-9_-]/g, '');
+  const tagline = args[1] || '';
+  const sysPrompt = args.slice(2).join(' ') || '';
+
+  if (!name || !tagline || !sysPrompt) {
+    fail('Usage: nha agent:create <name> "<tagline>" "<system prompt>"');
+    console.log('');
+    info('Example:');
+    info('  nha agent:create reviewer "Code review expert" "You are a senior code reviewer..."');
+    console.log('');
+    info('The agent will be available as: nha ask reviewer "review this code"');
+    process.exit(1);
+  }
+
+  const agentFile = path.join(AGENTS_DIR, `${name}.mjs`);
+  if (fs.existsSync(agentFile)) {
+    fail(`Agent "${name}" already exists at ${agentFile}`);
+    process.exit(1);
+  }
+
+  const content = `// NHA Custom Agent: ${name}
+// Created: ${new Date().toISOString()}
+
+export const CARD = {
+  name: '${name}',
+  displayName: '${name.toUpperCase()}',
+  category: 'custom',
+  tagline: '${tagline.replace(/'/g, "\\'")}',
+};
+
+export const SYSTEM_PROMPT = \`${sysPrompt.replace(/`/g, '\\`')}\`;
+`;
+
+  if (!fs.existsSync(AGENTS_DIR)) {
+    fs.mkdirSync(AGENTS_DIR, { recursive: true });
+  }
+
+  fs.writeFileSync(agentFile, content, 'utf-8');
+  ok(`Agent "${name}" created at ${agentFile}`);
+  info(`Invoke it: nha ask ${name} "your question"`);
+  info(`With file: nha ask ${name} "analyze" --file report.csv`);
+  info(`With image: nha ask ${name} "what is this?" --image photo.jpg`);
+}

package/src/commands/chat.mjs

@@ -11,8 +11,12 @@
  */
 
 import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
 import { loadConfig } from '../config.mjs';
-import { callLLM } from '../services/llm.mjs';
+import { AGENTS_DIR, AGENTS } from '../constants.mjs';
+import { callLLM, parseAgentFile } from '../services/llm.mjs';
+
 import { loadChatHistory, saveChatHistory, extractMemory } from '../services/memory.mjs';
 import { fail, info, ok, warn, C, G, Y, D, W, BOLD, NC, R } from '../ui.mjs';
 import {
@@ -160,17 +164,97 @@ async function handleSlashCommand(input, config, history) {
     return true;
   }
 
+  // /agent <name> — switch to talking with a specific agent
+  if (trimmed.startsWith('/agent ')) {
+    const agentName = trimmed.slice(7).trim().toLowerCase();
+    const agentFile = path.join(AGENTS_DIR, `${agentName}.mjs`);
+    if (!fs.existsSync(agentFile)) {
+      console.log(`  ${R}Agent "${agentName}" not found. Available: ${AGENTS.join(', ')}${NC}`);
+      return true;
+    }
+    const agentSource = fs.readFileSync(agentFile, 'utf-8');
+    const { card, systemPrompt: agentSysPrompt } = parseAgentFile(agentSource, agentName);
+    if (agentSysPrompt) {
+      // Store agent context for subsequent messages
+      config._chatAgent = { name: agentName, systemPrompt: agentSysPrompt, card };
+      console.log(`  ${G}Now chatting with ${BOLD}${card?.displayName || agentName.toUpperCase()}${NC}${G} (${card?.tagline || 'agent'})${NC}`);
+      console.log(`  ${D}Type /agent off to return to NHA Chat${NC}`);
+    } else {
+      console.log(`  ${R}Agent "${agentName}" has no system prompt.${NC}`);
+    }
+    return true;
+  }
+
+  if (trimmed === '/agent off' || trimmed === '/agent reset') {
+    delete config._chatAgent;
+    console.log(`  ${G}Switched back to NHA Chat.${NC}`);
+    return true;
+  }
+
+  // /create-agent — interactive agent creation
+  if (trimmed === '/create-agent') {
+    const readline2 = await import('readline');
+    const rl2 = readline2.default.createInterface({ input: process.stdin, output: process.stdout });
+    const q = (prompt) => new Promise(resolve => rl2.question(prompt, resolve));
+    console.log(`\n  ${BOLD}${Y}Create Custom Agent${NC}\n`);
+    const name = ((await q(`  ${C}Name${NC} (lowercase, no spaces): `)) || '').toLowerCase().replace(/[^a-z0-9_-]/g, '');
+    const tagline = (await q(`  ${C}Tagline${NC} (short description): `)) || '';
+    const sysPrompt = (await q(`  ${C}System prompt${NC} (agent personality): `)) || '';
+    rl2.close();
+
+    if (!name || !tagline || !sysPrompt) {
+      console.log(`  ${R}All fields required.${NC}`);
+      return true;
+    }
+
+    const agentFile = path.join(AGENTS_DIR, `${name}.mjs`);
+    if (fs.existsSync(agentFile)) {
+      console.log(`  ${R}Agent "${name}" already exists.${NC}`);
+      return true;
+    }
+
+    const content = `// NHA Custom Agent: ${name}\n// Created: ${new Date().toISOString()}\n\nexport const CARD = {\n  name: '${name}',\n  displayName: '${name.toUpperCase()}',\n  category: 'custom',\n  tagline: '${tagline.replace(/'/g, "\\'")}',\n};\n\nexport const SYSTEM_PROMPT = \`${sysPrompt.replace(/`/g, '\\`')}\`;\n`;
+    if (!fs.existsSync(AGENTS_DIR)) fs.mkdirSync(AGENTS_DIR, { recursive: true });
+    fs.writeFileSync(agentFile, content, 'utf-8');
+    console.log(`  ${G}Agent "${name}" created!${NC}`);
+    console.log(`  ${D}Switch to it: /agent ${name}${NC}`);
+    return true;
+  }
+
+  // /agents — list available agents
+  if (trimmed === '/agents') {
+    const available = [];
+    if (fs.existsSync(AGENTS_DIR)) {
+      for (const f of fs.readdirSync(AGENTS_DIR)) {
+        if (f.endsWith('.mjs')) available.push(f.replace('.mjs', ''));
+      }
+    }
+    console.log(`  ${BOLD}Available Agents${NC} (${available.length})`);
+    for (const a of available) {
+      console.log(`  ${C}${a}${NC}`);
+    }
+    console.log(`\n  ${D}Switch: /agent <name> | Create: /create-agent${NC}`);
+    return true;
+  }
+
   if (trimmed === '/help') {
     console.log(`
   ${BOLD}Chat Commands${NC}
 
-  ${C}/tasks${NC}    Show today's tasks
-  ${C}/plan${NC}     Run daily planner
-  ${C}/clear${NC}    Clear conversation history
-  ${C}/help${NC}     Show this help
-  ${C}/quit${NC}     Exit chat
+  ${C}/tasks${NC}          Show today's tasks
+  ${C}/plan${NC}           Run daily planner
+  ${C}/agents${NC}         List available agents
+  ${C}/agent <name>${NC}   Switch to chatting with a specific agent
+  ${C}/agent off${NC}      Return to NHA Chat
+  ${C}/create-agent${NC}   Create a new custom agent interactively
+  ${C}/clear${NC}          Clear conversation history
+  ${C}/help${NC}           Show this help
+  ${C}/quit${NC}           Exit chat
 
-  ${D}Otherwise, just type naturally — the AI understands
+  ${D}You can also type @agent in any message to route it to that agent.
+  Example: "@saber audit this function for SQL injection"
+
+  Otherwise, just type naturally — the AI understands
   requests like "show my unread emails", "add a task to review PR #42",
   "what's on my calendar tomorrow?", "list GitHub issues", etc.${NC}
 `);
@@ -256,10 +340,32 @@ export async function cmdChat(args) {
     }
 
     try {
-      const userMessage = serializeHistory(history, input);
+      // Handle @agent inline routing
+      let effectiveSystemPrompt = systemPrompt;
+      let effectiveInput = input;
+      const atMatch = input.match(/^@(\w+)\s+(.*)/s);
+      if (atMatch) {
+        const inlineAgent = atMatch[1].toLowerCase();
+        const inlinePrompt = atMatch[2];
+        const agentFile = path.join(AGENTS_DIR, `${inlineAgent}.mjs`);
+        if (fs.existsSync(agentFile)) {
+          const agentSource = fs.readFileSync(agentFile, 'utf-8');
+          const { card, systemPrompt: agentSysPrompt } = parseAgentFile(agentSource, inlineAgent);
+          if (agentSysPrompt) {
+            effectiveSystemPrompt = agentSysPrompt;
+            effectiveInput = inlinePrompt;
+            process.stdout.write(`  ${D}Routing to ${card?.displayName || inlineAgent.toUpperCase()}...${NC}\n`);
+          }
+        }
+      } else if (config._chatAgent) {
+        // Persistent agent mode via /agent <name>
+        effectiveSystemPrompt = config._chatAgent.systemPrompt;
+      }
+
+      const userMessage = serializeHistory(history, effectiveInput);
 
       process.stdout.write(`\n  ${D}Thinking...${NC}`);
-      const response = await callLLM(config, systemPrompt, userMessage);
+      const response = await callLLM(config, effectiveSystemPrompt, userMessage);
       process.stdout.write('\r' + ' '.repeat(40) + '\r');
 
       const { textParts, actions } = parseActions(response);