@hainiva/agent-sdk 0.0.0-stage → 0.2.0

package/dist/esm/contract.d.ts

@@ -0,0 +1,216 @@
+/**
+ * GENERATED from the HAINIVA monorepo (@aicc/types agentApi.ts and
+ * agentEvents.ts) — do not edit by hand. The Agent API's response shapes and
+ * event names: additive changes only within a major version.
+ */
+export type AgentPresenceStatus = "online" | "busy" | "away" | "offline";
+export type AgentRole = "agent" | "supervisor";
+export interface AgentMeDto {
+    id: string;
+    externalId: string | null;
+    displayName: string | null;
+    role: AgentRole;
+    /** Team ids this member works in; null = the whole organisation. */
+    teams: string[] | null;
+    status: AgentPresenceStatus | null;
+    session: {
+        id: string;
+        agentAppId: string;
+        mode: "live" | "test";
+        expiresAt: string;
+    };
+}
+export interface AgentRingDto {
+    callId: string;
+    conversationId: string;
+    kind: "voice" | "video" | "chat";
+    channel: string;
+    contactName: string | null;
+    callerNumber: string | null;
+    /** direct = routed to you; queue = offered to your queue; escalation = a live call handed to you. */
+    path: "direct" | "queue" | "escalation";
+    startedAt: string;
+}
+export interface AgentCallDto {
+    callId: string;
+    conversationId: string;
+    kind: "voice" | "video" | "chat";
+    channel: string;
+    direction: "inbound" | "outbound" | "internal";
+    status: string;
+    assignedToMe: boolean;
+    startedAt: string;
+    endedAt: string | null;
+    contactName: string | null;
+    callerNumber: string | null;
+}
+export interface AgentMediaTokenDto {
+    token: string;
+    roomName: string;
+    livekitUrl: string;
+    expiresAt: string;
+}
+export interface AgentConversationDto {
+    id: string;
+    status: string;
+    subject: string | null;
+    channel: string | null;
+    chatType: string | null;
+    contact: {
+        id: string;
+        name: string | null;
+        phone: string | null;
+    };
+    assignedAgentId: string | null;
+    assignedToMe: boolean;
+    queueId: string | null;
+    /** The open interaction a message or file goes to (null when none is open). */
+    activeInteractionId: string | null;
+    lastMessageAt: string | null;
+    createdAt: string;
+    closedAt: string | null;
+}
+export interface AgentMessageDto {
+    id: string;
+    conversationId: string;
+    interactionId: string;
+    direction: string;
+    senderType: string;
+    /** agents.id of the sender when an agent wrote it. */
+    senderAgentId: string | null;
+    senderName: string | null;
+    type: string;
+    text: string | null;
+    attachment: {
+        name: string | null;
+        mimeType: string | null;
+        size: number | null;
+    } | null;
+    createdAt: string;
+}
+export interface AgentDispositionDto {
+    code: string;
+    label: string;
+    channel: string | null;
+    required: boolean;
+}
+export interface SupervisorLiveCallDto {
+    callId: string;
+    conversationId: string;
+    agentId: string | null;
+    agentName: string | null;
+    channel: string;
+    status: string;
+    startedAt: string;
+    contactName: string | null;
+    callerNumber: string | null;
+    queueId: string | null;
+}
+export interface SupervisorAgentDto {
+    id: string;
+    displayName: string;
+    externalId: string | null;
+    role: AgentRole;
+    teamId: string | null;
+    status: AgentPresenceStatus;
+    activeCalls: number;
+    openConversations: number;
+}
+export interface AgentPage<T> {
+    data: T[];
+    nextCursor: string | null;
+}
+/** POST /agent/v1/sessions (201) and POST /agent/v1/sessions/refresh (200). */
+export interface AgentSessionDto {
+    accessToken: string;
+    accessExpiresAt: string;
+    /** hnv_rt_…, rotating: each refresh answers a new one and the old one stops working. */
+    refreshToken: string;
+    refreshExpiresAt: string;
+    sessionId: string;
+    member: {
+        id: string;
+        externalId: string | null;
+        displayName: string;
+        role: AgentRole;
+    };
+    app: {
+        id: string;
+        name: string;
+        mode: "live" | "test";
+    };
+    /** The event socket on the host the app reached; SDKs derive their own from their base URL. */
+    wsUrl: string;
+}
+/** POST /agent/v1/calls/:id/accept. `media` is null for a call without a room (chat). */
+export interface AgentAcceptDto {
+    callId: string;
+    accepted: true;
+    media: AgentMediaTokenDto | null;
+}
+/** POST /agent/v1/supervisor/calls/:id/supervise. */
+export interface SupervisorSuperviseDto {
+    callId: string;
+    mode: "monitor" | "whisper" | "barge";
+    media: AgentMediaTokenDto;
+}
+/** POST /agent/v1/push/subscriptions body. */
+export interface AgentPushSubscriptionInput {
+    platform: "ios" | "android";
+    /** FCM registration token (Android) or APNs device token, hex (iPhone). */
+    token: string;
+    /** voip = rings (PushKit on iPhone, high-priority data on Android); alert = ordinary notices. */
+    kind: "voip" | "alert";
+    /** Must be one of the agent app's allowedBundleIds. */
+    bundleId: string;
+    /** A stable id for this install: a new token from the same install replaces the old one. */
+    deviceId?: string;
+}
+/** POST /agent/v1/push/subscriptions (201). The token is never echoed. */
+export interface AgentPushSubscriptionDto {
+    id: string;
+    platform: "ios" | "android";
+    kind: "voip" | "alert";
+    bundleId: string;
+    /** Whether the agent app has working push credentials for this platform right now. */
+    deliverable: boolean;
+    createdAt: string;
+}
+/** Event data of the stream's call.ringing. */
+export interface AgentCallRingingData {
+    callId: string;
+    conversationId: string;
+    path: "direct" | "queue" | "transfer";
+    channel?: string | null;
+    line?: string | null;
+    contactName: string | null;
+    callerNumber?: string | null;
+    fromAgentId?: string | null;
+    fromAgentName?: string | null;
+    transferMode?: "warm" | "blind";
+    /** ISO time the ring ends, when the server knows it. */
+    expiresAt: string | null;
+}
+/** Event data of the stream's call.ended. callId is null when only the conversation is known. */
+export interface AgentCallEndedData {
+    callId: string | null;
+    conversationId: string | null;
+    reason: "ended" | "failed" | "answered_elsewhere" | "declined" | "expired" | "transfer_ended";
+    answeredBy?: string | null;
+    failure?: {
+        reason: string;
+    };
+}
+export declare const AGENT_EVENT_NAMES: readonly ["call.ringing", "call.ended", "conversation.assigned", "message.created", "wrapup.required", "presence.changed", "supervisor.alert"];
+export type AgentEventName = (typeof AGENT_EVENT_NAMES)[number];
+export interface AgentEvent {
+    event: AgentEventName;
+    data: Record<string, unknown>;
+}
+/** What the stream delivers: the event plus its position (resume from it). */
+export interface AgentStreamFrame extends AgentEvent {
+    type: "event";
+    seq: number;
+    at: string;
+}
+//# sourceMappingURL=contract.d.ts.map

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

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

