t3-bridge 0.1.2 → 0.2.0

package/README.md

@@ -39,26 +39,29 @@ Slack, and bookmark each link. On a single Mac without Tailscale, open the `127.
 | `npx t3-bridge link` | Print the control panel link again |
 | `npx t3-bridge status` | Show whether T3 Code and the bots are connected |
 
-To update, open the control panel's **Updates** card and choose **Update now**, or run
+The panel lists your bots in a sidebar. Each bot's **Conversation** tab shows every request from
+chat, what the agent is doing about it, its subagents, and anything that went wrong.
+
+To update, open **Settings** in the panel and choose **Update**, or run
 `npx t3-bridge@latest install`. Settings live in `~/Library/Application Support/T3 Bridge` and
 logs in `~/Library/Logs/T3 Bridge.log`.
 
-**Replace link** in **Open from other devices** issues a new link; every old copy stops working.
+**Replace link** under **Settings → Open from other devices** issues a new link; every old copy
+stops working. The QR code next to it opens the panel on your phone.
 
 ## Add a Slack bot
 
-In the control panel, choose **Add Slack bot** and follow the steps:
+In the control panel, choose **+ Add** and follow the four steps:
 
-1. Name the bot and copy the generated manifest.
-2. On api.slack.com/apps, choose **Create New App → From a manifest**, paste it, and install the
-   app to your workspace. Copy the **Bot User OAuth Token** (`xoxb-…`).
-3. Under **Basic Information → App-Level Tokens**, create a token with the `connections:write`
-   scope (`xapp-…`).
-4. Paste both tokens and choose **Test tokens**.
-5. Choose a thread, or create a new orchestrator thread. A new thread is pinned, runs with full
+1. Name the bot and choose **Create Slack app**. Slack opens with the app filled in; choose
+   **Create**, then **Install to Workspace**.
+2. Paste the **Bot User OAuth Token** (`xoxb-…`) and an app-level token with the
+   `connections:write` scope (`xapp-…`, under **Basic Information → App-Level Tokens**). They
+   are checked as you paste.
+3. Choose a thread, or create a new orchestrator thread. A new thread is pinned, runs with full
    access, and starts with the orchestrator instructions.
-6. Leave **Who may use it** empty to claim the bot by sending it a direct message, or list Slack
-   member IDs.
+4. Send the bot a direct message in Slack. The first person to do so becomes its owner; add
+   others under the bot's **Settings → Who may use it**.
 
 Message the bot directly, or invite it to a channel with `/invite @bot`. Both go to the same thread. In
 a channel, mention the bot (`@bot fix the login page`) or reply under one of its messages; other
@@ -66,9 +69,9 @@ channel chatter is ignored.
 
 ## Updating an existing bot's Slack app
 
-When a new version needs more Slack permissions, the bot's card shows **Update Slack app**. It
-gives you a new manifest to paste under **App Manifest** on api.slack.com, then asks you to
-reinstall the app. The tokens stay the same.
+When a new version needs more Slack permissions, the bot's **Slack app** tab says so. It gives
+you a new manifest to paste under **App Manifest** on api.slack.com, then asks you to reinstall
+the app. The tokens stay the same.
 
 ## In Slack
 

package/dist/cli.cjs

@@ -74375,6 +74375,87 @@ const DEFAULT_INSTRUCTIONS = `You are the orchestrator for this project. Message
 - You may answer quick questions directly only when no code needs to be read or changed.
 - Keep replies concise and chat-friendly. Use short paragraphs and lists; avoid wide tables.
 - Images you show (by file path or attachment) and pages you render with html_render reach the user in Slack as files, so do not tell them to open T3 to see them.`;
+// src/engine/core/activity.ts
+const SNIPPET = 280;
+const snippet = (text) => text.length > SNIPPET ? `${text.slice(0, SNIPPET).trimEnd()}…` : text;
+function newActivity(input) {
+	const at = (/* @__PURE__ */ new Date()).toISOString();
+	return {
+		id: input.id,
+		at,
+		user: input.user,
+		text: snippet(input.text),
+		files: input.files,
+		status: input.error === void 0 ? "running" : "not_sent",
+		subagents: [],
+		waiting: null,
+		reply: null,
+		error: input.error ?? null,
+		updatedAt: at
+	};
+}
+/** Folds a post the agent produced for this request into its entry. */
+function applyPost(entry, post) {
+	const touched = {
+		...entry,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	switch (post.kind) {
+		case "assistant": return post.markdown.trim() === "" ? entry : {
+			...touched,
+			reply: snippet(post.markdown.trim())
+		};
+		case "subagents": return {
+			...touched,
+			subagents: post.tasks.map((task) => ({
+				id: task.id,
+				title: task.title,
+				status: task.status
+			}))
+		};
+		case "subagent": {
+			const task = {
+				id: post.id,
+				title: post.title,
+				status: post.status
+			};
+			const others = entry.subagents.filter((existing) => existing.id !== post.id);
+			return {
+				...touched,
+				subagents: [...others, task]
+			};
+		}
+		case "approval": return {
+			...touched,
+			waiting: post.resolved === null ? "approval" : null
+		};
+		case "question": return {
+			...touched,
+			waiting: post.resolved ? null : "question"
+		};
+		case "error": return {
+			...touched,
+			error: snippet(post.message)
+		};
+		default: return entry;
+	}
+}
+function applyRunStatus(entry, status) {
+	if (entry.status === status) return entry;
+	return {
+		...entry,
+		status,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+}
+/** Whether the agent is still on it: its turn is running or subagents it started still are. */
+function isWorking(entry) {
+	return entry.status === "running" || entry.subagents.some((task) => [
+		"pending",
+		"running",
+		"waiting"
+	].includes(task.status));
+}
 /** Writes through a temp file so a crash mid-write never leaves half a JSON file behind. */
 async function writeJsonAtomic(file, value, mode = 384) {
 	await node_fs_promises.mkdir(node_path.dirname(file), { recursive: true });
@@ -74751,9 +74832,10 @@ var BotRuntime = class {
 	}
 	applyRun(run) {
 		this.runs.set(run.id, run);
+		const status = runStatus(run.status);
+		if (status !== null) this.updateActivity(run.id, (entry) => applyRunStatus(entry, status));
 		const sent = this.state.sentMessages[run.userMessageId];
 		if (sent === void 0) return;
-		const status = runStatus(run.status);
 		if (status === null || status === sent.status) return;
 		this.state.sentMessages[run.userMessageId] = {
 			...sent,
@@ -74770,8 +74852,36 @@ var BotRuntime = class {
 			post: keyed.post,
 			runId
 		});
+		this.updateActivity(runId, (entry) => applyPost(entry, keyed.post));
 		this.scheduleDelivery(0);
 	}
+	get activity() {
+		return this.state?.activity ?? [];
+	}
+	recordActivity(entry) {
+		const activity = [...this.activity, entry];
+		this.state.activity = activity.slice(-200);
+		this.scheduleSave();
+	}
+	/** Updates the request a run belongs to, following summaries back to the run that delegated. */
+	updateActivity(runId, change) {
+		let current = runId;
+		for (let depth = 0; current !== null && depth < 16; depth += 1) {
+			const run = this.runs.get(current);
+			if (run === void 0) return;
+			const index = this.activity.findIndex((entry) => entry.id === run.userMessageId);
+			if (index !== -1) {
+				const before = this.activity[index];
+				const after = change(before);
+				if (after !== before) {
+					this.state.activity = this.activity.with(index, after);
+					this.scheduleSave();
+				}
+				return;
+			}
+			current = this.wakeParents.get(run.userMessageId) ?? null;
+		}
+	}
 	/**
 	* The chat thread a run's output belongs in: the thread of the chat message that started
 	* it, the thread under a message typed in T3, or, for the summary T3 asks for after
@@ -74923,6 +75033,7 @@ var BotRuntime = class {
 			return;
 		}
 		if (await this.answerFromReply(message, text)) return;
+		let recorded = null;
 		try {
 			const attachments = await this.uploadFiles(message);
 			const messageId = MessageId.make(node_crypto.randomUUID());
@@ -74940,6 +75051,13 @@ var BotRuntime = class {
 				...title === null ? [] : [`${message.replyTo === null ? "new thread" : "thread"} "${title}"`],
 				...this.bot.reminder ? ["delegate via subagents"] : []
 			].join(" · ")}]\n`;
