@atomic-chat/core 0.5.1

package/dist/cli/commands/daemon.js

@@ -0,0 +1,88 @@
+/** `daemon` — run this process as the owner of a data folder. */
+import { homedir } from 'node:os';
+import { parseArgs } from 'node:util';
+import { AtomicCore } from '../../core/index.js';
+import { breadcrumbLogger, captureReport, createCoreReporter, parseTelemetryFlag, processFailureReport, } from '../../telemetry/index.js';
+import { CORE_VERSION } from '../../version.js';
+import { layoutFor, pathValue } from './shared.js';
+import { printFirstRunNotice } from './telemetry.js';
+/** `daemon` — become the owner and stay up until something asks us to stop. */
+export async function daemonCommand(argv, io) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            'data-folder': { type: 'string' },
+            'control-port': { type: 'string' },
+            'control-host': { type: 'string' },
+            'public-port': { type: 'string' },
+            'public-host': { type: 'string' },
+            'api-key': { type: 'string' },
+            'resources-dir': { type: 'string' },
+            'cloudflared-bin': { type: 'string' },
+            'verbose': { type: 'boolean', short: 'v' },
+            // A host that starts this daemon may pass its user's consent; absent, the core decides itself.
+            'telemetry': { type: 'string' },
+        },
+        strict: true,
+        allowPositionals: false,
+    });
+    const layout = layoutFor(values, io);
+    const resourcesDir = pathValue(values['resources-dir'], io.cwd);
+    const cloudflaredPath = pathValue(values['cloudflared-bin'], io.cwd);
+    const reporter = await createCoreReporter({
+        host: 'cli',
+        ownerScope: 'cli',
+        enabled: parseTelemetryFlag(values['telemetry']),
+        dataFolder: layout.root,
+        telemetryFile: layout.core.telemetry,
+        homeDir: homedir(),
+        env: io.env,
+        platform: process.platform,
+        arch: process.arch,
+        version: CORE_VERSION,
+        warn: (message) => io.stderr(`[warn] ${message}\n`),
+    });
+    await printFirstRunNotice(io, layout.core.telemetry);
+    io.installProcessHandlers?.({ reporter });
+    let core;
+    try {
+        core = await AtomicCore.create({
+            dataFolder: layout.root,
+            ownerScope: 'cli',
+            ...(resourcesDir ? { resourcesDir } : {}),
+            ...(cloudflaredPath ? { cloudflaredPath } : {}),
+            controlPort: values['control-port'] !== undefined ? Number(values['control-port']) : 0,
+            ...(values['control-host'] ? { controlHost: values['control-host'] } : {}),
+            env: io.env,
+            errorReporter: reporter,
+            logger: breadcrumbLogger(reporter, (level, message) => {
+                if (values.verbose || level !== 'info')
+                    io.stderr(`[${level}] ${message}\n`);
+            }),
+        });
+    }
+    catch (error) {
+        captureReport(reporter, processFailureReport('startup', error));
+        await reporter.flush();
+        throw error;
+    }
+    // The first stdout line is the handshake; everything else goes to stderr so it stays parseable.
+    io.stdout(`${JSON.stringify(core.readyLine())}\n`);
+    if (values['public-port'] !== undefined) {
+        await core.startPublicServer({
+            port: Number(values['public-port']),
+            ...(values['public-host'] ? { host: values['public-host'] } : {}),
+            ...(values['api-key'] ? { apiKey: values['api-key'] } : {}),
+        });
+    }
+    // Either a signal reaches us, or something asked the core to stop through the control API.
+    await Promise.race([
+        io.waitForShutdown(async () => {
+            await core.shutdown();
+        }),
+        core.stopped,
+    ]);
+    await reporter.flush();
+    return 0;
+}
+//# sourceMappingURL=daemon.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * The phase-1 commands (PLAN.md §4): `daemon`, `serve`, `models list`, `server status`, `shutdown`.
+ *
+ * Flags, defaults and exit codes follow the Rust `jan-cli` wherever it has an opinion — `serve`
+ * defaults to port 6767, `models list --json` prints the same fields, `server status` exits 1 when
+ * the server is unreachable — because both binaries will be installed side by side during the
+ * migration. The deliberate difference is ownership: `serve` attaches to a core that keeps running
+ * after Ctrl+C instead of owning the model itself, which the help text states outright.
+ */
+export { apiUrl, baseUrl, formatBytes, layoutFor } from './shared.js';
+export { modelsCommand } from './models.js';
+export { daemonCommand } from './daemon.js';
+export { DEFAULT_SERVE_CTX_SIZE, DEFAULT_SERVE_GPU_LAYERS, DEFAULT_SERVE_PORT, DEFAULT_SERVE_TIMEOUT_SECS, serveAttachOptions, serveCommand, } from './serve.js';
+export { serverCommand } from './server.js';
+export { shutdownCommand } from './shutdown.js';
+export { printFirstRunNotice, telemetryCommand } from './telemetry.js';

