@pinecall/chat-core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,239 @@
+'use strict';
+
+// src/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(
+        /\/$/,
+        ""
+      );
+      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 { 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;
+      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.listeners.clear();
+  }
+};
+
+exports.ChatSession = ChatSession;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

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

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+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';
+
+/**
+ * ChatSession — Framework-agnostic text chat client for Pinecall agents.
+ *
+ * Mirrors VoiceSession's API patterns:
+ *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore
+ *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)
+ *
+ * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat
+ */
+
+declare class ChatSession extends EventTarget {
+    private opts;
+    private state;
+    private listeners;
+    private ws;
+    private reconnectTimer;
+    private msgCounter;
+    constructor(opts: ChatSessionOptions);
+    /** Read-only snapshot of current state (stable ref until next mutation). */
+    getState(): Readonly<ChatSessionState>;
+    /** Subscribe to ANY state change (for React useSyncExternalStore). */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    private setMessages;
+    connect(): Promise<void>;
+    private handleMessage;
+    /** Send a text message to the agent. */
+    send(text: string): void;
+    /**
+     * 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: string, value: string | null): void;
+    /** Disconnect the chat session. */
+    disconnect(): void;
+    /** Tear down the session and clear subscribers. Do not reuse after this. */
+    destroy(): void;
+}
+
+export { ChatSession, ChatSessionOptions, ChatSessionState };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+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';
+
+/**
+ * ChatSession — Framework-agnostic text chat client for Pinecall agents.
+ *
+ * Mirrors VoiceSession's API patterns:
+ *   - session.subscribe(cb) + session.getState() — for React useSyncExternalStore
+ *   - session.addEventListener('status' | 'message' | 'error' | 'change', cb)
+ *
+ * Flow: GET /chat/token → WS /chat/ws?token=cht_xxx → bidirectional text chat
+ */
+
+declare class ChatSession extends EventTarget {
+    private opts;
+    private state;
+    private listeners;
+    private ws;
+    private reconnectTimer;
+    private msgCounter;
+    constructor(opts: ChatSessionOptions);
+    /** Read-only snapshot of current state (stable ref until next mutation). */
+    getState(): Readonly<ChatSessionState>;
+    /** Subscribe to ANY state change (for React useSyncExternalStore). */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    private setMessages;
+    connect(): Promise<void>;
+    private handleMessage;
+    /** Send a text message to the agent. */
+    send(text: string): void;
+    /**
+     * 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: string, value: string | null): void;
+    /** Disconnect the chat session. */
+    disconnect(): void;
+    /** Tear down the session and clear subscribers. Do not reuse after this. */
+    destroy(): void;
+}
+
+export { ChatSession, ChatSessionOptions, ChatSessionState };

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/react.cjs

@@ -0,0 +1,279 @@
+'use strict';
+
+var react = require('react');
+
+// src/react.tsx
+
+// src/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(
+        /\/$/,
+        ""
+      );
+      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 { 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;
+      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.listeners.clear();
+  }
+};
+
+// src/react.tsx
+function usePinecallChat(opts) {
+  const sessionRef = react.useRef(null);
+  if (!sessionRef.current) {
+    sessionRef.current = new ChatSession(opts);
+  }
+  const session = sessionRef.current;
+  const state = react.useSyncExternalStore(
+    react.useCallback((cb) => session.subscribe(cb), [session]),
+    react.useCallback(() => session.getState(), [session])
+  );
+  react.useEffect(() => {
+    if (opts.autoConnect !== false) {
+      session.connect();
+    }
+    return () => {
+      session.destroy();
+      sessionRef.current = null;
+    };
+  }, []);
+  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