@octomil/browser 1.0.0 → 1.2.0

package/dist/server-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-api.d.ts","sourceRoot":"","sources":["../src/server-api.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtE,qBAAa,eAAe;IAC1B,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEjC,OAAO,GAAE,mBAAwB;IAS7C,SAAS,CAAC,QAAQ,CAChB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACjC,MAAM;cAWO,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,EACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC;cAQG,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,EACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;YAIF,OAAO;CAqCtB"}

package/dist/server-api.js

@@ -0,0 +1,56 @@
+import { OctomilError } from "./types.js";
+export class ServerApiClient {
+    serverUrl;
+    apiKey;
+    orgId;
+    constructor(options = {}) {
+        this.serverUrl = (options.serverUrl ?? "https://api.octomil.com").replace(/\/+$/, "");
+        this.apiKey = options.apiKey;
+        this.orgId = options.orgId;
+    }
+    buildUrl(path, query) {
+        const url = new URL(path, `${this.serverUrl}/`);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value === undefined || value === null || value === "") {
+                continue;
+            }
+            url.searchParams.set(key, String(value));
+        }
+        return url.toString();
+    }
+    async requestJson(path, init = {}, query) {
+        const response = await this.request(path, init, query);
+        if (response.status === 204) {
+            return undefined;
+        }
+        return (await response.json());
+    }
+    async requestVoid(path, init = {}, query) {
+        await this.request(path, init, query);
+    }
+    async request(path, init = {}, query) {
+        const headers = new Headers(init.headers);
+        if (!headers.has("Content-Type") && init.body !== undefined) {
+            headers.set("Content-Type", "application/json");
+        }
+        if (this.apiKey && !headers.has("Authorization")) {
+            headers.set("Authorization", `Bearer ${this.apiKey}`);
+        }
+        let response;
+        try {
+            response = await fetch(this.buildUrl(path, query), {
+                ...init,
+                headers,
+            });
+        }
+        catch (error) {
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Request failed: ${String(error)}`, error);
+        }
+        if (!response.ok) {
+            const detail = await response.text().catch(() => "");
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Request failed: HTTP ${response.status}${detail ? ` ${detail}` : ""}`);
+        }
+        return response;
+    }
+}
+//# sourceMappingURL=server-api.js.map

package/dist/server-api.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,20 @@
+import { ServerApiClient, type ServerClientOptions } from "./server-api.js";
+export type BillingSession = Record<string, unknown>;
+export type BillingState = Record<string, unknown>;
+export type UsageLimits = Record<string, unknown>;
+export type Integration = Record<string, unknown>;
+export type IntegrationValidation = Record<string, unknown>;
+export type IntegrationPatch = Record<string, unknown>;
+export declare class SettingsClient extends ServerApiClient {
+    constructor(options?: ServerClientOptions);
+    createCheckoutSession(request: Record<string, unknown>, orgId?: string): Promise<BillingSession>;
+    createPortalSession(request: Record<string, unknown>, orgId?: string): Promise<BillingSession>;
+    updateBilling(request: Record<string, unknown>, orgId?: string): Promise<BillingState>;
+    getUsageLimits(orgId?: string): Promise<UsageLimits>;
+    updateUsageLimits(request: Record<string, unknown>, orgId?: string): Promise<UsageLimits>;
+    getIntegration(integrationId: string, orgId?: string): Promise<Integration>;
+    updateIntegration(integrationId: string, request: IntegrationPatch, orgId?: string): Promise<Integration>;
+    deleteIntegration(integrationId: string, orgId?: string): Promise<void>;
+    validateIntegration(integrationId: string, orgId?: string): Promise<IntegrationValidation>;
+}
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,qBAAa,cAAe,SAAQ,eAAe;gBACrC,OAAO,GAAE,mBAAwB;IAIvC,qBAAqB,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC;IAWpB,mBAAmB,CACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,CAAC;IAWpB,aAAa,CACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC;IAWlB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQpD,iBAAiB,CACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAWjB,cAAc,CAClB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAQjB,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,gBAAgB,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC;IAWjB,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAQV,mBAAmB,CACvB,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,qBAAqB,CAAC;CAOlC"}

