@talqing/client 0.4.0

package/dist/cjs/token.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTalqingTokenSource = createTalqingTokenSource;
+const livekit_client_1 = require("livekit-client");
+/** 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. */
+function createTalqingTokenSource(fetchToken) {
+    let minted = null;
+    return livekit_client_1.TokenSource.literal(() => {
+        // A mint that failed is not this call's token, and the surface will offer
+        // the call again — so keep the rejection out of the cache.
+        minted ?? (minted = fetchToken()
+            .then((credentials) => ({
+            serverUrl: credentials.server_url,
+            participantToken: credentials.participant_token,
+        }))
+            .catch((error) => {
+            minted = null;
+            throw error;
+        }));
+        return minted;
+    });
+}
+//# sourceMappingURL=token.js.map

package/dist/cjs/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/token.ts"],"names":[],"mappings":";;AA6BA,4DAmBC;AAhDD,mDAAoE;AAWpE;;;;;;;;;;;;;;;;;4CAiB4C;AAC5C,SAAgB,wBAAwB,CACtC,UAAiD;IAEjD,IAAI,MAAM,GAAoE,IAAI,CAAC;IAEnF,OAAO,4BAAW,CAAC,OAAO,CAAC,GAAG,EAAE;QAC9B,0EAA0E;QAC1E,2DAA2D;QAC3D,MAAM,KAAN,MAAM,GAAK,UAAU,EAAE;aACpB,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACtB,SAAS,EAAE,WAAW,CAAC,UAAU;YACjC,gBAAgB,EAAE,WAAW,CAAC,iBAAiB;SAChD,CAAC,CAAC;aACF,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,EAAC;QACL,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/userdata.d.ts

@@ -0,0 +1,22 @@
+import { type RemoteParticipant, type Room } from "livekit-client";
+import type { JsonObject } from "./json.js";
+/** The agent on this call, or undefined before it has joined.
+ *
+ *  On a video call the avatar worker is an agent participant too, but it joins
+ *  on the agent's behalf and never answers RPCs, so the first one found is the
+ *  one to talk to. */
+export declare function talqingAgentParticipant(room: Room): RemoteParticipant | undefined;
+/** Merge a patch into the live session's userdata, over RPC to the agent.
+ *
+ *  Resolves rather than throws when the agent is not there: a write that did
+ *  not land is a state a page can render. */
+export declare function setTalqingUserdata(room: Room, patch: JsonObject, responseTimeout?: number): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Read the live session's userdata, or only the keys named.
+ *
+ *  Throws when the agent is not there, unlike `setTalqingUserdata`: a read that
+ *  returned nothing is not a state anything can render. */
+export declare function getTalqingUserdata(room: Room, keys?: string[], responseTimeout?: number): Promise<JsonObject>;
+//# sourceMappingURL=userdata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.d.ts","sourceRoot":"","sources":["../../src/userdata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;sBAIsB;AACtB,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAIjF;AAED;;;6CAG6C;AAC7C,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,eAAe,SAAI,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAU1C;AAED;;;2DAG2D;AAC3D,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,eAAe,SAAI,GAClB,OAAO,CAAC,UAAU,CAAC,CAcrB"}

package/dist/cjs/userdata.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.talqingAgentParticipant = talqingAgentParticipant;
+exports.setTalqingUserdata = setTalqingUserdata;
+exports.getTalqingUserdata = getTalqingUserdata;
+const livekit_client_1 = require("livekit-client");
+/** The agent on this call, or undefined before it has joined.
+ *
+ *  On a video call the avatar worker is an agent participant too, but it joins
+ *  on the agent's behalf and never answers RPCs, so the first one found is the
+ *  one to talk to. */
+function talqingAgentParticipant(room) {
+    return [...room.remoteParticipants.values()].find((participant) => participant.kind === livekit_client_1.ParticipantKind.AGENT);
+}
+/** Merge a patch into the live session's userdata, over RPC to the agent.
+ *
+ *  Resolves rather than throws when the agent is not there: a write that did
+ *  not land is a state a page can render. */
+async function setTalqingUserdata(room, patch, responseTimeout = 3) {
+    const agent = talqingAgentParticipant(room);
+    if (!agent)
+        return { ok: false, error: "agent participant is not connected" };
+    const response = await room.localParticipant.performRpc({
+        destinationIdentity: agent.identity,
+        method: "talqing.client.userdata_set",
+        payload: JSON.stringify(patch),
+        responseTimeout,
+    });
+    return JSON.parse(response || "{}");
+}
+/** Read the live session's userdata, or only the keys named.
+ *
+ *  Throws when the agent is not there, unlike `setTalqingUserdata`: a read that
+ *  returned nothing is not a state anything can render. */
+async function getTalqingUserdata(room, keys, responseTimeout = 3) {
+    const agent = talqingAgentParticipant(room);
+    if (!agent)
+        throw new Error("agent participant is not connected");
+    const response = await room.localParticipant.performRpc({
+        destinationIdentity: agent.identity,
+        method: "talqing.client.userdata_get",
+        payload: JSON.stringify(keys ? { keys } : {}),
+        responseTimeout,
+    });
+    const parsed = JSON.parse(response || "{}");
+    if (parsed.ok === false) {
+        throw new Error(String(parsed.error || "userdata RPC failed"));
+    }
+    return parsed;
+}
+//# sourceMappingURL=userdata.js.map

