@atomic-chat/core 0.19.0 → 0.20.5

package/dist/runtime/geniex/accelerators.d.ts

@@ -0,0 +1,20 @@
+/**
+ * GenieX's devices as accelerators (openspec change `add-geniex-runtime`, task 6.4, design D3): what
+ * the active build's library found at its install — the Hexagon NPU (`HTP0`) and the Adreno GPU
+ * (`GPUOpenCL`) — in LiteRT-LM's shape, so the clients reuse their UI. Everything a device needs
+ * ships inside the SDK build, so each is `prepared` the moment it is listed and `prepare` has
+ * nothing to download; it answers so without an event.
+ */
+import type { GeniexAccelerators, GeniexChip, GeniexPrepareRequest, GeniexPrepareResult } from '../../contracts/index.js';
+import type { GeniexBuild } from './runtime.js';
+export interface GeniexAcceleratorDeps {
+    resolveBuild: () => Promise<GeniexBuild | undefined>;
+    chip: GeniexChip;
+}
+export declare class GeniexAcceleratorService {
+    private readonly deps;
+    constructor(deps: GeniexAcceleratorDeps);
+    list(): Promise<GeniexAccelerators>;
+    /** Every name answers at once: prepared when the library found it, with why it is not otherwise. */
+    prepare(request: GeniexPrepareRequest): Promise<GeniexPrepareResult>;
+}

package/dist/runtime/geniex/accelerators.js

@@ -0,0 +1,53 @@
+/**
+ * GenieX's devices as accelerators (openspec change `add-geniex-runtime`, task 6.4, design D3): what
+ * the active build's library found at its install — the Hexagon NPU (`HTP0`) and the Adreno GPU
+ * (`GPUOpenCL`) — in LiteRT-LM's shape, so the clients reuse their UI. Everything a device needs
+ * ships inside the SDK build, so each is `prepared` the moment it is listed and `prepare` has
+ * nothing to download; it answers so without an event.
+ */
+import { acceleratorsFound } from './devices.js';
+const NOTHING_TO_PREPARE = "Nothing to prepare: GenieX's NPU and GPU libraries are part of the installed build.";
+export class GeniexAcceleratorService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async list() {
+        const build = await this.deps.resolveBuild();
+        if (!build)
+            return { installed: false, build: null, chip: this.deps.chip, accelerators: [], error: null };
+        return {
+            installed: true,
+            build: `${build.version}/${build.dir.split(/[\\/]/).at(-1) ?? ''}`,
+            chip: this.deps.chip,
+            accelerators: acceleratorsFound(build.devices).map((device) => ({
+                name: device,
+                device,
+                version: build.version,
+                size_bytes: 0,
+                prepared: true,
+            })),
+            error: null,
+        };
+    }
+    /** Every name answers at once: prepared when the library found it, with why it is not otherwise. */
+    async prepare(request) {
+        const listed = await this.list();
+        const offered = new Set(listed.accelerators.map((accelerator) => accelerator.name));
+        const wanted = request.accelerators && request.accelerators.length > 0 ? request.accelerators : [...offered];
+        return {
+            accelerators: wanted.map((name) => offered.has(name)
+                ? { name, prepared: true, reason: NOTHING_TO_PREPARE }
+                : {
+                    name,
+                    prepared: false,
+                    reason: !listed.installed
+                        ? 'GenieX is not installed on this computer.'
+                        : name === 'npu' || name === 'gpu'
+                            ? `GenieX found no ${name.toUpperCase()} on this computer.`
+                            : `GenieX has no ${name} accelerator.`,
+                }),
+        };
+    }
+}
+//# sourceMappingURL=accelerators.js.map

