opensquid 0.5.395

package/dist/setup/cli/topic_create_step.js

@@ -0,0 +1,213 @@
+/**
+ * TPS.4 — first-run topic-create step for the chat-setup wizard.
+ *
+ * Slots between WIZ.3 (executePlan: writes models.yaml + chat_agent.yaml)
+ * and WIZ.4 (runChannelTestStep). When the user has a Telegram supergroup
+ * configured, offers to auto-create a forum topic for the current
+ * workspace + bind it via TPS.3's `resolveOrCreateTopic`. Opt-out (default
+ * = yes). On accept, the workspace's per-project `chat-routing.json` gets
+ * an `auto_bound` block + the new topic_id added to `inbound_topic_ids`,
+ * so the next WIZ.4 test (and subsequent agent traffic) lands in the
+ * freshly-bound topic.
+ *
+ * Why not import `resolveOrCreateTopic` statically: `src.legacy/` is
+ * excluded from `tsconfig.json`. The whole-tree typecheck can't see legacy
+ * exports, and `tsconfig.build.json` doesn't emit them either. We load
+ * the legacy module at runtime via a path computed from `import.meta.url`
+ * — the runtime location is `dist/chat/daemon/workspace-topic.js` (built
+ * by the ad-hoc `pnpm exec tsc src.legacy/...` invocation documented in
+ * `src.legacy/chat/adapters/telegram.ts`). Tests inject a fake
+ * `resolveOrCreateTopic` via the `deps` interface and bypass the loader.
+ *
+ * Never throws past the wizard — mirrors WIZ.4's contract. Every failure
+ * prints a recovery hint via `note()` and returns. The WIZ.3 writes are
+ * already on disk by the time this step runs; failure here leaves the
+ * user with a working config minus the auto-binding.
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { confirm, isCancel, note, spinner } from '@clack/prompts';
+import pc from 'picocolors';
+import { OPENSQUID_HOME, resolveProjectUuid } from '../../runtime/paths.js';
+// ---------------------------------------------------------------------------
+// runTopicCreateStep — TPS.4 entry point. Returns void; never throws.
+// ---------------------------------------------------------------------------
+export async function runTopicCreateStep(deps) {
+    const env = deps.env ?? process.env;
+    if (env.OPENSQUID_NO_BILLED_CALLS === '1') {
+        note('Topic-create skipped (OPENSQUID_NO_BILLED_CALLS=1).', 'Topic');
+        return;
+    }
+    // Pre-flight: daemon liveness (same snapshot WIZ.4 uses).
+    if (!deps.daemonState.running) {
+        note(daemonNotRunningHint(deps.daemonState.pidPath), 'Topic');
+        return;
+    }
+    const workspaceUuid = await resolveProjectUuid({
+        cwd: deps.cwd ?? process.cwd(),
+        env,
+    });
+    if (workspaceUuid === null) {
+        note(noProjectUuidHint(), 'Topic');
+        return;
+    }
+    const loadRouting = deps.loadRouting ?? loadProjectChatRouting;
+    const routing = await loadRouting(workspaceUuid);
+    const chatId = routing?.telegram?.report_channel;
+    if (chatId === undefined || chatId.length === 0) {
+        note(noSupergroupHint(), 'Topic');
+        return;
+    }
+    const proceed = await confirm({
+        message: 'Create a Telegram forum topic for this workspace so its messages are isolated from other projects?',
+        initialValue: true,
+    });
+    if (isCancel(proceed) || proceed !== true) {
+        note('Topic-create skipped — workspace messages will land in the supergroup general topic.', 'Topic');
+        return;
+    }
+    const workspacePath = deps.cwd ?? process.cwd();
+    const resolver = deps.resolveOrCreateTopic ?? (await loadLegacyResolver());
+    const s = spinner();
+    s.start('Creating topic (or reusing existing binding)...');
+    try {
+        const result = await resolver({
+            workspaceUuid,
+            workspacePath: resolve(workspacePath),
+            chatId,
+            mode: 'wizard',
+        });
+        if (result.created) {
+            s.stop(pc.green(`Created topic "${result.topicName}" (thread_id=${String(result.topicId)}). Bound to this workspace.`));
+        }
+        else {
+            s.stop(pc.green(`Existing topic "${result.topicName}" (thread_id=${String(result.topicId)}) reused. Workspace already bound.`));
+        }
+    }
+    catch (err) {
+        s.stop(pc.red(`Topic-create failed: ${describeError(err)}`));
+        note(recoveryHintFor(err), 'Topic');
+    }
+}
+// ---------------------------------------------------------------------------
+// Default routing reader — duplicates WIZ.4's inlined reader. Same
+// type-poison avoidance rationale documented in chat_actions_test_step.ts.
+// ---------------------------------------------------------------------------
+async function loadProjectChatRouting(uuid) {
+    const p = join(OPENSQUID_HOME(), 'projects', uuid, 'chat-routing.json');
+    try {
+        const raw = await readFile(p, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Lazy legacy-resolver loader — resolves at first call so tests that
+// inject `deps.resolveOrCreateTopic` never trigger the dist read. Path
+// is constructed from `import.meta.url` (runtime location) rather than
+// a static import string so the tsconfig src.legacy exclude is honored.
+// ---------------------------------------------------------------------------
+async function loadLegacyResolver() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // Runtime: this file is at dist/setup/cli/topic_create_step.js;
+    // workspace-topic.js lives at dist/chat/daemon/workspace-topic.js.
+    const target = resolve(here, '..', '..', 'chat', 'daemon', 'workspace-topic.js');
+    const mod = (await import(pathToFileURL(target).href));
+    if (typeof mod.resolveOrCreateTopic !== 'function') {
+        throw new Error(`legacy workspace-topic module at ${target} did not export resolveOrCreateTopic — rebuild dist/chat/daemon/* per the src.legacy header instructions`);
+    }
+    return mod.resolveOrCreateTopic;
+}
+// ---------------------------------------------------------------------------
+// Error classification — maps known TPS.3 failure modes to user-actionable
+// recovery hints. Catch-all returns a generic "see daemon logs" hint.
+// Detection is message-substring based (Telegram + grammy error messages
+// pass through resolveOrCreateTopic unchanged).
+// ---------------------------------------------------------------------------
+function describeError(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+function recoveryHintFor(err) {
+    const msg = describeError(err);
+    const lower = msg.toLowerCase();
+    // 403 — bot lacks can_manage_topics. Telegram returns "Bad Request:
+    // CHAT_ADMIN_REQUIRED" or "Forbidden: ...".
+    if (lower.includes('chat_admin_required') ||
+        lower.includes('can_manage_topics') ||
+        msg.includes('403') ||
+        lower.includes('forbidden')) {
+        return [
+            "The bot needs the 'Manage Topics' admin permission on this supergroup.",
+            'In Telegram: open the group → Edit → Administrators → your bot → enable Manage Topics.',
+            'Then re-run `opensquid setup chat` and accept the topic-create step.',
+        ].join('\n');
+    }
+    // 429 — rate-limited.
+    if (msg.includes('429') || lower.includes('too many requests') || lower.includes('retry after')) {
+        return [
+            'Telegram is rate-limiting topic creation for this bot.',
+            'Wait a minute, then re-run `opensquid setup chat` and accept the topic-create step.',
+        ].join('\n');
+    }
+    // 400 — forum topics disabled on the supergroup.
+    if ((msg.includes('400') && (lower.includes('topic') || lower.includes('forum'))) ||
+        lower.includes('topics_disabled') ||
+        lower.includes('not a forum')) {
+        return [
+            'Forum topics are not enabled on this supergroup.',
+            'In Telegram: open the group → Edit → Topics → enable Topics.',
+            'Then re-run `opensquid setup chat` and accept the topic-create step.',
+        ].join('\n');
+    }
+    // Lockfile LOCKED — another opensquid process is binding.
+    if (lower.includes('elocked') || lower.includes('lock')) {
+        return [
+            'Another opensquid process is binding a topic for this workspace right now.',
+            'Wait a few seconds and re-run `opensquid setup chat`.',
+        ].join('\n');
+    }
+    // Persist failed AFTER createTopic — orphan recorded.
+    if (lower.includes('orphan') || (lower.includes('persist') && lower.includes('fail'))) {
+        return [
+            'A topic was created on Telegram but the local binding write failed.',
+            'The orphan was logged to ~/.opensquid/orphan-topics.jsonl for manual cleanup.',
+            'Re-run `opensquid setup chat` after fixing the disk / permissions issue.',
+        ].join('\n');
+    }
+    return [
+        'See `~/.opensquid/chat-daemon.log` for daemon-side detail.',
+        'Re-run `opensquid setup chat` to retry the topic-create step.',
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// Static-text hints (same shape as WIZ.4 sibling)
+// ---------------------------------------------------------------------------
+function daemonNotRunningHint(pidPath) {
+    return [
+        `The chat-daemon is not running (pidfile: ${pidPath}).`,
+        'Start it with:',
+        '  opensquid chat-daemon start',
+        'then re-run `opensquid setup chat` and accept the topic-create step.',
+    ].join('\n');
+}
+function noProjectUuidHint() {
+    return [
+        'Could not resolve the active project UUID.',
+        'Run `opensquid init` in this directory, or set OPENSQUID_PROJECT_UUID.',
+    ].join('\n');
+}
+function noSupergroupHint() {
+    return [
+        'No Telegram supergroup is configured for this workspace.',
+        'Set `report_channel` in ~/.opensquid/projects/<uuid>/chat-routing.json,',
+        'then re-run `opensquid setup chat` to bind a workspace topic.',
+    ].join('\n');
+}
+//# sourceMappingURL=topic_create_step.js.map

package/dist/setup/cli/topic_create_step.js.map

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

package/dist/setup/cli/trace.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OBSERVE.2 — `opensquid trace` CLI verb.
+ *
+ * Three subcommands, all backed by `TraceReader` (OBSERVE.1):
+ *
+ *   opensquid trace <runId>                        — render a timeline
+ *   opensquid trace tail [--follow]                — live event stream
+ *   opensquid trace export <runId> --format <fmt>  — json | md | otel to stdout
+ *
+ * Duration bar is 20-char by default; widens to `min(60, stdout.columns - 40)`
+ * when the terminal is wider than 80 cols. Color via picocolors'
+ * `createColors(enabled)` — enabled iff `stdout.isTTY` and `NO_COLOR` is unset.
+ * `--follow` uses an AbortController + SIGINT handler that detaches itself so
+ * the process exits with no leaked timer. JSON + OTEL export delegate to
+ * `TraceReader.export`; MD renders inline (no duplicate logic for json/otel).
+ *
+ * Imports from: commander, picocolors, ../../runtime/observability/index.js.
+ * Imported by: src/cli.ts (register subcommand).
+ */
+import type { Client } from '@libsql/client';
+import type { Command } from 'commander';
+import type { TraceEvent, TraceTimeline } from '../../runtime/observability/index.js';
+export interface RenderOpts {
+    /** Forced bar width — tests pass a fixed value for deterministic snapshots. */
+    barWidth?: number;
+    /** Force enable/disable color regardless of TTY. */
+    color?: boolean;
+}
+/**
+ * Pure renderer. Returns a multi-line string. Exported for snapshot tests so
+ * every styling decision flows through the injected `opts` deterministically.
+ */
+export declare function renderTimeline(t: TraceTimeline, opts?: RenderOpts): string;
+/** GFM-safe markdown export. No ANSI, no `█` glyph. Pasteable into a PR. */
+export declare function renderMarkdown(t: TraceTimeline): string;
+/** Compact one-line representation for `tail --follow`. */
+export declare function renderTailEvent(e: TraceEvent, opts?: RenderOpts): string;
+export interface TraceCliDeps {
+    /** Factory so tests can inject an in-memory client. */
+    openClient?: (dbPath: string) => Client;
+    stdout?: (s: string) => void;
+    stderr?: (s: string) => void;
+    /** Override the abort controller (tests force-abort `--follow` deterministically). */
+    abort?: AbortController;
+}
+/**
+ * Register `opensquid trace` on the parent program. Every IO boundary
+ * (db open, stdout, stderr, abort signal) is overridable via `deps` so the
+ * commander tree is the same code path in tests as in production.
+ */
+export declare function registerTraceCommand(program: Command, deps?: TraceCliDeps): Command;
+//# sourceMappingURL=trace.d.ts.map

