@kernel.chat/kbot 3.66.0 → 3.68.0

package/README.md

@@ -2,7 +2,7 @@
 
 <p align="center">
   <strong>kbot</strong><br>
-  Open-source terminal AI agent. 35 agents. 686+ tools. 20 providers. Science, finance, security, and more.
+  Open-source terminal AI agent. 693+ tools. 35 agents. 20 providers. Dreams, learns, watches your system. $0 local.
 </p>
 
 <p align="center">
@@ -30,7 +30,7 @@ Most terminal AI agents lock you into one provider, one model, one way of workin
 - **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).
-- **686+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.
+- **693+ 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.
 
@@ -47,7 +47,23 @@ kbot dream journal    # Full insight history
 kbot dream search     # Find specific memories
 ```
 
-5-tier memory: pattern cache -> solution index -> user profile -> dream journal -> passive scanner. All tiers feed each other through the dream engine.
+7-tier memory: pattern cache -> solution index -> user profile -> dream journal -> passive scanner -> music production -> desktop behavior. All tiers feed each other bidirectionally through the dream engine. Dream insights automatically evolve kbot's prompts so it gets better at being *your* specific tool.
+
+### Always-On System Manager
+
+kbot runs 24/7 in the background, managing your entire development environment:
+
+```
+kbot watchdog             # Service dashboard — CPU, RAM, disk, all services
+kbot wd --restart email   # Restart a crashed service
+kbot dream status         # What kbot learned about you
+```
+
+- **Service watchdog** — health-checks all background services, auto-restarts crashes
+- **Morning briefing** — daily email with downloads, stars, emails, dream insights, service health
+- **Behavior learning** — observes which apps you use and when, dreams about your workflow patterns
+- **Companion memory** — email agent remembers every user's preferences, goals, and conversation history
+- **Proactive follow-ups** — checks in with users who go quiet, referencing their specific context
 
 ### Audit Any Repo in One Command
 
@@ -65,9 +81,12 @@ Checks security, documentation, code quality, CI/CD, community health, and DevOp
 |---|---|---|---|---|---|
 | AI providers | 20 | 1 | 1 | 6 | 75+ |
 | Specialist agents | 35 | 0 | 0 | 0 | 0 |
-| Built-in tools | 686+ | ~20 | ~15 | ~10 | ~15 |
+| Built-in tools | 693+ | ~20 | ~15 | ~10 | ~15 |
 | Science tools | 114 | 0 | 0 | 0 | 0 |
-| Learning engine | Yes | No | No | No | No |
+| Memory system | 7-tier bidirectional | File-based | No | No | No |
+| Dream engine | Yes ($0 local) | Cloud API | No | No | No |
+| Service watchdog | Yes | No | No | No | No |
+| Behavior learning | 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 |
@@ -248,6 +267,8 @@ Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.
 | `kbot dream status` | See what kbot has learned about you |
 | `kbot dream journal` | Full insight history |
 | `kbot dream search` | Find specific memories |
+| `kbot watchdog` | System dashboard — services, CPU, RAM, disk, Ollama, dreams |
+| `kbot wd --restart <svc>` | Restart a crashed background service |
 | `kbot contribute <repo>` | Find good-first-issues and quick wins |
 | `kbot share` | Share conversation as GitHub Gist |
 | `kbot pair` | File watcher with auto-analysis |

package/dist/agent.js

@@ -17,8 +17,9 @@ 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 { setBuddyMood } from './buddy.js';
+import { setBuddyMood, addBuddyXP, checkAchievements, formatAchievementUnlock } from './buddy.js';
 import { notifyTurn, startMemoryScanner, stopMemoryScanner } from './memory-scanner.js';
+import { captureUserBehavior } from './user-behavior.js';
 import { autoCompact, compressToolResult } from './context-manager.js';
 import { learnedRoute, recordRoute } from './learned-router.js';
 import { buildCacheablePrompt, createPromptSections } from './prompt-cache.js';
@@ -1007,6 +1008,9 @@ Always quote file paths that contain spaces. Never reference internal system nam
     setBuddyMood('thinking');
     // Start passive memory scanner for this session
     startMemoryScanner();
+    // Capture a behavior snapshot (what apps are open, active window, etc.)
+    // Non-blocking, macOS only, purely local storage
+    captureUserBehavior();
     // ── Gödel limits: detect undecidable loops and hand off to human ──
     const loopDetector = new LoopDetector({
         maxToolRepeats: 5,
@@ -1623,6 +1627,14 @@ Always quote file paths that contain spaces. Never reference internal system nam
     // ── Dream Engine: consolidate session memories (non-blocking, $0 via Ollama) ──
     setBuddyMood('learning');
     dreamAfterSession(sessionId);
+    // ── Buddy Evolution: award XP for completing a session ──
+    addBuddyXP(1);
+    // ── Achievements: check for newly unlocked milestones ──
+    const newAchievements = checkAchievements();
+    for (const achievement of newAchievements) {
+        // Print to stderr so it doesn't interfere with piped output
+        process.stderr.write('\n' + formatAchievementUnlock(achievement) + '\n\n');
+    }
     // Session complete — buddy returns to idle
     setBuddyMood('idle');
     const content = lastResponse?.content || 'Reached maximum tool iterations.';

package/dist/buddy.d.ts

@@ -1,20 +1,86 @@
 export type BuddySpecies = 'fox' | 'owl' | 'cat' | 'robot' | 'ghost' | 'mushroom' | 'octopus' | 'dragon';
 export type BuddyMood = 'idle' | 'thinking' | 'success' | 'error' | 'learning';
+export type BuddyLevel = 0 | 1 | 2 | 3;
+export interface BuddyEvolution {
+    level: BuddyLevel;
+    xp: number;
+    evolvedAt: string[];
+}
 export interface BuddyState {
     species: BuddySpecies;
     name: string;
     mood: BuddyMood;
+    evolution: BuddyEvolution;
+}
+export interface BuddyLevelInfo {
+    level: BuddyLevel;
+    xp: number;
+    xpToNext: number | null;
+    title: string;
+}
+export interface Achievement {
+    /** Unique achievement ID */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description of what the user did */
+    description: string;
+    /** Single ASCII char icon (trophy, star, bolt, etc.) */
+    icon: string;
+    /** ISO timestamp when unlocked, null if locked */
+    unlockedAt: string | null;
 }
-/** Get the buddy's current state (species, name, mood) */
+/**
+ * Check all achievement conditions and unlock any newly earned.
+ * Returns the list of newly unlocked achievements (empty if none).
+ * Call this at session end in agent.ts.
+ */
+export declare function checkAchievements(): Achievement[];
+/**
+ * Get all achievements with their unlock status.
+ * Unlocked ones include the timestamp; locked ones show null.
+ */
+export declare function getAchievements(): Achievement[];
+/**
+ * Get a progress hint for a locked achievement.
+ * Returns null if the achievement is unlocked or not found.
+ */
+export declare function getAchievementProgress(achievementId: string): string | null;
+/**
+ * Format achievement unlock notification for terminal display.
+ * Shows the buddy sprite in success mood with a celebration message.
+ */
+export declare function formatAchievementUnlock(achievement: Achievement): string;
+/** Get the buddy's current state (species, name, mood, evolution) */
 export declare function getBuddy(): BuddyState;
 /** Set the buddy's mood */
 export declare function setBuddyMood(mood: BuddyMood): void;
-/** Get the ASCII sprite for the buddy in the given mood (defaults to current) */
+/** Get the ASCII sprite for the buddy in the given mood (defaults to current).
+ *  Applies evolution visual upgrades based on the buddy's current level. */
 export declare function getBuddySprite(mood?: BuddyMood): string[];
 /** Get a random greeting for the buddy */
 export declare function getBuddyGreeting(): string;
 /** Rename the buddy (persisted to ~/.kbot/buddy.json) */
 export declare function renameBuddy(newName: string): void;
+/**
+ * Add XP to the buddy. Checks for level-ups and persists to buddy.json.
+ * Returns the updated level info, and whether a level-up just occurred.
+ *
+ * XP sources:
+ *   - Session complete: +1
+ *   - Dream cycle:      +2
+ *   - Tool creation:    +3
+ *   - First error fix:  +1
+ */
+export declare function addBuddyXP(amount: number): {
+    levelInfo: BuddyLevelInfo;
+    leveledUp: boolean;
+};
+/**
+ * Get the buddy's current level info without modifying state.
+ * Includes level, XP, XP to next level, and species-specific title.
+ */
+export declare function getBuddyLevel(): BuddyLevelInfo;
 /**
  * Format the buddy with a speech bubble and status message.
  * Returns a multi-line string ready for terminal output.
@@ -30,4 +96,13 @@ export declare function renameBuddy(newName: string): void;
  *   ~ Patch the fox ~
  */
 export declare function formatBuddyStatus(message?: string): string;
+/**
+ * Get a dream narration for the buddy to tell the user at startup.
+ *
+ * Picks the highest-relevance insight that was reinforced in the last 24 hours
+ * and hasn't already been narrated. Returns `null` if there's nothing new to say.
+ *
+ * Tracks narrated insight IDs in buddy.json to avoid repeats.
+ */
+export declare function getBuddyDreamNarration(): string | null;
 //# sourceMappingURL=buddy.d.ts.map