import fs from "node:fs";

import path from "node:path";

import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";

import { beforeAll, describe, expect, it, vi } from "vitest";

import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";

import {

browserPluginNodeHostCommands,

browserPluginReload,

handleBrowserGatewayRequest: vi.fn(),

registerBrowserCli: vi.fn(),

runBrowserProxyCommand: vi.fn(async () => "ok"),

stopBrowserControlService: vi.fn(async () => undefined),

}));

vi.mock("./register.runtime.js", async () => {

registerBrowserCli: runtimeApiMocks.registerBrowserCli,

}));

vi.mock("./src/control-service.js", () => ({

stopBrowserControlService: runtimeApiMocks.stopBrowserControlService,

}));

beforeAll(async () => {

await import("./register.runtime.js");

});

beforeEach(() => {

vi.clearAllMocks();

});

afterEach(() => {

vi.unstubAllEnvs();

});

function createApi() {

const registerCli = vi.fn();

const registerGatewayMethod = vi.fn();

expect(runtimeApiMocks.collectBrowserSecurityAuditFindings).toHaveBeenCalled();

});

it("lazy-loads the browser service on start", async () => {

it("registers a lazy browser control service", async () => {

const { api, registerService } = createApi();

registerBrowserPlugin(api);

expect(typeof service?.stop).toBe("function");

expect(runtimeApiMocks.createBrowserPluginService).not.toHaveBeenCalled();

await service.start({ config: {}, stateDir: "/tmp/openclaw", logger: { warn: vi.fn() } });

expect(runtimeApiMocks.createBrowserPluginService).not.toHaveBeenCalled();

await service.stop({ config: {}, stateDir: "/tmp/openclaw", logger: { warn: vi.fn() } });

expect(runtimeApiMocks.stopBrowserControlService).toHaveBeenCalledOnce();

});

it("eager-loads the browser control service when explicitly requested", async () => {

vi.stubEnv("OPENCLAW_EAGER_BROWSER_CONTROL_SERVER", "1");

const { api, registerService } = createApi();

registerBrowserPlugin(api);

const service = mockCallArg(registerService) as {

id: string;

start: (...args: unknown[]) => unknown;

};

await service.start({ config: {}, stateDir: "/tmp/openclaw", logger: { warn: vi.fn() } });

expect(runtimeApiMocks.createBrowserPluginService).toHaveBeenCalledOnce();

});

for (const value of ["false", "", "disabled"]) {

it(`keeps browser control service env value ${JSON.stringify(value)} lazy`, async () => {

vi.stubEnv("OPENCLAW_EAGER_BROWSER_CONTROL_SERVER", value);

const { api, registerService } = createApi();

registerBrowserPlugin(api);

const service = mockCallArg(registerService) as {

id: string;

start: (...args: unknown[]) => unknown;

};

await service.start({ config: {}, stateDir: "/tmp/openclaw", logger: { warn: vi.fn() } });

expect(runtimeApiMocks.createBrowserPluginService).not.toHaveBeenCalled();

});

}

it("declares setup auto-enable reasons for browser config surfaces", () => {

const probe = registerBrowserAutoEnableProbe();