@pinecall/web 0.1.0

package/README.md

@@ -0,0 +1,168 @@
+# @pinecall/web
+
+[![npm](https://img.shields.io/npm/v/@pinecall/web)](https://www.npmjs.com/package/@pinecall/web)
+
+The web client for [Pinecall](https://pinecall.io) agents — real-time WebRTC **voice**, text **chat**, and drop-in **React** widgets, in one package.
+
+> **Migrating from `@pinecall/voice-core` / `@pinecall/voice-widget` / `@pinecall/chat-core`?** They are now a single package. See [Entry points](#entry-points) below — the React widget moves to the package root, vanilla voice to `/core`, and chat to `/chat` + `/chat/react`.
+
+## Install
+
+```bash
+npm install @pinecall/web
+# React is a peer dep — only needed for the widget + chat/react entries
+npm install react react-dom
+```
+
+## Entry points
+
+| Import | What | Needs React |
+|--------|------|-------------|
+| `@pinecall/web` | React widgets — `VoiceWidget`, `ContactHub`, `ChatView`, `useVoice`, `useVoiceSession`, presets | ✅ |
+| `@pinecall/web/core` | `VoiceSession` — framework-agnostic WebRTC voice client | ❌ |
+| `@pinecall/web/chat` | `ChatSession` — framework-agnostic text chat client | ❌ |
+| `@pinecall/web/chat/react` | `usePinecallChat` — React hook over `ChatSession` | ✅ |
+
+## Quick Start
+
+### React widget
+
+```tsx
+import { VoiceWidget } from "@pinecall/web";
+
+<VoiceWidget agent="mara" name="Mara" preset="midnight" />
+```
+
+### Vanilla voice (any framework)
+
+```ts
+import { VoiceSession } from "@pinecall/web/core";
+
+const session = new VoiceSession({ agent: "mara" });
+session.subscribe(() => console.log(session.getState()));
+await session.connect();
+```
+
+### Chat hook
+
+```tsx
+import { usePinecallChat } from "@pinecall/web/chat/react";
+
+const chat = usePinecallChat({ agent: "florencia" });
+```
+
+## Structure
+
+```
+web/
+├── src/
+│   ├── index.ts        @pinecall/web        — React widgets barrel
+│   ├── core/           @pinecall/web/core   — VoiceSession (vanilla)
+│   ├── chat/           @pinecall/web/chat[/react] — ChatSession + React hook
+│   └── widget/         React components (VoiceWidget, ContactHub, ChatView…)
+├── docs/               diagrams + legacy changelogs
+├── examples/react/     Demo app with preset switcher
+├── tsup.config.ts      Build (4 entries → ESM + CJS + DTS)
+└── tsconfig.json
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm build       # build all 4 entries (ESM + CJS + DTS)
+pnpm dev         # tsup watch
+pnpm typecheck
+```
+
+## Publishing
+
+```bash
+npm version <patch|minor|major>
+pnpm release     # build + npm publish
+```
+
+## Widget Theme & Orb States
+
+The `<VoiceWidget>` orb cycles through visual states as the session progresses. Each state has a configurable color (RGB triplet):
+
+| Orb State | CSS Class | Theme Property | Default Color | When |
+|-----------|-----------|---------------|---------------|------|
+| Idle | — | `orbFrom`/`orbMid`/`orbTo` | Pearl gradient | Not connected |
+| Connecting | `.connecting` | `colorConnecting` | `245, 158, 11` (amber) | Establishing WebRTC |
+| Active | `.active` | `colorActive` | `76, 175, 80` (green) | Connected, waiting |
+| User speaking | `.user-speaking` | `colorUserSpeaking` | `52, 211, 153` (emerald) | User talking |
+| Agent speaking | `.speaking` | `colorSpeaking` | `248, 113, 113` (rose) | Agent talking |
+| Thinking | `.thinking` | `colorThinking` | `139, 92, 246` (violet) | Processing |
+| **Idle warning** | `.idle-warning` | `colorWarning` | `255, 160, 0` (orange) | User silent too long, call will timeout |
+
+### Idle Warning
+
+When the server emits `session.idle_warning`, the orb switches to the `idle-warning` state — a blinking amber/orange animation. This warns the user that the call will end due to inactivity.
+
+```tsx
+// Customize the warning color via theme
+<VoiceWidget
+  agent="mara"
+  theme={{ colorWarning: "255, 60, 60" }}  // red warning
+/>
+```
+
+The idle warning is cleared when:
+- The user starts speaking
+- The session disconnects
+- `session.timeout` fires (auto-disconnect)
+
+### Theme Presets
+
+5 built-in presets: `dark` (default), `midnight`, `aurora`, `sunset`, `light`.
+
+```tsx
+<VoiceWidget agent="mara" preset="midnight" />
+```
+
+### Custom Theme
+
+Override individual colors on top of any preset:
+
+```tsx
+<VoiceWidget
+  agent="mara"
+  preset="dark"
+  theme={{
+    colorActive: "0, 200, 100",
+    colorWarning: "255, 80, 0",
+    ringColor: "100, 100, 200",
+  }}
+/>
+```
+
+All theme properties accept **RGB triplets** (e.g. `"255, 160, 0"`) for use with CSS `rgba()`.
+
+## Session Limits (via `@pinecall/sdk`)
+
+Session limits are configured on the agent (server-side SDK) and flow through to the WebRTC widget automatically:
+
+```typescript
+// Server-side (agent.js)
+const agent = pc.deploy("my-agent", {
+  // ...voice, stt, llm config...
+  sessionLimits: {
+    idle_timeout_seconds: 20,   // hang up after 20s of silence
+    idle_warning_seconds: 10,   // warn 10s before timeout
+    max_duration_seconds: 600,  // hard cap at 10 minutes
+  },
+});
+
+agent.on("session.idle_warning", (event, call) => {
+  call.say("Are you still there?");
+});
+```
+
+The widget receives `session.idle_warning` via DataChannel and:
+1. Switches the orb to the **idle-warning** state (blinking `colorWarning`)
+2. On `session.timeout`, auto-disconnects and resets to idle
+
+## License
+
+MIT

package/dist/chat/index.cjs

@@ -0,0 +1,250 @@
+'use strict';
+
+// 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();
+  }
+};
+
+exports.ChatSession = ChatSession;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/chat/index.cjs.map

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

package/dist/chat/index.d.cts

@@ -0,0 +1,48 @@
+import { C as ChatSessionOptions, a as ChatSessionState } from '../types-W0229iUB.cjs';
+export { b as ChatEventType, c as ChatMessage, d as ChatStatus } from '../types-W0229iUB.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/chat/index.d.ts

@@ -0,0 +1,48 @@
+import { C as ChatSessionOptions, a as ChatSessionState } from '../types-W0229iUB.js';
+export { b as ChatEventType, c as ChatMessage, d as ChatStatus } from '../types-W0229iUB.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/chat/index.js

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

package/dist/chat/index.js.map

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