@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/files.js

@@ -0,0 +1,214 @@
+//#region src/files.ts
+const BY_EXTENSION = {
+	md: "markdown",
+	markdown: "markdown",
+	txt: "text",
+	log: "text",
+	json: "code",
+	yaml: "code",
+	yml: "code",
+	xml: "code",
+	html: "code",
+	htm: "code",
+	css: "code",
+	js: "code",
+	ts: "code",
+	py: "code",
+	sql: "code",
+	toml: "code",
+	ini: "code",
+	csv: "table",
+	tsv: "table",
+	pdf: "pdf",
+	png: "image",
+	jpg: "image",
+	jpeg: "image",
+	gif: "image",
+	webp: "image",
+	avif: "image",
+	bmp: "image",
+	svg: "image"
+};
+/** The type a browser needs to draw a PDF or a picture, by extension. */
+const MEDIA = {
+	pdf: "application/pdf",
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	webp: "image/webp",
+	avif: "image/avif",
+	bmp: "image/bmp",
+	svg: "image/svg+xml"
+};
+/** A name's extension, lowercase; "" for one without (`README`, `.env`). */
+function extensionOf(name) {
+	const base = baseName(name);
+	const dot = base.lastIndexOf(".");
+	return dot <= 0 ? "" : base.slice(dot + 1).toLowerCase();
+}
+/** The last name of a path: what a file is saved as. */
+const baseName = (path) => path.slice(path.lastIndexOf("/") + 1);
+function byType(type) {
+	const media = type.split(";")[0]?.trim().toLowerCase() ?? "";
+	if (media === "text/markdown") return "markdown";
+	if (media === "text/csv" || media === "text/tab-separated-values") return "table";
+	if (media === "text/html" || /^application\/(json|xml|x-yaml|yaml)$/.test(media)) return "code";
+	if (media.startsWith("text/")) return "text";
+	if (media === "application/pdf") return "pdf";
+	if (Object.values(MEDIA).includes(media)) return "image";
+	return "none";
+}
+/** How a file of this name and type is shown. */
+function previewOf(name, type) {
+	return BY_EXTENSION[extensionOf(name)] ?? byType(type);
+}
+/**
+* The bytes typed as a browser must have them to draw them (a PDF, a picture), whatever type
+* they came with: one uploaded without a type is kept as plain bytes.
+*/
+function typedFor(blob, name) {
+	const type = MEDIA[extensionOf(name)];
+	return type === void 0 || blob.type === type ? blob : new Blob([blob], { type });
+}
+/** JSON laid out two spaces deep; anything that is not JSON as it was. */
+function pretty(text) {
+	try {
+		return JSON.stringify(JSON.parse(text), null, 2);
+	} catch {
+		return text;
+	}
+}
+const SEPARATORS = [
+	",",
+	";",
+	"	"
+];
+/**
+* A CSV (or TSV) as rows of cells, when it is simple enough to draw as a table: one separator,
+* the commonest of comma, semicolon and tab on the first line; quoted cells kept whole (quotes
+* doubled inside, line breaks too); every row as wide as the first, and that at least two. Null
+* otherwise, and it is shown as written.
+*/
+function tableOf(text) {
+	const body = text.replace(/^/, "").replace(/\r\n?/g, "\n").replace(/\n+$/, "");
+	const first = body.split("\n", 1)[0] ?? "";
+	const separator = SEPARATORS.reduce((best, each) => first.split(each).length > first.split(best).length ? each : best);
+	if (!first.includes(separator)) return null;
+	const rows = cellsOf(body, separator);
+	const width = rows[0]?.length ?? 0;
+	return width >= 2 && rows.every((row) => row.length === width) ? rows : null;
+}
+function cellsOf(text, separator) {
+	const rows = [];
+	let row = [];
+	let cell = "";
+	let quoted = false;
+	for (let at = 0; at < text.length; at += 1) {
+		const char = text.charAt(at);
+		if (quoted) {
+			if (char !== "\"") cell += char;
+			else if (text.charAt(at + 1) === "\"") {
+				cell += "\"";
+				at += 1;
+			} else quoted = false;
+		} else if (char === "\"" && cell === "") quoted = true;
+		else if (char === separator || char === "\n") {
+			row.push(cell);
+			cell = "";
+			if (char === "\n") {
+				rows.push(row);
+				row = [];
+			}
+		} else cell += char;
+	}
+	row.push(cell);
+	rows.push(row);
+	return rows;
+}
+/** The tags a Word file's HTML keeps, as the API keeps them (`preview.TAGS`). */
+const DOCUMENT_TAGS = /* @__PURE__ */ new Set([
+	"h1",
+	"h2",
+	"h3",
+	"h4",
+	"h5",
+	"h6",
+	"p",
+	"br",
+	"hr",
+	"blockquote",
+	"pre",
+	"code",
+	"ul",
+	"ol",
+	"li",
+	"table",
+	"thead",
+	"tbody",
+	"tr",
+	"th",
+	"td",
+	"strong",
+	"b",
+	"em",
+	"i",
+	"u",
+	"s",
+	"sub",
+	"sup",
+	"img"
+]);
+/** What goes with everything it holds; any other tag not kept goes and leaves its words. */
+const DROPPED = /* @__PURE__ */ new Set([
+	"script",
+	"style",
+	"template",
+	"iframe",
+	"object",
+	"embed",
+	"noscript",
+	"svg",
+	"math",
+	"link",
+	"meta",
+	"title"
+]);
+/** A picture inline, as the only address a document may hold. */
+const PICTURE = /^data:image\/(?:png|jpe?g|gif|webp|bmp);base64,/i;
+/** Whether an element keeps an attribute: a picture its data address and words, a cell its span. */
+function keeps(tag, name, value) {
+	if (tag === "img") return name === "alt" || name === "src" && PICTURE.test(value);
+	return (tag === "td" || tag === "th") && (name === "colspan" || name === "rowspan");
+}
+/**
+* A Word file's HTML (a `document` preview) kept again, here, to what a viewer draws: the API
+* cleans it, and what the page puts in itself it checks itself. Its tags and attributes the
+* API's allow-list, scripts and styles gone with what they hold, any other tag gone and its words
+* kept, a picture only by a data address.
+*/
+function cleanDocument(html) {
+	const body = new DOMParser().parseFromString(html, "text/html").body;
+	const clean = (parent) => {
+		for (const child of [...parent.children]) {
+			const tag = child.tagName.toLowerCase();
+			if (DROPPED.has(tag)) {
+				child.remove();
+				continue;
+			}
+			clean(child);
+			if (!DOCUMENT_TAGS.has(tag)) {
+				child.replaceWith(...child.childNodes);
+				continue;
+			}
+			for (const { name, value } of [...child.attributes]) if (!keeps(tag, name.toLowerCase(), value)) child.removeAttribute(name);
+			if (tag === "img" && !child.hasAttribute("src")) child.remove();
+		}
+	};
+	clean(body);
+	return body.innerHTML;
+}
+//#endregion
+export { baseName, cleanDocument, extensionOf, pretty, previewOf, tableOf, typedFor };
+
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","names":[],"sources":["../src/files.ts"],"sourcesContent":["/**\n * How a file is shown before it is saved, read from its name first (the owner named it, and a\n * browser often gives no type) and from its type when the name says nothing.\n */\n\n/**\n * Words with headings (Markdown), plain words, a source read in the mono face (JSON, YAML, a\n * page's HTML: shown as written, never run), rows of cells (CSV), a PDF, a picture, or nothing.\n */\nexport type Preview = \"markdown\" | \"text\" | \"code\" | \"table\" | \"pdf\" | \"image\" | \"none\";\n\nconst BY_EXTENSION: Readonly<Record<string, Preview>> = {\n  md: \"markdown\",\n  markdown: \"markdown\",\n  txt: \"text\",\n  log: \"text\",\n  json: \"code\",\n  yaml: \"code\",\n  yml: \"code\",\n  xml: \"code\",\n  html: \"code\",\n  htm: \"code\",\n  css: \"code\",\n  js: \"code\",\n  ts: \"code\",\n  py: \"code\",\n  sql: \"code\",\n  toml: \"code\",\n  ini: \"code\",\n  csv: \"table\",\n  tsv: \"table\",\n  pdf: \"pdf\",\n  png: \"image\",\n  jpg: \"image\",\n  jpeg: \"image\",\n  gif: \"image\",\n  webp: \"image\",\n  avif: \"image\",\n  bmp: \"image\",\n  svg: \"image\",\n};\n\n/** The type a browser needs to draw a PDF or a picture, by extension. */\nconst MEDIA: Readonly<Record<string, string>> = {\n  pdf: \"application/pdf\",\n  png: \"image/png\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  gif: \"image/gif\",\n  webp: \"image/webp\",\n  avif: \"image/avif\",\n  bmp: \"image/bmp\",\n  svg: \"image/svg+xml\",\n};\n\n/** A name's extension, lowercase; \"\" for one without (`README`, `.env`). */\nexport function extensionOf(name: string): string {\n  const base = baseName(name);\n  const dot = base.lastIndexOf(\".\");\n  return dot <= 0 ? \"\" : base.slice(dot + 1).toLowerCase();\n}\n\n/** The last name of a path: what a file is saved as. */\nexport const baseName = (path: string): string => path.slice(path.lastIndexOf(\"/\") + 1);\n\nfunction byType(type: string): Preview {\n  const media = type.split(\";\")[0]?.trim().toLowerCase() ?? \"\";\n  if (media === \"text/markdown\") return \"markdown\";\n  if (media === \"text/csv\" || media === \"text/tab-separated-values\") return \"table\";\n  if (media === \"text/html\" || /^application\\/(json|xml|x-yaml|yaml)$/.test(media)) return \"code\";\n  if (media.startsWith(\"text/\")) return \"text\";\n  if (media === \"application/pdf\") return \"pdf\";\n  if (Object.values(MEDIA).includes(media)) return \"image\";\n  return \"none\";\n}\n\n/** How a file of this name and type is shown. */\nexport function previewOf(name: string, type: string): Preview {\n  return BY_EXTENSION[extensionOf(name)] ?? byType(type);\n}\n\n/**\n * The bytes typed as a browser must have them to draw them (a PDF, a picture), whatever type\n * they came with: one uploaded without a type is kept as plain bytes.\n */\nexport function typedFor(blob: Blob, name: string): Blob {\n  const type = MEDIA[extensionOf(name)];\n  return type === undefined || blob.type === type ? blob : new Blob([blob], { type });\n}\n\n/** JSON laid out two spaces deep; anything that is not JSON as it was. */\nexport function pretty(text: string): string {\n  try {\n    return JSON.stringify(JSON.parse(text), null, 2);\n  } catch {\n    return text;\n  }\n}\n\nconst SEPARATORS = [\",\", \";\", \"\\t\"] as const;\n\n/**\n * A CSV (or TSV) as rows of cells, when it is simple enough to draw as a table: one separator,\n * the commonest of comma, semicolon and tab on the first line; quoted cells kept whole (quotes\n * doubled inside, line breaks too); every row as wide as the first, and that at least two. Null\n * otherwise, and it is shown as written.\n */\nexport function tableOf(text: string): string[][] | null {\n  const body = text.replace(/^/, \"\").replace(/\\r\\n?/g, \"\\n\").replace(/\\n+$/, \"\");\n  const first = body.split(\"\\n\", 1)[0] ?? \"\";\n  const separator = SEPARATORS.reduce((best, each) =>\n    first.split(each).length > first.split(best).length ? each : best,\n  );\n  if (!first.includes(separator)) return null;\n  const rows = cellsOf(body, separator);\n  const width = rows[0]?.length ?? 0;\n  return width >= 2 && rows.every((row) => row.length === width) ? rows : null;\n}\n\nfunction cellsOf(text: string, separator: string): string[][] {\n  const rows: string[][] = [];\n  let row: string[] = [];\n  let cell = \"\";\n  let quoted = false;\n  for (let at = 0; at < text.length; at += 1) {\n    const char = text.charAt(at);\n    if (quoted) {\n      if (char !== '\"') cell += char;\n      else if (text.charAt(at + 1) === '\"') {\n        cell += '\"';\n        at += 1;\n      } else quoted = false;\n    } else if (char === '\"' && cell === \"\") {\n      quoted = true;\n    } else if (char === separator || char === \"\\n\") {\n      row.push(cell);\n      cell = \"\";\n      if (char === \"\\n\") {\n        rows.push(row);\n        row = [];\n      }\n    } else {\n      cell += char;\n    }\n  }\n  row.push(cell);\n  rows.push(row);\n  return rows;\n}\n\n/** The tags a Word file's HTML keeps, as the API keeps them (`preview.TAGS`). */\nconst DOCUMENT_TAGS: ReadonlySet<string> = new Set([\n  \"h1\",\n  \"h2\",\n  \"h3\",\n  \"h4\",\n  \"h5\",\n  \"h6\",\n  \"p\",\n  \"br\",\n  \"hr\",\n  \"blockquote\",\n  \"pre\",\n  \"code\",\n  \"ul\",\n  \"ol\",\n  \"li\",\n  \"table\",\n  \"thead\",\n  \"tbody\",\n  \"tr\",\n  \"th\",\n  \"td\",\n  \"strong\",\n  \"b\",\n  \"em\",\n  \"i\",\n  \"u\",\n  \"s\",\n  \"sub\",\n  \"sup\",\n  \"img\",\n]);\n\n/** What goes with everything it holds; any other tag not kept goes and leaves its words. */\nconst DROPPED: ReadonlySet<string> = new Set([\n  \"script\",\n  \"style\",\n  \"template\",\n  \"iframe\",\n  \"object\",\n  \"embed\",\n  \"noscript\",\n  \"svg\",\n  \"math\",\n  \"link\",\n  \"meta\",\n  \"title\",\n]);\n\n/** A picture inline, as the only address a document may hold. */\nconst PICTURE = /^data:image\\/(?:png|jpe?g|gif|webp|bmp);base64,/i;\n\n/** Whether an element keeps an attribute: a picture its data address and words, a cell its span. */\nfunction keeps(tag: string, name: string, value: string): boolean {\n  if (tag === \"img\") return name === \"alt\" || (name === \"src\" && PICTURE.test(value));\n  return (tag === \"td\" || tag === \"th\") && (name === \"colspan\" || name === \"rowspan\");\n}\n\n/**\n * A Word file's HTML (a `document` preview) kept again, here, to what a viewer draws: the API\n * cleans it, and what the page puts in itself it checks itself. Its tags and attributes the\n * API's allow-list, scripts and styles gone with what they hold, any other tag gone and its words\n * kept, a picture only by a data address.\n */\nexport function cleanDocument(html: string): string {\n  const body = new DOMParser().parseFromString(html, \"text/html\").body;\n  const clean = (parent: Element) => {\n    for (const child of [...parent.children]) {\n      const tag = child.tagName.toLowerCase();\n      if (DROPPED.has(tag)) {\n        child.remove();\n        continue;\n      }\n      clean(child);\n      if (!DOCUMENT_TAGS.has(tag)) {\n        child.replaceWith(...child.childNodes);\n        continue;\n      }\n      for (const { name, value } of [...child.attributes]) {\n        if (!keeps(tag, name.toLowerCase(), value)) child.removeAttribute(name);\n      }\n      if (tag === \"img\" && !child.hasAttribute(\"src\")) child.remove();\n    }\n  };\n  clean(body);\n  return body.innerHTML;\n}\n"],"mappings":"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"}

