@atomic-chat/core 0.17.0 → 0.18.4

package/dist/runtime/foundry-local/host-process.js

@@ -0,0 +1,185 @@
+/**
+ * The core's side of the `foundry-host` protocol (openspec change `add-foundry-local`, design D1):
+ * the host is this very binary in a hidden mode, started with `process.execPath`, so a crash of
+ * Microsoft's native library never takes the core down. `probe` loads the library of one build and
+ * prints one JSON line: the C API version and the accelerators it finds, prepared or not.
+ */
+import { spawn } from 'node:child_process';
+import { AtomicCoreError } from '../../contracts/index.js';
+/** The first run of a freshly unpacked library is scanned by Gatekeeper / Defender. */
+export const FOUNDRY_HOST_PROBE_TIMEOUT_MS = 60_000;
+const OUTPUT_LIMIT = 64 * 1024;
+function parseProbeLine(line) {
+    let raw;
+    try {
+        raw = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const { c_api_version, version, accelerators } = raw;
+    if (typeof c_api_version !== 'number' || !Array.isArray(accelerators))
+        return null;
+    const out = [];
+    for (const item of accelerators) {
+        if (item === null || typeof item !== 'object')
+            return null;
+        const { name, device, prepared, execution_provider } = item;
+        if (typeof name !== 'string' || typeof device !== 'string' || typeof prepared !== 'boolean')
+            return null;
+        out.push({
+            name,
+            ...(typeof execution_provider === 'string' || execution_provider === null
+                ? { execution_provider }
+                : {}),
+            device,
+            prepared,
+        });
+    }
+    return { c_api_version, ...(typeof version === 'string' ? { version } : {}), accelerators: out };
+}
+/**
+ * `foundry-host probe --lib <libDir> --app-data <appDataDir>`. Throws `ENGINE_INSTALL_FAILED` with
+ * what the host printed when it exits non-zero, prints no answer or does not answer in time.
+ */
+export function runFoundryHostProbe(command, target, options = {}) {
+    const args = [
+        ...command.args,
+        'probe',
+        '--lib',
+        target.libDir,
+        '--app-data',
+        target.appDataDir,
+        '--logs',
+        target.logsDir,
+        ...(target.prepared ?? []).flatMap((name) => ['--prepared', name]),
+    ];
+    return new Promise((resolve, reject) => {
+        const child = spawn(command.exe, args, {
+            env: options.env ?? process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        const keep = (buffer, chunk) => (buffer + chunk.toString('utf8')).slice(-OUTPUT_LIMIT);
+        child.stdout.on('data', (chunk) => (stdout = keep(stdout, chunk)));
+        child.stderr.on('data', (chunk) => (stderr = keep(stderr, chunk)));
+        const timeoutMs = options.timeoutMs ?? FOUNDRY_HOST_PROBE_TIMEOUT_MS;
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            reject(new AtomicCoreError('ENGINE_INSTALL_FAILED', 'The Foundry Local host did not answer.', `probe of ${target.libDir} timed out after ${Math.round(timeoutMs / 1000)}s`));
+        }, timeoutMs);
+        child.on('error', (error) => {
+            clearTimeout(timer);
+            reject(new AtomicCoreError('ENGINE_INSTALL_FAILED', 'The Foundry Local host could not be started.', String(error)));
+        });
+        child.on('close', (code, signal) => {
+            clearTimeout(timer);
+            const answer = stdout
+                .split(/\r?\n/)
+                .reverse()
+                .map((line) => line.trim())
+                .filter(Boolean)
+                .map(parseProbeLine)
+                .find((parsed) => parsed !== null);
+            if (code === 0 && answer)
+                return resolve(answer);
+            const status = code !== null ? `exit code ${code}` : `signal ${String(signal)}`;
+            reject(new AtomicCoreError('ENGINE_INSTALL_FAILED', 'The Foundry Local library does not load on this computer.', `${status}\n${[...(stderr || stdout)].slice(-800).join('')}`.trim()));
+        });
+    });
+}
+/**
+ * Test hook only, the same kind as `ATOMIC_MANAGED_TEST_HOST`: an executable that stands in for
+ * `atomic-chat-core foundry-host` in the e2e suite, where no real Foundry Local library exists.
+ * Production never sets it.
+ */
+export const FOUNDRY_HOST_TEST_COMMAND_ENV = 'ATOMIC_FOUNDRY_HOST_TEST_COMMAND';
+/**
+ * This binary in its `foundry-host` mode: `process.execPath` (inside a compiled Bun binary that is
+ * the binary; under a runtime, the runtime plus the entry script, as `selfCommand` in the CLI does).
+ * That binary may be a program embedding the core as a library (`atc`): it must hand an `argv` of
+ * `foundry-host …` to `runFoundryHostMain` (`@atomic-chat/core/foundry-host`) before its own commands,
+ * as the core binaries do (change close-cli-core-gaps, design D1).
+ */
+export function foundryHostCommand(env, argv = process.argv, execPath = process.execPath) {
+    const stand = env[FOUNDRY_HOST_TEST_COMMAND_ENV]?.trim();
+    if (stand)
+        return { exe: stand, args: [] };
+    const script = argv[1];
+    const viaRuntime = script !== undefined && /\.(c|m)?[jt]s$/.test(script);
+    return { exe: execPath, args: [...(viaRuntime ? [script] : []), 'foundry-host'] };
+}
+function parseStep(raw) {
+    const { accelerator, stage, fraction, reason } = raw;
+    if (typeof accelerator !== 'string')
+        return null;
+    if (stage !== 'started' && stage !== 'downloading' && stage !== 'done' && stage !== 'failed')
+        return null;
+    if (fraction !== null && typeof fraction !== 'number')
+        return null;
+    return { accelerator, stage, fraction, ...(typeof reason === 'string' ? { reason } : {}) };
+}
+/**
+ * `foundry-host prepare --lib --app-data --logs [names…]`: each step to `onStep` as it happens, the
+ * summary as the result. No timeout: a CUDA plugin is 2 GB (rulings S2). A host that exits non-zero
+ * or prints no summary is `FOUNDRY_LOCAL_HOST_ERROR` with what it said.
+ */
+export function runFoundryHostPrepare(command, target, names, onStep, options = {}) {
+    const args = [
+        ...command.args,
+        'prepare',
+        '--lib',
+        target.libDir,
+        '--app-data',
+        target.appDataDir,
+        '--logs',
+        target.logsDir,
+        ...names,
+    ];
+    return new Promise((resolve, reject) => {
+        const child = spawn(command.exe, args, {
+            env: options.env ?? process.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        let summary = null;
+        let stderr = '';
+        child.stderr.on('data', (chunk) => (stderr = (stderr + chunk.toString('utf8')).slice(-OUTPUT_LIMIT)));
+        let pending = '';
+        child.stdout.on('data', (chunk) => {
+            pending += chunk.toString('utf8');
+            const lines = pending.split(/\r?\n/);
+            pending = lines.pop() ?? '';
+            for (const line of lines) {
+                let raw;
+                try {
+                    raw = JSON.parse(line);
+                }
+                catch {
+                    continue;
+                }
+                if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+                    continue;
+                const record = raw;
+                if (record['done'] === true && Array.isArray(record['accelerators'])) {
+                    summary = { accelerators: record['accelerators'] };
+                    continue;
+                }
+                const step = parseStep(record);
+                if (step)
+                    onStep(step);
+            }
+        });
+        child.on('error', (error) => reject(new AtomicCoreError('FOUNDRY_LOCAL_HOST_ERROR', 'The Foundry Local host could not be started.', String(error))));
+        child.on('close', (code) => {
+            if (code === 0 && summary)
+                return resolve(summary);
+            reject(new AtomicCoreError('FOUNDRY_LOCAL_HOST_ERROR', 'The Foundry Local host could not prepare the accelerators.', `exit code ${String(code)}\n${[...stderr].slice(-800).join('')}`.trim()));
+        });
+    });
+}
+//# sourceMappingURL=host-process.js.map

package/dist/runtime/foundry-local/host-process.js.map

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

package/dist/runtime/foundry-local/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The `foundry-local` provider (openspec change `add-foundry-local`): the core's side of the
+ * `foundry-host` protocol for now; the runtime, the host mode and the accelerators follow.
+ */
+export * from './host-process.js';
+export * from './model-yml.js';
+export type { FoundryHostDeps } from './host/run.js';
+export * from './runtime.js';
+export * from './accelerators.js';
+export * from './check.js';

package/dist/runtime/foundry-local/index.js

@@ -0,0 +1,10 @@
+/**
+ * The `foundry-local` provider (openspec change `add-foundry-local`): the core's side of the
+ * `foundry-host` protocol for now; the runtime, the host mode and the accelerators follow.
+ */
+export * from './host-process.js';
+export * from './model-yml.js';
+export * from './runtime.js';
+export * from './accelerators.js';
+export * from './check.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/foundry-local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/foundry-local/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAE9B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA"}

package/dist/runtime/foundry-local/model-yml.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The `foundry_local` block of a Foundry Local model's `model.yml` (openspec change
+ * `add-foundry-local`, task 6.2). The core never writes it — the app's installer does — and reads it
+ * strictly: an accelerator or device this core does not know is a variant it cannot run
+ * (`FOUNDRY_LOCAL_VARIANT_UNSUPPORTED`), anything else malformed is a broken file (`MODEL_LOAD_FAILED`).
+ */
+import type { ModelYmlFoundryLocal } from '../../contracts/index.js';
+export declare function readFoundryLocalBlock(doc: Record<string, unknown>): ModelYmlFoundryLocal;

package/dist/runtime/foundry-local/model-yml.js

@@ -0,0 +1,63 @@
+/**
+ * The `foundry_local` block of a Foundry Local model's `model.yml` (openspec change
+ * `add-foundry-local`, task 6.2). The core never writes it — the app's installer does — and reads it
+ * strictly: an accelerator or device this core does not know is a variant it cannot run
+ * (`FOUNDRY_LOCAL_VARIANT_UNSUPPORTED`), anything else malformed is a broken file (`MODEL_LOAD_FAILED`).
+ */
+import { AtomicCoreError, FOUNDRY_LOCAL_DEVICES, FOUNDRY_LOCAL_EXECUTION_PROVIDERS, } from '../../contracts/index.js';
+const broken = (why) => new AtomicCoreError('MODEL_LOAD_FAILED', `model.yml: foundry_local ${why}.`);
+const text = (block, key) => {
+    const value = block[key];
+    if (typeof value !== 'string' || value.trim() === '')
+        throw broken(`has no ${key}`);
+    return value;
+};
+const optionalText = (block, key) => {
+    const value = block[key];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value === '')
+        throw broken(`has a ${key} that is not text`);
+    return value;
+};
+const flag = (block, key) => {
+    const value = block[key];
+    if (value === undefined)
+        return false;
+    if (typeof value !== 'boolean')
+        throw broken(`has a ${key} that is not true or false`);
+    return value;
+};
+export function readFoundryLocalBlock(doc) {
+    const raw = doc['foundry_local'];
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        throw broken('is missing');
+    const block = raw;
+    const executionProvider = text(block, 'execution_provider');
+    if (!FOUNDRY_LOCAL_EXECUTION_PROVIDERS.some((known) => known === executionProvider))
+        throw new AtomicCoreError('FOUNDRY_LOCAL_VARIANT_UNSUPPORTED', `This core does not run Foundry Local variants on the "${executionProvider}" accelerator.`);
+    const device = text(block, 'device');
+    if (!FOUNDRY_LOCAL_DEVICES.some((known) => known === device))
+        throw new AtomicCoreError('FOUNDRY_LOCAL_VARIANT_UNSUPPORTED', `This core does not run Foundry Local variants on a "${device}" device.`);
+    const context = block['context_length'];
+    if (context !== undefined && (typeof context !== 'number' || !Number.isSafeInteger(context) || context < 1))
+        throw broken('has a context_length that is not a positive whole number');
+    const assetId = optionalText(block, 'asset_id');
+    const assetVersion = optionalText(block, 'asset_version');
+    const reasoningStart = optionalText(block, 'reasoning_start');
+    const reasoningEnd = optionalText(block, 'reasoning_end');
+    return {
+        model_id: text(block, 'model_id'),
+        variant_id: text(block, 'variant_id'),
+        execution_provider: executionProvider,
+        device: device,
+        ...(assetId !== undefined ? { asset_id: assetId } : {}),
+        ...(assetVersion !== undefined ? { asset_version: assetVersion } : {}),
+        ...(context !== undefined ? { context_length: context } : {}),
+        tools: flag(block, 'tools'),
+        reasoning: flag(block, 'reasoning'),
+        ...(reasoningStart !== undefined ? { reasoning_start: reasoningStart } : {}),
+        ...(reasoningEnd !== undefined ? { reasoning_end: reasoningEnd } : {}),
+    };
+}
+//# sourceMappingURL=model-yml.js.map

package/dist/runtime/foundry-local/model-yml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-yml.js","sourceRoot":"","sources":["../../../src/runtime/foundry-local/model-yml.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,0BAA0B,CAAA;AAOjC,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,mBAAmB,EAAE,4BAA4B,GAAG,GAAG,CAAC,CAAA;AAE5G,MAAM,IAAI,GAAG,CAAC,KAA8B,EAAE,GAAW,EAAU,EAAE;IACnE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC,CAAA;IACnF,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,KAA8B,EAAE,GAAW,EAAsB,EAAE;IACvF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;QAAE,MAAM,MAAM,CAAC,SAAS,GAAG,mBAAmB,CAAC,CAAA;IAC5F,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,IAAI,GAAG,CAAC,KAA8B,EAAE,GAAW,EAAW,EAAE;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACrC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,MAAM,CAAC,SAAS,GAAG,4BAA4B,CAAC,CAAA;IACtF,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,UAAU,qBAAqB,CAAC,GAA4B;IAChE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,CAAA;IAChC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,MAAM,MAAM,CAAC,YAAY,CAAC,CAAA;IAC7F,MAAM,KAAK,GAAG,GAA8B,CAAA;IAC5C,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;IAC3D,IAAI,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,iBAAiB,CAAC;QACjF,MAAM,IAAI,eAAe,CACvB,mCAAmC,EACnC,yDAAyD,iBAAiB,gBAAgB,CAC3F,CAAA;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACpC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC;QAC1D,MAAM,IAAI,eAAe,CACvB,mCAAmC,EACnC,uDAAuD,MAAM,WAAW,CACzE,CAAA;IACH,MAAM,OAAO,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAA;IACvC,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;QACzG,MAAM,MAAM,CAAC,0DAA0D,CAAC,CAAA;IAC1E,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAC/C,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,CAAA;IACzD,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;IAC7D,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,CAAA;IACzD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC;QACjC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;QACrC,kBAAkB,EAAE,iBAAkD;QACtE,MAAM,EAAE,MAA4B;QACpC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QAC3B,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;QACnC,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,88 @@
+/**
+ * The `foundry-local` provider's sessions (openspec change `add-foundry-local`, task 6.3, design D5):
+ * one `foundry-host serve` process per model — this very binary in its hidden mode — on the sidecar
+ * table MLX and Foundation Models use, behind the session gateway the managed engines use.
+ *
+ *   load = model.yml → the variant runs on this platform → its accelerator is prepared → the active
+ *          build → [GPU claim, for CUDA and WebGPU] → host on a random loopback port → readiness
+ *          line → gateway (key + Host) → session on the gateway's port
+ *
+ * Foundry Local's built-in server has no authentication and serves the local catalog under
+ * `/catalogs/local` with models named `<name>:<version>` (spike, rulings S1 finding 7): the gateway
+ * holds the key, adds the prefix and renames the model both ways, so a client sees the core's model id.
+ */
+import type { ModelYmlFoundryLocal, SessionInfo, UnloadResult } from '../../contracts/index.js';
+import type { DataLayout } from '../../config/index.js';
+import type { EngineHost } from '../../engine-builds/service.js';
+import type { ProcessJournal } from '../../lock/index.js';
+import type { ModelRegistry } from '../../models/index.js';
+import type { ManagedRoute } from '../managed-text/index.js';
+import type { CtxIncreaseResult, EmitFn, GpuClaimHook, GpuOccupancy, LocalLoadOptions, LocalRuntime, RecreateResult, SessionRoutePolicy } from '../shared/index.js';
+import { spawnAndAwaitReady } from '../shared/index.js';
+import type { BackendOutputSink } from '../shared/index.js';
+import type { FoundryHostCommand } from './host-process.js';
+/** The settings' `timeout` default, in seconds: registering, building the ORT session, compiling (OpenVINO). */
+export declare const FOUNDRY_LOCAL_DEFAULT_TIMEOUT_SECS = 600;
+/** What a Foundry Local session serves (design D5); anything else is refused before it reaches the host. */
+export declare const FOUNDRY_LOCAL_ROUTES: readonly ManagedRoute[];
+/**
+ * The accelerators each platform runs variants on (spec "Провайдер регистрируется только на
+ * поддерживаемых платформах"). Which of them this machine actually has is the probe's answer (6.4).
+ */
+export declare function variantRunsOn(platform: NodeJS.Platform, arch: string, ep: ModelYmlFoundryLocal['execution_provider']): boolean;
+/** The registration id the host serves the model under: `<name>:<version>`, one segment. */
+export declare function registrationId(modelId: string): string;
+export interface FoundryLocalRuntimeOptions {
+    layout: DataLayout;
+    registry: ModelRegistry;
+    instanceId: string;
+    platform: NodeJS.Platform;
+    arch: string;
+    /** This binary in its `foundry-host` mode (`foundryHostCommand`). */
+    hostCommand: FoundryHostCommand;
+    /** The active build's directory (engine-builds), or nothing installed. */
+    resolveBuild: () => Promise<string | undefined>;
+    /** The accelerators core recorded as prepared (`accelerators.json`, task 6.4). */
+    preparedAccelerators: () => Promise<readonly string[]>;
+    /** The same live trusted-hosts list `:1337` and the managed gateways use. */
+    trustedHosts: string[];
+    /** The `foundry-local` provider settings, re-read per load. */
+    readSettings: () => Promise<Record<string, unknown>>;
+    journal?: ProcessJournal | undefined;
+    emit?: EmitFn;
+    baseEnv?: NodeJS.ProcessEnv;
+    backendOutput?: BackendOutputSink;
+    log?: (level: 'debug' | 'info' | 'warn' | 'error', message: string) => void;
+    /** GPU residency (spec `gpu-residency`): CUDA and WebGPU variants hold every card. */
+    claimGpu?: GpuClaimHook | undefined;
+    /** Test seam. */
+    spawn?: typeof spawnAndAwaitReady;
+}
+export declare class FoundryLocalRuntime implements LocalRuntime {
+    private readonly options;
+    private readonly table;
+    private readonly emit;
+    /** Loads past their GPU claim and not yet a session. */
+    private readonly claimed;
+    /** The `foundry-local` model registry this runtime reads (`<data>/foundry-local/models`). */
+    get registry(): ModelRegistry;
+    constructor(options: FoundryLocalRuntimeOptions);
+    list(): SessionInfo[];
+    findSession(modelId: string): SessionInfo | undefined;
+    getLoadedModels(): string[];
+    isLoading(modelId: string): boolean;
+    /** CUDA and WebGPU sessions hold every card (the library picks one we cannot name); NPU and CPU none. */
+    gpuOccupancy(): GpuOccupancy[];
+    /** What the engine-builds module needs: the load queue, and the builds sessions run from (design D2). */
+    engineHost(): EngineHost;
+    routePolicy(modelId: string): SessionRoutePolicy | undefined;
+    load(modelId: string, opts?: LocalLoadOptions): Promise<SessionInfo>;
+    private start;
+    private startHost;
+    /** Waits for the host to exit (spec "Выгрузка"); the gateway goes with it. */
+    unload(modelId: string): Promise<UnloadResult>;
+    /** The context is the variant's own: nothing to grow. */
+    autoIncreaseCtx(modelId: string): Promise<CtxIncreaseResult>;
+    recreateSession(modelId: string): Promise<RecreateResult>;
+    shutdown(): Promise<void>;
+}