@atomic-chat/core 0.17.0 → 0.18.3

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

@@ -0,0 +1,109 @@
+/**
+ * The arguments of the hidden `foundry-host` mode (openspec change `add-foundry-local`, task 5.1).
+ * Core is the only caller, so the parse is strict: anything unknown is a bug on core's side.
+ *
+ *   foundry-host probe   --lib <build> --app-data <dir> --logs <dir> [--prepared <ep>]…
+ *   foundry-host prepare --lib <build> --app-data <dir> --logs <dir> [<ep>…]
+ *   foundry-host serve   --lib <build> --app-data <dir> --logs <dir> --model <dir> --ep <ep>
+ *                        --port <p> --cache <dir> --id <name>:<version> [--tools]
+ *                        [--reasoning-start <s> --reasoning-end <s>] [--context-length <n>]
+ */
+import { parseArgs } from 'node:util';
+import { FOUNDRY_LOCAL_EXECUTION_PROVIDERS } from '../../../contracts/index.js';
+export class FoundryHostUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FoundryHostUsageError';
+    }
+}
+const COMMON_OPTIONS = {
+    'lib': { type: 'string' },
+    'app-data': { type: 'string' },
+    'logs': { type: 'string' },
+};
+const required = (values, key) => {
+    const value = values[key];
+    if (typeof value !== 'string' || value === '')
+        throw new FoundryHostUsageError(`--${key} is required`);
+    return value;
+};
+function common(values) {
+    return {
+        lib: required(values, 'lib'),
+        appData: required(values, 'app-data'),
+        logs: required(values, 'logs'),
+    };
+}
+export function parseFoundryHostArgs(argv) {
+    const [mode, ...rest] = argv;
+    try {
+        if (mode === 'probe') {
+            const { values } = parseArgs({
+                args: rest,
+                options: { ...COMMON_OPTIONS, prepared: { type: 'string', multiple: true } },
+                strict: true,
+            });
+            return { mode, ...common(values), prepared: values.prepared ?? [] };
+        }
+        if (mode === 'prepare') {
+            const { values, positionals } = parseArgs({
+                args: rest,
+                options: COMMON_OPTIONS,
+                strict: true,
+                allowPositionals: true,
+            });
+            return { mode, ...common(values), accelerators: positionals };
+        }
+        if (mode === 'serve') {
+            const { values } = parseArgs({
+                args: rest,
+                options: {
+                    ...COMMON_OPTIONS,
+                    'model': { type: 'string' },
+                    'ep': { type: 'string' },
+                    'port': { type: 'string' },
+                    'cache': { type: 'string' },
+                    'id': { type: 'string' },
+                    'tools': { type: 'boolean' },
+                    'reasoning-start': { type: 'string' },
+                    'reasoning-end': { type: 'string' },
+                    'context-length': { type: 'string' },
+                },
+                strict: true,
+            });
+            const ep = required(values, 'ep');
+            if (!FOUNDRY_LOCAL_EXECUTION_PROVIDERS.some((known) => known === ep))
+                throw new FoundryHostUsageError(`--ep ${ep} is not an accelerator this host runs`);
+            const port = Number(required(values, 'port'));
+            if (!Number.isInteger(port) || port < 1 || port > 65535)
+                throw new FoundryHostUsageError(`--port ${values.port} is not a port`);
+            const id = required(values, 'id');
+            if (!/^[^:\s]+:\d+$/.test(id))
+                throw new FoundryHostUsageError(`--id ${id} is not <name>:<version>`);
+            const context = values['context-length'];
+            const contextLength = context === undefined ? undefined : Number(context);
+            if (contextLength !== undefined && (!Number.isSafeInteger(contextLength) || contextLength < 1))
+                throw new FoundryHostUsageError(`--context-length ${context} is not a positive whole number`);
+            return {
+                mode,
+                ...common(values),
+                model: required(values, 'model'),
+                ep: ep,
+                port,
+                cache: required(values, 'cache'),
+                id,
+                tools: values.tools === true,
+                ...(values['reasoning-start'] !== undefined ? { reasoningStart: values['reasoning-start'] } : {}),
+                ...(values['reasoning-end'] !== undefined ? { reasoningEnd: values['reasoning-end'] } : {}),
+                ...(contextLength !== undefined ? { contextLength } : {}),
+            };
+        }
+    }
+    catch (error) {
+        if (error instanceof FoundryHostUsageError)
+            throw error;
+        throw new FoundryHostUsageError(error instanceof Error ? error.message : String(error));
+    }
+    throw new FoundryHostUsageError(`foundry-host: unknown mode ${JSON.stringify(mode ?? '')} (probe, prepare, serve)`);
+}
+//# sourceMappingURL=args.js.map

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

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

