@hainiva/agent-sdk 0.0.0-stage → 0.3.0

package/dist/cjs/ws.cjs

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconnectingSocket = void 0;
+exports.backoffDelay = backoffDelay;
+const emitter_js_1 = require("./emitter.cjs");
+const errors_js_1 = require("./errors.cjs");
+const log_js_1 = require("./log.cjs");
+const redact_js_1 = require("./redact.cjs");
+const url_js_1 = require("./url.cjs");
+/** Exponential backoff with full jitter: between half and all of min(max, initial·2^attempt). */
+function backoffDelay(attempt, initial = 1000, max = 30000, rnd = Math.random) {
+    const cap = Math.min(max, initial * 2 ** Math.max(0, attempt));
+    return Math.round(cap / 2 + rnd() * (cap / 2));
+}
+const OPEN = 1;
+/**
+ * A WebSocket that stays connected: exponential backoff with jitter, auth in the
+ * first frame (the token is never in the URL), heartbeat with a dead-connection
+ * timeout, and a resume hook carrying the last sequence number seen. Frame shapes
+ * are the caller's: pass `authFrame`, `isReady`, `resume`, `seqOf` for the
+ * protocol (`/agent/v1/ws` bindings: TODO(S3b)).
+ */
+class ReconnectingSocket {
+    constructor(o) {
+        this.o = o;
+        this.ws = null;
+        this.st = "idle";
+        this.want = false;
+        this.authed = false;
+        this.attempt = 0;
+        this.seq = 0;
+        this.lastFrameAt = 0;
+        this.reconnectTimer = null;
+        this.authTimer = null;
+        this.pingTimer = null;
+        this.WS = o.WebSocket ?? globalThis.WebSocket;
+        this.redactor = o.redactor ?? new redact_js_1.Redactor();
+        this.log = (0, log_js_1.safeLogger)(o.log, this.redactor);
+        this.events = new emitter_js_1.TypedEmitter((e) => this.log("listener_error", e));
+        this.expiredCode = o.closeCodes?.tokenExpired ?? 4001;
+        this.revokedCode = o.closeCodes?.revoked ?? 4003;
+    }
+    get state() { return this.st; }
+    /** The highest sequence number received (what `resume` is called with). */
+    get lastSeq() { return this.seq; }
+    /** Restore a sequence number kept from an earlier run. */
+    setLastSeq(n) { if (Number.isFinite(n) && n >= 0)
+        this.seq = n; }
+    connect() {
+        this.want = true;
+        if (this.ws || this.reconnectTimer)
+            return;
+        if (!this.WS) {
+            this.fail(new errors_js_1.HainivaAgentError(0, "no_websocket"));
+            return;
+        }
+        void this.open();
+    }
+    disconnect() {
+        this.want = false;
+        this.clearTimers();
+        const ws = this.ws;
+        this.ws = null;
+        this.authed = false;
+        ws?.close(1000);
+        this.setState("closed");
+    }
+    /** Send a frame on an authenticated socket. False when not open (nothing is queued). */
+    send(frame) {
+        if (!this.ws || !this.authed || this.ws.readyState !== OPEN)
+            return false;
+        this.ws.send(this.encode(frame));
+        return true;
+    }
+    /** Hand a refreshed access token to the open socket (needs `tokenFrame`). */
+    updateToken(token) {
+        this.redactor.add(token);
+        return this.o.tokenFrame ? this.send(this.o.tokenFrame(token)) : false;
+    }
+    encode(f) { return (this.o.encode ?? JSON.stringify)(f); }
+    setState(s) {
+        if (this.st === s)
+            return;
+        this.st = s;
+        this.events.emit("state", s);
+    }
+    fail(e) {
+        this.log("socket_error", { code: e.code });
+        this.events.emit("error", e);
+    }
+    async open() {
+        this.setState(this.attempt ? "reconnecting" : "connecting");
+        let token;
+        let url;
+        try {
+            token = await this.o.getToken();
+            this.redactor.add(token);
+            url = typeof this.o.url === "function" ? await this.o.url() : this.o.url;
+        }
+        catch (e) {
+            this.fail(errors_js_1.HainivaAgentError.from(e, "socket_auth_failed", this.redactor));
+            return this.scheduleReconnect();
+        }
+        if (!this.want)
+            return;
+        try {
+            (0, url_js_1.assertSafeUrl)(url, { kind: "ws", ...(this.o.allowInsecureLocalhost ? { allowInsecureLocalhost: true } : {}) });
+            if (token && url.includes(token))
+                throw new errors_js_1.HainivaAgentError(0, "credentials_in_url");
+        }
+        catch (e) {
+            // A configuration mistake: retrying cannot fix it.
+            this.want = false;
+            this.setState("closed");
+            return this.fail(errors_js_1.HainivaAgentError.from(e, "invalid_url", this.redactor));
+        }
+        let ws;
+        try {
+            ws = new this.WS(url);
+        }
+        catch (e) {
+            this.fail(errors_js_1.HainivaAgentError.from(e, "socket_failed", this.redactor));
+            return this.scheduleReconnect();
+        }
+        this.ws = ws;
+        this.authed = false;
+        ws.onopen = () => {
+            if (this.ws !== ws)
+                return;
+            // First frame: the credential. Nothing else is sent before the server says ready.
+            ws.send(this.encode((this.o.authFrame ?? ((t) => ({ type: "auth", token: t })))(token)));
+            this.authTimer = setTimeout(() => {
+                if (this.ws === ws && !this.authed) {
+                    this.log("auth_timeout");
+                    ws.close(4000, "auth timeout");
+                }
+            }, this.o.authTimeoutMs ?? 10000);
+        };
+        ws.onmessage = (ev) => { if (this.ws === ws)
+            this.onFrame(ws, typeof ev.data === "string" ? ev.data : String(ev.data)); };
+        ws.onerror = () => { };
+        ws.onclose = (ev) => {
+            if (this.ws !== ws)
+                return;
+            this.ws = null;
+            this.authed = false;
+            this.clearTimers();
+            this.log("socket_closed", { code: ev.code });
+            if (!this.want)
+                return this.setState("closed");
+            if (ev.code === this.revokedCode) {
+                this.want = false;
+                this.setState("closed");
+                this.events.emit("revoked", { code: ev.code });
+                return;
+            }
+            if (this.o.closeCodes?.fatal?.includes(ev.code)) {
+                this.want = false;
+                this.setState("closed");
+                return this.fail(new errors_js_1.HainivaAgentError(0, `socket_closed_${ev.code}`, {}, this.redactor));
+            }
+            if (ev.code === this.expiredCode)
+                this.o.onTokenRejected?.();
+            this.scheduleReconnect();
+        };
+    }
+    onFrame(ws, raw) {
+        let f;
+        try {
+            f = (this.o.decode ?? JSON.parse)(raw);
+        }
+        catch {
+            return;
+        }
+        this.lastFrameAt = Date.now();
+        if (!this.authed) {
+            const ready = this.o.isReady ?? ((x) => x?.["type"] === "ready");
+            if (!ready(f))
+                return; // nothing is delivered before the server accepted the credential
+            this.authed = true;
+            this.attempt = 0;
+            if (this.authTimer) {
+                clearTimeout(this.authTimer);
+                this.authTimer = null;
+            }
+            this.startHeartbeat(ws);
+            this.setState("open");
+            const resume = this.seq > 0 ? this.o.resume?.(this.seq) : null;
+            if (resume)
+                ws.send(this.encode(resume));
+            this.events.emit("ready", f);
+            return;
+        }
+        const seqOf = this.o.seqOf ?? ((x) => { const s = x?.["seq"]; return typeof s === "number" ? s : undefined; });
+        const s = seqOf(f);
+        if (s !== undefined) {
+            if (s <= this.seq)
+                return; // a replayed frame already delivered
+            this.seq = s;
+        }
+        this.events.emit("frame", f);
+    }
+    startHeartbeat(ws) {
+        const hb = this.o.heartbeat;
+        if (hb === false)
+            return;
+        const every = hb?.intervalMs ?? 20000;
+        const dead = hb?.timeoutMs ?? 45000;
+        const frame = hb?.frame ?? (() => ({ type: "ping" }));
+        this.pingTimer = setInterval(() => {
+            if (this.ws !== ws)
+                return;
+            if (Date.now() - this.lastFrameAt > dead) {
+                this.log("heartbeat_timeout");
+                ws.close(4000, "heartbeat timeout");
+                return;
+            }
+            if (ws.readyState === OPEN)
+                ws.send(this.encode(frame()));
+        }, every);
+    }
+    scheduleReconnect() {
+        if (!this.want)
+            return;
+        const b = this.o.backoff;
+        const d = backoffDelay(this.attempt++, b?.initialMs, b?.maxMs, b?.random);
+        this.setState("reconnecting");
+        this.reconnectTimer = setTimeout(() => { this.reconnectTimer = null; if (this.want)
+            void this.open(); }, d);
+    }
+    clearTimers() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.authTimer) {
+            clearTimeout(this.authTimer);
+            this.authTimer = null;
+        }
+        if (this.pingTimer) {
+            clearInterval(this.pingTimer);
+            this.pingTimer = null;
+        }
+    }
+}
+exports.ReconnectingSocket = ReconnectingSocket;

