@mearl/client 2.20.3 → 2.20.4

package/dist/pluginPageBundle.js

@@ -30,6 +30,7 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
   let requestSequence = 0;
   const pending = new Map();
   const pageEventListeners = new Map();
+  const contextListeners = new Set();
   let subscriptionSequence = 0;
   let resolveReady;
   const ready = new Promise(resolve => { resolveReady = resolve; });
@@ -397,7 +398,13 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
     return query;
   };
 
-  const api = { invoke, subscribe, ready: () => ready, runAgentTask, setAgentGuides, setAgentPanelVisible, setQueryParam };
+  const onContextChange = listener => {
+    if (typeof listener !== 'function') throw new Error('Invalid context listener');
+    contextListeners.add(listener);
+    if (context) listener(context);
+    return () => contextListeners.delete(listener);
+  };
+  const api = { invoke, subscribe, onContextChange, ready: async () => { await ready; return context; }, runAgentTask, setAgentGuides, setAgentPanelVisible, setQueryParam };
   const ui = globalThis.__mearlToolboxUi;
   if (ui !== undefined) {
     if (!ui || typeof ui !== 'object' || ui.runtime !== 'preact') {
@@ -421,6 +428,10 @@ const PAGE_BRIDGE_SCRIPT = String.raw `(() => {
     document.documentElement.style.colorScheme = theme;
     if (/^\d+(?:\.\d+)?px$/.test(fontSize)) document.documentElement.style.fontSize = fontSize;
     context = Object.freeze({ ...(context || {}), ...(nextContext || {}), theme });
+    for (const listener of contextListeners) {
+      try { listener(context); }
+      catch (error) { console.error('Toolbox context listener failed', error); }
+    }
     return context;
   };
 

package/dist/pluginRegistry.d.ts

@@ -7,6 +7,9 @@ export interface PluginToolboxSandboxPage {
     runtime?: 'preact';
     entry: string;
     commands: string[];
+    lifecycle?: {
+        onNavigation: string;
+    };
 }
 export interface PluginToolboxLocale {
     title?: string;

package/dist/pluginRegistry.js

@@ -199,6 +199,17 @@ export function normalizePluginToolboxContribution(value) {
         entry: pageEntry,
         commands,
     };
+    if (pageCandidate.lifecycle !== undefined) {
+        const lifecycle = pageCandidate.lifecycle;
+        if (!lifecycle ||
+            typeof lifecycle !== 'object' ||
+            Array.isArray(lifecycle) ||
+            typeof lifecycle.onNavigation !== 'string' ||
+            !commands.includes(lifecycle.onNavigation)) {
+            throw new Error('toolbox.page.lifecycle.onNavigation 必须是 page.commands 中的命令名称');
+        }
+        page.lifecycle = { onNavigation: lifecycle.onNavigation };
+    }
     let agent;
     if (candidate.agent !== undefined) {
         if (!candidate.agent || typeof candidate.agent !== 'object' || Array.isArray(candidate.agent)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/client",
-  "version": "2.20.3",
+  "version": "2.20.4",
   "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.20.3",
-    "@mearl/provider": "2.20.3"
+    "@mearl/cloud-types": "2.20.4",
+    "@mearl/provider": "2.20.4"
   },
   "devDependencies": {
     "@types/node": "^24.9.1",