@pinecall/chat-core 0.1.0 → 0.1.1

package/dist/{chunk-ST5DVE5W.js → chunk-A2FCWUQW.js}

@@ -69,14 +69,24 @@ var ChatSession = class extends EventTarget {
         /\/$/,
         ""
       );
-      const tRes = await fetch(
-        `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`
-      );
-      if (!tRes.ok) {
-        const body = await tRes.text();
-        throw new Error(`Token: ${tRes.status} ${body}`);
+      let token;
+      let chatServer;
+      if (this.opts.tokenProvider) {
+        const t = await this.opts.tokenProvider();
+        token = t.token;
+        chatServer = t.server;
+      } else {
+        const tRes = await fetch(
+          `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`
+        );
+        if (!tRes.ok) {
+          const body = await tRes.text();
+          throw new Error(`Token: ${tRes.status} ${body}`);
+        }
+        const t = await tRes.json();
+        token = t.token;
+        chatServer = t.server;
       }
-      const { token, server: chatServer } = await tRes.json();
       const wsBase = (chatServer || base).replace(/^http:/, "ws:").replace(/^https:/, "wss:");
       const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);
       this.ws = ws;
@@ -233,5 +243,5 @@ var ChatSession = class extends EventTarget {
 };
 
 export { ChatSession };
-//# sourceMappingURL=chunk-ST5DVE5W.js.map
-//# sourceMappingURL=chunk-ST5DVE5W.js.map
+//# sourceMappingURL=chunk-A2FCWUQW.js.map
+//# sourceMappingURL=chunk-A2FCWUQW.js.map

package/dist/chunk-A2FCWUQW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ChatSession.ts"],"names":[],"mappings":"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","file":"chunk-A2FCWUQW.js","sourcesContent":["/**\n * ChatSession — Framework-agnostic text chat client for Pinecall agents.\n *\n * Mirrors VoiceSession's API patterns:\n *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore\n *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)\n *\n * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat\n */\nimport type {\n  ChatSessionState,\n  ChatSessionOptions,\n  ChatMessage,\n} from \"./types\";\n\nconst INITIAL_STATE: ChatSessionState = {\n  status: \"idle\",\n  error: null,\n  messages: [],\n  typing: false,\n  streamingText: \"\",\n  sessionId: null,\n};\n\nexport class ChatSession extends EventTarget {\n  private state: ChatSessionState = { ...INITIAL_STATE };\n  private listeners = new Set<() => void>();\n\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private msgCounter = 0;\n\n  constructor(private opts: ChatSessionOptions) {\n    super();\n  }\n\n  /** Read-only snapshot of current state (stable ref until next mutation). */\n  getState(): Readonly<ChatSessionState> {\n    return this.state;\n  }\n\n  /** Subscribe to ANY state change (for React useSyncExternalStore). */\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private setState(patch: Partial<ChatSessionState>): void {\n    const prev = this.state;\n    this.state = { ...prev, ...patch };\n    for (const l of this.listeners) l();\n\n    if (patch.status !== undefined && patch.status !== prev.status) {\n      this.dispatchEvent(\n        new CustomEvent(\"status\", { detail: { status: this.state.status } }),\n      );\n    }\n    if (\n      patch.error !== undefined &&\n      patch.error !== null &&\n      patch.error !== prev.error\n    ) {\n      this.dispatchEvent(\n        new CustomEvent(\"error\", { detail: { error: this.state.error } }),\n      );\n    }\n    this.dispatchEvent(\n      new CustomEvent(\"change\", { detail: { state: this.state } }),\n    );\n  }\n\n  private setMessages(\n    updater: (prev: ChatMessage[]) => ChatMessage[],\n  ): void {\n    const next = updater(this.state.messages);\n    this.setState({ messages: next });\n    const last = next[next.length - 1];\n    if (last) {\n      this.dispatchEvent(\n        new CustomEvent(\"message\", { detail: { message: last } }),\n      );\n    }\n  }\n\n  // ── Connection ──────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.ws) return;\n\n    try {\n      this.setState({\n        status: \"connecting\",\n        error: null,\n      });\n\n      const base = (this.opts.server ?? \"https://voice.pinecall.io\").replace(\n        /\\/$/,\n        \"\",\n      );\n\n      // 1. Fetch chat token — use tokenProvider (backend proxy) or direct fetch\n      let token: string;\n      let chatServer: string;\n      if (this.opts.tokenProvider) {\n        const t = await this.opts.tokenProvider();\n        token = t.token;\n        chatServer = t.server;\n      } else {\n        const tRes = await fetch(\n          `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`,\n        );\n        if (!tRes.ok) {\n          const body = await tRes.text();\n          throw new Error(`Token: ${tRes.status} ${body}`);\n        }\n        const t = await tRes.json();\n        token = t.token;\n        chatServer = t.server;\n      }\n      const wsBase = (chatServer || base)\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\");\n\n      // 2. Open WebSocket\n      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);\n      this.ws = ws;\n\n      ws.onopen = () => {\n        // Wait for chat.connected event before setting status\n      };\n\n      ws.onmessage = (evt) => this.handleMessage(evt);\n\n      ws.onerror = () => {\n        this.setState({ error: \"WebSocket error\", status: \"error\" });\n      };\n\n      ws.onclose = (evt) => {\n        this.ws = null;\n        if (this.state.status === \"connected\") {\n          // Unexpected disconnect\n          this.setState({ status: \"idle\" });\n        }\n      };\n    } catch (err) {\n      this.setState({\n        error: err instanceof Error ? err.message : String(err),\n        status: \"error\",\n      });\n      this.ws = null;\n    }\n  }\n\n  private handleMessage(evt: MessageEvent): void {\n    let d: any;\n    try {\n      d = JSON.parse(evt.data);\n    } catch {\n      return;\n    }\n\n    switch (d.event) {\n      case \"chat.connected\":\n        this.setState({\n          status: \"connected\",\n          sessionId: d.session_id ?? null,\n        });\n        break;\n\n      case \"chat.token\":\n      case \"llm.chat.token\":\n        // Streaming token from LLM\n        this.setState({\n          typing: true,\n          streamingText: d.text ?? \"\",\n        });\n\n        // Update or create bot message\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx ? { ...m, text: d.text ?? \"\" } : m,\n            );\n          }\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: true,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.done\":\n      case \"llm.chat.done\":\n        // LLM finished streaming\n        this.setState({\n          typing: false,\n          streamingText: \"\",\n        });\n\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx\n                ? { ...m, text: d.text ?? m.text, isStreaming: false }\n                : m,\n            );\n          }\n          // If we missed the streaming, add the final message\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: false,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.error\":\n      case \"llm.chat.error\":\n        this.setState({\n          typing: false,\n          error: d.error ?? \"Unknown error\",\n        });\n        break;\n\n      case \"error\":\n        this.setState({\n          error: d.error ?? \"Unknown error\",\n          status: \"error\",\n        });\n        break;\n    }\n\n    // Emit raw event for power users\n    this.dispatchEvent(new CustomEvent(\"event\", { detail: d }));\n  }\n\n  // ── Actions ─────────────────────────────────────────────────────────\n\n  /** Send a text message to the agent. */\n  send(text: string): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n\n    const trimmed = text.trim();\n    if (!trimmed) return;\n\n    // Add user message to local state immediately\n    this.setMessages((prev) => [\n      ...prev,\n      {\n        id: ++this.msgCounter,\n        role: \"user\",\n        text: trimmed,\n      },\n    ]);\n\n    // Send to server\n    this.ws.send(JSON.stringify({ event: \"message\", text: trimmed }));\n  }\n\n  /**\n   * Set or clear a keyed context block in the LLM system prompt.\n   *\n   * @example\n   * ```ts\n   * session.setContext(\"form\", JSON.stringify({ name: \"Juan\" }));\n   * session.setContext(\"form\", null); // clear\n   * ```\n   */\n  setContext(key: string, value: string | null): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.ws.send(JSON.stringify({ event: \"set_context\", key, value }));\n  }\n\n  /** Disconnect the chat session. */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n    this.setState({ status: \"idle\", typing: false, streamingText: \"\" });\n  }\n\n  /** Tear down the session and clear subscribers. Do not reuse after this. */\n  destroy(): void {\n    this.disconnect();\n    this.listeners.clear();\n  }\n}\n"]}

package/dist/index.cjs

@@ -71,14 +71,24 @@ var ChatSession = class extends EventTarget {
         /\/$/,
         ""
       );