package/dist/esm/contract.js

@@ -0,0 +1,12 @@
+/**
+ * GENERATED from the HAINIVA monorepo (@aicc/types agentApi.ts and
+ * agentEvents.ts) — do not edit by hand. The Agent API's response shapes and
+ * event names: additive changes only within a major version.
+ */
+/* eslint-disable */
+// ── The event stream (/agent/v1/ws) ──────────────────────────────────────────
+export const AGENT_EVENT_NAMES = [
+    "call.ringing", "call.ended", "conversation.assigned", "message.created",
+    "wrapup.required", "presence.changed", "supervisor.alert",
+];
+//# sourceMappingURL=contract.js.map

package/dist/esm/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/contract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAoB;AA+KpB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc,EAAE,YAAY,EAAE,uBAAuB,EAAE,iBAAiB;IACxE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB;CACjD,CAAC"}

package/dist/esm/embed.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @hainiva/agent-sdk/embed — the embeddable HAINIVA desk (iframe / WebView with a
+ * postMessage bridge). Planned for milestone M3; not part of this release.
+ */
+export interface MountDeskOptions {
+    container: unknown;
+    getAccessToken: () => Promise<string>;
+}
+export interface MountedDesk {
+    destroy(): void;
+}
+/** Not yet available: throws. */
+export declare function mountDesk(_options?: MountDeskOptions): MountedDesk;
+//# sourceMappingURL=embed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/embed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,WAAW,CAElE"}

