@atomic-chat/core 0.5.1

package/dist/cloud/chatgpt.js

@@ -0,0 +1,233 @@
+/**
+ * Serving a ChatGPT subscription: the `/chat/completions` branch for models registered under the
+ * `chatgpt` provider, and the subscription's model list.
+ *
+ * Ported from: src-tauri/src/core/server/chatgpt_route.rs, proxy.rs (`try_serve_chatgpt`).
+ * Contract: test/fixtures/app/chatgpt-route (upstream request, model normalisation); the response
+ * side is `ChatChunkStreamConverter`, pinned by the chat-to-responses-shim set.
+ *
+ * The request is built from scratch rather than forwarded: this endpoint is particular about what
+ * it receives, and the bearer must be the subscription's, never the client's.
+ */
+import { randomUUID } from 'node:crypto';
+import { AtomicCoreError } from '../contracts/index.js';
+import { ChatChunkStreamConverter, chatRequestToResponses, isJsonObject, serdeToString, } from '../server/shims/index.js';
+export const CHATGPT_PROVIDER = 'chatgpt';
+export const CHATGPT_BASE_URL = 'https://chatgpt.com/backend-api/codex';
+export const CHATGPT_ORIGINATOR = 'atomic_chat';
+export const CHATGPT_USER_AGENT = 'atomic-chat/1';
+/** `/codex/models` hides slugs whose minimal client version exceeds this. */
+export const CHATGPT_CLIENT_VERSION = '0.156.0';
+export const CHATGPT_REQUEST_TIMEOUT_MS = 600_000;
+function asU64(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : null;
+}
+export function normalizeModel(item) {
+    if (!isJsonObject(item))
+        return null;
+    const slug = item['slug'];
+    if (typeof slug !== 'string' || slug === '' || Buffer.byteLength(slug) > 128)
+        return null;
+    const display = item['display_name'];
+    const modalities = item['input_modalities'];
+    const levels = item['supported_reasoning_levels'];
+    return {
+        id: slug,
+        display_name: typeof display === 'string' && display !== '' ? display : slug,
+        context_length: asU64(item['context_window']),
+        vision: Array.isArray(modalities) && modalities.some((m) => m === 'image'),
+        reasoning_efforts: Array.isArray(levels)
+            ? levels.flatMap((l) => (isJsonObject(l) && typeof l['effort'] === 'string' ? [l['effort']] : []))
+            : [],
+        listed: item['visibility'] === 'list',
+    };
+}
+export function buildUpstreamRequest(options) {
+    const headers = [
+        ['authorization', `Bearer ${options.accessToken}`],
+        ['accept', 'text/event-stream'],
+        ['content-type', 'application/json'],
+        ['openai-beta', 'responses=experimental'],
+        ['originator', CHATGPT_ORIGINATOR],
+        ['user-agent', CHATGPT_USER_AGENT],
+        // Hyphen, not underscore: the backend reads `session-id` to keep one conversation on one shard.
+        ['session-id', options.sessionId],
+        ['x-client-request-id', options.requestId],
+    ];
+    if (options.accountId !== null)
+        headers.push(['chatgpt-account-id', options.accountId]);
+    return {
+        method: 'POST',
+        url: `${options.baseUrl ?? CHATGPT_BASE_URL}/responses`,
+        headers,
+        body: serdeToString(options.payload),
+    };
+}
+/** Send with one forced token refresh on a 401: the server's opinion of the token outranks ours. */
+async function withRefreshOn401(backend, send) {
+    let forced = false;
+    for (;;) {
+        const token = await backend.accessToken(forced);
+        const response = await send(token);
+        if (response.status === 401 && !forced) {
+            await response.body?.cancel().catch(() => { });
+            forced = true;
+            continue;
+        }
+        return response;
+    }
+}
+/** What the subscription can serve, straight from the account; no curated fallback. */
+export async function listSubscriptionModels(backend) {
+    const fetchImpl = backend.fetch ?? fetch;
+    const base = backend.baseUrl ?? CHATGPT_BASE_URL;
+    let response;
+    try {
+        response = await withRefreshOn401(backend, (token) => fetchImpl(`${base}/models?client_version=${CHATGPT_CLIENT_VERSION}`, {
+            headers: {
+                'authorization': `Bearer ${token.token}`,
+                'accept': 'application/json',
+                'originator': CHATGPT_ORIGINATOR,
+                'user-agent': CHATGPT_USER_AGENT,
+                ...(token.accountId !== null ? { 'chatgpt-account-id': token.accountId } : {}),
+            },
+        }));
+    }
+    catch (e) {
+        if (e instanceof AtomicCoreError)
+            throw e;
+        throw new AtomicCoreError('UPSTREAM_ERROR', `Could not reach ChatGPT: ${e.message}`);
+    }
+    const body = await response.text();
+    if (!response.ok)
+        throw new AtomicCoreError('UPSTREAM_ERROR', `Could not list ChatGPT models (${response.status}): ${body}`);
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch (e) {
+        throw new AtomicCoreError('UPSTREAM_ERROR', `ChatGPT returned an unreadable model list: ${e.message}`);
+    }
+    const items = isJsonObject(parsed) && Array.isArray(parsed['models']) ? parsed['models'] : [];
+    const seen = new Set();
+    return items.flatMap((item) => {
+        const model = normalizeModel(item);
+        if (!model || seen.has(model.id))
+            return [];
+        seen.add(model.id);
+        return [model];
+    });
+}
+/**
+ * Answer one `/chat/completions` request from the subscription. The upstream only streams, so a
+ * non-streaming client gets the aggregate of that stream.
+ */
+export async function serveSubscriptionChat(backend, requestBody, stream, reply, signal) {
+    const sessionId = randomUUID();
+    // Stable across the retry, and doubling as the prompt cache key.
+    const payload = chatRequestToResponses(requestBody, sessionId);
+    const model = isJsonObject(requestBody) && typeof requestBody['model'] === 'string' ? requestBody['model'] : '';
+    const requestId = randomUUID().replaceAll('-', '');
+    const created = Math.floor(Date.now() / 1000);
+    const fetchImpl = backend.fetch ?? fetch;
+    let response;
+    try {
+        response = await withRefreshOn401(backend, (token) => {
+            const request = buildUpstreamRequest({
+                ...(backend.baseUrl !== undefined ? { baseUrl: backend.baseUrl } : {}),
+                accessToken: token.token,
+                accountId: token.accountId,
+                sessionId,
+                requestId,
+                payload,
+            });
+            return fetchImpl(request.url, {
+                method: request.method,
+                headers: request.headers,
+                body: request.body,
+                signal: signal
+                    ? AbortSignal.any([signal, AbortSignal.timeout(CHATGPT_REQUEST_TIMEOUT_MS)])
+                    : AbortSignal.timeout(CHATGPT_REQUEST_TIMEOUT_MS),
+            });
+        });
+    }
+    catch (e) {
+        if (signal?.aborted)
+            return;
+        if (e instanceof AtomicCoreError)
+            return reply.error(401, e.message);
+        return reply.error(502, `ChatGPT subscription request failed: ${e.message}`);
+    }
+    if (!response.ok) {
+        // Verbatim: subscription quotas are per-account, and a generic error leaves nothing to act on.
+        const body = await response.text().catch((e) => `Failed to read error body: ${e.message}`);
+        return reply.error(response.status, body);
+    }
+    const conv = new ChatChunkStreamConverter(model, created);
+    if (!stream) {
+        for await (const event of upstreamEvents(response)) {
+            if (event === 'done')
+                break;
+            conv.onEvent(event);
+        }
+        const error = conv.error();
+        if (error !== null)
+            return reply.error(502, error);
+        return reply.json(serdeToString(conv.intoChatCompletion()));
+    }
+    async function* frames() {
+        try {
+            for await (const event of upstreamEvents(response)) {
+                if (event === 'done')
+                    break;
+                for (const chunk of conv.onEvent(event))
+                    yield `data: ${serdeToString(chunk)}\n\n`;
+            }
+        }
+        catch {
+            // the upstream broke off; the client is still owed the closing frames below
+        }
+        // Whatever ended the stream, the client is waiting for a finish chunk and `[DONE]`.
+        for (const chunk of conv.finish())
+            yield `data: ${serdeToString(chunk)}\n\n`;
+        yield 'data: [DONE]\n\n';
+    }
+    await reply.stream(frames(), () => void response.body?.cancel().catch(() => { }));
+}
+/** The `data:` payloads of an SSE body: parsed JSON, or `'done'` for `[DONE]`. */
+async function* upstreamEvents(response) {
+    if (!response.body)
+        return;
+    const decoder = new TextDecoder();
+    let pending = '';
+    const parse = function* (line) {
+        const text = line.trim();
+        if (!text.startsWith('data:'))
+            return;
+        const data = text.slice('data:'.length).trim();
+        if (data === '[DONE]') {
+            yield 'done';
+            return;
+        }
+        try {
+            yield JSON.parse(data);
+        }
+        catch {
+            // neither JSON nor [DONE]: nothing to translate
+        }
+    };
+    for await (const chunk of response.body) {
+        pending += decoder.decode(chunk, { stream: true });
+        let newline = pending.indexOf('\n');
+        while (newline >= 0) {
+            const line = pending.slice(0, newline);
+            pending = pending.slice(newline + 1);
+            yield* parse(line);
+            newline = pending.indexOf('\n');
+        }
+    }
+    pending += decoder.decode();
+    if (pending !== '')
+        yield* parse(pending);
+}
+//# sourceMappingURL=chatgpt.js.map

