opensteer 0.9.6 → 0.9.8

package/dist/{chunk-BVRIPCWA.js → chunk-LFWP5RXF.js}

@@ -1,5 +1,5 @@
-import { objectSchema, stringSchema, literalSchema, JSON_SCHEMA_DRAFT_2020_12, integerSchema, enumSchema, oneOfSchema, numberSchema, arraySchema, recordSchema, defineSchema, opensteerCapabilitySetSchema, opensteerErrorSchema, OpensteerProtocolError, resolveFilesystemWorkspacePath, createFilesystemOpensteerWorkspace, DEFAULT_OPENSTEER_ENGINE, createOpensteerError, assertSupportedEngineOptions, normalizeObservabilityConfig, manifestToExternalBinaryLocation, normalizeObservationContext, OpensteerBrowserManager, isOpensteerProtocolError, toOpensteerError } from './chunk-3XBQRZZC.js';
-import { canonicalJsonString, toCanonicalJsonValue, readPersistedCloudSessionRecord, writePersistedSessionRecord, clearPersistedSessionRecord, resolveBrandUserDataDir, sha256Hex, getBrowserBrand, detectInstalledBrowserBrands, __require } from './chunk-T5P2QGZ3.js';
+import { objectSchema, stringSchema, literalSchema, JSON_SCHEMA_DRAFT_2020_12, integerSchema, enumSchema, oneOfSchema, numberSchema, arraySchema, recordSchema, defineSchema, opensteerCapabilitySetSchema, opensteerErrorSchema, OpensteerProtocolError, resolveFilesystemWorkspacePath, createFilesystemOpensteerWorkspace, DEFAULT_OPENSTEER_ENGINE, createOpensteerError, assertSupportedEngineOptions, normalizeObservabilityConfig, manifestToExternalBinaryLocation, OpensteerBrowserManager, isOpensteerProtocolError, normalizeObservationContext, toOpensteerError } from './chunk-EXXRLPLI.js';
+import { canonicalJsonString, toCanonicalJsonValue, readPersistedCloudSessionRecord, writePersistedSessionRecord, clearPersistedSessionRecord, resolveBrandUserDataDir, getBrowserBrand, detectInstalledBrowserBrands, __require, normalizeNonEmptyString, sha256Hex, readPersistedLocalBrowserSessionRecord } from './chunk-GKYBP3KD.js';
 import { selectAll } from 'css-select';
 import { createHash, randomUUID, pbkdf2Sync, createDecipheriv } from 'crypto';
 import { existsSync, readFileSync } from 'fs';
@@ -7,7 +7,7 @@ import path2, { join } from 'path';
 import { promisify } from 'util';
 import { gzip as gzip$1 } from 'zlib';
 import { execFile as execFile$1, spawn } from 'child_process';
-import { rm, mkdtemp, copyFile, writeFile, readFile } from 'fs/promises';
+import { rm, mkdtemp, copyFile, readFile, writeFile } from 'fs/promises';
 import { tmpdir } from 'os';
 import { AsyncLocalStorage } from 'async_hooks';
 import sharp from 'sharp';
