@hainiva/agent-sdk 0.0.0-stage → 0.3.0

package/dist/esm/events.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The `/agent/v1/ws` protocol (v1) as ReconnectingSocket options, and the
+ * mapping of its events to the SDK's typed events and to the call state machine.
+ *
+ *   client → auth {token, lastSeq?}   FIRST frame (the token never rides in the URL)
+ *          → token.refresh {token, id} swap in a refreshed access token
+ *          → ping
+ *   server → ready {seq, expiresAt}
+ *          → event {seq, event, data, at}
+ *          → resync_required {fromSeq} events after your lastSeq are gone: refetch over REST
+ *          → ack {id, ok, error?} · session.expiring {expiresAt} · pong · error {code}
+ *   close  4001 token refused/expired (refresh, reconnect) · 4003 revoked (stop)
+ *          4008 auth timeout · 4029 rate limited (reconnect with backoff)
+ *          4009 too many sockets · 1003 binary frame (stop: retrying cannot fix them)
+ *
+ * The resume position travels in the auth frame, so the server replays from it
+ * atomically with authentication (no window in which a live event overtakes
+ * the replay).
+ */
+import type { CallEvent, CallInfo, CallsState } from "./calls.js";
+import type { AgentEventName } from "./contract.js";
+import type { SocketOptions } from "./ws.js";
+export type { AgentEventName } from "./contract.js";
+/** One event frame from the server. */
+export interface AgentEventFrame<D = Record<string, unknown>> {
+    v?: number;
+    type: "event";
+    event: AgentEventName;
+    seq: number;
+    at: string;
+    data: D;
+}
+/** Any frame from the server. */
+export type AgentServerFrame = AgentEventFrame | {
+    v?: number;
+    type: "ready";
+    seq: number;
+    expiresAt?: string;
+    protocol?: number;
+} | {
+    v?: number;
+    type: "resync_required";
+    fromSeq: number;
+} | {
+    v?: number;
+    type: "ack";
+    id: string;
+    ok: boolean;
+    error?: string;
+    expiresAt?: string;
+} | {
+    v?: number;
+    type: "session.expiring";
+    expiresAt: string;
+} | {
+    v?: number;
+    type: "pong";
+} | {
+    v?: number;
+    type: "error";
+    code?: string;
+};
+export type AgentClientFrame = {
+    type: "auth";
+    token: string;
+    lastSeq?: number;
+} | {
+    type: "token.refresh";
+    token: string;
+    id: string;
+} | {
+    type: "resume";
+    lastSeq: number;
+    id?: string;
+} | {
+    type: "ping";
+};
+export declare const AGENT_CLOSE_CODES: {
+    readonly tokenExpired: 4001;
+    readonly revoked: 4003;
+    readonly authTimeout: 4008;
+    readonly tooManySockets: 4009;
+    readonly rateLimited: 4029;
+};
+/** The protocol as ReconnectingSocket options. `lastSeq()` is read when the auth frame is built. */
+export declare function agentSocketBindings(lastSeq: () => number): Pick<SocketOptions<AgentServerFrame, AgentClientFrame>, "authFrame" | "isReady" | "resume" | "seqOf" | "tokenFrame" | "closeCodes" | "heartbeat">;
+/** Is this a well-formed event frame with a name this SDK knows? Unknown names are passed on as `event.unknown`. */
+export declare function isEventFrame(f: unknown): f is AgentEventFrame;
+export declare const isKnownEvent: (name: string) => name is AgentEventName;
+/** Pure: call.ringing data → the state machine's CallInfo (null when malformed). */
+export declare function ringInfo(d: Record<string, unknown>, now: number, defaultRingMs: number): CallInfo | null;
+/**
+ * Pure: an event → the state-machine events it causes (empty when it is not
+ * about calls this device knows). `state` resolves a call.ended that names only
+ * the conversation.
+ */
+export declare function toCallEvents(frame: AgentEventFrame, state: CallsState, now: number, defaultRingMs?: number): CallEvent[];
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/esm/events.js