package/dist/frames.d.ts

@@ -0,0 +1,115 @@
+import { Surface } from "./blocks.js";
+import { Action, BrowserControl, BrowserFrame, BrowserInput, BrowserState, Decision, Handover, Holder, Message, Request, StepState, ToolCall } from "./types.js";
+//#region src/frames.d.ts
+/**
+ * The frames of a conversation's socket, as v3/README.md documents them. Down: a message stored;
+ * a piece of the reply as it streams; a surface the agent shows (`awaits`: the turn stops until
+ * the person acts on it); an action running, told again as its state moves; an action that needs
+ * a yes, the person's (the turn stopped) or the business's (`decides`: the turn went on); the
+ * conversation handed to a person, and why (the agent stays quiet in it
+ * until it is released); the turn over, or stopped by the person; or what went wrong (`code` for
+ * the app to word, `detail` for a log). A socket that opens mid-turn is first told the turn so
+ * far, from the person's message on. Who answers the conversation, after any change of it (`holder`:
+ * who now, and the change); and what was decided of a person's message, when it is stored,
+ * settles or is cleared (`decision`, null then). And the conversation's browser: its state, whole, whenever it changes
+ * (told at once to a socket that opens), and its screen as it paints. And one of the host's own
+ * tools the agent called, for the page to run (`tool`): its step works meanwhile, the turn waits
+ * for its `tool_result`, and a person's socket that opens while it waits is told it again.
+ */
+export type Frame = {
+  type: "working";
+} | {
+  type: "message";
+  message: Message;
+} | {
+  type: "text";
+  delta: string;
+} | {
+  type: "ui";
+  id: string;
+  surface: Surface;
+  awaits: boolean;
+} | {
+  type: "step";
+  id: string;
+  state: StepState;
+  action?: string;
+  output?: string;
+} | ({
+  type: "request";
+  id: string;
+} & Request) | ({
+  type: "tool";
+} & ToolCall) | {
+  type: "handoff";
+  reason: string;
+} | {
+  type: "holder";
+  handled_by: Holder;
+  handover: Handover;
+} | {
+  type: "decision";
+  message_id: string;
+  decision: Decision | null;
+} | {
+  type: "done";
+} | {
+  type: "stopped";
+} | {
+  type: "error";
+  code: string;
+  detail: string;
+} | ({
+  type: "browser";
+  open: true;
+} & BrowserState) | {
+  type: "browser";
+  open: false;
+} | ({
+  type: "browser.frame";
+} & BrowserFrame);
+/**
+ * Up: the person says something (words, files they uploaded to the conversation, or both), acts
+ * on a surface, or stops the reply on its way; takes the browser or gives it back, and acts on it
+ * while they hold it. And what a tool of the host's answered, run in the page: its output, or
+ * why it failed.
+ */
+export type UpFrame = {
+  type: "say";
+  text: string;
+  files?: string[];
+} | ({
+  type: "action";
+} & Action) | {
+  type: "stop";
+} | {
+  type: "browser.control";
+  to: BrowserControl;
+} | {
+  type: "browser.close";
+} | {
+  type: "browser.input";
+  event: BrowserInput;
+} | ToolResult;
+/** What a host's tool answered: what it gave back (null for nothing), or why it failed. */
+export type ToolResult = {
+  type: "tool_result";
+  id: string;
+  output: unknown;
+} | {
+  type: "tool_result";
+  id: string;
+  error: string;
+};
+/** The most files one message carries. */
+export declare const FILES_PER_MESSAGE = 10;
+/** The most of a tool's error the API takes: the agent reads the rest of it as cut. */
+export declare const TOOL_ERROR_MAX = 2000;
+/**
+ * What a host's tool call answers up, from how its promise settled: what it gave back (`null` for
+ * nothing, which JSON would leave out), or the reason it threw in words (an error's message; its
+ * kind when it says nothing), as much of it as the API takes.
+ */
+export declare function toolResultOf(id: string, settled: PromiseSettledResult<unknown>): ToolResult;
+//#endregion
+//# sourceMappingURL=frames.d.ts.map

