@kernel.chat/kbot 1.3.1 → 2.3.0

package/README.md

@@ -0,0 +1,94 @@
+# K:BOT
+
+Open-source terminal AI agent. 17 specialists, 60+ tools, 14 providers, local-first.
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g @kernel.chat/kbot
+
+# Set up with your API key (auto-detects provider)
+kbot auth
+
+# Or use a local model (no API key needed)
+kbot ollama
+
+# Start chatting
+kbot
+```
+
+## One-Shot Mode
+
+```bash
+kbot "fix the auth bug in src/auth.ts"
+kbot "create a react component for user profiles"
+kbot "deploy to production"
+```
+
+## Features
+
+- **14 Providers**: Anthropic, OpenAI, Google, Mistral, xAI, DeepSeek, Groq, Together, Fireworks, Perplexity, Cohere, NVIDIA, Ollama, OpenClaw
+- **60+ Tools**: File ops, bash, git, GitHub, web search, Jupyter notebooks, Docker sandbox, background tasks, MCP consumption, and more
+- **Local-First**: Simple operations (file reads, git, grep) execute locally without API calls
+- **Learning Engine**: Caches successful patterns, solutions, and user preferences — gets faster over time
+- **Custom Agents**: Create on-the-fly specialist agents or use built-in presets
+- **Hooks & Plugins**: Extend with pre/post tool hooks and custom plugins
+- **IDE Integration**: MCP server for VS Code, Cursor, Zed, Neovim
+
+## Providers
+
+| Provider | Cost | Setup |
+|----------|------|-------|
+| Anthropic (Claude) | $3-15/M tokens | `ANTHROPIC_API_KEY` |
+| OpenAI (GPT) | $2.5-10/M tokens | `OPENAI_API_KEY` |
+| Google (Gemini) | $0.15-0.60/M tokens | `GOOGLE_API_KEY` |
+| Ollama (Local) | **Free** | `ollama serve` |
+| OpenClaw (Local) | **Free** | `openclaw-cmd start` |
+
+Set any provider's env var and K:BOT auto-detects it. Or run `kbot auth` for interactive setup.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `kbot` | Interactive REPL |
+| `kbot "prompt"` | One-shot execution |
+| `kbot auth` | Configure API key |
+| `kbot ollama` | Set up local Ollama |
+| `kbot usage` | Show usage stats |
+| `/save` | Save current session |
+| `/resume` | Resume a saved session |
+| `/matrix` | Manage custom agents |
+| `/plugins` | Manage plugins |
+| `/compact` | Compress conversation history |
+
+## Architecture
+
+```
+User Message
+    │
+    ├─ Local-first check (file reads, git, grep → instant, $0)
+    │
+    ├─ Complexity detection → Autonomous planner (multi-step)
+    │
+    └─ Provider API call → Tool execution loop
+        │
+        ├─ Permission check (destructive ops require confirmation)
+        ├─ Pre/post hooks
+        ├─ Tool execution (local, with timeout)
+        └─ Learning (async, patterns + solutions + profile)
+```
+
+## Security
+
+- API keys encrypted at rest (AES-256-CBC)
+- Config file restricted to owner (chmod 600)
+- Destructive operations require user confirmation
+- Bash tool blocks dangerous commands (rm -rf /, fork bombs, etc.)
+- Tool execution timeout prevents hangs (5 min default)
+- Result truncation prevents memory exhaustion (50KB default)
+
+## License
+
+MIT — Antigravity Group

package/dist/agent.d.ts

@@ -1,16 +1,25 @@
 import { type ProjectContext } from './context.js';
+import { type ParsedMessage } from './multimodal.js';
 export interface AgentOptions {
     agent?: string;
     model?: string;
     stream?: boolean;
     context?: ProjectContext;
     tier?: string;
+    /** Enable extended thinking (shows reasoning steps) */
+    thinking?: boolean;
+    /** Thinking budget in tokens (default: 10000) */
+    thinkingBudget?: number;
+    /** Pre-parsed multimodal content (images from CLI) */
+    multimodal?: ParsedMessage;
 }
 export interface AgentResponse {
     content: string;
     agent: string;
     model: string;
     toolCalls: number;
+    thinking?: string;
+    streamed?: boolean;
     usage?: {
         input_tokens: number;
         output_tokens: number;

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAuBA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAO1E,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AA6MD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAwJxB;AAED,6CAA6C;AAC7C,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAef"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAwBA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAU1E,OAAO,EAA8E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAehI,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,aAAa,CAAA;CAC3B;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AA2eD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CA2UxB;AAGD,6CAA6C;AAC7C,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CA2Df"}