package/dist/setup/cli/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAe,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAOnG,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,CAsB9E;AAqBD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CA4BvD;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM,CAI5E;AAMD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,sFAAsF;IACtF,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAWD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAuHvF"}

package/dist/setup/cli/trace.js

@@ -0,0 +1,239 @@
+/**
+ * OBSERVE.2 — `opensquid trace` CLI verb.
+ *
+ * Three subcommands, all backed by `TraceReader` (OBSERVE.1):
+ *
+ *   opensquid trace <runId>                        — render a timeline
+ *   opensquid trace tail [--follow]                — live event stream
+ *   opensquid trace export <runId> --format <fmt>  — json | md | otel to stdout
+ *
+ * Duration bar is 20-char by default; widens to `min(60, stdout.columns - 40)`
+ * when the terminal is wider than 80 cols. Color via picocolors'
+ * `createColors(enabled)` — enabled iff `stdout.isTTY` and `NO_COLOR` is unset.
+ * `--follow` uses an AbortController + SIGINT handler that detaches itself so
+ * the process exits with no leaked timer. JSON + OTEL export delegate to
+ * `TraceReader.export`; MD renders inline (no duplicate logic for json/otel).
+ *
+ * Imports from: commander, picocolors, ../../runtime/observability/index.js.
+ * Imported by: src/cli.ts (register subcommand).
+ */
+import { createClient } from '@libsql/client';
+import pc from 'picocolors';
+import { TraceReader } from '../../runtime/observability/index.js';
+import { OPENSQUID_HOME } from '../../runtime/paths.js';
+const DEFAULT_BAR_WIDTH = 20;
+const MAX_BAR_WIDTH = 60;
+/** Columns reserved for marks + step idx + fn-name + durationMs label. */
+const NON_BAR_RESERVED = 40;
+function autoBarWidth() {
+    const cols = process.stdout.columns;
+    if (typeof cols !== 'number' || cols <= 0)
+        return DEFAULT_BAR_WIDTH;
+    if (cols <= 80)
+        return DEFAULT_BAR_WIDTH;
+    return Math.min(MAX_BAR_WIDTH, Math.max(DEFAULT_BAR_WIDTH, cols - NON_BAR_RESERVED));
+}
+function colorSupported() {
+    if (process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== '')
+        return false;
+    if (process.env.FORCE_COLOR !== undefined && process.env.FORCE_COLOR !== '')
+        return true;
+    return process.stdout.isTTY === true;
+}
+/**
+ * Pure renderer. Returns a multi-line string. Exported for snapshot tests so
+ * every styling decision flows through the injected `opts` deterministically.
+ */
+export function renderTimeline(t, opts = {}) {
+    const c = pc.createColors(opts.color ?? colorSupported());
+    const barWidth = opts.barWidth ?? autoBarWidth();
+    const lines = [];
+    lines.push(c.bold(`${t.packId}/${t.skill}/${t.ruleId}`) + c.dim(`  run ${t.runId.slice(0, 8)}`));
+    lines.push(c.dim(`  ${new Date(t.startedAtMs).toISOString()}  ${String(t.totalDurationMs)}ms  ${statusLabel(t.status, c)}`));
+    lines.push('');
+    for (const e of t.events) {
+        const bar = renderDurationBar(e.durationMs, t.totalDurationMs, barWidth, c);
+        const mark = e.status === 'completed' ? c.green('✓') : c.red('✗');
+        lines.push(`  ${mark} ${c.cyan(String(e.stepIdx).padStart(2))} ${e.fn.padEnd(20)} ${bar}  ${String(e.durationMs)}ms`);
+        if (e.asBinding !== undefined)
+            lines.push(c.dim(`        as: ${e.asBinding}`));
+        if (e.outputsPreview !== undefined)
+            lines.push(c.dim(`        out: ${e.outputsPreview}`));
+        if (e.errorMessage !== undefined)
+            lines.push(c.red(`        err: ${e.errorMessage}`));
+    }
+    return lines.join('\n');
+}
+function renderDurationBar(stepMs, totalMs, width, c) {
+    const denom = Math.max(totalMs, 1);
+    const filled = Math.max(1, Math.min(width, Math.round((stepMs / denom) * width)));
+    return c.dim('[') + '█'.repeat(filled) + ' '.repeat(width - filled) + c.dim(']');
+}
+function statusLabel(s, c) {
+    switch (s) {
+        case 'completed':
+            return c.green(s);
+        case 'errored':
+            return c.red(s);
+        case 'in_flight':
+            return c.yellow(s);
+        case 'interrupted':
+            return c.magenta(s);
+    }
+}
+/** GFM-safe markdown export. No ANSI, no `█` glyph. Pasteable into a PR. */
+export function renderMarkdown(t) {
+    const head = [
+        `# Trace \`${t.runId}\``,
+        '',
+        `- **Pack**: \`${t.packId}\``,
+        `- **Skill**: \`${t.skill}\``,
+        `- **Rule**: \`${t.ruleId}\``,
+        `- **Event kind**: \`${t.eventKind}\``,
+        `- **Started**: ${new Date(t.startedAtMs).toISOString()}`,
+        `- **Duration**: ${String(t.totalDurationMs)}ms`,
+        `- **Status**: \`${t.status}\``,
+        '',
+        '| # | Function | Duration | Status | as |',
+        '|---|----------|----------|--------|----|',
+    ];
+    const rows = t.events.map((e) => `| ${String(e.stepIdx)} | \`${e.fn}\` | ${String(e.durationMs)}ms | ${e.status} | ${e.asBinding ?? ''} |`);
+    const details = [];
+    for (const e of t.events) {
+        if (e.outputsPreview === undefined && e.errorMessage === undefined)
+            continue;
+        if (details.length === 0)
+            details.push('', '## Details');
+        details.push('', `### Step ${String(e.stepIdx)} — \`${e.fn}\``);
+        if (e.outputsPreview !== undefined)
+            details.push('', '```', `out: ${e.outputsPreview}`, '```');
+        if (e.errorMessage !== undefined)
+            details.push('', '```', `err: ${e.errorMessage}`, '```');
+    }
+    return [...head, ...rows, ...details].join('\n') + '\n';
+}
+/** Compact one-line representation for `tail --follow`. */
+export function renderTailEvent(e, opts = {}) {
+    const c = pc.createColors(opts.color ?? colorSupported());
+    const mark = e.status === 'completed' ? c.green('✓') : c.red('✗');
+    return `${mark} ${c.dim(e.runId.slice(0, 8))} ${c.cyan(String(e.stepIdx).padStart(2))} ${e.fn.padEnd(20)} ${String(e.durationMs)}ms`;
+}
+function defaultDbPath() {
+    return `file:${OPENSQUID_HOME()}/opensquid.db`;
+}
+function defaultOpen(dbPath) {
+    const url = dbPath.startsWith('file:') || dbPath === ':memory:' ? dbPath : `file:${dbPath}`;
+    return createClient({ url });
+}
+/**
+ * Register `opensquid trace` on the parent program. Every IO boundary
+ * (db open, stdout, stderr, abort signal) is overridable via `deps` so the
+ * commander tree is the same code path in tests as in production.
+ */
+export function registerTraceCommand(program, deps = {}) {
+    const open = deps.openClient ?? defaultOpen;
+    const out = deps.stdout ?? ((s) => process.stdout.write(s));
+    const err = deps.stderr ?? ((s) => process.stderr.write(s));
+    const trace = program.command('trace').description('Render durable-execution checkpoint traces.');
+    trace
+        .command('show', { isDefault: true })
+        .description('Render a primitive-call timeline for one run.')
+        .argument('<runId>', 'Run id (as recorded in the checkpoints table)')
+        .option('--db <path>', 'Path to the libsql DB', defaultDbPath())
+        .option('--no-color', 'Disable ANSI color output')
+        .action(async (runId, opts) => {
+        const client = open(opts.db);
+        try {
+            const reader = new TraceReader(client);
+            const timeline = await reader.getTimeline(runId);
+            if (timeline === null) {
+                err(`opensquid trace: no run found for id "${runId}"\n`);
+                process.exitCode = 1;
+                return;
+            }
+            out(renderTimeline(timeline, opts.color ? {} : { color: false }) + '\n');
+        }
+        finally {
+            client.close();
+        }
+    });
+    trace
+        .command('tail')
+        .description('Stream new primitive-call events as they complete.')
+        .option('--db <path>', 'Path to the libsql DB', defaultDbPath())
+        .option('--follow', 'Keep tailing until SIGINT', false)
+        .option('--pack <packId>', 'Filter to one pack')
+        .option('--interval <ms>', 'Polling interval (default 1000ms, floor 100ms)', '1000')
+        .option('--no-color', 'Disable ANSI color output')
+        .action(async (opts) => {
+        const client = open(opts.db);
+        const controller = deps.abort ?? new AbortController();
+        const onSigint = () => {
+            controller.abort();
+        };
+        process.on('SIGINT', onSigint);
+        try {
+            const reader = new TraceReader(client);
+            const tailOpts = {
+                sinceMs: Date.now(),
+                intervalMs: Number(opts.interval),
+                signal: controller.signal,
+            };
+            if (opts.pack !== undefined)
+                tailOpts.packId = opts.pack;
+            const stream = await reader.tail(tailOpts);
+            const renderOpts = opts.color ? {} : { color: false };
+            for await (const ev of stream) {
+                out(renderTailEvent(ev, renderOpts) + '\n');
+                if (!opts.follow) {
+                    controller.abort();
+                    break;
+                }
+            }
+        }
+        finally {
+            process.off('SIGINT', onSigint);
+            client.close();
+        }
+    });
+    trace
+        .command('export')
+        .description('Export a run as json | md | otel to stdout.')
+        .argument('<runId>', 'Run id (as recorded in the checkpoints table)')
+        .requiredOption('--format <fmt>', 'Output format: json | md | otel')
+        .option('--db <path>', 'Path to the libsql DB', defaultDbPath())
+        .action(async (runId, opts) => {
+        const fmt = opts.format;
+        if (fmt !== 'json' && fmt !== 'md' && fmt !== 'otel') {
+            err(`opensquid trace export: unknown --format "${fmt}" (expected json|md|otel)\n`);
+            process.exitCode = 1;
+            return;
+        }
+        const client = open(opts.db);
+        try {
+            const reader = new TraceReader(client);
+            if (fmt === 'md') {
+                const timeline = await reader.getTimeline(runId);
+                if (timeline === null) {
+                    err(`opensquid trace export: no run found for id "${runId}"\n`);
+                    process.exitCode = 1;
+                    return;
+                }
+                out(renderMarkdown(timeline));
+                return;
+            }
+            const exported = await reader.export(runId, fmt);
+            if (exported === '') {
+                err(`opensquid trace export: no run found for id "${runId}"\n`);
+                process.exitCode = 1;
+                return;
+            }
+            out(exported + '\n');
+        }
+        finally {
+            client.close();
+        }
+    });
+    return trace;
+}
+//# sourceMappingURL=trace.js.map

