@pinecall/web 0.1.0

package/dist/types-CKfTJcH8.d.cts

@@ -0,0 +1,144 @@
+type SessionStatus = "idle" | "connecting" | "connected" | "error";
+type CallPhase = "idle" | "listening" | "speaking" | "pause" | "thinking";
+interface TranscriptMessage {
+    id: number;
+    role: "user" | "bot" | "system";
+    text: string;
+    /** User: STT partial (still typing) */
+    isInterim?: boolean;
+    /** Bot: TTS currently playing */
+    speaking?: boolean;
+    /** Bot: user interrupted the agent */
+    interrupted?: boolean;
+    /** Bot: server-assigned message ID for word-by-word tracking */
+    messageId?: string;
+    /** System: tool call ID (for updating with result) */
+    toolCallId?: string;
+}
+/**
+ * A tool call event received from the server-side LLM via DataChannel.
+ *
+ * The server sends `llm.tool_call` with a batch of tool calls.
+ * Each call has an `id`, `name`, and JSON `arguments`.
+ */
+interface ToolCallEvent {
+    /** Correlation ID — echoed in `llm.tool_result`. */
+    msgId: string;
+    /** Individual tool calls in this batch. */
+    calls: {
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }[];
+}
+/**
+ * A tool result event relayed from the server via DataChannel.
+ *
+ * Sent after the Node.js SDK agent executes a tool and returns the result.
+ */
+interface ToolResultEvent {
+    /** Tool call ID (matches `ToolCallEvent.calls[].id`). */
+    toolCallId: string;
+    /** Tool function name. */
+    name: string;
+    /** The result value (any JSON). */
+    result: unknown;
+}
+/**
+ * A pending tool UI entry tracked in session state.
+ *
+ * Created when `llm.tool_call` arrives for a tracked tool name.
+ * Updated with `result` when `llm.tool_result` arrives.
+ * Removed via `dismissTool()` after the user interacts.
+ */
+interface ToolUI {
+    /** Tool call ID. */
+    toolCallId: string;
+    /** Tool function name. */
+    name: string;
+    /** Parsed arguments from the LLM. */
+    arguments: Record<string, unknown>;
+    /** Result from server execution (`undefined` while pending). */
+    result?: unknown;
+    /** Timestamp when the tool call was received. */
+    timestamp: number;
+}
+interface VoiceSessionState {
+    status: SessionStatus;
+    error: string | null;
+    isMuted: boolean;
+    phase: CallPhase;
+    userSpeaking: boolean;
+    agentSpeaking: boolean;
+    duration: number;
+    messages: TranscriptMessage[];
+    /** Active tool UI entries (only for tracked tools). */
+    toolCalls: ToolUI[];
+    /**
+     * Idle warning state. Non-null when `session.idle_warning` fires,
+     * meaning the user hasn't spoken and the call will timeout soon.
+     * Contains the remaining seconds until timeout.
+     * Resets to `null` when the user speaks.
+     */
+    idleWarning: number | null;
+}
+interface VoiceSessionOptions {
+    /** Agent ID to connect to */
+    agent: string;
+    /**
+     * Pinecall API base URL for token exchange.
+     * Default: `"https://voice.pinecall.io"`.
+     *
+     * The SDK fetches a WebRTC token from `GET {server}/webrtc/token?agent_id=X`.
+     * The response includes the actual voice server URL for ICE + SDP negotiation.
+     */
+    server?: string;
+    /**
+     * Initial session config overrides sent in the WebRTC offer body.
+     * Supported keys: `voice`, `stt`, `language`, `turnDetection`, `greeting`.
+     *
+     * @example
+     * ```ts
+     * { voice: "alloy", stt: "deepgram", language: "es", greeting: "¡Hola!" }
+     * ```
+     */
+    config?: Record<string, unknown>;
+    /** Call metadata sent in the WebRTC offer body. */
+    metadata?: Record<string, unknown>;
+    /**
+     * Tool names to track for UI rendering.
+     *
+     * When listed, VoiceSession tracks `llm.tool_call` → `llm.tool_result`
+     * for these tools and exposes them in `state.toolCalls`.
+     * Tools NOT listed are ignored (handled silently by the server-side agent).
+     *
+     * @example
+     * ```ts
+     * trackedTools: ["getAvailableSlots", "showLocationMap"]
+     * ```
+     */
+    trackedTools?: string[];
+    /**
+     * Custom token provider — call your backend to generate tokens instead
+     * of hitting /webrtc/token directly. Keeps API keys server-side.
+     *
+     * When set, VoiceSession calls this function instead of
+     * `GET /webrtc/token?agent_id=X`. It should return the token response
+     * from your authenticated backend endpoint.
+     *
+     * @example
+     * ```ts
+     * tokenProvider: async () => {
+     *   const res = await fetch("/api/token?channel=webrtc", { credentials: "include" });
+     *   return res.json(); // { token, server, expires_in }
+     * }
+     * ```
+     */
+    tokenProvider?: () => Promise<{
+        token: string;
+        server: string;
+        expires_in?: number;
+    }>;
+}
+
+export type { CallPhase as C, SessionStatus as S, ToolCallEvent as T, VoiceSessionOptions as V, VoiceSessionState as a, ToolResultEvent as b, ToolUI as c, TranscriptMessage as d };

