@mearl/native-host 2.0.2 → 2.2.0

package/README.md

@@ -85,7 +85,7 @@ qodercli
 MEARL_QODER_PATH=/absolute/path/to/qodercli
 ```
 
-侧边栏中未选择本地目录时，Codex 对话使用只读沙箱且不允许提权，Qoder 对话通过首条提示词约束为只读模式；选择后才使用该目录作为可写工作区。`MEARL_AGENT_CWD` 仅用于 Codex 只读对话的默认浏览目录，不会开启写权限；Qoder 未选目录时从用户主目录开始浏览。Agent 接入由统一 Provider 接口承载，后续可新增 Claude 等实现而无需修改扩展与 native-host 之间的 Chat 协议。只安装 ChatGPT 等桌面聊天客户端不能替代 Provider CLI；侧边栏会在 CLI 缺失时展示安装与登录指引。
+侧边栏 Agent 不使用只读或工作区沙箱限制，文件、命令和网络操作由 Provider 的审批机制控制。用户选择的本地目录只作为对话的参考上下文和相对路径起点，不限制 Agent 可访问的范围；未选择时从用户主目录开始，Codex 可通过 `MEARL_AGENT_CWD` 覆盖默认起点。Agent 接入由统一 Provider 接口承载，后续可新增 Claude 等实现而无需修改扩展与 native-host 之间的 Chat 协议。只安装 ChatGPT 等桌面聊天客户端不能替代 Provider CLI；侧边栏会在 CLI 缺失时展示安装与登录指引。
 
 ## 构建
 

package/dist/agent/codex-provider.d.ts

@@ -8,6 +8,7 @@ export declare function externalOpenCommand(url: string, platform?: NodeJS.Platf
 export declare class CodexAgentProvider implements AgentProvider {
     private readonly log;
     private readonly clientVersion;
+    private readonly mearlSocketPath?;
     readonly id = "codex";
     private process;
     private initialized;
@@ -17,8 +18,10 @@ export declare class CodexAgentProvider implements AgentProvider {
     private listeners;
     private knownThreadIds;
     private sessionModels;
-    constructor(log: (...args: any[]) => void, clientVersion: string);
+    private readonly executableResolver;
+    constructor(log: (...args: any[]) => void, clientVersion: string, mearlSocketPath?: string | undefined);
     getDescriptor(): Promise<AgentChatProviderDescriptor>;
+    prepare(): Promise<void>;
     onEvent(listener: (event: AgentProviderEvent) => void): () => void;
     listSessions(options: AgentProviderListSessionsOptions): Promise<AgentProviderListSessionsResult>;
     listSkills(cwd?: string): Promise<AgentInstalledSkill[]>;
@@ -44,4 +47,5 @@ export declare class CodexAgentProvider implements AgentProvider {
     private extractThreadId;
     private probeExecutable;
     private resolveExecutable;
+    private resolveExecutableCandidates;
 }

package/dist/agent/executable-resolver.d.ts

@@ -0,0 +1,34 @@
+export type AgentExecutableResolution = {
+    executable: string;
+    error: null;
+} | {
+    executable: null;
+    error: string;
+};
+interface AgentExecutableResolverOptions {
+    candidates: () => string[];
+    probe: (executable: string) => Promise<string | null>;
+    notFoundError: string;
+    unusableError: string;
+    onFailure?: (executable: string, error: string) => void;
+}
+interface AgentExecutableProbeOptions {
+    args: string[];
+    timeoutMs: number;
+    timeoutError: string;
+    startError: (error: Error) => string;
+    exitError: (code: number | null) => string;
+}
+export declare class AgentExecutableResolver {
+    private readonly options;
+    private resolvedExecutable;
+    private resolutionPromise;
+    private generation;
+    constructor(options: AgentExecutableResolverOptions);
+    resolve(): Promise<AgentExecutableResolution>;
+    reset(): void;
+    private probeCandidates;
+}
+export declare function executableFileCandidates(candidates: Array<string | null | undefined>): string[];
+export declare function probeAgentExecutable(executable: string, options: AgentExecutableProbeOptions): Promise<string | null>;
+export {};

package/dist/agent/manager.d.ts

@@ -1,4 +1,4 @@
-import type { AgentChatEvent, AgentChatCloseOptions, AgentChatEventsOptions, AgentChatEventsResult, AgentChatInterruptOptions, AgentChatListSessionsOptions, AgentChatListSessionsResult, AgentChatOpenOptions, AgentChatRefreshResult, AgentChatRespondOptions, AgentChatSendOptions, AgentChatSession, AgentChatStartOptions, AgentChatStatus, AgentInstalledSkill, AgentSkillReadResult } from '@mearl/browser-core';
+import type { AgentChatEvent, AgentChatEventsOptions, AgentChatEventsResult, AgentChatListSessionsOptions, AgentChatListSessionsResult, AgentChatPrepareOptions, AgentChatRefreshResult, AgentChatRespondOptions, AgentChatSendOptions, AgentChatSession, AgentChatSessionTarget, AgentChatStartOptions, AgentChatStatus, AgentInstalledSkill, AgentSkillInstalledListOptions, AgentSkillReadOptions, AgentSkillReadResult } from '@mearl/browser-core';
 import type { AgentProvider } from './provider.js';
 export declare class AgentChatManager {
     private readonly emit;
@@ -14,23 +14,17 @@ export declare class AgentChatManager {
     private readonly unsubscribe;
     constructor(providers: AgentProvider[], emit: (event: AgentChatEvent) => void);
     getStatus(): Promise<AgentChatStatus>;
-    listSkills(options: {
-        providerId?: unknown;
-        cwd?: unknown;
-    }): Promise<AgentInstalledSkill[]>;
-    readSkill(options: {
-        providerId?: unknown;
-        path?: unknown;
-        cwd?: unknown;
-    }): Promise<AgentSkillReadResult>;
+    prepare(options: AgentChatPrepareOptions): Promise<void>;
+    listSkills(options: AgentSkillInstalledListOptions): Promise<AgentInstalledSkill[]>;
+    readSkill(options: AgentSkillReadOptions): Promise<AgentSkillReadResult>;
     listSessions(options: AgentChatListSessionsOptions): Promise<AgentChatListSessionsResult>;
     startSession(options: AgentChatStartOptions): Promise<AgentChatSession>;
     sendMessage(options: AgentChatSendOptions): Promise<{
         turnId: string;
     }>;
-    interrupt(options: AgentChatInterruptOptions): Promise<void>;
-    openSession(options: AgentChatOpenOptions): Promise<void>;
-    closeSession(options: AgentChatCloseOptions): Promise<void>;
+    interrupt(options: AgentChatSessionTarget): Promise<void>;
+    openSession(options: AgentChatSessionTarget): Promise<void>;
+    closeSession(options: AgentChatSessionTarget): Promise<void>;
     getEvents(options: AgentChatEventsOptions): AgentChatEventsResult;
     refreshSession(options: AgentChatEventsOptions): Promise<AgentChatRefreshResult>;
     respondToRequest(options: AgentChatRespondOptions): void;

package/dist/agent/provider.d.ts

@@ -1,4 +1,4 @@
-import type { AgentChatEventKind, AgentChatImageInput, AgentChatModelInfo, AgentChatProviderDescriptor, AgentInstalledSkill } from '@mearl/browser-core';
+import type { AgentChatEventKind, AgentChatImageInput, AgentChatListSessionsOptions, AgentChatModelInfo, AgentChatProviderDescriptor, AgentChatSessionSummary, AgentInstalledSkill } from '@mearl/browser-core';
 export interface AgentProviderEvent {
     providerSessionId?: string;
     kind: AgentChatEventKind;
@@ -12,16 +12,8 @@ export interface AgentProviderSessionOptions {
     developerInstructions?: string;
     ephemeral?: boolean;
 }
-export interface AgentProviderSessionSummary {
-    providerSessionId: string;
-    title?: string;
-    cwd?: string;
-    updatedAt?: number;
-    ephemeral?: boolean;
-}
-export interface AgentProviderListSessionsOptions {
-    cwd?: string;
-    cursor?: string;
+export type AgentProviderSessionSummary = Omit<AgentChatSessionSummary, 'providerId'>;
+export interface AgentProviderListSessionsOptions extends Omit<AgentChatListSessionsOptions, 'providerId' | 'limit'> {
     limit: number;
 }
 export interface AgentProviderListSessionsResult {
@@ -36,6 +28,7 @@ export interface AgentProviderResumeResult {
 export interface AgentProvider {
     readonly id: string;
     getDescriptor(): Promise<AgentChatProviderDescriptor>;
+    prepare(): Promise<void>;
     onEvent(listener: (event: AgentProviderEvent) => void): () => void;
     listSessions?(options: AgentProviderListSessionsOptions): Promise<AgentProviderListSessionsResult>;
     listSkills?(cwd?: string): Promise<AgentInstalledSkill[]>;

package/dist/agent/qoder-provider.d.ts

@@ -18,8 +18,10 @@ export declare class QoderAgentProvider implements AgentProvider {
     private pendingPermissions;
     private historyCaptures;
     private nextTurnId;
+    private readonly executableResolver;
     constructor(log: (...args: any[]) => void, clientVersion: string);
     getDescriptor(): Promise<AgentChatProviderDescriptor>;
+    prepare(): Promise<void>;
     onEvent(listener: (event: AgentProviderEvent) => void): () => void;
     listSessions(options: AgentProviderListSessionsOptions): Promise<AgentProviderListSessionsResult>;
     listSkills(cwd?: string): Promise<AgentInstalledSkill[]>;
@@ -48,5 +50,6 @@ export declare class QoderAgentProvider implements AgentProvider {
     private probeExecutable;
     private runSkillsList;
     private resolveExecutable;
+    private resolveExecutableCandidates;
     private emit;
 }

package/dist/agent/skill-manager.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSkillCheckUpdatesResult, AgentSkillCliStatus, AgentSkillInstallOptions, AgentSkillMutationOptions, AgentSkillMutationResult, AgentSkillScope, AgentSkillUpdate } from '@mearl/browser-core';
+import type { AgentSkillCheckUpdatesResult, AgentSkillCheckUpdatesOptions, AgentSkillCliStatus, AgentSkillInstallOptions, AgentSkillMutationOptions, AgentSkillMutationResult, AgentSkillScope, AgentSkillUpdate } from '@mearl/browser-core';
 interface SkillCliOutput {
     stdout: string;
     stderr: string;
@@ -17,10 +17,7 @@ export declare class AgentSkillManager {
     constructor(options?: AgentSkillManagerOptions);
     getStatus(): Promise<AgentSkillCliStatus>;
     install(data: AgentSkillInstallOptions): Promise<AgentSkillMutationResult>;
-    checkUpdates(data: {
-        providerId?: unknown;
-        cwd?: unknown;
-    }): Promise<AgentSkillCheckUpdatesResult>;
+    checkUpdates(data: AgentSkillCheckUpdatesOptions): Promise<AgentSkillCheckUpdatesResult>;
     update(data: AgentSkillMutationOptions): Promise<AgentSkillMutationResult>;
     uninstall(data: AgentSkillMutationOptions): Promise<AgentSkillMutationResult>;
     private mutationContext;

package/dist/analytics.d.ts

@@ -1 +1,3 @@
+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,33 +1,7 @@
+import type { BrowserListResult } from '@mearl/browser-core';
 import { type BrowserRecord } from './browser-registry.js';
 import { type ManagedBrowserSummary } from './managed-browser.js';
-export type BrowserStatus = 'connected' | 'running_disconnected' | 'stopped';
-interface BrowserInventoryBase {
-    browserId: string;
-    name: string;
-    status: BrowserStatus;
-    extensionVersion?: string;
-    nativeHostVersion?: string;
-    transport?: 'extension' | 'cdp';
-}
-export interface RegularBrowserInventoryItem extends BrowserInventoryBase {
-    type: 'regular';
-    status: 'connected';
-}
-export interface ManagedBrowserInventoryItem extends BrowserInventoryBase {
-    type: 'managed';
-    headless: boolean;
-    persistent: boolean;
-    cdpPort: number;
-    createdAt: string;
-    account?: ManagedBrowserSummary['account'];
-    copiedCookies?: ManagedBrowserSummary['copiedCookies'];
-}
-export type BrowserInventoryItem = RegularBrowserInventoryItem | ManagedBrowserInventoryItem;
-export interface BrowserInventoryResult {
-    count: number;
-    connectedCount: number;
-    browsers: BrowserInventoryItem[];
-}
+type BrowserInventoryResult = Omit<BrowserListResult, 'defaultBrowserId'>;
 export declare function mergeBrowserInventory(connected: BrowserRecord[], managed: ManagedBrowserSummary[]): BrowserInventoryResult;
 export declare function listBrowserInventory(): BrowserInventoryResult;
 export {};

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

@@ -8,16 +8,17 @@
  * - `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: string;