package/dist/cloud/chatgpt.js.map

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

package/dist/cloud/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Cloud providers the Local API Server routes to, and the ChatGPT subscription route.
+ *
+ * Ported from: src-tauri/src/core/server/{remote_provider_commands,chatgpt_route}.rs.
+ * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ */
+export * from './registry.js';
+export * from './chatgpt.js';

package/dist/cloud/index.js

@@ -0,0 +1,9 @@
+/**
+ * Cloud providers the Local API Server routes to, and the ChatGPT subscription route.
+ *
+ * Ported from: src-tauri/src/core/server/{remote_provider_commands,chatgpt_route}.rs.
+ * See PLAN.md §3.2. Public API of this module is exported from this file only.
+ */
+export * from './registry.js';
+export * from './chatgpt.js';
+//# sourceMappingURL=index.js.map

package/dist/cloud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cloud/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA"}

package/dist/cloud/registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The cloud providers the Local API Server can route to: what the app registers today with
+ * `register_provider_config`, kept by the core so a server it owns — or a core running on its own —
+ * can serve cloud models too.
+ *
+ * Ported from: src-tauri/src/core/server/remote_provider_commands.rs (the in-memory map there).
+ *
+ * The non-secret half (base URL, custom headers, models) is stored in `settings.json` under
+ * `cloud.providers`; the API key goes to `credentials.json`, so the settings file never carries a
+ * secret (PLAN.md §3.4). Order is registration order, which decides which provider wins when two
+ * list the same model — the app's hash map made that arbitrary; here it is at least stable.
+ */
+import type { ApiKeyStore } from '../credentials/index.js';
+import type { RemoteProvider } from '../router/index.js';
+import type { SettingsStore } from '../settings/index.js';
+export interface CustomHeader {
+    header: string;
+    value: string;
+}
+/** A provider as the control API shows it: never the key, only whether there is one. */
+export interface CloudProviderView {
+    provider: string;
+    base_url: string | null;
+    custom_headers: CustomHeader[];
+    models: string[];
+    has_api_key: boolean;
+}
+export interface CloudProviderInput {
+    provider: string;
+    /** Absent keeps the stored key; `null` or `""` removes it; a string replaces it. */
+    api_key?: string | null;
+    base_url?: string | null;
+    custom_headers?: CustomHeader[];
+    models?: string[];
+}
+export declare class CloudRegistry {
+    private readonly settings;
+    private readonly keys;
+    private mutation;
+    constructor(settings: SettingsStore, keys: ApiKeyStore);
+    private stored;
+    list(): CloudProviderView[];
+    get(provider: string): CloudProviderView | undefined;
+    /** Register or replace a provider. Everything but the key is replaced wholesale, as the app does. */
+    upsert(input: CloudProviderInput): Promise<CloudProviderView>;
+    /** Missing is success, like the app's `unregister_provider_config`. */
+    remove(provider: string): Promise<void>;
+    private serialize;
+    /** What the router matches models against. */
+    routing(): ReadonlyMap<string, RemoteProvider>;
+}