package/dist/setup/cli/trace.js.map

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

package/dist/setup/cli/triggers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CLI.1 — `opensquid triggers list|show|fire|enable|disable`.
+ *
+ * Commander wiring + table rendering. Pack enumeration + state-file IO
+ * live in `triggers_state.ts`; synthetic-event construction lives in
+ * `triggers_synth.ts` (both split for file-size budget). Trigger id
+ * format (locked): `<pack>:<skill>:<kind>:<index>`. `fire` requires
+ * `--yes` in non-TTY contexts; TTY shows an interactive `[y/N]` prompt.
+ *
+ * Imports from: commander, picocolors, node:readline/promises,
+ *   ./triggers_state.js, ./triggers_synth.js.
+ * Imported by: src/cli.ts.
+ */
+import { type TriggerRow } from './triggers_state.js';
+import type { Command } from 'commander';
+import type { Event } from '../../runtime/types.js';
+export type { TriggerRow } from './triggers_state.js';
+export type TriggerDispatch = (event: Event) => Promise<void> | void;
+export interface TriggersCliDeps {
+    packsDir?: string;
+    statePath?: string;
+    stdout?: (s: string) => void;
+    stderr?: (s: string) => void;
+    isTty?: () => boolean;
+    dispatch?: TriggerDispatch;
+    now?: () => Date;
+}
+export declare function renderTable(rows: readonly TriggerRow[], opts?: {
+    color?: boolean;
+}): string;
+export declare function registerTriggers(parent: Command, deps?: TriggersCliDeps): Command;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/setup/cli/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/setup/cli/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAOD,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CA4B/F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CA0GrF"}