@octomil/browser 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -3,35 +3,86 @@
  *
  * @example
  * ```ts
- * import { Octomil } from '@octomil/browser';
+ * import { OctomilClient } from '@octomil/browser';
  *
- * const ml = new Octomil({
- *   model: 'https://models.octomil.io/sentiment-v1.onnx',
+ * const ml = new OctomilClient({
+ *   model: 'https://models.octomil.com/sentiment-v1.onnx',
  *   backend: 'webgpu',
  * });
  *
  * await ml.load();
  * const result = await ml.predict({ text: 'This is amazing!' });
  * console.log(result.label, result.score);
- * ml.dispose();
+ * ml.close();
  * ```
  *
  * @packageDocumentation
  */
-export { Octomil } from "./octomil.js";
-export { InferenceEngine } from "./inference.js";
-export { ModelLoader } from "./model-loader.js";
+export { OctomilClient } from "./octomil.js";
+export { OctomilAudio } from "./audio/octomil-audio.js";
+export { AudioTranscriptions } from "./audio/audio-transcriptions.js";
+export type { TranscriptionRequest } from "./audio/audio-transcriptions.js";
+export type { TranscriptionResult, TranscriptionSegment, } from "./audio/transcription-types.js";
+export { ChatClient, messagesToResponseInput } from "./chat.js";
+export type { ChatClientOptions, ChatThread, ChatTurnRequest, } from "./chat.js";
+export { InferenceEngine } from "./runtime/engines/onnx-web/engine.js";
+export type { ModelRuntime } from "./runtime/index.js";
+export { ModelManager } from "./model-manager.js";
 export { createModelCache, type ModelCache } from "./cache.js";
-export { TelemetryReporter, initTelemetry, getTelemetry, disposeTelemetry, } from "./telemetry.js";
-export { DeviceAuthManager } from "./device-auth.js";
-export { computeHash, verifyModelIntegrity, assertModelIntegrity } from "./integrity.js";
+export { TelemetryReporter, initTelemetry, getTelemetry, closeTelemetry, } from "./telemetry.js";
+export type { TelemetryReporterOptions, TelemetryResource, TelemetryEnvelope, OtlpKeyValue, OtlpResource, OtlpInstrumentationScope, OtlpLogRecord, OtlpScopeLogs, OtlpResourceLogs, ExportLogsServiceRequest, } from "./telemetry.js";
+export { MonitoringClient } from "./monitoring.js";
+export type { AlertRule, UpdateAlertRuleRequest } from "./monitoring.js";
+export { SettingsClient } from "./settings.js";
+export type { BillingSession, BillingState, UsageLimits, Integration, IntegrationValidation, IntegrationPatch, } from "./settings.js";
+export { TrainingClient } from "./training.js";
+export type { TrainingJob, TrainingJobStatus } from "./training.js";
+export { CapabilitiesClient } from "./capabilities.js";
+export type { CapabilityProfile } from "./capabilities.js";
+export { ControlClient } from "./control.js";
+export type { DeviceRegistration, HeartbeatResponse, ControlClientOptions, DesiredState, DesiredModelEntry, DeviceSyncRequest, DeviceSyncResponse, ObservedModelStatus, } from "./control.js";
+export type { ControlSyncResult } from "./types.js";
+export { DevicesClient } from "./devices.js";
+export { SyncManager } from "./sync-manager.js";
+export type { SyncManagerOptions, SyncEvent, SyncEventListener, LocalModelMeta, } from "./sync-manager.js";
+export { DeviceAuth } from "./device-auth.js";
+export { ArtifactsClient } from "./artifacts.js";
+export type { ArtifactManifest, ArtifactDownloadUrls, ArtifactDownloadUrlsRequest, } from "./artifacts.js";
+export { configure, getDeviceContext } from "./configure.js";
+export type { ConfigureOptions } from "./configure.js";
+export { DeviceContext } from "./device-context.js";
+export type { RegistrationState, TokenState } from "./device-context.js";
+export type { SilentAuthConfig, PublishableKeyEnvironment, } from "./silent-auth-config.js";
+export { validatePublishableKey, getPublishableKeyEnvironment, } from "./silent-auth-config.js";
+export type { MonitoringConfig } from "./monitoring-config.js";
+export { computeHash, verifyModelIntegrity, assertModelIntegrity, } from "./integrity.js";
+export { ResponsesClient, generateId as generateResponseId, } from "./responses.js";
+export { ToolRunner } from "./responses-tools.js";
+export { createTransformersJsLocalResponsesRuntime } from "./transformers-local-runtime.js";
+export type { ToolExecutor, ToolResult, } from "./responses-tools.js";
+export type { LocalResponsesRuntime, LocalResponsesRuntimeResolver, } from "./responses-runtime.js";
+export type { TransformersLocalResponsesRuntimeOptions } from "./transformers-local-runtime.js";
+export type { ResponseRequest, ContentBlock, ResponseInputItem, ChatContentPart, ToolDef, ResponseToolCall, ResponseOutput, Response as ResponseObject, ResponseUsage, TextDeltaEvent, ToolCallDeltaEvent, DoneEvent, ResponseStreamEvent, ResponsesClientOptions, } from "./responses.js";
+export { ModelsClient } from "./models.js";
+export type { ModelStatus, CachedModelInfo } from "./models.js";
 export { StreamingInferenceEngine } from "./streaming.js";
