@mearl/native-host 2.7.2 → 2.8.0

package/dist/agentbay-browser.d.ts

@@ -1,168 +0,0 @@
-/** AgentBay browser lifecycle and CDP endpoint resolution. */
-import { type DaemonRecord } from '@mearl/daemon-core';
-import type { BrowserLaunchParams } from '@mearl/browser-core';
-import { type TransferableCookie } from './cdp-backend/cookie-transfer.js';
-export declare const DEFAULT_AGENTBAY_IMAGE_ID = "imgc-0aae4rgl8kvagdv1j";
-export interface AgentBayBrowserRecord extends DaemonRecord {
-    pid: number;
-    browserId: string;
-    name: string;
-    sessionId: string;
-    imageId?: string;
-    userAgentMode?: 'default' | 'desktop';
-    persistent?: boolean;
-    contextId?: string;
-    contextName?: string;
-    /** Successful context sync checkpoint for retrying deletion of the current session. */
-    contextSyncedAt?: string;
-    createdAt: string;
-    copiedCookies?: {
-        domains: string[];
-        count: number;
-    };
-}
-export interface AgentBaySessionLike {
-    sessionId: string;
-    browser: {
-        initializeAsync(options: Record<string, unknown>): Promise<boolean>;
-        getEndpointUrl(): Promise<string>;
-    };
-    info?(): Promise<{
-        success?: boolean;
-        data?: unknown;
-        errorMessage?: string;
-    }>;
-    callMcpTool?(toolName: string, args: Record<string, unknown>, autoGenSession?: boolean): Promise<{
-        success?: boolean;
-        errorMessage?: string;
-    }>;
-    context?: {
-        sync(): Promise<{
-            success: boolean;
-            errorMessage?: string;
-        }>;
-    };
-    fileSystem?: {
-        getFileTransferContextPath(): Promise<string | null>;
-        createDirectory(path: string): Promise<{
-            success?: boolean;
-            error?: string;
-            errorMessage?: string;
-        }>;
-        uploadFile(localPath: string, remotePath: string, options?: {
-            wait?: boolean;
-            waitTimeout?: number;
-        }): Promise<{
-            success?: boolean;
-            error?: string;
-            errorMessage?: string;
-            error_message?: string;
-        }>;
-    };
-    delete(syncContext?: boolean): Promise<{
-        success: boolean;
-        errorMessage?: string;
-    }>;
-    keepAlive(): Promise<{
-        success?: boolean;
-        errorMessage?: string;
-    }>;
-}
-export interface AgentBayClientLike {
-    create(params: Record<string, unknown>): Promise<{
-        success: boolean;
-        session?: AgentBaySessionLike;
-        errorMessage?: string;
-    }>;
-    get(sessionId: string): Promise<{
-        success: boolean;
-        session?: AgentBaySessionLike;
-        errorMessage?: string;
-    }>;
-    context?: {
-        get(name: string, create?: boolean): Promise<{
-            success: boolean;
-            context?: {
-                id: string;
-                name: string;
-            };
-            errorMessage?: string;
-        }>;
-        delete(context: {
-            id: string;
-            name: string;
-        }): Promise<{
-            success: boolean;
-            errorMessage?: string;
-        }>;
-    };
-}
-export interface AgentBayBrowserSummary {
-    browserId: string;
-    name: string;
-    provider: 'agentbay';
-    headless: false;
-    persistent: boolean;
-    agentbaySessionId: string;
-    agentbayImageId?: string;
-    agentbayContextId?: string;
-    agentbayContextName?: string;
-    createdAt: string;
-    copiedCookies?: AgentBayBrowserRecord['copiedCookies'];
-    running: boolean;
-}
-export interface AgentBayBrowserLaunchResult extends AgentBayBrowserSummary {
-    created: boolean;
-    reused: boolean;
-}
-export interface AgentBayBrowserManagerDeps {
-    nativeHostScript: string;
-    exportCookies: (domains: string[]) => Promise<TransferableCookie[]>;
-    getBrowserUserAgent: () => Promise<string>;
-    log: (...args: any[]) => void;
-    createAgentBayClient?: (apiKey: string) => Promise<AgentBayClientLike>;
-    connectCdp?: ConnectAgentBayCdp;
-    findBrowserRecord?: (selector: string) => {
-        record: AgentBayBrowserRecord;
-        running: boolean;
-    } | null;
-    persistBrowserRecord?: (record: AgentBayBrowserRecord) => void;
-    resolveApiKey?: () => string;
-}
-interface AgentBayCdpClient {
-    sendCommand(method: string, params?: Record<string, any>, timeoutMs?: number): Promise<any>;
-    close(): void;
-}
-type ConnectAgentBayCdp = (endpoint: string) => Promise<AgentBayCdpClient>;
-interface AgentBayBrowserSessionInitOptions {
-    userAgent?: string;
-    connectCdp?: ConnectAgentBayCdp;
-}
-/** Stable managed-browser identity while keeping the cloud provider explicit. */
-export declare function agentBayBrowserId(name: string): string;
-export declare function resolveAgentBayApiKey(): string;
-export declare function resolveAgentBayImageId(value: unknown): string;
-export declare function agentBayContextName(browserId: string): string;
-export declare function normalizeDesktopUserAgent(value: unknown): string;
-export declare function normalizeAgentBayAccessUrl(value: unknown): string | undefined;
-export declare function hasAgentBayBrowser(selector: string): boolean;
-export declare function listAgentBayBrowsers(): AgentBayBrowserSummary[];
-export declare function getAgentBaySession(sessionId: string, dependencies?: Pick<AgentBayBrowserManagerDeps, 'createAgentBayClient' | 'resolveApiKey'>): Promise<AgentBaySessionLike>;
-export declare function getAgentBayAccessUrl(sessionId: string, dependencies?: Pick<AgentBayBrowserManagerDeps, 'createAgentBayClient' | 'resolveApiKey'>): Promise<string>;
-export declare function resolveAgentBayEndpoint(sessionId: string): Promise<string>;
-export declare function keepAgentBaySessionAlive(sessionId: string): Promise<void>;
-export declare function initializeAgentBayBrowserSession(session: Pick<AgentBaySessionLike, 'browser'>, input: Pick<BrowserLaunchParams, 'url'>, cookies: TransferableCookie[], options?: AgentBayBrowserSessionInitOptions): Promise<number>;
-export declare function reuseAgentBayBrowserSession(session: Pick<AgentBaySessionLike, 'browser'>, input: Pick<BrowserLaunchParams, 'url'>, cookies: TransferableCookie[], options?: Pick<AgentBayBrowserSessionInitOptions, 'connectCdp'>): Promise<number>;
-export declare function launchAgentBayBrowser(input: BrowserLaunchParams, deps: AgentBayBrowserManagerDeps): Promise<AgentBayBrowserLaunchResult>;
-export declare function releaseAgentBayBrowserResources(record: AgentBayBrowserRecord, agentBay: AgentBayClientLike, options?: {
-    deleteProfile?: boolean;
-    persistRecord?: (record: AgentBayBrowserRecord) => void;
-}): Promise<{
-    sessionDeleted: boolean;
-    contextSynced?: boolean;
-    contextDeleted?: boolean;
-}>;
-export declare function closeAgentBayBrowser(selector: string, options?: {
-    deleteProfile?: boolean;
-}): Promise<Record<string, any>>;
-export {};