package/dist/cloud/registry.js

@@ -0,0 +1,148 @@
+/**
+ * The cloud providers the Local API Server can route to: what the app registers today with
+ * `register_provider_config`, kept by the core so a server it owns — or a core running on its own —
+ * can serve cloud models too.
+ *
+ * Ported from: src-tauri/src/core/server/remote_provider_commands.rs (the in-memory map there).
+ *
+ * The non-secret half (base URL, custom headers, models) is stored in `settings.json` under
+ * `cloud.providers`; the API key goes to `credentials.json`, so the settings file never carries a
+ * secret (PLAN.md §3.4). Order is registration order, which decides which provider wins when two
+ * list the same model — the app's hash map made that arbitrary; here it is at least stable.
+ */
+import { createHash } from 'node:crypto';
+import { AtomicCoreError } from '../contracts/index.js';
+/** Engines the core runs itself; registering one as a cloud provider would shadow its sessions. */
+const LOCAL_PROVIDERS = new Set(['llamacpp', 'llamacpp-upstream', 'mlx', 'foundation-models']);
+function binding(provider) {
+    return createHash('sha256')
+        .update(JSON.stringify([provider.provider, provider.base_url, provider.custom_headers, provider.models]))
+        .digest('hex');
+}
+export class CloudRegistry {
+    settings;
+    keys;
+    mutation = Promise.resolve();
+    constructor(settings, keys) {
+        this.settings = settings;
+        this.keys = keys;
+    }
+    stored() {
+        return this.settings.snapshot().cloud.providers.flatMap((raw) => {
+            const provider = raw['provider'];
+            if (typeof provider !== 'string' || provider === '')
+                return [];
+            const baseUrl = raw['base_url'];
+            const headers = Array.isArray(raw['custom_headers']) ? raw['custom_headers'] : [];
+            const models = Array.isArray(raw['models']) ? raw['models'] : [];
+            return [
+                {
+                    provider,
+                    base_url: typeof baseUrl === 'string' ? baseUrl : null,
+                    custom_headers: headers.filter((h) => typeof h?.header === 'string' &&
+                        typeof h?.value === 'string'),
+                    models: models.filter((m) => typeof m === 'string'),
+                },
+            ];
+        });
+    }
+    list() {
+        return this.stored().map((p) => ({ ...p, has_api_key: this.keys.has(p.provider) }));
+    }
+    get(provider) {
+        return this.list().find((p) => p.provider === provider);
+    }
+    /** Register or replace a provider. Everything but the key is replaced wholesale, as the app does. */
+    async upsert(input) {
+        const provider = validate(input);
+        const next = {
+            provider,
+            base_url: input.base_url === undefined || input.base_url === null ? null : input.base_url.trim(),
+            custom_headers: (input.custom_headers ?? []).map((h) => ({ header: h.header, value: h.value })),
+            models: [...(input.models ?? [])],
+        };
+        return this.serialize(async () => {
+            const list = this.stored();
+            const at = list.findIndex((p) => p.provider === provider);
+            if (at >= 0)
+                list[at] = next;
+            else
+                list.push(next);
+            const oldKey = this.keys.record(provider);
+            // Publish the new key with a binding before changing settings. A router
+            // reading between the two writes (or after a crash) sees a mismatch and
+            // cannot send either key to the wrong destination.
+            await this.keys.setBound(provider, input.api_key === undefined ? oldKey?.api_key : input.api_key, binding(next));
+            try {
+                await this.settings.setCloudProviders(list);
+            }
+            catch (e) {
+                await this.keys.restore(provider, oldKey);
+                throw e;
+            }
+            return { ...next, has_api_key: this.keys.has(provider) };
+        });
+    }
+    /** Missing is success, like the app's `unregister_provider_config`. */
+    async remove(provider) {
+        await this.serialize(async () => {
+            const list = this.stored();
+            const kept = list.filter((p) => p.provider !== provider);
+            const oldKey = this.keys.record(provider);
+            await this.keys.remove(provider);
+            try {
+                if (kept.length !== list.length)
+                    await this.settings.setCloudProviders(kept);
+            }
+            catch (e) {
+                await this.keys.restore(provider, oldKey);
+                throw e;
+            }
+        });
+    }
+    serialize(operation) {
+        const result = this.mutation.then(operation);
+        this.mutation = result.then(() => { }, () => { });
+        return result;
+    }
+    /** What the router matches models against. */
+    routing() {
+        return new Map(this.stored().flatMap((p) => {
+            const key = this.keys.record(p.provider);
+            if (key?.bound_to !== undefined && key.bound_to !== binding(p))
+                return [];
+            return [
+                [
+                    p.provider,
+                    {
+                        provider: p.provider,
+                        apiKey: key?.api_key ?? null,
+                        baseUrl: p.base_url,
+                        customHeaders: p.custom_headers,
+                        models: p.models,
+                    },
+                ],
+            ];
+        }));
+    }
+}
+function validate(input) {
+    const provider = typeof input?.provider === 'string' ? input.provider.trim() : '';
+    if (provider === '')
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'a cloud provider needs a name');
+    if (LOCAL_PROVIDERS.has(provider))
+        throw new AtomicCoreError('INVALID_ARGUMENT', `"${provider}" is a local engine, not a cloud provider`);
+    if (input.models !== undefined &&
+        (!Array.isArray(input.models) || input.models.some((m) => typeof m !== 'string')))
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'models must be a list of model ids');
+    if (input.custom_headers !== undefined &&
+        (!Array.isArray(input.custom_headers) ||
+            input.custom_headers.some((h) => typeof h?.header !== 'string' || typeof h?.value !== 'string')))
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'custom_headers must be a list of {header, value}');
+    if (input.base_url !== undefined && input.base_url !== null && typeof input.base_url !== 'string')
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'base_url must be a string');
+    if (input.api_key !== undefined && input.api_key !== null && typeof input.api_key !== 'string')
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'api_key must be a string');
+    return provider;
+}
+//# sourceMappingURL=registry.js.map

