@talqing/client 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,121 @@
+# @talqing/client
+
+The Talqing call protocol, over a LiveKit `Room`. Framework-free.
+
+```bash
+npm install @talqing/client livekit-client
+```
+
+Everything here is something only Talqing can write: the mint-once token source,
+the two userdata RPC methods, the `talqing.images` byte-stream topic and its
+acknowledgement, the `talqing.frontend_rpc` envelope, and the capture settings
+that decide whether the agent can read a shared screen. **Nothing here renames
+LiveKit** — for a room, a track or a participant, use `livekit-client` directly.
+
+**If you are writing React, install
+[`@talqing/react`](https://www.npmjs.com/package/@talqing/react) instead.** It
+re-exports all of this and adds the hooks.
+
+## Joining a call
+
+Your **server** mints the token with `POST /v1/calls/token` — see
+[`@talqing/sdk`](https://www.npmjs.com/package/@talqing/sdk) — and the browser
+receives two strings. A Talqing credential that can mint a call token can also
+create and delete agents, read every transcript and spend the workspace's
+credits, so it never belongs in browser code.
+
+```ts
+import { Room } from "livekit-client";
+import { createTalqingTokenSource, TALQING_AUDIO_CAPTURE_DEFAULTS } from "@talqing/client";
+
+const room = new Room({ audioCaptureDefaults: TALQING_AUDIO_CAPTURE_DEFAULTS });
+
+const tokenSource = createTalqingTokenSource(async () => {
+  const response = await fetch("/api/talqing-token", { method: "POST" });
+  return await response.json(); // { server_url, participant_token }
+});
+```
+
+The source mints **once**, however often it is asked. That is load-bearing:
+minting files the session row the call is later read back from, and LiveKit asks
+three times per call — to warm the connection, to connect, and once more as the
+call ends. Freshness comes from a new source per call, never from re-minting
+inside one.
+
+Leave `TALQING_AUDIO_CAPTURE_DEFAULTS` on. Echo cancellation is what stops the
+agent hearing its own speech through the microphone and interrupting itself,
+which sounds exactly like a bad model.
+
+## Userdata
+
+What the agent knows about the person on the call, readable as
+`{{userdata.field}}` from its prompt and its tools.
+
+```ts
+import { getTalqingUserdata, setTalqingUserdata } from "@talqing/client";
+
+await setTalqingUserdata(room, { cart_total: 4200 }); // → { ok, error? }
+const { tier } = await getTalqingUserdata(room, ["tier"]);
+```
+
+Both are RPCs to the worker running the call, with a 3-second timeout by
+default. `set` resolves `{ ok: false }` when the agent has not joined — a write
+that did not land is a state you can render — while `get` **throws**, because a
+read that returned nothing is not.
+
+## Images
+
+```ts
+import { onTalqingImageResult, sendTalqingImage } from "@talqing/client";
+
+const stop = onTalqingImageResult(room, ({ streamId, ok, error }) => render(streamId, ok, error));
+const image = await sendTalqingImage(room, file); // validates, downscales, sends
+```
+
+`sendTalqingImage` resolves once the bytes are on their way; the verdict arrives
+on the acknowledgement. There is one **even on the happy path**, because the
+agent deliberately stays silent when a photo lands — the caller is
+mid-conversation and about to say what it is for — so silence cannot double as
+"it arrived". Nothing acknowledging within 30 seconds means the agent went away
+mid-upload, which is a third outcome and not a failure you can describe.
+
+`talqingImageRejection(file)`, `talqingDownscaleImage(file)` and
+`talqingImageDataUrl(file)` are the three steps on their own. The last produces
+the `data:` URL a **text** message carries.
+
+## Frontend RPC
+
+A tool's `frontend_rpc` operation calls into your page. The agent sends one
+envelope method and this dispatches on `envelope.method`, so you register once
+rather than per tool.
+
+```ts
+import { registerTalqingRpcHandlers, TalqingRpcError } from "@talqing/client";
+
+const stop = registerTalqingRpcHandlers(room, {
+  open_page: async ({ payload }) => {
+    const { href } = JSON.parse(payload) as { href: string };
+    navigate(href);
+    return JSON.stringify({ ok: true });
+  },
+  cancel_order: async () => {
+    throw new TalqingRpcError(1403, "the customer declined");
+  },
+});
+```
+
+A `"*"` key catches everything unmatched and receives the whole envelope. An
+unknown method with no wildcard answers RPC code `1404`; anything else you throw
+becomes `1500` with its message.
+
+## Screen share
+
+`TALQING_SCREEN_SHARE_CAPTURE` and `TALQING_SCREEN_SHARE_PUBLISH` are the four
+settings that decide whether the agent can read what is on screen — h264 at one
+frame a second, 1920×1080, `contentHint: "text"`. Publishing on an SVC codec
+costs you legibility, and it is the first thing to check if the agent starts
+misreading identifiers. Pass them to `room.localParticipant.setScreenShareEnabled`,
+and call it from a click: the browser's picker needs a user gesture, so an agent
+can ask for a screen but can never take one.
+
+Full reference: <https://docs.talqing.com/sdks/react>.

package/dist/cjs/images.d.ts

@@ -0,0 +1,62 @@
+import type { Room } from "livekit-client";
+export declare const TALQING_IMAGE_TOPIC = "talqing.images";
+/** Decoded size the server refuses above. The downscale below keeps a phone
+ *  photo far under it; this is the belt for a file that is not a photo. */
+export declare const TALQING_IMAGE_MAX_BYTES: number;
+/** Longest side the server stores. Downscaling to it before sending is a
+ *  courtesy to the data channel, which is ordered and reliable and will
+ *  happily spend a minute pushing 10 MB past a call's audio. */
+export declare const TALQING_IMAGE_MAX_EDGE_PX = 1568;
+/** How long to wait for the agent's ack before saying we do not know. Without
+ *  it a thumbnail sits on "sending" for the rest of the call when the worker
+ *  dies mid-upload. */
+export declare const TALQING_IMAGE_ACK_TIMEOUT_MS = 30000;
+/** Refuse what the browser can see is wrong, instantly and with no round trip.
+ *  Returns the sentence to show, or null when the file is fine. The server
+ *  re-validates everything regardless — this exists so the common mistakes cost
+ *  nothing to catch. */
+export declare function talqingImageRejection(file: File): string | null;
+/** Downscale to the longest edge the server keeps, re-encoding as JPEG or PNG.
+ *
+ *  Also what normalizes whatever the OS handed the file input — this is how a
+ *  Safari HEIC becomes a JPEG. Throws if the image cannot be decoded, which is
+ *  the third dropzone check. */
+export declare function talqingDownscaleImage(file: File): Promise<Blob>;
+/** Validate and downscale a file into the `data:` URL a text message carries.
+ *
+ *  `createTextMessage` takes `images: [{data_url, filename}]`; this produces the
+ *  `data_url`. It doubles as the thumbnail's `src`, so there is no object URL to
+ *  create and revoke. Throws the sentence to show if the file is refused. */
+export declare function talqingImageDataUrl(file: File): Promise<string>;
+export type TalqingImageStatus = "sending" | "sent" | "failed" | "unknown";
+/** One image the browser sent on a call, and what became of it. */
+export interface TalqingSentImage {
+    /** The stream id `sendFile` returned, which the ack comes back under. */
+    streamId: string;
+    name: string;
+    /** An object URL for the downscaled image, for rendering the thumbnail.
+     *  Revoke it when you are done with it — `useTalqingImages` does. */
+    previewUrl: string;
+    /** When it was handed to the room, so a transcript can put it in the sequence
+     *  it was sent in rather than at the end. */
+    sentAt: number;
+    status: TalqingImageStatus;
+    /** Set when `status` is "failed" or "unknown" — a sentence, shown as-is. */
+    error?: string;
+}
+/** Validate, downscale and send one image to the agent on this call.
+ *
+ *  Resolves once the bytes are on their way, with the entry to render. The
+ *  outcome arrives later, on the ack — see `onTalqingImageResult`. Throws the
+ *  sentence to show if the file is refused or the agent is not there yet. */
+export declare function sendTalqingImage(room: Room, file: File): Promise<TalqingSentImage>;
+/** Listen for the agent's verdict on each image sent. Returns the unregister.
+ *
+ *  There is one ack per image even on the happy path, because the agent stays
+ *  silent when a photo lands — so silence cannot double as "it arrived". */
+export declare function onTalqingImageResult(room: Room, onResult: (result: {
+    streamId: string;
+    ok: boolean;
+    error?: string;
+}) => void): () => 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":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAqB,MAAM,gBAAgB,CAAC;AAgB9D,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AACpD;2EAC2E;AAC3E,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AACxD;;gEAEgE;AAChE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;uBAEuB;AACvB,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;wBAGwB;AACxB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAM/D;AAED;;;;gCAIgC;AAChC,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBrE;AAED;;;;6EAI6E;AAC7E,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAUrE;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE3E,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb;yEACqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB;iDAC6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;6EAI6E;AAC7E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwBxF;AAED;;;4EAG4E;AAC5E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAC5E,MAAM,IAAI,CAeZ"}

package/dist/cjs/images.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TALQING_IMAGE_ACK_TIMEOUT_MS = exports.TALQING_IMAGE_MAX_EDGE_PX = exports.TALQING_IMAGE_MAX_BYTES = exports.TALQING_IMAGE_TOPIC = void 0;
+exports.talqingImageRejection = talqingImageRejection;
+exports.talqingDownscaleImage = talqingDownscaleImage;
+exports.talqingImageDataUrl = talqingImageDataUrl;
+exports.sendTalqingImage = sendTalqingImage;
+exports.onTalqingImageResult = onTalqingImageResult;
+const userdata_js_1 = require("./userdata.js");
+/* ── images ───────────────────────────────────────────────────────────────
+ *
+ * A caller attaches a photo on a web voice or video call and the agent sees
+ * it. The bytes go over a LiveKit byte stream on the `talqing.images` topic,
+ * addressed to the agent; the agent answers on an RPC back, and the id
+ * `sendFile` returns is the id that ack carries, so there is nothing to
+ * correlate by hand.
+ *
+ * The agent deliberately does NOT speak when a photo lands — the caller is
+ * mid-conversation and about to say what it is for. The image is in the
+ * model's view for their next turn.
+ */
+exports.TALQING_IMAGE_TOPIC = "talqing.images";
+/** Decoded size the server refuses above. The downscale below keeps a phone
+ *  photo far under it; this is the belt for a file that is not a photo. */
+exports.TALQING_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+/** Longest side the server stores. Downscaling to it before sending is a
+ *  courtesy to the data channel, which is ordered and reliable and will
+ *  happily spend a minute pushing 10 MB past a call's audio. */
+exports.TALQING_IMAGE_MAX_EDGE_PX = 1568;
+const TALQING_IMAGE_TYPES = ["image/jpeg", "image/png", "image/webp"];
+/** How long to wait for the agent's ack before saying we do not know. Without
+ *  it a thumbnail sits on "sending" for the rest of the call when the worker
+ *  dies mid-upload. */
+exports.TALQING_IMAGE_ACK_TIMEOUT_MS = 30000;
+/** Refuse what the browser can see is wrong, instantly and with no round trip.
+ *  Returns the sentence to show, or null when the file is fine. The server
+ *  re-validates everything regardless — this exists so the common mistakes cost
+ *  nothing to catch. */
+function talqingImageRejection(file) {
+    if (!TALQING_IMAGE_TYPES.includes(file.type)) {
+        return "that file is not a JPEG, PNG or WebP";
+    }
+    if (file.size > exports.TALQING_IMAGE_MAX_BYTES)
+        return "images are 10 MB or smaller";
+    return null;
+}
+/** Downscale to the longest edge the server keeps, re-encoding as JPEG or PNG.
+ *
+ *  Also what normalizes whatever the OS handed the file input — this is how a
+ *  Safari HEIC becomes a JPEG. Throws if the image cannot be decoded, which is
+ *  the third dropzone check. */
+async function talqingDownscaleImage(file) {
+    const bitmap = await createImageBitmap(file);
+    try {
+        const longest = Math.max(bitmap.width, bitmap.height);
+        const scale = longest > exports.TALQING_IMAGE_MAX_EDGE_PX ? exports.TALQING_IMAGE_MAX_EDGE_PX / longest : 1;
+        const canvas = document.createElement("canvas");
+        canvas.width = Math.max(1, Math.round(bitmap.width * scale));
+        canvas.height = Math.max(1, Math.round(bitmap.height * scale));
+        const context = canvas.getContext("2d");
+        if (!context)
+            throw new Error("this browser cannot resize images");
+        context.drawImage(bitmap, 0, 0, canvas.width, canvas.height);
+        // PNG keeps transparency; everything else becomes a JPEG, including the
+        // HEIC the OS decoded for us.
+        const type = file.type === "image/png" ? "image/png" : "image/jpeg";
+        const blob = await new Promise((resolve) => canvas.toBlob(resolve, type, 0.85));
+        if (!blob)
+            throw new Error("that image could not be read");
+        return blob;
+    }
+    finally {
+        bitmap.close();
+    }
+}
+/** Validate and downscale a file into the `data:` URL a text message carries.
+ *
+ *  `createTextMessage` takes `images: [{data_url, filename}]`; this produces the
+ *  `data_url`. It doubles as the thumbnail's `src`, so there is no object URL to
+ *  create and revoke. Throws the sentence to show if the file is refused. */
+async function talqingImageDataUrl(file) {
+    const rejection = talqingImageRejection(file);
+    if (rejection)
+        throw new Error(rejection);
+    const blob = await talqingDownscaleImage(file);
+    return await new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onerror = () => reject(new Error("that image could not be read"));
+        reader.onload = () => resolve(String(reader.result));
+        reader.readAsDataURL(blob);
+    });
+}
+/** Validate, downscale and send one image to the agent on this call.
+ *
+ *  Resolves once the bytes are on their way, with the entry to render. The
+ *  outcome arrives later, on the ack — see `onTalqingImageResult`. Throws the
+ *  sentence to show if the file is refused or the agent is not there yet. */
+async function sendTalqingImage(room, file) {
+    const agent = (0, userdata_js_1.talqingAgentParticipant)(room);
+    if (!agent)
+        throw new Error("the agent is not on the call yet");
+    const rejection = talqingImageRejection(file);
+    if (rejection)
+        throw new Error(rejection);
+    const blob = await talqingDownscaleImage(file);
+    // Addressed to the agent, never broadcast: on video the avatar worker is
+    // a participant too, and a broadcast sends the bytes twice.
+    const { id } = await room.localParticipant.sendFile(new File([blob], file.name, { type: blob.type }), {
+        topic: exports.TALQING_IMAGE_TOPIC,
+        mimeType: blob.type,
+        destinationIdentities: [agent.identity],
+    });
+    return {
+        streamId: id,
+        name: file.name,
+        previewUrl: URL.createObjectURL(blob),
+        sentAt: Date.now(),
+        status: "sending",
+    };
+}
+/** Listen for the agent's verdict on each image sent. Returns the unregister.
+ *
+ *  There is one ack per image even on the happy path, because the agent stays
+ *  silent when a photo lands — so silence cannot double as "it arrived". */
+function onTalqingImageResult(room, onResult) {
+    room.registerRpcMethod("talqing.image_result", async (data) => {
+        const { stream_id, ok, error } = JSON.parse(data.payload || "{}");
+        onResult({
+            streamId: stream_id,
+            ok,
+            error: ok ? undefined : error || "that image was not accepted",
+        });
+        return "{}";
+    });
+    return () => room.unregisterRpcMethod("talqing.image_result");
+}
+//# 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 { createTalqingTokenSource } from "./token.js";
+export type { TalqingCallCredentials } from "./token.js";
+export { getTalqingUserdata, setTalqingUserdata, talqingAgentParticipant, } from "./userdata.js";
+export { onTalqingImageResult, sendTalqingImage, talqingDownscaleImage, talqingImageDataUrl, talqingImageRejection, TALQING_IMAGE_ACK_TIMEOUT_MS, TALQING_IMAGE_MAX_BYTES, TALQING_IMAGE_MAX_EDGE_PX, TALQING_IMAGE_TOPIC, } from "./images.js";
+export type { TalqingImageStatus, TalqingSentImage } from "./images.js";
+export { registerTalqingRpcHandlers, TalqingRpcError } from "./rpc.js";
+export type { TalqingFrontendRpcEnvelope, TalqingRpcHandler, TalqingRpcHandlers, TalqingRpcInvocation, } from "./rpc.js";
+export { TALQING_AUDIO_CAPTURE_DEFAULTS, TALQING_SCREEN_SHARE_CAPTURE, TALQING_SCREEN_SHARE_PUBLISH, } from "./media.js";
+export type { JsonObject, JsonPrimitive, JsonValue } from "./json.js";
+//# 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":"AAWA,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvE,YAAY,EACV,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,37 @@
+"use strict";
+/* The Talqing call protocol, over a LiveKit `Room`. Framework-free.
+ *
+ * Everything here is something only Talqing can write: the mint-once token
+ * source, the two userdata RPC methods, the `talqing.images` byte-stream topic
+ * and its ack, the `talqing.frontend_rpc` envelope, and the measured capture
+ * settings. Nothing here renames LiveKit — for a room, a track or a
+ * participant, use `livekit-client` directly.
+ *
+ * React bindings for all of it are `@talqing/react`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TALQING_SCREEN_SHARE_PUBLISH = exports.TALQING_SCREEN_SHARE_CAPTURE = exports.TALQING_AUDIO_CAPTURE_DEFAULTS = exports.TalqingRpcError = exports.registerTalqingRpcHandlers = exports.TALQING_IMAGE_TOPIC = exports.TALQING_IMAGE_MAX_EDGE_PX = exports.TALQING_IMAGE_MAX_BYTES = exports.TALQING_IMAGE_ACK_TIMEOUT_MS = exports.talqingImageRejection = exports.talqingImageDataUrl = exports.talqingDownscaleImage = exports.sendTalqingImage = exports.onTalqingImageResult = exports.talqingAgentParticipant = exports.setTalqingUserdata = exports.getTalqingUserdata = exports.createTalqingTokenSource = void 0;
+var token_js_1 = require("./token.js");
+Object.defineProperty(exports, "createTalqingTokenSource", { enumerable: true, get: function () { return token_js_1.createTalqingTokenSource; } });
+var userdata_js_1 = require("./userdata.js");
+Object.defineProperty(exports, "getTalqingUserdata", { enumerable: true, get: function () { return userdata_js_1.getTalqingUserdata; } });
+Object.defineProperty(exports, "setTalqingUserdata", { enumerable: true, get: function () { return userdata_js_1.setTalqingUserdata; } });
+Object.defineProperty(exports, "talqingAgentParticipant", { enumerable: true, get: function () { return userdata_js_1.talqingAgentParticipant; } });
+var images_js_1 = require("./images.js");
+Object.defineProperty(exports, "onTalqingImageResult", { enumerable: true, get: function () { return images_js_1.onTalqingImageResult; } });
+Object.defineProperty(exports, "sendTalqingImage", { enumerable: true, get: function () { return images_js_1.sendTalqingImage; } });
+Object.defineProperty(exports, "talqingDownscaleImage", { enumerable: true, get: function () { return images_js_1.talqingDownscaleImage; } });
+Object.defineProperty(exports, "talqingImageDataUrl", { enumerable: true, get: function () { return images_js_1.talqingImageDataUrl; } });
+Object.defineProperty(exports, "talqingImageRejection", { enumerable: true, get: function () { return images_js_1.talqingImageRejection; } });
+Object.defineProperty(exports, "TALQING_IMAGE_ACK_TIMEOUT_MS", { enumerable: true, get: function () { return images_js_1.TALQING_IMAGE_ACK_TIMEOUT_MS; } });
+Object.defineProperty(exports, "TALQING_IMAGE_MAX_BYTES", { enumerable: true, get: function () { return images_js_1.TALQING_IMAGE_MAX_BYTES; } });
+Object.defineProperty(exports, "TALQING_IMAGE_MAX_EDGE_PX", { enumerable: true, get: function () { return images_js_1.TALQING_IMAGE_MAX_EDGE_PX; } });
+Object.defineProperty(exports, "TALQING_IMAGE_TOPIC", { enumerable: true, get: function () { return images_js_1.TALQING_IMAGE_TOPIC; } });
+var rpc_js_1 = require("./rpc.js");
+Object.defineProperty(exports, "registerTalqingRpcHandlers", { enumerable: true, get: function () { return rpc_js_1.registerTalqingRpcHandlers; } });
+Object.defineProperty(exports, "TalqingRpcError", { enumerable: true, get: function () { return rpc_js_1.TalqingRpcError; } });
+var media_js_1 = require("./media.js");
+Object.defineProperty(exports, "TALQING_AUDIO_CAPTURE_DEFAULTS", { enumerable: true, get: function () { return media_js_1.TALQING_AUDIO_CAPTURE_DEFAULTS; } });
+Object.defineProperty(exports, "TALQING_SCREEN_SHARE_CAPTURE", { enumerable: true, get: function () { return media_js_1.TALQING_SCREEN_SHARE_CAPTURE; } });
+Object.defineProperty(exports, "TALQING_SCREEN_SHARE_PUBLISH", { enumerable: true, get: function () { return media_js_1.TALQING_SCREEN_SHARE_PUBLISH; } });
+//# 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;;;;;;;;;GASG;;;AAEH,uCAAsD;AAA7C,oHAAA,wBAAwB,OAAA;AAGjC,6CAIuB;AAHrB,iHAAA,kBAAkB,OAAA;AAClB,iHAAA,kBAAkB,OAAA;AAClB,sHAAA,uBAAuB,OAAA;AAGzB,yCAUqB;AATnB,iHAAA,oBAAoB,OAAA;AACpB,6GAAA,gBAAgB,OAAA;AAChB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,yHAAA,4BAA4B,OAAA;AAC5B,oHAAA,uBAAuB,OAAA;AACvB,sHAAA,yBAAyB,OAAA;AACzB,gHAAA,mBAAmB,OAAA;AAIrB,mCAAuE;AAA9D,oHAAA,0BAA0B,OAAA;AAAE,yGAAA,eAAe,OAAA;AAQpD,uCAIoB;AAHlB,0HAAA,8BAA8B,OAAA;AAC9B,wHAAA,4BAA4B,OAAA;AAC5B,wHAAA,4BAA4B,OAAA"}

package/dist/cjs/json.d.ts

@@ -0,0 +1,8 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: unknown;
+};
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/json.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}

package/dist/cjs/json.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=json.js.map

package/dist/cjs/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/json.ts"],"names":[],"mappings":""}

package/dist/cjs/media.d.ts

@@ -0,0 +1,9 @@
+import type { ScreenShareCaptureOptions, TrackPublishOptions } from "livekit-client";
+export declare const TALQING_AUDIO_CAPTURE_DEFAULTS: {
+    readonly echoCancellation: true;
+    readonly noiseSuppression: true;
+    readonly autoGainControl: true;
+};
+export declare const TALQING_SCREEN_SHARE_CAPTURE: ScreenShareCaptureOptions;
+export declare const TALQING_SCREEN_SHARE_PUBLISH: TrackPublishOptions;
+//# 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":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAOrF,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAiCX,eAAO,MAAM,4BAA4B,EAAE,yBAG1C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,mBAG1C,CAAC"}

package/dist/cjs/media.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TALQING_SCREEN_SHARE_PUBLISH = exports.TALQING_SCREEN_SHARE_CAPTURE = exports.TALQING_AUDIO_CAPTURE_DEFAULTS = void 0;
+/* Echo cancellation is what stops the agent hearing its own speech through the
+ * caller's microphone and interrupting itself. It is a default rather than
+ * something each app remembers, because a call without it is broken in a way
+ * that sounds like a bad model. Pass `roomOptions.audioCaptureDefaults` to
+ * override. */
+exports.TALQING_AUDIO_CAPTURE_DEFAULTS = {
+    echoCancellation: true,
+    noiseSuppression: true,
+    autoGainControl: true,
+};
+/* Screen share, with the four settings that decide whether the agent can read
+ * what is on it.
+ *
+ * Only the first is obvious, and every one of them is upstream of anything we
+ * could do on our side:
+ *
+ *  - `contentHint: "text"` tells the encoder to preserve spatial detail. The
+ *    default for a screen share on an SVC codec is `motion`, which trades
+ *    exactly that away — the wrong trade for reading code, and no JPEG quality
+ *    setting downstream recovers it.
+ *  - `videoCodec: "h264"` is what keeps that hint. `livekit-client` forces
+ *    `contentHint = "motion"` on screen shares published as vp9 or av1,
+ *    together with `scalabilityMode: "L1T3"`. **Publishing on an SVC codec will
+ *    cost you legibility**, and it is the first thing to check if the agent
+ *    starts misreading identifiers.
+ *  - `screenShareEncoding.maxFramerate: 1` is the frame-rate cap that actually
+ *    binds. `resolution.frameRate` reaches `getDisplayMedia` as a bare number,
+ *    which WebRTC reads as `ideal` — a wish, not a limit. The default publish
+ *    ceiling is 15 fps, and every delivered frame is copied into the agent's
+ *    process before it can be dropped, so this is the single biggest lever on
+ *    what a call costs the worker. One frame a second is ample: the agent is
+ *    handed the newest frame at the end of each turn, and turns are seconds
+ *    apart.
+ *  - `resolution` is set explicitly rather than inherited. The default is 1080p
+ *    by `ideal`, which is a strong hint and not a guarantee.
+ *
+ * The picker cannot be opened for the person — `getDisplayMedia` requires a
+ * transient user activation — so sharing must start from a click. The agent
+ * asking out loud is what prompts it; there is no version of this where the
+ * agent turns sharing on.
+ */
+exports.TALQING_SCREEN_SHARE_CAPTURE = {
+    resolution: { width: 1920, height: 1080, frameRate: 1 },
+    contentHint: "text",
+};
+exports.TALQING_SCREEN_SHARE_PUBLISH = {
+    videoCodec: "h264",
+    screenShareEncoding: { maxBitrate: 1000000, maxFramerate: 1 },
+};
+//# 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":";;;AAEA;;;;eAIe;AACF,QAAA,8BAA8B,GAAG;IAC5C,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;CACb,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACU,QAAA,4BAA4B,GAA8B;IACrE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;IACvD,WAAW,EAAE,MAAM;CACpB,CAAC;AAEW,QAAA,4BAA4B,GAAwB;IAC/D,UAAU,EAAE,MAAM;IAClB,mBAAmB,EAAE,EAAE,UAAU,EAAE,OAAS,EAAE,YAAY,EAAE,CAAC,EAAE;CAChE,CAAC"}