package/dist/frames.js

@@ -0,0 +1,219 @@
+//#region src/frames.ts
+const STATES = /* @__PURE__ */ new Set([
+	"running",
+	"waiting",
+	"done",
+	"failed"
+]);
+const HOLDERS = /* @__PURE__ */ new Set([
+	"agent",
+	"person",
+	"nobody"
+]);
+const DECISIONS = /* @__PURE__ */ new Set([
+	"deciding",
+	"answer",
+	"skip",
+	"hold",
+	"ignore"
+]);
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isState = (value) => typeof value === "string" && STATES.has(value);
+const isSurface = (value) => isRecord(value) && Array.isArray(value.blocks) && typeof value.text === "string";
+const isDecides = (value) => value === "person" || value === "business";
+const isRequest = (value) => isRecord(value) && typeof value.action === "string" && isRecord(value.input) && (value.decides === void 0 || isDecides(value.decides));
+const isStep = (value) => isRecord(value) && typeof value.id === "string" && typeof value.action === "string" && isState(value.state) && (value.output === null || typeof value.output === "string") && (value.surface === null || isSurface(value.surface)) && typeof value.awaits === "boolean" && (value.request === null || isRequest(value.request));
+const isSize = (value) => typeof value.width === "number" && typeof value.height === "number";
+const orNull = (value) => typeof value === "string" ? value : null;
+const isHolder = (value) => typeof value === "string" && HOLDERS.has(value);
+/** A change of who answers as told, or null when it is not one: a reason or title left out is none. */
+function handoverOf(value) {
+	if (!isRecord(value) || !isHolder(value.holder)) return null;
+	if (typeof value.by !== "string" || typeof value.at !== "string") return null;
+	const { holder, by, at } = value;
+	return {
+		holder,
+		reason: orNull(value.reason) ?? "",
+		by,
+		title: orNull(value.title),
+		at
+	};
+}
+/** A message's decision as told, or null when it is not one; what it leaves out is none. */
+function decisionOf(value) {
+	if (!isRecord(value) || typeof value.kind !== "string" || !DECISIONS.has(value.kind)) return null;
+	return {
+		kind: value.kind,
+		reason: orNull(value.reason),
+		automation: orNull(value.automation),
+		title: orNull(value.title),
+		run_id: orNull(value.run_id)
+	};
+}
+/** The browser's state as told, or null when it is not one this package can draw. */
+function browserOf(frame) {
+	const { url, title, control } = frame;
+	if (typeof url !== "string" || typeof title !== "string" || !isSize(frame)) return null;
+	if (control !== "agent" && control !== "person") return null;
+	return {
+		where: frame.where === "mine" ? "mine" : "hosted",
+		url,
+		title,
+		control,
+		reason: orNull(frame.reason),
+		wait: orNull(frame.wait),
+		width: frame.width,
+		height: frame.height
+	};
+}
+const isAction = (value) => isRecord(value) && typeof value.surface === "string" && typeof value.name === "string" && isRecord(value.data) && typeof value.label === "string";
+const isAttachment = (value) => isRecord(value) && typeof value.id === "string" && typeof value.name === "string" && typeof value.media_type === "string" && typeof value.size === "number";
+const isMessage = (value) => isRecord(value) && typeof value.id === "string" && (value.role === "user" || value.role === "assistant") && typeof value.text === "string" && (value.action === null || isAction(value.action)) && Array.isArray(value.steps) && value.steps.every(isStep) && (value.files === void 0 || Array.isArray(value.files) && value.files.every(isAttachment)) && typeof value.created_at === "string";
+/** The most files one message carries. */
+const FILES_PER_MESSAGE = 10;
+/**
+* What saying something sends: the words trimmed, and the ids of the files uploaded for it
+* beside them (only when there are); null when there is neither.
+*/
+function sayOf(text, files = []) {
+	const words = text.trim();
+	if (words === "" && files.length === 0) return null;
+	return files.length === 0 ? {
+		type: "say",
+		text: words
+	} : {
+		type: "say",
+		text: words,
+		files: [...files]
+	};
+}
+/** The most of a tool's error the API takes: the agent reads the rest of it as cut. */
+const TOOL_ERROR_MAX = 2e3;
+/**
+* What a host's tool call answers up, from how its promise settled: what it gave back (`null` for
+* nothing, which JSON would leave out), or the reason it threw in words (an error's message; its
+* kind when it says nothing), as much of it as the API takes.
+*/
+function toolResultOf(id, settled) {
+	if (settled.status === "fulfilled") return {
+		type: "tool_result",
+		id,
+		output: settled.value ?? null
+	};
+	const reason = settled.reason;
+	return {
+		type: "tool_result",
+		id,
+		error: ((reason instanceof Error ? reason.message : String(reason)).trim() || (reason instanceof Error ? reason.name : "Error")).slice(0, TOOL_ERROR_MAX)
+	};
+}
+/**
+* One frame, read without trusting it. Kinds this package does not know yet (more will come:
+* `audio`) and anything malformed are null, to be let pass.
+*/
+function frameOf(raw) {
+	if (typeof raw !== "string") return null;
+	let frame;
+	try {
+		frame = JSON.parse(raw);
+	} catch {
+		return null;
+	}
+	if (!isRecord(frame)) return null;
+	const { id, action, output } = frame;
+	if (frame.type === "message" && isMessage(frame.message)) return {
+		type: "message",
+		message: frame.message
+	};
+	if (frame.type === "text" && typeof frame.delta === "string") return {
+		type: "text",
+		delta: frame.delta
+	};
+	if (frame.type === "ui" && typeof id === "string" && isSurface(frame.surface)) return {
+		type: "ui",
+		id,
+		surface: frame.surface,
+		awaits: frame.awaits === true
+	};
+	if (frame.type === "step" && typeof id === "string" && isState(frame.state)) return {
+		type: "step",
+		id,
+		state: frame.state,
+		...typeof action === "string" ? { action } : {},
+		...typeof output === "string" ? { output } : {}
+	};
+	if (frame.type === "request" && typeof id === "string" && typeof action === "string" && isRecord(frame.input)) {
+		const decides = isDecides(frame.decides) ? frame.decides : "person";
+		return {
+			type: "request",
+			id,
+			action,
+			input: frame.input,
+			decides
+		};
+	}
+	if (frame.type === "tool" && typeof id === "string" && typeof frame.name === "string" && isRecord(frame.input)) return {
+		type: "tool",
+		id,
+		name: frame.name,
+		input: frame.input
+	};
+	if (frame.type === "handoff" && typeof frame.reason === "string") return {
+		type: "handoff",
+		reason: frame.reason
+	};
+	if (frame.type === "holder" && isHolder(frame.handled_by)) {
+		const handover = handoverOf(frame.handover);
+		return handover && {
+			type: "holder",
+			handled_by: frame.handled_by,
+			handover
+		};
+	}
+	if (frame.type === "decision" && typeof frame.message_id === "string") {
+		const { message_id } = frame;
+		if (frame.decision === null) return {
+			type: "decision",
+			message_id,
+			decision: null
+		};
+		const decision = decisionOf(frame.decision);
+		return decision && {
+			type: "decision",
+			message_id,
+			decision
+		};
+	}
+	if (frame.type === "browser") {
+		if (frame.open === false) return {
+			type: "browser",
+			open: false
+		};
+		const browser = frame.open === true ? browserOf(frame) : null;
+		return browser && {
+			type: "browser",
+			open: true,
+			...browser
+		};
+	}
+	if (frame.type === "browser.frame" && typeof frame.jpeg === "string" && isSize(frame)) {
+		const { jpeg, width, height } = frame;
+		return {
+			type: "browser.frame",
+			jpeg,
+			width,
+			height
+		};
+	}
+	if (frame.type === "working" || frame.type === "done" || frame.type === "stopped") return { type: frame.type };
+	if (frame.type === "error" && typeof frame.code === "string" && typeof frame.detail === "string") return {
+		type: "error",
+		code: frame.code,
+		detail: frame.detail
+	};
+	return null;
+}
+//#endregion
+export { FILES_PER_MESSAGE, TOOL_ERROR_MAX, frameOf, sayOf, toolResultOf };
+
+//# sourceMappingURL=frames.js.map

