@octomil/browser 1.0.0

package/dist/privacy.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @octomil/browser — Privacy filters
+ *
+ * Differential privacy (gradient clipping + noise injection) and
+ * quantization for communication-efficient federated learning.
+ */
+import type { WeightMap } from "./types.js";
+/**
+ * Clip gradients by L2 norm. If the L2 norm of the flattened weight map
+ * exceeds `maxNorm`, scale all values down proportionally.
+ */
+export declare function clipGradients(delta: WeightMap, maxNorm: number): WeightMap;
+/**
+ * Add calibrated Gaussian noise for (epsilon, delta)-differential privacy.
+ *
+ * Noise std = sensitivity * sqrt(2 * ln(1.25/deltaDP)) / epsilon
+ *
+ * @param delta     Weight deltas to perturb.
+ * @param epsilon   Privacy budget.
+ * @param sensitivity  L2 sensitivity (typically the clipping norm).
+ * @param deltaDP   DP delta parameter.
+ */
+export declare function addGaussianNoise(delta: WeightMap, epsilon: number, sensitivity: number, deltaDP: number): WeightMap;
+export interface QuantizedWeightMap {
+    [key: string]: {
+        data: Int8Array | Int16Array;
+        scale: number;
+        zeroPoint: number;
+    };
+}
+/**
+ * Quantize weights to reduced precision (8 or 16 bit).
+ * Uses min-max symmetric quantization.
+ */
+export declare function quantize(delta: WeightMap, bits?: 8 | 16): QuantizedWeightMap;
+/**
+ * Dequantize back to Float32Array.
+ */
+export declare function dequantize(quantized: QuantizedWeightMap): WeightMap;
+//# sourceMappingURL=privacy.d.ts.map

package/dist/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../src/privacy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAM5C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAyB1E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,SAAS,CAaX;AAiBD,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,IAAI,GAAE,CAAC,GAAG,EAAM,GACf,kBAAkB,CAwBpB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAWnE"}

package/dist/privacy.js

@@ -0,0 +1,118 @@
+/**
+ * @octomil/browser — Privacy filters
+ *
+ * Differential privacy (gradient clipping + noise injection) and
+ * quantization for communication-efficient federated learning.
+ */
+// ---------------------------------------------------------------------------
+// Gradient Clipping
+// ---------------------------------------------------------------------------
+/**
+ * Clip gradients by L2 norm. If the L2 norm of the flattened weight map
+ * exceeds `maxNorm`, scale all values down proportionally.
+ */
+export function clipGradients(delta, maxNorm) {
+    let sumSq = 0;
+    for (const arr of Object.values(delta)) {
+        if (!arr)
+            continue;
+        for (let i = 0; i < arr.length; i++) {
+            sumSq += arr[i] * arr[i];
+        }
+    }
+    const norm = Math.sqrt(sumSq);
+    if (norm <= maxNorm) {
+        return delta; // No clipping needed
+    }
+    const scale = maxNorm / norm;
+    const clipped = {};
+    for (const [key, arr] of Object.entries(delta)) {
+        if (!arr)
+            continue;
+        const c = new Float32Array(arr.length);
+        for (let i = 0; i < arr.length; i++) {
+            c[i] = arr[i] * scale;
+        }
+        clipped[key] = c;
+    }
+    return clipped;
+}
+// ---------------------------------------------------------------------------
+// Gaussian Noise Injection
+// ---------------------------------------------------------------------------
+/**
+ * Add calibrated Gaussian noise for (epsilon, delta)-differential privacy.
+ *
+ * Noise std = sensitivity * sqrt(2 * ln(1.25/deltaDP)) / epsilon
+ *
+ * @param delta     Weight deltas to perturb.
+ * @param epsilon   Privacy budget.
+ * @param sensitivity  L2 sensitivity (typically the clipping norm).
+ * @param deltaDP   DP delta parameter.
+ */
+export function addGaussianNoise(delta, epsilon, sensitivity, deltaDP) {
+    const sigma = (sensitivity * Math.sqrt(2 * Math.log(1.25 / deltaDP))) / epsilon;
+    const noisy = {};
+    for (const [key, arr] of Object.entries(delta)) {
+        if (!arr)
+            continue;
+        const n = new Float32Array(arr.length);
+        for (let i = 0; i < arr.length; i++) {
+            n[i] = arr[i] + gaussianRandom() * sigma;
+        }
+        noisy[key] = n;
+    }
+    return noisy;
+}
+/** Box-Muller transform for generating Gaussian random numbers. */
+function gaussianRandom() {
+    let u1;
+    let u2;
+    do {
+        u1 = Math.random();
+        u2 = Math.random();
+    } while (u1 === 0);
+    return Math.sqrt(-2.0 * Math.log(u1)) * Math.cos(2.0 * Math.PI * u2);
+}
+/**
+ * Quantize weights to reduced precision (8 or 16 bit).
+ * Uses min-max symmetric quantization.
+ */
+export function quantize(delta, bits = 8) {
+    const maxVal = bits === 8 ? 127 : 32767;
+    const result = {};
+    for (const [key, arr] of Object.entries(delta)) {
+        if (!arr)
+            continue;
+        let absMax = 0;
+        for (let i = 0; i < arr.length; i++) {
+            const abs = Math.abs(arr[i]);
+            if (abs > absMax)
+                absMax = abs;
+        }
+        const scale = absMax > 0 ? absMax / maxVal : 1;
+        const quantized = bits === 8 ? new Int8Array(arr.length) : new Int16Array(arr.length);
+        for (let i = 0; i < arr.length; i++) {
+            quantized[i] = Math.round(arr[i] / scale);
+        }
+        result[key] = { data: quantized, scale, zeroPoint: 0 };
+    }
+    return result;
+}
+/**
+ * Dequantize back to Float32Array.
+ */
+export function dequantize(quantized) {
+    const result = {};
+    for (const [key, entry] of Object.entries(quantized)) {
+        if (!entry)
+            continue;
+        const arr = new Float32Array(entry.data.length);
+        for (let i = 0; i < entry.data.length; i++) {
+            arr[i] = (entry.data[i] - entry.zeroPoint) * entry.scale;
+        }
+        result[key] = arr;
+    }
+    return result;
+}
+//# sourceMappingURL=privacy.js.map

