@atomic-chat/core 0.5.1

package/dist/runtime/shared/external-sessions.js

@@ -0,0 +1,155 @@
+/**
+ * Sessions another process owns — the desktop app's TurboQuant, MLX and Foundation Models engines,
+ * and its llama.cpp upstream engine while that runtime is still the app's — registered with the core
+ * so the Local API Server it serves can route to them (PLAN.md §4, stage 4d).
+ *
+ * The owner publishes its whole list as a snapshot with a generation, and keeps it alive with
+ * heartbeats. A snapshot from an older generation is refused, so a restarted app cannot be
+ * overwritten by a request its previous run left in flight. A registration that stops beating
+ * expires and its sessions vanish from routing: the core never kills a process it does not own, it
+ * only stops sending traffic to it.
+ *
+ * Growing a registered session's context is the owner's job — it holds the process and its settings.
+ * The core asks with an event carrying a request id and waits for the owner's answer, with the same
+ * 60-second limit the app's own proxy gives its extension.
+ */
+import { randomUUID } from 'node:crypto';
+import { AtomicCoreError } from '../../contracts/index.js';
+export const EXTERNAL_SESSION_TTL_MS = 30_000;
+export const EXTERNAL_CTX_TIMEOUT_MS = 60_000;
+const PROVIDERS = new Set(['llamacpp', 'llamacpp-upstream', 'mlx', 'foundation-models']);
+export class ExternalSessions {
+    options;
+    owners = new Map();
+    pendingCtx = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    now() {
+        return (this.options.now ?? Date.now)();
+    }
+    live() {
+        const now = this.now();
+        for (const [owner, registration] of this.owners) {
+            if (registration.expiresAt <= now)
+                this.drop(owner, 'expired');
+        }
+        return [...this.owners];
+    }
+    drop(owner, reason) {
+        if (!this.owners.delete(owner))
+            return;
+        // Anyone waiting for this owner's answer will not get one.
+        for (const [id, pending] of this.pendingCtx) {
+            if (pending.owner === owner) {
+                this.pendingCtx.delete(id);
+                pending.resolve({ ok: false, reason: 'owner_gone' });
+            }
+        }
+        this.options.emit('external-sessions:changed', { owner, sessions: 0, reason });
+    }
+    /** Replace an owner's snapshot. An older generation than the one held is a stale request: refused. */
+    publish(owner, generation, sessions) {
+        if (!owner)
+            throw new AtomicCoreError('INVALID_ARGUMENT', 'an external session registration needs an owner');
+        if (!Number.isSafeInteger(generation) || generation < 0)
+            throw new AtomicCoreError('INVALID_ARGUMENT', 'generation must be a non-negative integer');
+        const current = this.owners.get(owner);
+        if (current && generation < current.generation)
+            throw new AtomicCoreError('CORE_ALREADY_RUNNING', `stale registration for ${owner}: generation ${generation} is older than ${current.generation}`);
+        const parsed = parseSessions(sessions);
+        this.owners.set(owner, {
+            generation,
+            sessions: parsed,
+            expiresAt: this.now() + (this.options.ttlMs ?? EXTERNAL_SESSION_TTL_MS),
+        });
+        this.options.emit('external-sessions:changed', { owner, sessions: parsed.length, reason: 'published' });
+        return { generation, sessions: parsed.length };
+    }
+    /** Keep a registration alive. A heartbeat for a generation that is no longer held says so. */
+    heartbeat(owner, generation) {
+        this.live();
+        const current = this.owners.get(owner);
+        if (!current || current.generation !== generation)
+            return { alive: false };
+        current.expiresAt = this.now() + (this.options.ttlMs ?? EXTERNAL_SESSION_TTL_MS);
+        return { alive: true };
+    }
+    unregister(owner, generation) {
+        const current = this.owners.get(owner);
+        if (!current || (generation !== undefined && current.generation !== generation))
+            return false;
+        this.drop(owner, 'unregistered');
+        return true;
+    }
+    /** Every live registered session, owner attached. */
+    list() {
+        return this.live().flatMap(([owner, registration]) => registration.sessions.map((s) => ({ ...s, owner })));
+    }
+    find(provider, matches) {
+        return this.list().find((s) => s.provider === provider && matches(s.model_id));
+    }
+    /** Ask the owner to grow a session's context, and wait for its answer or the timeout. */
+    requestCtxIncrease(owner, provider, modelId, trigger) {
+        const requestId = randomUUID();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                if (this.pendingCtx.delete(requestId))
+                    resolve({ ok: false, reason: 'timeout' });
+            }, this.options.ctxTimeoutMs ?? EXTERNAL_CTX_TIMEOUT_MS);
+            timer.unref?.();
+            this.pendingCtx.set(requestId, {
+                owner,
+                resolve: (outcome) => {
+                    clearTimeout(timer);
+                    resolve(outcome);
+                },
+            });
+            this.options.emit('external-sessions:ctx-requested', {
+                request_id: requestId,
+                owner,
+                provider,
+                model_id: modelId,
+                trigger,
+            });
+        });
+    }
+    /** The owner's answer. An unknown or already-answered request is not an error, only `false`. */
+    answerCtxIncrease(owner, requestId, outcome) {
+        const pending = this.pendingCtx.get(requestId);
+        if (!pending || pending.owner !== owner)
+            return false;
+        this.pendingCtx.delete(requestId);
+        const o = (outcome ?? {});
+        pending.resolve({
+            ok: o['ok'] === true,
+            ...(typeof o['new_ctx_len'] === 'number' ? { new_ctx_len: o['new_ctx_len'] } : {}),
+            ...(typeof o['reason'] === 'string' ? { reason: o['reason'] } : {}),
+        });
+        return true;
+    }
+}
+function parseSessions(raw) {
+    if (!Array.isArray(raw))
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'sessions must be a list');
+    return raw.map((entry, index) => {
+        const s = (entry ?? {});
+        const provider = s['provider'];
+        const port = s['port'];
+        if (typeof provider !== 'string' || !PROVIDERS.has(provider))
+            throw new AtomicCoreError('INVALID_ARGUMENT', `sessions[${index}].provider is not a local provider`);
+        if (typeof s['model_id'] !== 'string' || s['model_id'] === '')
+            throw new AtomicCoreError('INVALID_ARGUMENT', `sessions[${index}].model_id is missing`);
+        if (typeof port !== 'number' || !Number.isInteger(port) || port <= 0 || port > 65535)
+            throw new AtomicCoreError('INVALID_ARGUMENT', `sessions[${index}].port is not a port`);
+        return {
+            provider: provider,
+            model_id: s['model_id'],
+            port,
+            api_key: typeof s['api_key'] === 'string' ? s['api_key'] : '',
+            is_embedding: s['is_embedding'] === true,
+            pid: typeof s['pid'] === 'number' ? s['pid'] : null,
+        };
+    });
+}
+//# sourceMappingURL=external-sessions.js.map

