@atomic-chat/core 0.17.0 → 0.18.3

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

@@ -0,0 +1,316 @@
+/**
+ * The hidden `foundry-host` mode of the core binaries (openspec change `add-foundry-local`, design D1):
+ * one process per model or command, so a crash of Microsoft's native library never takes the core
+ * down. Core starts it with `process.execPath`; nothing else should.
+ *
+ * Exit codes: 0 done; 2 usage (a bug on core's side); 3 the library does not load or speaks another
+ * C API; 4 a library call failed. Errors go to stderr as one line each; stdout carries JSON lines only.
+ */
+import { existsSync } from 'node:fs';
+import { open, readdir, rm, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { FoundryHostUsageError, parseFoundryHostArgs } from './args.js';
+import { describeDiscoverable, executionProvider } from './execution-providers.js';
+import { FoundryLibraryError } from './library.js';
+/** SIGTERM, SIGINT or the end of stdin, whichever comes first. */
+export function watchStopSignals() {
+    let resolve = () => { };
+    const stopped = new Promise((done) => (resolve = done));
+    const stop = () => resolve();
+    process.on('SIGTERM', stop);
+    process.on('SIGINT', stop);
+    process.stdin.on('end', stop);
+    process.stdin.on('close', stop);
+    process.stdin.resume();
+    return {
+        stopped,
+        dispose() {
+            process.off('SIGTERM', stop);
+            process.off('SIGINT', stop);
+            process.stdin.off('end', stop);
+            process.stdin.off('close', stop);
+            process.stdin.pause();
+            process.stdin.destroy();
+        },
+    };
+}
+/** Where the built-in server serves models registered in the local catalog (spike finding 7). */
+export const LOCAL_CATALOG_BASE_PATH = '/catalogs/local';
+/** Reads what `foundry_local_<date>.log` files under `logsDir` gained since the reader was made. */
+export function logTailReader() {
+    const offsets = new Map();
+    let primed = false;
+    const files = async (dir) => (await readdir(dir).catch(() => [])).filter((name) => /^foundry_local.*\.log$/.test(name));
+    return async (logsDir) => {
+        if (!primed) {
+            primed = true;
+            for (const name of await files(logsDir))
+                offsets.set(name, (await stat(join(logsDir, name)).catch(() => ({ size: 0 }))).size);
+        }
+        let text = '';
+        for (const name of await files(logsDir)) {
+            const path = join(logsDir, name);
+            const size = (await stat(path).catch(() => ({ size: 0 }))).size;
+            const from = Math.min(offsets.get(name) ?? 0, size);
+            if (size > from) {
+                const handle = await open(path, 'r');
+                try {
+                    const buffer = Buffer.alloc(Math.min(size - from, 256 * 1024));
+                    await handle.read(buffer, 0, buffer.length, size - buffer.length);
+                    text += buffer.toString('utf8');
+                }
+                finally {
+                    await handle.close();
+                }
+            }
+            offsets.set(name, size);
+        }
+        return text;
+    };
+}
+/**
+ * The library's own words for why `name` was not registered: the last warning or error that names the
+ * accelerator or its family (`cuda` for `CUDAExecutionProvider`), not the generic summary line.
+ */
+export function failureReason(log, name) {
+    const family = name.replace(/ExecutionProvider$/, '').toLowerCase();
+    const lines = log
+        .split(/\r?\n/)
+        .filter((line) => /\[(warning|error)\]/i.test(line))
+        .filter((line) => !/Failed to download or register EP/i.test(line))
+        .filter((line) => line.includes(name) || line.toLowerCase().includes(family));
+    const last = lines.at(-1);
+    if (!last)
+        return null;
+    const blocked = /failed to load '([^']+)' \(4551\)/.exec(last);
+    if (blocked)
+        return appControlBlocked(blocked[1] ?? '', family);
+    return last.replace(/^\[[^\]]*\]\s*\[[^\]]*\]\s*/, '').trim();
+}
+/**
+ * Windows' 4551 (`ERROR_SYSTEM_INTEGRITY_POLICY_VIOLATION`): Smart App Control or an organization's
+ * app control policy refused a library without a signature. Microsoft's CUDA bundle ships
+ * `onnxruntime-genai-cuda.dll` unsigned, so on a laptop with Smart App Control on the whole bundle
+ * downloads and then cannot load. The person can act on this, not on the path and the code.
+ */
+const ACCELERATOR_LABELS = {
+    cuda: 'CUDA',
+    webgpu: 'WebGPU',
+    openvino: 'OpenVINO',
+    nvtensorrtrtx: 'TensorRT-RTX',
+    qnn: 'QNN',
+};
+function appControlBlocked(path, family) {
+    const file = path.split(/[\\/]/).at(-1) || 'a library';
+    const accelerator = ACCELERATOR_LABELS[family] ?? family;
+    return (`Windows blocked ${file}, a library of Microsoft's ${accelerator} accelerator that has no digital signature: ` +
+        "Smart App Control or your organization's app control policy does not let unsigned libraries load. " +
+        `To use ${accelerator}, turn Smart App Control off in Windows Security → App & browser control → ` +
+        'Smart App Control settings (Windows cannot turn it back on without a reset), or on a managed PC ask your ' +
+        'administrator to allow it; then press Retry. Models on WebGPU and CPU run without it.');
+}
+/** Line-oriented output over a stream-oriented CLI io: one JSON or error line per call. */
+export function lineIo(io) {
+    return { stdout: (line) => io.stdout(`${line}\n`), stderr: (line) => io.stderr(`${line}\n`) };
+}
+/** The name the library reports itself under (telemetry, logs). */
+export const FOUNDRY_HOST_APP_NAME = 'atomic-chat';
+const json = (value) => JSON.stringify(value);
+/** `<build>/lib` when the build has one (release archives do), else the folder itself. */
+export function libraryDir(build, exists = existsSync) {
+    return exists(join(build, 'lib')) ? join(build, 'lib') : build;
+}
+/** Opens the library through `bun:ffi`; under Node this mode cannot run, and says so. */
+export const loadLibraryWithBun = async (libDir) => {
+    let module;
+    try {
+        module = await import('./ffi-bun.js');
+    }
+    catch (error) {
+        throw new FoundryLibraryError('load', 0, `foundry-host runs inside the compiled atomic-chat-core binaries only (${error instanceof Error ? error.message : String(error)})`);
+    }
+    return module.loadBunFoundryLibrary(libDir);
+};
+function openManager(library, args, extra) {
+    return library.createManager({
+        appName: FOUNDRY_HOST_APP_NAME,
+        appDataDir: args.appData,
+        logsDir: args.logs,
+        modelCacheDir: extra.cache,
+        webServiceEndpoints: extra.endpoints,
+        // Design D8: the optional telemetry off; `ProcessInfo` still goes, and is disclosed.
+        additionalOptions: { DisableNonessentialTelemetry: 'true' },
+    });
+}
+function close(manager) {
+    try {
+        manager.shutdown();
+    }
+    finally {
+        manager.release();
+    }
+}
+async function probe(library, args, deps) {
+    const manager = openManager(library, args, { cache: join(args.appData, 'cache'), endpoints: [] });
+    try {
+        const accelerators = manager.discoverableEps().map((ep) => ({
+            name: ep.name,
+            ...describeDiscoverable(ep.name),
+            prepared: args.prepared.includes(ep.name),
+        }));
+        deps.stdout(json({ c_api_version: library.cApiVersion, version: library.version, accelerators }));
+    }
+    finally {
+        close(manager);
+    }
+}
+/**
+ * The accelerators the library downloads from Microsoft's CDN and reports on the calling thread,
+ * synchronously (spike findings 2, 15). Every other one comes through Windows ML, which reported
+ * nothing on a machine that already had it (finding 16) and, on a first install on a Core Ultra
+ * laptop, called back from a thread of its own; it gets no callback and reports a start and an end.
+ */
+const CDN_ACCELERATORS = new Set([
+    'CUDAExecutionProvider',
+    'WebGpuExecutionProvider',
+    'WebGPUExecutionProvider',
+]);
+/**
+ * Task 5.2: each accelerator on its own `Manager_DownloadAndRegisterEps` call, so one failure never
+ * cancels the others and each gets its own reason. Lines: `{accelerator, stage, fraction}` with
+ * `stage` started → downloading* → done | failed; Windows ML accelerators report no downloading lines
+ * at all (spike finding 16), and a failed one has `fraction: null` (rulings R6). Last line: the summary.
+ */
+async function prepare(library, args, deps) {
+    const readLog = deps.readLogTail ?? logTailReader();
+    await readLog(args.logs);
+    const manager = openManager(library, args, { cache: join(args.appData, 'cache'), endpoints: [] });
+    const summary = [];
+    try {
+        const offered = manager.discoverableEps().map((ep) => ep.name);
+        const wanted = args.accelerators.length > 0 ? args.accelerators : offered;
+        for (const name of wanted) {
+            if (!offered.includes(name)) {
+                summary.push({ name, prepared: false, reason: `This computer does not offer ${name}.` });
+                continue;
+            }
+            deps.stdout(json({ accelerator: name, stage: 'started', fraction: 0 }));
+            let thrown = null;
+            try {
+                // The callback goes only where the library calls it on this thread: Windows ML reported a first
+                // install from a thread of its own, and Bun's plain callback called there failed the prepare.
+                manager.downloadAndRegisterEps([name], CDN_ACCELERATORS.has(name)
+                    ? (_label, percent) => deps.stdout(json({ accelerator: name, stage: 'downloading', fraction: Math.min(1, percent / 100) }))
+                    : undefined);
+            }
+            catch (error) {
+                thrown = error instanceof Error ? error.message : String(error);
+            }
+            const registered = manager.discoverableEps().some((ep) => ep.name === name && ep.registered);
+            if (registered) {
+                deps.stdout(json({ accelerator: name, stage: 'done', fraction: 1 }));
+                summary.push({ name, prepared: true });
+            }
+            else {
+                const reason = thrown ?? failureReason(await readLog(args.logs), name) ?? `Foundry Local did not register ${name}.`;
+                deps.stdout(json({ accelerator: name, stage: 'failed', fraction: null, reason }));
+                summary.push({ name, prepared: false, reason });
+            }
+        }
+        deps.stdout(json({ done: true, accelerators: summary }));
+    }
+    finally {
+        close(manager);
+    }
+}
+/**
+ * Task 5.3: register the variant's accelerator (prepared only — nothing is downloaded here), register
+ * the folder in this host's own catalog with the accelerator named explicitly, load, start the
+ * built-in server on the loopback port core chose, print the readiness line, and on stop shut the
+ * library down and delete the catalog cache. Exit 5: the accelerator is not prepared.
+ */
+async function serve(library, args, deps) {
+    const ep = executionProvider(args.ep);
+    const removeDir = deps.removeDir ?? ((path) => rm(path, { recursive: true, force: true }));
+    const watch = (deps.watchStop ?? watchStopSignals)();
+    const manager = openManager(library, args, {
+        cache: args.cache,
+        endpoints: [`http://127.0.0.1:${args.port}`],
+    });
+    try {
+        if (ep.register) {
+            manager.downloadAndRegisterEps([ep.register]);
+            if (!manager.discoverableEps().some((found) => found.name === ep.register && found.registered)) {
+                deps.stderr(`${ep.register} is not prepared on this computer; prepare it before loading this model.`);
+                return 5;
+            }
+        }
+        const reasoning = args.reasoningStart !== undefined && args.reasoningEnd !== undefined;
+        const model = manager.registerLocalModel(args.model, args.id, {
+            strings: {
+                task: 'chat-completion',
+                execution_provider: ep.metadata,
+                ...(reasoning
+                    ? { reasoning_start: args.reasoningStart, reasoning_end: args.reasoningEnd }
+                    : {}),
+            },
+            ints: {
+                supports_tool_calling: args.tools ? 1 : 0,
+                supports_reasoning: reasoning ? 1 : 0,
+                ...(args.contextLength !== undefined ? { context_length: args.contextLength } : {}),
+            },
+        });
+        model.load();
+        const [url] = manager.webServiceStart();
+        deps.stdout(json({
+            ready: true,
+            url: url ?? `http://127.0.0.1:${args.port}`,
+            base_path: LOCAL_CATALOG_BASE_PATH,
+            model_id: args.id,
+            execution_provider: model.executionProvider(),
+        }));
+        await watch.stopped;
+        return 0;
+    }
+    finally {
+        try {
+            close(manager);
+        }
+        finally {
+            watch.dispose();
+            await removeDir(args.cache).catch(() => { });
+        }
+    }
+}
+export async function runFoundryHost(argv, deps) {
+    let args;
+    try {
+        args = parseFoundryHostArgs(argv);
+    }
+    catch (error) {
+        deps.stderr(error instanceof FoundryHostUsageError ? error.message : String(error));
+        return 2;
+    }
+    let library;
+    try {
+        library = await deps.loadLibrary(libraryDir(args.lib));
+    }
+    catch (error) {
+        deps.stderr(`foundry_local does not load from ${args.lib}: ${error instanceof Error ? error.message : String(error)}`);
+        return 3;
+    }
+    try {
+        if (args.mode === 'probe')
+            await probe(library, args, deps);
+        else if (args.mode === 'prepare')
+            await prepare(library, args, deps);
+        else
+            return await serve(library, args, deps);
+        return 0;
+    }
+    catch (error) {
+        deps.stderr(error instanceof Error ? error.message : String(error));
+        return 4;
+    }
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,78 @@
+/**
+ * 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.
+ */
+/** How to start `foundry-host`: `[execPath, script?]` + `foundry-host`, or a test stand-in. */
+export interface FoundryHostCommand {
+    exe: string;
+    args: string[];
+}
+export interface FoundryHostAccelerator {
+    name: string;
+    /** The conf spelling (`cuda`, `openvino`…); `null` for one this core runs no variant on. */
+    execution_provider?: string | null;
+    device: string;
+    prepared: boolean;
+}
+export interface FoundryHostProbeResult {
+    c_api_version: number;
+    /** The library's own version string. */
+    version?: string;
+    accelerators: FoundryHostAccelerator[];
+}
+/** What `probe` and `prepare` run against. */
+export interface FoundryHostTarget {
+    /** The build directory. */
+    libDir: string;
+    /** The library's data, shared by every build (`<data>/foundry-local/runtime`). */
+    appDataDir: string;
+    /** The library's logs (`<data>/foundry-local/logs`); the host refuses to run without them. */
+    logsDir: string;
+    /** The accelerators core recorded as prepared (the library cannot tell, rulings R6). */
+    prepared?: readonly string[];
+}
+/** The first run of a freshly unpacked library is scanned by Gatekeeper / Defender. */
+export declare const FOUNDRY_HOST_PROBE_TIMEOUT_MS = 60000;
+/**
+ * `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 declare function runFoundryHostProbe(command: FoundryHostCommand, target: FoundryHostTarget, options?: {
+    env?: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+}): Promise<FoundryHostProbeResult>;
+/**
+ * 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 declare 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).
+ */
+export declare function foundryHostCommand(env: Record<string, string | undefined>, argv?: readonly string[], execPath?: string): FoundryHostCommand;
+/** One accelerator's step, as `foundry-host prepare` prints it (task 5.2). */
+export interface FoundryHostPrepareStep {
+    accelerator: string;
+    stage: 'started' | 'downloading' | 'done' | 'failed';
+    fraction: number | null;
+    reason?: string;
+}
+export interface FoundryHostPrepareSummary {
+    accelerators: Array<{
+        name: string;
+        prepared: boolean;
+        reason?: string;
+    }>;
+}
+/**
+ * `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 declare function runFoundryHostPrepare(command: FoundryHostCommand, target: Omit<FoundryHostTarget, 'prepared'>, names: readonly string[], onStep: (step: FoundryHostPrepareStep) => void, options?: {
+    env?: NodeJS.ProcessEnv;
+}): Promise<FoundryHostPrepareSummary>;

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

@@ -0,0 +1,182 @@
+/**
+ * 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).
+ */
+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,11 @@
+/**
+ * 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 { lineIo, loadLibraryWithBun, runFoundryHost } from './host/run.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,11 @@
+/**
+ * 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 { lineIo, loadLibraryWithBun, runFoundryHost } from './host/run.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;AAC9B,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE1E,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;