@signalcore/ui 0.1.0 → 1.0.0-beta.0

package/dist/VoiceCall.d.ts

@@ -0,0 +1,91 @@
+import { KitPart } from "./kit/context.js";
+import { AgentTint } from "./tint.js";
+import { OrbStyle } from "./voice/orbs.js";
+import { CallEndedBy, CallLook, CallProblem } from "./call.js";
+import { CallJoin } from "./useCall.js";
+import { ReactNode } from "react";
+//#region src/VoiceCall.d.ts
+/** The words a call says; a host gives its own, in its language. */
+export interface VoiceCallMessages {
+  /** The call's name, for those who can't see it. */
+  call: (name: string) => string;
+  /** What the call is doing, in a word or two. */
+  states: Readonly<Record<Exclude<CallLook, "problem">, string>>;
+  /** Under the state while the call connects. */
+  calling: (name: string) => string;
+  /** Why the call ended, before how long it lasted. */
+  ended: Readonly<Record<CallEndedBy, (name: string) => string>>;
+  /** Why the call never began, and what the person can do about it. */
+  problems: Readonly<Record<CallProblem, {
+    title: (name: string) => string;
+    help: string;
+  }>>;
+  mute: string;
+  hangUp: string;
+  /** Under the controls, where there is a keyboard. */
+  keys: string;
+  /** Under the controls while the microphone is off. */
+  muted: string;
+  /** The browser held the agent's voice until a press: the button that lets it play. */
+  hear: (name: string) => string;
+}
+export declare const VOICE_CALL_MESSAGES: VoiceCallMessages;
+/** The call's parts, by the class each carries; `classNames` adds a host's own under the same keys. */
+export type VoiceCallPart = "sc-call" | `sc-call--${CallLook}` | `sc-call--${AgentTint}` | "sc-call--on" | "sc-call--muted" | "sc-call__stage" | "sc-call__orb" | "sc-call__state" | "sc-call__line" | "sc-call__sound" | "sc-call__controls" | "sc-call__control" | "sc-call__mute" | "sc-call__hangup" | "sc-call__hint" | "sc-call__captions" | "sc-call__after";
+export interface VoiceCallProps {
+  /**
+   * Where to join: LiveKit's address and a token for the call's room (our API's
+   * `client.conversations.call(agentId)` answers both, `client.agents.call(id)` for the owner's
+   * test). Called once, when the call starts, after the microphone is open.
+   */
+  connect: () => Promise<CallJoin>;
+  /** The agent's name, for the words that say it. */
+  name: string;
+  /**
+   * The agent's own tint (`agentTint(id)`), worn by the call's chrome: the orb's shader paints its
+   * own colours, and the still orb that stands in where there is no WebGL wears it.
+   */
+  tint?: AgentTint | undefined;
+  /** How the orb is drawn: `"wave"` (the default) or `"fluid-dots"`. */
+  orb?: OrbStyle | undefined;
+  /** The orb's diameter in pixels: 280 by default, less for a call in a small panel. */
+  orbSize?: number | undefined;
+  /**
+   * Why the call ended as the API keeps it, once the host has read it (`endedByReason` of its
+   * conversation's call): what the end says when the agent's side closed the room (its goodbye,
+   * or its longest time), which the room doesn't tell. Until then the end says how long it was.
+   */
+  endedBy?: CallEndedBy | null | undefined;
+  messages?: Partial<VoiceCallMessages> | undefined;
+  /** The host's classes for the call's parts and the kit's (the orb's `sc-orb…`, the buttons'). */
+  classNames?: Partial<Record<VoiceCallPart | KitPart, string>> | undefined;
+  /**
+   * The call is over, once: it ended (`answered`: the agent took it; `problem` null), or it
+   * couldn't begin (`problem`: why, which the call shows until the host takes it away).
+   */
+  onEnd?: ((answered: boolean, problem: CallProblem | null) => void) | undefined;
+  /** The agent took the call: its time counts from now. Once. */
+  onAnswer?: (() => void) | undefined;
+  /** What the host offers once the call is over, in place of the controls: call again, write. */
+  after?: ReactNode;
+  /** What is being said, drawn by the host under the orb while the call is on (`sc-call__captions`). */
+  captions?: ReactNode;
+}
+/**
+ * A voice call with an agent, the one a customer has on the phone: the call starts when it
+ * mounts and ends when it unmounts. The orb, large in the middle, rests while the line is found,
+ * moves with whoever speaks (the agent's voice while it speaks, the person's while it listens),
+ * calms while the agent thinks, and fades once the call is over; under it what the call
+ * is doing in a word, its time, and the two controls a phone has, mute and hang up. A microphone
+ * that can't be used, or a call that can't be made (the API's refusal among them), says why in
+ * words and what to do; an end says who ended it (the room's own word, or the API's: `endedBy`)
+ * and how long it lasted.
+ *
+ * Space mutes and unmutes from anywhere that isn't a field or a control of the page's own.
+ * Escape never hangs up: it is the key that closes things, pressed by reflex, and a call ended
+ * by accident can't be taken back, so ending one is the red button's alone. The orb stands
+ * still under reduced motion, one frame per state: the words say the rest.
+ */
+export declare function VoiceCall(props: VoiceCallProps): import("react").JSX.Element;
+//#endregion
+//# sourceMappingURL=VoiceCall.d.ts.map