package/dist/cli/commands/index.js

@@ -0,0 +1,17 @@
+/**
+ * The phase-1 commands (PLAN.md §4): `daemon`, `serve`, `models list`, `server status`, `shutdown`.
+ *
+ * Flags, defaults and exit codes follow the Rust `jan-cli` wherever it has an opinion — `serve`
+ * defaults to port 6767, `models list --json` prints the same fields, `server status` exits 1 when
+ * the server is unreachable — because both binaries will be installed side by side during the
+ * migration. The deliberate difference is ownership: `serve` attaches to a core that keeps running
+ * after Ctrl+C instead of owning the model itself, which the help text states outright.
+ */
+export { apiUrl, baseUrl, formatBytes, layoutFor } from './shared.js';
+export { modelsCommand } from './models.js';
+export { daemonCommand } from './daemon.js';
+export { DEFAULT_SERVE_CTX_SIZE, DEFAULT_SERVE_GPU_LAYERS, DEFAULT_SERVE_PORT, DEFAULT_SERVE_TIMEOUT_SECS, serveAttachOptions, serveCommand, } from './serve.js';
+export { serverCommand } from './server.js';
+export { shutdownCommand } from './shutdown.js';
+export { printFirstRunNotice, telemetryCommand } from './telemetry.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

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

@@ -0,0 +1,4 @@
+/** `models list` — the installed chat models, as a table or as JSON. */
+import type { CliIo } from '../io.js';
+/** `models list` reads the folder directly, exactly as the Rust CLI does — no core needed. */
+export declare function modelsCommand(argv: string[], io: CliIo): Promise<number>;

package/dist/cli/commands/models.js

@@ -0,0 +1,52 @@
+/** `models list` — the installed chat models, as a table or as JSON. */
+import { parseArgs } from 'node:util';
+import { LOCAL_PROVIDER } from '../../core/index.js';
+import { ModelRegistry } from '../../models/index.js';
+import { formatBytes, layoutFor } from './shared.js';
+/** `models list` reads the folder directly, exactly as the Rust CLI does — no core needed. */
+export async function modelsCommand(argv, io) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: { 'json': { type: 'boolean' }, 'data-folder': { type: 'string' } },
+        allowPositionals: true,
+        strict: true,
+    });
+    const sub = positionals[0] ?? 'list';
+    if (sub !== 'list') {
+        io.stderr(`Unknown models subcommand: ${sub}\n`);
+        return 2;
+    }
+    const registry = new ModelRegistry(layoutFor(values, io), LOCAL_PROVIDER);
+    const models = await registry.listChatModels();
+    if (values.json) {
+        io.stdout(`${JSON.stringify(models.map(jsonModel), null, 2)}\n`);
+        return 0;
+    }
+    if (models.length === 0) {
+        io.stderr('No chat models installed.\n\n');
+        io.stderr('  Download one in the Atomic Chat desktop app, or serve a\n');
+        io.stderr('  HuggingFace GGUF repo directly:\n\n');
+        io.stderr('    atomic-chat-cli serve <owner>/<repo>\n');
+        return 0;
+    }
+    const width = Math.max(8, ...models.map((m) => m.id.length));
+    io.stdout(`\n  ${'MODEL ID'.padEnd(width)}  ${'SIZE'.padStart(9)}  CAPABILITIES\n`);
+    for (const model of models) {
+        const size = model.yml.size_bytes ? formatBytes(model.yml.size_bytes) : '-';
+        const caps = model.yml.capabilities?.length ? model.yml.capabilities.join(', ') : '-';
+        io.stdout(`  ${model.id.padEnd(width)}  ${size.padStart(9)}  ${caps}\n`);
+    }
+    io.stdout('\n');
+    return 0;
+}
+function jsonModel(model) {
+    return {
+        id: model.id,
+        name: model.yml.name ?? null,
+        model_path: model.yml.model_path,
+        size_bytes: model.yml.size_bytes ?? 0,
+        capabilities: model.yml.capabilities ?? [],
+        mmproj_path: model.yml.mmproj_path ?? null,
+    };
+}
+//# sourceMappingURL=models.js.map

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

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

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