-      const tRes = await fetch(
-        `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`
-      );
-      if (!tRes.ok) {
-        const body = await tRes.text();
-        throw new Error(`Token: ${tRes.status} ${body}`);
+      let token;
+      let chatServer;
+      if (this.opts.tokenProvider) {
+        const t = await this.opts.tokenProvider();
+        token = t.token;
+        chatServer = t.server;
+      } else {
+        const tRes = await fetch(
+          `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`
+        );
+        if (!tRes.ok) {
+          const body = await tRes.text();
+          throw new Error(`Token: ${tRes.status} ${body}`);
+        }
+        const t = await tRes.json();
+        token = t.token;
+        chatServer = t.server;
       }
-      const { token, server: chatServer } = await tRes.json();
       const wsBase = (chatServer || base).replace(/^http:/, "ws:").replace(/^https:/, "wss:");
       const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);
       this.ws = ws;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ChatSession.ts"],"names":[],"mappings":";;;AAeA,IAAM,aAAA,GAAkC;AAAA,EACtC,MAAA,EAAQ,MAAA;AAAA,EACR,KAAA,EAAO,IAAA;AAAA,EACP,UAAU,EAAC;AAAA,EACX,MAAA,EAAQ,KAAA;AAAA,EACR,aAAA,EAAe,EAAA;AAAA,EACf,SAAA,EAAW;AACb,CAAA;AAEO,IAAM,WAAA,GAAN,cAA0B,WAAA,CAAY;AAAA,EAQ3C,YAAoB,IAAA,EAA0B;AAC5C,IAAA,KAAA,EAAM;AADY,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAEpB;AAAA,EAFoB,IAAA;AAAA,EAPZ,KAAA,GAA0B,EAAE,GAAG,aAAA,EAAc;AAAA,EAC7C,SAAA,uBAAgB,GAAA,EAAgB;AAAA,EAEhC,EAAA,GAAuB,IAAA;AAAA,EACvB,cAAA,GAAuD,IAAA;AAAA,EACvD,UAAA,GAAa,CAAA;AAAA;AAAA,EAOrB,QAAA,GAAuC;AACrC,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,EACd;AAAA;AAAA,EAGA,UAAU,QAAA,EAAkC;AAC1C,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAQ,CAAA;AAC3B,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,EACF;AAAA,EAEQ,SAAS,KAAA,EAAwC;AACvD,IAAA,MAAM,OAAO,IAAA,CAAK,KAAA;AAClB,IAAA,IAAA,CAAK,KAAA,GAAQ,EAAE,GAAG,IAAA,EAAM,GAAG,KAAA,EAAM;AACjC,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,SAAA,EAAW,CAAA,EAAE;AAElC,IAAA,IAAI,MAAM,MAAA,KAAW,MAAA,IAAa,KAAA,CAAM,MAAA,KAAW,KAAK,MAAA,EAAQ;AAC9D,MAAA,IAAA,CAAK,aAAA;AAAA,QACH,IAAI,WAAA,CAAY,QAAA,EAAU,EAAE,MAAA,EAAQ,EAAE,MAAA,EAAQ,IAAA,CAAK,KAAA,CAAM,MAAA,EAAO,EAAG;AAAA,OACrE;AAAA,IACF;AACA,IAAA,IACE,KAAA,CAAM,UAAU,MAAA,IAChB,KAAA,CAAM,UAAU,IAAA,IAChB,KAAA,CAAM,KAAA,KAAU,IAAA,CAAK,KAAA,EACrB;AACA,MAAA,IAAA,CAAK,aAAA;AAAA,QACH,IAAI,WAAA,CAAY,OAAA,EAAS,EAAE,MAAA,EAAQ,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,CAAM,KAAA,EAAM,EAAG;AAAA,OAClE;AAAA,IACF;AACA,IAAA,IAAA,CAAK,aAAA;AAAA,MACH,IAAI,WAAA,CAAY,QAAA,EAAU,EAAE,MAAA,EAAQ,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAM,EAAG;AAAA,KAC7D;AAAA,EACF;AAAA,EAEQ,YACN,OAAA,EACM;AACN,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,QAAQ,CAAA;AACxC,IAAA,IAAA,CAAK,QAAA,CAAS,EAAE,QAAA,EAAU,IAAA,EAAM,CAAA;AAChC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,MAAA,GAAS,CAAC,CAAA;AACjC,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,IAAA,CAAK,aAAA;AAAA,QACH,IAAI,YAAY,SAAA,EAAW,EAAE,QAAQ,EAAE,OAAA,EAAS,IAAA,EAAK,EAAG;AAAA,OAC1D;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,MAAM,OAAA,GAAyB;AAC7B,IAAA,IAAI,KAAK,EAAA,EAAI;AAEb,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,QAAA,CAAS;AAAA,QACZ,MAAA,EAAQ,YAAA;AAAA,QACR,KAAA,EAAO;AAAA,OACR,CAAA;AAED,MAAA,MAAM,IAAA,GAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,IAAU,2BAAA,EAA6B,OAAA;AAAA,QAC7D,KAAA;AAAA,QACA;AAAA,OACF;AAGA,MAAA,MAAM,OAAO,MAAM,KAAA;AAAA,QACjB,GAAG,IAAI,CAAA,qBAAA,EAAwB,mBAAmB,IAAA,CAAK,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,OACpE;AACA,MAAA,IAAI,CAAC,KAAK,EAAA,EAAI;AACZ,QAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,IAAA,EAAK;AAC7B,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,OAAA,EAAU,KAAK,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE,CAAA;AAAA,MACjD;AACA,MAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,YAAW,GAAI,MAAM,KAAK,IAAA,EAAK;AACtD,MAAA,MAAM,MAAA,GAAA,CAAU,cAAc,IAAA,EAC3B,OAAA,CAAQ,UAAU,KAAK,CAAA,CACvB,OAAA,CAAQ,SAAA,EAAW,MAAM,CAAA;AAG5B,MAAA,MAAM,KAAK,IAAI,SAAA,CAAU,GAAG,MAAM,CAAA,eAAA,EAAkB,KAAK,CAAA,CAAE,CAAA;AAC3D,MAAA,IAAA,CAAK,EAAA,GAAK,EAAA;AAEV,MAAA,EAAA,CAAG,SAAS,MAAM;AAAA,MAElB,CAAA;AAEA,MAAA,EAAA,CAAG,SAAA,GAAY,CAAC,GAAA,KAAQ,IAAA,CAAK,cAAc,GAAG,CAAA;AAE9C,MAAA,EAAA,CAAG,UAAU,MAAM;AACjB,QAAA,IAAA,CAAK,SAAS,EAAE,KAAA,EAAO,iBAAA,EAAmB,MAAA,EAAQ,SAAS,CAAA;AAAA,MAC7D,CAAA;AAEA,MAAA,EAAA,CAAG,OAAA,GAAU,CAAC,GAAA,KAAQ;AACpB,QAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AACV,QAAA,IAAI,IAAA,CAAK,KAAA,CAAM,MAAA,KAAW,WAAA,EAAa;AAErC,UAAA,IAAA,CAAK,QAAA,CAAS,EAAE,MAAA,EAAQ,MAAA,EAAQ,CAAA;AAAA,QAClC;AAAA,MACF,CAAA;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,IAAA,CAAK,QAAA,CAAS;AAAA,QACZ,OAAO,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAAA,QACtD,MAAA,EAAQ;AAAA,OACT,CAAA;AACD,MAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AAAA,IACZ;AAAA,EACF;AAAA,EAEQ,cAAc,GAAA,EAAyB;AAC7C,IAAA,IAAI,CAAA;AACJ,IAAA,IAAI;AACF,MAAA,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAAA,IACzB,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AAEA,IAAA,QAAQ,EAAE,KAAA;AAAO,MACf,KAAK,gBAAA;AACH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,WAAA;AAAA,UACR,SAAA,EAAW,EAAE,UAAA,IAAc;AAAA,SAC5B,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,YAAA;AAAA,MACL,KAAK,gBAAA;AAEH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,IAAA;AAAA,UACR,aAAA,EAAe,EAAE,IAAA,IAAQ;AAAA,SAC1B,CAAA;AAGD,QAAA,IAAA,CAAK,WAAA,CAAY,CAAC,IAAA,KAAS;AACzB,UAAA,MAAM,MAAM,IAAA,CAAK,SAAA;AAAA,YACf,CAAC,CAAA,KAAM,CAAA,CAAE,SAAA,KAAc,CAAA,CAAE,cAAc,CAAA,CAAE;AAAA,WAC3C;AACA,UAAA,IAAI,OAAO,CAAA,EAAG;AACZ,YAAA,OAAO,IAAA,CAAK,GAAA;AAAA,cAAI,CAAC,CAAA,EAAG,CAAA,KAClB,CAAA,KAAM,GAAA,GAAM,EAAE,GAAG,CAAA,EAAG,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,EAAA,EAAG,GAAI;AAAA,aAC7C;AAAA,UACF;AACA,UAAA,OAAO;AAAA,YACL,GAAG,IAAA;AAAA,YACH;AAAA,cACE,EAAA,EAAI,EAAE,IAAA,CAAK,UAAA;AAAA,cACX,IAAA,EAAM,KAAA;AAAA,cACN,IAAA,EAAM,EAAE,IAAA,IAAQ,EAAA;AAAA,cAChB,WAAW,CAAA,CAAE,UAAA;AAAA,cACb,WAAA,EAAa;AAAA;AACf,WACF;AAAA,QACF,CAAC,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,WAAA;AAAA,MACL,KAAK,eAAA;AAEH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,KAAA;AAAA,UACR,aAAA,EAAe;AAAA,SAChB,CAAA;AAED,QAAA,IAAA,CAAK,WAAA,CAAY,CAAC,IAAA,KAAS;AACzB,UAAA,MAAM,MAAM,IAAA,CAAK,SAAA;AAAA,YACf,CAAC,CAAA,KAAM,CAAA,CAAE,SAAA,KAAc,CAAA,CAAE,cAAc,CAAA,CAAE;AAAA,WAC3C;AACA,UAAA,IAAI,OAAO,CAAA,EAAG;AACZ,YAAA,OAAO,IAAA,CAAK,GAAA;AAAA,cAAI,CAAC,CAAA,EAAG,CAAA,KAClB,CAAA,KAAM,MACF,EAAE,GAAG,CAAA,EAAG,IAAA,EAAM,EAAE,IAAA,IAAQ,CAAA,CAAE,IAAA,EAAM,WAAA,EAAa,OAAM,GACnD;AAAA,aACN;AAAA,UACF;AAEA,UAAA,OAAO;AAAA,YACL,GAAG,IAAA;AAAA,YACH;AAAA,cACE,EAAA,EAAI,EAAE,IAAA,CAAK,UAAA;AAAA,cACX,IAAA,EAAM,KAAA;AAAA,cACN,IAAA,EAAM,EAAE,IAAA,IAAQ,EAAA;AAAA,cAChB,WAAW,CAAA,CAAE,UAAA;AAAA,cACb,WAAA,EAAa;AAAA;AACf,WACF;AAAA,QACF,CAAC,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,YAAA;AAAA,MACL,KAAK,gBAAA;AACH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,KAAA;AAAA,UACR,KAAA,EAAO,EAAE,KAAA,IAAS;AAAA,SACnB,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,OAAA;AACH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,KAAA,EAAO,EAAE,KAAA,IAAS,eAAA;AAAA,UAClB,MAAA,EAAQ;AAAA,SACT,CAAA;AACD,QAAA;AAAA;AAIJ,IAAA,IAAA,CAAK,aAAA,CAAc,IAAI,WAAA,CAAY,OAAA,EAAS,EAAE,MAAA,EAAQ,CAAA,EAAG,CAAC,CAAA;AAAA,EAC5D;AAAA;AAAA;AAAA,EAKA,KAAK,IAAA,EAAoB;AACvB,IAAA,IAAI,CAAC,IAAA,CAAK,EAAA,IAAM,KAAK,EAAA,CAAG,UAAA,KAAe,UAAU,IAAA,EAAM;AAEvD,IAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,IAAA,IAAI,CAAC,OAAA,EAAS;AAGd,IAAA,IAAA,CAAK,WAAA,CAAY,CAAC,IAAA,KAAS;AAAA,MACzB,GAAG,IAAA;AAAA,MACH;AAAA,QACE,EAAA,EAAI,EAAE,IAAA,CAAK,UAAA;AAAA,QACX,IAAA,EAAM,MAAA;AAAA,QACN,IAAA,EAAM;AAAA;AACR,KACD,CAAA;AAGD,IAAA,IAAA,CAAK,EAAA,CAAG,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,SAAA,EAAW,IAAA,EAAM,OAAA,EAAS,CAAC,CAAA;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,UAAA,CAAW,KAAa,KAAA,EAA4B;AAClD,IAAA,IAAI,CAAC,IAAA,CAAK,EAAA,IAAM,KAAK,EAAA,CAAG,UAAA,KAAe,UAAU,IAAA,EAAM;AACvD,IAAA,IAAA,CAAK,EAAA,CAAG,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,aAAA,EAAe,GAAA,EAAK,KAAA,EAAO,CAAC,CAAA;AAAA,EACnE;AAAA;AAAA,EAGA,UAAA,GAAmB;AACjB,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,YAAA,CAAa,KAAK,cAAc,CAAA;AAChC,MAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AAAA,IACxB;AACA,IAAA,IAAI,KAAK,EAAA,EAAI;AACX,MAAA,IAAA,CAAK,GAAG,KAAA,EAAM;AACd,MAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AAAA,IACZ;AACA,IAAA,IAAA,CAAK,QAAA,CAAS,EAAE,MAAA,EAAQ,MAAA,EAAQ,QAAQ,KAAA,EAAO,aAAA,EAAe,IAAI,CAAA;AAAA,EACpE;AAAA;AAAA,EAGA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,UAAA,EAAW;AAChB,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AACF","file":"index.cjs","sourcesContent":["/**\n * ChatSession — Framework-agnostic text chat client for Pinecall agents.\n *\n * Mirrors VoiceSession's API patterns:\n *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore\n *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)\n *\n * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat\n */\nimport type {\n  ChatSessionState,\n  ChatSessionOptions,\n  ChatMessage,\n} from \"./types\";\n\nconst INITIAL_STATE: ChatSessionState = {\n  status: \"idle\",\n  error: null,\n  messages: [],\n  typing: false,\n  streamingText: \"\",\n  sessionId: null,\n};\n\nexport class ChatSession extends EventTarget {\n  private state: ChatSessionState = { ...INITIAL_STATE };\n  private listeners = new Set<() => void>();\n\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private msgCounter = 0;\n\n  constructor(private opts: ChatSessionOptions) {\n    super();\n  }\n\n  /** Read-only snapshot of current state (stable ref until next mutation). */\n  getState(): Readonly<ChatSessionState> {\n    return this.state;\n  }\n\n  /** Subscribe to ANY state change (for React useSyncExternalStore). */\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private setState(patch: Partial<ChatSessionState>): void {\n    const prev = this.state;\n    this.state = { ...prev, ...patch };\n    for (const l of this.listeners) l();\n\n    if (patch.status !== undefined && patch.status !== prev.status) {\n      this.dispatchEvent(\n        new CustomEvent(\"status\", { detail: { status: this.state.status } }),\n      );\n    }\n    if (\n      patch.error !== undefined &&\n      patch.error !== null &&\n      patch.error !== prev.error\n    ) {\n      this.dispatchEvent(\n        new CustomEvent(\"error\", { detail: { error: this.state.error } }),\n      );\n    }\n    this.dispatchEvent(\n      new CustomEvent(\"change\", { detail: { state: this.state } }),\n    );\n  }\n\n  private setMessages(\n    updater: (prev: ChatMessage[]) => ChatMessage[],\n  ): void {\n    const next = updater(this.state.messages);\n    this.setState({ messages: next });\n    const last = next[next.length - 1];\n    if (last) {\n      this.dispatchEvent(\n        new CustomEvent(\"message\", { detail: { message: last } }),\n      );\n    }\n  }\n\n  // ── Connection ──────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.ws) return;\n\n    try {\n      this.setState({\n        status: \"connecting\",\n        error: null,\n      });\n\n      const base = (this.opts.server ?? \"https://voice.pinecall.io\").replace(\n        /\\/$/,\n        \"\",\n      );\n\n      // 1. Fetch chat token (public, no API key)\n      const tRes = await fetch(\n        `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`,\n      );\n      if (!tRes.ok) {\n        const body = await tRes.text();\n        throw new Error(`Token: ${tRes.status} ${body}`);\n      }\n      const { token, server: chatServer } = await tRes.json();\n      const wsBase = (chatServer || base)\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\");\n\n      // 2. Open WebSocket\n      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);\n      this.ws = ws;\n\n      ws.onopen = () => {\n        // Wait for chat.connected event before setting status\n      };\n\n      ws.onmessage = (evt) => this.handleMessage(evt);\n\n      ws.onerror = () => {\n        this.setState({ error: \"WebSocket error\", status: \"error\" });\n      };\n\n      ws.onclose = (evt) => {\n        this.ws = null;\n        if (this.state.status === \"connected\") {\n          // Unexpected disconnect\n          this.setState({ status: \"idle\" });\n        }\n      };\n    } catch (err) {\n      this.setState({\n        error: err instanceof Error ? err.message : String(err),\n        status: \"error\",\n      });\n      this.ws = null;\n    }\n  }\n\n  private handleMessage(evt: MessageEvent): void {\n    let d: any;\n    try {\n      d = JSON.parse(evt.data);\n    } catch {\n      return;\n    }\n\n    switch (d.event) {\n      case \"chat.connected\":\n        this.setState({\n          status: \"connected\",\n          sessionId: d.session_id ?? null,\n        });\n        break;\n\n      case \"chat.token\":\n      case \"llm.chat.token\":\n        // Streaming token from LLM\n        this.setState({\n          typing: true,\n          streamingText: d.text ?? \"\",\n        });\n\n        // Update or create bot message\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx ? { ...m, text: d.text ?? \"\" } : m,\n            );\n          }\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: true,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.done\":\n      case \"llm.chat.done\":\n        // LLM finished streaming\n        this.setState({\n          typing: false,\n          streamingText: \"\",\n        });\n\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx\n                ? { ...m, text: d.text ?? m.text, isStreaming: false }\n                : m,\n            );\n          }\n          // If we missed the streaming, add the final message\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: false,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.error\":\n      case \"llm.chat.error\":\n        this.setState({\n          typing: false,\n          error: d.error ?? \"Unknown error\",\n        });\n        break;\n\n      case \"error\":\n        this.setState({\n          error: d.error ?? \"Unknown error\",\n          status: \"error\",\n        });\n        break;\n    }\n\n    // Emit raw event for power users\n    this.dispatchEvent(new CustomEvent(\"event\", { detail: d }));\n  }\n\n  // ── Actions ─────────────────────────────────────────────────────────\n\n  /** Send a text message to the agent. */\n  send(text: string): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n\n    const trimmed = text.trim();\n    if (!trimmed) return;\n\n    // Add user message to local state immediately\n    this.setMessages((prev) => [\n      ...prev,\n      {\n        id: ++this.msgCounter,\n        role: \"user\",\n        text: trimmed,\n      },\n    ]);\n\n    // Send to server\n    this.ws.send(JSON.stringify({ event: \"message\", text: trimmed }));\n  }\n\n  /**\n   * Set or clear a keyed context block in the LLM system prompt.\n   *\n   * @example\n   * ```ts\n   * session.setContext(\"form\", JSON.stringify({ name: \"Juan\" }));\n   * session.setContext(\"form\", null); // clear\n   * ```\n   */\n  setContext(key: string, value: string | null): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.ws.send(JSON.stringify({ event: \"set_context\", key, value }));\n  }\n\n  /** Disconnect the chat session. */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n    this.setState({ status: \"idle\", typing: false, streamingText: \"\" });\n  }\n\n  /** Tear down the session and clear subscribers. Do not reuse after this. */\n  destroy(): void {\n    this.disconnect();\n    this.listeners.clear();\n  }\n}\n"]}