package/dist/runtime/shared/external-sessions.js.map

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

package/dist/runtime/shared/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Process mechanics shared by every local backend: environment (library/CUDA paths), path
+ * validation, ports and API keys, spawn/readiness/termination. `llamacpp/`, `mlx/` and
+ * `foundation-models/` build on it.
+ *
+ * Ported from: tauri-plugin-llamacpp-upstream/src/{commands,process,path}.rs, utils/src/{system,network}.rs.
+ * See PLAN.md §3.2.
+ */
+export * from './env.js';
+export * from './paths.js';
+export * from './ports.js';
+export * from './process.js';
+export * from './load-cancel.js';
+export * from './external-sessions.js';
+export * from './local-runtime.js';
+export * from './sidecar.js';
+export * from './log-stream.js';

package/dist/runtime/shared/index.js

@@ -0,0 +1,18 @@
+/**
+ * Process mechanics shared by every local backend: environment (library/CUDA paths), path
+ * validation, ports and API keys, spawn/readiness/termination. `llamacpp/`, `mlx/` and
+ * `foundation-models/` build on it.
+ *
+ * Ported from: tauri-plugin-llamacpp-upstream/src/{commands,process,path}.rs, utils/src/{system,network}.rs.
+ * See PLAN.md §3.2.
+ */
+export * from './env.js';
+export * from './paths.js';
+export * from './ports.js';
+export * from './process.js';
+export * from './load-cancel.js';
+export * from './external-sessions.js';
+export * from './local-runtime.js';
+export * from './sidecar.js';
+export * from './log-stream.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/shared/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA"}

