@octomil/browser 1.0.0 → 1.1.0

package/dist/routing.js

@@ -0,0 +1,221 @@
+/**
+ * @octomil/browser — Routing client
+ *
+ * ADVANCED — MAY: Calls the Octomil routing API to decide whether inference
+ * should run on-device or in the cloud.  Caches decisions with a configurable
+ * TTL and provides a cloud inference proxy when the server picks "cloud".
+ *
+ * This module is part of the ADVANCED tier. SDKs MAY implement routing
+ * support. It is not required for core SDK compliance.
+ */
+import { OctomilError } from "./types.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_CACHE_TTL_MS = 300_000; // 5 minutes
+const PERSISTENT_CACHE_KEY = "octomil_routing_cache";
+// ---------------------------------------------------------------------------
+// RoutingClient
+// ---------------------------------------------------------------------------
+export class RoutingClient {
+    serverUrl;
+    apiKey;
+    cacheTtlMs;
+    prefer;
+    cache = new Map();
+    /** Whether the last `route()` call was answered from offline fallback. */
+    lastRouteWasOffline = false;
+    constructor(config) {
+        this.serverUrl = config.serverUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+        this.cacheTtlMs = config.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+        this.prefer = config.prefer ?? "fastest";
+    }
+    // -----------------------------------------------------------------------
+    // Public
+    // -----------------------------------------------------------------------
+    /**
+     * Ask the routing API whether to run on-device or in the cloud.
+     *
+     * Returns a cached decision when available and not expired.
+     * On network failure, returns a persistent-cached decision or a synthetic
+     * device decision. Never returns `null`.
+     */
+    async route(modelId, modelParams, modelSizeMb, deviceCapabilities) {
+        this.lastRouteWasOffline = false;
+        const cached = this.cache.get(modelId);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.decision;
+        }
+        const body = {
+            model_id: modelId,
+            model_params: modelParams,
+            model_size_mb: modelSizeMb,
+            device_capabilities: deviceCapabilities,
+            prefer: this.prefer,
+        };
+        let response;
+        try {
+            response = await fetch(`${this.serverUrl}/api/v1/route`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch {
+            return this.offlineFallback(modelId);
+        }
+        if (!response.ok) {
+            return this.offlineFallback(modelId);
+        }
+        const decision = (await response.json());
+        this.cache.set(modelId, {
+            decision,
+            expiresAt: Date.now() + this.cacheTtlMs,
+        });
+        // Persist to localStorage for offline fallback.
+        this.persistToStorage(modelId, decision);
+        return decision;
+    }
+    /**
+     * Run inference in the cloud via POST /api/v1/inference.
+     *
+     * Throws on failure so the caller can catch and fall back to local.
+     */
+    async cloudInfer(modelId, inputData, parameters = {}) {
+        const body = {
+            model_id: modelId,
+            input_data: inputData,
+            parameters,
+        };
+        let response;
+        try {
+            response = await fetch(`${this.serverUrl}/api/v1/inference`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Cloud inference request failed: ${String(err)}`, err);
+        }
+        if (!response.ok) {
+            throw new OctomilError("INFERENCE_FAILED", `Cloud inference failed: HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+    /** Invalidate all cached routing decisions (in-memory and persistent). */
+    clearCache() {
+        this.cache.clear();
+        try {
+            localStorage.removeItem(PERSISTENT_CACHE_KEY);
+        }
+        catch {
+            // localStorage unavailable (e.g. SSR).
+        }
+    }
+    /** Invalidate the cached routing decision for a specific model. */
+    invalidate(modelId) {
+        this.cache.delete(modelId);
+        const entries = this.loadPersistentCache();
+        delete entries[modelId];
+        this.savePersistentCache(entries);
+    }
+    // -----------------------------------------------------------------------
+    // Offline fallback
+    // -----------------------------------------------------------------------
+    offlineFallback(modelId) {
+        this.lastRouteWasOffline = true;
+        // Try persistent cache.
+        const entries = this.loadPersistentCache();
+        const persisted = entries[modelId];
+        if (persisted) {
+            return { ...persisted, cached: true, offline: false };
+        }
+        // No cache — synthetic device decision.
+        return {
+            id: `offline-${modelId}`,
+            target: "device",
+            format: "onnx",
+            engine: "ort-wasm",
+            fallback_target: null,
+            cached: false,
+            offline: true,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Persistent storage (localStorage)
+    // -----------------------------------------------------------------------
+    persistToStorage(modelId, decision) {
+        const entries = this.loadPersistentCache();
+        entries[modelId] = decision;
+        this.savePersistentCache(entries);
+    }
+    loadPersistentCache() {
+        try {
+            const raw = localStorage.getItem(PERSISTENT_CACHE_KEY);
+            if (!raw)
+                return {};
+            return JSON.parse(raw);
+        }
+        catch {
+            return {};
+        }
+    }
+    savePersistentCache(entries) {
+        try {
+            localStorage.setItem(PERSISTENT_CACHE_KEY, JSON.stringify(entries));
+        }
+        catch {
+            // localStorage unavailable or full.
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Detect device capabilities in a browser environment.
+ * Returns reasonable defaults when APIs are unavailable.
+ */
+export async function detectDeviceCapabilities() {
+    const gpuAvailable = await detectWebGPU();
+    // navigator.deviceMemory is only available in Chromium browsers.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const memoryGb = navigator.deviceMemory;
+    const totalMemoryMb = memoryGb ? Math.round(memoryGb * 1024) : 0;
+    const supportedRuntimes = ["wasm"];
+    if (gpuAvailable) {
+        supportedRuntimes.push("webgpu");
+    }
+    return {
+        platform: "web",
+        model: navigator.userAgent,
+        total_memory_mb: totalMemoryMb,
+        gpu_available: gpuAvailable,
+        npu_available: false, // No NPU API in browsers yet.
+        supported_runtimes: supportedRuntimes,
+    };
+}
+async function detectWebGPU() {
+    if (typeof navigator === "undefined")
+        return false;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const gpu = navigator.gpu;
+        if (!gpu)
+            return false;
+        const adapter = await gpu.requestAdapter();
+        return adapter !== null;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

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

package/dist/runtime/core/model-runtime.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @octomil/browser — ModelRuntime interface
+ *
+ * Abstraction over inference runtimes. The default `InferenceEngine` uses
+ * ONNX Runtime Web, but callers may inject a custom runtime (e.g.
+ * TensorFlow.js, WebNN) via the OctomilClient constructor.
+ */
+import type { Backend, NamedTensors, PredictOutput } from "../../types.js";
+export interface ModelRuntime {
+    /** Create a runtime session from a model buffer. */
+    createSession(modelData: ArrayBuffer, backend?: Backend): Promise<void>;
+    /** Run inference on the given inputs. */
+    run(inputs: NamedTensors): Promise<PredictOutput>;
+    /** Release all resources held by the runtime. */
+    dispose(): void;
+    /** Whether this runtime is available in the current environment. */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=model-runtime.d.ts.map

package/dist/runtime/core/model-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-runtime.d.ts","sourceRoot":"","sources":["../../../src/runtime/core/model-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3E,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,yCAAyC;IACzC,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAClD,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAC;IAChB,oEAAoE;IACpE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/dist/runtime/core/model-runtime.js

@@ -0,0 +1,9 @@
+/**
+ * @octomil/browser — ModelRuntime interface
+ *
+ * Abstraction over inference runtimes. The default `InferenceEngine` uses
+ * ONNX Runtime Web, but callers may inject a custom runtime (e.g.
+ * TensorFlow.js, WebNN) via the OctomilClient constructor.
+ */
+export {};
+//# sourceMappingURL=model-runtime.js.map

package/dist/runtime/core/model-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-runtime.js","sourceRoot":"","sources":["../../../src/runtime/core/model-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/{inference.d.ts → runtime/engines/onnx-web/engine.d.ts}

@@ -5,8 +5,10 @@
  * buffer, auto-detect the best execution provider (WebGPU > WASM),
  * and run forward passes.
  */
-import type { Backend, NamedTensors, PredictOutput } from "./types.js";
-export declare class InferenceEngine {
+import type { Backend, NamedTensors, PredictOutput } from "../../../types.js";
+import type { ModelRuntime } from "../../core/model-runtime.js";
+export type { ModelRuntime } from "../../core/model-runtime.js";
+export declare class InferenceEngine implements ModelRuntime {
     private session;
     private ortModule;
     private resolvedBackend;
@@ -29,6 +31,8 @@ export declare class InferenceEngine {
     get activeBackend(): Backend | null;
     /** Release WASM / WebGPU resources. */
     dispose(): void;
+    /** Check if ONNX Runtime Web can be loaded in this environment. */
+    isAvailable(): Promise<boolean>;
     private loadOrt;
     private resolveProvider;
     private detectWebGPU;
@@ -40,4 +44,4 @@ export declare class InferenceEngine {
      */
     private extractConvenience;
 }
-//# sourceMappingURL=inference.d.ts.map
+//# sourceMappingURL=engine.d.ts.map

package/dist/runtime/engines/onnx-web/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/runtime/engines/onnx-web/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,mBAAmB,CAAC;AAE1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAahE,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,eAAe,CAAwB;IAM/C;;;;;OAKG;IACG,aAAa,CACjB,SAAS,EAAE,WAAW,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC;IA0ChB;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA4CvD,0CAA0C;IAC1C,IAAI,UAAU,IAAI,SAAS,MAAM,EAAE,CAGlC;IAED,2CAA2C;IAC3C,IAAI,WAAW,IAAI,SAAS,MAAM,EAAE,CAGnC;IAED,4DAA4D;IAC5D,IAAI,aAAa,IAAI,OAAO,GAAG,IAAI,CAElC;IAED,uCAAuC;IACvC,OAAO,IAAI,IAAI;IAQf,mEAAmE;IAC7D,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;YAavB,OAAO;YAiBP,eAAe;YAoBf,YAAY;IAc1B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAmC3B"}

package/dist/{inference.js → runtime/engines/onnx-web/engine.js}

@@ -5,7 +5,7 @@
  * buffer, auto-detect the best execution provider (WebGPU > WASM),
  * and run forward passes.
  */
-import { OctomilError } from "./types.js";
+import { OctomilError } from "../../../types.js";
 // ---------------------------------------------------------------------------
 // InferenceEngine
 // ---------------------------------------------------------------------------
@@ -105,6 +105,16 @@ export class InferenceEngine {
             this.session = null;
         }
     }
+    /** Check if ONNX Runtime Web can be loaded in this environment. */
+    async isAvailable() {
+        try {
+            await this.loadOrt();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
     // -----------------------------------------------------------------------
     // Internal
     // -----------------------------------------------------------------------
@@ -118,7 +128,7 @@ export class InferenceEngine {
             return this.ortModule;
         }
         catch (err) {
-            throw new OctomilError("BACKEND_UNAVAILABLE", 'Failed to import onnxruntime-web. Make sure the package is installed: npm i onnxruntime-web', err);
+            throw new OctomilError("RUNTIME_UNAVAILABLE", 'Failed to import onnxruntime-web. Make sure the package is installed: npm i onnxruntime-web', err);
         }
     }
     async resolveProvider(_ortMod, backend) {
@@ -129,7 +139,7 @@ export class InferenceEngine {
             if (hasWebGPU)
                 return "webgpu";
             if (backend === "webgpu") {
-                throw new OctomilError("BACKEND_UNAVAILABLE", "WebGPU was explicitly requested but is not available in this browser.");
+                throw new OctomilError("RUNTIME_UNAVAILABLE", "WebGPU was explicitly requested but is not available in this browser.");
             }
         }
         return "wasm";
@@ -151,7 +161,7 @@ export class InferenceEngine {
     }
     ensureSession() {
         if (!this.session) {
-            throw new OctomilError("SESSION_DISPOSED", "No active session. Call load() before running inference.");
+            throw new OctomilError("CANCELLED", "No active session. Call load() before running inference.");
         }
     }
     convertOutputs(results) {
@@ -175,10 +185,14 @@ export class InferenceEngine {
             return {};
         const first = tensors[names[0]];
         const data = first.data;
-        if (!(data instanceof Float32Array))
-            return {};
         if (data.length === 0)
             return {};
+        // Single-element output indicates a direct class/token ID.
+        if (data.length === 1) {
+            return { label: String(Number(data[0])), score: 1.0 };
+        }
+        if (!(data instanceof Float32Array))
+            return {};
         // Treat as class probabilities / logits.
         const scores = Array.from(data);
         let maxIdx = 0;
@@ -210,4 +224,4 @@ function inferOrtType(data) {
         return "uint8";
     return "float32";
 }
-//# sourceMappingURL=inference.js.map
+//# sourceMappingURL=engine.js.map

package/dist/runtime/engines/onnx-web/engine.js.map

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

package/dist/runtime/engines/registry/engine-plugin.d.ts

@@ -0,0 +1,11 @@
+import type { BenchmarkResult } from "../../../types.js";
+export interface EnginePlugin {
+    readonly name: string;
+    readonly displayName: string;
+    readonly priority: number;
+    detect(): Promise<boolean>;
+    detectInfo(): Promise<string>;
+    supportsModel(modelName: string): boolean;
+    benchmark(modelName: string, nTokens?: number): Promise<BenchmarkResult>;
+}
+//# sourceMappingURL=engine-plugin.d.ts.map

package/dist/runtime/engines/registry/engine-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-plugin.d.ts","sourceRoot":"","sources":["../../../../src/runtime/engines/registry/engine-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1E"}

package/dist/runtime/engines/registry/engine-plugin.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=engine-plugin.js.map

package/dist/runtime/engines/registry/engine-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-plugin.js","sourceRoot":"","sources":["../../../../src/runtime/engines/registry/engine-plugin.ts"],"names":[],"mappings":""}

package/dist/runtime/engines/registry/engine-registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @octomil/browser — Engine registry
+ *
+ * Minimal registry for discovering, benchmarking, and selecting inference
+ * engines. In the browser environment only ONNX Runtime (WebGPU / WASM) is
+ * available by default, but the registry allows third-party plugins to
+ * register additional backends.
+ *
+ * Matches the cross-platform SDK interface.
+ */
+import type { EnginePlugin } from "./engine-plugin.js";
+import type { DetectionResult, RankedEngine } from "../../../types.js";
+export declare class EngineRegistry {
+    private plugins;
+    /** Register an engine plugin. Replaces any existing plugin with the same name. */
+    register(plugin: EnginePlugin): void;
+    /** Remove a registered plugin by name. */
+    remove(name: string): boolean;
+    /** Get a registered plugin by name. */
+    get(name: string): EnginePlugin | undefined;
+    /** List all registered plugin names. */
+    get engines(): readonly string[];
+    /** Clear all registrations. */
+    reset(): void;
+    /** Detect which registered engines are available. */
+    detectAll(modelName?: string): Promise<DetectionResult[]>;
+    /** Benchmark available engines and return results sorted by throughput. */
+    benchmarkAll(modelName: string, nTokens?: number): Promise<RankedEngine[]>;
+    /** Pick the best engine from benchmark results (highest throughput, no error). */
+    selectBest(ranked: RankedEngine[]): RankedEngine | null;
+    /** Convenience: detect → benchmark → select in one call. */
+    autoSelect(modelName: string, nTokens?: number): Promise<RankedEngine | null>;
+    private sortedPlugins;
+}
+//# sourceMappingURL=engine-registry.d.ts.map

package/dist/runtime/engines/registry/engine-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-registry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/engines/registry/engine-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEvE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwC;IAEvD,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIpC,0CAA0C;IAC1C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,uCAAuC;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C,wCAAwC;IACxC,IAAI,OAAO,IAAI,SAAS,MAAM,EAAE,CAE/B;IAED,+BAA+B;IAC/B,KAAK,IAAI,IAAI;IAIb,qDAAqD;IAC/C,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAe/D,2EAA2E;IACrE,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB1B,kFAAkF;IAClF,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,GAAG,IAAI;IAIvD,4DAA4D;IACtD,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAK/B,OAAO,CAAC,aAAa;CAGtB"}

package/dist/runtime/engines/registry/engine-registry.js

@@ -0,0 +1,74 @@
+/**
+ * @octomil/browser — Engine registry
+ *
+ * Minimal registry for discovering, benchmarking, and selecting inference
+ * engines. In the browser environment only ONNX Runtime (WebGPU / WASM) is
+ * available by default, but the registry allows third-party plugins to
+ * register additional backends.
+ *
+ * Matches the cross-platform SDK interface.
+ */
+export class EngineRegistry {
+    plugins = new Map();
+    /** Register an engine plugin. Replaces any existing plugin with the same name. */
+    register(plugin) {
+        this.plugins.set(plugin.name, plugin);
+    }
+    /** Remove a registered plugin by name. */
+    remove(name) {
+        return this.plugins.delete(name);
+    }
+    /** Get a registered plugin by name. */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /** List all registered plugin names. */
+    get engines() {
+        return [...this.plugins.keys()];
+    }
+    /** Clear all registrations. */
+    reset() {
+        this.plugins.clear();
+    }
+    /** Detect which registered engines are available. */
+    async detectAll(modelName) {
+        const results = [];
+        for (const plugin of this.sortedPlugins()) {
+            const available = await plugin.detect();
+            const supportsModel = modelName ? plugin.supportsModel(modelName) : true;
+            const info = available ? await plugin.detectInfo() : "";
+            results.push({
+                engine: plugin.name,
+                available: available && supportsModel,
+                info,
+            });
+        }
+        return results;
+    }
+    /** Benchmark available engines and return results sorted by throughput. */
+    async benchmarkAll(modelName, nTokens) {
+        const detected = await this.detectAll(modelName);
+        const available = detected.filter((d) => d.available);
+        const ranked = [];
+        for (const det of available) {
+            const plugin = this.plugins.get(det.engine);
+            const result = await plugin.benchmark(modelName, nTokens);
+            ranked.push({ engine: det.engine, result });
+        }
+        ranked.sort((a, b) => b.result.tokens_per_second - a.result.tokens_per_second);
+        return ranked;
+    }
+    /** Pick the best engine from benchmark results (highest throughput, no error). */
+    selectBest(ranked) {
+        return ranked.find((r) => r.result.error == null) ?? null;
+    }
+    /** Convenience: detect → benchmark → select in one call. */
+    async autoSelect(modelName, nTokens) {
+        const ranked = await this.benchmarkAll(modelName, nTokens);
+        return this.selectBest(ranked);
+    }
+    sortedPlugins() {
+        return [...this.plugins.values()].sort((a, b) => a.priority - b.priority);
+    }
+}
+//# sourceMappingURL=engine-registry.js.map

package/dist/runtime/engines/registry/engine-registry.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export type { ModelRuntime } from "./core/model-runtime.js";
+export { EngineRegistry } from "./engines/registry/engine-registry.js";
+export type { EnginePlugin } from "./engines/registry/engine-plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,2 @@
+export { EngineRegistry } from "./engines/registry/engine-registry.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/secure-aggregation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"secure-aggregation.d.ts","sourceRoot":"","sources":["../src/secure-aggregation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA8B;IAE7C,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC;IAa3D,qDAAqD;IAC/C,kBAAkB,CAAC,gBAAgB,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB5E;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+B5E,iEAAiE;IACjE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS;IAgBzE,6DAA6D;IAC7D,MAAM,CACJ,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACtC,SAAS;CAeb;AA0BD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAqBf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA4B/D;AAMD,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM;IAK7B;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAI5D,iEAAiE;IACjE,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;CAQjD"}
+{"version":3,"file":"secure-aggregation.d.ts","sourceRoot":"","sources":["../src/secure-aggregation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA8B;IAE7C,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC;IAa3D,qDAAqD;IAC/C,kBAAkB,CAAC,gBAAgB,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAkB5E;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+B5E,iEAAiE;IACjE,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS;IAgBzE,6DAA6D;IAC7D,MAAM,CACJ,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACtC,SAAS;CAeb;AA0BD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,WAAW,EAAE,CAqBf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA4B/D;AAMD,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM;IAK7B;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAI5D,iEAAiE;IACjE,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM;CASjD"}

package/dist/secure-aggregation.js

@@ -5,6 +5,7 @@
  * secret sharing, all via the Web Crypto API. Ensures the server
  * only sees the aggregate of client updates, never individual deltas.
  */
+import { OctomilError } from "./types.js";
 // ---------------------------------------------------------------------------
 // SecureAggregation (basic pairwise masking)
 // ---------------------------------------------------------------------------
@@ -19,7 +20,7 @@ export class SecureAggregation {
     /** Derive a shared secret with a peer using ECDH. */
     async deriveSharedSecret(peerPublicKeyJwk) {
         if (!this.keyPair) {
-            throw new Error("Call generateKeyPair() first.");
+            throw new OctomilError("INVALID_INPUT", "Call generateKeyPair() first.");
         }
         const peerKey = await crypto.subtle.importKey("jwk", peerPublicKeyJwk, { name: "ECDH", namedCurve: "P-256" }, false, []);
         return crypto.subtle.deriveBits({ name: "ECDH", public: peerKey }, this.keyPair.privateKey, 256);
@@ -166,7 +167,7 @@ export class SecAggPlus extends SecureAggregation {
     /** Reconstruct a dropped peer's secret from collected shares. */
     reconstructSecret(shares) {
         if (shares.length < this.threshold) {
-            throw new Error(`Need at least ${this.threshold} shares, got ${shares.length}.`);
+            throw new OctomilError("INVALID_INPUT", `Need at least ${this.threshold} shares, got ${shares.length}.`);
         }
         return shamirReconstruct(shares.slice(0, this.threshold));
     }

package/dist/secure-aggregation.js.map

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

package/dist/server-api.d.ts

@@ -0,0 +1,17 @@
+export interface ServerClientOptions {
+    serverUrl?: string;
+    apiKey?: string;
+    orgId?: string;
+}
+export type QueryValue = string | number | boolean | null | undefined;
+export declare class ServerApiClient {
+    protected readonly serverUrl: string;
+    protected readonly apiKey: string | undefined;
+    protected readonly orgId: string | undefined;
+    constructor(options?: ServerClientOptions);
+    protected buildUrl(path: string, query?: Record<string, QueryValue>): string;
+    protected requestJson<T>(path: string, init?: RequestInit, query?: Record<string, QueryValue>): Promise<T>;
+    protected requestVoid(path: string, init?: RequestInit, query?: Record<string, QueryValue>): Promise<void>;
+    private request;
+}
+//# sourceMappingURL=server-api.d.ts.map