@kernel.chat/kbot 2.5.0 → 2.8.0

package/dist/cli.js

@@ -16,20 +16,20 @@ import { gatherContext } from './context.js';
 import { registerAllTools } from './tools/index.js';
 import { clearHistory, clearMemory, compactHistory, restoreHistory } from './memory.js';
 import { saveSession, loadSession, listSessions, deleteSession, formatSessionList, } from './sessions.js';
-import { createAgent, removeAgent, getAgent, formatAgentList, formatAgentDetail, PRESETS, getMatrixAgentIds, activateMimic, listMimicProfiles, getMimicProfile, } from './matrix.js';
+import { createAgent, removeAgent, getAgent, formatAgentList, formatAgentDetail, PRESETS, getMatrixAgentIds, activateMimic, listMimicProfiles, getMimicProfile, registerBuiltinAgents, formatBuiltinAgentList, formatBuiltinAgentDetail, } from './matrix.js';
 import { getExtendedStats, incrementSessions, learnFact, selfTrain, getTrainingLog, flushPendingWrites } from './learning.js';
 import { banner, bannerCompact, bannerAuth, prompt as kbotPrompt, printError, printSuccess, printInfo, printResponse, printHelp, printGoodbye, setQuiet, } from './ui.js';
 import { checkForUpdate, selfUpdate } from './updater.js';
 import { syncOnStartup, schedulePush, flushCloudSync, isCloudSyncEnabled, setCloudToken, getCloudToken } from './cloud-sync.js';
 import chalk from 'chalk';
