@atomic-chat/core 0.5.1

package/dist/core/create.js

@@ -0,0 +1,393 @@
+/**
+ * The dependency wiring behind `AtomicCore.create()`: take the instance lock, open every store, build
+ * the runtimes and backend services, start the control listener, construct the facade, reap what a
+ * previous owner left running and only then publish the endpoint.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { dataLayout, nodeDataFolderEnv, resolveCliDataFolder, resolveDataFolder } from '../config/index.js';
+import { CoreEmitter } from '../events/index.js';
+import { InstanceLock, ProcessJournal, writeControlToken } from '../lock/index.js';
+import { EmbedService, ModelCapabilityService, ModelRegistry } from '../models/index.js';
+import { LlamacppRuntime } from '../runtime/llamacpp/index.js';
+import { ExternalSessions } from '../runtime/index.js';
+import { FoundationModelsRuntime } from '../runtime/foundation-models/index.js';
+import { MlxRuntime } from '../runtime/mlx/index.js';
+import { SettingsStore } from '../settings/index.js';
+import { ApiKeyStore, ChatGptAuth } from '../credentials/index.js';
+import { CloudRegistry, listSubscriptionModels } from '../cloud/index.js';
+import { HardwareOverrideStore } from '../hardware/index.js';
+import { BackendService, ensureBackend, ensureTurboquantCudart, ensureUpstreamCudart, ManifestSessionCache, OptimalBackendStore, fetchLiveManifest, platformArch, manifestTransportFromFetch, readRuntimeSettings, selectInstalledBackend, } from '../backend/index.js';
+import { wireDiffusion } from '../diffusion/index.js';
+import { Downloader, availableDiskSpace, createPolicyFetch } from '../downloads/index.js';
+import { lanAddresses, reapTunnelOrphan, wireRemoteAccess } from '../remote-access/index.js';
+import { ClientRegistry, CLIENT_EXPIRY_MS, ControlServer } from '../server/index.js';
+import { captureReport, createCoreReporter, processFailureReport, reportCoreEvents, } from '../telemetry/index.js';
+import { CORE_VERSION } from '../version.js';
+import { reapOrphans } from './reap-orphans.js';
+import { sessionsOf } from './sessions.js';
+import { LOCAL_PROVIDER } from './types.js';
+/**
+ * Take ownership of a data folder and start the control listener. `construct` builds the facade
+ * from the wired parts; `AtomicCore.create` passes its private constructor.
+ */
+export async function createAtomicCore(options, construct) {
+    const log = options.logger ?? (() => { });
+    const warn = (message) => log('warn', message);
+    const scope = options.ownerScope ?? 'cli';
+    const root = options.dataFolder ??
+        (scope === 'app'
+            ? resolveDataFolder(nodeDataFolderEnv(options.env))
+            : resolveCliDataFolder(nodeDataFolderEnv(options.env)));
+    const layout = dataLayout(root);
+    const lock = await InstanceLock.acquire(layout, { ownerScope: scope });
+    let core;
+    try {
+        const token = await writeControlToken(layout);
+        const reporter = options.errorReporter ??
+            (options.telemetry === false
+                ? undefined
+                : await createCoreReporter({
+                    host: options.telemetry?.host ?? 'library',
+                    hostVersion: options.telemetry?.hostVersion,
+                    enabled: options.telemetry?.enabled,
+                    ownerScope: scope,
+                    dataFolder: layout.root,
+                    telemetryFile: layout.core.telemetry,
+                    homeDir: homedir(),
+                    env: options.env ?? process.env,
+                    platform: options.platform ?? process.platform,
+                    arch: process.arch,
+                    version: CORE_VERSION,
+                    warn,
+                    fetch: options.fetch,
+                }));
+        const emitter = new CoreEmitter({
+            instanceId: lock.instanceId,
+            onListenerError: (event, error) => captureReport(reporter, processFailureReport('event_listener', error, { event })),
+        });
+        if (reporter)
+            reportCoreEvents(emitter, reporter, options.platform ?? process.platform);
+        const settings = await SettingsStore.open(layout.core.settings, { ownerScope: scope });
+        // Settings written through the CLI/control API must reach the attached app immediately so it
+        // can refresh the legacy rollback copy before acknowledging the revision. Migration
+        // bookkeeping lives under `state`; it is deliberately not a provider event, otherwise an
+        // acknowledge would trigger another mirror+acknowledge cycle forever.
+        settings.onChange((change) => {
+            if (change.scope === 'state')
+                return;
+            emitter.emit('settings:changed', {
+                provider: change.scope,
+                key: change.key,
+                value: change.value,
+            });
+        });
+        const apiKeys = await ApiKeyStore.open(layout.core.credentials);
+        const cloud = new CloudRegistry(settings, apiKeys);
+        const env = options.env ?? process.env;
+        // Test hooks only: point sign-in and the subscription at local stubs. Production never sets them.
+        const chatgptIssuer = env['ATOMIC_CHATGPT_ISSUER'];
+        const chatgptBaseUrl = env['ATOMIC_CHATGPT_BASE_URL'];
+        const chatgptCallbackPort = env['ATOMIC_CHATGPT_CALLBACK_PORT'];
+        const chatgpt = new ChatGptAuth({
+            path: layout.chatgptAuthFile,
+            endpoint: {
+                ...(chatgptIssuer ? { issuer: chatgptIssuer } : {}),
+                ...(options.fetch ? { fetch: options.fetch } : {}),
+            },
+            ...(chatgptCallbackPort ? { callbackPort: Number(chatgptCallbackPort) } : {}),
+        });
+        const chatgptBackend = {
+            accessToken: (force) => chatgpt.accessToken(force),
+            ...(chatgptBaseUrl ? { baseUrl: chatgptBaseUrl } : {}),
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+        };
+        const externalSessions = new ExternalSessions({ emit: (name, payload) => emitter.emit(name, payload) });
+        const journal = await ProcessJournal.open(layout);
+        const clients = new ClientRegistry();
+        // One per core process, in memory: hardware changes between runs, and a stale file claiming
+        // a GPU that is gone would pick a backend that cannot start. The same store is deliberately
+        // shared by control and the runtime: accepting an override that load never reads is worse
+        // than rejecting the endpoint, because it tells the app a hardware handover succeeded.
+        const hardware = new HardwareOverrideStore();
+        // One downloader per core process: it owns the active-task table that `cancel` works from, so
+        // two of them would each know only half of what is running.
+        const downloader = new Downloader({
+            dataFolder: layout.root,
+            platform: process.platform,
+            fetch: options.fetch ?? fetch,
+            emit: (name, payload) => emitter.emit(name, payload),
+        });
+        const registries = new Map([
+            [LOCAL_PROVIDER, new ModelRegistry(layout, LOCAL_PROVIDER)],
+            ['llamacpp', new ModelRegistry(layout, 'llamacpp')],
+        ]);
+        const platform = options.platform ?? process.platform;
+        // Both llama.cpp providers run through one runtime class; what differs — backend ids, the
+        // argument rules and Windows CUDA runtime repair — is decided by the provider it is given.
+        const llamacppRuntime = (provider) => new LlamacppRuntime({
+            layout,
+            registry: registries.get(provider),
+            instanceId: lock.instanceId,
+            provider,
+            journal,
+            emit: (name, payload) => emitter.emit(name, payload),
+            readSettings: () => readRuntimeSettings(settings, provider, layout, hardware),
+            ensureBackendReady: (backend, version) => ensureBackend(layout, provider, backend, version, hardware, process.arch, (repairBackend, repairVersion) => {
+                const backendDir = join(layout.provider(provider).backendsDir, repairVersion, repairBackend);
+                const taskId = `${provider}-cudart-${repairVersion}/${repairBackend}`.replace(/[^A-Za-z0-9_/:-]/g, '_');
+                const deps = { layout, downloader, platform, log: (message) => log('warn', message) };
+                const repair = provider === 'llamacpp'
+                    ? ensureTurboquantCudart(repairBackend, backendDir, taskId, deps)
+                    : ensureUpstreamCudart(repairVersion, repairBackend, backendDir, taskId, deps);
+                return repair.then(() => { }, (e) => log('warn', `cudart pre-flight for ${repairVersion}/${repairBackend} failed: ${String(e)}`));
+            }),
+            cpuInfo: async () => {
+                const injected = hardware.get();
+                if (!injected?.cpu_extensions)
+                    return undefined;
+                // The no-AVX policy knows `x86_64`, not Node's `x64`: pass the raw name and it never fires.
+                return { arch: platformArch(process.arch), extensions: hardware.cpuExtensions([]) };
+            },
+            ...(options.fetch ? { fetch: options.fetch } : {}),
+        });
+        const runtimes = new Map([
+            [LOCAL_PROVIDER, llamacppRuntime('llamacpp-upstream')],
+            ['llamacpp', llamacppRuntime('llamacpp')],
+        ]);
+        if (platform === 'darwin') {
+            const mlxRegistry = new ModelRegistry(layout, 'mlx');
+            registries.set('mlx', mlxRegistry);
+            runtimes.set('mlx', new MlxRuntime({
+                layout,
+                registry: mlxRegistry,
+                instanceId: lock.instanceId,
+                resourcesDir: options.resourcesDir,
+                readSettings: async () => settings.get('mlx'),
+                journal,
+                emit: (name, payload) => emitter.emit(name, payload),
+            }));
+            runtimes.set('foundation-models', new FoundationModelsRuntime({
+                instanceId: lock.instanceId,
+                resourcesDir: options.resourcesDir,
+                journal,
+                emit: (name, payload) => emitter.emit(name, payload),
+            }));
+        }
+        const optimalStore = await OptimalBackendStore.open(layout.core.optimalBackend, (provider, state) => {
+            emitter.emit('backend:optimal-changed', { provider, ...state });
+        });
+        const manifestCache = new ManifestSessionCache();
+        const capabilities = new ModelCapabilityService({
+            layout,
+            registry: (provider) => registries.get(provider),
+        });
+        const embeddings = new EmbedService({
+            findSession: (provider, modelId) => sessionsOf(runtimes).find((session) => session.provider === provider && session.model_id === modelId),
+            load: async (provider, modelId) => (await core.acquire(provider, modelId, { isEmbedding: true })).session,
+            unload: (provider, modelId) => core.unload(provider, modelId),
+            fetch: options.fetch ?? fetch,
+        });
+        const backendServices = new Map();
+        const backendService = (provider) => {
+            const existing = backendServices.get(provider);
+            if (existing)
+                return existing;
+            const created = new BackendService({
+                layout,
+                provider,
+                downloader,
+                optimalStore,
+                readManifest: async (proxy) => {
+                    const cached = manifestCache.get();
+                    if (cached)
+                        return cached;
+                    const fetchImpl = proxy
+                        ? createPolicyFetch({ proxy, ignore_ssl: proxy.ignore_ssl })
+                        : (options.fetch ?? fetch);
+                    return fetchLiveManifest({
+                        cache: manifestCache,
+                        transports: [manifestTransportFromFetch('core fetch', fetchImpl)],
+                        onWarn: (message) => log('warn', message),
+                    });
+                },
+            });
+            backendServices.set(provider, created);
+            return created;
+        };
+        const diffusion = wireDiffusion({
+            layout,
+            journal,
+            instanceId: lock.instanceId,
+            emit: (name, payload) => emitter.emit(name, payload),
+            log: (level, msg) => (level === 'debug' ? undefined : log(level, msg)),
+            platform,
+            env,
+            ...(options.diffusion ? { overrides: options.diffusion } : {}),
+        });
+        const control = await ControlServer.start({
+            token,
+            instanceId: lock.instanceId,
+            version: CORE_VERSION,
+            ownerScope: scope,
+            dataFolder: layout.root,
+            emitter,
+            clients,
+            sessions: () => sessionsOf(runtimes),
+            loadModel: (provider, modelId, body) => core.acquire(provider, modelId, body),
+            cancelModelLoad: (provider, modelId) => core.cancelLoad(provider, modelId),
+            unloadModel: (provider, modelId) => core.unload(provider, modelId),
+            increaseCtx: (provider, modelId, reason) => core.increaseCtx(provider, modelId, reason),
+            recreateSession: (provider, modelId) => core.recreateSession(provider, modelId),
+            hardware,
+            foundationModelsAvailability: (force) => {
+                const runtime = runtimes.get('foundation-models');
+                return runtime instanceof FoundationModelsRuntime
+                    ? runtime.checkAvailability(force)
+                    : Promise.resolve('unavailable');
+            },
+            models: {
+                capabilities: (provider, modelId) => capabilities.capabilities(provider, modelId),
+                validateGguf: (path) => capabilities.validateGguf(path),
+                devices: async (provider) => {
+                    // Asking a backend what devices it sees needs a backend; with none installed the
+                    // honest answer is an empty list, not an error about a missing binary.
+                    const resolved = await selectInstalledBackend(layout, provider, hardware).catch(() => undefined);
+                    if (!resolved)
+                        return [];
+                    const runtime = core.runtime(provider);
+                    return runtime instanceof LlamacppRuntime ? runtime.getDevices(resolved.path) : [];
+                },
+                embed: (provider, modelId, input, ubatchSize) => embeddings.embed(provider, modelId, input, ubatchSize),
+            },
+            backends: {
+                list: (provider, current) => backendService(provider).listInstalled(current),
+                install: (provider, version, backend, opts) => backendService(provider).install(version, backend, opts),
+                remove: (provider, version, backend) => backendService(provider).remove(version, backend, String(settings.get(provider)['version_backend'] ?? '')),
+                cancel: (taskId) => downloader.cancel(taskId),
+                getOptimal: (provider) => backendService(provider).getOptimalCache(),
+                setOptimal: (provider, record, expectedRevision) => backendService(provider).setOptimalCache(record, expectedRevision),
+                optimalSnapshot: () => optimalStore.snapshot(),
+            },
+            disk: { available: (path) => availableDiskSpace(layout.root, path) },
+            remoteAccess: {
+                lanAddresses,
+                status: () => core.remoteAccessStatus(),
+                start: () => core.startRemoteAccess(),
+                stop: () => core.stopRemoteAccess(),
+            },
+            diffusion,
+            settings: {
+                get: (provider) => settings.get(provider),
+                revision: () => settings.revision,
+                migration: (scope) => settings.migration(scope),
+                update: (provider, patch, opts) => settings.update(provider, patch, opts),
+                importProvider: (provider, values, opts) => settings.importProvider(provider, values, opts),
+                acknowledge: (scope, revision) => settings.acknowledge(scope, revision),
+            },
+            externalSessions: {
+                publish: (owner, generation, sessions) => externalSessions.publish(owner, generation, sessions),
+                heartbeat: (owner, generation) => externalSessions.heartbeat(owner, generation),
+                unregister: (owner, generation) => externalSessions.unregister(owner, generation),
+                list: () => externalSessions.list().map(({ api_key: _key, ...rest }) => rest),
+                answerCtx: (owner, requestId, outcome) => externalSessions.answerCtxIncrease(owner, requestId, outcome),
+            },
+            cloud: {
+                list: () => cloud.list(),
+                upsert: (input) => cloud.upsert(input),
+                remove: (provider) => cloud.remove(provider),
+            },
+            chatgpt: {
+                status: () => chatgpt.status(),
+                reload: () => chatgpt.reload(),
+                startLogin: () => chatgpt.startLogin(),
+                waitLogin: () => chatgpt.waitLogin(),
+                cancelLogin: () => chatgpt.cancelLogin(),
+                logout: () => chatgpt.logout(),
+                models: () => listSubscriptionModels(chatgptBackend),
+            },
+            publicServer: {
+                setInspecting: (enabled) => {
+                    ;
+                    core.inspecting = enabled;
+                },
+                status: () => core.publicState(),
+                start: (opts) => core.startPublicServer(opts),
+                stop: () => core.stopPublicServer(),
+            },
+            shutdown: async () => {
+                await core.shutdown();
+            },
+            ...(reporter ? { telemetry: reporter } : {}),
+        }, {
+            host: options.controlHost ?? '127.0.0.1',
+            ...(options.controlPort !== undefined ? { port: options.controlPort } : {}),
+        });
+        let appLeaseTimer;
+        if (scope === 'app') {
+            const startupDeadline = Date.now() + CLIENT_EXPIRY_MS;
+            let appEverRegistered = false;
+            // An app that crashes cannot detach. Its registration expires after missed heartbeats;
+            // unlike the CLI daemon, this owner then unloads models and releases its lock.
+            appLeaseTimer = setInterval(() => {
+                if (clients.count() > 0)
+                    appEverRegistered = true;
+                else if (appEverRegistered || Date.now() > startupDeadline)
+                    void core.shutdown();
+            }, 5_000);
+            appLeaseTimer.unref();
+        }
+        core = construct({
+            layout,
+            events: emitter,
+            settings,
+            clients,
+            lock,
+            runtimes,
+            registries,
+            control,
+            log,
+            controlToken: token,
+            apiKeys,
+            cloud,
+            chatgpt,
+            chatgptBackend,
+            externalSessions,
+            appLeaseTimer,
+            diffusion,
+            errors: reporter,
+            telemetry: reporter,
+            remoteAccess: await wireRemoteAccess({
+                overrides: options.remoteAccess,
+                cloudflaredPath: options.cloudflaredPath,
+                resourcesDir: options.resourcesDir,
+                env,
+                platform,
+                journalPath: layout.core.remoteAccessTunnel,
+                emptyConfigPath: layout.core.cloudflaredEmptyConfig,
+                instanceId: lock.instanceId,
+                warn,
+            }),
+        });
+        await reapOrphans(journal, lock.instanceId, log);
+        // A tunnel is worse to orphan than a backend: it keeps a public URL pointed at a local port.
+        await reapTunnelOrphan(layout.core.remoteAccessTunnel, { log: warn });
+        // Atomic Chat 2.0.40 journalled its tunnel at the data root and reaped it at its own startup; the
+        // app that replaced it does not. Same checks, and the file is consumed. Only the app owner's folder
+        // can hold it: a CLI owner refuses the app's folder, and one app instance runs at a time.
+        await reapTunnelOrphan(layout.legacyRemoteAccessTunnel, { log: warn });
+        await lock.publish(control.host, control.port);
+        log('info', `core ${CORE_VERSION} owns ${layout.root} (control ${control.url})`);
+        return core;
+    }
+    catch (e) {
+        // A failure after the app lease timer or control listener starts must
+        // release both; otherwise an unpublished owner can still wake its timer.
+        if (core)
+            await core.shutdown().catch(() => { });
+        else
+            await lock.release().catch(() => { });
+        throw e;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/core/create.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The `AtomicCore` facade: the owner process assembled from its parts. `create.ts` wires the
+ * dependencies, `sessions.ts` owns model claims and routing to local sessions, `public-server.ts`
+ * the lifecycle of the public `/v1` listener. Public API of this module is exported from this file only.
+ */
+export { CORE_VERSION } from '../version.js';
+export { AtomicCore } from './atomic-core.js';
+export type { PublicServerStartOptions } from './public-server.js';
+export { LOCAL_PROVIDER } from './types.js';
+export type { AtomicCoreOptions, CoreLoadOptions, CoreLogger } from './types.js';

package/dist/core/index.js

@@ -0,0 +1,9 @@
+/**
+ * The `AtomicCore` facade: the owner process assembled from its parts. `create.ts` wires the
+ * dependencies, `sessions.ts` owns model claims and routing to local sessions, `public-server.ts`
+ * the lifecycle of the public `/v1` listener. Public API of this module is exported from this file only.
+ */
+export { CORE_VERSION } from '../version.js';
+export { AtomicCore } from './atomic-core.js';
+export { LOCAL_PROVIDER } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA"}

package/dist/core/public-server.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The lifecycle of the public `/v1` listener owned by `AtomicCore`: start, stop and state, the option
+ * normalization that makes an identical start idempotent, and the published state files.
+ *
+ * It is a separate, optional listener whose stop must never take control down with it.
+ *
+ * It also keeps the remote-access tunnel honest about it: a public URL must never point at a port
+ * that has stopped, or at whatever binds that port next. So a stop ends the tunnel *first*, a
+ * genuine start ends any tunnel that survived (it pointed at the previous port), and a repeated
+ * start that changes nothing leaves the tunnel alone.
+ */
+import type { LocalApiServerState } from '../contracts/index.js';
+import type { DataLayout } from '../config/index.js';
+import type { CoreEmitter } from '../events/index.js';
+import type { PublicServerDeps } from '../server/index.js';
+import type { ServerEndpoint } from '../remote-access/index.js';
+import type { CoreLogger } from './types.js';
+export interface PublicServerStartOptions {
+    host?: string;
+    port?: number;
+    prefix?: string;
+    apiKey?: string;
+    trustedHosts?: string[];
+    proxyTimeoutSecs?: number;
+    /**
+     * Write the app's `<data>/local-api-server.json` while this server runs. Only the owner of the
+     * public API writes that file, so the app asks for this when it hands the server to the core, and
+     * a core serving on its own leaves the app's file alone.
+     */
+    writeStateFile?: boolean;
+    /** Take a free port when the requested one cannot be bound (the app's behaviour); see `PublicServer`. */
+    fallbackPort?: boolean;
+}
+export interface PublicServerLifecycleDeps {
+    layout: DataLayout;
+    events: CoreEmitter;
+    log: CoreLogger;
+    /** Throws once the owning core is stopping; checked again inside the serialized transition. */
+    assertRunning: () => void;
+    /** What the listener routes to, built for each start. */
+    serverDeps: () => PublicServerDeps;
+    /** The tunnel in front of this listener: ended before a stop, re-announced after every transition. */
+    remoteAccess?: {
+        stop: () => Promise<unknown>;
+        announce: () => void;
+    };
+}
+/** Owns the public listener and serializes its start/stop transitions. */
+export declare class PublicServerLifecycle {
+    private readonly deps;
+    private publicServer;
+    private lastPublicState;
+    private publicConfig;
+    private publicTransition;
+    private stopping;
+    constructor(deps: PublicServerLifecycleDeps);
+    state(): LocalApiServerState;
+    /**
+     * Where a tunnel would point: the *bound* port (a fallback can change it) and a host that really
+     * listens. `undefined` while there is no listener — and already while one is stopping, so nothing
+     * new is pointed at a port that is about to go.
+     */
+    endpoint(): ServerEndpoint | undefined;
+    /** Start the public listener; an identical start is idempotent, an incompatible one is a conflict. */
+    start(options: PublicServerStartOptions): Promise<LocalApiServerState>;
+    /** Stop the listener after any transition in flight; a stopped listener reports its last state. */
+    stop(): Promise<LocalApiServerState>;
+    private stopPublicServerNow;
+    /**
+     * Publish where the public API is, for clients that have no control token — `server status` and
+     * the app. This is the core's own copy; the app's `<data>/local-api-server.json` is written only
+     * when the app handed the server over (`writeStateFile`), so there is always one writer of it.
+     */
+    private publishServerState;
+    private withPublicTransition;
+}