package/dist/runtime/foundry-local/host/execution-providers.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The three spellings of each accelerator (spike findings 6 and 14): conf and `model.yml` say `webgpu`,
+ * the library's EP registration and `Manager_GetDiscoverableEps` say `WebGpuExecutionProvider` (ONNX
+ * Runtime's name), and `RegisterModel` metadata wants `WebGPUExecutionProvider` (the catalog's name) —
+ * `Load` refuses the ORT spelling with "unknown execution provider for local model".
+ */
+import type { FoundryLocalExecutionProvider } from '../../../contracts/index.js';
+interface ExecutionProviderNames {
+    short: FoundryLocalExecutionProvider;
+    /** What the variant runs on; OpenVINO serves Intel GPUs and NPUs alike (finding: offered without an NPU). */
+    device: 'cpu' | 'gpu' | 'npu' | 'gpu/npu';
+    /** `Manager_DownloadAndRegisterEps` / discoverable name; `null` for the CPU, which is always there. */
+    register: string | null;
+    /** `execution_provider` in `RegisterModel` metadata. */
+    metadata: string;
+}
+export declare const EXECUTION_PROVIDERS: readonly ExecutionProviderNames[];
+export declare function executionProvider(short: FoundryLocalExecutionProvider): ExecutionProviderNames;
+/**
+ * What the probe says about one discoverable accelerator. One this core does not run variants on
+ * (`NvTensorRTRTXExecutionProvider`, design non-goal) keeps its name with `execution_provider: null`.
+ */
+export declare function describeDiscoverable(name: string): {
+    execution_provider: FoundryLocalExecutionProvider | null;
+    device: string;
+};
+export {};

package/dist/runtime/foundry-local/host/execution-providers.js

@@ -0,0 +1,43 @@
+/**
+ * The three spellings of each accelerator (spike findings 6 and 14): conf and `model.yml` say `webgpu`,
+ * the library's EP registration and `Manager_GetDiscoverableEps` say `WebGpuExecutionProvider` (ONNX
+ * Runtime's name), and `RegisterModel` metadata wants `WebGPUExecutionProvider` (the catalog's name) —
+ * `Load` refuses the ORT spelling with "unknown execution provider for local model".
+ */
+export const EXECUTION_PROVIDERS = [
+    { short: 'cpu', device: 'cpu', register: null, metadata: 'CPUExecutionProvider' },
+    { short: 'cuda', device: 'gpu', register: 'CUDAExecutionProvider', metadata: 'CUDAExecutionProvider' },
+    {
+        short: 'webgpu',
+        device: 'gpu',
+        register: 'WebGpuExecutionProvider',
+        metadata: 'WebGPUExecutionProvider',
+    },
+    {
+        short: 'openvino',
+        device: 'gpu/npu',
+        register: 'OpenVINOExecutionProvider',
+        metadata: 'OpenVINOExecutionProvider',
+    },
+    { short: 'qnn', device: 'npu', register: 'QNNExecutionProvider', metadata: 'QNNExecutionProvider' },
+    {
+        short: 'vitisai',
+        device: 'npu',
+        register: 'VitisAIExecutionProvider',
+        metadata: 'VitisAIExecutionProvider',
+    },
+];
+export function executionProvider(short) {
+    return EXECUTION_PROVIDERS.find((ep) => ep.short === short);
+}
+/**
+ * What the probe says about one discoverable accelerator. One this core does not run variants on
+ * (`NvTensorRTRTXExecutionProvider`, design non-goal) keeps its name with `execution_provider: null`.
+ */
+export function describeDiscoverable(name) {
+    const known = EXECUTION_PROVIDERS.find((ep) => ep.register === name);
+    if (known)
+        return { execution_provider: known.short, device: known.device };
+    return { execution_provider: null, device: /TensorRT|Cuda|Gpu|DML/i.test(name) ? 'gpu' : 'unknown' };
+}
+//# sourceMappingURL=execution-providers.js.map

