@atomic-chat/core 0.5.1

package/dist/contracts/settings.js

@@ -0,0 +1,17 @@
+/**
+ * Provider settings as the core stores them (canonical keys). The app's extension `settings.json`
+ * descriptors are copied into `src/settings/schema/*.json`; this file only carries the value types.
+ * Source: guest-js/types.ts:151-222 (LlamacppConfig), extensions/<ext>/settings.json.
+ */
+export const DEFAULT_SERVER_SETTINGS = {
+    host: '127.0.0.1',
+    port: 1337,
+    prefix: '/v1',
+    api_key: '',
+    trusted_hosts: [],
+    cors_enabled: true,
+    proxy_timeout_ms: 600_000,
+    enable_on_startup: false,
+    verbose_logs: false,
+};
+//# sourceMappingURL=settings.js.map

package/dist/contracts/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/contracts/settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6HH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,IAAI;IAClB,gBAAgB,EAAE,OAAO;IACzB,iBAAiB,EAAE,KAAK;IACxB,YAAY,EAAE,KAAK;CACpB,CAAA"}

package/dist/core/atomic-core.d.ts

@@ -0,0 +1,149 @@
+/**
+ * `AtomicCore` — the owner process assembled from its parts (PLAN.md §3.3, §3.4, §3.6).
+ *
+ * Creating one *is* taking ownership of a data folder: it acquires the instance lock, mints the
+ * control token, cleans up backend processes the previous owner left behind, starts the control
+ * listener and only then publishes its endpoint. A client that sees `state: "ready"` in the lock can
+ * dial the port and expect an answer.
+ *
+ * The public `/v1` listener is deliberately not started here — it is a separate, optional listener
+ * whose stop must never take control down with it.
+ */
+import type { ReadyLine } from '../contracts/index.js';
+import type { LocalApiServerState, LocalProviderId, RemoteAccessStatus, SessionInfo, UnloadResult } from '../contracts/index.js';
+import type { DataLayout } from '../config/index.js';
+import type { DiffusionService } from '../diffusion/index.js';
+import type { CoreEmitter } from '../events/index.js';
+import type { InstanceLock } from '../lock/index.js';
+import type { ModelRegistry } from '../models/index.js';
+import type { RemoteAccessManagerDeps } from '../remote-access/index.js';
+import { LlamacppRuntime } from '../runtime/llamacpp/index.js';
+import type { CtxIncreaseResult, ExternalSessions, LocalRuntime, RecreateResult } from '../runtime/index.js';
+import type { SettingsStore } from '../settings/index.js';
+import type { ErrorSink, TelemetryControl } from '../telemetry/index.js';
+import type { ApiKeyStore, ChatGptAuth } from '../credentials/index.js';
+import type { ChatGptBackend, CloudRegistry } from '../cloud/index.js';
+import type { ClientRegistry, ControlServer, SessionSummary } from '../server/index.js';
+import type { PublicServerStartOptions } from './public-server.js';
+import type { AtomicCoreOptions, CoreLoadOptions, CoreLogger } from './types.js';
+/** Everything `create()` wires before the facade exists; see `create.ts`. */
+export interface AtomicCoreParts {
+    layout: DataLayout;
+    events: CoreEmitter;
+    settings: SettingsStore;
+    clients: ClientRegistry;
+    lock: InstanceLock;
+    runtimes: Map<LocalProviderId, LocalRuntime>;
+    registries: Map<LocalProviderId, ModelRegistry>;
+    control: ControlServer;
+    log: CoreLogger;
+    controlToken: string;
+    apiKeys: ApiKeyStore;
+    cloud: CloudRegistry;
+    chatgpt: ChatGptAuth;
+    chatgptBackend: ChatGptBackend;
+    externalSessions: ExternalSessions;
+    /** Set for an app owner: the timer that shuts the core down once the app's registration lapses. */
+    appLeaseTimer: NodeJS.Timeout | undefined;
+    /** How the remote-access tunnel is started, proven and journalled; the facade supplies the rest. */
+    remoteAccess: Pick<RemoteAccessManagerDeps, 'spawner' | 'prober' | 'timings' | 'journal'>;
+    /** Image generation (stage 7): its own module, not a runtime. */
+    diffusion: DiffusionService;
+    /** Where a failed load and the public server's failures are reported; absent, nothing is. */
+    errors?: ErrorSink | undefined;
+    /** The same reporter, for a host that changes consent, user or tags at run time. */
+    telemetry?: TelemetryControl | undefined;
+}
+export declare class AtomicCore {
+    readonly version = "0.5.1";
+    private lifecycle;
+    private shutdownPromise;
+    /** Whether the app's API screen is watching; previews are collected only then. */
+    inspecting: boolean;
+    private resolveStopped;
+    /** Resolves once this core has stopped, however that was triggered (API, signal, or in-process). */
+    readonly stopped: Promise<void>;
+    readonly layout: DataLayout;
+    readonly events: CoreEmitter;
+    readonly settings: SettingsStore;
+    readonly clients: ClientRegistry;
+    readonly control: ControlServer;
+    readonly controlToken: string;
+    /** Cloud provider API keys (`credentials.json`). */
+    readonly apiKeys: ApiKeyStore;
+    readonly cloud: CloudRegistry;
+    /** The ChatGPT subscription session (`atomic-chatgpt-auth.json`). */
+    readonly chatgpt: ChatGptAuth;
+    /** Engines the desktop app still owns, registered for routing only (stage 4d). */
+    readonly externalSessions: ExternalSessions;
+    private readonly lock;
+    private readonly runtimes;
+    private readonly registries;
+    private readonly log;
+    private readonly appLeaseTimer;
+    private readonly errors;
+    /**
+     * This core's error reporting, for an embedding program: `state()` says whether it reports and
+     * why, `update({ enabled, user_id, tags })` is what `PUT /atomic/v1/telemetry` does. Undefined
+     * when the host turned reporting off with `telemetry: false`.
+     */
+    readonly telemetry: TelemetryControl | undefined;
+    /** Model claims and per-model load/unload transitions. */
+    private readonly localSessions;
+    /** The public `/v1` listener and its serialized start/stop. */
+    private readonly publicServer;
+    /** What the public listener trusts beyond its configuration: the tunnel name, the socket's address. */
+    private readonly trustedHosts;
+    /** The Cloudflare quick tunnel in front of the public listener. */
+    private readonly remoteAccess;
+    /** Image generation on stable-diffusion.cpp: the resident `sd-server`, its jobs and the gallery. */
+    readonly diffusion: DiffusionService;
+    private constructor();
+    get instanceId(): string;
+    /** Take ownership of a data folder and start the control listener. */
+    static create(options?: AtomicCoreOptions): Promise<AtomicCore>;
+    readyLine(): ReadyLine;
+    registry(provider?: LocalProviderId): ModelRegistry;
+    runtime(provider?: LocalProviderId): LocalRuntime;
+    /** A llama.cpp runtime, for what only llama.cpp has (devices, runtime device info, context size). */
+    llamacpp(provider?: 'llamacpp' | 'llamacpp-upstream'): LlamacppRuntime;
+    sessions(): SessionSummary[];
+    load(provider: LocalProviderId, modelId: string, options?: CoreLoadOptions): Promise<SessionInfo>;
+    /** Load or attach without making an attaching client accidentally own the shared session. */
+    acquire(provider: LocalProviderId, modelId: string, options?: CoreLoadOptions): Promise<{
+        session: SessionInfo;
+        created: boolean;
+    }>;
+    /**
+     * Reload a model with a larger context because a request did not fit. Guarded like `load`: the
+     * desktop app may still own this model, and reloading it here would take it from under the app.
+     */
+    increaseCtx(provider: LocalProviderId, modelId: string, reason?: string): Promise<CtxIncreaseResult>;
+    /** Restart a poisoned engine at its current context; guarded like `load`. */
+    recreateSession(provider: LocalProviderId, modelId: string): Promise<RecreateResult>;
+    /**
+     * Cancel a load that has not answered yet. `false` when nothing is pending for the model — it has
+     * already loaded (unload it instead) or the load has not arrived.
+     */
+    cancelLoad(provider: LocalProviderId, modelId: string): boolean;
+    unload(provider: LocalProviderId, modelId: string): Promise<UnloadResult>;
+    publicState(): LocalApiServerState;
+    /** Start the public listener; an identical start is idempotent, an incompatible one is a conflict. */
+    startPublicServer(options?: PublicServerStartOptions): Promise<LocalApiServerState>;
+    stopPublicServer(): Promise<LocalApiServerState>;
+    remoteAccessStatus(): RemoteAccessStatus;
+    /** Open the tunnel; answers `starting` at once, the rest arrives as `remote-access:status`. */
+    startRemoteAccess(): RemoteAccessStatus;
+    /** Close the tunnel; answers once its process is gone. */
+    stopRemoteAccess(): Promise<RemoteAccessStatus>;
+    /** Stop everything this core owns and release the lock last. */
+    shutdown(): Promise<void>;
+    /** Alias so the facade reads the same as the library docs. */
+    dispose(): Promise<void>;
+    /**
+     * Run a load (or a reload at another context) and report it when it fails, from whichever caller:
+     * the app, the public API, a remote client or the CLI. The error still reaches the caller.
+     */
+    private reportingLoad;
+    private assertRunning;
+}

