@mearl/native-host 2.5.0 → 2.5.1

package/dist/agentbay-browser.d.ts

@@ -9,6 +9,11 @@ export interface AgentBayBrowserRecord extends DaemonRecord {
     name: string;
     sessionId: string;
     imageId?: string;
+    persistent?: boolean;
+    contextId?: string;
+    contextName?: string;
+    /** Successful context sync checkpoint for retrying deletion of the current session. */
+    contextSyncedAt?: string;
     accessUrl?: string;
     createdAt: string;
     copiedCookies?: {
@@ -23,6 +28,16 @@ export interface AgentBaySessionLike {
         initializeAsync(options: Record<string, unknown>): Promise<boolean>;
         getEndpointUrl(): Promise<string>;
     };
+    callMcpTool?(toolName: string, args: Record<string, unknown>, autoGenSession?: boolean): Promise<{
+        success?: boolean;
+        errorMessage?: string;
+    }>;
+    context?: {
+        sync(): Promise<{
+            success: boolean;
+            errorMessage?: string;
+        }>;
+    };
     delete(syncContext?: boolean): Promise<{
         success: boolean;
         errorMessage?: string;
@@ -43,15 +58,34 @@ export interface AgentBayClientLike {
         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: false;
+    persistent: boolean;
     agentbaySessionId: string;
     agentbayImageId?: string;
+    agentbayContextId?: string;
+    agentbayContextName?: string;
     agentbayAccessUrl?: string;
     createdAt: string;
     copiedCookies?: AgentBayBrowserRecord['copiedCookies'];
@@ -79,6 +113,7 @@ interface AgentBayBrowserSessionInitOptions {
 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;
@@ -87,5 +122,15 @@ export declare function resolveAgentBayEndpoint(sessionId: string): Promise<stri
 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 launchAgentBayBrowser(input: BrowserLaunchParams, deps: AgentBayBrowserManagerDeps): Promise<AgentBayBrowserSummary>;
-export declare function closeAgentBayBrowser(selector: string): Promise<Record<string, any>>;
+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/index.js

@@ -9574,9 +9574,6 @@ function validateAgentBayInput(input) {
   if (input.headless === true) {
     throw new Error("headless=true is not supported by the AgentBay browser provider");
   }
-  if (input.persistent === true) {
-    throw new Error("persistent is not supported by the AgentBay CDP provider yet");
-  }
   if (input.executablePath) {
     throw new Error("executablePath is only supported by the local browser provider");
   }
@@ -9592,6 +9589,9 @@ function resolveAgentBayImageId(value) {
   }
   return imageId;
 }
+function agentBayContextName(browserId) {
+  return `mearl-browser-${hashKey(browserId)}`;
+}
 function normalizeDesktopUserAgent(value) {
   const userAgent = typeof value === "string" ? value.trim() : "";
   if (!userAgent) throw new Error("Could not determine the control browser user agent");
@@ -9614,9 +9614,11 @@ function browserSummary2(record2, running) {
     name: record2.name,
     provider: "agentbay",
     headless: false,
-    persistent: false,
+    persistent: record2.persistent === true,
     agentbaySessionId: record2.sessionId,
     ...record2.imageId ? { agentbayImageId: record2.imageId } : {},
+    ...record2.contextId ? { agentbayContextId: record2.contextId } : {},
+    ...record2.contextName ? { agentbayContextName: record2.contextName } : {},
     ...accessUrl ? { agentbayAccessUrl: accessUrl } : {},
     createdAt: record2.createdAt,
     ...record2.copiedCookies ? { copiedCookies: record2.copiedCookies } : {},
@@ -9651,12 +9653,26 @@ function listAgentBayBrowsers() {
 }
 async function requireSession(sessionId, apiKey) {
   const agentBay = await createClient(apiKey);
+  return requireSessionFromClient(agentBay, sessionId);
+}
+async function requireSessionFromClient(agentBay, sessionId) {
   const result = await agentBay.get(sessionId);
   if (!result.success || !result.session) {
     throw new Error(result.errorMessage || `AgentBay session not found: ${sessionId}`);
   }
   return result.session;
 }
+async function resolvePersistentContext(agentBay, browserId) {
+  if (!agentBay.context) {
+    throw new Error("The installed AgentBay SDK does not support persistent browser contexts");
+  }
+  const name = agentBayContextName(browserId);
+  const result = await agentBay.context.get(name, true);
+  if (!result.success || !result.context?.id) {
+    throw new Error(result.errorMessage || `Failed to create AgentBay browser context: ${name}`);
+  }
+  return { id: result.context.id, name: result.context.name || name };
+}
 async function resolveAgentBayEndpoint(sessionId) {
   const apiKey = resolveAgentBayApiKey();
   const { AgentBay, GetCdpLinkRequest } = await loadSdk();
@@ -9702,12 +9718,14 @@ async function launchAgentBayBrowser(input, deps) {
   const browserId = agentBayBrowserId(name);
   validateAgentBayInput(input);
   const imageId = resolveAgentBayImageId(input.imageId);
+  const persistent = input.persistent === true;
   const userAgentMode = resolveUserAgentMode(input.userAgentMode);
   const copyCookieDomains = input.copyCookieDomains === void 0 ? [] : normalizeCookieDomains(input.copyCookieDomains);
   const apiKey = (deps.resolveApiKey ?? resolveAgentBayApiKey)();
   const releaseLock = acquireLaunchLock(browserId);
   const persistBrowserRecord = deps.persistBrowserRecord ?? ((record2) => writeRecord(keyedConfigFile(AGENTBAY_BROWSERS_SUBDIR, record2.browserId), record2));
   let session = null;
+  let context;
   let hostPid = 0;
   let recordWritten = false;
   try {
@@ -9717,7 +9735,18 @@ async function launchAgentBayBrowser(input, deps) {
       userAgentMode === "desktop" ? deps.getBrowserUserAgent().then(normalizeDesktopUserAgent) : Promise.resolve(void 0)
     ]);
     const agentBay = await (deps.createAgentBayClient ?? createClient)(apiKey);
-    const created = await agentBay.create({ imageId, framework: "mearl" });
+    context = persistent ? await resolvePersistentContext(agentBay, browserId) : void 0;
+    const created = await agentBay.create({
+      imageId,
+      framework: "mearl",
+      ...context ? {
+        browserContext: {
+          contextId: context.id,
+          autoUpload: true,
+          syncMode: "standard"
+        }
+      } : {}
+    });
     if (!created.success || !created.session) {
       throw new Error(created.errorMessage || "AgentBay session creation failed");
     }
@@ -9757,6 +9786,8 @@ async function launchAgentBayBrowser(input, deps) {
       name,
       sessionId: session.sessionId,
       imageId,
+      persistent,
+      ...context ? { contextId: context.id, contextName: context.name } : {},
       ...accessUrl ? { accessUrl } : {},
       createdAt: (/* @__PURE__ */ new Date()).toISOString(),
       ...copyCookieDomains.length > 0 ? { copiedCookies: { domains: copyCookieDomains, count: copiedCookieCount } } : {}
@@ -9790,6 +9821,8 @@ async function launchAgentBayBrowser(input, deps) {
           name,
           sessionId: session.sessionId,
           imageId,
+          persistent,
+          ...context ? { contextId: context.id, contextName: context.name } : {},
           ...accessUrl ? { accessUrl } : {},
           createdAt: (/* @__PURE__ */ new Date()).toISOString()
         };
@@ -9827,16 +9860,72 @@ function isMissingSessionError(error48) {
   const message = error48 instanceof Error ? error48.message : String(error48);
   return /not[ -]?found|does not exist|already deleted|invalid session/i.test(message);
 }
-async function closeAgentBayBrowser(selector) {
-  const record2 = findRecord(selector);
-  if (!record2) throw new Error(`AgentBay browser not found: ${selector}`);
+async function releaseAgentBayBrowserResources(record2, agentBay, options = {}) {
+  const deleteContext = record2.persistent === true && options.deleteProfile === true;
+  const syncContext = record2.persistent === true && !deleteContext;
+  let contextSynced = Boolean(record2.contextSyncedAt);
+  let session;
   try {
-    const session = await requireSession(record2.sessionId, resolveAgentBayApiKey());
-    const result = await session.delete(false);
-    if (!result.success) throw new Error(result.errorMessage || "AgentBay session deletion failed");
+    session = await requireSessionFromClient(agentBay, record2.sessionId);
   } catch (error48) {
     if (!isMissingSessionError(error48)) throw error48;
   }
+  if (session) {
+    if (syncContext && !contextSynced) {
+      if (!session.callMcpTool) {
+        throw new Error("The installed AgentBay SDK cannot stop the browser before context sync");
+      }
+      const stopped = await session.callMcpTool("stopChrome", {}, false);
+      if (stopped.success === false) {
+        throw new Error(stopped.errorMessage || "AgentBay browser shutdown failed");
+      }
+      if (!session.context) {
+        throw new Error("The installed AgentBay SDK cannot synchronize browser context state");
+      }
+      const synced = await session.context.sync();
+      if (!synced.success) {
+        throw new Error(synced.errorMessage || "AgentBay browser context sync failed");
+      }
+      contextSynced = true;
+      record2.contextSyncedAt = (/* @__PURE__ */ new Date()).toISOString();
+      options.persistRecord?.(record2);
+    }
+    try {
+      const result = await session.delete(false);
+      if (!result.success) {
+        throw new Error(result.errorMessage || "AgentBay session deletion failed");
+      }
+    } catch (error48) {
+      if (!isMissingSessionError(error48)) throw error48;
+    }
+  }
+  if (deleteContext) {
+    if (!record2.contextId || !record2.contextName || !agentBay.context) {
+      throw new Error("AgentBay browser context metadata is unavailable for profile deletion");
+    }
+    const result = await agentBay.context.delete({
+      id: record2.contextId,
+      name: record2.contextName
+    });
+    if (!result.success) throw new Error(result.errorMessage || "AgentBay context deletion failed");
+  }
+  return {
+    sessionDeleted: true,
+    ...syncContext ? { contextSynced } : {},
+    ...deleteContext ? { contextDeleted: true } : {}
+  };
+}
+async function closeAgentBayBrowser(selector, options = {}) {
+  const record2 = findRecord(selector);
+  if (!record2) throw new Error(`AgentBay browser not found: ${selector}`);
+  const agentBay = await createClient(resolveAgentBayApiKey());
+  const released = await releaseAgentBayBrowserResources(record2, agentBay, {
+    ...options,
+    persistRecord: (updatedRecord) => writeRecord(
+      keyedConfigFile(AGENTBAY_BROWSERS_SUBDIR, updatedRecord.browserId),
+      updatedRecord
+    )
+  });
   const closingOwnHost = record2.pid === process.pid;
   if (!closingOwnHost) await stopProcess(record2.pid, `--browser-id ${record2.browserId}`);
   removeRecord(keyedConfigFile(AGENTBAY_BROWSERS_SUBDIR, record2.browserId));
@@ -9849,7 +9938,8 @@ async function closeAgentBayBrowser(selector) {
     browserId: record2.browserId,
     provider: "agentbay",
     closed: true,
-    sessionDeleted: true
+    ...released,
+    ...record2.persistent === true ? { profileDeleted: options.deleteProfile === true } : { profileDeleted: true }
   };
 }
 
@@ -10006,6 +10096,8 @@ function mergeBrowserInventory(connected, managed) {
       ..."cdpPort" in managedBrowser ? { cdpPort: managedBrowser.cdpPort } : {},
       ..."agentbaySessionId" in managedBrowser ? { agentbaySessionId: managedBrowser.agentbaySessionId } : {},
       ..."agentbayImageId" in managedBrowser && managedBrowser.agentbayImageId ? { agentbayImageId: managedBrowser.agentbayImageId } : {},
+      ..."agentbayContextId" in managedBrowser && managedBrowser.agentbayContextId ? { agentbayContextId: managedBrowser.agentbayContextId } : {},
+      ..."agentbayContextName" in managedBrowser && managedBrowser.agentbayContextName ? { agentbayContextName: managedBrowser.agentbayContextName } : {},
       ..."agentbayAccessUrl" in managedBrowser && managedBrowser.agentbayAccessUrl ? { agentbayAccessUrl: managedBrowser.agentbayAccessUrl } : {},
       createdAt: managedBrowser.createdAt,
       ..."account" in managedBrowser ? { account: managedBrowser.account } : {},
@@ -10023,6 +10115,8 @@ function mergeBrowserInventory(connected, managed) {
     ..."cdpPort" in browser ? { cdpPort: browser.cdpPort } : {},
     ..."agentbaySessionId" in browser ? { agentbaySessionId: browser.agentbaySessionId } : {},
     ..."agentbayImageId" in browser && browser.agentbayImageId ? { agentbayImageId: browser.agentbayImageId } : {},
+    ..."agentbayContextId" in browser && browser.agentbayContextId ? { agentbayContextId: browser.agentbayContextId } : {},
+    ..."agentbayContextName" in browser && browser.agentbayContextName ? { agentbayContextName: browser.agentbayContextName } : {},
     ..."agentbayAccessUrl" in browser && browser.agentbayAccessUrl ? { agentbayAccessUrl: browser.agentbayAccessUrl } : {},
     createdAt: browser.createdAt,
     ..."account" in browser ? { account: browser.account } : {},
@@ -10047,7 +10141,7 @@ import os2 from "node:os";
 import { randomUUID as randomUUID4 } from "node:crypto";
 
 // src/version.ts
-var NATIVE_HOST_VERSION = true ? "2.5.0" : "unknown";
+var NATIVE_HOST_VERSION = true ? "2.5.1" : "unknown";
 
 // src/analytics.ts
 var MEASUREMENT_ID = "G-W84LJDZ6PH";
@@ -31037,7 +31131,7 @@ async function handleSocketLine(socket, line) {
           `Managed browser name is ambiguous: ${selector}. Use the full browserId from browser_list.`
         );
       }
-      const result = agentBayExists ? await closeAgentBayBrowser(selector) : await closeManagedBrowser(selector, { deleteProfile: data?.deleteProfile });
+      const result = agentBayExists ? await closeAgentBayBrowser(selector, { deleteProfile: data?.deleteProfile }) : await closeManagedBrowser(selector, { deleteProfile: data?.deleteProfile });
       socket.write(JSON.stringify({ id, success: true, data: result }) + "\n");
     } catch (error48) {
       socket.write(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mearl/native-host",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "description": "Native Messaging Host for Mearl — bridges Chrome Extension and local socket server",
   "type": "module",
   "main": "dist/install.js",
@@ -37,9 +37,9 @@
     "@types/ws": "^8.18.1",
     "esbuild": "^0.25.2",
     "typescript": "^5.8.3",
-    "@mearl/browser-core": "2.5.0",
-    "@mearl/daemon-core": "2.5.0",
-    "@mearl/setup": "2.5.0"
+    "@mearl/browser-core": "2.5.1",
+    "@mearl/daemon-core": "2.5.1",
+    "@mearl/setup": "2.5.1"
   },
   "scripts": {
     "build": "rm -rf dist/ && node build.mjs",