@bud.sh/app 0.5.0 → 0.6.0

package/dist/server/assets/{listener-DN5TyOjJ.js → listener-D61O6PzF.js}

@@ -1,10 +1,11 @@
-import { Dn as tryPromise, Dt as callback, Ft as fail$1, Gt as map, Kt as mapError, Lt as flatMap, Mn as void_, Nt as die, On as try_, Pt as ensuring, Sn as sync, St as andThen, Ut as gen, Xt as orElseSucceed, Zt as promise, g as resolveScreenRoutes, gn as scoped, gr as TaggedError, h as defaultScreens, qt as match, s as Previews, t as BranchPreviews, u as Git, v as themeStyle, vt as acquireRelease, y as LOGO_TYPES } from "./branch-previews-ClkoJ0lM.js";
-import { C as selected$1, I as WorkError, L as ScreenModules, O as AdapterRegistry, S as ready, T as LiveChannel, V as taskDesignModuleId, a as FileMutations, b as read, c as FileReview, f as Files, g as StoreActivity, h as ReviewActionError, m as FilesInputError, r as FileSaves, t as FileReviewActions, u as FileSearch, w as validate, x as readWorkspace, y as inspect } from "./server-DxK-UB_Z.js";
-import { At as parseReviewSourceQuery, Ct as parseReviewDiffQuery, F as parseThreadId, Ft as parseFileSearchQuery, I as parseThreadInput, Kt as parseFileIndexQuery, L as parseThreadLinkInput, N as parseThreadDeleteInput, On as parseMessageAuthor, P as parseThreadFilter, R as parseThreadReplyInput, Sn as parseWorkUpdate, Tt as parseReviewHistoryQuery, V as parseThreadStatusInput, Xt as parseFilePath, _ as taskRoutes, bn as parseWorkSync, cn as parseSectionData, dt as maxFileSaveBytes, fn as parseWorkCreate, ft as parseMutationApply, g as pageRoutes, gn as parseWorkMutationResult, h as fileRoutes, hn as parseWorkItemRef, i as routes, in as parseElementAnchor, it as parseReviewActionIntent, j as parseThread, ln as parseWorkActionInput, lt as parseFileSaveRequest, pn as parseWorkDetail, pt as parseMutationIntent, rn as MAX_CANVAS_Y, rt as parseReviewActionApply, vn as parseWorkQuery, xn as parseWorkSyncResult, xt as parseReviewComparison, z as parseThreadSnapshot } from "./events-iHpLGr3k.js";
-import { $ as openShellTab, B as parseTaskDesign, Bt as Button, Cn as hasMessage, Dn as useLocaleSource, En as t, J as FieldCardContent, On as Text, Q as initialShellTabs, Rt as Loader, Sn as writePreference, Tn as locale, X as activeTab, Y as FieldCardHeader, Z as closeShellTab, _ as requestComments, _n as LiveStatus, _t as taskHref, at as tabsCookieValue, et as parseShellTabs, gt as selectedTask, ht as readConversationLocation, it as tabsCookieName, lt as conversationDestination, mn as ShellTabBar, n as unavailableComments, nt as stepShellTab, ot as visitShellTab, pt as legacyConversationHref, q as FieldCard, r as followThreads, rt as tabHref, t as commentsUnavailable, tt as readTabsCookie, v as projectLive, wn as isLocale, xn as readPreference, xt as legacyFileHref, yn as AppShell } from "./comment-data-CsjukwAW.js";
+import { $t as map, At as andThen, C as themeStyle, Cn as scoped, Cr as TaggedError, E as LOGO_TYPES, En as succeed, Et as acquireRelease, Fn as try_, Ft as callback, Gt as flatMap, Ht as ensuring, Pn as tryPromise, Qt as ignore, Rt as catch_, S as resolveScreenRoutes, T as FACTORY_STATUS_ROLES, Ut as fail$1, Vt as die, Zt as gen, an as promise, en as mapError, in as orElseSucceed, kn as sync, m as Git, qt as forEach, s as Previews, t as BranchPreviews, tn as match, w as FACTORY_STATUS_CATEGORIES, x as defaultScreens, zn as void_ } from "./branch-previews-DedrpnVR.js";
+import { C as inspect, D as selected$1, E as ready, F as AdapterRegistry, H as WorkError, M as Attachments, O as validate, T as readWorkspace, U as ScreenModules, a as FileMutations, b as StoreActivity, c as FileReview, f as Files, g as FactoryRuns, h as ReviewActionError, k as LiveChannel, m as FilesInputError, q as taskDesignModuleId, r as FileSaves, t as FileReviewActions, u as FileSearch, w as read } from "./server-Dkbp5stG.js";
+import { An as fieldByRole, B as parseThreadStatusInput, Dn as parseMessageAuthor, F as parseThreadInput, Gt as parseFileIndexQuery, I as parseThreadLinkInput, L as parseThreadReplyInput, M as parseThreadDeleteInput, N as parseThreadFilter, P as parseThreadId, Pt as parseFileSearchQuery, R as parseThreadSnapshot, Sn as valueByRole, St as parseReviewDiffQuery, Yt as parseFilePath, _ as taskRoutes, _n as parseWorkQuery, bn as parseWorkSyncResult, bt as parseReviewComparison, cn as parseWorkActionInput, ct as parseFileSaveRequest, dn as parseWorkCreate, dt as parseMutationApply, fn as parseWorkDetail, ft as parseMutationIntent, g as pageRoutes, h as fileRoutes, hn as parseWorkMutationResult, i as routes, j as parseThread, kt as parseReviewSourceQuery, mn as parseWorkItemRef, nn as MAX_CANVAS_Y, nt as parseReviewActionApply, rn as parseElementAnchor, rt as parseReviewActionIntent, sn as parseSectionData, ut as maxFileSaveBytes, wt as parseReviewHistoryQuery, xn as parseWorkUpdate, yn as parseWorkSync } from "./events-BH_rAu7O.js";
+import { An as hasMessage, Ct as taskHref, En as AppShell, Fn as Text, Gt as Loader, H as parseTaskDesign, Mn as locale, Nn as t, On as readPreference, Ot as legacyFileHref, Pn as useLocaleSource, Q as FieldCardHeader, X as FieldCardContent, Y as FieldCard, _ as requestComments, _t as legacyConversationHref, at as readTabsCookie, bt as agentViewOpen, ct as tabsCookieName, et as activeTab, it as parseShellTabs, jn as isLocale, kn as writePreference, lt as tabsCookieValue, n as unavailableComments, nt as initialShellTabs, ot as stepShellTab, pt as conversationDestination, qt as Button, r as followThreads, rt as openShellTab, st as tabHref, t as commentsUnavailable, tt as closeShellTab, ut as visitShellTab, v as projectLive, wn as LiveStatus, xn as ShellTabBar, xt as selectedTask, yt as readConversationLocation } from "./comment-data-Rg42ToTW.js";
 import { d as parsePreviewHash, f as parsePreviewId, l as parsePreviewBranch, m as parsePreviewViewport } from "./parsers-CsiSkwTT.js";
