@kernel.chat/kbot 3.61.8 → 3.63.0

package/README.md

@@ -1,7 +1,281 @@
 # kbot
 
-Open-source terminal AI agent. 670+ tools. 35 agents. 20 providers.
+<p align="center">
+  <strong>kbot</strong><br>
+  Open-source terminal AI agent. 35 agents. 670+ tools. 20 providers. Science, finance, security, and more.
+</p>
+
+<p align="center">
+  <img src="tools/video-assets/demo.gif" alt="kbot demo" width="700">
+</p>
+
+<p align="center">
+  <a href="https://github.com/isaacsight/kernel/actions/workflows/ci.yml"><img src="https://github.com/isaacsight/kernel/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/@kernel.chat/kbot"><img src="https://img.shields.io/npm/v/@kernel.chat/kbot?color=6B5B95&label=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@kernel.chat/kbot"><img src="https://img.shields.io/npm/dw/@kernel.chat/kbot?color=6B5B95" alt="npm downloads"></a>
+  <a href="https://github.com/isaacsight/kernel/blob/main/LICENSE"><img src="https://img.shields.io/github/license/isaacsight/kernel?color=6B5B95" alt="MIT License"></a>
+  <a href="https://kernel.chat"><img src="https://img.shields.io/badge/web-kernel.chat-6B5B95" alt="kernel.chat"></a>
+  <a href="https://discord.gg/kdMauM9abG"><img src="https://img.shields.io/badge/discord-join-6B5B95?logo=discord&logoColor=white" alt="Discord"></a>
+</p>
 
 ```bash
 npm install -g @kernel.chat/kbot
 ```
