@kernel.chat/kbot 3.71.0 → 3.73.0

package/dist/integrations/mobile-mcp-client.js

@@ -0,0 +1,343 @@
+/**
+ * mobile-mcp-client.ts — kbot <-> mobile-mcp integration
+ *
+ * Singleton client that manages the mobile-mcp server process lifecycle.
+ * Communicates via MCP protocol over stdio transport.
+ * Auto-installs @mobilenext/mobile-mcp via npm if not present.
+ *
+ * mobile-mcp provides native accessibility-tree-based automation for
+ * iOS and Android devices connected via USB or WiFi.
+ *
+ * @see https://github.com/mobile-next/mobile-mcp
+ */
+import { spawn, execSync } from 'node:child_process';
+import { Buffer } from 'node:buffer';
+function encodeJsonRpc(msg) {
+    const body = JSON.stringify(msg);
+    return `Content-Length: ${Buffer.byteLength(body)}\r\n\r\n${body}`;
+}
+// ── MobileMCPClient ────────────────────────────────────────────────────
+export class MobileMCPClient {
+    static instance = null;
+    process = null;
+    messageId = 0;
+    pending = new Map();
+    buffer = '';
+    initialized = false;
+    activeDeviceId = null;
+    static getInstance() {
+        if (!MobileMCPClient.instance) {
+            MobileMCPClient.instance = new MobileMCPClient();
+        }
+        return MobileMCPClient.instance;
+    }
+    /** Whether the MCP server process is running and initialized */
+    get isConnected() {
+        return this.initialized && this.process !== null && !this.process.killed;
+    }
+    /** The device ID currently being controlled */
+    get currentDeviceId() {
+        return this.activeDeviceId;
+    }
+    // ── Process lifecycle ──────────────────────────────────────────────
+    /** Start the mobile-mcp server process and perform MCP handshake */
+    async start() {
+        if (this.isConnected)
+            return;
+        // Ensure npx is available
+        try {
+            execSync('which npx', { stdio: 'pipe' });
+        }
+        catch {
+            throw new Error('npx not found. Ensure Node.js >= 22 is installed.');
+        }
+        // Spawn the mobile-mcp server via npx (auto-installs if needed)
+        this.process = spawn('npx', ['-y', '@mobilenext/mobile-mcp@latest'], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: { ...process.env },
+        });
+        this.buffer = '';
+        this.messageId = 0;
+        this.pending.clear();
+        this.process.stdout?.on('data', (chunk) => {
+            this.buffer += chunk.toString();
+            this.parseMessages();
+        });
+        // Log stderr for debugging but don't crash
+        this.process.stderr?.on('data', (chunk) => {
+            const msg = chunk.toString().trim();
+            if (msg && process.env.KBOT_DEBUG) {
+                console.error(`[mobile-mcp stderr] ${msg}`);
+            }
+        });
+        this.process.on('error', (err) => {
+            this.initialized = false;
+            this.process = null;
+            if (process.env.KBOT_DEBUG) {
+                console.error(`[mobile-mcp] Process error: ${err.message}`);
+            }
+        });
+        this.process.on('exit', (code) => {
+            this.initialized = false;
+            this.process = null;
+            // Reject any pending requests
+            const pendingEntries = Array.from(this.pending.entries());
+            for (const [id, { reject }] of pendingEntries) {
+                reject(new Error(`mobile-mcp process exited with code ${code}`));
+                this.pending.delete(id);
+            }
+        });
+        // MCP initialize handshake
+        try {
+            await this.sendRequest('initialize', {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'kbot', version: '3.61.0' },
+            });
+            this.sendNotification('initialized', {});
+            this.initialized = true;
+        }
+        catch (err) {
+            this.stop();
+            throw new Error(`mobile-mcp handshake failed: ${err instanceof Error ? err.message : String(err)}\n` +
+                'Ensure @mobilenext/mobile-mcp is installed: npm install -g @mobilenext/mobile-mcp');
+        }
+    }
+    /** Stop the mobile-mcp server process */
+    stop() {
+        if (this.process) {
+            try {
+                // Graceful shutdown
+                this.sendNotification('exit', null);
+            }
+            catch { /* best effort */ }
+            this.process.kill();
+            this.process = null;
+        }
+        this.initialized = false;
+        this.activeDeviceId = null;
+        this.buffer = '';
+        this.pending.clear();
+    }
+    // ── MCP protocol ───────────────────────────────────────────────────
+    parseMessages() {
+        while (true) {
+            const headerEnd = this.buffer.indexOf('\r\n\r\n');
+            if (headerEnd === -1)
+                break;
+            const header = this.buffer.slice(0, headerEnd);
+            const lengthMatch = header.match(/Content-Length:\s*(\d+)/i);
+            if (!lengthMatch) {
+                this.buffer = this.buffer.slice(headerEnd + 4);
+                continue;
+            }
+            const contentLength = parseInt(lengthMatch[1], 10);
+            const bodyStart = headerEnd + 4;
+            if (this.buffer.length < bodyStart + contentLength)
+                break;
+            const body = this.buffer.slice(bodyStart, bodyStart + contentLength);
+            this.buffer = this.buffer.slice(bodyStart + contentLength);
+            try {
+                const msg = JSON.parse(body);
+                if (msg.id !== undefined && this.pending.has(msg.id)) {
+                    const { resolve, reject } = this.pending.get(msg.id);
+                    this.pending.delete(msg.id);
+                    if (msg.error) {
+                        reject(new Error(msg.error.message));
+                    }
+                    else {
+                        resolve(msg.result);
+                    }
+                }
+            }
+            catch {
+                // Skip malformed messages
+            }
+        }
+    }
+    sendRequest(method, params, timeout = 30_000) {
+        return new Promise((resolve, reject) => {
+            if (!this.process?.stdin?.writable) {
+                reject(new Error('mobile-mcp process is not running. Call mobile_connect first.'));
+                return;
+            }
+            const id = ++this.messageId;
+            this.pending.set(id, { resolve, reject });
+            const msg = { jsonrpc: '2.0', id, method, params };
+            this.process.stdin.write(encodeJsonRpc(msg));
+            setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`mobile-mcp request timeout after ${timeout / 1000}s: ${method}`));
+                }
+            }, timeout);
+        });
+    }
+    sendNotification(method, params) {
+        if (!this.process?.stdin?.writable)
+            return;
+        const msg = { jsonrpc: '2.0', method, params };
+        this.process.stdin.write(encodeJsonRpc(msg));
+    }
+    /** Call a tool on the mobile-mcp server */
+    async callTool(toolName, args) {
+        if (!this.isConnected) {
+            throw new Error('Not connected to mobile-mcp. Call mobile_connect first.');
+        }
+        const result = await this.sendRequest('tools/call', {
+            name: toolName,
+            arguments: args,
+        }, 60_000);
+        return result;
+    }
+    /** Extract text content from an MCP tool result */
+    extractText(result) {
+        const r = result;
+        if (r?.content) {
+            return r.content
+                .filter(c => c.type === 'text' && c.text)
+                .map(c => c.text)
+                .join('\n');
+        }
+        return JSON.stringify(result, null, 2);
+    }
+    /** Extract image content (base64) from an MCP tool result */
+    extractImage(result) {
+        const r = result;
+        if (r?.content) {
+            const img = r.content.find(c => c.type === 'image' && c.data);
+            if (img)
+                return { data: img.data, mimeType: img.mimeType || 'image/png' };
+        }
+        return null;
+    }
+    // ── High-level device operations ───────────────────────────────────
+    /** List all available devices */
+    async listDevices() {
+        const result = await this.callTool('mobile_list_available_devices', {});
+        const text = this.extractText(result);
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            // Try to parse from structured output
+            return [];
+        }
+    }
+    /** Set the active device for subsequent operations */
+    setActiveDevice(deviceId) {
+        this.activeDeviceId = deviceId;
+    }
+    /** Get the active device ID, throwing if none set */
+    requireDevice(deviceId) {
+        const id = deviceId || this.activeDeviceId;
+        if (!id) {
+            throw new Error('No device selected. Use mobile_connect to connect to a device, or pass a device ID.');
+        }
+        return id;
+    }
+    /** List apps on the active device */
+    async listApps(deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_list_apps', { device });
+        return this.extractText(result);
+    }
+    /** Launch an app by bundle ID */
+    async launchApp(packageName, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_launch_app', { device, packageName });
+        return this.extractText(result);
+    }
+    /** Take a screenshot, returns base64 image data */
+    async takeScreenshot(deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_take_screenshot', { device });
+        const img = this.extractImage(result);
+        if (img)
+            return img;
+        return this.extractText(result);
+    }
+    /** Save screenshot to a file */
+    async saveScreenshot(saveTo, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_save_screenshot', { device, saveTo });
+        return this.extractText(result);
+    }
+    /** List UI elements on screen via accessibility tree */
+    async listElements(deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_list_elements_on_screen', { device });
+        return this.extractText(result);
+    }
+    /** Tap at coordinates */
+    async tap(x, y, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_click_on_screen_at_coordinates', { device, x, y });
+        return this.extractText(result);
+    }
+    /** Swipe on screen */
+    async swipe(direction, opts) {
+        const device = this.requireDevice(opts?.deviceId);
+        const args = { device, direction };
+        if (opts?.x !== undefined)
+            args.x = opts.x;
+        if (opts?.y !== undefined)
+            args.y = opts.y;
+        if (opts?.distance !== undefined)
+            args.distance = opts.distance;
+        const result = await this.callTool('mobile_swipe_on_screen', args);
+        return this.extractText(result);
+    }
+    /** Type text */
+    async typeText(text, submit = false, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_type_keys', { device, text, submit });
+        return this.extractText(result);
+    }
+    /** Press a device button */
+    async pressButton(button, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_press_button', { device, button });
+        return this.extractText(result);
+    }
+    /** Get screen size */
+    async getScreenSize(deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_get_screen_size', { device });
+        return this.extractText(result);
+    }
+    /** Open a URL in the device browser */
+    async openUrl(url, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_open_url', { device, url });
+        return this.extractText(result);
+    }
+    /** Get device orientation */
+    async getOrientation(deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_get_orientation', { device });
+        return this.extractText(result);
+    }
+    /** Terminate an app */
+    async terminateApp(packageName, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_terminate_app', { device, packageName });
+        return this.extractText(result);
+    }
+    /** Double tap at coordinates */
+    async doubleTap(x, y, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const result = await this.callTool('mobile_double_tap_on_screen', { device, x, y });
+        return this.extractText(result);
+    }
+    /** Long press at coordinates */
+    async longPress(x, y, duration, deviceId) {
+        const device = this.requireDevice(deviceId);
+        const args = { device, x, y };
+        if (duration !== undefined)
+            args.duration = duration;
+        const result = await this.callTool('mobile_long_press_on_screen_at_coordinates', args);
+        return this.extractText(result);
+    }
+}
+//# sourceMappingURL=mobile-mcp-client.js.map

