@atomic-chat/core 0.17.0 → 0.18.4

package/dist/downloads/archive.js

@@ -2,7 +2,7 @@
  * Archive extraction and backend-pack layout normalisation. Port of `decompress` and
  * `normalize_backend_layout` in `src-tauri/src/core/filesystem/commands.rs`.
  *
- * Only `.tar.gz` and `.zip` are supported (same error text as the app). Zip entries are guarded
+ * Only `.tar.gz` (also named `.tgz`) and `.zip` are supported (same error text as the app). Zip entries are guarded
  * against zip-slip, directory entries are created, and the unix mode bits are applied.
  */
 import { createWriteStream } from 'node:fs';
@@ -14,7 +14,7 @@ import yauzl from 'yauzl';
 export const UNSUPPORTED_ARCHIVE_MESSAGE = 'Unsupported file format. Only .tar.gz and .zip are supported.';
 export async function extractArchive(archivePath, outputDir) {
     await mkdir(outputDir, { recursive: true });
-    if (archivePath.endsWith('.tar.gz')) {
+    if (archivePath.endsWith('.tar.gz') || archivePath.endsWith('.tgz')) {
         await tarExtract({ file: archivePath, cwd: outputDir });
         return;
     }

package/dist/downloads/archive.js.map

@@ -1 +1 @@
-{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/downloads/archive.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/downloads/archive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC/C,OAAO,EAAE,CAAC,IAAI,UAAU,EAAE,MAAM,KAAK,CAAA;AACrC,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,CAAC,MAAM,2BAA2B,GAAG,+DAA+D,CAAA;AAE1G,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,SAAiB;IACzE,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAA;QACvD,OAAM;IACR,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;QACxC,OAAM;IACR,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,SAAiB;IACrC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAA;IAC7D,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACxF,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,WAAmB,EAAE,SAAiB;IACxD,OAAO,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE;QACzC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YAC1D,IAAI,GAAG,IAAI,CAAC,GAAG;gBAAE,OAAO,MAAM,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAA;YACtE,4EAA4E;YAC5E,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAQ,EAAE,EAAE,CAC3B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChG,CAAA;YACD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;YAC1B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACxB,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;gBACxC,IAAI,GAAG,KAAK,SAAS;oBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAA;gBACzE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;gBACpC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;oBAAE,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAA;gBACrF,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAA;oBACvE,OAAM;gBACR,CAAC;gBACD,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE;oBAC9C,IAAI,SAAS,IAAI,CAAC,MAAM;wBAAE,OAAO,MAAM,CAAC,SAAS,IAAI,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAA;oBAC3F,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;yBACzC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;yBACxD,IAAI,CAAC,KAAK,IAAI,EAAE;wBACf,MAAM,IAAI,GAAG,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAA;wBAChD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,CAAC;4BAC5C,MAAM,KAAK,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;wBACrD,GAAG,CAAC,SAAS,EAAE,CAAA;oBACjB,CAAC,CAAC;yBACD,KAAK,CAAC,MAAM,CAAC,CAAA;gBAClB,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;YACF,GAAG,CAAC,SAAS,EAAE,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,MAAc,EAAE,EAAE;IACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACnC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AAClE,CAAC,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAC3B,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CACV,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;AAEH,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,MAAc;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAY,CAAC,CAAA;IAC5D,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,OAAO,GAAG,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3F,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,SAAiB,EAAE,OAAe;IAC7E,IAAI,SAAS,KAAK,EAAE,IAAI,OAAO,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IAC3G,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACxC,IAAI,MAAM,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAM;IAElC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,aAAa;gBAAE,SAAQ;YAClF,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;QAClD,CAAC;QACD,OAAM;IACR,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,EACtB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;QACD,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YAAE,SAAQ;QACvF,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC;YAAE,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAA;QAC/E,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,MAAK;IACP,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,mCAAmC,QAAQ,EAAE,CAAC,CAAA;IAChG,CAAC;AACH,CAAC"}

package/dist/engine-builds/engines.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Everything that differs between the engines `EngineBuildsService` installs, as one table (openspec
+ * change `add-foundry-local`, task 4.1): which release a manifest offers, which build fits this host,
+ * which archives make it, how it is probed and recorded, what is on disk and which build is active.
+ * The service only orders the steps; a new engine is a new row here, not another branch there.
+ */
+import type { EngineBuildId, EngineBuildRef } from '../contracts/index.js';
+import type { HardwareFacts } from '../hardware/index.js';
+import type { BuildArchive } from './install.js';
+import type { ManifestOf } from './manifest.js';
+import type { FoundryLocalHostPlatform } from './select.js';
+/** One build on disk as the service sees it. */
+export interface Build extends EngineBuildRef {
+    /** For a bundled MLX build, `resources-dir`; otherwise the build's own directory. */
+    dir: string;
+    installed_at_ms: number | null;
+    published_at: string | null;
+    /** Foundry Local: the C API version recorded at install; `null` when unknown. */
+    c_api_version?: number | null;
+}
+/** What a row may read from the service's dependencies. */
+export interface EngineContext {
+    /** This engine's `<data>/…/backends`. */
+    root: string;
+    failedBackendsFile: string;
+    resourcesDir?: string | undefined;
+    platform: NodeJS.Platform;
+    hardware: () => Promise<Pick<HardwareFacts, 'osType' | 'arch' | 'cpuExtensions' | 'gpus'>>;
+    log?: ((level: 'info' | 'warn', message: string) => void) | undefined;
+    /** Which Foundry Local archive this host runs (`foundryLocalHostPlatform`), or why none. */
+    foundryLocalHost: FoundryLocalHostPlatform;
+    /** `foundry-host probe --lib <dir>` of this core; throws `ENGINE_INSTALL_FAILED` with what it printed. */
+    foundryHostProbe?: ((libDir: string) => Promise<void>) | undefined;
+}
+export interface HostChoice {
+    /** What this host would install, best first. */
+    ladder: string[];
+    backend_id: string | null;
+    /** Why `backend_id` is `null`. */
+    reason: string | null;
+}
+/** An archive of a build; `sha256` and `size` are absent when the manifest does not pin them. */
+export type ArchiveRef = Omit<BuildArchive, 'sha256' | 'size'> & {
+    sha256?: string;
+    size?: number;
+};
+export interface BuildRecordInfo {
+    tag: string;
+    backendId: string;
+    sha256: string | null;
+    installedAtMs: number;
+    publishedAt: string | null;
+    /** Foundry Local: the release's C API version. */
+    cApiVersion: number | null;
+}
+export interface EngineDescriptor<M> {
+    /** The release an install takes from the manifest, and the order key it carries. */
+    release(manifest: M): {
+        tag: string;
+        published_at: string | null;
+        c_api_version?: number;
+    };
+    hostChoice(ctx: EngineContext, manifest: M | null): Promise<HostChoice>;
+    /** The build's archive first, companions after; all unpack into one directory. */
+    archives(manifest: M, backendId: string): ArchiveRef[];
+    /** Fix the unpacked tree up before the probe; runs even when a test replaces the probe. */
+    prepare?(staging: string, ctx: EngineContext): Promise<void>;
+    /** Make the unpacked tree runnable and prove it runs here; throws `ENGINE_INSTALL_FAILED`. */
+    probe(staging: string, ctx: EngineContext): Promise<void>;
+    /** The ownership marker and `install.json`. */
+    record(staging: string, info: BuildRecordInfo): Promise<void>;
+    builds(ctx: EngineContext): Promise<Build[]>;
+    /** The build the next load uses. */
+    active(builds: Build[]): Build | undefined;
+    /**
+     * Present when a build that fails its probe sends the install down the host's ladder (sd.cpp,
+     * design D7 of `move-sdcpp-mlx-install-to-core`): remember the failed rung for this tag.
+     */
+    rememberFailedRung?(ctx: EngineContext, tag: string, backendId: string): Promise<void>;
+}
+export declare const ENGINE_DESCRIPTORS: {
+    [K in EngineBuildId]: EngineDescriptor<ManifestOf[K]>;
+};

package/dist/engine-builds/engines.js

@@ -0,0 +1,144 @@
+/**
+ * Everything that differs between the engines `EngineBuildsService` installs, as one table (openspec
+ * change `add-foundry-local`, task 4.1): which release a manifest offers, which build fits this host,
+ * which archives make it, how it is probed and recorded, what is on disk and which build is active.
+ * The service only orders the steps; a new engine is a new row here, not another branch there.
+ */
+import { AtomicCoreError } from '../contracts/index.js';
+import { listInstalledBackends, prepareSdcppTree, writeInstallRecord } from '../diffusion/install.js';
+import { listDownloadedMlx, probeMlxServer, readBundledMlx, writeMlxInstallRecord } from './builds.js';
+import { listFoundryLocalBuilds, prepareFoundryLocalTree, writeFoundryLocalInstallRecord, } from './foundry-local.js';
+import { FOUNDRY_LOCAL_C_API_VERSIONS, foundryLocalAssetUrl, mlxAssetUrl, sdcppAssetUrl } from './manifest.js';
+import { compareBuilds } from './order.js';
+import { backendKindOf, companionFor, foundryLocalHostChoice, mlxHostChoice, readFailedBackends, rememberFailedBackend, sdcppHostChoice, sdcppHostOf, } from './select.js';
+const pin = (asset) => ({
+    ...(asset.sha256 !== undefined ? { sha256: asset.sha256 } : {}),
+    ...(asset.size !== undefined ? { size: asset.size } : {}),
+});
+/** The newest of `builds` by the engine's order; the first one wins a tie. */
+function newest(engine, builds) {
+    let best;
+    for (const build of builds)
+        if (!best || compareBuilds(engine, build, best) > 0)
+            best = build;
+    return best;
+}
+const sdcpp = {
+    release: (manifest) => ({ tag: manifest.tag_name, published_at: null }),
+    async hostChoice(ctx, manifest) {
+        const host = sdcppHostOf(await ctx.hardware());
+        if (!manifest)
+            return { ladder: [], backend_id: null, reason: 'The sd.cpp manifest is unavailable.' };
+        return sdcppHostChoice(host, manifest, await readFailedBackends(ctx.failedBackendsFile));
+    },
+    archives(manifest, backendId) {
+        const ids = [backendId, companionFor(backendId)];
+        return ids.flatMap((id) => {
+            const asset = manifest.assets.find((candidate) => candidate.backend === id);
+            return asset ? [{ ...pin(asset), url: sdcppAssetUrl(manifest, asset), name: asset.name }] : [];
+        });
+    },
+    probe: (staging, ctx) => prepareSdcppTree(staging, { platform: ctx.platform, ...(ctx.log ? { log: ctx.log } : {}) }),
+    record: (staging, info) => writeInstallRecord(staging, {
+        tag: info.tag,
+        backendId: info.backendId,
+        backend: backendKindOf(info.backendId),
+        engine: 'sd-cpp',
+        sha256: info.sha256,
+        installedAtMs: info.installedAtMs,
+        dir: staging,
+    }),
+    async builds(ctx) {
+        return (await listInstalledBackends(ctx.root, ctx.platform))
+            .filter((record) => record.engine === 'sd-cpp')
+            .map((record) => ({
+            tag: record.tag,
+            backend_id: record.backendId,
+            origin: 'downloaded',
+            dir: record.dir,
+            installed_at_ms: record.installedAtMs,
+            published_at: null,
+        }));
+    },
+    /** The newest install, which `selectModelInstall` hands the next load. */
+    active: (builds) => builds[0],
+    rememberFailedRung: (ctx, tag, backendId) => rememberFailedBackend(ctx.failedBackendsFile, tag, backendId),
+};
+const mlx = {
+    release: (manifest) => ({ tag: manifest.tag_name, published_at: manifest.published_at }),
+    async hostChoice(ctx, manifest) {
+        const choice = mlxHostChoice(sdcppHostOf(await ctx.hardware()), manifest);
+        return { ...choice, ladder: choice.backend_id ? [choice.backend_id] : [] };
+    },
+    archives: (manifest, backendId) => manifest.assets
+        .filter((asset) => asset.backend === backendId)
+        .map((asset) => ({ ...pin(asset), url: mlxAssetUrl(manifest, asset), name: asset.name })),
+    probe: (staging, ctx) => probeMlxServer(staging, { platform: ctx.platform }),
+    record: (staging, { cApiVersion: _cApiVersion, ...info }) => writeMlxInstallRecord(staging, info),
+    async builds(ctx) {
+        const out = (await listDownloadedMlx(ctx.root)).map((record) => ({
+            tag: record.tag,
+            backend_id: record.backendId,
+            origin: 'downloaded',
+            dir: record.dir,
+            installed_at_ms: record.installedAtMs,
+            published_at: record.publishedAt,
+        }));
+        const bundled = await readBundledMlx(ctx.resourcesDir);
+        if (bundled)
+            out.unshift(bundledMlxBuild(bundled, ctx.resourcesDir));
+        return out;
+    },
+    /** The newest build by `published_at`, the bundled one on a tie (spec "Две точки происхождения mlx-server"). */
+    active: (builds) => newest('mlx', builds),
+};
+function bundledMlxBuild(bundled, resourcesDir) {
+    return {
+        tag: bundled.tag ?? 'bundled',
+        backend_id: 'macos-arm64',
+        origin: 'bundled',
+        dir: resourcesDir,
+        installed_at_ms: null,
+        published_at: bundled.published_at,
+    };
+}
+const foundryLocal = {
+    release: (manifest) => {
+        const newest = manifest.releases[0];
+        return { tag: newest.tag, published_at: newest.published_at, c_api_version: newest.c_api_version };
+    },
+    hostChoice: async (ctx, manifest) => foundryLocalHostChoice(ctx.foundryLocalHost, manifest?.releases[0] ?? null),
+    archives(manifest, backendId) {
+        const release = manifest.releases[0];
+        const asset = release?.assets.find((candidate) => candidate.platform === backendId);
+        return release && asset
+            ? [{ ...pin(asset), url: foundryLocalAssetUrl(manifest, release, asset), name: asset.name }]
+            : [];
+    },
+    prepare: (staging, ctx) => prepareFoundryLocalTree(staging, ctx.platform),
+    async probe(staging, ctx) {
+        if (!ctx.foundryHostProbe)
+            throw new AtomicCoreError('ENGINE_INSTALL_FAILED', 'This core has no Foundry Local host to check the build with.');
+        await ctx.foundryHostProbe(staging);
+    },
+    record: (staging, info) => writeFoundryLocalInstallRecord(staging, info),
+    async builds(ctx) {
+        return (await listFoundryLocalBuilds(ctx.root)).map((record) => ({
+            tag: record.tag,
+            backend_id: record.backendId,
+            origin: 'downloaded',
+            dir: record.dir,
+            installed_at_ms: record.installedAtMs,
+            published_at: record.publishedAt,
+            c_api_version: record.cApiVersion,
+        }));
+    },
+    /** The newest by `published_at` among the builds whose C API this core's host binds (design D2). */
+    active: (builds) => newest('foundry-local', builds.filter((build) => build.c_api_version != null && FOUNDRY_LOCAL_C_API_VERSIONS.includes(build.c_api_version))),
+};
+export const ENGINE_DESCRIPTORS = {
+    'sd-cpp': sdcpp,
+    'mlx': mlx,
+    'foundry-local': foundryLocal,
+};
+//# sourceMappingURL=engines.js.map

package/dist/engine-builds/engines.js.map

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

package/dist/engine-builds/foundry-local.d.ts

@@ -0,0 +1,22 @@
+/**
+ * What is particular to Foundry Local builds (openspec change `add-foundry-local`, design D2): the
+ * tree a release archive unpacks to is made runnable before the probe — Microsoft's debug symbols
+ * go (`*.pdb` 129 MB, `*.so.dbg` 165 MB, `*.dSYM` 52 MB; integrity was already checked on the
+ * archive's sha256) and on Linux the ONNX Runtime soname the library asks for is added — and each
+ * build records the C API version it was published with, which decides whether this core can run it.
+ */
+/** Debug symbols out; on Linux, `lib/libonnxruntime.so.1` → `libonnxruntime.so` unless it is there. */
+export declare function prepareFoundryLocalTree(staging: string, platform: NodeJS.Platform): Promise<void>;
+export interface FoundryLocalInstallRecord {
+    tag: string;
+    backendId: string;
+    sha256: string | null;
+    installedAtMs: number;
+    publishedAt: string | null;
+    cApiVersion: number | null;
+    dir: string;
+}
+/** The marker, then `install.json` without `dir`. */
+export declare function writeFoundryLocalInstallRecord(dir: string, record: Omit<FoundryLocalInstallRecord, 'dir'>): Promise<void>;
+/** Every marked `<root>/<tag>/<platform>/` with a record and its library, newest install first. */
+export declare function listFoundryLocalBuilds(root: string): Promise<FoundryLocalInstallRecord[]>;

package/dist/engine-builds/foundry-local.js

@@ -0,0 +1,100 @@
+/**
+ * What is particular to Foundry Local builds (openspec change `add-foundry-local`, design D2): the
+ * tree a release archive unpacks to is made runnable before the probe — Microsoft's debug symbols
+ * go (`*.pdb` 129 MB, `*.so.dbg` 165 MB, `*.dSYM` 52 MB; integrity was already checked on the
+ * archive's sha256) and on Linux the ONNX Runtime soname the library asks for is added — and each
+ * build records the C API version it was published with, which decides whether this core can run it.
+ */
+import { lstat, readdir, readFile, rm, stat, symlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { INSTALL_RECORD, OWNER_MARKER } from '../diffusion/install.js';
+import { isDateTime } from './manifest.js';
+/** Names that are debug symbols only, on any of the three systems. */
+const DEBUG_SYMBOLS_RE = /\.(pdb|so\.dbg|dSYM)$/;
+/** `libfoundry_local.so` needs this name; the archive ships `libonnxruntime.so` alone (spike, ruling S1). */
+const ORT_SONAME = 'libonnxruntime.so.1';
+const ORT_LIBRARY = 'libonnxruntime.so';
+const exists = (path) => stat(path).then(() => true, () => false);
+/** The name itself, a dangling symlink included. */
+const named = (path) => lstat(path).then(() => true, () => false);
+/** Delete debug symbols anywhere under `dir`; a `.dSYM` bundle is a directory. */
+async function removeDebugSymbols(dir) {
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+        const path = join(dir, entry.name);
+        if (DEBUG_SYMBOLS_RE.test(entry.name))
+            await rm(path, { recursive: true, force: true });
+        else if (entry.isDirectory())
+            await removeDebugSymbols(path);
+    }
+}
+/** Debug symbols out; on Linux, `lib/libonnxruntime.so.1` → `libonnxruntime.so` unless it is there. */
+export async function prepareFoundryLocalTree(staging, platform) {
+    await removeDebugSymbols(staging);
+    if (platform !== 'linux')
+        return;
+    const lib = join(staging, 'lib');
+    if ((await exists(join(lib, ORT_LIBRARY))) && !(await named(join(lib, ORT_SONAME))))
+        await symlink(ORT_LIBRARY, join(lib, ORT_SONAME));
+}
+/** The marker, then `install.json` without `dir`. */
+export async function writeFoundryLocalInstallRecord(dir, record) {
+    await writeFile(join(dir, OWNER_MARKER), 'atomic-chat\n');
+    const file = {
+        tag: record.tag,
+        backendId: record.backendId,
+        sha256: record.sha256,
+        installedAtMs: record.installedAtMs,
+        publishedAt: record.publishedAt,
+        cApiVersion: record.cApiVersion,
+    };
+    await writeFile(join(dir, INSTALL_RECORD), JSON.stringify(file, null, 2));
+}
+async function readFoundryLocalInstallRecord(dir) {
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(join(dir, INSTALL_RECORD), 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const { tag, backendId, sha256, installedAtMs, publishedAt, cApiVersion } = raw;
+    if (typeof tag !== 'string' ||
+        typeof backendId !== 'string' ||
+        typeof installedAtMs !== 'number' ||
+        !Number.isSafeInteger(installedAtMs))
+        return undefined;
+    return {
+        tag,
+        backendId,
+        sha256: typeof sha256 === 'string' ? sha256 : null,
+        installedAtMs,
+        publishedAt: isDateTime(publishedAt) ? publishedAt : null,
+        cApiVersion: typeof cApiVersion === 'number' && Number.isSafeInteger(cApiVersion) ? cApiVersion : null,
+        dir,
+    };
+}
+/** The Foundry Local library under `lib/`, by each system's name for it. */
+const LIBRARY_NAMES = ['libfoundry_local.dylib', 'libfoundry_local.so', 'foundry_local.dll'];
+async function hasLibrary(dir) {
+    for (const name of LIBRARY_NAMES)
+        if (await exists(join(dir, 'lib', name)))
+            return true;
+    return false;
+}
+/** Every marked `<root>/<tag>/<platform>/` with a record and its library, newest install first. */
+export async function listFoundryLocalBuilds(root) {
+    const out = [];
+    for (const tag of await readdir(root).catch(() => []))
+        for (const backend of await readdir(join(root, tag)).catch(() => [])) {
+            const dir = join(root, tag, backend);
+            if (!(await exists(join(dir, OWNER_MARKER))))
+                continue;
+            const record = await readFoundryLocalInstallRecord(dir);
+            if (record && (await hasLibrary(dir)))
+                out.push(record);
+        }
+    return out.sort((a, b) => b.installedAtMs - a.installedAtMs);
+}
+//# sourceMappingURL=foundry-local.js.map

package/dist/engine-builds/foundry-local.js.map

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

package/dist/engine-builds/manifest.d.ts

@@ -1,7 +1,9 @@
 /**
- * The two conf manifests the engine-builds module installs from: `backends/sdcpp-manifest.json`
+ * The conf manifests the engine-builds module installs from: `backends/sdcpp-manifest.json`
  * (stable-diffusion.cpp, which the desktop used to read itself) and `backends/mlx-manifest.json`
- * (the mlx-vlm fork's `mlx-server`). Openspec change `move-sdcpp-mlx-install-to-core`, design D6.
+ * (the mlx-vlm fork's `mlx-server`), openspec change `move-sdcpp-mlx-install-to-core` design D6;
+ * `backends/foundry-local-manifest.json` (Microsoft Foundry Local releases), change
+ * `add-foundry-local` design D2.
  *
  * The source follows the house pattern of `PrismCatalogService` and `cached-document.ts`: conf main
  * over `fetch` with an 8 s budget and the request's proxy, an `ATOMIC_*_MANIFEST_URL` override that
@@ -15,9 +17,15 @@
  * kept — the catalog shows it — but `assetInstallable` says no: nothing unverified is executed.
  */
 import type { DataLayout } from '../config/index.js';
-import type { ProxyConfig } from '../contracts/index.js';
+import type { EngineBuildId, ProxyConfig } from '../contracts/index.js';
+/**
+ * The `FOUNDRY_LOCAL_API_VERSION`s this core's `foundry-host` binds (design D1). A release built
+ * against another one is not offered.
+ */
+export declare const FOUNDRY_LOCAL_C_API_VERSIONS: readonly number[];
 export declare const SDCPP_MANIFEST_URL = "https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/sdcpp-manifest.json";
 export declare const MLX_MANIFEST_URL = "https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/mlx-manifest.json";
+export declare const FOUNDRY_LOCAL_MANIFEST_URL = "https://raw.githubusercontent.com/AtomicBot-ai/atomic-chat-conf/main/backends/foundry-local-manifest.json";
 export declare const ENGINE_MANIFEST_TIMEOUT_MS = 8000;
 /** A fetched manifest is reused for this long unless the caller forces a re-read. */
 export declare const ENGINE_MANIFEST_TTL_MS: number;
@@ -52,12 +60,49 @@ export interface MlxManifest {
     published_at: string;
     assets: MlxAsset[];
 }
+export declare const FOUNDRY_LOCAL_PLATFORMS: readonly ["win-x64", "win-arm64", "macos-arm64", "linux-x64", "linux-arm64"];
+export type FoundryLocalPlatform = (typeof FOUNDRY_LOCAL_PLATFORMS)[number];
+export interface FoundryLocalAsset {
+    platform: FoundryLocalPlatform;
+    name: string;
+    size: number;
+    sha256: string;
+}
+export interface FoundryLocalRelease {
+    /** The `microsoft/foundry-local` release tag, `v<major>.<minor>.<patch>`. */
+    tag: string;
+    /** The order builds of this engine have. */
+    published_at: string;
+    min_core_version: string;
+    /** `FOUNDRY_LOCAL_API_VERSION` of the release's `foundry_local_c.h`. */
+    c_api_version: number;
+    notes_url?: string;
+    assets: FoundryLocalAsset[];
+}
+/** The releases this core can install, newest first; never empty. */
+export interface FoundryLocalManifest {
+    upstream_repo: string;
+    releases: FoundryLocalRelease[];
+}
+/** What decides which releases a core accepts. */
+export interface FoundryLocalAcceptance {
+    coreVersion: string;
+    /** The C API versions this core's `foundry-host` speaks. */
+    cApiVersions: readonly number[];
+}
 /** A conf date-time this core can order by: RFC 3339 shape and a real calendar date. */
 export declare function isDateTime(value: unknown): value is string;
 /** `backends/sdcpp-manifest.json`, or throw why it is not one. */
 export declare function parseSdcppManifest(data: unknown): SdcppManifest;
 /** `backends/mlx-manifest.json`, or throw why it is not one. */
 export declare function parseMlxManifest(data: unknown): MlxManifest;
+/**
+ * `backends/foundry-local-manifest.json`: strict per field, lenient per record — a release or asset
+ * that does not parse is skipped, as is a release for a newer core or a C API `accept` does not
+ * speak (spec `foundry-local-runtime`, "Релизы рантайма публикуются в conf"). Throws for another
+ * schema version, a document without a valid repository, or no release left to install.
+ */
+export declare function parseFoundryLocalManifest(data: unknown, accept: FoundryLocalAcceptance): FoundryLocalManifest;
 /** An asset core may download and run: pinned by both `sha256` and `size`. */
 export declare function assetInstallable(asset: {
     sha256?: string;
@@ -66,7 +111,8 @@ export declare function assetInstallable(asset: {
 /** The mirror when the manifest names one, else the upstream release (which never carries `-a<sha>`). */
 export declare function sdcppAssetUrl(manifest: SdcppManifest, asset: SdcppAsset): string;
 export declare function mlxAssetUrl(manifest: MlxManifest, asset: MlxAsset): string;
-/** Which manifest: everything that differs between the two engines. */
+export declare function foundryLocalAssetUrl(manifest: FoundryLocalManifest, release: FoundryLocalRelease, asset: FoundryLocalAsset): string;
+/** Which manifest: everything that differs between the engines. */
 export interface ManifestKind<T> {
     label: string;
     url: string;
@@ -74,9 +120,14 @@ export interface ManifestKind<T> {
     parse(data: unknown): T;
     cacheFile: string;
 }
+/** The manifest document of each engine. */
+export interface ManifestOf {
+    'sd-cpp': SdcppManifest;
+    'mlx': MlxManifest;
+    'foundry-local': FoundryLocalManifest;
+}
 export declare function manifestKinds(layout: DataLayout): {
-    'sd-cpp': ManifestKind<SdcppManifest>;
-    'mlx': ManifestKind<MlxManifest>;
+    [K in EngineBuildId]: ManifestKind<ManifestOf[K]>;
 };
 /** What a read found. `source` is `null` exactly when `manifest` is. */
 export interface ManifestRead<T> {