+export { EngineRegistry } from "./runtime/index.js";
+export type { EnginePlugin } from "./runtime/index.js";
+export { embed } from "./embeddings.js";
+export { OctomilText, TextPredictionsClient } from "./text/octomil-text.js";
+export type { TextPredictionRequest, TextPredictionResult, } from "./text/octomil-text.js";
 export { FederatedClient, WeightExtractor } from "./federated.js";
+export { FederatedAnalyticsClient } from "./federated-analytics.js";
 export { SecureAggregation, SecAggPlus, shamirSplit, shamirReconstruct, } from "./secure-aggregation.js";
 export { clipGradients, addGaussianNoise, quantize, dequantize, } from "./privacy.js";
-export { RolloutsManager } from "./rollouts.js";
+export { getInstallId, resetInstallIdCache } from "./install-id.js";
+export { GradientCache } from "./gradient-cache.js";
 export { ExperimentsClient } from "./experiments.js";
-export type { OctomilOptions, Backend, CacheStrategy, DownloadProgress, TensorData, NamedTensors, PredictInput, PredictOutput, ChatRole, ChatMessage, ChatResponse, ChatOptions, ChatChunk, CacheInfo, TelemetryEvent, ModelMetadata, OctomilErrorCode, DeviceAuthConfig, DeviceAuthToken, DeviceInfo, StreamingModality, StreamingOptions, StreamingChunk, StreamingResult, WeightMap, TrainingConfig, TrainStepResult, FederatedRound, RolloutStatus, RolloutVersion, RolloutConfig, Experiment, ExperimentVariant, } from "./types.js";
+export { RoutingClient, detectDeviceCapabilities } from "./routing.js";
+export type { AuthConfig, OrgApiKeyAuth, DeviceTokenAuth, OctomilOptions, Backend, CacheStrategy, DownloadProgress, TensorData, NamedTensors, PredictInput, PredictOutput, ChatRole, ChatMessage, ChatResponse, ChatOptions, ChatChunk, CacheInfo, TelemetryEvent, ModelMetadata, OctomilErrorCode, DeviceAuthConfig, DeviceAuthToken, DeviceInfo, StreamingModality, StreamingOptions, StreamingChunk, StreamingResult, StreamToken, WeightMap, TrainingConfig, TrainStepResult, FederatedRound, Experiment, ExperimentVariant, DeviceCapabilities, RoutingPreference, RoutingRequest, RoutingDecision, RoutingFallbackTarget, RoutingConfig, CloudInferenceRequest, CloudInferenceResponse, EmbeddingResult, EmbeddingUsage, EmbeddingResponse, BenchmarkResult, DetectionResult, RankedEngine, InferenceMetrics, GenerationChunk, CacheStats, AnalyticsFilter, DescriptiveResult, GroupStats, ConfidenceInterval, TTestResult, ChiSquareResult, PostHocPair, AnovaResult, AnalyticsQuery, AnalyticsQueryListResponse, GradientCacheEntry, } from "./types.js";
 export type { QuantizedWeightMap } from "./privacy.js";