package/dist/core/atomic-core.js

@@ -0,0 +1,289 @@
+/**
+ * `AtomicCore` — the owner process assembled from its parts (PLAN.md §3.3, §3.4, §3.6).
+ *
+ * Creating one *is* taking ownership of a data folder: it acquires the instance lock, mints the
+ * control token, cleans up backend processes the previous owner left behind, starts the control
+ * listener and only then publishes its endpoint. A client that sees `state: "ready"` in the lock can
+ * dial the port and expect an answer.
+ *
+ * The public `/v1` listener is deliberately not started here — it is a separate, optional listener
+ * whose stop must never take control down with it.
+ */
+import { AtomicCoreError, CONTROL_PROTOCOL_VERSION } from '../contracts/index.js';
+import { assertNotLoadedByLegacy } from '../lock/index.js';
+import { RemoteAccessManager } from '../remote-access/index.js';
+import { LlamacppRuntime } from '../runtime/llamacpp/index.js';
+import { captureReport, loadFailureReport } from '../telemetry/index.js';
+import { DynamicTrustedHosts } from '../server/index.js';
+import { CORE_VERSION } from '../version.js';
+import { createAtomicCore } from './create.js';
+import { PublicServerLifecycle } from './public-server.js';
+import { LocalSessions, sessionsOf, unknownProvider } from './sessions.js';
+import { LOCAL_PROVIDER } from './types.js';
+export class AtomicCore {
+    version = CORE_VERSION;
+    lifecycle = 'running';
+    shutdownPromise;
+    /** Whether the app's API screen is watching; previews are collected only then. */
+    inspecting = false;
+    resolveStopped;
+    /** Resolves once this core has stopped, however that was triggered (API, signal, or in-process). */
+    stopped = new Promise((resolve) => {
+        this.resolveStopped = resolve;
+    });
+    layout;
+    events;
+    settings;
+    clients;
+    control;
+    controlToken;
+    /** Cloud provider API keys (`credentials.json`). */
+    apiKeys;
+    cloud;
+    /** The ChatGPT subscription session (`atomic-chatgpt-auth.json`). */
+    chatgpt;
+    /** Engines the desktop app still owns, registered for routing only (stage 4d). */
+    externalSessions;
+    lock;
+    runtimes;
+    registries;
+    log;
+    appLeaseTimer;
+    errors;
+    /**
+     * This core's error reporting, for an embedding program: `state()` says whether it reports and
+     * why, `update({ enabled, user_id, tags })` is what `PUT /atomic/v1/telemetry` does. Undefined
+     * when the host turned reporting off with `telemetry: false`.
+     */
+    telemetry;
+    /** Model claims and per-model load/unload transitions. */
+    localSessions;
+    /** The public `/v1` listener and its serialized start/stop. */
+    publicServer;
+    /** What the public listener trusts beyond its configuration: the tunnel name, the socket's address. */
+    trustedHosts = new DynamicTrustedHosts();
+    /** The Cloudflare quick tunnel in front of the public listener. */
+    remoteAccess;
+    /** Image generation on stable-diffusion.cpp: the resident `sd-server`, its jobs and the gallery. */
+    diffusion;
+    constructor(parts) {
+        this.layout = parts.layout;
+        this.events = parts.events;
+        this.settings = parts.settings;
+        this.clients = parts.clients;
+        this.control = parts.control;
+        this.controlToken = parts.controlToken;
+        this.apiKeys = parts.apiKeys;
+        this.cloud = parts.cloud;
+        this.chatgpt = parts.chatgpt;
+        this.externalSessions = parts.externalSessions;
+        this.lock = parts.lock;
+        this.runtimes = parts.runtimes;
+        this.registries = parts.registries;
+        this.log = parts.log;
+        this.appLeaseTimer = parts.appLeaseTimer;
+        this.diffusion = parts.diffusion;
+        this.errors = parts.errors;
+        this.telemetry = parts.telemetry;
+        this.localSessions = new LocalSessions({
+            layout: parts.layout,
+            instanceId: parts.lock.instanceId,
+            runtimes: parts.runtimes,
+            externalSessions: parts.externalSessions,
+            runtime: (provider) => this.runtime(provider),
+            assertRunning: () => this.assertRunning(),
+            increaseCtx: (provider, modelId, reason) => this.increaseCtx(provider, modelId, reason),
+            recreateSession: (provider, modelId) => this.recreateSession(provider, modelId),
+        });
+        this.remoteAccess = new RemoteAccessManager({
+            ...parts.remoteAccess,
+            server: () => this.publicServer.endpoint(),
+            hosts: this.trustedHosts,
+            emit: (status) => this.events.emit('remote-access:status', status),
+            log: parts.log,
+        });
+        this.publicServer = new PublicServerLifecycle({
+            layout: parts.layout,
+            events: parts.events,
+            log: parts.log,
+            assertRunning: () => this.assertRunning(),
+            remoteAccess: this.remoteAccess,
+            serverDeps: () => ({
+                findLocal: (provider, modelId) => this.localSessions.localTarget(provider, modelId),
+                listLocal: () => this.localSessions.listLocalTargets(),
+                providers: () => this.cloud.routing(),
+                chatgpt: parts.chatgptBackend,
+                increaseCtx: (provider, modelId, trigger) => this.localSessions.serverCtxRequest(provider, modelId, trigger),
+                emit: (name, payload) => this.events.emit(name, payload),
+                inspecting: () => this.inspecting,
+                dynamicTrustedHosts: (localAddress) => this.trustedHosts.groupFor(localAddress),
+                images: this.diffusion.imagesBackend(),
+                videos: this.diffusion.videosBackend(),
+                errors: parts.errors,
+            }),
+        });
+    }
+    get instanceId() {
+        return this.lock.instanceId;
+    }
+    /** Take ownership of a data folder and start the control listener. */
+    static create(options = {}) {
+        return createAtomicCore(options, (parts) => new AtomicCore(parts));
+    }
+    readyLine() {
+        return {
+            event: 'core:ready',
+            pid: process.pid,
+            instance_id: this.instanceId,
+            protocol: CONTROL_PROTOCOL_VERSION,
+            version: CORE_VERSION,
+            control_host: this.control.host,
+            control_port: this.control.port,
+        };
+    }
+    registry(provider = LOCAL_PROVIDER) {
+        const registry = this.registries.get(provider);
+        if (!registry)
+            throw unknownProvider(provider, this.registries.keys());
+        return registry;
+    }
+    runtime(provider = LOCAL_PROVIDER) {
+        const runtime = this.runtimes.get(provider);
+        if (!runtime)
+            throw unknownProvider(provider, this.runtimes.keys());
+        return runtime;
+    }
+    /** A llama.cpp runtime, for what only llama.cpp has (devices, runtime device info, context size). */
+    llamacpp(provider = 'llamacpp-upstream') {
+        const runtime = this.runtime(provider);
+        if (!(runtime instanceof LlamacppRuntime))
+            throw unknownProvider(provider, this.runtimes.keys());
+        return runtime;
+    }
+    sessions() {
+        return sessionsOf(this.runtimes);
+    }
+    async load(provider, modelId, options = {}) {
+        return (await this.acquire(provider, modelId, options)).session;
+    }
+    /** Load or attach without making an attaching client accidentally own the shared session. */
+    async acquire(provider, modelId, options = {}) {
+        this.assertRunning();
+        return this.reportingLoad(provider, modelId, options, () => this.localSessions.acquire(provider, modelId, options));
+    }
+    /**
+     * Reload a model with a larger context because a request did not fit. Guarded like `load`: the
+     * desktop app may still own this model, and reloading it here would take it from under the app.
+     */
+    async increaseCtx(provider, modelId, reason) {
+        this.assertRunning();
+        await assertNotLoadedByLegacy(this.layout, modelId);
+        return this.reportingLoad(provider, modelId, {}, () => this.runtime(provider).autoIncreaseCtx(modelId, reason));
+    }
+    /** Restart a poisoned engine at its current context; guarded like `load`. */
+    async recreateSession(provider, modelId) {
+        this.assertRunning();
+        await assertNotLoadedByLegacy(this.layout, modelId);
+        return this.reportingLoad(provider, modelId, {}, () => this.runtime(provider).recreateSession(modelId));
+    }
+    /**
+     * Cancel a load that has not answered yet. `false` when nothing is pending for the model — it has
+     * already loaded (unload it instead) or the load has not arrived.
+     */
+    cancelLoad(provider, modelId) {
+        this.assertRunning();
+        return this.localSessions.cancelLoad(provider, modelId);
+    }
+    async unload(provider, modelId) {
+        this.assertRunning();
+        return this.localSessions.unload(provider, modelId);
+    }
+    publicState() {
+        return this.publicServer.state();
+    }
+    /** Start the public listener; an identical start is idempotent, an incompatible one is a conflict. */
+    async startPublicServer(options = {}) {
+        this.assertRunning();
+        return this.publicServer.start(options);
+    }
+    async stopPublicServer() {
+        this.assertRunning();
+        return this.publicServer.stop();
+    }
+    remoteAccessStatus() {
+        return this.remoteAccess.status();
+    }
+    /** Open the tunnel; answers `starting` at once, the rest arrives as `remote-access:status`. */
+    startRemoteAccess() {
+        this.assertRunning();
+        return this.remoteAccess.start();
+    }
+    /** Close the tunnel; answers once its process is gone. */
+    async stopRemoteAccess() {
+        this.assertRunning();
+        return this.remoteAccess.stop();
+    }
+    /** Stop everything this core owns and release the lock last. */
+    async shutdown() {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        // Before anything that can wait: a public URL must not outlive the core that answers behind it.
+        this.remoteAccess.killNow();
+        this.lifecycle = 'stopping';
+        if (this.appLeaseTimer)
+            clearInterval(this.appLeaseTimer);
+        this.shutdownPromise = (async () => {
+            await this.publicServer.stop();
+            // A multi-gigabyte sd-server must not outlive the core; it goes before the chat runtimes.
+            await this.diffusion.shutdown();
+            for (const runtime of this.runtimes.values())
+                await runtime.shutdown();
+            await this.localSessions.releaseAll();
+            await this.control.close();
+            await this.lock.release();
+            this.lifecycle = 'stopped';
+            this.log('info', 'core stopped');
+            this.resolveStopped?.();
+        })();
+        return this.shutdownPromise;
+    }
+    /** Alias so the facade reads the same as the library docs. */
+    dispose() {
+        return this.shutdown();
+    }
+    /**
+     * Run a load (or a reload at another context) and report it when it fails, from whichever caller:
+     * the app, the public API, a remote client or the CLI. The error still reaches the caller.
+     */
+    async reportingLoad(provider, modelId, options, load) {
+        try {
+            return await load();
+        }
+        catch (error) {
+            if (this.errors) {
+                // The settings the runtime loads with, so the report names the backend and context it used.
+                let settings = {};
+                try {
+                    settings = this.settings.get(provider);
+                }
+                catch {
+                    // an unknown provider: the error being reported already says so
+                }
+                captureReport(this.errors, loadFailureReport({
+                    provider,
+                    modelId,
+                    error,
+                    overrides: { ...settings, ...options.overrides },
+                    isEmbedding: options.isEmbedding,
+                }));
+            }
+            throw error;
+        }
+    }
+    assertRunning() {
+        if (this.lifecycle !== 'running') {
+            throw new AtomicCoreError('CORE_NOT_RUNNING', 'The Atomic Chat core is stopping or has stopped.');
+        }
+    }
+}
+//# sourceMappingURL=atomic-core.js.map

package/dist/core/atomic-core.js.map

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

package/dist/core/create.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 type { AtomicCore, AtomicCoreParts } from './atomic-core.js';
+import type { AtomicCoreOptions } 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 declare function createAtomicCore(options: AtomicCoreOptions, construct: (parts: AtomicCoreParts) => AtomicCore): Promise<AtomicCore>;