+{"version":3,"sources":["../src/ChatSession.ts"],"names":[],"mappings":";;;AAeA,IAAM,aAAA,GAAkC;AAAA,EACtC,MAAA,EAAQ,MAAA;AAAA,EACR,KAAA,EAAO,IAAA;AAAA,EACP,UAAU,EAAC;AAAA,EACX,MAAA,EAAQ,KAAA;AAAA,EACR,aAAA,EAAe,EAAA;AAAA,EACf,SAAA,EAAW;AACb,CAAA;AAEO,IAAM,WAAA,GAAN,cAA0B,WAAA,CAAY;AAAA,EAQ3C,YAAoB,IAAA,EAA0B;AAC5C,IAAA,KAAA,EAAM;AADY,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAEpB;AAAA,EAFoB,IAAA;AAAA,EAPZ,KAAA,GAA0B,EAAE,GAAG,aAAA,EAAc;AAAA,EAC7C,SAAA,uBAAgB,GAAA,EAAgB;AAAA,EAEhC,EAAA,GAAuB,IAAA;AAAA,EACvB,cAAA,GAAuD,IAAA;AAAA,EACvD,UAAA,GAAa,CAAA;AAAA;AAAA,EAOrB,QAAA,GAAuC;AACrC,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,EACd;AAAA;AAAA,EAGA,UAAU,QAAA,EAAkC;AAC1C,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAQ,CAAA;AAC3B,IAAA,OAAO,MAAM;AACX,MAAA,IAAA,CAAK,SAAA,CAAU,OAAO,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,EACF;AAAA,EAEQ,SAAS,KAAA,EAAwC;AACvD,IAAA,MAAM,OAAO,IAAA,CAAK,KAAA;AAClB,IAAA,IAAA,CAAK,KAAA,GAAQ,EAAE,GAAG,IAAA,EAAM,GAAG,KAAA,EAAM;AACjC,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,SAAA,EAAW,CAAA,EAAE;AAElC,IAAA,IAAI,MAAM,MAAA,KAAW,MAAA,IAAa,KAAA,CAAM,MAAA,KAAW,KAAK,MAAA,EAAQ;AAC9D,MAAA,IAAA,CAAK,aAAA;AAAA,QACH,IAAI,WAAA,CAAY,QAAA,EAAU,EAAE,MAAA,EAAQ,EAAE,MAAA,EAAQ,IAAA,CAAK,KAAA,CAAM,MAAA,EAAO,EAAG;AAAA,OACrE;AAAA,IACF;AACA,IAAA,IACE,KAAA,CAAM,UAAU,MAAA,IAChB,KAAA,CAAM,UAAU,IAAA,IAChB,KAAA,CAAM,KAAA,KAAU,IAAA,CAAK,KAAA,EACrB;AACA,MAAA,IAAA,CAAK,aAAA;AAAA,QACH,IAAI,WAAA,CAAY,OAAA,EAAS,EAAE,MAAA,EAAQ,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,CAAM,KAAA,EAAM,EAAG;AAAA,OAClE;AAAA,IACF;AACA,IAAA,IAAA,CAAK,aAAA;AAAA,MACH,IAAI,WAAA,CAAY,QAAA,EAAU,EAAE,MAAA,EAAQ,EAAE,KAAA,EAAO,IAAA,CAAK,KAAA,EAAM,EAAG;AAAA,KAC7D;AAAA,EACF;AAAA,EAEQ,YACN,OAAA,EACM;AACN,IAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,QAAQ,CAAA;AACxC,IAAA,IAAA,CAAK,QAAA,CAAS,EAAE,QAAA,EAAU,IAAA,EAAM,CAAA;AAChC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,MAAA,GAAS,CAAC,CAAA;AACjC,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,IAAA,CAAK,aAAA;AAAA,QACH,IAAI,YAAY,SAAA,EAAW,EAAE,QAAQ,EAAE,OAAA,EAAS,IAAA,EAAK,EAAG;AAAA,OAC1D;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,MAAM,OAAA,GAAyB;AAC7B,IAAA,IAAI,KAAK,EAAA,EAAI;AAEb,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,QAAA,CAAS;AAAA,QACZ,MAAA,EAAQ,YAAA;AAAA,QACR,KAAA,EAAO;AAAA,OACR,CAAA;AAED,MAAA,MAAM,IAAA,GAAA,CAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,IAAU,2BAAA,EAA6B,OAAA;AAAA,QAC7D,KAAA;AAAA,QACA;AAAA,OACF;AAGA,MAAA,IAAI,KAAA;AACJ,MAAA,IAAI,UAAA;AACJ,MAAA,IAAI,IAAA,CAAK,KAAK,aAAA,EAAe;AAC3B,QAAA,MAAM,CAAA,GAAI,MAAM,IAAA,CAAK,IAAA,CAAK,aAAA,EAAc;AACxC,QAAA,KAAA,GAAQ,CAAA,CAAE,KAAA;AACV,QAAA,UAAA,GAAa,CAAA,CAAE,MAAA;AAAA,MACjB,CAAA,MAAO;AACL,QAAA,MAAM,OAAO,MAAM,KAAA;AAAA,UACjB,GAAG,IAAI,CAAA,qBAAA,EAAwB,mBAAmB,IAAA,CAAK,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,SACpE;AACA,QAAA,IAAI,CAAC,KAAK,EAAA,EAAI;AACZ,UAAA,MAAM,IAAA,GAAO,MAAM,IAAA,CAAK,IAAA,EAAK;AAC7B,UAAA,MAAM,IAAI,KAAA,CAAM,CAAA,OAAA,EAAU,KAAK,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAE,CAAA;AAAA,QACjD;AACA,QAAA,MAAM,CAAA,GAAI,MAAM,IAAA,CAAK,IAAA,EAAK;AAC1B,QAAA,KAAA,GAAQ,CAAA,CAAE,KAAA;AACV,QAAA,UAAA,GAAa,CAAA,CAAE,MAAA;AAAA,MACjB;AACA,MAAA,MAAM,MAAA,GAAA,CAAU,cAAc,IAAA,EAC3B,OAAA,CAAQ,UAAU,KAAK,CAAA,CACvB,OAAA,CAAQ,SAAA,EAAW,MAAM,CAAA;AAG5B,MAAA,MAAM,KAAK,IAAI,SAAA,CAAU,GAAG,MAAM,CAAA,eAAA,EAAkB,KAAK,CAAA,CAAE,CAAA;AAC3D,MAAA,IAAA,CAAK,EAAA,GAAK,EAAA;AAEV,MAAA,EAAA,CAAG,SAAS,MAAM;AAAA,MAElB,CAAA;AAEA,MAAA,EAAA,CAAG,SAAA,GAAY,CAAC,GAAA,KAAQ,IAAA,CAAK,cAAc,GAAG,CAAA;AAE9C,MAAA,EAAA,CAAG,UAAU,MAAM;AACjB,QAAA,IAAA,CAAK,SAAS,EAAE,KAAA,EAAO,iBAAA,EAAmB,MAAA,EAAQ,SAAS,CAAA;AAAA,MAC7D,CAAA;AAEA,MAAA,EAAA,CAAG,OAAA,GAAU,CAAC,GAAA,KAAQ;AACpB,QAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AACV,QAAA,IAAI,IAAA,CAAK,KAAA,CAAM,MAAA,KAAW,WAAA,EAAa;AAErC,UAAA,IAAA,CAAK,QAAA,CAAS,EAAE,MAAA,EAAQ,MAAA,EAAQ,CAAA;AAAA,QAClC;AAAA,MACF,CAAA;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,IAAA,CAAK,QAAA,CAAS;AAAA,QACZ,OAAO,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAAA,QACtD,MAAA,EAAQ;AAAA,OACT,CAAA;AACD,MAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AAAA,IACZ;AAAA,EACF;AAAA,EAEQ,cAAc,GAAA,EAAyB;AAC7C,IAAA,IAAI,CAAA;AACJ,IAAA,IAAI;AACF,MAAA,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAAA,IACzB,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AAEA,IAAA,QAAQ,EAAE,KAAA;AAAO,MACf,KAAK,gBAAA;AACH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,WAAA;AAAA,UACR,SAAA,EAAW,EAAE,UAAA,IAAc;AAAA,SAC5B,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,YAAA;AAAA,MACL,KAAK,gBAAA;AAEH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,IAAA;AAAA,UACR,aAAA,EAAe,EAAE,IAAA,IAAQ;AAAA,SAC1B,CAAA;AAGD,QAAA,IAAA,CAAK,WAAA,CAAY,CAAC,IAAA,KAAS;AACzB,UAAA,MAAM,MAAM,IAAA,CAAK,SAAA;AAAA,YACf,CAAC,CAAA,KAAM,CAAA,CAAE,SAAA,KAAc,CAAA,CAAE,cAAc,CAAA,CAAE;AAAA,WAC3C;AACA,UAAA,IAAI,OAAO,CAAA,EAAG;AACZ,YAAA,OAAO,IAAA,CAAK,GAAA;AAAA,cAAI,CAAC,CAAA,EAAG,CAAA,KAClB,CAAA,KAAM,GAAA,GAAM,EAAE,GAAG,CAAA,EAAG,IAAA,EAAM,CAAA,CAAE,IAAA,IAAQ,EAAA,EAAG,GAAI;AAAA,aAC7C;AAAA,UACF;AACA,UAAA,OAAO;AAAA,YACL,GAAG,IAAA;AAAA,YACH;AAAA,cACE,EAAA,EAAI,EAAE,IAAA,CAAK,UAAA;AAAA,cACX,IAAA,EAAM,KAAA;AAAA,cACN,IAAA,EAAM,EAAE,IAAA,IAAQ,EAAA;AAAA,cAChB,WAAW,CAAA,CAAE,UAAA;AAAA,cACb,WAAA,EAAa;AAAA;AACf,WACF;AAAA,QACF,CAAC,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,WAAA;AAAA,MACL,KAAK,eAAA;AAEH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,KAAA;AAAA,UACR,aAAA,EAAe;AAAA,SAChB,CAAA;AAED,QAAA,IAAA,CAAK,WAAA,CAAY,CAAC,IAAA,KAAS;AACzB,UAAA,MAAM,MAAM,IAAA,CAAK,SAAA;AAAA,YACf,CAAC,CAAA,KAAM,CAAA,CAAE,SAAA,KAAc,CAAA,CAAE,cAAc,CAAA,CAAE;AAAA,WAC3C;AACA,UAAA,IAAI,OAAO,CAAA,EAAG;AACZ,YAAA,OAAO,IAAA,CAAK,GAAA;AAAA,cAAI,CAAC,CAAA,EAAG,CAAA,KAClB,CAAA,KAAM,MACF,EAAE,GAAG,CAAA,EAAG,IAAA,EAAM,EAAE,IAAA,IAAQ,CAAA,CAAE,IAAA,EAAM,WAAA,EAAa,OAAM,GACnD;AAAA,aACN;AAAA,UACF;AAEA,UAAA,OAAO;AAAA,YACL,GAAG,IAAA;AAAA,YACH;AAAA,cACE,EAAA,EAAI,EAAE,IAAA,CAAK,UAAA;AAAA,cACX,IAAA,EAAM,KAAA;AAAA,cACN,IAAA,EAAM,EAAE,IAAA,IAAQ,EAAA;AAAA,cAChB,WAAW,CAAA,CAAE,UAAA;AAAA,cACb,WAAA,EAAa;AAAA;AACf,WACF;AAAA,QACF,CAAC,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,YAAA;AAAA,MACL,KAAK,gBAAA;AACH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,MAAA,EAAQ,KAAA;AAAA,UACR,KAAA,EAAO,EAAE,KAAA,IAAS;AAAA,SACnB,CAAA;AACD,QAAA;AAAA,MAEF,KAAK,OAAA;AACH,QAAA,IAAA,CAAK,QAAA,CAAS;AAAA,UACZ,KAAA,EAAO,EAAE,KAAA,IAAS,eAAA;AAAA,UAClB,MAAA,EAAQ;AAAA,SACT,CAAA;AACD,QAAA;AAAA;AAIJ,IAAA,IAAA,CAAK,aAAA,CAAc,IAAI,WAAA,CAAY,OAAA,EAAS,EAAE,MAAA,EAAQ,CAAA,EAAG,CAAC,CAAA;AAAA,EAC5D;AAAA;AAAA;AAAA,EAKA,KAAK,IAAA,EAAoB;AACvB,IAAA,IAAI,CAAC,IAAA,CAAK,EAAA,IAAM,KAAK,EAAA,CAAG,UAAA,KAAe,UAAU,IAAA,EAAM;AAEvD,IAAA,MAAM,OAAA,GAAU,KAAK,IAAA,EAAK;AAC1B,IAAA,IAAI,CAAC,OAAA,EAAS;AAGd,IAAA,IAAA,CAAK,WAAA,CAAY,CAAC,IAAA,KAAS;AAAA,MACzB,GAAG,IAAA;AAAA,MACH;AAAA,QACE,EAAA,EAAI,EAAE,IAAA,CAAK,UAAA;AAAA,QACX,IAAA,EAAM,MAAA;AAAA,QACN,IAAA,EAAM;AAAA;AACR,KACD,CAAA;AAGD,IAAA,IAAA,CAAK,EAAA,CAAG,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,SAAA,EAAW,IAAA,EAAM,OAAA,EAAS,CAAC,CAAA;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,UAAA,CAAW,KAAa,KAAA,EAA4B;AAClD,IAAA,IAAI,CAAC,IAAA,CAAK,EAAA,IAAM,KAAK,EAAA,CAAG,UAAA,KAAe,UAAU,IAAA,EAAM;AACvD,IAAA,IAAA,CAAK,EAAA,CAAG,IAAA,CAAK,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO,aAAA,EAAe,GAAA,EAAK,KAAA,EAAO,CAAC,CAAA;AAAA,EACnE;AAAA;AAAA,EAGA,UAAA,GAAmB;AACjB,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,YAAA,CAAa,KAAK,cAAc,CAAA;AAChC,MAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AAAA,IACxB;AACA,IAAA,IAAI,KAAK,EAAA,EAAI;AACX,MAAA,IAAA,CAAK,GAAG,KAAA,EAAM;AACd,MAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AAAA,IACZ;AACA,IAAA,IAAA,CAAK,QAAA,CAAS,EAAE,MAAA,EAAQ,MAAA,EAAQ,QAAQ,KAAA,EAAO,aAAA,EAAe,IAAI,CAAA;AAAA,EACpE;AAAA;AAAA,EAGA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,UAAA,EAAW;AAChB,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AACF","file":"index.cjs","sourcesContent":["/**\n * ChatSession — Framework-agnostic text chat client for Pinecall agents.\n *\n * Mirrors VoiceSession's API patterns:\n *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore\n *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)\n *\n * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat\n */\nimport type {\n  ChatSessionState,\n  ChatSessionOptions,\n  ChatMessage,\n} from \"./types\";\n\nconst INITIAL_STATE: ChatSessionState = {\n  status: \"idle\",\n  error: null,\n  messages: [],\n  typing: false,\n  streamingText: \"\",\n  sessionId: null,\n};\n\nexport class ChatSession extends EventTarget {\n  private state: ChatSessionState = { ...INITIAL_STATE };\n  private listeners = new Set<() => void>();\n\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private msgCounter = 0;\n\n  constructor(private opts: ChatSessionOptions) {\n    super();\n  }\n\n  /** Read-only snapshot of current state (stable ref until next mutation). */\n  getState(): Readonly<ChatSessionState> {\n    return this.state;\n  }\n\n  /** Subscribe to ANY state change (for React useSyncExternalStore). */\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private setState(patch: Partial<ChatSessionState>): void {\n    const prev = this.state;\n    this.state = { ...prev, ...patch };\n    for (const l of this.listeners) l();\n\n    if (patch.status !== undefined && patch.status !== prev.status) {\n      this.dispatchEvent(\n        new CustomEvent(\"status\", { detail: { status: this.state.status } }),\n      );\n    }\n    if (\n      patch.error !== undefined &&\n      patch.error !== null &&\n      patch.error !== prev.error\n    ) {\n      this.dispatchEvent(\n        new CustomEvent(\"error\", { detail: { error: this.state.error } }),\n      );\n    }\n    this.dispatchEvent(\n      new CustomEvent(\"change\", { detail: { state: this.state } }),\n    );\n  }\n\n  private setMessages(\n    updater: (prev: ChatMessage[]) => ChatMessage[],\n  ): void {\n    const next = updater(this.state.messages);\n    this.setState({ messages: next });\n    const last = next[next.length - 1];\n    if (last) {\n      this.dispatchEvent(\n        new CustomEvent(\"message\", { detail: { message: last } }),\n      );\n    }\n  }\n\n  // ── Connection ──────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.ws) return;\n\n    try {\n      this.setState({\n        status: \"connecting\",\n        error: null,\n      });\n\n      const base = (this.opts.server ?? \"https://voice.pinecall.io\").replace(\n        /\\/$/,\n        \"\",\n      );\n\n      // 1. Fetch chat token — use tokenProvider (backend proxy) or direct fetch\n      let token: string;\n      let chatServer: string;\n      if (this.opts.tokenProvider) {\n        const t = await this.opts.tokenProvider();\n        token = t.token;\n        chatServer = t.server;\n      } else {\n        const tRes = await fetch(\n          `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`,\n        );\n        if (!tRes.ok) {\n          const body = await tRes.text();\n          throw new Error(`Token: ${tRes.status} ${body}`);\n        }\n        const t = await tRes.json();\n        token = t.token;\n        chatServer = t.server;\n      }\n      const wsBase = (chatServer || base)\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\");\n\n      // 2. Open WebSocket\n      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);\n      this.ws = ws;\n\n      ws.onopen = () => {\n        // Wait for chat.connected event before setting status\n      };\n\n      ws.onmessage = (evt) => this.handleMessage(evt);\n\n      ws.onerror = () => {\n        this.setState({ error: \"WebSocket error\", status: \"error\" });\n      };\n\n      ws.onclose = (evt) => {\n        this.ws = null;\n        if (this.state.status === \"connected\") {\n          // Unexpected disconnect\n          this.setState({ status: \"idle\" });\n        }\n      };\n    } catch (err) {\n      this.setState({\n        error: err instanceof Error ? err.message : String(err),\n        status: \"error\",\n      });\n      this.ws = null;\n    }\n  }\n\n  private handleMessage(evt: MessageEvent): void {\n    let d: any;\n    try {\n      d = JSON.parse(evt.data);\n    } catch {\n      return;\n    }\n\n    switch (d.event) {\n      case \"chat.connected\":\n        this.setState({\n          status: \"connected\",\n          sessionId: d.session_id ?? null,\n        });\n        break;\n\n      case \"chat.token\":\n      case \"llm.chat.token\":\n        // Streaming token from LLM\n        this.setState({\n          typing: true,\n          streamingText: d.text ?? \"\",\n        });\n\n        // Update or create bot message\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx ? { ...m, text: d.text ?? \"\" } : m,\n            );\n          }\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: true,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.done\":\n      case \"llm.chat.done\":\n        // LLM finished streaming\n        this.setState({\n          typing: false,\n          streamingText: \"\",\n        });\n\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx\n                ? { ...m, text: d.text ?? m.text, isStreaming: false }\n                : m,\n            );\n          }\n          // If we missed the streaming, add the final message\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: false,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.error\":\n      case \"llm.chat.error\":\n        this.setState({\n          typing: false,\n          error: d.error ?? \"Unknown error\",\n        });\n        break;\n\n      case \"error\":\n        this.setState({\n          error: d.error ?? \"Unknown error\",\n          status: \"error\",\n        });\n        break;\n    }\n\n    // Emit raw event for power users\n    this.dispatchEvent(new CustomEvent(\"event\", { detail: d }));\n  }\n\n  // ── Actions ─────────────────────────────────────────────────────────\n\n  /** Send a text message to the agent. */\n  send(text: string): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n\n    const trimmed = text.trim();\n    if (!trimmed) return;\n\n    // Add user message to local state immediately\n    this.setMessages((prev) => [\n      ...prev,\n      {\n        id: ++this.msgCounter,\n        role: \"user\",\n        text: trimmed,\n      },\n    ]);\n\n    // Send to server\n    this.ws.send(JSON.stringify({ event: \"message\", text: trimmed }));\n  }\n\n  /**\n   * Set or clear a keyed context block in the LLM system prompt.\n   *\n   * @example\n   * ```ts\n   * session.setContext(\"form\", JSON.stringify({ name: \"Juan\" }));\n   * session.setContext(\"form\", null); // clear\n   * ```\n   */\n  setContext(key: string, value: string | null): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.ws.send(JSON.stringify({ event: \"set_context\", key, value }));\n  }\n\n  /** Disconnect the chat session. */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n    this.setState({ status: \"idle\", typing: false, streamingText: \"\" });\n  }\n\n  /** Tear down the session and clear subscribers. Do not reuse after this. */\n  destroy(): void {\n    this.disconnect();\n    this.listeners.clear();\n  }\n}\n"]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { b as ChatSessionOptions, c as ChatSessionState } from './types-CGPqse91.cjs';
-export { C as ChatEventType, a as ChatMessage, d as ChatStatus } from './types-CGPqse91.cjs';
+import { b as ChatSessionOptions, c as ChatSessionState } from './types-CHSJWZBX.cjs';
+export { C as ChatEventType, a as ChatMessage, d as ChatStatus } from './types-CHSJWZBX.cjs';
 
 /**
  * ChatSession — Framework-agnostic text chat client for Pinecall agents.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { b as ChatSessionOptions, c as ChatSessionState } from './types-CGPqse91.js';
-export { C as ChatEventType, a as ChatMessage, d as ChatStatus } from './types-CGPqse91.js';
+import { b as ChatSessionOptions, c as ChatSessionState } from './types-CHSJWZBX.js';
+export { C as ChatEventType, a as ChatMessage, d as ChatStatus } from './types-CHSJWZBX.js';
 
 /**
  * ChatSession — Framework-agnostic text chat client for Pinecall agents.

package/dist/index.js

@@ -1,3 +1,3 @@
-export { ChatSession } from './chunk-ST5DVE5W.js';
+export { ChatSession } from './chunk-A2FCWUQW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.cjs

@@ -75,14 +75,24 @@ var ChatSession = class extends EventTarget {
         /\/$/,
         ""
       );
-      const tRes = await fetch(
-        `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`
-      );
-      if (!tRes.ok) {
-        const body = await tRes.text();
-        throw new Error(`Token: ${tRes.status} ${body}`);
+      let token;
+      let chatServer;
+      if (this.opts.tokenProvider) {
+        const t = await this.opts.tokenProvider();
+        token = t.token;
+        chatServer = t.server;
+      } else {
+        const tRes = await fetch(
+          `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`
+        );
+        if (!tRes.ok) {
+          const body = await tRes.text();
+          throw new Error(`Token: ${tRes.status} ${body}`);
+        }
+        const t = await tRes.json();
+        token = t.token;
+        chatServer = t.server;
       }
-      const { token, server: chatServer } = await tRes.json();
       const wsBase = (chatServer || base).replace(/^http:/, "ws:").replace(/^https:/, "wss:");
       const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);
       this.ws = ws;

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ChatSession.ts","../src/react.tsx"],"names":["useRef","useSyncExternalStore","useCallback","useEffect"],"mappings":"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","file":"react.cjs","sourcesContent":["/**\n * ChatSession — Framework-agnostic text chat client for Pinecall agents.\n *\n * Mirrors VoiceSession's API patterns:\n *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore\n *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)\n *\n * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat\n */\nimport type {\n  ChatSessionState,\n  ChatSessionOptions,\n  ChatMessage,\n} from \"./types\";\n\nconst INITIAL_STATE: ChatSessionState = {\n  status: \"idle\",\n  error: null,\n  messages: [],\n  typing: false,\n  streamingText: \"\",\n  sessionId: null,\n};\n\nexport class ChatSession extends EventTarget {\n  private state: ChatSessionState = { ...INITIAL_STATE };\n  private listeners = new Set<() => void>();\n\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private msgCounter = 0;\n\n  constructor(private opts: ChatSessionOptions) {\n    super();\n  }\n\n  /** Read-only snapshot of current state (stable ref until next mutation). */\n  getState(): Readonly<ChatSessionState> {\n    return this.state;\n  }\n\n  /** Subscribe to ANY state change (for React useSyncExternalStore). */\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private setState(patch: Partial<ChatSessionState>): void {\n    const prev = this.state;\n    this.state = { ...prev, ...patch };\n    for (const l of this.listeners) l();\n\n    if (patch.status !== undefined && patch.status !== prev.status) {\n      this.dispatchEvent(\n        new CustomEvent(\"status\", { detail: { status: this.state.status } }),\n      );\n    }\n    if (\n      patch.error !== undefined &&\n      patch.error !== null &&\n      patch.error !== prev.error\n    ) {\n      this.dispatchEvent(\n        new CustomEvent(\"error\", { detail: { error: this.state.error } }),\n      );\n    }\n    this.dispatchEvent(\n      new CustomEvent(\"change\", { detail: { state: this.state } }),\n    );\n  }\n\n  private setMessages(\n    updater: (prev: ChatMessage[]) => ChatMessage[],\n  ): void {\n    const next = updater(this.state.messages);\n    this.setState({ messages: next });\n    const last = next[next.length - 1];\n    if (last) {\n      this.dispatchEvent(\n        new CustomEvent(\"message\", { detail: { message: last } }),\n      );\n    }\n  }\n\n  // ── Connection ──────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.ws) return;\n\n    try {\n      this.setState({\n        status: \"connecting\",\n        error: null,\n      });\n\n      const base = (this.opts.server ?? \"https://voice.pinecall.io\").replace(\n        /\\/$/,\n        \"\",\n      );\n\n      // 1. Fetch chat token (public, no API key)\n      const tRes = await fetch(\n        `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`,\n      );\n      if (!tRes.ok) {\n        const body = await tRes.text();\n        throw new Error(`Token: ${tRes.status} ${body}`);\n      }\n      const { token, server: chatServer } = await tRes.json();\n      const wsBase = (chatServer || base)\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\");\n\n      // 2. Open WebSocket\n      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);\n      this.ws = ws;\n\n      ws.onopen = () => {\n        // Wait for chat.connected event before setting status\n      };\n\n      ws.onmessage = (evt) => this.handleMessage(evt);\n\n      ws.onerror = () => {\n        this.setState({ error: \"WebSocket error\", status: \"error\" });\n      };\n\n      ws.onclose = (evt) => {\n        this.ws = null;\n        if (this.state.status === \"connected\") {\n          // Unexpected disconnect\n          this.setState({ status: \"idle\" });\n        }\n      };\n    } catch (err) {\n      this.setState({\n        error: err instanceof Error ? err.message : String(err),\n        status: \"error\",\n      });\n      this.ws = null;\n    }\n  }\n\n  private handleMessage(evt: MessageEvent): void {\n    let d: any;\n    try {\n      d = JSON.parse(evt.data);\n    } catch {\n      return;\n    }\n\n    switch (d.event) {\n      case \"chat.connected\":\n        this.setState({\n          status: \"connected\",\n          sessionId: d.session_id ?? null,\n        });\n        break;\n\n      case \"chat.token\":\n      case \"llm.chat.token\":\n        // Streaming token from LLM\n        this.setState({\n          typing: true,\n          streamingText: d.text ?? \"\",\n        });\n\n        // Update or create bot message\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx ? { ...m, text: d.text ?? \"\" } : m,\n            );\n          }\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: true,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.done\":\n      case \"llm.chat.done\":\n        // LLM finished streaming\n        this.setState({\n          typing: false,\n          streamingText: \"\",\n        });\n\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx\n                ? { ...m, text: d.text ?? m.text, isStreaming: false }\n                : m,\n            );\n          }\n          // If we missed the streaming, add the final message\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: false,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.error\":\n      case \"llm.chat.error\":\n        this.setState({\n          typing: false,\n          error: d.error ?? \"Unknown error\",\n        });\n        break;\n\n      case \"error\":\n        this.setState({\n          error: d.error ?? \"Unknown error\",\n          status: \"error\",\n        });\n        break;\n    }\n\n    // Emit raw event for power users\n    this.dispatchEvent(new CustomEvent(\"event\", { detail: d }));\n  }\n\n  // ── Actions ─────────────────────────────────────────────────────────\n\n  /** Send a text message to the agent. */\n  send(text: string): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n\n    const trimmed = text.trim();\n    if (!trimmed) return;\n\n    // Add user message to local state immediately\n    this.setMessages((prev) => [\n      ...prev,\n      {\n        id: ++this.msgCounter,\n        role: \"user\",\n        text: trimmed,\n      },\n    ]);\n\n    // Send to server\n    this.ws.send(JSON.stringify({ event: \"message\", text: trimmed }));\n  }\n\n  /**\n   * Set or clear a keyed context block in the LLM system prompt.\n   *\n   * @example\n   * ```ts\n   * session.setContext(\"form\", JSON.stringify({ name: \"Juan\" }));\n   * session.setContext(\"form\", null); // clear\n   * ```\n   */\n  setContext(key: string, value: string | null): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.ws.send(JSON.stringify({ event: \"set_context\", key, value }));\n  }\n\n  /** Disconnect the chat session. */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n    this.setState({ status: \"idle\", typing: false, streamingText: \"\" });\n  }\n\n  /** Tear down the session and clear subscribers. Do not reuse after this. */\n  destroy(): void {\n    this.disconnect();\n    this.listeners.clear();\n  }\n}\n","/**\n * @pinecall/chat-core/react\n *\n * React hook for Pinecall text chat.\n *\n * @example\n * ```tsx\n * import { usePinecallChat } from \"@pinecall/chat-core/react\";\n *\n * function Chat() {\n *   const { messages, send, connected, typing } = usePinecallChat({\n *     agent: \"florencia\",\n *   });\n *\n *   return (\n *     <div>\n *       {messages.map((m) => (\n *         <p key={m.id}>{m.role}: {m.text}</p>\n *       ))}\n *       <input onKeyDown={(e) => {\n *         if (e.key === \"Enter\") {\n *           send(e.currentTarget.value);\n *           e.currentTarget.value = \"\";\n *         }\n *       }} />\n *     </div>\n *   );\n * }\n * ```\n */\nimport { useSyncExternalStore, useRef, useCallback, useEffect } from \"react\";\nimport { ChatSession } from \"./ChatSession\";\nimport type { ChatSessionOptions, ChatMessage } from \"./types\";\n\nexport interface UsePinecallChatReturn {\n  /** All messages in the conversation. */\n  messages: ChatMessage[];\n  /** Send a text message. */\n  send: (text: string) => void;\n  /** True when connected to the server. */\n  connected: boolean;\n  /** True while the bot is streaming a response. */\n  typing: boolean;\n  /** Partial text of the current response being streamed. */\n  streamingText: string;\n  /** Current error, if any. */\n  error: string | null;\n  /** Inject dynamic context into the LLM prompt. */\n  setContext: (key: string, value: string | null) => void;\n  /** Connect to the chat server. */\n  connect: () => void;\n  /** Disconnect from the chat server. */\n  disconnect: () => void;\n}\n\n/**\n * React hook for Pinecall text chat.\n *\n * Creates a ChatSession and exposes reactive state via useSyncExternalStore.\n * The session auto-connects on mount and disconnects on unmount.\n */\nexport function usePinecallChat(\n  opts: ChatSessionOptions & {\n    /** Set to false to disable auto-connect on mount. @default true */\n    autoConnect?: boolean;\n  },\n): UsePinecallChatReturn {\n  const sessionRef = useRef<ChatSession | null>(null);\n\n  // Stable session instance\n  if (!sessionRef.current) {\n    sessionRef.current = new ChatSession(opts);\n  }\n  const session = sessionRef.current;\n\n  // useSyncExternalStore for reactive state\n  const state = useSyncExternalStore(\n    useCallback((cb: () => void) => session.subscribe(cb), [session]),\n    useCallback(() => session.getState(), [session]),\n  );\n\n  // Auto-connect on mount\n  useEffect(() => {\n    if (opts.autoConnect !== false) {\n      session.connect();\n    }\n    return () => {\n      session.destroy();\n      sessionRef.current = null;\n    };\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  return {\n    messages: state.messages,\n    send: useCallback((text: string) => session.send(text), [session]),\n    connected: state.status === \"connected\",\n    typing: state.typing,\n    streamingText: state.streamingText,\n    error: state.error,\n    setContext: useCallback(\n      (key: string, value: string | null) => session.setContext(key, value),\n      [session],\n    ),\n    connect: useCallback(() => session.connect(), [session]),\n    disconnect: useCallback(() => session.disconnect(), [session]),\n  };\n}\n\n// Re-export core types for convenience\nexport type { ChatSessionOptions, ChatMessage, ChatSessionState } from \"./types\";\n"]}
+{"version":3,"sources":["../src/ChatSession.ts","../src/react.tsx"],"names":["useRef","useSyncExternalStore","useCallback","useEffect"],"mappings":"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","file":"react.cjs","sourcesContent":["/**\n * ChatSession — Framework-agnostic text chat client for Pinecall agents.\n *\n * Mirrors VoiceSession's API patterns:\n *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore\n *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)\n *\n * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat\n */\nimport type {\n  ChatSessionState,\n  ChatSessionOptions,\n  ChatMessage,\n} from \"./types\";\n\nconst INITIAL_STATE: ChatSessionState = {\n  status: \"idle\",\n  error: null,\n  messages: [],\n  typing: false,\n  streamingText: \"\",\n  sessionId: null,\n};\n\nexport class ChatSession extends EventTarget {\n  private state: ChatSessionState = { ...INITIAL_STATE };\n  private listeners = new Set<() => void>();\n\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private msgCounter = 0;\n\n  constructor(private opts: ChatSessionOptions) {\n    super();\n  }\n\n  /** Read-only snapshot of current state (stable ref until next mutation). */\n  getState(): Readonly<ChatSessionState> {\n    return this.state;\n  }\n\n  /** Subscribe to ANY state change (for React useSyncExternalStore). */\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private setState(patch: Partial<ChatSessionState>): void {\n    const prev = this.state;\n    this.state = { ...prev, ...patch };\n    for (const l of this.listeners) l();\n\n    if (patch.status !== undefined && patch.status !== prev.status) {\n      this.dispatchEvent(\n        new CustomEvent(\"status\", { detail: { status: this.state.status } }),\n      );\n    }\n    if (\n      patch.error !== undefined &&\n      patch.error !== null &&\n      patch.error !== prev.error\n    ) {\n      this.dispatchEvent(\n        new CustomEvent(\"error\", { detail: { error: this.state.error } }),\n      );\n    }\n    this.dispatchEvent(\n      new CustomEvent(\"change\", { detail: { state: this.state } }),\n    );\n  }\n\n  private setMessages(\n    updater: (prev: ChatMessage[]) => ChatMessage[],\n  ): void {\n    const next = updater(this.state.messages);\n    this.setState({ messages: next });\n    const last = next[next.length - 1];\n    if (last) {\n      this.dispatchEvent(\n        new CustomEvent(\"message\", { detail: { message: last } }),\n      );\n    }\n  }\n\n  // ── Connection ──────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.ws) return;\n\n    try {\n      this.setState({\n        status: \"connecting\",\n        error: null,\n      });\n\n      const base = (this.opts.server ?? \"https://voice.pinecall.io\").replace(\n        /\\/$/,\n        \"\",\n      );\n\n      // 1. Fetch chat token — use tokenProvider (backend proxy) or direct fetch\n      let token: string;\n      let chatServer: string;\n      if (this.opts.tokenProvider) {\n        const t = await this.opts.tokenProvider();\n        token = t.token;\n        chatServer = t.server;\n      } else {\n        const tRes = await fetch(\n          `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`,\n        );\n        if (!tRes.ok) {\n          const body = await tRes.text();\n          throw new Error(`Token: ${tRes.status} ${body}`);\n        }\n        const t = await tRes.json();\n        token = t.token;\n        chatServer = t.server;\n      }\n      const wsBase = (chatServer || base)\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\");\n\n      // 2. Open WebSocket\n      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);\n      this.ws = ws;\n\n      ws.onopen = () => {\n        // Wait for chat.connected event before setting status\n      };\n\n      ws.onmessage = (evt) => this.handleMessage(evt);\n\n      ws.onerror = () => {\n        this.setState({ error: \"WebSocket error\", status: \"error\" });\n      };\n\n      ws.onclose = (evt) => {\n        this.ws = null;\n        if (this.state.status === \"connected\") {\n          // Unexpected disconnect\n          this.setState({ status: \"idle\" });\n        }\n      };\n    } catch (err) {\n      this.setState({\n        error: err instanceof Error ? err.message : String(err),\n        status: \"error\",\n      });\n      this.ws = null;\n    }\n  }\n\n  private handleMessage(evt: MessageEvent): void {\n    let d: any;\n    try {\n      d = JSON.parse(evt.data);\n    } catch {\n      return;\n    }\n\n    switch (d.event) {\n      case \"chat.connected\":\n        this.setState({\n          status: \"connected\",\n          sessionId: d.session_id ?? null,\n        });\n        break;\n\n      case \"chat.token\":\n      case \"llm.chat.token\":\n        // Streaming token from LLM\n        this.setState({\n          typing: true,\n          streamingText: d.text ?? \"\",\n        });\n\n        // Update or create bot message\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx ? { ...m, text: d.text ?? \"\" } : m,\n            );\n          }\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: true,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.done\":\n      case \"llm.chat.done\":\n        // LLM finished streaming\n        this.setState({\n          typing: false,\n          streamingText: \"\",\n        });\n\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx\n                ? { ...m, text: d.text ?? m.text, isStreaming: false }\n                : m,\n            );\n          }\n          // If we missed the streaming, add the final message\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: false,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.error\":\n      case \"llm.chat.error\":\n        this.setState({\n          typing: false,\n          error: d.error ?? \"Unknown error\",\n        });\n        break;\n\n      case \"error\":\n        this.setState({\n          error: d.error ?? \"Unknown error\",\n          status: \"error\",\n        });\n        break;\n    }\n\n    // Emit raw event for power users\n    this.dispatchEvent(new CustomEvent(\"event\", { detail: d }));\n  }\n\n  // ── Actions ─────────────────────────────────────────────────────────\n\n  /** Send a text message to the agent. */\n  send(text: string): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n\n    const trimmed = text.trim();\n    if (!trimmed) return;\n\n    // Add user message to local state immediately\n    this.setMessages((prev) => [\n      ...prev,\n      {\n        id: ++this.msgCounter,\n        role: \"user\",\n        text: trimmed,\n      },\n    ]);\n\n    // Send to server\n    this.ws.send(JSON.stringify({ event: \"message\", text: trimmed }));\n  }\n\n  /**\n   * Set or clear a keyed context block in the LLM system prompt.\n   *\n   * @example\n   * ```ts\n   * session.setContext(\"form\", JSON.stringify({ name: \"Juan\" }));\n   * session.setContext(\"form\", null); // clear\n   * ```\n   */\n  setContext(key: string, value: string | null): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.ws.send(JSON.stringify({ event: \"set_context\", key, value }));\n  }\n\n  /** Disconnect the chat session. */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n    this.setState({ status: \"idle\", typing: false, streamingText: \"\" });\n  }\n\n  /** Tear down the session and clear subscribers. Do not reuse after this. */\n  destroy(): void {\n    this.disconnect();\n    this.listeners.clear();\n  }\n}\n","/**\n * @pinecall/chat-core/react\n *\n * React hook for Pinecall text chat.\n *\n * @example\n * ```tsx\n * import { usePinecallChat } from \"@pinecall/chat-core/react\";\n *\n * function Chat() {\n *   const { messages, send, connected, typing } = usePinecallChat({\n *     agent: \"florencia\",\n *   });\n *\n *   return (\n *     <div>\n *       {messages.map((m) => (\n *         <p key={m.id}>{m.role}: {m.text}</p>\n *       ))}\n *       <input onKeyDown={(e) => {\n *         if (e.key === \"Enter\") {\n *           send(e.currentTarget.value);\n *           e.currentTarget.value = \"\";\n *         }\n *       }} />\n *     </div>\n *   );\n * }\n * ```\n */\nimport { useSyncExternalStore, useRef, useCallback, useEffect } from \"react\";\nimport { ChatSession } from \"./ChatSession\";\nimport type { ChatSessionOptions, ChatMessage } from \"./types\";\n\nexport interface UsePinecallChatReturn {\n  /** All messages in the conversation. */\n  messages: ChatMessage[];\n  /** Send a text message. */\n  send: (text: string) => void;\n  /** True when connected to the server. */\n  connected: boolean;\n  /** True while the bot is streaming a response. */\n  typing: boolean;\n  /** Partial text of the current response being streamed. */\n  streamingText: string;\n  /** Current error, if any. */\n  error: string | null;\n  /** Inject dynamic context into the LLM prompt. */\n  setContext: (key: string, value: string | null) => void;\n  /** Connect to the chat server. */\n  connect: () => void;\n  /** Disconnect from the chat server. */\n  disconnect: () => void;\n}\n\n/**\n * React hook for Pinecall text chat.\n *\n * Creates a ChatSession and exposes reactive state via useSyncExternalStore.\n * The session auto-connects on mount and disconnects on unmount.\n */\nexport function usePinecallChat(\n  opts: ChatSessionOptions & {\n    /** Set to false to disable auto-connect on mount. @default true */\n    autoConnect?: boolean;\n  },\n): UsePinecallChatReturn {\n  const sessionRef = useRef<ChatSession | null>(null);\n\n  // Stable session instance\n  if (!sessionRef.current) {\n    sessionRef.current = new ChatSession(opts);\n  }\n  const session = sessionRef.current;\n\n  // useSyncExternalStore for reactive state\n  const state = useSyncExternalStore(\n    useCallback((cb: () => void) => session.subscribe(cb), [session]),\n    useCallback(() => session.getState(), [session]),\n  );\n\n  // Auto-connect on mount\n  useEffect(() => {\n    if (opts.autoConnect !== false) {\n      session.connect();\n    }\n    return () => {\n      session.destroy();\n      sessionRef.current = null;\n    };\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  return {\n    messages: state.messages,\n    send: useCallback((text: string) => session.send(text), [session]),\n    connected: state.status === \"connected\",\n    typing: state.typing,\n    streamingText: state.streamingText,\n    error: state.error,\n    setContext: useCallback(\n      (key: string, value: string | null) => session.setContext(key, value),\n      [session],\n    ),\n    connect: useCallback(() => session.connect(), [session]),\n    disconnect: useCallback(() => session.disconnect(), [session]),\n  };\n}\n\n// Re-export core types for convenience\nexport type { ChatSessionOptions, ChatMessage, ChatSessionState } from \"./types\";\n"]}