package/dist/agentbay-file-upload.d.ts

@@ -1,12 +0,0 @@
-import { type AgentBaySessionLike } from './agentbay-browser.js';
-interface AgentBayPageUploadDependencies {
-    getSession?: (sessionId: string) => Promise<AgentBaySessionLike>;
-    createTransferId?: () => string;
-}
-/**
- * Copies Native Host-local files into the active AgentBay session before CDP selects them.
- * Each file gets an isolated directory so the browser-visible filename stays unchanged.
- * Staged files remain session-scoped because Chromium may read them after the CDP call returns.
- */
-export declare function stageAgentBayPageUploads(sessionId: string, action: string, data: any, dependencies?: AgentBayPageUploadDependencies): Promise<any>;
-export {};

package/dist/agentbay-lifecycle.d.ts

@@ -1,38 +0,0 @@
-export declare const MIN_AGENTBAY_IDLE_RELEASE_MINUTES = 3;
-export declare const DEFAULT_AGENTBAY_IDLE_RELEASE_MINUTES = 30;
-export declare const DEFAULT_AGENTBAY_MAX_RUNTIME_MINUTES = 120;
-export declare const DEFAULT_AGENTBAY_LIFECYCLE_CHECK_INTERVAL_MS = 60000;
-export interface AgentBayLifecycleConfig {
-    idleReleaseTimeout: number;
-    maxRuntime: number;
-}
-interface AgentBaySessionWatchdogOptions {
-    idleTimeoutMs: number;
-    checkIntervalMs?: number;
-    now?: () => number;
-    keepAlive: () => Promise<void>;
-    close: () => Promise<void>;
-    log: (...args: unknown[]) => void;
-}
-export declare function resolveAgentBayLifecycleConfig(env?: NodeJS.ProcessEnv): AgentBayLifecycleConfig;
-export declare class AgentBaySessionWatchdog {
-    private readonly idleTimeoutMs;
-    private readonly checkIntervalMs;
-    private readonly now;
-    private readonly keepAlive;
-    private readonly close;
-    private readonly log;
-    private activeRequests;
-    private lastActivityAt;
-    private timer;
-    private checking;
-    private closing;
-    private stopped;
-    constructor(options: AgentBaySessionWatchdogOptions);
-    start(): void;
-    stop(): void;
-    beginActivity(): boolean;
-    endActivity(): void;
-    checkNow(): Promise<void>;
-}
-export {};