package/dist/cjs/userdata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userdata.js","sourceRoot":"","sources":["../../src/userdata.ts"],"names":[],"mappings":";;AAQA,0DAIC;AAMD,gDAcC;AAMD,gDAkBC;AAxDD,mDAAoF;AAGpF;;;;sBAIsB;AACtB,SAAgB,uBAAuB,CAAC,IAAU;IAChD,OAAO,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC/C,CAAC,WAA8B,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,gCAAe,CAAC,KAAK,CAC/E,CAAC;AACJ,CAAC;AAED;;;6CAG6C;AACtC,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,KAAiB,EACjB,eAAe,GAAG,CAAC;IAEnB,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IAC9E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;QACtD,mBAAmB,EAAE,KAAK,CAAC,QAAQ;QACnC,MAAM,EAAE,6BAA6B;QACrC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAC9B,eAAe;KAChB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAoC,CAAC;AACzE,CAAC;AAED;;;2DAG2D;AACpD,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,IAAe,EACf,eAAe,GAAG,CAAC;IAEnB,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;QACtD,mBAAmB,EAAE,KAAK,CAAC,QAAQ;QACnC,MAAM,EAAE,6BAA6B;QACrC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,eAAe;KAChB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAkD,CAAC;IAC7F,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/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/esm/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/esm/images.js

@@ -0,0 +1,129 @@
+import { talqingAgentParticipant } from "./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.
+ */
+export 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 const 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. */
+export const 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. */
+export 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 function talqingImageRejection(file) {
+    if (!TALQING_IMAGE_TYPES.includes(file.type)) {
+        return "that file is not a JPEG, PNG or WebP";
+    }
+    if (file.size > 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. */
+export async function talqingDownscaleImage(file) {
+    const bitmap = await createImageBitmap(file);
+    try {
+        const longest = Math.max(bitmap.width, bitmap.height);
+        const scale = longest > TALQING_IMAGE_MAX_EDGE_PX ? 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. */
+export 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. */
+export async function sendTalqingImage(room, file) {
+    const agent = 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: 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". */
+export 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/esm/images.js.map

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

package/dist/esm/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/esm/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/esm/index.js

@@ -0,0 +1,16 @@
+/* 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`.
+ */
+export { createTalqingTokenSource } 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 { registerTalqingRpcHandlers, TalqingRpcError } from "./rpc.js";
+export { TALQING_AUDIO_CAPTURE_DEFAULTS, TALQING_SCREEN_SHARE_CAPTURE, TALQING_SCREEN_SHARE_PUBLISH, } from "./media.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD,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;AAGrB,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAQvE,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/esm/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/esm/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/esm/json.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.js.map

package/dist/esm/json.js.map

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

package/dist/esm/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/esm/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/esm/media.js

@@ -0,0 +1,50 @@
+/* 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. */
+export const 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.
+ */
+export const TALQING_SCREEN_SHARE_CAPTURE = {
+    resolution: { width: 1920, height: 1080, frameRate: 1 },
+    contentHint: "text",
+};
+export const TALQING_SCREEN_SHARE_PUBLISH = {
+    videoCodec: "h264",
+    screenShareEncoding: { maxBitrate: 1000000, maxFramerate: 1 },
+};
+//# sourceMappingURL=media.js.map

package/dist/esm/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAEA;;;;eAIe;AACf,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;CACb,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA8B;IACrE,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE;IACvD,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAwB;IAC/D,UAAU,EAAE,MAAM;IAClB,mBAAmB,EAAE,EAAE,UAAU,EAAE,OAAS,EAAE,YAAY,EAAE,CAAC,EAAE;CAChE,CAAC"}

package/dist/esm/package.json

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

package/dist/esm/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/esm/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/esm/rpc.js

@@ -0,0 +1,43 @@
+import { RpcError } from "livekit-client";
+/** Throw this from a handler to choose the code the agent sees. */
+export class TalqingRpcError extends Error {
+    constructor(code, message, data) {
+        super(message);
+        this.name = "TalqingRpcError";
+        this.code = code;
+        this.data = data;
+    }
+}
+/** 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 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 RpcError(error.code, error.message, error.data);
+            }
+            throw new RpcError(1500, error instanceof Error ? error.message : "RPC handler failed");
+        }
+    });
+    return () => room.unregisterRpcMethod("talqing.frontend_rpc");
+}
+//# sourceMappingURL=rpc.js.map

package/dist/esm/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAqC,MAAM,gBAAgB,CAAC;AA2B7E,mEAAmE;AACnE,MAAM,OAAO,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;AAED;;;0EAG0E;AAC1E,MAAM,UAAU,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,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,IAAI,QAAQ,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/esm/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/esm/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"}

package/dist/esm/token.js

@@ -0,0 +1,37 @@
+import { TokenSource } from "livekit-client";
+/** 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 function createTalqingTokenSource(fetchToken) {
+    let minted = null;
+    return TokenSource.literal(() => {
+        // A mint that failed is not this call's token, and the surface will offer
+        // the call again — so keep the rejection out of the cache.
+        minted ?? (minted = fetchToken()
+            .then((credentials) => ({
+            serverUrl: credentials.server_url,
+            participantToken: credentials.participant_token,
+        }))
+            .catch((error) => {
+            minted = null;
+            throw error;
+        }));
+        return minted;
+    });
+}
+//# sourceMappingURL=token.js.map

package/dist/esm/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyB,MAAM,gBAAgB,CAAC;AAWpE;;;;;;;;;;;;;;;;;4CAiB4C;AAC5C,MAAM,UAAU,wBAAwB,CACtC,UAAiD;IAEjD,IAAI,MAAM,GAAoE,IAAI,CAAC;IAEnF,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE;QAC9B,0EAA0E;QAC1E,2DAA2D;QAC3D,MAAM,KAAN,MAAM,GAAK,UAAU,EAAE;aACpB,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;YACtB,SAAS,EAAE,WAAW,CAAC,UAAU;YACjC,gBAAgB,EAAE,WAAW,CAAC,iBAAiB;SAChD,CAAC,CAAC;aACF,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,EAAC;QACL,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}