package/dist/runtime/foundry-local/host/execution-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-providers.js","sourceRoot":"","sources":["../../../../src/runtime/foundry-local/host/execution-providers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,CAAC,MAAM,mBAAmB,GAAsC;IACpE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACjF,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,uBAAuB,EAAE,QAAQ,EAAE,uBAAuB,EAAE;IACtG;QACE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,yBAAyB;QACnC,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,2BAA2B;KACtC;IACD,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,EAAE,sBAAsB,EAAE;IACnG;QACE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,0BAA0B;KACrC;CACF,CAAA;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAoC;IACpE,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,KAAK,KAAK,CAA2B,CAAA;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAI/C,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAA;IACpE,IAAI,KAAK;QAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC3E,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,CAAA;AACtG,CAAC"}

package/dist/runtime/foundry-local/host/ffi-bun.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `FoundryLibrary` over `bun:ffi` — the only file in `src/` that may import `bun:*` (operator decision
+ * Q2 of change `add-foundry-local`; allow-listed in `scripts/check-runtime-agnostic.mjs`). It is
+ * imported dynamically by the `foundry-host` mode alone, so the npm package still loads under Node.
+ *
+ * The library exports three symbols; everything else is a table of function pointers (`flApi` and its
+ * sub-APIs), read here by index. Indices follow `foundry_local_c.h` of C API version 2: tables only
+ * ever grow at the end, so a library that grants version 2 keeps these positions.
+ *
+ * Proven by the spike (rulings S1, S2): progress callbacks must not be `threadsafe` — the native caller
+ * would wait on a JS thread it itself blocks and read a non-zero return as "cancel"; on Windows the
+ * library's DLL dependencies are found only after `SetDllDirectoryW(<lib>)`.
+ */
+import type { LoadFoundryLibrary } from './library.js';
+/** The `FOUNDRY_LOCAL_API_VERSION` these bindings are written against. */
+export declare const BOUND_C_API_VERSION = 2;
+export declare const loadBunFoundryLibrary: LoadFoundryLibrary;

package/dist/runtime/foundry-local/host/ffi-bun.js