package/dist/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","names":[],"sources":["../src/frames.ts"],"sourcesContent":["import type { Surface } from \"./blocks\";\nimport type {\n  Action,\n  Attachment,\n  BrowserControl,\n  BrowserFrame,\n  BrowserInput,\n  BrowserState,\n  Decides,\n  Decision,\n  Handover,\n  Holder,\n  Message,\n  Request,\n  Step,\n  StepState,\n  ToolCall,\n} from \"./types\";\n\n/**\n * The frames of a conversation's socket, as v3/README.md documents them. Down: a message stored;\n * a piece of the reply as it streams; a surface the agent shows (`awaits`: the turn stops until\n * the person acts on it); an action running, told again as its state moves; an action that needs\n * a yes, the person's (the turn stopped) or the business's (`decides`: the turn went on); the\n * conversation handed to a person, and why (the agent stays quiet in it\n * until it is released); the turn over, or stopped by the person; or what went wrong (`code` for\n * the app to word, `detail` for a log). A socket that opens mid-turn is first told the turn so\n * far, from the person's message on. Who answers the conversation, after any change of it (`holder`:\n * who now, and the change); and what was decided of a person's message, when it is stored,\n * settles or is cleared (`decision`, null then). And the conversation's browser: its state, whole, whenever it changes\n * (told at once to a socket that opens), and its screen as it paints. And one of the host's own\n * tools the agent called, for the page to run (`tool`): its step works meanwhile, the turn waits\n * for its `tool_result`, and a person's socket that opens while it waits is told it again.\n */\nexport type Frame =\n  | { type: \"working\" }\n  | { type: \"message\"; message: Message }\n  | { type: \"text\"; delta: string }\n  | { type: \"ui\"; id: string; surface: Surface; awaits: boolean }\n  | { type: \"step\"; id: string; state: StepState; action?: string; output?: string }\n  | ({ type: \"request\"; id: string } & Request)\n  | ({ type: \"tool\" } & ToolCall)\n  | { type: \"handoff\"; reason: string }\n  | { type: \"holder\"; handled_by: Holder; handover: Handover }\n  | { type: \"decision\"; message_id: string; decision: Decision | null }\n  | { type: \"done\" }\n  | { type: \"stopped\" }\n  | { type: \"error\"; code: string; detail: string }\n  | ({ type: \"browser\"; open: true } & BrowserState)\n  | { type: \"browser\"; open: false }\n  | ({ type: \"browser.frame\" } & BrowserFrame);\n\n/**\n * Up: the person says something (words, files they uploaded to the conversation, or both), acts\n * on a surface, or stops the reply on its way; takes the browser or gives it back, and acts on it\n * while they hold it. And what a tool of the host's answered, run in the page: its output, or\n * why it failed.\n */\nexport type UpFrame =\n  | { type: \"say\"; text: string; files?: string[] }\n  | ({ type: \"action\" } & Action)\n  | { type: \"stop\" }\n  | { type: \"browser.control\"; to: BrowserControl }\n  | { type: \"browser.close\" }\n  | { type: \"browser.input\"; event: BrowserInput }\n  | ToolResult;\n\n/** What a host's tool answered: what it gave back (null for nothing), or why it failed. */\nexport type ToolResult =\n  | { type: \"tool_result\"; id: string; output: unknown }\n  | { type: \"tool_result\"; id: string; error: string };\n\nconst STATES: ReadonlySet<string> = new Set([\"running\", \"waiting\", \"done\", \"failed\"]);\nconst HOLDERS: ReadonlySet<string> = new Set([\"agent\", \"person\", \"nobody\"]);\nconst DECISIONS: ReadonlySet<string> = new Set([\"deciding\", \"answer\", \"skip\", \"hold\", \"ignore\"]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nconst isState = (value: unknown): value is StepState =>\n  typeof value === \"string\" && STATES.has(value);\n\n// The blocks inside are the API's, validated at `show`; the renderer draws what it knows.\nconst isSurface = (value: unknown): value is Surface =>\n  isRecord(value) && Array.isArray(value.blocks) && typeof value.text === \"string\";\n\nconst isDecides = (value: unknown): value is Decides => value === \"person\" || value === \"business\";\n\nconst isRequest = (value: unknown): value is Request =>\n  isRecord(value) &&\n  typeof value.action === \"string\" &&\n  isRecord(value.input) &&\n  (value.decides === undefined || isDecides(value.decides));\n\nconst isStep = (value: unknown): value is Step =>\n  isRecord(value) &&\n  typeof value.id === \"string\" &&\n  typeof value.action === \"string\" &&\n  isState(value.state) &&\n  (value.output === null || typeof value.output === \"string\") &&\n  (value.surface === null || isSurface(value.surface)) &&\n  typeof value.awaits === \"boolean\" &&\n  (value.request === null || isRequest(value.request));\n\nconst isSize = (value: Record<string, unknown>): boolean =>\n  typeof value.width === \"number\" && typeof value.height === \"number\";\n\nconst orNull = (value: unknown): string | null => (typeof value === \"string\" ? value : null);\n\nconst isHolder = (value: unknown): value is Holder =>\n  typeof value === \"string\" && HOLDERS.has(value);\n\n/** A change of who answers as told, or null when it is not one: a reason or title left out is none. */\nfunction handoverOf(value: unknown): Handover | null {\n  if (!isRecord(value) || !isHolder(value.holder)) return null;\n  if (typeof value.by !== \"string\" || typeof value.at !== \"string\") return null;\n  const { holder, by, at } = value;\n  return { holder, reason: orNull(value.reason) ?? \"\", by, title: orNull(value.title), at };\n}\n\n/** A message's decision as told, or null when it is not one; what it leaves out is none. */\nfunction decisionOf(value: unknown): Decision | null {\n  if (!isRecord(value) || typeof value.kind !== \"string\" || !DECISIONS.has(value.kind)) return null;\n  return {\n    kind: value.kind as Decision[\"kind\"],\n    reason: orNull(value.reason),\n    automation: orNull(value.automation),\n    title: orNull(value.title),\n    run_id: orNull(value.run_id),\n  };\n}\n\n/** The browser's state as told, or null when it is not one this package can draw. */\nfunction browserOf(frame: Record<string, unknown>): BrowserState | null {\n  const { url, title, control } = frame;\n  if (typeof url !== \"string\" || typeof title !== \"string\" || !isSize(frame)) return null;\n  if (control !== \"agent\" && control !== \"person\") return null;\n  return {\n    where: frame.where === \"mine\" ? \"mine\" : \"hosted\",\n    url,\n    title,\n    control,\n    reason: orNull(frame.reason),\n    wait: orNull(frame.wait),\n    width: frame.width as number,\n    height: frame.height as number,\n  };\n}\n\nconst isAction = (value: unknown): value is Action =>\n  isRecord(value) &&\n  typeof value.surface === \"string\" &&\n  typeof value.name === \"string\" &&\n  isRecord(value.data) &&\n  typeof value.label === \"string\";\n\nconst isAttachment = (value: unknown): value is Attachment =>\n  isRecord(value) &&\n  typeof value.id === \"string\" &&\n  typeof value.name === \"string\" &&\n  typeof value.media_type === \"string\" &&\n  typeof value.size === \"number\";\n\nconst isMessage = (value: unknown): value is Message =>\n  isRecord(value) &&\n  typeof value.id === \"string\" &&\n  (value.role === \"user\" || value.role === \"assistant\") &&\n  typeof value.text === \"string\" &&\n  (value.action === null || isAction(value.action)) &&\n  Array.isArray(value.steps) &&\n  value.steps.every(isStep) &&\n  (value.files === undefined || (Array.isArray(value.files) && value.files.every(isAttachment))) &&\n  typeof value.created_at === \"string\";\n\n/** The most files one message carries. */\nexport const FILES_PER_MESSAGE = 10;\n\n/**\n * What saying something sends: the words trimmed, and the ids of the files uploaded for it\n * beside them (only when there are); null when there is neither.\n */\nexport function sayOf(text: string, files: readonly string[] = []): UpFrame | null {\n  const words = text.trim();\n  if (words === \"\" && files.length === 0) return null;\n  return files.length === 0\n    ? { type: \"say\", text: words }\n    : { type: \"say\", text: words, files: [...files] };\n}\n\n/** The most of a tool's error the API takes: the agent reads the rest of it as cut. */\nexport const TOOL_ERROR_MAX = 2000;\n\n/**\n * What a host's tool call answers up, from how its promise settled: what it gave back (`null` for\n * nothing, which JSON would leave out), or the reason it threw in words (an error's message; its\n * kind when it says nothing), as much of it as the API takes.\n */\nexport function toolResultOf(id: string, settled: PromiseSettledResult<unknown>): ToolResult {\n  if (settled.status === \"fulfilled\") {\n    return { type: \"tool_result\", id, output: settled.value ?? null };\n  }\n  const reason: unknown = settled.reason;\n  const words = (reason instanceof Error ? reason.message : String(reason)).trim();\n  const error = words || (reason instanceof Error ? reason.name : \"Error\");\n  return { type: \"tool_result\", id, error: error.slice(0, TOOL_ERROR_MAX) };\n}\n\n/**\n * One frame, read without trusting it. Kinds this package does not know yet (more will come:\n * `audio`) and anything malformed are null, to be let pass.\n */\nexport function frameOf(raw: unknown): Frame | null {\n  if (typeof raw !== \"string\") return null;\n  let frame: unknown;\n  try {\n    frame = JSON.parse(raw);\n  } catch {\n    return null;\n  }\n  if (!isRecord(frame)) return null;\n  const { id, action, output } = frame;\n  if (frame.type === \"message\" && isMessage(frame.message)) {\n    return { type: \"message\", message: frame.message };\n  }\n  if (frame.type === \"text\" && typeof frame.delta === \"string\") {\n    return { type: \"text\", delta: frame.delta };\n  }\n  if (frame.type === \"ui\" && typeof id === \"string\" && isSurface(frame.surface)) {\n    return { type: \"ui\", id, surface: frame.surface, awaits: frame.awaits === true };\n  }\n  if (frame.type === \"step\" && typeof id === \"string\" && isState(frame.state)) {\n    return {\n      type: \"step\",\n      id,\n      state: frame.state,\n      ...(typeof action === \"string\" ? { action } : {}),\n      ...(typeof output === \"string\" ? { output } : {}),\n    };\n  }\n  if (\n    frame.type === \"request\" &&\n    typeof id === \"string\" &&\n    typeof action === \"string\" &&\n    isRecord(frame.input)\n  ) {\n    // Left out by an API from before it: the person on the screen gave every yes then.\n    const decides = isDecides(frame.decides) ? frame.decides : \"person\";\n    return { type: \"request\", id, action, input: frame.input, decides };\n  }\n  if (\n    frame.type === \"tool\" &&\n    typeof id === \"string\" &&\n    typeof frame.name === \"string\" &&\n    isRecord(frame.input)\n  ) {\n    return { type: \"tool\", id, name: frame.name, input: frame.input };\n  }\n  if (frame.type === \"handoff\" && typeof frame.reason === \"string\") {\n    return { type: \"handoff\", reason: frame.reason };\n  }\n  if (frame.type === \"holder\" && isHolder(frame.handled_by)) {\n    const handover = handoverOf(frame.handover);\n    return handover && { type: \"holder\", handled_by: frame.handled_by, handover };\n  }\n  if (frame.type === \"decision\" && typeof frame.message_id === \"string\") {\n    const { message_id } = frame;\n    if (frame.decision === null) return { type: \"decision\", message_id, decision: null };\n    const decision = decisionOf(frame.decision);\n    return decision && { type: \"decision\", message_id, decision };\n  }\n  if (frame.type === \"browser\") {\n    if (frame.open === false) return { type: \"browser\", open: false };\n    const browser = frame.open === true ? browserOf(frame) : null;\n    return browser && { type: \"browser\", open: true, ...browser };\n  }\n  if (frame.type === \"browser.frame\" && typeof frame.jpeg === \"string\" && isSize(frame)) {\n    const { jpeg, width, height } = frame as { jpeg: string; width: number; height: number };\n    return { type: \"browser.frame\", jpeg, width, height };\n  }\n  if (frame.type === \"working\" || frame.type === \"done\" || frame.type === \"stopped\") {\n    return { type: frame.type };\n  }\n  if (\n    frame.type === \"error\" &&\n    typeof frame.code === \"string\" &&\n    typeof frame.detail === \"string\"\n  ) {\n    return { type: \"error\", code: frame.code, detail: frame.detail };\n  }\n  return null;\n}\n"],"mappings":"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"}

