opensteer 0.4.8 → 0.4.10

package/bin/opensteer.mjs

@@ -781,7 +781,6 @@ Environment:
   OPENSTEER_MODE            Runtime routing: "local" (default) or "cloud"
   OPENSTEER_API_KEY         Required when cloud mode is selected
   OPENSTEER_BASE_URL        Override cloud control-plane base URL
-  OPENSTEER_APP_URL         Cloud app base URL for emitting browser session links (default: https://opensteer.com)
   OPENSTEER_REMOTE_ANNOUNCE Cloud session announcement policy: always (default), off, tty
 `)
 }

package/dist/{chunk-GQ7HNCM2.js → chunk-C3NM6XZH.js}

@@ -38,6 +38,7 @@ function sanitizeNamespaceSegment(segment) {
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_SETTLE_MS = 750;
 var FRAME_EVALUATE_GRACE_MS = 200;
+var TRANSIENT_CONTEXT_RETRY_DELAY_MS = 25;
 var STEALTH_WORLD_NAME = "__opensteer_wait__";
 var StealthWaitUnavailableError = class extends Error {
   constructor(cause) {
@@ -341,7 +342,12 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
     const frameRecords = await this.getFrameRecords();
     const mainFrame = frameRecords[0];
     if (!mainFrame) return;
-    await this.waitForFrameVisualStability(mainFrame.frameId, timeout, settleMs);
+    await this.waitForFrameVisualStability(
+      mainFrame.frameId,
+      timeout,
+      settleMs,
+      true
+    );
   }
   async collectVisibleFrameIds() {
     const frameRecords = await this.getFrameRecords();
@@ -370,19 +376,44 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
     }
     return visibleFrameIds;
   }
-  async waitForFrameVisualStability(frameId, timeout, settleMs) {
+  async waitForFrameVisualStability(frameId, timeout, settleMs, retryTransientContextErrors = true) {
     if (timeout <= 0) return;
     const script = buildStabilityScript(timeout, settleMs);
-    let contextId = await this.ensureFrameContextId(frameId);
-    try {
-      await this.evaluateWithGuard(contextId, script, timeout);
-    } catch (error) {
-      if (!isMissingExecutionContextError(error)) {
-        throw error;
+    if (!retryTransientContextErrors) {
+      let contextId = await this.ensureFrameContextId(frameId);
+      try {
+        await this.evaluateWithGuard(contextId, script, timeout);
+      } catch (error) {
+        if (!isMissingExecutionContextError(error)) {
+          throw error;
+        }
+        this.contextsByFrame.delete(frameId);
+        contextId = await this.ensureFrameContextId(frameId);
+        await this.evaluateWithGuard(contextId, script, timeout);
+      }
+      return;
+    }
+    const deadline = Date.now() + timeout;
+    while (true) {
+      const remaining = Math.max(0, deadline - Date.now());
+      if (remaining === 0) {
+        return;
+      }
+      const contextId = await this.ensureFrameContextId(frameId);
+      try {
+        await this.evaluateWithGuard(contextId, script, remaining);
+        return;
+      } catch (error) {
+        if (!isTransientExecutionContextError(error)) {
+          throw error;
+        }
+        this.contextsByFrame.delete(frameId);
+        const retryDelay = Math.min(
+          TRANSIENT_CONTEXT_RETRY_DELAY_MS,
+          Math.max(0, deadline - Date.now())
+        );
+        await sleep(retryDelay);
       }
-      this.contextsByFrame.delete(frameId);
-      contextId = await this.ensureFrameContextId(frameId);
-      await this.evaluateWithGuard(contextId, script, timeout);
     }
   }
   async initialize() {
@@ -502,7 +533,8 @@ async function waitForVisualStabilityAcrossFrames(page, options = {}) {
             await runtime.waitForFrameVisualStability(
               frameId,
               remaining,
-              settleMs
+              settleMs,
+              false
             );
           } catch (error) {
             if (isIgnorableFrameError(error)) return;
@@ -540,6 +572,11 @@ function sameFrameIds(before, after) {
 function formatCdpException(details) {
   return details.exception?.description || details.text || "CDP runtime evaluation failed.";
 }
+function isTransientExecutionContextError(error) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message;
+  return message.includes("Execution context was destroyed") || message.includes("Cannot find context with specified id") || message.includes("Cannot find execution context");
+}
 function isMissingExecutionContextError(error) {
   if (!(error instanceof Error)) return false;
   const message = error.message;
@@ -548,7 +585,7 @@ function isMissingExecutionContextError(error) {
 function isIgnorableFrameError(error) {
   if (!(error instanceof Error)) return false;
   const message = error.message;
-  return message.includes("Frame was detached") || message.includes("Execution context was destroyed") || message.includes("Target page, context or browser has been closed") || message.includes("Cannot find context with specified id") || message.includes("Cannot find execution context") || message.includes("No frame for given id found");
+  return message.includes("Frame was detached") || message.includes("Target page, context or browser has been closed") || isTransientExecutionContextError(error) || message.includes("No frame for given id found");
 }
 function sleep(ms) {
   return new Promise((resolve) => {
@@ -6177,6 +6214,11 @@ function resolveOpensteerApiKey(env) {
   if (!value) return void 0;
   return value;
 }
+function resolveOpensteerBaseUrl(env) {
+  const value = env.OPENSTEER_BASE_URL?.trim();
+  if (!value) return void 0;
+  return value;
+}
 function resolveOpensteerAuthScheme(env) {
   return parseAuthScheme(env.OPENSTEER_AUTH_SCHEME, "OPENSTEER_AUTH_SCHEME");
 }
@@ -6255,6 +6297,7 @@ function resolveConfig(input = {}) {
   const mergedWithEnv = mergeDeep(mergedWithFile, envConfig);
   const resolved = mergeDeep(mergedWithEnv, input);
   const envApiKey = resolveOpensteerApiKey(env);
+  const envBaseUrl = resolveOpensteerBaseUrl(env);
   const envAuthScheme = resolveOpensteerAuthScheme(env);
   const envCloudAnnounce = parseCloudAnnounce(
     env.OPENSTEER_REMOTE_ANNOUNCE,
@@ -6272,6 +6315,9 @@ function resolveConfig(input = {}) {
   const inputHasCloudApiKey = Boolean(
     inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "apiKey")
   );
+  const inputHasCloudBaseUrl = Boolean(
+    inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "baseUrl")
+  );
   const cloudSelection = resolveCloudSelection({
     cloud: resolved.cloud
   }, env);
@@ -6291,6 +6337,12 @@ function resolveConfig(input = {}) {
       apiKey: envApiKey
     };
   }
+  if (envBaseUrl && cloudSelection.cloud && !inputHasCloudBaseUrl) {
+    resolved.cloud = {
+      ...normalizeCloudOptions(resolved.cloud) ?? {},
+      baseUrl: envBaseUrl
+    };
+  }
   return resolved;
 }
 function resolveNamespace(config, rootDir) {
@@ -7685,12 +7737,16 @@ function clonePersistedExtractNode(node) {
 
 // src/cloud/runtime.ts
 var DEFAULT_CLOUD_BASE_URL = "https://remote.opensteer.com";
-var DEFAULT_CLOUD_APP_URL = "https://opensteer.com";
-function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key", appUrl = resolveCloudAppUrl()) {
+function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key") {
+  const normalizedBaseUrl = normalizeCloudBaseUrl(baseUrl);
   return {
-    sessionClient: new CloudSessionClient(baseUrl, key, authScheme),
+    sessionClient: new CloudSessionClient(
+      normalizedBaseUrl,
+      key,
+      authScheme
+    ),
     cdpClient: new CloudCdpClient(),
-    appUrl: normalizeCloudAppUrl(appUrl),
+    baseUrl: normalizedBaseUrl,
     actionClient: null,
     sessionId: null,
     localRunId: null,
@@ -7700,15 +7756,9 @@ function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authSchem
 function resolveCloudBaseUrl() {
   const value = process.env.OPENSTEER_BASE_URL?.trim();
   if (!value) return DEFAULT_CLOUD_BASE_URL;
-  return value.replace(/\/+$/, "");
+  return normalizeCloudBaseUrl(value);
 }
-function resolveCloudAppUrl() {
-  const value = process.env.OPENSTEER_APP_URL?.trim();
-  if (!value) return DEFAULT_CLOUD_APP_URL;
-  return normalizeCloudAppUrl(value);
-}
-function normalizeCloudAppUrl(value) {
-  if (!value) return null;
+function normalizeCloudBaseUrl(value) {
   return value.replace(/\/+$/, "");
 }
 function readCloudActionDescription(payload) {
@@ -7766,8 +7816,7 @@ var Opensteer = class _Opensteer {
       this.cloud = createCloudRuntimeState(
         apiKey,
         cloudConfig?.baseUrl,
-        cloudConfig?.authScheme,
-        cloudConfig?.appUrl
+        cloudConfig?.authScheme
       );
     } else {
       this.cloud = null;
@@ -7959,10 +8008,7 @@ var Opensteer = class _Opensteer {
         this.snapshotCache = null;
         this.cloud.actionClient = actionClient;
         this.cloud.sessionId = sessionId;
-        this.cloud.cloudSessionUrl = buildCloudSessionUrl(
-          this.cloud.appUrl,
-          session2.cloudSession.sessionId
-        );
+        this.cloud.cloudSessionUrl = session2.cloudSessionUrl;
         this.announceCloudSession({
           sessionId: session2.sessionId,
           workspaceId: session2.cloudSession.workspaceId,
@@ -10019,12 +10065,6 @@ function buildLocalRunId(namespace) {
   const normalized = namespace.trim() || "default";
   return `${normalized}-${Date.now().toString(36)}-${randomUUID2().slice(0, 8)}`;
 }
-function buildCloudSessionUrl(appUrl, sessionId) {
-  if (!appUrl) {
-    return null;
-  }
-  return `${appUrl}/browser/${encodeURIComponent(sessionId)}`;
-}
 
 export {
   normalizeNamespace,

package/dist/cli/server.cjs

@@ -1036,6 +1036,11 @@ function resolveOpensteerApiKey(env) {
   if (!value) return void 0;
   return value;
 }
+function resolveOpensteerBaseUrl(env) {
+  const value = env.OPENSTEER_BASE_URL?.trim();
+  if (!value) return void 0;
+  return value;
+}
 function resolveOpensteerAuthScheme(env) {
   return parseAuthScheme(env.OPENSTEER_AUTH_SCHEME, "OPENSTEER_AUTH_SCHEME");
 }
@@ -1114,6 +1119,7 @@ function resolveConfig(input = {}) {
   const mergedWithEnv = mergeDeep(mergedWithFile, envConfig);
   const resolved = mergeDeep(mergedWithEnv, input);
   const envApiKey = resolveOpensteerApiKey(env);
+  const envBaseUrl = resolveOpensteerBaseUrl(env);
   const envAuthScheme = resolveOpensteerAuthScheme(env);
   const envCloudAnnounce = parseCloudAnnounce(
     env.OPENSTEER_REMOTE_ANNOUNCE,
@@ -1131,6 +1137,9 @@ function resolveConfig(input = {}) {
   const inputHasCloudApiKey = Boolean(
     inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "apiKey")
   );
+  const inputHasCloudBaseUrl = Boolean(
+    inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "baseUrl")
+  );
   const cloudSelection = resolveCloudSelection({
     cloud: resolved.cloud
   }, env);
@@ -1150,6 +1159,12 @@ function resolveConfig(input = {}) {
       apiKey: envApiKey
     };
   }
+  if (envBaseUrl && cloudSelection.cloud && !inputHasCloudBaseUrl) {
+    resolved.cloud = {
+      ...normalizeCloudOptions(resolved.cloud) ?? {},
+      baseUrl: envBaseUrl
+    };
+  }
   return resolved;
 }
 function resolveNamespace(config, rootDir) {
@@ -1190,6 +1205,7 @@ function getCallerFilePath() {
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_SETTLE_MS = 750;
 var FRAME_EVALUATE_GRACE_MS = 200;
+var TRANSIENT_CONTEXT_RETRY_DELAY_MS = 25;
 var STEALTH_WORLD_NAME = "__opensteer_wait__";
 var StealthWaitUnavailableError = class extends Error {
   constructor(cause) {
@@ -1493,7 +1509,12 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
     const frameRecords = await this.getFrameRecords();
     const mainFrame = frameRecords[0];
     if (!mainFrame) return;
-    await this.waitForFrameVisualStability(mainFrame.frameId, timeout, settleMs);
+    await this.waitForFrameVisualStability(
+      mainFrame.frameId,
+      timeout,
+      settleMs,
+      true
+    );
   }
   async collectVisibleFrameIds() {
     const frameRecords = await this.getFrameRecords();
@@ -1522,19 +1543,44 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
     }
     return visibleFrameIds;
   }
-  async waitForFrameVisualStability(frameId, timeout, settleMs) {
+  async waitForFrameVisualStability(frameId, timeout, settleMs, retryTransientContextErrors = true) {
     if (timeout <= 0) return;
     const script = buildStabilityScript(timeout, settleMs);
-    let contextId = await this.ensureFrameContextId(frameId);
-    try {
-      await this.evaluateWithGuard(contextId, script, timeout);
-    } catch (error) {
-      if (!isMissingExecutionContextError(error)) {
-        throw error;
+    if (!retryTransientContextErrors) {
+      let contextId = await this.ensureFrameContextId(frameId);
+      try {
+        await this.evaluateWithGuard(contextId, script, timeout);
+      } catch (error) {
+        if (!isMissingExecutionContextError(error)) {
+          throw error;
+        }
+        this.contextsByFrame.delete(frameId);
+        contextId = await this.ensureFrameContextId(frameId);
+        await this.evaluateWithGuard(contextId, script, timeout);
+      }
+      return;
+    }
+    const deadline = Date.now() + timeout;
+    while (true) {
+      const remaining = Math.max(0, deadline - Date.now());
+      if (remaining === 0) {
+        return;
+      }
+      const contextId = await this.ensureFrameContextId(frameId);
+      try {
+        await this.evaluateWithGuard(contextId, script, remaining);
+        return;
+      } catch (error) {
+        if (!isTransientExecutionContextError(error)) {
+          throw error;
+        }
+        this.contextsByFrame.delete(frameId);
+        const retryDelay = Math.min(
+          TRANSIENT_CONTEXT_RETRY_DELAY_MS,
+          Math.max(0, deadline - Date.now())
+        );
+        await sleep(retryDelay);
       }
-      this.contextsByFrame.delete(frameId);
-      contextId = await this.ensureFrameContextId(frameId);
-      await this.evaluateWithGuard(contextId, script, timeout);
     }
   }
   async initialize() {
@@ -1654,7 +1700,8 @@ async function waitForVisualStabilityAcrossFrames(page, options = {}) {
             await runtime.waitForFrameVisualStability(
               frameId,
               remaining,
-              settleMs
+              settleMs,
+              false
             );
           } catch (error) {
             if (isIgnorableFrameError(error)) return;
@@ -1692,6 +1739,11 @@ function sameFrameIds(before, after) {
 function formatCdpException(details) {
   return details.exception?.description || details.text || "CDP runtime evaluation failed.";
 }
+function isTransientExecutionContextError(error) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message;
+  return message.includes("Execution context was destroyed") || message.includes("Cannot find context with specified id") || message.includes("Cannot find execution context");
+}
 function isMissingExecutionContextError(error) {
   if (!(error instanceof Error)) return false;
   const message = error.message;
@@ -1700,7 +1752,7 @@ function isMissingExecutionContextError(error) {
 function isIgnorableFrameError(error) {
   if (!(error instanceof Error)) return false;
   const message = error.message;
-  return message.includes("Frame was detached") || message.includes("Execution context was destroyed") || message.includes("Target page, context or browser has been closed") || message.includes("Cannot find context with specified id") || message.includes("Cannot find execution context") || message.includes("No frame for given id found");
+  return message.includes("Frame was detached") || message.includes("Target page, context or browser has been closed") || isTransientExecutionContextError(error) || message.includes("No frame for given id found");
 }
 function sleep(ms) {
   return new Promise((resolve) => {
@@ -8019,12 +8071,16 @@ function toCloudErrorCode(code) {
 
 // src/cloud/runtime.ts
 var DEFAULT_CLOUD_BASE_URL = "https://remote.opensteer.com";
-var DEFAULT_CLOUD_APP_URL = "https://opensteer.com";
-function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key", appUrl = resolveCloudAppUrl()) {
+function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key") {
+  const normalizedBaseUrl = normalizeCloudBaseUrl(baseUrl);
   return {
-    sessionClient: new CloudSessionClient(baseUrl, key, authScheme),
+    sessionClient: new CloudSessionClient(
+      normalizedBaseUrl,
+      key,
+      authScheme
+    ),
     cdpClient: new CloudCdpClient(),
-    appUrl: normalizeCloudAppUrl(appUrl),
+    baseUrl: normalizedBaseUrl,
     actionClient: null,
     sessionId: null,
     localRunId: null,
@@ -8034,15 +8090,9 @@ function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authSchem
 function resolveCloudBaseUrl() {
   const value = process.env.OPENSTEER_BASE_URL?.trim();
   if (!value) return DEFAULT_CLOUD_BASE_URL;
-  return value.replace(/\/+$/, "");
+  return normalizeCloudBaseUrl(value);
 }
-function resolveCloudAppUrl() {
-  const value = process.env.OPENSTEER_APP_URL?.trim();
-  if (!value) return DEFAULT_CLOUD_APP_URL;
-  return normalizeCloudAppUrl(value);
-}
-function normalizeCloudAppUrl(value) {
-  if (!value) return null;
+function normalizeCloudBaseUrl(value) {
   return value.replace(/\/+$/, "");
 }
 function readCloudActionDescription(payload) {
@@ -8100,8 +8150,7 @@ var Opensteer = class _Opensteer {
       this.cloud = createCloudRuntimeState(
         apiKey,
         cloudConfig?.baseUrl,
-        cloudConfig?.authScheme,
-        cloudConfig?.appUrl
+        cloudConfig?.authScheme
       );
     } else {
       this.cloud = null;
@@ -8293,10 +8342,7 @@ var Opensteer = class _Opensteer {
         this.snapshotCache = null;
         this.cloud.actionClient = actionClient;
         this.cloud.sessionId = sessionId;
-        this.cloud.cloudSessionUrl = buildCloudSessionUrl(
-          this.cloud.appUrl,
-          session3.cloudSession.sessionId
-        );
+        this.cloud.cloudSessionUrl = session3.cloudSessionUrl;
         this.announceCloudSession({
           sessionId: session3.sessionId,
           workspaceId: session3.cloudSession.workspaceId,
@@ -10353,12 +10399,6 @@ function buildLocalRunId(namespace) {
   const normalized = namespace.trim() || "default";
   return `${normalized}-${Date.now().toString(36)}-${(0, import_crypto2.randomUUID)().slice(0, 8)}`;
 }
-function buildCloudSessionUrl(appUrl, sessionId) {
-  if (!appUrl) {
-    return null;
-  }
-  return `${appUrl}/browser/${encodeURIComponent(sessionId)}`;
-}
 
 // src/cli/paths.ts
 var import_os2 = require("os");

package/dist/cli/server.js

@@ -1,6 +1,6 @@
 import {
   Opensteer
-} from "../chunk-GQ7HNCM2.js";
+} from "../chunk-C3NM6XZH.js";
 import "../chunk-3H5RRIMZ.js";
 
 // src/cli/server.ts

package/dist/index.cjs

@@ -1111,6 +1111,11 @@ function resolveOpensteerApiKey(env) {
   if (!value) return void 0;
   return value;
 }
+function resolveOpensteerBaseUrl(env) {
+  const value = env.OPENSTEER_BASE_URL?.trim();
+  if (!value) return void 0;
+  return value;
+}
 function resolveOpensteerAuthScheme(env) {
   return parseAuthScheme(env.OPENSTEER_AUTH_SCHEME, "OPENSTEER_AUTH_SCHEME");
 }
@@ -1189,6 +1194,7 @@ function resolveConfig(input = {}) {
   const mergedWithEnv = mergeDeep(mergedWithFile, envConfig);
   const resolved = mergeDeep(mergedWithEnv, input);
   const envApiKey = resolveOpensteerApiKey(env);
+  const envBaseUrl = resolveOpensteerBaseUrl(env);
   const envAuthScheme = resolveOpensteerAuthScheme(env);
   const envCloudAnnounce = parseCloudAnnounce(
     env.OPENSTEER_REMOTE_ANNOUNCE,
@@ -1206,6 +1212,9 @@ function resolveConfig(input = {}) {
   const inputHasCloudApiKey = Boolean(
     inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "apiKey")
   );
+  const inputHasCloudBaseUrl = Boolean(
+    inputCloudOptions && Object.prototype.hasOwnProperty.call(inputCloudOptions, "baseUrl")
+  );
   const cloudSelection = resolveCloudSelection({
     cloud: resolved.cloud
   }, env);
@@ -1225,6 +1234,12 @@ function resolveConfig(input = {}) {
       apiKey: envApiKey
     };
   }
+  if (envBaseUrl && cloudSelection.cloud && !inputHasCloudBaseUrl) {
+    resolved.cloud = {
+      ...normalizeCloudOptions(resolved.cloud) ?? {},
+      baseUrl: envBaseUrl
+    };
+  }
   return resolved;
 }
 function resolveNamespace(config, rootDir) {
@@ -1265,6 +1280,7 @@ function getCallerFilePath() {
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_SETTLE_MS = 750;
 var FRAME_EVALUATE_GRACE_MS = 200;
+var TRANSIENT_CONTEXT_RETRY_DELAY_MS = 25;
 var STEALTH_WORLD_NAME = "__opensteer_wait__";
 var StealthWaitUnavailableError = class extends Error {
   constructor(cause) {
@@ -1568,7 +1584,12 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
     const frameRecords = await this.getFrameRecords();
     const mainFrame = frameRecords[0];
     if (!mainFrame) return;
-    await this.waitForFrameVisualStability(mainFrame.frameId, timeout, settleMs);
+    await this.waitForFrameVisualStability(
+      mainFrame.frameId,
+      timeout,
+      settleMs,
+      true
+    );
   }
   async collectVisibleFrameIds() {
     const frameRecords = await this.getFrameRecords();
@@ -1597,19 +1618,44 @@ var StealthCdpRuntime = class _StealthCdpRuntime {
     }
     return visibleFrameIds;
   }
-  async waitForFrameVisualStability(frameId, timeout, settleMs) {
+  async waitForFrameVisualStability(frameId, timeout, settleMs, retryTransientContextErrors = true) {
     if (timeout <= 0) return;
     const script = buildStabilityScript(timeout, settleMs);
-    let contextId = await this.ensureFrameContextId(frameId);
-    try {
-      await this.evaluateWithGuard(contextId, script, timeout);
-    } catch (error) {
-      if (!isMissingExecutionContextError(error)) {
-        throw error;
+    if (!retryTransientContextErrors) {
+      let contextId = await this.ensureFrameContextId(frameId);
+      try {
+        await this.evaluateWithGuard(contextId, script, timeout);
+      } catch (error) {
+        if (!isMissingExecutionContextError(error)) {
+          throw error;
+        }
+        this.contextsByFrame.delete(frameId);
+        contextId = await this.ensureFrameContextId(frameId);
+        await this.evaluateWithGuard(contextId, script, timeout);
+      }
+      return;
+    }
+    const deadline = Date.now() + timeout;
+    while (true) {
+      const remaining = Math.max(0, deadline - Date.now());
+      if (remaining === 0) {
+        return;
+      }
+      const contextId = await this.ensureFrameContextId(frameId);
+      try {
+        await this.evaluateWithGuard(contextId, script, remaining);
+        return;
+      } catch (error) {
+        if (!isTransientExecutionContextError(error)) {
+          throw error;
+        }
+        this.contextsByFrame.delete(frameId);
+        const retryDelay = Math.min(
+          TRANSIENT_CONTEXT_RETRY_DELAY_MS,
+          Math.max(0, deadline - Date.now())
+        );
+        await sleep(retryDelay);
       }
-      this.contextsByFrame.delete(frameId);
-      contextId = await this.ensureFrameContextId(frameId);
-      await this.evaluateWithGuard(contextId, script, timeout);
     }
   }
   async initialize() {
@@ -1729,7 +1775,8 @@ async function waitForVisualStabilityAcrossFrames(page, options = {}) {
             await runtime.waitForFrameVisualStability(
               frameId,
               remaining,
-              settleMs
+              settleMs,
+              false
             );
           } catch (error) {
             if (isIgnorableFrameError(error)) return;
@@ -1767,6 +1814,11 @@ function sameFrameIds(before, after) {
 function formatCdpException(details) {
   return details.exception?.description || details.text || "CDP runtime evaluation failed.";
 }
+function isTransientExecutionContextError(error) {
+  if (!(error instanceof Error)) return false;
+  const message = error.message;
+  return message.includes("Execution context was destroyed") || message.includes("Cannot find context with specified id") || message.includes("Cannot find execution context");
+}
 function isMissingExecutionContextError(error) {
   if (!(error instanceof Error)) return false;
   const message = error.message;
@@ -1775,7 +1827,7 @@ function isMissingExecutionContextError(error) {
 function isIgnorableFrameError(error) {
   if (!(error instanceof Error)) return false;
   const message = error.message;
-  return message.includes("Frame was detached") || message.includes("Execution context was destroyed") || message.includes("Target page, context or browser has been closed") || message.includes("Cannot find context with specified id") || message.includes("Cannot find execution context") || message.includes("No frame for given id found");
+  return message.includes("Frame was detached") || message.includes("Target page, context or browser has been closed") || isTransientExecutionContextError(error) || message.includes("No frame for given id found");
 }
 function sleep(ms) {
   return new Promise((resolve) => {
@@ -8104,12 +8156,16 @@ function toCloudErrorCode(code) {
 
 // src/cloud/runtime.ts
 var DEFAULT_CLOUD_BASE_URL = "https://remote.opensteer.com";
-var DEFAULT_CLOUD_APP_URL = "https://opensteer.com";
-function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key", appUrl = resolveCloudAppUrl()) {
+function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authScheme = "api-key") {
+  const normalizedBaseUrl = normalizeCloudBaseUrl(baseUrl);
   return {
-    sessionClient: new CloudSessionClient(baseUrl, key, authScheme),
+    sessionClient: new CloudSessionClient(
+      normalizedBaseUrl,
+      key,
+      authScheme
+    ),
     cdpClient: new CloudCdpClient(),
-    appUrl: normalizeCloudAppUrl(appUrl),
+    baseUrl: normalizedBaseUrl,
     actionClient: null,
     sessionId: null,
     localRunId: null,
@@ -8119,15 +8175,9 @@ function createCloudRuntimeState(key, baseUrl = resolveCloudBaseUrl(), authSchem
 function resolveCloudBaseUrl() {
   const value = process.env.OPENSTEER_BASE_URL?.trim();
   if (!value) return DEFAULT_CLOUD_BASE_URL;
-  return value.replace(/\/+$/, "");
+  return normalizeCloudBaseUrl(value);
 }
-function resolveCloudAppUrl() {
-  const value = process.env.OPENSTEER_APP_URL?.trim();
-  if (!value) return DEFAULT_CLOUD_APP_URL;
-  return normalizeCloudAppUrl(value);
-}
-function normalizeCloudAppUrl(value) {
-  if (!value) return null;
+function normalizeCloudBaseUrl(value) {
   return value.replace(/\/+$/, "");
 }
 function readCloudActionDescription(payload) {
@@ -8185,8 +8235,7 @@ var Opensteer = class _Opensteer {
       this.cloud = createCloudRuntimeState(
         apiKey,
         cloudConfig?.baseUrl,
-        cloudConfig?.authScheme,
-        cloudConfig?.appUrl
+        cloudConfig?.authScheme
       );
     } else {
       this.cloud = null;
@@ -8378,10 +8427,7 @@ var Opensteer = class _Opensteer {
         this.snapshotCache = null;
         this.cloud.actionClient = actionClient;
         this.cloud.sessionId = sessionId;
-        this.cloud.cloudSessionUrl = buildCloudSessionUrl(
-          this.cloud.appUrl,
-          session2.cloudSession.sessionId
-        );
+        this.cloud.cloudSessionUrl = session2.cloudSessionUrl;
         this.announceCloudSession({
           sessionId: session2.sessionId,
           workspaceId: session2.cloudSession.workspaceId,
@@ -10438,12 +10484,6 @@ function buildLocalRunId(namespace) {
   const normalized = namespace.trim() || "default";
   return `${normalized}-${Date.now().toString(36)}-${(0, import_crypto2.randomUUID)().slice(0, 8)}`;
 }
-function buildCloudSessionUrl(appUrl, sessionId) {
-  if (!appUrl) {
-    return null;
-  }
-  return `${appUrl}/browser/${encodeURIComponent(sessionId)}`;
-}
 
 // src/ai/index.ts
 init_resolver();

package/dist/index.d.cts

@@ -127,7 +127,6 @@ type OpensteerCloudAnnouncePolicy = 'always' | 'off' | 'tty';
 interface OpensteerCloudOptions {
     apiKey?: string;
     baseUrl?: string;
-    appUrl?: string;
     authScheme?: OpensteerAuthScheme;
     announce?: OpensteerCloudAnnouncePolicy;
 }

package/dist/index.d.ts

@@ -127,7 +127,6 @@ type OpensteerCloudAnnouncePolicy = 'always' | 'off' | 'tty';
 interface OpensteerCloudOptions {
     apiKey?: string;
     baseUrl?: string;
-    appUrl?: string;
     authScheme?: OpensteerAuthScheme;
     announce?: OpensteerCloudAnnouncePolicy;
 }

package/dist/index.js

@@ -68,7 +68,7 @@ import {
   switchTab,
   typeText,
   waitForVisualStability
-} from "./chunk-GQ7HNCM2.js";
+} from "./chunk-C3NM6XZH.js";
 import {
   createResolveCallback
 } from "./chunk-SRJLH34D.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensteer",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "Open-source browser automation SDK with robust selectors and deterministic replay.",
   "license": "MIT",
   "type": "module",