+    name: BrowserCommandAction;
     session: 'browser';
-    handler: (session: CdpSession, data: any) => Promise<any>;
+    handler: (session: CdpSession, data: any, controlSource: ControlSource) => Promise<any>;
 }
 export interface PageAction {
-    name: string;
+    name: BrowserCommandAction;
     session: 'page';
-    handler: (session: PageSession, data: any) => Promise<any>;
+    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. */
@@ -32,4 +33,4 @@ export declare function getRegisteredActionNames(): string[];
  * 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): Promise<any>;
+export declare function dispatchCdpAction(cdpSession: CdpSession, action: string, data: any, controlSource?: ControlSource): Promise<any>;

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

@@ -1,7 +1,8 @@
 /**
  * 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: any): Promise<any>;
-export declare function cdpPageSelectedElement(session: PageSession, _data: any): Promise<any>;
-export declare function cdpGetUserInfo(session: PageSession, data: any): Promise<any>;
+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

@@ -3,7 +3,7 @@
  * 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 } from '@mearl/browser-core';
+import type { MtopRequest, RumEvent, ConsoleLog, RequestBufferAccounting } from '@mearl/browser-core';
 import type { CdpClient, CdpChildSession } from './client.js';
 interface PartialRequest {
     id: number;
@@ -40,6 +40,7 @@ export interface CdpBuffers {
     events: RumEvent[];
     pending: Map<string, PartialRequest>;
     requestCounter: number;
+    requestBufferAccounting: RequestBufferAccounting;
 }
 export declare function createBuffers(): CdpBuffers;
 export declare function setupBufferListeners(client: CdpClient | CdpChildSession, buffers: CdpBuffers): void;

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

@@ -60,5 +60,8 @@ export declare class CdpSession {
     private findTargetByIdViaCdp;
     private findDefaultPageTargetViaCdp;
     private fetchVersionInfo;
+    hasActiveConnections(): boolean;
+    listOpenPageSessions(): PageSession[];
+    listRegisteredTabIds(targetIds?: ReadonlySet<string>): number[];
     close(): void;
 }

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

@@ -7,8 +7,8 @@
  * built-in observation.
  */
 import type { CdpSession } from './cdp-session.js';
