@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/browser.js

@@ -0,0 +1,292 @@
+//#region src/browser.ts
+/** The action that hands the person the browser; the turn waits on it until they give it back. */
+const HAND_OVER = "browser_hand_over";
+function createScreen() {
+	let latest = null;
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		show: (frame) => {
+			latest = frame;
+			for (const listener of listeners) listener(frame);
+		},
+		clear: () => {
+			latest = null;
+		},
+		watch: (listener) => {
+			listeners.add(listener);
+			if (latest) listener(latest);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+}
+/**
+* The hand-over the turn waits on (its step's id) when the browser it handed over is no longer
+* there to give back: the person can still go on.
+*/
+function handOverWaiting(messages, awaiting) {
+	if (awaiting === null) return null;
+	return messages.flatMap((message) => message.steps).find((one) => one.id === awaiting)?.action === "browser_hand_over" ? awaiting : null;
+}
+/** "es.wikipedia.org" and the rest of the address apart, for an address bar; nothing for a blank page. */
+function siteOf(url) {
+	try {
+		const { protocol, host, pathname, search } = new URL(url);
+		if (!protocol.startsWith("http")) return {
+			host: "",
+			rest: ""
+		};
+		return {
+			host,
+			rest: pathname === "/" && !search ? "" : `${pathname}${search}`
+		};
+	} catch {
+		return {
+			host: "",
+			rest: ""
+		};
+	}
+}
+/** Where a pointer event is on the page: scaled from the element as shown, kept inside it. */
+function pointOf(event, box, size) {
+	const along = (at, from, shown, real) => shown > 0 ? Math.round(Math.min(Math.max((at - from) / shown, 0), 1) * real) : 0;
+	return {
+		x: along(event.clientX, box.left, box.width, size.width),
+		y: along(event.clientY, box.top, box.height, size.height)
+	};
+}
+/** DevTools' mask of the keys held with another: Alt 1, Ctrl 2, Meta 4, Shift 8. */
+function modifiersOf(event) {
+	return (event.altKey ? 1 : 0) | (event.ctrlKey ? 2 : 0) | (event.metaKey ? 4 : 0) | (event.shiftKey ? 8 : 0);
+}
+/**
+* A key as the browser takes it; nothing for a key that stays here: Tab (the focus leaves the
+* screen) and paste (the text comes in its own event, from this computer's clipboard).
+*/
+function keyOf(event, action) {
+	if (event.key === "Tab") return null;
+	if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === "v") return null;
+	return {
+		kind: "key",
+		action,
+		key: event.key.slice(0, 32),
+		code: event.code.slice(0, 32),
+		keyCode: Math.min(Math.max(event.keyCode, 0), 255),
+		modifiers: modifiersOf(event)
+	};
+}
+const BUTTONS = {
+	0: "left",
+	1: "middle",
+	2: "right"
+};
+const MOVE_EVERY_MS = 40;
+const WHEEL_EVERY_MS = 50;
+const LINE_PX = 16;
+const MAX_DELTA = 1e4;
+const MAX_PASTE = 4e3;
+const clamp = (value, limit) => Math.min(Math.max(value, -limit), limit);
+/**
+* Sends what the person does on `element` (the screen) to `send`, in the page's pixels; the
+* returned function stops it. The pointer goes as down, move and up (drags and double clicks
+* work as on the page; a drag that leaves the screen still ends), the wheel as wheel (the page
+* around does not scroll; the turns of `WHEEL_EVERY_MS` summed into one), keys while the screen
+* has the focus, and text pasted there as text. A key still held when the focus goes is let go.
+* The context menu is the page's.
+*/
+function capture(element, size, send) {
+	const held = /* @__PURE__ */ new Map();
+	let lastMove = Number.NEGATIVE_INFINITY;
+	const at = (event) => pointOf(event, element.getBoundingClientRect(), size);
+	const turned = {
+		x: 0,
+		y: 0,
+		dx: 0,
+		dy: 0
+	};
+	let lastWheel = Number.NEGATIVE_INFINITY;
+	let wheelTimer;
+	const flushWheel = () => {
+		wheelTimer = void 0;
+		lastWheel = performance.now();
+		const { x, y, dx, dy } = turned;
+		turned.dx = 0;
+		turned.dy = 0;
+		if (dx !== 0 || dy !== 0) send({
+			kind: "wheel",
+			x,
+			y,
+			dx: clamp(dx, MAX_DELTA),
+			dy: clamp(dy, MAX_DELTA)
+		});
+	};
+	const down = (event) => {
+		const button = BUTTONS[event.button];
+		if (!button) return;
+		event.preventDefault();
+		element.focus({ preventScroll: true });
+		element.setPointerCapture(event.pointerId);
+		const clicks = Math.min(Math.max(event.detail, 1), 3);
+		send({
+			kind: "mouse",
+			action: "down",
+			...at(event),
+			button,
+			clicks
+		});
+	};
+	const up = (event) => {
+		const button = BUTTONS[event.button];
+		if (!button) return;
+		const clicks = Math.min(Math.max(event.detail, 1), 3);
+		send({
+			kind: "mouse",
+			action: "up",
+			...at(event),
+			button,
+			clicks
+		});
+	};
+	const move = (event) => {
+		if (event.timeStamp - lastMove < MOVE_EVERY_MS) return;
+		lastMove = event.timeStamp;
+		send({
+			kind: "mouse",
+			action: "move",
+			...at(event)
+		});
+	};
+	const wheel = (event) => {
+		event.preventDefault();
+		const unit = event.deltaMode === 1 ? LINE_PX : event.deltaMode === 2 ? size.height : 1;
+		Object.assign(turned, at(event));
+		turned.dx += event.deltaX * unit;
+		turned.dy += event.deltaY * unit;
+		if (wheelTimer !== void 0) return;
+		const wait = lastWheel + WHEEL_EVERY_MS - performance.now();
+		if (wait <= 0) flushWheel();
+		else wheelTimer = setTimeout(flushWheel, wait);
+	};
+	const keyed = (action) => (event) => {
+		if (event.isComposing) return;
+		const key = keyOf(event, action);
+		if (!key) return;
+		event.preventDefault();
+		if (action === "down") held.set(event.code || event.key, {
+			...key,
+			action: "up"
+		});
+		else held.delete(event.code || event.key);
+		send(key);
+	};
+	const paste = (event) => {
+		const text = event.clipboardData?.getData("text/plain") ?? "";
+		if (text === "") return;
+		event.preventDefault();
+		send({
+			kind: "paste",
+			text: text.slice(0, MAX_PASTE)
+		});
+	};
+	const letGo = () => {
+		for (const key of held.values()) send(key);
+		held.clear();
+	};
+	const noMenu = (event) => {
+		event.preventDefault();
+	};
+	const keyDown = keyed("down");
+	const keyUp = keyed("up");
+	element.addEventListener("pointerdown", down);
+	element.addEventListener("pointerup", up);
+	element.addEventListener("pointermove", move);
+	element.addEventListener("wheel", wheel, { passive: false });
+	element.addEventListener("keydown", keyDown);
+	element.addEventListener("keyup", keyUp);
+	element.addEventListener("paste", paste);
+	element.addEventListener("blur", letGo);
+	element.addEventListener("contextmenu", noMenu);
+	return () => {
+		clearTimeout(wheelTimer);
+		element.removeEventListener("pointerdown", down);
+		element.removeEventListener("pointerup", up);
+		element.removeEventListener("pointermove", move);
+		element.removeEventListener("wheel", wheel);
+		element.removeEventListener("keydown", keyDown);
+		element.removeEventListener("keyup", keyUp);
+		element.removeEventListener("paste", paste);
+		element.removeEventListener("blur", letGo);
+		element.removeEventListener("contextmenu", noMenu);
+	};
+}
+/**
+* The bytes in a base64 string: the platform's own decoder where it has one, else a plain loop
+* (`Uint8Array.from` with a mapper walks a frame's 100,000 characters through an iterator, a
+* callback each, on the main thread, as the next picture is due).
+*/
+function bytesOf(base64) {
+	const native = Uint8Array.fromBase64;
+	if (native) return native(base64);
+	const text = atob(base64);
+	const bytes = new Uint8Array(text.length);
+	for (let at = 0; at < text.length; at += 1) bytes[at] = text.charCodeAt(at);
+	return bytes;
+}
+/**
+* Paints JPEGs (base64) on `canvas`, stretched to its size, v2's way: decoded off the main thread
+* (`createImageBitmap`), one at a time, and drawn on the screen's next frame, so a picture never
+* lands mid-paint. A picture that comes while another is being decoded waits, and a newer one
+* replaces it, as a newer decoded one replaces one not drawn yet: a slow device skips to the
+* present instead of falling behind. The canvas keeps the last picture until the next is ready,
+* so it never flickers; one that does not decode is skipped. `onPaint` hears each one drawn.
+*/
+function painterOn(canvas, onPaint) {
+	let decoding = false;
+	let waiting;
+	let ready;
+	let frame = 0;
+	let disposed = false;
+	const draw = () => {
+		frame = 0;
+		const bitmap = ready;
+		ready = void 0;
+		if (!bitmap) return;
+		canvas.getContext("2d")?.drawImage(bitmap, 0, 0, canvas.width, canvas.height);
+		bitmap.close();
+		onPaint?.();
+	};
+	const decode = async (jpeg) => {
+		decoding = true;
+		try {
+			const bitmap = await createImageBitmap(new Blob([bytesOf(jpeg)], { type: "image/jpeg" }));
+			if (disposed) bitmap.close();
+			else {
+				ready?.close();
+				ready = bitmap;
+				if (frame === 0) frame = requestAnimationFrame(draw);
+			}
+		} catch {}
+		decoding = false;
+		const next = waiting;
+		waiting = void 0;
+		if (next !== void 0 && !disposed) await decode(next);
+	};
+	return {
+		paint: (jpeg) => {
+			if (decoding) waiting = jpeg;
+			else decode(jpeg);
+		},
+		dispose: () => {
+			disposed = true;
+			waiting = void 0;
+			if (frame !== 0) cancelAnimationFrame(frame);
+			ready?.close();
+			ready = void 0;
+		}
+	};
+}
+//#endregion
+export { HAND_OVER, bytesOf, capture, createScreen, handOverWaiting, keyOf, modifiersOf, painterOn, pointOf, siteOf };
+
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["/**\n * The conversation's browser, apart from how it is drawn: its screen as pictures to watch, the\n * person's pointer and keys as the input it takes, and where it is in a few words.\n */\n\nimport type { BrowserFrame, BrowserInput, Message } from \"./types\";\n\n/** The action that hands the person the browser; the turn waits on it until they give it back. */\nexport const HAND_OVER = \"browser_hand_over\";\n\n/**\n * The browser's screen as it comes: the latest picture, and whoever watches. Kept out of the\n * conversation's state, so a picture repaints a canvas and nothing else.\n */\nexport interface Screen {\n  /** A new picture: each watcher hears it. */\n  show: (frame: BrowserFrame) => void;\n  /** The browser closed: no picture any more. */\n  clear: () => void;\n  /** Hears each picture from now on, the latest at once; returns how to stop. */\n  watch: (listener: (frame: BrowserFrame) => void) => () => void;\n}\n\nexport function createScreen(): Screen {\n  let latest: BrowserFrame | null = null;\n  const listeners = new Set<(frame: BrowserFrame) => void>();\n  return {\n    show: (frame) => {\n      latest = frame;\n      for (const listener of listeners) listener(frame);\n    },\n    clear: () => {\n      latest = null;\n    },\n    watch: (listener) => {\n      listeners.add(listener);\n      if (latest) listener(latest);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n  };\n}\n\n/**\n * The hand-over the turn waits on (its step's id) when the browser it handed over is no longer\n * there to give back: the person can still go on.\n */\nexport function handOverWaiting(\n  messages: readonly Message[],\n  awaiting: string | null,\n): string | null {\n  if (awaiting === null) return null;\n  const step = messages.flatMap((message) => message.steps).find((one) => one.id === awaiting);\n  return step?.action === HAND_OVER ? awaiting : null;\n}\n\n/** \"es.wikipedia.org\" and the rest of the address apart, for an address bar; nothing for a blank page. */\nexport function siteOf(url: string): { host: string; rest: string } {\n  try {\n    const { protocol, host, pathname, search } = new URL(url);\n    if (!protocol.startsWith(\"http\")) return { host: \"\", rest: \"\" };\n    return { host, rest: pathname === \"/\" && !search ? \"\" : `${pathname}${search}` };\n  } catch {\n    return { host: \"\", rest: \"\" };\n  }\n}\n\nexport interface Size {\n  width: number;\n  height: number;\n}\n\n/** Where a pointer event is on the page: scaled from the element as shown, kept inside it. */\nexport function pointOf(\n  event: { clientX: number; clientY: number },\n  box: { left: number; top: number; width: number; height: number },\n  size: Size,\n): { x: number; y: number } {\n  const along = (at: number, from: number, shown: number, real: number) =>\n    shown > 0 ? Math.round(Math.min(Math.max((at - from) / shown, 0), 1) * real) : 0;\n  return {\n    x: along(event.clientX, box.left, box.width, size.width),\n    y: along(event.clientY, box.top, box.height, size.height),\n  };\n}\n\n/** DevTools' mask of the keys held with another: Alt 1, Ctrl 2, Meta 4, Shift 8. */\nexport function modifiersOf(event: {\n  altKey: boolean;\n  ctrlKey: boolean;\n  metaKey: boolean;\n  shiftKey: boolean;\n}): number {\n  return (\n    (event.altKey ? 1 : 0) |\n    (event.ctrlKey ? 2 : 0) |\n    (event.metaKey ? 4 : 0) |\n    (event.shiftKey ? 8 : 0)\n  );\n}\n\ntype KeyInput = Extract<BrowserInput, { kind: \"key\" }>;\n\n/**\n * A key as the browser takes it; nothing for a key that stays here: Tab (the focus leaves the\n * screen) and paste (the text comes in its own event, from this computer's clipboard).\n */\nexport function keyOf(\n  event: Pick<\n    KeyboardEvent,\n    \"key\" | \"code\" | \"keyCode\" | \"altKey\" | \"ctrlKey\" | \"metaKey\" | \"shiftKey\"\n  >,\n  action: \"down\" | \"up\",\n): KeyInput | null {\n  if (event.key === \"Tab\") return null;\n  if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === \"v\") return null;\n  return {\n    kind: \"key\",\n    action,\n    key: event.key.slice(0, 32),\n    code: event.code.slice(0, 32),\n    keyCode: Math.min(Math.max(event.keyCode, 0), 255),\n    modifiers: modifiersOf(event),\n  };\n}\n\nconst BUTTONS: Readonly<Record<number, \"left\" | \"middle\" | \"right\">> = {\n  0: \"left\",\n  1: \"middle\",\n  2: \"right\",\n};\nconst MOVE_EVERY_MS = 40; // where the pointer is, 25 times a second at most\n// A trackpad fires the wheel 60 times a second, and each one waits on the hosted browser: what\n// turns within this long goes as one, so the page keeps up with the hand instead of trailing it.\nconst WHEEL_EVERY_MS = 50;\nconst LINE_PX = 16; // a wheel that scrolls by lines, in pixels\nconst MAX_DELTA = 10_000;\nconst MAX_PASTE = 4_000;\n\nconst clamp = (value: number, limit: number) => Math.min(Math.max(value, -limit), limit);\n\n/**\n * Sends what the person does on `element` (the screen) to `send`, in the page's pixels; the\n * returned function stops it. The pointer goes as down, move and up (drags and double clicks\n * work as on the page; a drag that leaves the screen still ends), the wheel as wheel (the page\n * around does not scroll; the turns of `WHEEL_EVERY_MS` summed into one), keys while the screen\n * has the focus, and text pasted there as text. A key still held when the focus goes is let go.\n * The context menu is the page's.\n */\nexport function capture(\n  element: HTMLElement,\n  size: Size,\n  send: (input: BrowserInput) => void,\n): () => void {\n  const held = new Map<string, KeyInput>();\n  let lastMove = Number.NEGATIVE_INFINITY;\n  const at = (event: { clientX: number; clientY: number }) =>\n    pointOf(event, element.getBoundingClientRect(), size);\n  // The wheel's turns not sent yet, where the pointer was, and when the last went.\n  const turned = { x: 0, y: 0, dx: 0, dy: 0 };\n  let lastWheel = Number.NEGATIVE_INFINITY;\n  let wheelTimer: ReturnType<typeof setTimeout> | undefined;\n  const flushWheel = () => {\n    wheelTimer = undefined;\n    lastWheel = performance.now();\n    const { x, y, dx, dy } = turned;\n    turned.dx = 0;\n    turned.dy = 0;\n    if (dx !== 0 || dy !== 0) {\n      send({ kind: \"wheel\", x, y, dx: clamp(dx, MAX_DELTA), dy: clamp(dy, MAX_DELTA) });\n    }\n  };\n\n  const down = (event: PointerEvent) => {\n    const button = BUTTONS[event.button];\n    if (!button) return;\n    event.preventDefault(); // the page would select the screen, and keep the focus where it was\n    element.focus({ preventScroll: true });\n    element.setPointerCapture(event.pointerId);\n    const clicks = Math.min(Math.max(event.detail, 1), 3);\n    send({ kind: \"mouse\", action: \"down\", ...at(event), button, clicks });\n  };\n  const up = (event: PointerEvent) => {\n    const button = BUTTONS[event.button];\n    if (!button) return;\n    const clicks = Math.min(Math.max(event.detail, 1), 3);\n    send({ kind: \"mouse\", action: \"up\", ...at(event), button, clicks });\n  };\n  const move = (event: PointerEvent) => {\n    if (event.timeStamp - lastMove < MOVE_EVERY_MS) return;\n    lastMove = event.timeStamp;\n    send({ kind: \"mouse\", action: \"move\", ...at(event) });\n  };\n  const wheel = (event: WheelEvent) => {\n    event.preventDefault();\n    const unit = event.deltaMode === 1 ? LINE_PX : event.deltaMode === 2 ? size.height : 1;\n    Object.assign(turned, at(event));\n    turned.dx += event.deltaX * unit;\n    turned.dy += event.deltaY * unit;\n    if (wheelTimer !== undefined) return;\n    // The first turn goes at once; what follows it within the window, together at its end.\n    const wait = lastWheel + WHEEL_EVERY_MS - performance.now();\n    if (wait <= 0) flushWheel();\n    else wheelTimer = setTimeout(flushWheel, wait);\n  };\n  const keyed = (action: \"down\" | \"up\") => (event: KeyboardEvent) => {\n    if (event.isComposing) return;\n    const key = keyOf(event, action);\n    if (!key) return;\n    event.preventDefault();\n    if (action === \"down\") held.set(event.code || event.key, { ...key, action: \"up\" });\n    else held.delete(event.code || event.key);\n    send(key);\n  };\n  const paste = (event: ClipboardEvent) => {\n    const text = event.clipboardData?.getData(\"text/plain\") ?? \"\";\n    if (text === \"\") return;\n    event.preventDefault();\n    send({ kind: \"paste\", text: text.slice(0, MAX_PASTE) });\n  };\n  const letGo = () => {\n    for (const key of held.values()) send(key);\n    held.clear();\n  };\n  const noMenu = (event: Event) => {\n    event.preventDefault();\n  };\n  const keyDown = keyed(\"down\");\n  const keyUp = keyed(\"up\");\n\n  element.addEventListener(\"pointerdown\", down);\n  element.addEventListener(\"pointerup\", up);\n  element.addEventListener(\"pointermove\", move);\n  element.addEventListener(\"wheel\", wheel, { passive: false });\n  element.addEventListener(\"keydown\", keyDown);\n  element.addEventListener(\"keyup\", keyUp);\n  element.addEventListener(\"paste\", paste);\n  element.addEventListener(\"blur\", letGo);\n  element.addEventListener(\"contextmenu\", noMenu);\n  return () => {\n    clearTimeout(wheelTimer);\n    element.removeEventListener(\"pointerdown\", down);\n    element.removeEventListener(\"pointerup\", up);\n    element.removeEventListener(\"pointermove\", move);\n    element.removeEventListener(\"wheel\", wheel);\n    element.removeEventListener(\"keydown\", keyDown);\n    element.removeEventListener(\"keyup\", keyUp);\n    element.removeEventListener(\"paste\", paste);\n    element.removeEventListener(\"blur\", letGo);\n    element.removeEventListener(\"contextmenu\", noMenu);\n  };\n}\n\n/**\n * The bytes in a base64 string: the platform's own decoder where it has one, else a plain loop\n * (`Uint8Array.from` with a mapper walks a frame's 100,000 characters through an iterator, a\n * callback each, on the main thread, as the next picture is due).\n */\nexport function bytesOf(base64: string): Uint8Array<ArrayBuffer> {\n  const native = (Uint8Array as { fromBase64?: (text: string) => Uint8Array<ArrayBuffer> })\n    .fromBase64;\n  if (native) return native(base64);\n  const text = atob(base64);\n  const bytes = new Uint8Array(text.length);\n  for (let at = 0; at < text.length; at += 1) bytes[at] = text.charCodeAt(at);\n  return bytes;\n}\n\n/** Draws a picture on a canvas, unless a newer one comes while it is still being decoded. */\nexport interface Painter {\n  paint: (jpeg: string) => void;\n  dispose: () => void;\n}\n\n/**\n * Paints JPEGs (base64) on `canvas`, stretched to its size, v2's way: decoded off the main thread\n * (`createImageBitmap`), one at a time, and drawn on the screen's next frame, so a picture never\n * lands mid-paint. A picture that comes while another is being decoded waits, and a newer one\n * replaces it, as a newer decoded one replaces one not drawn yet: a slow device skips to the\n * present instead of falling behind. The canvas keeps the last picture until the next is ready,\n * so it never flickers; one that does not decode is skipped. `onPaint` hears each one drawn.\n */\nexport function painterOn(canvas: HTMLCanvasElement, onPaint?: () => void): Painter {\n  let decoding = false;\n  let waiting: string | undefined;\n  let ready: ImageBitmap | undefined; // decoded, for the next frame\n  let frame = 0; // the animation frame asked for, if one is\n  let disposed = false;\n\n  const draw = () => {\n    frame = 0;\n    const bitmap = ready;\n    ready = undefined;\n    if (!bitmap) return;\n    canvas.getContext(\"2d\")?.drawImage(bitmap, 0, 0, canvas.width, canvas.height);\n    bitmap.close();\n    onPaint?.();\n  };\n\n  const decode = async (jpeg: string): Promise<void> => {\n    decoding = true;\n    try {\n      const bitmap = await createImageBitmap(new Blob([bytesOf(jpeg)], { type: \"image/jpeg\" }));\n      if (disposed) {\n        bitmap.close();\n      } else {\n        ready?.close();\n        ready = bitmap;\n        if (frame === 0) frame = requestAnimationFrame(draw);\n      }\n    } catch {\n      // Cut off or damaged: the next picture replaces it.\n    }\n    decoding = false;\n    const next = waiting;\n    waiting = undefined;\n    if (next !== undefined && !disposed) await decode(next);\n  };\n\n  return {\n    paint: (jpeg) => {\n      if (decoding) waiting = jpeg;\n      else void decode(jpeg);\n    },\n    dispose: () => {\n      disposed = true;\n      waiting = undefined;\n      if (frame !== 0) cancelAnimationFrame(frame);\n      ready?.close();\n      ready = undefined;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/call.d.ts

@@ -0,0 +1,89 @@
+import { CallReason } from "./types.js";
+import { OrbState } from "./voice/orbs.js";
+//#region src/call.d.ts
+/** What the agent is doing, as LiveKit's agents publish it (`lk.agent.state`). */
+export type AgentActivity = "initializing" | "idle" | "listening" | "thinking" | "speaking";
+/** Why a call that began is over. */
+export type CallEndedBy =
+/** The person hung up. */
+"person" |
+/** The agent did: it said one of its goodbyes. */
+"agent" |
+/** It reached its longest time. */
+"limit" |
+/** The line went: the network, or the agent's side fell. */
+"dropped";
+/** Why a call never began. */
+export type CallProblem =
+/** The person, or the browser, said no to the microphone. */
+"denied" |
+/** There is no microphone to use. */
+"nomic" |
+/** Another application holds the microphone. */
+"inuse" |
+/** This browser can't call: no microphone access at all (an old one, or a page not on https). */
+"unsupported" |
+/** Calls aren't set up where the agent works (the API refused with `no_calls`). */
+"off" |
+/** The agent takes no calls: a squad's builder (`builder`). */
+"builder" |
+/** The API wouldn't make the call, for any other reason it named. */
+"refused" |
+/** The call couldn't be made or joined. */
+"failed" |
+/** The room was there, but no agent came to it. */
+"unanswered";
+/** How a call ended: why, and how long it lasted from when the agent picked up. */
+export interface CallEnd {
+  /**
+   * Why, as far as the room knows: null when the agent's side closed it (its goodbye, or its
+   * longest time), which only the API says (`endedByReason`).
+   */
+  by: CallEndedBy | null;
+  seconds: number;
+}
+/** Where a call stands. */
+export interface CallState {
+  /** Opening the microphone and the room; ringing until the agent joins; on; over. */
+  stage: "opening" | "ringing" | "on" | "over";
+  /** When the agent joined, in ms; the call's time counts from it. */
+  answeredAt: number | null;
+  /** What the agent says it is doing; null while it says nothing. */
+  agent: AgentActivity | null;
+  /** Whether the agent's voice is coming, for an agent that doesn't say what it is doing. */
+  speaking: boolean;
+  /** The line is being found again; the call goes on once it is. */
+  reconnecting: boolean;
+  muted: boolean;
+  /** The browser holds the agent's voice until the person presses something. */
+  silenced: boolean;
+  end: CallEnd | null;
+  problem: CallProblem | null;
+}
+/** What the call shows, in one word: each has its words, its look and its orb. */
+export type CallLook = "connecting" | "listening" | "thinking" | "speaking" | "reconnecting" | "ended" | "problem";
+/**
+ * What the call shows now. Before the agent picks up, and while it starts, it is connecting;
+ * then what the agent says it is doing (an agent that says nothing is speaking while its voice
+ * comes, listening otherwise).
+ */
+export declare function lookOf(state: CallState): CallLook;
+/**
+ * What the orb shows of a call: what the agent is doing once the call is on, moved by whoever is
+ * speaking (the agent's voice while it speaks, the person's microphone while it listens); at rest
+ * while the line is found (connecting, reconnecting) and once the call is over.
+ */
+export declare function orbOf(look: CallLook): {
+  state: OrbState;
+  follows: "agent" | "person" | null;
+};
+/**
+ * Why a call ended as the API keeps it (`CallGlance.reason`), as the call says it: the person hung
+ * up, the agent said goodbye, it reached its longest time; anything else (it failed, its end never
+ * came) is a line that dropped. Null while the API has no end for it yet.
+ */
+export declare function endedByReason(reason: CallReason | null | undefined): CallEndedBy | null;
+/** A call's time as a phone shows it: 0:07, 12:34, 1:02:03. */
+export declare function durationOf(seconds: number): string;
+//#endregion
+//# sourceMappingURL=call.d.ts.map

package/dist/call.js

@@ -0,0 +1,218 @@
+import { ApiError } from "./client.js";
+//#region src/call.ts
+/**
+* A voice call with an agent, as the person on it sees it: where it stands, why it ended or
+* never began, and how long it lasted. Pure, so it is tested without a room; `useCall` feeds it
+* what LiveKit says.
+*/
+const CALL_START = {
+	stage: "opening",
+	answeredAt: null,
+	agent: null,
+	speaking: false,
+	reconnecting: false,
+	muted: false,
+	silenced: false,
+	end: null,
+	problem: null
+};
+/**
+* The call, one event at a time. Once over (ended, or never begun) nothing moves it again: the
+* room's last words after a hang-up (its disconnect, a track going) are not news.
+*/
+function callReducer(state, event) {
+	if (state.stage === "over") return state;
+	switch (event.type) {
+		case "ringing": return state.stage === "opening" ? {
+			...state,
+			stage: "ringing"
+		} : state;
+		case "answered": return state.answeredAt === null ? {
+			...state,
+			stage: "on",
+			answeredAt: event.at
+		} : state;
+		case "agent": return {
+			...state,
+			agent: event.activity
+		};
+		case "speaking": return {
+			...state,
+			speaking: event.speaking
+		};
+		case "reconnecting": return {
+			...state,
+			reconnecting: event.reconnecting
+		};
+		case "muted": return {
+			...state,
+			muted: event.muted
+		};
+		case "silenced": return {
+			...state,
+			silenced: event.silenced
+		};
+		case "ended": {
+			const seconds = state.answeredAt === null ? 0 : secondsBetween(state.answeredAt, event.at);
+			return {
+				...state,
+				stage: "over",
+				reconnecting: false,
+				end: {
+					by: event.by,
+					seconds
+				}
+			};
+		}
+		case "failed": return {
+			...state,
+			stage: "over",
+			reconnecting: false,
+			problem: event.problem
+		};
+	}
+}
+const secondsBetween = (from, to) => Math.max(0, Math.floor((to - from) / 1e3));
+/**
+* What the call shows now. Before the agent picks up, and while it starts, it is connecting;
+* then what the agent says it is doing (an agent that says nothing is speaking while its voice
+* comes, listening otherwise).
+*/
+function lookOf(state) {
+	if (state.problem !== null) return "problem";
+	if (state.end !== null) return "ended";
+	if (state.answeredAt === null || state.agent === "initializing") return "connecting";
+	if (state.reconnecting) return "reconnecting";
+	if (state.agent === "thinking" || state.agent === "speaking") return state.agent;
+	if (state.agent === null && state.speaking) return "speaking";
+	return "listening";
+}
+/**
+* What the orb shows of a call: what the agent is doing once the call is on, moved by whoever is
+* speaking (the agent's voice while it speaks, the person's microphone while it listens); at rest
+* while the line is found (connecting, reconnecting) and once the call is over.
+*/
+function orbOf(look) {
+	switch (look) {
+		case "speaking": return {
+			state: look,
+			follows: "agent"
+		};
+		case "listening": return {
+			state: look,
+			follows: "person"
+		};
+		case "thinking": return {
+			state: look,
+			follows: null
+		};
+		default: return {
+			state: "idle",
+			follows: null
+		};
+	}
+}
+/** The agent's state as LiveKit's agents publish it, or null for anything else. */
+function activityOf(value) {
+	switch (value) {
+		case "initializing":
+		case "idle":
+		case "listening":
+		case "thinking":
+		case "speaking": return value;
+		default: return null;
+	}
+}
+/**
+* Why the room let the person go, as LiveKit says it (`DisconnectReason`'s names): they hung up;
+* the room was closed under them, which is the agent's side ending the call (its goodbye, or its
+* longest time: null, the API says which); anything else, the line went.
+*/
+function endedBy(reason, hungUp) {
+	if (hungUp || reason === "CLIENT_INITIATED") return "person";
+	if (reason === "ROOM_DELETED" || reason === "ROOM_CLOSED" || reason === "PARTICIPANT_REMOVED") return null;
+	return "dropped";
+}
+/**
+* Why a call ended as the API keeps it (`CallGlance.reason`), as the call says it: the person hung
+* up, the agent said goodbye, it reached its longest time; anything else (it failed, its end never
+* came) is a line that dropped. Null while the API has no end for it yet.
+*/
+function endedByReason(reason) {
+	switch (reason) {
+		case "caller": return "person";
+		case "agent": return "agent";
+		case "max_duration": return "limit";
+		case null:
+		case void 0: return null;
+		default: return "dropped";
+	}
+}
+/**
+* Why a call couldn't be made, from what asking for it threw: the API's refusal, by its code
+* (calls not set up where the agent works, an agent that takes none, any other it named);
+* anything else (no answer, or one that named nothing) is a call that failed.
+*/
+function refusalOf(error) {
+	if (!(error instanceof ApiError) || error.code === null) return "failed";
+	switch (error.code) {
+		case "no_calls": return "off";
+		case "builder": return "builder";
+		default: return "refused";
+	}
+}
+/**
+* Why the microphone couldn't be opened, from the browser's error (`DOMException` names, as
+* LiveKit reads them too); one the browser doesn't name is a call that failed.
+*/
+function callProblemOf(error) {
+	switch (error instanceof Error || isNamed(error) ? error.name : "") {
+		case "NotAllowedError":
+		case "PermissionDeniedError":
+		case "SecurityError": return "denied";
+		case "NotFoundError":
+		case "DevicesNotFoundError":
+		case "OverconstrainedError": return "nomic";
+		case "NotReadableError":
+		case "TrackStartError":
+		case "AbortError": return "inuse";
+		default: return "failed";
+	}
+}
+const isNamed = (value) => typeof value === "object" && value !== null && "name" in value && typeof value.name === "string";
+/** A call's time as a phone shows it: 0:07, 12:34, 1:02:03. */
+function durationOf(seconds) {
+	const whole = Math.max(0, Math.floor(seconds));
+	const hours = Math.floor(whole / 3600);
+	const minutes = Math.floor(whole % 3600 / 60);
+	const rest = String(whole % 60).padStart(2, "0");
+	return hours > 0 ? `${hours}:${String(minutes).padStart(2, "0")}:${rest}` : `${minutes}:${rest}`;
+}
+/**
+* A loudness read off a track (0 to 1, the root mean square of its spectrum as LiveKit measures
+* it) as the orb shows it: speech sits low on that scale, so it is lifted and the floor of a quiet
+* room cut away.
+*/
+function loudness(volume) {
+	const lifted = (volume - FLOOR) / (1 - FLOOR);
+	return Math.min(1, Math.max(0, Math.sqrt(Math.max(0, lifted)) * GAIN));
+}
+const FLOOR = .04;
+const GAIN = 1.25;
+/**
+* Whether a key belongs to what it was pressed on, not to the call: a field being typed in, or a
+* control of the page's own (outside the call) that Space presses. Elsewhere (the call itself,
+* the page, a dialog it sits in) Space mutes and unmutes.
+*/
+function keyBelongsElsewhere(target, call) {
+	if (!(target instanceof Element)) return false;
+	if (target.matches(EDITABLE)) return true;
+	if (call?.contains(target)) return false;
+	return target.matches(PRESSABLE);
+}
+const EDITABLE = "input, textarea, select, [contenteditable]:not([contenteditable=\"false\"])";
+const PRESSABLE = "button, a[href], summary, [role=\"button\"], [role=\"checkbox\"], [role=\"switch\"], [role=\"radio\"], [role=\"tab\"], [role=\"menuitem\"], [role=\"option\"], [role=\"slider\"]";
+//#endregion
+export { CALL_START, activityOf, callProblemOf, callReducer, durationOf, endedBy, endedByReason, keyBelongsElsewhere, lookOf, loudness, orbOf, refusalOf };
+
+//# sourceMappingURL=call.js.map

package/dist/call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.js","names":[],"sources":["../src/call.ts"],"sourcesContent":["/**\n * A voice call with an agent, as the person on it sees it: where it stands, why it ended or\n * never began, and how long it lasted. Pure, so it is tested without a room; `useCall` feeds it\n * what LiveKit says.\n */\n\nimport { ApiError } from \"./client\";\nimport type { CallReason } from \"./types\";\nimport type { OrbState } from \"./voice/orbs\";\n\n/** What the agent is doing, as LiveKit's agents publish it (`lk.agent.state`). */\nexport type AgentActivity = \"initializing\" | \"idle\" | \"listening\" | \"thinking\" | \"speaking\";\n\n/** Why a call that began is over. */\nexport type CallEndedBy =\n  /** The person hung up. */\n  | \"person\"\n  /** The agent did: it said one of its goodbyes. */\n  | \"agent\"\n  /** It reached its longest time. */\n  | \"limit\"\n  /** The line went: the network, or the agent's side fell. */\n  | \"dropped\";\n\n/** Why a call never began. */\nexport type CallProblem =\n  /** The person, or the browser, said no to the microphone. */\n  | \"denied\"\n  /** There is no microphone to use. */\n  | \"nomic\"\n  /** Another application holds the microphone. */\n  | \"inuse\"\n  /** This browser can't call: no microphone access at all (an old one, or a page not on https). */\n  | \"unsupported\"\n  /** Calls aren't set up where the agent works (the API refused with `no_calls`). */\n  | \"off\"\n  /** The agent takes no calls: a squad's builder (`builder`). */\n  | \"builder\"\n  /** The API wouldn't make the call, for any other reason it named. */\n  | \"refused\"\n  /** The call couldn't be made or joined. */\n  | \"failed\"\n  /** The room was there, but no agent came to it. */\n  | \"unanswered\";\n\n/** How a call ended: why, and how long it lasted from when the agent picked up. */\nexport interface CallEnd {\n  /**\n   * Why, as far as the room knows: null when the agent's side closed it (its goodbye, or its\n   * longest time), which only the API says (`endedByReason`).\n   */\n  by: CallEndedBy | null;\n  seconds: number;\n}\n\n/** Where a call stands. */\nexport interface CallState {\n  /** Opening the microphone and the room; ringing until the agent joins; on; over. */\n  stage: \"opening\" | \"ringing\" | \"on\" | \"over\";\n  /** When the agent joined, in ms; the call's time counts from it. */\n  answeredAt: number | null;\n  /** What the agent says it is doing; null while it says nothing. */\n  agent: AgentActivity | null;\n  /** Whether the agent's voice is coming, for an agent that doesn't say what it is doing. */\n  speaking: boolean;\n  /** The line is being found again; the call goes on once it is. */\n  reconnecting: boolean;\n  muted: boolean;\n  /** The browser holds the agent's voice until the person presses something. */\n  silenced: boolean;\n  end: CallEnd | null;\n  problem: CallProblem | null;\n}\n\nexport const CALL_START: CallState = {\n  stage: \"opening\",\n  answeredAt: null,\n  agent: null,\n  speaking: false,\n  reconnecting: false,\n  muted: false,\n  silenced: false,\n  end: null,\n  problem: null,\n};\n\n/** What moves a call, from the room. */\nexport type CallEvent =\n  | { type: \"ringing\" }\n  | { type: \"answered\"; at: number }\n  | { type: \"agent\"; activity: AgentActivity | null }\n  | { type: \"speaking\"; speaking: boolean }\n  | { type: \"reconnecting\"; reconnecting: boolean }\n  | { type: \"muted\"; muted: boolean }\n  | { type: \"silenced\"; silenced: boolean }\n  | { type: \"ended\"; by: CallEndedBy | null; at: number }\n  | { type: \"failed\"; problem: CallProblem };\n\n/**\n * The call, one event at a time. Once over (ended, or never begun) nothing moves it again: the\n * room's last words after a hang-up (its disconnect, a track going) are not news.\n */\nexport function callReducer(state: CallState, event: CallEvent): CallState {\n  if (state.stage === \"over\") return state;\n  switch (event.type) {\n    case \"ringing\":\n      return state.stage === \"opening\" ? { ...state, stage: \"ringing\" } : state;\n    case \"answered\":\n      return state.answeredAt === null ? { ...state, stage: \"on\", answeredAt: event.at } : state;\n    case \"agent\":\n      return { ...state, agent: event.activity };\n    case \"speaking\":\n      return { ...state, speaking: event.speaking };\n    case \"reconnecting\":\n      return { ...state, reconnecting: event.reconnecting };\n    case \"muted\":\n      return { ...state, muted: event.muted };\n    case \"silenced\":\n      return { ...state, silenced: event.silenced };\n    case \"ended\": {\n      const seconds = state.answeredAt === null ? 0 : secondsBetween(state.answeredAt, event.at);\n      return { ...state, stage: \"over\", reconnecting: false, end: { by: event.by, seconds } };\n    }\n    case \"failed\":\n      return { ...state, stage: \"over\", reconnecting: false, problem: event.problem };\n  }\n}\n\nconst secondsBetween = (from: number, to: number): number =>\n  Math.max(0, Math.floor((to - from) / 1000));\n\n/** What the call shows, in one word: each has its words, its look and its orb. */\nexport type CallLook =\n  \"connecting\" | \"listening\" | \"thinking\" | \"speaking\" | \"reconnecting\" | \"ended\" | \"problem\";\n\n/**\n * What the call shows now. Before the agent picks up, and while it starts, it is connecting;\n * then what the agent says it is doing (an agent that says nothing is speaking while its voice\n * comes, listening otherwise).\n */\nexport function lookOf(state: CallState): CallLook {\n  if (state.problem !== null) return \"problem\";\n  if (state.end !== null) return \"ended\";\n  if (state.answeredAt === null || state.agent === \"initializing\") return \"connecting\";\n  if (state.reconnecting) return \"reconnecting\";\n  if (state.agent === \"thinking\" || state.agent === \"speaking\") return state.agent;\n  if (state.agent === null && state.speaking) return \"speaking\";\n  return \"listening\";\n}\n\n/**\n * What the orb shows of a call: what the agent is doing once the call is on, moved by whoever is\n * speaking (the agent's voice while it speaks, the person's microphone while it listens); at rest\n * while the line is found (connecting, reconnecting) and once the call is over.\n */\nexport function orbOf(look: CallLook): { state: OrbState; follows: \"agent\" | \"person\" | null } {\n  switch (look) {\n    case \"speaking\":\n      return { state: look, follows: \"agent\" };\n    case \"listening\":\n      return { state: look, follows: \"person\" };\n    case \"thinking\":\n      return { state: look, follows: null };\n    default:\n      return { state: \"idle\", follows: null };\n  }\n}\n\n/** The agent's state as LiveKit's agents publish it, or null for anything else. */\nexport function activityOf(value: string | undefined): AgentActivity | null {\n  switch (value) {\n    case \"initializing\":\n    case \"idle\":\n    case \"listening\":\n    case \"thinking\":\n    case \"speaking\":\n      return value;\n    default:\n      return null;\n  }\n}\n\n/**\n * Why the room let the person go, as LiveKit says it (`DisconnectReason`'s names): they hung up;\n * the room was closed under them, which is the agent's side ending the call (its goodbye, or its\n * longest time: null, the API says which); anything else, the line went.\n */\nexport function endedBy(reason: string | undefined, hungUp: boolean): CallEndedBy | null {\n  if (hungUp || reason === \"CLIENT_INITIATED\") return \"person\";\n  if (reason === \"ROOM_DELETED\" || reason === \"ROOM_CLOSED\" || reason === \"PARTICIPANT_REMOVED\") {\n    return null;\n  }\n  return \"dropped\";\n}\n\n/**\n * Why a call ended as the API keeps it (`CallGlance.reason`), as the call says it: the person hung\n * up, the agent said goodbye, it reached its longest time; anything else (it failed, its end never\n * came) is a line that dropped. Null while the API has no end for it yet.\n */\nexport function endedByReason(reason: CallReason | null | undefined): CallEndedBy | null {\n  switch (reason) {\n    case \"caller\":\n      return \"person\";\n    case \"agent\":\n      return \"agent\";\n    case \"max_duration\":\n      return \"limit\";\n    case null:\n    case undefined:\n      return null;\n    default:\n      return \"dropped\";\n  }\n}\n\n/**\n * Why a call couldn't be made, from what asking for it threw: the API's refusal, by its code\n * (calls not set up where the agent works, an agent that takes none, any other it named);\n * anything else (no answer, or one that named nothing) is a call that failed.\n */\nexport function refusalOf(error: unknown): CallProblem {\n  if (!(error instanceof ApiError) || error.code === null) return \"failed\";\n  switch (error.code) {\n    case \"no_calls\":\n      return \"off\";\n    case \"builder\":\n      return \"builder\";\n    default:\n      return \"refused\";\n  }\n}\n\n/**\n * Why the microphone couldn't be opened, from the browser's error (`DOMException` names, as\n * LiveKit reads them too); one the browser doesn't name is a call that failed.\n */\nexport function callProblemOf(error: unknown): CallProblem {\n  const name = error instanceof Error || isNamed(error) ? error.name : \"\";\n  switch (name) {\n    case \"NotAllowedError\":\n    case \"PermissionDeniedError\":\n    case \"SecurityError\":\n      return \"denied\";\n    case \"NotFoundError\":\n    case \"DevicesNotFoundError\":\n    case \"OverconstrainedError\":\n      return \"nomic\";\n    case \"NotReadableError\":\n    case \"TrackStartError\":\n    case \"AbortError\":\n      return \"inuse\";\n    default:\n      return \"failed\";\n  }\n}\n\nconst isNamed = (value: unknown): value is { name: string } =>\n  typeof value === \"object\" &&\n  value !== null &&\n  \"name\" in value &&\n  typeof (value as { name: unknown }).name === \"string\";\n\n/** A call's time as a phone shows it: 0:07, 12:34, 1:02:03. */\nexport function durationOf(seconds: number): string {\n  const whole = Math.max(0, Math.floor(seconds));\n  const hours = Math.floor(whole / 3600);\n  const minutes = Math.floor((whole % 3600) / 60);\n  const rest = String(whole % 60).padStart(2, \"0\");\n  return hours > 0 ? `${hours}:${String(minutes).padStart(2, \"0\")}:${rest}` : `${minutes}:${rest}`;\n}\n\n/**\n * A loudness read off a track (0 to 1, the root mean square of its spectrum as LiveKit measures\n * it) as the orb shows it: speech sits low on that scale, so it is lifted and the floor of a quiet\n * room cut away.\n */\nexport function loudness(volume: number): number {\n  const lifted = (volume - FLOOR) / (1 - FLOOR);\n  return Math.min(1, Math.max(0, Math.sqrt(Math.max(0, lifted)) * GAIN));\n}\n\nconst FLOOR = 0.04;\nconst GAIN = 1.25;\n\n/**\n * Whether a key belongs to what it was pressed on, not to the call: a field being typed in, or a\n * control of the page's own (outside the call) that Space presses. Elsewhere (the call itself,\n * the page, a dialog it sits in) Space mutes and unmutes.\n */\nexport function keyBelongsElsewhere(target: EventTarget | null, call: Element | null): boolean {\n  if (!(target instanceof Element)) return false;\n  if (target.matches(EDITABLE)) return true;\n  if (call?.contains(target)) return false;\n  return target.matches(PRESSABLE);\n}\n\nconst EDITABLE = 'input, textarea, select, [contenteditable]:not([contenteditable=\"false\"])';\nconst PRESSABLE =\n  'button, a[href], summary, [role=\"button\"], [role=\"checkbox\"], [role=\"switch\"], [role=\"radio\"], [role=\"tab\"], [role=\"menuitem\"], [role=\"option\"], [role=\"slider\"]';\n"],"mappings":"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"}