package/dist/analytics.d.ts

@@ -1,3 +0,0 @@
-export declare function setAnalyticsClientId(value: unknown): boolean;
-export declare function classifyAnalyticsError(error: unknown): string;
-export declare function trackAction(action: string, params?: Record<string, string | number | boolean>): void;

package/dist/browser-inventory.d.ts

@@ -1,8 +0,0 @@
-import type { BrowserListResult } from '@mearl/browser-core';
-import { type BrowserRecord } from './browser-registry.js';
-import { type ManagedBrowserSummary } from './managed-browser.js';
-import { type AgentBayBrowserSummary } from './agentbay-browser.js';
-type BrowserInventoryResult = Omit<BrowserListResult, 'defaultBrowserId'>;
-export declare function mergeBrowserInventory(connected: BrowserRecord[], managed: Array<ManagedBrowserSummary | AgentBayBrowserSummary>): BrowserInventoryResult;
-export declare function listBrowserInventory(): BrowserInventoryResult;
-export {};

package/dist/browser-registry.d.ts

@@ -1,78 +0,0 @@
-/**
- * Browser registry — advertises this native-host's connection in a shared,
- * on-disk registry so clients can discover and address multiple browsers at
- * once (multiple Chrome profiles / Chromium-based browsers, each with the
- * extension, each launching its own native-host).
- *
- * Why a registry instead of the old single well-known socket
- * ----------------------------------------------------------
- * Historically every native-host fought over one fixed socket; the last one to
- * start kicked the others off, so at most one browser was reachable and the two
- * flapped on every reconnect. Here each native-host listens on its own unique
- * per-process socket and publishes a record; the client reads the registry and
- * connects to the socket of whichever browser it wants (default: most-recently
- * focused). No contention, N browsers reachable simultaneously.
- *
- * Ownership
- * ---------
- * The record is keyed by the browser's stable installation id, so a browser
- * that reconnects (extension reload → new native-host pid → new socket) simply
- * overwrites its own record. To avoid a briefly-overlapping predecessor wiping
- * the successor's record during a reload, every mutation first checks that the
- * on-disk record still belongs to this process (or is stale) before writing.
- */
-import { type DaemonRecord } from '@mearl/daemon-core';
-export interface BrowserRecord extends DaemonRecord {
-    /** native-host pid — used for liveness pruning. */
-    pid: number;
-    /** Stable per-installation id reported by the extension (or 'cdp' for daemon mode). */
-    browserId: string;
-    /** Absolute path of the per-process socket this native-host listens on. */
-    socketPath: string;
-    /** Human-readable browser name, e.g. "Chrome", "Edge". */
-    browserName: string;
-    extensionVersion?: string;
-    nativeHostVersion: string;
-    transport: 'extension' | 'cdp';
-    /** Epoch ms when this browser window last gained focus; drives default target selection. */
-    lastFocusedAt?: number;
-    startedAt: string;
-    /** Epoch ms of the last record write; latest-wins tiebreak. */
-    updatedAt: number;
-}
-export declare function initBrowserRegistry(deps: {
-    log: (...args: any[]) => void;
-}): void;
-/**
- * Publish (or refresh) this native-host's registry record. Called once the
- * browser identity is known — from the extension handshake, or immediately with
- * a synthetic identity in CDP daemon mode.
- */
-export declare function registerBrowser(info: {
-    browserId: string;
-    socketPath: string;
-    browserName: string;
-    nativeHostVersion: string;
-    transport: 'extension' | 'cdp';
-    extensionVersion?: string;
-    /** Initial focus rank. Managed headless browsers use 0 so they do not steal the default target. */
-    lastFocusedAt?: number;
-}): void;
-/**
- * Mark this browser as most-recently focused, so it becomes the default target.
- * Focus can change in rapid bursts (fast window switching), so writes are
- * throttled: the first change in an interval writes immediately, further changes
- * schedule a single trailing write rather than one write each.
- */
-export declare function touchFocus(): void;
-/** Remove our record on shutdown — but only if it is still ours. */
-export declare function unregisterBrowser(): void;
-/**
- * Reap registry records left behind by native-hosts that exited without
- * cleanup (crashes). Live records are kept; a dead record is kept until it is
- * older than STALE_RECORD_TTL_MS so a quickly-reconnecting browser can still
- * inherit its own last-focus time. Meant to run once at startup.
- */
-export declare function pruneDeadBrowsers(): void;
-/** Live browser connections, ordered by the same focus rank used for default routing. */
-export declare function listRegisteredBrowsers(): BrowserRecord[];