package/dist/serve.d.ts

@@ -2,6 +2,9 @@ interface ServeOptions {
     port: number;
     token?: string;
     computerUse?: boolean;
+    https?: boolean;
+    cert?: string;
+    key?: string;
 }
 export declare function startServe(options: ServeOptions): Promise<void>;
 export {};

package/dist/serve.js

@@ -1,9 +1,11 @@
-// kbot Serve — HTTP server that exposes all tools over REST
+// kbot Serve — HTTP/HTTPS server that exposes all tools over REST
 //
 // Usage:
 //   kbot serve                    # Start on default port 7437
 //   kbot serve --port 3000        # Custom port
 //   kbot serve --token mysecret   # Require auth token
+//   kbot serve --https            # HTTPS with auto-generated self-signed cert
+//   kbot serve --cert x.pem --key x.key  # HTTPS with custom cert
 //
 // Endpoints:
 //   GET  /health          — Health check
@@ -13,6 +15,7 @@
 //   POST /stream          — SSE streaming agent execution
 //   GET  /metrics         — Tool execution metrics
 import { createServer } from 'node:http';
+import { createServer as createHttpsServer } from 'node:https';
 import { createRequire } from 'node:module';
 import { registerAllTools, getAllTools, executeTool, getToolDefinitionsForApi, getToolMetrics } from './tools/index.js';
 import { extractMcpAppFromText, renderMcpApp, listAppCapableTools } from './mcp-apps.js';
