@pinecall/chat-core 0.1.0

package/README.md

@@ -0,0 +1,240 @@
+<h1 align="center">@pinecall/chat-core</h1>
+
+<p align="center">
+  <strong>Text chat client for Pinecall voice agents.</strong><br/>
+  Framework-agnostic core + React hook. Zero dependencies.
+</p>
+
+<p align="center">
+  <a href="#install">Install</a> ·
+  <a href="#vanilla-js">Vanilla JS</a> ·
+  <a href="#react">React</a> ·
+  <a href="#api-reference">API</a>
+</p>
+
+---
+
+## Install
+
+```bash
+npm install @pinecall/chat-core
+```
+
+> **Browser-only.** Uses the native `WebSocket` and `EventTarget` APIs. Works in any modern browser, bundler, or SSR-hydrated app.
+
+---
+
+## Vanilla JS
+
+`ChatSession` is framework-agnostic — no React, no dependencies. Works in vanilla JS, Vue, Svelte, Angular, or any framework.
+
+```javascript
+import { ChatSession } from "@pinecall/chat-core";
+
+const chat = new ChatSession({ agent: "florencia" });
+
+// Listen to events via standard EventTarget
+chat.addEventListener("message", (e) => {
+  const msg = e.detail.message;
+  console.log(`${msg.role}: ${msg.text}`);
+});
+
+chat.addEventListener("status", (e) => {
+  console.log("Status:", e.detail.status);
+});
+
+// Connect and send
+await chat.connect();
+chat.send("Hola, quiero reservar un turno");
+```
+
+### Subscribe pattern (for reactive UI)
+
+```javascript
+// Works with any reactive system (MobX, signals, stores)
+const unsubscribe = chat.subscribe(() => {
+  const state = chat.getState();
+  console.log("Messages:", state.messages.length);
+  console.log("Typing:", state.typing);
+  console.log("Status:", state.status);
+});
+
+// Clean up
+unsubscribe();
+```
+
+### Dynamic context injection
+
+Inject live context into the LLM system prompt — form state, user selections, page data:
+
+```javascript
+chat.setContext("cart", JSON.stringify({
+  items: ["Corte de cabello", "Tinte"],
+  total: 85.00,
+}));
+
+// Clear a context key
+chat.setContext("cart", null);
+```
+
+---
+
+## React
+
+The `@pinecall/chat-core/react` subpath export provides a `usePinecallChat` hook. React is an **optional** peer dependency.
+
+```tsx
+import { usePinecallChat } from "@pinecall/chat-core/react";
+
+function Chat() {
+  const { messages, send, connected, typing, streamingText } = usePinecallChat({
+    agent: "florencia",
+  });
+
+  if (!connected) return <p>Connecting...</p>;
+
+  return (
+    <div>
+      {messages.map((m) => (
+        <p key={m.id}>
+          <strong>{m.role}:</strong> {m.text}
+          {m.isStreaming && "▊"}
+        </p>
+      ))}
+      {typing && <p>Bot is typing: {streamingText}▊</p>}
+      <input
+        placeholder="Type a message..."
+        onKeyDown={(e) => {
+          if (e.key === "Enter") {
+            send(e.currentTarget.value);
+            e.currentTarget.value = "";
+          }
+        }}
+      />
+    </div>
+  );
+}
+```
+
+### Hook options
+
+```typescript
+usePinecallChat({
+  agent: "florencia",           // Agent ID (required)
+  server: "https://voice.pinecall.io",  // Voice server URL (default)
+  autoConnect: true,            // Connect on mount (default: true)
+});
+```
+
+### Hook return
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `messages` | `ChatMessage[]` | All messages in the conversation |
+| `send` | `(text: string) => void` | Send a text message |
+| `connected` | `boolean` | `true` when connected to the server |
+| `typing` | `boolean` | `true` while the bot is streaming |
+| `streamingText` | `string` | Partial text of the current bot response |
+| `error` | `string \| null` | Current error, if any |
+| `setContext` | `(key, value) => void` | Inject dynamic context into the LLM prompt |
+| `connect` | `() => void` | Manually connect |
+| `disconnect` | `() => void` | Manually disconnect |
+
+---
+
+## API Reference
+
+### `ChatSession`
+
+```typescript
+import { ChatSession } from "@pinecall/chat-core";
+
+const chat = new ChatSession(options);
+```
+
+#### Options
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `agent` | `string` | ✅ | Agent slug (e.g. `"florencia"`, `"dev-berna-florencia"`) |
+| `server` | `string` | — | Voice server URL (default: `https://voice.pinecall.io`) |
+
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `connect()` | Connect to the chat server (fetches token → opens WebSocket) |
+| `disconnect()` | Close the WebSocket connection |
+| `destroy()` | Disconnect + clear all subscribers. Do not reuse. |
+| `send(text)` | Send a text message to the agent |
+| `setContext(key, value)` | Inject/update/clear keyed context in the LLM prompt |
+| `getState()` | Read-only snapshot of current state |
+| `subscribe(cb)` | Subscribe to state changes (for React `useSyncExternalStore`) |
+
+#### Events (via `EventTarget`)
+
+| Event | `detail` | When |
+|-------|----------|------|
+| `status` | `{ status }` | Connection status changed |
+| `message` | `{ message }` | New or updated message |
+| `error` | `{ error }` | Error occurred |
+| `change` | `{ state }` | Any state mutation (most general) |
+| `event` | raw server payload | Every raw server event |
+
+#### State shape
+
+```typescript
+interface ChatSessionState {
+  status: "idle" | "connecting" | "connected" | "error";
+  error: string | null;
+  messages: ChatMessage[];
+  typing: boolean;
+  streamingText: string;
+  sessionId: string | null;
+}
+
+interface ChatMessage {
+  id: number;
+  role: "user" | "bot";
+  text: string;
+  messageId?: string;    // server-assigned ID (bot messages)
+  isStreaming?: boolean;  // true while bot is still streaming
+}
+```
+
+---
+
+## Protocol
+
+```
+Browser                         Voice Server
+  │                                 │
+  ├─ GET /chat/token?agent_id=X ──→│  (fetch short-lived token)
+  │←── { token: "cht_xxx" } ──────│
+  │                                 │
+  ├─ WS /chat/ws?token=cht_xxx ──→│  (open WebSocket)
+  │←── { event: "chat.connected" }│
+  │                                 │
+  ├─→ { event: "message", text }   │  (user sends message)
+  │←── { event: "chat.token", … } │  (streaming tokens)
+  │←── { event: "chat.token", … } │
+  │←── { event: "chat.done", … }  │  (stream complete)
+  │                                 │
+  ├─→ { event: "set_context", … } │  (inject LLM context)
+```
+
+---
+
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [`@pinecall/sdk`](https://npmjs.com/package/@pinecall/sdk) | Server-side SDK — agent, call, tools, channels |
+| [`@pinecall/voice-core`](https://npmjs.com/package/@pinecall/voice-core) | WebRTC voice session (framework-agnostic) |
+| [`@pinecall/voice-widget`](https://npmjs.com/package/@pinecall/voice-widget) | React voice widget with animated orb UI |
+
+---
+
+## License
+
+MIT

package/dist/chunk-ST5DVE5W.js

@@ -0,0 +1,237 @@
+// 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();
+  }
+};
+
+export { ChatSession };
+//# sourceMappingURL=chunk-ST5DVE5W.js.map
+//# sourceMappingURL=chunk-ST5DVE5W.js.map

package/dist/chunk-ST5DVE5W.js.map

@@ -0,0 +1 @@
+{"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"]}