package/dist/esm/embed.js

@@ -0,0 +1,9 @@
+/**
+ * @hainiva/agent-sdk/embed — the embeddable HAINIVA desk (iframe / WebView with a
+ * postMessage bridge). Planned for milestone M3; not part of this release.
+ */
+/** Not yet available: throws. */
+export function mountDesk(_options) {
+    throw new Error("@hainiva/agent-sdk/embed is not yet available");
+}
+//# sourceMappingURL=embed.js.map

package/dist/esm/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/embed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,iCAAiC;AACjC,MAAM,UAAU,SAAS,CAAC,QAA2B;IACnD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACnE,CAAC"}

package/dist/esm/emitter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A small typed event emitter. `Events` maps each event name to its payload:
+ *
+ *   const e = new TypedEmitter<{ state: ConnectionState; ready: undefined }>();
+ *   const off = e.on("state", (s) => …);   e.emit("state", "open");   e.emit("ready", undefined);
+ *
+ * A listener that throws does not stop the others; the error goes to `onError`.
+ */
+export declare class TypedEmitter<Events extends {
+    [K in keyof Events]: unknown;
+}> {
+    private readonly onError?;
+    private readonly listeners;
+    constructor(onError?: ((error: unknown, event: keyof Events) => void) | undefined);
+    on<K extends keyof Events>(event: K, fn: (payload: Events[K]) => void): () => void;
+    once<K extends keyof Events>(event: K, fn: (payload: Events[K]) => void): () => void;
+    /** Remove a listener added with on(). (A once() listener is removed by the function once() returned.) */
+    off<K extends keyof Events>(event: K, fn: (payload: Events[K]) => void): void;
+    emit<K extends keyof Events>(event: K, payload: Events[K]): void;
+    listenerCount(event: keyof Events): number;
+    removeAll(): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/emitter.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,qBAAa,YAAY,CAAC,MAAM,SAAS;KAAG,CAAC,IAAI,MAAM,MAAM,GAAG,OAAO;CAAE;IAG3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAFrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;gBAEvC,OAAO,CAAC,GAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,KAAK,IAAI,aAAA;IAEpF,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlF,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAKpF,yGAAyG;IACzG,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAI7E,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAShE,aAAa,CAAC,KAAK,EAAE,MAAM,MAAM,GAAG,MAAM;IAE1C,SAAS,IAAI,IAAI;CAClB"}

package/dist/esm/emitter.js

@@ -0,0 +1,47 @@
+/**
+ * A small typed event emitter. `Events` maps each event name to its payload:
+ *
+ *   const e = new TypedEmitter<{ state: ConnectionState; ready: undefined }>();
+ *   const off = e.on("state", (s) => …);   e.emit("state", "open");   e.emit("ready", undefined);
+ *
+ * A listener that throws does not stop the others; the error goes to `onError`.
+ */
+export class TypedEmitter {
+    constructor(onError) {
+        this.onError = onError;
+        this.listeners = new Map();
+    }
+    on(event, fn) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(fn);
+        return () => this.off(event, fn);
+    }
+    once(event, fn) {
+        const off = this.on(event, (p) => { off(); fn(p); });
+        return off;
+    }
+    /** Remove a listener added with on(). (A once() listener is removed by the function once() returned.) */
+    off(event, fn) {
+        this.listeners.get(event)?.delete(fn);
+    }
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        for (const fn of [...set]) {
+            try {
+                fn(payload);
+            }
+            catch (e) {
+                this.onError?.(e, event);
+            }
+        }
+    }
+    listenerCount(event) { return this.listeners.get(event)?.size ?? 0; }
+    removeAll() { this.listeners.clear(); }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/esm/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/emitter.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IAGvB,YAA6B,OAAuD;QAAvD,YAAO,GAAP,OAAO,CAAgD;QAFnE,cAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEmB,CAAC;IAExF,EAAE,CAAyB,KAAQ,EAAE,EAAgC;QACnE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAAC,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,EAAc,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,EAAgC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yGAAyG;IACzG,GAAG,CAAyB,KAAQ,EAAE,EAAgC;QACpE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAc,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,OAAkB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAAC,CAAC;YACpB,OAAO,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,aAAa,CAAC,KAAmB,IAAY,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3F,SAAS,KAAW,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;CAC9C"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,16 @@
+import { Redactor } from "./redact.js";
+/**
+ * Every error the SDK raises. The message is only `status code`, and the body is
+ * redacted when the error is made: a partner who logs errors (or sends them to a
+ * crash reporter) never ships a token with them.
+ */
+export declare class HainivaAgentError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly body: Record<string, unknown>;
+    /** status 0 = raised by the SDK itself (configuration, network), not by HAINIVA. */
+    constructor(status: number, code: string, body?: Record<string, unknown>, redactor?: Redactor);
+    /** Wrap anything thrown below the SDK (fetch, WebSocket, LiveKit) without carrying its secrets along. */
+    static from(e: unknown, code?: string, redactor?: Redactor): HainivaAgentError;
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA6B,MAAM,aAAa,CAAC;AAElE;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC,oFAAoF;gBACxE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IASjG,yGAAyG;IACzG,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,SAAW,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,iBAAiB;CAKjF"}