package/dist/VoiceCall.js

@@ -0,0 +1,302 @@
+import { classes } from "./classes.js";
+import { KitProvider } from "./kit/context.js";
+import { Button } from "./kit/Button.js";
+import { durationOf, keyBelongsElsewhere, lookOf, orbOf } from "./call.js";
+import { useCall } from "./useCall.js";
+import { Orb } from "./voice/Orb.js";
+import { useEffect, useRef, useState } from "react";
+import { MicrophoneIcon, MicrophoneSlashIcon, PhoneDisconnectIcon, SpeakerHighIcon } from "@phosphor-icons/react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/VoiceCall.tsx
+/** How big the orb is drawn: large, in the middle, with room for it to grow when the voice is loud. */
+const ORB_SIZE = 280;
+/** The orb's level where nobody it follows is speaking. */
+const SILENT = () => 0;
+const VOICE_CALL_MESSAGES = {
+	call: (name) => `Call with ${name}`,
+	states: {
+		connecting: "Connecting…",
+		listening: "Listening",
+		thinking: "Thinking",
+		speaking: "Speaking",
+		reconnecting: "Reconnecting…",
+		ended: "Call ended"
+	},
+	calling: (name) => `Calling ${name}`,
+	ended: {
+		person: () => "You hung up",
+		agent: (name) => `${name} hung up`,
+		limit: () => "It reached its longest time",
+		dropped: () => "The line dropped"
+	},
+	problems: {
+		denied: {
+			title: () => "The microphone isn't allowed",
+			help: "Allow the microphone for this page (the icon beside the address) and call again."
+		},
+		nomic: {
+			title: () => "No microphone",
+			help: "Plug one in, or pick another in your system's sound settings, and call again."
+		},
+		inuse: {
+			title: () => "The microphone is busy",
+			help: "Another app is using it. Close it and call again."
+		},
+		unsupported: {
+			title: () => "This browser can't call",
+			help: "Open this page over https in a recent Chrome, Edge, Safari or Firefox."
+		},
+		off: {
+			title: () => "Calls aren't set up",
+			help: "Calls are turned on where your agents work. Ask whoever set it up."
+		},
+		builder: {
+			title: (name) => `${name} doesn't take calls`,
+			help: "A squad's builder only writes. Call one of the squad's agents."
+		},
+		refused: {
+			title: (name) => `${name} can't take this call`,
+			help: "Try again in a moment."
+		},
+		failed: {
+			title: (name) => `Couldn't call ${name}`,
+			help: "Check your connection and try again."
+		},
+		unanswered: {
+			title: (name) => `${name} isn't answering`,
+			help: "Calls aren't being taken right now. Try again in a moment."
+		}
+	},
+	mute: "Mute",
+	hangUp: "Hang up",
+	keys: "Space mutes and unmutes",
+	muted: "Your microphone is off",
+	hear: (name) => `Hear ${name}`
+};
+/**
+* A voice call with an agent, the one a customer has on the phone: the call starts when it
+* mounts and ends when it unmounts. The orb, large in the middle, rests while the line is found,
+* moves with whoever speaks (the agent's voice while it speaks, the person's while it listens),
+* calms while the agent thinks, and fades once the call is over; under it what the call
+* is doing in a word, its time, and the two controls a phone has, mute and hang up. A microphone
+* that can't be used, or a call that can't be made (the API's refusal among them), says why in
+* words and what to do; an end says who ended it (the room's own word, or the API's: `endedBy`)
+* and how long it lasted.
+*
+* Space mutes and unmutes from anywhere that isn't a field or a control of the page's own.
+* Escape never hangs up: it is the key that closes things, pressed by reflex, and a call ended
+* by accident can't be taken back, so ending one is the red button's alone. The orb stands
+* still under reduced motion, one frame per state: the words say the rest.
+*/
+function VoiceCall(props) {
+	return /* @__PURE__ */ jsx(KitProvider, {
+		classNames: props.classNames,
+		children: /* @__PURE__ */ jsx(Call, { ...props })
+	});
+}
+function Call({ connect, name, tint = "sky", orb: style, orbSize = ORB_SIZE, endedBy, messages, classNames, onEnd, onAnswer, after, captions }) {
+	const words = {
+		...VOICE_CALL_MESSAGES,
+		...messages
+	};
+	const root = useRef(null);
+	const sink = useRef(null);
+	const call = useCall(connect, { sink });
+	const { state } = call;
+	const look = lookOf(state);
+	const orb = orbOf(look);
+	const over = state.stage === "over";
+	const seconds = useSeconds(state);
+	useSpace(root, !over, () => {
+		call.mute();
+	});
+	useEffect(() => {
+		root.current?.focus({ preventScroll: true });
+	}, [over]);
+	const told = useRef({
+		onEnd,
+		onAnswer
+	});
+	useEffect(() => {
+		told.current = {
+			onEnd,
+			onAnswer
+		};
+	});
+	const answered = state.answeredAt !== null;
+	useEffect(() => {
+		if (answered) told.current.onAnswer?.();
+	}, [answered]);
+	useEffect(() => {
+		if (over) told.current.onEnd?.(answered, state.problem);
+	}, [over]);
+	const { headline, line } = wordsOf(state, look, seconds, words, name, endedBy ?? null);
+	const modifiers = [`sc-call--${look}`, `sc-call--${tint}`];
+	if (!over) modifiers.push("sc-call--on");
+	if (state.muted && !over) modifiers.push("sc-call--muted");
+	return /* @__PURE__ */ jsxs("section", {
+		ref: root,
+		tabIndex: -1,
+		"aria-label": words.call(name),
+		part: "call",
+		className: `sc ${classes(classNames, "sc-call", ...modifiers)}`,
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: classes(classNames, "sc-call__stage"),
+				children: [
+					/* @__PURE__ */ jsx(Orb, {
+						state: orb.state,
+						level: orb.follows === null ? SILENT : call.meter[orb.follows],
+						size: orbSize,
+						style,
+						label: headline,
+						className: classes(classNames, "sc-call__orb")
+					}),
+					/* @__PURE__ */ jsx("p", {
+						role: "status",
+						part: "call-state",
+						className: classes(classNames, "sc-call__state"),
+						children: /* @__PURE__ */ jsx("span", { children: headline }, headline)
+					}),
+					/* @__PURE__ */ jsx("p", {
+						part: "call-line",
+						className: classes(classNames, "sc-call__line"),
+						children: line
+					})
+				]
+			}),
+			captions !== void 0 && !over && /* @__PURE__ */ jsx("div", {
+				part: "captions",
+				className: classes(classNames, "sc-call__captions"),
+				children: captions
+			}),
+			state.silenced && !over && /* @__PURE__ */ jsx(Button, {
+				size: "sm",
+				icon: SpeakerHighIcon,
+				onClick: call.hear,
+				className: classes(classNames, "sc-call__sound"),
+				children: words.hear(name)
+			}),
+			over ? after !== void 0 && /* @__PURE__ */ jsx("div", {
+				part: "call-after",
+				className: classes(classNames, "sc-call__after"),
+				children: after
+			}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("div", {
+				part: "call-controls",
+				className: classes(classNames, "sc-call__controls"),
+				children: [/* @__PURE__ */ jsxs("div", {
+					className: classes(classNames, "sc-call__control"),
+					children: [/* @__PURE__ */ jsx(Button, {
+						icon: state.muted ? MicrophoneSlashIcon : MicrophoneIcon,
+						"aria-label": words.mute,
+						"aria-pressed": state.muted,
+						disabled: state.stage === "opening",
+						onClick: () => {
+							call.mute();
+						},
+						part: "mute",
+						className: classes(classNames, "sc-call__mute")
+					}), /* @__PURE__ */ jsx("span", {
+						"aria-hidden": true,
+						children: words.mute
+					})]
+				}), /* @__PURE__ */ jsxs("div", {
+					className: classes(classNames, "sc-call__control"),
+					children: [/* @__PURE__ */ jsx(Button, {
+						tone: "danger",
+						icon: PhoneDisconnectIcon,
+						"aria-label": words.hangUp,
+						onClick: call.hangUp,
+						part: "hang-up",
+						className: classes(classNames, "sc-call__hangup")
+					}), /* @__PURE__ */ jsx("span", {
+						"aria-hidden": true,
+						children: words.hangUp
+					})]
+				})]
+			}), /* @__PURE__ */ jsx("p", {
+				"data-keys": state.muted ? void 0 : "",
+				className: classes(classNames, "sc-call__hint"),
+				children: state.muted ? words.muted : words.keys
+			})] }),
+			/* @__PURE__ */ jsx("div", {
+				ref: sink,
+				hidden: true
+			})
+		]
+	});
+}
+/**
+* What the call says: what it is doing (or why it couldn't begin), and under it who is being
+* called, the time, how it ended (as the room knows it, else as the API said: `endedBy`) and how
+* long it lasted, or what to do.
+*/
+function wordsOf(state, look, seconds, words, name, endedBy) {
+	if (look === "problem" && state.problem !== null) {
+		const problem = words.problems[state.problem];
+		return {
+			headline: problem.title(name),
+			line: problem.help
+		};
+	}
+	const headline = look === "problem" ? "" : words.states[look];
+	if (state.end !== null) {
+		const by = state.end.by ?? endedBy;
+		const lasted = durationOf(state.end.seconds);
+		return {
+			headline: by === null ? headline : words.ended[by](name),
+			line: lasted
+		};
+	}
+	return {
+		headline,
+		line: state.answeredAt === null ? words.calling(name) : durationOf(seconds)
+	};
+}
+/** The call's time in whole seconds: counting while it is on, held once it is over. */
+function useSeconds(state) {
+	const [now, setNow] = useState(() => Date.now());
+	const counting = state.answeredAt !== null && state.stage !== "over";
+	useEffect(() => {
+		if (!counting) return void 0;
+		const tick = setInterval(() => {
+			setNow(Date.now());
+		}, 500);
+		return () => {
+			clearInterval(tick);
+		};
+	}, [counting]);
+	if (state.end !== null) return state.end.seconds;
+	if (state.answeredAt === null) return 0;
+	return Math.max(0, Math.floor((now - state.answeredAt) / 1e3));
+}
+/**
+* Space mutes and unmutes while `active`, wherever it doesn't belong to something else (a field,
+* a control of the page's own). Taken whole, down and up: the page doesn't scroll, and a control
+* of the call that has the focus is not pressed by it.
+*/
+function useSpace(root, active, toggle) {
+	const latest = useRef(toggle);
+	useEffect(() => {
+		latest.current = toggle;
+	});
+	useEffect(() => {
+		if (!active) return void 0;
+		const onKey = (event) => {
+			if (event.key !== " " || event.ctrlKey || event.metaKey || event.altKey) return;
+			if (event.defaultPrevented || keyBelongsElsewhere(event.target, root.current)) return;
+			event.preventDefault();
+			if (event.type === "keydown" && !event.repeat) latest.current();
+		};
+		window.addEventListener("keydown", onKey);
+		window.addEventListener("keyup", onKey);
+		return () => {
+			window.removeEventListener("keydown", onKey);
+			window.removeEventListener("keyup", onKey);
+		};
+	}, [active, root]);
+}
+//#endregion
+export { VOICE_CALL_MESSAGES, VoiceCall };
+
+//# sourceMappingURL=VoiceCall.js.map