package/dist/cdp-backend/action-registry.d.ts

@@ -1,36 +0,0 @@
-/**
- * CDP action registry.
- *
- * Each handler sub-module registers its actions here. The registry replaces
- * the giant switch/case in handleViaCdp with a data-driven lookup.
- *
- * Two session levels:
- * - `browser`: handler receives CdpSession (for tab management, tdbank, etc.)
- * - `page`:    handler receives PageSession (for most page-level actions)
- */
-import type { BrowserCommandAction, ControlSource } from '@mearl/browser-core';
-import type { CdpSession, PageSession } from './cdp-session.js';
-export interface BrowserAction {
-    name: BrowserCommandAction;
-    session: 'browser';
-    handler: (session: CdpSession, data: any, controlSource: ControlSource) => Promise<any>;
-}
-export interface PageAction {
-    name: BrowserCommandAction;
-    session: 'page';
-    handler: (session: PageSession, data: any, controlSource: ControlSource) => Promise<any>;
-}
-export type CdpAction = BrowserAction | PageAction;
-/** Register one or more CDP actions. Called by each handler sub-module. */
-export declare function registerActions(actions: CdpAction[]): void;
-/** Look up a registered action by name. Returns undefined if not found. */
-export declare function getAction(name: string): CdpAction | undefined;
-/** Get all registered action names (useful for diagnostics). */
-export declare function getRegisteredActionNames(): string[];
-/**
- * Dispatch an action by name.
- *
- * Resolves the appropriate session level and calls the handler.
- * Throws if the action is unknown or CDP is not available.
- */
-export declare function dispatchCdpAction(cdpSession: CdpSession, action: string, data: any, controlSource?: ControlSource): Promise<any>;

package/dist/cdp-backend/browser-handlers.d.ts

@@ -1,8 +0,0 @@
-/**
- * CDP browser-level handlers: screenshot, selected element, user info.
- */
-import type { GetUserInfoParams, PageScreenshotParams, PageSelectedElementParams } from '@mearl/browser-core';
-import type { PageSession } from './cdp-session.js';
-export declare function cdpPageScreenshot(session: PageSession, data: PageScreenshotParams): Promise<any>;
-export declare function cdpPageSelectedElement(session: PageSession, _data: PageSelectedElementParams): Promise<any>;
-export declare function cdpGetUserInfo(session: PageSession, data: GetUserInfoParams): Promise<any>;

package/dist/cdp-backend/buffers.d.ts