-export { OctomilError } from "./types.js";
+export { OctomilError, ERROR_CODE_MAP, AuthType, PrincipalType, Scope, } from "./types.js";
+export { ErrorCode, ModelStatus as ContractModelStatus, DeviceClass, FinishReason, CompatibilityLevel, OTLP_RESOURCE_ATTRIBUTES, TELEMETRY_EVENTS, EVENT_REQUIRED_ATTRIBUTES, } from "./_generated/index.js";
+import type { BenchmarkResult } from "./types.js";
+export declare function benchmarkResultOk(result: BenchmarkResult): boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,YAAY,EACV,cAAc,EACd,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,EACX,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,43 +3,85 @@
  *
  * @example
  * ```ts
- * import { Octomil } from '@octomil/browser';
+ * import { OctomilClient } from '@octomil/browser';
  *
- * const ml = new Octomil({
- *   model: 'https://models.octomil.io/sentiment-v1.onnx',
+ * const ml = new OctomilClient({
+ *   model: 'https://models.octomil.com/sentiment-v1.onnx',
  *   backend: 'webgpu',
  * });
  *
  * await ml.load();
  * const result = await ml.predict({ text: 'This is amazing!' });
  * console.log(result.label, result.score);
- * ml.dispose();
+ * ml.close();
  * ```
  *
  * @packageDocumentation
  */
 // Main class
-export { Octomil } from "./octomil.js";
+export { OctomilClient } from "./octomil.js";
+// Audio namespace (transcriptions)
+export { OctomilAudio } from "./audio/octomil-audio.js";
+export { AudioTranscriptions } from "./audio/audio-transcriptions.js";
+// Chat namespace (OpenAI-compatible chat completions)
+export { ChatClient, messagesToResponseInput } from "./chat.js";
 // Sub-modules (for advanced usage)
-export { InferenceEngine } from "./inference.js";
-export { ModelLoader } from "./model-loader.js";
+export { InferenceEngine } from "./runtime/engines/onnx-web/engine.js";
+export { ModelManager } from "./model-manager.js";
 export { createModelCache } from "./cache.js";
-export { TelemetryReporter, initTelemetry, getTelemetry, disposeTelemetry, } from "./telemetry.js";
+export { TelemetryReporter, initTelemetry, getTelemetry, closeTelemetry, } from "./telemetry.js";
+export { MonitoringClient } from "./monitoring.js";
+export { SettingsClient } from "./settings.js";
+export { TrainingClient } from "./training.js";
+// Capabilities
+export { CapabilitiesClient } from "./capabilities.js";
+// Control (device registration + heartbeat)
+export { ControlClient } from "./control.js";
+export { DevicesClient } from "./devices.js";
+// Sync (desired-state reconciliation)
+export { SyncManager } from "./sync-manager.js";
 // Device auth
-export { DeviceAuthManager } from "./device-auth.js";
+export { DeviceAuth } from "./device-auth.js";
+export { ArtifactsClient } from "./artifacts.js";
+// Silent device registration
+export { configure, getDeviceContext } from "./configure.js";
+export { DeviceContext } from "./device-context.js";
+export { validatePublishableKey, getPublishableKeyEnvironment, } from "./silent-auth-config.js";
 // Model integrity
-export { computeHash, verifyModelIntegrity, assertModelIntegrity } from "./integrity.js";
+export { computeHash, verifyModelIntegrity, assertModelIntegrity, } from "./integrity.js";
+// Responses namespace (Layer 2 — structured response API)
+export { ResponsesClient, generateId as generateResponseId, } from "./responses.js";
+export { ToolRunner } from "./responses-tools.js";
+export { createTransformersJsLocalResponsesRuntime } from "./transformers-local-runtime.js";
+// Models namespace (status / load / unload / list / clearCache)
+export { ModelsClient } from "./models.js";
 // Streaming inference
 export { StreamingInferenceEngine } from "./streaming.js";
+// Engine registry & plugin interface
+export { EngineRegistry } from "./runtime/index.js";
+// Embeddings
+export { embed } from "./embeddings.js";
+export { OctomilText, TextPredictionsClient } from "./text/octomil-text.js";
 // Federated training
 export { FederatedClient, WeightExtractor } from "./federated.js";
+// Federated analytics
+export { FederatedAnalyticsClient } from "./federated-analytics.js";
 // Secure aggregation
 export { SecureAggregation, SecAggPlus, shamirSplit, shamirReconstruct, } from "./secure-aggregation.js";
 // Privacy filters
 export { clipGradients, addGaussianNoise, quantize, dequantize, } from "./privacy.js";