@@ -0,0 +1,16 @@
+/** `serve <model>` — load a model through the owner and expose it on the public API. */
+import type { DataLayout } from '../../config/index.js';
+import type { CliIo } from '../io.js';
+export declare const DEFAULT_SERVE_PORT = 6767;
+export declare const DEFAULT_SERVE_TIMEOUT_SECS = 120;
+export declare const DEFAULT_SERVE_GPU_LAYERS = -1;
+export declare const DEFAULT_SERVE_CTX_SIZE = 32768;
+/** `serve <model>` — attach (or start a core), load the model, expose it, and report where. */
+export declare function serveCommand(argv: string[], io: CliIo): Promise<number>;
+/** How `serve` reaches its owner: start one when none runs, and say on stderr what went wrong. */
+export declare function serveAttachOptions(layout: DataLayout, io: CliIo): {
+    layout: DataLayout;
+    clientName: string;
+    launch: boolean;
+    log: (message: string) => void;
+};

package/dist/cli/commands/serve.js

@@ -0,0 +1,263 @@
+/** `serve <model>` — load a model through the owner and expose it on the public API. */
+import { parseArgs } from 'node:util';
+import { basename, extname, join } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { APPLE_MODEL_ID, FOUNDATION_MODELS_BINARY, FOUNDATION_MODELS_STARTUP_TIMEOUT_SECS, } from '../../runtime/foundation-models/index.js';
+import { MLX_DEFAULT_TIMEOUT_SECS, MLX_SERVER_BINARY } from '../../runtime/mlx/index.js';
+import { LOCAL_PROVIDER } from '../../core/index.js';
+import { versionBackendFromBinPath } from '../../backend/index.js';
+import { chooseDefaultHfFile, downloadHfModel, fetchHfGgufFiles, hfToken, looksLikeHfRepo, ModelRegistry, } from '../../models/index.js';
+import { withAttachedOwner } from '../owner.js';
+import { apiUrl, formatBytes, layoutFor, pathValue } from './shared.js';
+import { printFirstRunNotice } from './telemetry.js';
+export const DEFAULT_SERVE_PORT = 6767;
+export const DEFAULT_SERVE_TIMEOUT_SECS = 120;
+export const DEFAULT_SERVE_GPU_LAYERS = -1;
+export const DEFAULT_SERVE_CTX_SIZE = 32_768;
+/** `serve <model>` — attach (or start a core), load the model, expose it, and report where. */
+export async function serveCommand(argv, io) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            'data-folder': { type: 'string' },
+            'port': { type: 'string' },
+            'host': { type: 'string' },
+            'api-key': { type: 'string' },
+            'bin': { type: 'string' },
+            'model-path': { type: 'string' },
+            'mmproj': { type: 'string' },
+            'embedding': { type: 'boolean' },
+            'timeout': { type: 'string' },
+            'ctx-size': { type: 'string' },
+            'n-gpu-layers': { type: 'string' },
+            'fit': { type: 'boolean' },
+            'threads': { type: 'string' },
+            'json': { type: 'boolean' },
+            'detach': { type: 'boolean', short: 'd' },
+            'log': { type: 'string' },
+            'verbose': { type: 'boolean', short: 'v' },
+            'select': { type: 'boolean' },
+            'provider': { type: 'string' },
+            'resources-dir': { type: 'string' },
+        },
+        allowPositionals: true,
+        strict: true,
+    });
+    const layout = layoutFor(values, io);
+    await printFirstRunNotice(io, layout.core.telemetry);
+    const provider = serveProvider(values.provider);
+    if (provider === 'mlx' || provider === 'foundation-models')
+        return serveSidecar(provider, values, positionals, layout, io);
+    const registry = new ModelRegistry(layout, LOCAL_PROVIDER);
+    const modelPath = pathValue(values['model-path'], io.cwd);
+    const mmprojPath = pathValue(values.mmproj, io.cwd);
+    const exePath = pathValue(values.bin, io.cwd);
+    let modelId = await resolveServeModelId(positionals[0], modelPath, registry, io);
+    if (!modelPath && !(await registry.find(modelId)) && looksLikeHfRepo(modelId)) {
+        io.stderr(`Fetching GGUF files for ${modelId} from Hugging Face…\n`);
+        const token = hfToken(io.env);
+        const files = await fetchHfGgufFiles(modelId, {
+            fetch: io.fetch,
+            ...(token ? { token } : {}),
+        });
+        const chosen = values.select
+            ? files[await io.select('Select a quantization to download', files.map((file) => `${file.filename}  ${formatBytes(file.size)}`))]
+            : chooseDefaultHfFile(files);
+        if (!chosen)
+            throw new Error('No Hugging Face file was selected.');
+        io.stderr(`Downloading ${chosen.filename} (${formatBytes(chosen.size)})…\n`);
+        modelId = await downloadHfModel({
+            layout,
+            registry,
+            repoId: modelId,
+            file: chosen,
+            fetch: io.fetch,
+            env: io.env,
+            emit: (name, payload) => {
+                if (name === 'download:progress' && payload.percent === 100)
+                    io.stderr(`Downloaded ${modelId}.\n`);
+            },
+        });
+    }
+    const port = integerOption(values.port, DEFAULT_SERVE_PORT, '--port', 0, 65_535);
+    const timeoutSecs = integerOption(values.timeout, DEFAULT_SERVE_TIMEOUT_SECS, '--timeout', 1, Number.MAX_SAFE_INTEGER);
+    const gpuLayers = integerOption(values['n-gpu-layers'], DEFAULT_SERVE_GPU_LAYERS, '--n-gpu-layers', -1, Number.MAX_SAFE_INTEGER);
+    const ctxSize = values.fit
+        ? 0
+        : integerOption(values['ctx-size'], DEFAULT_SERVE_CTX_SIZE, '--ctx-size', 0, Number.MAX_SAFE_INTEGER);
+    const threads = integerOption(values.threads, 0, '--threads', 0, Number.MAX_SAFE_INTEGER);
+    const logPath = values.log
+        ? pathValue(values.log, io.cwd)
+        : values.detach
+            ? join(layout.core.logsDir, 'serve.log')
+            : undefined;
+    return withAttachedOwner(serveAttachOptions(layout, io), async ({ client }) => {
+        const overrides = {
+            ctx_size: ctxSize,
+            n_gpu_layers: gpuLayers,
+            fit: values.fit === true,
+            threads,
+            timeout: timeoutSecs,
+        };
+        const verbose = values.verbose === true;
+        const eventAbort = new AbortController();
+        const eventReady = verbose ? subscribeToLogs(client, io, eventAbort.signal) : undefined;
+        if (eventReady)
+            await eventReady;
+        let session;
+        let state;
+        try {
+            // Claim/validate the public configuration before auto-unload can mutate sessions. An
+            // incompatible running listener must reject this command while its current model stays live.
+            state = await client.startServer({
+                port,
+                ...(values.host ? { host: values.host } : {}),
+                ...(values['api-key'] ? { api_key: values['api-key'] } : {}),
+            });
+            session = await client.loadModel(LOCAL_PROVIDER, modelId, {
+                isEmbedding: values.embedding === true,
+                ...(exePath
+                    ? { exePath, versionBackend: versionBackendFromBinPath(exePath) ?? 'cli/llama-server' }
+                    : {}),
+                ...(modelPath ? { modelPath } : {}),
+                ...(mmprojPath ? { mmprojPath } : {}),
+                timeoutSecs,
+                ...(logPath ? { logPath } : {}),
+                verbose,
+                overrides,
+            });
+        }
+        finally {
+            eventAbort.abort();
+        }
+        if (values.json) {
+            io.stdout(`${JSON.stringify({ session, server: state }, null, 2)}\n`);
+        }
+        else {
+            io.stdout(`\n  ${modelId} is serving at ${apiUrl(state)}\n`);
+            io.stdout(`  model process pid ${session.pid}, port ${session.port}\n`);
+            if (state.requires_api_key)
+                io.stdout('  clients must send the API key you configured\n');
+            io.stdout('\n  The core keeps running after this command exits; stop it with `shutdown`.\n\n');
+        }
+        return 0;
+    });
+}
+const SERVE_PROVIDERS = ['llamacpp-upstream', 'mlx', 'foundation-models'];
+function serveProvider(value) {
+    if (value === undefined)
+        return LOCAL_PROVIDER;
+    if (SERVE_PROVIDERS.includes(value))
+        return value;
+    throw new AtomicCoreError('INVALID_ARGUMENT', `--provider must be one of: ${SERVE_PROVIDERS.join(', ')}.`, String(value));
+}
+const SIDECARS = {
+    'mlx': { binary: MLX_SERVER_BINARY, name: 'MLX', timeoutSecs: MLX_DEFAULT_TIMEOUT_SECS },
+    'foundation-models': {
+        binary: FOUNDATION_MODELS_BINARY,
+        name: 'Foundation Models',
+        timeoutSecs: FOUNDATION_MODELS_STARTUP_TIMEOUT_SECS,
+    },
+};
+/**
+ * `serve --provider mlx|foundation-models`. Both servers ship with the desktop app, not with the
+ * CLI, so a standalone CLI must be told where they are. MLX models are the ones the app installed
+ * under `mlx/models`; Foundation Models has the one on-device model.
+ */
+async function serveSidecar(provider, values, positionals, layout, io) {
+    const sidecar = SIDECARS[provider];
+    const modelId = provider === 'foundation-models'
+        ? positionals[0]?.trim() || APPLE_MODEL_ID
+        : await resolveServeModelId(positionals[0], undefined, new ModelRegistry(layout, 'mlx'), io);
+    const resourcesDir = pathValue(values['resources-dir'], io.cwd);
+    const exePath = pathValue(values['bin'], io.cwd) ?? (resourcesDir ? join(resourcesDir, sidecar.binary) : undefined);
+    if (!exePath)
+        throw new AtomicCoreError('INVALID_ARGUMENT', `${sidecar.name} needs --resources-dir <folder with ${sidecar.binary}> or --bin <server>.`);
+    const port = integerOption(values['port'], DEFAULT_SERVE_PORT, '--port', 0, 65_535);
+    const timeoutSecs = integerOption(values['timeout'], sidecar.timeoutSecs, '--timeout', 1, Number.MAX_SAFE_INTEGER);
+    const ctxSize = values['ctx-size'] !== undefined
+        ? integerOption(values['ctx-size'], 0, '--ctx-size', 1, Number.MAX_SAFE_INTEGER)
+        : undefined;
+    const logPath = values['log'] ? pathValue(values['log'], io.cwd) : undefined;
+    return withAttachedOwner(serveAttachOptions(layout, io), async ({ client }) => {
+        const state = await client.startServer({
+            port,
+            ...(typeof values['host'] === 'string' ? { host: values['host'] } : {}),
+            ...(typeof values['api-key'] === 'string' ? { api_key: values['api-key'] } : {}),
+        });
+        const session = await client.loadModel(provider, modelId, {
+            exePath,
+            timeoutSecs,
+            isEmbedding: values['embedding'] === true,
+            ...(ctxSize !== undefined ? { overrides: { ctx_size: ctxSize } } : {}),
+            ...(logPath ? { logPath } : {}),
+            verbose: values['verbose'] === true,
+        });
+        if (values['json'])
+            io.stdout(`${JSON.stringify({ session, server: state }, null, 2)}\n`);
+        else if (provider === 'mlx') {
+            io.stdout(`\n  ${modelId} is serving at ${apiUrl(state)}\n`);
+            io.stdout(`  model process pid ${session.pid}, port ${session.port}\n\n`);
+        }
+        else {
+            io.stdout(`\n  ${modelId} is running on port ${session.port} (pid ${session.pid})\n`);
+            io.stdout('  The public API does not route to Foundation Models; talk to that port directly.\n\n');
+        }
+        return 0;
+    });
+}
+/** How `serve` reaches its owner: start one when none runs, and say on stderr what went wrong. */
+export function serveAttachOptions(layout, io) {
+    return {
+        layout,
+        clientName: 'atomic-chat-core serve',
+        launch: true,
+        log: (message) => io.stderr(`${message}\n`),
+    };
+}
+async function resolveServeModelId(positional, modelPath, registry, io) {
+    if (positional?.trim())
+        return positional.trim();
+    if (modelPath)
+        return basename(modelPath, extname(modelPath)) || 'model';
+    const models = await registry.listChatModels();
+    if (models.length === 0) {
+        throw new Error('No chat models are installed. Pass --model-path or a Hugging Face owner/repository id.');
+    }
+    if (models.length === 1) {
+        io.stderr(`Using model ${models[0]?.id}.\n`);
+        return models[0]?.id;
+    }
+    const index = await io.select('Choose a model', models.map((model) => `${model.id}  ${formatBytes(model.yml.size_bytes)}`));
+    return models[index].id;
+}
+function integerOption(value, fallback, name, min, max) {
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < min || parsed > max)
+        throw new Error(`${name} must be an integer between ${min} and ${max}.`);
+    return parsed;
+}
+async function subscribeToLogs(client, io, signal) {
+    let resolveOpen;
+    let rejectOpen;
+    const opened = new Promise((resolve, reject) => {
+        resolveOpen = resolve;
+        rejectOpen = reject;
+    });
+    void client
+        .events((message) => {
+        if (message.event !== 'core:log')
+            return;
+        const payload = message.data;
+        if (typeof payload.msg === 'string')
+            io.stderr(`${payload.msg}\n`);
+    }, { signal, onOpen: () => resolveOpen?.() })
+        .catch((error) => {
+        if (!signal.aborted)
+            rejectOpen?.(error);
+    });
+    return opened;
+}
+//# sourceMappingURL=serve.js.map

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

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

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