package/dist/types-CKfTJcH8.d.ts

@@ -0,0 +1,144 @@
+type SessionStatus = "idle" | "connecting" | "connected" | "error";
+type CallPhase = "idle" | "listening" | "speaking" | "pause" | "thinking";
+interface TranscriptMessage {
+    id: number;
+    role: "user" | "bot" | "system";
+    text: string;
+    /** User: STT partial (still typing) */
+    isInterim?: boolean;
+    /** Bot: TTS currently playing */
+    speaking?: boolean;
+    /** Bot: user interrupted the agent */
+    interrupted?: boolean;
+    /** Bot: server-assigned message ID for word-by-word tracking */
+    messageId?: string;
+    /** System: tool call ID (for updating with result) */
+    toolCallId?: string;
+}
+/**
+ * A tool call event received from the server-side LLM via DataChannel.
+ *
+ * The server sends `llm.tool_call` with a batch of tool calls.
+ * Each call has an `id`, `name`, and JSON `arguments`.
+ */
+interface ToolCallEvent {
+    /** Correlation ID — echoed in `llm.tool_result`. */
+    msgId: string;
+    /** Individual tool calls in this batch. */
+    calls: {
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }[];
+}
+/**
+ * A tool result event relayed from the server via DataChannel.
+ *
+ * Sent after the Node.js SDK agent executes a tool and returns the result.
+ */
+interface ToolResultEvent {
+    /** Tool call ID (matches `ToolCallEvent.calls[].id`). */
+    toolCallId: string;
+    /** Tool function name. */
+    name: string;
+    /** The result value (any JSON). */
+    result: unknown;
+}
+/**
+ * A pending tool UI entry tracked in session state.
+ *
+ * Created when `llm.tool_call` arrives for a tracked tool name.
+ * Updated with `result` when `llm.tool_result` arrives.
+ * Removed via `dismissTool()` after the user interacts.
+ */
+interface ToolUI {
+    /** Tool call ID. */
+    toolCallId: string;
+    /** Tool function name. */
+    name: string;
+    /** Parsed arguments from the LLM. */
+    arguments: Record<string, unknown>;
+    /** Result from server execution (`undefined` while pending). */
+    result?: unknown;
+    /** Timestamp when the tool call was received. */
+    timestamp: number;
+}
+interface VoiceSessionState {
+    status: SessionStatus;
+    error: string | null;
+    isMuted: boolean;
+    phase: CallPhase;
+    userSpeaking: boolean;
+    agentSpeaking: boolean;
+    duration: number;
+    messages: TranscriptMessage[];
+    /** Active tool UI entries (only for tracked tools). */
+    toolCalls: ToolUI[];
+    /**
+     * Idle warning state. Non-null when `session.idle_warning` fires,
+     * meaning the user hasn't spoken and the call will timeout soon.
+     * Contains the remaining seconds until timeout.
+     * Resets to `null` when the user speaks.
+     */
+    idleWarning: number | null;
+}
+interface VoiceSessionOptions {
+    /** Agent ID to connect to */
+    agent: string;
+    /**
+     * Pinecall API base URL for token exchange.
+     * Default: `"https://voice.pinecall.io"`.
+     *
+     * The SDK fetches a WebRTC token from `GET {server}/webrtc/token?agent_id=X`.
+     * The response includes the actual voice server URL for ICE + SDP negotiation.
+     */
+    server?: string;
+    /**
+     * Initial session config overrides sent in the WebRTC offer body.
+     * Supported keys: `voice`, `stt`, `language`, `turnDetection`, `greeting`.
+     *
+     * @example
+     * ```ts
+     * { voice: "alloy", stt: "deepgram", language: "es", greeting: "¡Hola!" }
+     * ```
+     */
+    config?: Record<string, unknown>;
+    /** Call metadata sent in the WebRTC offer body. */
+    metadata?: Record<string, unknown>;
+    /**
+     * Tool names to track for UI rendering.
+     *
+     * When listed, VoiceSession tracks `llm.tool_call` → `llm.tool_result`
+     * for these tools and exposes them in `state.toolCalls`.
+     * Tools NOT listed are ignored (handled silently by the server-side agent).
+     *
+     * @example
+     * ```ts
+     * trackedTools: ["getAvailableSlots", "showLocationMap"]
+     * ```
+     */
+    trackedTools?: string[];
+    /**
+     * Custom token provider — call your backend to generate tokens instead
+     * of hitting /webrtc/token directly. Keeps API keys server-side.
+     *
+     * When set, VoiceSession calls this function instead of
+     * `GET /webrtc/token?agent_id=X`. It should return the token response
+     * from your authenticated backend endpoint.
+     *
+     * @example
+     * ```ts
+     * tokenProvider: async () => {
+     *   const res = await fetch("/api/token?channel=webrtc", { credentials: "include" });
+     *   return res.json(); // { token, server, expires_in }
+     * }
+     * ```
+     */
+    tokenProvider?: () => Promise<{
+        token: string;
+        server: string;
+        expires_in?: number;
+    }>;
+}
+
+export type { CallPhase as C, SessionStatus as S, ToolCallEvent as T, VoiceSessionOptions as V, VoiceSessionState as a, ToolResultEvent as b, ToolUI as c, TranscriptMessage as d };

