@geminixiang/mikan 1.0.0-beta.6 → 1.0.0-beta.60

package/dist/cli/download.js

@@ -0,0 +1,88 @@
+import { LogLevel, WebClient } from "@slack/web-api";
+function formatTs(ts) {
+    const date = new Date(parseFloat(ts) * 1000);
+    return date
+        .toISOString()
+        .replace("T", " ")
+        .replace(/\.\d+Z$/, "");
+}
+function formatMessage(ts, user, text, indent = "") {
+    const prefix = `[${formatTs(ts)}] ${user}: `;
+    const lines = text.split("\n");
+    const firstLine = `${indent}${prefix}${lines[0]}`;
+    if (lines.length === 1)
+        return firstLine;
+    // All continuation lines get same indent as content start
+    const contentIndent = indent + " ".repeat(prefix.length);
+    return [firstLine, ...lines.slice(1).map((l) => contentIndent + l)].join("\n");
+}
+export async function downloadChannel(channelId, botToken) {
+    const client = new WebClient(botToken, { logLevel: LogLevel.ERROR });
+    console.error(`Fetching channel info for ${channelId}...`);
+    const channelName = await resolveChannelName(client, channelId);
+    console.error(`Downloading history for #${channelName} (${channelId})...`);
+    const messages = await fetchHistory(client, channelId);
+    messages.reverse(); // chronological order
+    const threadReplies = await fetchThreadReplies(client, channelId, messages);
+    const totalReplies = printTranscript(messages, threadReplies);
+    console.error(`Done! ${messages.length} messages, ${totalReplies} thread replies`);
+}
+/** DM channels have no name; the id is the readable fallback. */
+async function resolveChannelName(client, channelId) {
+    try {
+        const info = await client.conversations.info({ channel: channelId });
+        return typeof info.channel?.name === "string" ? info.channel.name : channelId;
+    }
+    catch {
+        return channelId;
+    }
+}
+/** Drain one cursor-paginated Slack conversations endpoint, page by page. */
+async function* pages(fetchPage) {
+    let cursor;
+    do {
+        const response = await fetchPage(cursor);
+        yield (response.messages ?? []);
+        cursor = response.response_metadata?.next_cursor;
+    } while (cursor);
+}
+async function fetchHistory(client, channelId) {
+    const messages = [];
+    const fetchPage = (cursor) => client.conversations.history({ channel: channelId, limit: 200, cursor });
+    for await (const page of pages(fetchPage)) {
+        messages.push(...page);
+        console.error(`  Fetched ${messages.length} messages...`);
+    }
+    return messages;
+}
+async function fetchThreadReplies(client, channelId, messages) {
+    const parents = messages.filter((message) => message.reply_count && message.reply_count > 0);
+    console.error(`Fetching ${parents.length} threads...`);
+    const threadReplies = new Map();
+    for (const [index, parent] of parents.entries()) {
+        console.error(`  Thread ${index + 1}/${parents.length} (${parent.reply_count} replies)...`);
+        threadReplies.set(parent.ts, await fetchReplies(client, channelId, parent.ts));
+    }
+    return threadReplies;
+}
+async function fetchReplies(client, channelId, ts) {
+    const replies = [];
+    const fetchPage = (cursor) => client.conversations.replies({ channel: channelId, ts, limit: 200, cursor });
+    for await (const page of pages(fetchPage)) {
+        replies.push(...page.slice(1)); // the first message is the parent
+    }
+    return replies;
+}
+/** Print every message with its thread replies indented underneath. */
+function printTranscript(messages, threadReplies) {
+    let totalReplies = 0;
+    for (const message of messages) {
+        console.log(formatMessage(message.ts, message.user || "unknown", message.text || ""));
+        for (const reply of threadReplies.get(message.ts) ?? []) {
+            console.log(formatMessage(reply.ts, reply.user || "unknown", reply.text || "", "  "));
+            totalReplies++;
+        }
+    }
+    return totalReplies;
+}
+//# sourceMappingURL=download.js.map

