import type { BrowserPool } from "./browser-pool.js";
import type { SsrfConfig, JsonObject } from "./types.js";
import type { BrowserWsServer } from "./ws-server.js";

export interface BrowserToolExecutionContext {
    readonly toolCallId?: string;
}

export interface ACodeBuiltInToolLike {
    readonly kind: "builtin";
    readonly toolName: string;
    readonly exposedName: string;
    readonly description: string;
    readonly inputSchema: JsonObject;
    execute(args: JsonObject, context?: BrowserToolExecutionContext): Promise<unknown>;
}

export interface CreateBuiltInBrowserToolsOptions {
    pool: BrowserPool;
    wsServer?: BrowserWsServer;
    agentId?: string;
    
    scopeKey?: string;
    
    ssrfConfig?: SsrfConfig;
}

export declare function createBuiltInBrowserTools(options: CreateBuiltInBrowserToolsOptions): ACodeBuiltInToolLike[];