package/dist/runtime/geniex/accelerators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accelerators.js","sourceRoot":"","sources":["../../../src/runtime/geniex/accelerators.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAQhD,MAAM,kBAAkB,GACtB,qFAAqF,CAAA;AAEvF,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAE5D,KAAK,CAAC,IAAI;QACR,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QACzG,OAAO;YACL,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE;YAClE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,YAAY,EAAE,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC9D,IAAI,EAAE,MAAM;gBACZ,MAAM;gBACN,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,CAAC;gBACb,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;YACH,KAAK,EAAE,IAAI;SACZ,CAAA;IACH,CAAC;IAED,oGAAoG;IACpG,KAAK,CAAC,OAAO,CAAC,OAA6B;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QAChC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;QACnF,MAAM,MAAM,GACV,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAA;QAC/F,OAAO;YACL,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBACf,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE;gBACtD,CAAC,CAAC;oBACE,IAAI;oBACJ,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS;wBACvB,CAAC,CAAC,2CAA2C;wBAC7C,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK;4BAChC,CAAC,CAAC,mBAAmB,IAAI,CAAC,WAAW,EAAE,oBAAoB;4BAC3D,CAAC,CAAC,iBAAiB,IAAI,eAAe;iBAC3C,CACN;SACF,CAAA;IACH,CAAC;CACF"}

package/dist/runtime/geniex/check.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `POST /models/geniex/check` (openspec change `add-geniex-runtime`, task 6.5): whether a variant
+ * would run here. Before a download, from what core already knows — this machine's chip, the
+ * active build and the devices its probe found — never the network. For a model on disk, also from
+ * the model itself (`geniex-host inspect`, no library needed), whose facts come back in the answer
+ * for the client to write into `model.yml`.
+ */
+import type { GeniexCheckRequest, GeniexCheckResult, GeniexChip, GeniexModelMetadata } from '../../contracts/index.js';
+import type { ModelRegistry } from '../../models/index.js';
+import type { GeniexBuild } from './runtime.js';
+export interface GeniexCheckFacts {
+    chip: GeniexChip;
+    build: GeniexBuild | null;
+}
+/** The verdict for a variant (`plugin`, `device`, `chip`, `min_runtime_version`), and for a model its facts. */
+export declare function geniexVerdict(facts: GeniexCheckFacts, request: Pick<GeniexCheckRequest, 'plugin' | 'device' | 'chip' | 'min_runtime_version'>, model: GeniexModelMetadata | null): GeniexCheckResult;
+/** The request body, strictly: a variant, a path with its plugin and device, or a model id. */
+export declare function parseGeniexCheckRequest(body: unknown): GeniexCheckRequest;
+export interface GeniexCheckDeps {
+    chip: GeniexChip;
+    /** `<data>/geniex/models`: the only place a checked path may be. */
+    modelsDir: string;
+    registry: ModelRegistry;
+    resolveBuild: () => Promise<GeniexBuild | undefined>;
+    /** The runtime's cached `inspect` (by path and mtime); needs no build. */
+    inspect: (path: string) => Promise<GeniexModelMetadata>;
+}
+export declare class GeniexCheckService {
+    private readonly deps;
+    constructor(deps: GeniexCheckDeps);
+    /** A path inside the models root, links resolved, or `INVALID_ARGUMENT`. */
+    private inRoot;
+    check(request: GeniexCheckRequest): Promise<GeniexCheckResult>;
+}

package/dist/runtime/geniex/check.js