package/dist/privacy.js.map

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

package/dist/rollouts.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @octomil/browser — Rollout and canary management
+ *
+ * Resolves which model version a device should use based on server-side
+ * rollout configuration. Uses deterministic hashing for stable canary
+ * group assignment.
+ */
+import type { RolloutConfig, RolloutVersion, TelemetryEvent } from "./types.js";
+export declare class RolloutsManager {
+    private readonly serverUrl;
+    private readonly apiKey?;
+    private readonly cacheTtlMs;
+    private readonly onTelemetry?;
+    private configCache;
+    constructor(options: {
+        serverUrl: string;
+        apiKey?: string;
+        cacheTtlMs?: number;
+        onTelemetry?: (event: TelemetryEvent) => void;
+    });
+    /**
+     * Resolve which version a device should use.
+     *
+     * Logic:
+     *  1. If a canary version exists, check if device is in canary group.
+     *  2. Otherwise return the active version.
+     */
+    resolveVersion(modelId: string, deviceId: string): Promise<string>;
+    /** Fetch rollout configuration, with caching. */
+    getRolloutConfig(modelId: string): Promise<RolloutConfig>;
+    /**
+     * Deterministic check: is this device in the canary group?
+     * Uses a simple hash of (deviceId + modelId) to assign a 0-99 bucket.
+     */
+    isInCanaryGroup(modelId: string, deviceId: string, canaryPercentage: number): boolean;
+    /** Get all available versions for a model. */
+    getAvailableVersions(modelId: string): Promise<RolloutVersion[]>;
+    /** Report rollout success/failure to the server. */
+    reportRolloutStatus(modelId: string, version: string, status: "success" | "failure"): Promise<void>;
+    /** Clear the rollout config cache. */
+    clearCache(): void;
+}
+//# sourceMappingURL=rollouts.d.ts.map

package/dist/rollouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollouts.d.ts","sourceRoot":"","sources":["../src/rollouts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOhF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAkC;IAE/D,OAAO,CAAC,WAAW,CAGf;gBAEQ,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;KAC/C;IAOD;;;;;;OAMG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBxE,iDAAiD;IAC3C,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB/D;;;OAGG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB,OAAO;IAKV,8CAA8C;IACxC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAKtE,oDAAoD;IAC9C,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC;IAqBhB,sCAAsC;IACtC,UAAU,IAAI,IAAI;CAGnB"}

package/dist/rollouts.js