package/dist/esm/errors.js

@@ -0,0 +1,25 @@
+import { redactString, redactValue } from "./redact.js";
+/**
+ * Every error the SDK raises. The message is only `status code`, and the body is
+ * redacted when the error is made: a partner who logs errors (or sends them to a
+ * crash reporter) never ships a token with them.
+ */
+export class HainivaAgentError extends Error {
+    /** status 0 = raised by the SDK itself (configuration, network), not by HAINIVA. */
+    constructor(status, code, body = {}, redactor) {
+        const c = redactor ? redactor.string(code) : redactString(code);
+        super(`${status} ${c}`);
+        this.name = "HainivaAgentError";
+        this.status = status;
+        this.code = c;
+        this.body = (redactor ? redactor.value(body) : redactValue(body));
+    }
+    /** Wrap anything thrown below the SDK (fetch, WebSocket, LiveKit) without carrying its secrets along. */
+    static from(e, code = "failed", redactor) {
+        if (e instanceof HainivaAgentError)
+            return e;
+        const message = e instanceof Error ? e.message : String(e);
+        return new HainivaAgentError(0, code, { cause: message }, redactor);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAElE;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAK1C,oFAAoF;IACpF,YAAY,MAAc,EAAE,IAAY,EAAE,OAAgC,EAAE,EAAE,QAAmB;QAC/F,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAChE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAA4B,CAAC;IAC/F,CAAC;IAED,yGAAyG;IACzG,MAAM,CAAC,IAAI,CAAC,CAAU,EAAE,IAAI,GAAG,QAAQ,EAAE,QAAmB;QAC1D,IAAI,CAAC,YAAY,iBAAiB;YAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,IAAI,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtE,CAAC;CACF"}

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
+ *   "@hainiva/agent-sdk/embed"        the embeddable desk (not yet available)
+ *
+ * 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.2.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