package/dist/cjs/package.json

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

package/dist/cjs/rpc.d.ts

@@ -0,0 +1,25 @@
+import { type Room } from "livekit-client";
+import type { JsonValue } from "./json.js";
+export interface TalqingRpcInvocation {
+    payload: string;
+    responseTimeout?: number;
+    callerIdentity?: string;
+}
+export type TalqingRpcHandler = (data: TalqingRpcInvocation) => string | Promise<string>;
+export type TalqingRpcHandlers = Record<string, TalqingRpcHandler>;
+export interface TalqingFrontendRpcEnvelope {
+    method: string;
+    payload?: JsonValue;
+}
+/** Throw this from a handler to choose the code the agent sees. */
+export declare class TalqingRpcError extends Error {
+    readonly code: number;
+    readonly data?: string;
+    constructor(code: number, message: string, data?: string);
+}
+/** Register the frontend-RPC envelope handler on a room. Returns the unregister.
+ *
+ *  A `"*"` key catches every method with no handler of its own, and receives the
+ *  WHOLE envelope as its payload string so it can tell what it caught. */
+export declare function registerTalqingRpcHandlers(room: Room, handlers: TalqingRpcHandlers): () => 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":"AAAA,OAAO,EAAY,KAAK,IAAI,EAA0B,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAU3C,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,oBAAoB,KACvB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC9B,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEnE,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,mEAAmE;AACnE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAMzD;AAED;;;0EAG0E;AAC1E,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,IAAI,CAiCZ"}