@@ -0,0 +1,114 @@
+/**
+ * @octomil/browser — Rollout and canary management
+ *
+ * Resolves which model version a device should use based on server-side
+ * rollout configuration. Uses deterministic hashing for stable canary
+ * group assignment.
+ */
+import { OctomilError } from "./types.js";
+// ---------------------------------------------------------------------------
+// RolloutsManager
+// ---------------------------------------------------------------------------
+export class RolloutsManager {
+    serverUrl;
+    apiKey;
+    cacheTtlMs;
+    onTelemetry;
+    configCache = new Map();
+    constructor(options) {
+        this.serverUrl = options.serverUrl;
+        this.apiKey = options.apiKey;
+        this.cacheTtlMs = options.cacheTtlMs ?? 5 * 60 * 1000; // 5 min
+        this.onTelemetry = options.onTelemetry;
+    }
+    /**
+     * Resolve which version a device should use.
+     *
+     * Logic:
+     *  1. If a canary version exists, check if device is in canary group.
+     *  2. Otherwise return the active version.
+     */
+    async resolveVersion(modelId, deviceId) {
+        const config = await this.getRolloutConfig(modelId);
+        // Check for canary version
+        const canary = config.versions.find((v) => v.status === "canary");
+        if (canary && this.isInCanaryGroup(modelId, deviceId, canary.percentage)) {
+            return canary.version;
+        }
+        // Fall back to active version
+        const active = config.versions.find((v) => v.status === "active");
+        if (active)
+            return active.version;
+        throw new OctomilError("MODEL_NOT_FOUND", `No active version found for model "${modelId}".`);
+    }
+    /** Fetch rollout configuration, with caching. */
+    async getRolloutConfig(modelId) {
+        const cached = this.configCache.get(modelId);
+        if (cached && Date.now() - cached.fetchedAt < this.cacheTtlMs) {
+            return cached.config;
+        }
+        const url = `${this.serverUrl}/api/v1/models/${encodeURIComponent(modelId)}/rollout`;
+        const headers = { Accept: "application/json" };
+        if (this.apiKey)
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        const response = await fetch(url, { headers });
+        if (!response.ok) {
+            throw new OctomilError("NETWORK_ERROR", `Failed to fetch rollout config: HTTP ${response.status}`);
+        }
+        const config = (await response.json());
+        this.configCache.set(modelId, { config, fetchedAt: Date.now() });
+        return config;
+    }
+    /**
+     * Deterministic check: is this device in the canary group?
+     * Uses a simple hash of (deviceId + modelId) to assign a 0-99 bucket.
+     */
+    isInCanaryGroup(modelId, deviceId, canaryPercentage) {
+        const bucket = deterministicBucket(deviceId + modelId);
+        return bucket < canaryPercentage;
+    }
+    /** Get all available versions for a model. */
+    async getAvailableVersions(modelId) {
+        const config = await this.getRolloutConfig(modelId);
+        return config.versions;
+    }
+    /** Report rollout success/failure to the server. */
+    async reportRolloutStatus(modelId, version, status) {
+        const url = `${this.serverUrl}/api/v1/models/${encodeURIComponent(modelId)}/rollout/status`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiKey)
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ version, status }),
+        });
+        this.onTelemetry?.({
+            type: "rollout_status",
+            model: modelId,
+            metadata: { version, status },
+            timestamp: Date.now(),
+        });
+    }
+    /** Clear the rollout config cache. */
+    clearCache() {
+        this.configCache.clear();
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Simple deterministic hash → bucket [0, 100).
+ * Uses djb2 hash for speed (no crypto needed for bucketing).
+ */
+function deterministicBucket(input) {
+    let hash = 5381;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) + hash + input.charCodeAt(i)) | 0;
+    }
+    return Math.abs(hash) % 100;
+}
+//# sourceMappingURL=rollouts.js.map

package/dist/rollouts.js.map

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