package/dist/VoiceCall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceCall.js","names":[],"sources":["../src/VoiceCall.tsx"],"sourcesContent":["import {\n  MicrophoneIcon,\n  MicrophoneSlashIcon,\n  PhoneDisconnectIcon,\n  SpeakerHighIcon,\n} from \"@phosphor-icons/react\";\nimport { useEffect, useRef, useState, type ReactNode, type RefObject } from \"react\";\n\nimport {\n  durationOf,\n  keyBelongsElsewhere,\n  lookOf,\n  orbOf,\n  type CallEndedBy,\n  type CallLook,\n  type CallProblem,\n  type CallState,\n} from \"./call\";\nimport { classes } from \"./classes\";\nimport { Button } from \"./kit/Button\";\nimport { KitProvider, type KitClassNames, type KitPart } from \"./kit/context\";\nimport type { AgentTint } from \"./tint\";\nimport { useCall, type CallJoin } from \"./useCall\";\nimport { Orb } from \"./voice/Orb\";\nimport type { OrbStyle } from \"./voice/orbs\";\n\n/** How big the orb is drawn: large, in the middle, with room for it to grow when the voice is loud. */\nconst ORB_SIZE = 280;\n\n/** The orb's level where nobody it follows is speaking. */\nconst SILENT = (): number => 0;\n\n/** The words a call says; a host gives its own, in its language. */\nexport interface VoiceCallMessages {\n  /** The call's name, for those who can't see it. */\n  call: (name: string) => string;\n  /** What the call is doing, in a word or two. */\n  states: Readonly<Record<Exclude<CallLook, \"problem\">, string>>;\n  /** Under the state while the call connects. */\n  calling: (name: string) => string;\n  /** Why the call ended, before how long it lasted. */\n  ended: Readonly<Record<CallEndedBy, (name: string) => string>>;\n  /** Why the call never began, and what the person can do about it. */\n  problems: Readonly<Record<CallProblem, { title: (name: string) => string; help: string }>>;\n  mute: string;\n  hangUp: string;\n  /** Under the controls, where there is a keyboard. */\n  keys: string;\n  /** Under the controls while the microphone is off. */\n  muted: string;\n  /** The browser held the agent's voice until a press: the button that lets it play. */\n  hear: (name: string) => string;\n}\n\nexport const VOICE_CALL_MESSAGES: VoiceCallMessages = {\n  call: (name) => `Call with ${name}`,\n  states: {\n    connecting: \"Connecting…\",\n    listening: \"Listening\",\n    thinking: \"Thinking\",\n    speaking: \"Speaking\",\n    reconnecting: \"Reconnecting…\",\n    ended: \"Call ended\",\n  },\n  calling: (name) => `Calling ${name}`,\n  ended: {\n    person: () => \"You hung up\",\n    agent: (name) => `${name} hung up`,\n    limit: () => \"It reached its longest time\",\n    dropped: () => \"The line dropped\",\n  },\n  problems: {\n    denied: {\n      title: () => \"The microphone isn't allowed\",\n      help: \"Allow the microphone for this page (the icon beside the address) and call again.\",\n    },\n    nomic: {\n      title: () => \"No microphone\",\n      help: \"Plug one in, or pick another in your system's sound settings, and call again.\",\n    },\n    inuse: {\n      title: () => \"The microphone is busy\",\n      help: \"Another app is using it. Close it and call again.\",\n    },\n    unsupported: {\n      title: () => \"This browser can't call\",\n      help: \"Open this page over https in a recent Chrome, Edge, Safari or Firefox.\",\n    },\n    off: {\n      title: () => \"Calls aren't set up\",\n      help: \"Calls are turned on where your agents work. Ask whoever set it up.\",\n    },\n    builder: {\n      title: (name) => `${name} doesn't take calls`,\n      help: \"A squad's builder only writes. Call one of the squad's agents.\",\n    },\n    refused: {\n      title: (name) => `${name} can't take this call`,\n      help: \"Try again in a moment.\",\n    },\n    failed: {\n      title: (name) => `Couldn't call ${name}`,\n      help: \"Check your connection and try again.\",\n    },\n    unanswered: {\n      title: (name) => `${name} isn't answering`,\n      help: \"Calls aren't being taken right now. Try again in a moment.\",\n    },\n  },\n  mute: \"Mute\",\n  hangUp: \"Hang up\",\n  keys: \"Space mutes and unmutes\",\n  muted: \"Your microphone is off\",\n  hear: (name) => `Hear ${name}`,\n};\n\n/** The call's parts, by the class each carries; `classNames` adds a host's own under the same keys. */\nexport type VoiceCallPart =\n  | \"sc-call\"\n  | `sc-call--${CallLook}`\n  | `sc-call--${AgentTint}`\n  | \"sc-call--on\"\n  | \"sc-call--muted\"\n  | \"sc-call__stage\"\n  | \"sc-call__orb\"\n  | \"sc-call__state\"\n  | \"sc-call__line\"\n  | \"sc-call__sound\"\n  | \"sc-call__controls\"\n  | \"sc-call__control\"\n  | \"sc-call__mute\"\n  | \"sc-call__hangup\"\n  | \"sc-call__hint\"\n  | \"sc-call__captions\"\n  | \"sc-call__after\";\n\nexport interface VoiceCallProps {\n  /**\n   * Where to join: LiveKit's address and a token for the call's room (our API's\n   * `client.conversations.call(agentId)` answers both, `client.agents.call(id)` for the owner's\n   * test). Called once, when the call starts, after the microphone is open.\n   */\n  connect: () => Promise<CallJoin>;\n  /** The agent's name, for the words that say it. */\n  name: string;\n  /**\n   * The agent's own tint (`agentTint(id)`), worn by the call's chrome: the orb's shader paints its\n   * own colours, and the still orb that stands in where there is no WebGL wears it.\n   */\n  tint?: AgentTint | undefined;\n  /** How the orb is drawn: `\"wave\"` (the default) or `\"fluid-dots\"`. */\n  orb?: OrbStyle | undefined;\n  /** The orb's diameter in pixels: 280 by default, less for a call in a small panel. */\n  orbSize?: number | undefined;\n  /**\n   * Why the call ended as the API keeps it, once the host has read it (`endedByReason` of its\n   * conversation's call): what the end says when the agent's side closed the room (its goodbye,\n   * or its longest time), which the room doesn't tell. Until then the end says how long it was.\n   */\n  endedBy?: CallEndedBy | null | undefined;\n  messages?: Partial<VoiceCallMessages> | undefined;\n  /** The host's classes for the call's parts and the kit's (the orb's `sc-orb…`, the buttons'). */\n  classNames?: Partial<Record<VoiceCallPart | KitPart, string>> | undefined;\n  /**\n   * The call is over, once: it ended (`answered`: the agent took it; `problem` null), or it\n   * couldn't begin (`problem`: why, which the call shows until the host takes it away).\n   */\n  onEnd?: ((answered: boolean, problem: CallProblem | null) => void) | undefined;\n  /** The agent took the call: its time counts from now. Once. */\n  onAnswer?: (() => void) | undefined;\n  /** What the host offers once the call is over, in place of the controls: call again, write. */\n  after?: ReactNode;\n  /** What is being said, drawn by the host under the orb while the call is on (`sc-call__captions`). */\n  captions?: ReactNode;\n}\n\n/**\n * A voice call with an agent, the one a customer has on the phone: the call starts when it\n * mounts and ends when it unmounts. The orb, large in the middle, rests while the line is found,\n * moves with whoever speaks (the agent's voice while it speaks, the person's while it listens),\n * calms while the agent thinks, and fades once the call is over; under it what the call\n * is doing in a word, its time, and the two controls a phone has, mute and hang up. A microphone\n * that can't be used, or a call that can't be made (the API's refusal among them), says why in\n * words and what to do; an end says who ended it (the room's own word, or the API's: `endedBy`)\n * and how long it lasted.\n *\n * Space mutes and unmutes from anywhere that isn't a field or a control of the page's own.\n * Escape never hangs up: it is the key that closes things, pressed by reflex, and a call ended\n * by accident can't be taken back, so ending one is the red button's alone. The orb stands\n * still under reduced motion, one frame per state: the words say the rest.\n */\nexport function VoiceCall(props: VoiceCallProps) {\n  return (\n    <KitProvider classNames={props.classNames as KitClassNames}>\n      <Call {...props} />\n    </KitProvider>\n  );\n}\n\nfunction Call({\n  connect,\n  name,\n  tint = \"sky\",\n  orb: style,\n  orbSize = ORB_SIZE,\n  endedBy,\n  messages,\n  classNames,\n  onEnd,\n  onAnswer,\n  after,\n  captions,\n}: VoiceCallProps) {\n  const words = { ...VOICE_CALL_MESSAGES, ...messages };\n  const root = useRef<HTMLElement>(null);\n  const sink = useRef<HTMLDivElement>(null);\n  const call = useCall(connect, { sink });\n  const { state } = call;\n  const look = lookOf(state);\n  const orb = orbOf(look);\n  const over = state.stage === \"over\";\n  const seconds = useSeconds(state);\n\n  useSpace(root, !over, () => {\n    call.mute();\n  });\n  // The call takes the keyboard as it opens, so Space is its from the start; and again once over,\n  // when the control that had it is gone, so the host's offers are the next stop.\n  useEffect(() => {\n    root.current?.focus({ preventScroll: true });\n  }, [over]);\n  // The host's ears as it last gave them.\n  const told = useRef({ onEnd, onAnswer });\n  useEffect(() => {\n    told.current = { onEnd, onAnswer };\n  });\n  const answered = state.answeredAt !== null;\n  useEffect(() => {\n    if (answered) told.current.onAnswer?.();\n  }, [answered]);\n  useEffect(() => {\n    if (over) told.current.onEnd?.(answered, state.problem);\n  }, [over]);\n\n  const { headline, line } = wordsOf(state, look, seconds, words, name, endedBy ?? null);\n  const modifiers: VoiceCallPart[] = [`sc-call--${look}`, `sc-call--${tint}`];\n  if (!over) modifiers.push(\"sc-call--on\");\n  if (state.muted && !over) modifiers.push(\"sc-call--muted\");\n\n  return (\n    <section\n      ref={root}\n      tabIndex={-1}\n      aria-label={words.call(name)}\n      part=\"call\"\n      className={`sc ${classes(classNames, \"sc-call\", ...modifiers)}`}\n    >\n      <div className={classes(classNames, \"sc-call__stage\")}>\n        <Orb\n          state={orb.state}\n          level={orb.follows === null ? SILENT : call.meter[orb.follows]}\n          size={orbSize}\n          style={style}\n          label={headline}\n          className={classes(classNames, \"sc-call__orb\")}\n        />\n        <p role=\"status\" part=\"call-state\" className={classes(classNames, \"sc-call__state\")}>\n          <span key={headline}>{headline}</span>\n        </p>\n        <p part=\"call-line\" className={classes(classNames, \"sc-call__line\")}>\n          {line}\n        </p>\n      </div>\n      {captions !== undefined && !over && (\n        <div part=\"captions\" className={classes(classNames, \"sc-call__captions\")}>\n          {captions}\n        </div>\n      )}\n      {state.silenced && !over && (\n        <Button\n          size=\"sm\"\n          icon={SpeakerHighIcon}\n          onClick={call.hear}\n          className={classes(classNames, \"sc-call__sound\")}\n        >\n          {words.hear(name)}\n        </Button>\n      )}\n      {over ? (\n        after !== undefined && (\n          <div part=\"call-after\" className={classes(classNames, \"sc-call__after\")}>\n            {after}\n          </div>\n        )\n      ) : (\n        <>\n          <div part=\"call-controls\" className={classes(classNames, \"sc-call__controls\")}>\n            <div className={classes(classNames, \"sc-call__control\")}>\n              <Button\n                icon={state.muted ? MicrophoneSlashIcon : MicrophoneIcon}\n                aria-label={words.mute}\n                aria-pressed={state.muted}\n                disabled={state.stage === \"opening\"}\n                onClick={() => {\n                  call.mute();\n                }}\n                part=\"mute\"\n                className={classes(classNames, \"sc-call__mute\")}\n              />\n              <span aria-hidden>{words.mute}</span>\n            </div>\n            <div className={classes(classNames, \"sc-call__control\")}>\n              <Button\n                tone=\"danger\"\n                icon={PhoneDisconnectIcon}\n                aria-label={words.hangUp}\n                onClick={call.hangUp}\n                part=\"hang-up\"\n                className={classes(classNames, \"sc-call__hangup\")}\n              />\n              <span aria-hidden>{words.hangUp}</span>\n            </div>\n          </div>\n          <p\n            data-keys={state.muted ? undefined : \"\"}\n            className={classes(classNames, \"sc-call__hint\")}\n          >\n            {state.muted ? words.muted : words.keys}\n          </p>\n        </>\n      )}\n      {/* The agent's voice plays from here. */}\n      <div ref={sink} hidden />\n    </section>\n  );\n}\n\n/**\n * What the call says: what it is doing (or why it couldn't begin), and under it who is being\n * called, the time, how it ended (as the room knows it, else as the API said: `endedBy`) and how\n * long it lasted, or what to do.\n */\nfunction wordsOf(\n  state: CallState,\n  look: CallLook,\n  seconds: number,\n  words: VoiceCallMessages,\n  name: string,\n  endedBy: CallEndedBy | null,\n): { headline: string; line: string } {\n  if (look === \"problem\" && state.problem !== null) {\n    const problem = words.problems[state.problem];\n    return { headline: problem.title(name), line: problem.help };\n  }\n  const headline = look === \"problem\" ? \"\" : words.states[look];\n  if (state.end !== null) {\n    const by = state.end.by ?? endedBy;\n    const lasted = durationOf(state.end.seconds);\n    // Why it ended says it ended; how long it lasted, under it.\n    return { headline: by === null ? headline : words.ended[by](name), line: lasted };\n  }\n  return {\n    headline,\n    line: state.answeredAt === null ? words.calling(name) : durationOf(seconds),\n  };\n}\n\n/** The call's time in whole seconds: counting while it is on, held once it is over. */\nfunction useSeconds(state: CallState): number {\n  const [now, setNow] = useState(() => Date.now());\n  const counting = state.answeredAt !== null && state.stage !== \"over\";\n  useEffect(() => {\n    if (!counting) return undefined;\n    const tick = setInterval(() => {\n      setNow(Date.now());\n    }, 500);\n    return () => {\n      clearInterval(tick);\n    };\n  }, [counting]);\n  if (state.end !== null) return state.end.seconds;\n  if (state.answeredAt === null) return 0;\n  return Math.max(0, Math.floor((now - state.answeredAt) / 1000));\n}\n\n/**\n * Space mutes and unmutes while `active`, wherever it doesn't belong to something else (a field,\n * a control of the page's own). Taken whole, down and up: the page doesn't scroll, and a control\n * of the call that has the focus is not pressed by it.\n */\nfunction useSpace(root: RefObject<HTMLElement | null>, active: boolean, toggle: () => void) {\n  const latest = useRef(toggle);\n  useEffect(() => {\n    latest.current = toggle;\n  });\n  useEffect(() => {\n    if (!active) return undefined;\n    const onKey = (event: KeyboardEvent) => {\n      if (event.key !== \" \" || event.ctrlKey || event.metaKey || event.altKey) return;\n      if (event.defaultPrevented || keyBelongsElsewhere(event.target, root.current)) return;\n      event.preventDefault();\n      if (event.type === \"keydown\" && !event.repeat) latest.current();\n    };\n    window.addEventListener(\"keydown\", onKey);\n    window.addEventListener(\"keyup\", onKey);\n    return () => {\n      window.removeEventListener(\"keydown\", onKey);\n      window.removeEventListener(\"keyup\", onKey);\n    };\n  }, [active, root]);\n}\n"],"mappings":"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"}