package/dist/cli/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../src/cli/download.ts"],"names":[],"mappings":"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","sourcesContent":["import { LogLevel, WebClient } from \"@slack/web-api\";\n\ninterface Message {\n  ts: string;\n  user?: string;\n  text?: string;\n  thread_ts?: string;\n  reply_count?: number;\n  files?: Array<{ name: string; url_private?: string }>;\n}\n\nfunction formatTs(ts: string): string {\n  const date = new Date(parseFloat(ts) * 1000);\n  return date\n    .toISOString()\n    .replace(\"T\", \" \")\n    .replace(/\\.\\d+Z$/, \"\");\n}\n\nfunction formatMessage(ts: string, user: string, text: string, indent = \"\"): string {\n  const prefix = `[${formatTs(ts)}] ${user}: `;\n  const lines = text.split(\"\\n\");\n  const firstLine = `${indent}${prefix}${lines[0]}`;\n  if (lines.length === 1) return firstLine;\n  // All continuation lines get same indent as content start\n  const contentIndent = indent + \" \".repeat(prefix.length);\n  return [firstLine, ...lines.slice(1).map((l) => contentIndent + l)].join(\"\\n\");\n}\n\nexport async function downloadChannel(channelId: string, botToken: string): Promise<void> {\n  const client = new WebClient(botToken, { logLevel: LogLevel.ERROR });\n\n  console.error(`Fetching channel info for ${channelId}...`);\n  const channelName = await resolveChannelName(client, channelId);\n  console.error(`Downloading history for #${channelName} (${channelId})...`);\n\n  const messages = await fetchHistory(client, channelId);\n  messages.reverse(); // chronological order\n\n  const threadReplies = await fetchThreadReplies(client, channelId, messages);\n  const totalReplies = printTranscript(messages, threadReplies);\n  console.error(`Done! ${messages.length} messages, ${totalReplies} thread replies`);\n}\n\n/** DM channels have no name; the id is the readable fallback. */\nasync function resolveChannelName(client: WebClient, channelId: string): Promise<string> {\n  try {\n    const info = await client.conversations.info({ channel: channelId });\n    return typeof info.channel?.name === \"string\" ? info.channel.name : channelId;\n  } catch {\n    return channelId;\n  }\n}\n\ninterface Page {\n  messages?: unknown[];\n  response_metadata?: { next_cursor?: string };\n}\n\n/** Drain one cursor-paginated Slack conversations endpoint, page by page. */\nasync function* pages(fetchPage: (cursor?: string) => Promise<Page>): AsyncGenerator<Message[]> {\n  let cursor: string | undefined;\n  do {\n    const response = await fetchPage(cursor);\n    yield (response.messages ?? []) as Message[];\n    cursor = response.response_metadata?.next_cursor;\n  } while (cursor);\n}\n\nasync function fetchHistory(client: WebClient, channelId: string): Promise<Message[]> {\n  const messages: Message[] = [];\n  const fetchPage = (cursor?: string) =>\n    client.conversations.history({ channel: channelId, limit: 200, cursor });\n  for await (const page of pages(fetchPage)) {\n    messages.push(...page);\n    console.error(`  Fetched ${messages.length} messages...`);\n  }\n  return messages;\n}\n\nasync function fetchThreadReplies(\n  client: WebClient,\n  channelId: string,\n  messages: readonly Message[],\n): Promise<Map<string, Message[]>> {\n  const parents = messages.filter((message) => message.reply_count && message.reply_count > 0);\n  console.error(`Fetching ${parents.length} threads...`);\n\n  const threadReplies = new Map<string, Message[]>();\n  for (const [index, parent] of parents.entries()) {\n    console.error(`  Thread ${index + 1}/${parents.length} (${parent.reply_count} replies)...`);\n    threadReplies.set(parent.ts, await fetchReplies(client, channelId, parent.ts));\n  }\n  return threadReplies;\n}\n\nasync function fetchReplies(client: WebClient, channelId: string, ts: string): Promise<Message[]> {\n  const replies: Message[] = [];\n  const fetchPage = (cursor?: string) =>\n    client.conversations.replies({ channel: channelId, ts, limit: 200, cursor });\n  for await (const page of pages(fetchPage)) {\n    replies.push(...page.slice(1)); // the first message is the parent\n  }\n  return replies;\n}\n\n/** Print every message with its thread replies indented underneath. */\nfunction printTranscript(\n  messages: readonly Message[],\n  threadReplies: ReadonlyMap<string, Message[]>,\n): number {\n  let totalReplies = 0;\n  for (const message of messages) {\n    console.log(formatMessage(message.ts, message.user || \"unknown\", message.text || \"\"));\n    for (const reply of threadReplies.get(message.ts) ?? []) {\n      console.log(formatMessage(reply.ts, reply.user || \"unknown\", reply.text || \"\", \"  \"));\n      totalReplies++;\n    }\n  }\n  return totalReplies;\n}\n"]}

package/dist/cli/office.d.ts

@@ -0,0 +1,2 @@
+export declare function runOfficeCommand(argv: string[]): number;
+//# sourceMappingURL=office.d.ts.map

package/dist/cli/office.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"office.d.ts","sourceRoot":"","sources":["../../src/cli/office.ts"],"names":[],"mappings":"AAeA,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CA6BvD"}

package/dist/cli/office.js