@@ -0,0 +1,117 @@
+/**
+ * `POST /models/geniex/check` (openspec change `add-geniex-runtime`, task 6.5): whether a variant
+ * would run here. Before a download, from what core already knows — this machine's chip, the
+ * active build and the devices its probe found — never the network. For a model on disk, also from
+ * the model itself (`geniex-host inspect`, no library needed), whose facts come back in the answer
+ * for the client to write into `model.yml`.
+ */
+import { realpath } from 'node:fs/promises';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { AtomicCoreError, GENIEX_CHIPS, GENIEX_DEVICES, GENIEX_PLUGINS } from '../../contracts/index.js';
+import { compareVersions } from '../../backend/index.js';
+import { deviceFound, deviceMissingReason } from './devices.js';
+import { readGeniexBlock } from './model-yml.js';
+const verdict = (v, reason, metadata) => ({
+    verdict: v,
+    reason,
+    ...(metadata ? { metadata } : {}),
+});
+/** The verdict for a variant (`plugin`, `device`, `chip`, `min_runtime_version`), and for a model its facts. */
+export function geniexVerdict(facts, request, model) {
+    const plugin = request.plugin ?? '';
+    if (!GENIEX_PLUGINS.some((known) => known === plugin))
+        return verdict('platform-unsupported', `This core runs no GenieX model with the "${plugin}" plugin.`, model);
+    const device = request.device ?? '';
+    if (!GENIEX_DEVICES.some((known) => known === device))
+        return verdict('platform-unsupported', `This core runs no GenieX model on the "${device}" device.`, model);
+    if (plugin === 'qairt') {
+        if (device !== 'npu')
+            return verdict('platform-unsupported', 'AI Hub bundles run on the NPU only.', model);
+        const chip = model?.kind === 'qairt' && model.chip ? model.chip : request.chip;
+        if (chip === undefined || chip === null)
+            return verdict('platform-unsupported', 'This bundle does not say which Snapdragon chip it is built for.', model);
+        if (!GENIEX_CHIPS.some((known) => known === chip))
+            return verdict('platform-unsupported', `This core knows no Snapdragon "${chip}".`, model);
+        if (chip !== facts.chip)
+            return verdict('platform-unsupported', `This bundle is built for the Snapdragon ${chip}; this computer has the ${facts.chip}.`, model);
+    }
+    if (model && (model.kind === 'qairt') !== (plugin === 'qairt'))
+        return verdict('platform-unsupported', model.kind === 'qairt'
+            ? 'This folder holds an AI Hub bundle, which runs with the qairt plugin.'
+            : 'This file is a GGUF, which runs with the llama_cpp plugin.', model);
+    if (!facts.build)
+        return verdict('engine-not-installed', 'GenieX is not installed on this computer.', model);
+    if (!deviceFound(device, facts.build.devices))
+        return verdict('accelerator-unavailable', deviceMissingReason(device), model);
+    const needs = (model?.kind === 'qairt' ? model.min_runtime_version : null) ?? request.min_runtime_version ?? null;
+    if (needs && compareVersions(needs, facts.build.version) > 0)
+        return verdict('requires-newer-engine', `This model needs GenieX ${needs}; the installed one is ${facts.build.version}.`, model);
+    return verdict('ok', null, model);
+}
+const VERSION_RE = /^\d+\.\d+(\.\d+)?$/;
+const FIELDS = ['plugin', 'device', 'chip', 'min_runtime_version', 'path', 'model_id'];
+/** The request body, strictly: a variant, a path with its plugin and device, or a model id. */
+export function parseGeniexCheckRequest(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) => !FIELDS.some((field) => field === key));
+    if (extra.length > 0)
+        invalid(`The request has fields this core does not know: ${extra.sort().join(', ')}.`);
+    const out = {};
+    for (const key of FIELDS) {
+        const value = record[key];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string' || value === '')
+            invalid(`${key} must be text.`);
+        out[key] = value;
+    }
+    if (out.min_runtime_version !== undefined && !VERSION_RE.test(out.min_runtime_version))
+        invalid('min_runtime_version must be X.Y or X.Y.Z.');
+    if (out.model_id !== undefined) {
+        if (Object.keys(out).length > 1)
+            invalid('model_id is checked alone: its variant comes from model.yml.');
+        return out;
+    }
+    if (out.plugin === undefined || out.device === undefined)
+        invalid('plugin and device are required for a variant or a path.');
+    return out;
+}
+export class GeniexCheckService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** A path inside the models root, links resolved, or `INVALID_ARGUMENT`. */
+    async inRoot(path) {
+        const refuse = () => new AtomicCoreError('INVALID_ARGUMENT', 'path must be a file or folder inside the GenieX models folder.');
+        if (!isAbsolute(path))
+            throw new AtomicCoreError('INVALID_ARGUMENT', 'path must be absolute.');
+        const root = await realpath(this.deps.modelsDir).catch(() => resolve(this.deps.modelsDir));
+        // A model that is not there yet is judged by its spelling; one that is, by where its links lead.
+        const full = await realpath(path).catch(() => resolve(path));
+        const rel = relative(root, full);
+        if (rel === '' || rel.startsWith('..') || isAbsolute(rel))
+            throw refuse();
+        return resolve(path);
+    }
+    async check(request) {
+        let variant = request;
+        let path = request.path !== undefined ? await this.inRoot(request.path) : null;
+        if (request.model_id !== undefined) {
+            const yml = await this.deps.registry.read(request.model_id);
+            const block = readGeniexBlock(yml);
+            variant = { plugin: block.plugin, device: block.backend, ...(block.chip ? { chip: block.chip } : {}) };
+            // The registry's own path: an installed model may be a link, which the runtime loads as it is.
+            path = this.deps.registry.resolvePaths(yml).modelPath;
+        }
+        const facts = { chip: this.deps.chip, build: (await this.deps.resolveBuild()) ?? null };
+        const metadata = path ? await this.deps.inspect(path) : null;
+        return geniexVerdict(facts, variant, metadata);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/runtime/geniex/check.js.map

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

package/dist/runtime/geniex/chip.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Where the `geniex` provider registers, and which Snapdragon chip the machine has (openspec change
+ * `add-geniex-runtime`, task 4.3, design D3): Windows arm64 whose processor string names a Snapdragon
+ * X of either generation. The AI Hub bundles are compiled per Hexagon generation, not per SKU, and
+ * conf spells the generations `x-elite` (Hexagon v73: X Elite `X1E…`, X Plus `X1P…`, X `X1-…`) and
+ * `x2-elite` (v81: X2 Elite `X2E…`, X2 Plus `X2P…`) — AI Hub itself points the X Plus at the X Elite
+ * zip. Other arm64 Windows machines (virtual machines, 8cx: Hexagon v69, which the SDK has no HTP
+ * library for) keep the provider off.
+ *
+ * The same table shape as LiteRT-LM's Intel NPU generations (`litert-lm/npu.ts`). Verified on an X2
+ * Elite (rulings/core.md, spike S1); the first generation is read off the part numbers only.
+ */
+import type { GeniexChip } from '../../contracts/index.js';
+export declare function geniexChip(cpuName: string): GeniexChip | null;
+export interface GeniexHostFacts {
+    platform: NodeJS.Platform;
+    arch: string;
+    /** `Win32_Processor.Name` on Windows, as the hardware probe reports it. */
+    cpuName: string;
+}
+/** Which SDK zip this host runs and which chip it has, or why none (`EngineHostPlatform` for engine-builds). */
+export type GeniexHostPlatform = {
+    platform: 'win-arm64';
+    chip: GeniexChip;
+} | {
+    platform: null;
+    reason: string;
+};
+export declare function geniexHostPlatform(host: GeniexHostFacts): GeniexHostPlatform;

package/dist/runtime/geniex/chip.js

@@ -0,0 +1,35 @@
+/**
+ * Where the `geniex` provider registers, and which Snapdragon chip the machine has (openspec change
+ * `add-geniex-runtime`, task 4.3, design D3): Windows arm64 whose processor string names a Snapdragon
+ * X of either generation. The AI Hub bundles are compiled per Hexagon generation, not per SKU, and
+ * conf spells the generations `x-elite` (Hexagon v73: X Elite `X1E…`, X Plus `X1P…`, X `X1-…`) and
+ * `x2-elite` (v81: X2 Elite `X2E…`, X2 Plus `X2P…`) — AI Hub itself points the X Plus at the X Elite
+ * zip. Other arm64 Windows machines (virtual machines, 8cx: Hexagon v69, which the SDK has no HTP
+ * library for) keep the provider off.
+ *
+ * The same table shape as LiteRT-LM's Intel NPU generations (`litert-lm/npu.ts`). Verified on an X2
+ * Elite (rulings/core.md, spike S1); the first generation is read off the part numbers only.
+ */
+/**
+ * The part numbers as a bare word, not a suffix: `X1E80100`, `X1E78100` (X Elite), `X1P64100` (X Plus),
+ * `X1-26-100` (X), `X2E88100` (X2 Elite), `X2P…` (X2 Plus).
+ */
+const PART_RE = /(?:^|[^A-Za-z0-9])(X1E|X1P|X1(?=-\d)|X2E|X2P)\d*(?![A-Za-z])/;
+export function geniexChip(cpuName) {
+    const part = PART_RE.exec(cpuName)?.[1];
+    if (!part)
+        return null;
+    return part.startsWith('X1') ? 'x-elite' : 'x2-elite';
+}
+export function geniexHostPlatform(host) {
+    if (host.platform !== 'win32' || host.arch !== 'arm64')
+        return { platform: null, reason: `GenieX runs on Windows arm64 only, not ${host.platform} ${host.arch}.` };
+    const chip = geniexChip(host.cpuName);
+    if (!chip)
+        return {
+            platform: null,
+            reason: `GenieX runs on Snapdragon X (X Elite, X Plus, X, X2 Elite, X2 Plus) only; this processor is "${host.cpuName}".`,
+        };
+    return { platform: 'win-arm64', chip };
+}
+//# sourceMappingURL=chip.js.map

package/dist/runtime/geniex/chip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chip.js","sourceRoot":"","sources":["../../../src/runtime/geniex/chip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;GAGG;AACH,MAAM,OAAO,GAAG,8DAA8D,CAAA;AAE9E,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAA;AACvD,CAAC;AAaD,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;QACpD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,0CAA0C,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;IAC5G,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACrC,IAAI,CAAC,IAAI;QACP,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,gGAAgG,IAAI,CAAC,OAAO,IAAI;SACzH,CAAA;IACH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;AACxC,CAAC"}

package/dist/runtime/geniex/devices.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GenieX's device ids and the devices a model names (openspec change `add-geniex-runtime`, design
+ * D3): `geniex_get_device_list` of the `llama_cpp` plugin answers ids such as `HTP0` (the Hexagon
+ * NPU), `GPUOpenCL` (the Adreno GPU) and `CPU`; a model asks for `npu`, `gpu`, `cpu` or `hybrid`
+ * (NPU and GPU together). The ids are what `probe` recorded at the build's install.
+ */
+import type { GeniexDevice } from '../../contracts/index.js';
+/** Whether the library found what `device` needs; the CPU is always there. */
+export declare function deviceFound(device: GeniexDevice, ids: readonly string[]): boolean;
+/** Why `device` is not there, in words a card can show. */
+export declare function deviceMissingReason(device: GeniexDevice): string;
+/** The accelerators the library found, in the order the clients list them: the NPU, then the GPU. */
+export declare function acceleratorsFound(ids: readonly string[]): Array<Extract<GeniexDevice, 'npu' | 'gpu'>>;