package/dist/about.d.ts

@@ -0,0 +1,212 @@
+import { formatSize } from "./kit/numbers.js";
+//#region src/about.d.ts
+/**
+ * Qué puede: what an agent says about itself and the facts it rests on (`GET /agents/{id}/about`,
+ * `POST /agents/{id}/describe`). The words are the model's, written from the agent's folder and
+ * stale the moment it changes; the facts are the platform's, read each time.
+ */
+/** The marks the package draws (a topic's, an automation's kind, a note's tone). */
+export declare const ICONS: readonly ["message", "phone", "mail", "calendar", "clock", "search", "file", "table", "bell", "hand", "user", "globe", "code", "lock", "cart", "card", "map", "check", "warning", "sparkle"];
+export type Icon = (typeof ICONS)[number];
+/** One automation as the agent tells it: what it does then, and when. */
+export interface Does {
+  /** The automation's id. */
+  automation: string;
+  text: string;
+  /** When it runs, the way a person says it: "Cada día a las 8:00". */
+  when: string;
+}
+/** What the agent says about itself: a lead, what it does, what it asks leave for. */
+export interface About {
+  /** Two or three sentences, first person, in the owner's language. */
+  summary: string;
+  does: Does[];
+  asks: string[];
+}
+export type ActionSource = "default" | "library" | "own";
+export interface ActionFact {
+  name: string;
+  description: string;
+  source: ActionSource;
+  on: boolean;
+  needs_approval: boolean;
+  destructive: boolean;
+  /** Its input as the model gets it (JSON Schema); left out by an API from before. */
+  input_schema?: Readonly<Record<string, unknown>> | undefined;
+}
+export type AutomationKind = "schedule" | "webhook" | "event";
+/** Something the agent does on its own: at a time, when another system calls, on an event. */
+export interface AutomationFact {
+  id: string;
+  /** Its file's name, `automations/<name>.py`: how its page is reached. */
+  name: string;
+  kind: AutomationKind;
+  title: string;
+  /** What it does, in the owner's words. */
+  summary: string;
+  /** The same words, for a reader of the older shape. */
+  say: string;
+  /** A cron line and its time zone, for one that runs at a time. */
+  schedule?: string | null | undefined;
+  timezone?: string | null | undefined;
+  /** Where another system calls it, for a webhook (a path on the API). */
+  url?: string | null | undefined;
+  /** For one on an app's event: the app (the connection's name), the event as its provider
+   * names it, and the app as its mark is drawn (`composio:gmail`, the provider's logo). */
+  app?: string | null | undefined;
+  /** The app as people write it (`Google Calendar`). */
+  app_title?: string | null | undefined;
+  event?: string | null | undefined;
+  provider?: string | undefined;
+  icon?: string | null | undefined;
+  /** Off: declared, but it doesn't run. */
+  on: boolean;
+  next_run_at?: string | null | undefined;
+}
+export type Provider = "arcade" | "composio" | "mcp" | "api";
+export interface ConnectionFact {
+  provider: Provider;
+  name: string;
+  /** The app, as the provider names it (`gmail`). */
+  toolkit?: string | undefined;
+  /** The app as people write it (`Google Calendar`). */
+  title?: string | undefined;
+  /** pending · active · error · disconnected */
+  status?: string | undefined;
+  /** The provider's names of what the agent may do in it (`Gmail.SendEmail`). */
+  actions: string[];
+  /** What the provider calls each of them for people (`List Events`), when it says. */
+  titles?: Readonly<Record<string, string>> | undefined;
+  /** A URL to the app's own mark, when the provider gives one. */
+  icon?: string | null | undefined;
+}
+/** An app of the agent's as people write it: its provider's name, else its alias made words. */
+export declare const appTitle: (connection: ConnectionFact) => string;
+/** A tool of an app as people read it: its provider's name for it, else its own made words. */
+export declare const toolTitle: (connection: ConnectionFact, action: string) => string;
+/** A tool of an app as a person reads it: `Gmail.SendEmail` is "Send email". */
+export declare function toolName(action: string): string;
+/**
+ * An action's name made words, for one nobody named: `ver_hoja` is "Ver hoja"; an app's tool
+ * as the model calls it, `gmail__GMAIL_SEND_EMAIL`, is "Send email (Gmail)".
+ */
+export declare function actionWords(name: string): string;
+/** `gmail` + `Gmail.SendEmail` → `gmail__Gmail_SendEmail`: the tool the model is given. */
+export declare const generatedName: (alias: string, action: string) => string;
+/**
+ * The tools the agent's apps give it, by the names the model calls them, in words: the
+ * provider's for the tool and the app's ("List Events (Google Calendar)"), as a chat's steps
+ * read them (`ChatMessages.steps`).
+ */
+export declare function appSteps(connections: readonly ConnectionFact[]): Record<string, string>;
+export type ChannelKind = "whatsapp" | "instagram" | "email" | "sms" | "web" | "phone";
+export interface ChannelFact {
+  kind: ChannelKind;
+  name: string;
+  status: string;
+}
+/** A file the agent can read: its own, or one of the organization's, shared with every agent. */
+export interface FileFact {
+  path: string;
+  size: number;
+  /** Text, Markdown, JSON, YAML or PDF, read by `search_files`; anything else is only kept. */
+  searchable: boolean;
+  /** The organization's, not the agent's own. */
+  shared: boolean;
+}
+/** A line the agent kept with `remember`. */
+export interface MemoryFact {
+  id: string;
+  /** The agent that keeps it; the contact it is about, when it is about one. */
+  agent_id?: string | undefined;
+  contact_id?: string | null | undefined;
+  text: string;
+  created_at: string;
+}
+/** A key the agent may use: its own, or one of the organization's, shared with every agent. */
+export interface VaultFact {
+  name: string;
+  /** The hosts it may be sent to. */
+  hosts?: string[] | undefined;
+  /** The organization's, not the agent's own. */
+  shared?: boolean | undefined;
+}
+/** A table of the organization's the agent may read or write (an agenda, the clients). */
+export interface DataFact {
+  table: string;
+  /** Its name for people, when it has one. */
+  title?: string | null | undefined;
+  can: string[];
+}
+export interface AskFact {
+  agent_id: string;
+  name: string;
+}
+export type DeviceKind = "extension" | "installer";
+export interface DeviceFact {
+  kind: DeviceKind;
+  name: string;
+  status: string;
+}
+/** What the agent has, every list present from day one; one whose phase has not come is empty. */
+export interface Facts {
+  actions: ActionFact[];
+  automations: AutomationFact[];
+  connections: ConnectionFact[];
+  channels: ChannelFact[];
+  /** Its own first, then the organization's shared. */
+  files: FileFact[];
+  /** Newest first. */
+  memories: MemoryFact[];
+  vault: VaultFact[];
+  data: DataFact[];
+  asks: AskFact[];
+  devices: DeviceFact[];
+}
+export interface AboutOut {
+  /** Null until the agent has written about itself once. */
+  about: About | null;
+  /** When the words were written; null when the folder changed since, so they are stale. */
+  about_at: string | null;
+  facts: Facts;
+}
+/**
+ * What the panel lists of the facts beside what the agent does on its own, gathered into a few
+ * things an owner reads at a glance: the apps it uses, its tools, what it knows (files and
+ * tables), what it has learned, where it works (channels and devices), and its keys.
+ */
+export type Topic = "apps" | "tools" | "knowledge" | "learning" | "channels" | "keys";
+/** The topics in the order the panel lists them. */
+export declare const TOPICS: readonly Topic[];
+/** An automation with what the agent said about it, when it said something. */
+export interface Told {
+  automation: AutomationFact;
+  line: Does | undefined;
+}
+/**
+ * The agent's automations, in their order, each with the agent's line about it (matched by id):
+ * one added since the words were written has none yet, and a line for one since removed is
+ * dropped.
+ */
+export declare function automationsOf(about: About | null, facts: Facts): Told[];
+/** How many things a topic holds: the tools that are on, the rest whole. */
+export declare function countOf(topic: Topic, facts: Facts): number;
+/**
+ * The names of what a topic holds, in order, as its row in the panel previews them: an app by its
+ * name, a tool by `label` (the host's words for the shipped ones), a file by its path and a table
+ * by its title, what it learned by the line itself.
+ */
+export declare function namesOf(topic: Topic, facts: Facts, label: (action: ActionFact) => string): string[];
+export type AboutState = "writing" | "stale" | "fresh";
+/**
+ * Which state the words are in: `writing` while there are none yet or the agent is writing them
+ * anew (`loading`), `stale` when the agent changed since it wrote them, `fresh` otherwise.
+ */
+export declare function aboutState(about: About | null, aboutAt: string | null, loading: boolean): AboutState;
+/** How a status reads beside its words: working, broken, or neither. */
+export type StatusTone = "on" | "off" | "quiet";
+/** The tone of a channel's or a device's status, from the words the platform uses for it. */
+export declare function toneOf(status: string): StatusTone;
+//#endregion
+export { formatSize };
+//# sourceMappingURL=about.d.ts.map