@pinecall/web 0.1.0

package/dist/chat/react.cjs

@@ -0,0 +1,292 @@
+'use strict';
+
+var react = require('react');
+
+// src/chat/react.tsx
+
+// src/chat/ChatSession.ts
+var INITIAL_STATE = {
+  status: "idle",
+  error: null,
+  messages: [],
+  typing: false,
+  streamingText: "",
+  sessionId: null
+};
+var ChatSession = class extends EventTarget {
+  constructor(opts) {
+    super();
+    this.opts = opts;
+  }
+  opts;
+  state = { ...INITIAL_STATE };
+  listeners = /* @__PURE__ */ new Set();
+  ws = null;
+  reconnectTimer = null;
+  msgCounter = 0;
+  /** Read-only snapshot of current state (stable ref until next mutation). */
+  getState() {
+    return this.state;
+  }
+  /** Subscribe to ANY state change (for React useSyncExternalStore). */
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  setState(patch) {
+    const prev = this.state;
+    this.state = { ...prev, ...patch };
+    for (const l of this.listeners) l();
+    if (patch.status !== void 0 && patch.status !== prev.status) {
+      this.dispatchEvent(
+        new CustomEvent("status", { detail: { status: this.state.status } })
+      );
+    }
+    if (patch.error !== void 0 && patch.error !== null && patch.error !== prev.error) {
+      this.dispatchEvent(
+        new CustomEvent("error", { detail: { error: this.state.error } })
+      );
+    }
+    this.dispatchEvent(
+      new CustomEvent("change", { detail: { state: this.state } })
+    );
+  }
+  setMessages(updater) {
+    const next = updater(this.state.messages);
+    this.setState({ messages: next });
+    const last = next[next.length - 1];
+    if (last) {
+      this.dispatchEvent(
+        new CustomEvent("message", { detail: { message: last } })
+      );
+    }
+  }
+  // ── Connection ──────────────────────────────────────────────────────
+  async connect() {
+    if (this.ws) return;
+    try {
+      this.setState({
+        status: "connecting",
+        error: null
+      });
+      const base = (this.opts.server ?? "https://voice.pinecall.io").replace(
+        /\/$/,
+        ""
+      );
+      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 wsBase = (chatServer || base).replace(/^http:/, "ws:").replace(/^https:/, "wss:");
+      const ws = new WebSocket(`${wsBase}/chat/ws?token=${token}`);
+      this.ws = ws;
+      ws.onopen = () => {
+      };
+      ws.onmessage = (evt) => this.handleMessage(evt);
+      ws.onerror = () => {
+        this.setState({ error: "WebSocket error", status: "error" });
+      };
+      ws.onclose = (evt) => {
+        this.ws = null;
+        if (this.state.status === "connected") {
+          this.setState({ status: "idle" });
+        }
+      };
+    } catch (err) {
+      this.setState({
+        error: err instanceof Error ? err.message : String(err),
+        status: "error"
+      });
+      this.ws = null;
+    }
+  }
+  handleMessage(evt) {
+    let d;
+    try {
+      d = JSON.parse(evt.data);
+    } catch {
+      return;
+    }
+    switch (d.event) {
+      case "chat.connected":
+        this.setState({
+          status: "connected",
+          sessionId: d.session_id ?? null
+        });
+        break;
+      case "chat.token":
+      case "llm.chat.token":
+        this.setState({
+          typing: true,
+          streamingText: d.text ?? ""
+        });
+        this.setMessages((prev) => {
+          const idx = prev.findIndex(
+            (m) => m.messageId === d.message_id && m.isStreaming
+          );
+          if (idx >= 0) {
+            return prev.map(
+              (m, i) => i === idx ? { ...m, text: d.text ?? "" } : m
+            );
+          }
+          return [
+            ...prev,
+            {
+              id: ++this.msgCounter,
+              role: "bot",
+              text: d.text ?? "",
+              messageId: d.message_id,
+              isStreaming: true
+            }
+          ];
+        });
+        break;
+      case "chat.done":
+      case "llm.chat.done":
+        this.setState({
+          typing: false,
+          streamingText: ""
+        });
+        this.setMessages((prev) => {
+          const idx = prev.findIndex(
+            (m) => m.messageId === d.message_id && m.isStreaming
+          );
+          if (idx >= 0) {
+            return prev.map(
+              (m, i) => i === idx ? { ...m, text: d.text ?? m.text, isStreaming: false } : m
+            );
+          }
+          return [
+            ...prev,
+            {
+              id: ++this.msgCounter,
+              role: "bot",
+              text: d.text ?? "",
+              messageId: d.message_id,
+              isStreaming: false
+            }
+          ];
+        });
+        break;
+      case "chat.error":
+      case "llm.chat.error":
+        this.setState({
+          typing: false,
+          error: d.error ?? "Unknown error"
+        });
+        break;
+      case "error":
+        this.setState({
+          error: d.error ?? "Unknown error",
+          status: "error"
+        });
+        break;
+    }
+    this.dispatchEvent(new CustomEvent("event", { detail: d }));
+  }
+  // ── Actions ─────────────────────────────────────────────────────────
+  /** Send a text message to the agent. */
+  send(text) {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    const trimmed = text.trim();
+    if (!trimmed) return;
+    this.setMessages((prev) => [
+      ...prev,
+      {
+        id: ++this.msgCounter,
+        role: "user",
+        text: trimmed
+      }
+    ]);
+    this.ws.send(JSON.stringify({ event: "message", text: trimmed }));
+  }
+  /**
+   * Set or clear a keyed context block in the LLM system prompt.
+   *
+   * @example
+   * ```ts
+   * session.setContext("form", JSON.stringify({ name: "Juan" }));
+   * session.setContext("form", null); // clear
+   * ```
+   */
+  setContext(key, value) {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    this.ws.send(JSON.stringify({ event: "set_context", key, value }));
+  }
+  /** Disconnect the chat session. */
+  disconnect() {
+    if (this.reconnectTimer) {
+      clearTimeout(this.reconnectTimer);
+      this.reconnectTimer = null;
+    }
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.setState({ status: "idle", typing: false, streamingText: "" });
+  }
+  /** Tear down the session and clear subscribers. Do not reuse after this. */
+  destroy() {
+    this.disconnect();
+    this.setState({ status: "destroyed" });
+    this.listeners.clear();
+  }
+};
+
+// src/chat/react.tsx
+function usePinecallChat(opts) {
+  const [session, setSession] = react.useState(
+    () => new ChatSession(opts)
+  );
+  const state = react.useSyncExternalStore(
+    react.useCallback((cb) => session.subscribe(cb), [session]),
+    react.useCallback(() => session.getState(), [session])
+  );
+  react.useEffect(() => {
+    let activeSession = session;
+    if (activeSession.getState().status === "destroyed") {
+      activeSession = new ChatSession(opts);
+      setSession(activeSession);
+    }
+    if (opts.autoConnect !== false) {
+      activeSession.connect();
+    }
+    return () => {
+      activeSession.destroy();
+    };
+  }, []);
+  return {
+    messages: state.messages,
+    send: react.useCallback((text) => session.send(text), [session]),
+    connected: state.status === "connected",
+    typing: state.typing,
+    streamingText: state.streamingText,
+    error: state.error,
+    setContext: react.useCallback(
+      (key, value) => session.setContext(key, value),
+      [session]
+    ),
+    connect: react.useCallback(() => session.connect(), [session]),
+    disconnect: react.useCallback(() => session.disconnect(), [session])
+  };
+}
+
+exports.usePinecallChat = usePinecallChat;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/chat/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chat/ChatSession.ts","../../src/chat/react.tsx"],"names":["useState","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.setState({ status: \"destroyed\" });\n    this.listeners.clear();\n  }\n}\n","/**\n * @pinecall/web/chat/react\n *\n * React hook for Pinecall text chat.\n *\n * @example\n * ```tsx\n * import { usePinecallChat } from \"@pinecall/web/chat/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, useState, 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  // Use state for the session so React re-renders when it changes\n  const [session, setSession] = useState<ChatSession>(\n    () => new ChatSession(opts),\n  );\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, destroy on unmount\n  useEffect(() => {\n    // In Strict Mode, the previous session was destroyed.\n    // Create a fresh one if the current session was destroyed.\n    let activeSession = session;\n    if (activeSession.getState().status === \"destroyed\") {\n      activeSession = new ChatSession(opts);\n      setSession(activeSession);\n    }\n\n    if (opts.autoConnect !== false) {\n      activeSession.connect();\n    }\n    return () => {\n      activeSession.destroy();\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/chat/react.d.cts

@@ -0,0 +1,35 @@
+import { c as ChatMessage, C as ChatSessionOptions } from '../types-W0229iUB.cjs';
+export { a as ChatSessionState } from '../types-W0229iUB.cjs';
+
+interface UsePinecallChatReturn {
+    /** All messages in the conversation. */
+    messages: ChatMessage[];
+    /** Send a text message. */
+    send: (text: string) => void;
+    /** True when connected to the server. */
+    connected: boolean;
+    /** True while the bot is streaming a response. */
+    typing: boolean;
+    /** Partial text of the current response being streamed. */
+    streamingText: string;
+    /** Current error, if any. */
+    error: string | null;
+    /** Inject dynamic context into the LLM prompt. */
+    setContext: (key: string, value: string | null) => void;
+    /** Connect to the chat server. */
+    connect: () => void;
+    /** Disconnect from the chat server. */
+    disconnect: () => void;
+}
+/**
+ * React hook for Pinecall text chat.
+ *
+ * Creates a ChatSession and exposes reactive state via useSyncExternalStore.
+ * The session auto-connects on mount and disconnects on unmount.
+ */
+declare function usePinecallChat(opts: ChatSessionOptions & {
+    /** Set to false to disable auto-connect on mount. @default true */
+    autoConnect?: boolean;
+}): UsePinecallChatReturn;
+
+export { ChatMessage, ChatSessionOptions, type UsePinecallChatReturn, usePinecallChat };

package/dist/chat/react.d.ts

@@ -0,0 +1,35 @@
+import { c as ChatMessage, C as ChatSessionOptions } from '../types-W0229iUB.js';
+export { a as ChatSessionState } from '../types-W0229iUB.js';
+
+interface UsePinecallChatReturn {
+    /** All messages in the conversation. */
+    messages: ChatMessage[];
+    /** Send a text message. */
+    send: (text: string) => void;
+    /** True when connected to the server. */
+    connected: boolean;
+    /** True while the bot is streaming a response. */
+    typing: boolean;
+    /** Partial text of the current response being streamed. */
+    streamingText: string;
+    /** Current error, if any. */
+    error: string | null;
+    /** Inject dynamic context into the LLM prompt. */
+    setContext: (key: string, value: string | null) => void;
+    /** Connect to the chat server. */
+    connect: () => void;
+    /** Disconnect from the chat server. */
+    disconnect: () => void;
+}
+/**
+ * React hook for Pinecall text chat.
+ *
+ * Creates a ChatSession and exposes reactive state via useSyncExternalStore.
+ * The session auto-connects on mount and disconnects on unmount.
+ */
+declare function usePinecallChat(opts: ChatSessionOptions & {
+    /** Set to false to disable auto-connect on mount. @default true */
+    autoConnect?: boolean;
+}): UsePinecallChatReturn;
+
+export { ChatMessage, ChatSessionOptions, type UsePinecallChatReturn, usePinecallChat };

package/dist/chat/react.js

@@ -0,0 +1,4 @@
+export { usePinecallChat } from '../chunk-LHZA26Z5.js';
+import '../chunk-MCAQMGBG.js';
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/chat/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"react.js"}

package/dist/chunk-LHZA26Z5.js

@@ -0,0 +1,43 @@
+import { ChatSession } from './chunk-MCAQMGBG.js';
+import { useState, useSyncExternalStore, useCallback, useEffect } from 'react';
+
+function usePinecallChat(opts) {
+  const [session, setSession] = useState(
+    () => new ChatSession(opts)
+  );
+  const state = useSyncExternalStore(
+    useCallback((cb) => session.subscribe(cb), [session]),
+    useCallback(() => session.getState(), [session])
+  );
+  useEffect(() => {
+    let activeSession = session;
+    if (activeSession.getState().status === "destroyed") {
+      activeSession = new ChatSession(opts);
+      setSession(activeSession);
+    }
+    if (opts.autoConnect !== false) {
+      activeSession.connect();
+    }
+    return () => {
+      activeSession.destroy();
+    };
+  }, []);
+  return {
+    messages: state.messages,
+    send: useCallback((text) => session.send(text), [session]),
+    connected: state.status === "connected",
+    typing: state.typing,
+    streamingText: state.streamingText,
+    error: state.error,
+    setContext: useCallback(
+      (key, value) => session.setContext(key, value),
+      [session]
+    ),
+    connect: useCallback(() => session.connect(), [session]),
+    disconnect: useCallback(() => session.disconnect(), [session])
+  };
+}
+
+export { usePinecallChat };
+//# sourceMappingURL=chunk-LHZA26Z5.js.map
+//# sourceMappingURL=chunk-LHZA26Z5.js.map

package/dist/chunk-LHZA26Z5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chat/react.tsx"],"names":[],"mappings":";;;AA6DO,SAAS,gBACd,IAAA,EAIuB;AAEvB,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,QAAA;AAAA,IAC5B,MAAM,IAAI,WAAA,CAAY,IAAI;AAAA,GAC5B;AAGA,EAAA,MAAM,KAAA,GAAQ,oBAAA;AAAA,IACZ,WAAA,CAAY,CAAC,EAAA,KAAmB,OAAA,CAAQ,UAAU,EAAE,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAAA,IAChE,YAAY,MAAM,OAAA,CAAQ,UAAS,EAAG,CAAC,OAAO,CAAC;AAAA,GACjD;AAGA,EAAA,SAAA,CAAU,MAAM;AAGd,IAAA,IAAI,aAAA,GAAgB,OAAA;AACpB,IAAA,IAAI,aAAA,CAAc,QAAA,EAAS,CAAE,MAAA,KAAW,WAAA,EAAa;AACnD,MAAA,aAAA,GAAgB,IAAI,YAAY,IAAI,CAAA;AACpC,MAAA,UAAA,CAAW,aAAa,CAAA;AAAA,IAC1B;AAEA,IAAA,IAAI,IAAA,CAAK,gBAAgB,KAAA,EAAO;AAC9B,MAAA,aAAA,CAAc,OAAA,EAAQ;AAAA,IACxB;AACA,IAAA,OAAO,MAAM;AACX,MAAA,aAAA,CAAc,OAAA,EAAQ;AAAA,IACxB,CAAA;AAAA,EACF,CAAA,EAAG,EAAE,CAAA;AAEL,EAAA,OAAO;AAAA,IACL,UAAU,KAAA,CAAM,QAAA;AAAA,IAChB,IAAA,EAAM,WAAA,CAAY,CAAC,IAAA,KAAiB,OAAA,CAAQ,KAAK,IAAI,CAAA,EAAG,CAAC,OAAO,CAAC,CAAA;AAAA,IACjE,SAAA,EAAW,MAAM,MAAA,KAAW,WAAA;AAAA,IAC5B,QAAQ,KAAA,CAAM,MAAA;AAAA,IACd,eAAe,KAAA,CAAM,aAAA;AAAA,IACrB,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,UAAA,EAAY,WAAA;AAAA,MACV,CAAC,GAAA,EAAa,KAAA,KAAyB,OAAA,CAAQ,UAAA,CAAW,KAAK,KAAK,CAAA;AAAA,MACpE,CAAC,OAAO;AAAA,KACV;AAAA,IACA,OAAA,EAAS,YAAY,MAAM,OAAA,CAAQ,SAAQ,EAAG,CAAC,OAAO,CAAC,CAAA;AAAA,IACvD,UAAA,EAAY,YAAY,MAAM,OAAA,CAAQ,YAAW,EAAG,CAAC,OAAO,CAAC;AAAA,GAC/D;AACF","file":"chunk-LHZA26Z5.js","sourcesContent":["/**\n * @pinecall/web/chat/react\n *\n * React hook for Pinecall text chat.\n *\n * @example\n * ```tsx\n * import { usePinecallChat } from \"@pinecall/web/chat/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, useState, 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  // Use state for the session so React re-renders when it changes\n  const [session, setSession] = useState<ChatSession>(\n    () => new ChatSession(opts),\n  );\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, destroy on unmount\n  useEffect(() => {\n    // In Strict Mode, the previous session was destroyed.\n    // Create a fresh one if the current session was destroyed.\n    let activeSession = session;\n    if (activeSession.getState().status === \"destroyed\") {\n      activeSession = new ChatSession(opts);\n      setSession(activeSession);\n    }\n\n    if (opts.autoConnect !== false) {\n      activeSession.connect();\n    }\n    return () => {\n      activeSession.destroy();\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"]}