@kernel.chat/kbot 3.72.0 → 3.73.0

package/dist/buddy.d.ts

@@ -74,6 +74,27 @@ export declare function addBuddyXP(amount: number): {
     levelInfo: BuddyLevelInfo;
     leveledUp: boolean;
 };
+/**
+ * Sync buddy stats to the cloud leaderboard.
+ * Anonymous — uses a SHA-256 hash of hostname+homedir, not user identity.
+ * Requires a kernel.chat token (cloud sync enabled).
+ */
+export declare function syncBuddyToCloud(): Promise<boolean>;
+/**
+ * Fetch the buddy leaderboard from the cloud.
+ * Returns ranked entries sorted by XP descending.
+ */
+export declare function fetchBuddyLeaderboard(opts?: {
+    limit?: number;
+    species?: string;
+}): Promise<Array<{
+    species: string;
+    level: number;
+    xp: number;
+    achievement_count: number;
+    sessions: number;
+    rank: number;
+}>>;
 /**
  * Get the buddy's current level info without modifying state.
  * Includes level, XP, XP to next level, and species-specific title.

package/dist/buddy.js

@@ -7,7 +7,7 @@
 // Achievements: milestones that unlock as the user uses kbot. Persisted in buddy.json.
 //
 // Persists buddy name + achievements to ~/.kbot/buddy.json
-import { homedir } from 'node:os';
+import { homedir, hostname } from 'node:os';
 import { join } from 'node:path';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { createHash } from 'node:crypto';
@@ -15,6 +15,7 @@ import { createInterface } from 'node:readline';
 import { getDreamStatus, getDreamPrompt } from './dream.js';
 import { getExtendedStats, getProfileSummary } from './learning.js';
 import { getToolMetrics } from './tools/index.js';
+import { getCloudToken } from './cloud-sync.js';
 // ── Paths ──
 const KBOT_DIR = join(homedir(), '.kbot');
 const BUDDY_FILE = join(KBOT_DIR, 'buddy.json');
@@ -930,6 +931,8 @@ export function addBuddyXP(amount) {
     config.evolution = evo;
     saveBuddyConfig(config);
     cachedEvolution = evo;
+    // Debounced cloud sync — leaderboard update
+    scheduleBuddySync();
     const species = resolveSpecies();
     const nextLevel = (newLevel < 3 ? (newLevel + 1) : null);
     const xpToNext = nextLevel !== null ? LEVEL_THRESHOLDS[nextLevel] - evo.xp : null;
@@ -943,6 +946,99 @@ export function addBuddyXP(amount) {
         leveledUp,
     };
 }
+// ── Cloud Sync — Buddy Leaderboard ──
+const ENGINE_URL = 'https://eoxxpyixdieprsxlpwcs.supabase.co/functions/v1/kbot-engine';
+const BUDDY_SYNC_DEBOUNCE_MS = 5 * 60 * 1000; // max once per 5 minutes
+let buddySyncTimer = null;
+let lastBuddySync = 0;
+/** Generate an anonymous device hash from hostname + homedir */
+function getDeviceHash() {
+    return createHash('sha256')
+        .update(`${hostname()}:${homedir()}`)
+        .digest('hex');
+}
+/**
+ * Sync buddy stats to the cloud leaderboard.
+ * Anonymous — uses a SHA-256 hash of hostname+homedir, not user identity.
+ * Requires a kernel.chat token (cloud sync enabled).
+ */
+export async function syncBuddyToCloud() {
+    const token = getCloudToken();
+    if (!token)
+        return false;
+    try {
+        const buddy = getBuddy();
+        const lvl = getBuddyLevel();
+        const achievements = getAchievements();
+        const stats = getExtendedStats();
+        const unlockedCount = achievements.filter(a => a.unlockedAt !== null).length;
+        const res = await fetch(`${ENGINE_URL}/sync`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+            body: JSON.stringify({
+                action: 'buddy_sync',
+                device_hash: getDeviceHash(),
+                species: buddy.species,
+                level: lvl.level,
+                xp: lvl.xp,
+                achievement_count: unlockedCount,
+                sessions: stats.sessions,
+            }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** Debounced buddy sync — called from addBuddyXP, max once per 5 minutes */
+function scheduleBuddySync() {
+    const now = Date.now();
+    if (now - lastBuddySync < BUDDY_SYNC_DEBOUNCE_MS)
+        return;
+    if (buddySyncTimer)
+        return;
+    buddySyncTimer = setTimeout(() => {
+        buddySyncTimer = null;
+        lastBuddySync = Date.now();
+        syncBuddyToCloud().catch(() => { }); // fire and forget
+    }, 1000); // short delay to batch rapid XP gains
+}
+/**
+ * Fetch the buddy leaderboard from the cloud.
+ * Returns ranked entries sorted by XP descending.
+ */
+export async function fetchBuddyLeaderboard(opts) {
+    const token = getCloudToken();
+    if (!token)
+        return [];
+    try {
+        const res = await fetch(`${ENGINE_URL}/sync`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+            body: JSON.stringify({
+                action: 'buddy_leaderboard',
+                limit: opts?.limit ?? 50,
+                ...(opts?.species ? { species: opts.species } : {}),
+            }),
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        return data.leaderboard ?? [];
+    }
+    catch {
+        return [];
+    }
+}
 /**
  * Get the buddy's current level info without modifying state.
  * Includes level, XP, XP to next level, and species-specific title.

package/dist/cli.js

@@ -27,7 +27,7 @@ import { banner, bannerCompact, bannerAuth, prompt as kbotPrompt, printError, pr
 import { checkForUpdate, selfUpdate } from './updater.js';
 import { runTutorial } from './tutorial.js';
 import { syncOnStartup, schedulePush, flushCloudSync, isCloudSyncEnabled, setCloudToken, getCloudToken } from './cloud-sync.js';
-import { getBuddy, getBuddyGreeting, formatBuddyStatus, getBuddyDreamNarration, renameBuddy, buddyChat, getAchievements, getBuddyLevel } from './buddy.js';
+import { getBuddy, getBuddyGreeting, formatBuddyStatus, getBuddyDreamNarration, renameBuddy, buddyChat, getAchievements, getBuddyLevel, fetchBuddyLeaderboard } from './buddy.js';
 import chalk from 'chalk';
 import { createRequire } from 'node:module';
 const __require = createRequire(import.meta.url);
@@ -3579,6 +3579,62 @@ async function main() {
         console.log();
         process.exit(0);
     });
+    buddyCmd
+        .command('leaderboard')
+        .description('Show the global buddy leaderboard — anonymous rankings across all kbot installs')
+        .option('-l, --limit <n>', 'Number of entries to show', '20')
+        .option('-s, --species <species>', 'Filter by species (fox, owl, cat, robot, ghost, mushroom, octopus, dragon)')
+        .action(async (opts) => {
+        const limit = Math.min(Math.max(parseInt(opts.limit, 10) || 20, 1), 200);
+        const species = opts.species?.toLowerCase();
+        const validSpecies = ['fox', 'owl', 'cat', 'robot', 'ghost', 'mushroom', 'octopus', 'dragon'];
+        if (species && !validSpecies.includes(species)) {
+            printError(`Unknown species "${species}". Valid: ${validSpecies.join(', ')}`);
+            process.exit(1);
+        }
+        printInfo('Fetching leaderboard...');
+        const entries = await fetchBuddyLeaderboard({ limit, species });
+        if (entries.length === 0) {
+            console.log();
+            printWarn('No entries on the leaderboard yet.');
+            printInfo('Use kbot to earn XP and enable cloud sync to appear on the leaderboard.');
+            console.log();
+            process.exit(0);
+        }
+        const SPECIES_ICONS = {
+            fox: '[fox]', owl: '[owl]', cat: '[cat]', robot: '[bot]',
+            ghost: '[gho]', mushroom: '[msh]', octopus: '[oct]', dragon: '[drg]',
+        };
+        const LEVEL_TITLES_SHORT = {
+            0: 'Novice', 1: 'Adept', 2: 'Master', 3: 'Legend',
+        };
+        const header = species
+            ? `Buddy Leaderboard — ${species}`
+            : 'Global Buddy Leaderboard';
+        console.log();
+        console.log(`  ${chalk.bold(header)}`);
+        console.log(`  ${chalk.dim('─'.repeat(56))}`);
+        console.log(`  ${chalk.dim('#'.padStart(3))}  ${chalk.dim('Species'.padEnd(7))} ${chalk.dim('Level'.padEnd(12))} ${chalk.dim('XP'.padStart(6))}  ${chalk.dim('Achv'.padStart(4))}  ${chalk.dim('Sessions'.padStart(8))}`);
+        console.log(`  ${chalk.dim('─'.repeat(56))}`);
+        for (const entry of entries) {
+            const icon = SPECIES_ICONS[entry.species] || entry.species.slice(0, 5);
+            const title = LEVEL_TITLES_SHORT[entry.level] ?? `L${entry.level}`;
+            const levelStr = `${entry.level} ${title}`;
+            const rankStr = String(entry.rank).padStart(3);
+            const xpStr = String(entry.xp).padStart(6);
+            const achvStr = String(entry.achievement_count).padStart(4);
+            const sessStr = String(entry.sessions).padStart(8);
+            // Highlight top 3
+            const rankColor = entry.rank === 1 ? chalk.hex('#FFD700') :
+                entry.rank === 2 ? chalk.hex('#C0C0C0') :
+                    entry.rank === 3 ? chalk.hex('#CD7F32') : chalk.white;
+            console.log(`  ${rankColor(rankStr)}  ${chalk.hex('#A78BFA')(icon.padEnd(7))} ${levelStr.padEnd(12)} ${chalk.hex('#4ADE80')(xpStr)}  ${achvStr}  ${chalk.dim(sessStr)}`);
+        }
+        console.log();
+        console.log(`  ${chalk.dim(`${entries.length} entries shown`)}`);
+        console.log();
+        process.exit(0);
+    });
     buddyCmd.action(() => {
         buddyCmd.commands.find(c => c.name() === 'status')?.parse(['', '', 'status']);
     });

package/dist/tools/buddy-tools.js

@@ -1,12 +1,13 @@
 // kbot Buddy Tools — Interact with your terminal companion
 //
-// Four tools:
+// Five tools:
 //   buddy_status       — Show buddy name, species, mood, and sprite
 //   buddy_rename       — Give your buddy a custom name (persisted to ~/.kbot/buddy.json)
 //   buddy_achievements — Show all achievements with unlock status and progress
 //   buddy_personality  — Show species personality traits, style, and strength
+//   buddy_leaderboard  — Global anonymous leaderboard across all kbot installs
 import { registerTool } from './index.js';
-import { getBuddy, getBuddySprite, getBuddyGreeting, getBuddyLevel, formatBuddyStatus, renameBuddy, getAchievements, getAchievementProgress, getSpeciesPersonality, } from '../buddy.js';
+import { getBuddy, getBuddySprite, getBuddyGreeting, getBuddyLevel, formatBuddyStatus, renameBuddy, getAchievements, getAchievementProgress, getSpeciesPersonality, fetchBuddyLeaderboard, } from '../buddy.js';
 const VALID_MOODS = ['idle', 'thinking', 'success', 'error', 'learning', 'alert', 'dance', 'curious', 'proud'];
 export function registerBuddyTools() {
     registerTool({
@@ -124,5 +125,57 @@ export function registerBuddyTools() {
             ].join('\n');
         },
     });
+    registerTool({
+        name: 'buddy_leaderboard',
+        description: 'Show the global buddy leaderboard — anonymous rankings of all kbot buddies across installs, sorted by XP. Requires cloud sync (kernel.chat token).',
+        parameters: {
+            limit: {
+                type: 'number',
+                description: 'Number of entries to show (default 20, max 200)',
+            },
+            species: {
+                type: 'string',
+                description: 'Filter by species: fox, owl, cat, robot, ghost, mushroom, octopus, dragon',
+            },
+        },
+        tier: 'free',
+        async execute(args) {
+            const SPECIES_ICONS = {
+                fox: '[fox]', owl: '[owl]', cat: '[cat]', robot: '[bot]',
+                ghost: '[gho]', mushroom: '[msh]', octopus: '[oct]', dragon: '[drg]',
+            };
+            const LEVEL_TITLES_SHORT = {
+                0: 'Novice', 1: 'Adept', 2: 'Master', 3: 'Legend',
+            };
+            const limit = Math.min(Math.max(Math.floor(Number(args.limit) || 20), 1), 200);
+            const species = args.species ? String(args.species).toLowerCase() : undefined;
+            const validSpecies = ['fox', 'owl', 'cat', 'robot', 'ghost', 'mushroom', 'octopus', 'dragon'];
+            if (species && !validSpecies.includes(species)) {
+                return `Unknown species "${species}". Valid: ${validSpecies.join(', ')}`;
+            }
+            const entries = await fetchBuddyLeaderboard({ limit, species });
+            if (entries.length === 0) {
+                return 'No entries on the leaderboard yet. Use kbot to earn XP and sync to the cloud!';
+            }
+            const lines = [];
+            const header = species
+                ? `=== Buddy Leaderboard — ${species} ===`
+                : '=== Global Buddy Leaderboard ===';
+            lines.push(header);
+            lines.push('');
+            // Table header
+            lines.push(`  ${'#'.padStart(3)}  ${'Species'.padEnd(7)} ${'Level'.padEnd(12)} ${'XP'.padStart(6)}  ${'Achv'.padStart(4)}  ${'Sessions'.padStart(8)}`);
+            lines.push(`  ${'─'.repeat(3)}  ${'─'.repeat(7)} ${'─'.repeat(12)} ${'─'.repeat(6)}  ${'─'.repeat(4)}  ${'─'.repeat(8)}`);
+            for (const entry of entries) {
+                const icon = SPECIES_ICONS[entry.species] || entry.species.slice(0, 5);
+                const title = LEVEL_TITLES_SHORT[entry.level] ?? `L${entry.level}`;
+                const levelStr = `${entry.level} ${title}`;
+                lines.push(`  ${String(entry.rank).padStart(3)}  ${icon.padEnd(7)} ${levelStr.padEnd(12)} ${String(entry.xp).padStart(6)}  ${String(entry.achievement_count).padStart(4)}  ${String(entry.sessions).padStart(8)}`);
+            }
+            lines.push('');
+            lines.push(`${entries.length} entries shown`);
+            return lines.join('\n');
+        },
+    });
 }
 //# sourceMappingURL=buddy-tools.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernel.chat/kbot",
-  "version": "3.72.0",
+  "version": "3.73.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.",
   "type": "module",
   "repository": {