From b865785d01a778a39f0fee84c33b1c7bca729bb2 Mon Sep 17 00:00:00 2001 From: Yash Dewasthale Date: Fri, 20 Nov 2026 17:16:34 +0530 Subject: [PATCH 1/3] Use Nova-prefixed Browserbase environment variables Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- apps/web/.env.example | 4 ++++ .../modules/nova-web/components/browser-pane.tsx | 2 +- apps/web/modules/nova/browser/provider.test.ts | 13 ++++++++++++- apps/web/modules/nova/browser/provider.ts | 14 +++++++++++--- apps/web/modules/nova/browser/server.ts | 7 ++----- apps/web/modules/nova/sessions/turn.ts | 4 ++-- 6 files changed, 32 insertions(+), 12 deletions(-) diff --git a/apps/web/.env.example b/apps/web/.env.example index e9f41229..ff792a05 100644 --- a/apps/web/.env.example +++ b/apps/web/.env.example @@ -62,6 +62,10 @@ NVIDIA_API_KEY= # Shared secret used when creating repo webhooks + verifying deliveries # Must match production Vercel env AND the secret on each GitHub webhook. GITHUB_WEBHOOK_SECRET= +# ─── Nova Agent Browser (Browserbase) ─── +# Required in the web server environment to enable Nova's shared browser. +NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY= +NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID= # ─── AI Gateway (PR reviews + embeddings) ─── # PR reviews prefer Merge when MERGE_GATEWAY_API_KEY is configured, then direct # OPENAI/ANTHROPIC/GOOGLE keys. Without a Merge key, the shared gateway order applies. diff --git a/apps/web/modules/nova-web/components/browser-pane.tsx b/apps/web/modules/nova-web/components/browser-pane.tsx index f51b7e97..29aba884 100644 --- a/apps/web/modules/nova-web/components/browser-pane.tsx +++ b/apps/web/modules/nova-web/components/browser-pane.tsx @@ -114,7 +114,7 @@ export function BrowserPane({ sessionId }: { sessionId: string }) {

{pending ? "Connecting…" : active ? browser.control === "agent" ? "Nova’s browser workspace" : "Browser is connecting" : "Browse together"}

-{!state ? error ? "Use reconnect to retry the browser service." : "Checking browser configuration…" : !state.configured ? "Configure BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID on the server to enable the shared browser." : active ? browser.control === "agent" ? "Nova can inspect and navigate this session. Take control to interact, sign in, or complete sensitive actions." : disconnected ? "The live view disconnected. Reconnect or stop this session." : "Waiting for a safe connection. Use reconnect to refresh the view." : "Open an isolated cloud browser, then hand it to Nova when you’re ready. Sessions run for up to 15 minutes."} +{!state ? error ? "Use reconnect to retry the browser service." : "Checking browser configuration…" : !state.configured ? "Configure NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY and NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID on the server to enable the shared browser." : active ? browser.control === "agent" ? "Nova can inspect and navigate this session. Take control to interact, sign in, or complete sensitive actions." : disconnected ? "The live view disconnected. Reconnect or stop this session." : "Waiting for a safe connection. Use reconnect to refresh the view." : "Open an isolated cloud browser, then hand it to Nova when you’re ready. Sessions run for up to 15 minutes."}