+			recorded = messageId;
+			this.recordActivity(newActivity({
+				id: messageId,
+				user: message.userName,
+				text,
+				files: message.files.length
+			}));
 			await this.options.t3.dispatch({
 				type: "message.dispatch",
 				commandId: CommandId.make(node_crypto.randomUUID()),
@@ -74960,6 +75078,15 @@ var BotRuntime = class {
 			};
 		} catch (error) {
 			log.error(`[${this.bot.name}] sending a message to T3 failed`, error);
+			const failed = newActivity({
+				id: recorded ?? node_crypto.randomUUID(),
+				user: message.userName,
+				text,
+				files: message.files.length,
+				error: `Could not reach T3: ${errorText(error)}`
+			});
+			if (recorded === null) this.recordActivity(failed);
+			else this.state.activity = this.activity.map((entry) => entry.id === recorded ? failed : entry);
 			await adapter.reply(message, `⚠️ Could not reach T3: ${errorText(error)}`);
 		}
 	}
@@ -76495,7 +76622,7 @@ function describeCause(cause) {
 	return ((error instanceof Error ? error.message : typeof error === "string" ? error : JSON.stringify(error)) ?? "Unknown error").split("\n")[0].slice(0, 500);
 }
 // src/engine/version.ts
-const BRIDGE_VERSION = "0.1.2";
+const BRIDGE_VERSION = "0.2.0";
 // src/engine/Engine.ts
 const botSecret = (botId, name) => `bot.${botId}.${name}`;
 var Engine = class {
@@ -76546,11 +76673,17 @@ var Engine = class {
 						error: "Not running"
 					},
 					lastError: runtime?.lastError ?? null,
-					manifestOutdated: (bot.manifestVersion ?? 1) < 3
+					manifestOutdated: (bot.manifestVersion ?? 1) < 3,
+					activity: summarize(runtime?.activity ?? [])
 				};
 			})
 		};
 	}