@@ -22,6 +25,10 @@ import { runAgent } from './agent.js';
 import { destroySession } from './memory.js';
 import { randomUUID } from 'node:crypto';
 import { mountA2ARoutes } from './a2a.js';
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 const __require = createRequire(import.meta.url);
 const VERSION = __require('../package.json').version;
 function cors(res) {
@@ -42,13 +49,42 @@ function readBody(req) {
         req.on('error', reject);
     });
 }
+/** Generate or load a self-signed TLS certificate for localhost */
+function ensureSelfSignedCert() {
+    const certDir = join(homedir(), '.kbot', 'certs');
+    const certPath = join(certDir, 'localhost.crt');
+    const keyPath = join(certDir, 'localhost.key');
+    if (existsSync(certPath) && existsSync(keyPath)) {
+        return { cert: readFileSync(certPath, 'utf-8'), key: readFileSync(keyPath, 'utf-8') };
+    }
+    mkdirSync(certDir, { recursive: true });
+    printInfo('Generating self-signed TLS certificate for localhost...');
+    execSync(`openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 ` +
+        `-nodes -days 365 -subj "/CN=localhost" ` +
+        `-addext "subjectAltName=DNS:localhost,IP:127.0.0.1" ` +
+        `-keyout "${keyPath}" -out "${certPath}"`, { stdio: 'pipe' });
+    printSuccess('Certificate generated at ~/.kbot/certs/');
+    return { cert: readFileSync(certPath, 'utf-8'), key: readFileSync(keyPath, 'utf-8') };
+}
 export async function startServe(options) {
     // Register all tools before starting
     printInfo('Registering tools...');
     await registerAllTools({ computerUse: options.computerUse });
     const tools = getAllTools();
     printSuccess(`${tools.length} tools registered`);
-    const server = createServer(async (req, res) => {
+    // Determine TLS config
+    const useTls = !!(options.https || options.cert || options.key);
+    let tlsOpts;
+    if (useTls) {
+        if (options.cert && options.key) {
+            tlsOpts = { cert: readFileSync(options.cert, 'utf-8'), key: readFileSync(options.key, 'utf-8') };
+        }
+        else {
+            tlsOpts = ensureSelfSignedCert();
+        }
+    }
+    const protocol = useTls ? 'https' : 'http';
+    const handler = async (req, res) => {
         // CORS preflight
         if (req.method === 'OPTIONS') {
             cors(res);
@@ -66,7 +102,7 @@ export async function startServe(options) {
                 return;
             }
         }
-        const url = new URL(req.url || '/', `http://localhost:${options.port}`);
+        const url = new URL(req.url || '/', `${protocol}://localhost:${options.port}`);
         const path = url.pathname;
         try {
             // GET /health
@@ -218,15 +254,23 @@ export async function startServe(options) {
         catch (err) {
             json(res, 500, { error: err instanceof Error ? err.message : 'Internal error' });
         }
-    });
+    };
+    const server = useTls
+        ? createHttpsServer(tlsOpts, handler)
+        : createServer(handler);
     // Mount A2A protocol routes (Agent Card + task endpoints)
+    // Cast needed: https.Server and http.Server share the same request event API
     mountA2ARoutes(server, {
         port: options.port,
-        endpointUrl: `http://localhost:${options.port}`,
+        endpointUrl: `${protocol}://localhost:${options.port}`,
         token: options.token,
     });
+    const baseUrl = `${protocol}://localhost:${options.port}`;
     server.listen(options.port, () => {
-        printSuccess(`kbot serve running on http://localhost:${options.port}`);
+        printSuccess(`kbot serve running on ${baseUrl}`);
+        if (useTls) {
+            printInfo('  TLS: self-signed cert (browsers will warn — safe for local connectors)');
+        }
         printInfo(`  GET  /health                — Health check`);
         printInfo(`  GET  /tools                 — List ${tools.length} tools`);
         printInfo(`  POST /execute               — Execute a tool`);
@@ -243,7 +287,7 @@ export async function startServe(options) {
         }
         printInfo('');
         printInfo('Connect from kernel.chat:');
-        printInfo(`  connectKbot('http://localhost:${options.port}')`);
+        printInfo(`  connectKbot('${baseUrl}')`);
     });
     // Graceful shutdown
     const shutdown = () => {

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/dist/tools/index.js

@@ -311,6 +311,8 @@ const LAZY_MODULE_IMPORTS = [
     { path: './financial-analysis.js', registerFn: 'registerFinancialAnalysisTools' },
     { path: './ai-analysis.js', registerFn: 'registerAIAnalysisTools' },
     { path: './music-gen.js', registerFn: 'registerMusicGenTools' },
+    { path: './mobile-automation.js', registerFn: 'registerMobileAutomationTools' },
+    { path: './iphone.js', registerFn: 'registerIPhoneTools' },
 ];
 /** Track whether lazy tools have been registered */
 let lazyToolsRegistered = false;

package/dist/tools/iphone.d.ts

@@ -0,0 +1,2 @@
+export declare function registerIPhoneTools(): void;
+//# sourceMappingURL=iphone.d.ts.map