From 6b2f69da4e388fb7a2c56c4ac46db40a3827684f Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:05:43 +0000 Subject: [PATCH 1/7] Expose isolated brief approval to authenticated T3 operators --- apps/server/src/isolatedApprovalHttp.test.ts | 66 ++++++++++++ apps/server/src/isolatedApprovalHttp.ts | 102 +++++++++++++++++++ apps/server/src/server.ts | 2 + 3 files changed, 170 insertions(+) create mode 100644 apps/server/src/isolatedApprovalHttp.test.ts create mode 100644 apps/server/src/isolatedApprovalHttp.ts diff --git a/apps/server/src/isolatedApprovalHttp.test.ts b/apps/server/src/isolatedApprovalHttp.test.ts new file mode 100644 index 0000000000000..2aeb7eb3ca5a0 --- /dev/null +++ b/apps/server/src/isolatedApprovalHttp.test.ts @@ -0,0 +1,66 @@ +import { AuthSessionId } from "@t3tools/contracts"; +import * as Effect from "effect/Effect"; +import * as Layer from "effect/Layer"; +import { FetchHttpClient, HttpRouter } from "effect/http"; +import { expect, it, vi } from "vite-plus/test"; + +import { EnvironmentAuth } from "./auth/EnvironmentAuth.ts"; +import { layer } from "./isolatedApprovalHttp.ts"; + +it("forwards only explicit approvals from the configured authenticated operator", async () => { + vi.stubEnv("T3CODE_ISOLATED_APPROVAL_PORT", "45678"); + vi.stubEnv("T3CODE_ISOLATED_APPROVAL_TOKEN", "sidecar-test-token"); + vi.stubEnv("T3CODE_ISOLATED_APPROVAL_SUBJECT", "operator"); + let subject = "different-account"; + const upstream = vi + .spyOn(globalThis, "fetch") + .mockResolvedValue(Response.json({ runId: "existing-run", revision: "a".repeat(64) })); + const { handler, dispose } = HttpRouter.toWebHandler( + layer.pipe( + Layer.provideMerge(FetchHttpClient.layer), + Layer.provideMerge( + Layer.mock(EnvironmentAuth)({ + authenticateHttpRequest: () => + Effect.succeed({ + sessionId: AuthSessionId.make("fixture-session"), + subject, + method: "bearer-access-token", + scopes: ["orchestration:operate"], + }), + }), + ), + ), + { disableLogger: true }, + ); + try { + const send = (body: string, auth?: string) => + handler( + new Request("http://localhost/api/isolated-approval/v1/approve", { + method: "POST", + headers: { + "content-type": "application/json", + "content-length": String(body.length), + ...(auth ? { authorization: auth } : {}), + }, + body, + }), + ); + const body = JSON.stringify({ ticket: "fixture", revision: "a".repeat(64) }); + expect((await send(body)).status).toBe(401); + expect((await send(body, "Bearer t3-session")).status).toBe(403); + subject = "operator"; + expect((await send("{}", "Bearer t3-session")).status).toBe(400); + expect(upstream).not.toHaveBeenCalled(); + expect((await send(body, "Bearer t3-session")).status).toBe(200); + const [url, forwarded] = upstream.mock.calls[0] ?? []; + expect(String(url)).toBe("http://127.0.0.1:45678/isolated-approval/v1/approve"); + expect(forwarded?.redirect).toBe("error"); + expect(new Headers(forwarded?.headers).get("authorization")).toBe("Bearer sidecar-test-token"); + expect(forwarded?.body).toBeInstanceOf(Uint8Array); + expect(new TextDecoder().decode(forwarded?.body as Uint8Array)).toBe(body); + } finally { + await dispose(); + upstream.mockRestore(); + vi.unstubAllEnvs(); + } +}); diff --git a/apps/server/src/isolatedApprovalHttp.ts b/apps/server/src/isolatedApprovalHttp.ts new file mode 100644 index 0000000000000..fe6a9f25101b6 --- /dev/null +++ b/apps/server/src/isolatedApprovalHttp.ts @@ -0,0 +1,102 @@ +/** Isolated operator-only access to the loopback brief approval service. */ +import * as Effect from "effect/Effect"; +import * as Layer from "effect/Layer"; +import * as Option from "effect/Option"; +import * as Schema from "effect/Schema"; +import { + FetchHttpClient, + HttpClient, + HttpClientRequest, + HttpRouter, + HttpServerRequest, + HttpServerResponse, +} from "effect/http"; + +import { EnvironmentAuth } from "./auth/EnvironmentAuth.ts"; + +const ticket = Schema.String.check(Schema.isPattern(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,99}$/)); +const reviewBody = Schema.Struct({ ticket }); +const approveBody = Schema.Struct({ + ticket, + revision: Schema.String.check(Schema.isPattern(/^[a-f0-9]{64}$/)), +}); + +function isolatedConfig() { + return { + port: Number(process.env.T3CODE_ISOLATED_APPROVAL_PORT), + token: process.env.T3CODE_ISOLATED_APPROVAL_TOKEN, + operator: process.env.T3CODE_ISOLATED_APPROVAL_SUBJECT, + }; +} + +const route = (action: "review" | "approve") => + HttpRouter.add( + "POST", + `/api/isolated-approval/v1/${action}`, + Effect.gen(function* () { + const { port, token, operator } = isolatedConfig(); + if (!Number.isInteger(port) || port < 1 || port > 65535 || !token || !operator) { + return HttpServerResponse.empty({ status: 404 }); + } + + const request = yield* HttpServerRequest.HttpServerRequest; + if (!/^Bearer \S+$/i.test(request.headers.authorization ?? "")) { + return HttpServerResponse.empty({ status: 401 }); + } + const auth = yield* EnvironmentAuth; + const session = yield* auth.authenticateHttpRequest(request).pipe(Effect.option); + if (Option.isNone(session)) { + return HttpServerResponse.empty({ status: 401 }); + } + if ( + session.value.subject !== operator || + !session.value.scopes.includes("orchestration:operate") + ) { + return HttpServerResponse.empty({ status: 403 }); + } + + const length = Number(request.headers["content-length"]); + if ( + !Number.isInteger(length) || + length < 1 || + length > 8192 || + request.headers["content-encoding"] !== undefined || + request.headers["content-type"]?.split(";")[0]?.trim().toLowerCase() !== "application/json" + ) { + return HttpServerResponse.empty({ status: 400 }); + } + const body = yield* request.json.pipe(Effect.option); + if (Option.isNone(body)) { + return HttpServerResponse.empty({ status: 400 }); + } + const schema = action === "review" ? reviewBody : approveBody; + const input = Schema.decodeUnknownOption(schema)(body.value); + if (Option.isNone(input)) { + return HttpServerResponse.empty({ status: 400 }); + } + const client = yield* HttpClient.HttpClient; + const response = yield* HttpClientRequest.post( + `http://127.0.0.1:${port}/isolated-approval/v1/${action}`, + ).pipe( + HttpClientRequest.setHeader("authorization", `Bearer ${token}`), + HttpClientRequest.bodyJson(input.value), + Effect.flatMap((outbound) => client.execute(outbound)), + Effect.flatMap((result) => + Effect.map(result.text, (body) => ({ status: result.status, body })), + ), + Effect.provideService(FetchHttpClient.RequestInit, { redirect: "error" }), + Effect.timeout("15 seconds"), + Effect.option, + ); + if (Option.isNone(response) || ![200, 409].includes(response.value.status)) { + return HttpServerResponse.empty({ status: 502, headers: { "cache-control": "no-store" } }); + } + return HttpServerResponse.text(response.value.body, { + status: response.value.status, + contentType: "application/json", + headers: { "cache-control": "no-store" }, + }); + }), + ); + +export const layer = Layer.mergeAll(route("review"), route("approve")); diff --git a/apps/server/src/server.ts b/apps/server/src/server.ts index 47c4a4c9a20ec..23e91d378a3a3 100644 --- a/apps/server/src/server.ts +++ b/apps/server/src/server.ts @@ -33,6 +33,7 @@ import * as NonBlockingSpawner from "./process/NonBlockingSpawner.ts"; import * as KeepAwake from "./background/KeepAwake.ts"; import * as ServerConfig from "./config.ts"; import { withUntracedRequests } from "./http.ts"; +import * as IsolatedApprovalHttp from "./isolatedApprovalHttp.ts"; import * as ServerHttp from "./http.ts"; import { guardHttpResponseWriteErrors, @@ -837,6 +838,7 @@ const layerMakeRoutes = Layer.mergeAll( Layer.provide(WebhookRoute.layer.pipe(Layer.provide(RelayDeliveryProof.layer))), Layer.provide(AuthHttp.layerAuthenticatedAuth), ), + IsolatedApprovalHttp.layer, ServerHttp.layerOtlpTracesProxyRoute, ServerHttp.layerAssetRoute, ServerHttp.layerAttachmentUploadRoute, From e07fc48b66bfb8f3d7106b2e1d2c9b6b6f4ef509 Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:11:42 +0000 Subject: [PATCH 2/7] Review and approve an isolated brief from native chat --- apps/server/src/isolatedApprovalHttp.test.ts | 4 +- apps/server/src/isolatedApprovalHttp.ts | 5 +- apps/web/src/components/chat/ChatHeader.tsx | 7 + .../components/chat/IsolatedBriefDialog.tsx | 193 ++++++++++++++++++ 4 files changed, 207 insertions(+), 2 deletions(-) create mode 100644 apps/web/src/components/chat/IsolatedBriefDialog.tsx diff --git a/apps/server/src/isolatedApprovalHttp.test.ts b/apps/server/src/isolatedApprovalHttp.test.ts index 2aeb7eb3ca5a0..1c8dfd3b9e9d6 100644 --- a/apps/server/src/isolatedApprovalHttp.test.ts +++ b/apps/server/src/isolatedApprovalHttp.test.ts @@ -33,7 +33,7 @@ it("forwards only explicit approvals from the configured authenticated operator" { disableLogger: true }, ); try { - const send = (body: string, auth?: string) => + const send = (body: string, auth?: string, cookie?: string) => handler( new Request("http://localhost/api/isolated-approval/v1/approve", { method: "POST", @@ -41,6 +41,7 @@ it("forwards only explicit approvals from the configured authenticated operator" "content-type": "application/json", "content-length": String(body.length), ...(auth ? { authorization: auth } : {}), + ...(cookie ? { cookie } : {}), }, body, }), @@ -49,6 +50,7 @@ it("forwards only explicit approvals from the configured authenticated operator" expect((await send(body)).status).toBe(401); expect((await send(body, "Bearer t3-session")).status).toBe(403); subject = "operator"; + expect((await send(body, "Bearer t3-session", "session=fixture")).status).toBe(401); expect((await send("{}", "Bearer t3-session")).status).toBe(400); expect(upstream).not.toHaveBeenCalled(); expect((await send(body, "Bearer t3-session")).status).toBe(200); diff --git a/apps/server/src/isolatedApprovalHttp.ts b/apps/server/src/isolatedApprovalHttp.ts index fe6a9f25101b6..bea4d5f2d8f17 100644 --- a/apps/server/src/isolatedApprovalHttp.ts +++ b/apps/server/src/isolatedApprovalHttp.ts @@ -40,7 +40,10 @@ const route = (action: "review" | "approve") => } const request = yield* HttpServerRequest.HttpServerRequest; - if (!/^Bearer \S+$/i.test(request.headers.authorization ?? "")) { + if ( + request.headers.cookie !== undefined || + !/^Bearer \S+$/i.test(request.headers.authorization ?? "") + ) { return HttpServerResponse.empty({ status: 401 }); } const auth = yield* EnvironmentAuth; diff --git a/apps/web/src/components/chat/ChatHeader.tsx b/apps/web/src/components/chat/ChatHeader.tsx index 22e02b228a24d..8c320d5137896 100644 --- a/apps/web/src/components/chat/ChatHeader.tsx +++ b/apps/web/src/components/chat/ChatHeader.tsx @@ -1,5 +1,6 @@ import { AuthOrchestrationOperateScope, + PRIMARY_LOCAL_ENVIRONMENT_ID, type EnvironmentId, type ScopedThreadRef, type ThreadId, @@ -43,6 +44,7 @@ import { cn } from "~/lib/utils"; import { textDirection } from "~/textDirection"; import { useClientSettings } from "../../hooks/useSettings"; import { GuestShareIndicator } from "./GuestShareControls"; +import { IsolatedBriefDialog } from "./IsolatedBriefDialog"; interface ChatHeaderProps { activeThreadEnvironmentId: EnvironmentId; @@ -398,6 +400,11 @@ export const ChatHeader = memo(function ChatHeader({ ) : null} + {isServerThread && + canOperateThread && + activeThreadEnvironmentId === PRIMARY_LOCAL_ENVIRONMENT_ID && + typeof window !== "undefined" && + window.desktopBridge && } {isServerThread ? : null} ); diff --git a/apps/web/src/components/chat/IsolatedBriefDialog.tsx b/apps/web/src/components/chat/IsolatedBriefDialog.tsx new file mode 100644 index 0000000000000..6361db9e541b2 --- /dev/null +++ b/apps/web/src/components/chat/IsolatedBriefDialog.tsx @@ -0,0 +1,193 @@ +import { Link } from "@tanstack/react-router"; +import * as Schema from "effect/Schema"; +import { type FormEvent, useState } from "react"; +import { readDesktopPrimaryBearerToken } from "~/environments/primary/desktopAuth"; +import { resolvePrimaryEnvironmentHttpUrl } from "~/environments/primary/target"; +import { parseManagedRunId } from "~/lib/managedRunDelivery"; +import { Button } from "../ui/button"; +import { Dialog, DialogDescription, DialogPopup, DialogTitle, DialogTrigger } from "../ui/dialog"; + +const ticketPattern = /^[A-Za-z0-9][A-Za-z0-9_-]{0,99}$/; +const Tokens = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: Number.MAX_SAFE_INTEGER })); +const Stage = Schema.Struct({ + projectId: Schema.String, + message: Schema.String, + tokens: Tokens, + modelSelection: Schema.Struct({ + instanceId: Schema.String, + model: Schema.String, + options: Schema.optionalKey(Schema.Unknown), + }), +}); +const Draft = Schema.Struct({ + ticket: Schema.String, + revision: Schema.String.check(Schema.isPattern(/^[a-f0-9]{64}$/)), + brief: Schema.Struct({ + workspaceId: Schema.String, + repository: Schema.String, + baseSha: Schema.String.check(Schema.isPattern(/^[a-f0-9]{40}$/)), + scope: Schema.String, + tokens: Tokens, + nativeStages: Schema.optionalKey( + Schema.Struct({ + lead: Stage, + implementation: Schema.optionalKey(Stage), + qa: Schema.optionalKey(Stage), + }), + ), + }), +}); +const isDraft = Schema.is(Draft); +const isApproval = Schema.is(Schema.Struct({ runId: Schema.String, revision: Schema.String })); + +async function postApproval( + action: "review" | "approve", + input: { ticket: string; revision?: string }, +): Promise { + const token = await readDesktopPrimaryBearerToken(); + if (!token) throw new Error("Sign in to the local desktop environment."); + const response = await fetch( + resolvePrimaryEnvironmentHttpUrl(`/api/isolated-approval/v1/${action}`), + { + method: "POST", + headers: { authorization: `Bearer ${token}`, "content-type": "application/json" }, + body: JSON.stringify(input), + credentials: "omit", + redirect: "error", + cache: "no-store", + }, + ); + if (response.status === 409) { + const value: unknown = await response.json(); + const error = Schema.is(Schema.Struct({ error: Schema.String })); + throw new Error(error(value) ? value.error : "Review the latest prepared brief."); + } + if (response.status === 404) + throw new Error("Isolated approval is disabled in this environment."); + if (response.status === 401 || response.status === 403) { + throw new Error("This session cannot approve isolated runs."); + } + if (!response.ok) throw new Error("The isolated approval service is unavailable."); + return response.json(); +} + +function BriefForm() { + const [draft, setDraft] = useState(null); + const [runId, setRunId] = useState(); + const [error, setError] = useState(); + const [pending, setPending] = useState(false); + + async function review(event: FormEvent) { + event.preventDefault(); + const ticket = new FormData(event.currentTarget).get("ticket"); + if (pending || typeof ticket !== "string" || !ticketPattern.test(ticket.trim())) return; + setPending(true); + setDraft(null); + setRunId(undefined); + setError(undefined); + try { + const value = await postApproval("review", { ticket: ticket.trim() }); + if (!isDraft(value) || value.ticket !== ticket.trim()) + throw new Error("Invalid prepared brief."); + setDraft(value); + } catch (cause) { + setError(cause instanceof Error ? cause.message : "Review failed."); + } finally { + setPending(false); + } + } + + async function approve() { + if (!draft || pending || runId) return; + setPending(true); + setError(undefined); + try { + const value = await postApproval("approve", { + ticket: draft.ticket, + revision: draft.revision, + }); + const id = + isApproval(value) && value.revision === draft.revision + ? parseManagedRunId(value.runId) + : undefined; + if (!id) + throw new Error("Approval receipt is unavailable. Retry the same revision to recover it."); + setRunId(id); + } catch (cause) { + setError(cause instanceof Error ? cause.message : "Approval failed."); + } finally { + setPending(false); + } + } + + return ( +
+
void review(event)} className="flex items-end gap-2"> + + +
+ {draft && ( +
+

+ {draft.brief.repository} · {draft.brief.workspaceId} +

+

Ticket {draft.ticket}

+

Base commit {draft.brief.baseSha}

+

Revision {draft.revision}

+

Budget {draft.brief.tokens.toLocaleString()} tokens

+

{draft.brief.scope}

+ {draft.brief.nativeStages && ( +
    + {Object.entries(draft.brief.nativeStages).map(([role, stage]) => ( +
  • +

    + {role} · {stage.modelSelection.instanceId} · {stage.modelSelection.model} +

    +

    + {stage.tokens.toLocaleString()} tokens · Project {stage.projectId} +

    + {stage.modelSelection.options !== undefined && ( +

    {JSON.stringify(stage.modelSelection.options)}

    + )} +

    {stage.message}

    +
  • + ))} +
+ )} + {runId ? ( + + Open run in Delivery + + ) : ( + + )} +
+ )} + {pending &&

Waiting for the isolated sidecar…

} + {error &&

{error}

} +
+ ); +} + +export function IsolatedBriefDialog() { + const [open, setOpen] = useState(false); + return ( + + }> + Review isolated brief + + + Review isolated brief + Enter a ticket prepared in the isolated workspace. + {open && } + + + ); +} From 8d21e56ddabcf264e3cb69aa010315bb3117d786 Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:15:54 +0000 Subject: [PATCH 3/7] Exercise explicit brief approval and lost-reply retry in the browser --- .../chat/IsolatedBriefDialog.browser.test.tsx | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx diff --git a/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx b/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx new file mode 100644 index 0000000000000..dc7859befd196 --- /dev/null +++ b/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx @@ -0,0 +1,67 @@ +import "~/index.css"; +import { expect, it, vi } from "vite-plus/test"; +import { page } from "vite-plus/test/browser"; +import { render, stubGlobal } from "../../../test/render"; +import { IsolatedBriefDialog } from "./IsolatedBriefDialog"; + +vi.mock(import("~/environments/primary/desktopAuth"), () => ({ + readDesktopPrimaryBearerToken: async () => "fixture-session", +})); +vi.mock(import("~/environments/primary/target"), () => ({ + resolvePrimaryEnvironmentHttpUrl: (pathname: string) => `http://127.0.0.1:3210${pathname}`, +})); + +it("requires explicit approval of the reviewed revision and can recover a missing receipt", async () => { + const revision = "a".repeat(64); + const baseSha = "b".repeat(40); + const runId = "a16fdb25-00e8-4061-97c2-14cd6e10c27b"; + const fetchApproval = vi + .fn() + .mockResolvedValueOnce( + Response.json({ + ticket: "fixture", + revision, + brief: { + repository: "lab/fixture", + workspaceId: "isolated", + scope: "Update the clamp fixture", + baseSha, + tokens: 1000, + nativeStages: { + lead: { + projectId: "fixture-project", + message: "Review the clamp brief", + tokens: 100, + modelSelection: { instanceId: "codex-lab", model: "codex-fixture" }, + }, + }, + }, + }), + ) + .mockRejectedValueOnce(new Error("Reply lost")) + .mockResolvedValueOnce(Response.json({ runId, revision })); + using _fetch = stubGlobal("fetch", fetchApproval); + await using screen = await render(); + await screen.getByRole("button", { name: "Review isolated brief" }).click(); + const dialog = page.getByRole("dialog"); + const approve = dialog.getByRole("button", { name: "Approve isolated run" }); + await expect.element(approve).not.toBeInTheDocument(); + await dialog.getByRole("textbox", { name: "Prepared ticket" }).fill("fixture"); + await dialog.getByRole("button", { name: "Review", exact: true }).click(); + await expect.element(dialog.getByText(`Base commit ${baseSha}`)).toBeVisible(); + await expect.element(dialog.getByText("lead · codex-lab · codex-fixture")).toBeVisible(); + expect(fetchApproval).toHaveBeenCalledTimes(1); + expect(fetchApproval.mock.calls[0]?.[0]).toMatch(/\/review$/); + await approve.click(); + await expect.element(dialog.getByRole("alert")).toHaveTextContent("Reply lost"); + await approve.click(); + await expect + .element(dialog.getByRole("link", { name: "Open run in Delivery" })) + .toHaveAttribute("href", `/delivery?run=${runId}`); + const approvalCalls = fetchApproval.mock.calls.slice(1); + expect(approvalCalls).toHaveLength(2); + expect(approvalCalls[0]).toEqual(approvalCalls[1]); + expect(approvalCalls[0]?.[0]).toMatch(/\/approve$/); + expect(approvalCalls[0]?.[1]?.body).toBe(JSON.stringify({ ticket: "fixture", revision })); + expect(approvalCalls[0]?.[1]?.credentials).toBe("omit"); +}); From 4a9346671b27be1adc96ce61df4aa44cbb09f0da Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:23:48 +0000 Subject: [PATCH 4/7] Offer isolated brief review before the first provider turn --- apps/web/src/components/chat/ChatHeader.tsx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/apps/web/src/components/chat/ChatHeader.tsx b/apps/web/src/components/chat/ChatHeader.tsx index 8c320d5137896..77c438e8e32f8 100644 --- a/apps/web/src/components/chat/ChatHeader.tsx +++ b/apps/web/src/components/chat/ChatHeader.tsx @@ -400,8 +400,7 @@ export const ChatHeader = memo(function ChatHeader({ ) : null} - {isServerThread && - canOperateThread && + {canOperateThread && activeThreadEnvironmentId === PRIMARY_LOCAL_ENVIRONMENT_ID && typeof window !== "undefined" && window.desktopBridge && } From 1c412cfbab08a0cd57dea36692c1bd044854e6ae Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:24:59 +0000 Subject: [PATCH 5/7] Match brief review to the resolved primary environment --- apps/web/src/components/chat/ChatHeader.tsx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/apps/web/src/components/chat/ChatHeader.tsx b/apps/web/src/components/chat/ChatHeader.tsx index 77c438e8e32f8..60e9c9b7878cb 100644 --- a/apps/web/src/components/chat/ChatHeader.tsx +++ b/apps/web/src/components/chat/ChatHeader.tsx @@ -1,6 +1,5 @@ import { AuthOrchestrationOperateScope, - PRIMARY_LOCAL_ENVIRONMENT_ID, type EnvironmentId, type ScopedThreadRef, type ThreadId, @@ -28,6 +27,7 @@ import { toastManager } from "../ui/toast"; import { useThreadActionMenu } from "~/hooks/useThreadActionMenu"; import { readLocalApi } from "~/localApi"; import { threadEnvironment } from "../../state/threads"; +import { usePrimaryEnvironmentId } from "../../state/environments"; import { canShareWithGuestAtom } from "./guestShareAvailability"; import { useAtomValue } from "@effect/atom-react"; import { useOrchestrationCommand } from "../../state/use-orchestration-command"; @@ -90,6 +90,7 @@ export const ChatHeader = memo(function ChatHeader({ const interfaceFont = useClientSettings((settings) => settings.fontFamilySans); const breadcrumbContainerRef = useRef(null); const [collapseParentTitle, setCollapseParentTitle] = useState(false); + const primaryEnvironmentId = usePrimaryEnvironmentId(); const activeThreadRef = scopeThreadRef(activeThreadEnvironmentId, activeThreadId); const canOperateThread = useEnvironmentScope( activeThreadEnvironmentId, @@ -401,7 +402,7 @@ export const ChatHeader = memo(function ChatHeader({ {canOperateThread && - activeThreadEnvironmentId === PRIMARY_LOCAL_ENVIRONMENT_ID && + activeThreadEnvironmentId === primaryEnvironmentId && typeof window !== "undefined" && window.desktopBridge && } {isServerThread ? : null} From 90ee330068e422cec26be88610e24e292ec726ea Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:29:29 +0000 Subject: [PATCH 6/7] Cover isolated review in a fresh local chat draft --- .../chat/ChatHeader.browser.test.tsx | 21 ++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/apps/web/src/components/chat/ChatHeader.browser.test.tsx b/apps/web/src/components/chat/ChatHeader.browser.test.tsx index 2f54eef77c8d3..0ea4ee8711fe0 100644 --- a/apps/web/src/components/chat/ChatHeader.browser.test.tsx +++ b/apps/web/src/components/chat/ChatHeader.browser.test.tsx @@ -4,6 +4,11 @@ import { userEvent } from "vite-plus/test/browser"; const persisted = vi.hoisted(() => ({ title: "" })); const openMenu = vi.hoisted(() => vi.fn()); +vi.mock(import("../../state/environments"), async (importOriginal) => ({ + ...(await importOriginal()), + usePrimaryEnvironmentId: () => EnvironmentId.make("local-backend-generated-id"), +})); + vi.mock(import("../../state/session"), async (importOriginal) => ({ ...(await importOriginal()), useEnvironmentScope: () => true, @@ -24,14 +29,14 @@ vi.mock(import("~/hooks/useThreadActionMenu"), () => ({ import { render, stubGlobal } from "../../../test/render"; import { ChatHeader } from "./ChatHeader"; -function header(title: string) { +function header(title: string, environment = "environment", isServerThread = true) { return ( <> {}} @@ -103,3 +108,13 @@ it("keeps the Escape that cancels a rename from also reaching window shortcuts", expect(persisted.title).toBe("New thread"); expect(windowEscapes).toEqual([true]); }); + +it("offers isolated brief review on a draft in the resolved primary desktop environment", async () => { + using _bridge = stubGlobal("desktopBridge", {}); + await using screen = await render(header("New thread", "local-backend-generated-id", false)); + const review = screen.getByRole("button", { name: "Review isolated brief" }); + await expect.element(review).toBeVisible(); + + await screen.rerender(header("Other thread", "linked-environment", false)); + await expect.element(review).not.toBeInTheDocument(); +}); From 47135930cb5368bdd9cef7b8a502e7f4df3d0a7f Mon Sep 17 00:00:00 2001 From: InTheta <17220028+InTheta@users.noreply.github.com> Date: Tue, 17 Nov 2026 11:38:46 +0000 Subject: [PATCH 7/7] Prepare scoped drafts in native chat and compile approval handlers --- apps/server/src/isolatedApprovalHttp.test.ts | 13 +- apps/server/src/isolatedApprovalHttp.ts | 14 ++- .../chat/IsolatedBriefDialog.browser.test.tsx | 115 ++++++++++-------- .../components/chat/IsolatedBriefDialog.tsx | 91 ++++++++++---- 4 files changed, 147 insertions(+), 86 deletions(-) diff --git a/apps/server/src/isolatedApprovalHttp.test.ts b/apps/server/src/isolatedApprovalHttp.test.ts index 1c8dfd3b9e9d6..203f233a6bf10 100644 --- a/apps/server/src/isolatedApprovalHttp.test.ts +++ b/apps/server/src/isolatedApprovalHttp.test.ts @@ -14,7 +14,9 @@ it("forwards only explicit approvals from the configured authenticated operator" let subject = "different-account"; const upstream = vi .spyOn(globalThis, "fetch") - .mockResolvedValue(Response.json({ runId: "existing-run", revision: "a".repeat(64) })); + .mockImplementation(async () => + Response.json({ runId: "existing-run", revision: "a".repeat(64) }), + ); const { handler, dispose } = HttpRouter.toWebHandler( layer.pipe( Layer.provideMerge(FetchHttpClient.layer), @@ -33,9 +35,9 @@ it("forwards only explicit approvals from the configured authenticated operator" { disableLogger: true }, ); try { - const send = (body: string, auth?: string, cookie?: string) => + const send = (body: string, auth?: string, cookie?: string, action = "approve") => handler( - new Request("http://localhost/api/isolated-approval/v1/approve", { + new Request(`http://localhost/api/isolated-approval/v1/${action}`, { method: "POST", headers: { "content-type": "application/json", @@ -60,6 +62,11 @@ it("forwards only explicit approvals from the configured authenticated operator" expect(new Headers(forwarded?.headers).get("authorization")).toBe("Bearer sidecar-test-token"); expect(forwarded?.body).toBeInstanceOf(Uint8Array); expect(new TextDecoder().decode(forwarded?.body as Uint8Array)).toBe(body); + const draft = JSON.stringify({ ticket: "fixture", scope: "Update fixture" }); + expect((await send(draft, "Bearer t3-session", undefined, "prepare")).status).toBe(200); + const [prepareUrl, prepared] = upstream.mock.calls[1] ?? []; + expect(String(prepareUrl)).toBe("http://127.0.0.1:45678/isolated-approval/v1/prepare"); + expect(new TextDecoder().decode(prepared?.body as Uint8Array)).toBe(draft); } finally { await dispose(); upstream.mockRestore(); diff --git a/apps/server/src/isolatedApprovalHttp.ts b/apps/server/src/isolatedApprovalHttp.ts index bea4d5f2d8f17..378521246c6a8 100644 --- a/apps/server/src/isolatedApprovalHttp.ts +++ b/apps/server/src/isolatedApprovalHttp.ts @@ -15,6 +15,10 @@ import { import { EnvironmentAuth } from "./auth/EnvironmentAuth.ts"; const ticket = Schema.String.check(Schema.isPattern(/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,99}$/)); +const prepareBody = Schema.Struct({ + ticket, + scope: Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(4000)), +}); const reviewBody = Schema.Struct({ ticket }); const approveBody = Schema.Struct({ ticket, @@ -29,7 +33,9 @@ function isolatedConfig() { }; } -const route = (action: "review" | "approve") => +const bodies = { prepare: prepareBody, review: reviewBody, approve: approveBody }; + +const route = (action: keyof typeof bodies) => HttpRouter.add( "POST", `/api/isolated-approval/v1/${action}`, @@ -72,7 +78,7 @@ const route = (action: "review" | "approve") => if (Option.isNone(body)) { return HttpServerResponse.empty({ status: 400 }); } - const schema = action === "review" ? reviewBody : approveBody; + const schema = bodies[action]; const input = Schema.decodeUnknownOption(schema)(body.value); if (Option.isNone(input)) { return HttpServerResponse.empty({ status: 400 }); @@ -91,7 +97,7 @@ const route = (action: "review" | "approve") => Effect.timeout("15 seconds"), Effect.option, ); - if (Option.isNone(response) || ![200, 409].includes(response.value.status)) { + if (Option.isNone(response) || ![200, 400, 404, 409].includes(response.value.status)) { return HttpServerResponse.empty({ status: 502, headers: { "cache-control": "no-store" } }); } return HttpServerResponse.text(response.value.body, { @@ -102,4 +108,4 @@ const route = (action: "review" | "approve") => }), ); -export const layer = Layer.mergeAll(route("review"), route("approve")); +export const layer = Layer.mergeAll(route("prepare"), route("review"), route("approve")); diff --git a/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx b/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx index dc7859befd196..d08e7bbd422fe 100644 --- a/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx +++ b/apps/web/src/components/chat/IsolatedBriefDialog.browser.test.tsx @@ -11,57 +11,68 @@ vi.mock(import("~/environments/primary/target"), () => ({ resolvePrimaryEnvironmentHttpUrl: (pathname: string) => `http://127.0.0.1:3210${pathname}`, })); -it("requires explicit approval of the reviewed revision and can recover a missing receipt", async () => { - const revision = "a".repeat(64); - const baseSha = "b".repeat(40); - const runId = "a16fdb25-00e8-4061-97c2-14cd6e10c27b"; - const fetchApproval = vi - .fn() - .mockResolvedValueOnce( - Response.json({ - ticket: "fixture", - revision, - brief: { - repository: "lab/fixture", - workspaceId: "isolated", - scope: "Update the clamp fixture", - baseSha, - tokens: 1000, - nativeStages: { - lead: { - projectId: "fixture-project", - message: "Review the clamp brief", - tokens: 100, - modelSelection: { instanceId: "codex-lab", model: "codex-fixture" }, +it.each(["review", "prepare"] as const)( + "requires explicit approval after %s and can recover a missing receipt", + async (action) => { + const revision = "a".repeat(64); + const baseSha = "b".repeat(40); + const runId = "a16fdb25-00e8-4061-97c2-14cd6e10c27b"; + const fetchApproval = vi + .fn() + .mockResolvedValueOnce( + Response.json({ + ticket: "fixture", + revision, + brief: { + repository: "lab/fixture", + workspaceId: "isolated", + scope: "Update the clamp fixture", + baseSha, + tokens: 1000, + nativeStages: { + lead: { + projectId: "fixture-project", + message: "Review the clamp brief", + tokens: 100, + modelSelection: { instanceId: "codex-lab", model: "codex-fixture" }, + }, }, }, - }, - }), - ) - .mockRejectedValueOnce(new Error("Reply lost")) - .mockResolvedValueOnce(Response.json({ runId, revision })); - using _fetch = stubGlobal("fetch", fetchApproval); - await using screen = await render(); - await screen.getByRole("button", { name: "Review isolated brief" }).click(); - const dialog = page.getByRole("dialog"); - const approve = dialog.getByRole("button", { name: "Approve isolated run" }); - await expect.element(approve).not.toBeInTheDocument(); - await dialog.getByRole("textbox", { name: "Prepared ticket" }).fill("fixture"); - await dialog.getByRole("button", { name: "Review", exact: true }).click(); - await expect.element(dialog.getByText(`Base commit ${baseSha}`)).toBeVisible(); - await expect.element(dialog.getByText("lead · codex-lab · codex-fixture")).toBeVisible(); - expect(fetchApproval).toHaveBeenCalledTimes(1); - expect(fetchApproval.mock.calls[0]?.[0]).toMatch(/\/review$/); - await approve.click(); - await expect.element(dialog.getByRole("alert")).toHaveTextContent("Reply lost"); - await approve.click(); - await expect - .element(dialog.getByRole("link", { name: "Open run in Delivery" })) - .toHaveAttribute("href", `/delivery?run=${runId}`); - const approvalCalls = fetchApproval.mock.calls.slice(1); - expect(approvalCalls).toHaveLength(2); - expect(approvalCalls[0]).toEqual(approvalCalls[1]); - expect(approvalCalls[0]?.[0]).toMatch(/\/approve$/); - expect(approvalCalls[0]?.[1]?.body).toBe(JSON.stringify({ ticket: "fixture", revision })); - expect(approvalCalls[0]?.[1]?.credentials).toBe("omit"); -}); + }), + ) + .mockRejectedValueOnce(new Error("Reply lost")) + .mockResolvedValueOnce(Response.json({ runId, revision })); + using _fetch = stubGlobal("fetch", fetchApproval); + await using screen = await render(); + await screen.getByRole("button", { name: "Review isolated brief" }).click(); + const dialog = page.getByRole("dialog"); + const approve = dialog.getByRole("button", { name: "Approve isolated run" }); + await expect.element(approve).not.toBeInTheDocument(); + await dialog.getByRole("textbox", { name: "Ticket", exact: true }).fill("fixture"); + if (action === "prepare") { + await dialog.getByRole("textbox", { name: "Task scope" }).fill("Update the clamp fixture"); + } + await dialog + .getByRole("button", { + name: action === "prepare" ? "Prepare draft" : "Review existing draft", + exact: true, + }) + .click(); + await expect.element(dialog.getByText(`Base commit ${baseSha}`)).toBeVisible(); + await expect.element(dialog.getByText("lead · codex-lab · codex-fixture")).toBeVisible(); + expect(fetchApproval).toHaveBeenCalledTimes(1); + expect(fetchApproval.mock.calls[0]?.[0]).toMatch(new RegExp(`/${action}$`)); + await approve.click(); + await expect.element(dialog.getByRole("alert")).toHaveTextContent("Reply lost"); + await approve.click(); + await expect + .element(dialog.getByRole("link", { name: "Open run in Delivery" })) + .toHaveAttribute("href", `/delivery?run=${runId}`); + const approvalCalls = fetchApproval.mock.calls.slice(1); + expect(approvalCalls).toHaveLength(2); + expect(approvalCalls[0]).toEqual(approvalCalls[1]); + expect(approvalCalls[0]?.[0]).toMatch(/\/approve$/); + expect(approvalCalls[0]?.[1]?.body).toBe(JSON.stringify({ ticket: "fixture", revision })); + expect(approvalCalls[0]?.[1]?.credentials).toBe("omit"); + }, +); diff --git a/apps/web/src/components/chat/IsolatedBriefDialog.tsx b/apps/web/src/components/chat/IsolatedBriefDialog.tsx index 6361db9e541b2..611b59375ed25 100644 --- a/apps/web/src/components/chat/IsolatedBriefDialog.tsx +++ b/apps/web/src/components/chat/IsolatedBriefDialog.tsx @@ -41,8 +41,8 @@ const isDraft = Schema.is(Draft); const isApproval = Schema.is(Schema.Struct({ runId: Schema.String, revision: Schema.String })); async function postApproval( - action: "review" | "approve", - input: { ticket: string; revision?: string }, + action: "prepare" | "review" | "approve", + input: { ticket: string; revision?: string; scope?: string }, ): Promise { const token = await readDesktopPrimaryBearerToken(); if (!token) throw new Error("Sign in to the local desktop environment."); @@ -57,13 +57,19 @@ async function postApproval( cache: "no-store", }, ); - if (response.status === 409) { - const value: unknown = await response.json(); + if (response.status === 400 || response.status === 409) { + const value: unknown = await response.json().catch(() => undefined); const error = Schema.is(Schema.Struct({ error: Schema.String })); - throw new Error(error(value) ? value.error : "Review the latest prepared brief."); + throw new Error( + error(value) ? value.error : "Check your ticket and scope, then review the latest draft.", + ); } if (response.status === 404) - throw new Error("Isolated approval is disabled in this environment."); + throw new Error( + action === "prepare" + ? "Draft preparation is disabled in this environment." + : "Isolated approval is disabled in this environment.", + ); if (response.status === 401 || response.status === 403) { throw new Error("This session cannot approve isolated runs."); } @@ -77,24 +83,43 @@ function BriefForm() { const [error, setError] = useState(); const [pending, setPending] = useState(false); - async function review(event: FormEvent) { + async function loadDraft(event: FormEvent) { event.preventDefault(); - const ticket = new FormData(event.currentTarget).get("ticket"); - if (pending || typeof ticket !== "string" || !ticketPattern.test(ticket.trim())) return; + const form = new FormData(event.currentTarget); + const ticket = String(form.get("ticket") ?? "").trim(); + const scope = String(form.get("scope") ?? "").trim(); + const submitter = (event.nativeEvent as SubmitEvent).submitter; + const action = + submitter instanceof HTMLButtonElement && submitter.value === "prepare" + ? "prepare" + : "review"; + if (pending) return; + if (!ticketPattern.test(ticket)) { + setError("Enter a ticket using letters, digits, hyphens or underscores."); + return; + } + if (action === "prepare" && !scope) { + setError("Enter a task scope to prepare a draft."); + return; + } setPending(true); setDraft(null); setRunId(undefined); setError(undefined); try { - const value = await postApproval("review", { ticket: ticket.trim() }); - if (!isDraft(value) || value.ticket !== ticket.trim()) - throw new Error("Invalid prepared brief."); - setDraft(value); + const value = await postApproval( + action, + action === "prepare" ? { ticket, scope } : { ticket }, + ); + if (isDraft(value) && value.ticket === ticket) { + setDraft(value); + } else { + setError("Invalid prepared brief."); + } } catch (cause) { setError(cause instanceof Error ? cause.message : "Review failed."); - } finally { - setPending(false); } + setPending(false); } async function approve() { @@ -110,26 +135,36 @@ function BriefForm() { isApproval(value) && value.revision === draft.revision ? parseManagedRunId(value.runId) : undefined; - if (!id) - throw new Error("Approval receipt is unavailable. Retry the same revision to recover it."); - setRunId(id); + if (id) { + setRunId(id); + } else { + setError("Approval receipt is unavailable. Retry the same revision to recover it."); + } } catch (cause) { setError(cause instanceof Error ? cause.message : "Approval failed."); - } finally { - setPending(false); } + setPending(false); } return (
-
void review(event)} className="flex items-end gap-2"> -