-// Rollouts
-export { RolloutsManager } from "./rollouts.js";
+// Install ID (telemetry resource attribute)
+export { getInstallId, resetInstallIdCache } from "./install-id.js";
+// Gradient cache
+export { GradientCache } from "./gradient-cache.js";
 // Experiments / A/B testing
 export { ExperimentsClient } from "./experiments.js";
-export { OctomilError } from "./types.js";
+// Routing
+export { RoutingClient, detectDeviceCapabilities } from "./routing.js";
+export { OctomilError, ERROR_CODE_MAP, AuthType, PrincipalType, Scope, } from "./types.js";
+// Contract-generated enums and constants (from octomil-contracts)
+export { ErrorCode, ModelStatus as ContractModelStatus, DeviceClass, FinishReason, CompatibilityLevel, OTLP_RESOURCE_ATTRIBUTES, TELEMETRY_EVENTS, EVENT_REQUIRED_ATTRIBUTES, } from "./_generated/index.js";
+export function benchmarkResultOk(result) {
+    return result.error == null;
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,aAAa;AACb,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,mCAAmC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEzF,sBAAsB;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAElE,qBAAqB;AACrB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,kBAAkB;AAClB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAyCrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/install-id.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @octomil/browser — Persistent install ID for telemetry resource attributes.
+ *
+ * Generates a UUID on first SDK initialization and persists it to
+ * `localStorage` under the key `octomil_install_id`. On subsequent inits,
+ * reads from the persisted value. This provides a stable anonymous
+ * identifier for the `octomil.install.id` OTLP resource attribute.
+ */
+/**
+ * Returns the persistent install ID, creating it if necessary.
+ *
+ * On first call, checks `localStorage` for a stored value. If none exists,
+ * generates a new UUID via `crypto.randomUUID()` and persists it. The result
+ * is cached in memory for subsequent calls.
+ *
+ * If `localStorage` is unavailable (e.g., private browsing, SSR), a new
+ * random UUID is generated and cached in memory only (not persisted).
+ */
+export declare function getInstallId(): string;
+/**
+ * Returns the cached install ID without accessing localStorage.
+ *
+ * Returns null if `getInstallId()` has not been called yet.
+ */
+export declare function getCachedInstallId(): string | null;
+/**
+ * Clears the in-memory cache. Primarily for testing.
+ *
+ * Does NOT remove the persisted value from localStorage.
+ */
+export declare function resetInstallIdCache(): void;
+//# sourceMappingURL=install-id.d.ts.map

package/dist/install-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.d.ts","sourceRoot":"","sources":["../src/install-id.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAyBrC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/install-id.js

@@ -0,0 +1,61 @@
+/**
+ * @octomil/browser — Persistent install ID for telemetry resource attributes.
+ *
+ * Generates a UUID on first SDK initialization and persists it to
+ * `localStorage` under the key `octomil_install_id`. On subsequent inits,
+ * reads from the persisted value. This provides a stable anonymous
+ * identifier for the `octomil.install.id` OTLP resource attribute.
+ */
+const STORAGE_KEY = "octomil_install_id";
+let _cached = null;
+/**
+ * Returns the persistent install ID, creating it if necessary.
+ *
+ * On first call, checks `localStorage` for a stored value. If none exists,
+ * generates a new UUID via `crypto.randomUUID()` and persists it. The result
+ * is cached in memory for subsequent calls.
+ *
+ * If `localStorage` is unavailable (e.g., private browsing, SSR), a new
+ * random UUID is generated and cached in memory only (not persisted).
+ */
+export function getInstallId() {
+    if (_cached !== null) {
+        return _cached;
+    }
+    try {
+        const stored = localStorage.getItem(STORAGE_KEY);
+        if (stored) {
+            _cached = stored;
+            return stored;
+        }
+    }
+    catch {
+        // localStorage unavailable (private browsing, SSR, etc.)
+    }
+    const newId = crypto.randomUUID();
+    try {
+        localStorage.setItem(STORAGE_KEY, newId);
+    }
+    catch {
+        // Persistence failed — use ephemeral ID
+    }
+    _cached = newId;
+    return newId;
+}
+/**
+ * Returns the cached install ID without accessing localStorage.
+ *
+ * Returns null if `getInstallId()` has not been called yet.
+ */
+export function getCachedInstallId() {
+    return _cached;
+}
+/**
+ * Clears the in-memory cache. Primarily for testing.
+ *
+ * Does NOT remove the persisted value from localStorage.
+ */
+export function resetInstallIdCache() {
+    _cached = null;
+}
+//# sourceMappingURL=install-id.js.map

package/dist/install-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-id.js","sourceRoot":"","sources":["../src/install-id.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,GAAG,MAAM,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAElC,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IAED,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/{model-loader.d.ts → model-manager.d.ts}

@@ -1,5 +1,5 @@
 /**
- * @octomil/browser — Model loader
+ * @octomil/browser — Model manager
  *
  * Downloads an ONNX model from a URL or the Octomil model registry,
  * caches it locally, and returns the raw `ArrayBuffer` for the
@@ -7,7 +7,7 @@
  */
 import type { ModelCache } from "./cache.js";
 import type { OctomilOptions } from "./types.js";
-export declare class ModelLoader {
+export declare class ModelManager {
     private readonly modelId;
     private readonly serverUrl;
     private readonly apiKey;
@@ -31,10 +31,10 @@ export declare class ModelLoader {
      * the Octomil server.
      */
     resolveModelUrl(): Promise<string>;
-    private fetchRegistryUrl;
+    private fetchResolverUrl;
     private buildHeaders;
     private download;
     private delay;
     private validate;
 }
-//# sourceMappingURL=model-loader.d.ts.map
+//# sourceMappingURL=model-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.d.ts","sourceRoot":"","sources":["../src/model-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,YAAY,CAAC;AAcpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;IACzE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU;IAYtD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAqBlC,iDAAiD;IAC3C,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAKlC,+BAA+B;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,oCAAoC;IAC9B,YAAY;IASlB;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;YAkB1B,gBAAgB;IAiD9B,OAAO,CAAC,YAAY;YAWN,QAAQ;IAmHtB,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,QAAQ;CAkBjB"}

package/dist/{model-loader.js → model-manager.js}

@@ -1,5 +1,5 @@
 /**
- * @octomil/browser — Model loader
+ * @octomil/browser — Model manager
  *
  * Downloads an ONNX model from a URL or the Octomil model registry,
  * caches it locally, and returns the raw `ArrayBuffer` for the
@@ -12,9 +12,9 @@ import { OctomilError } from "./types.js";
 const MAX_RETRIES = 3;
 const RETRY_DELAY_MS = 1_000;
 // ---------------------------------------------------------------------------
-// ModelLoader
+// ModelManager
 // ---------------------------------------------------------------------------
-export class ModelLoader {
+export class ModelManager {
     modelId;
     serverUrl;
     apiKey;
@@ -80,10 +80,10 @@ export class ModelLoader {
         if (!this.serverUrl) {
             throw new OctomilError("MODEL_NOT_FOUND", `Cannot resolve model "${this.modelId}": no serverUrl configured.`);
         }
-        return this.fetchRegistryUrl(this.modelId);
+        return this.fetchResolverUrl(this.modelId);
     }
-    async fetchRegistryUrl(name) {
-        const registryUrl = `${this.serverUrl}/api/v1/models/${encodeURIComponent(name)}/metadata`;
+    async fetchResolverUrl(reference) {
+        const resolverUrl = `${this.serverUrl}/api/v1/registry/resolve/${encodeURIComponent(reference)}`;
         const headers = {
             Accept: "application/json",
         };
@@ -92,19 +92,23 @@ export class ModelLoader {
         }
         let response;
         try {
-            response = await fetch(registryUrl, { headers });
+            response = await fetch(resolverUrl, { headers });
         }
         catch (err) {
-            throw new OctomilError("NETWORK_ERROR", `Failed to reach model registry at ${registryUrl}`, err);
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Failed to reach model resolver at ${resolverUrl}`, err);
         }
         if (!response.ok) {
             if (response.status === 404) {
-                throw new OctomilError("MODEL_NOT_FOUND", `Model "${name}" not found in registry.`);
+                throw new OctomilError("MODEL_NOT_FOUND", `Model "${reference}" not found in registry.`);
             }
-            throw new OctomilError("NETWORK_ERROR", `Registry returned HTTP ${response.status}: ${response.statusText}`);
+            throw new OctomilError("NETWORK_UNAVAILABLE", `Model resolver returned HTTP ${response.status}: ${response.statusText}`);
         }
         const metadata = (await response.json());
-        return metadata.url;
+        const resolvedUrl = metadata.download_url ?? metadata.url;
+        if (!resolvedUrl) {
+            throw new OctomilError("MODEL_LOAD_FAILED", `Model resolver response for "${reference}" did not include a download URL`);
+        }
+        return resolvedUrl;
     }
     // -----------------------------------------------------------------------
     // Internal — download
@@ -133,7 +137,7 @@ export class ModelLoader {
             catch (err) {
                 attempt++;
                 if (attempt > MAX_RETRIES) {
-                    throw new OctomilError("NETWORK_ERROR", `Failed to download model from ${url} after ${MAX_RETRIES} retries`, err);
+                    throw new OctomilError("NETWORK_UNAVAILABLE", `Failed to download model from ${url} after ${MAX_RETRIES} retries`, err);
                 }
                 await this.delay(RETRY_DELAY_MS * attempt);
                 continue;
@@ -192,7 +196,7 @@ export class ModelLoader {
                 streamFailed = true;
                 attempt++;
                 if (attempt > MAX_RETRIES) {
-                    throw new OctomilError("NETWORK_ERROR", `Model download interrupted after ${MAX_RETRIES} retries`, err);
+                    throw new OctomilError("NETWORK_UNAVAILABLE", `Model download interrupted after ${MAX_RETRIES} retries`, err);
                 }
                 await this.delay(RETRY_DELAY_MS * attempt);
             }
@@ -229,4 +233,4 @@ export class ModelLoader {
         }
     }
 }
-//# sourceMappingURL=model-loader.js.map
+//# sourceMappingURL=model-manager.js.map

package/dist/model-manager.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @octomil/browser — Models namespace
+ *
+ * Provides a `ModelsClient` that exposes model lifecycle status
+ * (`not_cached | downloading | ready | error`), load/unload,
+ * cached model listing, and cache clearing.
+ *
+ * Because the browser SDK's `OctomilClient` is model-specific
+ * (constructed with a single model URL/ref), this client wraps
+ * the existing {@link ModelManager} and tracks runtime state
+ * (downloading, error) in memory.
+ */
+import type { ModelManager } from "./model-manager.js";
+/** Lifecycle status of a model in the browser SDK. */
+export type ModelStatus = "not_cached" | "downloading" | "ready" | "error";
+/** Summary info for a cached model. */
+export interface CachedModelInfo {
+    /** The model reference (URL or registry name). */
+    modelRef: string;
+    /** ISO-8601 timestamp of when the model was cached. */
+    cachedAt?: string;
+    /** Size of the cached model in bytes. */
+    sizeBytes?: number;
+}
+export declare class ModelsClient {
+    private readonly modelId;
+    private readonly manager;
+    private readonly onLoaded;
+    /** Models currently being downloaded. */
+    private downloading;
+    /** Models that failed to load, keyed by modelId -> error message. */
+    private errors;
+    constructor(modelId: string, manager: ModelManager, onLoaded: () => void);
+    /**
+     * Return the current lifecycle status of the configured model.
+     *
+     * - `"downloading"` — a `load()` call is in progress.
+     * - `"error"` — the last `load()` call failed.
+     * - `"ready"` — the model binary is cached locally.
+     * - `"not_cached"` — the model is not cached and not loading.
+     */
+    status(modelId?: string): Promise<ModelStatus>;
+    /**
+     * Download the model (if not cached) and mark it as ready.
+     *
+     * Tracks downloading/error state so that `status()` reflects
+     * the current lifecycle phase.  Delegates the actual work to
+     * the underlying {@link ModelManager}.
+     */
+    load(modelId?: string): Promise<void>;
+    /**
+     * Remove the cached model binary.
+     *
+     * Note: this does not release the in-memory ONNX session.
+     * Call `OctomilClient.close()` for full cleanup.
+     */
+    unload(_modelId?: string): Promise<void>;
+    /**
+     * List cached models.
+     *
+     * Because the browser SDK manages a single model per client,
+     * this returns zero or one entries.
+     */
+    list(): Promise<CachedModelInfo[]>;
+    /**
+     * Remove the cached model and clear any tracked error state.
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Return the error message for the model, if the last load failed.
+     */
+    getError(modelId?: string): string | undefined;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3E,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,yCAAyC;IACzC,OAAO,CAAC,WAAW,CAAqB;IACxC,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAA6B;gBAGxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,IAAI;IAOvC;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAUpD;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB3C;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAaxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAI/C"}