Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

feat(browser): add fire-engine session destroyed (#2841)

Developers Digest6d2bee1799de
diff --git a/apps/api/src/config.ts b/apps/api/src/config.ts
index 6e2380ace..9dd187cba 100644
--- a/apps/api/src/config.ts
+++ b/apps/api/src/config.ts
@@ -226,6 +226,7 @@ const configSchema = z.object({
// Browser Service
BROWSER_SERVICE_URL: z.string().optional(),
BROWSER_SERVICE_API_KEY: z.string().optional(),
+ BROWSER_SERVICE_WEBHOOK_SECRET: z.string().optional(),
NUQ_PREFETCH_WORKER_HEARTBEAT_URL: z.string().optional(),
});
diff --git a/apps/api/src/controllers/v2/browser.ts b/apps/api/src/controllers/v2/browser.ts
index 5139ca875..43030ea2c 100644
--- a/apps/api/src/controllers/v2/browser.ts
+++ b/apps/api/src/controllers/v2/browser.ts
@@ -1,11 +1,12 @@
import { v7 as uuidv7 } from "uuid";
-import { Response } from "express";
+import { Request, Response } from "express";
import { z } from "zod";
import { logger as _logger } from "../../lib/logger";
import { config } from "../../config";
import {
insertBrowserSession,
getBrowserSession,
+ getBrowserSessionByBrowserId,
listBrowserSessions,
updateBrowserSessionActivity,
updateBrowserSessionStatus,
@@ -447,3 +448,48 @@ export async function browserListController(
})),
});
}
+
+export async function browserWebhookDestroyedController(
+ req: Request,
+ res: Response,
+) {
+ const logger = _logger.child({
+ module: "api/v2",
+ method: "browserWebhookDestroyedController",
+ });
+
+ // Validate browser service secret
+ const secret = req.headers["x-browser-service-secret"];
+ if (
+ !config.BROWSER_SERVICE_WEBHOOK_SECRET ||
+ !secret ||
+ secret !== config.BROWSER_SERVICE_WEBHOOK_SECRET
+ ) {
+ return res.status(401).json({ error: "Unauthorized" });
+ }
+
+ const { sessionId } = req.body as { sessionId?: string };
+ if (!sessionId) {
+ return res.status(400).json({ error: "Missing browserId" });
+ }
+ let browserId = sessionId;
+
+ logger.info("Received destroyed webhook from browser service", { browserId });
+
+ const session = await getBrowserSessionByBrowserId(browserId);
+ if (!session) {
+ logger.warn("No session found for destroyed webhook", { browserId });
+ return res.status(200).json({ ok: true });
+ }
+
+ if (session.status === "destroyed") {
+ logger.info("Session already destroyed", { sessionId: session.id, browserId });
+ return res.status(200).json({ ok: true });
+ }
+
+ await updateBrowserSessionStatus(session.id, "destroyed");
+
+ logger.info("Session marked as destroyed via webhook", { sessionId: session.id, browserId });
+
+ return res.status(200).json({ ok: true });
+}
diff --git a/apps/api/src/lib/browser-sessions.ts b/apps/api/src/lib/browser-sessions.ts
index 2cf523917..3b54fd46b 100644
--- a/apps/api/src/lib/browser-sessions.ts
+++ b/apps/api/src/lib/browser-sessions.ts
@@ -105,13 +105,31 @@ export async function updateBrowserSessionActivity(id: string): Promise<void> {
}
}
+export async function getBrowserSessionByBrowserId(
+ browserId: string,
+): Promise<BrowserSessionRow | null> {
+ const { data, error } = await supabase_service
+ .from(TABLE)
+ .select("*")
+ .eq("browser_id", browserId)
+ .single();
+
+ if (error) {
+ if (error.code === "PGRST116") return null;
+ logger.error("Failed to get browser session by browser_id", { error, browserId });
+ throw new Error(`Failed to get browser session by browser_id: ${error.message}`);
+ }
+
+ return data as BrowserSessionRow;
+}
+
export async function updateBrowserSessionStatus(
id: string,
status: BrowserSessionStatus,
): Promise<void> {
const { error } = await supabase_service
.from(TABLE)
- .update({ status, updated_at: new Date().toISOString() })
+ .update({ status, updated_at: new Date().toISOString(), deleted_at: status === "destroyed" ? new Date().toISOString() : null })
.eq("id", id);
if (error) {
diff --git a/apps/api/src/routes/v2.ts b/apps/api/src/routes/v2.ts
index 7a6efdd4b..4a99cdb98 100644
--- a/apps/api/src/routes/v2.ts
+++ b/apps/api/src/routes/v2.ts
@@ -48,6 +48,7 @@ import {
browserExecuteController,
browserDeleteController,
browserListController,
+ browserWebhookDestroyedController,
} from "../controllers/v2/browser";
expressWs(express());
@@ -397,6 +398,11 @@ v2Router.delete(
wrap(browserDeleteController),
);
+v2Router.post(
+ "/browser/webhook/destroyed",
+ wrap(browserWebhookDestroyedController),
+);
+
// Only register x402 routes if X402_PAY_TO_ADDRESS is configured
if (isX402Enabled()) {
v2Router.post(