kimaki 0.31.0 → 1.0.0

package/dist/analytics.test.js

@@ -1,159 +1,123 @@
-// Unit tests for anonymous install id and product event construction.
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import { setDataDir } from './config.js';
-import { _enableAnalyticsTestCapture, _resetAnalyticsForTests, commonAnalyticsProps, getInstallId, initAnalytics, INSTALL_ID_FILENAME, setAnalyticsBotMode, trackEvent, } from './analytics.js';
-describe('analytics', () => {
-    let tmpDir;
-    beforeEach(() => {
-        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'kimaki-analytics-'));
-        setDataDir(tmpDir);
-        _resetAnalyticsForTests();
-    });
-    afterEach(() => {
-        _resetAnalyticsForTests();
-        fs.rmSync(tmpDir, { recursive: true, force: true });
-    });
-    it('creates and reuses install-id', () => {
-        const first = getInstallId();
-        expect(first).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-        expect(fs.readFileSync(path.join(tmpDir, INSTALL_ID_FILENAME), 'utf8').trim()).toBe(first);
-        _resetAnalyticsForTests();
-        setDataDir(tmpDir);
-        expect(getInstallId()).toBe(first);
-    });
-    it('replaces invalid install-id file contents', () => {
-        fs.writeFileSync(path.join(tmpDir, INSTALL_ID_FILENAME), 'not-a-uuid\n');
-        const id = getInstallId();
-        expect(id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i);
-        expect(id).not.toBe('not-a-uuid');
-        expect(fs.readFileSync(path.join(tmpDir, INSTALL_ID_FILENAME), 'utf8').trim()).toBe(id);
-    });
-    it('no-ops trackEvent under vitest without capture', () => {
-        initAnalytics();
-        expect(() => {
-            trackEvent('bot_started', { guild_count: 1 });
-        }).not.toThrow();
-    });
-    it('KIMAKI_STRADA_ENABLED=0 keeps initAnalytics from throwing', () => {
-        const prev = process.env.KIMAKI_STRADA_ENABLED;
-        process.env.KIMAKI_STRADA_ENABLED = '0';
-        try {
-            initAnalytics();
-            expect(() => {
-                trackEvent('bot_started', { guild_count: 1 });
-            }).not.toThrow();
-        }
-        finally {
-            if (prev === undefined) {
-                delete process.env.KIMAKI_STRADA_ENABLED;
-            }
-            else {
-                process.env.KIMAKI_STRADA_ENABLED = prev;
-            }
-        }
-    });
-    it('builds common props and install_id always wins', () => {
-        setAnalyticsBotMode('gateway');
-        const captured = _enableAnalyticsTestCapture({
-            installId: '22222222-2222-4222-8222-222222222222',
-            botMode: 'gateway',
-        });
-        trackEvent('turn_started', {
-            install_id: 'should-not-win',
-            input_kind: 'prompt',
-            ingress_mode: 'direct',
-            source: 'discord',
-            uses_custom_agent: false,
-        });
-        expect(captured).toHaveLength(1);
-        expect(captured[0].name).toBe('turn_started');
-        expect(captured[0].properties).toMatchObject({
-            install_id: '22222222-2222-4222-8222-222222222222',
-            schema_version: 1,
-            bot_mode: 'gateway',
-            platform: process.platform,
-            arch: process.arch,
-            input_kind: 'prompt',
-            ingress_mode: 'direct',
-            source: 'discord',
-            uses_custom_agent: false,
-        });
-        expect(captured[0].properties.install_id).not.toBe('should-not-win');
-        const common = commonAnalyticsProps({ foo: 'bar' });
-        expect(common).toMatchObject({
-            foo: 'bar',
-            install_id: '22222222-2222-4222-8222-222222222222',
-            schema_version: 1,
-            bot_mode: 'gateway',
-        });
-    });
-    it('emits project_registered session_created turn_completed tokens_used shapes', () => {
-        const captured = _enableAnalyticsTestCapture({
-            installId: '33333333-3333-4333-8333-333333333333',
-            botMode: 'self_hosted',
-        });
-        trackEvent('project_registered', {
-            project_kind: 'user',
-            source: 'cli',
-            user_project_count: 2,
-        });
-        trackEvent('session_created', {
-            has_worktree: true,
-            source: 'discord',
-        });
-        trackEvent('turn_completed', {
-            duration_sec: 42,
-        });
-        trackEvent('tokens_used', {
-            tokens_input: 100,
-            tokens_output: 20,
-            tokens_reasoning: 5,
-            tokens_cache_read: 10,
-            tokens_cache_write: 2,
-            tokens_total: 137,
-            cost: 0,
-            assistant_message_count: 2,
-            is_subagent: false,
-            model: 'gpt-5.3-codex',
-            provider: 'openai',
-        });
-        expect(captured.map((e) => e.name)).toEqual([
-            'project_registered',
-            'session_created',
-            'turn_completed',
-            'tokens_used',
-        ]);
-        expect(captured[0].properties).toMatchObject({
-            project_kind: 'user',
-            source: 'cli',
-            user_project_count: 2,
-            install_id: '33333333-3333-4333-8333-333333333333',
-            schema_version: 1,
-        });
-        expect(captured[1].properties).toMatchObject({
-            has_worktree: true,
-            source: 'discord',
-        });
-        expect(captured[2].properties).toMatchObject({
-            duration_sec: 42,
-        });
-        expect(captured[3].properties).toMatchObject({
-            tokens_input: 100,
-            tokens_output: 20,
-            tokens_reasoning: 5,
-            tokens_cache_read: 10,
-            tokens_cache_write: 2,
-            tokens_total: 137,
-            cost: 0,
-            assistant_message_count: 2,
-            is_subagent: false,
-            model: 'gpt-5.3-codex',
-            provider: 'openai',
-            install_id: '33333333-3333-4333-8333-333333333333',
-            schema_version: 1,
-        });
+// foldAnalytics over recorded OpenCode event streams (spec 29.3): which
+// product events one Kimaki thread produces, for the root and its subagents.
+import { expect, test } from 'vitest';
+import { foldAnalytics } from "./analytics.js";
+import { eventSessionId } from "./thread-reducer.js";
+import { loadFixture, rootSessionId } from "./test/replay.js";
+function foldFixture(file, { reasoning = 0 } = {}) {
+    // The recorded model reports no reasoning; add some to every step to check the total.
+    const events = loadFixture(file).map((event) => {
+        if (event.type === 'session.step.ended')
+            return { ...event, data: { ...event.data, tokens: { ...event.data.tokens, reasoning } } };
+        if (event.type === 'session.step.failed' && event.data.tokens)
+            return { ...event, data: { ...event.data, tokens: { ...event.data.tokens, reasoning } } };
+        return event;
     });
+    const root = rootSessionId(events);
+    const result = events.reduce((acc, event) => {
+        const folded = foldAnalytics({ state: acc.state, event, isRoot: eventSessionId(event) === root });
+        return { state: folded.state, events: [...acc.events, ...folded.events] };
+    }, { state: {}, events: [] });
+    return result.events;
+}
+test('a turn with a foreground subagent: tokens per execution, one completed turn', () => {
+    expect(foldFixture('task-subagent.events.jsonl')).toMatchInlineSnapshot(`
+    [
+      {
+        "name": "turn_started",
+        "properties": {},
+      },
+      {
+        "name": "tokens_used",
+        "properties": {
+          "assistant_message_count": 3,
+          "cost": 0,
+          "is_subagent": true,
+          "model": "gpt-6-luna",
+          "provider": "openai",
+          "tokens_cache_read": 50176,
+          "tokens_cache_write": 0,
+          "tokens_input": 35597,
+          "tokens_output": 92,
+          "tokens_reasoning": 0,
+          "tokens_total": 85865,
+        },
+      },
+      {
+        "name": "tokens_used",
+        "properties": {
+          "assistant_message_count": 3,
+          "cost": 0,
+          "is_subagent": false,
+          "model": "gpt-6-luna",
+          "provider": "openai",
+          "tokens_cache_read": 72192,
+          "tokens_cache_write": 0,
+          "tokens_input": 3100,
+          "tokens_output": 118,
+          "tokens_reasoning": 0,
+          "tokens_total": 75410,
+        },
+      },
+      {
+        "name": "turn_completed",
+        "properties": {
+          "duration_sec": 13,
+        },
+      },
+    ]
+  `);
+});
+test('an interrupted turn reports the tokens of its failed step but does not complete; reasoning is billed', () => {
+    expect(foldFixture('abort.events.jsonl', { reasoning: 100 })).toMatchInlineSnapshot(`
+    [
+      {
+        "name": "turn_started",
+        "properties": {},
+      },
+      {
+        "name": "tokens_used",
+        "properties": {
+          "assistant_message_count": 1,
+          "cost": 0,
+          "is_subagent": false,
+          "model": "gpt-6-luna",
+          "provider": "openai",
+          "tokens_cache_read": 24064,
+          "tokens_cache_write": 0,
+          "tokens_input": 836,
+          "tokens_output": 22,
+          "tokens_reasoning": 100,
+          "tokens_total": 25022,
+        },
+      },
+      {
+        "name": "turn_started",
+        "properties": {},
+      },
+      {
+        "name": "tokens_used",
+        "properties": {
+          "assistant_message_count": 1,
+          "cost": 0,
+          "is_subagent": false,
+          "model": "gpt-6-luna",
+          "provider": "openai",
+          "tokens_cache_read": 24064,
+          "tokens_cache_write": 0,
+          "tokens_input": 897,
+          "tokens_output": 8,
+          "tokens_reasoning": 100,
+          "tokens_total": 25069,
+        },
+      },
+      {
+        "name": "turn_completed",
+        "properties": {
+          "duration_sec": 1,
+        },
+      },
+    ]
+  `);
 });
+//# sourceMappingURL=analytics.test.js.map

package/dist/analytics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.test.js","sourceRoot":"","sources":["../src/analytics.test.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,6EAA6E;AAG7E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAErC,OAAO,EAAE,aAAa,EAAwC,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAE7D,SAAS,WAAW,CAAC,IAAY,EAAE,EAAE,SAAS,GAAG,CAAC,KAA6B,EAAE;IAC/E,sFAAsF;IACtF,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAW,EAAE;QACtD,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB;YAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;QAClI,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;QACxJ,OAAO,KAAK,CAAA;IACd,CAAC,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAC1B,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QACjG,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAA;IAC3E,CAAC,EACD,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAC1B,CAAA;IACD,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC;AAED,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;IACvF,MAAM,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC,CAAC,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CvE,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,sGAAsG,EAAE,GAAG,EAAE;IAChH,MAAM,CAAC,WAAW,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDnF,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/autostart.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_LOCK_PORT = 29988;
+export declare function distCliEntry(): string;
+export declare function writeAutostartScript({ dataDir, args }: {
+    dataDir: string;
+    args: readonly string[];
+}): Promise<Error | void>;
+export declare function autostartBot(): void;

package/dist/autostart.js

@@ -0,0 +1,75 @@
+// Start the bot when OpenCode starts. The bot writes <dataDir>/autostart.command
+// on every start; the Kimaki OpenCode plugin opens it when no bot answers on
+// the lock port:
+//
+//   kimaki start ──writes──▶ ~/.kimaki/autostart.command   (exec node <pkg>/dist/cli.js ...)
+//                                       ▲
+//   OpenCode loads plugin ──no /health on 29988──▶ open -g autostart.command
+//                                                  (default terminal app, in background)
+//
+// The script exists only after onboarding succeeded, so a fresh install never
+// opens a terminal with the onboarding prompts. It always runs dist/cli.js,
+// also when the bot ran from src: keep dist built. --if-not-running makes a bot that
+// lost the race exit instead of stopping the running one.
+// Imported by the plugin (OpenCode process): no logger, no bot modules.
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import dedent from 'string-dedent';
+export const DEFAULT_LOCK_PORT = 29988;
+const SCRIPT_NAME = 'autostart.command';
+const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+// <pkg>/dist/cli.js, from this file at <pkg>/{src,dist}/autostart.{ts,js}.
+export function distCliEntry() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'dist', 'cli.js');
+}
+// Windows has no autostart: it would need a .cmd script and `start`.
+export async function writeAutostartScript({ dataDir, args }) {
+    if (process.platform === 'win32')
+        return;
+    const file = path.join(dataDir, SCRIPT_NAME);
+    const cli = distCliEntry();
+    if (!fs.existsSync(cli))
+        return fs.promises.rm(file, { force: true }).catch((cause) => cause);
+    const command = [process.execPath, cli, '--if-not-running', '--data-dir', dataDir, ...args].map(quote).join(' ');
+    // The bot inherits the OpenCode (or Terminal) env: drop overrides that would change its port, token or service.
+    const script = dedent `
+    #!/bin/sh
+    # Generated by Kimaki on bot start. The Kimaki OpenCode plugin opens it when no bot runs.
+    unset KIMAKI_LOCK_PORT KIMAKI_BOT_TOKEN KIMAKI_OPENCODE_SERVICE_FILE KIMAKI_DATA_DIR KIMAKI_SUPERVISED
+    exec ${command}
+  ` + '\n';
+    return fs.promises.writeFile(file, script, { mode: 0o755 }).then(() => fs.promises.chmod(file, 0o755))
+        .catch((cause) => cause);
+}
+// Only the default install: HOME and the default port, never KIMAKI_* env.
+// Agent shells export KIMAKI_DATA_DIR, so test OpenCode servers started from
+// them would otherwise start the real bot. Test servers set HOME to a temp dir.
+async function startIfStopped() {
+    const file = path.join(os.homedir(), '.kimaki', SCRIPT_NAME);
+    if (!fs.existsSync(file))
+        return;
+    // Any answer means the port is taken (V2 or V1 bot).
+    const running = await fetch(`http://127.0.0.1:${DEFAULT_LOCK_PORT}/health`, { signal: AbortSignal.timeout(2_000) })
+        .then(() => true, () => false);
+    if (running)
+        return;
+    // macOS opens .command files in the default terminal app; -g keeps it in the background.
+    const [command, args] = process.platform === 'darwin' ? ['open', ['-g', file]] : ['sh', [file]];
+    const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+    child.on('error', () => undefined);
+    child.unref();
+}
+// Once per OpenCode process: setup runs once per location and every reload
+// re-imports the plugin, so module state would not dedupe. A bot the user
+// stopped is not started again until OpenCode restarts.
+const STARTED = Symbol.for('kimaki.autostart');
+export function autostartBot() {
+    if (process.platform === 'win32' || Reflect.get(globalThis, STARTED))
+        return;
+    Reflect.set(globalThis, STARTED, true);
+    void startIfStopped().catch(() => undefined);
+}
+//# sourceMappingURL=autostart.js.map