+	/** A bot's latest requests, newest first. */
+	activity(botId) {
+		if (!this.config.get().bots.some((bot) => bot.id === botId)) throw new NotFoundError("No such bot");
+		return [...this.bots.get(botId)?.activity ?? []].reverse();
+	}
 	async listThreads() {
 		const shell = await this.t3.getShell();
 		const projects = new Map(shell.projects.map((project) => [project.id, project.title]));
@@ -76800,6 +76933,18 @@ var Engine = class {
 	}
 };
 var NotFoundError = class extends Error {};
+/** What the bot list shows: the request in progress, and how today went. */
+function summarize(activity) {
+	const midnight = /* @__PURE__ */ new Date();
+	midnight.setHours(0, 0, 0, 0);
+	const today = activity.filter((entry) => Date.parse(entry.at) >= midnight.getTime());
+	return {
+		working: activity.findLast(isWorking) ?? null,
+		today: today.length,
+		problemsToday: today.filter((entry) => entry.error !== null || entry.status === "failed").length,
+		lastAt: activity.at(-1)?.updatedAt ?? null
+	};
+}
 /** Bots set up with the agent manifest talk in Slack's AI-app layout, one thread per request. */
 function isAgentLayout(bot) {
 	return (bot.manifestVersion ?? 1) >= 3;
@@ -76934,6 +77079,8 @@ var ControlServer = class {
 			token: await engine.rotateControlToken(),
 			connectLinks: this.connectLinks()
 		};
+		const activityMatch = /^\/api\/bots\/([\w-]+)\/activity$/.exec(path);
+		if (method === "GET" && activityMatch !== null) return { entries: engine.activity(activityMatch[1]) };
 		const freshMatch = /^\/api\/bots\/([\w-]+)\/new-thread$/.exec(path);
 		if (method === "POST" && freshMatch !== null) return engine.startFreshThread(freshMatch[1]);
 		const botMatch = /^\/api\/bots\/([\w-]+)$/.exec(path);

package/dist/panel/assets/index-BCdCSEsV.css

@@ -0,0 +1 @@
+:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light dark;--bg:#fff;--sidebar:#fafafa;--surface:#fff;--raised:#f4f4f5;--hover:#f4f4f5;--selected:#ececee;--text:#27272a;--muted:#71717b;--border:#e4e4e7;--input:#d4d4d8;--accent:#1b4ed8;--accent-text:#fff;--info:#1b4ed8;--ok:#16a34a;--warn:#bb4d00;--warn-surface:#fcf4e8;--bad:#c10007;--bad-surface:#fcebec;--code:#f4f4f5;--radius:10px;--font:-apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif;--mono:ui-monospace, "SF Mono", Menlo, monospace;font-family:var(--font);font-size:13px}@media (prefers-color-scheme:dark){:root{--lightningcss-light: ;--lightningcss-dark:initial;--bg:#0a0a0a;--sidebar:#000;--surface:#111;--raised:#141414;--hover:#131313;--selected:#1a1b1b;--text:#f5f5f5;--muted:#818181;--border:#1f1f1f;--input:#262626;--accent:#346bf1;--info:#51a2ff;--ok:#22c55e;--warn:#ffb900;--warn-surface:#312108;--bad:#ff6467;--bad-surface:#301214;--code:#111}}*{box-sizing:border-box}html,body,#root{height:100%}body{background:var(--bg);color:var(--text);-webkit-font-smoothing:antialiased;margin:0}a{color:var(--info)}button{font:inherit;color:inherit}code,.mono{font-family:var(--mono);font-size:12px}code{background:var(--code);border:1px solid var(--border);border-radius:5px;padding:0 4px}h1{margin:0;font-size:16px;font-weight:650}h2{margin:0;font-size:13.5px;font-weight:600}p{margin:6px 0;line-height:1.5}.muted{color:var(--muted)}.small{font-size:12px}.ok-text{color:var(--ok)}.error-text{color:var(--bad)}.row{align-items:center;gap:8px;display:flex}.row.wrap{flex-wrap:wrap}.spread{justify-content:space-between}.stack{gap:12px;display:grid}.stack.tight{gap:8px}.shell{grid-template-columns:248px 1fr;height:100%;display:grid}.sidebar{background:var(--sidebar);border-right:1px solid var(--border);flex-direction:column;min-height:0;display:flex}.sidebar-head{justify-content:space-between;align-items:center;padding:14px 12px 8px 14px;display:flex}.brand{align-items:center;gap:8px;font-size:13.5px;font-weight:650;display:flex}.brand svg{color:var(--accent)}.sidebar-list{flex:1;padding:4px 6px 10px;overflow-y:auto}.group{text-transform:uppercase;letter-spacing:.05em;color:var(--muted);align-items:center;gap:6px;padding:12px 8px 4px;font-size:10.5px;display:flex}.item{all:unset;box-sizing:border-box;cursor:pointer;border-radius:8px;grid-template-columns:1fr auto;gap:2px 8px;width:100%;padding:8px;display:grid}.item:hover{background:var(--hover)}.item.selected{background:var(--selected)}.item-name{align-items:center;gap:7px;min-width:0;font-weight:550;display:flex}.item-name span:last-child{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.item-side{color:var(--muted);font-size:11.5px}.item-sub{color:var(--muted);white-space:nowrap;text-overflow:ellipsis;grid-column:1/-1;padding-left:14px;font-size:11.5px;overflow:hidden}.item-sub.working{color:var(--info)}.item-sub.problem{color:var(--bad)}.badge{background:var(--info);color:var(--bg);border-radius:99px;padding:0 6px;font-size:10.5px;font-weight:700;line-height:16px}.sidebar-foot{border-top:1px solid var(--border);gap:2px;padding:8px 6px 10px;display:grid}.foot-line{color:var(--muted);align-items:center;gap:7px;padding:2px 8px;font-size:11.5px;display:flex}.empty-list{color:var(--muted);padding:16px 8px;font-size:12px;line-height:1.5}.main{min-width:0;overflow-y:auto}.page{max-width:860px;padding:20px 24px 40px}.page-head{align-items:flex-start;gap:12px;margin-bottom:4px;display:flex}.page-head .grow{flex:1;min-width:0}.subtitle{color:var(--muted);flex-wrap:wrap;gap:2px 6px;margin-top:3px;font-size:12px;display:flex}.btn.back{display:none}@media (max-width:720px){.shell{grid-template-columns:1fr}.shell.detail .sidebar,.shell:not(.detail) .main{display:none}.page{padding:14px 14px 32px}.btn.back{display:inline-flex}}.btn{cursor:pointer;border:1px solid var(--border);background:var(--surface);white-space:nowrap;border-radius:8px;align-items:center;gap:6px;padding:6px 11px;font-size:12.5px;font-weight:550;display:inline-flex}.btn:hover:not(:disabled){background:var(--hover)}.btn:disabled{opacity:.5;cursor:default}.btn.primary{background:var(--accent);color:var(--accent-text);border-color:#0000}.btn.primary:hover:not(:disabled){background:var(--accent);filter:brightness(1.08)}.btn.ghost{color:var(--muted);background:0 0;border-color:#0000}.btn.ghost:hover:not(:disabled){color:var(--text)}.btn.danger{color:var(--bad)}.btn.sm{padding:4px 9px;font-size:12px}.btn.icon{padding:4px 8px}.input{border:1px solid var(--input);background:var(--bg);width:100%;color:var(--text);font:inherit;border-radius:8px;padding:7px 9px}.input:focus{outline:2px solid color-mix(in srgb, var(--accent) 45%, transparent);outline-offset:-1px}textarea.input{resize:vertical;line-height:1.45}.field{gap:5px;display:grid}.field>span{font-size:12px;font-weight:550}.field .hint{color:var(--muted);font-size:11.5px;font-weight:400}.check{align-items:flex-start;gap:8px;font-size:12.5px;line-height:1.45;display:flex}.check input{margin-top:2px}.segmented{border:1px solid var(--border);border-radius:8px;gap:2px;padding:2px;display:inline-flex}.segmented button{cursor:pointer;color:var(--muted);background:0 0;border:0;border-radius:6px;padding:4px 10px;font-size:12px}.segmented button.active{background:var(--selected);color:var(--text);font-weight:550}.card{background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);padding:14px}.dot{background:var(--muted);border-radius:50%;flex:none;width:7px;height:7px}.dot.ok{background:var(--ok)}.dot.pending{background:var(--warn)}.dot.bad{background:var(--bad)}.dot.working{background:var(--info);box-shadow:0 0 0 3px color-mix(in srgb, var(--info) 22%, transparent)}.platform{color:#fff;border-radius:5px;flex:none;place-items:center;width:18px;height:18px;font-size:10px;font-weight:800;display:inline-grid}.platform.lg{border-radius:8px;width:32px;height:32px;font-size:14px}.platform.slack{background:#611f69}.banner{border:1px solid var(--border);background:var(--raised);border-radius:8px;padding:10px 12px;font-size:12.5px;line-height:1.5}.banner.warn{background:var(--warn-surface);border-color:color-mix(in srgb, var(--warn) 35%, transparent)}.banner.bad{background:var(--bad-surface);border-color:color-mix(in srgb, var(--bad) 35%, transparent);color:var(--bad)}.tabs{border-bottom:1px solid var(--border);gap:18px;margin:14px 0 16px;display:flex}.tabs button{cursor:pointer;color:var(--muted);background:0 0;border:0;border-bottom:2px solid #0000;margin-bottom:-1px;padding:0 0 9px;font-size:12.5px}.tabs button.active{color:var(--text);border-bottom-color:var(--accent);font-weight:600}.facts{grid-template-columns:repeat(3,1fr);gap:8px;margin-bottom:16px;display:grid}.fact{border:1px solid var(--border);border-radius:8px;padding:8px 10px}.fact .k{text-transform:uppercase;letter-spacing:.04em;color:var(--muted);font-size:10.5px}.fact .v{margin-top:2px;font-weight:600}.menu{position:relative}.menu-list{z-index:5;background:var(--surface);border:1px solid var(--border);border-radius:9px;min-width:200px;padding:4px;position:absolute;top:calc(100% + 4px);right:0;box-shadow:0 8px 24px #00000040}.menu-list button{text-align:left;cursor:pointer;background:0 0;border:0;border-radius:6px;width:100%;padding:7px 9px;font-size:12.5px;display:block}.menu-list button:hover{background:var(--hover)}.menu-list .danger{color:var(--bad)}.feed{gap:14px;display:grid}.req{gap:6px;display:grid}.msg{grid-template-columns:26px 1fr;gap:10px;display:grid}.avatar{background:var(--raised);border:1px solid var(--border);border-radius:50%;place-items:center;width:26px;height:26px;font-size:11px;font-weight:700;display:grid}.avatar.bot{background:var(--accent);color:var(--accent-text);border-color:#0000}.bubble{border:1px solid var(--border);border-radius:var(--radius);background:var(--surface);min-width:0;padding:9px 11px}.bubble.reply{background:var(--raised)}.who{color:var(--muted);margin-bottom:3px;font-size:11.5px}.text{white-space:pre-wrap;overflow-wrap:anywhere;line-height:1.5}.chips{flex-wrap:wrap;align-items:center;gap:6px;margin-top:8px;display:flex}.chip{background:var(--raised);border:1px solid var(--border);color:var(--muted);border-radius:5px;padding:2px 7px;font-size:11px}.chip.completed{color:var(--ok)}.chip.failed{color:var(--bad)}.chip.running,.chip.waiting,.chip.pending{color:var(--info)}.state{color:var(--muted);align-items:center;gap:6px;font-size:11.5px;display:inline-flex}.state.working{color:var(--info)}.state.waiting{color:var(--warn)}.state.bad{color:var(--bad)}.state.ok{color:var(--ok)}.empty{text-align:center;color:var(--muted);padding:36px 16px;line-height:1.6}.stepper{gap:6px;margin:14px 0 16px;display:flex}.stepper div{color:var(--muted);border-top:2px solid var(--border);flex:1;padding-top:8px;font-size:11.5px}.stepper .done{border-color:var(--ok);color:var(--text)}.stepper .current{border-color:var(--accent);color:var(--text);font-weight:600}.steps-list{gap:6px;margin:0;padding-left:18px;line-height:1.5;display:grid}.wizard-foot{justify-content:space-between;margin-top:16px;display:flex}.thread-list{border:1px solid var(--border);border-radius:8px;max-height:260px;overflow-y:auto}.thread-row{text-align:left;border:0;border-bottom:1px solid var(--border);cursor:pointer;background:0 0;gap:1px;width:100%;padding:7px 10px;display:grid}.thread-row:last-child{border-bottom:0}.thread-row:hover{background:var(--hover)}.thread-row.selected{background:color-mix(in srgb, var(--accent) 14%, transparent)}.thread-title{font-weight:550}details summary{cursor:pointer}.link-row{align-items:center;gap:14px;margin-top:10px;display:flex}.qr{background:#fff;border-radius:8px;flex:none;width:96px;height:96px;padding:6px}.log{background:var(--code);border:1px solid var(--border);font-family:var(--mono);white-space:pre-wrap;border-radius:8px;max-height:360px;margin:10px 0 0;padding:10px;font-size:11px;line-height:1.55;overflow:auto}.connect{max-width:460px;margin:15vh auto;padding:0 16px}