@@ -1,53 +0,0 @@
-/**
- * In-memory circular buffers for CDP network requests, console logs, and
- * RUM/tracking events. A single CdpSession subscribes to CDP events and
- * fills these buffers; callers read from them without CDP interaction.
- */
-import type { MtopRequest, RumEvent, ConsoleLog, RequestBufferAccounting } from '@mearl/browser-core';
-import { type CaptureSequenceState } from '@mearl/browser-core';
-import type { CdpClient, CdpChildSession } from './client.js';
-interface PartialRequest extends MtopRequest {
-    id: number;
-    requestId: string;
-    timestamp: string;
-    timestampMs: number;
-    method: string;
-    url: string;
-    apiName: string;
-    headers: Array<{
-        name: string;
-        value: string;
-    }>;
-    postData: any;
-    queryString: Array<{
-        name: string;
-        value: string;
-    }>;
-    status: number;
-    statusText: string;
-    responseHeaders: Array<{
-        name: string;
-        value: string;
-    }>;
-    responseBody: any;
-    isProxy: boolean;
-    proxyRequestUrl: string | null;
-    proxyData: any;
-    startTs?: number;
-}
-export interface CdpBuffers {
-    requests: MtopRequest[];
-    logs: ConsoleLog[];
-    events: RumEvent[];
-    pending: Map<string, PartialRequest>;
-    requestCounter: number;
-    requestBufferAccounting: RequestBufferAccounting;
-    capture: CaptureSequenceState & {
-        droppedRequestsThroughSequence: number;
-        droppedLogsThroughSequence: number;
-        droppedEventsThroughSequence: number;
-    };
-}
-export declare function createBuffers(tabId?: number): CdpBuffers;
-export declare function setupBufferListeners(client: CdpClient | CdpChildSession, buffers: CdpBuffers): Promise<void>;
-export {};

package/dist/cdp-backend/cdp-session.d.ts

@@ -1,74 +0,0 @@
-/**
- * CDP session manager — maintains browser-level and page-level CDP connections.
- *
- * - Browser client: connected to the browser's top-level WebSocket endpoint.
- *   Used for Target.* commands (list/open/close tabs).
- * - Page sessions: per-target connections used for page interaction, screenshots,
- *   and buffered network/log/event collection.
- */
-import { CdpClient, CdpChildSession } from './client.js';
-import { type CdpBuffers } from './buffers.js';
-export interface PageSession {
-    tabId: number;
-    client: CdpClient | CdpChildSession;
-    buffers: CdpBuffers;
-    targetId: string;
-    url: string;
-    emulation?: {
-        mobile: boolean;
-        touch: boolean;
-    };
-}
-export interface CdpSessionOptions {
-    port?: number;
-    userDataDir?: string;
-    endpointUrl?: string;
-    endpointResolver?: () => Promise<string>;
-}
-export declare class CdpSession {
-    readonly port: number;
-    readonly userDataDir?: string;
-    private readonly endpointUrl?;
-    private readonly endpointResolver?;
-    private browserClient;
-    private pageSessions;
-    /** Virtual tabId counter → CDP targetId */
-    private tabIdMap;
-    private nextTabId;
-    constructor(options?: number | CdpSessionOptions);
-    getBrowserClient(): Promise<CdpClient>;
-    /**
-     * Get (or create) a page session.
-     *
-     * @param virtualTabId  Numeric tabId returned by `tab_open` (optional).
-     *                      If omitted, connects to the first available page target.
-     */
-    getPageSession(virtualTabId?: number): Promise<PageSession>;
-    /** Register a newly opened target as a virtual tabId and return the numeric ID. */
-    registerTarget(targetId: string): Promise<number>;
-    /** Return the existing virtual tabId for a target, registering it when first discovered. */
-    ensureTargetRegistered(targetId: string): Promise<number>;
-    private createPageSession;
-    private findTargetById;
-    private findDefaultPageTarget;
-    /** Effective port: from DevToolsActivePort file if present, else this.port */
-    private effectivePort;
-    /**
-     * Resolve the browser-level WebSocket URL.
-     * Priority: DevToolsActivePort file → HTTP /json/version
-     */
-    private resolveBrowserWsUrl;
-    /**
-     * Build a page-level WebSocket URL from a target ID.
-     * Used when HTTP /json is unavailable.
-     */
-    private pageWsUrl;
-    private isRemote;
-    private findTargetByIdViaCdp;
-    private findDefaultPageTargetViaCdp;
-    private fetchVersionInfo;
-    hasActiveConnections(): boolean;
-    listOpenPageSessions(): PageSession[];
-    listRegisteredTabIds(targetIds?: ReadonlySet<string>): number[];
-    close(): void;
-}

