@mearl/client 2.2.2 → 2.3.0

package/README.md

@@ -82,7 +82,7 @@ mearl browser_release
 
 | 分类        | Actions                                                                                                   |
 | ----------- | --------------------------------------------------------------------------------------------------------- |
-| API 调试    | `get_requests` `get_logs` `get_events` `get_api_schema`                                                   |
+| API 调试    | `capture_checkpoint` `get_requests` `get_logs` `get_events` `get_api_schema`                              |
 | Mock & 规则 | `set_mock` `get_mocks` `set_rule` `get_rules`                                                             |
 | 网络代理    | `send_request` `send_mtop_request`                                                                        |
 | 标签页      | `tab_open` `tab_close` `tab_list`                                                                         |
@@ -94,7 +94,7 @@ mearl browser_release
 | TDBank      | `tdbank_account`                                                                                          |
 | 浏览器      | `browser_list` `browser_release` `browser_launch` `browser_close`                                         |
 
-页面交互动作（`page_click` / `page_type` / `page_hover` / `page_scroll` / `page_press` / `page_upload`）默认内置观察：同一次调用内执行动作并等待异步稳定，返回 `{ action, observation }`；传 `observe: false` 可关闭观察仅执行裸动作。观察结果不替代完整页面理解：`mode: "delta"` 只返回主文档中的 `effects.notifications`、`effects.interactives` 和 `effects.focus` 等高置信度信号，并明确携带 `scope: "main-document"`；可交互节点会尽量携带真实 backend `node.ref`，后续动作优先使用 ref，缺少 ref 时使用 `node.selector`。`mode: "navigation"` 且 `ready: true` 时，页面已通过网络静默、骨架状态或保守的内容稳定判定，可在新页面重建快照。动作直接打开新标签页时，`observation.openedTabs` 返回新标签页的 `tabId`、URL、标题和加载状态，可直接把该 `tabId` 用于后续操作，不必调用 `tab_list`。通常仅在 `fullSnapshotRecommended` 为 true 时根据 `snapshotReasons` 回退；滚动后若下一步需要读取新视口内容，可按需获取 viewport 快照。`page_eval` 默认裸执行，只有显式传入 `observe` 对象时才启用观察。
+页面交互动作（`page_click` / `page_type` / `page_hover` / `page_scroll` / `page_press` / `page_upload`）默认内置观察与原子诊断：同一次调用内执行动作、等待异步稳定，并返回 `{ action, observation, diagnostics }`；`diagnostics` 默认包含新增 error logs 和全部业务 requests。传 `observe: false` 只关闭 DOM/导航观察并保留诊断；同时传 `diagnostics: false` 才仅执行裸动作。观察结果不替代完整页面理解：`mode: "delta"` 只返回主文档中的 `effects.notifications`、`effects.interactives` 和 `effects.focus` 等高置信度信号，并明确携带 `scope: "main-document"`；可交互节点会尽量携带真实 backend `node.ref`，后续动作优先使用 ref，缺少 ref 时使用 `node.selector`。`mode: "navigation"` 且 `ready: true` 时，页面已通过网络静默、骨架状态或保守的内容稳定判定，可在新页面重建快照。动作直接打开新标签页时，`observation.openedTabs` 返回新标签页的 `tabId`、URL、标题和加载状态，可直接把该 `tabId` 用于后续操作，不必调用 `tab_list`。通常仅在 `fullSnapshotRecommended` 为 true 时根据 `snapshotReasons` 回退；滚动后若下一步需要读取新视口内容，可按需获取 viewport 快照。`page_eval` 默认裸执行；显式传 `observe` 对象可启用观察，传 `diagnostics: true` 或对象可启用原子诊断。
 
 `page_snapshot` 默认返回完整 AX Tree；长列表可传 `mode: "viewport"`，只需要当前视口内的控件时传 `mode: "interactive"`，已知 CSS 区域时传 `rootSelector`，已有 ref 时传 `rootRef`（可用 `ancestorDepth` 向上补充上下文），只查找特定文案或角色时传 `query`。视口内缺少 AX 控件语义时，`interactive` 会自动回退到 viewport，并返回 `fallbackMode: "viewport"`。`maxNodes` / `maxChars` 截断会同时保留首尾内容。
 

package/dist/cli.js