-import { t as projectWork } from "./project-work-qSKFO5yj.js";
+import { t as projectWork } from "./project-work-DoIwxWMm.js";
 import { n as showWorkspaceTab } from "./workspace-tab-DAUjkJzZ.js";
+import { c as parseTaskContext, l as parseTaskContextInput } from "./run-BJ8r5jSh.js";
 import { createHash } from "node:crypto";
 import { extname, isAbsolute, relative, resolve } from "node:path";
 import { createController, createRouter } from "remix/router";
@@ -86,10 +87,10 @@ function ProjectLiveStatus(handle) {
 //#endregion
 //#region app/client/screens.ts
 var builtIns = {
-	"bud:pages": () => import("./pages-BBBXyJWV.js"),
-	"bud:canvas": () => import("./canvas-Dc1mYCwQ.js"),
-	"bud:tasks": () => import("./tasks-CiXodsLN.js"),
-	"bud:files": () => import("./files-E9mSFeoc.js")
+	"bud:pages": () => import("./pages-KJY_Ba92.js"),
+	"bud:canvas": () => import("./canvas-CJWQ-jjv.js"),
+	"bud:tasks": () => import("./tasks-Bgu5Lg9Y.js"),
+	"bud:files": () => import("./files-CPJqKeMo.js")
 };
 /**
 * Imports a screen module: a built-in by its key, any other by the URL the server gave it.
@@ -365,6 +366,14 @@ function Workspace(handle) {
 				icon: screen.icon
 			};
 		}
+		if (agentViewOpen(href)) {
+			let task = selectedTask(href);
+			if (task) return {
+				href,
+				title: t("app.client.workspace.agentView", { task }),
+				icon: "terminal"
+			};
+		}
 		let last = (match && match.root !== "/" ? pathname.slice(match.root.length) : pathname).split("/").filter(Boolean).at(-1);
 		return {
 			href,
@@ -730,6 +739,97 @@ function createAppController(template, project, runtime) {
 	} });
 }
 //#endregion
+//#region app/server/comment-task.ts
+var titleLength = 120;
+/**
+* A task's title and description for a discussion: what it asks, where it was made, what it points
+* at and how to get back to it, in the request's language.
+* @param thread - The discussion, with its messages loaded.
+* @param schema - The task store's fields; title and description go where their roles are.
+* @param routes - The project's routes, for page titles.
+* @param found - The element at the comment's point, when the comment didn't keep one.
+* @returns Field values for a new task.
+*/
+function commentTaskValues(thread, schema, routes, found = null) {
+	let first = thread.messages[0];
+	let place = commentPlace(thread, routes);
+	let line = first?.body.split("\n").find((text) => text.trim())?.trim() ?? "";
+	let title = (line.length > titleLength ? `${line.slice(0, 119).trimEnd()}…` : line) || t("app.server.commentTask.title", { place });
+	let values = {};
+	let titleField = fieldByRole(schema, "title");
+	if (titleField) values[titleField.id] = title;
+	let descriptionField = fieldByRole(schema, "description");
+	if (descriptionField) values[descriptionField.id] = commentTaskDescription(thread, place, found);
+	return values;
+}
+function commentPlace(thread, routes) {
+	let anchor = thread.anchor;
+	if (!anchor) return t("app.server.commentTask.linkedTasks");
+	if ("type" in anchor) return `${anchor.path}:${anchor.startLine}–${anchor.endLine}`;
+	let route = routes.find((candidate) => candidate.id === anchor.pageId);
+	return route && route.title !== anchor.pagePath ? `${route.title} (${anchor.pagePath})` : anchor.pagePath;
+}
+function commentTaskDescription(thread, place, found) {
+	let first = thread.messages[0];
+	let lines = [];
+	if (first) {
+		lines.push(...first.body.split("\n").map((text) => `> ${text}`));
+		lines.push(`>`, `> — ${first.author.name}, ${first.createdAt.slice(0, 10)}`, "");
+	}
+	let anchor = thread.anchor;
+	let where = [place];
+	if (anchor && "type" in anchor) where.push(anchor.commit ? anchor.commit.slice(0, 8) : t("app.server.commentTask.uncommitted"));
+	else if (anchor) {
+		where.push(`${anchor.viewport}px`);
+		where.push(anchor.branch ?? t("app.server.commentTask.workingTree"));
+	}
+	lines.push(`**${t("app.server.commentTask.where")}:** ${where.join(" · ")}`);
+	let element = (anchor && !("type" in anchor) ? anchor.element : null) ?? found;
+	if (element) {
+		let label = element.label || element.breadcrumb;
+		lines.push(`**${t("app.server.commentTask.element")}:** ${label} (\`${element.tagName}\`)`);
+		let source = element.source;
+		if (source?.file) lines.push(`**${t("app.server.commentTask.source")}:** \`${source.file}${source.line ? `:${source.line}` : ""}\`${source.component ? ` (${source.component})` : ""}`);
+	}
+	if (anchor && "type" in anchor && anchor.context.selected.length) lines.push("", "```", ...anchor.context.selected, "```");
+	if (thread.messageCount > 1) lines.push(`**${t("app.server.commentTask.replies")}:** ${t("app.server.commentTask.replyCount", { count: thread.messageCount - 1 })}`);
+	lines.push(`**${t("app.server.commentTask.discussion")}:** [/comments/${thread.id}](/comments/${encodeURIComponent(thread.id)})`);
+	return lines.join("\n");
+}
+/**
+* Where a task made from a discussion came from, kept with the task for its page and its agent.
+* @param thread - The discussion.
+* @param routes - The project's routes, for page titles.
+* @param given - What the canvas found: the element and point, and the screenshot's hash.
+* @returns The task's context.
+*/
+function commentTaskContext(thread, routes, given) {
+	let anchor = thread.anchor;
+	let code = anchor && "type" in anchor ? anchor : null;
+	let canvas = anchor && !("type" in anchor) ? anchor : null;
+	let route = canvas ? routes.find((candidate) => candidate.id === canvas.pageId) : void 0;
+	return {
+		version: 1,
+		thread: thread.id,
+		page: canvas ? {
+			id: canvas.pageId,
+			path: canvas.pagePath,
+			title: route?.title ?? canvas.pagePath
+		} : null,
+		viewport: canvas?.viewport ?? null,
+		branch: canvas?.branch ?? null,
+		point: canvas ? given.point : null,
+		element: (canvas?.element ?? null) || given.element,
+		image: canvas ? given.image : null,
+		code: code ? {
+			path: code.path,
+			startLine: code.startLine,
+			endLine: code.endLine,
+			commit: code.commit ?? null
+		} : null
+	};
+}
+//#endregion
 //#region app/server/comments.ts
 /** A comment request the server refuses, with the HTTP status to answer it with. */
 var CommentError = class extends TaggedError("CommentError") {
@@ -914,7 +1014,7 @@ function projectApi(options) {
 		if (!runtime) return jsonError("The project services are not running. Restart Bud.", 503);
 		return runtime.runPromise(program(project).pipe(match({
 			onFailure: options.failure,
-			onSuccess: (value) => Response.json(value, { headers })
+			onSuccess: (value) => value instanceof Response ? value : Response.json(value, { headers })
 		})), { signal: request.signal });
 	};
 }
@@ -949,7 +1049,7 @@ function parseQuery(request, schema, allowed) {
 }
 //#endregion
 //#region app/actions/comments/controller.ts
-var statuses$5 = {
+var statuses$6 = {
 	input: 400,
 	unavailable: 503,
 	"not-found": 404,
@@ -1015,7 +1115,7 @@ function createCommentsController(project, runtime) {
 		project,
 		runtime,
 		missing: "Connect a project with the Bud Vite plugin to use comments.",
-		failure: (error) => error._tag === "WorkError" ? jsonError(error.message, statuses$5[error.reason], {
+		failure: (error) => error._tag === "WorkError" ? jsonError(error.message, statuses$6[error.reason], {
 			code: error.reason,
 			...error.currentRevision ? { currentRevision: error.currentRevision } : {}
 		}) : jsonError(error.message, error.status)
@@ -1114,6 +1214,39 @@ function createCommentsController(project, runtime) {
 		unlink({ request, params }) {
 			return respond(request, (project) => written(link(request, project, params.id, true)));
 		},
+		makeTask({ request, params }) {
+			return respond(request, (project) => written(gen(function* () {
+				let id = yield* input$2(() => parseThreadId(params.id));
+				let body = yield* readProjectJsonBody(request, { maxBytes: 32e5 });
+				let given = parseTaskContextInput(body && typeof body === "object" && "context" in body ? body.context : null);
+				let threads = yield* writable(project.root, "link");
+				let thread = yield* threads.get(project.root, id).pipe(flatMap((value) => result(() => parseThread(value))));
+				let image = given.image ? yield* (yield* Attachments).put(given.image).pipe(orElseSucceed(() => null)) : null;
+				let context = commentTaskContext(thread, project.config.routes, {
+					...given,
+					image
+				});
+				let tasks = yield* selected$1(project.root);
+				let work = yield* ready(tasks);
+				if (!tasks.schema.capabilities.create) return yield* new WorkError({
+					reason: "refused",
+					message: "The task store does not support creating tasks."
+				});
+				let draft = yield* input$2(() => parseWorkCreate({ values: commentTaskValues(thread, tasks.schema, project.config.routes, context.element) }, tasks.schema));
+				let created = yield* work.create(project.root, draft).pipe(flatMap((value) => result(() => parseWorkMutationResult(value, tasks.schema), true)));
+				let task = created.item.id;
+				if (work.writeItemData && created.item.revision) yield* ignore(work.writeItemData(project.root, task, "budContext", context, created.item.revision));
+				let linked = yield* threads.link(project.root, id, [task], thread.revision ?? "").pipe(flatMap((value) => result(() => parseThread(value), true)), mapError((cause) => new WorkError({
+					reason: "uncertain",
+					message: `Task ${task} was created, but linking it to this discussion could not be confirmed. Link it from the task before trying again.`,
+					cause
+				})));
+				return {
+					item: created.item,
+					thread: linked
+				};
+			})));
+		},
 		deleteMessage({ request, params }) {
 			return respond(request, (project) => written(gen(function* () {
 				let id = yield* input$2(() => parseThreadId(params.id));
@@ -1156,6 +1289,544 @@ function createCommentsController(project, runtime) {
 	} });
 }
 //#endregion
+//#region app/server/agent-tools.ts
+/** The task database's tools, as MCP lists them; all of them only read. */
+var AGENT_TOOLS = [
+	{
+		name: "search_tasks",
+		description: "Searches the project's tasks by words in their title or description, and by status. Use it to find related tasks, duplicates and earlier decisions.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				query: {
+					type: "string",
+					description: "Words to look for."
+				},
+				status: {
+					type: "string",
+					description: "Only tasks with this status, such as open."
+				},
+				limit: {
+					type: "number",
+					description: "At most this many; 20 by default, 50 at most."
+				}
+			}
+		}
+	},
+	{
+		name: "get_task",
+		description: "Reads one task: its fields, relations and the discussions linked to it.",
+		inputSchema: {
+			type: "object",
+			properties: { id: {
+				type: "string",
+				description: "The task id."
+			} },
+			required: ["id"]
+		}
+	},
+	{
+		name: "list_discussions",
+		description: "Lists the project's discussions, such as comments on a page of the site, with their first message and the tasks they link.",
+		inputSchema: {
+			type: "object",
+			properties: {
+				page: {
+					type: "string",
+					description: "Only comments on this page path, such as /pricing."
+				},
+				task: {
+					type: "string",
+					description: "Only discussions linked to this task id."
+				}
+			}
+		}
+	},
+	{
+		name: "recent_changes",
+		description: "Lists the tasks changed most recently, newest first.",
+		inputSchema: {
+			type: "object",
+			properties: { limit: {
+				type: "number",
+				description: "At most this many; 20 by default."
+			} }
+		}
+	}
+];
+function text(value, max = 2e3) {
+	return typeof value === "string" ? value.slice(0, max) : void 0;
+}
+function brief(item, schema) {
+	return {
+		id: item.id,
+		title: text(valueByRole(item, schema, "title"), 300),
+		status: text(valueByRole(item, schema, "status"), 100),
+		updated: text(valueByRole(item, schema, "updated"), 100)
+	};
+}
+function discussion(thread, messages = 1) {
+	let anchor = thread.anchor;
+	return {
+		id: thread.id,
+		status: thread.status,
+		page: anchor && !("type" in anchor) ? anchor.pagePath : void 0,
+		file: anchor && "type" in anchor ? anchor.path : void 0,
+		tasks: thread.itemIds,
+		messageCount: thread.messageCount,
+		messages: thread.messages.slice(0, messages).map((message) => ({
+			author: message.author.name,
+			at: message.createdAt,
+			body: message.body.slice(0, 4e3)
+		}))
+	};
+}
+function count(value, fallback, max) {
+	return typeof value === "number" && Number.isInteger(value) && value > 0 ? Math.min(value, max) : fallback;
+}
+/**
+* Runs one of the task database's tools.
+* @param stores - The project's stores.
+* @param name - The tool.
+* @param args - Its arguments, untrusted.
+* @returns What it found, as JSON-ready data.
+*/
+function callAgentTool(stores, name, args) {
+	let { root, work, threads } = stores;
+	return gen(function* () {
+		let schema = yield* work.schema(root);
+		if (name === "search_tasks") return { tasks: (yield* work.list(root, {
+			...text(args.query, 200) ? { search: text(args.query, 200) } : {},
+			...text(args.status, 100) ? { status: text(args.status, 100) } : {},
+			limit: count(args.limit, 20, 50)
+		})).items.map((item) => brief(item, schema)) };
+		if (name === "get_task") {
+			let id = text(args.id, 200);
+			if (!id) return yield* new WorkError({
+				reason: "input",
+				message: "Name the task with id."
+			});
+			let detail = yield* work.get(root, id);
+			let linked = threads ? (yield* threads.list(root, { itemId: id })).threads : [];
+			return {
+				...brief(detail.item, schema),
+				description: text(valueByRole(detail.item, schema, "description"), 2e4),
+				fields: Object.fromEntries(schema.fields.filter((field) => detail.item.values[field.id] !== void 0).map((field) => [field.label, detail.item.values[field.id]])),
+				relations: detail.item.relations,
+				discussions: linked.map((thread) => discussion(thread, 20))
+			};
+		}
+		if (name === "list_discussions") {
+			if (!threads) return { discussions: [] };
+			let page = text(args.page, 1e3);
+			let task = text(args.task, 200);
+			return { discussions: (yield* threads.list(root, {
+				...page ? { pagePath: page } : {},
+				...task ? { itemId: task } : {}
+			})).threads.slice(0, 100).map((thread) => discussion(thread)) };
+		}
+		if (name === "recent_changes") return { tasks: (yield* work.list(root, { limit: 500 })).items.map((item) => brief(item, schema)).sort((left, right) => (right.updated ?? "").localeCompare(left.updated ?? "")).slice(0, count(args.limit, 20, 100)) };
+		return yield* new WorkError({
+			reason: "input",
+			message: `No tool ${name}.`
+		});
+	});
+}
+function answer(id, result) {
+	return {
+		jsonrpc: "2.0",
+		id,
+		result
+	};
+}
+function failure$3(id, code, message) {
+	return {
+		jsonrpc: "2.0",
+		id: id ?? null,
+		error: {
+			code,
+			message
+		}
+	};
+}
+/**
+* Answers MCP's JSON-RPC messages for the task database: initialize, ping, the tool list and
+* tool calls. Notifications get no answer.
+* @param stores - The project's stores.
+* @param body - The request body, untrusted.
+* @returns The response body, or null when every message was a notification.
+*/
+function answerAgentTools(stores, body) {
+	let one = (message) => {
+		if (!message || typeof message !== "object" || typeof message.method !== "string") return succeed(failure$3(message?.id, -32600, "Invalid request."));
+		let id = message.id;
+		let notification = id === void 0;
+		let params = message.params ?? {};
+		switch (message.method) {
+			case "initialize": return succeed(answer(id, {
+				protocolVersion: typeof params.protocolVersion === "string" ? params.protocolVersion : "2025-06-18",
+				capabilities: { tools: { listChanged: false } },
+				serverInfo: {
+					name: "bud-tasks",
+					version: "1.0.0"
+				},
+				instructions: "Read-only access to this project's tasks and discussions, for finding related work and earlier decisions."
+			}));
+			case "ping": return succeed(notification ? null : answer(id, {}));
+			case "tools/list": return succeed(answer(id, { tools: AGENT_TOOLS }));
+			case "tools/call": return callAgentTool(stores, typeof params.name === "string" ? params.name : "", params.arguments && typeof params.arguments === "object" ? params.arguments : {}).pipe(match({
+				onSuccess: (result) => answer(id, { content: [{
+					type: "text",
+					text: JSON.stringify(result, null, 2)
+				}] }),
+				onFailure: (error) => answer(id, {
+					content: [{
+						type: "text",
+						text: error.message
+					}],
+					isError: true
+				})
+			}));
+			default: return succeed(notification ? null : failure$3(id, -32601, `No method ${message.method}.`));
+		}
+	};
+	if (Array.isArray(body)) return map(forEach(body.slice(0, 20), one), (answers) => {
+		let given = answers.filter((value) => value !== null);
+		return given.length ? given : null;
+	});
+	return one(body);
+}
+//#endregion
+//#region app/actions/agent-api/controller.ts
+var json = (body, status = 200) => Response.json(body, {
+	status,
+	headers: { "Cache-Control": "no-store" }
+});
+/**
+* Serves the task database agents read in their sandboxes, as an MCP server over HTTP: only a
+* running run's token lets an agent in, and it can only read.
+* @param project - The trusted consuming project.
+* @param runtime - The companion's runtime with its stores and runs.
+* @returns The agent controller.
+*/
+function createAgentController(project, runtime) {
+	return createController(routes.agentApi, { actions: {
+		tasksStream() {
+			return new Response(null, {
+				status: 405,
+				headers: { Allow: "POST" }
+			});
+		},
+		tasks({ request }) {
+			if (!project || !runtime) return json({ error: "No project is connected." }, 404);
+			let token = /^Bearer (\S{1,2000})$/.exec(request.headers.get("Authorization") ?? "")?.[1];
+			if (!token) return json({ error: "Send the run’s token." }, 401);
+			return runtime.runPromise(gen(function* () {
+				if (!(yield* (yield* FactoryRuns).agentTask(token))) return json({ error: "This token’s run is over or unknown." }, 401);
+				let { work, threads } = yield* AdapterRegistry;
+				if (!work) return json({ error: "Task storage is off." }, 503);
+				let body = yield* readProjectJsonBody(request, { maxBytes: 64e3 });
+				let answer = yield* answerAgentTools({
+					root: project.root,
+					work,
+					threads
+				}, body);
+				return answer === null ? new Response(null, { status: 202 }) : json(answer);
+			}).pipe(catch_((error) => succeed(json({ error: error.message }, "status" in error ? error.status : 500)))), { signal: request.signal });
+		}
+	} });
+}
+//#endregion
+//#region app/actions/factory-api/controller.ts
+var TERMINAL_SESSIONS = [
+	"agent",
+	"dev",
+	"shell"
+];
+var statuses$5 = {
+	input: 400,
+	unavailable: 503,
+	"not-found": 404,
+	conflict: 409,
+	refused: 422,
+	timeout: 504,
+	uncertain: 409,
+	storage: 500
+};
+/**
+* Compares the factory's statuses with the task store's.
+* @param factory - The factory config.
+* @param schema - The task store's schema.
+* @param canAdd - Whether the store can add statuses.
+* @returns What is missing and whether adding fixes it.
+*/
+function factoryReadiness(factory, schema, canAdd) {
+	let problems = [];
+	for (let role of FACTORY_STATUS_ROLES) {
+		let value = factory.statuses[role];
+		let category = FACTORY_STATUS_CATEGORIES[role];
+		let status = schema.statuses.find((entry) => entry.value === value);
+		if (!status) problems.push({
+			role,
+			value,
+			category,
+			reason: "missing"
+		});
+		else if (status.category !== category) problems.push({
+			role,
+			value,
+			category,
+			reason: "category"
+		});
+	}
+	return {
+		enabled: true,
+		ready: !problems.length,
+		message: null,
+		problems,
+		canAdd: canAdd && problems.length > 0 && problems.every((problem) => problem.reason === "missing"),
+		statuses: factory.statuses
+	};
+}
+var off = {
+	enabled: false,
+	ready: false,
+	message: null,
+	problems: [],
+	canAdd: false,
+	statuses: null
+};
+/**
+* Serves the factory's readiness and sets up its statuses in the task store.
+* @param project - The trusted consuming project.
+* @param runtime - The companion's runtime with the selected adapters.
+* @returns The factory controller.
+*/
+function createFactoryController(project, runtime) {
+	let api = projectApi({
+		project,
+		runtime,
+		missing: "Connect a project with the Bud Vite plugin to use the factory.",
+		failure: (error) => error._tag === "WorkError" ? jsonError(error.message, statuses$5[error.reason], { code: error.reason }) : jsonError(error.message, error.status)
+	});
+	let taskId = (value) => /^[\w.:-]{1,200}$/.test(value) ? succeed(value) : fail$1(new WorkError({
+		reason: "input",
+		message: "Invalid task id."
+	}));
+	let person = (root) => map(commentAuthor(root), (author) => ({
+		name: author.name,
+		email: author.email
+	}));
+	function act(request, id, operation) {
+		return api(request, (project) => gen(function* () {
+			let task = yield* taskId(id);
+			return { run: yield* operation(yield* FactoryRuns, project, task) };
+		}));
+	}
+	function readiness(project) {
+		return gen(function* () {
+			let factory = project.config.factory;
+			if (!factory) return off;
+			let tasks = yield* selected$1(project.root);
+			if (!tasks.service || tasks.connection.state !== "ready") return {
+				...off,
+				enabled: true,
+				message: tasks.connection.state === "ready" ? "Task storage is off, so the factory has nowhere to keep its tasks." : tasks.connection.message ?? "Task storage is unavailable."
+			};
+			return factoryReadiness(factory, tasks.schema, Boolean(tasks.service.addStatuses));
+		});
+	}
+	let terminals = /* @__PURE__ */ new Map();
+	let bridge = (task, session) => gen(function* () {
+		if (!TERMINAL_SESSIONS.includes(session)) return yield* new WorkError({
+			reason: "not-found",
+			message: "No such terminal."
+		});
+		let cached = terminals.get(task);
+		let terminal = cached && cached.until > Date.now() ? cached.value : yield* (yield* FactoryRuns).terminal(task);
+		if (!terminal) return yield* new WorkError({
+			reason: "not-found",
+			message: "This run has no terminal; it starts with the run’s sandbox."
+		});
+		terminals.set(task, {
+			value: terminal,
+			until: Date.now() + 3e4
+		});
+		let call = (path, init = {}) => tryPromise({
+			try: async () => {
+				let url = new URL(terminal.url);
+				let [pathname, query = ""] = path.split("?");
+				url.pathname = `${url.pathname.replace(/\/$/, "")}${pathname}`;
+				for (let [key, value] of new URLSearchParams(query)) url.searchParams.set(key, value);
+				let response = await fetch(url, {
+					...init,
+					headers: {
+						...terminal.headers,
+						Authorization: `Basic ${btoa(`bud:${terminal.password}`)}`,
+						...init.headers
+					}
+				});
+				if (!response.ok && response.status !== 204) throw new Error(`The terminal answered ${response.status}.`);
+				return response;
+			},
+			catch: (cause) => {
+				terminals.delete(task);
+				return new WorkError({
+					reason: "unavailable",
+					message: "The terminal isn’t answering; its sandbox may be waking.",
+					cause
+				});
+			}
+		});
+		return {
+			name: session,
+			terminal,
+			call
+		};
+	});
+	let size = (value, fallback) => typeof value === "number" && Number.isInteger(value) && value >= 2 && value <= 1e3 ? value : fallback;
+	return createController(routes.factoryApi, { actions: {
+		status({ request }) {
+			return api(request, readiness);
+		},
+		run({ request, params }) {
+			return act(request, params.id, (runs, _project, task) => runs.get(task));
+		},
+		start({ request, params }) {
+			return act(request, params.id, (runs, project, task) => flatMap(person(project.root), (by) => runs.start(task, by)));
+		},
+		changes({ request, params }) {
+			return act(request, params.id, (runs, project, task) => gen(function* () {
+				let body = yield* readProjectJsonBody(request, { maxBytes: 64e3 });
+				let message = body && typeof body === "object" && "message" in body && typeof body.message === "string" ? body.message.trim() : "";
+				if (!message || message.length > 1e4) return yield* new WorkError({
+					reason: "input",
+					message: "Write what should change."
+				});
+				return yield* runs.changes(task, message, yield* person(project.root));
+			}));
+		},
+		answer({ request, params }) {
+			return act(request, params.id, (runs, project, task) => gen(function* () {
+				let body = yield* readProjectJsonBody(request, { maxBytes: 64e3 });
+				let message = body && typeof body === "object" && "message" in body && typeof body.message === "string" ? body.message.trim() : "";
+				if (!message || message.length > 1e4) return yield* new WorkError({
+					reason: "input",
+					message: "Write your answer."
+				});
+				return yield* runs.answer(task, message, yield* person(project.root));
+			}));
+		},
+		approve({ request, params }) {
+			return act(request, params.id, (runs, project, task) => flatMap(person(project.root), (by) => runs.approve(task, by)));
+		},
+		discard({ request, params }) {
+			return act(request, params.id, (runs, _project, task) => runs.discard(task));
+		},
+		retry({ request, params }) {
+			return act(request, params.id, (runs, _project, task) => runs.retry(task));
+		},
+		wake({ request, params }) {
+			return act(request, params.id, (runs, _project, task) => runs.wake(task));
+		},
+		preview({ request, params }) {
+			return api(request, () => gen(function* () {
+				let task = yield* taskId(params.id);
+				return { preview: yield* (yield* FactoryRuns).preview(task) };
+			}));
+		},
+		touch({ request, params }) {
+			return api(request, () => gen(function* () {
+				yield* (yield* FactoryRuns).touch(yield* taskId(params.id));
+				return { ok: true };
+			}));
+		},
+		terminal({ request, params }) {
+			return api(request, () => gen(function* () {
+				let task = yield* taskId(params.id);
+				let { name, terminal, call } = yield* bridge(task, params.session);
+				let session = terminal.sessions[name];
+				if (!session) return yield* new WorkError({
+					reason: "not-found",
+					message: name === "agent" ? "This run’s agent has no interface to attach to." : "This run has no dev server."
+				});
+				let query = new URL(request.url).searchParams;
+				yield* call("/open", {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						id: name,
+						command: session.command,
+						env: session.env,
+						cols: size(Number(query.get("cols")), 80),
+						rows: size(Number(query.get("rows")), 24)
+					})
+				});
+				yield* ignore((yield* FactoryRuns).touch(task));
+				let stream = yield* call(`/stream?id=${name}&from=${Math.max(0, Number(query.get("from")) || 0)}`, { signal: request.signal });
+				return new Response(stream.body, { headers: {
+					"Content-Type": "text/event-stream",
+					"Cache-Control": "no-store",
+					"X-Content-Type-Options": "nosniff"
+				} });
+			}));
+		},
+		terminalInput({ request, params }) {
+			return api(request, () => gen(function* () {
+				let task = yield* taskId(params.id);
+				let body = yield* readProjectJsonBody(request, { maxBytes: 64e3 });
+				let data = body && typeof body === "object" && "data" in body ? body.data : null;
+				if (typeof data !== "string" || data.length > 32e3) return yield* new WorkError({
+					reason: "input",
+					message: "Invalid input."
+				});
+				let { name, call } = yield* bridge(task, params.session);
+				yield* call(`/input?id=${name}`, {
+					method: "POST",
+					body: data
+				});
+				return { ok: true };
+			}));
+		},
+		terminalResize({ request, params }) {
+			return api(request, () => gen(function* () {
+				let task = yield* taskId(params.id);
+				let body = yield* readProjectJsonBody(request, { maxBytes: 1e3 });
+				let { name, call } = yield* bridge(task, params.session);
+				yield* call(`/resize?id=${name}`, {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						cols: size(body?.cols, 80),
+						rows: size(body?.rows, 24)
+					})
+				});
+				return { ok: true };
+			}));
+		},
+		addStatuses({ request }) {
+			return api(request, (project) => gen(function* () {
+				let current = yield* readiness(project);
+				if (!current.enabled) return yield* new WorkError({
+					reason: "refused",
+					message: "The factory is off."
+				});
+				if (current.ready) return current;
+				if (!current.canAdd) return yield* new WorkError({
+					reason: "refused",
+					message: current.message ?? "The task store can’t add these statuses; set them up in the store or map other ones in factory.statuses."
+				});
+				let tasks = yield* selected$1(project.root);
+				yield* (yield* ready(tasks)).addStatuses(project.root, current.problems.map((problem) => ({
+					value: problem.value,
+					category: problem.category
+				}))).pipe(ensuring(StoreActivity.use((activity) => activity.notify("work"))));
+				return yield* readiness(project);
+			}));
+		}
+	} });
+}
+//#endregion
 //#region app/actions/tasks-api/controller.ts
 var statuses$4 = {
 	input: 400,
@@ -1242,6 +1913,29 @@ function createTasksController(project, runtime) {
 		}));
 	}
 	return createController(routes.tasksApi, { actions: {
+		context({ request, params }) {
+			return respond(request, (project) => gen(function* () {
+				let id = yield* validate(() => parseWorkItemRef({ id: params.id }).id, "input");
+				let current = yield* selected$1(project.root);
+				let service = yield* ready(current);
+				if (!service.readItemData) return { context: null };
+				let { value } = yield* service.readItemData(project.root, id, "budContext");
+				return { context: parseTaskContext(value) };
+			}));
+		},
+		attachment({ request, params }) {
+			return respond(request, () => gen(function* () {
+				let bytes = yield* (yield* Attachments).get(params.hash);
+				if (!bytes) return yield* new WorkError({
+					reason: "not-found",
+					message: "No such image."
+				});
+				return new Response(bytes, { headers: {
+					"Content-Type": "image/jpeg",
+					"Cache-Control": "private, max-age=31536000, immutable"
+				} });
+			}));
+		},
 		schema({ request }) {
 			return respond(request, (project) => read(project.root, (reader) => inspect(reader).pipe(map(({ schema }) => schema))));
 		},
@@ -1957,6 +2651,8 @@ function createApp(template, publicDirectory, project, runtime) {
 	router.map(routes, createAppController(template, project, runtime));
 	router.map(routes.comments, createCommentsController(project, runtime));
 	router.map(routes.tasksApi, createTasksController(project, runtime));
+	router.map(routes.factoryApi, createFactoryController(project, runtime));
+	router.map(routes.agentApi, createAgentController(project, runtime));
 	router.map(routes.filesApi, createFilesController(project, runtime));
 	router.map(routes.fileSearchApi, createFileSearchController(project, runtime));
 	router.map(routes.fileReviewApi, createFileReviewController(project, runtime));