@octomil/browser 1.0.0

package/dist/streaming.js

@@ -0,0 +1,148 @@
+/**
+ * @octomil/browser — Streaming inference engine
+ *
+ * Wraps server-sent events / streaming HTTP responses for incremental
+ * inference results (text generation, audio, video, image tiles).
+ */
+import { OctomilError } from "./types.js";
+// ---------------------------------------------------------------------------
+// StreamingInferenceEngine
+// ---------------------------------------------------------------------------
+export class StreamingInferenceEngine {
+    serverUrl;
+    apiKey;
+    onTelemetry;
+    constructor(options) {
+        this.serverUrl = options.serverUrl;
+        this.apiKey = options.apiKey;
+        this.onTelemetry = options.onTelemetry;
+    }
+    /**
+     * Stream inference results from the server.
+     *
+     * Returns an async iterable of chunks. Supports cancellation via AbortSignal.
+     */
+    async *stream(modelId, input, options = {}) {
+        const abortController = new AbortController();
+        const signal = options.signal
+            ? this.combineSignals(options.signal, abortController.signal)
+            : abortController.signal;
+        const url = `${this.serverUrl}/api/v1/models/${encodeURIComponent(modelId)}/stream`;
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "text/event-stream",
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        const startTime = performance.now();
+        let ttfc = null;
+        let chunkCount = 0;
+        let totalBytes = 0;
+        this.onTelemetry?.({
+            type: "streaming_start",
+            model: modelId,
+            metadata: { modality: options.modality ?? "text" },
+            timestamp: Date.now(),
+        });
+        let response;
+        try {
+            response = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({
+                    input,
+                    modality: options.modality ?? "text",
+                    ...options.params,
+                }),
+                signal,
+            });
+        }
+        catch (err) {
+            this.onTelemetry?.({
+                type: "streaming_error",
+                model: modelId,
+                metadata: { error: String(err) },
+                timestamp: Date.now(),
+            });
+            throw new OctomilError("NETWORK_ERROR", `Streaming request failed: ${String(err)}`, err);
+        }
+        if (!response.ok) {
+            throw new OctomilError("INFERENCE_FAILED", `Streaming inference failed: HTTP ${response.status}`);
+        }
+        if (!response.body) {
+            throw new OctomilError("INFERENCE_FAILED", "Server did not return a streaming body.");
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (!line.startsWith("data: "))
+                        continue;
+                    const data = line.slice(6).trim();
+                    if (data === "[DONE]")
+                        break;
+                    let parsed;
+                    try {
+                        parsed = JSON.parse(data);
+                    }
+                    catch {
+                        continue;
+                    }
+                    chunkCount++;
+                    totalBytes += data.length;
+                    if (ttfc === null) {
+                        ttfc = performance.now() - startTime;
+                        this.onTelemetry?.({
+                            type: "streaming_chunk",
+                            model: modelId,
+                            durationMs: ttfc,
+                            metadata: { chunkIndex: 0, ttfc: true },
+                            timestamp: Date.now(),
+                        });
+                    }
+                    yield parsed;
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        const totalMs = performance.now() - startTime;
+        this.onTelemetry?.({
+            type: "streaming_complete",
+            model: modelId,
+            durationMs: totalMs,
+            metadata: { chunkCount, totalBytes, ttfcMs: ttfc },
+            timestamp: Date.now(),
+        });
+        return {
+            totalChunks: chunkCount,
+            totalBytes,
+            durationMs: totalMs,
+            ttfcMs: ttfc ?? totalMs,
+        };
+    }
+    combineSignals(...signals) {
+        const controller = new AbortController();
+        for (const signal of signals) {
+            if (signal.aborted) {
+                controller.abort(signal.reason);
+                return controller.signal;
+            }
+            signal.addEventListener("abort", () => controller.abort(signal.reason), {
+                once: true,
+            });
+        }
+        return controller.signal;
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @octomil/browser — Telemetry reporter
+ *
+ * Opt-in, batched, non-blocking telemetry.  Events are queued in memory
+ * and flushed periodically using `navigator.sendBeacon` (preferred) or
+ * `fetch` with `keepalive: true`.
+ */
+import type { TelemetryEvent } from "./types.js";
+export interface TelemetryReporterOptions {
+    /** Endpoint to POST batched events to. */
+    url?: string;
+    /** Flush interval in milliseconds. */
+    flushIntervalMs?: number;
+    /** Maximum events per batch. */
+    maxBatchSize?: number;
+    /** API key included in the `Authorization` header. */
+    apiKey?: string;
+}
+export declare class TelemetryReporter {
+    private readonly url;
+    private readonly flushIntervalMs;
+    private readonly maxBatchSize;
+    private readonly apiKey;
+    private queue;
+    private timerId;
+    private disposed;
+    constructor(options?: TelemetryReporterOptions);
+    /** Enqueue a telemetry event. Non-blocking, never throws. */
+    track(event: TelemetryEvent): void;
+    /** Flush all queued events immediately. */
+    flush(): Promise<void>;
+    /** Stop the flush timer and send remaining events. */
+    dispose(): void;
+    private startAutoFlush;
+    private send;
+    private sendBeacon;
+}
+export declare function initTelemetry(options?: TelemetryReporterOptions): TelemetryReporter;
+export declare function getTelemetry(): TelemetryReporter | null;
+export declare function disposeTelemetry(): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAcjD,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,wBAA6B;IAclD,6DAA6D;IAC7D,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IASlC,2CAA2C;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,sDAAsD;IACtD,OAAO,IAAI,IAAI;IAmBf,OAAO,CAAC,cAAc;YAOR,IAAI;IA0BlB,OAAO,CAAC,UAAU;CAcnB;AAQD,wBAAgB,aAAa,CAC3B,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAMnB;AAED,wBAAgB,YAAY,IAAI,iBAAiB,GAAG,IAAI,CAEvD;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/telemetry.js

@@ -0,0 +1,130 @@
+/**
+ * @octomil/browser — Telemetry reporter
+ *
+ * Opt-in, batched, non-blocking telemetry.  Events are queued in memory
+ * and flushed periodically using `navigator.sendBeacon` (preferred) or
+ * `fetch` with `keepalive: true`.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_FLUSH_INTERVAL_MS = 30_000; // 30 seconds
+const DEFAULT_MAX_BATCH_SIZE = 50;
+const DEFAULT_TELEMETRY_URL = "https://api.octomil.io/v1/telemetry";
+export class TelemetryReporter {
+    url;
+    flushIntervalMs;
+    maxBatchSize;
+    apiKey;
+    queue = [];
+    timerId = null;
+    disposed = false;
+    constructor(options = {}) {
+        this.url = options.url ?? DEFAULT_TELEMETRY_URL;
+        this.flushIntervalMs =
+            options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this.maxBatchSize = options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+        this.apiKey = options.apiKey;
+        this.startAutoFlush();
+    }
+    // -----------------------------------------------------------------------
+    // Public
+    // -----------------------------------------------------------------------
+    /** Enqueue a telemetry event. Non-blocking, never throws. */
+    track(event) {
+        if (this.disposed)
+            return;
+        this.queue.push(event);
+        if (this.queue.length >= this.maxBatchSize) {
+            void this.flush();
+        }
+    }
+    /** Flush all queued events immediately. */
+    async flush() {
+        if (this.queue.length === 0)
+            return;
+        const batch = this.queue.splice(0, this.maxBatchSize);
+        await this.send(batch);
+    }
+    /** Stop the flush timer and send remaining events. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.timerId !== null) {
+            clearInterval(this.timerId);
+            this.timerId = null;
+        }
+        // Best-effort final flush via beacon.
+        if (this.queue.length > 0) {
+            this.sendBeacon(this.queue.splice(0));
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    startAutoFlush() {
+        if (typeof setInterval === "undefined")
+            return;
+        this.timerId = setInterval(() => {
+            void this.flush();
+        }, this.flushIntervalMs);
+    }
+    async send(events) {
+        const body = JSON.stringify({ events });
+        try {
+            // Try sendBeacon first — it survives page unload.
+            if (this.sendBeacon(events))
+                return;
+            // Fallback to fetch with keepalive.
+            const headers = {
+                "Content-Type": "application/json",
+            };
+            if (this.apiKey) {
+                headers["Authorization"] = `Bearer ${this.apiKey}`;
+            }
+            await fetch(this.url, {
+                method: "POST",
+                headers,
+                body,
+                keepalive: true,
+            });
+        }
+        catch {
+            // Telemetry is best-effort. Swallow all errors.
+        }
+    }
+    sendBeacon(events) {
+        if (typeof navigator === "undefined" || !navigator.sendBeacon) {
+            return false;
+        }
+        try {
+            const blob = new Blob([JSON.stringify({ events })], {
+                type: "application/json",
+            });
+            return navigator.sendBeacon(this.url, blob);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton helpers
+// ---------------------------------------------------------------------------
+let _reporter = null;
+export function initTelemetry(options = {}) {
+    if (_reporter) {
+        _reporter.dispose();
+    }
+    _reporter = new TelemetryReporter(options);
+    return _reporter;
+}
+export function getTelemetry() {
+    return _reporter;
+}
+export function disposeTelemetry() {
+    _reporter?.dispose();
+    _reporter = null;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * @octomil/browser — TypeScript type definitions
+ *
+ * All public interfaces and types for the browser inference SDK.
+ */
+/** Inference backend. `"webgpu"` is preferred; `"wasm"` is the universal fallback. */
+export type Backend = "webgpu" | "wasm";
+/** Model caching strategy. */
+export type CacheStrategy = "cache-api" | "indexeddb" | "none";
+/** Options for initialising an {@link Octomil} instance. */
+export interface OctomilOptions {
+    /**
+     * Model identifier — either a full URL to an `.onnx` file or
+     * a name resolvable via the Octomil model registry.
+     */
+    model: string;
+    /** Octomil server URL (used to resolve registry model names). */
+    serverUrl?: string;
+    /** Octomil API key for authenticated model downloads. */
+    apiKey?: string;
+    /**
+     * Inference backend.
+     * - `"webgpu"` — uses WebGPU when available (fastest).
+     * - `"wasm"`   — WASM SIMD fallback (universal).
+     * - `undefined` — auto-detect (try WebGPU first, then WASM).
+     */
+    backend?: Backend;
+    /**
+     * Whether to report anonymous telemetry (latency, cache hits) to the
+     * Octomil dashboard. Opt-in only.
+     * @default false
+     */
+    telemetry?: boolean;
+    /** Telemetry endpoint override. Only used when `telemetry` is `true`. */
+    telemetryUrl?: string;
+    /**
+     * Model caching strategy.
+     * @default "cache-api"
+     */
+    cacheStrategy?: CacheStrategy;
+    /** Called during model download with progress information. */
+    onProgress?: (progress: DownloadProgress) => void;
+}
+/** Progress information emitted during model download. */
+export interface DownloadProgress {
+    /** Bytes received so far. */
+    loaded: number;
+    /** Total bytes (may be 0 if the server omits Content-Length). */
+    total: number;
+    /** Percentage 0–100 (NaN when total is unknown). */
+    percent: number;
+}
+/**
+ * Named tensor map. Keys are input tensor names, values are the data.
+ * When a model has a single input you can pass the data directly.
+ */
+export type TensorData = Float32Array | Int32Array | BigInt64Array | Uint8Array;
+export interface NamedTensors {
+    [name: string]: {
+        data: TensorData;
+        dims: number[];
+    };
+}
+/**
+ * Predict input — either a named tensor map for explicit control,
+ * or a convenience payload that the model adapter will pre-process.
+ */
+export type PredictInput = NamedTensors | {
+    text: string;
+} | {
+    image: ImageData | HTMLCanvasElement | HTMLImageElement;
+} | {
+    raw: TensorData;
+    dims: number[];
+};
+/** Result of a single inference call. */
+export interface PredictOutput {
+    /** Raw output tensors keyed by name. */
+    tensors: NamedTensors;
+    /** Top-level convenience fields (model-dependent). */
+    label?: string;
+    score?: number;
+    scores?: number[];
+    /** Inference wall-clock time in milliseconds. */
+    latencyMs: number;
+}
+/** Role for a chat message. */
+export type ChatRole = "system" | "user" | "assistant";
+/** A single message in a chat conversation. */
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+}
+/** Response from the chat API. */
+export interface ChatResponse {
+    message: ChatMessage;
+    /** Token-generation latency in milliseconds. */
+    latencyMs: number;
+    /** Usage stats when available. */
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/** Information about the cached model. */
+export interface CacheInfo {
+    /** Whether the model is currently cached. */
+    cached: boolean;
+    /** Size in bytes (0 if not cached). */
+    sizeBytes: number;
+    /** ISO-8601 timestamp of when the model was cached. */
+    cachedAt?: string;
+}
+/** A single telemetry event queued for delivery. */
+export interface TelemetryEvent {
+    type: "model_load" | "inference" | "cache_hit" | "cache_miss" | "error" | "streaming_start" | "streaming_chunk" | "streaming_complete" | "streaming_error" | "training_complete" | "rollout_status" | "experiment_metric";
+    model: string;
+    durationMs?: number;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+}
+/** Metadata returned by the Octomil model registry. */
+export interface ModelMetadata {
+    name: string;
+    version: string;
+    format: "onnx";
+    sizeBytes: number;
+    url: string;
+    checksum?: string;
+}
+export interface DeviceAuthConfig {
+    serverUrl: string;
+    apiKey: string;
+}
+export interface DeviceAuthToken {
+    accessToken: string;
+    refreshToken: string;
+    /** Epoch ms when the access token expires. */
+    expiresAt: number;
+}
+export interface DeviceInfo {
+    userAgent: string;
+    language: string;
+    screenWidth: number;
+    screenHeight: number;
+    timezone: string;
+    webgpu: boolean;
+}
+export type StreamingModality = "text" | "image" | "audio" | "video";
+export interface StreamingOptions {
+    modality?: StreamingModality;
+    signal?: AbortSignal;
+    params?: Record<string, unknown>;
+}
+export interface StreamingChunk {
+    index: number;
+    data: unknown;
+    modality: StreamingModality;
+    done: boolean;
+}
+export interface StreamingResult {
+    totalChunks: number;
+    totalBytes: number;
+    durationMs: number;
+    ttfcMs: number;
+}
+export interface ChatOptions {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    stream?: boolean;
+    signal?: AbortSignal;
+}
+export interface ChatChunk {
+    index: number;
+    content: string;
+    done: boolean;
+    role?: ChatRole;
+}
+export type WeightMap = Record<string, Float32Array>;
+export interface TrainingConfig {
+    modelId?: string;
+    epochs: number;
+    batchSize: number;
+    learningRate: number;
+    /** User-provided training step — browser ONNX doesn't support training natively. */
+    onTrainStep: (weights: WeightMap, params: {
+        epoch: number;
+        batchSize: number;
+        learningRate: number;
+    }) => Promise<TrainStepResult>;
+}
+export interface TrainStepResult {
+    weights: WeightMap;
+    loss?: number;
+}
+export interface FederatedRound {
+    id: string;
+    federationId: string;
+    roundNumber: number;
+    status: "pending" | "selecting" | "in_progress" | "aggregating" | "complete";
+    modelVersion: string;
+    config: Record<string, unknown>;
+}
+export type RolloutStatus = "pending" | "canary" | "active" | "rolled_back";
+export interface RolloutVersion {
+    version: string;
+    status: RolloutStatus;
+    percentage: number;
+    createdAt: string;
+}
+export interface RolloutConfig {
+    modelId: string;
+    versions: RolloutVersion[];
+}
+export interface ExperimentVariant {
+    id: string;
+    name: string;
+    modelId: string;
+    modelVersion: string;
+    trafficPercentage: number;
+}
+export interface Experiment {
+    id: string;
+    name: string;
+    status: "draft" | "active" | "paused" | "completed";
+    variants: ExperimentVariant[];
+    createdAt: string;
+}
+/** Error codes emitted by the SDK. */
+export type OctomilErrorCode = "MODEL_NOT_FOUND" | "MODEL_LOAD_FAILED" | "INFERENCE_FAILED" | "BACKEND_UNAVAILABLE" | "CACHE_ERROR" | "NETWORK_ERROR" | "INVALID_INPUT" | "NOT_LOADED" | "SESSION_DISPOSED";
+/** Structured error thrown by the SDK. */
+export declare class OctomilError extends Error {
+    readonly code: OctomilErrorCode;
+    readonly cause?: unknown;
+    constructor(code: OctomilErrorCode, message: string, cause?: unknown);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,sFAAsF;AACtF,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExC,8BAA8B;AAC9B,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/D,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAMD,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC3B,CAAC,IAAI,EAAE,MAAM,GAAG;QACd,IAAI,EAAE,UAAU,CAAC;QACjB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,KAAK,EAAE,SAAS,GAAG,iBAAiB,GAAG,gBAAgB,CAAA;CAAE,GAC3D;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAExC,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,OAAO,EAAE,YAAY,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,+BAA+B;AAC/B,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvD,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAMD,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,YAAY,GACZ,WAAW,GACX,WAAW,GACX,YAAY,GACZ,OAAO,GACP,iBAAiB,GACjB,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAUD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAMD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAMD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,WAAW,EAAE,CACX,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAC/D,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAMD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAMD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACpD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,aAAa,GACb,eAAe,GACf,eAAe,GACf,YAAY,GACZ,kBAAkB,CAAC;AAEvB,0CAA0C;AAC1C,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAMrE"}

package/dist/types.js

@@ -0,0 +1,17 @@
+/**
+ * @octomil/browser — TypeScript type definitions
+ *
+ * All public interfaces and types for the browser inference SDK.
+ */
+/** Structured error thrown by the SDK. */
+export class OctomilError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.name = "OctomilError";
+        this.code = code;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0VH,0CAA0C;AAC1C,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAmB;IACvB,KAAK,CAAW;IAEzB,YAAY,IAAsB,EAAE,OAAe,EAAE,KAAe;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@octomil/browser",
+  "version": "1.0.0",
+  "description": "In-browser ML inference via ONNX Runtime Web + WebGPU",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "browser": "dist/octomil.min.js",
+  "unpkg": "dist/octomil.min.js",
+  "jsdelivr": "dist/octomil.min.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && node build.mjs",
+    "build:types": "tsc",
+    "build:bundle": "node build.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build && pnpm test"
+  },
+  "dependencies": {
+    "onnxruntime-web": "^1.17.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.24.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "eslint": "^9.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0"
+  },
+  "keywords": [
+    "octomil",
+    "onnx",
+    "webgpu",
+    "wasm",
+    "machine-learning",
+    "inference",
+    "browser",
+    "federated-learning"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/octomil/octomil-browser"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}