pi-roundtable-web 0.22.5 → 0.23.0

package/dist/chunk-transcript-nabrrayp.js

@@ -0,0 +1 @@
+import{r,s,i,t,f,e,n,c,h,o,p,d,a,m,w,H,x}from"./chunk-index-5pnpf9v5.js";function q({conversationKey:l}){let[y,E]=i(),g=s(!1),{data:u,error:N}=x(()=>a.transcript(l,y),`${l}|${y??""}`);r(()=>{if(u&&!g.current)g.current=!0,window.scrollTo(0,document.body.scrollHeight)},[u]);let b=n("a",{className:"back",href:c("conversations"),children:["← ",t("Conversations")]});if(!u)return n(f,{children:[b,N?e(o,{message:N}):e(h,{})]});let{conversation:T}=u,k=T.kind==="outside"?t("Outside agent · {id}",{id:T.id.slice(0,8)}):H(T);return n(f,{children:[b,n("section",{className:"stack",children:[n("div",{className:"card-head",children:[e("h2",{children:k}),T.busy>0?e(d,{tone:"busy",children:t("running")}):null]}),u.archives.length>0?n("label",{className:"inline",children:[t("Showing")," ",n("select",{value:y??"",onChange:(v)=>{g.current=!1,E(v.target.value||void 0)},children:[e("option",{value:"",children:t("Current conversation")}),u.archives.map((v)=>e("option",{value:v,children:t("Archived {name}",{name:v})},v))]})]}):null,N?e(o,{message:N}):null,u.truncated?e("p",{className:"hint",children:t("This conversation is longer than the console reads; the oldest entries are not shown.")}):null,u.entries.length===0?e(p,{children:t("Nothing to show.")}):null,e("ol",{className:"transcript",children:u.entries.map((v,A)=>e(C,{entry:v},A))})]})]})}function C({entry:l}){let{timeZone:y}=m(),E=l.at?w(l.at,y):"";if(l.role==="tool")return e("li",{className:"entry entry-tool",children:n("details",{children:[n("summary",{children:[l.failed?t("Tool failed"):t("Tool result"),l.tool?` · ${l.tool}`:""]}),e("pre",{children:l.text||t("(empty)")})]})});return n("li",{className:`entry entry-${l.role}`,children:[n("div",{className:"entry-head",children:[e("span",{className:"role",children:t(S[l.role])}),e("span",{className:"meta",children:E})]}),l.text?e("p",{className:"text",children:l.text}):null,l.calls?.map((g,u)=>n("code",{className:"call",children:[g.name," ",g.preview]},u))]})}var S={user:"User",assistant:"Assistant",tool:"Tool",compaction:"Summary of earlier conversation"};export{q as TranscriptPage};

package/dist/index.html

@@ -2,10 +2,14 @@
 <html lang="en">
 	<head>
 		<meta charset="utf-8" />
-		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content" />
+		<meta name="color-scheme" content="light dark" />
 		<title>Console</title>
 		
-	<link rel="stylesheet" crossorigin href="./chunk-e8z9q554.css"><script type="module" crossorigin src="./chunk-82frzte9.js"></script></head>
+		
+		
+		
+	<link rel="stylesheet" crossorigin href="./chunk-index-dkvf85c7.css"><script type="module" crossorigin src="./chunk-index-5pnpf9v5.js"></script></head>
 	<body>
 		<div id="root"></div>
 		

package/dist/sw.js