package/dist/secure-aggregation.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @octomil/browser — Secure aggregation (SecAgg / SecAgg+)
+ *
+ * Implements pairwise masking using ECDH key exchange and Shamir's
+ * secret sharing, all via the Web Crypto API. Ensures the server
+ * only sees the aggregate of client updates, never individual deltas.
+ */
+import type { WeightMap } from "./types.js";
+export declare class SecureAggregation {
+    private keyPair;
+    /** Generate an ECDH key pair for this round. */
+    generateKeyPair(): Promise<{
+        publicKey: JsonWebKey;
+    }>;
+    /** Derive a shared secret with a peer using ECDH. */
+    deriveSharedSecret(peerPublicKeyJwk: JsonWebKey): Promise<ArrayBuffer>;
+    /**
+     * Generate a deterministic PRG mask from a shared secret.
+     * Uses the secret as a seed to produce `length` float values.
+     */
+    createMask(secret: ArrayBuffer, length: number): Promise<Float32Array>;
+    /** Add masks to a weight update: masked = delta + sum(masks). */
+    maskUpdate(delta: WeightMap, masks: Map<string, Float32Array>): WeightMap;
+    /** Remove masks of dropped peers from the aggregated sum. */
+    unmask(maskedSum: WeightMap, droppedMasks: Map<string, Float32Array>): WeightMap;
+}
+export interface SecretShare {
+    x: number;
+    y: number;
+}
+/**
+ * Split a secret into `numShares` shares requiring `threshold` to reconstruct.
+ */
+export declare function shamirSplit(secret: number, threshold: number, numShares: number): SecretShare[];
+/**
+ * Reconstruct a secret from `threshold` shares via Lagrange interpolation.
+ */
+export declare function shamirReconstruct(shares: SecretShare[]): number;
+export declare class SecAggPlus extends SecureAggregation {
+    private readonly threshold;
+    constructor(threshold: number);
+    /**
+     * Split a shared secret into Shamir shares so that any `threshold`
+     * surviving peers can reconstruct the mask of a dropped peer.
+     */
+    splitSecret(secret: number, numPeers: number): SecretShare[];
+    /** Reconstruct a dropped peer's secret from collected shares. */
+    reconstructSecret(shares: SecretShare[]): number;
+}
+//# sourceMappingURL=secure-aggregation.d.ts.map

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

@@ -0,0 +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"}

package/dist/secure-aggregation.js

