@wingman-ai/gateway 0.5.2 → 0.5.4

package/dist/agent/tools/browser_runtime.d.ts

@@ -0,0 +1,560 @@
+import * as z from "zod";
+export declare const DEFAULT_ACTION_TIMEOUT_MS = 30000;
+export declare const BrowserTransportPreferenceSchema: z.ZodEnum<{
+    auto: "auto";
+    playwright: "playwright";
+    relay: "relay";
+}>;
+export declare const BrowserActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"navigate">;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"open">;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"goto">;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"click">;
+    selector: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"type">;
+    selector: z.ZodString;
+    text: z.ZodString;
+    submit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"press">;
+    key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"wait">;
+    ms: z.ZodOptional<z.ZodNumber>;
+    selector: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    load: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    fn: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ms">;
+    ms: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sleep">;
+    ms: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"pause">;
+    ms: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    load: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    fn: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"wait_for">;
+}, z.core.$strip>, z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    load: z.ZodOptional<z.ZodEnum<{
+        load: "load";
+        domcontentloaded: "domcontentloaded";
+        networkidle: "networkidle";
+    }>>;
+    fn: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"wait_until">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"extract_text">;
+    selector: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"selector">;
+    selector: z.ZodString;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"extract">;
+    selector: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"getContent">;
+    selector: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"get_content">;
+    selector: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"querySelector">;
+    selector: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"query_selector">;
+    selector: z.ZodOptional<z.ZodString>;
+    maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"screenshot">;
+    path: z.ZodOptional<z.ZodString>;
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"path">;
+    path: z.ZodString;
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"snapshot">;
+    path: z.ZodString;
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"capture">;
+    path: z.ZodString;
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"evaluate">;
+    expression: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"expression">;
+    expression: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"js">;
+    expression: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"script">;
+    expression: z.ZodString;
+}, z.core.$strip>], "type">;
+export declare const BrowserControlInputSchema: z.ZodObject<{
+    url: z.ZodOptional<z.ZodString>;
+    actions: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"click">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"type">;
+        selector: z.ZodString;
+        text: z.ZodString;
+        submit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"press">;
+        key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"wait">;
+        ms: z.ZodOptional<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        load: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        fn: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"ms">;
+        ms: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"sleep">;
+        ms: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"pause">;
+        ms: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        selector: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        load: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        fn: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"wait_for">;
+    }, z.core.$strip>, z.ZodObject<{
+        selector: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        load: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        fn: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"wait_until">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"extract_text">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"selector">;
+        selector: z.ZodString;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"extract">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"getContent">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"get_content">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"querySelector">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"query_selector">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"screenshot">;
+        path: z.ZodOptional<z.ZodString>;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"snapshot">;
+        path: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"capture">;
+        path: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"evaluate">;
+        expression: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"expression">;
+        expression: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"js">;
+        expression: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"script">;
+        expression: z.ZodString;
+    }, z.core.$strip>], "type">>>>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    transport: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        playwright: "playwright";
+        relay: "relay";
+    }>>;
+}, z.core.$strip>;
+export declare const BrowserSessionActionInputSchema: z.ZodObject<{
+    session_id: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    actions: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"navigate">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"open">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"click">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"type">;
+        selector: z.ZodString;
+        text: z.ZodString;
+        submit: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"press">;
+        key: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"wait">;
+        ms: z.ZodOptional<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        load: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        fn: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"ms">;
+        ms: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"sleep">;
+        ms: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"pause">;
+        ms: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        selector: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        load: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        fn: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"wait_for">;
+    }, z.core.$strip>, z.ZodObject<{
+        selector: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        load: z.ZodOptional<z.ZodEnum<{
+            load: "load";
+            domcontentloaded: "domcontentloaded";
+            networkidle: "networkidle";
+        }>>;
+        fn: z.ZodOptional<z.ZodString>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        type: z.ZodLiteral<"wait_until">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"extract_text">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"selector">;
+        selector: z.ZodString;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"extract">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"getContent">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"get_content">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"querySelector">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"query_selector">;
+        selector: z.ZodOptional<z.ZodString>;
+        maxChars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"screenshot">;
+        path: z.ZodOptional<z.ZodString>;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"path">;
+        path: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"snapshot">;
+        path: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"capture">;
+        path: z.ZodString;
+        fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"evaluate">;
+        expression: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"expression">;
+        expression: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"js">;
+        expression: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"script">;
+        expression: z.ZodString;
+    }, z.core.$strip>], "type">>>>;
+    timeoutMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type BrowserControlInput = z.infer<typeof BrowserControlInputSchema>;
+export type BrowserSessionActionInput = z.infer<typeof BrowserSessionActionInputSchema>;
+export type BrowserAction = z.infer<typeof BrowserActionSchema>;
+export type BrowserTransportPreference = z.infer<typeof BrowserTransportPreferenceSchema>;
+export type BrowserPageLike = {
+    goto: (url: string, options?: {
+        waitUntil?: "domcontentloaded";
+        timeout?: number;
+    }) => Promise<unknown>;
+    bringToFront?: () => Promise<unknown>;
+    click: (selector: string, options?: {
+        timeout?: number;
+    }) => Promise<unknown>;
+    fill: (selector: string, text: string, options?: {
+        timeout?: number;
+    }) => Promise<unknown>;
+    keyboard: {
+        press: (key: string) => Promise<unknown>;
+    };
+    waitForTimeout: (ms: number) => Promise<unknown>;
+    waitForSelector?: (selector: string, options?: {
+        state?: "attached" | "detached" | "visible" | "hidden";
+        timeout?: number;
+    }) => Promise<unknown>;
+    waitForURL?: (url: string | RegExp, options?: {
+        timeout?: number;
+        waitUntil?: "load" | "domcontentloaded" | "networkidle";
+    }) => Promise<unknown>;
+    waitForLoadState?: (state?: "load" | "domcontentloaded" | "networkidle", options?: {
+        timeout?: number;
+    }) => Promise<unknown>;
+    waitForFunction?: (expression: string, arg?: unknown, options?: {
+        timeout?: number;
+    }) => Promise<unknown>;
+    textContent: (selector: string, options?: {
+        timeout?: number;
+    }) => Promise<string | null>;
+    evaluate: (expression: string) => Promise<unknown>;
+    screenshot: (options: {
+        path: string;
+        fullPage?: boolean;
+    }) => Promise<unknown>;
+    title: () => Promise<string>;
+    url: () => string;
+};
+export type BrowserContextLike = {
+    pages: () => BrowserPageLike[];
+    newPage: () => Promise<BrowserPageLike>;
+    close?: () => Promise<unknown>;
+};
+type BrowserLike = {
+    contexts: () => BrowserContextLike[];
+    close: () => Promise<unknown>;
+};
+type LaunchPersistentContextOptions = {
+    executablePath?: string;
+    headless?: boolean;
+    timeout?: number;
+    args?: string[];
+    ignoreDefaultArgs?: string[];
+};
+type PlaywrightLike = {
+    chromium: {
+        connectOverCDP: (wsEndpoint: string, options?: {
+            timeout?: number;
+        }) => Promise<BrowserLike>;
+        launchPersistentContext?: (userDataDir: string, options?: LaunchPersistentContextOptions) => Promise<BrowserContextLike>;
+    };
+};
+interface StartChromeInput {
+    executablePath?: string;
+    headless: boolean;
+    launchTimeoutMs: number;
+    userDataDir: string;
+    chromeArgs?: string[];
+}
+interface StartedChromeSession {
+    wsEndpoint: string;
+    close: () => Promise<void>;
+}
+export type BrowserRuntimeTransport = "cdp" | "persistent-context" | "relay-cdp";
+type BrowserRelayRuntimeConfig = {
+    enabled?: boolean;
+    host?: string;
+    port?: number;
+    requireAuth?: boolean;
+    authToken?: string;
+};
+type ResolvedBrowserRelayConfig = {
+    host: string;
+    port: number;
+    requireAuth: boolean;
+    authToken?: string;
+};
+export interface BrowserControlDependencies {
+    importPlaywright: () => Promise<PlaywrightLike>;
+    startChrome: (input: StartChromeInput) => Promise<StartedChromeSession>;
+    resolveRelayWsEndpoint: (config: ResolvedBrowserRelayConfig, timeoutMs: number) => Promise<string>;
+    mkTempDir: () => string;
+    removeDir: (target: string) => void;
+    now: () => number;
+}
+export interface BrowserControlToolOptions {
+    workspace?: string;
+    configWorkspace?: string;
+    launchTimeoutMs?: number;
+    defaultExecutablePath?: string;
+    browserProfile?: string;
+    browserTransport?: BrowserTransportPreference;
+    relayConfig?: BrowserRelayRuntimeConfig;
+    profilesRootDir?: string;
+    profilePaths?: Record<string, string>;
+    browserExtensions?: string[];
+    extensionsRootDir?: string;
+    extensionPaths?: Record<string, string>;
+    defaultExtensions?: string[];
+    preferPersistentLaunch?: boolean;
+}
+export type BrowserUserDataDirSelection = {
+    userDataDir: string;
+    persistentProfile: boolean;
+    profileId?: string;
+    releaseLock?: () => void;
+};
+export interface BrowserSessionRuntime {
+    workspace: string;
+    configWorkspace: string;
+    now: () => number;
+    headless: boolean;
+    context: BrowserContextLike;
+    userDataDirSelection: BrowserUserDataDirSelection;
+    browserTransport: BrowserRuntimeTransport;
+    transportRequested: BrowserTransportPreference;
+    transportFallbackReason: string | null;
+    reusedExistingCdpSession: boolean;
+    extensionIds: string[];
+    launchedContext: BrowserContextLike | null;
+    browser: BrowserLike | null;
+    chromeSession: StartedChromeSession | null;
+    closed: boolean;
+}
+export interface BrowserExecutionSummary {
+    browser: "chrome-cdp" | "chrome-playwright" | "chrome-relay";
+    transport: BrowserRuntimeTransport;
+    transportRequested: BrowserTransportPreference;
+    transportUsed: BrowserRuntimeTransport;
+    fallbackReason: string | null;
+    mode: "headless" | "headed";
+    persistentProfile: boolean;
+    profileId: string | null;
+    profilePath: string | null;
+    reusedExistingSession: boolean;
+    executionWorkspace: string;
+    configWorkspace: string;
+    extensions: string[];
+    finalUrl: string;
+    title: string;
+    actionResults: Record<string, unknown>[];
+}
+type BrowserSessionOpenInput = Partial<Pick<BrowserControlInput, "headless" | "timeoutMs" | "executablePath" | "transport">>;
+type BrowserSessionExecutionInput = Partial<Pick<BrowserControlInput, "url" | "actions" | "timeoutMs">>;
+export declare const createBrowserDependencies: (dependencies?: Partial<BrowserControlDependencies>) => BrowserControlDependencies;
+export declare function clearStaleDevtoolsArtifacts(userDataDir: string): void;
+export declare function runBrowserAction(page: BrowserPageLike, action: BrowserAction, timeoutMs: number, workspace: string, now: () => number, actionIndex: number): Promise<Record<string, unknown>>;
+export declare function openBrowserSessionRuntime(options?: BrowserControlToolOptions, dependencies?: Partial<BrowserControlDependencies>, input?: BrowserSessionOpenInput): Promise<BrowserSessionRuntime>;
+export declare function executeBrowserSessionRuntime(runtime: BrowserSessionRuntime, input?: BrowserSessionExecutionInput): Promise<BrowserExecutionSummary>;
+export declare function closeBrowserSessionRuntime(runtime: BrowserSessionRuntime, dependencies?: Partial<BrowserControlDependencies>): Promise<void>;
+export {};