docs: document large extension sources

extensions/browser/index.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover index plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";

extensions/browser/src/browser-tool.schema.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover browser tool.schema plugin behavior.
 import { describe, expect, it } from "vitest";
 import { BrowserToolSchema } from "./browser-tool.schema.js";
 import { ACT_MAX_VIEWPORT_DIMENSION } from "./browser/act-policy.js";

extensions/browser/src/browser-tool.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover browser tool plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 const browserClientMocks = vi.hoisted(() => ({

extensions/browser/src/browser/bridge-server.auth.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover bridge server.auth plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { startBrowserBridgeServer, stopBrowserBridgeServer } from "./bridge-server.js";
 import type { ResolvedBrowserConfig } from "./config.js";

extensions/browser/src/browser/browser-proxy-mode.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover browser proxy mode plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   hasChromeProxyControlArg,

extensions/browser/src/browser/browser-utils.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover browser utils plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   appendCdpPath,

extensions/browser/src/browser/cdp-proxy-bypass.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp proxy bypass plugin behavior.
 import http from "node:http";
 import https from "node:https";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";

extensions/browser/src/browser/cdp.helpers.fuzz.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp.helpers.fuzz plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   appendCdpPath,

extensions/browser/src/browser/cdp.helpers.internal.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp.helpers.internal plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { WebSocketServer } from "ws";
 import { rawDataToString } from "../infra/ws.js";

extensions/browser/src/browser/cdp.helpers.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp.helpers plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { resolveCdpReachabilityPolicy } from "./cdp-reachability-policy.js";

extensions/browser/src/browser/cdp.internal.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp.internal plugin behavior.
 import { afterEach, describe, expect, it } from "vitest";
 import { type WebSocket, WebSocketServer } from "ws";
 import { rawDataToString } from "../infra/ws.js";

extensions/browser/src/browser/cdp.screenshot-params.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp.screenshot params plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { withCdpSocket } from "./cdp.helpers.js";
 import { captureScreenshot } from "./cdp.js";

extensions/browser/src/browser/cdp.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover cdp plugin behavior.
 import { createServer } from "node:http";
 import type { AddressInfo } from "node:net";
 import type { Duplex } from "node:stream";

extensions/browser/src/browser/chrome-mcp.snapshot.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chrome mcp.snapshot plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildAiSnapshotFromChromeMcpSnapshot,

extensions/browser/src/browser/chrome-mcp.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chrome mcp plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/chrome.default-browser.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chromeefault browser plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 vi.mock("node:child_process", async () => {

extensions/browser/src/browser/chrome.internal.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chrome.internal plugin behavior.
 import { EventEmitter } from "node:events";
 import fs from "node:fs";
 import fsp from "node:fs/promises";

extensions/browser/src/browser/chrome.loopback-ssrf.integration.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chrome.loopback ssrf.integration plugin behavior.
 import { createServer, type Server } from "node:http";
 import type { AddressInfo } from "node:net";
 import { afterEach, describe, expect, it } from "vitest";

extensions/browser/src/browser/chrome.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chrome plugin behavior.
 import fs from "node:fs";
 import fsp from "node:fs/promises";
 import { createServer } from "node:http";

extensions/browser/src/browser/chrome.version.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover chrome.version plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const execFileSyncMock = vi.hoisted(() => vi.fn());

extensions/browser/src/browser/client-fetch.attach-only.e2e.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover client fetch.attach only plugin behavior.
 import fs from "node:fs/promises";
 import net from "node:net";
 import path from "node:path";

extensions/browser/src/browser/client-fetch.loopback-auth.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover client fetch.loopback auth plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import "../test-support/browser-security.mock.js";

extensions/browser/src/browser/client.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover client plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import {

extensions/browser/src/browser/config.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover config plugin behavior.
 import os from "node:os";
 import path from "node:path";
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";

extensions/browser/src/browser/control-auth.auto-token.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover control auth.auto token plugin behavior.
 import { beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { expectGeneratedTokenPersistedToGatewayAuth } from "../../test-support.js";
 import type { OpenClawConfig } from "../config/config.js";

extensions/browser/src/browser/control-auth.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover control auth plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { OpenClawConfig } from "../../test-support.js";
 import { ensureBrowserControlAuth } from "./control-auth.js";

extensions/browser/src/browser/control-service.plugin-disabled.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover control service.plugin disabled plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const mocks = vi.hoisted(() => ({

extensions/browser/src/browser/doctor.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover doctor plugin behavior.
 import { describe, expect, it } from "vitest";
 import { buildBrowserDoctorReport } from "./doctor.js";
 

extensions/browser/src/browser/errors.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover errors plugin behavior.
 import { describe, expect, it } from "vitest";
 import { BrowserTabNotFoundError } from "./errors.js";
 

extensions/browser/src/browser/navigation-guard.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover navigation guard plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError, type LookupFn } from "../infra/net/ssrf.js";
 import {

extensions/browser/src/browser/output-directories.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover output directories plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/paths.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover paths plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/profiles-service.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover profiles service plugin behavior.
 import fs from "node:fs";
 import path from "node:path";
 import { beforeEach, describe, expect, it, vi } from "vitest";

extensions/browser/src/browser/profiles.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover profiles plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveBrowserConfig } from "./config.js";
 import {

extensions/browser/src/browser/proxy-files.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover proxy files plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { MEDIA_MAX_BYTES } from "openclaw/plugin-sdk/media-runtime";

extensions/browser/src/browser/pw-ai.e2e.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw ai plugin behavior.
 import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
 import { connectOverCdpMock, getChromeWebSocketUrlMock } from "./pw-session.mock-setup.js";
 

extensions/browser/src/browser/pw-role-snapshot.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw role snapshot plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   buildRoleSnapshotFromAiSnapshot,

extensions/browser/src/browser/pw-session.assert-navigation-safety.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw session.assert navigation safety plugin behavior.
 import type { Page } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError } from "../infra/net/ssrf.js";

extensions/browser/src/browser/pw-session.browserless.live.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw sessionless plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isLiveTestEnabled } from "../../test-support.js";
 

extensions/browser/src/browser/pw-session.connections.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw session.connections plugin behavior.
 import { chromium } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import * as chromeModule from "./chrome.js";

extensions/browser/src/browser/pw-session.create-page.navigation-guard.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw session.create page.navigation guard plugin behavior.
 import { chromium } from "playwright-core";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError } from "../infra/net/ssrf.js";

extensions/browser/src/browser/pw-session.dialogs.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw sessionialogs plugin behavior.
 import { MAX_DATE_TIMESTAMP_MS } from "openclaw/plugin-sdk/number-runtime";
 import type { Dialog, Page } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";

extensions/browser/src/browser/pw-session.get-page-for-targetid.extension-fallback.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw session.get page for targetid.extension fallback plugin behavior.
 import { chromium } from "playwright-core";
 import { afterEach, describe, expect, it, vi } from "vitest";
 import * as chromeModule from "./chrome.js";

extensions/browser/src/browser/pw-session.page-cdp.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw session.page cdp plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   BROWSER_REF_MARKER_ATTRIBUTE,

extensions/browser/src/browser/pw-session.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw session plugin behavior.
 import fs from "node:fs/promises";
 import path from "node:path";
 import type { Page } from "playwright-core";

extensions/browser/src/browser/pw-tools-core.browser-ssrf-guard.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core ssrf guard plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const pageState = vi.hoisted(() => ({

extensions/browser/src/browser/pw-tools-core.clamps-timeoutms-scrollintoview.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.clamps timeoutms scrollintoview plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   installPwToolsCoreTestHooks,

extensions/browser/src/browser/pw-tools-core.interactions.batch.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.batch plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 let page: {

extensions/browser/src/browser/pw-tools-core.interactions.evaluate.abort.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.evaluate.abort plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 let page: { evaluate: ReturnType<typeof vi.fn>; url: ReturnType<typeof vi.fn> } | null = null;

extensions/browser/src/browser/pw-tools-core.interactions.navigation-guard.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.navigation guard plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   getPwToolsCoreNavigationGuardMocks,

extensions/browser/src/browser/pw-tools-core.interactions.set-input-files.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.interactions.set input files plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 let page: Record<string, unknown> | null = null;

extensions/browser/src/browser/pw-tools-core.last-file-chooser-arm-wins.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.last file chooser arm wins plugin behavior.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";

extensions/browser/src/browser/pw-tools-core.screenshots-element-selector.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.screenshots element selector plugin behavior.
 import crypto from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";

extensions/browser/src/browser/pw-tools-core.shared.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.shared plugin behavior.
 import { describe, expect, it } from "vitest";
 import { normalizeTimeoutMs } from "./pw-tools-core.shared.js";
 

extensions/browser/src/browser/pw-tools-core.snapshot.navigate-guard.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.snapshot.navigate guard plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { SsrFBlockedError } from "../infra/net/ssrf.js";
 import "../test-support/browser-security.mock.js";

extensions/browser/src/browser/pw-tools-core.snapshot.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.snapshot plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const getPageForTargetId = vi.fn();

extensions/browser/src/browser/pw-tools-core.upload-paths.test.ts

@@ -1,12 +1,17 @@
+// Browser tests cover pw tools core.upload paths plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
-import { installPwToolsCoreTestHooks, setPwToolsCoreCurrentPage } from "./pw-tools-core.test-harness.js";
+import {
+  installPwToolsCoreTestHooks,
+  setPwToolsCoreCurrentPage,
+} from "./pw-tools-core.test-harness.js";
 
 const pathMocks = vi.hoisted(() => ({
-  resolveStrictExistingUploadPaths: vi.fn<
-    (args: { requestedPaths: string[] }) => Promise<
-      { ok: true; paths: string[] } | { ok: false; error: string }
-    >
-  >(),
+  resolveStrictExistingUploadPaths:
+    vi.fn<
+      (args: {
+        requestedPaths: string[];
+      }) => Promise<{ ok: true; paths: string[] } | { ok: false; error: string }>
+    >(),
 }));
 
 vi.mock("./paths.js", async (importOriginal) => {

extensions/browser/src/browser/pw-tools-core.waits-next-download-saves-it.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover pw tools core.waits next download saves it plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/request-policy.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover request policy plugin behavior.
 import { describe, expect, it } from "vitest";
 import { isPersistentBrowserProfileMutation } from "./request-policy.js";
 import { matchBrowserUrlPattern } from "./url-pattern.js";

extensions/browser/src/browser/routes/agent.act.existing-session-navigation-guard.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.act.existing session navigation guard plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   createExistingSessionAgentSharedModule,

extensions/browser/src/browser/routes/agent.act.normalize.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.act.normalize plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_SAFE_TIMEOUT_DELAY_MS } from "../timer-delay.js";
 import { normalizeActRequest } from "./agent.act.normalize.js";

extensions/browser/src/browser/routes/agent.existing-session.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.existing session plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { EXISTING_SESSION_LIMITS } from "./existing-session-limits.js";
 import {

extensions/browser/src/browser/routes/agent.shared.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.shared plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import type { BrowserRouteContext, ProfileContext } from "../server-context.js";
 import "../../test-support/browser-security.mock.js";

extensions/browser/src/browser/routes/agent.snapshot.local-managed.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot.local managed plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 import type { BrowserRequest } from "./types.js";

extensions/browser/src/browser/routes/agent.snapshot.plan.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot.plan plugin behavior.
 import { describe, expect, it } from "vitest";
 import type { ResolvedBrowserProfile } from "../config.js";
 import { DEFAULT_AI_SNAPSHOT_MAX_CHARS } from "../constants.js";

extensions/browser/src/browser/routes/agent.snapshot.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveTargetIdAfterNavigate } from "./agent.snapshot-target.js";
 

extensions/browser/src/browser/routes/agent.snapshot.timeout.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.snapshot.timeout plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 

extensions/browser/src/browser/routes/agent.storage.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover agent.storage plugin behavior.
 import { describe, expect, it } from "vitest";
 import {
   parseCookieSetOptions,

extensions/browser/src/browser/routes/basic.existing-session.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover basic.existing session plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 

extensions/browser/src/browser/routes/dispatcher.abort.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover dispatcher.abort plugin behavior.
 import { beforeAll, describe, expect, it, vi } from "vitest";
 import type { BrowserRouteContext } from "../server-context.js";
 

extensions/browser/src/browser/routes/permissions.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover permissions plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";
 

extensions/browser/src/browser/routes/route-numeric.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover route numeric plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_SAFE_TIMEOUT_DELAY_MS } from "../timer-delay.js";
 import { readRouteTimerTimeoutMs } from "./route-numeric.js";

extensions/browser/src/browser/routes/tabs.attach-only.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover tabs.attach only plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import "../../../test-support.js";
 import "../server-context.chrome-test-harness.js";

extensions/browser/src/browser/routes/tabs.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover tabs plugin behavior.
 import { MAX_TIMER_TIMEOUT_MS } from "openclaw/plugin-sdk/number-runtime";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteApp, createBrowserRouteResponse } from "./test-helpers.js";

extensions/browser/src/browser/runtime-lifecycle.unhandled-rejections.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover runtime lifecycle.unhandled rejections plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { getUnhandledRejectionHandlers, registerUnhandledRejectionHandlerMock, resetHandlers } =

extensions/browser/src/browser/screenshot.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover screenshot plugin behavior.
 import fs from "node:fs/promises";
 import { getImageMetadata } from "openclaw/plugin-sdk/media-runtime";
 import { createSolidPngBuffer } from "openclaw/plugin-sdk/test-fixtures";

extensions/browser/src/browser/server-context.ensure-browser-available.waits-for-cdp-ready.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.ensure browser available.waits for cdp ready plugin behavior.
 import type { ChildProcessWithoutNullStreams } from "node:child_process";
 import { EventEmitter } from "node:events";
 import { afterEach, describe, expect, it, vi } from "vitest";

extensions/browser/src/browser/server-context.existing-session.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.existing session plugin behavior.
 import fs from "node:fs";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import "../test-support/browser-security.mock.js";

extensions/browser/src/browser/server-context.hot-reload-profiles.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.hot reload profiles plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import type { BrowserServerState } from "./server-context.types.js";
 

extensions/browser/src/browser/server-context.lifecycle.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.lifecycle plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveIdleProfileStopOutcome } from "./server-context.lifecycle.js";
 import { makeBrowserProfile } from "./server-context.test-harness.js";

extensions/browser/src/browser/server-context.list-profiles.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.list profiles plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import "./server-context.chrome-test-harness.js";
 import * as chromeModule from "./chrome.js";

extensions/browser/src/browser/server-context.loopback-direct-ws.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.loopback direct ws plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { withBrowserFetchPreconnect } from "../../test-fetch.js";
 import * as cdpModule from "./cdp.js";

extensions/browser/src/browser/server-context.remote-profile-tab-ops.fallback.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.remote profile tab ops.fallback plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import { withBrowserFetchPreconnect } from "../../test-fetch.js";
 import {

extensions/browser/src/browser/server-context.remote-profile-tab-ops.playwright.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.remote profile tab ops.playwright plugin behavior.
 import { describe, expect, it, vi } from "vitest";
 import {
   installRemoteProfileTestLifecycle,

extensions/browser/src/browser/server-context.reset.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.reset plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/server-context.stop-running-browser.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.stop running browser plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { createBrowserRouteContext } from "./server-context.js";
 import { makeBrowserProfile, makeBrowserServerState } from "./server-context.test-harness.js";

extensions/browser/src/browser/server-context.tab-selection-state.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server context.tab selection state plugin behavior.
 import { afterEach, describe, expect, it, vi } from "vitest";
 import { withBrowserFetchPreconnect } from "../../test-fetch.js";
 import "../test-support/browser-security.mock.js";

extensions/browser/src/browser/server-lifecycle.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server lifecycle plugin behavior.
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 const { stopOpenClawChromeMock } = vi.hoisted(() => ({

extensions/browser/src/browser/server.agent-contract-core.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server.agent contract core plugin behavior.
 import fs from "node:fs";
 import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
 import { DEFAULT_AI_SNAPSHOT_MAX_CHARS } from "./constants.js";

extensions/browser/src/browser/server.agent-contract-form-layout-act-commands.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server.agent contract form layout act commands plugin behavior.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/server.auth-fail-closed.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server.auth fail closed plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { startBrowserControlServerFromConfig, stopBrowserControlServer } from "../server.js";
 import { getFreePort } from "./test-port.js";

extensions/browser/src/browser/server.auth-token-gates-http.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server.auth token gates http plugin behavior.
 import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
 import { afterEach, beforeAll, beforeEach, describe, expect, it } from "vitest";
 import { isAuthorizedBrowserRequest } from "./http-auth.js";

extensions/browser/src/browser/server.evaluate-disabled-does-not-block-storage.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover server.evaluate disabled does not block storage plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { getFreePort } from "./test-port.js";
 import { getBrowserTestFetch } from "./test-support/fetch.js";

extensions/browser/src/browser/session-tab-cleanup.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover session tab cleanup plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   isPrimaryTrackedBrowserSessionKey,

extensions/browser/src/browser/session-tab-registry.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover session tab registry plugin behavior.
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import {
   countTrackedSessionBrowserTabsForTests,

extensions/browser/src/browser/target-id.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover target id plugin behavior.
 import { describe, expect, it } from "vitest";
 import { resolveTargetIdFromTabs } from "./target-id.js";
 

extensions/browser/src/browser/timer-delay.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover timer delay plugin behavior.
 import { describe, expect, it } from "vitest";
 import { MAX_SAFE_TIMEOUT_DELAY_MS, normalizeBrowserTimerDelayMs } from "./timer-delay.js";
 

extensions/browser/src/browser/trash.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover trash plugin behavior.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/browser/vision.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover vision plugin behavior.
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

extensions/browser/src/cli/browser-cli-actions-input/register.element.test.ts

@@ -1,3 +1,4 @@
+// Browser tests cover register.element plugin behavior.
 import { Command } from "commander";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 import * as browserCliSharedModule from "../browser-cli-shared.js";