+
+## Why kbot?
+
+Most terminal AI agents lock you into one provider, one model, one way of working. kbot doesn't.
+
+- **20 providers, zero lock-in** — Claude, GPT, Gemini, Grok, DeepSeek, Groq, Mistral, SambaNova, Cerebras, OpenRouter, and more. Switch with one command.
+- **Runs fully offline** — Embedded llama.cpp, Ollama, LM Studio, or Jan. $0, fully private.
+- **Learns your patterns** — Bayesian skill ratings + pattern extraction. Gets faster over time.
+- **35 specialist agents** — auto-routes your request to the right expert (coder, researcher, writer, guardian, quant, and 30 more).
+- **670+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.
+- **Programmatic SDK** — use kbot as a library in your own apps.
+- **MCP server built in** — plug kbot into Claude Code, Cursor, VS Code, Zed, or Neovim as a tool provider.
+
+### How it compares
+
+| | kbot | Claude Code | Codex CLI | Aider | OpenCode |
+|---|---|---|---|---|---|
+| AI providers | 20 | 1 | 1 | 6 | 75+ |
+| Specialist agents | 35 | 0 | 0 | 0 | 0 |
+| Built-in tools | 600+ | ~20 | ~15 | ~10 | ~15 |
+| Science tools | 114 | 0 | 0 | 0 | 0 |
+| Learning engine | Yes | No | No | No | No |
+| Offline mode | Embedded + Ollama | No | No | Ollama | Ollama |
+| SDK | Yes | No | Yes | No | No |
+| MCP server | Yes | N/A | No | No | No |
+| Web companion | kernel.chat | No | No | No | No |
+| Open source | MIT | Source available | Apache 2.0 | Apache 2.0 | MIT |
+| Cost | BYOK / $0 local | $20+/mo | BYOK | BYOK | BYOK |
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @kernel.chat/kbot
+
+# Or run directly (no install)
+npx @kernel.chat/kbot
+
+# Or use the install script (auto-installs Node.js if needed)
+curl -fsSL https://kernel.chat/install.sh | bash
+```
+
+```bash
+# Interactive mode
+kbot
+
+# One-shot
+kbot "explain this codebase"
+kbot "fix the auth bug in src/auth.ts"
+kbot "create a Dockerfile for this project"
+
+# Pipe mode (for scripting)
+kbot -p "generate a migration for user roles" > migration.sql
+
+# Use local models (free, no API key)
+kbot local
+
+# Set up your API key
+kbot auth
+```
+
+## Specialists
+
+kbot auto-routes to the right agent for each task. Or pick one with `--agent <name>`.
+
+| | Agents |
+|---|---|
+| **Core** | kernel, researcher, coder, writer, analyst |
+| **Extended** | aesthete, guardian, curator, strategist |
+| **Domain** | infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter |
+| **Presets** | claude-code, cursor, copilot, creative, developer |
+
+## 600+ Tools
+
+| Category | Examples |
+|----------|---------|
+| **Files & Code** | read, write, glob, grep, lint, format, type-check |
+| **Shell** | bash, parallel execute, background tasks |
+| **Git & GitHub** | commit, diff, PR, issues, code search |
+| **Web** | search, fetch, browser automation, browser agent |
+| **Research** | arXiv, Semantic Scholar, HuggingFace, NASA, DOI |
+| **Data** | CSV read/query/write, transforms, reports, invoices |
+| **Quality** | lint (ESLint/Biome/Clippy), test (Vitest/Jest/pytest), deps audit, formatting |
+| **Deploy** | Vercel, Netlify, Cloudflare Workers/Pages, Fly.io, Railway |
+| **Database** | Postgres, MySQL, SQLite queries, Prisma, ER diagrams, seed data |
+| **Containers** | Docker build/run/compose, Terraform |
+| **Creative** | p5.js generative art, GLSL shaders, SVG patterns, design variants |
+| **VFX** | GLSL shaders, FFmpeg, ImageMagick, Blender, procedural textures |
+| **Game Dev** | 16 tools for Godot, Unity, Unreal, Bevy, Phaser, Three.js, PlayCanvas, Defold |
+| **Training** | dataset prep, fine-tuning, evaluation, model export |
+| **Social** | post to X, LinkedIn, Bluesky, Mastodon — single posts and threads |
+| **Sandbox** | Docker sandboxes, E2B cloud sandboxes, isolated code execution |
+| **Notebooks** | Jupyter read/edit/insert/delete cells |
+| **Build Matrix** | cross-platform builds — mobile, desktop, WASM, embedded, server |
+| **LSP** | goto definition, find references, hover, rename, diagnostics |
+| **Memory** | persistent memory save/search/update across sessions |
+| **MCP** | marketplace search/install, 20 bundled servers |
+| **IDE** | MCP server, ACP server, LSP bridge |
+| **Forge** | create tools at runtime, publish to registry, install from registry |
+| **Meta** | subagents, worktrees, planner, sessions, checkpoints, self-eval |
+| **Science & Math** | symbolic compute, matrix ops, FFT, ODEs, probability, optimization, graph theory, OEIS |
+| **Physics** | orbital mechanics, circuits, signal processing, particles (PDG), relativity, quantum simulator, beam analysis, fluid dynamics |
+| **Chemistry** | PubChem compounds, reactions, periodic table (118 elements), spectroscopy, stoichiometry, thermodynamics |
+| **Biology** | PubMed, gene lookup, protein/PDB, BLAST, drug/ChEMBL, pathways, taxonomy, clinical trials |
+| **Earth & Climate** | earthquakes/USGS, climate/NOAA, satellite imagery, geology, ocean, air quality, volcanoes, water resources |
+| **Neuroscience** | brain atlas, EEG analysis, cognitive models, neural simulation, connectome, psychophysics |
+| **Social Science** | psychometrics, game theory, econometrics, social network analysis, survey design, voting systems |
+| **Humanities** | corpus analysis, formal logic, argument mapping, ethics frameworks, historical timelines, stylometry |
+| **Health & Epidemiology** | SIR/SEIR models, epidemiology calculations, disease surveillance, nutrition, vaccination modeling |
+| **Finance** | market data, technical analysis, paper trading, DeFi yields, wallet & swaps, stock screener, sentiment |
+| **Cybersecurity** | dep_audit, secret_scan, ssl_check, headers_check, cve_lookup, port_scan, owasp_check |
+| **Self-Defense** | memory HMAC, prompt injection detection, knowledge sanitization, forge verification, anomaly detection |
+
+## 20 Providers
+
+| Provider | Cost | Local? |
+|----------|------|--------|
+| **Embedded (llama.cpp)** | **Free** | Yes |
+| **Ollama** | **Free** | Yes |
+| **LM Studio** | **Free** | Yes |
+| **Jan** | **Free** | Yes |
+| DeepSeek | $0.27/M in | Cloud |
+| SambaNova | $0.50/M in | Cloud |
+| Cerebras | $0.60/M in | Cloud |
+| Groq | $0.59/M in | Cloud |
+| NVIDIA NIM | $0.80/M in | Cloud |
+| Together AI | $0.88/M in | Cloud |
+| Fireworks AI | $0.90/M in | Cloud |
+| Google (Gemini) | $1.25/M in | Cloud |
+| Mistral | $2.00/M in | Cloud |
+| OpenAI (GPT) | $2.00/M in | Cloud |
+| Cohere | $2.50/M in | Cloud |
+| Anthropic (Claude) | $3.00/M in | Cloud |
+| xAI (Grok) | $3.00/M in | Cloud |
+| Perplexity | $3.00/M in | Cloud |
+| OpenRouter | varies | Cloud |
+| kbot local | **Free** | Yes |
+
+Set any provider's env var and kbot auto-detects it. Or run `kbot auth` for interactive setup.
+
+## SDK
+
+```typescript
+import { agent, tools, providers } from '@kernel.chat/kbot'
+
+const result = await agent.run("fix the auth bug", { agent: 'coder' })
+console.log(result.content)
+
+for await (const event of agent.stream("explain this code")) {
+  if (event.type === 'content_delta') process.stdout.write(event.text)
+}
+```
+
+## Architecture
+
+```mermaid
+graph TD
+    A[User Message] --> B{Local-first check}
+    B -->|file, git, grep| C[Instant response — $0]
+    B -->|Needs AI| D{Complexity detection}
+    D -->|Simple| E[Bayesian Router → Specialist]
+    D -->|Multi-step| F[Autonomous Planner]
+    E --> G[Provider API + Tool Loop]
+    F --> G
+    G --> H{600+ Tools}
+    H --> I[File ops, bash, git, GitHub, search, deploy, DB, game dev...]
+    G --> J[Learning Engine]
+    J --> K[Patterns + Solutions + User Profile]
+    G --> L[Checkpointing]
+    L --> M[Resume from last tool call]
+```
+
+## MCP Server
+
+Use kbot as a tool provider inside any MCP-compatible IDE:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "kbot": { "command": "kbot", "args": ["ide", "mcp"] }
+    }
+  }
+}
+```
+
+Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `kbot` | Interactive REPL |
+| `kbot "prompt"` | One-shot execution |
+| `kbot auth` | Configure API key |
+| `kbot local` | Use local AI (Ollama, embedded, LM Studio, Jan) |
+| `kbot serve` | Start HTTP REST + SSE streaming server |
+| `kbot audit <repo>` | Security + quality audit of any GitHub repo |
+| `kbot contribute <repo>` | Find good-first-issues and quick wins |
+| `kbot share` | Share conversation as GitHub Gist |
+| `kbot pair` | File watcher with auto-analysis |
+| `kbot team` | Multi-agent TCP collaboration |
+| `kbot record` | Terminal session recording (SVG, GIF, asciicast) |
+| `kbot voice` | Text-to-speech output mode |
+| `kbot watch` | Real-time file analysis on change |
+| `kbot bootstrap` | Outer-loop project optimizer (visibility scoring) |
+| `kbot plugins` | Search, install, update community plugins |
+| `kbot models` | List, pull, remove, catalog local models |
+| `kbot changelog` | Generate changelog from git history |
+| `kbot completions` | Shell completions (bash, zsh, fish) |
+| `kbot cloud` | Sync learning data to kernel.chat |
+| `kbot ide mcp` | Start MCP server for IDEs |
+| `kbot doctor` | 10-point health check |
+
+### Power-User Flags
+
+```bash
+kbot --architect "design the auth system"    # Architecture mode — plan before code
+kbot --thinking "solve this hard problem"    # Extended reasoning with thinking budget
+kbot --self-eval "write a parser"            # Self-evaluation loop — scores and retries
+kbot --computer-use "fill out this form"     # Computer use — controls mouse and keyboard
+kbot -p "query" > output.txt                 # Pipe mode — clean output for scripting
+```
+
+## Security
+
+- API keys encrypted at rest (AES-256-CBC)
+- Destructive operations require confirmation
+- Shell commands sandboxed with blocklist
+- Tool execution timeout (5 min) with middleware pipeline
+- Config files restricted to owner (chmod 600)
+- 0 P0/P1 security issues (audited March 2026)
+
+## Development
+
+```bash
+cd packages/kbot
+npm install
+npm run dev          # Run in dev mode
+npm run build        # Compile TypeScript
+npm run test         # Run tests (vitest)
+```
+
+## Web Companion — kernel.chat
+
+kbot has a web companion at [kernel.chat](https://kernel.chat) — same agents, persistent memory, and a visual interface. Free to use (20 messages/day).
+
+## Community
+
+- **Web**: [kernel.chat](https://kernel.chat)
+- **npm**: [@kernel.chat/kbot](https://www.npmjs.com/package/@kernel.chat/kbot)
+- **Discord**: [discord.gg/kdMauM9abG](https://discord.gg/kdMauM9abG)
+- **GitHub**: [isaacsight/kernel](https://github.com/isaacsight/kernel)
+- **Issues**: [Report a bug](https://github.com/isaacsight/kernel/issues)
+
+## License
+
+[MIT](LICENSE) — [kernel.chat group](https://kernel.chat)

package/dist/agent.js

@@ -16,6 +16,7 @@ import { formatContextForPrompt } from './context.js';
 import { getMatrixSystemPrompt } from './matrix.js';
 import { buildFullLearningContext, findPattern, recordPattern, cacheSolution, updateProfile, classifyTask, extractKeywords, learnFromExchange, updateProjectMemory, shouldAutoTrain, selfTrain, } from './learning.js';
 import { getMemoryPrompt, addTurn, getPreviousMessages, getHistory } from './memory.js';
+import { getDreamPrompt, dreamAfterSession } from './dream.js';
 import { autoCompact, compressToolResult } from './context-manager.js';
 import { learnedRoute, recordRoute } from './learned-router.js';
 import { buildCacheablePrompt, createPromptSections } from './prompt-cache.js';
@@ -965,7 +966,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
         persona: PERSONA,
         matrixPrompt: matrixPrompt || undefined,
         contextSnippet: (contextSnippet || '') + repoMapSnippet + graphSnippet + skillsSnippet + skillLibrarySnippet || undefined,
-        memorySnippet: (memorySnippet || '') + reflectionSnippet || undefined,
+        memorySnippet: (memorySnippet || '') + getDreamPrompt(8) + reflectionSnippet || undefined,
         learningContext: ((learningContext || '') + (synthesisSnippet ? '\n\n' + synthesisSnippet : '') + (correctionsSnippet ? '\n\n' + correctionsSnippet : '')) || undefined,
     });
     const provider = byokProvider || 'anthropic';
@@ -1603,6 +1604,8 @@ Always quote file paths that contain spaces. Never reference internal system nam
         reason: 'loop_exhausted',
     });
     telemetry.destroy().catch(() => { });
+    // ── Dream Engine: consolidate session memories (non-blocking, $0 via Ollama) ──
+    dreamAfterSession(sessionId);
     const content = lastResponse?.content || 'Reached maximum tool iterations.';
     return {
         content,

package/dist/cli.js

@@ -3158,6 +3158,80 @@ async function main() {
         const r = await executeTool({ id: 'db_health', name: 'db_health', arguments: {} });
         console.log(r.result);
     });
+    // ── Dream Engine ──
+    const dreamCmd = program
+        .command('dream')
+        .description('Memory consolidation — consolidate session knowledge into durable insights');
+    dreamCmd
+        .command('run')
+        .description('Run a dream cycle now (uses local Ollama)')
+        .action(async () => {
+        const { dream } = await import('./dream.js');
+        printInfo('Dreaming... consolidating session memories with local AI');
+        const result = await dream();
+        if (result.success) {
+            printSuccess(`Dream cycle #${result.cycle} complete`);
+            console.log(`  New insights: ${result.newInsights}`);
+            console.log(`  Reinforced: ${result.reinforced}`);
+            console.log(`  Archived: ${result.archived} aged-out`);
+            console.log(`  Duration: ${result.duration}ms`);
+        }
+        else {
+            printWarn(result.error || 'Dream cycle failed');
+            if (result.archived > 0)
+                console.log(`  (Still archived ${result.archived} aged-out insights)`);
+        }
+    });
+    dreamCmd
+        .command('status')
+        .description('Show dream engine status and top insights')
+        .action(async () => {
+        const { getDreamStatus } = await import('./dream.js');
+        const { state, insights, archiveCount } = getDreamStatus();
+        console.log(chalk.bold('\nDream Engine'));
+        console.log(chalk.dim('═══════════════════'));
+        console.log(`Cycles:    ${state.cycles}`);
+        console.log(`Last:      ${state.lastDream || 'never'}`);
+        console.log(`Active:    ${state.activeInsights} insights`);
+        console.log(`Archived:  ${state.totalArchived} (${archiveCount} files)`);
+        if (insights.length > 0) {
+            const avgRel = Math.round(insights.reduce((s, i) => s + i.relevance, 0) / insights.length * 100);
+            console.log(`Avg relevance: ${avgRel}%`);
+            console.log(chalk.bold('\nTop insights:'));
+            for (const i of insights.slice(0, 8)) {
+                const pct = Math.round(i.relevance * 100);
+                console.log(`  ${chalk.green(`${pct}%`)} [${chalk.cyan(i.category)}] ${i.content}`);
+            }
+        }
+        else {
+            console.log(chalk.dim('\nNo insights yet. Run: kbot dream run'));
+        }
+    });
+    dreamCmd
+        .command('search <query>')
+        .description('Search dream insights by keyword')
+        .action(async (query) => {
+        const { searchDreams } = await import('./dream.js');
+        const results = searchDreams(query);
+        if (results.length === 0) {
+            printInfo(`No insights match "${query}"`);
+            return;
+        }
+        console.log(chalk.bold(`\n${results.length} insights matching "${query}":\n`));
+        for (const i of results.slice(0, 15)) {
+            const pct = Math.round(i.relevance * 100);
+            console.log(`  ${chalk.green(`${pct}%`)} [${chalk.cyan(i.category)}] ${i.content}`);
+            console.log(chalk.dim(`         ${i.keywords.join(', ')} | ${i.sessions} sessions | ${i.created.split('T')[0]}`));
+        }
+    });
+    dreamCmd
+        .command('journal')
+        .description('Print the full dream journal')
+        .action(async () => {
+        const { getDreamPrompt } = await import('./dream.js');
+        const journal = getDreamPrompt(50);
+        console.log(journal || chalk.dim('Dream journal is empty. Run: kbot dream run'));
+    });
     program.parse(process.argv);
     const opts = program.opts();
     const promptArgs = program.args;
@@ -3165,7 +3239,7 @@ async function main() {
     if (opts.quiet)
         setQuiet(true);
     // If a sub-command was run, we're done
-    if (['byok', 'auth', 'ide', 'local', 'ollama', 'kbot-local', 'pull', 'doctor', 'serve', 'agents', 'watch', 'voice', 'export', 'plugins', 'changelog', 'release', 'completions', 'automate', 'status', 'spec', 'a2a', 'init', 'email-agent', 'imessage-agent', 'consultation', 'observe', 'discovery', 'bench', 'lab', 'teach', 'sessions', 'admin', 'monitor', 'analytics', 'deploy', 'env', 'db'].includes(program.args[0]))
+    if (['byok', 'auth', 'ide', 'local', 'ollama', 'kbot-local', 'pull', 'doctor', 'serve', 'agents', 'watch', 'voice', 'export', 'plugins', 'changelog', 'release', 'completions', 'automate', 'status', 'spec', 'a2a', 'init', 'email-agent', 'imessage-agent', 'consultation', 'observe', 'discovery', 'bench', 'lab', 'teach', 'sessions', 'admin', 'monitor', 'analytics', 'deploy', 'env', 'db', 'dream'].includes(program.args[0]))
         return;
     // ── Ollama Launch Integration ──
     // Detect when kbot is started via `ollama launch kbot` or `kbot --ollama-launch`

package/dist/dream.d.ts

@@ -0,0 +1,66 @@
+export interface DreamInsight {
+    /** Unique ID */
+    id: string;
+    /** The consolidated insight */
+    content: string;
+    /** Category: pattern | preference | skill | project | relationship */
+    category: DreamCategory;
+    /** Keywords for retrieval */
+    keywords: string[];
+    /** Relevance score (0-1), decays over time */
+    relevance: number;
+    /** How many sessions contributed to this insight */
+    sessions: number;
+    /** Created timestamp */
+    created: string;
+    /** Last reinforced (refreshed relevance) */
+    lastReinforced: string;
+    /** Source: which sessions/topics generated this */
+    source: string;
+}
+export type DreamCategory = 'pattern' | 'preference' | 'skill' | 'project' | 'relationship';
+export interface DreamState {
+    /** Total dream cycles completed */
+    cycles: number;
+    /** Last dream timestamp */
+    lastDream: string | null;
+    /** Total insights ever created */
+    totalInsights: number;
+    /** Total insights archived (aged out) */
+    totalArchived: number;
+    /** Insights currently active */
+    activeInsights: number;
+    /** Last session turn count that was dreamed about */
+    lastSessionTurns: number;
+}
+/** Apply exponential decay to all insights based on time elapsed */
+export declare function ageMemories(insights: DreamInsight[]): {
+    aged: DreamInsight[];
+    archived: DreamInsight[];
+};
+/** Run a full dream cycle — consolidate, reinforce, age */
+export declare function dream(sessionId?: string): Promise<DreamResult>;
+export interface DreamResult {
+    success: boolean;
+    newInsights: number;
+    reinforced: number;
+    archived: number;
+    cycle: number;
+    duration: number;
+    error: string | null;
+}
+/** Get dream insights for inclusion in system prompt */
+export declare function getDreamPrompt(maxInsights?: number): string;
+/** Get full dream status */
+export declare function getDreamStatus(): {
+    state: DreamState;
+    insights: DreamInsight[];
+    archiveCount: number;
+};
+/** Search dream insights by keyword */
+export declare function searchDreams(query: string): DreamInsight[];
+/** Manually reinforce a specific insight (user confirms it's still relevant) */
+export declare function reinforceInsight(insightId: string): boolean;
+/** Run dream after session ends (non-blocking) */
+export declare function dreamAfterSession(sessionId?: string): void;
+//# sourceMappingURL=dream.d.ts.map