@pinecall/web 0.1.0

package/dist/core/index.d.cts

@@ -0,0 +1,100 @@
+import { V as VoiceSessionOptions, a as VoiceSessionState } from '../types-CKfTJcH8.cjs';
+export { C as CallPhase, S as SessionStatus, T as ToolCallEvent, b as ToolResultEvent, c as ToolUI, d as TranscriptMessage } from '../types-CKfTJcH8.cjs';
+
+/**
+ * VoiceSession — Framework-agnostic WebRTC voice client for Pinecall agents.
+ *
+ * Extends EventTarget. Two ways to consume:
+ *   1. session.subscribe(cb) + session.getState() — for React useSyncExternalStore
+ *   2. session.addEventListener('status' | 'phase' | 'message' | 'error' | 'event' | 'change', cb)
+ *
+ * WebRTC flow: token → ICE → mic → PeerConnection → DataChannel → SDP offer/answer
+ */
+
+declare class VoiceSession extends EventTarget {
+    private opts;
+    private state;
+    private listeners;
+    private pc;
+    private stream;
+    private audio;
+    private dc;
+    private timer;
+    private ping;
+    private startedAt;
+    private botWords;
+    constructor(opts: VoiceSessionOptions);
+    /** Read-only snapshot of current state (stable reference until next mutation). */
+    getState(): Readonly<VoiceSessionState>;
+    /** Subscribe to ANY state change (for React useSyncExternalStore). */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    private setMessages;
+    private cleanup;
+    connect(): Promise<void>;
+    private handleDataChannelMessage;
+    disconnect(): void;
+    toggleMute(): void;
+    setMuted(muted: boolean): void;
+    /**
+     * Send a configuration update via DataChannel during an active call.
+     * Use this for mid-call language/voice/STT switching.
+     *
+     * @example
+     * ```ts
+     * session.configure({ voice: "coral", stt: "deepgram", language: "es" });
+     * ```
+     */
+    configure(config: Record<string, unknown>): void;
+    /**
+     * Inject text into the conversation as if the user spoke it.
+     *
+     * Use this for click-based interactions in tool UIs (e.g., selecting a
+     * calendar slot). The server routes the text to the LLM, producing the
+     * same effect as the user speaking.
+     *
+     * @example
+     * ```ts
+     * session.sendText("I'd like the 10:00 AM slot");
+     * ```
+     */
+    sendText(text: string): void;
+    /**
+     * Remove a tool UI entry from state.
+     *
+     * Call this after the user interacts with a tool UI (e.g., selects a slot)
+     * to dismiss the rendered component from the transcript.
+     */
+    dismissTool(toolCallId: string): void;
+    /**
+     * Set or clear a keyed context block in the LLM system prompt.
+     *
+     * Use this to inject dynamic UI state (form data, selections, etc.)
+     * into the agent's prompt so it can see what the user is doing on screen.
+     * Each key is a named section — setting the same key replaces its value.
+     * Pass `null` to remove a context key.
+     *
+     * @example
+     * ```ts
+     * // Inject form state so the agent sees what's filled
+     * session.setContext("contact_form", JSON.stringify({
+     *   name: "John",
+     *   email: "john@example.com",
+     *   phone: "",
+     * }));
+     *
+     * // Clear when form is submitted
+     * session.setContext("contact_form", null);
+     * ```
+     */
+    setContext(key: string, value: string | null): void;
+    /**
+     * Update session options before the next `connect()` call.
+     * Has no effect on an already-connected session — use `configure()` for that.
+     */
+    updateOptions(patch: Partial<Pick<VoiceSessionOptions, "config" | "metadata">>): void;
+    /** Tear down the session and clear subscribers. After this, do not reuse. */
+    destroy(): void;
+}
+
+export { VoiceSession, VoiceSessionOptions, VoiceSessionState };

package/dist/core/index.d.ts

@@ -0,0 +1,100 @@
+import { V as VoiceSessionOptions, a as VoiceSessionState } from '../types-CKfTJcH8.js';
+export { C as CallPhase, S as SessionStatus, T as ToolCallEvent, b as ToolResultEvent, c as ToolUI, d as TranscriptMessage } from '../types-CKfTJcH8.js';
+
+/**
+ * VoiceSession — Framework-agnostic WebRTC voice client for Pinecall agents.
+ *
+ * Extends EventTarget. Two ways to consume:
+ *   1. session.subscribe(cb) + session.getState() — for React useSyncExternalStore
+ *   2. session.addEventListener('status' | 'phase' | 'message' | 'error' | 'event' | 'change', cb)
+ *
+ * WebRTC flow: token → ICE → mic → PeerConnection → DataChannel → SDP offer/answer
+ */
+
+declare class VoiceSession extends EventTarget {
+    private opts;
+    private state;
+    private listeners;
+    private pc;
+    private stream;
+    private audio;
+    private dc;
+    private timer;
+    private ping;
+    private startedAt;
+    private botWords;
+    constructor(opts: VoiceSessionOptions);
+    /** Read-only snapshot of current state (stable reference until next mutation). */
+    getState(): Readonly<VoiceSessionState>;
+    /** Subscribe to ANY state change (for React useSyncExternalStore). */
+    subscribe(listener: () => void): () => void;
+    private setState;
+    private setMessages;
+    private cleanup;
+    connect(): Promise<void>;
+    private handleDataChannelMessage;
+    disconnect(): void;
+    toggleMute(): void;
+    setMuted(muted: boolean): void;
+    /**
+     * Send a configuration update via DataChannel during an active call.
+     * Use this for mid-call language/voice/STT switching.
+     *
+     * @example
+     * ```ts
+     * session.configure({ voice: "coral", stt: "deepgram", language: "es" });
+     * ```
+     */
+    configure(config: Record<string, unknown>): void;
+    /**
+     * Inject text into the conversation as if the user spoke it.
+     *
+     * Use this for click-based interactions in tool UIs (e.g., selecting a
+     * calendar slot). The server routes the text to the LLM, producing the
+     * same effect as the user speaking.
+     *
+     * @example
+     * ```ts
+     * session.sendText("I'd like the 10:00 AM slot");
+     * ```
+     */
+    sendText(text: string): void;
+    /**
+     * Remove a tool UI entry from state.
+     *
+     * Call this after the user interacts with a tool UI (e.g., selects a slot)
+     * to dismiss the rendered component from the transcript.
+     */
+    dismissTool(toolCallId: string): void;
+    /**
+     * Set or clear a keyed context block in the LLM system prompt.
+     *
+     * Use this to inject dynamic UI state (form data, selections, etc.)
+     * into the agent's prompt so it can see what the user is doing on screen.
+     * Each key is a named section — setting the same key replaces its value.
+     * Pass `null` to remove a context key.
+     *
+     * @example
+     * ```ts
+     * // Inject form state so the agent sees what's filled
+     * session.setContext("contact_form", JSON.stringify({
+     *   name: "John",
+     *   email: "john@example.com",
+     *   phone: "",
+     * }));
+     *
+     * // Clear when form is submitted
+     * session.setContext("contact_form", null);
+     * ```
+     */
+    setContext(key: string, value: string | null): void;
+    /**
+     * Update session options before the next `connect()` call.
+     * Has no effect on an already-connected session — use `configure()` for that.
+     */
+    updateOptions(patch: Partial<Pick<VoiceSessionOptions, "config" | "metadata">>): void;
+    /** Tear down the session and clear subscribers. After this, do not reuse. */
+    destroy(): void;
+}
+
+export { VoiceSession, VoiceSessionOptions, VoiceSessionState };

package/dist/core/index.js

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

package/dist/core/index.js.map

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