@@ -0,0 +1,83 @@
+/**
+ * `mikan office` — inspect and claim conversation offices from the CLI.
+ *
+ *   mikan office list [--state-dir <dir>] [--workspace <dir>]
+ *   mikan office claim <conversationId> <platform> [--state-dir <dir>] [--workspace <dir>]
+ *
+ * `claim` records which platform owns a legacy raw-id conversation directory
+ * when several platforms are enabled and boot cannot infer ownership. The
+ * daemon performs the actual move on its next start. Run it with the daemon
+ * stopped so the directory is not moving under a live runtime.
+ */
+import { join, resolve } from "node:path";
+import { assertPlatformName, OfficeRegistry } from "../office/index.js";
+import { cliCommand, commandExitCode, nonEmptyValue, resolveStateDir } from "./arg-grammar.js";
+export function runOfficeCommand(argv) {
+    const command = cliCommand("mikan office")
+        .description("Inspect conversation offices and claim legacy directories")
+        .option("--state-dir <dir>", "State directory", nonEmptyValue)
+        .option("--workspace <dir>", "Workspace directory", nonEmptyValue);
+    let result = 1;
+    command
+        .command("list")
+        .description("List registered offices")
+        .action(() => {
+        result = listOffices(resolveStateDir(argv));
+    });
+    command
+        .command("claim <conversationId> <platform>")
+        .description("Claim a legacy directory (stop the daemon first)")
+        .action((conversationId, platform) => {
+        const stateDir = resolveStateDir(argv);
+        const { workspace } = command.opts();
+        result = claimOffice(stateDir, workspace ? resolve(workspace) : join(stateDir, "workspace"), [
+            conversationId,
+            platform,
+        ]);
+    });
+    try {
+        command.parse(argv, { from: "user" });
+        return result;
+    }
+    catch (error) {
+        return commandExitCode(error, command);
+    }
+}
+function listOffices(stateDir) {
+    const state = new OfficeRegistry(stateDir).getState();
+    console.log(`Enabled platforms: ${state.enabledPlatforms.join(", ") || "(none)"}`);
+    console.log(`Offices (${state.offices.length}):`);
+    for (const office of state.offices) {
+        console.log(`  ${office.platform}  ${office.conversationId}`);
+    }
+    const pending = state.migrations.filter((record) => record.status !== "committed");
+    if (pending.length > 0) {
+        console.log(`Pending migrations (${pending.length}):`);
+        for (const record of pending) {
+            const error = record.error ? `  (${record.error})` : "";
+            console.log(`  ${record.status}  ${record.rawConversationId}${error}`);
+        }
+    }
+    return 0;
+}
+function claimOffice(stateDir, workspaceRoot, rest) {
+    const [rawConversationId, platform] = rest;
+    if (!rawConversationId || !platform)
+        return 1;
+    try {
+        const record = new OfficeRegistry(stateDir).prepareLegacyMigration({
+            rawConversationId,
+            sourceDir: join(workspaceRoot, rawConversationId),
+            workspaceRoot,
+            ownerPlatform: assertPlatformName(platform),
+        });
+        console.log(`Claimed ${record.rawConversationId} for ${record.ownerPlatform}; ` +
+            "the daemon migrates the directory on its next start.");
+        return 0;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+}
+//# sourceMappingURL=office.js.map

package/dist/cli/office.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"office.js","sourceRoot":"","sources":["../../src/cli/office.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `mikan office` — inspect and claim conversation offices from the CLI.\n *\n *   mikan office list [--state-dir <dir>] [--workspace <dir>]\n *   mikan office claim <conversationId> <platform> [--state-dir <dir>] [--workspace <dir>]\n *\n * `claim` records which platform owns a legacy raw-id conversation directory\n * when several platforms are enabled and boot cannot infer ownership. The\n * daemon performs the actual move on its next start. Run it with the daemon\n * stopped so the directory is not moving under a live runtime.\n */\nimport { join, resolve } from \"node:path\";\nimport { assertPlatformName, OfficeRegistry } from \"../office/index.js\";\nimport { cliCommand, commandExitCode, nonEmptyValue, resolveStateDir } from \"./arg-grammar.js\";\n\nexport function runOfficeCommand(argv: string[]): number {\n  const command = cliCommand(\"mikan office\")\n    .description(\"Inspect conversation offices and claim legacy directories\")\n    .option(\"--state-dir <dir>\", \"State directory\", nonEmptyValue)\n    .option(\"--workspace <dir>\", \"Workspace directory\", nonEmptyValue);\n  let result = 1;\n  command\n    .command(\"list\")\n    .description(\"List registered offices\")\n    .action(() => {\n      result = listOffices(resolveStateDir(argv));\n    });\n  command\n    .command(\"claim <conversationId> <platform>\")\n    .description(\"Claim a legacy directory (stop the daemon first)\")\n    .action((conversationId: string, platform: string) => {\n      const stateDir = resolveStateDir(argv);\n      const { workspace } = command.opts<{ workspace?: string }>();\n      result = claimOffice(stateDir, workspace ? resolve(workspace) : join(stateDir, \"workspace\"), [\n        conversationId,\n        platform,\n      ]);\n    });\n  try {\n    command.parse(argv, { from: \"user\" });\n    return result;\n  } catch (error) {\n    return commandExitCode(error, command);\n  }\n}\n\nfunction listOffices(stateDir: string): number {\n  const state = new OfficeRegistry(stateDir).getState();\n  console.log(`Enabled platforms: ${state.enabledPlatforms.join(\", \") || \"(none)\"}`);\n  console.log(`Offices (${state.offices.length}):`);\n  for (const office of state.offices) {\n    console.log(`  ${office.platform}  ${office.conversationId}`);\n  }\n  const pending = state.migrations.filter((record) => record.status !== \"committed\");\n  if (pending.length > 0) {\n    console.log(`Pending migrations (${pending.length}):`);\n    for (const record of pending) {\n      const error = record.error ? `  (${record.error})` : \"\";\n      console.log(`  ${record.status}  ${record.rawConversationId}${error}`);\n    }\n  }\n  return 0;\n}\n\nfunction claimOffice(stateDir: string, workspaceRoot: string, rest: string[]): number {\n  const [rawConversationId, platform] = rest;\n  if (!rawConversationId || !platform) return 1;\n  try {\n    const record = new OfficeRegistry(stateDir).prepareLegacyMigration({\n      rawConversationId,\n      sourceDir: join(workspaceRoot, rawConversationId),\n      workspaceRoot,\n      ownerPlatform: assertPlatformName(platform),\n    });\n    console.log(\n      `Claimed ${record.rawConversationId} for ${record.ownerPlatform}; ` +\n        \"the daemon migrates the directory on its next start.\",\n    );\n    return 0;\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : String(err));\n    return 1;\n  }\n}\n"]}

package/dist/cli/onboard.d.ts

@@ -0,0 +1,10 @@
+import type { OnboardIo } from "./types.js";
+/** Merge collected vars into the env file, preserving unrelated existing lines. */
+export declare function renderEnvFile(existing: string | undefined, vars: Record<string, string>): string;
+export declare function runOnboardWizard(stateDir: string, io: OnboardIo, paths?: {
+    envFilePath?: string;
+    modelsJsonPath?: string;
+}): Promise<number>;
+/** Entry point for main.ts. Interactive on a TTY; template-only otherwise. */
+export declare function runOnboardCommand(stateDir: string): Promise<number>;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/cli/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/cli/onboard.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyI5C,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAUhG;AAWD,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,SAAS,EACb,KAAK,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAAC,MAAM,CAAC,CAmDjB;AAED,8EAA8E;AAC9E,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBzE"}

package/dist/cli/onboard.js