package/dist/cjs/rpc.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TalqingRpcError = void 0;
+exports.registerTalqingRpcHandlers = registerTalqingRpcHandlers;
+const livekit_client_1 = require("livekit-client");
+/** Throw this from a handler to choose the code the agent sees. */
+class TalqingRpcError extends Error {
+    constructor(code, message, data) {
+        super(message);
+        this.name = "TalqingRpcError";
+        this.code = code;
+        this.data = data;
+    }
+}
+exports.TalqingRpcError = TalqingRpcError;
+/** Register the frontend-RPC envelope handler on a room. Returns the unregister.
+ *
+ *  A `"*"` key catches every method with no handler of its own, and receives the
+ *  WHOLE envelope as its payload string so it can tell what it caught. */
+function registerTalqingRpcHandlers(room, handlers) {
+    room.registerRpcMethod("talqing.frontend_rpc", async (data) => {
+        try {
+            const envelope = JSON.parse(data.payload || "{}");
+            const isWildcard = handlers[envelope.method] === undefined;
+            const handler = handlers[envelope.method] ?? handlers["*"];
+            if (!handler) {
+                throw new TalqingRpcError(1404, `No frontend RPC handler registered for ${envelope.method}`);
+            }
+            return await handler({
+                payload: isWildcard
+                    ? JSON.stringify(envelope)
+                    : envelope.payload === undefined
+                        ? "{}"
+                        : JSON.stringify(envelope.payload),
+                responseTimeout: data.responseTimeout,
+                callerIdentity: data.callerIdentity,
+            });
+        }
+        catch (error) {
+            if (error instanceof TalqingRpcError) {
+                throw new livekit_client_1.RpcError(error.code, error.message, error.data);
+            }
+            throw new livekit_client_1.RpcError(1500, error instanceof Error ? error.message : "RPC handler failed");
+        }
+    });
+    return () => room.unregisterRpcMethod("talqing.frontend_rpc");
+}
+//# 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":";;;AA4CA,gEAoCC;AAhFD,mDAA6E;AA2B7E,mEAAmE;AACnE,MAAa,eAAgB,SAAQ,KAAK;IAIxC,YAAY,IAAY,EAAE,OAAe,EAAE,IAAa;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAVD,0CAUC;AAED;;;0EAG0E;AAC1E,SAAgB,0BAA0B,CACxC,IAAU,EACV,QAA4B;IAE5B,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;QAC/E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAA+B,CAAC;YAChF,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;YAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,eAAe,CACvB,IAAI,EACJ,0CAA0C,QAAQ,CAAC,MAAM,EAAE,CAC5D,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,OAAO,CAAC;gBACnB,OAAO,EAAE,UAAU;oBACjB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;oBAC1B,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS;wBAC9B,CAAC,CAAC,IAAI;wBACN,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACtC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,MAAM,IAAI,yBAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,IAAI,yBAAQ,CAChB,IAAI,EACJ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;AAChE,CAAC"}