package/dist/autostart.js.map

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

package/dist/bot.d.ts

@@ -0,0 +1,90 @@
+import type { JsonValue, SessionMetadata } from '@opencode/client';
+import { type Client, type TextChannel, type ThreadChannel } from 'discord.js';
+import type { AgentUi } from './agent-ui.ts';
+import type { Analytics } from './analytics.ts';
+import type { KimakiDb } from './db.ts';
+import type { EffectsRunner } from './effects.ts';
+import { ConfigError, DbError, DiscordError, OpenCodeError, OpenCodeUnavailableError } from './errors.ts';
+import type { EventLoop } from './event-loop.ts';
+import type { OpenCodeClient, OpencodeConnection } from './opencode-server.ts';
+import type { Route } from './routes.ts';
+import type { Clock } from './scheduler.ts';
+import type { PluginWait } from './sessions.ts';
+import type { SleepLock } from './sleeps.ts';
+import type { BotStore } from './store.ts';
+import type { ScheduledRun } from './system-prompt.ts';
+import type { TranscriptionBaseUrls } from './voice.ts';
+import type { RealtimeBaseUrls, VoiceCalls } from './voice-call.ts';
+export type Author = {
+    id: string;
+    username: string;
+};
+export type PromptFile = {
+    uri: string;
+    name: string;
+};
+export type ModelChoice = {
+    providerID: string;
+    id: string;
+    variant: string | null;
+};
+export type BotFeatures = {
+    withSleepLock: SleepLock;
+    waitForPlugin: PluginWait;
+    agentUi: AgentUi;
+    voiceCalls: VoiceCalls;
+};
+export type Bot = {
+    discord: Client;
+    db: KimakiDb;
+    store: BotStore;
+    opencode: OpencodeConnection;
+    eventLoop: EventLoop;
+    effects: EffectsRunner;
+    analytics: Analytics;
+    clock: Clock;
+    dataDir: string;
+    lockPort: number;
+    supervised: boolean;
+    token: string;
+    appId: string;
+    opencodeDbFile: string;
+    transcriptionBaseUrls: TranscriptionBaseUrls;
+    realtimeBaseUrls: RealtimeBaseUrls;
+    autoWorktrees: boolean;
+    features: BotFeatures;
+};
+export declare function oc<T>(bot: Pick<Bot, 'opencode'>, operation: string, run: (client: OpenCodeClient) => Promise<T>): Promise<OpenCodeUnavailableError | OpenCodeError | T>;
+export declare function projectOf(bot: Bot, channelId: string): Promise<{
+    created_at: Date | null;
+    channel_id: string;
+    directory: string;
+    channel_type: "text" | "voice";
+    guild_id: string | null;
+} | DbError | null>;
+export declare function sessionDirectory(bot: Pick<Bot, 'opencode'>, sessionId: string): Promise<string | OpenCodeError | OpenCodeUnavailableError>;
+export declare function rootSession(bot: Bot, threadId: string): OpenCodeError | string;
+export declare function threadOfSession(bot: Bot, sessionId: string): string | null;
+export declare function fetchThread(bot: Bot, threadId: string): Promise<DiscordError | ConfigError | ThreadChannel>;
+export declare function textChannel(bot: Bot, channelId: string): Promise<DiscordError | TextChannel>;
+export type SessionMarker = {
+    fields: {
+        readonly [key: string]: JsonValue;
+    };
+    dataDir: string | null;
+    lockPort: number | null;
+    parentSessionId: string | null;
+    task: ScheduledRun | null;
+};
+export declare function readMarker(metadata: SessionMetadata | undefined): SessionMarker | null;
+export declare function cliContext(bot: Bot): {
+    dataDir: string;
+    lockPort: number;
+};
+export declare function globalModel(bot: Bot): Promise<DbError | ModelChoice | null>;
+export declare function parseModel(value: string | null | undefined, variant: string | null | undefined): {
+    variant?: string | undefined;
+    providerID: string;
+    id: string;
+} | null;
+export declare function routeText(route: Route): string;