package/dist/runtime/shared/load-cancel.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Cancelling a model load before its engine reports ready.
+ *
+ * A load only becomes a session — something `unload` can find — once the server says it is ready,
+ * which can be minutes for a large model over a cold page cache. Until then the child belongs to the
+ * load alone, so "stop this model" had nothing to act on.
+ *
+ * Ported from the app's `src-tauri/utils/src/load_cancel.rs` (image-generation line, `767ff6350`),
+ * with one deliberate difference. The Rust registry replaced a model's token on every new load. In
+ * the core, acquires of one model are serialized, so the newest registration is always a queued
+ * follower and a cancel aimed at it would miss the load that is actually spawning. Here every
+ * pending load of a key shares one entry, and a fresh one starts only after an abort — which keeps
+ * the Rust guarantees: a finished load never unregisters a newer one, and a new load never inherits
+ * an earlier cancel (ADR 2026-09-17-cancel-a-model-load-through-a-shared-registry).
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+/** The app's wording, verbatim: its UI treats this code as a user stop, not a failure. */
+export declare const MODEL_LOAD_CANCELLED_MESSAGE = "The model load was cancelled.";
+export declare function loadCancelledError(): AtomicCoreError;
+/** Whether the load was cancelled. A caller with no way to cancel (the CLI, a reload) never is. */
+export declare function isLoadCancelled(signal?: AbortSignal): boolean;
+export declare function throwIfLoadCancelled(signal?: AbortSignal): void;
+/**
+ * Settle with `work`, or reject with `MODEL_LOAD_CANCELLED` as soon as `signal` aborts — the
+ * `select!` arm of the Rust loads. The abandoned work keeps running; its outcome is swallowed so a
+ * later rejection is not an unhandled one.
+ */
+export declare function raceLoadCancel<T>(work: Promise<T>, signal?: AbortSignal): Promise<T>;
+/** A pending load's hold on its key: the signal to watch, and the release that ends the hold. */
+export interface LoadCancelHandle {
+    signal: AbortSignal;
+    /** Idempotent. The entry goes once its last holder releases, unless a newer one replaced it. */
+    release: () => void;
+}
+export declare class LoadCancelRegistry {
+    private readonly loads;
+    /**
+     * Hold `key` for one pending load. Loads waiting on the same key share an entry, so one cancel
+     * reaches whichever of them is running; an entry that was already cancelled is replaced rather
+     * than joined, so the new load starts clean.
+     */
+    register(key: string): LoadCancelHandle;
+    /** Cancel the loads pending for `key`. `false` means nothing is in flight there. */
+    cancel(key: string): boolean;
+}

package/dist/runtime/shared/load-cancel.js