package/dist/cjs/token.d.ts

@@ -0,0 +1,29 @@
+import { type TokenSourceFixed } from "livekit-client";
+/** The two fields a browser needs to join a room, and nothing else.
+ *
+ *  Named as `POST /v1/calls/token` names them, so a server that mints one can
+ *  forward the response through to the browser without renaming anything. */
+export interface TalqingCallCredentials {
+    server_url: string;
+    participant_token: string;
+}
+/** Turn a one-shot mint into the token source LiveKit's session takes.
+ *
+ *  `fetchToken` is called at most once per source, no matter how often LiveKit
+ *  asks. That is load-bearing rather than an optimization: minting is not free,
+ *  because `POST /v1/calls/token` files the session row the call is later read
+ *  back from. The framework asks three times per call — to warm the connection,
+ *  to connect, and once more as the call ends to drop what it assumes is a
+ *  cached token — and only the middle one is a call anybody placed. Minting for
+ *  the third filed a session nobody ever joined, which sat in the workspace's
+ *  call list as queued for good.
+ *
+ *  `TokenSource.literal` is the LiveKit variant that leaves caching to us, and
+ *  this is us doing it.
+ *
+ *  Freshness comes from a new source per call, never from re-minting inside
+ *  one: the token names the room, and this call has exactly one. Mount the
+ *  session per call and end it on unmount, as LiveKit's own session lifecycle
+ *  does, and that holds by construction. */
+export declare function createTalqingTokenSource(fetchToken: () => Promise<TalqingCallCredentials>): TokenSourceFixed;
+//# sourceMappingURL=token.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../src/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;6EAG6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;4CAiB4C;AAC5C,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,GAChD,gBAAgB,CAiBlB"}