@@ -18,7 +18,10 @@ import { runCheck } from './check.js';
 import { resolveActionTimeoutSec } from './actionTimeouts.js';
 // ─── Usage / Help ─────────────────────────────────────────────────────────────
 const CATEGORIES = [
-    { title: 'API 调试', names: ['get_requests', 'get_logs', 'get_events', 'get_api_schema'] },
+    {
+        title: 'API 调试',
+        names: ['capture_checkpoint', 'get_requests', 'get_logs', 'get_events', 'get_api_schema'],
+    },
     { title: 'Mock & 规则', names: ['set_mock', 'get_mocks', 'set_rule', 'get_rules'] },
     { title: '网络代理', names: ['send_request', 'send_mtop_request'] },
     { title: '标签页', names: ['tab_open', 'tab_close', 'tab_list'] },

package/dist/commands.d.ts

@@ -15,6 +15,15 @@ export interface CommandDef {
     examples?: string[];
 }
 export declare const COMMANDS: readonly [{
+    readonly name: "capture_checkpoint";
+    readonly description: "为目标标签页建立 console/network 增量边界";
+    readonly params: [{
+        readonly name: "tabId";
+        readonly type: "number";
+        readonly description: "目标标签页 ID，从 tab_open 获取";
+    }];
+    readonly examples: ["capture_checkpoint --payload '{\"tabId\":12345}'"];
+}, {
     readonly name: "get_requests";
     readonly description: "获取最近的网络请求（mtop 或普通 xhr/fetch）";
     readonly params: [{
@@ -27,12 +36,20 @@ export declare const COMMANDS: readonly [{
         readonly description: "返回条数，默认 10";
     }, {
         readonly name: "source";
-        readonly type: "\"mtop\" | \"requests\"";
-        readonly description: "数据来源，不填时默认 mtop";
+        readonly type: "\"mtop\" | \"requests\" | \"all\"";
+        readonly description: "数据来源，不填时默认 mtop；all 返回全部业务请求";
     }, {
         readonly name: "filter";
         readonly type: "string";
         readonly description: "按 URL 或 API 名称过滤，支持正则";
+    }, {
+        readonly name: "since";
+        readonly type: "number";
+        readonly description: "只返回最近 N 秒内的请求";
+    }, {
+        readonly name: "after";
+        readonly type: "string";
+        readonly description: "只返回指定 capture cursor 之后的请求";
     }, {
         readonly name: "includeBody";
         readonly type: "boolean";
@@ -49,7 +66,7 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "limit";
         readonly type: "number";
-        readonly description: "返回条数，默认 20";
+        readonly description: "返回最新 N 条，默认 100";
     }, {
         readonly name: "level";
         readonly type: "string";
@@ -58,6 +75,14 @@ export declare const COMMANDS: readonly [{
         readonly name: "filter";
         readonly type: "string";
         readonly description: "按内容过滤，支持正则";
+    }, {
+        readonly name: "since";
+        readonly type: "number";
+        readonly description: "只返回最近 N 秒内的日志";
+    }, {
+        readonly name: "after";
+        readonly type: "string";
+        readonly description: "只返回指定 capture cursor 之后的日志";
     }];
     readonly examples: ["get_logs --payload '{\"limit\":10,\"level\":\"error\"}'"];
 }, {
@@ -433,8 +458,8 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "observe";
         readonly type: "object | false";
-        readonly description: "观察选项（quietMs/firstChangeTimeoutMs/timeoutMs/navigationGraceMs/navigationTimeoutMs/networkIdleMs/contentReadyAfterMs）；传 false 关闭内置观察，仅执行裸动作";
-    }, {
+        readonly description: "观察选项（quietMs/firstChangeTimeoutMs/timeoutMs/navigationGraceMs/navigationTimeoutMs/networkIdleMs/contentReadyAfterMs）；传 false 只关闭 DOM/导航观察，默认诊断仍会返回";
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;
@@ -461,8 +486,8 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "observe";
         readonly type: "object | false";
-        readonly description: "观察选项；传 false 关闭内置观察，仅执行裸动作";
-    }, {
+        readonly description: "观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回";
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;
@@ -480,8 +505,8 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "observe";
         readonly type: "object | false";
-        readonly description: "观察选项；传 false 关闭内置观察，仅执行裸动作";
-    }, {
+        readonly description: "观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回";
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;
@@ -511,8 +536,8 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "observe";
         readonly type: "object | false";
-        readonly description: "观察选项；传 false 关闭内置观察，仅执行裸动作";
-    }, {
+        readonly description: "观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回";
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;
@@ -535,7 +560,7 @@ export declare const COMMANDS: readonly [{
         readonly name: "observe";
         readonly type: "object";
         readonly description: "仅在表达式会修改页面且需要观察结果时显式传入；不传保持轻量裸执行";
-    }, {
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;
@@ -557,8 +582,8 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "observe";
         readonly type: "object | false";
-        readonly description: "观察选项；传 false 关闭内置观察，仅执行裸动作";
-    }, {
+        readonly description: "观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回";
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;
@@ -633,8 +658,8 @@ export declare const COMMANDS: readonly [{
     }, {
         readonly name: "observe";
         readonly type: "object | false";
-        readonly description: "观察选项；传 false 关闭内置观察，仅执行裸动作";
-    }, {
+        readonly description: "观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回";
+    }, ParamDef, {
         readonly name: "tabId";
         readonly type: "number";
         readonly required: true;

package/dist/commands.js

@@ -1,5 +1,16 @@
+const PAGE_DIAGNOSTICS_PARAM = {
+    name: 'diagnostics',
+    type: 'object | boolean',
+    description: '交互动作默认在执行前原子建立边界，并返回新增 error logs/全部业务 requests；传 false 关闭，或传对象自定义过滤',
+};
 export const COMMANDS = [
     // ── API 调试 ──────────────────────────────────────────────────────────────
+    {
+        name: 'capture_checkpoint',
+        description: '为目标标签页建立 console/network 增量边界',
+        params: [{ name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_open 获取' }],
+        examples: [`capture_checkpoint --payload '{"tabId":12345}'`],
+    },
     {
         name: 'get_requests',
         description: '获取最近的网络请求（mtop 或普通 xhr/fetch）',
@@ -8,10 +19,12 @@ export const COMMANDS = [
             { name: 'count', type: 'number', description: '返回条数，默认 10' },
             {
                 name: 'source',
-                type: '"mtop" | "requests"',
-                description: '数据来源，不填时默认 mtop',
+                type: '"mtop" | "requests" | "all"',
+                description: '数据来源，不填时默认 mtop；all 返回全部业务请求',
             },
             { name: 'filter', type: 'string', description: '按 URL 或 API 名称过滤，支持正则' },
+            { name: 'since', type: 'number', description: '只返回最近 N 秒内的请求' },
+            { name: 'after', type: 'string', description: '只返回指定 capture cursor 之后的请求' },
             { name: 'includeBody', type: 'boolean', description: '是否包含请求/响应体，默认 true' },
         ],
         examples: [
@@ -24,9 +37,11 @@ export const COMMANDS = [
         description: '获取浏览器控制台日志',
         params: [
             { name: 'tabId', type: 'number', description: '目标标签页 ID，从 tab_list 获取' },
-            { name: 'limit', type: 'number', description: '返回条数，默认 20' },
+            { name: 'limit', type: 'number', description: '返回最新 N 条，默认 100' },
             { name: 'level', type: 'string', description: '按日志级别过滤：log/info/warn/error' },
             { name: 'filter', type: 'string', description: '按内容过滤，支持正则' },
+            { name: 'since', type: 'number', description: '只返回最近 N 秒内的日志' },
+            { name: 'after', type: 'string', description: '只返回指定 capture cursor 之后的日志' },
         ],
         examples: [`get_logs --payload '{"limit":10,"level":"error"}'`],
     },
@@ -368,8 +383,9 @@ export const COMMANDS = [
             {
                 name: 'observe',
                 type: 'object | false',
-                description: '观察选项（quietMs/firstChangeTimeoutMs/timeoutMs/navigationGraceMs/navigationTimeoutMs/networkIdleMs/contentReadyAfterMs）；传 false 关闭内置观察，仅执行裸动作',
+                description: '观察选项（quietMs/firstChangeTimeoutMs/timeoutMs/navigationGraceMs/navigationTimeoutMs/networkIdleMs/contentReadyAfterMs）；传 false 只关闭 DOM/导航观察，默认诊断仍会返回',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
@@ -397,8 +413,9 @@ export const COMMANDS = [
             {
                 name: 'observe',
                 type: 'object | false',
-                description: '观察选项；传 false 关闭内置观察，仅执行裸动作',
+                description: '观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [`page_type --payload '{"selector":"@e6","text":"搜索关键词"}'`],
@@ -416,8 +433,9 @@ export const COMMANDS = [
             {
                 name: 'observe',
                 type: 'object | false',
-                description: '观察选项；传 false 关闭内置观察，仅执行裸动作',
+                description: '观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [`page_hover --payload '{"selector":".nav-menu"}'`],
@@ -446,8 +464,9 @@ export const COMMANDS = [
             {
                 name: 'observe',
                 type: 'object | false',
-                description: '观察选项；传 false 关闭内置观察，仅执行裸动作',
+                description: '观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [
@@ -472,6 +491,7 @@ export const COMMANDS = [
                 type: 'object',
                 description: '仅在表达式会修改页面且需要观察结果时显式传入；不传保持轻量裸执行',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [`page_eval --payload '{"expression":"document.title"}'`],
@@ -490,8 +510,9 @@ export const COMMANDS = [
             {
                 name: 'observe',
                 type: 'object | false',
-                description: '观察选项；传 false 关闭内置观察，仅执行裸动作',
+                description: '观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [`page_press --payload '{"key":"Enter"}'`],
@@ -562,8 +583,9 @@ export const COMMANDS = [
             {
                 name: 'observe',
                 type: 'object | false',
-                description: '观察选项；传 false 关闭内置观察，仅执行裸动作',
+                description: '观察选项；传 false 只关闭 DOM/导航观察，默认诊断仍会返回',
             },
+            PAGE_DIAGNOSTICS_PARAM,
             { name: 'tabId', type: 'number', required: true, description: '目标标签页 ID' },
         ],
         examples: [

package/dist/generated-browser-action-protocol.d.ts

@@ -2,22 +2,37 @@ export interface GetRequestsParams {
     tabId?: number;
     count?: number;
     filter?: string;
+    /** Relative time window in seconds. */
     since?: number;
+    /** Opaque cursor returned by capture_checkpoint or a previous query. */
+    after?: string;
     includeBody?: boolean;
     includeHeaders?: boolean;
     maxBodySize?: number;
     fields?: string[];
     keysOnly?: boolean;
     applyHiddenFilter?: boolean;
-    source?: 'mtop' | 'requests';
+    source?: 'mtop' | 'requests' | 'all';
 }
 export interface GetLogsParams {
     tabId?: number;
     level?: 'log' | 'warn' | 'error' | 'info' | 'all';
+    /** Relative time window in seconds. */
     since?: number;
+    /** Opaque cursor returned by capture_checkpoint or a previous query. */
+    after?: string;
     limit?: number;
     filter?: string;
 }
+export interface CaptureCheckpointParams {
+    tabId?: number;
+}
+export interface CaptureCheckpointResult {
+    tabId: number;
+    cursor: string;
+    timestampMs: number;
+    captureStatus: 'armed' | 'active';
+}
 export interface GetEventsParams {
     tabId?: number;
     source?: 'rum' | 'aplus' | 'arms' | 'all';
@@ -253,6 +268,11 @@ export interface PageObservationWaitOptions {
     networkIdleMs?: number;
     contentReadyAfterMs?: number;
 }
+export interface PageDiagnosticsOptions {
+    logs?: boolean | Pick<GetLogsParams, 'level' | 'limit' | 'filter'>;
+    requests?: boolean | Pick<GetRequestsParams, 'count' | 'filter' | 'includeBody' | 'includeHeaders' | 'maxBodySize' | 'fields' | 'keysOnly' | 'source'>;
+}
+export type PageDiagnosticsSetting = PageDiagnosticsOptions | boolean;
 export interface PageClickParams {
     tabId?: number;
     selector?: string;
@@ -266,6 +286,7 @@ export interface PageClickParams {
     scope?: string;
     clickMode?: 'auto' | 'dom' | 'mouse' | 'touch';
     observe?: PageObservationWaitOptions | false;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageTypeParams {
     tabId?: number;
@@ -273,6 +294,7 @@ export interface PageTypeParams {
     text: string;
     clearFirst?: boolean;
     observe?: PageObservationWaitOptions | false;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageScrollParams {
     tabId?: number;
@@ -281,11 +303,13 @@ export interface PageScrollParams {
     selector?: string;
     containerPolicy?: 'self' | 'nearest';
     observe?: PageObservationWaitOptions | false;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageHoverParams {
     tabId?: number;
     selector: string;
     observe?: PageObservationWaitOptions | false;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageEvalParams {
     tabId?: number;
@@ -293,6 +317,7 @@ export interface PageEvalParams {
     frameId?: string;
     awaitPromise?: boolean;
     observe?: PageObservationWaitOptions;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageSnapshotQuery {
     text?: string;
@@ -315,6 +340,7 @@ export interface PagePressParams {
     key: string;
     modifiers?: string[];
     observe?: PageObservationWaitOptions | false;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageWaitParams {
     tabId?: number;
@@ -335,6 +361,7 @@ export interface PageUploadParams {
     selector: string;
     filePaths: string[];
     observe?: PageObservationWaitOptions | false;
+    diagnostics?: PageDiagnosticsSetting;
 }
 export interface PageFramesParams {
     tabId?: number;
@@ -402,6 +429,10 @@ export interface RunActionsParams {
     tabId: number;
 }
 export interface BrowserActionMap {
+    capture_checkpoint: {
+        request: CaptureCheckpointParams;
+        response: CaptureCheckpointResult;
+    };
     get_requests: {
         request: GetRequestsParams;
         response: unknown;
@@ -575,6 +606,7 @@ export type ExtensionBrowserAction = Exclude<BrowserCommandAction, 'browser_list
 export declare const PAGE_ACT_ACTIONS: readonly ["page_click", "page_type", "page_hover", "page_scroll", "page_press", "page_upload", "page_eval"];
 export type PageActAction = (typeof PAGE_ACT_ACTIONS)[number];
 export declare const BROWSER_ACTIONS: {
+    readonly capture_checkpoint: true;
     readonly get_requests: true;
     readonly get_logs: true;
     readonly get_events: true;
@@ -618,6 +650,7 @@ export declare const BROWSER_ACTIONS: {
     readonly run_actions: true;
 };
 export declare const BROWSER_COMMAND_ACTIONS: {
+    readonly capture_checkpoint: true;
     readonly get_requests: true;
     readonly get_logs: true;
     readonly get_events: true;
@@ -660,6 +693,7 @@ export declare const BROWSER_COMMAND_ACTIONS: {
     readonly run_actions: true;
 };
 export declare const EXTENSION_BROWSER_ACTIONS: {
+    readonly capture_checkpoint: true;
     readonly get_requests: true;
     readonly get_logs: true;
     readonly get_events: true;

package/dist/generated-browser-action-protocol.js

@@ -16,6 +16,7 @@ export const PAGE_ACT_ACTIONS = [
     'page_eval',
 ];
 export const BROWSER_ACTIONS = {
+    capture_checkpoint: true,
     get_requests: true,
     get_logs: true,
     get_events: true,
@@ -59,6 +60,7 @@ export const BROWSER_ACTIONS = {
     run_actions: true,
 };
 export const BROWSER_COMMAND_ACTIONS = {
+    capture_checkpoint: true,
     get_requests: true,
     get_logs: true,
     get_events: true,
@@ -101,6 +103,7 @@ export const BROWSER_COMMAND_ACTIONS = {
     run_actions: true,
 };
 export const EXTENSION_BROWSER_ACTIONS = {
+    capture_checkpoint: true,
     get_requests: true,
     get_logs: true,
     get_events: true,

package/dist/index.d.ts

@@ -7,8 +7,9 @@
 export { invoke } from './socket.js';
 export type { InvokeOptions } from './socket.js';
 export { BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
-export type { ActionStep, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserLaunchParams, BrowserListResult, BrowserReleaseFailure, BrowserReleaseResult, BrowserStatus, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetApiSchemaParams, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, GetUserInfoParams, ManagedBrowserAccount, ManagedBrowserInfo, PageClickParams, PageActAction, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RecordParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, TdbankAccountParams, } from './generated-browser-action-protocol.js';
+export type { ActionStep, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserLaunchParams, BrowserListResult, BrowserReleaseFailure, BrowserReleaseResult, BrowserStatus, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetApiSchemaParams, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, GetUserInfoParams, ManagedBrowserAccount, ManagedBrowserInfo, PageClickParams, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSelectedElementParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RecordParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, TdbankAccountParams, } from './generated-browser-action-protocol.js';
 import type * as Protocol from './generated-browser-action-protocol.js';
+export declare function captureCheckpoint(params?: Protocol.CaptureCheckpointParams): Promise<Protocol.BrowserActionResponse<'capture_checkpoint'>>;
 export declare function getRequests(params?: Protocol.GetRequestsParams): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
 export declare function getLogs(params?: Protocol.GetLogsParams): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
 export declare function getEvents(params?: Protocol.GetEventsParams): Promise<Protocol.BrowserActionResponse<'get_events'>>;

package/dist/index.js

@@ -7,6 +7,9 @@
 export { invoke } from './socket.js';
 export { BROWSER_ACTIONS, BROWSER_COMMAND_ACTIONS, EXTENSION_BROWSER_ACTIONS, PAGE_ACT_ACTIONS, SEND_REQUEST_MAX_FILES, SEND_REQUEST_MAX_TOTAL_BASE64_FILE_BYTES, SEND_REQUEST_MAX_TOTAL_FILE_BYTES, isBrowserAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
 import { invoke } from './socket.js';
+export function captureCheckpoint(params = {}) {
+    return invoke('capture_checkpoint', params);
+}
 export function getRequests(params = {}) {
     return invoke('get_requests', params);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "description": "Client SDK & CLI for Mearl — communicate with Chrome Extension via Unix Socket",
   "type": "module",
   "main": "dist/index.js",