kimaki 0.31.0 → 1.0.0

package/dist/btw.e2e.test.js

@@ -0,0 +1,102 @@
+// `. btw` and /btw fork the session into a new "btw:" thread that answers a
+// side question while the source session keeps running.
+import fs from 'node:fs';
+import { afterAll, beforeAll, expect, test } from 'vitest';
+import { TEST_USER_ID, seedProjectChannel, slowTextMatcher, startOpencodeTestServer, startTestBot, startTwin, tempDataDir, textParts, waitForBotMessageContaining, waitForFooter, warmUp, } from "./test/harness.js";
+const matchers = [
+    slowTextMatcher({ marker: 'slow-marker', text: 'slow-done', delayMs: 2_000 }),
+    { id: 'side', priority: 50, when: { latestUserTextIncludes: 'side-marker' }, then: { parts: textParts('side answer') } },
+    { id: 'slash', priority: 50, when: { latestUserTextIncludes: 'slash-marker' }, then: { parts: textParts('slash answer') } },
+];
+let server;
+let twin;
+let bot;
+let dataDir;
+beforeAll(async () => {
+    dataDir = tempDataDir();
+    [server, twin] = await Promise.all([startOpencodeTestServer({ matchers }), startTwin()]);
+    await seedProjectChannel({
+        dataDir,
+        channelId: twin.channelId,
+        guildId: twin.discord.guildId,
+        directory: server.projectDirectory,
+    });
+    await warmUp({ server });
+    bot = await startTestBot({ dataDir, twin, server });
+});
+afterAll(async () => {
+    await bot?.stop();
+    await twin?.stop();
+    await server?.stop();
+    fs.rmSync(dataDir, { recursive: true, force: true });
+});
+function hideIds(text) {
+    return text.replace(/<#\d+>/g, '<#THREAD>').replace(/ses_\w+/g, 'ses_ID');
+}
+async function waitForBtwThread(existing) {
+    return twin.discord.channel(twin.channelId).waitForThread({
+        timeout: 8_000,
+        predicate: (thread) => !existing.has(thread.id) && (thread.name?.startsWith('btw:') ?? false),
+    });
+}
+test('. btw forks into a side thread while the source run continues', async () => {
+    const { discord, channelId } = twin;
+    await discord.channel(channelId).user(TEST_USER_ID).sendMessage({ content: 'Long task slow-marker' });
+    const source = await discord.channel(channelId).waitForThread({ timeout: 8_000 });
+    await waitForBotMessageContaining({ discord, threadId: source.id, text: '*using ' });
+    const existing = new Set((await discord.channel(channelId).getThreads()).map((thread) => thread.id));
+    await discord.thread(source.id).user(TEST_USER_ID).sendMessage({ content: 'What is 2+2 side-marker. btw' });
+    const fork = await waitForBtwThread(existing);
+    await waitForFooter({ discord, threadId: fork.id });
+    await waitForFooter({ discord, threadId: source.id });
+    expect(fork.name).toBe('btw: What is 2+2 side-marker');
+    expect(hideIds(await discord.thread(source.id).text())).toMatchInlineSnapshot(`
+    "--- from: user (tommy)
+    Long task slow-marker
+    --- from: assistant (TestBot)
+    -# *using deterministic-provider/deterministic-v2 ⋅ build*
+    --- from: user (tommy)
+    What is 2+2 side-marker. btw
+    --- from: assistant (TestBot)
+    Session forked! Continue in <#THREAD>
+    slow-done
+    -# *project ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2*"
+  `);
+    expect(hideIds(await discord.thread(fork.id).text())).toMatchInlineSnapshot(`
+    "--- from: assistant (TestBot)
+    Reusing context from <#THREAD> to answer prompt...
+    What is 2+2 side-marker
+    side answer
+    -# *project ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2*"
+  `);
+    const rows = await bot.db.query.thread_sessions.findMany({ where: { thread_id: fork.id } });
+    expect(rows.length).toBe(1);
+    // The plugin only exports KIMAKI_TOOL_CALL to shells when the marker has the CLI context,
+    // so `kimaki buttons` failed on the first turn of every fork.
+    const info = await (await server.client()).session.get({ sessionID: rows[0].session_id });
+    expect(info.metadata?.['kimaki']).toMatchObject({ threadId: fork.id, dataDir, lockPort: expect.any(Number) });
+});
+test('/btw forks from a thread with an idle session', async () => {
+    const { discord, channelId } = twin;
+    await discord.channel(channelId).user(TEST_USER_ID).sendMessage({ content: 'Short task' });
+    const source = await discord.channel(channelId).waitForThread({
+        timeout: 8_000,
+        predicate: (thread) => thread.name === 'Short task',
+    });
+    await waitForFooter({ discord, threadId: source.id });
+    const existing = new Set((await discord.channel(channelId).getThreads()).map((thread) => thread.id));
+    await discord.thread(source.id).user(TEST_USER_ID).runSlashCommand({
+        name: 'btw',
+        options: [{ name: 'prompt', type: 3, value: 'Side slash-marker' }],
+    });
+    const fork = await waitForBtwThread(existing);
+    await waitForFooter({ discord, threadId: fork.id });
+    expect(hideIds(await discord.thread(fork.id).text())).toMatchInlineSnapshot(`
+    "--- from: assistant (TestBot)
+    Reusing context from <#THREAD> to answer prompt...
+    Side slash-marker
+    slash answer
+    -# *project ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2*"
+  `);
+});
+//# sourceMappingURL=btw.e2e.test.js.map

package/dist/btw.e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"btw.e2e.test.js","sourceRoot":"","sources":["../src/btw.e2e.test.ts"],"names":[],"mappings":"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"}