package/dist/settings.js

@@ -0,0 +1,49 @@
+import { ServerApiClient } from "./server-api.js";
+export class SettingsClient extends ServerApiClient {
+    constructor(options = {}) {
+        super(options);
+    }
+    async createCheckoutSession(request, orgId) {
+        return this.requestJson("/api/v1/settings/billing/checkout", {
+            method: "POST",
+            body: JSON.stringify(request),
+        }, { org_id: orgId ?? this.orgId });
+    }
+    async createPortalSession(request, orgId) {
+        return this.requestJson("/api/v1/settings/billing/portal", {
+            method: "POST",
+            body: JSON.stringify(request),
+        }, { org_id: orgId ?? this.orgId });
+    }
+    async updateBilling(request, orgId) {
+        return this.requestJson("/api/v1/settings/billing", {
+            method: "PATCH",
+            body: JSON.stringify(request),
+        }, { org_id: orgId ?? this.orgId });
+    }
+    async getUsageLimits(orgId) {
+        return this.requestJson("/api/v1/settings/usage-limits", { method: "GET" }, { org_id: orgId ?? this.orgId });
+    }
+    async updateUsageLimits(request, orgId) {
+        return this.requestJson("/api/v1/settings/usage-limits", {
+            method: "PUT",
+            body: JSON.stringify(request),
+        }, { org_id: orgId ?? this.orgId });
+    }
+    async getIntegration(integrationId, orgId) {
+        return this.requestJson(`/api/v1/settings/integrations/${encodeURIComponent(integrationId)}`, { method: "GET" }, { org_id: orgId ?? this.orgId });
+    }
+    async updateIntegration(integrationId, request, orgId) {
+        return this.requestJson(`/api/v1/settings/integrations/${encodeURIComponent(integrationId)}`, {
+            method: "PATCH",
+            body: JSON.stringify(request),
+        }, { org_id: orgId ?? this.orgId });
+    }
+    async deleteIntegration(integrationId, orgId) {
+        await this.requestVoid(`/api/v1/settings/integrations/${encodeURIComponent(integrationId)}`, { method: "DELETE" }, { org_id: orgId ?? this.orgId });
+    }
+    async validateIntegration(integrationId, orgId) {
+        return this.requestJson(`/api/v1/settings/integrations/${encodeURIComponent(integrationId)}/validate`, { method: "POST", body: JSON.stringify({}) }, { org_id: orgId ?? this.orgId });
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/silent-auth-config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @octomil/browser — Auth configuration for silent device registration
+ *
+ * Separate from the existing AuthConfig in types.ts which covers
+ * OrgApiKeyAuth / DeviceTokenAuth for the OctomilClient constructor.
+ * This type is used by the top-level configure() flow.
+ */
+export type PublishableKeyEnvironment = "test" | "live";
+export type SilentAuthConfig = {
+    type: "publishable_key";
+    key: string;
+    orgId?: string;
+    appId?: string;
+} | {
+    type: "bootstrap_token";
+    token: string;
+    orgId?: string;
+    appId?: string;
+} | {
+    type: "anonymous";
+    appId: string;
+};
+/**
+ * Validates that a publishable key has an environment-scoped prefix.
+ * Throws if the key does not start with `oct_pub_test_` or `oct_pub_live_`.
+ */
+export declare function validatePublishableKey(key: string): void;
+/**
+ * Extracts the environment ("test" or "live") from an environment-scoped publishable key.
+ * Returns `null` if the key does not have a recognized prefix.
+ */
+export declare function getPublishableKeyEnvironment(key: string): PublishableKeyEnvironment | null;
+//# sourceMappingURL=silent-auth-config.d.ts.map

package/dist/silent-auth-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"silent-auth-config.d.ts","sourceRoot":"","sources":["../src/silent-auth-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIzC;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAMxD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,MAAM,GACV,yBAAyB,GAAG,IAAI,CAIlC"}

package/dist/silent-auth-config.js

@@ -0,0 +1,29 @@
+/**
+ * @octomil/browser — Auth configuration for silent device registration
+ *
+ * Separate from the existing AuthConfig in types.ts which covers
+ * OrgApiKeyAuth / DeviceTokenAuth for the OctomilClient constructor.
+ * This type is used by the top-level configure() flow.
+ */
+const VALID_PREFIXES = ["oct_pub_test_", "oct_pub_live_"];
+/**
+ * Validates that a publishable key has an environment-scoped prefix.
+ * Throws if the key does not start with `oct_pub_test_` or `oct_pub_live_`.
+ */
+export function validatePublishableKey(key) {
+    if (!VALID_PREFIXES.some((p) => key.startsWith(p))) {
+        throw new Error("Publishable key must start with 'oct_pub_test_' or 'oct_pub_live_'");
+    }
+}
+/**
+ * Extracts the environment ("test" or "live") from an environment-scoped publishable key.
+ * Returns `null` if the key does not have a recognized prefix.
+ */
+export function getPublishableKeyEnvironment(key) {
+    if (key.startsWith("oct_pub_test_"))
+        return "test";
+    if (key.startsWith("oct_pub_live_"))
+        return "live";
+    return null;
+}
+//# sourceMappingURL=silent-auth-config.js.map

package/dist/silent-auth-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"silent-auth-config.js","sourceRoot":"","sources":["../src/silent-auth-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,cAAc,GAAG,CAAC,eAAe,EAAE,eAAe,CAAU,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,GAAW;IAEX,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,MAAM,CAAC;IACnD,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/streaming.d.ts

@@ -4,15 +4,16 @@
  * 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";
+import type { StreamingOptions, StreamingChunk, StreamingResult } from "./types.js";
+import type { TelemetryReporter } from "./telemetry.js";
 export declare class StreamingInferenceEngine {
     private readonly serverUrl;
     private readonly apiKey?;
-    private readonly onTelemetry?;
+    private readonly telemetry?;
     constructor(options: {
         serverUrl: string;
         apiKey?: string;
-        onTelemetry?: (event: TelemetryEvent) => void;
+        telemetry?: TelemetryReporter;
     });
     /**
      * Stream inference results from the server.

package/dist/streaming.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAMxD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAoB;gBAEnC,OAAO,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,iBAAiB,CAAC;KAC/B;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;IA8H7D,OAAO,CAAC,cAAc;CAavB"}

package/dist/streaming.js

@@ -11,11 +11,11 @@ import { OctomilError } from "./types.js";
 export class StreamingInferenceEngine {
     serverUrl;
     apiKey;
-    onTelemetry;
+    telemetry;
     constructor(options) {
         this.serverUrl = options.serverUrl;
         this.apiKey = options.apiKey;
-        this.onTelemetry = options.onTelemetry;
+        this.telemetry = options.telemetry;
     }
     /**
      * Stream inference results from the server.
@@ -39,11 +39,8 @@ export class StreamingInferenceEngine {
         let ttfc = null;
         let chunkCount = 0;
         let totalBytes = 0;
-        this.onTelemetry?.({
-            type: "streaming_start",
-            model: modelId,
-            metadata: { modality: options.modality ?? "text" },
-            timestamp: Date.now(),
+        this.telemetry?.reportInferenceStarted(modelId, {
+            modality: options.modality ?? "text",
         });
         let response;
         try {
@@ -59,13 +56,8 @@ export class StreamingInferenceEngine {
             });
         }
         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);
+            this.telemetry?.reportInferenceFailed(modelId, "network_error", String(err));
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Streaming request failed: ${String(err)}`, err);
         }
         if (!response.ok) {
             throw new OctomilError("INFERENCE_FAILED", `Streaming inference failed: HTTP ${response.status}`);
@@ -101,14 +93,14 @@ export class StreamingInferenceEngine {
                     totalBytes += data.length;
                     if (ttfc === null) {
                         ttfc = performance.now() - startTime;
-                        this.onTelemetry?.({
-                            type: "streaming_chunk",
-                            model: modelId,
+                        this.telemetry?.reportInferenceChunk(modelId, {
+                            chunkIndex: 0,
+                            ttfc: true,
                             durationMs: ttfc,
-                            metadata: { chunkIndex: 0, ttfc: true },
-                            timestamp: Date.now(),
                         });
                     }
+                    // Emit per-chunk telemetry for every chunk.
+                    this.telemetry?.reportChunkProduced(modelId, chunkCount - 1);
                     yield parsed;
                 }
             }
@@ -117,12 +109,10 @@ export class StreamingInferenceEngine {
             reader.releaseLock();
         }
         const totalMs = performance.now() - startTime;
-        this.onTelemetry?.({
-            type: "streaming_complete",
-            model: modelId,
-            durationMs: totalMs,
-            metadata: { chunkCount, totalBytes, ttfcMs: ttfc },
-            timestamp: Date.now(),
+        this.telemetry?.reportInferenceCompleted(modelId, totalMs, {
+            chunkCount,
+            totalBytes,
+            ttfcMs: ttfc ?? totalMs,
         });
         return {
             totalChunks: chunkCount,

package/dist/streaming.js.map

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

package/dist/sync-manager.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @octomil/browser — SyncManager
+ *
+ * Reconciles local model state against the server-authoritative desired state.
+ * Fetches desired state, compares against locally cached models, downloads
+ * missing or outdated artifacts, activates per activation_policy, and reports
+ * observed state back to the server.
+ *
+ * Opt-in: consumers create and start the SyncManager explicitly.
+ */
+import type { ControlClient } from "./control.js";
+import type { ModelCache } from "./cache.js";
+export type { DesiredModelEntry } from "./control.js";
+/** Persisted metadata for a locally cached model artifact. */
+export interface LocalModelMeta {
+    modelId: string;
+    modelVersion: string;
+    bindingKey?: string;
+    useCase?: string;
+    deploymentId?: string;
+    deploymentKey?: string;
+    modelName?: string;
+    modelRef?: string;
+    artifactUrl: string;
+    sha256?: string;
+    installedAt: string;
+    status: "staged" | "active";
+    sizeBytes?: number;
+}
+/** Events emitted during sync. */
+export type SyncEvent = {
+    type: "sync_start";
+} | {
+    type: "sync_complete";
+    downloaded: number;
+    activated: number;
+    errors: number;
+} | {
+    type: "download_start";
+    modelId: string;
+} | {
+    type: "download_complete";
+    modelId: string;
+    sizeBytes: number;
+} | {
+    type: "download_error";
+    modelId: string;
+    error: string;
+} | {
+    type: "activate";
+    modelId: string;
+    version: string;
+} | {
+    type: "error";
+    error: string;
+};
+export type SyncEventListener = (event: SyncEvent) => void;
+export interface SyncManagerOptions {
+    control: ControlClient;
+    cache: ModelCache;
+    /** Sync interval in ms. Default: 300_000 (5 min). Set to 0 to disable periodic sync. */
+    intervalMs?: number;
+    /** Event listener for sync lifecycle events. */
+    onEvent?: SyncEventListener;
+}
+export declare class SyncManager {
+    private readonly control;
+    private readonly cache;
+    private readonly intervalMs;
+    private readonly onEvent;
+    private readonly meta;
+    private timer;
+    private syncing;
+    constructor(options: SyncManagerOptions);
+    /**
+     * Start periodic sync. Runs an initial sync immediately, then at the
+     * configured interval.
+     */
+    start(): void;
+    /** Stop periodic sync. */
+    stop(): void;
+    /** Whether the sync loop is currently running. */
+    get isRunning(): boolean;
+    /**
+     * Run a single reconcile cycle. Can be called manually for on-demand sync
+     * (e.g. on page load or visibility change).
+     */
+    sync(): Promise<void>;
+    /** Get metadata for all locally tracked models. */
+    getLocalModels(): Promise<LocalModelMeta[]>;
+    /** Get metadata for a specific model. */
+    getModelMeta(modelId: string): Promise<LocalModelMeta | null>;
+    /** Manually activate a staged model. */
+    activate(modelId: string): Promise<void>;
+    private parseDesiredEntries;
+    private reconcileEntry;
+    private shouldActivate;
+    private downloadArtifact;
+    private garbageCollect;
+    private reportState;
+    private emit;
+}
+//# sourceMappingURL=sync-manager.d.ts.map

package/dist/sync-manager.d.ts.map

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