@atomic-chat/core 0.5.1

package/dist/cli/launch.js

@@ -0,0 +1,327 @@
+/**
+ * `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 { execFile, spawn } from 'node:child_process';
+import { parseArgs } from 'node:util';
+import { AtomicCoreError } from '../contracts/index.js';
+import { LOCAL_PROVIDER } from '../core/index.js';
+import { configureAgent } from '../integrations/configure/index.js';
+import { AGENTS, apiUrlFor, childEnv, CONFLICTING_PROVIDER_ENV, detectAgents, findAgent, MUSE_CLI_REFUSAL, } from '../integrations/index.js';
+import { ModelRegistry } from '../models/index.js';
+import { layoutFor, printFirstRunNotice } from './commands/index.js';
+import { withAttachedOwner } from './owner.js';
+export const DEFAULT_LAUNCH_PORT = 6767;
+export const DEFAULT_LAUNCH_CTX_SIZE = 32_768;
+export const DEFAULT_LAUNCH_API_KEY = 'atomic';
+export async function launchCommand(argv, io, deps = {}) {
+    // Everything after the agent name belongs to the agent, including flags this CLI does not know:
+    // `launch goose --debug` must reach Goose, not fail our own parser (Rust uses `trailing_var_arg`).
+    const { own, forwarded } = splitAgentArgs(argv);
+    const { values, positionals } = parseArgs({
+        args: own,
+        options: {
+            'data-folder': { type: 'string' },
+            'model': { type: 'string' },
+            'bin': { type: 'string' },
+            'port': { type: 'string' },
+            'host': { type: 'string' },
+            'api-key': { type: 'string' },
+            'n-gpu-layers': { type: 'string' },
+            'ctx-size': { type: 'string' },
+            'fit': { type: 'boolean' },
+            'no-fit': { type: 'boolean' },
+            'list': { type: 'boolean' },
+            'json': { type: 'boolean' },
+            'verbose': { type: 'boolean', short: 'v' },
+            'standalone': { type: 'boolean' },
+        },
+        allowPositionals: true,
+        strict: true,
+    });
+    const detect = deps.detect ?? detectAgents;
+    if (values.list)
+        return listAgents(io, values.json === true, detect);
+    const requested = positionals[0];
+    const agentArgs = [...positionals.slice(1), ...forwarded];
+    const agent = requested ? findAgent(requested) : await pickAgent(io, detect);
+    if (!agent) {
+        io.stderr(`Error: unknown agent '${requested}'.\n\n`);
+        await listAgents(io, false, detect);
+        return 1;
+    }
+    if (agent.id === 'muse') {
+        io.stderr(`Error: ${agent.name} cannot be launched from the CLI.\n\n`);
+        for (const line of MUSE_CLI_REFUSAL)
+            io.stderr(`  ${line}\n`);
+        return 1;
+    }
+    const detections = await detect([agent], { env: io.env });
+    const detection = detections.get(agent.id);
+    if (!detection.installed) {
+        io.stderr(`Error: ${agent.name} is not installed.\n\n`);
+        io.stderr('  Install it first — the Atomic Chat desktop app can do this\n');
+        io.stderr('  for you from the Launch page, or see:\n\n');
+        io.stderr(`    ${agent.docsUrl}\n`);
+        return 1;
+    }
+    const layout = layoutFor(values, io);
+    await printFirstRunNotice(io, layout.core.telemetry);
+    if (values.standalone && values['data-folder'] === undefined) {
+        throw new AtomicCoreError('INVALID_ARGUMENT', '--standalone requires an explicit --data-folder.', 'use a separate folder so the foreground owner cannot collide with the app');
+    }
+    const modelId = values.model ?? (await pickModel(layout, io));
+    const apiKey = values['api-key'] ?? DEFAULT_LAUNCH_API_KEY;
+    // `--fit` defaults to on for Claude Code, but only when `--ctx-size` was not given: an explicit
+    // context size means the user wants exactly that, and fit would override it.
+    const ctxGiven = values['ctx-size'] !== undefined;
+    const fit = values['no-fit'] ? false : (values.fit ?? (agent.id === 'claude-code' && !ctxGiven));
+    const overrides = {
+        ctx_size: ctxGiven ? Number(values['ctx-size']) : DEFAULT_LAUNCH_CTX_SIZE,
+        fit,
+    };
+    if (values['n-gpu-layers'] !== undefined)
+        overrides['n_gpu_layers'] = Number(values['n-gpu-layers']);
+    const standaloneCore = values.standalone
+        ? await (await import('../core/index.js')).AtomicCore.create({
+            dataFolder: layout.root,
+            controlPort: 0,
+            env: io.env,
+            telemetry: { host: 'cli' },
+        })
+        : undefined;
+    const execute = async (client) => {
+        let created = false;
+        try {
+            // Validate/claim the public listener before a model load can auto-unload another session.
+            const server = standaloneCore
+                ? await standaloneCore.startPublicServer({
+                    port: values.port !== undefined ? Number(values.port) : DEFAULT_LAUNCH_PORT,
+                    ...(values.host ? { host: values.host } : {}),
+                    apiKey,
+                })
+                : await client.startServer({
+                    port: values.port !== undefined ? Number(values.port) : DEFAULT_LAUNCH_PORT,
+                    ...(values.host ? { host: values.host } : {}),
+                    api_key: apiKey,
+                });
+            const acquired = standaloneCore
+                ? await standaloneCore.acquire(LOCAL_PROVIDER, modelId, {
+                    overrides,
+                    ...(values.bin ? { exePath: values.bin } : {}),
+                })
+                : await client.acquireModel(LOCAL_PROVIDER, modelId, {
+                    overrides,
+                    ...(values.bin ? { exePath: values.bin } : {}),
+                });
+            const session = acquired.session;
+            created = acquired.created;
+            const baseUrl = `http://${server.host === '0.0.0.0' ? '127.0.0.1' : server.host}:${server.port}`;
+            const apiUrl = apiUrlFor(agent, baseUrl, server.prefix);
+            const configure = deps.configure ??
+                ((a, u, m, k) => configureAgent(a, u, m, k, {
+                    env: io.env,
+                    spawn: runCommand,
+                }));
+            try {
+                await configure(agent, apiUrl, modelId, apiKey);
+            }
+            catch (e) {
+                throw new AtomicCoreError('IO_ERROR', `Could not configure ${agent.name}.`, e instanceof Error ? e.message : String(e));
+            }
+            io.stderr(`\n  Agent     ${agent.name}\n`);
+            io.stderr(`  Endpoint  ${apiUrl}\n`);
+            io.stderr(`  Model     ${modelId}\n`);
+            io.stderr(`  Session   pid ${session.pid}, port ${session.port}\n\n`);
+            const args = [...agent.runArgs, ...agentArgs];
+            const env = agentEnvironment(io.env, agent, apiUrl, modelId, apiKey);
+            const run = deps.run ?? runAgent;
+            if (agent.runMode === 'gui') {
+                await run({ program: detection.program, args, env, detached: true });
+                io.stderr(`  ${agent.name} opened. The model stays loaded until you press Ctrl+C.\n\n`);
+                await io.waitForShutdown(async () => { });
+                return 0;
+            }
+            io.stderr(`  → Launching: ${[detection.program, ...args].join(' ')}\n\n`);
+            return await run({ program: detection.program, args, env, detached: false });
+        }
+        catch (e) {
+            throw e instanceof AtomicCoreError
+                ? e
+                : new AtomicCoreError('IO_ERROR', `Could not launch ${agent.name}.`, e instanceof Error ? e.message : String(e));
+        }
+        finally {
+            if (created) {
+                if (standaloneCore)
+                    await standaloneCore.unload(LOCAL_PROVIDER, modelId).catch(() => { });
+                else
+                    await client?.unloadModel(LOCAL_PROVIDER, modelId).catch(() => { });
+            }
+            await standaloneCore?.shutdown().catch(() => { });
+        }
+    };
+    if (standaloneCore)
+        return execute();
+    return withAttachedOwner({
+        layout,
+        clientName: `atomic-chat-core launch ${agent.id}`,
+        launch: true,
+        log: (message) => io.stderr(`${message}\n`),
+    }, ({ client }) => execute(client));
+}
+/**
+ * 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 function splitAgentArgs(argv) {
+    const OURS = new Set([
+        '--data-folder',
+        '--model',
+        '--bin',
+        '--port',
+        '--host',
+        '--api-key',
+        '--n-gpu-layers',
+        '--ctx-size',
+    ]);
+    const FLAGS = new Set(['--fit', '--no-fit', '--standalone', '--list', '--json', '--verbose', '-v']);
+    const own = [];
+    const forwarded = [];
+    let seenAgent = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--') {
+            forwarded.push(...argv.slice(i + 1));
+            break;
+        }
+        if (OURS.has(arg)) {
+            own.push(arg, argv[i + 1] ?? '');
+            i++;
+            continue;
+        }
+        if (arg.startsWith('--fit=')) {
+            own.push(arg === '--fit=false' ? '--no-fit' : '--fit');
+            continue;
+        }
+        if (FLAGS.has(arg) || arg.startsWith('--data-folder=') || (!seenAgent && arg.startsWith('-'))) {
+            own.push(arg);
+            continue;
+        }
+        if (!seenAgent && !arg.startsWith('-')) {
+            own.push(arg);
+            seenAgent = true;
+            continue;
+        }
+        forwarded.push(arg);
+    }
+    return { own, forwarded };
+}
+async function listAgents(io, json, detect) {
+    const detections = await detect(AGENTS, { env: io.env });
+    if (json) {
+        io.stdout(`${JSON.stringify(AGENTS.map((agent) => ({
+            id: agent.id,
+            name: agent.name,
+            bin: agent.detectBin,
+            aliases: agent.aliases,
+            installed: detections.get(agent.id)?.installed ?? false,
+            path: detections.get(agent.id)?.path ?? null,
+            requires_model: agent.requiresModel,
+            endpoint_with_prefix: agent.endpointWithPrefix,
+            run_mode: agent.runMode,
+            run_args: agent.runArgs,
+            docs_url: agent.docsUrl,
+        })), null, 2)}\n`);
+        return 0;
+    }
+    io.stdout('Agents this CLI can configure:\n\n');
+    const width = Math.max(...AGENTS.map((a) => a.id.length), 12);
+    for (const agent of AGENTS) {
+        const mark = detections.get(agent.id)?.installed ? '●' : '○';
+        io.stdout(`  ${mark} ${agent.id.padEnd(width)} ${agent.docsUrl}\n`);
+    }
+    io.stdout('\n  ● installed   ○ not found on PATH\n');
+    return 0;
+}
+async function pickAgent(io, detect) {
+    const detections = await detect(AGENTS, { env: io.env });
+    const installed = AGENTS.filter((a) => detections.get(a.id)?.installed && a.id !== 'muse');
+    if (installed.length === 0) {
+        throw new AtomicCoreError('MODEL_NOT_FOUND', 'No supported coding agent is installed.', 'install one from the Launch page in Atomic Chat, or run `launch --list`');
+    }
+    const index = await io.select('Which agent should be launched?', installed.map((a) => a.name));
+    return installed[index];
+}
+async function pickModel(layout, io) {
+    const models = await new ModelRegistry(layout, LOCAL_PROVIDER).listChatModels();
+    if (models.length === 0) {
+        throw new AtomicCoreError('MODEL_NOT_FOUND', 'No chat models are installed.', 'download one in Atomic Chat, or pass --model');
+    }
+    if (models.length === 1)
+        return models[0].id;
+    const index = await io.select('Which model should be served?', models.map((m) => m.id));
+    return models[index].id;
+}
+/**
+ * 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 function agentEnvironment(base, agent, apiUrl, model, apiKey) {
+    const env = { ...base };
+    for (const name of CONFLICTING_PROVIDER_ENV)
+        delete env[name];
+    return { ...env, ...childEnv(agent, apiUrl, model, apiKey) };
+}
+export function runAgent(spec) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(spec.program, spec.args, {
+            env: spec.env,
+            stdio: spec.detached ? 'ignore' : 'inherit',
+            detached: spec.detached,
+            windowsHide: true,
+        });
+        let settled = false;
+        child.once('error', (e) => {
+            if (!settled)
+                reject(new AtomicCoreError('IO_ERROR', `Could not launch '${spec.program}'.`, e.message));
+        });
+        if (spec.detached) {
+            child.unref();
+            // Give a launcher that fails immediately a chance to report before we call it a success.
+            child.once('exit', (code, signal) => {
+                if (!settled) {
+                    settled = true;
+                    if (code === 0 && !signal)
+                        resolve(0);
+                    else
+                        reject(new AtomicCoreError('IO_ERROR', `'${spec.program}' exited before its window opened.`, `exit ${code ?? signal ?? '?'}`));
+                }
+            });
+            setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    resolve(0);
+                }
+            }, 250).unref();
+            return;
+        }
+        child.once('exit', (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+    });
+}
+export function runCommand(program, args) {
+    return new Promise((resolve, reject) => {
+        execFile(program, args, { windowsHide: true }, (error, stdout, stderr) => {
+            if (error && typeof error.code !== 'number')
+                reject(error);
+            else
+                resolve({ code: typeof error?.code === 'number' ? error.code : 0, stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=launch.js.map

package/dist/cli/launch.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CLI dispatcher. `bin.ts` is the only file with side effects; everything here takes a `CliIo`, so
+ * a test can run a command and read what it printed without spawning a process.
+ *
+ * Phase 1 ships `daemon`, `serve`, `models`, `server` and `shutdown` (PLAN.md §4); `launch` and the
+ * rest land with their phases.
+ */
+import type { CliIo } from './io.js';
+export declare const USAGE = "atomic-chat-core 0.5.1\n\nUsage: atomic-chat-core <command> [options]\n\nCommands:\n  serve <model>   Load a model in the core and expose it over an OpenAI-compatible API\n  models list     List the chat models installed in the CLI data folder\n  server status   Report whether a local API server is reachable\n  daemon          Run the core that owns this data folder (started for you by other commands)\n  shutdown        Stop the core that owns this data folder\n  launch <agent>  Start a model and launch a coding agent already wired to it\n  providers       List, register or remove cloud providers the API server routes to\n  auth chatgpt    Connect, inspect or disconnect a ChatGPT subscription\n  telemetry       Show, or turn on or off, the core's anonymous crash and error reports\n\nCommon options:\n  --data-folder <path>   Data folder to work with (default: <system data>/atomic-chat-cli/data)\n  -h, --help             Show this help\n  -v, --version          Print the version\n\nServe compatibility options:\n  --model-path <gguf>    Serve a GGUF directly; model id defaults to its filename\n  --provider <id>        llamacpp-upstream (default), mlx or foundation-models\n  --resources-dir <dir>  Folder with the desktop app's sidecar servers (mlx-server, foundation-models-server)\n  --bin <path>           Use this llama-server (or sidecar server) executable\n  --port <port>          Public OpenAI API port (default: 6767; 0 = random)\n  --mmproj <path>        Vision projector path\n  --embedding            Start in embedding mode\n  --timeout <seconds>    Readiness timeout (default: 120)\n  --n-gpu-layers <n>     GPU layers (-1 = all; default: -1)\n  --ctx-size <tokens>    Context size (default: 32768)\n  --fit                  Let llama.cpp choose context size for available memory\n  --threads <n>          CPU inference threads (0 = auto)\n  --api-key <key>        Require this key on the public API\n  --standalone           Run a foreground owner in an explicit, separate --data-folder\n  -d, --detach           Compatibility flag; the persistent owner is already detached\n  --log <path>           Append llama.cpp stdout/stderr to a file\n  -v, --verbose          Relay llama.cpp output while the model loads\n  --select               Pick a GGUF when downloading owner/repository from Hugging Face\n  --json                 Print the result as JSON\n\nNotes:\n  The core keeps running when a command exits, so a model stays loaded between commands and\n  Ctrl+C detaches instead of unloading. Stop it explicitly with `atomic-chat-core shutdown`.\n";
+export declare function runCli(argv: string[], io: CliIo): Promise<number>;