package/dist/types-W0229iUB.d.cts

@@ -0,0 +1,61 @@
+/**
+ * @pinecall/web/chat — Type definitions.
+ */
+/** Chat session connection status. */
+type ChatStatus = "idle" | "connecting" | "connected" | "error" | "destroyed";
+/** A single message in the conversation. */
+interface ChatMessage {
+    id: number;
+    role: "user" | "bot";
+    text: string;
+    /** Server-assigned message ID (for bot messages). */
+    messageId?: string;
+    /** True while the bot is still streaming this message. */
+    isStreaming?: boolean;
+}
+/** Full state of a ChatSession (immutable snapshots). */
+interface ChatSessionState {
+    status: ChatStatus;
+    error: string | null;
+    /** All messages in the conversation. */
+    messages: ChatMessage[];
+    /** True while the bot is streaming a response. */
+    typing: boolean;
+    /** Partial text of the current bot response being streamed. */
+    streamingText: string;
+    /** Session ID assigned by the server. */
+    sessionId: string | null;
+}
+/** Options for creating a ChatSession. */
+interface ChatSessionOptions {
+    /** Agent ID to connect to (e.g. "florencia", "dev-berna-florencia"). */
+    agent: string;
+    /**
+     * Voice server URL.
+     * The SDK fetches a chat token from `GET {server}/chat/token?agent_id=X`.
+     * Then opens a WebSocket to `{server}/chat/ws?token=cht_xxx`.
+     *
+     * @default "https://voice.pinecall.io"
+     */
+    server?: string;
+    /**
+     * Custom token provider — call your backend to generate tokens instead
+     * of hitting /chat/token directly. Keeps API keys server-side.
+     *
+     * @example
+     * ```ts
+     * tokenProvider: async () => {
+     *   const res = await fetch("/api/token?channel=chat");
+     *   return res.json(); // { token, server }
+     * }
+     * ```
+     */
+    tokenProvider?: () => Promise<{
+        token: string;
+        server: string;
+    }>;
+}
+/** Events emitted by ChatSession via EventTarget. */
+type ChatEventType = "status" | "message" | "error" | "change";
+
+export type { ChatSessionOptions as C, ChatSessionState as a, ChatEventType as b, ChatMessage as c, ChatStatus as d };