package/dist/react.d.cts

@@ -1,5 +1,5 @@
-import { a as ChatMessage, b as ChatSessionOptions } from './types-CGPqse91.cjs';
-export { c as ChatSessionState } from './types-CGPqse91.cjs';
+import { a as ChatMessage, b as ChatSessionOptions } from './types-CHSJWZBX.cjs';
+export { c as ChatSessionState } from './types-CHSJWZBX.cjs';
 
 interface UsePinecallChatReturn {
     /** All messages in the conversation. */

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { a as ChatMessage, b as ChatSessionOptions } from './types-CGPqse91.js';
-export { c as ChatSessionState } from './types-CGPqse91.js';
+import { a as ChatMessage, b as ChatSessionOptions } from './types-CHSJWZBX.js';
+export { c as ChatSessionState } from './types-CHSJWZBX.js';
 
 interface UsePinecallChatReturn {
     /** All messages in the conversation. */

package/dist/react.js

@@ -1,4 +1,4 @@
-import { ChatSession } from './chunk-ST5DVE5W.js';
+import { ChatSession } from './chunk-A2FCWUQW.js';
 import { useRef, useSyncExternalStore, useCallback, useEffect } from 'react';
 
 function usePinecallChat(opts) {

package/dist/{types-CGPqse91.d.cts → types-CHSJWZBX.d.cts}

@@ -38,6 +38,22 @@ interface ChatSessionOptions {
      * @default "https://voice.pinecall.io"
      */
     server?: string;
+    /**
+     * Custom token provider — call your backend to generate tokens instead
+     * of hitting /chat/token directly. Keeps API keys server-side.
+     *
+     * @example
+     * ```ts
+     * tokenProvider: async () => {
+     *   const res = await fetch("/api/token?channel=chat");
+     *   return res.json(); // { token, server }
+     * }
+     * ```
+     */
+    tokenProvider?: () => Promise<{
+        token: string;
+        server: string;
+    }>;
 }
 /** Events emitted by ChatSession via EventTarget. */
 type ChatEventType = "status" | "message" | "error" | "change";

package/dist/{types-CGPqse91.d.ts → types-CHSJWZBX.d.ts}

@@ -38,6 +38,22 @@ interface ChatSessionOptions {
      * @default "https://voice.pinecall.io"
      */
     server?: string;
+    /**
+     * Custom token provider — call your backend to generate tokens instead
+     * of hitting /chat/token directly. Keeps API keys server-side.
+     *
+     * @example
+     * ```ts
+     * tokenProvider: async () => {
+     *   const res = await fetch("/api/token?channel=chat");
+     *   return res.json(); // { token, server }
+     * }
+     * ```
+     */
+    tokenProvider?: () => Promise<{
+        token: string;
+        server: string;
+    }>;
 }
 /** Events emitted by ChatSession via EventTarget. */
 type ChatEventType = "status" | "message" | "error" | "change";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinecall/chat-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Framework-agnostic text chat client for Pinecall agents",
   "license": "MIT",
   "type": "module",

package/dist/chunk-ST5DVE5W.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ChatSession.ts"],"names":[],"mappings":"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","file":"chunk-ST5DVE5W.js","sourcesContent":["/**\n * ChatSession — Framework-agnostic text chat client for Pinecall agents.\n *\n * Mirrors VoiceSession's API patterns:\n *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore\n *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)\n *\n * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat\n */\nimport type {\n  ChatSessionState,\n  ChatSessionOptions,\n  ChatMessage,\n} from \"./types\";\n\nconst INITIAL_STATE: ChatSessionState = {\n  status: \"idle\",\n  error: null,\n  messages: [],\n  typing: false,\n  streamingText: \"\",\n  sessionId: null,\n};\n\nexport class ChatSession extends EventTarget {\n  private state: ChatSessionState = { ...INITIAL_STATE };\n  private listeners = new Set<() => void>();\n\n  private ws: WebSocket | null = null;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private msgCounter = 0;\n\n  constructor(private opts: ChatSessionOptions) {\n    super();\n  }\n\n  /** Read-only snapshot of current state (stable ref until next mutation). */\n  getState(): Readonly<ChatSessionState> {\n    return this.state;\n  }\n\n  /** Subscribe to ANY state change (for React useSyncExternalStore). */\n  subscribe(listener: () => void): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  private setState(patch: Partial<ChatSessionState>): void {\n    const prev = this.state;\n    this.state = { ...prev, ...patch };\n    for (const l of this.listeners) l();\n\n    if (patch.status !== undefined && patch.status !== prev.status) {\n      this.dispatchEvent(\n        new CustomEvent(\"status\", { detail: { status: this.state.status } }),\n      );\n    }\n    if (\n      patch.error !== undefined &&\n      patch.error !== null &&\n      patch.error !== prev.error\n    ) {\n      this.dispatchEvent(\n        new CustomEvent(\"error\", { detail: { error: this.state.error } }),\n      );\n    }\n    this.dispatchEvent(\n      new CustomEvent(\"change\", { detail: { state: this.state } }),\n    );\n  }\n\n  private setMessages(\n    updater: (prev: ChatMessage[]) => ChatMessage[],\n  ): void {\n    const next = updater(this.state.messages);\n    this.setState({ messages: next });\n    const last = next[next.length - 1];\n    if (last) {\n      this.dispatchEvent(\n        new CustomEvent(\"message\", { detail: { message: last } }),\n      );\n    }\n  }\n\n  // ── Connection ──────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.ws) return;\n\n    try {\n      this.setState({\n        status: \"connecting\",\n        error: null,\n      });\n\n      const base = (this.opts.server ?? \"https://voice.pinecall.io\").replace(\n        /\\/$/,\n        \"\",\n      );\n\n      // 1. Fetch chat token (public, no API key)\n      const tRes = await fetch(\n        `${base}/chat/token?agent_id=${encodeURIComponent(this.opts.agent)}`,\n      );\n      if (!tRes.ok) {\n        const body = await tRes.text();\n        throw new Error(`Token: ${tRes.status} ${body}`);\n      }\n      const { token, server: chatServer } = await tRes.json();\n      const wsBase = (chatServer || base)\n        .replace(/^http:/, \"ws:\")\n        .replace(/^https:/, \"wss:\");\n\n      // 2. Open WebSocket\n      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);\n      this.ws = ws;\n\n      ws.onopen = () => {\n        // Wait for chat.connected event before setting status\n      };\n\n      ws.onmessage = (evt) => this.handleMessage(evt);\n\n      ws.onerror = () => {\n        this.setState({ error: \"WebSocket error\", status: \"error\" });\n      };\n\n      ws.onclose = (evt) => {\n        this.ws = null;\n        if (this.state.status === \"connected\") {\n          // Unexpected disconnect\n          this.setState({ status: \"idle\" });\n        }\n      };\n    } catch (err) {\n      this.setState({\n        error: err instanceof Error ? err.message : String(err),\n        status: \"error\",\n      });\n      this.ws = null;\n    }\n  }\n\n  private handleMessage(evt: MessageEvent): void {\n    let d: any;\n    try {\n      d = JSON.parse(evt.data);\n    } catch {\n      return;\n    }\n\n    switch (d.event) {\n      case \"chat.connected\":\n        this.setState({\n          status: \"connected\",\n          sessionId: d.session_id ?? null,\n        });\n        break;\n\n      case \"chat.token\":\n      case \"llm.chat.token\":\n        // Streaming token from LLM\n        this.setState({\n          typing: true,\n          streamingText: d.text ?? \"\",\n        });\n\n        // Update or create bot message\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx ? { ...m, text: d.text ?? \"\" } : m,\n            );\n          }\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: true,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.done\":\n      case \"llm.chat.done\":\n        // LLM finished streaming\n        this.setState({\n          typing: false,\n          streamingText: \"\",\n        });\n\n        this.setMessages((prev) => {\n          const idx = prev.findIndex(\n            (m) => m.messageId === d.message_id && m.isStreaming,\n          );\n          if (idx >= 0) {\n            return prev.map((m, i) =>\n              i === idx\n                ? { ...m, text: d.text ?? m.text, isStreaming: false }\n                : m,\n            );\n          }\n          // If we missed the streaming, add the final message\n          return [\n            ...prev,\n            {\n              id: ++this.msgCounter,\n              role: \"bot\",\n              text: d.text ?? \"\",\n              messageId: d.message_id,\n              isStreaming: false,\n            },\n          ];\n        });\n        break;\n\n      case \"chat.error\":\n      case \"llm.chat.error\":\n        this.setState({\n          typing: false,\n          error: d.error ?? \"Unknown error\",\n        });\n        break;\n\n      case \"error\":\n        this.setState({\n          error: d.error ?? \"Unknown error\",\n          status: \"error\",\n        });\n        break;\n    }\n\n    // Emit raw event for power users\n    this.dispatchEvent(new CustomEvent(\"event\", { detail: d }));\n  }\n\n  // ── Actions ─────────────────────────────────────────────────────────\n\n  /** Send a text message to the agent. */\n  send(text: string): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n\n    const trimmed = text.trim();\n    if (!trimmed) return;\n\n    // Add user message to local state immediately\n    this.setMessages((prev) => [\n      ...prev,\n      {\n        id: ++this.msgCounter,\n        role: \"user\",\n        text: trimmed,\n      },\n    ]);\n\n    // Send to server\n    this.ws.send(JSON.stringify({ event: \"message\", text: trimmed }));\n  }\n\n  /**\n   * Set or clear a keyed context block in the LLM system prompt.\n   *\n   * @example\n   * ```ts\n   * session.setContext(\"form\", JSON.stringify({ name: \"Juan\" }));\n   * session.setContext(\"form\", null); // clear\n   * ```\n   */\n  setContext(key: string, value: string | null): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;\n    this.ws.send(JSON.stringify({ event: \"set_context\", key, value }));\n  }\n\n  /** Disconnect the chat session. */\n  disconnect(): void {\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = null;\n    }\n    if (this.ws) {\n      this.ws.close();\n      this.ws = null;\n    }\n    this.setState({ status: \"idle\", typing: false, streamingText: \"\" });\n  }\n\n  /** Tear down the session and clear subscribers. Do not reuse after this. */\n  destroy(): void {\n    this.disconnect();\n    this.listeners.clear();\n  }\n}\n"]}