@atomic-chat/core 0.5.1

package/dist/cli/commands/server.js.map

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

package/dist/cli/commands/shared.d.ts

@@ -0,0 +1,10 @@
+/** Helpers used by more than one CLI command: the data folder, sizes, paths and server URLs. */
+import type { LocalApiServerState } from '../../contracts/index.js';
+import type { DataLayout } from '../../config/index.js';
+import type { CliIo } from '../io.js';
+export declare function layoutFor(values: Record<string, unknown>, io: CliIo): DataLayout;
+/** Human-readable size, same thresholds as the Rust `fmt_bytes`. */
+export declare function formatBytes(bytes: number): string;
+export declare function pathValue(value: unknown, cwd: string): string | undefined;
+export declare function baseUrl(state: LocalApiServerState): string;
+export declare function apiUrl(state: LocalApiServerState): string;

package/dist/cli/commands/shared.js

@@ -0,0 +1,34 @@
+/** Helpers used by more than one CLI command: the data folder, sizes, paths and server URLs. */
+import { isAbsolute, resolve } from 'node:path';
+import { assertCliDataFolder, dataLayout, nodeDataFolderEnv, resolveCliDataFolder, } from '../../config/index.js';
+export function layoutFor(values, io) {
+    const explicit = typeof values['data-folder'] === 'string' ? values['data-folder'] : undefined;
+    const env = nodeDataFolderEnv(io.env);
+    const root = explicit ?? resolveCliDataFolder(env);
+    assertCliDataFolder(root, env);
+    return dataLayout(root);
+}
+/** Human-readable size, same thresholds as the Rust `fmt_bytes`. */
+export function formatBytes(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let value = bytes;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit++;
+    }
+    return unit === 0 ? `${value} ${units[unit]}` : `${value.toFixed(1)} ${units[unit]}`;
+}
+export function pathValue(value, cwd) {
+    if (typeof value !== 'string' || !value)
+        return undefined;
+    return isAbsolute(value) ? value : resolve(cwd, value);
+}
+export function baseUrl(state) {
+    const host = state.host === '0.0.0.0' ? '127.0.0.1' : state.host;
+    return `http://${host}:${state.port}`;
+}
+export function apiUrl(state) {
+    return `${baseUrl(state)}${state.prefix}`;
+}
+//# sourceMappingURL=shared.js.map

package/dist/cli/commands/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/cli/commands/shared.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE/C,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,uBAAuB,CAAA;AAI9B,MAAM,UAAU,SAAS,CAAC,MAA+B,EAAE,EAAS;IAClE,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAM,CAAC,aAAa,CAAY,CAAC,CAAC,CAAC,SAAS,CAAA;IAC1G,MAAM,GAAG,GAAG,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,IAAI,GAAG,QAAQ,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAA;IAClD,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAC9B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC3C,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,IAAI,CAAA;QACb,IAAI,EAAE,CAAA;IACR,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;AACtF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc,EAAE,GAAW;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IACzD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAA0B;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;IAChE,OAAO,UAAU,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAA0B;IAC/C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAA;AAC3C,CAAC"}

package/dist/cli/commands/shutdown.d.ts

@@ -0,0 +1,4 @@
+/** `shutdown` — ask the owner of a data folder to stop. */
+import type { CliIo } from '../io.js';
+/** `shutdown` — stop the core that owns this folder. */
+export declare function shutdownCommand(argv: string[], io: CliIo): Promise<number>;

package/dist/cli/commands/shutdown.js