package/dist/icons.js

@@ -0,0 +1,29 @@
+import { BellIcon, CalendarBlankIcon, ChatCircleIcon, CheckCircleIcon, ClockIcon, CodeIcon, CreditCardIcon, EnvelopeSimpleIcon, FileTextIcon, GlobeIcon, HandPalmIcon, LockSimpleIcon, MagnifyingGlassIcon, MapPinIcon, PhoneIcon, ShoppingCartIcon, SparkleIcon, TableIcon, UserIcon, WarningIcon } from "@phosphor-icons/react";
+//#region src/icons.tsx
+/** The package's glyphs by name, drawn with Phosphor: what a `Mark` holds. */
+const GLYPHS = {
+	message: ChatCircleIcon,
+	phone: PhoneIcon,
+	mail: EnvelopeSimpleIcon,
+	calendar: CalendarBlankIcon,
+	clock: ClockIcon,
+	search: MagnifyingGlassIcon,
+	file: FileTextIcon,
+	table: TableIcon,
+	bell: BellIcon,
+	hand: HandPalmIcon,
+	user: UserIcon,
+	globe: GlobeIcon,
+	code: CodeIcon,
+	lock: LockSimpleIcon,
+	cart: ShoppingCartIcon,
+	card: CreditCardIcon,
+	map: MapPinIcon,
+	check: CheckCircleIcon,
+	warning: WarningIcon,
+	sparkle: SparkleIcon
+};
+//#endregion
+export { GLYPHS };
+
+//# sourceMappingURL=icons.js.map