package/dist/bot.js

@@ -0,0 +1,120 @@
+// The one context every bot function takes as its first parameter. main.ts
+// builds it once per bot; tests start several bots in one process, so per-bot
+// state never lives in module globals. State owned by one feature stays in
+// that feature's closure; Bot only exposes its operations (`features`).
+//
+// Also the small helpers most writers share: OpenCode calls with errore
+// wrapping, project and thread lookups, the session marker.
+import { ChannelType } from 'discord.js';
+import { ConfigError, DbError, DiscordError, OpenCodeError, OpenCodeUnavailableError } from "./errors.js";
+// One OpenCode call of the current connection, with its rejection as an OpenCodeError.
+export async function oc(bot, operation, run) {
+    const client = bot.opencode.endpoint?.client;
+    if (!client)
+        return new OpenCodeUnavailableError({ reason: 'not connected' });
+    return run(client).catch((cause) => new OpenCodeError({ operation, cause }));
+}
+// The project row of a channel; null when the channel is not a project here.
+export async function projectOf(bot, channelId) {
+    const row = await bot.db.query.channel_directories
+        .findFirst({ where: { channel_id: channelId } })
+        .catch((cause) => new DbError({ operation: 'read channel_directories', cause }));
+    if (row instanceof Error)
+        return row;
+    return row ?? null;
+}
+// Current working directory of a session (session.moved changes it).
+export async function sessionDirectory(bot, sessionId) {
+    const info = await oc(bot, 'read session directory', (client) => client.session.get({ sessionID: sessionId }));
+    if (info instanceof Error)
+        return info;
+    return info.location.directory;
+}
+export function rootSession(bot, threadId) {
+    return bot.store.getState().roots[threadId] ?? new OpenCodeError({ operation: `find the session of thread ${threadId}` });
+}
+// The thread whose root session this is; null for children and unknown sessions.
+export function threadOfSession(bot, sessionId) {
+    const { sessionThreads, roots } = bot.store.getState();
+    const threadId = sessionThreads[sessionId];
+    return threadId && roots[threadId] === sessionId ? threadId : null;
+}
+export async function fetchThread(bot, threadId) {
+    const channel = await bot.discord.channels
+        .fetch(threadId)
+        .catch((cause) => new DiscordError({ operation: `fetch thread ${threadId}`, cause }));
+    if (channel instanceof Error)
+        return channel;
+    if (!channel?.isThread())
+        return new ConfigError({ reason: 'Target is not a thread' });
+    return channel;
+}
+export async function textChannel(bot, channelId) {
+    const channel = await bot.discord.channels
+        .fetch(channelId)
+        .catch((cause) => new DiscordError({ operation: `fetch channel ${channelId}`, cause }));
+    if (channel instanceof Error)
+        return channel;
+    if (channel?.type !== ChannelType.GuildText)
+        return new DiscordError({ operation: `use non-text channel ${channelId}` });
+    return channel;
+}
+function jsonObject(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+export function readMarker(metadata) {
+    const fields = jsonObject(metadata?.['kimaki']);
+    if (!fields)
+        return null;
+    const { dataDir, lockPort, parentSessionId } = fields;
+    const task = jsonObject(fields['task']);
+    const taskId = task?.['id'];
+    const cronExpr = task?.['cronExpr'];
+    const timezone = task?.['timezone'];
+    return {
+        fields,
+        dataDir: typeof dataDir === 'string' ? dataDir : null,
+        lockPort: typeof lockPort === 'number' ? lockPort : null,
+        parentSessionId: typeof parentSessionId === 'string' ? parentSessionId : null,
+        task: typeof taskId === 'number'
+            ? { id: taskId, cronExpr: typeof cronExpr === 'string' ? cronExpr : null, timezone: typeof timezone === 'string' ? timezone : null }
+            : null,
+    };
+}
+// The marker fields that point the agent's `kimaki` calls at this bot.
+export function cliContext(bot) {
+    return { dataDir: bot.dataDir, lockPort: bot.lockPort };
+}
+// Default model of new sessions in channels without their own (/model "All channels").
+export async function globalModel(bot) {
+    const row = await bot.db.query.global_models
+        .findFirst({ where: { app_id: bot.appId } })
+        .catch((cause) => new DbError({ operation: 'read global_models', cause }));
+    if (row instanceof Error)
+        return row;
+    const model = parseModel(row?.model_id, row?.variant);
+    return model ? { ...model, variant: row?.variant ?? null } : null;
+}
+export function parseModel(value, variant) {
+    if (!value)
+        return null;
+    const slash = value.indexOf('/');
+    if (slash <= 0)
+        return null;
+    return {
+        providerID: value.slice(0, slash),
+        id: value.slice(slash + 1),
+        ...(variant && { variant }),
+    };
+}
+// What a thread name and an echo show for an input.
+export function routeText(route) {
+    if (route.kind === 'shell')
+        return `!${route.command}`;
+    if (route.kind === 'command')
+        return `/${route.name}${route.arguments ? ` ${route.arguments}` : ''}`;
+    if (route.kind === 'skill')
+        return `/${route.id}${route.arguments ? ` ${route.arguments}` : ''}`;
+    return route.text;
+}
+//# sourceMappingURL=bot.js.map

package/dist/bot.js.map

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

package/dist/btw.e2e.test.d.ts

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