@mearl/client 2.18.0 → 2.19.1

package/dist/index.d.ts

@@ -11,14 +11,14 @@ export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, BROWSER_ACTIONS, BROWSE
 export type { ActionStep, AppProfileName, BrowserAction, BrowserActionMap, BrowserActionRequest, BrowserActionResponse, BrowserCapabilities, BrowserCapabilityAction, BrowserCloseParams, BrowserCommandAction, BrowserInfo, BrowserInfoBase, BrowserJsonValue, BrowserLaunchParams, BrowserProviderOperation, BrowserListResult, BrowserPairingInfo, BrowserReleaseFailure, BrowserReleaseResult, BrowserProviderDefinition, BrowserProviderIdentity, BrowserProviderInputSchema, BrowserProviderListResult, BrowserReference, BrowserDetails, BrowserSource, BrowserStatus, BrowserScreenshotKind, BrowserTransport, CaptureCheckpointParams, CaptureCheckpointResult, BrowserDevicePresetName, BrowserEmulationOptions, ExtensionBrowserAction, GetCookieParams, GetCookieResult, GetEventsParams, GetLogsParams, GetMocksParams, GetRequestsParams, ManagedBrowserInfo, PageClickParams, PageDragEndpoint, PageDragParams, PageDragPoint, PageActAction, PageDiagnosticsOptions, PageDiagnosticsSetting, PageEvalParams, PageFramesParams, PageHoverParams, PageInspectFilter, PageInspectParams, PageNavigateParams, PageObservationWaitOptions, PagePressParams, PageScreenshotParams, PageScrollParams, PageSnapshotParams, PageSnapshotQuery, PageTypeParams, PageUploadParams, PageWaitParams, RegularBrowserInfo, RequestDomainPermissionParams, RulesResult, RunActionName, RunActionsParams, SelectBrowserParams, SelectBrowserResult, SendRequestFile, SendRequestFormValue, SendMtopRequestParams, SendRequestParams, SetAppProfileParams, SetCookieParams, SetCookieResult, SetDeviceEmulationParams, SetMockParams, SetRuleParams, SetTimezoneParams, SetTimezoneResult, TabCloseParams, TabOpenParams, } from './generated-browser-action-protocol.js';
 import { type UnifiedInvokeOptions } from './unified.js';
 import type * as Protocol from './generated-browser-action-protocol.js';