@@ -0,0 +1,256 @@
+/**
+ * `FoundryLibrary` over `bun:ffi` — the only file in `src/` that may import `bun:*` (operator decision
+ * Q2 of change `add-foundry-local`; allow-listed in `scripts/check-runtime-agnostic.mjs`). It is
+ * imported dynamically by the `foundry-host` mode alone, so the npm package still loads under Node.
+ *
+ * The library exports three symbols; everything else is a table of function pointers (`flApi` and its
+ * sub-APIs), read here by index. Indices follow `foundry_local_c.h` of C API version 2: tables only
+ * ever grow at the end, so a library that grants version 2 keeps these positions.
+ *
+ * Proven by the spike (rulings S1, S2): progress callbacks must not be `threadsafe` — the native caller
+ * would wait on a JS thread it itself blocks and read a non-zero return as "cancel"; on Windows the
+ * library's DLL dependencies are found only after `SetDllDirectoryW(<lib>)`.
+ */
+import { CFunction, CString, dlopen, FFIType, JSCallback, ptr, read } from 'bun:ffi';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { FoundryLibraryError } from './library.js';
+/** The `FOUNDRY_LOCAL_API_VERSION` these bindings are written against. */
+export const BOUND_C_API_VERSION = 2;
+const POINTER = 8;
+const CATALOG_LOCAL = 1;
+/** `flEpInfo`: u32 version, padding, `const char* name` at 8, `bool is_registered` at 16. */
+const EP_INFO_SIZE = 24;
+const LIBRARY_FILE = {
+    win32: 'foundry_local.dll',
+    darwin: 'libfoundry_local.dylib',
+    linux: 'libfoundry_local.so',
+};
+/** Root table (`flApi`) indices. */
+const API = {
+    statusGetErrorCode: 2,
+    statusGetErrorMessage: 3,
+    statusRelease: 1,
+    managerCreate: 4,
+    managerRelease: 5,
+    webServiceStart: 7,
+    webServiceUrls: 8,
+    getCatalogApi: 10,
+    getConfigurationApi: 11,
+    getModelApi: 14,
+    createKeyValuePairs: 15,
+    addKeyValuePair: 16,
+    keyValuePairsRelease: 20,
+    getDiscoverableEps: 24,
+    downloadAndRegisterEps: 25,
+    managerShutdown: 27,
+    getCatalogByType: 29,
+};
+const CONFIG = {
+    create: 0,
+    release: 1,
+    setAppDataDir: 3,
+    setLogsDir: 4,
+    setModelCacheDir: 5,
+    addWebServiceEndpoint: 8,
+    setAdditionalOptions: 10,
+};
+const CATALOG = { registerModel: 8 };
+const MODEL = {
+    getInfo: 0,
+    load: 6,
+    unload: 7,
+    infoGetExecutionProvider: 17,
+    createModelInfo: 23,
+    releaseModelInfo: 24,
+    infoSetStringProperty: 25,
+    infoSetIntProperty: 26,
+};
+const T = FFIType;
+const cstr = (value) => Buffer.from(`${value}\0`, 'utf8');
+const outPointer = () => new BigUint64Array(1);
+const deref = (out) => Number(out[0]);
+export const loadBunFoundryLibrary = async (libDir) => {
+    const file = LIBRARY_FILE[process.platform];
+    if (!file)
+        throw new FoundryLibraryError('load', 0, `Foundry Local has no library for ${process.platform}`);
+    const path = join(libDir, file);
+    if (!existsSync(path))
+        throw new FoundryLibraryError('load', 0, `${path} not found: no ${file} in this build`);
+    if (process.platform === 'win32') {
+        // The loader does not search the DLL's own folder for onnxruntime.dll and its siblings (error 126).
+        const kernel32 = dlopen('kernel32.dll', { SetDllDirectoryW: { args: [T.ptr], returns: T.i32 } });
+        kernel32.symbols.SetDllDirectoryW(ptr(Buffer.from(`${libDir}\0`, 'utf16le')));
+    }
+    const library = dlopen(path, {
+        FoundryLocalGetApi: { args: [T.u32], returns: T.ptr },
+        FoundryLocalGetVersionString: { args: [], returns: T.cstring },
+    });
+    const version = String(library.symbols.FoundryLocalGetVersionString());
+    const api = library.symbols.FoundryLocalGetApi(BOUND_C_API_VERSION);
+    if (!api)
+        throw new FoundryLibraryError('FoundryLocalGetApi', 0, `Foundry Local ${version} does not provide C API version ${BOUND_C_API_VERSION}`);
+    return bindLibrary(api, version);
+};
+function bindLibrary(api, version) {
+    const fn = (table, index, args, returns) => CFunction({ ptr: read.ptr(table, index * POINTER), args, returns });
+    const statusCode = fn(api, API.statusGetErrorCode, [T.ptr], T.i32);
+    const statusMessage = fn(api, API.statusGetErrorMessage, [T.ptr], T.cstring);
+    const statusRelease = fn(api, API.statusRelease, [T.ptr], T.void);
+    /** A non-null `flStatus*` is an error: read it, free it, throw it. */
+    const check = (status, operation) => {
+        if (!status)
+            return;
+        const code = Number(statusCode(status));
+        const message = String(statusMessage(status));
+        statusRelease(status);
+        throw new FoundryLibraryError(operation, code, message);
+    };
+    const call = (f, operation, ...args) => check(f(...args), operation);
+    const configApi = fn(api, API.getConfigurationApi, [], T.ptr)();
+    const catalogApi = fn(api, API.getCatalogApi, [], T.ptr)();
+    const modelApi = fn(api, API.getModelApi, [], T.ptr)();
+    const f = {
+        configCreate: fn(configApi, CONFIG.create, [T.ptr, T.ptr], T.ptr),
+        configRelease: fn(configApi, CONFIG.release, [T.ptr], T.void),
+        setAppDataDir: fn(configApi, CONFIG.setAppDataDir, [T.ptr, T.ptr], T.ptr),
+        setLogsDir: fn(configApi, CONFIG.setLogsDir, [T.ptr, T.ptr], T.ptr),
+        setModelCacheDir: fn(configApi, CONFIG.setModelCacheDir, [T.ptr, T.ptr], T.ptr),
+        addWebServiceEndpoint: fn(configApi, CONFIG.addWebServiceEndpoint, [T.ptr, T.ptr], T.ptr),
+        setAdditionalOptions: fn(configApi, CONFIG.setAdditionalOptions, [T.ptr, T.ptr], T.ptr),
+        kvCreate: fn(api, API.createKeyValuePairs, [T.ptr], T.void),
+        kvAdd: fn(api, API.addKeyValuePair, [T.ptr, T.ptr, T.ptr], T.void),
+        kvRelease: fn(api, API.keyValuePairsRelease, [T.ptr], T.void),
+        managerCreate: fn(api, API.managerCreate, [T.ptr, T.ptr], T.ptr),
+        managerRelease: fn(api, API.managerRelease, [T.ptr], T.void),
+        managerShutdown: fn(api, API.managerShutdown, [T.ptr], T.ptr),
+        getDiscoverableEps: fn(api, API.getDiscoverableEps, [T.ptr, T.ptr, T.ptr], T.ptr),
+        downloadAndRegisterEps: fn(api, API.downloadAndRegisterEps, [T.ptr, T.ptr, T.u64, T.ptr, T.ptr], T.ptr),
+        getCatalogByType: fn(api, API.getCatalogByType, [T.ptr, T.i32, T.ptr], T.ptr),
+        webServiceStart: fn(api, API.webServiceStart, [T.ptr], T.ptr),
+        webServiceUrls: fn(api, API.webServiceUrls, [T.ptr, T.ptr, T.ptr], T.ptr),
+        registerModel: fn(catalogApi, CATALOG.registerModel, [T.ptr, T.ptr, T.ptr, T.ptr, T.ptr], T.ptr),
+        modelGetInfo: fn(modelApi, MODEL.getInfo, [T.ptr, T.ptr], T.ptr),
+        modelLoad: fn(modelApi, MODEL.load, [T.ptr], T.ptr),
+        modelUnload: fn(modelApi, MODEL.unload, [T.ptr], T.ptr),
+        infoGetExecutionProvider: fn(modelApi, MODEL.infoGetExecutionProvider, [T.ptr], T.cstring),
+        createModelInfo: fn(modelApi, MODEL.createModelInfo, [T.ptr], T.ptr),
+        releaseModelInfo: fn(modelApi, MODEL.releaseModelInfo, [T.ptr], T.void),
+        infoSetString: fn(modelApi, MODEL.infoSetStringProperty, [T.ptr, T.ptr, T.ptr], T.ptr),
+        infoSetInt: fn(modelApi, MODEL.infoSetIntProperty, [T.ptr, T.ptr, T.i64], T.ptr),
+    };
+    function createManager(config) {
+        const configOut = outPointer();
+        call(f.configCreate, 'Configuration_Create', ptr(cstr(config.appName)), ptr(configOut));
+        const cfg = deref(configOut);
+        let manager;
+        try {
+            call(f.setAppDataDir, 'SetAppDataDir', cfg, ptr(cstr(config.appDataDir)));
+            call(f.setLogsDir, 'SetLogsDir', cfg, ptr(cstr(config.logsDir)));
+            call(f.setModelCacheDir, 'SetModelCacheDir', cfg, ptr(cstr(config.modelCacheDir)));
+            for (const endpoint of config.webServiceEndpoints)
+                call(f.addWebServiceEndpoint, 'AddWebServiceEndpoint', cfg, ptr(cstr(endpoint)));
+            const kvOut = outPointer();
+            f.kvCreate(ptr(kvOut));
+            const kv = deref(kvOut);
+            for (const [key, value] of Object.entries(config.additionalOptions))
+                f.kvAdd(kv, ptr(cstr(key)), ptr(cstr(value)));
+            try {
+                call(f.setAdditionalOptions, 'SetAdditionalOptions', cfg, kv);
+            }
+            finally {
+                f.kvRelease(kv);
+            }
+            const managerOut = outPointer();
+            call(f.managerCreate, 'Manager_Create', cfg, ptr(managerOut));
+            manager = deref(managerOut);
+        }
+        finally {
+            f.configRelease(cfg);
+        }
+        return bindManager(manager);
+    }
+    function bindManager(manager) {
+        return {
+            discoverableEps() {
+                const epsOut = outPointer();
+                const countOut = outPointer();
+                call(f.getDiscoverableEps, 'Manager_GetDiscoverableEps', manager, ptr(epsOut), ptr(countOut));
+                const base = deref(epsOut);
+                const eps = [];
+                for (let i = 0; i < Number(countOut[0]); i++) {
+                    const at = i * EP_INFO_SIZE;
+                    eps.push({
+                        name: new CString(read.ptr(base, at + 8)).toString(),
+                        registered: read.u8(base, at + 16) !== 0,
+                    });
+                }
+                return eps;
+            },
+            downloadAndRegisterEps(names, onProgress) {
+                const strings = names.map(cstr);
+                const array = new BigUint64Array(strings.map((s) => BigInt(ptr(s))));
+                // Not threadsafe: the library calls back on the calling thread, synchronously (spike S1, S2).
+                const callback = onProgress
+                    ? new JSCallback((name, percent) => {
+                        onProgress(new CString(name).toString(), percent);
+                        return 0;
+                    }, { args: [T.ptr, T.f32, T.ptr], returns: T.i32 })
+                    : null;
+                try {
+                    call(f.downloadAndRegisterEps, 'Manager_DownloadAndRegisterEps', manager, names.length > 0 ? ptr(array) : null, names.length, callback ? callback.ptr : null, null);
+                }
+                finally {
+                    callback?.close();
+                }
+            },
+            registerLocalModel(path, id, metadata) {
+                const catalogOut = outPointer();
+                call(f.getCatalogByType, 'Manager_GetCatalogByType', manager, CATALOG_LOCAL, ptr(catalogOut));
+                const infoOut = outPointer();
+                call(f.createModelInfo, 'CreateModelInfo', ptr(infoOut));
+                const info = deref(infoOut);
+                const modelOut = outPointer();
+                try {
+                    for (const [key, value] of Object.entries(metadata.strings))
+                        call(f.infoSetString, `Info_SetStringProperty(${key})`, info, ptr(cstr(key)), ptr(cstr(value)));
+                    for (const [key, value] of Object.entries(metadata.ints))
+                        call(f.infoSetInt, `Info_SetIntProperty(${key})`, info, ptr(cstr(key)), BigInt(value));
+                    call(f.registerModel, 'RegisterModel', deref(catalogOut), ptr(cstr(path)), ptr(cstr(id)), info, ptr(modelOut));
+                }
+                finally {
+                    f.releaseModelInfo(info);
+                }
+                return bindModel(deref(modelOut));
+            },
+            webServiceStart() {
+                call(f.webServiceStart, 'Manager_WebServiceStart', manager);
+                const urlsOut = outPointer();
+                const countOut = outPointer();
+                call(f.webServiceUrls, 'Manager_WebServiceUrls', manager, ptr(urlsOut), ptr(countOut));
+                const urls = [];
+                for (let i = 0; i < Number(countOut[0]); i++)
+                    urls.push(new CString(read.ptr(deref(urlsOut), i * POINTER)).toString());
+                return urls;
+            },
+            shutdown: () => call(f.managerShutdown, 'Manager_Shutdown', manager),
+            release: () => {
+                f.managerRelease(manager);
+            },
+        };
+    }
+    function bindModel(model) {
+        return {
+            load: () => call(f.modelLoad, 'Model_Load', model),
+            unload: () => call(f.modelUnload, 'Model_Unload', model),
+            executionProvider() {
+                const infoOut = outPointer();
+                call(f.modelGetInfo, 'Model_GetInfo', model, ptr(infoOut));
+                const ep = f.infoGetExecutionProvider(deref(infoOut));
+                return ep ? String(ep) : null;
+            },
+        };
+    }
+    return { version, cApiVersion: BOUND_C_API_VERSION, createManager };
+}
+//# sourceMappingURL=ffi-bun.js.map