package/dist/runtime/geniex/devices.js

@@ -0,0 +1,32 @@
+/**
+ * GenieX's device ids and the devices a model names (openspec change `add-geniex-runtime`, design
+ * D3): `geniex_get_device_list` of the `llama_cpp` plugin answers ids such as `HTP0` (the Hexagon
+ * NPU), `GPUOpenCL` (the Adreno GPU) and `CPU`; a model asks for `npu`, `gpu`, `cpu` or `hybrid`
+ * (NPU and GPU together). The ids are what `probe` recorded at the build's install.
+ */
+const hasNpu = (ids) => ids.some((id) => /^HTP/i.test(id));
+const hasGpu = (ids) => ids.some((id) => /^GPU/i.test(id));
+/** Whether the library found what `device` needs; the CPU is always there. */
+export function deviceFound(device, ids) {
+    switch (device) {
+        case 'npu':
+            return hasNpu(ids);
+        case 'gpu':
+            return hasGpu(ids);
+        case 'hybrid':
+            return hasNpu(ids) && hasGpu(ids);
+        case 'cpu':
+            return true;
+    }
+}
+/** Why `device` is not there, in words a card can show. */
+export function deviceMissingReason(device) {
+    if (device === 'gpu')
+        return 'GenieX found no Adreno GPU (no OpenCL device) on this computer.';
+    return `GenieX found no Hexagon NPU (no HTP device) on this computer${device === 'hybrid' ? ', which hybrid needs with the GPU' : ''}; check the Qualcomm NPU driver.`;
+}
+/** The accelerators the library found, in the order the clients list them: the NPU, then the GPU. */
+export function acceleratorsFound(ids) {
+    return [...(hasNpu(ids) ? ['npu'] : []), ...(hasGpu(ids) ? ['gpu'] : [])];
+}
+//# sourceMappingURL=devices.js.map