package/dist/cdp-backend/cdp-utils.d.ts

@@ -1,67 +0,0 @@
-/**
- * Shared utilities for CDP backend handlers.
- *
- * Contains: HTTP helper (nodeFetch), cookie utilities, page-load waiters,
- * viewport helpers, and serialized function sources for page injection.
- */
-import { type PageClickPointerType, type PageDragPoint, type PageDragPointerType } from '@mearl/browser-core';
-import type { PageSession } from './cdp-session.js';
-export declare const TYPE_INTO_ELEMENT_SRC: string;
-export declare const CLICK_ELEMENT_VIA_JS_SRC: string;
-export declare const GET_CLICK_COORDS_FROM_NODE_SRC: string;
-export interface CdpViewportMetrics {
-    cssLayoutViewport?: {
-        clientWidth?: number;
-        clientHeight?: number;
-    };
-    cssVisualViewport?: {
-        clientWidth?: number;
-        clientHeight?: number;
-        scale?: number;
-    };
-    layoutViewport?: {
-        clientWidth?: number;
-        clientHeight?: number;
-    };
-    visualViewport?: {
-        clientWidth?: number;
-        clientHeight?: number;
-        scale?: number;
-    };
-}
-export declare function nodeFetch(urlStr: string, options?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string | Uint8Array;
-    timeoutMs?: number;
-}): Promise<{
-    status: number;
-    statusText: string;
-    headers: Record<string, string>;
-    body: string;
-    bodyBuffer: Buffer;
-}>;
-export declare function getCookiesForUrl(session: PageSession, targetUrl: string): Promise<Map<string, string>>;
-export declare function decodeTracknick(raw: string): string;
-export declare function buildMultipartFormBody(fields: Record<string, string>): {
-    contentType: string;
-    body: string;
-};
-export declare function waitForPageLoad(session: PageSession, timeoutMs: number): Promise<void>;
-export declare function getPageViewportSize(session: PageSession): Promise<{
-    width: number;
-    height: number;
-} | null>;
-export declare function getCdpInputViewportSize(session: PageSession): Promise<{
-    width: number;
-    height: number;
-} | null>;
-export declare function toCdpInputPoint(session: PageSession, x: number, y: number): Promise<{
-    x: number;
-    y: number;
-}>;
-export declare function dispatchCdpClick(session: PageSession, x: number, y: number, pointerType: PageClickPointerType): Promise<void>;
-export declare function dispatchCdpDrag(session: PageSession, from: PageDragPoint, to: PageDragPoint, pointerType: PageDragPointerType, durationMs: number): Promise<{
-    steps: number;
-}>;
-export declare function resolveBackendNodeObjectId(session: PageSession, backendNodeId: number): Promise<string>;

package/dist/cdp-backend/client.d.ts

@@ -1,34 +0,0 @@
-/** WebSocket CDP client shared by local and remote browser sessions. */
-type EventCallback = (params: any) => void;
-export declare class CdpChildSession {
-    private readonly parent;
-    readonly sessionId: string;
-    constructor(parent: CdpClient, sessionId: string);
-    sendCommand(method: string, params?: Record<string, any>, timeoutMs?: number): Promise<any>;
-    on(method: string, callback: EventCallback): () => void;
-    get closed(): boolean;
-    close(): void;
-}
-export declare class CdpClient {
-    private readonly socket;
-    private nextId;
-    private pending;
-    private eventHandlers;
-    private sessionEventHandlers;
-    private _closed;
-    private constructor();
-    static connect(wsUrl: string): Promise<CdpClient>;
-    createChildSession(sessionId: string): CdpChildSession;
-    sendCommandInSession(sessionId: string, method: string, params?: Record<string, any>, timeoutMs?: number): Promise<any>;
-    onSession(sessionId: string, method: string, callback: EventCallback): () => void;
-    sendCommand(method: string, params?: Record<string, any>, timeoutMs?: number): Promise<any>;
-    on(method: string, callback: EventCallback): () => void;
-    close(): void;
-    get closed(): boolean;
-    private sendRequest;
-    private consumeMessage;
-    private handleMessage;
-    private handleClosed;
-    private rejectPending;
-}
-export {};