package/dist/catalog-refresh.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/catalog-refresh.e2e.test.js

@@ -0,0 +1,90 @@
+// OpenCode loads agents lazily: user agents missing at startup get their
+// /<agent>-agent command when agent.updated arrives.
+import fs from 'node:fs';
+import path from 'node:path';
+import { Routes } from 'discord.js';
+import { afterAll, beforeAll, expect, test } from 'vitest';
+import { TEST_USER_ID, seedProjectChannel, startOpencodeTestServer, startTestBot, startTwin, tempDataDir, textParts, waitForFooter, } from "./test/harness.js";
+const matchers = [
+    { id: 'late', priority: 500, when: { latestUserTextIncludes: 'late-marker' }, then: { parts: textParts('late reply') } },
+];
+let server;
+let twin;
+let bot;
+let dataDir;
+beforeAll(async () => {
+    dataDir = tempDataDir();
+    [server, twin] = await Promise.all([startOpencodeTestServer({ matchers, agents: { late: { description: 'Late agent', mode: 'primary' } } }), startTwin()]);
+    await seedProjectChannel({ dataDir, channelId: twin.channelId, guildId: twin.discord.guildId, directory: server.projectDirectory });
+    bot = await startTestBot({ dataDir, twin, server });
+});
+afterAll(async () => {
+    await bot?.stop();
+    await twin?.stop();
+    await server?.stop();
+    fs.rmSync(dataDir, { recursive: true, force: true });
+});
+async function registeredNames() {
+    const commands = await twin.discord.getRegisteredCommands();
+    return commands.map((command) => command.name);
+}
+test('agents loaded after startup get their slash commands', async () => {
+    // A cold OpenCode has no user agents when the bot first registers commands;
+    // agent.updated fires when the catalog finishes loading; the refresh follows it.
+    const deadline = Date.now() + 8_000;
+    while (Date.now() < deadline && !(await registeredNames()).includes('late-agent')) {
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    expect(await registeredNames()).toContain('late-agent');
+    const { discord, channelId } = twin;
+    const before = new Set((await discord.channel(channelId).getThreads()).map((thread) => thread.id));
+    await discord
+        .channel(channelId)
+        .user(TEST_USER_ID)
+        .runSlashCommand({ name: 'late-agent', options: [{ name: 'prompt', type: 3, value: 'Go late-marker' }] });
+    const thread = await discord.channel(channelId).waitForThread({ timeout: 8_000, predicate: (found) => !before.has(found.id) });
+    await waitForFooter({ discord, threadId: thread.id });
+    expect(await discord.thread(thread.id).text()).toMatchInlineSnapshot(`
+    "--- from: assistant (TestBot)
+    » **tommy:** Go late-marker
+    -# *using deterministic-provider/deterministic-v2 ⋅ late*
+    late reply
+    -# *project ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2 ⋅ late*"
+  `);
+});
+test('a skill change adds its command; catalog events with the same catalog write nothing to Discord', async () => {
+    const skillFile = path.join(server.skillsDirectory, 'demo', 'SKILL.md');
+    const skillText = '---\nname: demo\ndescription: Demo skill\n---\nDemo.\n';
+    const nextCatalogEvent = () => new Promise((resolve) => {
+        const stop = bot.opencode.subscribe((event) => {
+            if (event.type !== 'skill.updated')
+                return;
+            stop();
+            resolve();
+        });
+    });
+    const waitForCommand = async () => {
+        const deadline = Date.now() + 8_000;
+        while (Date.now() < deadline && !(await registeredNames()).includes('demo-skill')) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+    };
+    fs.mkdirSync(path.dirname(skillFile), { recursive: true });
+    fs.writeFileSync(skillFile, skillText);
+    await waitForCommand();
+    expect(await registeredNames()).toContain('demo-skill');
+    // Same file content again: OpenCode rescans and publishes skill.updated, the commands stay the same.
+    const bulkWrites = [];
+    const commandsRoute = Routes.applicationGuildCommands(bot.discord.user.id, twin.discord.guildId);
+    bot.discord.rest.on('response', (request) => {
+        if (request.method === 'PUT' && request.path === commandsRoute)
+            bulkWrites.push(request.path);
+    });
+    const event = nextCatalogEvent();
+    fs.writeFileSync(skillFile, skillText);
+    await event;
+    // Let the pass that the event started finish.
+    await new Promise((resolve) => setTimeout(resolve, 300));
+    expect(bulkWrites).toEqual([]);
+});
+//# sourceMappingURL=catalog-refresh.e2e.test.js.map

package/dist/catalog-refresh.e2e.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-refresh.e2e.test.js","sourceRoot":"","sources":["../src/catalog-refresh.e2e.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/bot.d.ts

@@ -0,0 +1,5 @@
+import type { Goke } from 'goke';
+export declare function registerStartCommand(cli: Goke): void;
+export declare function registerLoginCommands(cli: Goke): void;
+export declare function registerToolCommands(cli: Goke): void;
+export declare function registerBotCommands(cli: Goke): void;

package/dist/cli/bot.js

@@ -0,0 +1,427 @@
+// Bot lifecycle and setup: the root command (start + onboarding), provider
+// login, tools (tunnel, tts), and bot status, logs, credentials and keys.
+// main.ts, onboarding.ts, traforo, SQLite and voice are loaded only by the
+// commands that run them (see the note in shared.ts).
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
+import dedent from 'string-dedent';
+import { distCliEntry, writeAutostartScript } from "../autostart.js";
+import { callBot, DEFAULT_LOCK_PORT, RESTART_EXIT_CODE, startLockServer } from "../lock-server.js";
+import { parseDuration } from "../duration.js";
+import { createLogger, setLogFile } from "../logger.js";
+import { action, DATA_DIR_HELP, dataDirOrDefault, discordApi, fail, openCliDb, printJson } from "./shared.js";
+const logger = createLogger('CLI');
+// null when the file vanished meanwhile (bot restart).
+async function readRange({ file, start, end }) {
+    const handle = await fs.promises.open(file, 'r').catch(() => null);
+    if (!handle)
+        return null;
+    const buffer = Buffer.alloc(end - start);
+    const read = await handle.read(buffer, 0, buffer.length, start).catch(() => null);
+    await handle.close().catch(() => undefined);
+    return read ? buffer.subarray(0, read.bytesRead) : null;
+}
+// tail -f that survives the bot truncating the file on restart.
+async function followFile(file) {
+    const position = { offset: 0 };
+    while (true) {
+        const size = await fs.promises.stat(file).then((stat) => stat.size).catch(() => 0);
+        if (size < position.offset)
+            position.offset = 0;
+        if (size > position.offset) {
+            const chunk = await readRange({ file, start: position.offset, end: size });
+            if (chunk)
+                process.stdout.write(chunk);
+            position.offset = size;
+        }
+        await sleep(300);
+    }
+}
+// The root command runs the bot in a child process and starts it again when it
+// exits with RESTART_EXIT_CODE (`kimaki restart`), so a restart loads new code:
+//
+//   kimaki (supervisor) ──spawn, same argv, KIMAKI_SUPERVISED=1──▶ bot
+//        ▲                                                         │
+//        └──────────── exit 75: spawn again; other code: exit ─────┘
+//
+// The child shares the terminal (stdio inherit), so onboarding prompts work.
+// The IPC channel only exists so the child sees `disconnect` if the supervisor dies.
+async function supervise() {
+    const state = { child: null };
+    // Ctrl+C reaches both processes; `kill <supervisor pid>` reaches only this one.
+    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+        process.on(signal, () => state.child?.kill('SIGTERM'));
+    }
+    while (true) {
+        const child = spawn(process.execPath, [...process.execArgv, ...process.argv.slice(1)], {
+            stdio: ['inherit', 'inherit', 'inherit', 'ipc'],
+            env: { ...process.env, KIMAKI_SUPERVISED: '1' },
+        });
+        state.child = child;
+        const code = await new Promise((resolve) => {
+            child.once('error', (error) => {
+                process.stderr.write(`Cannot start the kimaki bot process: ${error.message}\n`);
+                resolve(1);
+            });
+            child.once('exit', (exitCode, signal) => resolve(exitCode ?? (signal ? 1 : 0)));
+        });
+        if (code !== RESTART_EXIT_CODE)
+            process.exit(code);
+        process.stderr.write('Restarting kimaki...\n');
+    }
+}
+// `kimaki` with no subcommand.
+export function registerStartCommand(cli) {
+    cli.command('', 'Start the bot. Runs onboarding on first start')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('-g, --guild <guildId>', 'Server to onboard when the bot is in several')
+        .option('--gateway', 'Use the shared Kimaki bot, no Discord app needed')
+        .option('--gateway-callback-url <url>', 'Redirect here after the gateway install (appends ?guild_id=<id>)')
+        .option('--install-url', 'Print the install URL and exit (non-interactive onboarding)')
+        .option('--machine-name <name>', 'Name in this machine\'s category "Kimaki <name>" (default: hostname)')
+        .option('--restart-onboarding', 'Choose credentials again')
+        .option('--worktrees', 'Use a fresh Git worktree for new sessions unless the channel overrides it')
+        .option('--voice <name>', 'Voice of voice calls, saved for later starts (e.g. cove, juniper, sol). "default" resets it')
+        .option('--no-analytics', 'Disable anonymous usage analytics (same as KIMAKI_STRADA_ENABLED=0)')
+        .option('--if-not-running', 'Start only if no bot runs; never stop the running one (used by autostart)')
+        .action(async (options) => {
+        // The IPC check ignores a KIMAKI_SUPERVISED leaked into a shell by an older bot.
+        if (process.env['KIMAKI_SUPERVISED'] !== '1' || !process.connected)
+            return supervise();
+        // OpenCode and agent shells inherit process.env: a bot started from a
+        // session (tests) would otherwise think it is supervised and SIGTERM itself on restart.
+        delete process.env['KIMAKI_SUPERVISED'];
+        // Bot code loads only here: the other subcommands start without it.
+        const [{ startBot }, { ensureOpencode, kimakiShellCommand, runOnboarding, startCaffeinate }, { emitEvent, gatewayCredentials, gatewayUrlsFromEnv, installUrlFor, readSavedCredentials, resolveCredentials, restApiUrl }, { openDb }, { createAnalytics }, { opencodeConfigDir, opencodeDbFile }, { defaultMachineName }, { ensureVoiceChannels, parseRealtimeVoice, saveVoiceCallVoice },] = await Promise.all([
+            import("../main.js"),
+            import("../onboarding.js"),
+            import("../credentials.js"),
+            import("../db.js"),
+            import("../analytics.js"),
+            import("../opencode-server.js"),
+            import("../project.js"),
+            import("../voice-call.js"),
+        ]);
+        // Non-TTY hosts get the failure as an `error` event too (programmatic onboarding).
+        // Explicit type: TS narrows after a `never` call only for annotated consts.
+        const failStartup = (error, installUrl) => {
+            if (!process.stdin.isTTY)
+                emitEvent({ type: 'error', message: error.message, ...(installUrl && { install_url: installUrl }) });
+            fail(error);
+        };
+        const dataDir = dataDirOrDefault(options.dataDir);
+        const urls = gatewayUrlsFromEnv();
+        const machine = options.machineName ?? defaultMachineName();
+        // Validated before the lock, so a typo never stops the running bot. null: reset to the default.
+        const voice = (() => {
+            if (!options.voice)
+                return undefined;
+            if (options.voice.trim().toLowerCase() === 'default')
+                return null;
+            const parsed = parseRealtimeVoice(options.voice);
+            if (parsed instanceof Error)
+                fail(parsed);
+            return parsed.voice;
+        })();
+        if (options.installUrl) {
+            const opened = await openDb({ dataDir, migrate: true });
+            if (opened instanceof Error)
+                fail(opened);
+            const credentials = options.gateway
+                ? await gatewayCredentials({ db: opened.db, urls })
+                : await readSavedCredentials({ db: opened.db });
+            opened.close();
+            if (credentials instanceof Error)
+                fail(credentials);
+            if (!credentials)
+                fail(new Error('No bot configured yet. Run kimaki first, or pass --gateway.'));
+            process.stdout.write(`${installUrlFor({ credentials, website: urls.website, callbackUrl: options.gatewayCallbackUrl })}\n`);
+            if (credentials.mode === 'gateway')
+                process.stderr.write('This URL contains your client credentials. Do not share it.\n');
+            return;
+        }
+        // Stops a running bot of this port (V1 or V2) before the migration and
+        // onboarding, which must not run while it still writes. Before the log
+        // reset, so the stopped bot (or the one --if-not-running leaves running) keeps its kimaki.log.
+        const lock = await startLockServer({ port: Number(process.env['KIMAKI_LOCK_PORT'] || DEFAULT_LOCK_PORT), dataDir, supervised: true, evict: !options.ifNotRunning });
+        if (lock instanceof Error) {
+            // Another bot won the race after the plugin's health check.
+            if (options.ifNotRunning && lock.cause instanceof Error && Reflect.get(lock.cause, 'code') === 'EADDRINUSE') {
+                process.stderr.write(`Kimaki already runs on port ${lock.port}. Nothing to start.\n`);
+                process.exit(0);
+            }
+            failStartup(lock);
+        }
+        const logFile = setLogFile({ dataDir });
+        if (logFile instanceof Error)
+            failStartup(logFile);
+        // A crash goes to kimaki.log too (Node still prints it and exits).
+        process.on('uncaughtExceptionMonitor', (error, origin) => logger.error(`crash (${origin})`, error));
+        const opened = await openDb({ dataDir, migrate: true });
+        if (opened instanceof Error)
+            failStartup(opened);
+        // Before onboarding: without OpenCode the bot cannot start, so fail (or install it) before the Discord install.
+        const opencodeCheck = await ensureOpencode({ serviceFile: process.env['KIMAKI_OPENCODE_SERVICE_FILE'] });
+        if (opencodeCheck instanceof Error) {
+            opened.close();
+            failStartup(opencodeCheck);
+        }
+        startCaffeinate();
+        const resolved = await resolveCredentials({
+            db: opened.db,
+            gateway: Boolean(options.gateway),
+            restartOnboarding: Boolean(options.restartOnboarding),
+            urls,
+            callbackUrl: options.gatewayCallbackUrl,
+        });
+        // Saved in SQLite, so restarts, crashes and autostart keep it without the flag.
+        const savedVoice = resolved instanceof Error || voice === undefined ? undefined : await saveVoiceCallVoice({ db: opened.db, appId: resolved.credentials.appId, voice });
+        opened.close();
+        if (resolved instanceof Error)
+            failStartup(resolved);
+        if (savedVoice instanceof Error)
+            failStartup(savedVoice);
+        if (voice !== undefined)
+            logger.log(`voice calls use ${voice === null ? 'the default voice' : `the voice ${voice}`}`);
+        const { credentials, install } = resolved;
+        const installUrl = installUrlFor({ credentials, website: urls.website, callbackUrl: options.gatewayCallbackUrl });
+        // The agent calls this same install. Prefer the built dist entry, so agent
+        // commands skip the tsx loader also when the bot runs from src.
+        const distCli = distCliEntry();
+        const kimaki = kimakiShellCommand({
+            command: fs.existsSync(distCli)
+                ? [process.execPath, distCli]
+                : [process.execPath, ...process.execArgv, process.argv[1] ?? 'kimaki'],
+        });
+        const bot = await startBot({
+            kimakiCommand: kimaki,
+            dataDir,
+            token: credentials.token,
+            appId: credentials.appId,
+            discordRestUrl: restApiUrl(credentials),
+            lock,
+            opencodeServiceFile: process.env['KIMAKI_OPENCODE_SERVICE_FILE'],
+            ensureOpencode: true,
+            opencodeConfigDir: opencodeConfigDir(),
+            opencodeDbFile: opencodeDbFile(),
+            analytics: createAnalytics({ dataDir, botMode: credentials.mode, enabled: !options.noAnalytics }),
+            autoWorktrees: Boolean(options.worktrees),
+        });
+        if (bot instanceof Error)
+            failStartup(bot);
+        // exit() keeps process.exitCode: the restart route sets RESTART_EXIT_CODE before its SIGTERM.
+        const shutdown = () => {
+            void bot.stop().then(() => process.exit());
+        };
+        process.once('SIGTERM', shutdown);
+        process.once('SIGINT', shutdown);
+        // The supervisor died (SIGKILL, crash): nobody owns this bot anymore.
+        process.once('disconnect', shutdown);
+        const gateway = credentials.mode === 'gateway';
+        const onboarded = await runOnboarding({ bot, dataDir, guildId: options.guild ?? install?.guildId, installUrl, kimaki, gateway, installerId: install?.installerId, machine });
+        // The bot keeps running; the next start retries onboarding.
+        if (onboarded instanceof Error) {
+            logger.error(`onboarding failed`, onboarded);
+            if (!process.stdin.isTTY)
+                emitEvent({ type: 'error', message: `Onboarding failed: ${onboarded.message}. The bot is running; restart kimaki to retry.` });
+            return;
+        }
+        if (onboarded)
+            process.stderr.write(`Onboarding thread: https://discord.com/channels/${onboarded.guildId}/${onboarded.threadId}\n`);
+        const voiceChannels = await ensureVoiceChannels(bot, { machine });
+        if (voiceChannels instanceof Error)
+            logger.warn('cannot create the Kimaki voice channel', voiceChannels);
+        // Only the default port: the plugin checks that one. Runtime flags only;
+        // credentials, onboarding and --voice are saved in SQLite.
+        if (lock.port === DEFAULT_LOCK_PORT) {
+            const autostart = await writeAutostartScript({ dataDir, args: [
+                    ...(options.worktrees ? ['--worktrees'] : []),
+                    ...(options.noAnalytics ? ['--no-analytics'] : []),
+                    ...(options.machineName ? ['--machine-name', options.machineName] : []),
+                ] });
+            if (autostart instanceof Error)
+                logger.warn('cannot write the autostart script', autostart);
+        }
+        if (!process.stdin.isTTY)
+            emitEvent({ type: 'ready', app_id: credentials.appId, guild_ids: [...bot.discord.guilds.cache.keys()] });
+    });
+}
+// login, login credential: OpenCode provider credentials through the bot.
+export function registerLoginCommands(cli) {
+    cli.command('login <provider>', 'Connect a provider using OpenCode integration credentials')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('--key <key>', 'API key to store in OpenCode')
+        .option('--method <id>', 'OAuth method ID; without flags, list login methods')
+        .option('--attempt <id>', 'Check or complete this native OAuth attempt')
+        .option('--code <code>', 'Authorization code for the attempt')
+        .option('--cancel', 'Cancel the native OAuth attempt')
+        .action(async (provider, options) => {
+        await action({ route: 'login', dataDir: options.dataDir, input: {
+                provider, key: options.key, method: options.method, attempt: options.attempt, code: options.code, ...(options.cancel && { operation: 'cancel' }),
+            } });
+    });
+    cli.command('login credential <id>', 'Activate, remove, or label an OpenCode credential')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('--operation <name>', 'activate | remove | label')
+        .option('--label <text>', 'Credential label')
+        .action(async (id, options) => {
+        await action({ route: 'credential', dataDir: options.dataDir, input: { id, operation: options.operation ?? 'activate', label: options.label } });
+    });
+}
+// tunnel, tts
+export function registerToolCommands(cli) {
+    cli.command('tunnel', 'Run a command and expose its local port with a public URL. The child gets TRAFORO_URL')
+        .option('-p, --port <port>', 'Local port (default: read from the command output)')
+        .option('-t, --tunnel-id <id>', 'Fixed tunnel ID (default: random). Only for public-safe services')
+        .option('--host <host>', 'Local host (default: localhost)')
+        .option('-k, --kill', 'Kill the process on --port first')
+        .example('kimaki tunnel -- pnpm dev')
+        .action(async (options) => {
+        const command = options['--'] ?? [];
+        const port = options.port ? Number(options.port) : undefined;
+        if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65_535))
+            fail(new Error(`Invalid --port ${options.port}`));
+        if (!port && command.length === 0)
+            fail(new Error('Pass a command after --, or --port <port>. Example: kimaki tunnel -- pnpm dev'));
+        const { runTunnel } = await import('traforo/run-tunnel');
+        await runTunnel({ port, command: command.length > 0 ? command : undefined, tunnelId: options.tunnelId, localHost: options.host, baseDomain: 'kimaki.dev', kill: options.kill });
+    });
+    cli.command('tts [text]', 'Text to speech with OpenAI or Gemini. Reads stdin if no text is given')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('-o, --output <path>', 'Output file (default: speech.mp3 or speech.wav)')
+        .option('-p, --provider <name>', 'openai | gemini (default: from the stored key)')
+        .option('-v, --voice <voice>', 'Voice ID (default: alloy for OpenAI, Kore for Gemini)')
+        .option('-i, --instructions <text>', 'Style instructions (OpenAI only)')
+        .option('--speed <n>', '0.25 to 4.0 (OpenAI only, default: 1.25)')
+        .action(async (text, options) => {
+        const chunks = [];
+        if (!text && !process.stdin.isTTY)
+            for await (const chunk of process.stdin)
+                chunks.push(Buffer.from(chunk));
+        const input = text ?? Buffer.concat(chunks).toString('utf8').trim();
+        if (!input)
+            fail(new Error('Pass the text as an argument or pipe it via stdin'));
+        if (options.provider && options.provider !== 'openai' && options.provider !== 'gemini')
+            fail(new Error('--provider must be openai or gemini'));
+        const speed = options.speed ? Number(options.speed) : 1.25;
+        if (!(speed >= 0.25 && speed <= 4))
+            fail(new Error('--speed must be between 0.25 and 4'));
+        const [{ openDb }, { audioKeyCandidates, generateSpeech }] = await Promise.all([import("../db.js"), import("../voice.js")]);
+        // Any stored bot_api_keys row (imported from V1 /transcription-key); a missing database only skips it.
+        const opened = await openDb({ dataDir: dataDirOrDefault(options.dataDir), migrate: false });
+        const stored = opened instanceof Error ? null : await opened.db.query.bot_api_keys.findFirst().catch(() => null);
+        if (!(opened instanceof Error))
+            opened.close();
+        const key = audioKeyCandidates(stored).find((candidate) => !options.provider || candidate.provider === options.provider);
+        if (!key)
+            fail(new Error('No OpenAI or Gemini key. Set OPENAI_API_KEY or GEMINI_API_KEY'));
+        const result = await generateSpeech({ text: input, apiKey: key.apiKey, provider: key.provider, voice: options.voice, instructions: options.instructions, speed });
+        if (result instanceof Error)
+            fail(result);
+        const output = path.resolve(options.output ?? `speech.${result.mediaType === 'audio/mp3' ? 'mp3' : 'wav'}`);
+        await fs.promises.writeFile(output, result.audio);
+        process.stdout.write(`${output}\n`);
+    });
+}
+// status, logs, bot token / keys set / install-url
+export function registerBotCommands(cli) {
+    cli.command('status', 'Bot health: running, pid, uptime, OpenCode URL and version, guilds')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const result = await callBot({ dataDir: dataDirOrDefault(options.dataDir), route: 'status', input: {} });
+        if (result instanceof Error) {
+            process.stdout.write(options.json ? `${JSON.stringify({ running: false, reason: result.message })}\n` : `not running: ${result.message}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const status = { running: true, ...result.data };
+        if (options.json)
+            return printJson(status);
+        process.stdout.write(dedent `
+        running: pid ${status.pid}, up ${status.uptimeSec}s, mode ${JSON.stringify(status.mode)}
+        opencode: ${JSON.stringify(status.opencode)}
+        guilds: ${JSON.stringify(status.guilds)}
+        data dir: ${JSON.stringify(status.dataDir)}
+      ` + '\n');
+    });
+    cli.command('logs', 'Print the log file path. The bot resets the file on every start')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('-f, --follow', 'Print the log and keep printing new lines')
+        .action(async (options) => {
+        const file = path.join(dataDirOrDefault(options.dataDir), 'kimaki.log');
+        if (!options.follow) {
+            process.stdout.write(`${file}\n`);
+            return;
+        }
+        await followFile(file);
+    });
+    cli.command('restart', 'Restart the running bot with the code on disk. Sessions keep running in OpenCode')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .action(async (options) => {
+        const result = await callBot({ dataDir: dataDirOrDefault(options.dataDir), route: 'restart', input: {} });
+        if (result instanceof Error)
+            fail(result);
+        process.stdout.write(`Restarting bot (pid ${result.data.pid})\n`);
+    });
+    cli.command('profile cpu', 'Record a CPU profile of the running bot and print the .cpuprofile path')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('-d, --duration <duration>', 'How long to record, e.g. 20s or 2m (default: 20s)')
+        .example('kimaki profile cpu --duration 30s')
+        .action(async (options) => {
+        const durationMs = parseDuration(options.duration ?? '20s', '--duration');
+        if (durationMs instanceof Error)
+            fail(durationMs);
+        // Ctrl+C stops the recording early; the bot still writes the profile.
+        const controller = new AbortController();
+        process.once('SIGINT', () => controller.abort());
+        const signal = AbortSignal.any([controller.signal, AbortSignal.timeout(durationMs + 30_000)]);
+        process.stderr.write(`Recording for ${options.duration ?? '20s'}. Press Ctrl+C to stop early.\n`);
+        const result = await callBot({ dataDir: dataDirOrDefault(options.dataDir), route: 'profile.cpu', input: { durationMs }, signal });
+        if (result instanceof Error)
+            fail(controller.signal.aborted ? new Error('Stopped early. The bot writes the profile to <data dir>/profiles/') : result);
+        process.stdout.write(`${result.data.path}\n`);
+    });
+    cli.command('profile heap', 'Write a heap snapshot of the running bot and print the .heapsnapshot path')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .action(async (options) => {
+        const result = await callBot({ dataDir: dataDirOrDefault(options.dataDir), route: 'profile.heap', input: {}, signal: AbortSignal.timeout(300_000) });
+        if (result instanceof Error)
+            fail(result);
+        process.stdout.write(`${result.data.path}\n`);
+    });
+    cli.command('bot token', 'Print saved bot credentials for automation')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .action(async (options) => process.stdout.write(`${(await discordApi(options.dataDir)).credentials.token}\n`));
+    cli.command('bot keys set', 'Store OpenAI or Gemini API keys for voice transcription and kimaki tts')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('--openai <key>', 'OpenAI API key')
+        .option('--gemini <key>', 'Gemini API key')
+        .action(async (options) => {
+        const [{ readSavedCredentials }, { saveAudioKeys }] = await Promise.all([import("../credentials.js"), import("../voice.js")]);
+        const opened = await openCliDb(options.dataDir);
+        const result = await (async () => {
+            const credentials = await readSavedCredentials({ db: opened.db });
+            if (credentials instanceof Error)
+                return credentials;
+            if (!credentials)
+                return new Error('No saved bot credentials. Start kimaki once to onboard.');
+            return saveAudioKeys({ db: opened.db, token: credentials.token, openai: options.openai, gemini: options.gemini });
+        })();
+        opened.close();
+        if (result instanceof Error)
+            fail(result);
+        process.stdout.write(`Saved ${[options.openai && 'OpenAI', options.gemini && 'Gemini'].filter(Boolean).join(' and ')} API key\n`);
+    });
+    cli.command('bot install-url', 'Print the Discord bot install URL')
+        .option('--data-dir <path>', DATA_DIR_HELP)
+        .option('--gateway-callback-url <url>', 'Gateway only: redirect here after the install')
+        .action(async (options) => {
+        const { installUrlFor, gatewayUrlsFromEnv } = await import("../credentials.js");
+        const { credentials } = await discordApi(options.dataDir);
+        process.stdout.write(`${installUrlFor({ credentials, website: gatewayUrlsFromEnv().website, callbackUrl: options.gatewayCallbackUrl })}\n`);
+    });
+}
+//# sourceMappingURL=bot.js.map