-const VERSION = '2.5.0';
+const VERSION = '2.8.0';
 async function main() {
     const program = new Command();
     program
         .name('kbot')
         .description('K:BOT — Open-source terminal AI agent. Bring your own key, pick your model, run locally.')
         .version(VERSION)
-        .option('-a, --agent <agent>', 'Force a specific agent (kernel, researcher, coder, writer, analyst)')
+        .option('-a, --agent <agent>', 'Force a specific agent (kernel, researcher, coder, writer, analyst, hacker, operator, dreamer)')
         .option('-m, --model <model>', 'Override AI model (auto, sonnet, haiku)')
         .option('-s, --stream', 'Stream the response')
         .option('-p, --pipe', 'Pipe mode — raw text output for scripting')
@@ -40,6 +40,8 @@ async function main() {
         .option('--computer-use', 'Enable computer use tools')
         .option('-t, --thinking', 'Show AI reasoning steps')
         .option('--thinking-budget <tokens>', 'Thinking token budget (default: 10000)')
+        .option('--self-eval', 'Enable self-evaluation loop (score and retry low-quality responses)')
+        .option('--architect', 'Architect mode — plan-review-implement with dual agents')
         .option('--safe', 'Confirm destructive operations')
         .option('--strict', 'Confirm ALL operations')
         .argument('[prompt...]', 'One-shot prompt')
@@ -86,7 +88,7 @@ async function main() {
     });
     program
         .command('byok')
-        .description('Bring Your Own Key — configure your LLM API key (14 providers)')
+        .description('Bring Your Own Key — configure your LLM API key (19 providers)')
         .option('--off', 'Disable BYOK mode')
         .action(async (opts) => {
         if (opts.off) {
@@ -370,7 +372,7 @@ async function main() {
     });
     program
         .command('serve')
-        .description('Start HTTP server — expose all 60+ tools for kernel.chat or any client')
+        .description('Start HTTP server — expose all 119 tools for kernel.chat or any client')
         .option('-p, --port <port>', 'Port to listen on', '7437')
         .option('--token <token>', 'Require auth token for all requests')
         .option('--computer-use', 'Enable computer use tools')
@@ -401,6 +403,27 @@ async function main() {
             printError('Cannot connect to OpenClaw gateway. Start it first.');
         }
     });
+    program
+        .command('agents [name]')
+        .description('List all available agents, or show details for one')
+        .action(async (name) => {
+        registerBuiltinAgents();
+        if (name) {
+            const detail = formatBuiltinAgentDetail(name);
+            if (detail) {
+                console.log(detail);
+            }
+            else {
+                printError(`Agent "${name}" not found.`);
+                printInfo('Run `kbot agents` to see all available agents.');
+            }
+        }
+        else {
+            console.log(formatBuiltinAgentList());
+            console.log();
+            printInfo('Use: kbot --agent <name> "prompt"');
+        }
+    });
     program.parse(process.argv);
     const opts = program.opts();
     const promptArgs = program.args;
@@ -408,7 +431,7 @@ async function main() {
     if (opts.quiet)
         setQuiet(true);
     // If a sub-command was run, we're done
-    if (['byok', 'auth', 'ide', 'ollama', 'openclaw', 'pull', 'doctor', 'serve'].includes(program.args[0]))
+    if (['byok', 'auth', 'ide', 'ollama', 'openclaw', 'pull', 'doctor', 'serve', 'agents'].includes(program.args[0]))
         return;
     // Check for API key (BYOK or local provider)
     let byokActive = isByokEnabled();
@@ -422,9 +445,10 @@ async function main() {
             localActive = isLocalProvider(envDetected);
             printSuccess(`Auto-detected ${PROVIDERS[envDetected].name} from environment.`);
         }
-        // Priority 2: Check local providers in PARALLEL (both at once, use whichever responds first)
+        // Priority 2: Check local providers in PARALLEL (all at once, use whichever responds first)
         if (!byokActive) {
-            const [ollamaResult, openclawResult] = await Promise.allSettled([
+            const { isLmStudioRunning, isJanRunning, setupLmStudio, setupJan } = await import('./auth.js');
+            const [ollamaResult, lmstudioResult, janResult, openclawResult] = await Promise.allSettled([
                 // Check Ollama
                 (async () => {
                     const up = await isOllamaRunning();
@@ -436,6 +460,22 @@ async function main() {
                     const ok = await setupOllama();
                     return ok ? { provider: 'ollama', models: models.length } : null;
                 })(),
+                // Check LM Studio
+                (async () => {
+                    const up = await isLmStudioRunning();
+                    if (!up)
+                        return null;
+                    const ok = await setupLmStudio();
+                    return ok ? { provider: 'lmstudio' } : null;
+                })(),
+                // Check Jan
+                (async () => {
+                    const up = await isJanRunning();
+                    if (!up)
+                        return null;
+                    const ok = await setupJan();
+                    return ok ? { provider: 'jan' } : null;
+                })(),
                 // Check OpenClaw
                 (async () => {
                     try {
@@ -450,14 +490,26 @@ async function main() {
                     }
                 })(),
             ]);
-            // Prefer Ollama if both available (more models, more control)
+            // Prefer Ollama > LM Studio > Jan > OpenClaw
             const ollamaOk = ollamaResult.status === 'fulfilled' && ollamaResult.value;
+            const lmstudioOk = lmstudioResult.status === 'fulfilled' && lmstudioResult.value;
+            const janOk = janResult.status === 'fulfilled' && janResult.value;
             const openclawOk = openclawResult.status === 'fulfilled' && openclawResult.value;
             if (ollamaOk) {
                 byokActive = true;
                 localActive = true;
                 printSuccess(`Auto-configured Ollama (${ollamaOk.models} models). Ready — $0 cost!`);
             }
+            else if (lmstudioOk) {
+                byokActive = true;
+                localActive = true;
+                printSuccess('Auto-configured LM Studio. Ready — $0 cost!');
+            }
+            else if (janOk) {
+                byokActive = true;
+                localActive = true;
+                printSuccess('Auto-configured Jan. Ready — $0 cost!');
+            }
             else if (openclawOk) {
                 byokActive = true;
                 localActive = true;
@@ -488,6 +540,9 @@ async function main() {
             { env: 'PERPLEXITY_API_KEY', provider: 'perplexity' },
             { env: 'COHERE_API_KEY', provider: 'cohere' },
             { env: 'NVIDIA_API_KEY', provider: 'nvidia' },
+            { env: 'SAMBANOVA_API_KEY', provider: 'sambanova' },
+            { env: 'CEREBRAS_API_KEY', provider: 'cerebras' },
+            { env: 'OPENROUTER_API_KEY', provider: 'openrouter' },
         ];
         for (const { env, provider } of envKeys) {
             if (process.env[env])
@@ -513,6 +568,8 @@ async function main() {
             setPermissionMode('permissive');
         }
     }
+    // Register built-in agents (hacker, operator, dreamer) so --agent flag works
+    registerBuiltinAgents();
     // Parallel startup: register tools, gather context, check updates, and cloud sync
     const [, context, , syncMsg] = await Promise.all([
         registerAllTools({ computerUse: opts.computerUse }),
@@ -542,6 +599,11 @@ async function main() {
         thinking: opts.thinking || false,
         thinkingBudget: opts.thinkingBudget ? (parseInt(opts.thinkingBudget, 10) || 10000) : undefined,
     };
+    // Enable self-evaluation if requested
+    if (opts.selfEval) {
+        const { setSelfEvalEnabled } = await import('./self-eval.js');
+        setSelfEvalEnabled(true);
+    }
     // Pipe mode: echo "prompt" | kbot -p  OR  kbot -p "prompt"
     if (opts.pipe) {
         let message = promptArgs.join(' ');
@@ -639,6 +701,12 @@ async function main() {
             }) + '\n');
             return;
         }
+        // Architect mode: plan-review-implement with dual agents
+        if (opts.architect) {
+            const { runArchitectMode } = await import('./architect.js');
+            await runArchitectMode(message, agentOpts);
+            return;
+        }
         agentOpts.stream = true; // Force streaming for faster one-shot
         await runAndPrint(message, agentOpts);
         return;
@@ -739,12 +807,13 @@ async function byokFlow() {
 async function guidedSetup() {
     console.log(banner(VERSION));
     console.log();
-    console.log(chalk.bold('  Welcome! Let\'s get you set up.'));
+    console.log(chalk.bold('  Hey! I\'m K:BOT — your AI assistant for the terminal.'));
     console.log();
-    console.log(chalk.dim('  K:BOT needs an AI brain to work. You have two options:'));
+    console.log(chalk.dim('  I can write code, answer questions, search the web, manage git,'));
+    console.log(chalk.dim('  and a lot more. First, I need an AI brain. Pick one:'));
     console.log();
-    console.log(`  ${chalk.bold('1.')} ${chalk.hex('#6B8E6B')('Free & Private')} — Run AI on your computer (no account needed)`);
-    console.log(`  ${chalk.bold('2.')} ${chalk.hex('#5B8BA0')('Cloud AI')} — Use an API key from OpenAI, Google, Anthropic, etc.`);
+    console.log(`  ${chalk.bold('1.')} ${chalk.hex('#6B8E6B')('Free & Private')} — Run AI on your computer (no account, no cost)`);
+    console.log(`  ${chalk.bold('2.')} ${chalk.hex('#5B8BA0')('Cloud AI')} — Use an API key (OpenAI, Google, Anthropic, etc.)`);
     console.log();
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     const choice = await new Promise((resolve) => {
@@ -885,14 +954,48 @@ async function startRepl(agentOpts, context, tier, byokActive = false, localActi
             printInfo(`${p.name}`);
     }
     const sessionCount = incrementSessions();
+    // Return-visit greeting — show kbot's growth
+    if (sessionCount > 1) {
+        const stats = getExtendedStats();
+        const parts = [];
+        if (stats.patternsCount > 0)
+            parts.push(`${stats.patternsCount} patterns learned`);
+        if (stats.solutionsCount > 0)
+            parts.push(`${stats.solutionsCount} solutions cached`);
+        if (stats.knowledgeCount > 0)
+            parts.push(`${stats.knowledgeCount} facts remembered`);
+        if (parts.length > 0) {
+            printInfo(`Session ${stats.sessions} · ${parts.join(' · ')}`);
+        }
+    }
     const rl = createInterface({
         input: process.stdin,
         output: process.stdout,
         prompt: kbotPrompt(),
     });
-    // First time? Show a gentle hint
+    // First time? Show a friendly walkthrough
     if (sessionCount <= 1) {
-        printInfo('Try: "hello" or "create a python script" or /help');
+        console.log();
+        console.log(chalk.dim('  ┌─────────────────────────────────────────────┐'));
+        console.log(chalk.dim('  │') + chalk.bold('  Welcome! Here are some things you can try: ') + chalk.dim(' │'));
+        console.log(chalk.dim('  │                                             │'));
+        console.log(chalk.dim('  │') + '  "explain this project"                    ' + chalk.dim('  │'));
+        console.log(chalk.dim('  │') + '  "write a function that sorts names"       ' + chalk.dim('  │'));
+        console.log(chalk.dim('  │') + '  "find all TODO comments in this repo"     ' + chalk.dim('  │'));
+        console.log(chalk.dim('  │') + '  "what files are in this directory?"        ' + chalk.dim('  │'));
+        console.log(chalk.dim('  │                                             │'));
+        console.log(chalk.dim('  │') + chalk.dim('  Type /help for more commands.              ') + chalk.dim(' │'));
+        console.log(chalk.dim('  └─────────────────────────────────────────────┘'));
+        console.log();
+    }
+    else if (sessionCount <= 3) {
+        // Second and third time — show a quick tip they might not know
+        const tips = [
+            'Tip: kbot picks the right specialist for you. Try asking about science, code, or writing.',
+            'Tip: Type /save to keep this conversation. /resume to pick it up later.',
+            'Tip: kbot learns from you. The more you use it, the better it gets.',
+        ];
+        printInfo(tips[Math.min(sessionCount - 1, tips.length - 1)]);
     }
     console.log();
     rl.prompt();
@@ -929,12 +1032,28 @@ async function startRepl(agentOpts, context, tier, byokActive = false, localActi
                     if (!response.streamed) {
                         printResponse(response.agent, response.content);
                     }
-                    // Usage footer — subtle, compact like Claude Code
-                    if (response.usage) {
-                        const tokens = response.usage.input_tokens + response.usage.output_tokens;
-                        const cost = response.usage.cost_usd === 0 ? 'free' : `$${response.usage.cost_usd.toFixed(4)}`;
-                        const tools = response.toolCalls > 0 ? ` · ${response.toolCalls} tools` : '';
-                        printInfo(`${tokens} tokens${tools} · ${cost}`);
+                    // Mentor footer — teach the user what kbot did (agent, tools, cost)
+                    {
+                        const parts = [];
+                        // Show which agent handled it (teaches routing)
+                        if (response.agent && response.agent !== 'kernel') {
+                            parts.push(`${response.agent} agent`);
+                        }
+                        if (response.toolCalls > 0) {
+                            parts.push(`${response.toolCalls} tool${response.toolCalls > 1 ? 's' : ''} used`);
+                        }
+                        if (response.usage) {
+                            const tokens = response.usage.input_tokens + response.usage.output_tokens;
+                            const cost = response.usage.cost_usd === 0 ? 'free' : `$${response.usage.cost_usd.toFixed(4)}`;
+                            parts.push(`${tokens} tokens · ${cost}`);
+                        }
+                        if (parts.length > 0) {
+                            printInfo(parts.join(' · '));
+                        }
+                        // On first 5 sessions, teach what just happened
+                        if (sessionCount <= 5 && response.agent && response.agent !== 'kernel') {
+                            printInfo(chalk.dim(`  I picked the ${response.agent} agent for this. You can also say /agent ${response.agent} to use it directly.`));
+                        }
                     }
                     // Schedule cloud sync push (debounced — batches writes)
                     schedulePush();
@@ -1071,6 +1190,47 @@ async function handleSlashCommand(input, opts, rl) {
         case 'help':
             printHelp();
             break;
+        case 'tutorial': {
+            console.log();
+            console.log(chalk.bold('  Let\'s build something together. Pick a track:'));
+            console.log();
+            console.log(`  ${chalk.bold('1.')} ${chalk.hex('#4ADE80')('Build a website')}     — Create an HTML page from scratch`);
+            console.log(`  ${chalk.bold('2.')} ${chalk.hex('#60A5FA')('Fix a bug')}           — Find and fix a problem in code`);
+            console.log(`  ${chalk.bold('3.')} ${chalk.hex('#FB923C')('Write a script')}      — Automate something with Python or JavaScript`);
+            console.log(`  ${chalk.bold('4.')} ${chalk.hex('#F472B6')('Research a topic')}    — Deep-dive into any subject`);
+            console.log(`  ${chalk.bold('5.')} ${chalk.hex('#A78BFA')('Explore this project')} — Understand the code in this folder`);
+            console.log();
+            console.log(chalk.dim('  Pick a number, or just type what you want to build.'));
+            console.log();
+            const tutorialInput = await new Promise((resolve) => {
+                rl.question('  Your choice: ', (answer) => resolve(answer.trim()));
+            });
+            const tutorialPrompts = {
+                '1': 'Create a simple, beautiful HTML page with a heading, a paragraph about me, and some CSS styling. Save it as index.html. Walk me through what each part does.',
+                '2': 'Look at the files in this directory. Find any issues, bugs, or things that could be improved. Explain what you found and fix the most important one.',
+                '3': 'Write a short script that lists all files in the current directory, sorted by size. Use the language that makes the most sense for this project. Explain each line.',
+                '4': 'I want to understand how AI agents work. Research this topic and explain it simply — what are agents, how do they think, and what tools do they use? Give real examples.',
+                '5': 'Explore this project directory. What language is it written in? What does it do? What are the most important files? Give me a quick tour.',
+            };
+            const prompt = tutorialPrompts[tutorialInput] || tutorialInput;
+            if (prompt) {
+                console.log();
+                printInfo('Great choice! Let me work on that...');
+                console.log();
+                try {
+                    const response = await runAgent(prompt, opts);
+                    if (!response.streamed) {
+                        printResponse(response.agent, response.content);
+                    }
+                    console.log();
+                    printInfo(chalk.dim('That\'s the basics! Keep asking questions — I learn from every conversation.'));
+                }
+                catch (err) {
+                    printError(err instanceof Error ? err.message : String(err));
+                }
+            }
+            break;
+        }
         case 'agent':
             if (args[0]) {
                 opts.agent = args[0];
@@ -1241,6 +1401,74 @@ async function handleSlashCommand(input, opts, rl) {
             if (opts.thinking)
                 printInfo('AI will show reasoning steps before responding.');
             break;
+        case 'self-eval':
+        case 'selfeval': {
+            const { isSelfEvalEnabled, setSelfEvalEnabled } = await import('./self-eval.js');
+            const newState = !isSelfEvalEnabled();
+            setSelfEvalEnabled(newState);
+            printSuccess(`Self-evaluation: ${newState ? 'ON' : 'OFF'}`);
+            if (newState)
+                printInfo('Responses will be scored for quality and retried if below threshold.');
+            break;
+        }
+        case 'health':
+        case 'providers': {
+            const { getProviderHealth } = await import('./provider-fallback.js');
+            const health = getProviderHealth();
+            const active = health.filter(h => h.lastSuccess || h.lastFailure);
+            if (active.length === 0) {
+                printInfo('No provider calls recorded yet.');
+            }
+            else {
+                console.log();
+                printInfo('Provider Health:');
+                for (const h of active) {
+                    const status = h.isHealthy ? chalk.green('healthy') : chalk.red('unhealthy');
+                    const latency = h.avgLatencyMs ? `${h.avgLatencyMs}ms` : '-';
+                    const failures = h.consecutiveFailures > 0 ? chalk.yellow(` (${h.consecutiveFailures} failures)`) : '';
+                    printInfo(`  ${h.provider}: ${status} · ${latency}${failures}`);
+                }
+                console.log();
+            }
+            break;
+        }
+        case 'architect': {
+            const archTask = args.join(' ');
+            if (!archTask) {
+                printError('Usage: /architect <task description>');
+                printInfo('Example: /architect refactor the auth system to use JWT');
+            }
+            else {
+                const { runArchitectMode } = await import('./architect.js');
+                await runArchitectMode(archTask, opts);
+            }
+            break;
+        }
+        case 'graph': {
+            const graphArgs = args.join(' ');
+            if (!graphArgs) {
+                const { getGraph } = await import('./graph-memory.js');
+                const graph = getGraph();
+                printInfo(`Graph: ${graph.nodes.size} nodes, ${graph.edges.length} edges`);
+                if (graph.nodes.size > 0) {
+                    const { toContext } = await import('./graph-memory.js');
+                    printInfo(toContext(500));
+                }
+            }
+            else {
+                const { findNode } = await import('./graph-memory.js');
+                const results = findNode(graphArgs);
+                if (results.length === 0) {
+                    printInfo('No matching nodes found.');
+                }
+                else {
+                    for (const n of results.slice(0, 10)) {
+                        printInfo(`  [${n.type}:${n.name}] (${n.accessCount} accesses)`);
+                    }
+                }
+            }
+            break;
+        }
         case 'plan': {
             const planTask = args.join(' ');
             if (!planTask) {
@@ -1513,7 +1741,8 @@ async function handleSlashCommand(input, opts, rl) {
             rl.close();
             break;
         default:
-            printError(`Unknown command: /${cmd}. Type /help for available commands.`);
+            printError(`I don't know "/${cmd}". Here are some you can try:`);
+            printInfo('  /save — save this chat  |  /agent — pick a specialist  |  /help — see everything');
     }
 }
 // Prevent unhandled rejections from killing the process