@signalcore/ui 0.1.0 → 1.0.0-beta.0

package/dist/channelParts.js

@@ -0,0 +1,26 @@
+//#region src/channelParts.ts
+/**
+* What of an agent's reply on a channel shows now, as the person there gets it: the parts that
+* went, and whether more are on their way (shown as the channel's "typing"). One that failed
+* shows whole, so the business reads what didn't go. Anything that doesn't go out shows whole.
+*/
+function channelParts(message, text) {
+	if (message.delivery == null) return {
+		shown: [text],
+		typing: false
+	};
+	const parts = message.pieces != null && message.pieces.length > 1 ? message.pieces : [text];
+	if (message.delivery === "failed") return {
+		shown: parts,
+		typing: false
+	};
+	const sent = message.sent_parts ?? (message.delivery === "queued" ? 0 : parts.length);
+	return {
+		shown: parts.slice(0, sent),
+		typing: sent < parts.length
+	};
+}
+//#endregion
+export { channelParts };
+
+//# sourceMappingURL=channelParts.js.map

package/dist/channelParts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelParts.js","names":[],"sources":["../src/channelParts.ts"],"sourcesContent":["import type { Message } from \"./types\";\n\n/**\n * What of an agent's reply on a channel shows now, as the person there gets it: the parts that\n * went, and whether more are on their way (shown as the channel's \"typing\"). One that failed\n * shows whole, so the business reads what didn't go. Anything that doesn't go out shows whole.\n */\nexport function channelParts(\n  message: Pick<Message, \"delivery\" | \"pieces\" | \"sent_parts\">,\n  text: string,\n): { shown: string[]; typing: boolean } {\n  if (message.delivery == null) return { shown: [text], typing: false };\n  const parts = message.pieces != null && message.pieces.length > 1 ? message.pieces : [text];\n  if (message.delivery === \"failed\") return { shown: parts, typing: false };\n  const sent = message.sent_parts ?? (message.delivery === \"queued\" ? 0 : parts.length);\n  return { shown: parts.slice(0, sent), typing: sent < parts.length };\n}\n"],"mappings":";;;;;;AAOA,SAAgB,aACd,SACA,MACsC;CACtC,IAAI,QAAQ,YAAY,MAAM,OAAO;EAAE,OAAO,CAAC,IAAI;EAAG,QAAQ;CAAM;CACpE,MAAM,QAAQ,QAAQ,UAAU,QAAQ,QAAQ,OAAO,SAAS,IAAI,QAAQ,SAAS,CAAC,IAAI;CAC1F,IAAI,QAAQ,aAAa,UAAU,OAAO;EAAE,OAAO;EAAO,QAAQ;CAAM;CACxE,MAAM,OAAO,QAAQ,eAAe,QAAQ,aAAa,WAAW,IAAI,MAAM;CAC9E,OAAO;EAAE,OAAO,MAAM,MAAM,GAAG,IAAI;EAAG,QAAQ,OAAO,MAAM;CAAO;AACpE"}

package/dist/classes.js