package/dist/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","names":[],"sources":["../src/icons.tsx"],"sourcesContent":["import {\n  BellIcon,\n  CalendarBlankIcon,\n  ChatCircleIcon,\n  CheckCircleIcon,\n  ClockIcon,\n  CodeIcon,\n  CreditCardIcon,\n  EnvelopeSimpleIcon,\n  FileTextIcon,\n  GlobeIcon,\n  HandPalmIcon,\n  LockSimpleIcon,\n  MagnifyingGlassIcon,\n  MapPinIcon,\n  PhoneIcon,\n  ShoppingCartIcon,\n  SparkleIcon,\n  TableIcon,\n  UserIcon,\n  WarningIcon,\n  type Icon as Phosphor,\n} from \"@phosphor-icons/react\";\n\nimport type { Icon } from \"./about\";\n\n/** The package's glyphs by name, drawn with Phosphor: what a `Mark` holds. */\nexport const GLYPHS: Readonly<Record<Icon, Phosphor>> = {\n  message: ChatCircleIcon,\n  phone: PhoneIcon,\n  mail: EnvelopeSimpleIcon,\n  calendar: CalendarBlankIcon,\n  clock: ClockIcon,\n  search: MagnifyingGlassIcon,\n  file: FileTextIcon,\n  table: TableIcon,\n  bell: BellIcon,\n  hand: HandPalmIcon,\n  user: UserIcon,\n  globe: GlobeIcon,\n  code: CodeIcon,\n  lock: LockSimpleIcon,\n  cart: ShoppingCartIcon,\n  card: CreditCardIcon,\n  map: MapPinIcon,\n  check: CheckCircleIcon,\n  warning: WarningIcon,\n  sparkle: SparkleIcon,\n};\n"],"mappings":";;;AA2BA,MAAa,SAA2C;CACtD,SAAS;CACT,OAAO;CACP,MAAM;CACN,UAAU;CACV,OAAO;CACP,QAAQ;CACR,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,MAAM;CACN,MAAM;CACN,MAAM;CACN,KAAK;CACL,OAAO;CACP,SAAS;CACT,SAAS;AACX"}