@@ -238,14 +238,14 @@ var DEFAULT_SETTLE_DELAYS = {
   snapshot: 0
 };
 var DOM_ACTION_VISUAL_STABILITY_PROFILES = {
-  "dom.click": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
-  "dom.input": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
-  "dom.scroll": { settleMs: 600, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.click": { settleMs: 750, scope: "main-frame", timeoutMs: 7e3 },
+  "dom.input": { settleMs: 750, scope: "main-frame", timeoutMs: 7e3 },
+  "dom.scroll": { settleMs: 600, scope: "main-frame", timeoutMs: 7e3 },
   "dom.hover": { settleMs: 200, scope: "main-frame", timeoutMs: 2500 }
 };
 var DEFAULT_DOM_ACTION_VISUAL_STABILITY_PROFILE = {
   settleMs: 750,
-  scope: "visible-frames",
+  scope: "main-frame",
   timeoutMs: 7e3
 };
 var NAVIGATION_VISUAL_STABILITY_PROFILE = {
@@ -269,6 +269,7 @@ var defaultDomActionSettleObserver = {
         pageRef: input.pageRef,
         timeoutMs: effectiveTimeout,
         settleMs: profile.settleMs,
+        ...input.observedMutationQuietMs === void 0 ? {} : { initialQuietMs: input.observedMutationQuietMs },
         scope: profile.scope
       });
       return true;
@@ -289,15 +290,20 @@ var defaultNavigationSettleObserver = {
       return false;
     }
     try {
-      const startedAt = Date.now();
-      await input.engine.waitForPostLoadQuiet({
-        pageRef: input.pageRef,
-        timeoutMs: effectiveTimeout,
-        quietMs: DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS,
-        captureWindowMs: Math.min(NAVIGATION_POST_LOAD_CAPTURE_WINDOW_MS, effectiveTimeout),
-        signal: input.signal
-      });
-      const visualTimeout = Math.max(0, effectiveTimeout - (Date.now() - startedAt));
+      let visualTimeout = effectiveTimeout;
+      let initialQuietMs = input.observedMutationQuietMs ?? 0;
+      if (!input.postLoadHandled) {
+        const startedAt = Date.now();
+        await input.engine.waitForPostLoadQuiet({
+          pageRef: input.pageRef,
+          timeoutMs: effectiveTimeout,
+          quietMs: DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS,
+          captureWindowMs: Math.min(NAVIGATION_POST_LOAD_CAPTURE_WINDOW_MS, effectiveTimeout),
+          signal: input.signal
+        });
+        visualTimeout = Math.max(0, effectiveTimeout - (Date.now() - startedAt));
+        initialQuietMs = Math.max(initialQuietMs, DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS);
+      }
       if (visualTimeout <= 0) {
         return true;
       }
@@ -305,6 +311,7 @@ var defaultNavigationSettleObserver = {
         pageRef: input.pageRef,
         timeoutMs: visualTimeout,
         settleMs: profile.settleMs,
+        ...initialQuietMs <= 0 ? {} : { initialQuietMs },
         scope: profile.scope
       });
       return true;
@@ -626,7 +633,7 @@ function isJsonValueEqual(expected, actual) {
 
 // ../protocol/src/version.ts
 var OPENSTEER_PROTOCOL_NAME = "opensteer";
-var OPENSTEER_PROTOCOL_COMPATIBILITY_REVISION = 2;
+var OPENSTEER_PROTOCOL_COMPATIBILITY_REVISION = 3;
 var OPENSTEER_PROTOCOL_VERSION = `0.${OPENSTEER_PROTOCOL_COMPATIBILITY_REVISION}.0`;
 var OPENSTEER_PROTOCOL_REST_BASE_PATH = `/api/v${OPENSTEER_PROTOCOL_COMPATIBILITY_REVISION}`;
 objectSchema(
@@ -815,7 +822,7 @@ var visualViewportSchema = objectSchema(
     required: ["origin", "offsetWithinLayoutViewport", "size"]
   }
 );
-var viewportMetricsSchema = objectSchema(
+objectSchema(
   {
     layoutViewport: layoutViewportSchema,
     visualViewport: visualViewportSchema,
@@ -850,6 +857,9 @@ var pageInfoSchema = objectSchema(
   {
     pageRef: pageRefSchema,
     sessionRef: sessionRefSchema,
+    targetId: stringSchema({
+      description: "Underlying browser target identifier when available."
+    }),
     openerPageRef: pageRefSchema,
     url: stringSchema({
       description: "Current main-frame URL."
@@ -2266,7 +2276,7 @@ var domSnapshotSchema = objectSchema(
     ]
   }
 );
-var hitTestResultSchema = objectSchema(
+objectSchema(
   {
     inputPoint: pointSchema,
     inputCoordinateSpace: coordinateSpaceSchema,
@@ -3573,39 +3583,14 @@ var opensteerTargetInputSchema = oneOfSchema(
     title: "OpensteerTargetInput"
   }
 );
-var opensteerResolvedTargetSchema = objectSchema(
-  {
-    pageRef: pageRefSchema,
-    frameRef: frameRefSchema,
-    documentRef: documentRefSchema,
-    documentEpoch: documentEpochSchema,
-    nodeRef: nodeRefSchema,
-    tagName: stringSchema(),
-    pathHint: stringSchema(),
-    persist: stringSchema(),
-    selectorUsed: stringSchema()
-  },
-  {
-    title: "OpensteerResolvedTarget",
-    required: [
-      "pageRef",
-      "frameRef",
-      "documentRef",
-      "documentEpoch",
-      "nodeRef",
-      "tagName",
-      "pathHint"
-    ]
-  }
-);
 var opensteerActionResultSchema = objectSchema(
   {
-    target: opensteerResolvedTargetSchema,
-    point: pointSchema
+    tagName: stringSchema({ minLength: 1 }),
+    persist: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerActionResult",
-    required: ["target"]
+    required: ["tagName"]
   }
 );
 var opensteerSnapshotCounterSchema = objectSchema(
@@ -3651,16 +3636,14 @@ var opensteerSnapshotCounterSchema = objectSchema(
     ]
   }
 );
-var opensteerSessionStateSchema = objectSchema(
+var opensteerNavigationSummarySchema = objectSchema(
   {
-    sessionRef: sessionRefSchema,
-    pageRef: pageRefSchema,
     url: stringSchema(),
     title: stringSchema()
   },
   {
-    title: "OpensteerSessionState",
-    required: ["sessionRef", "pageRef", "url", "title"]
+    title: "OpensteerNavigationSummary",
+    required: ["url", "title"]
   }
 );
 var opensteerOpenInputSchema = objectSchema(
@@ -3728,6 +3711,17 @@ var opensteerPageCloseOutputSchema = objectSchema(
     required: ["closedPageRef", "pages"]
   }
 );
+var opensteerPageNewOutputSchema = objectSchema(
+  {
+    pageRef: pageRefSchema,
+    url: stringSchema(),
+    title: stringSchema()
+  },
+  {
+    title: "OpensteerPageNewOutput",
+    required: ["pageRef", "url", "title"]
+  }
+);
 var opensteerPageGotoInputSchema = objectSchema(
   {
     url: stringSchema(),
@@ -4114,72 +4108,28 @@ var opensteerComputerExecuteInputSchema = objectSchema(
     required: ["action"]
   }
 );
-var opensteerComputerTracePointSchema = objectSchema(
-  {
-    role: enumSchema(["point", "start", "end"]),
-    point: pointSchema,
-    hitTest: hitTestResultSchema,
-    target: opensteerResolvedTargetSchema
-  },
-  {
-    title: "OpensteerComputerTracePoint",
-    required: ["role", "point"]
-  }
-);
-var opensteerComputerTraceEnrichmentSchema = objectSchema(
-  {
-    points: arraySchema(opensteerComputerTracePointSchema)
-  },
-  {
-    title: "OpensteerComputerTraceEnrichment",
-    required: ["points"]
-  }
-);
-var opensteerComputerExecuteTimingSchema = objectSchema(
-  {
-    actionMs: integerSchema({ minimum: 0 }),
-    waitMs: integerSchema({ minimum: 0 }),
-    totalMs: integerSchema({ minimum: 0 })
-  },
-  {
-    title: "OpensteerComputerExecuteTiming",
-    required: ["actionMs", "waitMs", "totalMs"]
-  }
-);
-var opensteerComputerDisplayScaleSchema = objectSchema(
+var opensteerScreenshotSummarySchema = objectSchema(
   {
-    x: numberSchema({ exclusiveMinimum: 0 }),
-    y: numberSchema({ exclusiveMinimum: 0 })
+    payload: externalBinaryLocationSchema,
+    format: screenshotFormatSchema,
+    size: sizeSchema,
+    coordinateSpace: coordinateSpaceSchema,
+    clip: rectSchema
   },
   {
-    title: "OpensteerComputerDisplayScale",
-    required: ["x", "y"]
+    title: "OpensteerScreenshotSummary",
+    required: ["payload", "format", "size", "coordinateSpace"]
   }
 );
 var opensteerComputerExecuteOutputSchema = objectSchema(
   {
-    action: opensteerComputerActionSchema,
-    pageRef: pageRefSchema,
-    screenshot: screenshotArtifactSchema,
-    displayViewport: viewportMetricsSchema,
-    nativeViewport: viewportMetricsSchema,
-    displayScale: opensteerComputerDisplayScaleSchema,
-    events: arraySchema(opensteerEventSchema),
-    timing: opensteerComputerExecuteTimingSchema,
-    trace: opensteerComputerTraceEnrichmentSchema
+    url: stringSchema(),
+    title: stringSchema(),
+    screenshot: opensteerScreenshotSummarySchema
   },
   {
     title: "OpensteerComputerExecuteOutput",
-    required: [
-      "action",
-      "pageRef",
-      "screenshot",
-      "displayViewport",
-      "nativeViewport",
-      "displayScale",
-      "events",
-      "timing"
-    ]
+    required: ["url", "title", "screenshot"]
   }
 );
 function assertValidSemanticOperationInput(name, input) {
@@ -4205,7 +4155,7 @@ var opensteerSemanticOperationSpecificationsBase = [
     name: "session.open",
     description: "Open or resume the current Opensteer session and primary page.",
     inputSchema: opensteerOpenInputSchema,
-    outputSchema: opensteerSessionStateSchema,
+    outputSchema: opensteerNavigationSummarySchema,
     requiredCapabilities: ["sessions.manage", "pages.manage"],
     resolveRequiredCapabilities: (input) => input.url === void 0 ? ["sessions.manage", "pages.manage"] : ["sessions.manage", "pages.manage", "pages.navigate"]
   }),
@@ -4220,7 +4170,7 @@ var opensteerSemanticOperationSpecificationsBase = [
     name: "page.new",
     description: "Create and optionally navigate a new top-level page in the current session.",
     inputSchema: opensteerPageNewInputSchema,
-    outputSchema: opensteerSessionStateSchema,
+    outputSchema: opensteerPageNewOutputSchema,
     requiredCapabilities: ["pages.manage"],
     resolveRequiredCapabilities: (input) => input.url === void 0 ? ["pages.manage"] : ["pages.manage", "pages.navigate"]
   }),
@@ -4228,7 +4178,7 @@ var opensteerSemanticOperationSpecificationsBase = [
     name: "page.activate",
     description: "Activate an existing top-level page in the current session.",
     inputSchema: opensteerPageActivateInputSchema,
-    outputSchema: opensteerSessionStateSchema,
+    outputSchema: opensteerNavigationSummarySchema,
     requiredCapabilities: ["pages.manage", "inspect.pages"]
   }),
   defineSemanticOperationSpec({
@@ -4242,7 +4192,7 @@ var opensteerSemanticOperationSpecificationsBase = [
     name: "page.goto",
     description: "Navigate the current Opensteer page to a new URL.",
     inputSchema: opensteerPageGotoInputSchema,
-    outputSchema: opensteerSessionStateSchema,
+    outputSchema: opensteerNavigationSummarySchema,
     requiredCapabilities: ["pages.navigate"]
   }),
   defineSemanticOperationSpec({
@@ -5006,7 +4956,9 @@ function resolveExtractedValueInContext(normalizedValue, options) {
 function stripPositionClauses(nodes) {
   return (nodes || []).map((node) => ({
     ...node,
-    match: (node.match || []).filter((clause) => clause.kind !== "position" && clause.kind !== "text")
+    match: (node.match || []).filter(
+      (clause) => clause.kind !== "position" && clause.kind !== "text"
+    )
   }));
 }
 function dedupeSelectors(selectors) {
@@ -6498,7 +6450,7 @@ var DomActionExecutor = class {
         ...snapshot === void 0 ? {} : { snapshot },
         signal: timeout.signal,
         remainingMs: () => timeout.remainingMs(),
-        policySettle: async (targetPageRef, trigger) => {
+        policySettle: async (targetPageRef, trigger, boundary2) => {
           try {
             await settleWithPolicy(this.options.policy.settle, {
               operation,
@@ -6506,7 +6458,9 @@ var DomActionExecutor = class {
               engine: this.options.engine,
               pageRef: targetPageRef,
               signal: timeout.signal,
-              remainingMs: timeout.remainingMs()
+              remainingMs: timeout.remainingMs(),
+              ...boundary2?.observedMutationQuietMs === void 0 ? {} : { observedMutationQuietMs: boundary2.observedMutationQuietMs },
+              ...boundary2?.postLoadHandled === true ? { postLoadHandled: true } : {}
             });
           } catch (error) {
             if (snapshot !== void 0 && isSoftSettleTimeoutError(error, timeout.signal)) {
@@ -7274,7 +7228,9 @@ var DefaultDomRuntime = class {
         `Unable to resolve structural anchor "${buildPathSelectorHint(anchor)}" in the current session`
       );
     }
-    const replayPath = await this.tryBuildPathFromNode(context.snapshot, target.node, { enableTextMatch: true });
+    const replayPath = await this.tryBuildPathFromNode(context.snapshot, target.node, {
+      enableTextMatch: true
+    });
     return this.createResolvedTarget(source, context.snapshot, target.node, anchor, {
       ...persist === void 0 ? {} : { persist },
       ...replayPath === void 0 ? {} : { replayPath }
@@ -9240,7 +9196,7 @@ function normalizeTemplateField(value) {
       "Extraction field descriptors must specify exactly one of c/element, selector, or source."
     );
   }
-  const attribute = raw.attr !== void 0 ? normalizeNonEmptyString("attr", raw.attr) : raw.attribute === void 0 ? void 0 : normalizeNonEmptyString("attribute", raw.attribute);
+  const attribute = raw.attr !== void 0 ? normalizeNonEmptyString2("attr", raw.attr) : raw.attribute === void 0 ? void 0 : normalizeNonEmptyString2("attribute", raw.attribute);
   if (hasSource) {
     if (raw.source !== "current_url") {
       throw new Error(`Unsupported extraction source "${String(raw.source)}".`);
@@ -9251,7 +9207,7 @@ function normalizeTemplateField(value) {
   }
   if (hasSelector) {
     return {
-      selector: normalizeNonEmptyString("selector", raw.selector),
+      selector: normalizeNonEmptyString2("selector", raw.selector),
       ...attribute === void 0 ? {} : { attribute }
     };
   }
@@ -9459,7 +9415,7 @@ var MemoryOpensteerExtractionDescriptorStore = class {
     return record;
   }
 };
-function normalizeNonEmptyString(name, value) {
+function normalizeNonEmptyString2(name, value) {
   const normalized = String(value ?? "").trim();
   if (normalized.length === 0) {
     throw new Error(`${name} must not be empty`);
@@ -10270,11 +10226,11 @@ function delay(ms) {
 function wrapCloudFetchError(error, input) {
   if (!(error instanceof Error)) {
     return new Error(
-      `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check OPENSTEER_BASE_URL and network reachability from this environment.`
+      `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check the configured Opensteer cloud base URL and network reachability from this environment.`
     );
   }
   const wrapped = new Error(
-    `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check OPENSTEER_BASE_URL and network reachability from this environment.`,
+    `Failed to reach Opensteer cloud endpoint ${input.method} ${input.url}. Check the configured Opensteer cloud base URL and network reachability from this environment.`,
     {
       cause: error
     }
@@ -10314,6 +10270,7 @@ function asCloudErrorPayload(value) {
 }
 
 // src/cloud/config.ts
+var DEFAULT_OPENSTEER_CLOUD_BASE_URL = "https://api.opensteer.com";
 function resolveCloudConfig(input = {}) {
   const provider = resolveOpensteerProvider({
     ...input.provider === void 0 ? {} : { provider: input.provider },
@@ -10323,30 +10280,34 @@ function resolveCloudConfig(input = {}) {
     return void 0;
   }
   const cloudProvider = input.provider?.mode === "cloud" ? input.provider : void 0;
-  const apiKey = cloudProvider?.apiKey ?? input.environment?.OPENSTEER_API_KEY;
-  if (!apiKey || apiKey.trim().length === 0) {
+  const apiKey = normalizeOptionalCloudConfigValue(cloudProvider?.apiKey) ?? normalizeOptionalCloudConfigValue(input.environment?.OPENSTEER_API_KEY);
+  if (apiKey === void 0) {
     throw new Error("provider=cloud requires OPENSTEER_API_KEY or provider.apiKey.");
   }
-  const baseUrl = cloudProvider?.baseUrl ?? input.environment?.OPENSTEER_BASE_URL;
-  if (!baseUrl || baseUrl.trim().length === 0) {
-    throw new Error("provider=cloud requires OPENSTEER_BASE_URL or provider.baseUrl.");
-  }
-  const appBaseUrl = cloudProvider?.appBaseUrl ?? input.environment?.OPENSTEER_CLOUD_APP_BASE_URL;
+  const baseUrl = normalizeOptionalCloudConfigValue(cloudProvider?.baseUrl) ?? normalizeOptionalCloudConfigValue(input.environment?.OPENSTEER_BASE_URL) ?? DEFAULT_OPENSTEER_CLOUD_BASE_URL;
+  const appBaseUrl = normalizeOptionalCloudConfigValue(cloudProvider?.appBaseUrl) ?? normalizeOptionalCloudConfigValue(input.environment?.OPENSTEER_CLOUD_APP_BASE_URL);
   return {
-    apiKey: apiKey.trim(),
-    baseUrl: baseUrl.trim().replace(/\/+$/, ""),
-    ...appBaseUrl === void 0 || appBaseUrl.trim().length === 0 ? {} : { appBaseUrl: appBaseUrl.trim().replace(/\/+$/, "") },
+    apiKey,
+    baseUrl,
+    ...appBaseUrl === void 0 ? {} : { appBaseUrl },
     ...cloudProvider?.browserProfile === void 0 ? {} : { browserProfile: cloudProvider.browserProfile }
   };
 }
 function requireCloudAppBaseUrl(cloudConfig) {
-  const appBaseUrl = cloudConfig.appBaseUrl;
-  if (!appBaseUrl || appBaseUrl.trim().length === 0) {
+  const appBaseUrl = normalizeOptionalCloudConfigValue(cloudConfig.appBaseUrl);
+  if (appBaseUrl === void 0) {
     throw new Error(
       'record with provider=cloud requires OPENSTEER_CLOUD_APP_BASE_URL or "--cloud-app-base-url".'
     );
   }
-  return appBaseUrl.trim().replace(/\/+$/, "");
+  return appBaseUrl;
+}
+function normalizeOptionalCloudConfigValue(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim().replace(/\/+$/, "");
+  return normalized.length === 0 ? void 0 : normalized;
 }
 
 // ../runtime-core/src/sdk/semantic-dispatch.ts
@@ -10487,7 +10448,7 @@ async function dispatchSemanticOperation(runtime, operation, input, options = {}
 
 // ../runtime-core/package.json
 var package_default = {
-  version: "0.2.5"};
+  version: "0.2.7"};
 
 // ../runtime-core/src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -10758,12 +10719,16 @@ function toOpensteerResolvedTarget(target) {
     documentRef: target.documentRef,
     documentEpoch: target.documentEpoch,
     nodeRef: target.nodeRef,
-    tagName: target.node.nodeName.toUpperCase(),
+    tagName: toOpensteerTagName(target.node.nodeName),
     pathHint: buildPathSelectorHint(target.replayPath ?? target.anchor),
     ...target.persist === void 0 ? {} : { persist: target.persist },
     ...target.selectorUsed === void 0 ? {} : { selectorUsed: target.selectorUsed }
   };
 }
+function toOpensteerTagName(nodeName) {
+  const tagName = String(nodeName).trim().toLowerCase();
+  return tagName.length === 0 ? "element" : tagName;
+}
 
 // ../runtime-core/src/runtimes/computer-use/runtime.ts
 function createComputerUseRuntime(options) {
@@ -10797,7 +10762,7 @@ var DefaultComputerUseRuntime = class {
         screenshot,
         signal: input.timeout.signal,
         remainingMs: () => input.timeout.remainingMs(),
-        policySettle: async (pageRef, trigger) => {
+        policySettle: async (pageRef, trigger, boundary) => {
           try {
             await settleWithPolicy(this.options.policy.settle, {
               operation: "computer.execute",
@@ -10805,7 +10770,9 @@ var DefaultComputerUseRuntime = class {
               engine: this.options.engine,
               pageRef,
               signal: input.timeout.signal,
-              remainingMs: input.timeout.remainingMs()
+              remainingMs: input.timeout.remainingMs(),
+              ...boundary?.observedMutationQuietMs === void 0 ? {} : { observedMutationQuietMs: boundary.observedMutationQuietMs },
+              ...boundary?.postLoadHandled === true ? { postLoadHandled: true } : {}
             });
           } catch (error) {
             if (pageRef === input.pageRef && isSoftSettleTimeoutError(error, input.timeout.signal)) {
@@ -11983,28 +11950,24 @@ function restoreBoundedAttr(el, attr, value) {
   }
   setBoundedAttr(el, attr, value);
 }
-function deduplicateImages(html) {
+function deduplicateImagesInDom($) {
   const seen = /* @__PURE__ */ new Set();
-  return html.replace(/<img\b([^>]*)>/gi, (full, attrContent) => {
-    if (/\bc\s*=/.test(attrContent)) {
-      return full;
-    }
-    const srcMatch = attrContent.match(/\bsrc\s*=\s*(["']?)(.*?)\1/);
-    const srcsetMatch = attrContent.match(/\bsrcset\s*=\s*(["'])(.*?)\1/);
-    let src = null;
-    if (srcMatch && srcMatch[2]) {
-      src = srcMatch[2].trim();
-    } else if (srcsetMatch && srcsetMatch[2]) {
-      src = srcsetMatch[2].split(",")[0]?.trim().split(" ")[0] ?? null;
+  $("img").each(function deduplicateDomImage() {
+    const el = $(this);
+    if (el.attr("c") !== void 0) {
+      return;
     }
+    const srcValue = el.attr("src")?.trim();
+    const srcsetValue = el.attr("srcset");
+    const src = srcValue && srcValue.length > 0 ? srcValue : srcsetValue?.split(",")[0]?.trim().split(/\s+/u)[0];
     if (!src) {
-      return full;
+      return;
     }
     if (seen.has(src)) {
-      return "";
+      el.remove();
+      return;
     }
     seen.add(src);
-    return full;
   });
 }
 function hasAttribute2(node, attr) {
@@ -12062,23 +12025,6 @@ function isPreservedImageElement(node) {
 function getElementsInReverseDocumentOrder($) {
   return $.root().find("*").toArray().reverse().filter((node) => node.type === "tag");
 }
-function getNodeDepth(node) {
-  let depth = 0;
-  let current = node.parent;
-  while (current) {
-    depth++;
-    current = current.parent;
-  }
-  return depth;
-}
-function getElementsByDepthDescending($) {
-  const elements = $.root().find("*").toArray().filter((node) => node.type === "tag");
-  const depths = /* @__PURE__ */ new Map();
-  for (const el of elements) {
-    depths.set(el, getNodeDepth(el));
-  }
-  return elements.sort((a, b) => (depths.get(b) ?? 0) - (depths.get(a) ?? 0));
-}
 function flattenExtractionTree($) {
   for (const node of getElementsInReverseDocumentOrder($)) {
     const el = $(node);
@@ -12096,19 +12042,6 @@ function flattenExtractionTree($) {
     el.replaceWith(el.contents());
   }
 }
-function hasMarkedAncestor(el, attr) {
-  let current = el[0]?.parent;
-  while (current) {
-    if (!isElementLikeNode(current)) {
-      return false;
-    }
-    if (current.attribs?.[attr] !== void 0) {
-      return true;
-    }
-    current = current.parent;
-  }
-  return false;
-}
 function isIndicatorImage(node) {
   return (node?.tagName || "").toLowerCase() === "img" && (hasAttribute2(node, "alt") || hasAttribute2(node, "src") || hasAttribute2(node, "srcset"));
 }
@@ -12226,7 +12159,7 @@ function serializeForExtraction($, root) {
   traverse(root, 0);
   return lines.map((l) => l.trim()).filter((l) => l.length > 0).join("");
 }
-function isClickable($, el, context) {
+function isClickable(el, context) {
   if (context.hasPreMarked) {
     return el.attr(OPENSTEER_INTERACTIVE_ATTR) !== void 0;
   }
@@ -12260,21 +12193,17 @@ function isClickable($, el, context) {
   }
   return false;
 }
-function cleanForExtraction(html) {
+function prepareExtractionSnapshotDom(html) {
   if (!html.trim()) {
-    return "";
+    return void 0;
   }
   const $ = cheerio.load(html, { xmlMode: false });
   removeNoise($);
   removeComments($);
   markInlineSelfHiddenFallback($);
   pruneSelfHiddenNodes($);
-  const $clean = cheerio.load(
-    $.html().replace(/\n{2,}/g, "\n").trim(),
-    { xmlMode: false }
-  );
-  $clean("*").each(function stripAndRestoreExtractionAttrs() {
-    const el = $clean(this);
+  $("*").each(function stripAndRestoreExtractionAttrs() {
+    const el = $(this);
     const node = el[0];
     if (!node) {
       return;
@@ -12315,16 +12244,20 @@ function cleanForExtraction(html) {
       restoreBoundedAttr(el, "href", hrefValue);
     }
   });
-  flattenExtractionTree($clean);
-  const root = $clean.root()[0];
+  flattenExtractionTree($);
+  deduplicateImagesInDom($);
+  return $;
+}
+function serializePreparedExtractionSnapshot($) {
+  const root = $.root()[0];
   if (root === void 0) {
     return "";
   }
-  return deduplicateImages(serializeForExtraction($clean, root));
+  return serializeForExtraction($, root);
 }
-function cleanForAction(html) {
+function prepareActionSnapshotDom(html) {
   if (!html.trim()) {
-    return "";
+    return void 0;
   }
   const $ = cheerio.load(html, { xmlMode: false });
   removeNoise($);
@@ -12333,13 +12266,12 @@ function cleanForAction(html) {
   pruneSelfHiddenNodes($);
   const clickableMark = "data-clickable-marker";
   const indicatorMark = "data-keep-indicator";
-  const branchMark = "data-keep-branch";
   const context = {
     hasPreMarked: $(`[${OPENSTEER_INTERACTIVE_ATTR}]`).length > 0
   };
   $("*").each(function markClickables() {
     const el = $(this);
-    if (isClickable($, el, context)) {
+    if (isClickable(el, context)) {
       el.attr(clickableMark, "1");
     }
   });
@@ -12369,25 +12301,7 @@ function cleanForAction(html) {
       el.remove();
     }
   });
-  $(`[${clickableMark}], [${indicatorMark}]`).each(function markBranches() {
-    let current = $(this).parent();
-    while (current.length > 0) {
-      const node = current[0];
-      if (!node || node.type !== "tag") {
-        break;
-      }
-      const ancestor = current;
-      const tag = (node.tagName || "").toLowerCase();
-      if (ROOT_TAGS.has(tag) || ancestor.attr(clickableMark) !== void 0) {
-        break;
-      }
-      if (!isBoundaryTag(tag)) {
-        ancestor.attr(branchMark, "1");
-      }
-      current = ancestor.parent();
-    }
-  });
-  for (const node of getElementsByDepthDescending($)) {
+  for (const node of getElementsInReverseDocumentOrder($)) {
     const el = $(node);
     const tag = (node.tagName || "").toLowerCase();
     if (ROOT_TAGS.has(tag) || isBoundaryTag(tag)) {
@@ -12396,17 +12310,7 @@ function cleanForAction(html) {
     if (el.attr(clickableMark) !== void 0 || el.attr(indicatorMark) !== void 0) {
       continue;
     }
-    const insideClickable = hasMarkedAncestor(el, clickableMark);
-    const preserveBranch = el.attr(branchMark) !== void 0;
     const hasContent = hasElementChildren(node) || hasDirectText(node);
-    if (insideClickable || preserveBranch) {
-      if (!hasContent) {
-        el.remove();
-      } else {
-        unwrapActionNode($, el);
-      }
-      continue;
-    }
     if (!hasContent) {
       el.remove();
       continue;
@@ -12507,13 +12411,20 @@ function cleanForAction(html) {
     }
     el.removeAttr(clickableMark);
     el.removeAttr(indicatorMark);
-    el.removeAttr(branchMark);
     el.removeAttr(OPENSTEER_INTERACTIVE_ATTR);
     el.removeAttr(OPENSTEER_HIDDEN_ATTR);
     el.removeAttr(OPENSTEER_SCROLLABLE_ATTR);
     el.removeAttr(OPENSTEER_SELF_HIDDEN_ATTR);
   });
-  return compactHtml(deduplicateImages($.html()));
+  deduplicateImagesInDom($);
+  return $;
+}
+function serializePreparedActionSnapshot($) {
+  const normalized = compactHtml($.html());
+  if (normalized.length === 0) {
+    return "";
+  }
+  return cheerio.load(normalized, { xmlMode: false }).html();
 }
 var VOID_TAGS2 = /* @__PURE__ */ new Set([
   "area",
@@ -12736,27 +12647,32 @@ async function markLiveSnapshotSemantics(options) {
   const frames = await options.engine.listFrames({
     pageRef: options.pageRef
   });
-  for (const frame of frames) {
-    await evaluateFrameBestEffort(
-      options.engine,
-      frame.frameRef,
-      MARK_SNAPSHOT_SEMANTICS_SCRIPT,
-      SNAPSHOT_SEMANTIC_ARGS
-    );
-  }
-  return async () => {
-    for (const frame of frames) {
-      await evaluateFrameBestEffort(
+  await Promise.all(
+    frames.map(
+      (frame) => evaluateFrameBestEffort(
         options.engine,
         frame.frameRef,
-        CLEAR_SNAPSHOT_SEMANTICS_SCRIPT,
-        CLEAR_SNAPSHOT_SEMANTIC_ARGS
-      );
-    }
+        MARK_SNAPSHOT_SEMANTICS_SCRIPT,
+        SNAPSHOT_SEMANTIC_ARGS
+      )
+    )
+  );
+  return async () => {
+    await Promise.all(
+      frames.map(
+        (frame) => evaluateFrameBestEffort(
+          options.engine,
+          frame.frameRef,
+          CLEAR_SNAPSHOT_SEMANTICS_SCRIPT,
+          CLEAR_SNAPSHOT_SEMANTIC_ARGS
+        )
+      )
+    );
   };
 }
 
 // ../runtime-core/src/sdk/snapshot/compiler.ts
+var EXTRACTION_SKIPPED_COUNTER_TAGS = /* @__PURE__ */ new Set(["html", "head", "body"]);
 var INTERNAL_SNAPSHOT_ATTRIBUTE_NAMES = /* @__PURE__ */ new Set([
   "c",
   OPENSTEER_BOUNDARY_ATTR,
@@ -12771,7 +12687,7 @@ var INTERNAL_SNAPSHOT_ATTRIBUTE_NAMES = /* @__PURE__ */ new Set([
 var MAX_LIVE_COUNTER_SYNC_ATTEMPTS = 4;
 var CLEAR_LIVE_COUNTERS_SCRIPT = `(({ sparseCounterAttr }) => {
   const walk = (root) => {
-    for (const child of root.children) {
+    for (const child of Array.from(root?.children || [])) {
       child.removeAttribute("c");
       child.removeAttribute(sparseCounterAttr);
       walk(child);
@@ -12787,7 +12703,7 @@ var CLEAR_LIVE_COUNTERS_SCRIPT = `(({ sparseCounterAttr }) => {
 var ASSIGN_SPARSE_COUNTERS_SCRIPT = `(({ sparseCounterAttr, startCounter }) => {
   let counter = startCounter;
   const walk = (root) => {
-    for (const child of root.children) {
+    for (const child of Array.from(root?.children || [])) {
       child.setAttribute(sparseCounterAttr, String(counter++));
       walk(child);
       if (child.shadowRoot) {
@@ -12801,7 +12717,7 @@ var ASSIGN_SPARSE_COUNTERS_SCRIPT = `(({ sparseCounterAttr, startCounter }) => {
 })`;
 var APPLY_DENSE_COUNTERS_SCRIPT = `(({ sparseCounterAttr, mapping }) => {
   const walk = (root) => {
-    for (const child of root.children) {
+    for (const child of Array.from(root?.children || [])) {
       child.removeAttribute("c");
       const sparse = child.getAttribute(sparseCounterAttr);
       if (sparse !== null) {
@@ -12864,20 +12780,22 @@ function ensureSparseCountersForAllRecords(counterRecords) {
 async function clearOpensteerLiveCounters(engine, pageRef) {
   const frames = await engine.listFrames({ pageRef });
   const failures = [];
-  for (const frame of frames) {
-    try {
-      await engine.evaluateFrame({
-        frameRef: frame.frameRef,
-        script: CLEAR_LIVE_COUNTERS_SCRIPT,
-        args: [{ sparseCounterAttr: OPENSTEER_SPARSE_COUNTER_ATTR }]
-      });
-    } catch (error) {
-      if (isDetachedFrameSyncError(error)) {
-        continue;
+  await Promise.all(
+    frames.map(async (frame) => {
+      try {
+        await engine.evaluateFrame({
+          frameRef: frame.frameRef,
+          script: CLEAR_LIVE_COUNTERS_SCRIPT,
+          args: [{ sparseCounterAttr: OPENSTEER_SPARSE_COUNTER_ATTR }]
+        });
+      } catch (error) {
+        if (isDetachedFrameSyncError(error)) {
+          return;
+        }
+        failures.push(`frame ${frame.frameRef} could not be cleared (${describeError(error)}).`);
       }
-      failures.push(`frame ${frame.frameRef} could not be cleared (${describeError(error)}).`);
-    }
-  }
+    })
+  );
   if (failures.length > 0) {
     throw buildLiveCounterSyncError("clear live counters", failures);
   }
@@ -12926,25 +12844,29 @@ async function syncDenseCountersToLiveDom(engine, pageRef, sparseToDirectMapping
       denseCounter
     ])
   );
-  for (const frame of frames) {
-    try {
-      await engine.evaluateFrame({
-        frameRef: frame.frameRef,
-        script: APPLY_DENSE_COUNTERS_SCRIPT,
-        args: [
-          {
-            sparseCounterAttr: OPENSTEER_SPARSE_COUNTER_ATTR,
-            mapping: mappingObj
-          }
-        ]
-      });
-    } catch (error) {
-      if (isDetachedFrameSyncError(error)) {
-        continue;
+  await Promise.all(
+    frames.map(async (frame) => {
+      try {
+        await engine.evaluateFrame({
+          frameRef: frame.frameRef,
+          script: APPLY_DENSE_COUNTERS_SCRIPT,
+          args: [
+            {
+              sparseCounterAttr: OPENSTEER_SPARSE_COUNTER_ATTR,
+              mapping: mappingObj
+            }
+          ]
+        });
+      } catch (error) {
+        if (isDetachedFrameSyncError(error)) {
+          return;
+        }
+        failures.push(
+          `frame ${frame.frameRef} could not be synchronized (${describeError(error)}).`
+        );
       }
-      failures.push(`frame ${frame.frameRef} could not be synchronized (${describeError(error)}).`);
-    }
-  }
+    })
+  );
   if (failures.length > 0) {
     throw buildLiveCounterSyncError("synchronize dense counters", failures);
   }
@@ -12962,26 +12884,26 @@ async function compileOpensteerSnapshot(options) {
       await clearOpensteerLiveCounters(options.engine, options.pageRef);
       await assignSparseCountersToLiveDom(options.engine, options.pageRef);
       const pageInfo = await options.engine.getPageInfo({ pageRef: options.pageRef });
-      const mainSnapshot = await getMainDocumentSnapshot(options.engine, options.pageRef);
-      const snapshotsByDocumentRef = await collectDocumentSnapshots(options.engine, mainSnapshot);
+      const { mainSnapshot, snapshotsByDocumentRef } = await getPageDocumentSnapshots(
+        options.engine,
+        options.pageRef
+      );
       await cleanupLiveSemantics();
       cleanupLiveSemantics = async () => {
       };
-      const snapshotIndices = /* @__PURE__ */ new Map();
       const renderedNodes = /* @__PURE__ */ new Map();
       const rawHtml = renderDocumentSnapshot(
         mainSnapshot.documentRef,
         snapshotsByDocumentRef,
-        snapshotIndices,
         renderedNodes,
         {
           iframeDepth: 0,
           shadowDepth: 0
         }
       );
-      const cleanedHtml = options.mode === "extraction" ? cleanForExtraction(rawHtml) : cleanForAction(rawHtml);
-      const compiledHtml = assignCounters(cleanedHtml, renderedNodes);
-      const finalHtml = options.mode === "extraction" ? unwrapExtractionHtml(compiledHtml.html) : compiledHtml.html;
+      const preparedSnapshotDom = options.mode === "extraction" ? prepareExtractionSnapshotDom(rawHtml) : prepareActionSnapshotDom(rawHtml);
+      const compiledHtml = assignCountersInDom(preparedSnapshotDom, renderedNodes, options.mode);
+      const finalHtml = preparedSnapshotDom === void 0 ? "" : options.mode === "extraction" ? serializePreparedExtractionSnapshot(preparedSnapshotDom) : serializePreparedActionSnapshot(preparedSnapshotDom);
       ensureSparseCountersForAllRecords(compiledHtml.counterRecords);
       await syncDenseCountersToLiveDom(
         options.engine,
@@ -13016,6 +12938,25 @@ async function getMainDocumentSnapshot(engine, pageRef) {
   }
   return engine.getDomSnapshot({ frameRef: mainFrame.frameRef });
 }
+async function getPageDocumentSnapshots(engine, pageRef) {
+  const bundleEngine = engine;
+  const bundledSnapshots = await bundleEngine.getPageDomSnapshots?.({ pageRef });
+  if (bundledSnapshots && bundledSnapshots.length > 0) {
+    const mainSnapshot2 = bundledSnapshots.find((snapshot) => snapshot.parentDocumentRef === void 0) ?? bundledSnapshots[0];
+    return {
+      mainSnapshot: mainSnapshot2,
+      snapshotsByDocumentRef: new Map(
+        bundledSnapshots.map((snapshot) => [snapshot.documentRef, snapshot])
+      )
+    };
+  }
+  const mainSnapshot = await getMainDocumentSnapshot(engine, pageRef);
+  const snapshotsByDocumentRef = await collectDocumentSnapshots(engine, mainSnapshot);
+  return {
+    mainSnapshot,
+    snapshotsByDocumentRef
+  };
+}
 async function collectDocumentSnapshots(engine, mainSnapshot) {
   const snapshotsByDocumentRef = /* @__PURE__ */ new Map([
     [mainSnapshot.documentRef, mainSnapshot]
@@ -13034,7 +12975,7 @@ async function collectDocumentSnapshots(engine, mainSnapshot) {
   }
   return snapshotsByDocumentRef;
 }
-function renderDocumentSnapshot(documentRef, snapshotsByDocumentRef, snapshotIndices, renderedNodes, depth) {
+function renderDocumentSnapshot(documentRef, snapshotsByDocumentRef, renderedNodes, depth) {
   const snapshot = snapshotsByDocumentRef.get(documentRef);
   if (!snapshot) {
     return "";
@@ -13046,17 +12987,9 @@ function renderDocumentSnapshot(documentRef, snapshotsByDocumentRef, snapshotInd
       `snapshot ${snapshot.documentRef} is missing root node ${String(snapshot.rootSnapshotNodeId)}`
     );
   }
-  return renderNode(
-    snapshot,
-    rootNode,
-    nodesById,
-    snapshotsByDocumentRef,
-    snapshotIndices,
-    renderedNodes,
-    depth
-  );
+  return renderNode(snapshot, rootNode, nodesById, snapshotsByDocumentRef, renderedNodes, depth);
 }
-function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotIndices, renderedNodes, depth) {
+function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, renderedNodes, depth) {
   if (node.nodeType === 3) {
     return escapeHtml(node.nodeValue || node.textContent || "");
   }
@@ -13064,56 +12997,26 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
     return "";
   }
   if (node.nodeType === 9 || node.nodeType === 11) {
-    return renderChildren(
-      snapshot,
-      node,
-      nodesById,
-      snapshotsByDocumentRef,
-      snapshotIndices,
-      renderedNodes,
-      depth
-    );
+    return renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, renderedNodes, depth);
   }
   if (node.nodeType !== 1) {
-    return renderChildren(
-      snapshot,
-      node,
-      nodesById,
-      snapshotsByDocumentRef,
-      snapshotIndices,
-      renderedNodes,
-      depth
-    );
+    return renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, renderedNodes, depth);
   }
   const tagName = normalizeTagName(node.nodeName);
   if (isPseudoElementTagName(tagName)) {
-    return renderChildren(
-      snapshot,
-      node,
-      nodesById,
-      snapshotsByDocumentRef,
-      snapshotIndices,
-      renderedNodes,
-      depth
-    );
+    return renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, renderedNodes, depth);
   }
   if ((depth.iframeDepth > 0 || depth.shadowDepth > 0) && (tagName === "html" || tagName === "head" || tagName === "body")) {
-    return renderChildren(
-      snapshot,
-      node,
-      nodesById,
-      snapshotsByDocumentRef,
-      snapshotIndices,
-      renderedNodes,
-      depth
-    );
+    return renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, renderedNodes, depth);
   }
   const snapshotAttributes = normalizeNodeAttributes(node.attributes);
+  const snapshotAttributeIndex = indexNodeAttributes(snapshotAttributes);
   const authoredAttributes = stripInternalSnapshotAttributes(snapshotAttributes);
+  const authoredAttributeIndex = indexNodeAttributes(authoredAttributes);
   const attributes = [...authoredAttributes];
-  const subtreeHidden = hasAttribute3(snapshotAttributes, OPENSTEER_HIDDEN_ATTR) || isLikelySubtreeHidden(node);
-  const selfHidden = !subtreeHidden && (hasAttribute3(snapshotAttributes, OPENSTEER_SELF_HIDDEN_ATTR) || isLikelySelfHidden(node, nodesById));
-  const interactive = !subtreeHidden && !selfHidden && (hasAttribute3(snapshotAttributes, OPENSTEER_INTERACTIVE_ATTR) || isLikelyInteractive(tagName, node, authoredAttributes));
+  const subtreeHidden = snapshotAttributeIndex.has(OPENSTEER_HIDDEN_ATTR) || isLikelySubtreeHidden(node);
+  const selfHidden = !subtreeHidden && (snapshotAttributeIndex.has(OPENSTEER_SELF_HIDDEN_ATTR) || isLikelySelfHidden(node, nodesById));
+  const interactive = !subtreeHidden && !selfHidden && (snapshotAttributeIndex.has(OPENSTEER_INTERACTIVE_ATTR) || isLikelyInteractive(tagName, node, authoredAttributes, authoredAttributeIndex));
   if (interactive) {
     attributes.push({ name: OPENSTEER_INTERACTIVE_ATTR, value: "1" });
   }
@@ -13122,7 +13025,7 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
   } else if (selfHidden) {
     attributes.push({ name: OPENSTEER_SELF_HIDDEN_ATTR, value: "1" });
   }
-  const sparseCounter = findAttributeValue(snapshotAttributes, OPENSTEER_SPARSE_COUNTER_ATTR);
+  const sparseCounter = snapshotAttributeIndex.get(OPENSTEER_SPARSE_COUNTER_ATTR);
   if (sparseCounter !== void 0) {
     attributes.push({ name: OPENSTEER_SPARSE_COUNTER_ATTR, value: sparseCounter });
   }
@@ -13133,21 +13036,18 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
     const syntheticNodeId = buildSyntheticNodeId(snapshot, node);
     attributes.push({ name: OPENSTEER_NODE_ID_ATTR, value: syntheticNodeId });
     renderedNodes.set(syntheticNodeId, {
-      locator: createNodeLocator(snapshot.documentRef, snapshot.documentEpoch, node.nodeRef),
-      anchor: buildSnapshotElementAnchor(snapshot, node, snapshotsByDocumentRef, snapshotIndices),
       pageRef: snapshot.pageRef,
       frameRef: snapshot.frameRef,
       documentRef: snapshot.documentRef,
       documentEpoch: snapshot.documentEpoch,
       nodeRef: node.nodeRef,
       tagName: tagName.toUpperCase(),
-      pathHint: buildPathHint(tagName, authoredAttributes),
-      ...buildTextSnippet(node.textContent) === void 0 ? {} : { text: buildTextSnippet(node.textContent) },
       ...authoredAttributes.length === 0 ? {} : { attributes: authoredAttributes },
       iframeDepth: depth.iframeDepth,
       shadowDepth: depth.shadowDepth,
       interactive,
-      liveCounterSyncEligible: isLiveCounterSyncEligible(node, nodesById)
+      liveCounterSyncEligible: isLiveCounterSyncEligible(node, nodesById),
+      ...node.textContent === void 0 ? {} : { textContent: node.textContent }
     });
   }
   const attributeText = attributesToHtml(attributes);
@@ -13156,7 +13056,6 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
     node,
     nodesById,
     snapshotsByDocumentRef,
-    snapshotIndices,
     renderedNodes,
     depth
   );
@@ -13167,7 +13066,6 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
   const iframeHtml = renderDocumentSnapshot(
     node.contentDocumentRef,
     snapshotsByDocumentRef,
-    snapshotIndices,
     renderedNodes,
     {
       iframeDepth: depth.iframeDepth + 1,
@@ -13179,7 +13077,7 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
   }
   return `${elementHtml}<${OPENSTEER_IFRAME_BOUNDARY_TAG} ${OPENSTEER_BOUNDARY_ATTR}="iframe">${iframeHtml}</${OPENSTEER_IFRAME_BOUNDARY_TAG}>`;
 }
-function renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotIndices, renderedNodes, depth) {
+function renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, renderedNodes, depth) {
   const regularChildren = [];
   const shadowChildren = [];
   for (const childSnapshotNodeId of node.childSnapshotNodeIds) {
@@ -13196,18 +13094,10 @@ function renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, snaps
   const chunks = [];
   if (shadowChildren.length > 0) {
     const shadowHtml = shadowChildren.map(
-      (child) => renderNode(
-        snapshot,
-        child,
-        nodesById,
-        snapshotsByDocumentRef,
-        snapshotIndices,
-        renderedNodes,
-        {
-          iframeDepth: depth.iframeDepth,
-          shadowDepth: depth.shadowDepth + 1
-        }
-      )
+      (child) => renderNode(snapshot, child, nodesById, snapshotsByDocumentRef, renderedNodes, {
+        iframeDepth: depth.iframeDepth,
+        shadowDepth: depth.shadowDepth + 1
+      })
     ).join("");
     chunks.push(
       `<${OPENSTEER_SHADOW_BOUNDARY_TAG} ${OPENSTEER_BOUNDARY_ATTR}="shadow">${shadowHtml}</${OPENSTEER_SHADOW_BOUNDARY_TAG}>`
@@ -13215,24 +13105,21 @@ function renderChildren(snapshot, node, nodesById, snapshotsByDocumentRef, snaps
   }
   for (const child of regularChildren) {
     chunks.push(
-      renderNode(
-        snapshot,
-        child,
-        nodesById,
-        snapshotsByDocumentRef,
-        snapshotIndices,
-        renderedNodes,
-        depth
-      )
+      renderNode(snapshot, child, nodesById, snapshotsByDocumentRef, renderedNodes, depth)
     );
   }
   return chunks.join("");
 }
-function assignCounters(cleanedHtml, renderedNodes) {
-  const $ = cheerio.load(cleanedHtml, { xmlMode: false });
+function assignCountersInDom($, renderedNodes, mode) {
   const counterRecords = /* @__PURE__ */ new Map();
   const sparseToDirectMapping = /* @__PURE__ */ new Map();
   let nextCounter = 1;
+  if (!$) {
+    return {
+      counterRecords,
+      sparseToDirectMapping
+    };
+  }
   $("*").each(function assignElementCounter() {
     const el = $(this);
     const syntheticNodeId = el.attr(OPENSTEER_NODE_ID_ATTR);
@@ -13244,14 +13131,24 @@ function assignCounters(cleanedHtml, renderedNodes) {
     if (!rendered) {
       return;
     }
+    if (mode === "extraction" && EXTRACTION_SKIPPED_COUNTER_TAGS.has(rendered.tagName.toLowerCase())) {
+      el.removeAttr(OPENSTEER_SPARSE_COUNTER_ATTR);
+      return;
+    }
     const rawSparseCounter = el.attr(OPENSTEER_SPARSE_COUNTER_ATTR);
     el.removeAttr(OPENSTEER_SPARSE_COUNTER_ATTR);
     const sparseCounter = rawSparseCounter ? Number.parseInt(rawSparseCounter, 10) : void 0;
+    const replayableSparseCounter = typeof sparseCounter === "number" && Number.isFinite(sparseCounter) ? sparseCounter : void 0;
+    if (rendered.liveCounterSyncEligible && replayableSparseCounter === void 0) {
+      return;
+    }
     const counter = nextCounter++;
     el.attr("c", String(counter));
-    if (sparseCounter !== void 0 && Number.isFinite(sparseCounter)) {
-      sparseToDirectMapping.set(sparseCounter, counter);
+    if (replayableSparseCounter !== void 0) {
+      sparseToDirectMapping.set(replayableSparseCounter, counter);
     }
+    const pathHint = buildPathHint(rendered.tagName.toLowerCase(), rendered.attributes ?? []);
+    const text = buildTextSnippet(rendered.textContent);
     counterRecords.set(counter, {
       element: counter,
       pageRef: rendered.pageRef,
@@ -13260,20 +13157,17 @@ function assignCounters(cleanedHtml, renderedNodes) {
       documentEpoch: rendered.documentEpoch,
       nodeRef: rendered.nodeRef,
       tagName: rendered.tagName,
-      pathHint: rendered.pathHint,
-      ...rendered.text === void 0 ? {} : { text: rendered.text },
+      pathHint,
+      ...text === void 0 ? {} : { text },
       ...rendered.attributes === void 0 ? {} : { attributes: rendered.attributes },
       iframeDepth: rendered.iframeDepth,
       shadowDepth: rendered.shadowDepth,
       interactive: rendered.interactive,
       liveCounterSyncEligible: rendered.liveCounterSyncEligible,
-      locator: rendered.locator,
-      anchor: rendered.anchor,
-      ...sparseCounter !== void 0 && Number.isFinite(sparseCounter) ? { sparseCounter } : {}
+      ...replayableSparseCounter === void 0 ? {} : { sparseCounter: replayableSparseCounter }
     });
   });
   return {
-    html: $.html(),
     counterRecords,
     sparseToDirectMapping
   };
@@ -13347,28 +13241,28 @@ function isLikelySelfHidden(node, nodesById) {
   }
   return !hasVisibleOutOfFlowChild(node, nodesById);
 }
-function isLikelyInteractive(tagName, node, attributes) {
+function isLikelyInteractive(tagName, node, attributes, attributeIndex) {
   if (NATIVE_INTERACTIVE_TAGS.has(tagName)) {
-    if (tagName === "input" && findAttributeValue(attributes, "type")?.toLowerCase() === "hidden") {
+    if (tagName === "input" && attributeIndex.get("type")?.toLowerCase() === "hidden") {
       return false;
     }
     if (tagName !== "a") {
       return true;
     }
   }
-  if (tagName === "a" && findAttributeValue(attributes, "href") !== void 0) {
+  if (tagName === "a" && attributeIndex.has("href")) {
     return true;
   }
-  if (findAttributeValue(attributes, "onclick") !== void 0 || findAttributeValue(attributes, "onmousedown") !== void 0 || findAttributeValue(attributes, "onmouseup") !== void 0 || findAttributeValue(attributes, "data-action") !== void 0 || findAttributeValue(attributes, "data-click") !== void 0 || findAttributeValue(attributes, "data-toggle") !== void 0) {
+  if (attributeIndex.has("onclick") || attributeIndex.has("onmousedown") || attributeIndex.has("onmouseup") || attributeIndex.has("data-action") || attributeIndex.has("data-click") || attributeIndex.has("data-toggle")) {
     return true;
   }
-  if (hasNonNegativeTabIndex(findAttributeValue(attributes, "tabindex"))) {
+  if (hasNonNegativeTabIndex(attributeIndex.get("tabindex"))) {
     return true;
   }
-  if (findAttributeValue(attributes, "contenteditable")?.toLowerCase() === "true") {
+  if (attributeIndex.get("contenteditable")?.toLowerCase() === "true") {
     return true;
   }
-  const role = findAttributeValue(attributes, "role")?.toLowerCase();
+  const role = attributeIndex.get("role")?.toLowerCase();
   return role !== void 0 && INTERACTIVE_ROLE_SET.has(role);
 }
 function hasVisibleOutOfFlowChild(node, nodesById) {
@@ -13431,14 +13325,6 @@ function parseOpacity(value) {
   const parsed = Number.parseFloat(value);
   return Number.isFinite(parsed) ? parsed : Number.NaN;
 }
-function hasAttribute3(attributes, name) {
-  const normalizedName = name.toLowerCase();
-  return attributes.some((attribute) => attribute.name.toLowerCase() === normalizedName);
-}
-function unwrapExtractionHtml(html) {
-  const $ = cheerio.load(html, { xmlMode: false });
-  return $("body").html()?.trim() || html;
-}
 function buildSyntheticNodeId(snapshot, node) {
   return `${snapshot.documentRef}:${String(snapshot.documentEpoch)}:${String(node.snapshotNodeId)}`;
 }
@@ -13485,6 +13371,13 @@ function findAttributeValue(attributes, name) {
   const normalizedName = name.toLowerCase();
   return attributes.find((attribute) => attribute.name.toLowerCase() === normalizedName)?.value;
 }
+function indexNodeAttributes(attributes) {
+  const indexed = /* @__PURE__ */ new Map();
+  for (const attribute of attributes) {
+    indexed.set(attribute.name.toLowerCase(), attribute.value);
+  }
+  return indexed;
+}
 function attributesToHtml(attributes) {
   if (attributes.length === 0) {
     return "";
@@ -13494,56 +13387,6 @@ function attributesToHtml(attributes) {
 function escapeAttribute(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function buildSnapshotElementAnchor(snapshot, node, snapshotsByDocumentRef, snapshotIndices) {
-  const index = getSnapshotIndex(snapshot.documentRef, snapshotsByDocumentRef, snapshotIndices);
-  const localAnchor = buildLocalStructuralElementAnchor(index, node);
-  return prefixIframeContext(snapshot, localAnchor, snapshotsByDocumentRef, snapshotIndices);
-}
-function prefixIframeContext(snapshot, localPath, snapshotsByDocumentRef, snapshotIndices) {
-  if (snapshot.parentDocumentRef === void 0) {
-    return sanitizeStructuralElementAnchor(localPath);
-  }
-  const parentSnapshot = snapshotsByDocumentRef.get(snapshot.parentDocumentRef);
-  if (!parentSnapshot) {
-    throw new Error(
-      `document ${snapshot.documentRef} has parent ${snapshot.parentDocumentRef} but no parent snapshot`
-    );
-  }
-  const parentIndex = getSnapshotIndex(
-    parentSnapshot.documentRef,
-    snapshotsByDocumentRef,
-    snapshotIndices
-  );
-  const iframeHost = findIframeHostNode(parentIndex, snapshot.documentRef);
-  if (!iframeHost) {
-    throw new Error(
-      `document ${snapshot.documentRef} has parent ${snapshot.parentDocumentRef} but no iframe host`
-    );
-  }
-  const hostPath = buildSnapshotElementAnchor(
-    parentSnapshot,
-    iframeHost,
-    snapshotsByDocumentRef,
-    snapshotIndices
-  );
-  return sanitizeStructuralElementAnchor({
-    context: [...hostPath.context, { kind: "iframe", host: hostPath.nodes }, ...localPath.context],
-    nodes: localPath.nodes
-  });
-}
-function getSnapshotIndex(documentRef, snapshotsByDocumentRef, snapshotIndices) {
-  const existing = snapshotIndices.get(documentRef);
-  if (existing) {
-    return existing;
-  }
-  const snapshot = snapshotsByDocumentRef.get(documentRef);
-  if (!snapshot) {
-    throw new Error(`missing DOM snapshot for ${documentRef}`);
-  }
-  const index = createSnapshotIndex(snapshot);
-  snapshotIndices.set(documentRef, index);
-  return index;
-}
 function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
@@ -14676,7 +14519,10 @@ var OpensteerSessionRuntime = class {
   sessionRef;
   pageRef;
   runId;
-  observations;
+  observationSessions = /* @__PURE__ */ new Map();
+  openingObservationSessions = /* @__PURE__ */ new Map();
+  openedObservationSessions = /* @__PURE__ */ new Set();
+  observationSessionStorage = new AsyncLocalStorage();
   operationEventStorage = new AsyncLocalStorage();
   pendingOperationEventCaptures = [];
   ownsEngine = false;
@@ -14728,18 +14574,26 @@ var OpensteerSessionRuntime = class {
   }
   async setObservabilityConfig(input) {
     this.observationConfig = normalizeObservabilityConfig(input);
-    const observationSessionId = this.resolveObservationSessionId();
-    if (observationSessionId === void 0) {
-      return this.observationConfig;
-    }
-    const sink = this.injectedObservationSink ?? (await this.ensureRoot()).observations;
-    this.observations = await sink.openSession({
-      sessionId: observationSessionId,
-      openedAt: Date.now(),
-      config: this.observationConfig
-    });
+    await this.ensureConfiguredObservationSession();
     return this.observationConfig;
   }
+  async withObservationSessionId(sessionId, task) {
+    return await this.observationSessionStorage.run(
+      {
+        mode: "session",
+        sessionId: normalizeNonEmptyString("sessionId", sessionId)
+      },
+      task
+    );
+  }
+  async withoutObservationSession(task) {
+    return await this.observationSessionStorage.run(
+      {
+        mode: "disabled"
+      },
+      task
+    );
+  }
   async open(input = {}, options = {}) {
     assertValidSemanticOperationInput("session.open", input);
     if (input.workspace !== void 0 && normalizeNamespace2(input.workspace) !== this.workspace) {
@@ -14756,7 +14610,7 @@ var OpensteerSessionRuntime = class {
           options
         );
       }
-      return this.readSessionState();
+      return this.readNavigationSummary();
     }
     const startedAt = Date.now();
     const root = await this.ensureRoot();
@@ -14777,7 +14631,8 @@ var OpensteerSessionRuntime = class {
           openedSessionRef = sessionRef;
           const createdPage = await timeout.runStep(
             () => engine.createPage({
-              sessionRef
+              sessionRef,
+              ...input.url === void 0 ? {} : { url: input.url }
             })
           );
           openedPageRef = createdPage.data.pageRef;
@@ -14787,18 +14642,19 @@ var OpensteerSessionRuntime = class {
           await timeout.runStep(() => this.ensureSemantics());
           let frameRef2 = createdPage.frameRef;
           if (input.url !== void 0) {
-            const navigation = await this.navigatePage(
-              {
+            await timeout.runStep(
+              () => settleWithPolicy(this.policy.settle, {
                 operation: "session.open",
+                trigger: "navigation",
+                engine: this.requireEngine(),
                 pageRef: createdPage.data.pageRef,
-                url: input.url
-              },
-              timeout
+                signal: timeout.signal,
+                remainingMs: timeout.remainingMs()
+              })
             );
-            frameRef2 = navigation.data.mainFrame.frameRef;
           }
           return {
-            state: await timeout.runStep(() => this.readSessionState()),
+            state: await timeout.runStep(() => this.readNavigationSummary()),
             frameRef: frameRef2
           };
         },
@@ -14891,7 +14747,11 @@ var OpensteerSessionRuntime = class {
           "page.new cannot use openerPageRef before a session exists"
         );
       }
-      return this.open(input.url === void 0 ? {} : { url: input.url }, options);
+      const summary = await this.open(input.url === void 0 ? {} : { url: input.url }, options);
+      return {
+        pageRef: await this.ensurePageRef(),
+        ...summary
+      };
     }
     const startedAt = Date.now();
     try {
@@ -14906,7 +14766,7 @@ var OpensteerSessionRuntime = class {
             })
           );
           this.pageRef = created.data.pageRef;
-          return this.readSessionState();
+          return this.readCreatedPageOutput(created.data.pageRef);
         },
         options
       );
@@ -14948,7 +14808,7 @@ var OpensteerSessionRuntime = class {
             () => this.requireEngine().activatePage({ pageRef: input.pageRef })
           );
           this.pageRef = input.pageRef;
-          return this.readSessionState();
+          return this.readNavigationSummary(input.pageRef);
         },
         options
       );
@@ -15074,7 +14934,7 @@ var OpensteerSessionRuntime = class {
           timeout.throwIfAborted();
           return {
             navigation: navigation2,
-            state: await timeout.runStep(() => this.readSessionState())
+            state: await timeout.runStep(() => this.readNavigationSummary(pageRef))
           };
         },
         (diagnostics) => {
@@ -16308,7 +16168,7 @@ var OpensteerSessionRuntime = class {
     let mutationCaptureDiagnostics;
     let boundaryDiagnostics;
     try {
-      const { artifacts, output } = await this.runMutationCapturedOperation(
+      const { artifacts, output, result } = await this.runMutationCapturedOperation(
         "computer.execute",
         {
           ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
@@ -16326,9 +16186,14 @@ var OpensteerSessionRuntime = class {
             await this.invalidateLiveSnapshotCounters([pageRef, output2.pageRef], timeout);
             this.pageRef = output2.pageRef;
             const artifacts2 = await this.persistComputerArtifacts(output2, timeout);
+            const result2 = {
+              ...await timeout.runStep(() => this.readNavigationSummary(output2.pageRef)),
+              screenshot: artifacts2.screenshot
+            };
             return {
               artifacts: { manifests: artifacts2.manifests },
-              output: artifacts2.output
+              output: output2,
+              result: result2
             };
           } catch (error) {
             boundaryDiagnostics ??= takeActionBoundaryDiagnostics(timeout.signal);
@@ -16365,7 +16230,7 @@ var OpensteerSessionRuntime = class {
           documentEpoch: output.screenshot.documentEpoch
         })
       });
-      return output;
+      return result;
     } catch (error) {
       await this.appendTrace({
         operation: "computer.execute",
@@ -16513,8 +16378,9 @@ var OpensteerSessionRuntime = class {
           mutationCaptureDiagnostics = diagnostics;
         }
       );
-      const output = toOpensteerActionResult(executed.result);
+      const output = toOpensteerActionResult(executed.result.resolved);
       const actionEvents = "events" in executed.result ? executed.result.events : void 0;
+      const resolvedTarget = toOpensteerResolvedTarget2(executed.result.resolved);
       await this.appendTrace({
         operation,
         startedAt,
@@ -16522,8 +16388,13 @@ var OpensteerSessionRuntime = class {
         outcome: "ok",
         ...actionEvents === void 0 ? {} : { events: actionEvents },
         data: {
-          target: output.target,
-          ...output.point === void 0 ? {} : { point: output.point },
+          target: resolvedTarget,
+          ..."point" in executed.result && executed.result.point !== void 0 ? {
+            point: {
+              x: executed.result.point.x,
+              y: executed.result.point.y
+            }
+          } : {},
           ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
           ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
@@ -17988,20 +17859,20 @@ var OpensteerSessionRuntime = class {
       throw error;
     }
   }
-  async readSessionState() {
-    const pageRef = await this.ensurePageRef();
+  async readNavigationSummary(targetPageRef) {
+    const pageRef = targetPageRef ?? await this.ensurePageRef();
     const pageInfo = await this.requireEngine().getPageInfo({ pageRef });
-    const sessionRef = this.sessionRef;
-    if (!sessionRef) {
-      throw new Error("Opensteer session is not initialized");
-    }
     return {
-      sessionRef,
-      pageRef,
       url: pageInfo.url,
       title: pageInfo.title
     };
   }
+  async readCreatedPageOutput(pageRef) {
+    return {
+      pageRef,
+      ...await this.readNavigationSummary(pageRef)
+    };
+  }
   async captureSnapshotArtifacts(pageRef, options, timeout) {
     const root = this.requireRoot();
     const mainFrame = await timeout.runStep(() => getMainFrame(this.requireEngine(), pageRef));
@@ -18073,12 +17944,12 @@ var OpensteerSessionRuntime = class {
     const screenshotPayload = manifestToExternalBinaryLocation(root.rootPath, screenshotManifest);
     return {
       manifests,
-      output: {
-        ...output,
-        screenshot: {
-          ...output.screenshot,
-          payload: screenshotPayload
-        }
+      screenshot: {
+        payload: screenshotPayload,
+        format: output.screenshot.format,
+        size: output.screenshot.size,
+        coordinateSpace: output.screenshot.coordinateSpace,
+        ...output.screenshot.clip === void 0 ? {} : { clip: output.screenshot.clip }
       }
     };
   }
@@ -18166,7 +18037,7 @@ var OpensteerSessionRuntime = class {
   }
   async resetRuntimeState(options) {
     const engine = this.engine;
-    const observations = this.observations;
+    const observationSessions = [...this.openedObservationSessions];
     this.networkHistory.clear();
     this.sessionRef = void 0;
     this.pageRef = void 0;
@@ -18175,9 +18046,15 @@ var OpensteerSessionRuntime = class {
     this.computer = void 0;
     this.extractionDescriptors = void 0;
     this.engine = void 0;
-    this.observations = void 0;
+    this.observationSessions.clear();
+    this.openingObservationSessions.clear();
+    this.openedObservationSessions.clear();
     this.pendingOperationEventCaptures.length = 0;
-    await observations?.close("runtime_reset").catch(() => void 0);
+    await Promise.allSettled(
+      observationSessions.map(
+        (observationSession) => observationSession.close("runtime_reset").catch(() => void 0)
+      )
+    );
     if (options.disposeEngine && this.ownsEngine && engine?.dispose) {
       await engine.dispose();
     }
@@ -18187,23 +18064,64 @@ var OpensteerSessionRuntime = class {
     if (this.observationConfig.profile === "off") {
       return void 0;
     }
-    if (this.observations !== void 0) {
-      return this.observations;
+    const observationSessionId = this.resolveObservationSessionId();
+    if (observationSessionId === void 0) {
+      return void 0;
+    }
+    const existingObservationSession = this.observationSessions.get(observationSessionId);
+    if (existingObservationSession !== void 0) {
+      return existingObservationSession;
+    }
+    const openingObservationSession = this.openingObservationSessions.get(observationSessionId);
+    if (openingObservationSession !== void 0) {
+      return await openingObservationSession;
+    }
+    const openObservationSessionTask = this.openObservationSession(observationSessionId).finally(
+      () => {
+        this.openingObservationSessions.delete(observationSessionId);
+      }
+    );
+    this.openingObservationSessions.set(observationSessionId, openObservationSessionTask);
+    return await openObservationSessionTask;
+  }
+  async ensureConfiguredObservationSession() {
+    if (this.observationConfig.profile === "off") {
+      return void 0;
     }
     const observationSessionId = this.resolveObservationSessionId();
     if (observationSessionId === void 0) {
       return void 0;
     }
+    const hadObservationSession = this.observationSessions.has(observationSessionId) || this.openingObservationSessions.has(observationSessionId);
+    const observationSession = await this.ensureObservationSession();
+    if (observationSession !== void 0 && hadObservationSession) {
+      await observationSession.configure?.({
+        config: this.observationConfig,
+        updatedAt: Date.now()
+      });
+    }
+    return observationSession;
+  }
+  resolveObservationSessionId() {
+    const scopedSession = this.observationSessionStorage.getStore();
+    if (scopedSession?.mode === "session") {
+      return scopedSession.sessionId;
+    }
+    if (scopedSession?.mode === "disabled") {
+      return void 0;
+    }
+    return this.observationSessionId ?? this.sessionRef;
+  }
+  async openObservationSession(sessionId) {
     const sink = this.injectedObservationSink ?? (await this.ensureRoot()).observations;
-    this.observations = await sink.openSession({
-      sessionId: observationSessionId,
+    const observationSession = await sink.openSession({
+      sessionId,
       openedAt: Date.now(),
       config: this.observationConfig
     });
-    return this.observations;
-  }
-  resolveObservationSessionId() {
-    return this.observationSessionId ?? this.sessionRef;
+    this.observationSessions.set(sessionId, observationSession);
+    this.openedObservationSessions.add(observationSession);
+    return observationSession;
   }
   runWithOperationTimeout(operation, callback, options = {}) {
     const timeoutPolicy = options.timeoutMs === void 0 ? this.policy.timeout : {
@@ -19601,15 +19519,10 @@ function normalizeNamespace2(value) {
   const normalized = String(value ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
-function toOpensteerActionResult(result) {
+function toOpensteerActionResult(target) {
   return {
-    target: toOpensteerResolvedTarget2(result.resolved),
-    ...result.point === void 0 ? {} : {
-      point: {
-        x: result.point.x,
-        y: result.point.y
-      }
-    }
+    tagName: toOpensteerTagName2(target.node.nodeName),
+    ...target.persist === void 0 ? {} : { persist: target.persist }
   };
 }
 function toOpensteerResolvedTarget2(target) {
@@ -19619,12 +19532,16 @@ function toOpensteerResolvedTarget2(target) {
     documentRef: target.documentRef,
     documentEpoch: target.documentEpoch,
     nodeRef: target.nodeRef,
-    tagName: target.node.nodeName.toUpperCase(),
+    tagName: toOpensteerTagName2(target.node.nodeName),
     pathHint: buildPathSelectorHint(target.replayPath ?? target.anchor),
     ...target.persist === void 0 ? {} : { persist: target.persist },
     ...target.selectorUsed === void 0 ? {} : { selectorUsed: target.selectorUsed }
   };
 }
+function toOpensteerTagName2(nodeName) {
+  const tagName = String(nodeName).trim().toLowerCase();
+  return tagName.length === 0 ? "element" : tagName;
+}
 function normalizeOpensteerError(error) {
   return normalizeThrownOpensteerError(error, "Unknown Opensteer runtime failure");
 }
@@ -21260,7 +21177,11 @@ function generateReplayScript(options) {
     ``,
     ...renderOpensteerBootstrap(replayTarget),
     ``,
-    `const ${initialPageId} = (await opensteer.open(${JSON.stringify(initialPages[0]?.initialUrl ?? "")})).pageRef;`,
+    `await opensteer.open(${JSON.stringify(initialPages[0]?.initialUrl ?? "")});`,
+    `const ${initialPageId} = (await opensteer.listPages()).activePageRef;`,
+    `if (!${initialPageId}) {`,
+    `  throw new Error("Opensteer did not report an active page after open().");`,
+    `}`,
     `let activePageRef: string | undefined = ${initialPageId};`,
     ``,
     `async function ensureActive(pageRef: string): Promise<void> {`,
@@ -21464,26 +21385,35 @@ function renderOpensteerBootstrap(replayTarget) {
     `const opensteer = new Opensteer({`,
     `  provider: {`,
     `    mode: "cloud",`,
-    `    baseUrl: requireEnv(${JSON.stringify(replayTarget.baseUrlEnvVar ?? "OPENSTEER_BASE_URL")}),`,
     `    apiKey: requireEnv(${JSON.stringify(replayTarget.apiKeyEnvVar ?? "OPENSTEER_API_KEY")}),`,
+    ...renderCloudBaseUrl(replayTarget),
     ...renderCloudBrowserProfile(replayTarget),
     `  },`,
     `});`
   ];
 }
 function renderRequireEnvHelper(replayTarget) {
-  const baseUrlEnvVar = replayTarget.baseUrlEnvVar ?? "OPENSTEER_BASE_URL";
   const apiKeyEnvVar = replayTarget.apiKeyEnvVar ?? "OPENSTEER_API_KEY";
+  const requiredEnvVars = [
+    ...replayTarget.baseUrlEnvVar === void 0 ? [] : [replayTarget.baseUrlEnvVar],
+    apiKeyEnvVar
+  ];
   return [
     `function requireEnv(name: string): string {`,
     `  const value = process.env[name];`,
     `  if (typeof value === "string" && value.trim().length > 0) {`,
     `    return value;`,
     `  }`,
-    `  throw new Error(\`Missing environment variable \${name}. Set ${baseUrlEnvVar} and ${apiKeyEnvVar} before replaying this recording.\`);`,
+    `  throw new Error(\`Missing environment variable \${name}. Set ${requiredEnvVars.join(" and ")} before replaying this recording.\`);`,
     `}`
   ].join("\n");
 }
+function renderCloudBaseUrl(replayTarget) {
+  if (replayTarget.baseUrlEnvVar === void 0) {
+    return [];
+  }
+  return [`    baseUrl: requireEnv(${JSON.stringify(replayTarget.baseUrlEnvVar)}),`];
+}
 function renderCloudBrowserProfile(replayTarget) {
   if (replayTarget.browserProfileId === void 0) {
     return [];
@@ -22644,7 +22574,29 @@ function isLoopbackBaseUrl(baseUrl) {
   }
   return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1" || url.hostname === "[::1]";
 }
-var OpensteerRuntime = class extends OpensteerSessionRuntime {
+var LocalActivePageHintRuntime = class extends OpensteerSessionRuntime {
+  async completeWithLocalActivePageHint(operation) {
+    const output = await operation();
+    await persistLocalActivePageHint(this, this.rootPath);
+    return output;
+  }
+  async open(input = {}, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.open(input, options));
+  }
+  async newPage(input = {}, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.newPage(input, options));
+  }
+  async activatePage(input, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.activatePage(input, options));
+  }
+  async closePage(input = {}, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.closePage(input, options));
+  }
+  async goto(input, options = {}) {
+    return this.completeWithLocalActivePageHint(() => super.goto(input, options));
+  }
+};
+var OpensteerRuntime = class extends LocalActivePageHintRuntime {
   constructor(options = {}) {
     const publicWorkspace = normalizeWorkspace(options.workspace);
     const rootPath = options.rootPath ?? (publicWorkspace === void 0 ? path2.resolve(options.rootDir ?? process.cwd(), ".opensteer", "temporary", randomUUID()) : resolveFilesystemWorkspacePath({
@@ -22682,6 +22634,41 @@ var OpensteerRuntime = class extends OpensteerSessionRuntime {
     );
   }
 };
+async function persistLocalActivePageHint(runtime, rootPath) {
+  try {
+    await syncPersistedLocalActivePageHint(runtime, rootPath);
+  } catch {
+  }
+}
+async function syncPersistedLocalActivePageHint(runtime, rootPath) {
+  const record = await readPersistedLocalBrowserSessionRecord(rootPath);
+  if (!record) {
+    return;
+  }
+  const sessionInfo = await runtime.info();
+  const activePageRef = sessionInfo.activePageRef;
+  let activePageUrl;
+  let activePageTitle;
+  if (activePageRef !== void 0) {
+    const pages = await runtime.listPages();
+    const activePage = pages.pages.find((page) => page.pageRef === activePageRef);
+    activePageUrl = activePage?.url;
+    activePageTitle = activePage?.title;
+  }
+  const {
+    activePageRef: _previousActivePageRef,
+    activePageUrl: _previousActivePageUrl,
+    activePageTitle: _previousActivePageTitle,
+    ...restRecord
+  } = record;
+  await writePersistedSessionRecord(rootPath, {
+    ...restRecord,
+    updatedAt: Date.now(),
+    ...activePageRef === void 0 ? {} : { activePageRef },
+    ...activePageUrl === void 0 ? {} : { activePageUrl },
+    ...activePageTitle === void 0 ? {} : { activePageTitle }
+  });
+}
 function buildSharedRuntimeOptions(input) {
   const ownership = resolveOwnership(input.browser);
   const engineFactory = input.engineFactory ?? ((factoryOptions) => new OpensteerBrowserManager({
@@ -22773,6 +22760,6 @@ function createOpensteerSemanticRuntime(input = {}) {
   });
 }
 
-export { CloudSessionProxy, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, FlowRecorderCollector, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OpensteerCloudClient, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createDomDescriptorStore, createDomRuntime, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, dispatchSemanticOperation, generateReplayScript, hashDomDescriptorPersist, isBrowserCoreError, isCurrentUrlField, isValidCssAttributeKey, loadEnvironment, normalizeExtractedValue, normalizeOpensteerProviderMode, parseDomDescriptorRecord, parseExtractionDescriptorRecord, requireCloudAppBaseUrl, resolveCloudConfig, resolveDomActionBridge, resolveExtractedValueInContext, resolveOpensteerEnvironment, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath };
-//# sourceMappingURL=chunk-BVRIPCWA.js.map
-//# sourceMappingURL=chunk-BVRIPCWA.js.map
+export { CloudSessionProxy, DEFAULT_OPENSTEER_CLOUD_BASE_URL, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, FlowRecorderCollector, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OpensteerCloudClient, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createDomDescriptorStore, createDomRuntime, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, dispatchSemanticOperation, generateReplayScript, hashDomDescriptorPersist, isBrowserCoreError, isCurrentUrlField, isValidCssAttributeKey, loadEnvironment, normalizeExtractedValue, normalizeOpensteerProviderMode, parseDomDescriptorRecord, parseExtractionDescriptorRecord, requireCloudAppBaseUrl, resolveCloudConfig, resolveDomActionBridge, resolveExtractedValueInContext, resolveOpensteerEnvironment, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath };
+//# sourceMappingURL=chunk-LFWP5RXF.js.map
+//# sourceMappingURL=chunk-LFWP5RXF.js.map