@@ -0,0 +1 @@
+var i=self,o=new URL(i.registration.scope);var c=new URL("index.html",o).href,h=new Set(["index.html","chunk-character-creator-6vdshaj9.js","chunk-connectors-s33pc7b8.js","chunk-conversations-zpztvesk.js","chunk-entry-th44mrfe.js","chunk-index-4w1rf52n.js","chunk-index-5pnpf9v5.js","chunk-index-dkvf85c7.css","chunk-index-kkydgsrs.js","chunk-index-mtcervy3.js","chunk-index-x3cf4dsz.js","chunk-notes-ytw8qcfk.js","chunk-overview-fbea32dq.js","chunk-skills-58f4qz3b.js","chunk-table-ypqdgf66.js","chunk-table2d-bk1khqzq.js","chunk-transcript-nabrrayp.js"].map((e)=>new URL(e,o).href)),u=/\/chunk-table3d-[a-z0-9]+\.js$/,f=["api/","auth/","login","files/","avatars/"],w=(e)=>{let n=e.pathname.slice(o.pathname.length);return f.some((t)=>n.startsWith(t))};async function p(e){let n=await caches.open("roundtable-web-9fc0b00f8a22");try{let t=await fetch(e);if(t.ok&&new URL(e.url).href===o.href)await n.put(c,t.clone());return t}catch{let t=await n.match(c);if(t)return t;throw Error("offline and the shell is not cached")}}async function m(e){let n=await caches.open("roundtable-web-9fc0b00f8a22"),t=await n.match(e);if(t)return t;let s=await fetch(e);if(s.ok)await n.put(e,s.clone());return s}var r=(e,n)=>typeof e==="string"&&e?e.slice(0,n):void 0;function d(e){if(typeof e!=="string")return o.href;let n=URL.parse(e,o);return n&&n.origin===o.origin&&n.pathname.startsWith(o.pathname)?n.href:o.href}async function k(e){let n={};try{let s=e.data?.json();if(typeof s==="object"&&s!==null)n=s}catch{}let t=r(n.tag,200);await i.registration.showNotification(r(n.title,120)??"Roundtable",{body:r(n.body,240),icon:new URL("icons/192.png",o).href,badge:new URL("icons/badge-96.png",o).href,...t?{tag:t,renotify:!0}:{},data:{url:d(n.url)}})}async function g(e){e.notification.close();let n=e.notification.data,t=d(n?.url),a=(await i.clients.matchAll({type:"window",includeUncontrolled:!0})).find((l)=>l.url.startsWith(o.href));if(a){await a.focus(),a.postMessage({type:"roundtable:open",url:t});return}await i.clients.openWindow(t)}i.addEventListener("install",(e)=>{e.waitUntil(caches.open("roundtable-web-9fc0b00f8a22").then((n)=>n.addAll([...h])).then(()=>i.skipWaiting()))});i.addEventListener("activate",(e)=>{e.waitUntil(caches.keys().then((n)=>Promise.all(n.filter((t)=>t.startsWith("roundtable-web-")&&t!=="roundtable-web-9fc0b00f8a22").map((t)=>caches.delete(t)))).then(()=>i.clients.claim()))});i.addEventListener("fetch",(e)=>{let{request:n}=e;if(n.method!=="GET")return;let t=new URL(n.url);if(t.origin!==o.origin||!t.pathname.startsWith(o.pathname))return;if(w(t))return;if(n.mode==="navigate")e.respondWith(p(n));else if(h.has(t.origin+t.pathname)||u.test(t.pathname))e.respondWith(m(n))});i.addEventListener("push",(e)=>{e.waitUntil(k(e))});i.addEventListener("notificationclick",(e)=>{e.waitUntil(g(e))});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-roundtable-web",
-	"version": "0.22.5",
+	"version": "0.23.0",
 	"description": "A web console for the owners of a pi-roundtable host: conversations, transcripts, and memory notes, with live updates",
 	"type": "module",
 	"license": "MIT",
@@ -15,6 +15,7 @@
 		"!src/**/*.test.ts",
 		"!src/testing",
 		"dist",
+		"assets",
 		"LICENSE",
 		"README.md",
 		"CHANGELOG.md"
@@ -32,6 +33,7 @@
 		"build": "bun scripts/build.ts",
 		"prepack": "bun scripts/build.ts",
 		"fixture": "bun scripts/fixture-host.ts",
+		"fixture:app": "bun scripts/fixture-app.ts",
 		"typecheck": "tsc --noEmit && tsc --noEmit -p web",
 		"lint": "biome check .",
 		"test": "bun test"
@@ -40,18 +42,21 @@
 		"jose": "6.2.12"
 	},
 	"peerDependencies": {
-		"pi-roundtable": ">=0.22.0 <0.23.0"
+		"pi-roundtable": ">=0.23.0 <0.24.0"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.5.15",
+		"@happy-dom/global-registrator": "21.0.4",
 		"@types/bun": "1.4.3",
 		"@types/react": "19.3.0",
 		"@types/react-dom": "19.3.0",
-		"pi-roundtable": "0.22.5",
+		"@types/three": "0.186.0",
+		"pi-roundtable": "0.23.0",
 		"react": "19.3.0",
 		"react-dom": "19.3.0",
 		"react-markdown": "10.1.0",
 		"remark-gfm": "4.0.1",
+		"three": "0.186.1",
 		"typescript": "7.0.2"
 	}
 }