@@ -0,0 +1,32 @@
+/** `shutdown` — ask the owner of a data folder to stop. */
+import { parseArgs } from 'node:util';
+import { withAttachedOwner } from '../owner.js';
+import { layoutFor } from './shared.js';
+/** `shutdown` — stop the core that owns this folder. */
+export async function shutdownCommand(argv, io) {
+    const { values } = parseArgs({
+        args: argv,
+        options: { 'data-folder': { type: 'string' }, 'force': { type: 'boolean' } },
+        strict: true,
+        allowPositionals: false,
+    });
+    const layout = layoutFor(values, io);
+    let stopped = false;
+    try {
+        await withAttachedOwner({ layout, clientName: 'atomic-chat-core shutdown' }, async ({ client }, clientId) => {
+            await client.shutdown({ force: values.force === true, client_id: clientId });
+            stopped = true;
+        });
+    }
+    catch (e) {
+        if (e.code === 'CORE_NOT_RUNNING') {
+            io.stdout('No core is running for this data folder.\n');
+            return 0;
+        }
+        throw e;
+    }
+    if (stopped)
+        io.stdout('Core is stopping.\n');
+    return 0;
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/cli/commands/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../../../src/cli/commands/shutdown.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,wDAAwD;AACxD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc,EAAE,EAAS;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;QAC5E,MAAM,EAAE,IAAI;QACZ,gBAAgB,EAAE,KAAK;KACxB,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACpC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,iBAAiB,CACrB,EAAE,MAAM,EAAE,UAAU,EAAE,2BAA2B,EAAE,EACnD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE;YAC7B,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC5E,OAAO,GAAG,IAAI,CAAA;QAChB,CAAC,CACF,CAAA;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAAqB,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACvD,EAAE,CAAC,MAAM,CAAC,4CAA4C,CAAC,CAAA;YACvD,OAAO,CAAC,CAAA;QACV,CAAC;QACD,MAAM,CAAC,CAAA;IACT,CAAC;IACD,IAAI,OAAO;QAAE,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAC7C,OAAO,CAAC,CAAA;AACV,CAAC"}

package/dist/cli/commands/telemetry.d.ts

@@ -0,0 +1,8 @@
+/** `telemetry [status|on|off]` — the user's own say over the core's anonymous error reports. */
+import type { CliIo } from '../io.js';
+export declare function telemetryCommand(argv: string[], io: CliIo): Promise<number>;
+/**
+ * Print the one-time notice (stderr) when this data folder's core would report only because nobody
+ * said no. Commands that start or attach a core call it first.
+ */
+export declare function printFirstRunNotice(io: CliIo, telemetryFile: string): Promise<void>;

package/dist/cli/commands/telemetry.js

@@ -0,0 +1,50 @@
+/** `telemetry [status|on|off]` — the user's own say over the core's anonymous error reports. */
+import { parseArgs } from 'node:util';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { FIRST_RUN_NOTICE, envConsent, readTelemetryFile, resolveConsent, takeFirstRunNotice, writeTelemetryFile, } from '../../telemetry/index.js';
+import { CORE_VERSION } from '../../version.js';
+import { layoutFor } from './shared.js';
+const WHY = {
+    env: 'set by DO_NOT_TRACK or ATOMIC_CORE_TELEMETRY',
+    host: 'set by the program that runs the core',
+    stored: 'your choice',
+    default: 'the default; turn off with `atomic-chat-core telemetry off`',
+};
+export async function telemetryCommand(argv, io) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: { 'data-folder': { type: 'string' } },
+        allowPositionals: true,
+        strict: true,
+    });
+    const action = positionals[0] ?? 'status';
+    if (action !== 'status' && action !== 'on' && action !== 'off') {
+        io.stderr(`Unknown telemetry action "${action}": use status, on or off.\n`);
+        return 2;
+    }
+    const path = layoutFor(values, io).core.telemetry;
+    if (action !== 'status') {
+        const saved = await writeTelemetryFile(path, {
+            ...(await readTelemetryFile(path)),
+            enabled: action === 'on',
+            notice_shown: true,
+        });
+        if (!saved)
+            throw new AtomicCoreError('IO_ERROR', 'Could not save the error-report setting.', path);
+    }
+    const stored = await readTelemetryFile(path);
+    const decision = resolveConsent({ env: envConsent(io.env), stored: stored.enabled });
+    io.stdout(`Error reports: ${decision.enabled ? 'on' : 'off'} (${WHY[decision.source]})\n`);
+    if (action !== 'status')
+        io.stdout('A core that is already running keeps its setting until it restarts.\n');
+    return 0;
+}
+/**
+ * Print the one-time notice (stderr) when this data folder's core would report only because nobody
+ * said no. Commands that start or attach a core call it first.
+ */
+export async function printFirstRunNotice(io, telemetryFile) {
+    if (await takeFirstRunNotice({ telemetryFile, env: io.env, version: CORE_VERSION }))
+        io.stderr(FIRST_RUN_NOTICE);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/cli/commands/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/cli/commands/telemetry.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,GAAG,GAAkC;IACzC,GAAG,EAAE,8CAA8C;IACnD,IAAI,EAAE,uCAAuC;IAC7C,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,6DAA6D;CACvE,CAAA;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc,EAAE,EAAS;IAC9D,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;QACxC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAC9C,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,IAAI;KACb,CAAC,CAAA;IACF,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAA;IACzC,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC/D,EAAE,CAAC,MAAM,CAAC,6BAA6B,MAAM,6BAA6B,CAAC,CAAA;QAC3E,OAAO,CAAC,CAAA;IACV,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAA;IACjD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE;YAC3C,GAAG,CAAC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO,EAAE,MAAM,KAAK,IAAI;YACxB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAA;QACF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,0CAA0C,EAAE,IAAI,CAAC,CAAA;IACrG,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IACpF,EAAE,CAAC,MAAM,CAAC,kBAAkB,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1F,IAAI,MAAM,KAAK,QAAQ;QAAE,EAAE,CAAC,MAAM,CAAC,uEAAuE,CAAC,CAAA;IAC3G,OAAO,CAAC,CAAA;AACV,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EAAS,EAAE,aAAqB;IACxE,IAAI,MAAM,kBAAkB,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QACjF,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;AAC/B,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Public API of the CLI module: the owner model (find or start the core that owns a data folder)
+ * and the injectable I/O every command runs against. The command dispatcher (`main.ts`) and the
+ * commands themselves stay internal — a host reuses the mechanics, not the command surface.
+ */
+export * from './owner.js';
+export * from './io.js';

package/dist/cli/index.js

@@ -0,0 +1,8 @@
+/**
+ * Public API of the CLI module: the owner model (find or start the core that owns a data folder)
+ * and the injectable I/O every command runs against. The command dispatcher (`main.ts`) and the
+ * commands themselves stay internal — a host reuses the mechanics, not the command surface.
+ */
+export * from './owner.js';
+export * from './io.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/cli/io.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Everything the CLI touches outside its own logic, in one injectable object: output streams, the
+ * environment, the clock, HTTP, and "wait until someone stops us". Tests drive commands with a
+ * recording implementation instead of spawning a process for every assertion.
+ */
+import type { FatalDeps } from '../telemetry/index.js';
+export interface CliIo {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    fetch: typeof fetch;
+    readFile: (path: string) => Promise<string | undefined>;
+    /** Select one option; commands inject this so unit tests never need a real terminal. */
+    select: (prompt: string, options: string[]) => Promise<number>;
+    /**
+     * Block until the process is asked to stop, then run `onStop`. The daemon uses this to stay up;
+     * a test hands back a promise it resolves itself.
+     */
+    waitForShutdown: (onStop: () => Promise<void>) => Promise<void>;
+    /** Open a URL in the user's browser; best effort, the URL is always printed as well. */
+    openUrl: (url: string) => Promise<void>;
+    /**
+     * Report what nothing caught, then exit 1 — for a command that owns this process (`daemon`). Only
+     * the real process has it: a test runs commands inside its own.
+     */
+    installProcessHandlers?: (deps: Omit<FatalDeps, 'writeStderr' | 'exit'>) => void;
+}
+export interface SelectTerminal {
+    interactive: boolean;
+    write: (text: string) => void;
+    question: (prompt: string) => Promise<string>;
+}
+/** The prompt policy without process globals, so invalid/non-interactive selections are testable. */
+export declare function selectOption(prompt: string, options: string[], terminal: SelectTerminal): Promise<number>;
+export declare function nodeCliIo(): CliIo;
+/** Collects output instead of writing it; the tests' view of a command run. */
+export declare function recordingIo(over?: Partial<CliIo>): CliIo & {
+    out: string[];
+    err: string[];
+};
+/** How each platform opens a URL in the default browser. */
+export declare function browserCommand(platform: NodeJS.Platform, url: string): [string, string[]];
+export declare function openInBrowser(url: string, platform?: NodeJS.Platform, spawner?: (command: string, args: string[]) => Promise<void>): Promise<void>;
+/** Start a program and let it go; a missing program is not an error, the URL was printed anyway. */
+export declare function spawnDetached(command: string, args: string[]): Promise<void>;

package/dist/cli/io.js

@@ -0,0 +1,101 @@
+/**
+ * Everything the CLI touches outside its own logic, in one injectable object: output streams, the
+ * environment, the clock, HTTP, and "wait until someone stops us". Tests drive commands with a
+ * recording implementation instead of spawning a process for every assertion.
+ */
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { createInterface } from 'node:readline/promises';
+import { processHandlersFor } from '../telemetry/index.js';
+/** The prompt policy without process globals, so invalid/non-interactive selections are testable. */
+export async function selectOption(prompt, options, terminal) {
+    if (!terminal.interactive)
+        throw new Error(`${prompt} requires an interactive terminal.`);
+    terminal.write(`\n${prompt}\n`);
+    options.forEach((option, index) => terminal.write(`  ${index + 1}. ${option}\n`));
+    const answer = await terminal.question('Selection [1]: ');
+    const index = answer.trim() === '' ? 0 : Number(answer) - 1;
+    if (!Number.isInteger(index) || index < 0 || index >= options.length)
+        throw new Error('Invalid selection.');
+    return index;
+}
+export function nodeCliIo() {
+    return {
+        stdout: (text) => process.stdout.write(text),
+        stderr: (text) => process.stderr.write(text),
+        env: process.env,
+        cwd: process.cwd(),
+        fetch: (...args) => fetch(...args),
+        readFile: (path) => readFile(path, 'utf8').then((t) => t, () => undefined),
+        select: (prompt, options) => {
+            let readline;
+            return selectOption(prompt, options, {
+                interactive: Boolean(process.stdin.isTTY),
+                write: (text) => process.stderr.write(text),
+                question: async (text) => {
+                    readline = createInterface({ input: process.stdin, output: process.stderr });
+                    return readline.question(text);
+                },
+            }).finally(() => readline?.close());
+        },
+        openUrl: openInBrowser,
+        installProcessHandlers: processHandlersFor(process, process.stderr.write.bind(process.stderr), process.exit.bind(process)),
+        waitForShutdown: (onStop) => new Promise((resolve) => {
+            const stop = () => {
+                process.off('SIGINT', stop);
+                process.off('SIGTERM', stop);
+                void onStop().finally(resolve);
+            };
+            process.on('SIGINT', stop);
+            process.on('SIGTERM', stop);
+            // A daemon whose stdin closes has no controlling client left in the foreground, but that is
+            // not a reason to stop: ownership is explicit (PLAN.md §3.6). Only signals stop us.
+        }),
+    };
+}
+/** Collects output instead of writing it; the tests' view of a command run. */
+export function recordingIo(over = {}) {
+    const out = [];
+    const err = [];
+    return {
+        out,
+        err,
+        stdout: (text) => out.push(text),
+        stderr: (text) => err.push(text),
+        env: {},
+        cwd: process.cwd(),
+        fetch: (...args) => fetch(...args),
+        readFile: (path) => readFile(path, 'utf8').then((t) => t, () => undefined),
+        select: async () => 0,
+        openUrl: async () => { },
+        waitForShutdown: async (onStop) => {
+            await onStop();
+        },
+        ...over,
+    };
+}
+/** How each platform opens a URL in the default browser. */
+export function browserCommand(platform, url) {
+    if (platform === 'darwin')
+        return ['open', [url]];
+    // `start` treats the first quoted argument as a window title, hence the empty one.
+    if (platform === 'win32')
+        return ['cmd', ['/c', 'start', '""', url]];
+    return ['xdg-open', [url]];
+}
+export function openInBrowser(url, platform = process.platform, spawner = spawnDetached) {
+    const [command, args] = browserCommand(platform, url);
+    return spawner(command, args);
+}
+/** Start a program and let it go; a missing program is not an error, the URL was printed anyway. */
+export function spawnDetached(command, args) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, { stdio: 'ignore', detached: true });
+        child.once('error', () => resolve());
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=io.js.map