package/dist/runtime/foundry-local/host/ffi-bun.js.map

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

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

@@ -0,0 +1,61 @@
+/**
+ * The part of Foundry Local's C API (`foundry_local_c.h`, `FOUNDRY_LOCAL_API_VERSION` 2) the host
+ * uses, as an interface. `ffi-bun.ts` implements it over `bun:ffi`; the protocol tests (tasks 5.2,
+ * 5.3) run the host against a fake one. Every call is synchronous and may block, like the C API.
+ */
+/** A non-null `flStatus*`: the library's error code and message. */
+export declare class FoundryLibraryError extends Error {
+    readonly operation: string;
+    readonly libraryCode: number;
+    constructor(operation: string, libraryCode: number, message: string);
+}
+export interface FoundryManagerConfig {
+    appName: string;
+    appDataDir: string;
+    logsDir: string;
+    modelCacheDir: string;
+    /** `http://127.0.0.1:<port>` for `serve`; none otherwise. */
+    webServiceEndpoints: string[];
+    /** `SetAdditionalOptions`, e.g. `DisableNonessentialTelemetry`. */
+    additionalOptions: Record<string, string>;
+}
+export interface DiscoverableEp {
+    name: string;
+    /** Registered in this process; says nothing about a previous process (spike finding 18). */
+    registered: boolean;
+}
+export interface ModelMetadata {
+    strings: Record<string, string>;
+    ints: Record<string, number>;
+}
+export interface FoundryModel {
+    load(): void;
+    unload(): void;
+    /** The model's execution provider as the library holds it; `null` when unset. */
+    executionProvider(): string | null;
+}
+export interface FoundryManager {
+    discoverableEps(): DiscoverableEp[];
+    /**
+     * `Manager_DownloadAndRegisterEps`, blocking. `onProgress` is called on the calling thread for
+     * CDN accelerators (spike findings 2, 15). Windows ML ones may call it from a thread of their own
+     * on a first install, where the plain callback cannot run: pass it only for CDN accelerators. A
+     * per-EP failure is not an error — read `discoverableEps()` afterwards.
+     */
+    downloadAndRegisterEps(names: string[], onProgress?: (ep: string, percent: number) => void): void;
+    /** `RegisterModel` in the local catalog; files are not copied. */
+    registerLocalModel(path: string, id: string, metadata: ModelMetadata): FoundryModel;
+    /** Start the built-in server; the bound URLs. */
+    webServiceStart(): string[];
+    shutdown(): void;
+    release(): void;
+}
+export interface FoundryLibrary {
+    /** `FoundryLocalGetVersionString`. */
+    version: string;
+    /** The C API version the table was requested at. */
+    cApiVersion: number;
+    createManager(config: FoundryManagerConfig): FoundryManager;
+}
+/** Opens the library of one build (`<build>/lib`); throws when it does not load or speaks another C API. */
+export type LoadFoundryLibrary = (libDir: string) => Promise<FoundryLibrary>;

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