package/dist/cli/main.js

@@ -0,0 +1,109 @@
+/**
+ * CLI dispatcher. `bin.ts` is the only file with side effects; everything here takes a `CliIo`, so
+ * a test can run a command and read what it printed without spawning a process.
+ *
+ * Phase 1 ships `daemon`, `serve`, `models`, `server` and `shutdown` (PLAN.md §4); `launch` and the
+ * rest land with their phases.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import { CORE_VERSION } from '../version.js';
+import { daemonCommand, modelsCommand, serveCommand, serverCommand, shutdownCommand, telemetryCommand, } from './commands/index.js';
+import { launchCommand } from './launch.js';
+import { authCommand, providersCommand } from './cloud.js';
+export const USAGE = `atomic-chat-core ${CORE_VERSION}
+
+Usage: atomic-chat-core <command> [options]
+
+Commands:
+  serve <model>   Load a model in the core and expose it over an OpenAI-compatible API
+  models list     List the chat models installed in the CLI data folder
+  server status   Report whether a local API server is reachable
+  daemon          Run the core that owns this data folder (started for you by other commands)
+  shutdown        Stop the core that owns this data folder
+  launch <agent>  Start a model and launch a coding agent already wired to it
+  providers       List, register or remove cloud providers the API server routes to
+  auth chatgpt    Connect, inspect or disconnect a ChatGPT subscription
+  telemetry       Show, or turn on or off, the core's anonymous crash and error reports
+
+Common options:
+  --data-folder <path>   Data folder to work with (default: <system data>/atomic-chat-cli/data)
+  -h, --help             Show this help
+  -v, --version          Print the version
+
+Serve compatibility options:
+  --model-path <gguf>    Serve a GGUF directly; model id defaults to its filename
+  --provider <id>        llamacpp-upstream (default), mlx or foundation-models
+  --resources-dir <dir>  Folder with the desktop app's sidecar servers (mlx-server, foundation-models-server)
+  --bin <path>           Use this llama-server (or sidecar server) executable
+  --port <port>          Public OpenAI API port (default: 6767; 0 = random)
+  --mmproj <path>        Vision projector path
+  --embedding            Start in embedding mode
+  --timeout <seconds>    Readiness timeout (default: 120)
+  --n-gpu-layers <n>     GPU layers (-1 = all; default: -1)
+  --ctx-size <tokens>    Context size (default: 32768)
+  --fit                  Let llama.cpp choose context size for available memory
+  --threads <n>          CPU inference threads (0 = auto)
+  --api-key <key>        Require this key on the public API
+  --standalone           Run a foreground owner in an explicit, separate --data-folder
+  -d, --detach           Compatibility flag; the persistent owner is already detached
+  --log <path>           Append llama.cpp stdout/stderr to a file
+  -v, --verbose          Relay llama.cpp output while the model loads
+  --select               Pick a GGUF when downloading owner/repository from Hugging Face
+  --json                 Print the result as JSON
+
+Notes:
+  The core keeps running when a command exits, so a model stays loaded between commands and
+  Ctrl+C detaches instead of unloading. Stop it explicitly with \`atomic-chat-core shutdown\`.
+`;
+export async function runCli(argv, io) {
+    const command = argv[0];
+    // Parse global flags only before the command. In particular, `serve -v` is verbose backend
+    // output, not the top-level version flag.
+    if (command === '--version' || command === '-v') {
+        io.stdout(`${CORE_VERSION}\n`);
+        return 0;
+    }
+    if (command === '--help' || command === '-h' || !command) {
+        io.stdout(USAGE);
+        return command ? 0 : 2;
+    }
+    const rest = argv.slice(1);
+    try {
+        switch (command) {
+            case 'daemon':
+                return await daemonCommand(rest, io);
+            case 'serve':
+                return await serveCommand(rest, io);
+            case 'models':
+                return await modelsCommand(rest, io);
+            case 'server':
+                return await serverCommand(rest, io);
+            case 'launch':
+                return await launchCommand(rest, io);
+            case 'shutdown':
+                return await shutdownCommand(rest, io);
+            case 'providers':
+                return await providersCommand(rest, io);
+            case 'auth':
+                return await authCommand(rest, io);
+            case 'telemetry':
+                return await telemetryCommand(rest, io);
+            default:
+                io.stderr(`Unknown command: ${command}\n\n${USAGE}`);
+                return 2;
+        }
+    }
+    catch (e) {
+        io.stderr(`Error: ${describe(e)}\n`);
+        return 1;
+    }
+}
+function describe(error) {
+    if (error instanceof AtomicCoreError) {
+        return `${error.message}${error.details ? `\n  ${error.details}` : ''} [${error.code}]`;
+    }
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/owner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Finding — or starting — the core that owns a data folder (PLAN.md §3.6).
+ *
+ * Every command that needs a running core goes through here: read the lock, attach to a live owner,
+ * and only when there is none, launch `daemon` as an independent process and wait for it to publish
+ * its control port. The launched core does *not* die with us: that is the whole point of the owner
+ * model, and it is why `serve` can be Ctrl+C'd without unloading the model.
+ */
+import { CoreClient } from '../client/index.js';
+import type { DataLayout } from '../config/index.js';
+import type { LockRecord } from '../lock/index.js';
+export declare const DAEMON_START_TIMEOUT_MS = 20000;
+export interface AttachedOwner {
+    client: CoreClient;
+    record: LockRecord;
+    /** True when this process started the core we are now talking to. */
+    launched: boolean;
+}
+export interface AttachOptions {
+    layout: DataLayout;
+    clientName: string;
+    /** Start a core when none is running. */
+    launch?: boolean;
+    /** Argv[0] and any leading arguments needed to re-run this program (compiled binary vs source). */
+    selfCommand?: string[];
+    timeoutMs?: number;
+    log?: (message: string) => void;
+}
+/**
+ * How to re-invoke ourselves. Always through `process.execPath`: inside a compiled Bun binary
+ * `argv[0]` is the literal string `bun`, which is not a program on the user's machine — spawning it
+ * gave `Script not found "daemon"`. Running from source needs the script path as well.
+ */
+export declare function selfCommand(argv?: string[], execPath?: string): string[];
+export declare function attachToOwner(options: AttachOptions): Promise<AttachedOwner>;
+/** A CLI command owns a renewable registration only while it is doing work. */
+export declare function withAttachedOwner<T>(options: AttachOptions & {
+    heartbeatIntervalMs?: number;
+}, work: (owner: AttachedOwner, clientId: string) => Promise<T>): Promise<T>;