package/src/api-types.ts

@@ -1,5 +1,10 @@
 // The console's API shapes, shared by the server (`src/`) and the page (`web/`). Times are ISO strings.
 
+import type { CharacterInput, CharacterSpec } from "pi-roundtable/characters";
+
+/** What an agent is doing in a room, while it works. */
+export type ActivityPhase = "thinking" | "working";
+
 /** The panes the console can show; the options choose which ones a host serves. */
 export const PANES = [
 	"overview",
@@ -7,6 +12,9 @@ export const PANES = [
 	"notes",
 	"skills",
 	"connectors",
+	"rooms",
+	"schedules",
+	"table",
 ] as const;
 export type PaneName = (typeof PANES)[number];
 
@@ -16,12 +24,21 @@ export interface ConfigView {
 	panes: PaneName[];
 	/** The IANA zone the page formats times and event dates in: the host's `env.timeZone`. */
 	timeZone: string;
+	/** The page's look unless the owner picked one in the app; the server always sends it. */
+	look?: "modern" | "camelot";
 	locale?: string;
 	messages?: Readonly<Record<string, string>>;
 	cleanup?: boolean;
 	connectorAdminUrl?: string;
 	/** Only supplied for path-based routing; also the base for page/API URLs. */
 	mountPath?: string;
+	/** Present when the `rooms` pane is served: how the page opens the owner app's socket. */
+	app?: {
+		/** The key prefix of the app's rooms, such as `app`. */
+		surface: string;
+		/** The WebSocket subprotocol to offer. */
+		protocol: string;
+	};
 }
 
 export type ChannelName =
@@ -54,7 +71,8 @@ export interface AgentView {
 export interface GroupView {
 	name: string;
 	displayName: string;
-	channelId: string;
+	/** The group's Discord channel; a team without Discord has none. */
+	channelId?: string;
 	members: string[];
 	host: string;
 	busy: number;
@@ -222,3 +240,432 @@ export interface ConnectorsView {
 export interface ApiError {
 	error: string;
 }
+
+// ── The owner app: rooms, messages, cards, and the socket's frames ───────────────────────────────
+
+/** The WebSocket subprotocol of `<mount>/api/socket`; a later incompatible version gets a new name. */
+export const APP_PROTOCOL = "roundtable.app.v1";
+/** The version `ready` reports. */
+export const APP_PROTOCOL_VERSION = 1;
+/** The close code that says the credential lapsed: reconnect, and reload the page when the reconnect is refused. */
+export const APP_CLOSE_EXPIRED = 4401;
+/** The close code that says the person is no owner (any more): do not reconnect. */
+export const APP_CLOSE_FORBIDDEN = 4403;
+/** The most bytes (UTF-8, as JSON) an approval frame's `approval` carries before its long values are cut: 256 KiB. */
+export const APPROVAL_MAX_BYTES = 256 * 1024;
+/** The most files one message carries. */
+export const MAX_MESSAGE_FILES = 4;
+/** The longest message text in characters. */
+export const MAX_MESSAGE_CHARS = 32_000;
+
+/** What a room is: an agent's, a group's, or a dispatch thread (read only). */
+export type RoomKind = "agent" | "group" | "thread";
+
+/** The conversation's modes, per room. */
+export interface RoomMode {
+	yolo: boolean;
+	longRunning: boolean;
+}
+
+/** A file in a message, served at `<mount>/api/files/<id>`. */
+export interface RoomFile {
+	id: string;
+	name: string;
+	type: string;
+	size: number;
+}
+
+/**
+ * One message of a room. `id` is the room log's own number, ascending; a live message (an
+ * agent's interim text, shown until its final reply arrives) has `id` 0 and a `live` token,
+ * and a later frame with the same token replaces it. It is never stored: the client drops a
+ * room's live messages when a stored message of that agent arrives or the agent stops working.
+ */
+export interface RoomMessage {
+	id: number;
+	room: string;
+	/** `owner` wrote it, `agent` is a reply, `system` is a line the server wrote: a divider, a yolo approval. */
+	kind: "owner" | "agent" | "system";
+	/** The principal of an `owner` message. */
+	principalId?: string;
+	/** The agent name of an `agent` message. */
+	agent?: string;
+	/** The name to show with it. */
+	author: string;
+	text: string;
+	files: RoomFile[];
+	/** ISO time. */
+	at: string;
+	live?: string;
+}
+
+/** One entry of the room list. */
+export interface RoomView {
+	/** The channel key: `<surface>:agent.<name>`, `<surface>:group.<name>` or `<surface>:thread.<id>`. */
+	key: string;
+	kind: RoomKind;
+	/** The agent's or group's name; a thread's id. */
+	name: string;
+	displayName: string;
+	/** The coordinator's room, where the page opens. */
+	home: boolean;
+	/** The agent's picture, a path under the mount, for notification icons; absent for groups and threads. */
+	avatar?: string;
+	/** An agent room's character; a group page looks its members' up in the agent rooms. */
+	character?: CharacterSpec;
+	/** A group's members, by agent name. */
+	members?: string[];
+	/** A thread's parent room. */
+	parent?: string;
+	/** A thread's room takes no messages from the page. */
+	readOnly: boolean;
+	/** A thread whose dispatch has ended; its room stays readable. */
+	closed?: boolean;
+	mode: RoomMode;
+	/** The room's agent is working now. */
+	typing: boolean;
+	/** While typing: `working` during a tool call, `thinking` otherwise. */
+	phase?: ActivityPhase;
+	/** While typing: the member speaking, in a group round. */
+	agent?: string;
+	/** A turn runs that Stop would end. */
+	stoppable: boolean;
+	/** The newest stored message, if any. */
+	last?: RoomMessage;
+}
+
+export interface RoomsView {
+	rooms: RoomView[];
+}
+
+/** A page of a room's stored messages, oldest first, and the cards that ended among them. */
+export interface MessagesView {
+	messages: RoomMessage[];
+	/** There are older messages than the first one here. */
+	more: boolean;
+	/**
+	 * The cards of the room that opened within this page's span (from the first message's time,
+	 * or from the beginning when `more` is false, up to the next page's first message), oldest
+	 * first; the page places each among the messages by `frame.at`.
+	 */
+	cards: ClosedCard[];
+}
+
+/** Who the page is signed in as. */
+export interface SessionView {
+	principal: PrincipalName;
+	surface: string;
+	/** How the console signs the person in; the page offers Log out under `password`. */
+	auth: "none" | "password" | "verifier";
+	/** When the credential lapses, if it does. */
+	expiresAt?: string;
+	/** Web Push is available: the app serves the rooms and a key for it. */
+	push?: true;
+}
+
+/** The key a browser subscribes to push against. */
+export interface PushKeyView {
+	key: string;
+}
+
+/** One device of the person that gets push; the id is not the endpoint. */
+export interface PushDeviceView {
+	id: string;
+	label?: string;
+	createdAt: string;
+	lastOkAt?: string;
+}
+
+export interface PushDevicesView {
+	devices: PushDeviceView[];
+}
+
+/** A schedule, labelled by the room it belongs to or else its channel. */
+export interface ScheduleView {
+	id: number;
+	/** The room it runs in, when it belongs to one of the app's. */
+	room?: string;
+	/** The channel key it runs in. */
+	channel: string;
+	/** What to call that place: the room's name or the channel key. */
+	label: string;
+	title: string;
+	prompt: string;
+	/** The schedule's recurrence as the core stores it. */
+	recurrence: unknown;
+	nextRun: string;
+	lastRun?: string;
+	lastStatus?: string;
+	createdBy: string;
+}
+
+export interface SchedulesView {
+	schedules: ScheduleView[];
+}
+
+/** An agent's profile as its page edits it. */
+export interface AgentProfileView {
+	name: string;
+	displayName: string;
+	prompt: string;
+	/** Its own model; absent when it follows the assistant's. */
+	model?: string;
+	/** Its own thinking level; absent when it follows the assistant's. */
+	thinking?: string;
+	/** What its next turn runs on. */
+	effective: { model: string; thinking: string };
+	avatar: string;
+	character: CharacterSpec;
+	room: string;
+}
+
+export interface ModelsView {
+	models: string[];
+}
+
+/** What changes an agent: the same fields `AgentTeam.update` takes. */
+export interface AgentPatch {
+	displayName?: string;
+	prompt?: string;
+	model?: string;
+	thinking?: string;
+}
+
+/** The body of `PUT api/agents/<name>/character`: at most 4 KiB. */
+export interface CharacterRequest {
+	character: CharacterInput;
+}
+
+/** The 400 of `PUT api/agents/<name>/character`: `field` is the path of the offending field. */
+export interface CharacterRefusal extends ApiError {
+	field: string;
+}
+
+/** A file waiting for the message that uses it. */
+export interface UploadView {
+	id: string;
+	name: string;
+	type: string;
+	size: number;
+}
+
+/** An option of a question, as the core writes it. */
+export interface PromptOption {
+	label: string;
+	description?: string;
+	preview?: string;
+}
+
+/** One question of a card. */
+export interface PromptQuestion {
+	question: string;
+	header?: string;
+	/** None means a free-text answer. */
+	options: readonly PromptOption[];
+	multi: boolean;
+	allowOther: boolean;
+}
+
+/** What a held call is, as data beside its markdown text. */
+export interface PromptApproval {
+	action: string;
+	tool: string;
+	input: Record<string, unknown>;
+	files?: { path: string; bytes?: number }[];
+	copy?: { label?: string; text: string };
+	/** Set when long values of `input` were cut to fit `APPROVAL_MAX_BYTES`. */
+	truncated?: true;
+}
+
+/** The card's own words in place of an approval's. */
+export interface PromptWording {
+	approve: string;
+	decline: string;
+	footer: string;
+	approved: string;
+	declined: string;
+}
+
+/** An answer to a question: the chosen options' labels and the person's own text. */
+export interface PromptAnswer {
+	choices: string[];
+	text?: string;
+}
+
+/** A card the server asks the owner: an approval, a question, or several questions. */
+export type PromptFrame =
+	| {
+			id: string;
+			/** When the card opened (ISO 8601, the server's clock), which places it among the room's messages. */
+			at?: string;
+			kind: "approval";
+			title: string;
+			/** The card as markdown text. */
+			message: string;
+			approval?: PromptApproval;
+			/** `turn-timeout` is a turn's time-limit card: continuing it lets the turn go on. */
+			purpose: "action" | "turn-timeout";
+			wording?: PromptWording;
+			/** Only the speaker whose turn asks may answer. */
+			speakerOnly?: true;
+			/** Display names of the people the call names to approve it; owners may still. */
+			approvers?: string[];
+			/** The turn stopped waiting; an answer starts a new turn in the room. */
+			late?: true;
+	  }
+	| {
+			id: string;
+			at?: string;
+			kind: "ask";
+			title: string;
+			question: string;
+			options: readonly PromptOption[];
+			multi: boolean;
+			allowOther: boolean;
+			late?: true;
+	  }
+	| {
+			id: string;
+			at?: string;
+			kind: "questionnaire";
+			title: string;
+			questions: readonly PromptQuestion[];
+			late?: true;
+	  };
+
+/** How a card ended. `withdrawn` is a card the plugin that asked for it took back. */
+export type PromptOutcome =
+	| "approved"
+	| "declined"
+	| "answered"
+	| "expired"
+	| "cancelled"
+	| "withdrawn";
+
+/** What a person gave a question card: one answer, or one per question with the note beside them. */
+export type CardAnswer =
+	| { kind: "ask"; answer: PromptAnswer }
+	| { kind: "questionnaire"; answers: (PromptAnswer | null)[]; note?: string };
+
+/** A card that ended and is kept in its room's history, with how it ended. */
+export interface ClosedCard {
+	room: string;
+	/** The card as it was shown, `at` being when it opened. */
+	frame: PromptFrame;
+	outcome: PromptOutcome;
+	/** Why a `withdrawn` card was taken back. */
+	note?: string;
+	/** Who answered it, by display name; absent for a card nobody answered. */
+	by?: string;
+	/** What was answered, for the question cards. */
+	answer?: CardAnswer;
+	/** When it ended (ISO 8601, the server's clock). */
+	closedAt: string;
+}
+
+/** Why the server refused a frame. */
+export type RefusalCode =
+	| "bad_frame"
+	| "unknown_room"
+	| "read_only"
+	| "forbidden"
+	| "unknown_prompt"
+	| "unknown_upload"
+	| "empty"
+	| "too_long"
+	| "not_accepted";
+
+/** What the page sends: one JSON object per WebSocket text message. */
+export type ClientFrame =
+	/** Declares whether the page is in view and which room it shows. Sent after each `ready`. */
+	| { type: "hello"; visible: boolean; focus?: string }
+	| { type: "visibility"; visible: boolean }
+	/** The room the page shows now, or none: progress streams only for it. */
+	| { type: "focus"; room?: string }
+	| {
+			type: "send";
+			/** The page's own reference, echoed by `accepted` or `refused`. */
+			id: string;
+			room: string;
+			text: string;
+			/** Files uploaded with `POST api/uploads`, by the `id` each returned. */
+			uploads?: string[];
+	  }
+	| { type: "stop"; room: string }
+	| { type: "approval"; prompt: string; approved: boolean }
+	| { type: "answer"; prompt: string; answer: PromptAnswer }
+	| {
+			type: "answers";
+			prompt: string;
+			answers: (PromptAnswer | null)[];
+			note?: string;
+	  }
+	/** Cancels a question card instead of answering it. */
+	| { type: "cancel"; prompt: string };
+
+/** What the server sends: one JSON object per WebSocket text message. */
+export type ServerFrame =
+	/** The socket is authenticated; sent first, and followed by every open card. */
+	| {
+			type: "ready";
+			protocol: typeof APP_PROTOCOL_VERSION;
+			principal: string;
+			name: string;
+			/** The most files one message carries and the most bytes of one. */
+			uploads: { perMessage: number; maxBytes: number };
+	  }
+	/** The message `id` was taken into `room`; `message` is how it was stored. */
+	| { type: "accepted"; id: string; room: string; message: RoomMessage }
+	/** `id` names the refused `send`; `prompt` names the card whose answer was refused. */
+	| { type: "refused"; id?: string; prompt?: string; code: RefusalCode }
+	/** A message of a room, stored or live; see `RoomMessage`. */
+	| { type: "message"; room: string; message: RoomMessage }
+	/** A stored message changed its text in place, such as a thread's start line once the thread exists. */
+	| { type: "edited"; room: string; message: RoomMessage }
+	/** What the running turn writes and which tools it runs; sent to the sockets that focus the room. */
+	| { type: "progress"; room: string; event: AppProgress }
+	/** The room's agent is, or is no longer, working, and whether Stop applies. */
+	| {
+			type: "activity";
+			room: string;
+			typing: boolean;
+			stoppable: boolean;
+			phase?: ActivityPhase;
+			/** The member speaking, in a group round. */
+			agent?: string;
+			/** Only on the frame where `typing` turns false. */
+			outcome?: "done" | "failed";
+	  }
+	/** Which agents work now, anywhere (Discord included); sent after `ready` and when it changes. */
+	| { type: "presence"; agents: Record<string, { busy: boolean }> }
+	| { type: "prompt"; room: string; prompt: PromptFrame }
+	| {
+			type: "prompt_closed";
+			prompt: string;
+			outcome: PromptOutcome;
+			/** Why a `withdrawn` card was taken back. */
+			note?: string;
+			/** Who answered the card, by display name. */
+			by?: string;
+			/** What was answered, for the question cards. */
+			answer?: CardAnswer;
+			/** When it ended (ISO 8601, the server's clock). */
+			closedAt?: string;
+	  }
+	| { type: "mode"; room: string; yolo: boolean; longRunning: boolean }
+	/** Yolo mode approved a held call by itself. */
+	| { type: "auto_approved"; room: string; tool: string; action: string }
+	/** The team or the room list may differ: refetch. */
+	| { type: "changed" };
+
+/** A turn's live view, as the core reports it. */
+export type AppProgress =
+	| { type: "text"; delta: string }
+	| { type: "tool_start"; id: string; tool: string; preview?: string }
+	| {
+			type: "tool_end";
+			id: string;
+			tool: string;
+			ok: boolean;
+			refused?: "declined" | "expired" | "pending" | "held" | "withdrawn";
+	  };