package/dist/cdp-backend/composite-handlers.d.ts

@@ -1,17 +0,0 @@
-/**
- * CDP composite action handlers.
- *
- * Provides `run_actions` — sequential batch execution of multiple actions
- * within a single request, sharing the same CDP session — and the observed
- * page-action wrapper that gives page interaction actions their default
- * built-in observation.
- */
-import type { CdpSession } from './cdp-session.js';
-import { type ControlSource, type PageActAction, type RunActionsParams } from '@mearl/browser-core';
-export declare function cdpRunActions(session: CdpSession, data: RunActionsParams, controlSource?: ControlSource): Promise<any>;
-/**
- * Runs a page interaction action with built-in observation. Diagnostics are
- * collected only when the caller requests them.
- * `run_actions` stays lightweight and never enters this wrapper.
- */
-export declare function cdpObservedPageAction(session: CdpSession, action: PageActAction, data: any, controlSource?: ControlSource): Promise<any>;

package/dist/cdp-backend/controlled-indicator.d.ts

@@ -1,18 +0,0 @@
-/**
- * CDP 模式的受控页面视觉标识。
- *
- * 与扩展模式共享同一套 Mearl favicon 变体，本地操作显示绿色圆点角标，云端操作
- * 显示紫色云朵角标。图标通过 data URL 内联到新文档脚本，不依赖扩展资源或网络。
- *
- * 注入通过 Page.addScriptToEvaluateOnNewDocument + runImmediately 完成：脚本在
- * PageSession 存续期内跨导航生效；控制来源变化时替换脚本并立即更新当前文档。
- */
-import { type ControlSource } from '@mearl/browser-core';
-import type { PageSession } from './cdp-session.js';
-/**
- * 确保受控标识已注入到该 page session。相同来源幂等；来源变化时替换跨导航脚本，
- * runImmediately 同步更新当前文档。任何异常都不阻断 agent 动作本身。
- */
-export declare function ensureControlledIndicator(session: PageSession, controlSource?: ControlSource): Promise<void>;
-/** browser_release 使用：停止跨导航注入并恢复当前文档的 favicon。 */
-export declare function releaseControlledIndicator(session: PageSession): Promise<void>;

package/dist/cdp-backend/cookie-handlers.d.ts

@@ -1,5 +0,0 @@
-/** CDP handler for changing one named cookie in the current page scope. */
-import { type GetCookieParams, type SetCookieParams } from '@mearl/browser-core';
-import type { PageSession } from './cdp-session.js';
-export declare function cdpSetCookie(session: PageSession, data: SetCookieParams): Promise<any>;
-export declare function cdpGetCookie(session: PageSession, data: GetCookieParams): Promise<any>;

package/dist/cdp-backend/cookie-transfer.d.ts

@@ -1,30 +0,0 @@
-/** Cookie export/import helpers for copying selected domains between CDP browsers. */
-import type { CdpSession } from './cdp-session.js';
-export interface TransferableCookie {
-    name: string;
-    value: string;
-    domain: string;
-    path: string;
-    secure?: boolean;
-    httpOnly?: boolean;
-    sameSite?: 'Strict' | 'Lax' | 'None';
-    expires?: number;
-    priority?: 'Low' | 'Medium' | 'High';
-    sameParty?: boolean;
-    sourceScheme?: 'Unset' | 'NonSecure' | 'Secure';
-    sourcePort?: number;
-    partitionKey?: {
-        topLevelSite: string;
-        hasCrossSiteAncestor?: boolean;
-    };
-}
-interface CookieCommandClient {
-    sendCommand(method: string, params?: Record<string, any>, timeoutMs?: number): Promise<any>;
-}
-export declare function normalizeCookieDomain(input: string): string;
-export declare function normalizeCookieDomains(inputs: unknown): string[];
-export declare function cookieMatchesDomain(cookieDomain: string, requestedDomain: string): boolean;
-export declare function cdpExportCookies(session: CdpSession, domains: string[]): Promise<TransferableCookie[]>;
-export declare function cdpImportCookies(session: CdpSession, cookies: TransferableCookie[]): Promise<number>;
-export declare function cdpImportCookiesWithClient(browser: CookieCommandClient, cookies: TransferableCookie[]): Promise<number>;
-export {};