@@ -1,4 +1,9 @@
-/** A class attribute from the parts that apply: falsy ones are skipped. */
-export function classes(...parts) {
-    return parts.filter(Boolean).join(" ");
+//#region src/classes.ts
+/** The classes of a component's parts: each name, and what the host adds under it. */
+function classes(classNames, ...parts) {
+	return parts.flatMap((part) => [part, classNames?.[part]]).filter((name) => name !== void 0).join(" ");
 }
+//#endregion
+export { classes };
+
+//# sourceMappingURL=classes.js.map

package/dist/classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.js","names":[],"sources":["../src/classes.ts"],"sourcesContent":["/** The classes of a component's parts: each name, and what the host adds under it. */\nexport function classes<Part extends string>(\n  classNames: Partial<Record<Part, string>> | undefined,\n  ...parts: Part[]\n): string {\n  return parts\n    .flatMap((part) => [part, classNames?.[part]])\n    .filter((name) => name !== undefined)\n    .join(\" \");\n}\n"],"mappings":";;AACA,SAAgB,QACd,YACA,GAAG,OACK;CACR,OAAO,MACJ,SAAS,SAAS,CAAC,MAAM,aAAa,KAAK,CAAC,CAAC,CAC7C,QAAQ,SAAS,SAAS,KAAA,CAAS,CAAC,CACpC,KAAK,GAAG;AACb"}

package/dist/client.d.ts

@@ -1,65 +1,157 @@
-import type { BuilderEvent, LiveFrame, LiveStream, Signalcore } from "@signalcore/sdk";
+import { AboutOut, MemoryFact } from "./about.js";
+import { Automation, AutomationView, RunRecord, Task } from "./automation/types.js";
+import { Credentials, Speaker } from "./credentials.js";
+import { AgentFace, CallToken, Channel, Conversation, ConversationDetail, ConversationFile, FileAt, FilePreview, StoredFile, WidgetConfig } from "./types.js";
+//#region src/client.d.ts
 /**
- * What the components ask of the API, and nothing more. `Signalcore` from `@signalcore/sdk` has
- * all of it; a host that reaches the API another way (the web app, signed in with a cookie
- * instead of a key) supplies the same calls. A group the client lacks is not a failure: the
- * component that needs it says so, or hands the answer to the host (`onResolve`).
+ * What the API answered when it was not a success: its status, its sentence (`detail`, written
+ * to be shown) and its `code`, for a host to word in its own language.
  */
-export interface UiClient {
+export declare class ApiError extends Error {
+  readonly status: number;
+  readonly detail: string;
+  /** What went wrong, by name (`not_found`, `no_calls`); null when the answer named nothing. */
+  readonly code: string | null;
+  constructor(status: number, detail: string, code?: string | null);
+}
+/**
+ * Where the API is, and who calls it (`Credentials`: the cookie, a person's token, a token asked
+ * of the host's backend, or a publishable key and its visitor).
+ */
+export type ClientOptions = Credentials & {
+  /**
+   * The API's origin and prefix: `/api` in our own app (the cookie's, on the page's origin), the
+   * public `https://…/v1` from a host's page.
+   */
+  baseUrl: string;
+  /** A host's own `fetch`, when the global one is not the right one. */
+  fetch?: typeof fetch | undefined;
+};
+/** The files under one owner: the organization's, or an agent's own. */
+export interface Files {
+  /** Every file, by path. */
+  list: () => Promise<StoredFile[]>;
+  /**
+   * Stores the bytes under the path (replacing a file of the same name), with the blob's type
+   * as the file's; `searchable` makes it knowledge `search_files` reads (text, PDF).
+   */
+  put: (path: string, blob: Blob, searchable: boolean) => Promise<StoredFile>;
+  delete: (path: string) => Promise<void>;
+}
+/** How an upload goes: how much of it has gone, and how to let it go. */
+export interface UploadOptions {
+  /** Hears the share sent so far, from 0 to 1, as it goes. */
+  onProgress?: ((share: number) => void) | undefined;
+  /** Aborting it stops the upload, and the promise rejects with an `AbortError`. */
+  signal?: AbortSignal | undefined;
+}
+/** The API, as far as this package reaches it. */
+export interface Client {
+  /**
+   * The widget's agent and look, by the publishable key it speaks with (a web channel's key).
+   */
+  widget: () => Promise<WidgetConfig>;
+  /**
+   * Who the page speaks for, by its credentials: the business (our own app's cookie) or a person
+   * it serves (a token, a publishable key's visitor). What waits for the business's yes is
+   * answered by the business alone.
+   */
+  who: Speaker;
+  agents: {
+    /** What a person may know of the agent: its name, role, mark, and whether it takes calls. */
+    face: (id: string) => Promise<AgentFace>;
+    /** What the agent says about itself (null until it has written it) and the facts it rests on. */
+    about: (id: string) => Promise<AboutOut>;
+    /** Has the agent write about itself anew (a model call, a few seconds); answers like `about`. */
+    describe: (id: string) => Promise<AboutOut>;
+    /** The agent's own files, by path. */
+    files: (id: string) => Promise<StoredFile[]>;
+    /** Stores a file of the agent's own; see `Files.put`. */
+    putFile: (id: string, path: string, blob: Blob, searchable: boolean) => Promise<StoredFile>;
+    deleteFile: (id: string, path: string) => Promise<void>;
+    /** What the agent remembered, newest first. */
+    memories: (id: string) => Promise<MemoryFact[]>;
+    /** Takes one memory from it. */
+    forget: (id: string, memoryId: string) => Promise<void>;
     /**
-     * `resolve` carries an owner's answer. `pending` is optional: it fills in the cards a run is
-     * waiting on (`useRunStream`) and the ones a builder conversation still waits on, which only
-     * a host that follows runs or shows that conversation needs.
+     * The owner's call with the agent, from the browser (v3/VOICE.md): the call and its
+     * conversation (a test) made now, and where to join it (`VoiceCall`'s `connect`).
      */
-    requests?: Pick<Signalcore["requests"], "resolve"> & Partial<Pick<Signalcore["requests"], "pending">>;
-    /** Where a secret typed on a card goes: straight to the vault. */
-    vault?: Pick<Signalcore["vault"], "put">;
-    /** Where a document chosen on a card goes. */
-    documents?: Pick<Signalcore["documents"], "addFile">;
+    call: (id: string) => Promise<CallToken>;
+  };
+  /**
+   * The organization's files, shared by every agent; and the preview of any file the caller may
+   * read, the organization's, an agent's own or a conversation's (`preview`).
+   */
+  files: Files & {
+    /** What a viewer draws of the file, by its `kind` (v3/FILES.md, Preview). */
+    preview: (at: FileAt) => Promise<FilePreview>;
+  };
+  /** What an agent does on its own (v3/AUTOMATIONS.md). */
+  automations: {
+    /** The agent's automations, each as it stands now with its newest run. */
+    list: (agentId: string) => Promise<Automation[]>;
+    /** One of them by its name, with its newest runs. */
+    get: (agentId: string, name: string) => Promise<AutomationView>;
+  };
+  runs: {
+    /** One run of an automation with its record: every call it made, step by step. */
+    get: (id: string) => Promise<RunRecord>;
+  };
+  /**
+   * The tasks an agent runs for contacts, each with its newest runs: a person's own only (what
+   * they asked the agent for in their conversations); the business's, every one.
+   */
+  tasks: {
+    list: (agentId: string) => Promise<Task[]>;
+    /** Pauses it, or turns it on again; answers it as it stands. */
+    switch: (agentId: string, taskId: string, on: boolean) => Promise<Task>;
+    remove: (agentId: string, taskId: string) => Promise<void>;
+  };
+  /** Where people write to the organization's agents (v3/CHANNELS.md). */
+  channels: {
+    /** The organization's channels, or one agent's: the disconnected ones too. */
+    list: (agentId?: string) => Promise<Channel[]>;
+  };
+  conversations: {
+    /** One conversation with its messages. */
+    get: (id: string) => Promise<ConversationDetail>;
+    /** A new conversation with an agent. */
+    start: (agentId: string) => Promise<Conversation>;
+    /** The files that arrived in a conversation: attached, sent through a form. */
+    files: (id: string) => Promise<ConversationFile[]>;
     /**
-     * `authorize` gets a fresh consent link when the owner clicks a connect card (the one the
-     * card was made with is good for one attempt and expires); `refresh` asks the provider
-     * whether they finished.
+     * Stores a file in the conversation as the person picks it, to say it or send it through a
+     * form by its id: its bytes as they are, under its type and name.
      */
-    connections?: Pick<Signalcore["connections"], "authorize" | "refresh">;
-    /** A hosted browser's page, and its screenshot while it has no live view. */
-    browser?: Pick<Signalcore["browser"], "get" | "screenshot">;
-    /** A live stream's pictures, and the input a person sends back (`LiveView`). */
-    live?: {
-        connect: (streamId: string, options?: {
-            signal?: AbortSignal;
-        }) => WatchedStream;
-    };
-    /** A run's status and its live journal. */
-    runs?: Pick<Signalcore["runs"], "get" | "stream">;
+    upload: (id: string, file: File, options?: UploadOptions) => Promise<ConversationFile>;
     /**
-     * The live agent. `invoke` is talking to it as the person it serves (`AgentChat`); `overview`
-     * and `get` are reading it as its owner, for the windows that fetch for themselves when given
-     * an `agentId` (`AutomationsWindow`: the overview; `FlowWindow`: the overview and, from the
-     * agent, its package's files). Each component needs only its own.
+     * Where a picture, a video or a sound of the conversation plays from in the page's own
+     * player: an address that needs no credential, for an hour, streamed as the player seeks.
      */
-    agents?: Partial<Pick<Signalcore["agents"], "invoke" | "overview" | "get">>;
-    /** What the person said and was answered before, for the chat to open on (`AgentChat`). */
-    endUsers?: Pick<Signalcore["endUsers"], "myConversation">;
-    /** The builder: the owner's conversations with the assistant that shapes the agent. */
-    build?: {
-        sessions: BuildSessionsClient;
-    };
+    play: (id: string, fileId: string) => Promise<string>;
+    /**
+     * A call with the agent from the browser, for whoever may talk to it (a person, as theirs):
+     * the call and its own conversation made now, where what is said lands, and where to join it
+     * (`VoiceCall`'s `connect`).
+     */
+    call: (agentId: string) => Promise<CallToken>;
+  };
+  /**
+   * The conversation's socket address, signed in: `ws:` beside `http:`, `wss:` beside `https:`,
+   * with the token (and the visitor) in its query, since a browser's socket takes no header.
+   * `fresh` asks the host's backend for a new token first (`getToken`), for a socket that could
+   * not open with the last one.
+   */
+  liveUrl: (conversationId: string, options?: {
+    fresh?: boolean | undefined;
+  }) => Promise<string>;
 }
 /**
- * What `LiveView` uses of a stream. The SDK's `LiveStream` is one, and so is anything with its
- * first frame, its pictures (the newest, ending when the stream does, throwing when the
- * connection fails), a way to send input and a way to hang up.
+ * The API under `baseUrl`: JSON in and out, an `ApiError` for anything but a success, signed in
+ * the one way `options` gives. A token asked of the host's backend (`getToken`) that the API
+ * refuses (401: it expired) is asked for once more, and the request sent again with it.
  */
-export type WatchedStream = Pick<LiveStream, "info" | "send" | "close"> & AsyncIterable<LiveFrame>;
-/**
- * The calls of a builder conversation (`BuilderChat`, `useBuildSession`). `say` streams one
- * turn; hanging up is stopping the iteration, and a client that can hang up at once (a fetch it
- * owns) also honours `signal`, which the SDK's `say` may not take yet: a function that takes
- * fewer arguments is still a `say`.
- */
-export interface BuildSessionsClient extends Pick<Signalcore["build"]["sessions"], "create" | "list" | "history"> {
-    say: (agentId: string, sessionId: string, message: string, options?: {
-        signal?: AbortSignal;
-    }) => AsyncGenerator<BuilderEvent, void>;
-}
+export declare function createClient(options: ClientOptions): Client;
+//#endregion
+//# sourceMappingURL=client.d.ts.map

package/dist/client.js

@@ -1 +1,204 @@
-export {};
+import { signerOf } from "./credentials.js";
+//#region src/client.ts
+/**
+* What the API answered when it was not a success: its status, its sentence (`detail`, written
+* to be shown) and its `code`, for a host to word in its own language.
+*/
+var ApiError = class extends Error {
+	status;
+	detail;
+	/** What went wrong, by name (`not_found`, `no_calls`); null when the answer named nothing. */
+	code;
+	constructor(status, detail, code = null) {
+		super(detail);
+		this.name = "ApiError";
+		this.status = status;
+		this.detail = detail;
+		this.code = code;
+	}
+};
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isIssue = (value) => isRecord(value) && typeof value.msg === "string";
+/**
+* Reads an error body: `{code, detail: "message"}`, or FastAPI's 422 `{detail: [{msg, …}, …]}`
+* (the first issue speaks for all). A body with neither is named by its status alone.
+*/
+function parseError(status, body) {
+	const detail = isRecord(body) ? body.detail : void 0;
+	const code = isRecord(body) && typeof body.code === "string" ? body.code : null;
+	if (typeof detail === "string" && detail !== "") return new ApiError(status, detail, code);
+	if (Array.isArray(detail)) {
+		const issue = detail.find(isIssue);
+		if (issue) return new ApiError(status, issue.msg);
+	}
+	return new ApiError(status, `HTTP ${status}`);
+}
+/** A body read as JSON, or null when it is not. */
+function readJson(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return null;
+	}
+}
+const seg = encodeURIComponent;
+/** A file's path in a URL: each name of it encoded, the slashes between them kept. */
+const filePath = (path) => path.split("/").map(seg).join("/");
+/** Where a file's preview is read: under its conversation, its agent or the organization. */
+const previewPath = (at) => {
+	if ("conversationId" in at) return `/conversations/${seg(at.conversationId)}/files/${seg(at.fileId)}/preview`;
+	return `${"agentId" in at ? `/agents/${seg(at.agentId)}` : ""}/files/${filePath(at.path)}/preview`;
+};
+/**
+* The API under `baseUrl`: JSON in and out, an `ApiError` for anything but a success, signed in
+* the one way `options` gives. A token asked of the host's backend (`getToken`) that the API
+* refuses (401: it expired) is asked for once more, and the request sent again with it.
+*/
+function createClient(options) {
+	const { baseUrl, fetch: call = fetch } = options;
+	const signer = signerOf(options);
+	/** One request with the cookie or the credential's headers; a body goes as it is, typed. */
+	async function attempt(method, path, body) {
+		const signed = await signer.sign();
+		return {
+			response: await call(`${baseUrl}${path}`, {
+				method,
+				credentials: signer.credentials,
+				headers: body === void 0 ? signed.headers : {
+					...signed.headers,
+					"Content-Type": body.type
+				},
+				...body === void 0 ? {} : { body }
+			}),
+			signed
+		};
+	}
+	async function send(method, path, body) {
+		let { response, signed } = await attempt(method, path, body);
+		if (response.status === 401 && signed.renew !== null) {
+			signed.renew();
+			({response} = await attempt(method, path, body));
+		}
+		if (!response.ok) {
+			const answer = await response.json().catch(() => null);
+			throw parseError(response.status, answer);
+		}
+		return response;
+	}
+	async function json(method, path, body) {
+		return await (await send(method, path, body)).json();
+	}
+	/** A request whose answer has no body (204). */
+	async function run(method, path) {
+		await send(method, path);
+	}
+	/** The four of `Files` under a prefix: `/files`, or `/agents/{id}/files`. */
+	const filesUnder = (prefix) => ({
+		list: () => json("GET", prefix),
+		put: (path, blob, searchable) => json("PUT", `${prefix}/${filePath(path)}?searchable=${searchable}`, blob),
+		delete: (path) => run("DELETE", `${prefix}/${filePath(path)}`)
+	});
+	const own = (id) => filesUnder(`/agents/${seg(id)}/files`);
+	/**
+	* A file sent by XMLHttpRequest, the one way a browser tells how much of a body has gone; the
+	* cookie goes as with `fetch` on the same origin, any other credential as its headers. Refused
+	* with a token asked of the host's backend, it is sent once more with a new one.
+	*/
+	async function sendFile(path, file, options = {}) {
+		const signed = await signer.sign();
+		try {
+			return await post(path, file, signed.headers, options);
+		} catch (error) {
+			if (!(error instanceof ApiError && error.status === 401) || signed.renew === null) throw error;
+			signed.renew();
+			return post(path, file, (await signer.sign()).headers, options);
+		}
+	}
+	function post(path, file, headers, { onProgress, signal }) {
+		return new Promise((resolve, reject) => {
+			const aborted = () => new DOMException("The upload was aborted", "AbortError");
+			if (signal?.aborted) {
+				reject(aborted());
+				return;
+			}
+			const request = new XMLHttpRequest();
+			const abort = () => {
+				request.abort();
+			};
+			request.open("POST", `${baseUrl}${path}`);
+			for (const [name, value] of Object.entries(headers)) request.setRequestHeader(name, value);
+			request.setRequestHeader("Content-Type", file.type || "application/octet-stream");
+			request.setRequestHeader("X-File-Name", encodeURIComponent(file.name));
+			request.upload.addEventListener("progress", (event) => {
+				if (event.lengthComputable && event.total > 0) onProgress?.(event.loaded / event.total);
+			});
+			request.addEventListener("loadend", () => {
+				signal?.removeEventListener("abort", abort);
+			});
+			request.addEventListener("load", () => {
+				const body = readJson(request.responseText);
+				if (request.status >= 200 && request.status < 300) resolve(body);
+				else reject(parseError(request.status, body));
+			});
+			request.addEventListener("error", () => {
+				reject(new ApiError(0, "The upload could not reach the server"));
+			});
+			request.addEventListener("abort", () => {
+				reject(aborted());
+			});
+			signal?.addEventListener("abort", abort, { once: true });
+			request.send(file);
+		});
+	}
+	return {
+		widget: () => json("GET", "/channels/web/widget"),
+		who: signer.who,
+		agents: {
+			face: (id) => json("GET", `/agents/${seg(id)}/face`),
+			about: (id) => json("GET", `/agents/${seg(id)}/about`),
+			describe: (id) => json("POST", `/agents/${seg(id)}/describe`),
+			files: (id) => own(id).list(),
+			putFile: (id, path, blob, searchable) => own(id).put(path, blob, searchable),
+			deleteFile: (id, path) => own(id).delete(path),
+			memories: (id) => json("GET", `/agents/${seg(id)}/memories`),
+			forget: (id, memoryId) => run("DELETE", `/agents/${seg(id)}/memories/${seg(memoryId)}`),
+			call: (id) => json("POST", `/agents/${seg(id)}/voice/token`)
+		},
+		files: {
+			...filesUnder("/files"),
+			preview: (at) => json("GET", previewPath(at))
+		},
+		automations: {
+			list: (agentId) => json("GET", `/agents/${seg(agentId)}/automations`),
+			get: (agentId, name) => json("GET", `/agents/${seg(agentId)}/automations/${seg(name)}`)
+		},
+		runs: { get: (id) => json("GET", `/runs/${seg(id)}`) },
+		tasks: {
+			list: (agentId) => json("GET", `/agents/${seg(agentId)}/tasks`),
+			switch: (agentId, taskId, on) => json("PATCH", `/agents/${seg(agentId)}/tasks/${seg(taskId)}`, new Blob([JSON.stringify({ on })], { type: "application/json" })),
+			remove: (agentId, taskId) => run("DELETE", `/agents/${seg(agentId)}/tasks/${seg(taskId)}`)
+		},
+		channels: { list: (agentId) => json("GET", agentId === void 0 ? "/channels" : `/channels?agent=${seg(agentId)}`) },
+		conversations: {
+			get: (id) => json("GET", `/conversations/${seg(id)}`),
+			start: (agentId) => json("POST", `/agents/${seg(agentId)}/conversations`),
+			files: (id) => json("GET", `/conversations/${seg(id)}/files`),
+			upload: (id, file, options) => sendFile(`/conversations/${seg(id)}/files`, file, options),
+			play: async (id, fileId) => {
+				const link = await json("GET", `/conversations/${seg(id)}/files/${seg(fileId)}/link`);
+				return new URL(`${baseUrl}${link.path}`, window.location.href).href;
+			},
+			call: (agentId) => json("POST", `/agents/${seg(agentId)}/calls`)
+		},
+		liveUrl: async (conversationId, { fresh = false } = {}) => {
+			const url = new URL(`${baseUrl}/conversations/${seg(conversationId)}/live`, window.location.href);
+			url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+			for (const [name, value] of Object.entries(await signer.query(fresh))) url.searchParams.set(name, value);
+			return url.href;
+		}
+	};
+}
+//#endregion
+export { ApiError, createClient, parseError };
+
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { AboutOut, MemoryFact } from \"./about\";\nimport type { Automation, AutomationView, RunRecord, Task } from \"./automation/types\";\nimport { signerOf, type Credentials, type Speaker } from \"./credentials\";\nimport type {\n  AgentFace,\n  WidgetConfig,\n  CallToken,\n  Channel,\n  Conversation,\n  ConversationDetail,\n  ConversationFile,\n  FileAt,\n  FileLink,\n  FilePreview,\n  StoredFile,\n} from \"./types\";\n\n/**\n * What the API answered when it was not a success: its status, its sentence (`detail`, written\n * to be shown) and its `code`, for a host to word in its own language.\n */\nexport class ApiError extends Error {\n  readonly status: number;\n  readonly detail: string;\n  /** What went wrong, by name (`not_found`, `no_calls`); null when the answer named nothing. */\n  readonly code: string | null;\n\n  constructor(status: number, detail: string, code: string | null = null) {\n    super(detail);\n    this.name = \"ApiError\";\n    this.status = status;\n    this.detail = detail;\n    this.code = code;\n  }\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nconst isIssue = (value: unknown): value is { msg: string } =>\n  isRecord(value) && typeof value.msg === \"string\";\n\n/**\n * Reads an error body: `{code, detail: \"message\"}`, or FastAPI's 422 `{detail: [{msg, …}, …]}`\n * (the first issue speaks for all). A body with neither is named by its status alone.\n */\nexport function parseError(status: number, body: unknown): ApiError {\n  const detail = isRecord(body) ? body.detail : undefined;\n  const code = isRecord(body) && typeof body.code === \"string\" ? body.code : null;\n  if (typeof detail === \"string\" && detail !== \"\") return new ApiError(status, detail, code);\n  if (Array.isArray(detail)) {\n    const issue = detail.find(isIssue);\n    if (issue) return new ApiError(status, issue.msg);\n  }\n  return new ApiError(status, `HTTP ${status}`);\n}\n\n/** A body read as JSON, or null when it is not. */\nfunction readJson(text: string): unknown {\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Where the API is, and who calls it (`Credentials`: the cookie, a person's token, a token asked\n * of the host's backend, or a publishable key and its visitor).\n */\nexport type ClientOptions = Credentials & {\n  /**\n   * The API's origin and prefix: `/api` in our own app (the cookie's, on the page's origin), the\n   * public `https://…/v1` from a host's page.\n   */\n  baseUrl: string;\n  /** A host's own `fetch`, when the global one is not the right one. */\n  fetch?: typeof fetch | undefined;\n};\n\n/** The files under one owner: the organization's, or an agent's own. */\nexport interface Files {\n  /** Every file, by path. */\n  list: () => Promise<StoredFile[]>;\n  /**\n   * Stores the bytes under the path (replacing a file of the same name), with the blob's type\n   * as the file's; `searchable` makes it knowledge `search_files` reads (text, PDF).\n   */\n  put: (path: string, blob: Blob, searchable: boolean) => Promise<StoredFile>;\n  delete: (path: string) => Promise<void>;\n}\n\n/** How an upload goes: how much of it has gone, and how to let it go. */\nexport interface UploadOptions {\n  /** Hears the share sent so far, from 0 to 1, as it goes. */\n  onProgress?: ((share: number) => void) | undefined;\n  /** Aborting it stops the upload, and the promise rejects with an `AbortError`. */\n  signal?: AbortSignal | undefined;\n}\n\n/** The API, as far as this package reaches it. */\nexport interface Client {\n  /**\n   * The widget's agent and look, by the publishable key it speaks with (a web channel's key).\n   */\n  widget: () => Promise<WidgetConfig>;\n  /**\n   * Who the page speaks for, by its credentials: the business (our own app's cookie) or a person\n   * it serves (a token, a publishable key's visitor). What waits for the business's yes is\n   * answered by the business alone.\n   */\n  who: Speaker;\n  agents: {\n    /** What a person may know of the agent: its name, role, mark, and whether it takes calls. */\n    face: (id: string) => Promise<AgentFace>;\n    /** What the agent says about itself (null until it has written it) and the facts it rests on. */\n    about: (id: string) => Promise<AboutOut>;\n    /** Has the agent write about itself anew (a model call, a few seconds); answers like `about`. */\n    describe: (id: string) => Promise<AboutOut>;\n    /** The agent's own files, by path. */\n    files: (id: string) => Promise<StoredFile[]>;\n    /** Stores a file of the agent's own; see `Files.put`. */\n    putFile: (id: string, path: string, blob: Blob, searchable: boolean) => Promise<StoredFile>;\n    deleteFile: (id: string, path: string) => Promise<void>;\n    /** What the agent remembered, newest first. */\n    memories: (id: string) => Promise<MemoryFact[]>;\n    /** Takes one memory from it. */\n    forget: (id: string, memoryId: string) => Promise<void>;\n    /**\n     * The owner's call with the agent, from the browser (v3/VOICE.md): the call and its\n     * conversation (a test) made now, and where to join it (`VoiceCall`'s `connect`).\n     */\n    call: (id: string) => Promise<CallToken>;\n  };\n  /**\n   * The organization's files, shared by every agent; and the preview of any file the caller may\n   * read, the organization's, an agent's own or a conversation's (`preview`).\n   */\n  files: Files & {\n    /** What a viewer draws of the file, by its `kind` (v3/FILES.md, Preview). */\n    preview: (at: FileAt) => Promise<FilePreview>;\n  };\n  /** What an agent does on its own (v3/AUTOMATIONS.md). */\n  automations: {\n    /** The agent's automations, each as it stands now with its newest run. */\n    list: (agentId: string) => Promise<Automation[]>;\n    /** One of them by its name, with its newest runs. */\n    get: (agentId: string, name: string) => Promise<AutomationView>;\n  };\n  runs: {\n    /** One run of an automation with its record: every call it made, step by step. */\n    get: (id: string) => Promise<RunRecord>;\n  };\n  /**\n   * The tasks an agent runs for contacts, each with its newest runs: a person's own only (what\n   * they asked the agent for in their conversations); the business's, every one.\n   */\n  tasks: {\n    list: (agentId: string) => Promise<Task[]>;\n    /** Pauses it, or turns it on again; answers it as it stands. */\n    switch: (agentId: string, taskId: string, on: boolean) => Promise<Task>;\n    remove: (agentId: string, taskId: string) => Promise<void>;\n  };\n  /** Where people write to the organization's agents (v3/CHANNELS.md). */\n  channels: {\n    /** The organization's channels, or one agent's: the disconnected ones too. */\n    list: (agentId?: string) => Promise<Channel[]>;\n  };\n  conversations: {\n    /** One conversation with its messages. */\n    get: (id: string) => Promise<ConversationDetail>;\n    /** A new conversation with an agent. */\n    start: (agentId: string) => Promise<Conversation>;\n    /** The files that arrived in a conversation: attached, sent through a form. */\n    files: (id: string) => Promise<ConversationFile[]>;\n    /**\n     * Stores a file in the conversation as the person picks it, to say it or send it through a\n     * form by its id: its bytes as they are, under its type and name.\n     */\n    upload: (id: string, file: File, options?: UploadOptions) => Promise<ConversationFile>;\n    /**\n     * Where a picture, a video or a sound of the conversation plays from in the page's own\n     * player: an address that needs no credential, for an hour, streamed as the player seeks.\n     */\n    play: (id: string, fileId: string) => Promise<string>;\n    /**\n     * A call with the agent from the browser, for whoever may talk to it (a person, as theirs):\n     * the call and its own conversation made now, where what is said lands, and where to join it\n     * (`VoiceCall`'s `connect`).\n     */\n    call: (agentId: string) => Promise<CallToken>;\n  };\n  /**\n   * The conversation's socket address, signed in: `ws:` beside `http:`, `wss:` beside `https:`,\n   * with the token (and the visitor) in its query, since a browser's socket takes no header.\n   * `fresh` asks the host's backend for a new token first (`getToken`), for a socket that could\n   * not open with the last one.\n   */\n  liveUrl: (conversationId: string, options?: { fresh?: boolean | undefined }) => Promise<string>;\n}\n\nconst seg = encodeURIComponent;\n\n/** A file's path in a URL: each name of it encoded, the slashes between them kept. */\nconst filePath = (path: string): string => path.split(\"/\").map(seg).join(\"/\");\n\n/** Where a file's preview is read: under its conversation, its agent or the organization. */\nconst previewPath = (at: FileAt): string => {\n  if (\"conversationId\" in at) {\n    return `/conversations/${seg(at.conversationId)}/files/${seg(at.fileId)}/preview`;\n  }\n  const owner = \"agentId\" in at ? `/agents/${seg(at.agentId)}` : \"\";\n  return `${owner}/files/${filePath(at.path)}/preview`;\n};\n\ntype Method = \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n\n/**\n * The API under `baseUrl`: JSON in and out, an `ApiError` for anything but a success, signed in\n * the one way `options` gives. A token asked of the host's backend (`getToken`) that the API\n * refuses (401: it expired) is asked for once more, and the request sent again with it.\n */\nexport function createClient(options: ClientOptions): Client {\n  const { baseUrl, fetch: call = fetch } = options;\n  const signer = signerOf(options);\n\n  /** One request with the cookie or the credential's headers; a body goes as it is, typed. */\n  async function attempt(method: Method, path: string, body: Blob | undefined) {\n    const signed = await signer.sign();\n    const response = await call(`${baseUrl}${path}`, {\n      method,\n      credentials: signer.credentials,\n      headers:\n        body === undefined ? signed.headers : { ...signed.headers, \"Content-Type\": body.type },\n      ...(body === undefined ? {} : { body }),\n    });\n    return { response, signed };\n  }\n\n  async function send(method: Method, path: string, body?: Blob): Promise<Response> {\n    let { response, signed } = await attempt(method, path, body);\n    if (response.status === 401 && signed.renew !== null) {\n      signed.renew();\n      ({ response } = await attempt(method, path, body));\n    }\n    if (!response.ok) {\n      const answer: unknown = await response.json().catch(() => null);\n      throw parseError(response.status, answer);\n    }\n    return response;\n  }\n\n  async function json<T>(method: Method, path: string, body?: Blob): Promise<T> {\n    return (await (await send(method, path, body)).json()) as T;\n  }\n\n  /** A request whose answer has no body (204). */\n  async function run(method: Method, path: string): Promise<void> {\n    await send(method, path);\n  }\n\n  /** The four of `Files` under a prefix: `/files`, or `/agents/{id}/files`. */\n  const filesUnder = (prefix: string): Files => ({\n    list: () => json(\"GET\", prefix),\n    put: (path, blob, searchable) =>\n      json(\"PUT\", `${prefix}/${filePath(path)}?searchable=${searchable}`, blob),\n    delete: (path) => run(\"DELETE\", `${prefix}/${filePath(path)}`),\n  });\n\n  const own = (id: string) => filesUnder(`/agents/${seg(id)}/files`);\n\n  /**\n   * A file sent by XMLHttpRequest, the one way a browser tells how much of a body has gone; the\n   * cookie goes as with `fetch` on the same origin, any other credential as its headers. Refused\n   * with a token asked of the host's backend, it is sent once more with a new one.\n   */\n  async function sendFile(\n    path: string,\n    file: File,\n    options: UploadOptions = {},\n  ): Promise<ConversationFile> {\n    const signed = await signer.sign();\n    try {\n      return await post(path, file, signed.headers, options);\n    } catch (error) {\n      const expired = error instanceof ApiError && error.status === 401;\n      if (!expired || signed.renew === null) throw error;\n      signed.renew();\n      return post(path, file, (await signer.sign()).headers, options);\n    }\n  }\n\n  function post(\n    path: string,\n    file: File,\n    headers: Readonly<Record<string, string>>,\n    { onProgress, signal }: UploadOptions,\n  ): Promise<ConversationFile> {\n    return new Promise((resolve, reject) => {\n      const aborted = () => new DOMException(\"The upload was aborted\", \"AbortError\");\n      if (signal?.aborted) {\n        reject(aborted());\n        return;\n      }\n      const request = new XMLHttpRequest();\n      const abort = () => {\n        request.abort();\n      };\n      request.open(\"POST\", `${baseUrl}${path}`);\n      for (const [name, value] of Object.entries(headers)) request.setRequestHeader(name, value);\n      request.setRequestHeader(\"Content-Type\", file.type || \"application/octet-stream\");\n      request.setRequestHeader(\"X-File-Name\", encodeURIComponent(file.name));\n      request.upload.addEventListener(\"progress\", (event) => {\n        if (event.lengthComputable && event.total > 0) onProgress?.(event.loaded / event.total);\n      });\n      request.addEventListener(\"loadend\", () => {\n        signal?.removeEventListener(\"abort\", abort);\n      });\n      request.addEventListener(\"load\", () => {\n        const body = readJson(request.responseText);\n        if (request.status >= 200 && request.status < 300) resolve(body as ConversationFile);\n        else reject(parseError(request.status, body));\n      });\n      request.addEventListener(\"error\", () => {\n        reject(new ApiError(0, \"The upload could not reach the server\"));\n      });\n      request.addEventListener(\"abort\", () => {\n        reject(aborted());\n      });\n      signal?.addEventListener(\"abort\", abort, { once: true });\n      request.send(file);\n    });\n  }\n\n  return {\n    widget: () => json(\"GET\", \"/channels/web/widget\"),\n    who: signer.who,\n    agents: {\n      face: (id) => json(\"GET\", `/agents/${seg(id)}/face`),\n      about: (id) => json(\"GET\", `/agents/${seg(id)}/about`),\n      describe: (id) => json(\"POST\", `/agents/${seg(id)}/describe`),\n      files: (id) => own(id).list(),\n      putFile: (id, path, blob, searchable) => own(id).put(path, blob, searchable),\n      deleteFile: (id, path) => own(id).delete(path),\n      memories: (id) => json(\"GET\", `/agents/${seg(id)}/memories`),\n      forget: (id, memoryId) => run(\"DELETE\", `/agents/${seg(id)}/memories/${seg(memoryId)}`),\n      call: (id) => json(\"POST\", `/agents/${seg(id)}/voice/token`),\n    },\n    files: { ...filesUnder(\"/files\"), preview: (at) => json(\"GET\", previewPath(at)) },\n    automations: {\n      list: (agentId) => json(\"GET\", `/agents/${seg(agentId)}/automations`),\n      get: (agentId, name) => json(\"GET\", `/agents/${seg(agentId)}/automations/${seg(name)}`),\n    },\n    runs: {\n      get: (id) => json(\"GET\", `/runs/${seg(id)}`),\n    },\n    tasks: {\n      list: (agentId) => json(\"GET\", `/agents/${seg(agentId)}/tasks`),\n      switch: (agentId, taskId, on) =>\n        json(\n          \"PATCH\",\n          `/agents/${seg(agentId)}/tasks/${seg(taskId)}`,\n          new Blob([JSON.stringify({ on })], { type: \"application/json\" }),\n        ),\n      remove: (agentId, taskId) => run(\"DELETE\", `/agents/${seg(agentId)}/tasks/${seg(taskId)}`),\n    },\n    channels: {\n      list: (agentId) =>\n        json(\"GET\", agentId === undefined ? \"/channels\" : `/channels?agent=${seg(agentId)}`),\n    },\n    conversations: {\n      get: (id) => json(\"GET\", `/conversations/${seg(id)}`),\n      start: (agentId) => json(\"POST\", `/agents/${seg(agentId)}/conversations`),\n      files: (id) => json(\"GET\", `/conversations/${seg(id)}/files`),\n      upload: (id, file, options) => sendFile(`/conversations/${seg(id)}/files`, file, options),\n      play: async (id, fileId) => {\n        const link = await json<FileLink>(\n          \"GET\",\n          `/conversations/${seg(id)}/files/${seg(fileId)}/link`,\n        );\n        return new URL(`${baseUrl}${link.path}`, window.location.href).href;\n      },\n      call: (agentId) => json(\"POST\", `/agents/${seg(agentId)}/calls`),\n    },\n    liveUrl: async (conversationId, { fresh = false } = {}) => {\n      const url = new URL(\n        `${baseUrl}/conversations/${seg(conversationId)}/live`,\n        window.location.href,\n      );\n      url.protocol = url.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n      for (const [name, value] of Object.entries(await signer.query(fresh))) {\n        url.searchParams.set(name, value);\n      }\n      return url.href;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/conversationFiles.js

@@ -0,0 +1,46 @@
+import { useMemo, useRef, useState } from "react";
+//#region src/conversationFiles.ts
+/**
+* A conversation's files, as its chat's pieces reach them: an upload to it (the composer's, a
+* form's file field), every file known by id (said in its messages, uploaded here, or read back
+* once when one is asked for that neither has), where one plays from, and the host's way to
+* open one.
+*/
+function useConversationFiles(client, conversationId, messages, open) {
+	const [kept, setKept] = useState(() => /* @__PURE__ */ new Map());
+	const listed = useRef(false);
+	const known = useMemo(() => {
+		const all = new Map(kept);
+		for (const message of messages) for (const file of message.files ?? []) all.set(file.id, file);
+		return all;
+	}, [messages, kept]);
+	const keep = (files) => {
+		setKept((now) => {
+			const next = new Map(now);
+			for (const file of files) next.set(file.id, file);
+			return next;
+		});
+	};
+	return {
+		known,
+		open,
+		play: (file) => client.conversations.play(conversationId, file.id),
+		upload: async (file, progress, signal) => {
+			const stored = await client.conversations.upload(conversationId, file, {
+				onProgress: progress,
+				signal
+			});
+			keep([stored]);
+			return stored;
+		},
+		find: (ids) => {
+			if (listed.current || ids.every((id) => known.has(id))) return;
+			listed.current = true;
+			client.conversations.files(conversationId).then(keep, () => void 0);
+		}
+	};
+}
+//#endregion
+export { useConversationFiles };
+
+//# sourceMappingURL=conversationFiles.js.map

package/dist/conversationFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationFiles.js","names":[],"sources":["../src/conversationFiles.ts"],"sourcesContent":["import { useMemo, useRef, useState } from \"react\";\n\nimport type { Client } from \"./client\";\nimport type { FileHost } from \"./kit/uploads\";\nimport type { Attachment, Message } from \"./types\";\n\n/**\n * A conversation's files, as its chat's pieces reach them: an upload to it (the composer's, a\n * form's file field), every file known by id (said in its messages, uploaded here, or read back\n * once when one is asked for that neither has), where one plays from, and the host's way to\n * open one.\n */\nexport function useConversationFiles(\n  client: Client,\n  conversationId: string,\n  messages: readonly Message[],\n  open: ((file: Attachment) => void) | undefined,\n): FileHost {\n  const [kept, setKept] = useState<ReadonlyMap<string, Attachment>>(() => new Map());\n  const listed = useRef(false);\n\n  const known = useMemo(() => {\n    const all = new Map(kept);\n    for (const message of messages) for (const file of message.files ?? []) all.set(file.id, file);\n    return all;\n  }, [messages, kept]);\n\n  const keep = (files: readonly Attachment[]) => {\n    setKept((now) => {\n      const next = new Map(now);\n      for (const file of files) next.set(file.id, file);\n      return next;\n    });\n  };\n\n  return {\n    known,\n    open,\n    play: (file) => client.conversations.play(conversationId, file.id),\n    upload: async (file, progress, signal) => {\n      const stored = await client.conversations.upload(conversationId, file, {\n        onProgress: progress,\n        signal,\n      });\n      keep([stored]);\n      return stored;\n    },\n    find: (ids) => {\n      if (listed.current || ids.every((id) => known.has(id))) return;\n      listed.current = true;\n      client.conversations.files(conversationId).then(keep, () => undefined);\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAYA,SAAgB,qBACd,QACA,gBACA,UACA,MACU;CACV,MAAM,CAAC,MAAM,WAAW,+BAAgD,IAAI,IAAI,CAAC;CACjF,MAAM,SAAS,OAAO,KAAK;CAE3B,MAAM,QAAQ,cAAc;EAC1B,MAAM,MAAM,IAAI,IAAI,IAAI;EACxB,KAAK,MAAM,WAAW,UAAU,KAAK,MAAM,QAAQ,QAAQ,SAAS,CAAC,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI;EAC7F,OAAO;CACT,GAAG,CAAC,UAAU,IAAI,CAAC;CAEnB,MAAM,QAAQ,UAAiC;EAC7C,SAAS,QAAQ;GACf,MAAM,OAAO,IAAI,IAAI,GAAG;GACxB,KAAK,MAAM,QAAQ,OAAO,KAAK,IAAI,KAAK,IAAI,IAAI;GAChD,OAAO;EACT,CAAC;CACH;CAEA,OAAO;EACL;EACA;EACA,OAAO,SAAS,OAAO,cAAc,KAAK,gBAAgB,KAAK,EAAE;EACjE,QAAQ,OAAO,MAAM,UAAU,WAAW;GACxC,MAAM,SAAS,MAAM,OAAO,cAAc,OAAO,gBAAgB,MAAM;IACrE,YAAY;IACZ;GACF,CAAC;GACD,KAAK,CAAC,MAAM,CAAC;GACb,OAAO;EACT;EACA,OAAO,QAAQ;GACb,IAAI,OAAO,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG;GACxD,OAAO,UAAU;GACjB,OAAO,cAAc,MAAM,cAAc,CAAC,CAAC,KAAK,YAAY,KAAA,CAAS;EACvE;CACF;AACF"}