@@ -0,0 +1,225 @@
+/**
+ * `mikan onboard` — interactive first-run setup.
+ *
+ * Three questions cover the minimum viable deployment: one chat adapter,
+ * one LLM provider, and an optional sandbox mode. Everything asked is
+ * derived from existing authorities (ENV_MANIFEST for platform vars,
+ * settings/models.json shapes from config.ts / harness/models.ts) — this
+ * file adds no second inventory of anything.
+ *
+ * Products:
+ *   - <state-dir>/settings.json        (llm section follows the choice)
+ *   - <state-dir>/mikan.env  (0600)    (tokens/keys; at the default state
+ *                                       dir this is the ~/.mikan/mikan.env
+ *                                       the pm2 ecosystem file loads)
+ *   - ~/.mikan/models.json             (custom endpoint choice only)
+ *
+ * Non-interactive stdin (CI, piped) falls back to writing the settings
+ * template only — the pre-wizard `--onboard` behavior.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import * as prompts from "@clack/prompts";
+import { ENV_MANIFEST, envReport, readEnv } from "../env-manifest.js";
+import { createGlobalSettingsFile } from "../config.js";
+import { defaultModelsJsonPath } from "../harness/models.js";
+import { atomicWritePrivateFile } from "../file-guards.js";
+class OnboardAborted extends Error {
+    constructor() {
+        super("Onboarding aborted.");
+    }
+}
+/** Cancellation is handled before any settings are written. */
+async function answer(result) {
+    const value = await result;
+    if (prompts.isCancel(value))
+        throw new OnboardAborted();
+    return value;
+}
+function terminalIo() {
+    return {
+        ask: (message) => answer(prompts.text({ message: message.trim() })),
+        askSecret: (message) => answer(prompts.password({ message: message.trim() })),
+        select: (message, labels) => answer(prompts.select({
+            message,
+            options: labels.map((label, value) => ({ label, value })),
+        })),
+        confirm: (message) => answer(prompts.confirm({ message, initialValue: true })),
+        print: (line) => prompts.log.info(line.trim()),
+        close: () => { },
+    };
+}
+async function askRequired(io, query, secret = false) {
+    for (;;) {
+        const value = (secret ? await io.askSecret(query) : await io.ask(query)).trim();
+        if (value)
+            return value;
+        io.print("  (required)");
+    }
+}
+async function askChoice(io, labels, prompt) {
+    return io.select(prompt, labels);
+}
+/** Q1: pick a platform group from the manifest and collect its vars. */
+async function askAdapter(io, env) {
+    const platforms = ENV_MANIFEST.filter((group) => group.kind === "platform");
+    io.print("\nStep 1/3 — chat adapter");
+    const index = await askChoice(io, platforms.map((g) => g.title), "Platform");
+    const group = platforms[index];
+    for (const spec of group.vars.filter((v) => v.required)) {
+        env[spec.name] = await askRequired(io, `  ${spec.name} (${spec.doc}): `, spec.secret);
+    }
+    if (group.anyOf) {
+        // Prefer the path form of an either/or pair (keeps PEMs out of env files).
+        const name = group.anyOf.find((n) => n.endsWith("_PATH")) ?? group.anyOf[0];
+        const doc = group.vars.find((v) => v.name === name)?.doc ?? "";
+        env[name] = await askRequired(io, `  ${name} (${doc}): `);
+    }
+}
+/** Q2: LLM provider. Returns settings llm choice; may add env vars / models.json. */
+async function askLlm(io, env) {
+    io.print("\nStep 2/3 — LLM provider");
+    const index = await askChoice(io, [
+        "Anthropic (ANTHROPIC_API_KEY)",
+        "OpenAI (OPENAI_API_KEY)",
+        "Custom OpenAI-compatible endpoint (vLLM, proxy, …) — writes models.json",
+    ], "Provider");
+    if (index === 0) {
+        env.ANTHROPIC_API_KEY = await askRequired(io, "  ANTHROPIC_API_KEY: ", true);
+        const model = (await io.ask("  Model [claude-sonnet-4-6]: ")).trim() || "claude-sonnet-4-6";
+        return { llm: { provider: "anthropic", model } };
+    }
+    if (index === 1) {
+        env.OPENAI_API_KEY = await askRequired(io, "  OPENAI_API_KEY: ", true);
+        const model = (await io.ask("  Model [gpt-5.2]: ")).trim() || "gpt-5.2";
+        return { llm: { provider: "openai", model } };
+    }
+    const provider = (await io.ask("  Provider name [custom]: ")).trim() || "custom";
+    const baseUrl = await askRequired(io, "  Base URL (e.g. http://host:8080/v1): ");
+    const apiKey = (await io.askSecret("  API key (empty if none): ")).trim();
+    const ids = (await askRequired(io, "  Model ids (comma-separated): "))
+        .split(",")
+        .map((id) => id.trim())
+        .filter(Boolean);
+    const modelsJson = JSON.stringify({
+        providers: {
+            [provider]: {
+                api: "openai-completions",
+                baseUrl,
+                ...(apiKey ? { apiKey } : {}),
+                models: ids.map((id) => ({ id })),
+            },
+        },
+    }, null, 2);
+    return { llm: { provider, model: ids[0] }, modelsJson };
+}
+/** Q3: sandbox mode. Returns the `--sandbox` argument, or undefined for host. */
+async function askSandbox(io) {
+    io.print("\nStep 3/3 — sandbox (where agent commands run)");
+    const index = await askChoice(io, [
+        "host — run directly on this machine (default)",
+        "image — per-conversation Docker containers (needs Docker)",
+        "other — configure later via --sandbox (cloudflare)",
+    ], "Sandbox");
+    if (index === 0)
+        return undefined;
+    if (index === 1) {
+        const image = (await io.ask("  Image [ghcr.io/geminixiang/mikan-sandbox:latest]: ")).trim() ||
+            "ghcr.io/geminixiang/mikan-sandbox:latest";
+        return `image:${image}`;
+    }
+    io.print("  See `mikan --help` for the --sandbox spec.");
+    return undefined;
+}
+/** Merge collected vars into the env file, preserving unrelated existing lines. */
+export function renderEnvFile(existing, vars) {
+    const pending = new Map(Object.entries(vars));
+    const lines = [];
+    for (const line of existing ? existing.split("\n") : []) {
+        const rendered = rewriteEnvLine(line, pending);
+        if (rendered.trim() || lines.length > 0)
+            lines.push(rendered);
+    }
+    while (lines.at(-1) === "")
+        lines.pop();
+    for (const [key, value] of pending)
+        lines.push(`${key}=${value}`);
+    return `${lines.join("\n")}\n`;
+}
+/** Replace a `KEY=` line whose key is still pending, consuming that key. */
+function rewriteEnvLine(line, pending) {
+    const key = /^([A-Za-z_][A-Za-z0-9_]*)=/.exec(line)?.[1];
+    if (key === undefined || !pending.has(key))
+        return line;
+    const value = pending.get(key);
+    pending.delete(key);
+    return `${key}=${value}`;
+}
+export async function runOnboardWizard(stateDir, io, paths) {
+    const settingsPath = join(stateDir, "settings.json");
+    if (existsSync(settingsPath)) {
+        io.print(`Global settings already exists at ${settingsPath}.`);
+        io.print("Remove it first to re-run onboarding, or edit it directly.");
+        return 1;
+    }
+    const env = {};
+    await askAdapter(io, env);
+    const { llm, modelsJson } = await askLlm(io, env);
+    const sandboxArg = await askSandbox(io);
+    const modelsPath = paths?.modelsJsonPath ?? defaultModelsJsonPath();
+    if (modelsJson && existsSync(modelsPath)) {
+        io.print(`models.json already exists at ${modelsPath}. Add the provider manually before retrying; nothing was written.`);
+        return 1;
+    }
+    io.print(`Review settings\nProvider: ${llm.provider}\nModel: ${llm.model}\nSandbox: ${sandboxArg ?? "host"}\nSettings: ${settingsPath}\nCredentials: ${paths?.envFilePath ?? join(stateDir, "mikan.env")}${modelsJson ? `\nModels: ${modelsPath}` : ""}\nSecrets are hidden.`);
+    if (!(await io.confirm("Save these settings?"))) {
+        io.print("Onboarding cancelled; nothing was written.");
+        return 1;
+    }
+    createGlobalSettingsFile(stateDir, llm);
+    io.print(`\nWrote ${settingsPath}`);
+    if (modelsJson) {
+        atomicWritePrivateFile(modelsPath, `${modelsJson}\n`);
+        io.print(`Wrote ${modelsPath}`);
+    }
+    // Lives beside settings.json; at the default state dir this is exactly
+    // the ~/.mikan/mikan.env that the pm2 ecosystem file loads.
+    const envFilePath = paths?.envFilePath ?? join(stateDir, "mikan.env");
+    const existing = existsSync(envFilePath) ? readFileSync(envFilePath, "utf-8") : undefined;
+    atomicWritePrivateFile(envFilePath, renderEnvFile(existing, env));
+    io.print(`Wrote ${envFilePath} (0600)`);
+    // Report against the answers just given without mutating process.env.
+    io.print(`\n${envReport((name) => env[name] ?? readEnv(name))}`);
+    const sandboxFlag = sandboxArg ? ` --sandbox ${sandboxArg}` : "";
+    io.print("Next steps:");
+    io.print(`  pm2:    pm2 start ecosystem.config.cjs   (loads ${envFilePath}; see deploy/pm2/)`);
+    io.print(`  direct: set -a; source ${envFilePath}; set +a; mikan${sandboxFlag}`);
+    return 0;
+}
+/** Entry point for main.ts. Interactive on a TTY; template-only otherwise. */
+export async function runOnboardCommand(stateDir) {
+    if (!process.stdin.isTTY) {
+        const settingsPath = createGlobalSettingsFile(stateDir);
+        console.log(`Created global settings at ${settingsPath}`);
+        console.log(`Review the file, then start mikan (workspace defaults to ${join(stateDir, "workspace")}).`);
+        return 0;
+    }
+    prompts.intro("Mikan setup · arrows to choose · Esc / Ctrl+C to cancel");
+    const io = terminalIo();
+    try {
+        const code = await runOnboardWizard(stateDir, io);
+        prompts.outro(code === 0 ? "Setup complete" : "Setup not saved");
+        return code;
+    }
+    catch (err) {
+        if (err instanceof OnboardAborted) {
+            prompts.cancel("Onboarding aborted; nothing was written.");
+            return 1;
+        }
+        throw err;
+    }
+    finally {
+        io.close();
+    }
+}
+//# sourceMappingURL=onboard.js.map