{!active && state?.configured ? : null} {pending || (!state && !error) ? : null} diff --git a/apps/web/modules/nova/browser/provider.test.ts b/apps/web/modules/nova/browser/provider.test.ts index 706d70dc..6ad98794 100644 --- a/apps/web/modules/nova/browser/provider.test.ts +++ b/apps/web/modules/nova/browser/provider.test.ts @@ -1,8 +1,19 @@ import { describe, expect, test } from "bun:test" -import { createBrowserbaseProvider, validateProviderUrl } from "./provider" +import { browserConfigured, browserbaseConfig, createBrowserbaseProvider, validateProviderUrl } from "./provider" import { BrowserCreationRejectedError } from "./contracts" +test("Browserbase config reads the Nova-prefixed production environment names", () => { + const config = browserbaseConfig({ + NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY: " key ", + NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID: " project ", + }) + expect(config).toEqual({ apiKey: "key", projectId: "project" }) + expect(browserConfigured({ NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY: "key", NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID: "project" })).toBe(true) + expect(browserConfigured({ NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY: " ", NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID: "project" })).toBe(false) + expect(browserbaseConfig({ NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY: "", NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID: "project" })).toEqual({ apiKey: "", projectId: "project" }) +}) + describe("Browserbase creation failures", () => { for (const [status, detail, expected] of [ [401, "secret response", "rejected the API key"], diff --git a/apps/web/modules/nova/browser/provider.ts b/apps/web/modules/nova/browser/provider.ts index 429a89fc..0947173d 100644 --- a/apps/web/modules/nova/browser/provider.ts +++ b/apps/web/modules/nova/browser/provider.ts @@ -1,8 +1,16 @@ import { BrowserCreationRejectedError, BrowserError, LIVE_VIEW_TTL_SECONDS, type BrowserProvider } from "./contracts" import { browserLiveViewUrl } from "@/modules/nova-web/browser-view" -export function browserConfigured(): boolean { - return Boolean(process.env.BROWSERBASE_API_KEY?.trim() && process.env.BROWSERBASE_PROJECT_ID?.trim()) +export function browserbaseConfig(env: Pick = process.env) { + return { + apiKey: env.NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY?.trim() ?? "", + projectId: env.NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID?.trim() ?? "", + } +} + +export function browserConfigured(env: Pick = process.env): boolean { + const config = browserbaseConfig(env) + return Boolean(config.apiKey && config.projectId) } export function validateProviderUrl(value: unknown, kind: "live" | "cdp"): string { @@ -39,7 +47,7 @@ export function createBrowserbaseProvider( let message = "Browserbase request failed; retry later" let status = 502 if (response.status === 401) { - message = "Browserbase rejected the API key; check the deployed BROWSERBASE_API_KEY" + message = "Browserbase rejected the API key; check the deployed NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY" status = 503 } else if ((response.status === 400 || response.status === 403 || response.status === 402) && /keep.?alive/.test(detail)) { message = "Browserbase requires a paid plan with keep-alive support for Nova's shared browser" diff --git a/apps/web/modules/nova/browser/server.ts b/apps/web/modules/nova/browser/server.ts index 190ababc..b1b66cca 100644 --- a/apps/web/modules/nova/browser/server.ts +++ b/apps/web/modules/nova/browser/server.ts @@ -1,14 +1,11 @@ import { createBrowserService } from "./lifecycle" -import { browserConfigured, createBrowserbaseProvider } from "./provider" +import { browserbaseConfig, browserConfigured, createBrowserbaseProvider } from "./provider" import { browserStore } from "./store" export function browserService() { return createBrowserService({ store: browserStore, configured: browserConfigured(), - provider: createBrowserbaseProvider({ - apiKey: process.env.BROWSERBASE_API_KEY ?? "", - projectId: process.env.BROWSERBASE_PROJECT_ID ?? "", - }), + provider: createBrowserbaseProvider(browserbaseConfig()), }) } diff --git a/apps/web/modules/nova/sessions/turn.ts b/apps/web/modules/nova/sessions/turn.ts index b9fefbfe..96d0644e 100644 --- a/apps/web/modules/nova/sessions/turn.ts +++ b/apps/web/modules/nova/sessions/turn.ts @@ -5,7 +5,7 @@ import { authorizeHarnessRun, durableStore, harnessCheckpoint } from "../harness import { browserService } from "@/modules/nova/browser/server" import { browserHarnessTools, executeBrowserTool, isBrowserTool } from "@/modules/nova/browser/tools" -import { createBrowserbaseProvider } from "@/modules/nova/browser/provider" +import { browserbaseConfig, createBrowserbaseProvider } from "@/modules/nova/browser/provider" import { CHATGPT_PROVIDER, CHATGPT_UNAVAILABLE_MESSAGE } from "@/modules/nova/chatgpt/contracts" import { CODEX_PROVIDER } from "@/modules/nova/codex/models" @@ -766,7 +766,7 @@ export async function* runWebTurn(input: { if (isBrowserTool(toolName)) { if (!browserClaim || mode !== "agent") return { successful: false, error: "Browser agent control is not enabled" } const { runCdpAction } = await import("@/modules/nova/browser/cdp") - const provider = createBrowserbaseProvider({ apiKey: process.env.BROWSERBASE_API_KEY ?? "", projectId: process.env.BROWSERBASE_PROJECT_ID ?? "" }) + const provider = createBrowserbaseProvider(browserbaseConfig()) return executeBrowserTool({ name: toolName, args, scope: browserScope, expected: browserClaim, service: browser, connection: provider.connection, run: runCdpAction, signal }) } if (workspace) return workspace.execute(toolName, args) From 0c03ae20990ce2412533083a24f3fa95aa0413f0 Mon Sep 17 00:00:00 2001 From: Yash Dewasthale Date: Fri, 20 Nov 2026 17:21:10 +0530 Subject: [PATCH 2/3] Fix optional Browserbase env typing Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- apps/web/modules/nova/browser/provider.ts | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/apps/web/modules/nova/browser/provider.ts b/apps/web/modules/nova/browser/provider.ts index 0947173d..6b3f0e68 100644 --- a/apps/web/modules/nova/browser/provider.ts +++ b/apps/web/modules/nova/browser/provider.ts @@ -1,14 +1,16 @@ import { BrowserCreationRejectedError, BrowserError, LIVE_VIEW_TTL_SECONDS, type BrowserProvider } from "./contracts" import { browserLiveViewUrl } from "@/modules/nova-web/browser-view" -export function browserbaseConfig(env: Pick = process.env) { +type BrowserbaseEnvironment = Partial> + +export function browserbaseConfig(env: BrowserbaseEnvironment = process.env) { return { apiKey: env.NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY?.trim() ?? "", projectId: env.NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID?.trim() ?? "", } } -export function browserConfigured(env: Pick = process.env): boolean { +export function browserConfigured(env: BrowserbaseEnvironment = process.env): boolean { const config = browserbaseConfig(env) return Boolean(config.apiKey && config.projectId) } From 1e35b00f9b73c915f61965de238687e56be045f9 Mon Sep 17 00:00:00 2001 From: Yash Dewasthale Date: Fri, 20 Nov 2026 17:24:30 +0530 Subject: [PATCH 3/3] Use dictionary type for Browserbase environment config Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- apps/web/modules/nova/browser/provider.test.ts | 2 ++ apps/web/modules/nova/browser/provider.ts | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/apps/web/modules/nova/browser/provider.test.ts b/apps/web/modules/nova/browser/provider.test.ts index 6ad98794..f6ea57d9 100644 --- a/apps/web/modules/nova/browser/provider.test.ts +++ b/apps/web/modules/nova/browser/provider.test.ts @@ -4,6 +4,8 @@ import { browserConfigured, browserbaseConfig, createBrowserbaseProvider, valida import { BrowserCreationRejectedError } from "./contracts" test("Browserbase config reads the Nova-prefixed production environment names", () => { + expect(browserbaseConfig({})).toEqual({ apiKey: "", projectId: "" }) + expect(browserConfigured({})).toBe(false) const config = browserbaseConfig({ NOVA_AGENT_BROWSER_BROWSERBASE_API_KEY: " key ", NOVA_AGENT_BROWSER_BROWSERBASE_PROJECT_ID: " project ", diff --git a/apps/web/modules/nova/browser/provider.ts b/apps/web/modules/nova/browser/provider.ts index 6b3f0e68..76113782 100644 --- a/apps/web/modules/nova/browser/provider.ts +++ b/apps/web/modules/nova/browser/provider.ts @@ -1,7 +1,7 @@ import { BrowserCreationRejectedError, BrowserError, LIVE_VIEW_TTL_SECONDS, type BrowserProvider } from "./contracts" import { browserLiveViewUrl } from "@/modules/nova-web/browser-view" -type BrowserbaseEnvironment = Partial> +type BrowserbaseEnvironment = Record export function browserbaseConfig(env: BrowserbaseEnvironment = process.env) { return {