@atomic-chat/core 0.5.1

package/dist/config/data-folder.js

@@ -0,0 +1,150 @@
+/**
+ * Data-folder and config-file resolution, following the app exactly
+ * (`src-tauri/src/core/app/{commands,models,constants}.rs`).
+ *
+ * The app keeps a tiny `settings.json` (`{ data_folder, autostart_preference }`) in its config dir
+ * and everything else under `<data_folder>`. Two config dirs exist for historical reasons:
+ * the legacy `Atomic-Chat` (Cargo package name) and the current `chat.atomic.app` (bundle id);
+ * the legacy one wins whenever it exists. The Rust CLI (`resolve_config_file_path`) only ever looks
+ * at the legacy dir — the core follows the app, which is the writer.
+ *
+ * Pure: every environment fact is injected so the Windows/Linux branches are testable anywhere.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { posix, win32 } from 'node:path';
+import { realpathSync } from 'node:fs';
+export const CONFIGURATION_FILE_NAME = 'settings.json';
+export const DEFAULT_APP_NAME = 'Atomic Chat';
+/** Tauri bundle identifier — current config dir name. */
+export const APP_IDENTIFIER = 'chat.atomic.app';
+/** Cargo package name — legacy config dir name. */
+export const LEGACY_PACKAGE_NAME = 'Atomic-Chat';
+/** Env var the core honours before any file (CLI `--data-folder` sets it too). */
+export const DATA_FOLDER_ENV = 'ATOMIC_CORE_DATA_FOLDER';
+/** The real environment: what every caller outside tests passes to the resolvers below. */
+export function nodeDataFolderEnv(env = process.env) {
+    return {
+        platform: process.platform,
+        env,
+        homedir: homedir(),
+        exists: (path) => existsSync(path),
+        readFile: (path) => {
+            try {
+                return readFileSync(path, 'utf8');
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+/** The injected platform's path rules, never the host's: the Windows branches run on a Mac too. */
+const pathsOf = (e) => (e.platform === 'win32' ? win32 : posix);
+/** `dirs::data_dir()` — Roaming AppData / Application Support / XDG data. */
+export function dataDir(e) {
+    const { join } = pathsOf(e);
+    if (e.platform === 'win32')
+        return e.env['APPDATA'] ?? join(e.homedir, 'AppData', 'Roaming');
+    if (e.platform === 'darwin')
+        return join(e.homedir, 'Library', 'Application Support');
+    return e.env['XDG_DATA_HOME'] ?? join(e.homedir, '.local', 'share');
+}
+/** `dirs::config_dir()` — only differs from data_dir on Linux (`~/.config`). */
+export function configDir(e) {
+    const { join } = pathsOf(e);
+    if (e.platform === 'win32')
+        return e.env['APPDATA'] ?? join(e.homedir, 'AppData', 'Roaming');
+    if (e.platform === 'darwin')
+        return join(e.homedir, 'Library', 'Application Support');
+    return e.env['XDG_CONFIG_HOME'] ?? join(e.homedir, '.config');
+}
+/**
+ * Where the app reads/writes `settings.json` (`get_configuration_file_path`): the legacy
+ * `Atomic-Chat` dir when it exists, otherwise `chat.atomic.app`. On Linux the legacy dir is under
+ * `config_dir`, elsewhere it sits beside the current one under `data_dir`.
+ */
+export function resolveConfigFilePath(e) {
+    const { join } = pathsOf(e);
+    const current = join(dataDir(e), APP_IDENTIFIER);
+    const legacy = e.platform === 'linux' ? join(configDir(e), LEGACY_PACKAGE_NAME) : join(dataDir(e), LEGACY_PACKAGE_NAME);
+    return join(e.exists(legacy) ? legacy : current, CONFIGURATION_FILE_NAME);
+}
+/** `build_default_data_folder` + the `.ai.app` suffix strip of `default_data_folder_path`. */
+export function defaultDataFolder(e) {
+    const appName = e.env['APP_NAME'] ?? DEFAULT_APP_NAME;
+    const path = pathsOf(e).join(dataDir(e), appName, 'data');
+    return path.endsWith('.ai.app') ? path.slice(0, -'.ai.app'.length) : path;
+}
+/** Parse the app's `settings.json`; `autostart_preference` defaults to `unmanaged` like serde. */
+export function parseAppConfiguration(text) {
+    try {
+        const raw = JSON.parse(text);
+        if (!raw || typeof raw.data_folder !== 'string')
+            return undefined;
+        const pref = raw.autostart_preference;
+        const autostart = pref === 'pending_default_on' || pref === 'unmanaged' || pref === 'enabled' || pref === 'disabled'
+            ? pref
+            : 'unmanaged';
+        return { data_folder: raw.data_folder, autostart_preference: autostart };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * `<data>`: explicit env override → `settings.json` `data_folder` → default location.
+ * Never creates anything.
+ */
+export function resolveDataFolder(e) {
+    const override = e.env[DATA_FOLDER_ENV];
+    if (override !== undefined && override.trim() !== '')
+        return override;
+    const text = e.readFile(resolveConfigFilePath(e));
+    const config = text === undefined ? undefined : parseAppConfiguration(text);
+    return config?.data_folder ?? defaultDataFolder(e);
+}
+/** The CLI deliberately does not inherit the desktop application's configured data folder. */
+export function resolveCliDataFolder(e) {
+    return pathsOf(e).join(dataDir(e), 'atomic-chat-cli', 'data');
+}
+/** Reject aliases of the app's folder, including symlinks through existing parent directories. */
+export function assertCliDataFolder(folder, e) {
+    const paths = pathsOf(e);
+    const canonical = (input) => {
+        let ancestor = paths.resolve(input);
+        const missing = [];
+        // The destination may not exist. Resolve the nearest existing ancestor,
+        // including a symlink several levels up, then append the missing suffix.
+        // Tests model other platforms' lexical rules without probing this host's FS.
+        if (e.platform === process.platform) {
+            for (;;) {
+                try {
+                    ancestor = realpathSync.native(ancestor);
+                    break;
+                }
+                catch {
+                    const parent = paths.dirname(ancestor);
+                    if (parent === ancestor)
+                        break;
+                    missing.unshift(paths.basename(ancestor));
+                    ancestor = parent;
+                }
+            }
+        }
+        const path = paths.join(ancestor, ...missing);
+        // Windows aliases are case-insensitive even if their final components do
+        // not exist yet and realpath could not supply filesystem casing.
+        return e.platform === 'win32' ? path.toLowerCase() : path;
+    };
+    // The CLI's environment override is not the application's configured folder.
+    // In particular, --data-folder=A sets this override to A while the app may
+    // still own a different folder B from settings.json. Guard both candidates.
+    const text = e.readFile(resolveConfigFilePath(e));
+    const configured = text === undefined ? undefined : parseAppConfiguration(text);
+    const appFolder = configured?.data_folder ?? defaultDataFolder(e);
+    if ([appFolder, e.env[DATA_FOLDER_ENV]].some((path) => path && canonical(folder) === canonical(path))) {
+        throw new Error('The CLI cannot use the Atomic Chat application data folder; choose a separate --data-folder.');
+    }
+}
+//# sourceMappingURL=data-folder.js.map

package/dist/config/data-folder.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Data-folder resolution and on-disk layout (DataLayout, ProviderPaths, backend exe candidates).
+ *
+ * Ported from: src-tauri/src/core/app/{commands,models,constants}.rs,
+ * extensions/llamacpp-upstream-extension/src/{index,backend}.ts (getProviderPath/getModelsRootPath/getBackendExePath).
+ * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ */
+export * from './data-folder.js';
+export * from './paths.js';

package/dist/config/index.js

@@ -0,0 +1,10 @@
+/**
+ * Data-folder resolution and on-disk layout (DataLayout, ProviderPaths, backend exe candidates).
+ *
+ * Ported from: src-tauri/src/core/app/{commands,models,constants}.rs,
+ * extensions/llamacpp-upstream-extension/src/{index,backend}.ts (getProviderPath/getModelsRootPath/getBackendExePath).
+ * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ */
+export * from './data-folder.js';
+export * from './paths.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA"}

package/dist/config/paths.d.ts

@@ -0,0 +1,98 @@
+/**
+ * On-disk layout under `<data>`. Every path here is a contract with the app (PLAN.md §8.1):
+ *
+ *   <data>/llamacpp/models/<id>/{model.yml, model.gguf, mmproj.gguf, *.part, *.tmp, *.url}  (shared by both llama.cpp providers)
+ *   <data>/llamacpp/backends/<version>/<backend>/build/bin/llama-server        (turboquant)
+ *   <data>/llamacpp/lib/                                                        (turboquant cudart)
+ *   <data>/llamacpp-upstream/backends/<version>/<backend>/build/bin/llama-server
+ *   <data>/llamacpp-upstream/tmp/
+ *   <data>/mlx/models/<id>/{model.yml, config.json, *.safetensors}
+ *   <data>/diffusion/{backends/<tag>/<backend>/, models/, scratch/}, <data>/images/  (image generation; the app's paths since v2.0.38)
+ *   <data>/videos/  (video generation; the folder the app's ADR of 2026-09-10 reserved)
+ *   <data>/local-api-server.json, <data>/atomic-chatgpt-auth.json
+ *   <data>/remote-access-tunnel.json  (the app's 2.0.40 tunnel journal: reaped once at startup, never written)
+ *   <data>/atomic-core/  — the only new folder (settings, credentials, lock, journal, logs)
+ */
+import type { LocalProviderId } from '../contracts/index.js';
+/** Subfolder holding the shared GGUF tree: `<data>/llamacpp/models`. Not the provider id. */
+export declare const MODELS_ROOT = "llamacpp";
+export declare const CORE_DIR = "atomic-core";
+export declare const MODEL_YML = "model.yml";
+export declare const LOCAL_API_SERVER_STATE_FILE = "local-api-server.json";
+export declare const CHATGPT_AUTH_FILE = "atomic-chatgpt-auth.json";
+export interface ProviderPaths {
+    /** `<data>/<provider>` */
+    root: string;
+    /** `<root>/backends` (llama.cpp providers only). */
+    backendsDir: string;
+    /** `<root>/tmp` archive staging. */
+    tmpDir: string;
+    /** `<data>/llamacpp/lib` — turboquant only. */
+    libDir?: string;
+    /** `<data>/llamacpp/models` for both llama.cpp providers; `<data>/mlx/models` for MLX. */
+    modelsDir: string;
+}
+export interface CoreFiles {
+    dir: string;
+    /**
+     * The core's own copy of the local-API-server state, in the same schema as the app's
+     * `<data>/local-api-server.json`. The app owns that file until phase 4, and two writers would
+     * fight over it, so a core that serves `/v1` publishes its address here instead.
+     */
+    publicServerState: string;
+    settings: string;
+    credentials: string;
+    optimalBackend: string;
+    instanceLock: string;
+    controlToken: string;
+    processes: string;
+    modelClaims: string;
+    logsDir: string;
+    /** The remote-access tunnel's own crash-recovery record (it has no provider, model or port). */
+    remoteAccessTunnel: string;
+    /** An empty `--config` for cloudflared on Windows, which has no `/dev/null` to point at. */
+    cloudflaredEmptyConfig: string;
+    /** The core's own error-reporting state: the user's stored choice, the install id. */
+    telemetry: string;
+}
+/** Image generation. Paths the app's diffusion plugin chose; the core adopted them as they are. */
+export interface DiffusionPaths {
+    /** `<data>/diffusion` */
+    root: string;
+    /** `<root>/backends/<tag>/<backendId>/`, each holding `sd-server`. */
+    backendsDir: string;
+    modelsDir: string;
+    /** Empty directories `sd-server` insists on being given (LoRA, upscalers, embeddings). */
+    scratchDir: string;
+    /** `<data>/images`: the gallery, unless the user chose another folder. */
+    defaultOutputDir: string;
+    /** `<data>/videos`: the video gallery, unless the user chose another folder. */
+    defaultVideoOutputDir: string;
+}
+export interface DataLayout {
+    root: string;
+    serverStateFile: string;
+    chatgptAuthFile: string;
+    /**
+     * The tunnel journal Atomic Chat 2.0.40's Rust wrote (`{pid, started_at_secs}`) and reaped at its own
+     * startup. The app no longer reads it, so the core reaps it once and removes it; nothing writes it.
+     */
+    legacyRemoteAccessTunnel: string;
+    core: CoreFiles;
+    diffusion: DiffusionPaths;
+    provider(id: LocalProviderId): ProviderPaths;
+}
+export declare function dataLayout(root: string): DataLayout;
+/** `llama-server` / `llama-server.exe` by platform. */
+export declare function llamaServerExeName(platform: NodeJS.Platform): string;
+/** Both layouts a backend pack may have: `build/bin/<exe>` (current) or flat `<exe>` (legacy). */
+export declare function backendExeCandidates(paths: ProviderPaths, version: string, backend: string, exe: string): string[];
+/** Model id from the directory holding its `model.yml`: relative to `modelsDir`, `\` → `/`. */
+export declare function modelIdFromDir(modelsDir: string, modelDir: string): string;
+/** Directory of a model id (ids may contain `/`, which nests). */
+export declare function modelDirFromId(modelsDir: string, modelId: string): string;
+/**
+ * Resolve a `model.yml` path field: absolute paths stay, relative ones are joined onto `<data>`
+ * (`resolve_model_by_id` in `cli/mod.rs`, `joinPath([janDataFolderPath, model_path])` in the extension).
+ */
+export declare function resolveDataRelative(root: string, path: string, isAbsolute: (p: string) => boolean): string;

package/dist/config/paths.js

@@ -0,0 +1,109 @@
+/**
+ * On-disk layout under `<data>`. Every path here is a contract with the app (PLAN.md §8.1):
+ *
+ *   <data>/llamacpp/models/<id>/{model.yml, model.gguf, mmproj.gguf, *.part, *.tmp, *.url}  (shared by both llama.cpp providers)
+ *   <data>/llamacpp/backends/<version>/<backend>/build/bin/llama-server        (turboquant)
+ *   <data>/llamacpp/lib/                                                        (turboquant cudart)
+ *   <data>/llamacpp-upstream/backends/<version>/<backend>/build/bin/llama-server
+ *   <data>/llamacpp-upstream/tmp/
+ *   <data>/mlx/models/<id>/{model.yml, config.json, *.safetensors}
+ *   <data>/diffusion/{backends/<tag>/<backend>/, models/, scratch/}, <data>/images/  (image generation; the app's paths since v2.0.38)
+ *   <data>/videos/  (video generation; the folder the app's ADR of 2026-09-10 reserved)
+ *   <data>/local-api-server.json, <data>/atomic-chatgpt-auth.json
+ *   <data>/remote-access-tunnel.json  (the app's 2.0.40 tunnel journal: reaped once at startup, never written)
+ *   <data>/atomic-core/  — the only new folder (settings, credentials, lock, journal, logs)
+ */
+import { join, relative, sep } from 'node:path';
+/** Subfolder holding the shared GGUF tree: `<data>/llamacpp/models`. Not the provider id. */
+export const MODELS_ROOT = 'llamacpp';
+export const CORE_DIR = 'atomic-core';
+export const MODEL_YML = 'model.yml';
+export const LOCAL_API_SERVER_STATE_FILE = 'local-api-server.json';
+export const CHATGPT_AUTH_FILE = 'atomic-chatgpt-auth.json';
+export function dataLayout(root) {
+    const coreDir = join(root, CORE_DIR);
+    const diffusionDir = join(root, 'diffusion');
+    return {
+        root,
+        serverStateFile: join(root, LOCAL_API_SERVER_STATE_FILE),
+        chatgptAuthFile: join(root, CHATGPT_AUTH_FILE),
+        legacyRemoteAccessTunnel: join(root, 'remote-access-tunnel.json'),
+        core: {
+            dir: coreDir,
+            publicServerState: join(coreDir, LOCAL_API_SERVER_STATE_FILE),
+            settings: join(coreDir, 'settings.json'),
+            credentials: join(coreDir, 'credentials.json'),
+            optimalBackend: join(coreDir, 'optimal-backend.json'),
+            instanceLock: join(coreDir, 'instance.lock'),
+            controlToken: join(coreDir, 'control-token'),
+            processes: join(coreDir, 'processes.json'),
+            modelClaims: join(coreDir, 'model-claims'),
+            logsDir: join(coreDir, 'logs'),
+            remoteAccessTunnel: join(coreDir, 'remote-access-tunnel.json'),
+            cloudflaredEmptyConfig: join(coreDir, 'cloudflared-empty.yml'),
+            /** The core's own error-reporting state: the user's stored choice, the install id. */
+            telemetry: join(coreDir, 'telemetry.json'),
+        },
+        diffusion: {
+            root: diffusionDir,
+            backendsDir: join(diffusionDir, 'backends'),
+            modelsDir: join(diffusionDir, 'models'),
+            scratchDir: join(diffusionDir, 'scratch'),
+            defaultOutputDir: join(root, 'images'),
+            defaultVideoOutputDir: join(root, 'videos'),
+        },
+        provider(id) {
+            const providerRoot = join(root, id);
+            switch (id) {
+                case 'llamacpp':
+                    return {
+                        root: providerRoot,
+                        backendsDir: join(providerRoot, 'backends'),
+                        tmpDir: join(providerRoot, 'tmp'),
+                        libDir: join(providerRoot, 'lib'),
+                        modelsDir: join(root, MODELS_ROOT, 'models'),
+                    };
+                case 'llamacpp-upstream':
+                    return {
+                        root: providerRoot,
+                        backendsDir: join(providerRoot, 'backends'),
+                        tmpDir: join(providerRoot, 'tmp'),
+                        modelsDir: join(root, MODELS_ROOT, 'models'),
+                    };
+                case 'mlx':
+                case 'foundation-models':
+                    return {
+                        root: providerRoot,
+                        backendsDir: join(providerRoot, 'backends'),
+                        tmpDir: join(providerRoot, 'tmp'),
+                        modelsDir: join(providerRoot, 'models'),
+                    };
+            }
+        },
+    };
+}
+/** `llama-server` / `llama-server.exe` by platform. */
+export function llamaServerExeName(platform) {
+    return platform === 'win32' ? 'llama-server.exe' : 'llama-server';
+}
+/** Both layouts a backend pack may have: `build/bin/<exe>` (current) or flat `<exe>` (legacy). */
+export function backendExeCandidates(paths, version, backend, exe) {
+    const dir = join(paths.backendsDir, version, backend);
+    return [join(dir, 'build', 'bin', exe), join(dir, exe)];
+}
+/** Model id from the directory holding its `model.yml`: relative to `modelsDir`, `\` → `/`. */
+export function modelIdFromDir(modelsDir, modelDir) {
+    return relative(modelsDir, modelDir).split(sep).join('/');
+}
+/** Directory of a model id (ids may contain `/`, which nests). */
+export function modelDirFromId(modelsDir, modelId) {
+    return join(modelsDir, ...modelId.split('/'));
+}
+/**
+ * Resolve a `model.yml` path field: absolute paths stay, relative ones are joined onto `<data>`
+ * (`resolve_model_by_id` in `cli/mod.rs`, `joinPath([janDataFolderPath, model_path])` in the extension).
+ */
+export function resolveDataRelative(root, path, isAbsolute) {
+    return isAbsolute(path) ? path : join(root, path);
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

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

package/dist/contracts/control-api.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Control API (`/atomic/v1/*`) shapes and the sidecar handshake. PLAN.md §3.6.
+ */
+import type { ErrorBody } from './errors.js';
+export declare const CONTROL_API_PREFIX = "/atomic/v1";
+export declare const CONTROL_PROTOCOL_VERSION = 1;
+/**
+ * The core's first and only stdout line, printed by `daemon` once the control listener is bound
+ * (PLAN.md §3.6). It describes *control* readiness only: the public `/v1` listener is separate and
+ * its address comes from the snapshot, never from here.
+ */
+export interface ReadyLine {
+    event: 'core:ready';
+    pid: number;
+    instance_id: string;
+    protocol: typeof CONTROL_PROTOCOL_VERSION;
+    version: string;
+    control_host: string;
+    control_port: number;
+}
+export interface ControlErrorResponse {
+    error: ErrorBody;
+}
+export interface HealthResponse {
+    ok: true;
+    pid: number;
+    version: string;
+    dataFolder: string;
+    uptime_ms: number;
+}
+/** `<data>/local-api-server.json` — byte-identical with the app's state_file.rs; the API key is never written. */
+export interface LocalApiServerState {
+    running: boolean;
+    host: string;
+    port: number;
+    prefix: string;
+    requires_api_key: boolean;
+    pid: number | null;
+}
+export declare const LOCAL_API_SERVER_STATE_FILE = "local-api-server.json";
+/** `GET /atomic/v1/telemetry`: whether the core reports its errors, and why. Never the DSN. */
+export interface TelemetryState {
+    enabled: boolean;
+    /** Enabled, and this build has a project to report to. */
+    reporting: boolean;
+    has_user: boolean;
+    tags: Record<string, string>;
+    /** Who decided: the environment (`DO_NOT_TRACK`), the host, the user's stored choice, or the default (on). */
+    source: 'env' | 'host' | 'stored' | 'default';
+    /** Who embeds the core: `atomic-chat`, `cli`, `library`, or a host's own name. */
+    host: string;
+}
+/**
+ * `PUT /atomic/v1/telemetry`: what the app's `set_telemetry_*` commands learned. An omitted field
+ * keeps its value; `user_id: null` forgets the user; `tags` replaces the whole set (allow-listed).
+ */
+export interface TelemetryUpdateRequest {
+    enabled?: boolean;
+    user_id?: string | null;
+    tags?: Record<string, string>;
+}

package/dist/contracts/control-api.js

@@ -0,0 +1,7 @@
+/**
+ * Control API (`/atomic/v1/*`) shapes and the sidecar handshake. PLAN.md §3.6.
+ */
+export const CONTROL_API_PREFIX = '/atomic/v1';
+export const CONTROL_PROTOCOL_VERSION = 1;
+export const LOCAL_API_SERVER_STATE_FILE = 'local-api-server.json';
+//# sourceMappingURL=control-api.js.map

package/dist/contracts/control-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-api.js","sourceRoot":"","sources":["../../src/contracts/control-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAuCzC,MAAM,CAAC,MAAM,2BAA2B,GAAG,uBAAuB,CAAA"}