package/dist/cli/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../src/cli/onboard.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `mikan onboard` — interactive first-run setup.\n *\n * Three questions cover the minimum viable deployment: one chat adapter,\n * one LLM provider, and an optional sandbox mode. Everything asked is\n * derived from existing authorities (ENV_MANIFEST for platform vars,\n * settings/models.json shapes from config.ts / harness/models.ts) — this\n * file adds no second inventory of anything.\n *\n * Products:\n *   - <state-dir>/settings.json        (llm section follows the choice)\n *   - <state-dir>/mikan.env  (0600)    (tokens/keys; at the default state\n *                                       dir this is the ~/.mikan/mikan.env\n *                                       the pm2 ecosystem file loads)\n *   - ~/.mikan/models.json             (custom endpoint choice only)\n *\n * Non-interactive stdin (CI, piped) falls back to writing the settings\n * template only — the pre-wizard `--onboard` behavior.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport * as prompts from \"@clack/prompts\";\nimport { ENV_MANIFEST, envReport, readEnv } from \"../env-manifest.js\";\nimport { createGlobalSettingsFile } from \"../config.js\";\nimport type { OnboardLlmChoice } from \"../types.js\";\nimport { defaultModelsJsonPath } from \"../harness/models.js\";\nimport { atomicWritePrivateFile } from \"../file-guards.js\";\nimport type { OnboardIo } from \"./types.js\";\n\nclass OnboardAborted extends Error {\n  constructor() {\n    super(\"Onboarding aborted.\");\n  }\n}\n\n/** Cancellation is handled before any settings are written. */\nasync function answer<T>(result: Promise<T>): Promise<Exclude<T, symbol>> {\n  const value = await result;\n  if (prompts.isCancel(value)) throw new OnboardAborted();\n  return value as Exclude<T, symbol>;\n}\n\nfunction terminalIo(): OnboardIo {\n  return {\n    ask: (message) => answer(prompts.text({ message: message.trim() })),\n    askSecret: (message) => answer(prompts.password({ message: message.trim() })),\n    select: (message, labels) =>\n      answer(\n        prompts.select({\n          message,\n          options: labels.map((label, value) => ({ label, value })),\n        }),\n      ),\n    confirm: (message) => answer(prompts.confirm({ message, initialValue: true })),\n    print: (line) => prompts.log.info(line.trim()),\n    close: () => {},\n  };\n}\n\nasync function askRequired(io: OnboardIo, query: string, secret = false): Promise<string> {\n  for (;;) {\n    const value = (secret ? await io.askSecret(query) : await io.ask(query)).trim();\n    if (value) return value;\n    io.print(\"  (required)\");\n  }\n}\n\nasync function askChoice(io: OnboardIo, labels: string[], prompt: string): Promise<number> {\n  return io.select(prompt, labels);\n}\n\n/** Q1: pick a platform group from the manifest and collect its vars. */\nasync function askAdapter(io: OnboardIo, env: Record<string, string>): Promise<void> {\n  const platforms = ENV_MANIFEST.filter((group) => group.kind === \"platform\");\n  io.print(\"\\nStep 1/3 — chat adapter\");\n  const index = await askChoice(\n    io,\n    platforms.map((g) => g.title),\n    \"Platform\",\n  );\n  const group = platforms[index]!;\n  for (const spec of group.vars.filter((v) => v.required)) {\n    env[spec.name] = await askRequired(io, `  ${spec.name} (${spec.doc}): `, spec.secret);\n  }\n  if (group.anyOf) {\n    // Prefer the path form of an either/or pair (keeps PEMs out of env files).\n    const name = group.anyOf.find((n) => n.endsWith(\"_PATH\")) ?? group.anyOf[0]!;\n    const doc = group.vars.find((v) => v.name === name)?.doc ?? \"\";\n    env[name] = await askRequired(io, `  ${name} (${doc}): `);\n  }\n}\n\n/** Q2: LLM provider. Returns settings llm choice; may add env vars / models.json. */\nasync function askLlm(\n  io: OnboardIo,\n  env: Record<string, string>,\n): Promise<{ llm: OnboardLlmChoice; modelsJson?: string }> {\n  io.print(\"\\nStep 2/3 — LLM provider\");\n  const index = await askChoice(\n    io,\n    [\n      \"Anthropic (ANTHROPIC_API_KEY)\",\n      \"OpenAI (OPENAI_API_KEY)\",\n      \"Custom OpenAI-compatible endpoint (vLLM, proxy, …) — writes models.json\",\n    ],\n    \"Provider\",\n  );\n  if (index === 0) {\n    env.ANTHROPIC_API_KEY = await askRequired(io, \"  ANTHROPIC_API_KEY: \", true);\n    const model = (await io.ask(\"  Model [claude-sonnet-4-6]: \")).trim() || \"claude-sonnet-4-6\";\n    return { llm: { provider: \"anthropic\", model } };\n  }\n  if (index === 1) {\n    env.OPENAI_API_KEY = await askRequired(io, \"  OPENAI_API_KEY: \", true);\n    const model = (await io.ask(\"  Model [gpt-5.2]: \")).trim() || \"gpt-5.2\";\n    return { llm: { provider: \"openai\", model } };\n  }\n  const provider = (await io.ask(\"  Provider name [custom]: \")).trim() || \"custom\";\n  const baseUrl = await askRequired(io, \"  Base URL (e.g. http://host:8080/v1): \");\n  const apiKey = (await io.askSecret(\"  API key (empty if none): \")).trim();\n  const ids = (await askRequired(io, \"  Model ids (comma-separated): \"))\n    .split(\",\")\n    .map((id) => id.trim())\n    .filter(Boolean);\n  const modelsJson = JSON.stringify(\n    {\n      providers: {\n        [provider]: {\n          api: \"openai-completions\",\n          baseUrl,\n          ...(apiKey ? { apiKey } : {}),\n          models: ids.map((id) => ({ id })),\n        },\n      },\n    },\n    null,\n    2,\n  );\n  return { llm: { provider, model: ids[0]! }, modelsJson };\n}\n\n/** Q3: sandbox mode. Returns the `--sandbox` argument, or undefined for host. */\nasync function askSandbox(io: OnboardIo): Promise<string | undefined> {\n  io.print(\"\\nStep 3/3 — sandbox (where agent commands run)\");\n  const index = await askChoice(\n    io,\n    [\n      \"host — run directly on this machine (default)\",\n      \"image — per-conversation Docker containers (needs Docker)\",\n      \"other — configure later via --sandbox (cloudflare)\",\n    ],\n    \"Sandbox\",\n  );\n  if (index === 0) return undefined;\n  if (index === 1) {\n    const image =\n      (await io.ask(\"  Image [ghcr.io/geminixiang/mikan-sandbox:latest]: \")).trim() ||\n      \"ghcr.io/geminixiang/mikan-sandbox:latest\";\n    return `image:${image}`;\n  }\n  io.print(\"  See `mikan --help` for the --sandbox spec.\");\n  return undefined;\n}\n\n/** Merge collected vars into the env file, preserving unrelated existing lines. */\nexport function renderEnvFile(existing: string | undefined, vars: Record<string, string>): string {\n  const pending = new Map(Object.entries(vars));\n  const lines: string[] = [];\n  for (const line of existing ? existing.split(\"\\n\") : []) {\n    const rendered = rewriteEnvLine(line, pending);\n    if (rendered.trim() || lines.length > 0) lines.push(rendered);\n  }\n  while (lines.at(-1) === \"\") lines.pop();\n  for (const [key, value] of pending) lines.push(`${key}=${value}`);\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\n/** Replace a `KEY=` line whose key is still pending, consuming that key. */\nfunction rewriteEnvLine(line: string, pending: Map<string, string>): string {\n  const key = /^([A-Za-z_][A-Za-z0-9_]*)=/.exec(line)?.[1];\n  if (key === undefined || !pending.has(key)) return line;\n  const value = pending.get(key);\n  pending.delete(key);\n  return `${key}=${value}`;\n}\n\nexport async function runOnboardWizard(\n  stateDir: string,\n  io: OnboardIo,\n  paths?: { envFilePath?: string; modelsJsonPath?: string },\n): Promise<number> {\n  const settingsPath = join(stateDir, \"settings.json\");\n  if (existsSync(settingsPath)) {\n    io.print(`Global settings already exists at ${settingsPath}.`);\n    io.print(\"Remove it first to re-run onboarding, or edit it directly.\");\n    return 1;\n  }\n\n  const env: Record<string, string> = {};\n  await askAdapter(io, env);\n  const { llm, modelsJson } = await askLlm(io, env);\n  const sandboxArg = await askSandbox(io);\n\n  const modelsPath = paths?.modelsJsonPath ?? defaultModelsJsonPath();\n  if (modelsJson && existsSync(modelsPath)) {\n    io.print(\n      `models.json already exists at ${modelsPath}. Add the provider manually before retrying; nothing was written.`,\n    );\n    return 1;\n  }\n  io.print(\n    `Review settings\\nProvider: ${llm.provider}\\nModel: ${llm.model}\\nSandbox: ${sandboxArg ?? \"host\"}\\nSettings: ${settingsPath}\\nCredentials: ${paths?.envFilePath ?? join(stateDir, \"mikan.env\")}${modelsJson ? `\\nModels: ${modelsPath}` : \"\"}\\nSecrets are hidden.`,\n  );\n  if (!(await io.confirm(\"Save these settings?\"))) {\n    io.print(\"Onboarding cancelled; nothing was written.\");\n    return 1;\n  }\n\n  createGlobalSettingsFile(stateDir, llm);\n  io.print(`\\nWrote ${settingsPath}`);\n\n  if (modelsJson) {\n    atomicWritePrivateFile(modelsPath, `${modelsJson}\\n`);\n    io.print(`Wrote ${modelsPath}`);\n  }\n\n  // Lives beside settings.json; at the default state dir this is exactly\n  // the ~/.mikan/mikan.env that the pm2 ecosystem file loads.\n  const envFilePath = paths?.envFilePath ?? join(stateDir, \"mikan.env\");\n  const existing = existsSync(envFilePath) ? readFileSync(envFilePath, \"utf-8\") : undefined;\n  atomicWritePrivateFile(envFilePath, renderEnvFile(existing, env));\n  io.print(`Wrote ${envFilePath} (0600)`);\n\n  // Report against the answers just given without mutating process.env.\n  io.print(`\\n${envReport((name) => env[name] ?? readEnv(name))}`);\n\n  const sandboxFlag = sandboxArg ? ` --sandbox ${sandboxArg}` : \"\";\n  io.print(\"Next steps:\");\n  io.print(`  pm2:    pm2 start ecosystem.config.cjs   (loads ${envFilePath}; see deploy/pm2/)`);\n  io.print(`  direct: set -a; source ${envFilePath}; set +a; mikan${sandboxFlag}`);\n  return 0;\n}\n\n/** Entry point for main.ts. Interactive on a TTY; template-only otherwise. */\nexport async function runOnboardCommand(stateDir: string): Promise<number> {\n  if (!process.stdin.isTTY) {\n    const settingsPath = createGlobalSettingsFile(stateDir);\n    console.log(`Created global settings at ${settingsPath}`);\n    console.log(\n      `Review the file, then start mikan (workspace defaults to ${join(stateDir, \"workspace\")}).`,\n    );\n    return 0;\n  }\n  prompts.intro(\"Mikan setup · arrows to choose · Esc / Ctrl+C to cancel\");\n  const io = terminalIo();\n  try {\n    const code = await runOnboardWizard(stateDir, io);\n    prompts.outro(code === 0 ? \"Setup complete\" : \"Setup not saved\");\n    return code;\n  } catch (err) {\n    if (err instanceof OnboardAborted) {\n      prompts.cancel(\"Onboarding aborted; nothing was written.\");\n      return 1;\n    }\n    throw err;\n  } finally {\n    io.close();\n  }\n}\n"]}

