@atomic-chat/core 0.17.0 → 0.18.3

package/dist/lock/process-identity.d.ts

@@ -14,8 +14,8 @@ export interface IdentityDeps {
     platform?: NodeJS.Platform;
     /** Read a procfs entry (Linux). */
     readText?: (path: string) => Promise<string>;
-    /** Run a probe and return its stdout. */
-    run?: (file: string, args: string[]) => Promise<string>;
+    /** Run a probe and return its stdout; `env` is laid over this process's environment. */
+    run?: (file: string, args: string[], env?: Record<string, string>) => Promise<string>;
     /** Signal-0 liveness probe. */
     alive?: (pid: number) => boolean;
 }
@@ -27,7 +27,7 @@ export interface IdentityDeps {
  */
 export declare const IDENTITY_PROBE_TIMEOUT_MS = 15000;
 export declare function isProcessAlive(pid: number): boolean;
-export declare function runProbe(file: string, args: string[]): Promise<string>;
+export declare function runProbe(file: string, args: string[], env?: Record<string, string>): Promise<string>;
 /**
  * An opaque, comparable token for "this incarnation of this PID", or `undefined` when the platform
  * cannot tell us. Only ever compared for equality, never parsed.
@@ -44,5 +44,11 @@ export declare function processStartEpoch(pid: number, deps?: IdentityDeps): Pro
 export declare function processName(pid: number, deps?: IdentityDeps): Promise<string | undefined>;
 /** Compare a recorded identity with the live process. `unknown` means "cannot prove"; treat as live. */
 export declare function verifyProcessIdentity(pid: number, expected: string | null | undefined, deps?: IdentityDeps): Promise<IdentityVerdict>;
+/**
+ * Compare a recorded start time (`epoch:<seconds>`, `processStartEpoch`) with the live process. Seconds
+ * since the epoch read the same in every locale and zone, so a difference is proof of another process
+ * behind the PID; a second either way is the same start read at a different instant.
+ */
+export declare function verifyStartEpoch(pid: number, expected: string | null | undefined, deps?: IdentityDeps): Promise<IdentityVerdict>;
 /** Only a proven-gone process releases what it held. */
 export declare function identityPermitsTakeover(verdict: IdentityVerdict): boolean;

package/dist/lock/process-identity.js

@@ -30,9 +30,13 @@ export function isProcessAlive(pid) {
         return e.code === 'EPERM';
     }
 }