@@ -0,0 +1,174 @@
+/**
+ * @octomil/browser — Secure aggregation (SecAgg / SecAgg+)
+ *
+ * Implements pairwise masking using ECDH key exchange and Shamir's
+ * secret sharing, all via the Web Crypto API. Ensures the server
+ * only sees the aggregate of client updates, never individual deltas.
+ */
+// ---------------------------------------------------------------------------
+// SecureAggregation (basic pairwise masking)
+// ---------------------------------------------------------------------------
+export class SecureAggregation {
+    keyPair = null;
+    /** Generate an ECDH key pair for this round. */
+    async generateKeyPair() {
+        this.keyPair = await crypto.subtle.generateKey({ name: "ECDH", namedCurve: "P-256" }, true, ["deriveBits"]);
+        const publicKey = await crypto.subtle.exportKey("jwk", this.keyPair.publicKey);
+        return { publicKey };
+    }
+    /** Derive a shared secret with a peer using ECDH. */
+    async deriveSharedSecret(peerPublicKeyJwk) {
+        if (!this.keyPair) {
+            throw new Error("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);
+    }
+    /**
+     * Generate a deterministic PRG mask from a shared secret.
+     * Uses the secret as a seed to produce `length` float values.
+     */
+    async createMask(secret, length) {
+        // Expand seed via HKDF-SHA256, then interpret as float offsets
+        const keyMaterial = await crypto.subtle.importKey("raw", secret, "HKDF", false, ["deriveBits"]);
+        const bitsNeeded = length * 4 * 8; // Float32 = 4 bytes
+        const bits = await crypto.subtle.deriveBits({
+            name: "HKDF",
+            hash: "SHA-256",
+            salt: new Uint8Array(32),
+            info: new TextEncoder().encode("octomil-secagg-mask"),
+        }, keyMaterial, Math.min(bitsNeeded, 8160));
+        // If we need more bits than one deriveBits call can give,
+        // tile the output.
+        const mask = new Float32Array(length);
+        const source = new Float32Array(bits);
+        for (let i = 0; i < length; i++) {
+            mask[i] = source[i % source.length];
+        }
+        return mask;
+    }
+    /** Add masks to a weight update: masked = delta + sum(masks). */
+    maskUpdate(delta, masks) {
+        const masked = {};
+        for (const [key, arr] of Object.entries(delta)) {
+            if (!arr)
+                continue;
+            const result = new Float32Array(arr);
+            const mask = masks.get(key);
+            if (mask) {
+                for (let i = 0; i < result.length; i++) {
+                    result[i] = result[i] + (mask[i] ?? 0);
+                }
+            }
+            masked[key] = result;
+        }
+        return masked;
+    }
+    /** Remove masks of dropped peers from the aggregated sum. */
+    unmask(maskedSum, droppedMasks) {
+        const unmasked = {};
+        for (const [key, arr] of Object.entries(maskedSum)) {
+            if (!arr)
+                continue;
+            const result = new Float32Array(arr);
+            const mask = droppedMasks.get(key);
+            if (mask) {
+                for (let i = 0; i < result.length; i++) {
+                    result[i] = result[i] - (mask[i] ?? 0);
+                }
+            }
+            unmasked[key] = result;
+        }
+        return unmasked;
+    }
+}
+// ---------------------------------------------------------------------------
+// Shamir's Secret Sharing (for SecAgg+)
+// ---------------------------------------------------------------------------
+// Operates in GF(2^31 - 1) — a Mersenne prime field
+const PRIME = 2147483647;
+function modPow(base, exp, mod) {
+    let result = 1;
+    base = base % mod;
+    while (exp > 0) {
+        if (exp % 2 === 1) {
+            result = Number((BigInt(result) * BigInt(base)) % BigInt(mod));
+        }
+        exp = Math.floor(exp / 2);
+        base = Number((BigInt(base) * BigInt(base)) % BigInt(mod));
+    }
+    return result;
+}
+function modInverse(a, mod) {
+    return modPow(a, mod - 2, mod);
+}
+/**
+ * Split a secret into `numShares` shares requiring `threshold` to reconstruct.
+ */
+export function shamirSplit(secret, threshold, numShares) {
+    // Generate random coefficients for polynomial
+    const coeffs = [secret % PRIME];
+    for (let i = 1; i < threshold; i++) {
+        const randomBytes = new Uint32Array(1);
+        crypto.getRandomValues(randomBytes);
+        coeffs.push(randomBytes[0] % PRIME);
+    }
+    const shares = [];
+    for (let x = 1; x <= numShares; x++) {
+        let y = 0;
+        for (let i = 0; i < coeffs.length; i++) {
+            y = Number((BigInt(y) + BigInt(coeffs[i]) * BigInt(modPow(x, i, PRIME))) %
+                BigInt(PRIME));
+        }
+        shares.push({ x, y });
+    }
+    return shares;
+}
+/**
+ * Reconstruct a secret from `threshold` shares via Lagrange interpolation.
+ */
+export function shamirReconstruct(shares) {
+    let secret = 0;
+    const n = shares.length;
+    for (let i = 0; i < n; i++) {
+        let num = 1;
+        let den = 1;
+        for (let j = 0; j < n; j++) {
+            if (i === j)
+                continue;
+            num = Number((BigInt(num) * BigInt(PRIME - shares[j].x)) % BigInt(PRIME));
+            den = Number((BigInt(den) *
+                BigInt((shares[i].x - shares[j].x + PRIME) % PRIME)) %
+                BigInt(PRIME));
+        }
+        const lagrange = Number((BigInt(num) * BigInt(modInverse(den, PRIME))) % BigInt(PRIME));
+        secret = Number((BigInt(secret) + BigInt(shares[i].y) * BigInt(lagrange)) %
+            BigInt(PRIME));
+    }
+    return secret;
+}
+// ---------------------------------------------------------------------------
+// SecAggPlus
+// ---------------------------------------------------------------------------
+export class SecAggPlus extends SecureAggregation {
+    threshold;
+    constructor(threshold) {
+        super();
+        this.threshold = threshold;
+    }
+    /**
+     * Split a shared secret into Shamir shares so that any `threshold`
+     * surviving peers can reconstruct the mask of a dropped peer.
+     */
+    splitSecret(secret, numPeers) {
+        return shamirSplit(secret, this.threshold, numPeers);
+    }
+    /** 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}.`);
+        }
+        return shamirReconstruct(shares.slice(0, this.threshold));
+    }
+}
+//# sourceMappingURL=secure-aggregation.js.map

package/dist/secure-aggregation.js.map

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

package/dist/streaming.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @octomil/browser — Streaming inference engine
+ *
+ * Wraps server-sent events / streaming HTTP responses for incremental
+ * inference results (text generation, audio, video, image tiles).
+ */
+import type { StreamingOptions, StreamingChunk, StreamingResult, TelemetryEvent } from "./types.js";
+export declare class StreamingInferenceEngine {
+    private readonly serverUrl;
+    private readonly apiKey?;
+    private readonly onTelemetry?;
+    constructor(options: {
+        serverUrl: string;
+        apiKey?: string;
+        onTelemetry?: (event: TelemetryEvent) => void;
+    });
+    /**
+     * Stream inference results from the server.
+     *
+     * Returns an async iterable of chunks. Supports cancellation via AbortSignal.
+     */
+    stream(modelId: string, input: Record<string, unknown>, options?: StreamingOptions): AsyncGenerator<StreamingChunk, StreamingResult, undefined>;
+    private combineSignals;
+}
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAOpB,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAkC;gBAEnD,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;KAC/C;IAMD;;;;OAIG;IACI,MAAM,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,GAAE,gBAAqB,GAC7B,cAAc,CAAC,cAAc,EAAE,eAAe,EAAE,SAAS,CAAC;IAmI7D,OAAO,CAAC,cAAc;CAavB"}