-import { type PageActAction } from '@mearl/browser-core';
-export declare function cdpRunActions(session: CdpSession, data: any): Promise<any>;
+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: executes the raw
  * handler inside `runPageAct` and reports resulting page changes / navigation
@@ -16,4 +16,4 @@ export declare function cdpRunActions(session: CdpSession, data: any): Promise<a
  * dispatches the raw handler directly. `run_actions` steps never go through
  * this wrapper — they use dispatchCdpAction and stay lightweight.
  */
-export declare function cdpObservedPageAction(session: CdpSession, action: PageActAction, data: any): Promise<any>;
+export declare function cdpObservedPageAction(session: CdpSession, action: PageActAction, data: any, controlSource?: ControlSource): Promise<any>;

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

@@ -1,17 +1,18 @@
 /**
  * CDP 模式的受控页面视觉标识。
  *
- * 与扩展模式的 favicon 替换保持一致：agent 操作过的页面把 favicon 换成 Mearl
- * 图标。CDP 模式拿不到扩展资源，图标以 data URL 内联在注入脚本里，不依赖任何
- * 网络请求。
+ * 与扩展模式共享同一套 Mearl favicon 变体，本地操作显示绿色圆点角标，云端操作
+ * 显示紫色云朵角标。图标通过 data URL 内联到新文档脚本，不依赖扩展资源或网络。
  *
- * 注入通过 Page.addScriptToEvaluateOnNewDocument + runImmediately 完成：每个
- * PageSession 只注册一次，注册的脚本在 session 存续期内跨导航自动生效；
- * session 断开重建后由下一次动作重新注册。
+ * 注入通过 Page.addScriptToEvaluateOnNewDocument + runImmediately 完成：脚本在
+ * PageSession 存续期内跨导航生效；控制来源变化时替换脚本并立即更新当前文档。
  */