@@ -0,0 +1,4 @@
+/** `server status` — probe the local API server and list what it serves. */
+import type { CliIo } from '../io.js';
+/** `server status` — is a local API server reachable, and what does it serve? */
+export declare function serverCommand(argv: string[], io: CliIo): Promise<number>;

package/dist/cli/commands/server.js

@@ -0,0 +1,126 @@
+/** `server status` — probe the local API server and list what it serves. */
+import { parseArgs } from 'node:util';
+import { withAttachedOwner } from '../owner.js';
+import { apiUrl, baseUrl, layoutFor } from './shared.js';
+/** `server status` — is a local API server reachable, and what does it serve? */
+export async function serverCommand(argv, io) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            'data-folder': { type: 'string' },
+            'host': { type: 'string' },
+            'port': { type: 'string' },
+            'prefix': { type: 'string' },
+            'api-key': { type: 'string' },
+            'json': { type: 'boolean' },
+        },
+        allowPositionals: true,
+        strict: true,
+    });
+    const sub = positionals[0] ?? 'status';
+    if (sub !== 'status') {
+        io.stderr(`Unknown server subcommand: ${sub}\n`);
+        return 2;
+    }
+    const layout = layoutFor(values, io);
+    const state = await readServerState(layout, values, io);
+    const apiKey = values['api-key'] ?? io.env['ATOMIC_API_KEY'] ?? '';
+    const reachable = await probe(state, io);
+    const models = reachable ? await fetchModels(state, apiKey, io) : { error: 'server not reachable' };
+    if (values.json) {
+        io.stdout(`${JSON.stringify({
+            running: reachable,
+            url: apiUrl(state),
+            host: state.host,
+            port: state.port,
+            prefix: state.prefix,
+            requires_api_key: state.requires_api_key,
+            models: 'models' in models ? models.models : null,
+            models_error: 'error' in models ? models.error : null,
+        }, null, 2)}\n`);
+    }
+    else if (reachable) {
+        io.stdout(`\n  ● Local API Server is running\n`);
+        io.stdout(`  Endpoint  ${apiUrl(state)}\n`);
+        if ('models' in models)
+            io.stdout(`  Models    ${models.models.length ? models.models.join(', ') : 'none loaded'}\n`);
+        else
+            io.stdout(`  Models    ${models.error}\n`);
+        io.stdout('\n');
+    }
+    else {
+        io.stdout(`\n  ○ No Local API Server at ${apiUrl(state)}\n\n`);
+    }
+    return reachable ? 0 : 1;
+}
+async function readServerState(layout, values, io) {
+    // Prefer the running core's own state; fall back to the app's state file, then to defaults.
+    let state = {
+        running: false,
+        host: '127.0.0.1',
+        port: 1337,
+        prefix: '/v1',
+        requires_api_key: false,
+        pid: null,
+    };
+    try {
+        state = await withAttachedOwner({ layout, clientName: 'atomic-chat-core server status' }, ({ client }) => client.serverStatus());
+    }
+    catch {
+        // A crashed core can leave a stale discovery file beside a live legacy app state. Parse both
+        // and prefer the first endpoint that actually answers instead of letting file age decide.
+        const candidates = [];
+        for (const fromFile of [
+            await io.readFile(layout.core.publicServerState),
+            await io.readFile(layout.serverStateFile),
+        ]) {
+            if (!fromFile)
+                continue;
+            try {
+                const parsed = JSON.parse(fromFile);
+                if (typeof parsed.port === 'number' && typeof parsed.host === 'string')
+                    candidates.push({ ...state, ...parsed, pid: parsed.pid ?? null });
+            }
+            catch {
+                /* a malformed state file means "unknown", not "crash" */
+            }
+        }
+        state = candidates[0] ?? state;
+        for (const candidate of candidates) {
+            if (await probe(candidate, io)) {
+                state = candidate;
+                break;
+            }
+        }
+    }
+    if (typeof values['host'] === 'string')
+        state.host = values['host'];
+    if (values['port'] !== undefined)
+        state.port = Number(values['port']);
+    if (typeof values['prefix'] === 'string')
+        state.prefix = values['prefix'];
+    return state;
+}
+async function probe(state, io) {
+    const res = await io
+        .fetch(`${baseUrl(state)}/`, { signal: AbortSignal.timeout(3000) })
+        .catch(() => undefined);
+    return res !== undefined && res.ok;
+}
+async function fetchModels(state, apiKey, io) {
+    const res = await io
+        .fetch(`${apiUrl(state)}/models`, {
+        headers: apiKey ? { authorization: `Bearer ${apiKey}` } : {},
+        signal: AbortSignal.timeout(5000),
+    })
+        .catch((e) => e);
+    if (res instanceof Error)
+        return { error: res.message };
+    if (res.status === 401)
+        return { error: 'server requires an API key — pass --api-key or set ATOMIC_API_KEY' };
+    if (!res.ok)
+        return { error: `server returned ${res.status}` };
+    const body = (await res.json().catch(() => ({})));
+    return { models: (body.data ?? []).map((m) => String(m.id ?? '')).filter(Boolean) };
+}
+//# sourceMappingURL=server.js.map