package/dist/cli/io.js.map

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

package/dist/cli/launch.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `launch <agent>` — start a model in the core and hand the user a coding agent already pointed at
+ * it. Port of `handle_launch` in `src-tauri/src/bin/jan-cli.rs`, with the same flags, the same
+ * refusals and the same run modes.
+ *
+ * The one behavioural difference, stated in the help: the model lives in the core, not in this
+ * process. A terminal agent still owns the session's lifetime — when it exits we unload the model
+ * we loaded — but the core itself stays up, so the next command reuses it.
+ */
+import { detectAgents } from '../integrations/index.js';
+import type { Agent } from '../integrations/index.js';
+import type { CliIo } from './io.js';
+export declare const DEFAULT_LAUNCH_PORT = 6767;
+export declare const DEFAULT_LAUNCH_CTX_SIZE = 32768;
+export declare const DEFAULT_LAUNCH_API_KEY = "atomic";
+export interface LaunchDeps {
+    /** Write the agent's config files. Injected so tests never touch a real home directory. */
+    configure?: ((agent: Agent, apiUrl: string, model: string, apiKey: string) => Promise<void>) | undefined;
+    /** Run the agent; resolves with its exit code. Injected in tests. */
+    run?: ((spec: RunSpec) => Promise<number>) | undefined;
+    detect?: typeof detectAgents | undefined;
+}
+export interface RunSpec {
+    program: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    /** GUI launchers return at once, so the caller must keep serving until interrupted. */
+    detached: boolean;
+}
+export declare function launchCommand(argv: string[], io: CliIo, deps?: LaunchDeps): Promise<number>;
+/**
+ * Split our flags from the agent's. Everything before the first positional (the agent name) is
+ * ours; everything after it goes to the agent, except the options we document for `launch` itself.
+ */
+export declare function splitAgentArgs(argv: string[]): {
+    own: string[];
+    forwarded: string[];
+};
+/**
+ * The child's environment: ambient provider credentials removed (they would override the config we
+ * just wrote and quietly send traffic to a cloud provider), then the variables the env-configured
+ * agents read.
+ */
+export declare function agentEnvironment(base: NodeJS.ProcessEnv, agent: Agent, apiUrl: string, model: string, apiKey: string): NodeJS.ProcessEnv;
+export declare function runAgent(spec: RunSpec): Promise<number>;
+export declare function runCommand(program: string, args: string[]): Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;