package/dist/types-W0229iUB.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @pinecall/web/chat — Type definitions.
+ */
+/** Chat session connection status. */
+type ChatStatus = "idle" | "connecting" | "connected" | "error" | "destroyed";
+/** A single message in the conversation. */
+interface ChatMessage {
+    id: number;
+    role: "user" | "bot";
+    text: string;
+    /** Server-assigned message ID (for bot messages). */
+    messageId?: string;
+    /** True while the bot is still streaming this message. */
+    isStreaming?: boolean;
+}
+/** Full state of a ChatSession (immutable snapshots). */
+interface ChatSessionState {
+    status: ChatStatus;
+    error: string | null;
+    /** All messages in the conversation. */
+    messages: ChatMessage[];
+    /** True while the bot is streaming a response. */
+    typing: boolean;
+    /** Partial text of the current bot response being streamed. */
+    streamingText: string;
+    /** Session ID assigned by the server. */
+    sessionId: string | null;
+}
+/** Options for creating a ChatSession. */
+interface ChatSessionOptions {
+    /** Agent ID to connect to (e.g. "florencia", "dev-berna-florencia"). */
+    agent: string;
+    /**
+     * Voice server URL.
+     * The SDK fetches a chat token from `GET {server}/chat/token?agent_id=X`.
+     * Then opens a WebSocket to `{server}/chat/ws?token=cht_xxx`.
+     *
+     * @default "https://voice.pinecall.io"
+     */
+    server?: string;
+    /**
+     * Custom token provider — call your backend to generate tokens instead
+     * of hitting /chat/token directly. Keeps API keys server-side.
+     *
+     * @example
+     * ```ts
+     * tokenProvider: async () => {
+     *   const res = await fetch("/api/token?channel=chat");
+     *   return res.json(); // { token, server }
+     * }
+     * ```
+     */
+    tokenProvider?: () => Promise<{
+        token: string;
+        server: string;
+    }>;
+}
+/** Events emitted by ChatSession via EventTarget. */
+type ChatEventType = "status" | "message" | "error" | "change";
+
+export type { ChatSessionOptions as C, ChatSessionState as a, ChatEventType as b, ChatMessage as c, ChatStatus as d };

package/package.json

@@ -0,0 +1,113 @@
+{
+  "name": "@pinecall/web",
+  "version": "0.1.0",
+  "description": "Pinecall web client — WebRTC voice, text chat, and React widgets for Pinecall agents",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./core": {
+      "import": {
+        "types": "./dist/core/index.d.ts",
+        "default": "./dist/core/index.js"
+      },
+      "require": {
+        "types": "./dist/core/index.d.cts",
+        "default": "./dist/core/index.cjs"
+      }
+    },
+    "./chat": {
+      "import": {
+        "types": "./dist/chat/index.d.ts",
+        "default": "./dist/chat/index.js"
+      },
+      "require": {
+        "types": "./dist/chat/index.d.cts",
+        "default": "./dist/chat/index.cjs"
+      }
+    },
+    "./chat/react": {
+      "import": {
+        "types": "./dist/chat/react.d.ts",
+        "default": "./dist/chat/react.js"
+      },
+      "require": {
+        "types": "./dist/chat/react.d.cts",
+        "default": "./dist/chat/react.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "release": "pnpm build && npm publish"
+  },
+  "dependencies": {
+    "marked": "^18.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "webrtc",
+    "voice",
+    "chat",
+    "ai",
+    "agent",
+    "react",
+    "widget",
+    "pinecall"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pinecall/web"
+  },
+  "packageManager": "pnpm@10.2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}