-export function runProbe(file, args) {
+export function runProbe(file, args, env) {
     return new Promise((resolve, reject) => {
-        execFile(file, args, { timeout: IDENTITY_PROBE_TIMEOUT_MS, windowsHide: true }, (err, stdout) => {
+        execFile(file, args, {
+            timeout: IDENTITY_PROBE_TIMEOUT_MS,
+            windowsHide: true,
+            ...(env ? { env: { ...process.env, ...env } } : {}),
+        }, (err, stdout) => {
             if (err)
                 reject(err);
             else
@@ -40,6 +44,21 @@ export function runProbe(file, args) {
         });
     });
 }
+/**
+ * What `ps` prints depends on the locale and the time zone of whoever runs it; an identity compared
+ * later by another process (a core started from another terminal, a laptop in another zone) must not.
+ */
+const PINNED_PS_ENV = { LC_ALL: 'C', TZ: 'UTC' };
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** `Mon Oct 19 10:33:52 2026` (C locale, UTC) → seconds since the epoch; `undefined` for anything else. */
+function utcLstartSeconds(text) {
+    const m = /^[A-Z][a-z]{2} ([A-Z][a-z]{2}) +(\d{1,2}) (\d{2}):(\d{2}):(\d{2}) (\d{4})$/.exec(text);
+    const month = m ? MONTHS.indexOf(m[1]) : -1;
+    if (!m || month < 0)
+        return undefined;
+    const [day, h, min, sec, year] = m.slice(2).map(Number);
+    return Date.UTC(year, month, day, h, min, sec) / 1000;
+}
 /**
  * An opaque, comparable token for "this incarnation of this PID", or `undefined` when the platform
  * cannot tell us. Only ever compared for equality, never parsed.
@@ -65,19 +84,19 @@ export async function processStartId(pid, deps = {}) {
         if (platform === 'darwin') {
             // `lstart` has one-second resolution; a PID reused inside the same second is indistinguishable,
             // which the takeover path treats as "unknown", never as a free lock.
-            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)]);
+            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)], PINNED_PS_ENV);
             const value = out.trim().replace(/\s+/g, ' ');
-            return value ? `darwin:${value}` : undefined;
+            return value ? `darwin-utc:${value}` : undefined;
         }
         if (platform === 'win32') {
             const out = await run('powershell.exe', [
                 '-NoProfile',
                 '-NonInteractive',
                 '-Command',
-                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.Ticks`,
+                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToUniversalTime().Ticks`,
             ]);
             const value = out.trim();
-            return /^\d+$/.test(value) ? `win32:${value}` : undefined;
+            return /^\d+$/.test(value) ? `win32-utc:${value}` : undefined;
         }
     }
     catch {
@@ -107,9 +126,9 @@ export async function processStartEpoch(pid, deps = {}) {
             return `epoch:${Math.floor(boot + ticks / 100)}`;
         }
         if (platform === 'darwin') {
-            const out = (await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)])).trim();
-            const epoch = Math.floor(Date.parse(out) / 1000);
-            return Number.isFinite(epoch) ? `epoch:${epoch}` : undefined;
+            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)], PINNED_PS_ENV);
+            const epoch = utcLstartSeconds(out.trim().replace(/\s+/g, ' '));
+            return epoch === undefined ? undefined : `epoch:${epoch}`;
         }
         if (platform === 'win32') {
             const out = await run('powershell.exe', [
@@ -168,11 +187,58 @@ export async function verifyProcessIdentity(pid, expected, deps = {}) {
         return 'dead';
     if (!expected)
         return 'unknown';
+    // Written before identities were pinned: in the writer's locale and zone, which this reader cannot
+    // know. Equal still proves it; a difference proves nothing, so it never frees what the owner holds.
+    if (/^(darwin|win32):/.test(expected)) {
+        const legacy = await legacyStartId(pid, deps);
+        return legacy !== undefined && legacy === expected ? 'match' : 'unknown';
+    }
     const actual = await processStartId(pid, deps);
     if (!actual)
         return 'unknown';
     return actual === expected ? 'match' : 'mismatch';
 }
+/** The identity as cores before 0.18.3 wrote it: `ps` in the C locale and local zone, local ticks. */
+async function legacyStartId(pid, deps) {
+    const platform = deps.platform ?? process.platform;
+    const run = deps.run ?? runProbe;
+    try {
+        if (platform === 'darwin') {
+            const out = await run('/bin/ps', ['-o', 'lstart=', '-p', String(pid)], { LC_ALL: 'C' });
+            const value = out.trim().replace(/\s+/g, ' ');
+            return value ? `darwin:${value}` : undefined;
+        }
+        if (platform === 'win32') {
+            const out = await run('powershell.exe', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.Ticks`,
+            ]);
+            const value = out.trim();
+            return /^\d+$/.test(value) ? `win32:${value}` : undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+/**
+ * Compare a recorded start time (`epoch:<seconds>`, `processStartEpoch`) with the live process. Seconds
+ * since the epoch read the same in every locale and zone, so a difference is proof of another process
+ * behind the PID; a second either way is the same start read at a different instant.
+ */
+export async function verifyStartEpoch(pid, expected, deps = {}) {
+    const alive = deps.alive ?? isProcessAlive;
+    if (!alive(pid))
+        return 'dead';
+    const want = Number(/^epoch:(\d+)$/.exec(expected ?? '')?.[1]);
+    const got = Number(/^epoch:(\d+)$/.exec((await processStartEpoch(pid, deps)) ?? '')?.[1]);
+    if (!Number.isFinite(want) || !Number.isFinite(got))
+        return 'unknown';
+    return Math.abs(want - got) <= 1 ? 'match' : 'mismatch';
+}
 /** Only a proven-gone process releases what it held. */
 export function identityPermitsTakeover(verdict) {
     return verdict === 'dead' || verdict === 'mismatch';

package/dist/lock/process-identity.js.map

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

package/dist/router/resolve.d.ts

@@ -21,14 +21,14 @@ export interface RemoteProvider {
     /** The image and video models enabled for this provider; never part of chat routing. */
     media?: CloudProviderMedia;
 }
-export type LocalProvider = 'llamacpp' | 'llamacpp-upstream' | 'mlx' | 'tensorrt-llm' | 'atomic-prism' | 'vllm' | 'sglang';
+export type LocalProvider = 'llamacpp' | 'llamacpp-upstream' | 'mlx' | 'tensorrt-llm' | 'atomic-prism' | 'vllm' | 'sglang' | 'foundry-local';
 /**
  * The order local providers are searched in when a request names only a model. The same model id
  * loaded under two engines resolves to the first; changing the order would silently move traffic.
  * `tensorrt-llm`, `atomic-prism`, `vllm` and `sglang` come last, in the order they were added, for
  * exactly that reason: adding a provider moves nothing that already resolved (`vllm` after
  * `atomic-prism`, which core 0.10.0 already shipped; change `add-vllm-runtime`, D11; `sglang` after
- * `vllm`, change `add-sglang-runtime`, D8). A Prism-only file never loads
+ * `vllm`, change `add-sglang-runtime`, D8; `foundry-local` after `sglang`, change `add-foundry-local`, D5). A Prism-only file never loads
  * under another engine (the compatibility gate), so its sessions are found here even near the end of
  * the list; one store model is never loaded in two managed providers at once, so their order never
  * decides between two live sessions of one id.

package/dist/router/resolve.js

@@ -11,7 +11,7 @@
  * `tensorrt-llm`, `atomic-prism`, `vllm` and `sglang` come last, in the order they were added, for
  * exactly that reason: adding a provider moves nothing that already resolved (`vllm` after
  * `atomic-prism`, which core 0.10.0 already shipped; change `add-vllm-runtime`, D11; `sglang` after
- * `vllm`, change `add-sglang-runtime`, D8). A Prism-only file never loads
+ * `vllm`, change `add-sglang-runtime`, D8; `foundry-local` after `sglang`, change `add-foundry-local`, D5). A Prism-only file never loads
  * under another engine (the compatibility gate), so its sessions are found here even near the end of
  * the list; one store model is never loaded in two managed providers at once, so their order never
  * decides between two live sessions of one id.
@@ -24,6 +24,7 @@ export const LOCAL_SEARCH_ORDER = [
     'atomic-prism',
     'vllm',
     'sglang',
+    'foundry-local',
 ];
 /**
  * The remote provider that owns `modelId`, if any. Remote wins over local — a model id the user

package/dist/router/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/router/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,UAAU;IACV,mBAAmB;IACnB,KAAK;IACL,cAAc;IACd,cAAc;IACd,MAAM;IACN,QAAQ;CACT,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,SAA8C;IAE9C,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAA;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACvD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACd,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACd,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QACrB,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;YAAE,SAAQ;QAClE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,IAAe,EACf,SAA8C;IAE9C,MAAM,KAAK,GAAG,CAAC,MAAsB,EAAE,EAAU,EAAW,EAAE,CAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,KAAK,CAAA;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACrC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACnF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE;QACrC,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAClF,OAAO,SAAS,CAAA;AAClB,CAAC"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/router/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B;IAC1D,UAAU;IACV,mBAAmB;IACnB,KAAK;IACL,cAAc;IACd,cAAc;IACd,MAAM;IACN,QAAQ;IACR,eAAe;CAChB,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,SAA8C;IAE9C,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAA;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACvD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACd,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACd,IAAI,CAAC,KAAK,CAAC;YAAE,SAAQ;QACrB,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;YAAE,SAAQ;QAClE,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,IAAe,EACf,SAA8C;IAE9C,MAAM,KAAK,GAAG,CAAC,MAAsB,EAAE,EAAU,EAAW,EAAE,CAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,KAAK,CAAA;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAA;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;QACrC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACnF,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE;QACrC,IAAI,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;YAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IAClF,OAAO,SAAS,CAAA;AAClB,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Foundry Local's accelerators (openspec change `add-foundry-local`, task 6.4, design D3). The
+ * library finds and downloads them itself; core only decides when: a `probe` of the active build
+ * when a client first asks or the active build changed, and a `prepare` when a client orders it — one
+ * at a time, each step published as `foundry-local:accelerators`.
+ *
+ * What is prepared is core's own record, `<data>/foundry-local/runtime/accelerators.json`: the
+ * library's "registered" flag lives only as long as one process (spike finding 18).
+ */
+import type { CoreEvents, FoundryLocalAccelerators, FoundryLocalPrepareRequest, FoundryLocalPrepareResult } from '../../contracts/index.js';
+import type { FoundryHostCommand } from './host-process.js';
+export declare const ACCELERATORS_FILE = "accelerators.json";
+export interface FoundryLocalAcceleratorDeps {
+    hostCommand: FoundryHostCommand;
+    /** The active build's directory, or nothing installed. */
+    resolveBuild: () => Promise<string | undefined>;
+    /** `<data>/foundry-local/runtime`: the library's data and core's `accelerators.json`. */
+    runtimeDir: string;
+    logsDir: string;
+    emit: (name: 'foundry-local:accelerators', payload: CoreEvents['foundry-local:accelerators']) => void;
+    env?: NodeJS.ProcessEnv;
+    now?: () => number;
+}
+export declare class FoundryLocalAcceleratorService {
+    private readonly deps;
+    private cache;
+    private preparing;
+    private readonly now;
+    constructor(deps: FoundryLocalAcceleratorDeps);
+    /** The names core recorded as prepared: what a load checks before it starts a host. */
+    prepared(): Promise<string[]>;
+    /** The last probe of the active build, with core's record of what is prepared; `force` probes again. */
+    list(options?: {
+        force?: boolean;
+    }): Promise<FoundryLocalAccelerators>;
+    /** Downloads and registers the accelerators named (none: all offered); one prepare at a time. */
+    prepare(request: FoundryLocalPrepareRequest): Promise<FoundryLocalPrepareResult>;
+    private withRecord;
+    private read;
+    /** Write-then-rename: a crash mid-write leaves the previous record, never half of one. */
+    private write;
+}

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

@@ -0,0 +1,153 @@
+/**
+ * Foundry Local's accelerators (openspec change `add-foundry-local`, task 6.4, design D3). The
+ * library finds and downloads them itself; core only decides when: a `probe` of the active build
+ * when a client first asks or the active build changed, and a `prepare` when a client orders it — one
+ * at a time, each step published as `foundry-local:accelerators`.
+ *
+ * What is prepared is core's own record, `<data>/foundry-local/runtime/accelerators.json`: the
+ * library's "registered" flag lives only as long as one process (spike finding 18).
+ */
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { runFoundryHostPrepare, runFoundryHostProbe } from './host-process.js';
+export const ACCELERATORS_FILE = 'accelerators.json';
+const EMPTY = { prepared: [], failures: {}, updated_at: 0 };
+export class FoundryLocalAcceleratorService {
+    deps;
+    cache = null;
+    preparing = false;
+    now;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+    }
+    /** The names core recorded as prepared: what a load checks before it starts a host. */
+    async prepared() {
+        return [...(await this.read()).prepared];
+    }
+    /** The last probe of the active build, with core's record of what is prepared; `force` probes again. */
+    async list(options = {}) {
+        const build = await this.deps.resolveBuild();
+        if (!build)
+            return {
+                installed: false,
+                build: null,
+                version: null,
+                c_api_version: null,
+                probed_at: null,
+                accelerators: [],
+                error: null,
+            };
+        const record = await this.read();
+        if (!options.force && this.cache?.build === build)
+            return this.withRecord(this.cache.answer, record);
+        const name = `${basename(dirname(build))}/${basename(build)}`;
+        let answer;
+        try {
+            const probe = await runFoundryHostProbe(this.deps.hostCommand, {
+                libDir: build,
+                appDataDir: this.deps.runtimeDir,
+                logsDir: this.deps.logsDir,
+                prepared: record.prepared,
+            }, this.deps.env ? { env: this.deps.env } : {});
+            answer = {
+                installed: true,
+                build: name,
+                version: probe.version ?? null,
+                c_api_version: probe.c_api_version,
+                probed_at: this.now(),
+                accelerators: probe.accelerators.map((accelerator) => ({
+                    name: accelerator.name,
+                    execution_provider: (accelerator.execution_provider ??
+                        null),
+                    device: accelerator.device,
+                    prepared: false,
+                })),
+                error: null,
+            };
+        }
+        catch (error) {
+            const details = error instanceof AtomicCoreError ? error.details : undefined;
+            answer = {
+                installed: true,
+                build: name,
+                version: null,
+                c_api_version: null,
+                probed_at: this.now(),
+                accelerators: [],
+                error: [error instanceof Error ? error.message : String(error), details].filter(Boolean).join(' '),
+            };
+        }
+        this.cache = { build, answer };
+        return this.withRecord(answer, record);
+    }
+    /** Downloads and registers the accelerators named (none: all offered); one prepare at a time. */
+    async prepare(request) {
+        if (this.preparing)
+            throw new AtomicCoreError('ENGINE_INSTALL_IN_PROGRESS', 'Foundry Local accelerators are already being prepared; wait for that to finish.');
+        this.preparing = true;
+        try {
+            const build = await this.deps.resolveBuild();
+            if (!build)
+                throw new AtomicCoreError('BINARY_NOT_FOUND', 'Foundry Local is not installed; install it before preparing accelerators.');
+            const summary = await runFoundryHostPrepare(this.deps.hostCommand, { libDir: build, appDataDir: this.deps.runtimeDir, logsDir: this.deps.logsDir }, request.accelerators ?? [], (step) => this.deps.emit('foundry-local:accelerators', step), this.deps.env ? { env: this.deps.env } : {});
+            const record = await this.read();
+            const prepared = new Set(record.prepared);
+            const failures = { ...record.failures };
+            for (const outcome of summary.accelerators) {
+                if (outcome.prepared) {
+                    prepared.add(outcome.name);
+                    delete failures[outcome.name];
+                }
+                else {
+                    prepared.delete(outcome.name);
+                    failures[outcome.name] = outcome.reason ?? 'Foundry Local did not register it.';
+                }
+            }
+            await this.write({ prepared: [...prepared], failures, updated_at: this.now() });
+            // The library state changed: the next request probes again (spec: after install, update, prepare).
+            this.cache = null;
+            return { accelerators: summary.accelerators };
+        }
+        finally {
+            this.preparing = false;
+        }
+    }
+    withRecord(answer, record) {
+        return {
+            ...answer,
+            accelerators: answer.accelerators.map((accelerator) => {
+                const reason = record.failures[accelerator.name];
+                const prepared = record.prepared.includes(accelerator.name);
+                return { ...accelerator, prepared, ...(!prepared && reason !== undefined ? { reason } : {}) };
+            }),
+        };
+    }
+    async read() {
+        try {
+            const raw = JSON.parse(await readFile(join(this.deps.runtimeDir, ACCELERATORS_FILE), 'utf8'));
+            return {
+                prepared: Array.isArray(raw.prepared)
+                    ? raw.prepared.filter((name) => typeof name === 'string')
+                    : [],
+                failures: raw.failures && typeof raw.failures === 'object' && !Array.isArray(raw.failures)
+                    ? Object.fromEntries(Object.entries(raw.failures).filter(([, v]) => typeof v === 'string'))
+                    : {},
+                updated_at: typeof raw.updated_at === 'number' ? raw.updated_at : 0,
+            };
+        }
+        catch {
+            return EMPTY;
+        }
+    }
+    /** Write-then-rename: a crash mid-write leaves the previous record, never half of one. */
+    async write(record) {
+        await mkdir(this.deps.runtimeDir, { recursive: true });
+        const path = join(this.deps.runtimeDir, ACCELERATORS_FILE);
+        const temporary = `${path}.tmp-${process.pid}`;
+        await writeFile(temporary, JSON.stringify(record, null, 2));
+        await rename(temporary, path);
+    }
+}
+//# sourceMappingURL=accelerators.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * `POST /models/foundry-local/check` (openspec change `add-foundry-local`, task 6.5): whether a variant
+ * would run here, from what core already knows — the platform, the installed build, the last
+ * accelerators probe and whether the machine has an NPU. Never the network.
+ */
+import type { FoundryLocalAccelerator, FoundryLocalCheckRequest, FoundryLocalCheckResult } from '../../contracts/index.js';
+export interface FoundryLocalCheckFacts {
+    platform: NodeJS.Platform;
+    arch: string;
+    /** A Foundry Local build is installed and active. */
+    installed: boolean;
+    /** The last probe's accelerators, with core's record of what is prepared. */
+    accelerators: readonly FoundryLocalAccelerator[];
+    /** An NPU on this machine (`probeNpu`); `null` when unknown — the probe's list decides then. */
+    npu: boolean | null;
+}
+export declare function foundryLocalVerdict(facts: FoundryLocalCheckFacts, request: FoundryLocalCheckRequest): FoundryLocalCheckResult;
+/** The request body, strictly: the accelerator and the device as text, nothing else. */
+export declare function parseFoundryLocalCheckRequest(body: unknown): FoundryLocalCheckRequest;

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

@@ -0,0 +1,69 @@
+/**
+ * `POST /models/foundry-local/check` (openspec change `add-foundry-local`, task 6.5): whether a variant
+ * would run here, from what core already knows — the platform, the installed build, the last
+ * accelerators probe and whether the machine has an NPU. Never the network.
+ */
+import { AtomicCoreError, FOUNDRY_LOCAL_EXECUTION_PROVIDERS } from '../../contracts/index.js';
+import { executionProvider } from './host/execution-providers.js';
+import { variantRunsOn } from './runtime.js';
+export function foundryLocalVerdict(facts, request) {
+    const known = FOUNDRY_LOCAL_EXECUTION_PROVIDERS.some((ep) => ep === request.execution_provider);
+    if (!known)
+        return {
+            verdict: 'platform-unsupported',
+            reason: `This core runs no Foundry Local variant on the "${request.execution_provider}" accelerator.`,
+            accelerator: null,
+        };
+    const short = request.execution_provider;
+    const ep = executionProvider(short);
+    const accelerator = ep.register;
+    if (!variantRunsOn(facts.platform, facts.arch, short))
+        return {
+            verdict: 'platform-unsupported',
+            reason: `${short.toUpperCase()} variants do not run on ${facts.platform} ${facts.arch}.`,
+            accelerator,
+        };
+    if (!facts.installed)
+        return {
+            verdict: 'engine-not-installed',
+            reason: 'Foundry Local is not installed on this computer.',
+            accelerator,
+        };
+    if (accelerator === null)
+        return { verdict: 'ok', reason: null, accelerator: null };
+    if (request.device === 'npu' && facts.npu === false)
+        return { verdict: 'accelerator-unavailable', reason: 'This computer has no NPU.', accelerator };
+    const found = facts.accelerators.find((candidate) => candidate.name === accelerator);
+    if (!found)
+        return {
+            verdict: 'accelerator-unavailable',
+            reason: `Foundry Local does not offer ${accelerator} on this computer.`,
+            accelerator,
+        };
+    if (!found.prepared)
+        return {
+            verdict: 'accelerator-not-prepared',
+            reason: `${accelerator} is not prepared yet; prepare it on the Foundry Local page.`,
+            accelerator,
+        };
+    return { verdict: 'ok', reason: null, accelerator };
+}
+/** The request body, strictly: the accelerator and the device as text, nothing else. */
+export function parseFoundryLocalCheckRequest(body) {
+    const invalid = (why) => {
+        throw new AtomicCoreError('INVALID_ARGUMENT', why);
+    };
+    if (typeof body !== 'object' || body === null || Array.isArray(body))
+        return invalid('The request body must be a JSON object.');
+    const record = body;
+    const extra = Object.keys(record).filter((key) => key !== 'execution_provider' && key !== 'device');
+    if (extra.length > 0)
+        invalid(`The request has fields this core does not know: ${extra.sort().join(', ')}.`);
+    const { execution_provider: executionProvider, device } = record;
+    if (typeof executionProvider !== 'string' || executionProvider === '')
+        invalid('execution_provider is required.');
+    if (typeof device !== 'string' || device === '')
+        invalid('device is required.');
+    return { execution_provider: executionProvider, device: device };
+}
+//# sourceMappingURL=check.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * 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 type { FoundryLocalExecutionProvider } from '../../../contracts/index.js';
+interface CommonArgs {
+    /** The build directory (`<root>/<tag>/<platform>`), holding `lib/`. */
+    lib: string;
+    /** The library's own data (`app_data_dir`): accelerators, shared by every build. */
+    appData: string;
+    logs: string;
+}
+export type FoundryHostArgs = (CommonArgs & {
+    mode: 'probe';
+    /** Accelerators core recorded as prepared; the library cannot tell (spike finding 18). */
+    prepared: string[];
+}) | (CommonArgs & {
+    mode: 'prepare';
+    accelerators: string[];
+}) | (CommonArgs & {
+    mode: 'serve';
+    model: string;
+    ep: FoundryLocalExecutionProvider;
+    port: number;
+    /** The host's own catalog index, deleted at exit. */
+    cache: string;
+    /** `<name>:<version>`, never one of Microsoft's catalog ids (spike finding 7). */
+    id: string;
+    tools: boolean;
+    reasoningStart?: string;
+    reasoningEnd?: string;
+    contextLength?: number;
+});
+export declare class FoundryHostUsageError extends Error {
+    constructor(message: string);
+}
+export declare function parseFoundryHostArgs(argv: readonly string[]): FoundryHostArgs;
+export {};