@@ -0,0 +1,90 @@
+import { AGENT_EVENT_NAMES } from "./contract.js";
+export const AGENT_CLOSE_CODES = { tokenExpired: 4001, revoked: 4003, authTimeout: 4008, tooManySockets: 4009, rateLimited: 4029 };
+let tokenFrameSeq = 0;
+/** The protocol as ReconnectingSocket options. `lastSeq()` is read when the auth frame is built. */
+export function agentSocketBindings(lastSeq) {
+    return {
+        authFrame: (token) => {
+            const s = lastSeq();
+            return s > 0 ? { type: "auth", token, lastSeq: s } : { type: "auth", token };
+        },
+        isReady: (f) => f?.type === "ready",
+        // Resume rides in the auth frame (above): no separate frame after ready.
+        resume: () => null,
+        seqOf: (f) => (f?.type === "event" && typeof f.seq === "number" && Number.isInteger(f.seq) ? f.seq : undefined),
+        tokenFrame: (token) => ({ type: "token.refresh", token, id: `t${++tokenFrameSeq}` }),
+        closeCodes: { tokenExpired: AGENT_CLOSE_CODES.tokenExpired, revoked: AGENT_CLOSE_CODES.revoked, fatal: [AGENT_CLOSE_CODES.tooManySockets, 1003] },
+        // The server closes a socket that sends more than 120 frames a minute; 20 s is 3.
+        heartbeat: { intervalMs: 20000, timeoutMs: 60000, frame: () => ({ type: "ping" }) },
+    };
+}
+/** Is this a well-formed event frame with a name this SDK knows? Unknown names are passed on as `event.unknown`. */
+export function isEventFrame(f) {
+    const x = f;
+    return !!x && x["type"] === "event" && typeof x["event"] === "string" && typeof x["seq"] === "number"
+        && !!x["data"] && typeof x["data"] === "object" && !Array.isArray(x["data"]);
+}
+export const isKnownEvent = (name) => AGENT_EVENT_NAMES.includes(name);
+const str = (v) => (typeof v === "string" && v ? v : null);
+/** Pure: call.ringing data → the state machine's CallInfo (null when malformed). */
+export function ringInfo(d, now, defaultRingMs) {
+    const r = d;
+    const callId = str(r.callId);
+    if (!callId)
+        return null;
+    const path = r.path === "direct" || r.path === "queue" || r.path === "transfer" ? r.path : "queue";
+    const exp = str(r.expiresAt) ? Date.parse(r.expiresAt) : NaN;
+    const conversationId = str(r.conversationId);
+    const line = str(r.line);
+    return {
+        id: callId,
+        ...(conversationId ? { conversationId } : {}),
+        direction: "inbound",
+        path,
+        from: str(r.contactName) ?? str(r.callerNumber) ?? str(r.fromAgentName) ?? "",
+        ...(line ? { line } : {}),
+        // A ring without an end the server knows still ends: a lost cancel must not leave a ghost ring.
+        expiresAt: Number.isFinite(exp) ? exp : now + defaultRingMs,
+        ...(path === "transfer" ? { transfer: { mode: r.transferMode === "blind" ? "blind" : "warm" } } : {}),
+    };
+}
+/**
+ * Pure: an event → the state-machine events it causes (empty when it is not
+ * about calls this device knows). `state` resolves a call.ended that names only
+ * the conversation.
+ */
+export function toCallEvents(frame, state, now, defaultRingMs = 60000) {
+    if (frame.event === "call.ringing") {
+        const call = ringInfo(frame.data, now, defaultRingMs);
+        return call ? [{ type: "ring", call, at: now }] : [];
+    }
+    if (frame.event !== "call.ended")
+        return [];
+    const d = frame.data;
+    const ids = [];
+    const callId = str(d.callId);
+    if (callId)
+        ids.push(callId);
+    else if (str(d.conversationId)) {
+        for (const c of Object.values(state.calls))
+            if (c.info.conversationId === d.conversationId && c.phase !== "ended")
+                ids.push(c.info.id);
+    }
+    const out = [];
+    for (const id of ids) {
+        const c = state.calls[id];
+        if (!c || c.phase === "ended")
+            continue;
+        if (c.phase === "ringing" || c.phase === "connecting") {
+            const reason = d.reason === "answered_elsewhere" ? "answered_elsewhere"
+                : d.reason === "ended" || d.reason === "failed" ? "remote_ended" : "cancelled";
+            out.push({ type: "ring_cancelled", id, reason, at: now });
+        }
+        else if (d.reason !== "answered_elsewhere") {
+            // On the call: the caller hung up, the server ended it, or a blind transfer handed it over.
+            out.push({ type: "remote_end", id, at: now });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=events.js.map

package/dist/esm/events.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @hainiva/agent-sdk — build your own agent app on HAINIVA AICC: staff sign-in
+ * with your backend's assertion, the live event stream, and calls.
+ *
+ * Entry points:
+ *   "@hainiva/agent-sdk"              transport-agnostic core (this file) — no LiveKit, no DOM, no React Native
+ *   "@hainiva/agent-sdk/web"          localStorage store (opt-in), LiveKit call media
+ *   "@hainiva/agent-sdk/react-native" secure-store session, LiveKit call media, <HainivaDesk/>
+ *   "@hainiva/agent-sdk/embed"        mountDesk(): the HAINIVA desk in your web page (iframe)
+ *
+ * Start with HainivaAgent (./agent): it wires the session, the REST client,
+ * the event socket and the call state machine together. The parts are exported
+ * too, for apps that want their own wiring.
+ */
+export declare const SDK_VERSION = "0.3.0";
+export { HainivaAgentError } from "./errors.js";
+export { Redactor, redactString, redactValue } from "./redact.js";
+export { safeLogger, type Logger } from "./log.js";
+export { assertSafeUrl, type UrlRules } from "./url.js";
+export { TypedEmitter } from "./emitter.js";
+export { singleFlight, createTokenRefresher, type RefreshedToken, type TokenRefresher, type TokenRefresherOptions } from "./singleFlight.js";
+export { SessionManager, memoryStore, type AgentSession, type GetAssertion, type SessionEvents, type SessionManagerOptions, type SessionStore, type SessionTransport, } from "./session.js";
+export { ReconnectingSocket, backoffDelay, type ConnectionState, type SocketEvents, type SocketOptions, type WebSocketCtor, type WebSocketLike, } from "./ws.js";
+export { CallStore, transition, activeCall, ringingCalls, initialCallsState, type Call, type CallDirection, type CallEffect, type CallEvent, type CallInfo, type CallPath, type CallPhase, type CallsState, type CallStoreEvents, type CallStoreOptions, type EndReason, type Transition, type TransferState, type TransferTarget, } from "./calls.js";
+export { HainivaAgent, type HainivaAgentEvents, type HainivaAgentOptions, type JoinMedia, type MediaSession } from "./agent.js";
+export { AgentRestClient, errorFromResponse, newIdempotencyKey, type AgentRestOptions, type AgentStatus, type CallTransferTarget, type ConversationListQuery, type MediaCredentials, type RequestOptions, type TokenSource, } from "./rest.js";
+export { AGENT_CLOSE_CODES, agentSocketBindings, isEventFrame, ringInfo, toCallEvents, type AgentClientFrame, type AgentEventFrame, type AgentServerFrame, } from "./events.js";
+export * from "./contract.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC7I,OAAO,EACL,cAAc,EAAE,WAAW,EAC3B,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,qBAAqB,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,GAC/H,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAAE,YAAY,EAChC,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,GACpG,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAClE,KAAK,IAAI,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAC5G,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,GACvI,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAChI,OAAO,EACL,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EACrD,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,GAC3J,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAC5E,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,GACnE,MAAM,aAAa,CAAC;AACrB,cAAc,eAAe,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,29 @@
+/**
+ * @hainiva/agent-sdk — build your own agent app on HAINIVA AICC: staff sign-in
+ * with your backend's assertion, the live event stream, and calls.
+ *
+ * Entry points:
+ *   "@hainiva/agent-sdk"              transport-agnostic core (this file) — no LiveKit, no DOM, no React Native
+ *   "@hainiva/agent-sdk/web"          localStorage store (opt-in), LiveKit call media
+ *   "@hainiva/agent-sdk/react-native" secure-store session, LiveKit call media, <HainivaDesk/>
+ *   "@hainiva/agent-sdk/embed"        mountDesk(): the HAINIVA desk in your web page (iframe)
+ *
+ * Start with HainivaAgent (./agent): it wires the session, the REST client,
+ * the event socket and the call state machine together. The parts are exported
+ * too, for apps that want their own wiring.
+ */
+export const SDK_VERSION = "0.3.0";
+export { HainivaAgentError } from "./errors.js";
+export { Redactor, redactString, redactValue } from "./redact.js";
+export { safeLogger } from "./log.js";
+export { assertSafeUrl } from "./url.js";
+export { TypedEmitter } from "./emitter.js";
+export { singleFlight, createTokenRefresher } from "./singleFlight.js";
+export { SessionManager, memoryStore, } from "./session.js";
+export { ReconnectingSocket, backoffDelay, } from "./ws.js";
+export { CallStore, transition, activeCall, ringingCalls, initialCallsState, } from "./calls.js";
+export { HainivaAgent } from "./agent.js";
+export { AgentRestClient, errorFromResponse, newIdempotencyKey, } from "./rest.js";
+export { AGENT_CLOSE_CODES, agentSocketBindings, isEventFrame, ringInfo, toCallEvents, } from "./events.js";
+export * from "./contract.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAwE,MAAM,mBAAmB,CAAC;AAC7I,OAAO,EACL,cAAc,EAAE,WAAW,GAE5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAAE,YAAY,GAEjC,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,GAGnE,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAwF,MAAM,YAAY,CAAC;AAChI,OAAO,EACL,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,GAEtD,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,GAE7E,MAAM,aAAa,CAAC;AACrB,cAAc,eAAe,CAAC"}

package/dist/esm/livekit.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Joining a call's LiveKit room. Used by the /web and /react-native entry points
+ * only: `livekit-client` is a peer dependency, and the core never imports it.
+ */
+import { Room, type RoomConnectOptions, type RoomOptions } from "livekit-client";
+import { Redactor } from "./redact.js";
+export interface MediaJoin {
+    /** wss:// LiveKit URL. */
+    url: string;
+    /** Room token for this call — kept out of every error. */
+    token: string;
+}
+export interface JoinOptions {
+    /** Start with the microphone on. Default true. */
+    microphone?: boolean;
+    roomOptions?: RoomOptions;
+    connectOptions?: RoomConnectOptions;
+    /** ws://localhost in development. Default false. */
+    allowInsecureLocalhost?: boolean;
+    redactor?: Redactor;
+}
+export interface MediaCall {
+    readonly room: Room;
+    setMuted(muted: boolean): Promise<void>;
+    /** Leave the room (idempotent). */
+    leave(): Promise<void>;
+    /** The room closed (far end hung up, server ended it, network lost). Returns an unsubscribe. */
+    onDisconnected(fn: () => void): () => void;
+}
+/**
+ * Join with the call's media credentials, microphone on. The token is handed to
+ * LiveKit only; errors are redacted (LiveKit's own error text can contain its
+ * signalling URL, which carries the token).
+ */
+export declare function joinCallRoom(join: MediaJoin, o?: JoinOptions): Promise<MediaCall>;
+//# sourceMappingURL=livekit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.d.ts","sourceRoot":"","sources":["../../src/livekit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAa,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG5F,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,mCAAmC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,gGAAgG;IAChG,cAAc,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,GAAE,WAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA+B3F"}

package/dist/esm/livekit.js

@@ -0,0 +1,54 @@
+/**
+ * Joining a call's LiveKit room. Used by the /web and /react-native entry points
+ * only: `livekit-client` is a peer dependency, and the core never imports it.
+ */
+import { Room, RoomEvent } from "livekit-client";
+import { HainivaAgentError } from "./errors.js";
+import { Redactor } from "./redact.js";
+import { assertSafeUrl } from "./url.js";
+/**
+ * Join with the call's media credentials, microphone on. The token is handed to
+ * LiveKit only; errors are redacted (LiveKit's own error text can contain its
+ * signalling URL, which carries the token).
+ */
+export async function joinCallRoom(join, o = {}) {
+    const redactor = o.redactor ?? new Redactor();
+    redactor.add(join.token);
+    assertSafeUrl(join.url, { kind: "ws", ...(o.allowInsecureLocalhost ? { allowInsecureLocalhost: true } : {}) });
+    if (!join.token)
+        throw new HainivaAgentError(0, "no_media_token");
+    const room = new Room(o.roomOptions);
+    try {
+        await room.connect(join.url, join.token, { autoSubscribe: true, ...o.connectOptions });
+        if (o.microphone !== false)
+            await room.localParticipant.setMicrophoneEnabled(true);
+    }
+    catch (e) {
+        await room.disconnect().catch(() => undefined);
+        throw HainivaAgentError.from(e, "media_connect_failed", redactor);
+    }
+    let left = false;
+    return {
+        room,
+        async setMuted(muted) {
+            try {
+                await room.localParticipant.setMicrophoneEnabled(!muted);
+            }
+            catch (e) {
+                throw HainivaAgentError.from(e, "media_mute_failed", redactor);
+            }
+        },
+        async leave() {
+            if (left)
+                return;
+            left = true;
+            await room.disconnect().catch(() => undefined);
+        },
+        onDisconnected(fn) {
+            const h = () => fn();
+            room.on(RoomEvent.Disconnected, h);
+            return () => { room.off(RoomEvent.Disconnected, h); };
+        },
+    };
+}
+//# sourceMappingURL=livekit.js.map

package/dist/esm/livekit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"livekit.js","sourceRoot":"","sources":["../../src/livekit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,SAAS,EAA6C,MAAM,gBAAgB,CAAC;AAE5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA4BzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAe,EAAE,IAAiB,EAAE;IACrE,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,IAAI,QAAQ,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/G,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,iBAAiB,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,CAAC,UAAU,KAAK,KAAK;YAAE,MAAM,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,KAAK,CAAC,CAAC;YAAC,CAAC;YACjE,OAAO,CAAC,EAAE,CAAC;gBAAC,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,mBAAmB,EAAE,QAAQ,CAAC,CAAC;YAAC,CAAC;QAC/E,CAAC;QACD,KAAK,CAAC,KAAK;YACT,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QACD,cAAc,CAAC,EAAE;YACf,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YACrB,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YACnC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/log.d.ts

@@ -0,0 +1,6 @@
+import { Redactor } from "./redact.js";
+/** The partner's logger. The SDK logs nothing unless one is given. */
+export type Logger = (event: string, detail?: unknown) => void;
+/** A logger that redacts every detail before the partner's logger sees it. */
+export declare function safeLogger(log: Logger | undefined, redactor?: Redactor): Logger;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,sEAAsE;AACtE,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE/D,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,QAAyB,GAAG,MAAM,CAO/F"}

package/dist/esm/log.js

@@ -0,0 +1,13 @@
+import { Redactor } from "./redact.js";
+/** A logger that redacts every detail before the partner's logger sees it. */
+export function safeLogger(log, redactor = new Redactor()) {
+    if (!log)
+        return () => { };
+    return (event, detail) => {
+        try {
+            log(redactor.string(event), detail === undefined ? undefined : redactor.value(detail));
+        }
+        catch { /* a broken logger must not break a call */ }
+    };
+}
+//# sourceMappingURL=log.js.map

package/dist/esm/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKvC,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,GAAuB,EAAE,WAAqB,IAAI,QAAQ,EAAE;IACrF,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC1B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACzF,CAAC;QAAC,MAAM,CAAC,CAAC,2CAA2C,CAAC,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/react-native.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @hainiva/agent-sdk/react-native — React Native adapters: the session in the
+ * Keychain / Android Keystore (expo-secure-store) and LiveKit call media.
+ *
+ * Call `registerGlobals()` from `@livekit/react-native` once at startup before
+ * joining a room. Native ringing (CallKit / Android call notification) is
+ * `@hainiva/react-native-call`.
+ */
+import type { SessionStore } from "./session.js";
+export { joinCallRoom, type JoinOptions, type MediaCall, type MediaJoin } from "./livekit.js";
+/** The part of `expo-secure-store` this adapter uses: pass the module itself. */
+export interface SecureStoreModule {
+    getItemAsync(key: string, options?: Record<string, unknown>): Promise<string | null>;
+    setItemAsync(key: string, value: string, options?: Record<string, unknown>): Promise<void>;
+    deleteItemAsync(key: string, options?: Record<string, unknown>): Promise<void>;
+    /** expo-secure-store's constant; used as the default accessibility. */
+    AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY?: unknown;
+}
+export interface SecureStoreSessionOptions {
+    /** Default "hainiva.agent.session". Letters, digits, ".", "-" and "_" only. */
+    key?: string;
+    /**
+     * iPhone Keychain accessibility. Default AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY:
+     * readable while the phone is locked (a call that wakes the app must find the
+     * session) and never migrated to another device.
+     */
+    keychainAccessible?: unknown;
+}
+/**
+ * The session (and so the refresh token) in secure storage only. There is
+ * deliberately no fallback to AsyncStorage or another plain store: if secure
+ * storage fails, the session stays in memory and the next launch signs in again
+ * with a fresh assertion.
+ *
+ *   import * as SecureStore from "expo-secure-store";
+ *   const store = secureStoreSessionStore(SecureStore);
+ */
+export declare function secureStoreSessionStore(secure: SecureStoreModule, o?: SecureStoreSessionOptions): SessionStore;
+export { HainivaDesk, deskBridgeScript, type HainivaDeskProps, type WebViewLike } from "./reactNativeDesk.js";
+//# sourceMappingURL=react-native.d.ts.map

package/dist/esm/react-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.d.ts","sourceRoot":"","sources":["../../src/react-native.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9F,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrF,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,uEAAuE;IACvE,mCAAmC,CAAC,EAAE,OAAO,CAAC;CAC/C;AAED,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,GAAE,yBAA8B,GAAG,YAAY,CAUlH;AAID,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/react-native.js

@@ -0,0 +1,26 @@
+export { joinCallRoom } from "./livekit.js";
+/**
+ * The session (and so the refresh token) in secure storage only. There is
+ * deliberately no fallback to AsyncStorage or another plain store: if secure
+ * storage fails, the session stays in memory and the next launch signs in again
+ * with a fresh assertion.
+ *
+ *   import * as SecureStore from "expo-secure-store";
+ *   const store = secureStoreSessionStore(SecureStore);
+ */
+export function secureStoreSessionStore(secure, o = {}) {
+    const key = o.key ?? "hainiva.agent.session";
+    if (!/^[A-Za-z0-9._-]+$/.test(key))
+        throw new Error("secureStoreSessionStore: key may use only letters, digits, '.', '-' and '_'");
+    const access = o.keychainAccessible ?? secure.AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY;
+    const opts = access === undefined ? {} : { keychainAccessible: access };
+    return {
+        get: () => secure.getItemAsync(key, opts),
+        set: (v) => secure.setItemAsync(key, v, opts),
+        remove: () => secure.deleteItemAsync(key, opts),
+    };
+}
+// The embedded HAINIVA desk in a WebView (react-native-webview, an optional
+// peer), signed in with your agent session; calls stay native in your app.
+export { HainivaDesk, deskBridgeScript } from "./reactNativeDesk.js";
+//# sourceMappingURL=react-native.js.map

package/dist/esm/react-native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-native.js","sourceRoot":"","sources":["../../src/react-native.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAoD,MAAM,cAAc,CAAC;AAsB9F;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAyB,EAAE,IAA+B,EAAE;IAClG,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,uBAAuB,CAAC;IAC7C,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACnI,MAAM,MAAM,GAAG,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC,mCAAmC,CAAC;IAClF,MAAM,IAAI,GAA4B,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IACjG,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC;QACzC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC;QAC7C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,2EAA2E;AAC3E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAA2C,MAAM,sBAAsB,CAAC"}

package/dist/esm/reactNativeDesk.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `<HainivaDesk/>` — the HAINIVA desk inside your React Native app.
+ *
+ *   import { WebView } from "react-native-webview";
+ *   import { HainivaDesk } from "@hainiva/agent-sdk/react-native";
+ *
+ *   <HainivaDesk agent={agent} appId={APP_ID} baseUrl="https://app.hainiva.com"
+ *     onDial={(number, contactId) => placeNativeCall(number, contactId)}
+ *     onEnded={(reason) => goToSignIn(reason)} />
+ *
+ * The split is the HAINIVA Agent app's: YOUR app rings and carries call audio
+ * natively (@hainiva/react-native-call + this SDK's CallStore); the desk shows
+ * the work and hands calls to you (`onDial`, `onDialer`).
+ *
+ * Security:
+ *   - `originWhitelist` and `onShouldStartLoadWithRequest` keep the WebView on
+ *     the HAINIVA desk origin; any other URL is refused there (and offered to
+ *     `onOpenUrl`, if you pass one);
+ *   - no window.open passthrough (`setSupportMultipleWindows={false}`,
+ *     `javaScriptCanOpenWindowsAutomatically={false}`);
+ *   - the bridge is installed before the desk's scripts and ONLY when the page
+ *     is on the desk origin; the desk token goes in by injectJavaScript, never
+ *     in the URL, and is not written to storage.
+ */
+import * as React from "react";
+import { type DeskCallbacks, type DeskTokenSource, type HostToDesk } from "./embed.js";
+/** The parts of react-native-webview's WebView this component uses. */
+export interface WebViewLike {
+    injectJavaScript(script: string): void;
+}
+type WebViewComponent = React.ComponentType<Record<string, unknown> & {
+    ref?: React.Ref<WebViewLike>;
+}>;
+export interface HainivaDeskProps extends DeskCallbacks {
+    agent: DeskTokenSource;
+    appId: string;
+    /** The HAINIVA desk, e.g. https://app.hainiva.com. */
+    baseUrl: string;
+    theme?: "light" | "dark";
+    locale?: "vi" | "en";
+    /** react-native-webview's WebView. Default: required from "react-native-webview". */
+    WebView?: WebViewComponent;
+    /** Passed to the WebView. */
+    style?: unknown;
+    /** Local development only (http://localhost desk). */
+    allowInsecureLocalhost?: boolean;
+}
+/** Runs before the desk's scripts, on the desk origin only: the partner-rn bridge the desk looks for. */
+export declare function deskBridgeScript(deskOrigin: string, appId: string): string;
+/** A message to the desk, as a script: JSON twice (a string literal of the JSON), nothing interpolated raw. */
+export declare function deliverScript(m: HostToDesk): string;
+export declare function HainivaDesk(props: HainivaDeskProps): React.ReactElement;
+export {};
+//# sourceMappingURL=reactNativeDesk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactNativeDesk.d.ts","sourceRoot":"","sources":["../../src/reactNativeDesk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1G,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AACD,KAAK,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC,CAAC;AAExG,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,yGAAyG;AACzG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEnD;AAWD,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,CA4DvE"}