@@ -0,0 +1,17 @@
+/**
+ * The part of Foundry Local's C API (`foundry_local_c.h`, `FOUNDRY_LOCAL_API_VERSION` 2) the host
+ * uses, as an interface. `ffi-bun.ts` implements it over `bun:ffi`; the protocol tests (tasks 5.2,
+ * 5.3) run the host against a fake one. Every call is synchronous and may block, like the C API.
+ */
+/** A non-null `flStatus*`: the library's error code and message. */
+export class FoundryLibraryError extends Error {
+    operation;
+    libraryCode;
+    constructor(operation, libraryCode, message) {
+        super(`${operation}: ${message}`);
+        this.operation = operation;
+        this.libraryCode = libraryCode;
+        this.name = 'FoundryLibraryError';
+    }
+}
+//# sourceMappingURL=library.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../../../src/runtime/foundry-local/host/library.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oEAAoE;AACpE,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAEjC;IACA;IAFX,YACW,SAAiB,EACjB,WAAmB,EAC5B,OAAe;QAEf,KAAK,CAAC,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC,CAAA;QAJxB,cAAS,GAAT,SAAS,CAAQ;QACjB,gBAAW,GAAX,WAAW,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF"}

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

@@ -0,0 +1,54 @@
+/**
+ * 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 type { LoadFoundryLibrary } from './library.js';
+export interface FoundryHostDeps {
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+    loadLibrary: LoadFoundryLibrary;
+    /**
+     * What the library's log gained since the previous call (the first call: since the host started).
+     * The C API reports no per-accelerator failure (spike finding 11); its log does.
+     */
+    readLogTail?: (logsDir: string) => Promise<string>;
+    /**
+     * Starts watching for core's stop: SIGTERM, SIGINT or stdin closed (Windows has no SIGTERM). Made
+     * before the model loads, so a stop sent right after the readiness line is never missed.
+     */
+    watchStop?: () => StopWatch;
+    /** Deletes the host's catalog cache at exit. */
+    removeDir?: (path: string) => Promise<void>;
+}
+export interface StopWatch {
+    stopped: Promise<void>;
+    /** Let go of the signals and of stdin, so nothing keeps the process alive after the host is done. */
+    dispose(): void;
+}
+/** SIGTERM, SIGINT or the end of stdin, whichever comes first. */
+export declare function watchStopSignals(): StopWatch;
+/** Where the built-in server serves models registered in the local catalog (spike finding 7). */
+export declare const LOCAL_CATALOG_BASE_PATH = "/catalogs/local";
+/** Reads what `foundry_local_<date>.log` files under `logsDir` gained since the reader was made. */
+export declare function logTailReader(): (logsDir: string) => Promise<string>;
+/**
+ * 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 declare function failureReason(log: string, name: string): string | null;
+/** Line-oriented output over a stream-oriented CLI io: one JSON or error line per call. */
+export declare function lineIo(io: {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+}): Pick<FoundryHostDeps, 'stdout' | 'stderr'>;
+/** The name the library reports itself under (telemetry, logs). */
+export declare const FOUNDRY_HOST_APP_NAME = "atomic-chat";
+/** `<build>/lib` when the build has one (release archives do), else the folder itself. */
+export declare function libraryDir(build: string, exists?: (path: string) => boolean): string;
+/** Opens the library through `bun:ffi`; under Node this mode cannot run, and says so. */
+export declare const loadLibraryWithBun: LoadFoundryLibrary;
+export declare function runFoundryHost(argv: readonly string[], deps: FoundryHostDeps): Promise<number>;