package/dist/runtime/geniex/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../../../src/runtime/geniex/devices.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,GAAG,CAAC,GAAsB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACtF,MAAM,MAAM,GAAG,CAAC,GAAsB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AAEtF,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,MAAoB,EAAE,GAAsB;IACtE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;QACpB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;QACpB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAA;QACnC,KAAK,KAAK;YACR,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,iEAAiE,CAAA;IAC9F,OAAO,+DAA+D,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,EAAE,kCAAkC,CAAA;AACxK,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC7F,CAAC"}

package/dist/runtime/geniex/geniex-host.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@atomic-chat/core/geniex-host`: the one entry of the hidden `geniex-host` mode (change
+ * `add-geniex-runtime`, design D1). The core binaries and any program that embeds the core as a
+ * library (`atc`) hand it the arguments after `geniex-host` before they parse their own commands,
+ * because `geniexHostCommand` starts the host as `<this program> geniex-host …`.
+ *
+ * Importing this file loads no `bun:*`: the library lives in a Worker the mode alone starts.
+ */
+/**
+ * Runs `geniex-host <argv…>` and returns its exit code (`EXIT` in `host/run.ts`). Lines go to this
+ * process's stdout and stderr through writers that go quiet instead of crashing the host when the
+ * core closed its end of a pipe (EPIPE).
+ */
+export declare function runGeniexHostMain(argv: readonly string[], io?: {
+    stdout: (text: string) => void;
+    stderr: (text: string) => void;
+}): Promise<number>;

package/dist/runtime/geniex/geniex-host.js

@@ -0,0 +1,26 @@
+/**
+ * `@atomic-chat/core/geniex-host`: the one entry of the hidden `geniex-host` mode (change
+ * `add-geniex-runtime`, design D1). The core binaries and any program that embeds the core as a
+ * library (`atc`) hand it the arguments after `geniex-host` before they parse their own commands,
+ * because `geniexHostCommand` starts the host as `<this program> geniex-host …`.
+ *
+ * Importing this file loads no `bun:*`: the library lives in a Worker the mode alone starts.
+ */
+import { detachableWriter } from '../../cli/io.js';
+import { WorkerEngine, spawnGeniexWorker } from './host/engine.js';
+import { lineIo, runGeniexHost } from './host/run.js';
+/**
+ * Runs `geniex-host <argv…>` and returns its exit code (`EXIT` in `host/run.ts`). Lines go to this
+ * process's stdout and stderr through writers that go quiet instead of crashing the host when the
+ * core closed its end of a pipe (EPIPE).
+ */
+export async function runGeniexHostMain(argv, io = {
+    stdout: detachableWriter(process.stdout),
+    stderr: detachableWriter(process.stderr),
+}) {
+    return runGeniexHost(argv, {
+        ...lineIo(io),
+        startEngine: async () => new WorkerEngine(await spawnGeniexWorker()),
+    });
+}
+//# sourceMappingURL=geniex-host.js.map

package/dist/runtime/geniex/geniex-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geniex-host.js","sourceRoot":"","sources":["../../../src/runtime/geniex/geniex-host.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAErD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAuB,EACvB,KAAyE;IACvE,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC;IACxC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC;CACzC;IAED,OAAO,aAAa,CAAC,IAAI,EAAE;QACzB,GAAG,MAAM,CAAC,EAAE,CAAC;QACb,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,YAAY,CAAC,MAAM,iBAAiB,EAAE,CAAC;KACrE,CAAC,CAAA;AACJ,CAAC"}

package/dist/runtime/geniex/host/args.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The arguments of the hidden `geniex-host` mode (openspec change `add-geniex-runtime`, task 5.1).
+ * Core is the only caller, so the parse is strict: anything unknown is a bug on core's side.
+ *
+ *   geniex-host probe   --lib <build>
+ *   geniex-host inspect <file | bundle folder>
+ *   geniex-host serve   --lib <build> --engine-version <v> --model <file | bundle folder>
+ *                       --plugin llama_cpp|qairt --device npu|gpu|cpu|hybrid [--mmproj <file>]
+ *                       --nctx <n> [--threads <n>] --max-tokens <n> --power-mode <mode> --port <p, 0 for any>
+ *                       --tmp <dir> --id <model id> [--reasoning]
+ */
+import type { GeniexDevice, GeniexPlugin } from '../../../contracts/index.js';
+import type { GeniexPowerMode } from './library.js';
+export type GeniexHostArgs = {
+    mode: 'probe';
+    lib: string;
+} | {
+    mode: 'inspect';
+    path: string;
+} | {
+    mode: 'serve';
+    /** The build directory, holding `lib/`. */
+    lib: string;
+    /** The build's GenieX version, checked against a bundle's `min_runtime_version`. */
+    engineVersion: string;
+    /** A GGUF file (`llama_cpp`) or an AI Hub bundle folder (`qairt`). */
+    model: string;
+    plugin: GeniexPlugin;
+    device: GeniexDevice;
+    /** `llama_cpp` only: the vision projector beside the GGUF file. */
+    mmproj?: string;
+    /** `n_ctx`, already cut to what the model allows. */
+    nCtx: number;
+    threads: number;
+    /** The default `max_tokens` of a request that names none. */
+    maxTokens: number;
+    /** The NPU power mode; ignored off the NPU. */
+    powerMode: GeniexPowerMode;
+    port: number;
+    /** Where request images are written for the library; created when missing. */
+    tmp: string;
+    /** The id `/v1/models` lists: core's session id. */
+    id: string;
+    /** Think by default (`model.yml` `reasoning`); a request may still turn it off. */
+    reasoning: boolean;
+};
+export declare class GeniexHostUsageError extends Error {
+    constructor(message: string);
+}
+/**
+ * Threads for the `llama_cpp` plugin when `--threads` is not given. Spike S3 on an 18-core X2 Elite
+ * (Qwen3 4B Q4_0, cpu): the plugin's own default decoded at 17.7 tok/s, 12 threads at 40.7 (conf's
+ * llama.cpp with `-t 12`: 39.5), 18 threads at 21.1 — the efficiency cores drag the pool down.
+ */
+export declare function defaultGeniexThreads(): number;
+export declare function parseGeniexHostArgs(argv: readonly string[]): GeniexHostArgs;

package/dist/runtime/geniex/host/args.js

@@ -0,0 +1,115 @@
+/**
+ * The arguments of the hidden `geniex-host` mode (openspec change `add-geniex-runtime`, task 5.1).
+ * Core is the only caller, so the parse is strict: anything unknown is a bug on core's side.
+ *
+ *   geniex-host probe   --lib <build>
+ *   geniex-host inspect <file | bundle folder>
+ *   geniex-host serve   --lib <build> --engine-version <v> --model <file | bundle folder>
+ *                       --plugin llama_cpp|qairt --device npu|gpu|cpu|hybrid [--mmproj <file>]
+ *                       --nctx <n> [--threads <n>] --max-tokens <n> --power-mode <mode> --port <p, 0 for any>
+ *                       --tmp <dir> --id <model id> [--reasoning]
+ */
+import { availableParallelism } from 'node:os';
+import { parseArgs } from 'node:util';
+import { GENIEX_DEVICES, GENIEX_PLUGINS } from '../../../contracts/index.js';
+import { GENIEX_POWER_MODES } from './library.js';
+export class GeniexHostUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GeniexHostUsageError';
+    }
+}
+const required = (values, key) => {
+    const value = values[key];
+    if (typeof value !== 'string' || value === '')
+        throw new GeniexHostUsageError(`--${key} is required`);
+    return value;
+};
+const VERSION_RE = /^\d+\.\d+\.\d+$/;
+function wholeNumber(values, key, min, max) {
+    const raw = required(values, key);
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value < min || value > max)
+        throw new GeniexHostUsageError(`--${key} ${raw} is not a whole number from ${min} to ${max}`);
+    return value;
+}
+function oneOf(values, key, known, said) {
+    const value = required(values, key);
+    if (!known.some((candidate) => candidate === value))
+        throw new GeniexHostUsageError(`--${key} ${value} is not ${said}`);
+    return value;
+}
+/**
+ * Threads for the `llama_cpp` plugin when `--threads` is not given. Spike S3 on an 18-core X2 Elite
+ * (Qwen3 4B Q4_0, cpu): the plugin's own default decoded at 17.7 tok/s, 12 threads at 40.7 (conf's
+ * llama.cpp with `-t 12`: 39.5), 18 threads at 21.1 — the efficiency cores drag the pool down.
+ */
+export function defaultGeniexThreads() {
+    return Math.max(1, Math.min(12, availableParallelism()));
+}
+export function parseGeniexHostArgs(argv) {
+    const [mode, ...rest] = argv;
+    try {
+        if (mode === 'probe') {
+            const { values } = parseArgs({ args: rest, options: { lib: { type: 'string' } }, strict: true });
+            return { mode, lib: required(values, 'lib') };
+        }
+        if (mode === 'inspect') {
+            const { positionals } = parseArgs({ args: rest, options: {}, strict: true, allowPositionals: true });
+            if (positionals.length !== 1 || !positionals[0])
+                throw new GeniexHostUsageError('inspect takes one path');
+            return { mode, path: positionals[0] };
+        }
+        if (mode === 'serve') {
+            const { values } = parseArgs({
+                args: rest,
+                options: {
+                    'lib': { type: 'string' },
+                    'engine-version': { type: 'string' },
+                    'model': { type: 'string' },
+                    'plugin': { type: 'string' },
+                    'device': { type: 'string' },
+                    'mmproj': { type: 'string' },
+                    'nctx': { type: 'string' },
+                    'threads': { type: 'string' },
+                    'max-tokens': { type: 'string' },
+                    'power-mode': { type: 'string' },
+                    'port': { type: 'string' },
+                    'tmp': { type: 'string' },
+                    'id': { type: 'string' },
+                    'reasoning': { type: 'boolean' },
+                },
+                strict: true,
+            });
+            const lib = required(values, 'lib');
+            const engineVersion = required(values, 'engine-version');
+            if (!VERSION_RE.test(engineVersion))
+                throw new GeniexHostUsageError(`--engine-version ${engineVersion} is not X.Y.Z`);
+            const mmproj = values['mmproj'];
+            return {
+                mode,
+                lib,
+                engineVersion,
+                model: required(values, 'model'),
+                plugin: oneOf(values, 'plugin', GENIEX_PLUGINS, 'llama_cpp or qairt'),
+                device: oneOf(values, 'device', GENIEX_DEVICES, 'npu, gpu, cpu or hybrid'),
+                ...(mmproj ? { mmproj } : {}),
+                nCtx: wholeNumber(values, 'nctx', 1, 16_777_216),
+                threads: values['threads'] === undefined ? defaultGeniexThreads() : wholeNumber(values, 'threads', 1, 1024),
+                maxTokens: wholeNumber(values, 'max-tokens', 1, 16_777_216),
+                powerMode: oneOf(values, 'power-mode', GENIEX_POWER_MODES, `one of ${GENIEX_POWER_MODES.join(', ')}`),
+                port: wholeNumber(values, 'port', 0, 65535),
+                tmp: required(values, 'tmp'),
+                id: required(values, 'id'),
+                reasoning: values['reasoning'] === true,
+            };
+        }
+    }
+    catch (error) {
+        if (error instanceof GeniexHostUsageError)
+            throw error;
+        throw new GeniexHostUsageError(error instanceof Error ? error.message : String(error));
+    }
+    throw new GeniexHostUsageError(`geniex-host: unknown mode ${JSON.stringify(mode ?? '')} (probe, inspect, serve)`);
+}
+//# sourceMappingURL=args.js.map

package/dist/runtime/geniex/host/args.js.map

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