@octomil/browser 1.0.0 → 1.1.0

package/dist/chat.d.ts.map

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

package/dist/chat.js

@@ -0,0 +1,258 @@
+/**
+ * @octomil/browser — Chat namespace client
+ *
+ * Provides `client.chat.create()` and `client.chat.stream()` as the
+ * namespaced API surface required by the SDK facade contract.
+ *
+ * Delegates to the ResponsesClient under the hood, converting between
+ * ChatMessage[]/ChatOptions and the ResponseRequest format.
+ */
+import { OctomilError, ERROR_CODE_MAP } from "./types.js";
+import { ErrorCode } from "./_generated/error_code.js";
+import { ServerApiClient, } from "./server-api.js";
+class ChatApiClient extends ServerApiClient {
+    constructor(serverUrl, apiKey) {
+        super({ serverUrl, apiKey });
+    }
+    async requestJson(path, init = {}, query) {
+        return super.requestJson(path, init, query);
+    }
+}
+export class ChatThreadsClient {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async create(request) {
+        return this.api.requestJson("/api/v1/chat/threads", {
+            method: "POST",
+            body: JSON.stringify(request),
+        });
+    }
+    async get(threadId) {
+        return this.api.requestJson(`/api/v1/chat/threads/${encodeURIComponent(threadId)}`, { method: "GET" });
+    }
+    async list(query) {
+        return this.api.requestJson("/api/v1/chat/threads", { method: "GET" }, query);
+    }
+}
+export class ChatTurnClient {
+    createTurnInternal;
+    streamTurnInternal;
+    constructor(createTurnInternal, streamTurnInternal) {
+        this.createTurnInternal = createTurnInternal;
+        this.streamTurnInternal = streamTurnInternal;
+    }
+    async create(threadId, request) {
+        return this.createTurnInternal(threadId, request);
+    }
+    async *stream(threadId, request) {
+        yield* this.streamTurnInternal(threadId, request);
+    }
+}
+// ---------------------------------------------------------------------------
+// ChatClient
+// ---------------------------------------------------------------------------
+/**
+ * Namespaced chat API:
+ *
+ * ```ts
+ * const response = await client.chat.create(messages, options);
+ * for await (const chunk of client.chat.stream(messages, options)) { ... }
+ * ```
+ */
+export class ChatClient {
+    model;
+    serverUrl;
+    apiKey;
+    getResponses;
+    ensureReadyFn;
+    api;
+    threads;
+    turn;
+    constructor(options) {
+        this.model = options.model;
+        this.serverUrl = options.serverUrl;
+        this.apiKey = options.apiKey;
+        this.getResponses = options.getResponses;
+        this.ensureReadyFn = options.ensureReady;
+        this.api = new ChatApiClient(options.serverUrl, options.apiKey);
+        this.threads = new ChatThreadsClient(this.api);
+        this.turn = new ChatTurnClient((threadId, request) => this.createTurn(threadId, request), (threadId, request) => this.streamTurn(threadId, request));
+    }
+    /**
+     * Non-streaming chat completion.
+     *
+     * Equivalent to the deprecated `client.chat()` direct method.
+     */
+    async create(messages, options = {}) {
+        this.ensureReadyFn();
+        const start = performance.now();
+        const { instructions, input } = messagesToResponseInput(messages);
+        const response = await this.getResponses().create({
+            model: this.model,
+            input,
+            instructions,
+            maxOutputTokens: options.maxTokens,
+            temperature: options.temperature,
+            topP: options.topP,
+        });
+        const content = response.output
+            .filter((o) => o.type === "text" && o.text)
+            .map((o) => o.text)
+            .join("");
+        return {
+            message: { role: "assistant", content },
+            latencyMs: performance.now() - start,
+            usage: response.usage
+                ? {
+                    promptTokens: response.usage.promptTokens,
+                    completionTokens: response.usage.completionTokens,
+                    totalTokens: response.usage.totalTokens,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Streaming chat completion — yields chunks as they arrive.
+     *
+     * Equivalent to the deprecated `client.chatStream()` direct method.
+     */
+    async *stream(messages, options = {}) {
+        this.ensureReadyFn();
+        const { instructions, input } = messagesToResponseInput(messages);
+        let chunkIndex = 0;
+        const generator = this.getResponses().stream({
+            model: this.model,
+            input,
+            instructions,
+            maxOutputTokens: options.maxTokens,
+            temperature: options.temperature,
+            topP: options.topP,
+        });
+        for await (const event of generator) {
+            if (event.type === "text_delta") {
+                yield {
+                    index: chunkIndex++,
+                    content: event.delta,
+                    done: false,
+                    role: "assistant",
+                };
+            }
+            else if (event.type === "done") {
+                yield {
+                    index: chunkIndex,
+                    content: "",
+                    done: true,
+                    role: "assistant",
+                };
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Private
+    // -----------------------------------------------------------------------
+    requireServerUrl(method) {
+        if (!this.serverUrl) {
+            throw new OctomilError(ERROR_CODE_MAP[ErrorCode.InvalidInput], `${method} requires serverUrl to be configured.`);
+        }
+    }
+    async createTurn(threadId, request) {
+        this.ensureReadyFn();
+        this.requireServerUrl("chat.turn.create()");
+        return this.api.requestJson(`/api/v1/chat/threads/${encodeURIComponent(threadId)}/turns`, {
+            method: "POST",
+            body: JSON.stringify({
+                ...request,
+                threadId,
+            }),
+        });
+    }
+    async *streamTurn(threadId, request) {
+        this.ensureReadyFn();
+        this.requireServerUrl("chat.turn.stream()");
+        const response = await fetch(`${this.serverUrl}/api/v1/chat/threads/${encodeURIComponent(threadId)}/turns`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(this.apiKey
+                    ? { Authorization: `Bearer ${this.apiKey}` }
+                    : {}),
+            },
+            body: JSON.stringify({
+                ...request,
+                threadId,
+                stream: true,
+            }),
+        });
+        if (!response.ok || !response.body) {
+            throw new OctomilError(ERROR_CODE_MAP[ErrorCode.NetworkUnavailable], `chat.turn.stream() failed: HTTP ${response.status}`);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        let chunkIndex = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            buffer += decoder.decode(value ?? new Uint8Array(), { stream: !done });
+            let boundary = buffer.indexOf("\n\n");
+            while (boundary >= 0) {
+                const rawEvent = buffer.slice(0, boundary);
+                buffer = buffer.slice(boundary + 2);
+                const data = rawEvent
+                    .split("\n")
+                    .filter((line) => line.startsWith("data:"))
+                    .map((line) => line.slice(5).trim())
+                    .join("\n");
+                if (data && data !== "[DONE]") {
+                    const parsed = JSON.parse(data);
+                    if (parsed.type === "text_delta" && (parsed.delta || parsed.content)) {
+                        yield {
+                            index: chunkIndex++,
+                            content: parsed.delta ?? parsed.content ?? "",
+                            done: false,
+                            role: "assistant",
+                        };
+                    }
+                    if (parsed.type === "done") {
+                        yield {
+                            index: chunkIndex,
+                            content: "",
+                            done: true,
+                            role: "assistant",
+                        };
+                    }
+                }
+                boundary = buffer.indexOf("\n\n");
+            }
+            if (done) {
+                break;
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Shared helper
+// ---------------------------------------------------------------------------
+/**
+ * Convert ChatMessage[] to ResponseRequest fields.
+ * Extracts system messages as `instructions`, remaining as `input`.
+ */
+export function messagesToResponseInput(messages) {
+    const systemParts = [];
+    const userParts = [];
+    for (const msg of messages) {
+        if (msg.role === "system") {
+            systemParts.push(msg.content);
+        }
+        else {
+            const prefix = msg.role === "assistant" ? "[assistant] " : "";
+            userParts.push(prefix + msg.content);
+        }
+    }
+    return {
+        instructions: systemParts.length > 0 ? systemParts.join("\n") : undefined,
+        input: userParts.join("\n"),
+    };
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/configure.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @octomil/browser — Top-level configure() for silent device registration
+ *
+ * Creates a DeviceContext, optionally triggers background device registration
+ * with exponential backoff, and starts heartbeat if monitoring is enabled.
+ * Registration failure never blocks local usage.
+ */
+import { DeviceContext } from "./device-context.js";
+import { type SilentAuthConfig } from "./silent-auth-config.js";
+import type { MonitoringConfig } from "./monitoring-config.js";
+export interface ConfigureOptions {
+    auth?: SilentAuthConfig;
+    monitoring?: MonitoringConfig;
+    baseUrl?: string;
+}
+export declare function getDeviceContext(): DeviceContext | null;
+export declare function configure(options?: ConfigureOptions): Promise<DeviceContext>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../src/configure.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAQD,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD;AAMD,wBAAsB,SAAS,CAC7B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,aAAa,CAAC,CA+BxB"}

package/dist/configure.js

@@ -0,0 +1,136 @@
+/**
+ * @octomil/browser — Top-level configure() for silent device registration
+ *
+ * Creates a DeviceContext, optionally triggers background device registration
+ * with exponential backoff, and starts heartbeat if monitoring is enabled.
+ * Registration failure never blocks local usage.
+ */
+import { DeviceContext } from "./device-context.js";
+import { validatePublishableKey, } from "./silent-auth-config.js";
+// ---------------------------------------------------------------------------
+// Module state
+// ---------------------------------------------------------------------------
+let _deviceContext = null;
+export function getDeviceContext() {
+    return _deviceContext;
+}
+// ---------------------------------------------------------------------------
+// configure()
+// ---------------------------------------------------------------------------
+export async function configure(options = {}) {
+    // Validate publishable key prefix at configure-time
+    if (options.auth?.type === "publishable_key") {
+        validatePublishableKey(options.auth.key);
+    }
+    const installationId = DeviceContext.getOrCreateInstallationId();
+    const authAppId = options.auth?.type === "anonymous" ? options.auth.appId : options.auth?.appId;
+    const authOrgId = options.auth?.type === "anonymous" ? null : options.auth?.orgId ?? null;
+    const context = new DeviceContext({
+        installationId,
+        orgId: authOrgId,
+        appId: authAppId ?? null,
+    });
+    _deviceContext = context;
+    // Gate: only register if auth is defined AND monitoring is enabled
+    // (or in future: manifest has managed/cloud models)
+    const shouldRegister = options.auth != null && options.monitoring?.enabled === true;
+    if (shouldRegister) {
+        // Fire-and-forget background registration
+        silentRegister(context, options).catch(() => { });
+    }
+    return context;
+}
+// ---------------------------------------------------------------------------
+// Silent registration with exponential backoff
+// ---------------------------------------------------------------------------
+async function silentRegister(context, options, attempt = 0) {
+    const maxAttempts = 10;
+    const maxDelayMs = 300_000; // 5 minutes
+    const authOrgId = options.auth?.type === "anonymous" ? null : options.auth?.orgId ?? null;
+    try {
+        const baseUrl = options.baseUrl || "https://api.octomil.com";
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (options.auth?.type === "publishable_key") {
+            headers["Authorization"] = `Bearer ${options.auth.key}`;
+        }
+        else if (options.auth?.type === "bootstrap_token") {
+            headers["Authorization"] = `Bearer ${options.auth.token}`;
+        }
+        if (context.appId) {
+            headers["X-App-Id"] = context.appId;
+        }
+        const registerUrl = new URL(`${baseUrl.replace(/\/+$/, "")}/api/v1/devices/register`);
+        if (authOrgId) {
+            registerUrl.searchParams.set("org_id", authOrgId);
+        }
+        const response = await fetch(registerUrl.toString(), {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                device_identifier: context.installationId,
+                installation_id: context.installationId,
+                platform: "browser",
+                app_id: context.appId,
+            }),
+        });
+        if (!response.ok) {
+            if (response.status === 403) {
+                // Non-retryable
+                console.warn("[Octomil] Registration failed: invalid credentials");
+                context._markFailed();
+                return;
+            }
+            throw new Error(`Registration failed: ${response.status}`);
+        }
+        const data = (await response.json());
+        const serverDeviceId = data.device_id ?? data.id;
+        if (!serverDeviceId || !data.access_token || !data.expires_at) {
+            throw new Error("Registration response missing device token fields");
+        }
+        context._updateRegistered(serverDeviceId, data.access_token, new Date(data.expires_at));
+        // Start heartbeat if monitoring enabled
+        if (options.monitoring?.enabled) {
+            startHeartbeat(context, options);
+        }
+    }
+    catch (error) {
+        console.warn(`[Octomil] Registration attempt ${attempt + 1} failed:`, error);
+        if (attempt < maxAttempts) {
+            const baseDelay = Math.min(1000 * Math.pow(2, attempt), maxDelayMs);
+            const jitter = baseDelay * 0.1 * Math.random();
+            const delay = baseDelay + jitter;
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            return silentRegister(context, options, attempt + 1);
+        }
+        context._markFailed();
+    }
+}
+// ---------------------------------------------------------------------------
+// Heartbeat
+// ---------------------------------------------------------------------------
+function startHeartbeat(context, options) {
+    const intervalMs = options.monitoring?.heartbeatIntervalMs ?? 300_000;
+    setInterval(async () => {
+        const headers = context.authHeaders();
+        if (!headers)
+            return;
+        try {
+            const baseUrl = options.baseUrl || "https://api.octomil.com";
+            if (!context.serverDeviceId)
+                return;
+            await fetch(`${baseUrl.replace(/\/+$/, "")}/api/v1/devices/${context.serverDeviceId}/heartbeat`, {
+                method: "PUT",
+                headers: { ...headers, "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    device_identifier: context.installationId,
+                }),
+            });
+        }
+        catch {
+            // Heartbeat failures are non-fatal
+        }
+    }, intervalMs);
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

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

package/dist/control.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @octomil/browser — Control client
+ *
+ * Device registration and heartbeat management. Builds on top of
+ * the DeviceAuth module to provide the full control-plane namespace
+ * required by the SDK facade contract.
+ */
+import type { ControlSyncResult } from "./types.js";
+import type { DeviceContext } from "./device-context.js";
+import type { TelemetryReporter } from "./telemetry.js";
+export interface DeviceRegistration {
+    id: string;
+    deviceIdentifier: string;
+    orgId: string;
+    status: string;
+}
+export interface HeartbeatResponse {
+    status: string;
+    serverTime?: string;
+}
+export interface ControlClientOptions {
+    serverUrl?: string;
+    apiKey?: string;
+    orgId?: string;
+    deviceContext?: DeviceContext | null;
+    telemetry?: TelemetryReporter | null;
+}
+/** Per-model status in an observed state report. */
+export interface ObservedModelStatus {
+    modelId: string;
+    status: string;
+    version?: string;
+    bindingKey?: string;
+    useCase?: string;
+    deploymentId?: string;
+    deploymentKey?: string;
+    modelName?: string;
+    modelRef?: string;
+    bytesDownloaded?: number;
+    totalBytes?: number;
+    errorCode?: string;
+}
+/** Per-model entry in server-authoritative desired state. */
+export interface DesiredModelEntry {
+    modelId: string;
+    desiredVersion: string;
+    useCase?: string;
+    bindingKey?: string;
+    deploymentId?: string;
+    deploymentKey?: string;
+    modelName?: string;
+    modelRef?: string;
+    currentChannel?: string;
+    deliveryMode?: string;
+    activationPolicy?: string;
+    enginePolicy?: {
+        allowed?: string[];
+        forced?: string;
+    };
+    artifactManifest?: {
+        downloadUrl: string;
+        sizeBytes?: number;
+        sha256?: string;
+    };
+    rolloutId?: string;
+}
+export interface ServingBindingEntry {
+    binding_key?: string;
+    use_case?: string;
+    base_model_id: string;
+    base_version: string;
+    deployment_id?: string;
+    deployment_key?: string;
+    model_name?: string;
+    model_ref?: string;
+}
+/** Server-authoritative desired state for this device. */
+export interface DesiredState {
+    schemaVersion: string;
+    deviceId: string;
+    generatedAt: string;
+    activeBinding?: Record<string, unknown>;
+    models: DesiredModelEntry[];
+    serving?: ServingBindingEntry[];
+    policyConfig?: Record<string, unknown>;
+    federationOffers?: Array<{
+        roundId: string;
+        jobId: string;
+        expiresAt: string;
+    }>;
+    gcEligibleArtifactIds?: string[];
+}
+export interface ModelInventoryEntry {
+    modelId: string;
+    version: string;
+    artifactId?: string;
+    status?: string;
+}
+export interface DeviceSyncRequest {
+    schemaVersion?: string;
+    requestedAt?: string;
+    knownStateVersion?: string;
+    sdkVersion?: string;
+    platform?: string;
+    appId?: string;
+    appVersion?: string;
+    modelInventory?: ModelInventoryEntry[];
+    activeVersions?: Array<Record<string, string>>;
+    availableStorageBytes?: number;
+}
+export interface DeviceSyncResponse {
+    schemaVersion: string;
+    deviceId: string;
+    generatedAt?: string;
+    stateChanged: boolean;
+    models: DesiredModelEntry[];
+    gcEligibleArtifactIds: string[];
+    nextPollIntervalSeconds: number;
+    serverTimestamp?: string;
+    serving?: ServingBindingEntry[];
+    training_policy?: Record<string, unknown> | null;
+    round_offers?: Array<Record<string, unknown>>;
+}
+export declare class ControlClient {
+    private serverUrl;
+    private apiKey;
+    private orgId;
+    private serverDeviceId;
+    private heartbeatTimer;
+    private heartbeatSequence;
+    private readonly deviceContext;
+    private readonly telemetry;
+    constructor(options: ControlClientOptions);
+    /** Fetch current device assignments from the server. */
+    refresh(): Promise<ControlSyncResult>;
+    /** Register a device with the Octomil server. */
+    register(deviceId?: string): Promise<DeviceRegistration>;
+    /** Send a heartbeat to the server for the registered device. */
+    heartbeat(): Promise<HeartbeatResponse>;
+    /**
+     * Report observed device state to the server (GAP-05).
+     * POSTs per-model statuses and runtime metadata to
+     * `/api/v1/devices/{id}/observed-state`.
+     *
+     * Typically called by {@link SyncManager} after a reconcile cycle, but can
+     * also be invoked manually for custom reporting.
+     */
+    reportObservedState(models?: ObservedModelStatus[]): Promise<void>;
+    /**
+     * Fetch server-authoritative desired state (GAP-13).
+     * GETs `/api/v1/devices/{id}/desired-state`.
+     *
+     * Typically called by {@link SyncManager} during reconciliation, but can
+     * also be invoked manually for inspection.
+     */
+    fetchDesiredState(): Promise<DesiredState>;
+    sync(request?: DeviceSyncRequest): Promise<DeviceSyncResponse>;
+    /** Start periodic heartbeats at the given interval. */
+    startHeartbeat(intervalMs?: number): void;
+    /** Stop periodic heartbeats. */
+    stopHeartbeat(): void;
+    /** The server-assigned device ID, set after registration. */
+    get registeredDeviceId(): string | null;
+    /** Generate a stable device ID by hashing browser fingerprint data. */
+    private generateDeviceId;
+    /** Collect device info for registration payloads. */
+    private collectDeviceInfo;
+    private resolveAuthHeaders;
+    private resolveApiKeyHeaders;
+}
+//# sourceMappingURL=control.d.ts.map

package/dist/control.d.ts.map

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