@kernel.chat/kbot 3.95.0 → 3.97.1

package/dist/tools/tile-world.d.ts

@@ -32,9 +32,15 @@ export declare function updateCamera(world: TileWorld, robotWorldX: number, pane
 export declare function worldXToTile(worldPixelX: number): number;
 /** Convert tile X to world pixel X */
 export declare function tileToWorldX(tileX: number): number;
+/** Get a tile at absolute tile coordinates, generating chunk if needed */
+export declare function getTile(world: TileWorld, tileX: number, tileY: number): BlockType;
+/** Set a tile at absolute tile coordinates */
+export declare function setTile(world: TileWorld, tileX: number, tileY: number, block: BlockType): boolean;
 /** Render the visible tile world */
 export declare function renderTileWorld(ctx: CanvasRenderingContext2D, world: TileWorld, panelX: number, panelY: number, panelWidth: number, panelHeight: number, robotWorldX: number, frame: number): void;
 /** Parse and handle tile world chat commands. Returns response string or null if not a tile command. */
 export declare function handleTileCommand(text: string, username: string, world: TileWorld, robotWorldPixelX: number): string | null;
+/** Find the surface Y (first non-air tile from top) at a given tile X */
+export declare function findSurfaceY(world: TileWorld, tileX: number): number;
 export declare function registerTileWorldTools(): void;
 //# sourceMappingURL=tile-world.d.ts.map

package/dist/tools/tile-world.js

@@ -417,7 +417,7 @@ function tileXToLocalX(tileX) {
 }
 // ─── Tile Access Helpers ──────────────────────────────────────
 /** Get a tile at absolute tile coordinates, generating chunk if needed */
-function getTile(world, tileX, tileY) {
+export function getTile(world, tileX, tileY) {
     if (tileY < 0 || tileY >= WORLD_HEIGHT)
         return 'air';
     const chunkIdx = tileXToChunkIndex(tileX);
@@ -430,7 +430,7 @@ function getTile(world, tileX, tileY) {
     return chunk.tiles[tileY][lx];
 }
 /** Set a tile at absolute tile coordinates */
-function setTile(world, tileX, tileY, block) {
+export function setTile(world, tileX, tileY, block) {
     if (tileY < 0 || tileY >= WORLD_HEIGHT)
         return false;
     const chunkIdx = tileXToChunkIndex(tileX);
@@ -1009,7 +1009,7 @@ export function handleTileCommand(text, username, world, robotWorldPixelX) {
     return null;
 }
 /** Find the surface Y (first non-air tile from top) at a given tile X */
-function findSurfaceY(world, tileX) {
+export function findSurfaceY(world, tileX) {
     for (let y = 0; y < WORLD_HEIGHT; y++) {
         const block = getTile(world, tileX, y);
         if (block !== 'air' && block !== 'leaves' && block !== 'water') {

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.95.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"