@agimon-ai/po-git 0.0.0-alpha.78 → 0.0.0-alpha.79

package/dist/extensions/server.mjs

@@ -7,6 +7,8 @@ import { composeRootHooks, composeRootInjects, defineChannel, defineHook, define
 import { PO_CODEMODE_SERVICE, readPoCodemode } from "@agimon-ai/po-core/codemode";
 import { readPoSessionDelivery } from "@agimon-ai/po-session";
 import { Type } from "typebox";
+import { BACKGROUND_CONTEXT, PO_SHELL_SERVICE, requirePoShell, withAbortSignal } from "@agimon-ai/po-core/platform";
+import { poApiCallerFrom } from "@agimon-ai/po-core/packageApi";
 //#region src/schemas/runWorktreeTool.ts
 /**
 * The tool's action vocabulary.
@@ -1285,177 +1287,236 @@ function failed(error) {
 	}, { status: error.retryable ? 503 : 409 });
 	return Response.json({ error: "The worktree operation failed." }, { status: 500 });
 }
-//#endregion
-//#region src/extensions/(backend)/api/git/route.server.ts
-var route_server_default = defineRoute({
-	basePath: "git",
-	start(context) {
-		if (context.directEvents === void 0) throw new Error("Git hub API requires the direct event bus.");
-		const directEvents = context.directEvents;
-		const publishLifecycle = (sessionId, repositoryRoot) => {
-			directEvents.publish(GIT_WORKTREE_LIFECYCLE_EVENT, sessionId, {
-				version: 1,
-				repositoryRoot
+function createGitApi(openDirectory) {
+	return {
+		basePath: "git",
+		start(context) {
+			if (context.directEvents === void 0) throw new Error("Git hub API requires the direct event bus.");
+			const directEvents = context.directEvents;
+			const publishLifecycle = (sessionId, repositoryRoot) => {
+				directEvents.publish(GIT_WORKTREE_LIFECYCLE_EVENT, sessionId, {
+					version: 1,
+					repositoryRoot
+				});
+			};
+			const git = createWorktreeGit();
+			const operations = createWorktreeOperations({
+				git,
+				sessionService: context.sessionService,
+				...context.homeDirectory === void 0 ? {} : { homeDir: context.homeDirectory }
 			});
-		};
-		const git = createWorktreeGit();
-		const operations = createWorktreeOperations({
-			git,
-			sessionService: context.sessionService,
-			...context.homeDirectory === void 0 ? {} : { homeDir: context.homeDirectory }
-		});
-		/**
-		* The new-session dialog's routes: the workspace's branches, and a top-level
-		* worktree session on one. Workspace-mounted only, and always rooted at the
-		* mount's own workspace, so a request can never name another directory.
-		*/
-		const newSession = async (request, url) => {
-			const isBranches = request.method === "GET" && url.pathname === "/branches";
-			const isCreate = request.method === "POST" && url.pathname === "/sessions";
-			if (!isBranches && !isCreate) return void 0;
-			const workspaceRoot = context.scope === "workspace" ? context.workspaceRoot : void 0;
-			if (workspaceRoot === void 0) return Response.json({ error: "This route belongs to a workspace." }, { status: 404 });
-			if (isBranches) {
-				const repositoryRoot = await git.repositoryRoot(workspaceRoot);
-				const branches = repositoryRoot === void 0 ? {
-					repository: false,
-					local: [],
-					remote: []
-				} : {
-					repository: true,
-					...await git.listBranches(repositoryRoot)
+			/**
+			* The new-session dialog's routes: the workspace's branches, and a top-level
+			* worktree session on one. Workspace-mounted only, and always rooted at the
+			* mount's own workspace, so a request can never name another directory.
+			*/
+			const newSession = async (request, url) => {
+				const isBranches = request.method === "GET" && url.pathname === "/branches";
+				const isCreate = request.method === "POST" && url.pathname === "/sessions";
+				const isDelete = request.method === "DELETE" && url.pathname === "/branches";
+				const isOpen = request.method === "POST" && url.pathname === `/branches/open`;
+				if (!isBranches && !isCreate && !isDelete && !isOpen) return void 0;
+				const workspaceRoot = context.scope === "workspace" ? context.workspaceRoot : void 0;
+				if (workspaceRoot === void 0) return Response.json({ error: "This route belongs to a workspace." }, { status: 404 });
+				if (isBranches) {
+					const repositoryRoot = await git.repositoryRoot(workspaceRoot);
+					const branches = repositoryRoot === void 0 ? {
+						repository: false,
+						local: [],
+						remote: []
+					} : {
+						repository: true,
+						...await git.listBranches(repositoryRoot)
+					};
+					return Response.json(branches);
+				}
+				if (isDelete || isOpen) {
+					if (isOpen && poApiCallerFrom(request.headers)?.locality !== "local") return Response.json({ error: "Opening Finder is only available on the host." }, { status: 403 });
+					const body = await request.json().catch(() => void 0);
+					const branch = typeof body === "object" && body !== null ? body.branch : void 0;
+					if (typeof branch !== "string" || !validRefName(branch)) return badRequest("A valid branch name is required.");
+					const repositoryRoot = await git.repositoryRoot(workspaceRoot);
+					if (repositoryRoot === void 0) return badRequest("This workspace is not a git checkout.");
+					const branches = await git.listBranches(repositoryRoot);
+					const local = branches.local.find((item) => item.name === branch);
+					if (local === void 0) return Response.json({ error: "That local branch no longer exists." }, { status: 404 });
+					if (isOpen) {
+						if (local.checkedOutAt === void 0) return Response.json({ error: "This branch has no checked-out folder." }, { status: 409 });
+						if (openDirectory === void 0) return Response.json({ error: "Finder is not available on this host." }, { status: 409 });
+						try {
+							await openDirectory(local.checkedOutAt);
+							return Response.json({ opened: true });
+						} catch {
+							return Response.json({ error: "The branch folder could not be opened in Finder." }, { status: 409 });
+						}
+					}
+					if (local.checkedOutAt !== void 0 || branches.current === branch) return Response.json({ error: "Close this branch’s worktree before deleting it." }, { status: 409 });
+					if (!await git.deleteBranch({
+						repositoryRoot,
+						branch
+					})) return Response.json({ error: "Git refused to delete this branch. It may contain unmerged commits or be checked out." }, { status: 409 });
+					return Response.json({ deleted: true });
+				}
+				const parsed = newSessionRequest(await request.json().catch(() => void 0));
+				if ("error" in parsed) return badRequest(parsed.error);
+				const record = await operations.spawn({ cwd: workspaceRoot }, {
+					branch: parsed.branch,
+					checkout: parsed.mode === "existing-branch" ? "existing" : "new",
+					...parsed.mode === "existing-branch" && parsed.remote !== void 0 ? { remote: parsed.remote } : {},
+					...parsed.mode === "new-branch" && parsed.baseRef !== void 0 ? { baseRef: parsed.baseRef } : {},
+					...parsed.name === void 0 ? {} : { name: parsed.name }
+				});
+				publishLifecycle(record.sessionId, record.repositoryRoot);
+				const created = {
+					sessionId: record.sessionId,
+					worktreeId: record.id
 				};
-				return Response.json(branches);
-			}
-			const parsed = newSessionRequest(await request.json().catch(() => void 0));
-			if ("error" in parsed) return badRequest(parsed.error);
-			const record = await operations.spawn({ cwd: workspaceRoot }, {
-				branch: parsed.branch,
-				checkout: parsed.mode === "existing-branch" ? "existing" : "new",
-				...parsed.mode === "existing-branch" && parsed.remote !== void 0 ? { remote: parsed.remote } : {},
-				...parsed.mode === "new-branch" && parsed.baseRef !== void 0 ? { baseRef: parsed.baseRef } : {},
-				...parsed.name === void 0 ? {} : { name: parsed.name }
-			});
-			publishLifecycle(record.sessionId, record.repositoryRoot);
-			const created = {
-				sessionId: record.sessionId,
-				worktreeId: record.id
+				return Response.json(created, { status: 201 });
 			};
-			return Response.json(created, { status: 201 });
-		};
-		/** The admitted root for a request, or a response explaining why not. */
-		const rootOf = (url) => {
-			const repositoryId = url.searchParams.get("repositoryId");
-			if (repositoryId === null || repositoryId === "") return badRequest("A repositoryId is required.");
-			const root = context.resolveRepository?.(repositoryId);
-			if (root === void 0) return badRequest("That repository is not admitted to this cockpit.");
-			return root;
-		};
-		const homeDir = context.homeDirectory ?? os.homedir();
-		const gitAuth = createGitAuthStore(homeDir);
-		const branchDiff = createBranchDiff();
-		const pendingReviews = /* @__PURE__ */ new Map();
-		/**
-		* A workspace's remote auth. Workspace mounts only, so the step-up gate on
-		* `PUT /api/workspaces/<id>/plugins/git/auth` is the one way to write it.
-		* The view never carries the token.
-		*/
-		const auth = async (request, url) => {
-			if (url.pathname !== "/auth") return void 0;
-			if (context.scope !== "workspace") return Response.json({ error: "This route belongs to a workspace." }, { status: 404 });
-			if (request.method !== "GET" && request.method !== "PUT") return Response.json({ error: "Use GET or PUT." }, { status: 405 });
-			const root = rootOf(url);
-			if (root instanceof Response) return root;
-			if (request.method === "GET") return Response.json(await gitAuth.view(root));
-			try {
-				return Response.json(await gitAuth.save(root, await request.json().catch(() => void 0)));
-			} catch (error) {
-				if (error instanceof PoGitExpectedError && error.code === "invalid_request") {
-					const text = error.message.replace(/^\[[a-z_]+\] /u, "").replace("\nRecovery: ", " ");
-					return Response.json({
-						error: text,
-						code: error.code
-					}, { status: 400 });
-				}
-				throw error;
-			}
-		};
-		/**
-		* The session's change against its base. Session mounts only, rooted at the
-		* session's own checkout; a file is served only when it is in the change set
-		* computed for the request. Overlapping requests share an in-flight snapshot.
-		*/
-		const review = async (request, url) => {
-			if (url.pathname !== "/review" && url.pathname !== "/review/file") return void 0;
-			const cwd = context.scope === "session" ? context.cwd : void 0;
-			if (cwd === void 0) return Response.json({ error: "This route belongs to a session." }, { status: 404 });
-			if (request.method !== "GET") return Response.json({ error: "Use GET." }, { status: 405 });
-			let recordedBaseRef;
-			try {
-				recordedBaseRef = (await createWorktreeRegistry(await registryFile(cwd, homeDir)).list()).find((record) => record.sessionId === context.sessionId)?.baseRef;
-			} catch {
-				recordedBaseRef = void 0;
-			}
-			const key = JSON.stringify([cwd, recordedBaseRef ?? null]);
-			let pending = pendingReviews.get(key);
-			if (pending === void 0) {
-				pending = branchDiff.review(cwd, recordedBaseRef === void 0 ? {} : { recordedBaseRef }).finally(() => pendingReviews.delete(key));
-				pendingReviews.set(key, pending);
-			}
-			const result = await pending;
-			if (url.pathname === "/review") return Response.json(result?.summary ?? {
-				repository: false,
-				files: []
-			});
-			const filePath = url.searchParams.get("path") ?? "";
-			if (result === void 0 || !result.summary.files.some((file) => file.path === filePath)) return Response.json({ error: "That file is not part of this review." }, { status: 404 });
-			return Response.json(await branchDiff.fileDiff(result, filePath));
-		};
-		return {
-			async fetch(request) {
-				const url = new URL(request.url);
+			/** The admitted root for a request, or a response explaining why not. */
+			const rootOf = (url) => {
+				const repositoryId = url.searchParams.get("repositoryId");
+				if (repositoryId === null || repositoryId === "") return badRequest("A repositoryId is required.");
+				const root = context.resolveRepository?.(repositoryId);
+				if (root === void 0) return badRequest("That repository is not admitted to this cockpit.");
+				return root;
+			};
+			const homeDir = context.homeDirectory ?? context.environment?.HOME;
+			const gitAuth = homeDir === void 0 ? void 0 : createGitAuthStore(homeDir);
+			const branchDiff = createBranchDiff();
+			const pendingReviews = /* @__PURE__ */ new Map();
+			/**
+			* A workspace's remote auth. Workspace mounts only, so the step-up gate on
+			* `PUT /api/workspaces/<id>/plugins/git/auth` is the one way to write it.
+			* The view never carries the token.
+			*/
+			const auth = async (request, url) => {
+				if (url.pathname !== "/auth") return void 0;
+				if (context.scope !== "workspace") return Response.json({ error: "This route belongs to a workspace." }, { status: 404 });
+				if (request.method !== "GET" && request.method !== "PUT") return Response.json({ error: "Use GET or PUT." }, { status: 405 });
+				if (gitAuth === void 0) throw new Error("Git auth requires the admitted host home directory.");
+				const root = rootOf(url);
+				if (root instanceof Response) return root;
+				if (request.method === "GET") return Response.json(await gitAuth.view(root));
 				try {
-					const answered = await newSession(request, url) ?? await auth(request, url) ?? await review(request, url);
-					if (answered !== void 0) return answered;
+					return Response.json(await gitAuth.save(root, await request.json().catch(() => void 0)));
 				} catch (error) {
-					context.onNotice(`git request failed: ${error.name}`);
-					return failed(error);
+					if (error instanceof PoGitExpectedError && error.code === "invalid_request") {
+						const text = error.message.replace(/^\[[a-z_]+\] /u, "").replace("\nRecovery: ", " ");
+						return Response.json({
+							error: text,
+							code: error.code
+						}, { status: 400 });
+					}
+					throw error;
 				}
-				const root = rootOf(url);
-				if (root instanceof Response) return root;
-				const callerContext = {
-					cwd: root,
-					sessionId: url.searchParams.get("sessionId") ?? ""
-				};
-				if ((request.method === "POST" && url.pathname === "/worktrees" || request.method === "DELETE" && /^\/worktrees\/[^/]+$/u.test(url.pathname)) && callerContext.sessionId === "") return badRequest("A sessionId is required for worktree mutations.");
+			};
+			/**
+			* The session's change against its base. Session mounts only, rooted at the
+			* session's own checkout; a file is served only when it is in the change set
+			* computed for the request. Overlapping requests share an in-flight snapshot.
+			*/
+			const review = async (request, url) => {
+				if (url.pathname !== "/review" && url.pathname !== "/review/file") return void 0;
+				const cwd = context.scope === "session" ? context.cwd : void 0;
+				if (cwd === void 0) return Response.json({ error: "This route belongs to a session." }, { status: 404 });
+				if (request.method !== "GET") return Response.json({ error: "Use GET." }, { status: 405 });
+				if (homeDir === void 0) throw new Error("Git review requires the admitted host home directory.");
+				let recordedBaseRef;
 				try {
-					if (request.method === "GET" && url.pathname === "/worktrees") return Response.json({ worktrees: await operations.list(callerContext) });
-					if (request.method === "POST" && url.pathname === "/worktrees") {
-						const body = await request.json();
-						if (typeof body.branch !== "string" || body.branch.trim() === "") return badRequest("A branch is required.");
-						const record = await operations.spawn(callerContext, {
-							branch: body.branch,
-							...body.baseRef === void 0 ? {} : { baseRef: body.baseRef },
-							...body.name === void 0 ? {} : { name: body.name }
-						});
-						publishLifecycle(callerContext.sessionId, record.repositoryRoot);
-						return Response.json({ worktree: record }, { status: 201 });
+					recordedBaseRef = (await createWorktreeRegistry(await registryFile(cwd, homeDir)).list()).find((record) => record.sessionId === context.sessionId)?.baseRef;
+				} catch {
+					recordedBaseRef = void 0;
+				}
+				const key = JSON.stringify([cwd, recordedBaseRef ?? null]);
+				let pending = pendingReviews.get(key);
+				if (pending === void 0) {
+					pending = branchDiff.review(cwd, recordedBaseRef === void 0 ? {} : { recordedBaseRef }).finally(() => pendingReviews.delete(key));
+					pendingReviews.set(key, pending);
+				}
+				const result = await pending;
+				if (url.pathname === "/review") return Response.json(result?.summary ?? {
+					repository: false,
+					files: []
+				});
+				const filePath = url.searchParams.get("path") ?? "";
+				if (result === void 0 || !result.summary.files.some((file) => file.path === filePath)) return Response.json({ error: "That file is not part of this review." }, { status: 404 });
+				return Response.json(await branchDiff.fileDiff(result, filePath));
+			};
+			return {
+				async fetch(request) {
+					const url = new URL(request.url);
+					try {
+						const answered = await newSession(request, url) ?? await auth(request, url) ?? await review(request, url);
+						if (answered !== void 0) return answered;
+					} catch (error) {
+						context.onNotice(`git request failed: ${error.name}`);
+						return failed(error);
 					}
-					const closing = /^\/worktrees\/([^/]+)$/u.exec(url.pathname);
-					if (request.method === "DELETE" && closing) {
-						const record = await operations.close(callerContext, decodeURIComponent(String(closing[1])), url.searchParams.get("force") === "true");
-						publishLifecycle(callerContext.sessionId, record.repositoryRoot);
-						return Response.json({ worktree: record });
+					const root = rootOf(url);
+					if (root instanceof Response) return root;
+					const callerContext = {
+						cwd: root,
+						sessionId: url.searchParams.get("sessionId") ?? ""
+					};
+					if ((request.method === "POST" && url.pathname === "/worktrees" || request.method === "DELETE" && /^\/worktrees\/[^/]+$/u.test(url.pathname)) && callerContext.sessionId === "") return badRequest("A sessionId is required for worktree mutations.");
+					try {
+						if (request.method === "GET" && url.pathname === "/worktrees") return Response.json({ worktrees: await operations.list(callerContext) });
+						if (request.method === "POST" && url.pathname === "/worktrees") {
+							const body = await request.json();
+							if (typeof body.branch !== "string" || body.branch.trim() === "") return badRequest("A branch is required.");
+							const record = await operations.spawn(callerContext, {
+								branch: body.branch,
+								...body.baseRef === void 0 ? {} : { baseRef: body.baseRef },
+								...body.name === void 0 ? {} : { name: body.name }
+							});
+							publishLifecycle(callerContext.sessionId, record.repositoryRoot);
+							return Response.json({ worktree: record }, { status: 201 });
+						}
+						const closing = /^\/worktrees\/([^/]+)$/u.exec(url.pathname);
+						if (request.method === "DELETE" && closing) {
+							const record = await operations.close(callerContext, decodeURIComponent(String(closing[1])), url.searchParams.get("force") === "true");
+							publishLifecycle(callerContext.sessionId, record.repositoryRoot);
+							return Response.json({ worktree: record });
+						}
+						return Response.json({ error: "No such worktree route." }, { status: 404 });
+					} catch (error) {
+						context.onNotice(`worktree request failed: ${error.name}`);
+						return failed(error);
 					}
-					return Response.json({ error: "No such worktree route." }, { status: 404 });
-				} catch (error) {
-					context.onNotice(`worktree request failed: ${error.name}`);
-					return failed(error);
-				}
-			},
-			close() {}
+				},
+				close() {}
+			};
+		}
+	};
+}
+//#endregion
+//#region src/extensions/(backend)/api/git/route.server.ts
+var route_server_default = defineRoute(({ context, host, signal }) => {
+	let openDirectory;
+	context.inject([PO_SHELL_SERVICE], (child) => {
+		const shell = requirePoShell(child);
+		const env = Object.fromEntries(Object.entries(host.context.environment ?? {}).filter((entry) => entry[1] !== void 0));
+		openDirectory = async (path) => {
+			const result = await shell.exec([
+				"/usr/bin/open",
+				"-a",
+				"Finder",
+				path
+			], {
+				env,
+				inheritEnv: false
+			}, withAbortSignal(AbortSignal.any([signal, AbortSignal.timeout(5e3)]), BACKGROUND_CONTEXT));
+			if (!result.ok || result.value.exitCode !== 0) throw new Error("Finder could not be opened.");
 		};
-	}
+		return () => {
+			openDirectory = void 0;
+		};
+	});
+	return createGitApi(async (path) => {
+		if (openDirectory === void 0) throw new Error("The host shell is unavailable.");
+		await openDirectory(path);
+	});
 });
 //#endregion
 //#region src/services/gitFailure/index.ts