package/dist/credentials.d.ts

@@ -0,0 +1,45 @@
+//#region src/credentials.d.ts
+/**
+ * Who a client calls as, one way at a time (v3/README.md, Credentials): the owner's session cookie
+ * in our own app; a person's token, given as it is or asked of the host's backend (and asked again
+ * once it expires); or an anonymous visitor of a site, by the site's publishable key and the id
+ * the page keeps for them.
+ */
+type Way = "credentials" | "token" | "getToken" | "publishableKey" | "visitorId";
+/** One way of signing in, with none of the others beside it. */
+type Alone<T> = T & { [K in Exclude<Way, keyof T>]?: never; };
+export type Credentials =
+/** Our app, on the API's own origin (`/api`): the session cookie the browser holds. */
+Alone<{
+  credentials: "cookie";
+}> |
+/** A person's token the host's backend minted (`POST /v1/tokens`), used as it is. */
+Alone<{
+  token: string;
+}> |
+/**
+ * A person's token asked of the host's backend: when first needed, and once more each time the
+ * API refuses the one kept (it lasts an hour).
+ */
+Alone<{
+  getToken: () => Promise<string>;
+}> |
+/**
+ * An anonymous visitor (the widget): the site's publishable key, and who they are, an id the
+ * page keeps; one is made and kept in `localStorage` when none is given.
+ */
+Alone<{
+  publishableKey: string;
+  visitorId?: string | undefined;
+}>;
+/**
+ * Who a page speaks for: the business (the owner, in our own app) or a person it serves (a token's
+ * person, a publishable key's visitor). The API lets each answer different things: a yes the
+ * business decides is the business's alone.
+ */
+export type Speaker = "business" | "person";
+/** Where the page keeps its visitor's id, for every SignalCore widget on the site. */
+export declare const VISITOR_KEY = "signalcore.visitor";
+//#endregion
+export {};
+//# sourceMappingURL=credentials.d.ts.map