-export declare function tabCheckpoint(params?: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
+export declare function tabCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
 /** Compatibility wrapper for tabCheckpoint. */
-export declare function captureCheckpoint(params?: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
-export declare function getRequests(params?: Protocol.GetRequestsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
-export declare function getLogs(params?: Protocol.GetLogsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
-export declare function getEvents(params?: Protocol.GetEventsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_events'>>;
+export declare function captureCheckpoint(params: Protocol.CaptureCheckpointParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_checkpoint'>>;
+export declare function getRequests(params: Protocol.GetRequestsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_requests'>>;
+export declare function getLogs(params: Protocol.GetLogsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_logs'>>;
+export declare function getEvents(params: Protocol.GetEventsParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_events'>>;
 export declare function setMock(params: Protocol.SetMockParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'set_mock'>>;
-export declare function getMocks(params?: Protocol.GetMocksParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_mocks'>>;
+export declare function getMocks(params: Protocol.GetMocksParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'get_mocks'>>;
 export declare function sendRequest(params: Protocol.SendRequestParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'send_request'>>;
 export declare function sendMtopRequest(params: Protocol.SendMtopRequestParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'send_mtop_request'>>;
 export declare function browserList(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'browser_list'>>;
@@ -32,6 +32,7 @@ export declare function pageScreenshot(params: Protocol.PageScreenshotParams, op
 export declare function tabOpen(params: Protocol.TabOpenParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_open'>>;
 export declare function tabClose(params: Protocol.TabCloseParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_close'>>;
 export declare function tabList(options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_list'>>;
+export declare function tabGroup(params: Protocol.TabGroupParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'tab_group'>>;
 export declare function pageClick(params: Protocol.PageClickParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_click'>>;
 export declare function pageDrag(params: Protocol.PageDragParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_drag'>>;
 export declare function pageType(params: Protocol.PageTypeParams, options?: UnifiedInvokeOptions): Promise<Protocol.BrowserActionResponse<'page_type'>>;

package/dist/index.js

@@ -7,26 +7,26 @@
 export { UnifiedClient, UnifiedClient as MearlClient, decodeBrowserTarget, invoke, invokePlugin, listCloudConnectors, } from './unified.js';
 export { APP_PROFILE_NAMES, BROWSER_DEVICE_PRESET_NAMES, 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, isBrowserCapabilityAction, isBrowserCommandAction, isExtensionBrowserAction, } from './generated-browser-action-protocol.js';
 import { invoke } from './unified.js';
-export function tabCheckpoint(params = {}, options) {
+export function tabCheckpoint(params, options) {
     return invoke('tab_checkpoint', params, options);
 }
 /** Compatibility wrapper for tabCheckpoint. */
-export function captureCheckpoint(params = {}, options) {
+export function captureCheckpoint(params, options) {
     return tabCheckpoint(params, options);
 }
-export function getRequests(params = {}, options) {
+export function getRequests(params, options) {
     return invoke('get_requests', params, options);
 }
-export function getLogs(params = {}, options) {
+export function getLogs(params, options) {
     return invoke('get_logs', params, options);
 }
-export function getEvents(params = {}, options) {
+export function getEvents(params, options) {
     return invoke('get_events', params, options);
 }
 export function setMock(params, options) {
     return invoke('set_mock', params, options);
 }
-export function getMocks(params = {}, options) {
+export function getMocks(params, options) {
     return invoke('get_mocks', params, options);
 }
 export function sendRequest(params, options) {
@@ -68,6 +68,9 @@ export function tabClose(params, options) {
 export function tabList(options) {
     return invoke('tab_list', {}, options);
 }
+export function tabGroup(params, options) {
+    return invoke('tab_group', params, options);
+}
 export function pageClick(params, options) {
     return invoke('page_click', params, options);
 }

package/dist/officialPluginCatalog.d.ts

@@ -9,9 +9,13 @@ export declare const OFFICIAL_PLUGINS: {
     readonly buc: {
         readonly description: "使用 BUC 身份请求内部服务";
         readonly installArgs: readonly ["trip/mearl", "--skill", "buc-request", "--yes"];
-        readonly setup: "alibaba";
         readonly skill: "buc-request";
     };
+    readonly authx: {
+        readonly description: "使用 AuthX 身份请求内部服务";
+        readonly installArgs: readonly ["trip/mearl", "--skill", "authx-request", "--yes"];
+        readonly skill: "authx-request";
+    };
     readonly tdbank: {
         readonly description: "查询、借用和切换 TDBank 测试账号";
         readonly installArgs: readonly ["trip/mearl", "--skill", "tdbank-account", "--yes"];

package/dist/officialPluginCatalog.js

@@ -3,9 +3,13 @@ export const OFFICIAL_PLUGINS = {
     buc: {
         description: '使用 BUC 身份请求内部服务',
         installArgs: ['trip/mearl', '--skill', 'buc-request', '--yes'],
-        setup: 'alibaba',
         skill: 'buc-request',
     },
+    authx: {
+        description: '使用 AuthX 身份请求内部服务',
+        installArgs: ['trip/mearl', '--skill', 'authx-request', '--yes'],
+        skill: 'authx-request',
+    },
     tdbank: {
         description: '查询、借用和切换 TDBank 测试账号',
         installArgs: ['trip/mearl', '--skill', 'tdbank-account', '--yes'],

package/dist/pluginPageBundle.js

@@ -84,6 +84,32 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
     await requestHost('clipboard-write', { text });
   };
 
+  const openExternalLink = async url => {
+    if (typeof url !== 'string' || !url || url.length > 8192) {
+      throw new Error('External link must be a non-empty URL no longer than 8192 characters');
+    }
+    await requestHost('open-external-link', { url });
+  };
+
+  const handleExternalLinkClick = event => {
+    if (event.defaultPrevented || event.button !== 0) return;
+    const link = event.target?.closest?.('a[href]');
+    if (!link || String(link.target).toLowerCase() !== '_blank' || link.hasAttribute?.('download')) {
+      return;
+    }
+    let url;
+    try {
+      url = new URL(link.href);
+    } catch {
+      return;
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') return;
+    event.preventDefault();
+    void openExternalLink(url.href).catch(error => {
+      console.error('Failed to open external link', error);
+    });
+  };
+
   const toast = async (message, options = {}) => {
     if (typeof message !== 'string' || !message.trim() || message.length > 4000) {
       throw new Error('Toast message must be a non-empty string no longer than 4000 characters');
@@ -106,16 +132,213 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
       throw new Error('Agent panel options must be an object');
     }
     const layout = options.layout;
-    if (layout !== undefined && layout !== 'drawer' && layout !== 'workspace') {
-      throw new Error('Agent panel layout must be drawer or workspace');
+    if (layout !== undefined && layout !== 'drawer' && layout !== 'workspace' && layout !== 'inline') {
+      throw new Error('Agent panel layout must be drawer, workspace, or inline');
     }
     return layout;
   };
 
+  const agentPanelKey = (options, required = false) => {
+    const key = typeof options.key === 'string' ? options.key.trim() : '';
+    if ((required || options.key !== undefined) && (!key || key.length > 128)) {
+      throw new Error('Agent panel key must be a non-empty string no longer than 128 characters');
+    }
+    return key || null;
+  };
+
+  const agentPanelCwd = options => {
+    const cwd = options.cwd;
+    if (
+      cwd !== undefined &&
+      (typeof cwd !== 'string' ||
+        !cwd.trim() ||
+        cwd.length > 4096 ||
+        !/^(?:\/|[a-zA-Z]:[\\/])/.test(cwd.trim()))
+    ) {
+      throw new Error('Agent panel cwd must be an absolute path no longer than 4096 characters');
+    }
+    return cwd === undefined ? null : cwd.trim();
+  };
+
+  const agentPanelContext = options => {
+    const context = options.context;
+    if (
+      context !== undefined &&
+      (typeof context !== 'string' || !context.trim() || context.length > 65536)
+    ) {
+      throw new Error('Agent panel context must be a non-empty string no longer than 65536 characters');
+    }
+    return context === undefined ? null : context.trim();
+  };
+
+  const inlineAgentPanels = new Map();
+
+  const stopInlineAgentPanelTracking = key => {
+    if (key) {
+      inlineAgentPanels.get(key)?.cleanup();
+      inlineAgentPanels.delete(key);
+      return;
+    }
+    for (const tracked of inlineAgentPanels.values()) tracked.cleanup();
+    inlineAgentPanels.clear();
+  };
+
+  const inlineAgentPanelAnchor = (options, key) => {
+    const anchor = options.anchor;
+    if (!(anchor instanceof Element)) {
+      throw new Error('Inline Agent panel anchor must be an element');
+    }
+    const rect = anchor.getBoundingClientRect();
+    if (![rect.top, rect.left, rect.width, rect.height].every(Number.isFinite)) {
+      throw new Error('Inline Agent panel anchor returned invalid bounds');
+    }
+    return {
+      element: anchor,
+      key,
+      bounds: { top: rect.top, left: rect.left, width: rect.width, height: rect.height },
+    };
+  };
+
+  const trackInlineAgentPanel = presentation => {
+    stopInlineAgentPanelTracking(presentation.key);
+    let frame = null;
+    const update = () => {
+      frame = null;
+      if (!presentation.element.isConnected || !port) return;
+      const rect = presentation.element.getBoundingClientRect();
+      if (![rect.top, rect.left, rect.width, rect.height].every(Number.isFinite)) return;
+      const bounds = { top: rect.top, left: rect.left, width: rect.width, height: rect.height };
+      if (
+        bounds.top === presentation.bounds.top &&
+        bounds.left === presentation.bounds.left &&
+        bounds.width === presentation.bounds.width &&
+        bounds.height === presentation.bounds.height
+      ) return;
+      presentation.bounds = bounds;
+      port.postMessage({
+        type: 'agent-panel-position',
+        key: presentation.key,
+        bounds,
+      });
+    };
+    const schedule = () => {
+      if (frame !== null) return;
+      frame = requestAnimationFrame(update);
+    };
+    const observer = typeof ResizeObserver === 'function' ? new ResizeObserver(schedule) : null;
+    observer?.observe(presentation.element);
+    observer?.observe(document.documentElement);
+    const mutationObserver = typeof MutationObserver === 'function'
+      ? new MutationObserver(schedule)
+      : null;
+    mutationObserver?.observe(document.documentElement, {
+      attributes: true,
+      childList: true,
+      characterData: true,
+      subtree: true,
+    });
+    window.addEventListener('resize', schedule);
+    document.addEventListener('scroll', schedule, true);
+    const cleanup = () => {
+      if (frame !== null) cancelAnimationFrame(frame);
+      observer?.disconnect();
+      mutationObserver?.disconnect();
+      window.removeEventListener('resize', schedule);
+      document.removeEventListener('scroll', schedule, true);
+    };
+    inlineAgentPanels.set(presentation.key, { presentation, cleanup });
+  };
+
+  const scrollInlineAgentPage = (presentation, deltaX, deltaY) => {
+    const scrollAxis = (axis, delta) => {
+      if (!delta) return;
+      let element = presentation.element;
+      while (element) {
+        const style = window.getComputedStyle(element);
+        const overflow = axis === 'x' ? style.overflowX : style.overflowY;
+        const scrollSize = axis === 'x' ? element.scrollWidth : element.scrollHeight;
+        const clientSize = axis === 'x' ? element.clientWidth : element.clientHeight;
+        if (/^(auto|scroll|overlay)$/.test(overflow) && scrollSize > clientSize) {
+          const scrollPosition = axis === 'x' ? element.scrollLeft : element.scrollTop;
+          const maximum = scrollSize - clientSize;
+          if ((delta < 0 && scrollPosition > 0) || (delta > 0 && scrollPosition < maximum - 1)) {
+            if (axis === 'x') element.scrollLeft += delta;
+            else element.scrollTop += delta;
+            return;
+          }
+        }
+        element = element.parentElement;
+      }
+      window.scrollBy(axis === 'x' ? delta : 0, axis === 'y' ? delta : 0);
+    };
+    scrollAxis('x', deltaX);
+    scrollAxis('y', deltaY);
+  };
+
+  const agentPanelPresentation = (options, layout, key) => {
+    if (layout !== 'inline') return null;
+    return inlineAgentPanelAnchor(options, key);
+  };
+
   const setAgentPanelVisible = async (visible, options = {}) => {
     if (typeof visible !== 'boolean') throw new Error('Agent panel visibility must be a boolean');
     const layout = agentPanelLayout(options);
-    await requestHost('agent-panel', { visible, ...(layout ? { layout } : {}) });
+    const key = agentPanelKey(options, visible && layout === 'inline');
+    const cwd = visible ? agentPanelCwd(options) : null;
+    const context = visible ? agentPanelContext(options) : null;
+    const presentation = visible ? agentPanelPresentation(options, layout, key) : null;
+    const request = requestHost('agent-panel', {
+      visible,
+      ...(layout ? { layout } : {}),
+      ...(key ? { key } : {}),
+      ...(cwd ? { cwd } : {}),
+      ...(context ? { context } : {}),
+      ...(presentation ? { bounds: presentation.bounds } : {}),
+    });
+    if (presentation) {
+      await ready;
+      trackInlineAgentPanel(presentation);
+    } else if (!visible && key) {
+      stopInlineAgentPanelTracking(key);
+    } else {
+      stopInlineAgentPanelTracking();
+    }
+    try {
+      await request;
+    } catch (error) {
+      if (presentation) stopInlineAgentPanelTracking(presentation.key);
+      throw error;
+    }
+  };
+
+  const agentGuideText = (value, label, maximumLength) => {
+    const normalized = typeof value === 'string' ? value.trim() : '';
+    if (!normalized || normalized.length > maximumLength) {
+      throw new Error(label + ' must be a non-empty string no longer than ' + maximumLength + ' characters');
+    }
+    return normalized;
+  };
+
+  const setAgentGuides = async guides => {
+    if (!Array.isArray(guides) || guides.length === 0 || guides.length > 6) {
+      throw new Error('Agent guides must contain between 1 and 6 items');
+    }
+    const normalized = guides.map((guide, index) => {
+      if (!guide || typeof guide !== 'object' || Array.isArray(guide)) {
+        throw new Error('Agent guide ' + index + ' must be an object');
+      }
+      const icon = guide.icon === undefined ? undefined : agentGuideText(guide.icon, 'Agent guide icon', 40);
+      if (icon && !/^[a-z][a-z0-9-]*$/.test(icon)) {
+        throw new Error('Agent guide icon must use kebab-case');
+      }
+      return {
+        title: agentGuideText(guide.title, 'Agent guide title', 80),
+        description: agentGuideText(guide.description, 'Agent guide description', 160),
+        prompt: agentGuideText(guide.prompt, 'Agent guide prompt', 4000),
+        ...(icon ? { icon } : {}),
+      };
+    });
+    await requestHost('agent-guides', { guides: normalized });
   };
 
   const runAgentTask = async (prompt, options = {}) => {
@@ -126,7 +349,13 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
       throw new Error('Agent task options must be an object');
     }
     const cwd = options.cwd;
+    const ephemeral = options.ephemeral;
     const layout = agentPanelLayout(options);
+    const key = agentPanelKey(options, layout === 'inline');
+    const presentation = agentPanelPresentation(options, layout, key);
+    if (ephemeral !== undefined && ephemeral !== false) {
+      throw new Error('Temporary Agent conversations are not supported');
+    }
     if (
       cwd !== undefined &&
       (typeof cwd !== 'string' ||
@@ -136,11 +365,25 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
     ) {
       throw new Error('Agent task cwd must be an absolute path no longer than 4096 characters');
     }
-    await requestHost('agent-task', {
+    const request = requestHost('agent-task', {
       prompt: prompt.trim(),
       ...(cwd !== undefined ? { cwd: cwd.trim() } : {}),
       ...(layout ? { layout } : {}),
+      ...(key ? { key } : {}),
+      ...(presentation ? { bounds: presentation.bounds } : {}),
     });
+    if (presentation) {
+      await ready;
+      trackInlineAgentPanel(presentation);
+    } else {
+      stopInlineAgentPanelTracking();
+    }
+    try {
+      await request;
+    } catch (error) {
+      if (presentation) stopInlineAgentPanelTracking(presentation.key);
+      throw error;
+    }
   };
 
   const setQueryParam = async (name, value) => {
@@ -155,7 +398,7 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
     return query;
   };
 
-  const api = { copyText, invoke, operation, ready: () => ready, runAgentTask, runningOperations, selectDirectory, setAgentPanelVisible, setQueryParam, start, toast };
+  const api = { copyText, invoke, operation, ready: () => ready, runAgentTask, runningOperations, selectDirectory, setAgentGuides, setAgentPanelVisible, setQueryParam, start, toast };
   const ui = globalThis.__mearlToolboxUi;
   if (ui !== undefined) {
     if (!ui || typeof ui !== 'object' || ui.runtime !== 'preact') {
@@ -166,6 +409,7 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
   }
   Object.defineProperty(api, 'context', { enumerable: true, get: () => context });
   Object.defineProperty(window, 'mearl', { configurable: false, value: Object.freeze(api) });
+  document.addEventListener('click', handleExternalLinkClick);
 
   const applyContext = nextContext => {
     const theme =
@@ -198,6 +442,22 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
         applyContext(response.context);
         return;
       }
+      if (
+        response?.type === 'agent-panel-wheel' &&
+        typeof response.key === 'string' &&
+        inlineAgentPanels.has(response.key) &&
+        typeof response.deltaX === 'number' &&
+        Number.isFinite(response.deltaX) &&
+        typeof response.deltaY === 'number' &&
+        Number.isFinite(response.deltaY)
+      ) {
+        scrollInlineAgentPage(
+          inlineAgentPanels.get(response.key).presentation,
+          response.deltaX,
+          response.deltaY,
+        );
+        return;
+      }
       if (response?.type !== 'result' || typeof response.requestId !== 'string') return;
       const request = pending.get(response.requestId);
       if (!request) return;

package/dist/unifiedConfig.d.ts

@@ -1,6 +1,8 @@
 export interface CloudServerConfig {
     server: string;
 }
+/** Number of local calendar days between CLI update checks; null disables them. */
+export declare function loadCliAutoUpdateIntervalDays(configPath?: string): number | null;
 export declare function getCloudServerConfigPath(): string;
 export declare function loadCloudServerConfig(): CloudServerConfig | null;
 export declare function loadLocalConnectorId(): string | null;

package/dist/unifiedConfig.js

@@ -2,6 +2,29 @@ import { existsSync, readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 const MEARL_CONFIG_DIR = join(homedir(), '.mearl');
+/** Number of local calendar days between CLI update checks; null disables them. */
+export function loadCliAutoUpdateIntervalDays(configPath = join(MEARL_CONFIG_DIR, 'config.json')) {
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf8'));
+        if (config.cliAutoUpdate === false)
+            return null;
+        if (config.cliAutoUpdate === undefined)
+            return 1;
+        if (typeof config.cliAutoUpdate === 'object' &&
+            config.cliAutoUpdate !== null &&
+            !Array.isArray(config.cliAutoUpdate)) {
+            const { intervalDays } = config.cliAutoUpdate;
+            if (typeof intervalDays === 'number' &&
+                Number.isSafeInteger(intervalDays) &&
+                intervalDays > 0)
+                return intervalDays;
+        }
+    }
+    catch {
+        // A missing or invalid config uses the daily default.
+    }
+    return 1;
+}
 export function getCloudServerConfigPath() {
     return join(MEARL_CONFIG_DIR, 'cloud-server.json');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.18.0",
+  "version": "2.19.1",
   "description": "Unified Mearl SDK & CLI for local and remote browsers",
   "type": "module",
   "main": "dist/index.js",
@@ -59,8 +59,8 @@
     "commander": "^15.0.0",
     "fastest-levenshtein": "^1.0.16",
     "ws": "^8.18.0",
-    "@mearl/cloud-types": "2.18.0",
-    "@mearl/provider": "2.18.0"
+    "@mearl/cloud-types": "2.19.1",
+    "@mearl/provider": "2.19.1"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",