package/dist/cjs/ws.d.cts

@@ -0,0 +1,134 @@
+import { TypedEmitter } from "./emitter.cjs";
+import { HainivaAgentError } from "./errors.cjs";
+import { type Logger } from "./log.cjs";
+import { Redactor } from "./redact.cjs";
+export type ConnectionState = "idle" | "connecting" | "open" | "reconnecting" | "closed";
+/** Exponential backoff with full jitter: between half and all of min(max, initial·2^attempt). */
+export declare function backoffDelay(attempt: number, initial?: number, max?: number, rnd?: () => number): number;
+/** The part of the WebSocket API this client uses (browser, React Native, `ws` in Node). */
+export interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    onopen: ((ev: unknown) => void) | null;
+    onmessage: ((ev: {
+        data: unknown;
+    }) => void) | null;
+    onclose: ((ev: {
+        code: number;
+        reason?: string;
+    }) => void) | null;
+    onerror: ((ev: unknown) => void) | null;
+}
+export type WebSocketCtor = new (url: string) => WebSocketLike;
+type AnyFrame = Record<string, unknown>;
+export interface SocketOptions<In = AnyFrame, Out = AnyFrame> {
+    /** wss:// URL, or a function returning it. Never carries a credential (checked). */
+    url: string | (() => string | Promise<string>);
+    /** A valid access token (e.g. `session.accessToken()`); sent in the first frame. */
+    getToken: () => Promise<string>;
+    /** The server refused the token (close code `tokenExpired`): e.g. `session.invalidate()`. */
+    onTokenRejected?: () => void;
+    WebSocket?: WebSocketCtor;
+    /** First frame after open. Default `{ type: "auth", token }`. */
+    authFrame?: (token: string) => Out;
+    /** Whether a frame is the server's "authenticated" answer. Default `type === "ready"`. */
+    isReady?: (frame: In) => boolean;
+    /** Give up on an open socket that is not ready after this long. Default 10 s. */
+    authTimeoutMs?: number;
+    /** Keep-alive. `false` turns it off. */
+    heartbeat?: false | {
+        /** Send `frame()` this often. Default 20 s. */
+        intervalMs?: number;
+        /** Reconnect when nothing at all was received for this long. Default 45 s. */
+        timeoutMs?: number;
+        /** Default `{ type: "ping" }`. */
+        frame?: () => Out;
+    };
+    /** Resume hook: the frame to send after `ready` when frames were seen before. */
+    resume?: (lastSeq: number) => Out | null;
+    /** A frame's sequence number, if it has one. Default: numeric `seq`. */
+    seqOf?: (frame: In) => number | undefined;
+    /** Frame to hand the server a refreshed access token on an open socket. */
+    tokenFrame?: (token: string) => Out;
+    encode?: (frame: Out) => string;
+    decode?: (raw: string) => In;
+    backoff?: {
+        initialMs?: number;
+        maxMs?: number;
+        random?: () => number;
+    };
+    /**
+     * Server close codes. Defaults: tokenExpired 4001 (refresh and reconnect),
+     * revoked 4003 (stop). `fatal`: codes reconnecting cannot fix (stop, emit
+     * `error` with code `socket_closed_<code>`). Default none.
+     */
+    closeCodes?: {
+        tokenExpired?: number;
+        revoked?: number;
+        fatal?: number[];
+    };
+    /** Allow ws://localhost in development. Default false. */
+    allowInsecureLocalhost?: boolean;
+    log?: Logger;
+    redactor?: Redactor;
+}
+export interface SocketEvents<In> {
+    state: ConnectionState;
+    /** Authenticated (after every (re)connect). */
+    ready: In;
+    /** Every frame after `ready`, except ones already seen (seq ≤ lastSeq). */
+    frame: In;
+    /** The server revoked the session: the socket stays closed until connect() is called again. */
+    revoked: {
+        code: number;
+    };
+    error: HainivaAgentError;
+}
+/**
+ * A WebSocket that stays connected: exponential backoff with jitter, auth in the
+ * first frame (the token is never in the URL), heartbeat with a dead-connection
+ * timeout, and a resume hook carrying the last sequence number seen. Frame shapes
+ * are the caller's: pass `authFrame`, `isReady`, `resume`, `seqOf` for the
+ * protocol (`/agent/v1/ws` bindings: TODO(S3b)).
+ */
+export declare class ReconnectingSocket<In = AnyFrame, Out = AnyFrame> {
+    private readonly o;
+    readonly events: TypedEmitter<SocketEvents<In>>;
+    private ws;
+    private st;
+    private want;
+    private authed;
+    private attempt;
+    private seq;
+    private lastFrameAt;
+    private reconnectTimer;
+    private authTimer;
+    private pingTimer;
+    private readonly WS;
+    private readonly redactor;
+    private readonly log;
+    private readonly expiredCode;
+    private readonly revokedCode;
+    constructor(o: SocketOptions<In, Out>);
+    get state(): ConnectionState;
+    /** The highest sequence number received (what `resume` is called with). */
+    get lastSeq(): number;
+    /** Restore a sequence number kept from an earlier run. */
+    setLastSeq(n: number): void;
+    connect(): void;
+    disconnect(): void;
+    /** Send a frame on an authenticated socket. False when not open (nothing is queued). */
+    send(frame: Out): boolean;
+    /** Hand a refreshed access token to the open socket (needs `tokenFrame`). */
+    updateToken(token: string): boolean;
+    private encode;
+    private setState;
+    private fail;
+    private open;
+    private onFrame;
+    private startHeartbeat;
+    private scheduleReconnect;
+    private clearTimers;
+}
+export {};

