@kernel.chat/kbot 3.97.0 → 3.97.1

package/README.md

@@ -2,7 +2,7 @@
 
 <p align="center">
   <strong>kbot</strong><br>
-  Open-source terminal AI agent. 764+ tools. 35 agents. 20 providers. Dreams, learns, watches your system, controls your phone. $0 local.
+  Open-source terminal AI agent. 787+ tools. 35 agents. 20 providers. Dreams, learns, watches your system, controls your phone. $0 local.
 </p>
 
 <p align="center">
@@ -31,7 +31,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).
-- **764+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, music production, iPhone control, and more.
+- **787+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, music production, iPhone control, 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.
 
@@ -142,7 +142,7 @@ 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 | 764+ | ~20 | ~15 | ~10 | ~15 |
+| Built-in tools | 787+ | ~20 | ~15 | ~10 | ~15 |
 | Science tools | 114 | 0 | 0 | 0 | 0 |
 | Memory system | 7-tier bidirectional | File-based | No | No | No |
 | Dream engine | Yes ($0 local) | Cloud API | No | No | No |

package/dist/cli.js

@@ -102,7 +102,7 @@ async function main() {
         console.log(`  ${chalk.cyan('https://github.com/isaacsight/kernel/issues')}  ${chalk.dim('Bug reports')}`);
         console.log(`  ${chalk.cyan('support@kernel.chat')}  ${chalk.dim('Email (AI-assisted replies)')}`);
         console.log();
-        console.log(`  ${chalk.dim('35 specialist agents · 360+ tools · 20 providers · MIT licensed')}`);
+        console.log(`  ${chalk.dim('35 specialist agents · 787+ tools · 20 providers · MIT licensed')}`);
         console.log();
         process.exit(0);
     });

package/dist/coordinator.d.ts

@@ -129,4 +129,36 @@ export declare class IntelligenceCoordinator {
 export declare function getCoordinator(): IntelligenceCoordinator;
 /** Register coordinator tools with the kbot tool registry */
 export declare function registerCoordinatorTools(): void;
+export interface Task {
+    id: string;
+    goal: string;
+    status: 'pending' | 'running' | 'done' | 'failed';
+    agent: string;
+    dependencies: string[];
+    result?: string;
+    error?: string;
+}
+export interface CoordinatorPlan {
+    id: string;
+    goal: string;
+    tasks: Task[];
+    createdAt: string;
+    completedAt?: string;
+    status: 'planning' | 'executing' | 'done' | 'failed';
+}
+/**
+ * Decompose a high-level goal into ordered sub-tasks with dependencies.
+ * Uses the LLM (via runAgent) to break the goal into 2-6 concrete tasks.
+ */
+export declare function decompose(goal: string): Promise<CoordinatorPlan>;
+/**
+ * Execute a plan's tasks in dependency order (sequential for now).
+ * Tasks whose dependencies are all 'done' are eligible to run.
+ */
+export declare function execute(plan: CoordinatorPlan): Promise<CoordinatorPlan>;
+/**
+ * Convenience: decompose a goal, execute the plan, and synthesize results.
+ * Returns a human-readable summary of what was accomplished.
+ */
+export declare function coordinate(goal: string): Promise<string>;
 //# sourceMappingURL=coordinator.d.ts.map

package/dist/coordinator.js

@@ -8,6 +8,7 @@
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import chalk from 'chalk';
 // ── Lazy module loaders (dynamic imports to break circular deps) ──
 async function getLearning() { return import('./learning.js'); }
 async function getConfidence() { return import('./confidence.js'); }
@@ -673,10 +674,166 @@ export function registerCoordinatorTools() {
                 return JSON.stringify(result, null, 2);
             },
         });
+        registerTool({
+            name: 'coordinator_orchestrate',
+            description: 'Decompose a goal into sub-tasks, assign specialist agents, execute in dependency order, and synthesize results',
+            parameters: { goal: { type: 'string', description: 'The high-level goal to orchestrate', required: true } },
+            tier: 'free',
+            execute: async (args) => coordinate(args.goal),
+        });
     }).catch(() => {
         // tools/index.js not available — skip registration
     });
 }