+import { type ControlSource } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
 /**
- * 确保受控标识已注入到该 page session。幂等且 best-effort：
- * 失败时撤销标记，下一次动作重试；任何异常都不阻断 agent 动作本身。
+ * 确保受控标识已注入到该 page session。相同来源幂等；来源变化时替换跨导航脚本，
+ * runImmediately 同步更新当前文档。任何异常都不阻断 agent 动作本身。
  */
-export declare function ensureControlledIndicator(session: PageSession): Promise<void>;
+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

@@ -0,0 +1,5 @@
+/** 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/handlers.d.ts

@@ -12,6 +12,7 @@ import './tdbank-handlers.js';
 import './tab-handlers.js';
 import './interaction-handlers.js';
 import './timezone-handlers.js';
+import './cookie-handlers.js';
 import './snapshot-handlers.js';
 import './recording-handlers.js';
 import './composite-handlers.js';
@@ -27,3 +28,4 @@ export { cdpPageSnapshot, cdpPageFrames } from './snapshot-handlers.js';
 export { cdpRecordStart, cdpRecordStop } from './recording-handlers.js';
 export { cdpRunActions, cdpObservedPageAction } from './composite-handlers.js';
 export { cdpSetTimezone } from './timezone-handlers.js';
+export { cdpGetCookie, cdpSetCookie } from './cookie-handlers.js';

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

@@ -1,7 +1,8 @@
 /**
  * CDP HTTP proxy / MTOP request / API schema handlers.
  */
