@talqing/react 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Talqing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# @talqing/react
+
+React bindings for Talqing web calls: join a voice or video agent from a browser,
+attach a photo mid-call, share a screen, read and write the session's userdata,
+and answer the agent when a tool calls back into your page.
+
+```bash
+npm install @talqing/react
+```
+
+npm 7+ and pnpm install the peers for you — `@talqing/client`, `@talqing/sdk`,
+`livekit-client`, `@livekit/components-react`, `react` and `react-dom`. Yarn only
+warns, so on Yarn:
+
+```bash
+yarn add @talqing/react @talqing/client @talqing/sdk livekit-client @livekit/components-react
+```
+
+## Mint the token on your server
+
+`POST /v1/calls/token` needs the **editor** role, and a Talqing credential that
+can mint a call token can also create and delete agents, read every transcript
+and spend the workspace's credits. **Never ship one to a browser.**
+
+`contact_key` and `userdata` are the second reason. `contact_key` decides whose
+history the call resumes and `userdata` is merged onto that person's record — so
+on a server-minted call, the browser cannot choose either. They never leave your
+backend.
+
+```ts
+// app/api/talqing-token/route.ts — your server, with @talqing/sdk
+import { TalqingClient } from "@talqing/sdk";
+
+const talqing = new TalqingClient({
+  baseUrl: "https://api.in.talqing.com",
+  token: process.env.TALQING_API_TOKEN,
+});
+
+export async function POST(request: Request) {
+  const user = await authenticate(request); // your sign-in, not ours
+  if (!user) return new Response("unauthorized", { status: 401 });
+
+  const call = await talqing.calls.token({
+    tokenRequest: {
+      agent_id: process.env.TALQING_AGENT_ID,
+      contact_key: user.id,
+      userdata: { name: user.name, plan: user.plan },
+    },
+  });
+
+  if (call.warnings.length) console.warn(call.warnings); // stored nowhere else
+  return Response.json({
+    server_url: call.server_url,
+    participant_token: call.participant_token,
+  });
+}
+```
+
+## Join from the browser
+
+```tsx
+"use client";
+import { useEffect } from "react";
+import {
+  TalqingSessionProvider,
+  useAgent,
+  useSessionMessages,
+  useTalqingConnection,
+  useTalqingSession,
+} from "@talqing/react";
+
+export function CallSession({ onLeave }: { onLeave: () => void }) {
+  const session = useTalqingSession({
+    fetchToken: async () => {
+      const response = await fetch("/api/talqing-token", { method: "POST" });
+      return await response.json();
+    },
+  });
+
+  useEffect(() => {
+    // The token is minted inside start(), so an API refusal — an unpublished
+    // agent, a workspace out of credits — arrives here.
+    session.start().catch(onLeave);
+    return () => void session.end();
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- mount and unmount only
+  }, []);
+
+  return (
+    <TalqingSessionProvider session={session}>
+      <CallUI onLeave={onLeave} />
+    </TalqingSessionProvider>
+  );
+}
+
+function CallUI({ onLeave }: { onLeave: () => void }) {
+  const { isConnected, end } = useTalqingConnection();
+  const agent = useAgent();
+  const { messages } = useSessionMessages();
+
+  return (
+    <div>
+      <p>{isConnected ? `agent: ${agent.state}` : "connecting…"}</p>
+      {messages.map((message) => (
+        <p key={message.id}>
+          <b>{message.from?.isLocal ? "You" : "Agent"}</b> {message.message}
+        </p>
+      ))}
+      <button onClick={() => { void end(); onLeave(); }}>End call</button>
+    </div>
+  );
+}
+```
+
+**One session is one call.** Start it when the component mounts and end it on the
+way out. Place a second call by mounting a second session — give the component a
+`key` that changes per call. A finished session's token names the room that call
+used, and the API will not let a second call rejoin it.
+
+**The room's state is not the agent's state.** `isConnected` goes true partway
+through the join, while the agent is still starting up. Wait for
+`useAgent().state === "listening"` before telling the caller to speak.
+
+## The three ways to authorize a call
+
+Exactly one per call, and passing two is a type error rather than a precedence
+rule.
+
+| | When |
+| --- | --- |
+| `{ token }` | Your server already minted, and you forwarded `server_url` and `participant_token`. |
+| `{ fetchToken }` | Your endpoint mints. Called once, when the call starts. |
+| `{ client, agentId, callOptions }` | **Trusted first-party surfaces only.** Mints from the browser with a `TalqingClient` you already hold — an app same-origin with the API, signed in as a real editor. Not for a widget you embed for your customers. |
+
+`callOptions` is on the third branch alone, because it carries `contact_key` and
+`userdata`. `roomOptions` rides on all three.
+
+The third branch is the only one where this browser is what minted, so it is the
+only one where `session.warnings` fills in. On the other two your own server
+received them.
+
+## What else is here
+
+| | |
+| --- | --- |
+| `useTalqingImages(room)` | Send a photo to the agent mid-call and follow what became of it — four states, because the agent can go away mid-upload. |
+| `useTalqingScreenShare()` | Share a screen on the settings that keep it legible. `start()` must run inside a click. |
+| `useTalqingUserdata()` | Read and write the live session's userdata over RPC. |
+| `useTalqingRpcHandlers(handlers)` | Answer a tool's `frontend_rpc` calls into your page. `useTalqingFrontendRpcs()` is the declarative version. |
+| `useTalqingAvatarTrack()` | The track to render for a video agent. |
+| `TALQING_SCREEN_SHARE_CAPTURE` / `_PUBLISH` | The measured capture settings, exported so you can read them. |
+
+## The escape hatch
+
+**This layer only ever adds.** Anything LiveKit can do, you can do — take
+`useTalqingConnection().room` and use `livekit-client` directly. We never remove
+a capability to make our own surface look tidier, and we do not re-wrap LiveKit
+to rename it: `useAgent`, `useSessionMessages` and `VideoTrack` are re-exported
+here under their own names, and they are the same modules
+`@livekit/components-react` exports.
+
+That guarantee is why `livekit-client` and `@livekit/components-react` are peer
+dependencies rather than dependencies: the `Room` we hand you must be the same
+class your own imports and `instanceof` resolve to.
+
+## Without React
+
+[`@talqing/client`](https://www.npmjs.com/package/@talqing/client) is the same
+call protocol as plain functions over a `Room` you manage yourself.
+[`@talqing/sdk`](https://www.npmjs.com/package/@talqing/sdk) is the rest of the
+API. Full reference: <https://docs.talqing.com/sdks/react>.

package/dist/cjs/images.d.ts

@@ -0,0 +1,17 @@
+import type { Room } from "livekit-client";
+import { type TalqingSentImage } from "@talqing/client";
+/** Send images to the agent on this call, and follow what became of each.
+ *
+ *  `send` resolves once the bytes are on their way; the outcome arrives on the
+ *  returned list, which is what a thumbnail should render.
+ *
+ *  Takes the `Room` rather than reading it from the session context: a byte
+ *  stream and an RPC handler are room-level things, and passing the room keeps
+ *  this usable from a surface that manages its own connection —
+ *  `useTalqingConnection().room` inside a provider, or the Room you built. */
+export declare function useTalqingImages(room: Room | null | undefined): {
+    send: (file: File) => Promise<TalqingSentImage>;
+    sent: TalqingSentImage[];
+    clear: () => void;
+};
+//# sourceMappingURL=images.d.ts.map

package/dist/cjs/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/images.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;8EAQ8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS;iBA4C7C,IAAI,KAAG,OAAO,CAAC,gBAAgB,CAAC;;;EAgChD"}

package/dist/cjs/images.js

@@ -0,0 +1,68 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTalqingImages = useTalqingImages;
+const react_1 = require("react");
+const client_1 = require("@talqing/client");
+/** Send images to the agent on this call, and follow what became of each.
+ *
+ *  `send` resolves once the bytes are on their way; the outcome arrives on the
+ *  returned list, which is what a thumbnail should render.
+ *
+ *  Takes the `Room` rather than reading it from the session context: a byte
+ *  stream and an RPC handler are room-level things, and passing the room keeps
+ *  this usable from a surface that manages its own connection —
+ *  `useTalqingConnection().room` inside a provider, or the Room you built. */
+function useTalqingImages(room) {
+    const [sent, setSent] = (0, react_1.useState)([]);
+    const timers = (0, react_1.useRef)(new Map());
+    const settle = (0, react_1.useCallback)((streamId, patch) => {
+        const timer = timers.current.get(streamId);
+        if (timer) {
+            clearTimeout(timer);
+            timers.current.delete(streamId);
+        }
+        setSent((images) => images.map((image) => (image.streamId === streamId ? { ...image, ...patch } : image)));
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (!room)
+            return;
+        return (0, client_1.onTalqingImageResult)(room, ({ streamId, ok, error }) => settle(streamId, { status: ok ? "sent" : "failed", error }));
+    }, [room, settle]);
+    const pending = timers.current;
+    (0, react_1.useEffect)(() => () => {
+        pending.forEach(clearTimeout);
+        pending.clear();
+    }, [pending]);
+    /* Each thumbnail is an object URL over the downscaled blob, and each pins that
+       blob in memory until it is revoked. This hook is mounted per call, so
+       without this every call's images would be held for the life of the tab. */
+    const previews = (0, react_1.useRef)([]);
+    (0, react_1.useEffect)(() => () => {
+        previews.current.forEach(URL.revokeObjectURL);
+        previews.current = [];
+    }, []);
+    const send = (0, react_1.useCallback)(async (file) => {
+        if (!room)
+            throw new Error("the call is not connected");
+        const image = await (0, client_1.sendTalqingImage)(room, file);
+        previews.current.push(image.previewUrl);
+        setSent((images) => [...images, image]);
+        timers.current.set(image.streamId, setTimeout(() => settle(image.streamId, {
+            status: "unknown",
+            // Four states, not two: the one people forget is the agent going
+            // away mid-upload, where no ack is ever coming.
+            error: "we did not hear back — the agent may not have received it",
+        }), client_1.TALQING_IMAGE_ACK_TIMEOUT_MS));
+        return image;
+    }, [room, settle]);
+    const clear = (0, react_1.useCallback)(() => {
+        setSent((images) => {
+            images.forEach((image) => URL.revokeObjectURL(image.previewUrl));
+            previews.current = [];
+            return [];
+        });
+    }, []);
+    return { send, sent, clear };
+}
+//# sourceMappingURL=images.js.map

package/dist/cjs/images.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,10 @@
+export { TalqingSessionProvider, useTalqingConnection, useTalqingSession, } from "./session.js";
+export type { TalqingCallOptions, TalqingSession, TalqingSessionOptions, } from "./session.js";
+export { useTalqingUserdata } from "./userdata.js";
+export { useTalqingImages } from "./images.js";
+export { useTalqingFrontendRpcs, useTalqingRpcHandlers } from "./rpc.js";
+export { useTalqingAvatarTrack, useTalqingScreenShare } from "./media.js";
+export * from "@talqing/client";
+export { useAgent, useSessionMessages, VideoTrack, } from "@livekit/components-react";
+export type { AgentState, ReceivedMessage, TrackReference, UseAgentReturn, UseSessionReturn, } from "@livekit/components-react";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ1E,cAAc,iBAAiB,CAAC;AAYhC,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,2BAA2B,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,64 @@
+"use strict";
+/* React bindings for the Talqing call protocol.
+ *
+ * Thin by design. Everything here is either the call lifecycle (`useTalqingSession`
+ * and the auth union it takes) or a hook over something `@talqing/client` does to
+ * a `Room`. Nothing here wraps LiveKit to rename it: the layer only ever ADDS, so
+ * anything LiveKit can do you can do — take `useTalqingConnection().room` and use
+ * `livekit-client` directly. We never remove a capability to make our own surface
+ * look tidier, which is also why `livekit-client` and `@livekit/components-react`
+ * are peer dependencies: the `Room` we hand you is the same class your own
+ * imports and `instanceof` resolve to.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VideoTrack = exports.useSessionMessages = exports.useAgent = exports.useTalqingScreenShare = exports.useTalqingAvatarTrack = exports.useTalqingRpcHandlers = exports.useTalqingFrontendRpcs = exports.useTalqingImages = exports.useTalqingUserdata = exports.useTalqingSession = exports.useTalqingConnection = exports.TalqingSessionProvider = void 0;
+var session_js_1 = require("./session.js");
+Object.defineProperty(exports, "TalqingSessionProvider", { enumerable: true, get: function () { return session_js_1.TalqingSessionProvider; } });
+Object.defineProperty(exports, "useTalqingConnection", { enumerable: true, get: function () { return session_js_1.useTalqingConnection; } });
+Object.defineProperty(exports, "useTalqingSession", { enumerable: true, get: function () { return session_js_1.useTalqingSession; } });
+var userdata_js_1 = require("./userdata.js");
+Object.defineProperty(exports, "useTalqingUserdata", { enumerable: true, get: function () { return userdata_js_1.useTalqingUserdata; } });
+var images_js_1 = require("./images.js");
+Object.defineProperty(exports, "useTalqingImages", { enumerable: true, get: function () { return images_js_1.useTalqingImages; } });
+var rpc_js_1 = require("./rpc.js");
+Object.defineProperty(exports, "useTalqingFrontendRpcs", { enumerable: true, get: function () { return rpc_js_1.useTalqingFrontendRpcs; } });
+Object.defineProperty(exports, "useTalqingRpcHandlers", { enumerable: true, get: function () { return rpc_js_1.useTalqingRpcHandlers; } });
+var media_js_1 = require("./media.js");
+Object.defineProperty(exports, "useTalqingAvatarTrack", { enumerable: true, get: function () { return media_js_1.useTalqingAvatarTrack; } });
+Object.defineProperty(exports, "useTalqingScreenShare", { enumerable: true, get: function () { return media_js_1.useTalqingScreenShare; } });
+/* All of `@talqing/client`, so one install and one import cover a web call.
+ * Everything there works against any `Room`, with or without React — the token
+ * source, the userdata and image and frontend-RPC calls, and the measured
+ * capture constants. Re-exported wholesale rather than as a curated list
+ * because the whole package is meant to be reachable from here, and a list
+ * would quietly fall behind it. */
+__exportStar(require("@talqing/client"), exports);
+/* LiveKit's own, re-exported UNDER THEIR OWN NAMES so a tenant installs one
+ * package and imports one name.
+ *
+ * Re-exporting is not wrapping: there is no surface of ours here to drift, and
+ * nothing is subtracted — `useAgent` is the ten-state discriminated union
+ * LiveKit ships, with every derived boolean, every action and
+ * `failureReasons` intact. Keeping LiveKit's names is the point: a
+ * `useTalqing`-prefixed alias would claim these as ours and hide where to read
+ * their documentation. Import them from `@livekit/components-react` instead if
+ * you prefer — it is the same module. */
+var components_react_1 = require("@livekit/components-react");
+Object.defineProperty(exports, "useAgent", { enumerable: true, get: function () { return components_react_1.useAgent; } });
+Object.defineProperty(exports, "useSessionMessages", { enumerable: true, get: function () { return components_react_1.useSessionMessages; } });
+Object.defineProperty(exports, "VideoTrack", { enumerable: true, get: function () { return components_react_1.VideoTrack; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;AAEH,2CAIsB;AAHpB,oHAAA,sBAAsB,OAAA;AACtB,kHAAA,oBAAoB,OAAA;AACpB,+GAAA,iBAAiB,OAAA;AAQnB,6CAAmD;AAA1C,iHAAA,kBAAkB,OAAA;AAC3B,yCAA+C;AAAtC,6GAAA,gBAAgB,OAAA;AACzB,mCAAyE;AAAhE,gHAAA,sBAAsB,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AACtD,uCAA0E;AAAjE,iHAAA,qBAAqB,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAErD;;;;;mCAKmC;AACnC,kDAAgC;AAEhC;;;;;;;;;yCASyC;AACzC,8DAImC;AAHjC,4GAAA,QAAQ,OAAA;AACR,sHAAA,kBAAkB,OAAA;AAClB,8GAAA,UAAU,OAAA"}

package/dist/cjs/media.d.ts

@@ -0,0 +1,20 @@
+import { type TrackReference } from "@livekit/components-react";
+/** Share the caller's screen with the agent, on the settings that keep it
+ *  legible — see `TALQING_SCREEN_SHARE_CAPTURE` for why each one is what it is. */
+export declare function useTalqingScreenShare(): {
+    /** Whether a screen is being shared right now. */
+    enabled: boolean;
+    /** True while the browser picker is open or the track is publishing. */
+    pending: boolean;
+    /** Opens the browser's share picker. Must be called from a user gesture. */
+    start: () => Promise<boolean | undefined> | Promise<void>;
+    /** Stops sharing. The agent is told it can no longer see on the next turn. */
+    stop: () => Promise<boolean | undefined> | Promise<void>;
+};
+/** The video track to render for a video agent.
+ *
+ *  Prefers the avatar worker's camera — the worker publishes on the agent's
+ *  behalf, which is how it is identified — and falls back through the worker's
+ *  screen share and then the agent's own tracks. */
+export declare function useTalqingAvatarTrack(): TrackReference | undefined;
+//# sourceMappingURL=media.d.ts.map

package/dist/cjs/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAMnC;mFACmF;AACnF,wBAAgB,qBAAqB;IAQ/B,kDAAkD;;IAElD,wEAAwE;;IAExE,4EAA4E;;IAE5E,8EAA8E;;EAKnF;AAED;;;;oDAIoD;AACpD,wBAAgB,qBAAqB,IAAI,cAAc,GAAG,SAAS,CAgClE"}

package/dist/cjs/media.js

@@ -0,0 +1,46 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTalqingScreenShare = useTalqingScreenShare;
+exports.useTalqingAvatarTrack = useTalqingAvatarTrack;
+const react_1 = require("react");
+const livekit_client_1 = require("livekit-client");
+const components_react_1 = require("@livekit/components-react");
+const client_1 = require("@talqing/client");
+/** Share the caller's screen with the agent, on the settings that keep it
+ *  legible — see `TALQING_SCREEN_SHARE_CAPTURE` for why each one is what it is. */
+function useTalqingScreenShare() {
+    const { toggle, enabled, pending } = (0, components_react_1.useTrackToggle)({
+        source: livekit_client_1.Track.Source.ScreenShare,
+        captureOptions: client_1.TALQING_SCREEN_SHARE_CAPTURE,
+        publishOptions: client_1.TALQING_SCREEN_SHARE_PUBLISH,
+    });
+    return (0, react_1.useMemo)(() => ({
+        /** Whether a screen is being shared right now. */
+        enabled,
+        /** True while the browser picker is open or the track is publishing. */
+        pending,
+        /** Opens the browser's share picker. Must be called from a user gesture. */
+        start: () => toggle(true),
+        /** Stops sharing. The agent is told it can no longer see on the next turn. */
+        stop: () => toggle(false),
+    }), [enabled, pending, toggle]);
+}
+/** The video track to render for a video agent.
+ *
+ *  Prefers the avatar worker's camera — the worker publishes on the agent's
+ *  behalf, which is how it is identified — and falls back through the worker's
+ *  screen share and then the agent's own tracks. */
+function useTalqingAvatarTrack() {
+    const { agent } = (0, components_react_1.useVoiceAssistant)();
+    const remoteParticipants = (0, components_react_1.useRemoteParticipants)();
+    const worker = remoteParticipants.find((participant) => participant.kind === livekit_client_1.ParticipantKind.AGENT &&
+        participant.attributes["lk.publish_on_behalf"] === agent?.identity);
+    const agentTracks = (0, components_react_1.useParticipantTracks)([livekit_client_1.Track.Source.Camera, livekit_client_1.Track.Source.ScreenShare], agent?.identity);
+    const workerTracks = (0, components_react_1.useParticipantTracks)([livekit_client_1.Track.Source.Camera, livekit_client_1.Track.Source.ScreenShare], worker?.identity);
+    return (workerTracks.find((track) => track.source === livekit_client_1.Track.Source.Camera) ??
+        workerTracks.find((track) => track.source === livekit_client_1.Track.Source.ScreenShare) ??
+        agentTracks.find((track) => track.source === livekit_client_1.Track.Source.Camera) ??
+        agentTracks.find((track) => track.source === livekit_client_1.Track.Source.ScreenShare));
+}
+//# sourceMappingURL=media.js.map

package/dist/cjs/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AAkBb,sDAmBC;AAOD,sDAgCC;AA1ED,iCAAgC;AAChC,mDAAgF;AAChF,gEAMmC;AACnC,4CAGyB;AAEzB;mFACmF;AACnF,SAAgB,qBAAqB;IACnC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAA,iCAAc,EAAC;QAClD,MAAM,EAAE,sBAAK,CAAC,MAAM,CAAC,WAAW;QAChC,cAAc,EAAE,qCAA4B;QAC5C,cAAc,EAAE,qCAA4B;KAC7C,CAAC,CAAC;IACH,OAAO,IAAA,eAAO,EACZ,GAAG,EAAE,CAAC,CAAC;QACL,kDAAkD;QAClD,OAAO;QACP,wEAAwE;QACxE,OAAO;QACP,4EAA4E;QAC5E,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,8EAA8E;QAC9E,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;KAC1B,CAAC,EACF,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAC3B,CAAC;AACJ,CAAC;AAED;;;;oDAIoD;AACpD,SAAgB,qBAAqB;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,oCAAiB,GAAE,CAAC;IACtC,MAAM,kBAAkB,GAAG,IAAA,wCAAqB,GAAE,CAAC;IACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CACpC,CAAC,WAA8B,EAAE,EAAE,CACjC,WAAW,CAAC,IAAI,KAAK,gCAAe,CAAC,KAAK;QAC1C,WAAW,CAAC,UAAU,CAAC,sBAAsB,CAAC,KAAK,KAAK,EAAE,QAAQ,CACrE,CAAC;IAEF,MAAM,WAAW,GAAG,IAAA,uCAAoB,EACtC,CAAC,sBAAK,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAC/C,KAAK,EAAE,QAAQ,CAChB,CAAC;IACF,MAAM,YAAY,GAAG,IAAA,uCAAoB,EACvC,CAAC,sBAAK,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAC/C,MAAM,EAAE,QAAQ,CACjB,CAAC;IAEF,OAAO,CACL,YAAY,CAAC,IAAI,CACf,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,sBAAK,CAAC,MAAM,CAAC,MAAM,CAChE;QACD,YAAY,CAAC,IAAI,CACf,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,sBAAK,CAAC,MAAM,CAAC,WAAW,CACrE;QACD,WAAW,CAAC,IAAI,CACd,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,sBAAK,CAAC,MAAM,CAAC,MAAM,CAChE;QACD,WAAW,CAAC,IAAI,CACd,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,sBAAK,CAAC,MAAM,CAAC,WAAW,CACrE,CACF,CAAC;AACJ,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/rpc.d.ts

@@ -0,0 +1,17 @@
+import { type JsonValue, type TalqingRpcHandlers } from "@talqing/client";
+/** Handle the agent's `frontend_rpc` calls into this page.
+ *
+ *  Registration waits for the room to connect and is undone on unmount. Pass
+ *  `enabled: false` to hold off. */
+export declare function useTalqingRpcHandlers(handlers: TalqingRpcHandlers, enabled?: boolean): void;
+/** The declarative alternative: register nothing, render what arrived.
+ *
+ *  Keeps the latest payload per method name and always answers the agent "ok". */
+export declare function useTalqingFrontendRpcs(enabled?: boolean): {
+    actions: Record<string, {
+        payload?: JsonValue;
+        at: number;
+    }>;
+    clear: () => void;
+};
+//# sourceMappingURL=rpc.d.ts.map

package/dist/cjs/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,kBAAkB,EAExB,MAAM,iBAAiB,CAAC;AAGzB;;;oCAGoC;AACpC,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,UAAO,QAOjF;AAED;;kFAEkF;AAClF,wBAAgB,sBAAsB,CAAC,OAAO,UAAO;;kBAEtB,SAAS;YAAM,MAAM;;;EA+BnD"}

package/dist/cjs/rpc.js

@@ -0,0 +1,48 @@
+"use strict";
+"use client";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTalqingRpcHandlers = useTalqingRpcHandlers;
+exports.useTalqingFrontendRpcs = useTalqingFrontendRpcs;
+const react_1 = require("react");
+const client_1 = require("@talqing/client");
+const session_js_1 = require("./session.js");
+/** Handle the agent's `frontend_rpc` calls into this page.
+ *
+ *  Registration waits for the room to connect and is undone on unmount. Pass
+ *  `enabled: false` to hold off. */
+function useTalqingRpcHandlers(handlers, enabled = true) {
+    const { room, isConnected } = (0, session_js_1.useTalqingConnection)();
+    (0, react_1.useEffect)(() => {
+        if (!enabled || !room || !isConnected)
+            return;
+        return (0, client_1.registerTalqingRpcHandlers)(room, handlers);
+    }, [enabled, handlers, isConnected, room]);
+}
+/** The declarative alternative: register nothing, render what arrived.
+ *
+ *  Keeps the latest payload per method name and always answers the agent "ok". */
+function useTalqingFrontendRpcs(enabled = true) {
+    const [actions, setActions] = (0, react_1.useState)({});
+    const handlers = (0, react_1.useMemo)(() => ({
+        "*": async (data) => {
+            const payload = JSON.parse(data.payload || "{}");
+            const method = String(payload.method || "");
+            if (method) {
+                setActions((current) => ({
+                    ...current,
+                    [method]: {
+                        payload: payload.payload,
+                        at: Date.now(),
+                    },
+                }));
+            }
+            return "ok";
+        },
+    }), []);
+    useTalqingRpcHandlers(handlers, enabled);
+    return {
+        actions,
+        clear: () => setActions({}),
+    };
+}
+//# sourceMappingURL=rpc.js.map

package/dist/cjs/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;AAeb,sDAOC;AAKD,wDAiCC;AA1DD,iCAAqD;AACrD,4CAKyB;AACzB,6CAAoD;AAEpD;;;oCAGoC;AACpC,SAAgB,qBAAqB,CAAC,QAA4B,EAAE,OAAO,GAAG,IAAI;IAChF,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAA,iCAAoB,GAAE,CAAC;IAErD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC9C,OAAO,IAAA,mCAA0B,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;kFAEkF;AAClF,SAAgB,sBAAsB,CAAC,OAAO,GAAG,IAAI;IACnD,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAEpC,EAAE,CAAC,CAAC;IAEN,MAAM,QAAQ,GAAG,IAAA,eAAO,EACtB,GAAG,EAAE,CAAC,CAAC;QACL,GAAG,EAAE,KAAK,EAAE,IAA0B,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAc,CAAC;YAC9D,MAAM,MAAM,GAAG,MAAM,CAAE,OAA+B,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACrE,IAAI,MAAM,EAAE,CAAC;gBACX,UAAU,CACR,CAAC,OAA4D,EAAE,EAAE,CAAC,CAAC;oBACjE,GAAG,OAAO;oBACV,CAAC,MAAM,CAAC,EAAE;wBACR,OAAO,EAAG,OAAmC,CAAC,OAAO;wBACrD,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;qBACf;iBACF,CAAC,CACH,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,EACF,EAAE,CACH,CAAC;IAEF,qBAAqB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,OAAO;QACP,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/cjs/session.d.ts

@@ -0,0 +1,77 @@
+import React from "react";
+import { Room, type RoomOptions } from "livekit-client";
+import { type UseSessionReturn } from "@livekit/components-react";
+import { type TalqingCallCredentials } from "@talqing/client";
+import type { TalqingClient, TokenRequest } from "@talqing/sdk";
+/** Everything about one web call except which agent runs it. Wire-shaped, like
+ *  every other request type in this SDK. */
+export type TalqingCallOptions = Omit<TokenRequest, "agent_id">;
+type TalqingCallAuth = 
+/** Your server called `POST /v1/calls/token` and forwarded these two fields. */
+{
+    token: TalqingCallCredentials;
+    fetchToken?: never;
+    client?: never;
+    agentId?: never;
+    callOptions?: never;
+}
+/** Your endpoint mints one. Called once, when the call starts. */
+ | {
+    fetchToken: () => Promise<TalqingCallCredentials>;
+    token?: never;
+    client?: never;
+    agentId?: never;
+    callOptions?: never;
+}
+/** Mint from the browser with a `TalqingClient` that already holds a
+ *  credential. **Trusted first-party surfaces only** — an app that is
+ *  same-origin with the API and signed in as a real editor, which is what our
+ *  own dashboard is. If you are embedding a call widget for your customers,
+ *  this is not your branch. */
+ | {
+    client: TalqingClient;
+    agentId: string | null;
+    /** `contact_key`, `userdata`, `vars` and the per-call agent selection.
+     *  Only on this branch: on the other two the server passes them when it
+     *  mints, which is what keeps a browser from choosing whose history to
+     *  resume. */
+    callOptions?: TalqingCallOptions;
+    token?: never;
+    fetchToken?: never;
+};
+export type TalqingSessionOptions = TalqingCallAuth & {
+    roomOptions?: RoomOptions;
+};
+/** LiveKit's session, plus what resolving this call's plan complained about. */
+export type TalqingSession = UseSessionReturn & {
+    /** An unreachable team member, a handoff into an agent that records when this
+     *  one does not — resolved against state at CALL time, so it is not the list
+     *  publishing returned. Empty until the token is minted.
+     *
+     *  Populated on the `client` branch, which is the one where this browser is
+     *  what minted. On the two server-minted branches your own server received
+     *  them in the token response and this stays empty. */
+    warnings: string[];
+};
+/** One session, one call — `start()` it when this mounts and `end()` it on the
+ *  way out, the lifecycle LiveKit's own session docs describe. A second call is
+ *  a second mount, so give the component holding this a `key` that changes per
+ *  call. Starting a finished session again would rejoin the room the last call
+ *  used, which the API refuses. */
+export declare function useTalqingSession(options: TalqingSessionOptions): TalqingSession;
+export declare function TalqingSessionProvider({ session, children, audio, }: {
+    session: TalqingSession;
+    children: React.ReactNode;
+    audio?: boolean;
+}): React.JSX.Element;
+/** The call itself, read from context — and `room`, which is the supported way
+ *  down to raw `livekit-client` for anything this layer does not cover. */
+export declare function useTalqingConnection(): {
+    isConnected: boolean;
+    connectionState: import("livekit-client").ConnectionState;
+    room: Room;
+    start: (options?: import("@livekit/components-react").SessionConnectOptions) => Promise<void>;
+    end: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/cjs/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE;4CAC4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AAmBhE,KAAK,eAAe;AAClB,gFAAgF;AAC9E;IACE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AACH,kEAAkE;GAChE;IACE,UAAU,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;CACrB;AACH;;;;+BAI+B;GAC7B;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;kBAGc;IACd,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAEpF,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC9C;;;;;;2DAMuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;mCAImC;AACnC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAyBhF;AAED,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,EACR,KAAY,GACb,EAAE;IACD,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,qBAOA;AAED;2EAC2E;AAC3E,wBAAgB,oBAAoB;;;;;;EASnC"}