package/dist/cli/sessions.d.ts

@@ -0,0 +1,2 @@
+export declare function runSessionsCommand(argv: string[]): Promise<number>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/cli/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/cli/sessions.ts"],"names":[],"mappings":"AAoBA,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBxE"}

package/dist/cli/sessions.js

@@ -0,0 +1,88 @@
+/**
+ * `mikan sessions` — session-file maintenance from the CLI.
+ *
+ *   mikan sessions migrate [--state-dir <dir>] [--workspace <dir>] [--dry-run]
+ *
+ * `migrate` rewrites legacy mikan v3 and Pi 0.84-generation v4 sessions to
+ * Pi's current JSONL v4 storage schema. Run it with the daemon stopped. Each
+ * candidate is verified before atomic replacement, and the original remains
+ * beside it as `<file>.v3.bak` or `<file>.pi-084.bak`.
+ */
+import { join, resolve } from "node:path";
+import { findPi084SessionFiles, migratePi084SessionFile } from "../sessions/migrate-pi-084.js";
+import { findV3SessionFiles, migrateSessionFile } from "../sessions/migrate-v3.js";
+import { cliCommand, commandExitCode, nonEmptyValue, resolveStateDir } from "./arg-grammar.js";
+export async function runSessionsCommand(argv) {
+    const command = cliCommand("mikan sessions")
+        .description("Session-file maintenance (stop the daemon first)")
+        .option("--state-dir <dir>", "State directory", nonEmptyValue)
+        .option("--workspace <dir>", "Workspace directory", nonEmptyValue);
+    let result = 1;
+    command
+        .command("migrate")
+        .description("Migrate legacy sessions, preserving backups")
+        .option("--dry-run", "Preview migration without writing")
+        .action(async (options) => {
+        const { workspace } = command.opts();
+        const workspaceRoot = workspace
+            ? resolve(workspace)
+            : join(resolveStateDir(argv), "workspace");
+        result = await migrateWorkspace(workspaceRoot, options.dryRun ?? false);
+    });
+    try {
+        await command.parseAsync(argv, { from: "user" });
+        return result;
+    }
+    catch (error) {
+        return commandExitCode(error, command);
+    }
+}
+async function migrateWorkspace(workspaceRoot, dryRun) {
+    const candidates = findCandidates(workspaceRoot);
+    if (candidates.length === 0) {
+        console.log(`No legacy session files found under ${workspaceRoot}`);
+        return 0;
+    }
+    console.log(`Found ${candidates.length} legacy session file(s) under ${workspaceRoot}`);
+    const { migrated, failed } = await migrateCandidates(candidates, dryRun);
+    console.log(dryRun
+        ? `Dry run: ${migrated} file(s) would be migrated, ${failed} failed to read.`
+        : `Migrated ${migrated} file(s), ${failed} failure(s). Originals kept as *.v3.bak or *.pi-084.bak.`);
+    return failed === 0 ? 0 : 1;
+}
+function findCandidates(workspaceRoot) {
+    return [
+        ...findV3SessionFiles(workspaceRoot).map((file) => ({ file, format: "v3" })),
+        ...findPi084SessionFiles(workspaceRoot).map((file) => ({ file, format: "pi-084" })),
+    ].toSorted((left, right) => left.file.localeCompare(right.file));
+}
+async function migrateCandidates(candidates, dryRun) {
+    let migrated = 0;
+    let failed = 0;
+    for (const candidate of candidates) {
+        const outcome = await migrateCandidate(candidate, dryRun);
+        if (outcome === "migrated")
+            migrated++;
+        if (outcome === "failed")
+            failed++;
+    }
+    return { migrated, failed };
+}
+/** Migrate one session file. Read/convert failures are reported, never thrown. */
+async function migrateCandidate({ file, format }, dryRun) {
+    try {
+        const result = format === "v3"
+            ? await migrateSessionFile(file, { dryRun })
+            : await migratePi084SessionFile(file, { dryRun });
+        if (result.status !== "migrated")
+            return "skipped";
+        console.log(`${dryRun ? "would migrate" : "migrated"}  ${file}`);
+        return "migrated";
+    }
+    catch (error) {
+        const cause = error instanceof Error && error.cause ? ` (${String(error.cause)})` : "";
+        console.error(`FAILED     ${file}: ${error instanceof Error ? error.message : error}${cause}`);
+        return "failed";
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/cli/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/cli/sessions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `mikan sessions` — session-file maintenance from the CLI.\n *\n *   mikan sessions migrate [--state-dir <dir>] [--workspace <dir>] [--dry-run]\n *\n * `migrate` rewrites legacy mikan v3 and Pi 0.84-generation v4 sessions to\n * Pi's current JSONL v4 storage schema. Run it with the daemon stopped. Each\n * candidate is verified before atomic replacement, and the original remains\n * beside it as `<file>.v3.bak` or `<file>.pi-084.bak`.\n */\nimport { join, resolve } from \"node:path\";\nimport { findPi084SessionFiles, migratePi084SessionFile } from \"../sessions/migrate-pi-084.js\";\nimport { findV3SessionFiles, migrateSessionFile } from \"../sessions/migrate-v3.js\";\nimport { cliCommand, commandExitCode, nonEmptyValue, resolveStateDir } from \"./arg-grammar.js\";\n\ninterface Candidate {\n  file: string;\n  format: \"v3\" | \"pi-084\";\n}\n\nexport async function runSessionsCommand(argv: string[]): Promise<number> {\n  const command = cliCommand(\"mikan sessions\")\n    .description(\"Session-file maintenance (stop the daemon first)\")\n    .option(\"--state-dir <dir>\", \"State directory\", nonEmptyValue)\n    .option(\"--workspace <dir>\", \"Workspace directory\", nonEmptyValue);\n  let result = 1;\n  command\n    .command(\"migrate\")\n    .description(\"Migrate legacy sessions, preserving backups\")\n    .option(\"--dry-run\", \"Preview migration without writing\")\n    .action(async (options: { dryRun?: boolean }) => {\n      const { workspace } = command.opts<{ workspace?: string }>();\n      const workspaceRoot = workspace\n        ? resolve(workspace)\n        : join(resolveStateDir(argv), \"workspace\");\n      result = await migrateWorkspace(workspaceRoot, options.dryRun ?? false);\n    });\n  try {\n    await command.parseAsync(argv, { from: \"user\" });\n    return result;\n  } catch (error) {\n    return commandExitCode(error, command);\n  }\n}\n\nasync function migrateWorkspace(workspaceRoot: string, dryRun: boolean): Promise<number> {\n  const candidates = findCandidates(workspaceRoot);\n  if (candidates.length === 0) {\n    console.log(`No legacy session files found under ${workspaceRoot}`);\n    return 0;\n  }\n\n  console.log(`Found ${candidates.length} legacy session file(s) under ${workspaceRoot}`);\n  const { migrated, failed } = await migrateCandidates(candidates, dryRun);\n  console.log(\n    dryRun\n      ? `Dry run: ${migrated} file(s) would be migrated, ${failed} failed to read.`\n      : `Migrated ${migrated} file(s), ${failed} failure(s). Originals kept as *.v3.bak or *.pi-084.bak.`,\n  );\n  return failed === 0 ? 0 : 1;\n}\n\nfunction findCandidates(workspaceRoot: string): Candidate[] {\n  return [\n    ...findV3SessionFiles(workspaceRoot).map((file) => ({ file, format: \"v3\" as const })),\n    ...findPi084SessionFiles(workspaceRoot).map((file) => ({ file, format: \"pi-084\" as const })),\n  ].toSorted((left, right) => left.file.localeCompare(right.file));\n}\n\nasync function migrateCandidates(\n  candidates: readonly Candidate[],\n  dryRun: boolean,\n): Promise<{ migrated: number; failed: number }> {\n  let migrated = 0;\n  let failed = 0;\n  for (const candidate of candidates) {\n    const outcome = await migrateCandidate(candidate, dryRun);\n    if (outcome === \"migrated\") migrated++;\n    if (outcome === \"failed\") failed++;\n  }\n  return { migrated, failed };\n}\n\n/** Migrate one session file. Read/convert failures are reported, never thrown. */\nasync function migrateCandidate(\n  { file, format }: Candidate,\n  dryRun: boolean,\n): Promise<\"migrated\" | \"skipped\" | \"failed\"> {\n  try {\n    const result =\n      format === \"v3\"\n        ? await migrateSessionFile(file, { dryRun })\n        : await migratePi084SessionFile(file, { dryRun });\n    if (result.status !== \"migrated\") return \"skipped\";\n    console.log(`${dryRun ? \"would migrate\" : \"migrated\"}  ${file}`);\n    return \"migrated\";\n  } catch (error) {\n    const cause = error instanceof Error && error.cause ? ` (${String(error.cause)})` : \"\";\n    console.error(`FAILED     ${file}: ${error instanceof Error ? error.message : error}${cause}`);\n    return \"failed\";\n  }\n}\n"]}

package/dist/cli/types.d.ts

@@ -0,0 +1,25 @@
+import type { SandboxConfig } from "../sandbox/types.js";
+/** Prompt/print seam for the onboard wizard, so tests can script answers. */
+export interface OnboardIo {
+    ask(query: string): Promise<string>;
+    askSecret(query: string): Promise<string>;
+    select(query: string, labels: string[]): Promise<number>;
+    confirm(query: string): Promise<boolean>;
+    print(line: string): void;
+    close(): void;
+}
+export interface BootPlan {
+    mode: "office" | "sessions" | "env" | "help" | "version" | "onboard" | "download" | "run";
+    /** argv after `office`, handed to runOfficeCommand. Only set for mode "office". */
+    officeArgs?: string[];
+    /** argv after `sessions`, handed to runSessionsCommand. Only set for mode "sessions". */
+    sessionsArgs?: string[];
+    stateDir: string;
+    /** Resolved working directory; defaults to `<stateDir>/workspace`. */
+    workingDir: string;
+    /** True when the working directory came from argv (then it is not auto-created). */
+    workingDirExplicit: boolean;
+    sandbox: SandboxConfig;
+    downloadChannel?: string;
+}
+//# sourceMappingURL=types.d.ts.map