+import { type GetApiSchemaParams, type SendMtopRequestParams, type SendRequestParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpSendRequest(session: PageSession, data: any): Promise<any>;
-export declare function cdpSendMtopRequest(session: PageSession, data: any): Promise<any>;
-export declare function cdpGetApiSchema(session: PageSession, data: any): Promise<any>;
+export declare function cdpSendRequest(session: PageSession, data: SendRequestParams): Promise<any>;
+export declare function cdpSendMtopRequest(session: PageSession, data: SendMtopRequestParams): Promise<any>;
+export declare function cdpGetApiSchema(session: PageSession, data: GetApiSchemaParams): Promise<any>;

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

@@ -3,14 +3,15 @@
  *
  * Covers: click, type, scroll, eval, press, wait, navigate, upload, device emulation.
  */
+import { type PageClickParams, type PageEvalParams, type PageHoverParams, type PageNavigateParams, type PagePressParams, type PageScrollParams, type PageTypeParams, type PageUploadParams, type PageWaitParams, type SetDeviceEmulationParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpPageClick(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageType(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageScroll(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageEval(session: PageSession, data: any): Promise<any>;
-export declare function cdpPagePress(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageWait(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageNavigate(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageUpload(session: PageSession, data: any): Promise<any>;
-export declare function cdpSetDeviceEmulation(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageHover(session: PageSession, data: any): Promise<any>;
+export declare function cdpPageClick(session: PageSession, data: PageClickParams): Promise<any>;
+export declare function cdpPageType(session: PageSession, data: PageTypeParams): Promise<any>;
+export declare function cdpPageScroll(session: PageSession, data: PageScrollParams): Promise<any>;
+export declare function cdpPageEval(session: PageSession, data: PageEvalParams): Promise<any>;
+export declare function cdpPagePress(session: PageSession, data: PagePressParams): Promise<any>;
+export declare function cdpPageWait(session: PageSession, data: PageWaitParams): Promise<any>;
+export declare function cdpPageNavigate(session: PageSession, data: PageNavigateParams): Promise<any>;
+export declare function cdpPageUpload(session: PageSession, data: PageUploadParams): Promise<any>;
+export declare function cdpSetDeviceEmulation(session: PageSession, data: SetDeviceEmulationParams): Promise<any>;
+export declare function cdpPageHover(session: PageSession, data: PageHoverParams): Promise<any>;

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

@@ -1,6 +1,9 @@
 /**
  * CDP mock interception handlers.
  */
+import { type GetMocksParams, type SetMockParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpSetMock(session: PageSession, data: any): Promise<any>;
-export declare function cdpGetMocks(_session: PageSession, _data: any): any;
+/** browser_release 使用：丢弃所有依赖当前 CDP 会话的 mock 状态。 */
+export declare function clearCdpMockState(): void;
+export declare function cdpSetMock(session: PageSession, data: SetMockParams): Promise<any>;
+export declare function cdpGetMocks(_session: PageSession, _data: GetMocksParams): any;

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

@@ -4,6 +4,9 @@
  * Manages browser-side action recording via Runtime.addBinding +
  * Page.addScriptToEvaluateOnNewDocument.
  */
+import { type RecordParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpRecordStart(session: PageSession, _data: any): Promise<any>;
-export declare function cdpRecordStop(session: PageSession, _data: any): Promise<any>;
+export declare function cdpRecordStart(session: PageSession, _data: RecordParams): Promise<any>;
+export declare function cdpRecordStop(session: PageSession, _data: RecordParams): Promise<any>;
+/** browser_release 使用：停止仍存活页面的录制，并丢弃已失效 target 的残留状态。 */
+export declare function releaseCdpRecordings(sessions: PageSession[]): Promise<void>;

package/dist/cdp-backend/release-control.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser-level CDP control release.
+ *
+ * Closes Mearl's browser/page WebSocket sessions while keeping Chrome and all
+ * targets alive. A later browser action may create a fresh CdpSession.
+ */
+import type { CdpSession } from './cdp-session.js';
+export interface CdpReleaseResult {
+    released: boolean;
+    hadActiveControl: boolean;
+    affectedTabIds: number[];
+}
+export declare function releaseCdpControl(session: CdpSession): Promise<CdpReleaseResult>;

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

@@ -1,7 +1,8 @@
 /**
  * CDP request/log/event buffer query handlers.
  */
+import type { GetEventsParams, GetLogsParams, GetRequestsParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpGetRequests(session: PageSession, data: any): Promise<any>;
-export declare function cdpGetLogs(session: PageSession, data: any): Promise<any>;
-export declare function cdpGetEvents(session: PageSession, data: any): Promise<any>;
+export declare function cdpGetRequests(session: PageSession, data: GetRequestsParams): Promise<any>;
+export declare function cdpGetLogs(session: PageSession, data: GetLogsParams): Promise<any>;
+export declare function cdpGetEvents(session: PageSession, data: GetEventsParams): Promise<any>;

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

@@ -1,6 +1,7 @@
 /**
  * CDP accessibility tree snapshot and frame handlers.
  */
+import { type PageFramesParams, type PageSnapshotParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpPageSnapshot(session: PageSession, data: any): Promise<any>;
-export declare function cdpPageFrames(session: PageSession, _data: any): Promise<any>;
+export declare function cdpPageSnapshot(session: PageSession, data: PageSnapshotParams): Promise<any>;
+export declare function cdpPageFrames(session: PageSession, _data: PageFramesParams): Promise<any>;

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

@@ -1,7 +1,8 @@
 /**
  * CDP tab management handlers.
  */
+import { type ControlSource, type TabCloseParams, type TabOpenParams } from '@mearl/browser-core';
 import type { CdpSession } from './cdp-session.js';
-export declare function cdpTabOpen(session: CdpSession, data: any): Promise<any>;
-export declare function cdpTabClose(session: CdpSession, data: any): Promise<any>;
+export declare function cdpTabOpen(session: CdpSession, data: TabOpenParams, controlSource?: ControlSource): Promise<any>;
+export declare function cdpTabClose(session: CdpSession, data: TabCloseParams): Promise<any>;
 export declare function cdpTabList(session: CdpSession, _data: any): Promise<any>;

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

@@ -3,11 +3,12 @@
  *
  * Manages TDBank account listing, switching, borrowing via CDP cookie-based auth.
  */
+import { type TdbankAccountParams } from '@mearl/browser-core';
 import type { CdpSession } from './cdp-session.js';
 /** Prepare a TDBank SSO ticket without changing the controller browser account. */
-export declare function cdpPrepareTdbankSso(cdpSession: CdpSession, data: any): Promise<any>;
+export declare function cdpPrepareTdbankSso(cdpSession: CdpSession, data: TdbankAccountParams): Promise<any>;
 /** Consume a TDBank SSO ticket inside an isolated managed browser. */
 export declare function cdpConsumeTdbankSso(cdpSession: CdpSession, ssoUrl: string, expectedLoginId?: string): Promise<{
     nickname: string;
 }>;
-export declare function cdpTdbankAccount(cdpSession: CdpSession, data: any): Promise<any>;
+export declare function cdpTdbankAccount(cdpSession: CdpSession, data: TdbankAccountParams): Promise<any>;

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

@@ -1,3 +1,4 @@
 /** CDP timezone override handler. */
+import type { SetTimezoneParams } from '@mearl/browser-core';
 import type { PageSession } from './cdp-session.js';
-export declare function cdpSetTimezone(session: PageSession, data: any): Promise<any>;
+export declare function cdpSetTimezone(session: PageSession, data: SetTimezoneParams): Promise<any>;

package/dist/cloud-connector.d.ts

@@ -28,11 +28,14 @@
  * it. Connectors die only when explicitly stopped, when they exit on their own,
  * or when the machine reboots — never merely because the broker restarted.
  */
+export interface CloudConnectorListItem {
+    serverUrl: string;
+    pid: number;
+    connectorId?: string;
+    name?: string;
+}
 export interface CloudConnectorListResult {
-    connectors: Array<{
-        serverUrl: string;
-        pid: number;
-    }>;
+    connectors: CloudConnectorListItem[];
 }
 /**
  * Initialise module-level dependencies. Must be called before any other export.
@@ -46,6 +49,8 @@ export declare function initCloudConnector(deps: {
 export declare function startCloudConnector(serverUrl: string): Promise<{
     success: boolean;
     pid?: number;
+    connectorId?: string;
+    name?: string;
     reused?: boolean;
     error?: string;
 }>;