@@ -0,0 +1,95 @@
+/**
+ * Cancelling a model load before its engine reports ready.
+ *
+ * A load only becomes a session — something `unload` can find — once the server says it is ready,
+ * which can be minutes for a large model over a cold page cache. Until then the child belongs to the
+ * load alone, so "stop this model" had nothing to act on.
+ *
+ * Ported from the app's `src-tauri/utils/src/load_cancel.rs` (image-generation line, `767ff6350`),
+ * with one deliberate difference. The Rust registry replaced a model's token on every new load. In
+ * the core, acquires of one model are serialized, so the newest registration is always a queued
+ * follower and a cancel aimed at it would miss the load that is actually spawning. Here every
+ * pending load of a key shares one entry, and a fresh one starts only after an abort — which keeps
+ * the Rust guarantees: a finished load never unregisters a newer one, and a new load never inherits
+ * an earlier cancel (ADR 2026-09-17-cancel-a-model-load-through-a-shared-registry).
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+/** The app's wording, verbatim: its UI treats this code as a user stop, not a failure. */
+export const MODEL_LOAD_CANCELLED_MESSAGE = 'The model load was cancelled.';
+export function loadCancelledError() {
+    return new AtomicCoreError('MODEL_LOAD_CANCELLED', MODEL_LOAD_CANCELLED_MESSAGE);
+}
+/** Whether the load was cancelled. A caller with no way to cancel (the CLI, a reload) never is. */
+export function isLoadCancelled(signal) {
+    return signal?.aborted === true;
+}
+export function throwIfLoadCancelled(signal) {
+    if (isLoadCancelled(signal))
+        throw loadCancelledError();
+}
+/**
+ * Settle with `work`, or reject with `MODEL_LOAD_CANCELLED` as soon as `signal` aborts — the
+ * `select!` arm of the Rust loads. The abandoned work keeps running; its outcome is swallowed so a
+ * later rejection is not an unhandled one.
+ */
+export function raceLoadCancel(work, signal) {
+    if (!signal)
+        return work;
+    if (signal.aborted) {
+        work.catch(() => { });
+        return Promise.reject(loadCancelledError());
+    }
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            work.catch(() => { });
+            reject(loadCancelledError());
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        work.then((value) => {
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+export class LoadCancelRegistry {
+    loads = new Map();
+    /**
+     * Hold `key` for one pending load. Loads waiting on the same key share an entry, so one cancel
+     * reaches whichever of them is running; an entry that was already cancelled is replaced rather
+     * than joined, so the new load starts clean.
+     */
+    register(key) {
+        let entry = this.loads.get(key);
+        if (!entry || entry.controller.signal.aborted) {
+            entry = { controller: new AbortController(), holders: 0 };
+            this.loads.set(key, entry);
+        }
+        entry.holders++;
+        const held = entry;
+        let released = false;
+        return {
+            signal: held.controller.signal,
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                held.holders--;
+                // A newer load of the same key may have registered meanwhile; its entry is not ours to remove.
+                if (held.holders === 0 && this.loads.get(key) === held)
+                    this.loads.delete(key);
+            },
+        };
+    }
+    /** Cancel the loads pending for `key`. `false` means nothing is in flight there. */
+    cancel(key) {
+        const entry = this.loads.get(key);
+        if (!entry)
+            return false;
+        entry.controller.abort();
+        return true;
+    }
+}
+//# sourceMappingURL=load-cancel.js.map

package/dist/runtime/shared/load-cancel.js.map

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

package/dist/runtime/shared/local-runtime.d.ts

@@ -0,0 +1,68 @@
+/**
+ * What the owner asks of every local runtime — llama.cpp (both providers), MLX and Foundation
+ * Models — so the facade, the control API and the public server hold them in one table and never
+ * branch on which engine a session belongs to (PLAN.md §3.2, stage 5).
+ *
+ * The semantics are the core's, shared by every provider rather than copied from each extension:
+ * loading a model that is already loaded answers with its session (a second client attaching is not
+ * an error), and unloading one that is not loaded succeeds. The desktop extensions threw in both
+ * cases; their adapters keep that wording for the webview where it matters.
+ */
+import type { LocalProviderId, SessionInfo, UnloadResult } from '../../contracts/index.js';
+/** What `autoIncreaseCtx` did, or why it declined to do anything. */
+export type CtxIncreaseResult = {
+    ok: true;
+    new_ctx_len: number;
+    session: SessionInfo;
+} | {
+    ok: false;
+    /**
+     * `fit`: llama.cpp sizes the window itself. `at_max`: the model's trained context is reached.
+     * `unsupported`: the engine has no context setting to grow (Foundation Models).
+     */
+    reason: 'fit' | 'at_max' | 'not-loaded' | 'unsupported';
+    current_ctx_len?: number;
+    max_ctx_len?: number;
+};
+export type RecreateResult = {
+    ok: true;
+    session: SessionInfo;
+} | {
+    ok: false;
+    reason: 'not-loaded';
+};
+/** Options every runtime understands; each one reads the keys of `overrides` that are its own. */
+export interface LocalLoadOptions {
+    /** Per-model settings, canonical keys (the `settings` argument of an extension's `load()`). */
+    overrides?: Record<string, unknown>;
+    isEmbedding?: boolean;
+    /** Use this executable instead of resolving one (CLI `--bin`, or a resources folder). */
+    exePath?: string;
+    /** Readiness timeout in seconds. */
+    timeoutSecs?: number;
+    /** Append backend stdout/stderr to this path for the lifetime of the session. */
+    logPath?: string;
+    /** Relay backend stdout/stderr through `core:log` events. */
+    verbose?: boolean;
+    /** Bind the backend to this port instead of a random free one. */
+    port?: number;
+    /** Skip the auto-unload of other models of this provider. */
+    bypassAutoUnload?: boolean;
+    /**
+     * Aborted when the user cancels this load: the runtime kills what it started and rejects with
+     * `MODEL_LOAD_CANCELLED`. Owner shutdown has its own signal and keeps its own error.
+     */
+    signal?: AbortSignal;
+}
+export interface LocalRuntime {
+    list(): SessionInfo[];
+    findSession(modelId: string): SessionInfo | undefined;
+    getLoadedModels(): string[];
+    isLoading(modelId: string): boolean;
+    load(modelId: string, opts?: LocalLoadOptions): Promise<SessionInfo>;
+    unload(modelId: string): Promise<UnloadResult>;
+    autoIncreaseCtx(modelId: string, reason?: string): Promise<CtxIncreaseResult>;
+    recreateSession(modelId: string): Promise<RecreateResult>;
+    shutdown(): Promise<void>;
+}
+export type { LocalProviderId };

package/dist/runtime/shared/local-runtime.js

@@ -0,0 +1,12 @@
+/**
+ * What the owner asks of every local runtime — llama.cpp (both providers), MLX and Foundation
+ * Models — so the facade, the control API and the public server hold them in one table and never
+ * branch on which engine a session belongs to (PLAN.md §3.2, stage 5).
+ *
+ * The semantics are the core's, shared by every provider rather than copied from each extension:
+ * loading a model that is already loaded answers with its session (a second client attaching is not
+ * an error), and unloading one that is not loaded succeeds. The desktop extensions threw in both
+ * cases; their adapters keep that wording for the webview where it matters.
+ */
+export {};
+//# sourceMappingURL=local-runtime.js.map

package/dist/runtime/shared/local-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-runtime.js","sourceRoot":"","sources":["../../../src/runtime/shared/local-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/runtime/shared/log-stream.d.ts

@@ -0,0 +1,4 @@
+/** The per-session backend log a CLI `--log` / `--detach` asks for, shared by every runtime. */
+import type { WriteStream } from 'node:fs';
+export declare function openLogStream(path: string, engine?: string): Promise<WriteStream>;
+export declare function closeLogStream(stream: WriteStream | undefined): Promise<void>;

package/dist/runtime/shared/log-stream.js

@@ -0,0 +1,28 @@
+/** The per-session backend log a CLI `--log` / `--detach` asks for, shared by every runtime. */
+import { createWriteStream } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+export async function openLogStream(path, engine = 'llama.cpp') {
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        const stream = createWriteStream(path, { flags: 'a' });
+        await new Promise((resolve, reject) => {
+            stream.once('open', () => resolve());
+            stream.once('error', reject);
+        });
+        // A later disk error cannot retroactively fail a running model, but it must not become an
+        // unhandled EventEmitter error either.
+        stream.on('error', () => { });
+        return stream;
+    }
+    catch (error) {
+        throw new AtomicCoreError('IO_ERROR', `Cannot open ${engine} log file "${path}".`, error.message);
+    }
+}
+export function closeLogStream(stream) {
+    if (!stream || stream.closed)
+        return Promise.resolve();
+    return new Promise((resolve) => stream.end(resolve));
+}
+//# sourceMappingURL=log-stream.js.map

package/dist/runtime/shared/log-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-stream.js","sourceRoot":"","sources":["../../../src/runtime/shared/log-stream.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE1D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,MAAM,GAAG,WAAW;IACpE,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;QACtD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YACpC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;QACF,0FAA0F;QAC1F,uCAAuC;QACvC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC5B,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CACvB,UAAU,EACV,eAAe,MAAM,cAAc,IAAI,IAAI,EAC1C,KAAe,CAAC,OAAO,CACzB,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC5D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;AACtD,CAAC"}

package/dist/runtime/shared/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Path checks performed right before spawning. Port of
+ * `src-tauri/plugins/tauri-plugin-llamacpp-upstream/src/path.rs`.
+ *
+ * On Windows, non-ASCII model paths are passed as 8.3 short paths (llama.cpp opens files through
+ * ANSI APIs), except for split shards whose `-NNNNN-of-NNNNN` marker the mangling would destroy.
+ */
+export interface PathDeps {
+    platform: NodeJS.Platform;
+    exists: (path: string) => Promise<boolean>;
+    /** 8.3 short path on Windows (`GetShortPathNameW`); `undefined` when unavailable. */
+    shortPath?: (path: string) => Promise<string | undefined>;
+}
+export declare function needsShortPath(path: string): boolean;
+/** `*-NNNNN-of-NNNNN.gguf`, case-insensitive on the extension. */
+export declare function isSplitGgufName(fileName: string): boolean;
+export declare function validateBinaryPath(backendPath: string, deps: Pick<PathDeps, 'exists'>): Promise<string>;
+/** Validate `-m <path>` in argv, rewrite it for the platform, return the validated path. */
+export declare function validateModelArgs(args: string[], deps: PathDeps): Promise<string>;
+/** Validate `--mmproj <path>` when present; `undefined` when the flag is absent. */
+export declare function validateMmprojArgs(args: string[], deps: PathDeps): Promise<string | undefined>;

package/dist/runtime/shared/paths.js

@@ -0,0 +1,63 @@
+/**
+ * Path checks performed right before spawning. Port of
+ * `src-tauri/plugins/tauri-plugin-llamacpp-upstream/src/path.rs`.
+ *
+ * On Windows, non-ASCII model paths are passed as 8.3 short paths (llama.cpp opens files through
+ * ANSI APIs), except for split shards whose `-NNNNN-of-NNNNN` marker the mangling would destroy.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+export function needsShortPath(path) {
+    // eslint-disable-next-line no-control-regex
+    return !/^[\x00-\x7F]*$/.test(path);
+}
+/** `*-NNNNN-of-NNNNN.gguf`, case-insensitive on the extension. */
+export function isSplitGgufName(fileName) {
+    const lower = fileName.toLowerCase();
+    if (!lower.endsWith('.gguf'))
+        return false;
+    const stem = lower.slice(0, -'.gguf'.length);
+    if (stem.length < 15)
+        return false;
+    return /-\d{5}-of-\d{5}$/.test(stem);
+}
+export async function validateBinaryPath(backendPath, deps) {
+    if (!(await deps.exists(backendPath))) {
+        throw new AtomicCoreError('BINARY_NOT_FOUND', 'The llama.cpp server binary could not be found.', `Binary not found at ${JSON.stringify(backendPath)}`);
+    }
+    return backendPath;
+}
+async function platformPath(path, isSplit, deps) {
+    if (deps.platform !== 'win32' || isSplit || !needsShortPath(path) || !deps.shortPath)
+        return path;
+    return (await deps.shortPath(path)) ?? path;
+}
+/** Validate `-m <path>` in argv, rewrite it for the platform, return the validated path. */
+export async function validateModelArgs(args, deps) {
+    const i = args.indexOf('-m');
+    if (i < 0)
+        throw new AtomicCoreError('MODEL_LOAD_FAILED', "Model path argument '-m' is missing.");
+    const modelPath = args[i + 1];
+    if (modelPath === undefined)
+        throw new AtomicCoreError('MODEL_LOAD_FAILED', "Model path was not provided after '-m' flag.");
+    if (!(await deps.exists(modelPath))) {
+        throw new AtomicCoreError('MODEL_FILE_NOT_FOUND', 'The specified model file does not exist or is not accessible.', `Invalid or inaccessible model path: ${modelPath}`);
+    }
+    const fileName = modelPath.split(/[\\/]/).pop() ?? '';
+    args[i + 1] = await platformPath(modelPath, isSplitGgufName(fileName), deps);
+    return modelPath;
+}
+/** Validate `--mmproj <path>` when present; `undefined` when the flag is absent. */
+export async function validateMmprojArgs(args, deps) {
+    const i = args.indexOf('--mmproj');
+    if (i < 0)
+        return undefined;
+    const mmproj = args[i + 1];
+    if (mmproj === undefined)
+        throw new AtomicCoreError('MODEL_LOAD_FAILED', "Mmproj path was not provided after '--mmproj' flag.");
+    if (!(await deps.exists(mmproj))) {
+        throw new AtomicCoreError('MODEL_FILE_NOT_FOUND', 'The specified mmproj file does not exist or is not accessible.', `Invalid or inaccessible mmproj path: ${mmproj}`);
+    }
+    args[i + 1] = await platformPath(mmproj, false, deps);
+    return mmproj;
+}
+//# sourceMappingURL=paths.js.map

package/dist/runtime/shared/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/runtime/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAS1D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,4CAA4C;IAC5C,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACrC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;IACpC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAA;IAClC,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,IAA8B;IAE9B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,iDAAiD,EACjD,uBAAuB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CACrD,CAAA;IACH,CAAC;IACD,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAgB,EAAE,IAAc;IACxE,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IACjG,OAAO,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAA;AAC7C,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAc,EAAE,IAAc;IACpE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,sCAAsC,CAAC,CAAA;IACjG,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7B,IAAI,SAAS,KAAK,SAAS;QACzB,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,8CAA8C,CAAC,CAAA;IAChG,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,eAAe,CACvB,sBAAsB,EACtB,+DAA+D,EAC/D,uCAAuC,SAAS,EAAE,CACnD,CAAA;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;IACrD,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAA;IAC5E,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAc,EAAE,IAAc;IACrE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAClC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1B,IAAI,MAAM,KAAK,SAAS;QACtB,MAAM,IAAI,eAAe,CAAC,mBAAmB,EAAE,qDAAqD,CAAC,CAAA;IACvG,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,eAAe,CACvB,sBAAsB,EACtB,gEAAgE,EAChE,wCAAwC,MAAM,EAAE,CACjD,CAAA;IACH,CAAC;IACD,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IACrD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/runtime/shared/ports.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Session port selection and the per-session API key. Port of `generate_random_port` in
+ * `src-tauri/utils/src/network.rs` and `generate_api_key` in the plugin's `commands.rs`.
+ */
+export declare const PORT_RANGE_MIN = 3000;
+export declare const PORT_RANGE_MAX = 4000;
+export declare const PORT_MAX_ATTEMPTS = 20000;
+export declare const PORT_EXHAUSTED_MESSAGE = "Failed to find an available port for the model to load";
+/** Bind-and-release probe on 127.0.0.1 (inherently racy, as in the original). */
+export declare function isPortAvailable(port: number): Promise<boolean>;
+export interface PortOptions {
+    min?: number;
+    max?: number;
+    attempts?: number;
+    random?: (min: number, max: number) => number;
+    isAvailable?: (port: number) => Promise<boolean>;
+}
+/** A random port in [3000, 4000) that no session uses and that binds. */
+export declare function randomFreePort(usedPorts: Iterable<number>, opts?: PortOptions): Promise<number>;
+/** Secret the extension has always used for session keys (`index.ts:531`). */
+export declare const DEFAULT_API_SECRET = "JustAskNow";
+/**
+ * base64(HMAC-SHA256(secret, modelId + port)) — what the process gets as `LLAMA_API_KEY`. The
+ * extension concatenates the port onto the model id before calling the Rust HMAC (`index.ts:3195`).
+ */
+export declare function generateApiKey(modelId: string, port: number | string, secret?: string): string;