package/dist/cloud/registry.js.map

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

package/dist/config/data-folder.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+export declare const CONFIGURATION_FILE_NAME = "settings.json";
+export declare const DEFAULT_APP_NAME = "Atomic Chat";
+/** Tauri bundle identifier — current config dir name. */
+export declare const APP_IDENTIFIER = "chat.atomic.app";
+/** Cargo package name — legacy config dir name. */
+export declare const LEGACY_PACKAGE_NAME = "Atomic-Chat";
+/** Env var the core honours before any file (CLI `--data-folder` sets it too). */
+export declare const DATA_FOLDER_ENV = "ATOMIC_CORE_DATA_FOLDER";
+export type AutostartPreference = 'pending_default_on' | 'unmanaged' | 'enabled' | 'disabled';
+export interface AppConfiguration {
+    data_folder: string;
+    autostart_preference: AutostartPreference;
+}
+/** The real environment: what every caller outside tests passes to the resolvers below. */
+export declare function nodeDataFolderEnv(env?: NodeJS.ProcessEnv): DataFolderEnv;
+export interface DataFolderEnv {
+    platform: NodeJS.Platform;
+    env: NodeJS.ProcessEnv;
+    homedir: string;
+    exists: (path: string) => boolean;
+    readFile: (path: string) => string | undefined;
+}
+/** `dirs::data_dir()` — Roaming AppData / Application Support / XDG data. */
+export declare function dataDir(e: DataFolderEnv): string;
+/** `dirs::config_dir()` — only differs from data_dir on Linux (`~/.config`). */
+export declare function configDir(e: DataFolderEnv): string;
+/**
+ * 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 declare function resolveConfigFilePath(e: DataFolderEnv): string;
+/** `build_default_data_folder` + the `.ai.app` suffix strip of `default_data_folder_path`. */
+export declare function defaultDataFolder(e: DataFolderEnv): string;
+/** Parse the app's `settings.json`; `autostart_preference` defaults to `unmanaged` like serde. */
+export declare function parseAppConfiguration(text: string): AppConfiguration | undefined;
+/**
+ * `<data>`: explicit env override → `settings.json` `data_folder` → default location.
+ * Never creates anything.
+ */
+export declare function resolveDataFolder(e: DataFolderEnv): string;
+/** The CLI deliberately does not inherit the desktop application's configured data folder. */
+export declare function resolveCliDataFolder(e: DataFolderEnv): string;
+/** Reject aliases of the app's folder, including symlinks through existing parent directories. */
+export declare function assertCliDataFolder(folder: string, e: DataFolderEnv): void;