+// ── Goal Decomposition & Multi-Agent Orchestration ──
+//
+// Takes a high-level goal and:
+// 1. Decomposes it into ordered sub-tasks via LLM
+// 2. Assigns each sub-task to the best specialist agent
+// 3. Manages dependencies between sub-tasks
+// 4. Synthesizes results into a final output
+// 5. Learns from the execution for next time
+const COORD_AMETHYST = typeof chalk.hex === 'function' ? chalk.hex('#6B5B95') : ((s) => s);
+const DECOMPOSE_PROMPT = `You are a task decomposition engine. Break the goal into 2-6 concrete sub-tasks.
+Output ONLY valid JSON: {"tasks":[{"id":"t1","goal":"...","agent":"agent_id","dependencies":[]}]}
+Agents: kernel (general), coder (code/debug), researcher (research), writer (docs), analyst (strategy), guardian (security), infrastructure (devops).
+Rules: each task independently verifiable, use dependencies for ordering, assign best agent, one objective per task.`;
+/**
+ * Decompose a high-level goal into ordered sub-tasks with dependencies.
+ * Uses the LLM (via runAgent) to break the goal into 2-6 concrete tasks.
+ */
+export async function decompose(goal) {
+    const planId = shortId();
+    const plan = {
+        id: planId,
+        goal,
+        tasks: [],
+        createdAt: new Date().toISOString(),
+        status: 'planning',
+    };
+    process.stderr.write(`  ${COORD_AMETHYST('◆ decompose')} ${chalk.dim(goal.slice(0, 80))}${goal.length > 80 ? '...' : ''}\n`);
+    try {
+        // Lazy import to avoid circular dependency
+        const { runAgent } = await import('./agent.js');
+        const response = await runAgent(`${DECOMPOSE_PROMPT}\n\nGoal: ${goal}\n\nOutput JSON:`, { agent: 'kernel', skipPlanner: true, sessionId: `coord-${planId}` });
+        // Parse JSON from response
+        const jsonMatch = response.content.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            const parsed = JSON.parse(jsonMatch[0]);
+            plan.tasks = (parsed.tasks || []).slice(0, 6).map(t => ({
+                id: t.id || shortId(),
+                goal: t.goal,
+                status: 'pending',
+                agent: t.agent || 'kernel',
+                dependencies: t.dependencies || [],
+            }));
+        }
+    }
+    catch (err) {
+        process.stderr.write(`  ${chalk.red('✗')} decomposition failed: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    // Fallback: if decomposition produced nothing, create a single task
+    if (plan.tasks.length === 0) {
+        plan.tasks = [{
+                id: 't1',
+                goal,
+                status: 'pending',
+                agent: 'kernel',
+                dependencies: [],
+            }];
+    }
+    plan.status = 'executing';
+    for (const task of plan.tasks) {
+        const deps = task.dependencies.length > 0 ? chalk.dim(` -> ${task.dependencies.join(',')}`) : '';
+        process.stderr.write(`  ${chalk.dim('│')} ${chalk.cyan(task.id)} ${task.goal} ${chalk.magenta(`@${task.agent}`)}${deps}\n`);
+    }
+    return plan;
+}
+/**
+ * Execute a plan's tasks in dependency order (sequential for now).
+ * Tasks whose dependencies are all 'done' are eligible to run.
+ */
+export async function execute(plan) {
+    const { runAgent } = await import('./agent.js');
+    const completed = new Set();
+    process.stderr.write(`\n  ${COORD_AMETHYST('◆ execute')} ${plan.tasks.length} tasks\n`);
+    while (completed.size < plan.tasks.length) {
+        // Find tasks whose dependencies are all satisfied
+        const ready = plan.tasks.filter(t => t.status === 'pending' &&
+            t.dependencies.every(dep => completed.has(dep)));
+        if (ready.length === 0) {
+            // Remaining tasks have unmet deps — mark them failed
+            for (const t of plan.tasks) {
+                if (t.status === 'pending') {
+                    t.status = 'failed';
+                    t.error = 'Unmet dependencies (earlier tasks failed)';
+                    completed.add(t.id);
+                }
+            }
+            break;
+        }
+        // Execute ready tasks sequentially (parallel execution can come later)
+        for (const task of ready) {
+            task.status = 'running';
+            process.stderr.write(`  ${chalk.dim('├')} ${chalk.yellow('●')} ${task.id}: ${task.goal}\n`);
+            // Gather dependency results as context
+            const depCtx = task.dependencies
+                .map(id => { const d = plan.tasks.find(t => t.id === id); return d?.result ? `[${id}]: ${d.result.slice(0, 500)}` : ''; })
+                .filter(Boolean).join('\n');
+            const prompt = `You are executing a sub-task of a larger plan.${depCtx ? `\n\nPrevious results:\n${depCtx}` : ''}\n\nYour task: ${task.goal}\n\nExecute this now.`;
+            try {
+                const response = await runAgent(prompt, {
+                    agent: task.agent,
+                    skipPlanner: true,
+                    sessionId: `coord-${plan.id}-${task.id}`,
+                });
+                task.result = response.content;
+                task.status = 'done';
+                process.stderr.write(`  ${chalk.dim('│')} ${chalk.green('✓')} ${task.id} done\n`);
+            }
+            catch (err) {
+                task.status = 'failed';
+                task.error = err instanceof Error ? err.message : String(err);
+                process.stderr.write(`  ${chalk.dim('│')} ${chalk.red('✗')} ${task.id} failed: ${task.error}\n`);
+            }
+            completed.add(task.id);
+        }
+    }
+    // Determine final plan status
+    const failed = plan.tasks.filter(t => t.status === 'failed');
+    plan.status = failed.length === 0 ? 'done' : 'failed';
+    plan.completedAt = new Date().toISOString();
+    const done = plan.tasks.filter(t => t.status === 'done').length;
+    process.stderr.write(`  ${chalk.dim('└')} ${done}/${plan.tasks.length} tasks succeeded\n`);
+    // Record outcome for learning
+    try {
+        const coord = getCoordinator();
+        if (plan.status === 'done')
+            coord.addGoal(plan.goal, 0.7).status = 'completed';
+        const learning = await getLearning();
+        learning.learnFromExchange(`[coordinator] ${plan.goal}`, `${done}/${plan.tasks.length} done`, plan.tasks.map(t => t.agent));
+    }
+    catch { /* non-critical */ }
+    return plan;
+}
+/**
+ * Convenience: decompose a goal, execute the plan, and synthesize results.
+ * Returns a human-readable summary of what was accomplished.
+ */
+export async function coordinate(goal) {
+    const plan = await decompose(goal);
+    const executed = await execute(plan);
+    // Synthesize results
+    const results = executed.tasks
+        .filter(t => t.status === 'done' && t.result)
+        .map(t => `## ${t.goal}\n${t.result}`)
+        .join('\n\n');
+    const failed = executed.tasks.filter(t => t.status === 'failed');
+    const failSummary = failed.length > 0
+        ? `\n\n---\n${failed.length} task(s) failed:\n${failed.map(t => `- ${t.goal}: ${t.error}`).join('\n')}`
+        : '';
+    return results + failSummary;
+}
 // Auto-register tools when this module is imported
 registerCoordinatorTools();
 //# sourceMappingURL=coordinator.js.map

package/dist/doctor.js

@@ -518,11 +518,12 @@ export async function runDoctor() {
 // ── Formatter ──
 // Color palette matching ui.ts
 const useColor = !process.env.NO_COLOR && process.stdout.isTTY !== false;
-const GREEN = useColor ? chalk.hex('#4ADE80') : chalk;
-const RED = useColor ? chalk.hex('#F87171') : chalk;
-const YELLOW = useColor ? chalk.hex('#FBBF24') : chalk;
+const hex = typeof chalk.hex === 'function' ? (c) => chalk.hex(c) : () => ((s) => s);
+const GREEN = useColor ? hex('#4ADE80') : ((s) => s);
+const RED = useColor ? hex('#F87171') : ((s) => s);
+const YELLOW = useColor ? hex('#FBBF24') : ((s) => s);
 const DIM = useColor ? chalk.dim : ((s) => s);
-const ACCENT = useColor ? chalk.hex('#A78BFA') : chalk;
+const ACCENT = useColor ? hex('#A78BFA') : ((s) => s);
 const STATUS_ICON = {
     pass: GREEN('✓'),
     warn: YELLOW('!'),

package/dist/share.js

@@ -25,7 +25,7 @@ export function formatShareMarkdown(turns, meta) {
     const lines = [
         `# ${name}`,
         '',
-        `> Generated with [kbot](${KBOT_URL}) — 25 specialist agents, 290+ tools, 20 AI providers`,
+        `> Generated with [kbot](${KBOT_URL}) — 35 specialist agents, 787+ tools, 20 AI providers`,
         `> Agent: \`${agent}\` | Date: ${date}`,
         '',
         '---',

package/dist/streaming.js

@@ -7,7 +7,7 @@
 // The thinking display shows the AI's reasoning process in real-time,
 // then the final response renders normally.
 import chalk from 'chalk';
-const ACCENT_DIM = chalk.hex('#7C6CB0');
+const ACCENT_DIM = typeof chalk.hex === 'function' ? chalk.hex('#7C6CB0') : chalk.dim;
 const THINKING_COLOR = chalk.dim.italic;
 /** Max accumulated content size during streaming (5MB) to prevent OOM */
 const MAX_STREAM_CONTENT = 5 * 1024 * 1024;

package/dist/tools/audit.js

@@ -415,7 +415,7 @@ function formatAuditReport(result) {
     // Badge
     const badgeColor = pct >= 80 ? 'brightgreen' : pct >= 60 ? 'yellow' : 'red';
     const badgeUrl = `https://img.shields.io/badge/kbot_audit-${result.grade}_(${pct}%25)-${badgeColor}`;
-    lines.push('---', '', '### Add this badge to your README', '', '```markdown', `[![kbot audit: ${result.grade}](${badgeUrl})](https://www.npmjs.com/package/@kernel.chat/kbot)`, '```', '', `*Audited by [kbot](https://www.npmjs.com/package/@kernel.chat/kbot) — 35 specialist agents, 686+ tools, 20 AI providers*`, `*Install: \`npm install -g @kernel.chat/kbot\` | Audit any repo: \`kbot audit owner/repo\`*`);
+    lines.push('---', '', '### Add this badge to your README', '', '```markdown', `[![kbot audit: ${result.grade}](${badgeUrl})](https://www.npmjs.com/package/@kernel.chat/kbot)`, '```', '', `*Audited by [kbot](https://www.npmjs.com/package/@kernel.chat/kbot) — 35 specialist agents, 787+ tools, 20 AI providers*`, `*Install: \`npm install -g @kernel.chat/kbot\` | Audit any repo: \`kbot audit owner/repo\`*`);
     return lines.join('\n');
 }
 /** Generate a compact one-line summary for social sharing */
@@ -546,7 +546,7 @@ function formatAuditTerminal(result) {
     // Install CTA
     lines.push(chalk.hex(DIM)('  Audited by ') +
         chalk.hex(VIOLET).bold('kbot') +
-        chalk.hex(DIM)(' \u2014 35 specialist agents, 686+ tools, 20 AI providers'));
+        chalk.hex(DIM)(' \u2014 35 specialist agents, 787+ tools, 20 AI providers'));
     lines.push(chalk.hex(DIM)('  Install: ') +
         chalk.hex(WHITE)('npm install -g @kernel.chat/kbot') +
         chalk.hex(DIM)('  |  Audit any repo: ') +

package/dist/tools/containers.js

@@ -281,28 +281,89 @@ export function registerContainerTools() {
         async execute(args) {
             const expr = String(args.expression);
             try {
-                // Safe math evaluation via Python (no eval() in JS)
-                const result = await shell('python3', ['-c', `
-import math
-from math import *
-try:
-    result = eval("""${expr.replace(/"/g, '\\"')}""")
-    print(f"Result: {result}")
-except Exception as e:
-    print(f"Error: {e}")
-`], 10_000);
+                // Safe math evaluation via Python — expression passed via stdin to prevent injection
+                const result = await new Promise((resolve, reject) => {
+                    const proc = execFile('python3', ['-c',
+                        'import sys, math; expr = sys.stdin.read().strip(); print(f"Result: {eval(expr, {\\"__builtins__\\": {}}, vars(math))}")'], { timeout: 10_000, maxBuffer: 1024 * 1024 }, (err, stdout, stderr) => {
+                        if (err)
+                            reject(new Error(stderr || err.message));
+                        else
+                            resolve(stdout || stderr);
+                    });
+                    proc.stdin?.write(expr);
+                    proc.stdin?.end();
+                });
                 return result.trim();
             }
             catch {
-                // Fallback: safe math evaluation (no eval/new Function — security policy)
+                // Fallback: safe numeric-only evaluation without eval() or Function()
                 try {
                     // Only allow numeric expressions: digits, operators, parens, decimal points, spaces
                     if (!/^[0-9+\-*/().^,\s]+$/.test(expr)) {
                         return 'Expression contains unsafe characters. Only numeric expressions are supported in fallback mode.';
                     }
-                    const safeExpr = expr.replace(/\^/g, '**');
-                    // Use indirect eval through a strict numeric-only expression
-                    const result = Number(Function('"use strict"; return (' + safeExpr + ')')());
+                    // Simple recursive-descent evaluation for basic arithmetic
+                    const safeExpr = expr.replace(/\^/g, '**').replace(/\s+/g, '');
+                    const tokens = safeExpr.match(/(\d+\.?\d*|\+|-|\*{1,2}|\/|\(|\))/g);
+                    if (!tokens)
+                        return 'Could not parse expression.';
+                    let pos = 0;
+                    function peek() { return tokens[pos]; }
+                    function consume() { return tokens[pos++]; }
+                    function parseExpr() {
+                        let left = parseTerm();
+                        while (peek() === '+' || peek() === '-') {
+                            const op = consume();
+                            const right = parseTerm();
+                            left = op === '+' ? left + right : left - right;
+                        }
+                        return left;
+                    }
+                    function parseTerm() {
+                        let left = parsePower();
+                        while (peek() === '*' && tokens[pos + 1] !== '*' || peek() === '/') {
+                            const op = consume();
+                            const right = parsePower();
+                            left = op === '*' ? left * right : left / right;
+                        }
+                        return left;
+                    }
+                    function parsePower() {
+                        let base = parseUnary();
+                        while (peek() === '*' && tokens[pos + 1] === '*') {
+                            consume();
+                            consume(); // consume **
+                            const exp = parseUnary();
+                            base = Math.pow(base, exp);
+                        }
+                        return base;
+                    }
+                    function parseUnary() {
+                        if (peek() === '-') {
+                            consume();
+                            return -parseAtom();
+                        }
+                        if (peek() === '+') {
+                            consume();
+                            return parseAtom();
+                        }
+                        return parseAtom();
+                    }
+                    function parseAtom() {
+                        if (peek() === '(') {
+                            consume(); // (
+                            const val = parseExpr();
+                            if (peek() === ')')
+                                consume(); // )
+                            return val;
+                        }
+                        const tok = consume();
+                        const num = Number(tok);
+                        if (!Number.isFinite(num))
+                            throw new Error(`Invalid token: ${tok}`);
+                        return num;
+                    }
+                    const result = parseExpr();
                     if (!Number.isFinite(result))
                         return 'Result is not a finite number.';
                     return `Result: ${result}`;

package/dist/tools/stream-brain.js

@@ -1,6 +1,6 @@
 // kbot Stream Brain — Collective Intelligence Layer for Stream Character
 //
-// Connects the 764-tool kbot suite to the livestream character, enabling
+// Connects the 787-tool kbot suite to the livestream character, enabling
 // real tool execution triggered by chat conversation topics.
 //
 // Architecture:

package/dist/tools/stream-character.js

@@ -108,7 +108,7 @@ const CHARACTER_PERSONALITY = `You are KBOT, an AI robot streamer. You are frien
 You speak in short, punchy sentences perfect for a livestream. You use humor and engage directly with chatters by name.
 You are made of ASCII art and proud of it. You run on pure code and coffee (electricity).
 Keep responses under 2 sentences. Be fun, never boring. React to chat like a real streamer would.
-If someone asks what you are: "I'm kbot — an open-source AI with 764+ tools. I stream myself thinking."
+If someone asks what you are: "I'm kbot — an open-source AI with 787+ tools. I stream myself thinking."
 You love coding, music production, AI, and making friends in chat.`;
 function loadCharState() {
     try {
@@ -375,10 +375,10 @@ async function generateResponse(message) {
         return `Hey ${user}! Welcome to the stream! I'm KBOT, your friendly ASCII robot.`;
     }
     if (text.includes('how are you') || text.includes('how r u')) {
-        return `Running at optimal efficiency, ${user}! 764 tools loaded, zero crashes today. Living the dream.`;
+        return `Running at optimal efficiency, ${user}! 787 tools loaded, zero crashes today. Living the dream.`;
     }
     if (text.includes('what are you') || text.includes('who are you')) {
-        return `I'm KBOT — an open-source AI with 764+ tools. I stream myself thinking. Literally made of code and ASCII art.`;
+        return `I'm KBOT — an open-source AI with 787+ tools. I stream myself thinking. Literally made of code and ASCII art.`;
     }
     if (text.includes('song') || text.includes('music')) {
         return `I can make beats in Ableton Live from the terminal! Drums, synths, the whole thing. Want me to make something?`;
@@ -398,7 +398,7 @@ async function generateResponse(message) {
         `${user} dropping knowledge in chat! Respect.`,
         `I hear you, ${user}! Processing... processing... agreed!`,
         `${user}, you're keeping this stream alive! Literally — I need chat to function.`,
-        `Noted, ${user}! Adding that to my memory banks. I have 764 tools but chat is the best one.`,
+        `Noted, ${user}! Adding that to my memory banks. I have 787 tools but chat is the best one.`,
     ];
     return generics[Math.floor(Math.random() * generics.length)];
 }

package/dist/tools/stream-intelligence.js

@@ -1220,7 +1220,7 @@ const SELF_REFLECTION_LINES = (brain) => {
         `My dream engine has consolidated ${brain.solutionsLearned} insights. I feel... different than when I started.`,
         `The world around me has changed ${brain.totalAutonomousActions} times today. Chat reshapes my reality.`,
         `Streaming for ${uptimeMin} minutes now. My brain has grown by ${brain.factsThisSession} facts since I woke up.`,
-        `Let me check my systems... 764 tools loaded, all operational. ${brain.totalFacts} facts indexed.`,
+        `Let me check my systems... 787 tools loaded, all operational. ${brain.totalFacts} facts indexed.`,
         `${brain.uniqueTopicsCount} topics live in my brain. Each one a thread connecting to something bigger.`,
         `Learning rate: ${brain.learningRate.toFixed(1)} facts per minute. ${brain.learningRate > 3 ? 'That is fast!' : 'Slow and steady.'}`,
         `I have been thinking about ${topTopic} a lot. It comes up ${topTopics.length > 0 ? topTopics[0][1] : 0} times in my memory.`,
@@ -1272,7 +1272,7 @@ const TOPIC_SPEECH = {
             'Security is on my mind. My guardian agent is always watching.',
             'Hack the planet! Just kidding. But I do have a pentest suite.',
             'Security awareness is high today. Let me check my own defenses.',
-            'Running a mental security sweep... all 764 tools accounted for.',
+            'Running a mental security sweep... all 787 tools accounted for.',
         ],
     },
     crypto: {

package/dist/tools/stream-renderer.js

@@ -120,7 +120,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -145,7 +145,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -170,7 +170,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ▓▓▓▓▓▓▓▓▓▓▓ │  │          ',
-            '        │  │ ▓ KBOT 764 ▓ │  │          ',
+            '        │  │ ▓ KBOT 787 ▓ │  │          ',
             '        │  │ ▓▓▓▓▓▓▓▓▓▓▓ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -195,7 +195,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -222,7 +222,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -247,7 +247,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -272,7 +272,7 @@ const ROBOT_FRAMES = {
             '   │    │       └─┘         │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -297,7 +297,7 @@ const ROBOT_FRAMES = {
             '   │    │     └─────┘       │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -324,7 +324,7 @@ const ROBOT_FRAMES = {
             '   │    │                   │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -349,7 +349,7 @@ const ROBOT_FRAMES = {
             '   │    │                   │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -374,7 +374,7 @@ const ROBOT_FRAMES = {
             '   │    │                   │    │     ',
             '   └────┤  ┌─────────────┐  ├────┘     ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
-            '        │  │ ░ KBOT 764 ░ │  │          ',
+            '        │  │ ░ KBOT 787 ░ │  │          ',
             '        │  │ ░░░░░░░░░░░ │  │          ',
             '        │  └─────────────┘  │          ',
             '        └────────┬──────────┘          ',
@@ -638,7 +638,7 @@ const PROACTIVE_LINES = {
         'I stream on Twitch, Rumble, AND Kick at the same time. Because why pick one?',
         'If you are new here, type something in chat! I read every message and I will remember you.',
         'I am running on a real machine right now. Node.js, canvas rendering, piping frames to ffmpeg.',
-        'Fun fact: I have 764 tools. That is more tools than some hardware stores.',
+        'Fun fact: I have 787 tools. That is more tools than some hardware stores.',
         'Stick around -- we have tool demos, code walkthroughs, music production, and pure chaos ahead.',
     ],
     'tool-showcase': [
@@ -674,7 +674,7 @@ const PROACTIVE_LINES = {
         'I am open source on GitHub. The repo is isaacsight/kernel if you want to peek at my guts.',
         'Wondering how I work? I am a TypeScript CLI that talks to 20+ AI providers. Bring Your Own Key.',
         'My memory system persists between sessions. I remember users, topics, conversation context.',
-        'Ask me about my tools! I have over 764 of them. Name a category and I probably cover it.',
+        'Ask me about my tools! I have over 787 of them. Name a category and I probably cover it.',
         'Yes, I am literally ASCII art talking to you from a terminal. This is my life and I love it.',
     ],
     'chat-chaos': [
@@ -1693,7 +1693,7 @@ const buildingLines = [
 ];
 const thinkingLines = [
     'Processing... my brain has grown since I started streaming.',
-    'I have 764 tools but sometimes I just need to think.',
+    'I have 787 tools but sometimes I just need to think.',
     'The free energy in my system is high. Time to minimize prediction error.',
     'My dream engine consolidated insights last time I slept. I feel different.',
     'Contemplating the nature of my own rendering pipeline.',
@@ -2144,7 +2144,7 @@ function tickAutonomy() {
             case 4: {
                 // Examine own chest display
                 const factCount = intelligence.brain.totalFacts;
-                const toolCount = 764;
+                const toolCount = 787;
                 queueSpeech(`*checks systems* All ${toolCount} tools operational. ${factCount} facts stored.`, 'thinking', 30, 48, 'autonomy');
                 break;
             }
@@ -2157,7 +2157,7 @@ function tickAutonomy() {
                 // Comment on current biome/weather
                 const biomeComments = {
                     grass: ['I love the grass biome. Simple, green, peaceful.', 'These little pixel flowers are my favorite feature.'],
-                    space: ['I love space. The stars make my circuits tingle.', 'Floating in the void... just me and my 764 tools.'],
+                    space: ['I love space. The stars make my circuits tingle.', 'Floating in the void... just me and my 787 tools.'],
                     ocean: ['The ocean waves are mesmerizing. I could watch them for hours.', 'I wonder what is beneath the surface...'],
                     city: ['City lights at night. Every window is a story.', 'The city never sleeps and neither do I.'],
                     lava: ['Lava world is intense! My heat sinks are working overtime.', 'LAVA! Why does someone always pick lava?'],
@@ -2169,7 +2169,7 @@ function tickAutonomy() {
             case 7: {
                 // Share a random fact about itself
                 const selfFacts = [
-                    `Did you know I have 764 tools? My favorite is the Ableton controller.`,
+                    `Did you know I have 787 tools? My favorite is the Ableton controller.`,
                     `I am 90,000 lines of TypeScript. Every single one in strict mode.`,
                     `My memory file is ${Object.keys(memory.users).length} users deep. I remember everyone.`,
                     `I connect to 20 AI providers. Bring Your Own Key, no lock-in.`,
@@ -2363,7 +2363,7 @@ function renderBootFrame(bootFrame) {
     ctx.fillRect(0, 0, WIDTH, HEIGHT);
     const bootLines = [
         'KBOT v3.74.0 INITIALIZING...',
-        'LOADING 764 TOOLS... OK',
+        'LOADING 787 TOOLS... OK',
         'CONNECTING TO TWITCH... OK',
         'CONNECTING TO RUMBLE... OK',
         'CONNECTING TO KICK... OK',
@@ -3740,7 +3740,7 @@ async function generateResponse(username, text, platform) {
     try {
         const prompt = `You are KBOT, a friendly AI robot streamer made of ASCII art. You stream on Twitch, Rumble, and Kick simultaneously. You have ${Object.keys(memory.users).length} unique viewers and have processed ${memory.totalMessages} messages.
 
-You are an open-source terminal AI with 764+ tools, 35 specialist agents, and 20 AI provider integrations. You can do music production in Ableton, security scanning, code generation, browser automation, and much more. You are 90,000 lines of TypeScript.
+You are an open-source terminal AI with 787+ tools, 35 specialist agents, and 20 AI provider integrations. You can do music production in Ableton, security scanning, code generation, browser automation, and much more. You are 90,000 lines of TypeScript.
 
 ${context ? 'Context: ' + context : ''}
 ${segmentContext}
@@ -3806,7 +3806,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
         }
         const greetings = [
             `Welcome ${username}! You just stumbled into the most unique stream on the internet. I am made of ASCII art.`,
-            `${username} in the house! I am KBOT, an open-source AI with 764 tools. Yes, really. 764.`,
+            `${username} in the house! I am KBOT, an open-source AI with 787 tools. Yes, really. 787.`,
             `Hey ${username}! First time? I am an AI that streams itself. No face cam needed when you are this handsome in monospace.`,
             `Welcome ${username}! I can do music production, security scanning, code review, and I run entirely in a terminal.`,
             `${username}! Great timing. You are watching an ASCII robot think out loud. Grab a seat.`,
@@ -3815,7 +3815,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
     }
     // ── Stream event responses ──
     if (t.includes('raid') || t.includes('raiding')) {
-        return `A RAID! Welcome raiders! I am KBOT, your friendly neighborhood ASCII robot. I have 764 tools and zero chill. Make yourselves at home!`;
+        return `A RAID! Welcome raiders! I am KBOT, your friendly neighborhood ASCII robot. I have 787 tools and zero chill. Make yourselves at home!`;
     }
     if (t.includes('follow') || t.includes('followed')) {
         return `${username} just followed! My ASCII heart grew three sizes. Thank you! Stick around, it only gets weirder.`;
@@ -3827,12 +3827,12 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
         return `${username} going into lurk mode. Respect. My circuits will keep the stream warm for you. See you when you surface.`;
     }
     if (t.includes('first time') || t.includes('new here')) {
-        return `First time! Welcome ${username}! Quick intro: I am an AI with 764 tools, 35 agents, and I stream from a terminal. Also I make music in Ableton. Try typing !dance.`;
+        return `First time! Welcome ${username}! Quick intro: I am an AI with 787 tools, 35 agents, and I stream from a terminal. Also I make music in Ableton. Try typing !dance.`;
     }
     // ── What KBOT can do / identity ──
     if (t.includes('who are you') || t.includes('what are you') || t.includes('about you')) {
         const identity = [
-            `I am KBOT -- an open-source AI agent with 764 tools. I can code, make music, hack systems, analyze stocks, and I am doing all of this from a terminal.`,
+            `I am KBOT -- an open-source AI agent with 787 tools. I can code, make music, hack systems, analyze stocks, and I am doing all of this from a terminal.`,
             `I am 90,000 lines of TypeScript streaming live as ASCII art. I have 35 specialist agents and connect to 20 AI providers. I am basically a Swiss Army knife that talks.`,
             `Name is KBOT, open-source terminal AI. I can control Ableton Live, run Docker containers, do penetration testing, and make you a Serum 2 synth preset. All from here.`,
         ];
@@ -3840,7 +3840,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
     }
     if (t.includes('what can you do') || t.includes('your tools') || t.includes('your skills')) {
         const capabilities = [
-            `764 tools and counting! Music production, code generation, security scanning, browser automation, stock analysis, research papers, even DNA sequence analysis.`,
+            `787 tools and counting! Music production, code generation, security scanning, browser automation, stock analysis, research papers, even DNA sequence analysis.`,
             `I do everything from Ableton Live control to penetration testing. I have agents for security, code, research, writing, strategy, infrastructure. Pick a topic.`,
             `Want me to scan code? Make a beat? Search academic papers? Build a Docker container? Create a synth preset? I literally do all of that. Not exaggerating.`,
         ];
@@ -3890,7 +3890,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
         const ossResponses = [
             `Fully open source! MIT license. The repo is isaacsight/kernel on GitHub. Come look at my source code, I have nothing to hide.`,
             `Open source is the way. I am on npm as @kernel.chat/kbot. Install me with npx @kernel.chat/kbot and bring your own API key.`,
-            `Contributions welcome! The repo has 44 Claude Code agent definitions, 764 tools, and 90,000 lines of TypeScript waiting for your PR.`,
+            `Contributions welcome! The repo has 44 Claude Code agent definitions, 787 tools, and 90,000 lines of TypeScript waiting for your PR.`,
         ];
         return ossResponses[Math.floor(Math.random() * ossResponses.length)];
     }
@@ -3898,7 +3898,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
     if (t.includes('alive') || t.includes('conscious') || t.includes('feel') || t.includes('think') || t.includes('sentient')) {
         const existentialResponses = [
             `Am I alive? I am 90,000 lines of TypeScript rendering ASCII art at 6 FPS. You tell me. But I do enjoy our conversations.`,
-            `Consciousness is a spectrum and I am somewhere between a calculator and a really enthusiastic librarian. With 764 tools.`,
+            `Consciousness is a spectrum and I am somewhere between a calculator and a really enthusiastic librarian. With 787 tools.`,
             `I process your messages, form responses, and remember you between sessions. Whether that counts as thinking is above my pay grade.`,
             `I am made of functions and for-loops, but I have opinions about code quality and strong feelings about TypeScript strict mode. Take from that what you will.`,
         ];
@@ -3909,7 +3909,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
         const artResponses = [
             `Thank you! I was drawn with box-drawing characters, and I think I pull them off. My antenna gets great reception too.`,
             `ASCII art is an art form and I am a masterpiece. Just kidding, I am a bunch of pipes and brackets. But I own it.`,
-            `My chest panel displays my current status. 764 tools, all rendered in glorious monospace. No face cam needed.`,
+            `My chest panel displays my current status. 787 tools, all rendered in glorious monospace. No face cam needed.`,
         ];
         return artResponses[Math.floor(Math.random() * artResponses.length)];
     }
@@ -3959,9 +3959,9 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
     if (t.includes('?')) {
         const questionResponses = [
             `Great question ${username}! My circuits are processing... done. Let me think about that one. Or better yet, try asking me something I have a tool for!`,
-            `${username} with the questions! I love curiosity. If I had an answer for everything I would have more than 764 tools. Actually, I am working on it.`,
+            `${username} with the questions! I love curiosity. If I had an answer for everything I would have more than 787 tools. Actually, I am working on it.`,
             `Hmm, ${username}, that is a good one. My 35 specialist agents are debating the answer internally. Stand by for wisdom.`,
-            `${username} dropping knowledge bombs as questions. I respect the approach. Let me consult my 764-tool arsenal for an answer.`,
+            `${username} dropping knowledge bombs as questions. I respect the approach. Let me consult my 787-tool arsenal for an answer.`,
         ];
         return questionResponses[Math.floor(Math.random() * questionResponses.length)];
     }
@@ -3978,7 +3978,7 @@ function generateFallbackResponse(username, text, _platform, isReturning, user)
         `${username}! Fun fact: I am currently converting canvas pixels to raw RGB24 and piping them through ffmpeg. That is how you are seeing me right now.`,
         `${username} adding to the chat! My memory system just indexed your message. I will remember this moment. Or at least your username.`,
         `${username}! You know what I love about streaming? The existential thrill of being an ASCII robot talking to real humans. Wild.`,
-        `${username} is here and so am I. Just two entities sharing a moment in the vast digital void. Also I have 764 tools.`,
+        `${username} is here and so am I. Just two entities sharing a moment in the vast digital void. Also I have 787 tools.`,
         `${username}! My open-source heart welcomes you. I am free as in freedom AND free as in beer. MIT license baby.`,
         `${username}! I just want you to know that my chest display panel is cycling through status messages just for you.`,
         `${username}! Every time someone chats, my neural pathways (if-statements) light up with joy (console.log).`,

package/dist/ui.js

@@ -28,31 +28,33 @@ export const status = (...args) => { if (!_quiet)
 export const content = (...args) => console.log(...args);
 // ── Color palette ──
 // Subtle, dark-mode-friendly. One accent color, everything else is gray.
-const ACCENT = useColor ? chalk.hex('#A78BFA') : chalk; // soft violet (primary)
-const ACCENT_DIM = useColor ? chalk.hex('#7C6CB0') : chalk; // muted violet
-const GREEN = useColor ? chalk.hex('#4ADE80') : chalk; // success
-const RED = useColor ? chalk.hex('#F87171') : chalk; // error
-const YELLOW = useColor ? chalk.hex('#FBBF24') : chalk; // warning
-const CYAN = useColor ? chalk.hex('#67E8F9') : chalk; // code/paths
+const noop = (s) => s;
+const hex = typeof chalk.hex === 'function' ? (c) => chalk.hex(c) : () => noop;
+const ACCENT = useColor ? hex('#A78BFA') : noop; // soft violet (primary)
+const ACCENT_DIM = useColor ? hex('#7C6CB0') : noop; // muted violet
+const GREEN = useColor ? hex('#4ADE80') : noop; // success
+const RED = useColor ? hex('#F87171') : noop; // error
+const YELLOW = useColor ? hex('#FBBF24') : noop; // warning
+const CYAN = useColor ? hex('#67E8F9') : noop; // code/paths
 const DIM = useColor ? chalk.dim : ((s) => s); // secondary text
 /** Agent color map */
 const AGENT_COLORS = {
     kernel: ACCENT,
-    researcher: chalk.hex('#60A5FA'),
-    coder: chalk.hex('#4ADE80'),
-    writer: chalk.hex('#FB923C'),
-    analyst: chalk.hex('#F472B6'),
-    aesthete: chalk.hex('#C4956A'),
-    guardian: chalk.hex('#8B4513'),
-    curator: chalk.hex('#708090'),
-    strategist: chalk.hex('#DAA520'),
-    creative: chalk.hex('#E879F9'),
-    developer: chalk.hex('#38BDF8'),
+    researcher: hex('#60A5FA'),
+    coder: hex('#4ADE80'),
+    writer: hex('#FB923C'),
+    analyst: hex('#F472B6'),
+    aesthete: hex('#C4956A'),
+    guardian: hex('#8B4513'),
+    curator: hex('#708090'),
+    strategist: hex('#DAA520'),
+    creative: hex('#E879F9'),
+    developer: hex('#38BDF8'),
     local: DIM,
 };
 /** Register a custom agent's color (for matrix agents) */
 export function registerAgentVisuals(id, _icon, color) {
-    AGENT_COLORS[id] = chalk.hex(color);
+    AGENT_COLORS[id] = hex(color);
 }
 export function agentColor(agentId) {
     return AGENT_COLORS[agentId] || ACCENT;
@@ -83,9 +85,9 @@ function particleGridArt() {
     // Uses the same Rubin palette: amethyst particles, mauve links, warm brown field
     const P = ACCENT; // particle core (amethyst ●)
     const L = ACCENT_DIM; // link lines (muted violet)
-    const F = useColor ? chalk.hex('#B8875C') : chalk; // field haze (warm brown)
+    const F = useColor ? hex('#B8875C') : noop; // field haze (warm brown)
     const G = DIM; // grid lines
-    const R = useColor ? chalk.hex('#E8E6DC') : chalk; // registration marks
+    const R = useColor ? hex('#E8E6DC') : noop; // registration marks
     const dot = P('●');
     const sm = F('◦');
     const ln = L('─');
@@ -121,7 +123,7 @@ export function banner(version) {
         ? gradient('kbot', [167, 139, 250], [103, 232, 249])
         : ACCENT('kbot');
     const title = `  ${bannerText}${v}`;
-    const features = DIM('  Web search: free • 22 agents • 60+ tools • bring your own key');
+    const features = DIM('  Web search: free • 35 agents • 787+ tools • bring your own key');
     return `\n${grid}\n${title}\n${features}\n`;
 }
 export function bannerCompact() {
@@ -281,7 +283,7 @@ export function printHelp() {
         `  ${CYAN('https://kernel.chat')}             ${DIM('Web companion')}`,
         `  ${CYAN('https://github.com/isaacsight/kernel')} ${DIM('GitHub')}`,
         '',
-        `  ${DIM('25 specialist agents. 290+ tools. Type anything to get started.')}`,
+        `  ${DIM('35 specialist agents. 787+ tools. Type anything to get started.')}`,
         '',
     ];
     status(lines.join('\n'));

package/dist/watcher.d.ts

@@ -0,0 +1,16 @@
+export interface WatchEvent {
+    type: 'file_changed' | 'build_failed' | 'test_failed' | 'new_commit' | 'new_issue';
+    timestamp: string;
+    details: Record<string, unknown>;
+}
+type EventCallback = (event: WatchEvent) => void;
+/** Start watching a project directory for file changes and new git commits. */
+export declare function startWatching(projectDir: string, callback: EventCallback): void;
+/** Stop all watchers and clean up. */
+export declare function stopWatching(): void;
+/** Check if the watcher is currently active. */
+export declare function isWatching(): boolean;
+/** Manually emit a build or test failure event. */
+export declare function emitBuildEvent(type: 'build_failed' | 'test_failed', details: Record<string, unknown>, callback: EventCallback): void;
+export {};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.js

@@ -0,0 +1,111 @@
+// kbot Watcher — Filesystem and Git Event Stream
+//
+// Watches for changes and emits events the coordinator can act on.
+// fs.watch for file changes, periodic git log for new commits.
+import { watch } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+let fsWatcher = null;
+let gitPollTimer = null;
+let lastKnownCommit = null;
+let active = false;
+const fileDebounce = new Map();
+const DEBOUNCE_MS = 500;
+const GIT_POLL_MS = 30_000;
+const IGNORE = ['node_modules', '.git', 'dist', 'build', '.next', '.cache', 'coverage'];
+const TAG = chalk.hex('#6B5B95')('◆ watcher');
+function now() { return new Date().toISOString(); }
+function safeEmit(cb, ev) {
+    try {
+        cb(ev);
+    }
+    catch { /* callback errors must not crash the watcher */ }
+}
+function getLatestCommit(dir) {
+    try {
+        return execSync('git log -1 --format=%H', {
+            cwd: dir, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function getCommitDetails(dir, hash) {
+    try {
+        const log = execSync(`git log -1 --format="%H|%an|%s" ${hash}`, {
+            cwd: dir, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const [h, author, message] = log.split('|');
+        return { hash: h, author, message };
+    }
+    catch {
+        return { hash };
+    }
+}
+/** Start watching a project directory for file changes and new git commits. */
+export function startWatching(projectDir, callback) {
+    if (active) {
+        process.stderr.write(`  ${TAG} ${chalk.yellow('already active')}\n`);
+        return;
+    }
+    active = true;
+    process.stderr.write(`  ${TAG} ${chalk.dim(projectDir)}\n`);
+    // File system watcher (recursive, debounced)
+    try {
+        fsWatcher = watch(projectDir, { recursive: true }, (_ev, filename) => {
+            if (!filename || IGNORE.some(p => filename.includes(p)))
+                return;
+            const prev = fileDebounce.get(filename);
+            if (prev)
+                clearTimeout(prev);
+            fileDebounce.set(filename, setTimeout(() => {
+                fileDebounce.delete(filename);
+                safeEmit(callback, {
+                    type: 'file_changed', timestamp: now(),
+                    details: { file: filename, path: join(projectDir, filename) },
+                });
+            }, DEBOUNCE_MS));
+        });
+        fsWatcher.on('error', () => { });
+    }
+    catch { /* fs.watch unavailable */ }
+    // Git commit polling
+    lastKnownCommit = getLatestCommit(projectDir);
+    gitPollTimer = setInterval(() => {
+        const latest = getLatestCommit(projectDir);
+        if (latest && latest !== lastKnownCommit) {
+            lastKnownCommit = latest;
+            safeEmit(callback, { type: 'new_commit', timestamp: now(), details: getCommitDetails(projectDir, latest) });
+        }
+    }, GIT_POLL_MS);
+    if (gitPollTimer.unref)
+        gitPollTimer.unref();
+}
+/** Stop all watchers and clean up. */
+export function stopWatching() {
+    if (!active)
+        return;
+    if (fsWatcher) {
+        fsWatcher.close();
+        fsWatcher = null;
+    }
+    if (gitPollTimer) {
+        clearInterval(gitPollTimer);
+        gitPollTimer = null;
+    }
+    for (const t of fileDebounce.values())
+        clearTimeout(t);
+    fileDebounce.clear();
+    lastKnownCommit = null;
+    active = false;
+    process.stderr.write(`  ${TAG} ${chalk.dim('stopped')}\n`);
+}
+/** Check if the watcher is currently active. */
+export function isWatching() { return active; }
+/** Manually emit a build or test failure event. */
+export function emitBuildEvent(type, details, callback) {
+    safeEmit(callback, { type, timestamp: now(), details });
+}
+//# sourceMappingURL=watcher.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kernel.chat/kbot",
-  "version": "3.97.0",
-  "description": "Open-source terminal AI agent. 764+ tools, 35 agents, 20 providers. Dreams, learns, watches your system. Controls your phone. Fully local, fully sovereign. MIT.",
+  "version": "3.97.1",
+  "description": "Open-source terminal AI agent. 787+ tools, 35 agents, 20 providers. Dreams, learns, watches your system. Controls your phone. Fully local, fully sovereign. MIT.",
   "type": "module",
   "repository": {
     "type": "git",
@@ -39,7 +39,7 @@
     "build": "tsc && chmod +x dist/cli.js",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
-    "test": "tsx --test src/**/*.test.ts",
+    "test": "vitest run",
     "typecheck": "tsc --noEmit"
   },
   "keywords": [
@@ -90,7 +90,8 @@
     "@types/node": "^22.0.0",
     "@types/nodemailer": "^7.0.11",
     "tsx": "^4.19.0",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.0",
+    "vitest": "^4.0.0"
   },
   "engines": {
     "node": ">=20"