package/dist/esm/agent.d.ts

@@ -0,0 +1,240 @@
+/**
+ * HainivaAgent — one object for a staff member's app: sign-in with your
+ * backend's assertion, the REST API, the live event socket and the agent's
+ * calls, wired together.
+ *
+ *   const agent = new HainivaAgent({ baseUrl, tenantId, getAssertion, media: joinCallRoom });
+ *   agent.on("call.ringing", (r) => showRing(r));
+ *   await agent.connect();
+ *   await agent.calls.accept(callId);   // answers, then joins the room with `media`
+ *
+ * Transport-agnostic: LiveKit, the DOM and React Native come in through options
+ * (`media`, `WebSocket`, `store`), so the core runs in Node too.
+ */
+import { CallStore, type CallEffect, type CallsState, type TransferTarget } from "./calls.js";
+import type { AgentAcceptDto, AgentCallEndedData, AgentDeskSessionDto, AgentCallRingingData, AgentConversationDto, AgentDispositionDto, AgentMeDto, AgentMessageDto, AgentPage, AgentPushSubscriptionDto, AgentPushSubscriptionInput, AgentRingDto, AgentSessionDto, SupervisorAgentDto, SupervisorLiveCallDto, SupervisorSuperviseDto } from "./contract.js";
+import { TypedEmitter } from "./emitter.js";
+import { HainivaAgentError } from "./errors.js";
+import { type AgentEventFrame } from "./events.js";
+import { type Logger } from "./log.js";
+import { AgentRestClient, type AgentStatus, type ConversationListQuery, type MediaCredentials, type RequestOptions } from "./rest.js";
+import { SessionManager, type AgentSession, type GetAssertion, type SessionStore } from "./session.js";
+import { type ConnectionState, type WebSocketCtor } from "./ws.js";
+/** A joined media room — what `joinCallRoom` from `/web` or `/react-native` returns. */
+export interface MediaSession {
+    leave(): Promise<void>;
+    setMuted(muted: boolean): Promise<void>;
+    onDisconnected(fn: () => void): () => void;
+}
+/** Join a room: pass `joinCallRoom` from `@hainiva/agent-sdk/web` or `/react-native`. */
+export type JoinMedia = (join: {
+    url: string;
+    token: string;
+}) => Promise<MediaSession>;
+export interface HainivaAgentOptions {
+    /** https://api.hainiva.com (or your organisation's API host). */
+    baseUrl: string;
+    tenantId: string;
+    /** Ask YOUR backend for a fresh assertion — every time; never cache one. */
+    getAssertion: GetAssertion;
+    /** Where the session is kept. Default in memory (a restart signs in again). */
+    store?: SessionStore;
+    /** Joins call media. Without it, `calls.accept` answers and returns the credentials only. */
+    media?: JoinMedia;
+    /** WebSocket implementation (browsers and React Native have one; Node 22 too). */
+    WebSocket?: WebSocketCtor;
+    fetch?: typeof fetch;
+    device?: {
+        label?: string;
+        platform?: "ios" | "android" | "web" | "other";
+    };
+    /** Per REST request. Default 15 s. */
+    timeoutMs?: number;
+    /** How long a ring with no server-known end may ring here. Default 60 s. */
+    ringTimeoutMs?: number;
+    /** A redacted log of what the SDK does. Nothing is logged without it. */
+    log?: Logger;
+    /** Local development only (http://localhost, ws://localhost). */
+    allowInsecureLocalhost?: boolean;
+}
+export interface HainivaAgentEvents {
+    /** Socket state. */
+    connection: ConnectionState;
+    /** The socket is authenticated (after every reconnect). */
+    ready: {
+        seq: number;
+    };
+    "call.ringing": AgentCallRingingData;
+    "call.ended": AgentCallEndedData;
+    "conversation.assigned": Record<string, unknown>;
+    "message.created": Record<string, unknown>;
+    "wrapup.required": {
+        callId: string;
+        conversationId: string;
+        deadlineAt: string | null;
+    };
+    "presence.changed": Record<string, unknown>;
+    "supervisor.alert": Record<string, unknown>;
+    /** An event name this SDK version does not know yet (the server added one). */
+    "event.unknown": AgentEventFrame;
+    /** The calls changed (state machine). */
+    calls: CallsState;
+    /** Something the host must do for a call (stop the native ring, leave media). Handled for media already. */
+    callEffect: CallEffect;
+    /** Events were missed beyond what the server keeps: state was refetched (rings); refetch your own lists. */
+    resync: {
+        fromSeq: number;
+    };
+    /** The session expires within a minute: the SDK is refreshing it. */
+    "session.expiring": {
+        expiresAt: string;
+    };
+    /** The session was ended by HAINIVA (sign-out elsewhere, suspended, app paused, key rotated). Call connect() to sign in again. */
+    revoked: {
+        reason: string;
+    };
+    error: HainivaAgentError;
+}
+/**
+ * The staff member's app: session, REST, socket and calls.
+ */
+export declare class HainivaAgent {
+    private readonly o;
+    readonly events: TypedEmitter<HainivaAgentEvents>;
+    readonly session: SessionManager<AgentSession & AgentSessionDto>;
+    readonly rest: AgentRestClient;
+    readonly callStore: CallStore;
+    private socket;
+    private meDto;
+    private readonly media;
+    private readonly offs;
+    private readonly redactor;
+    private readonly log;
+    private readonly ringMs;
+    constructor(o: HainivaAgentOptions);
+    /** The signed-in member (after connect()). */
+    get me(): AgentMeDto | null;
+    /** The calls now (the state machine): ringing, connecting, active, held, ended. */
+    get callsState(): CallsState;
+    get connection(): ConnectionState;
+    on<K extends keyof HainivaAgentEvents>(event: K, fn: (payload: HainivaAgentEvents[K]) => void): () => void;
+    /** Sign in (or restore the stored session), load who you are and the rings waiting, open the event socket. */
+    connect(): Promise<AgentMeDto>;
+    /**
+     * Close the socket and leave every call's media. `signOut: true` also ends
+     * the session on the server (and removes it from the store) — do that when
+     * the staff member signs out; unregister this device's push first.
+     */
+    disconnect(opts?: {
+        signOut?: boolean;
+    }): Promise<void>;
+    setStatus(status: AgentStatus, o?: RequestOptions): Promise<{
+        status: AgentStatus;
+    }>;
+    readonly desk: {
+        /** A desk token for the embedded desk (`@hainiva/agent-sdk/embed` mountDesk / `<HainivaDesk/>` call this). */
+        session: () => Promise<AgentDeskSessionDto>;
+    };
+    readonly rings: {
+        /** Rings waiting for you now (also fed into the call state). */
+        pending: () => Promise<AgentRingDto[]>;
+    };
+    readonly calls: {
+        /**
+         * Answer: the server's answer race decides (409 = someone else was
+         * faster). With `media`, joins the room and returns the session.
+         */
+        accept: (callId: string, ring?: {
+            from?: string;
+            conversationId?: string;
+        }) => Promise<{
+            accepted: AgentAcceptDto;
+            media: MediaSession | null;
+        }>;
+        decline: (callId: string) => Promise<{
+            callId: string;
+            declined: true;
+        }>;
+        /** Hang up here: media is left at once, then the server ends the call. */
+        end: (callId: string) => Promise<{
+            callId: string;
+            ended: true;
+        }>;
+        hold: (callId: string, on: boolean) => Promise<{
+            callId: string;
+            onHold: boolean;
+        }>;
+        mute: (callId: string, muted: boolean) => Promise<void>;
+        /** Warm or blind to a colleague, to a queue (always blind), or to a phone number. */
+        transfer: (callId: string, target: TransferTarget, mode?: "warm" | "blind") => Promise<{
+            callId: string;
+            transferred: true;
+        }>;
+        get: (callId: string) => Promise<import("./contract.js").AgentCallDto>;
+    };
+    /** Join (or re-join) a call's media room. Without credentials, a fresh LiveKit token is minted. */
+    joinMedia(callId: string, creds?: MediaCredentials): Promise<MediaSession>;
+    readonly conversations: {
+        list: (q?: ConversationListQuery) => Promise<AgentPage<AgentConversationDto>>;
+        get: (id: string) => Promise<AgentConversationDto>;
+        /** Take it yourself (no agentId) or, a supervisor, give it to a colleague. */
+        assign: (id: string, agentId?: string) => Promise<unknown>;
+        release: (id: string, note?: string) => Promise<{
+            conversationId: string;
+            released: true;
+        }>;
+        transfer: (id: string, to: {
+            agentId: string;
+        } | {
+            queueId: string;
+            note?: string;
+        }) => Promise<unknown>;
+        close: (id: string) => Promise<{
+            conversationId: string;
+            closed: true;
+        }>;
+    };
+    readonly messages: {
+        list: (conversationId: string, q?: {
+            after?: string;
+            limit?: number;
+        }) => Promise<AgentPage<AgentMessageDto>>;
+        send: (conversationId: string, text: string) => Promise<Pick<AgentMessageDto, "id" | "conversationId" | "interactionId" | "createdAt">>;
+        typing: (conversationId: string) => Promise<{
+            ok: true;
+        }>;
+    };
+    /** After a call: a disposition code from dispositions() and notes. */
+    wrapUp(callId: string, w?: {
+        dispositionCode?: string;
+        notes?: string;
+    }): Promise<{
+        callId: string;
+        wrappedUp: true;
+    }>;
+    dispositions(channel?: string): Promise<AgentDispositionDto[]>;
+    readonly supervisor: {
+        liveCalls: () => Promise<SupervisorLiveCallDto[]>;
+        agents: () => Promise<SupervisorAgentDto[]>;
+        /** Listen in (monitor), coach the agent (whisper) or join the call (barge). Join `media` with your adapter. */
+        supervise: (callId: string, mode?: "monitor" | "whisper" | "barge") => Promise<SupervisorSuperviseDto>;
+        setMode: (callId: string, mode: "monitor" | "whisper" | "barge", supervisorTrackSid?: string) => Promise<{
+            callId: string;
+            mode: string;
+        }>;
+    };
+    readonly push: {
+        /** Register this device's FCM token (Android) or PushKit/APNs token (iPhone) for YOUR app's credentials. */
+        register: (sub: AgentPushSubscriptionInput) => Promise<AgentPushSubscriptionDto>;
+        unregister: (token: string) => Promise<void>;
+    };
+    /** A REST call; a final 401 session_revoked tells the app and forgets the session. */
+    private guard;
+    private onRevoked;
+    private openSocket;
+    private onFrame;
+    /** Rings waiting on the server → the call state (a cold start, a missed push, a resync). */
+    private syncRings;
+    private onEffect;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/esm/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,UAAU,EACpI,eAAe,EAAE,SAAS,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,YAAY,EAAE,eAAe,EAC/G,kBAAkB,EAAE,qBAAqB,EAAE,sBAAsB,EAClE,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAwF,KAAK,eAAe,EAAyB,MAAM,aAAa,CAAC;AAChK,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AACtI,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAsB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAEvF,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AACD,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,YAAY,EAAE,YAAY,CAAC;IAC3B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kFAAkF;IAClF,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;KAAE,CAAC;IAC5E,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,2DAA2D;IAC3D,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,cAAc,EAAE,oBAAoB,CAAC;IACrC,YAAY,EAAE,kBAAkB,CAAC;IACjC,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,iBAAiB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACzF,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,+EAA+E;IAC/E,eAAe,EAAE,eAAe,CAAC;IACjC,yCAAyC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,4GAA4G;IAC5G,UAAU,EAAE,UAAU,CAAC;IACvB,4GAA4G;IAC5G,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,qEAAqE;IACrE,kBAAkB,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,kIAAkI;IAClI,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,YAAY;IAaX,OAAO,CAAC,QAAQ,CAAC,CAAC;IAZ9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,YAAY,GAAG,eAAe,CAAC,CAAC;IACjE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAuE;IACrF,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IACzD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEH,CAAC,EAAE,mBAAmB;IAqBnD,8CAA8C;IAC9C,IAAI,EAAE,IAAI,UAAU,GAAG,IAAI,CAAuB;IAClD,mFAAmF;IACnF,IAAI,UAAU,IAAI,UAAU,CAAiC;IAC7D,IAAI,UAAU,IAAI,eAAe,CAAyC;IAE1E,EAAE,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAI1G,8GAA8G;IACxG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IASpC;;;;OAIG;IACG,UAAU,CAAC,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC;IAEpF,QAAQ,CAAC,IAAI;QACX,8GAA8G;uBACjG,OAAO,CAAC,mBAAmB,CAAC;MACzC;IAEF,QAAQ,CAAC,KAAK;QACZ,gEAAgE;uBACnD,OAAO,CAAC,YAAY,EAAE,CAAC;MACpC;IAEF,QAAQ,CAAC,KAAK;QACZ;;;WAGG;yBACoB,MAAM,SAAS;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,CAAA;SAAE,KAAG,OAAO,CAAC;YAAE,QAAQ,EAAE,cAAc,CAAC;YAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;SAAE,CAAC;0BA2B5H,MAAM;;;;QAI9B,0EAA0E;sBACtD,MAAM;;;;uBAIL,MAAM,MAAM,OAAO;;;;uBAKnB,MAAM,SAAS,OAAO;QAI3C,qFAAqF;2BAC5D,MAAM,UAAU,cAAc,SAAQ,MAAM,GAAG,OAAO;;;;sBAUjE,MAAM;MACpB;IAEF,mGAAmG;IAC7F,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAwBhF,QAAQ,CAAC,aAAa;mBACT,qBAAqB,KAAG,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;kBACjE,MAAM;QAChB,8EAA8E;qBACjE,MAAM,YAAY,MAAM;sBACvB,MAAM,SAAS,MAAM;;;;uBACpB,MAAM,MAAM;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;oBACvE,MAAM;;;;MAClB;IAEF,QAAQ,CAAC,QAAQ;+BACQ,MAAM,MAAM;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KAAG,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;+BACpF,MAAM,QAAQ,MAAM;iCAClB,MAAM;;;MAC/B;IAEF,sEAAsE;IACtE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;;;;IAC3E,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAE9D,QAAQ,CAAC,UAAU;yBACF,OAAO,CAAC,qBAAqB,EAAE,CAAC;sBACnC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACzC,+GAA+G;4BAC3F,MAAM,SAAQ,SAAS,GAAG,SAAS,GAAG,OAAO,KAAe,OAAO,CAAC,sBAAsB,CAAC;0BAC7F,MAAM,QAAQ,SAAS,GAAG,SAAS,GAAG,OAAO,uBAAuB,MAAM;;;;MAC5F;IAEF,QAAQ,CAAC,IAAI;QACX,4GAA4G;wBAC5F,0BAA0B,KAAG,OAAO,CAAC,wBAAwB,CAAC;4BAC1D,MAAM;MAC1B;IAIF,sFAAsF;YACxE,KAAK;YAQL,SAAS;IAOvB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,OAAO;IA+Bf,4FAA4F;YAC9E,SAAS;IAiBvB,OAAO,CAAC,QAAQ;CAQjB"}