opensteer 0.9.4 → 0.9.6

package/dist/index.cjs

@@ -1037,9 +1037,6 @@ function isBrowserCoreError(value) {
   return value instanceof BrowserCoreError;
 }
 
-// ../browser-core/src/cdp-visual-stability.ts
-var DEFAULT_VISUAL_STABILITY_SETTLE_MS = 750;
-
 // ../browser-core/src/post-load-tracker.ts
 var DEFAULT_POST_LOAD_TRACKER_QUIET_WINDOW_MS = 400;
 
@@ -4445,10 +4442,10 @@ var opensteerDomScrollInputSchema = objectSchema(
     required: ["target", "direction", "amount"]
   }
 );
-var opensteerExtractSchemaSchema = objectSchema(
+var opensteerExtractTemplateSchema = objectSchema(
   {},
   {
-    title: "OpensteerExtractSchema",
+    title: "OpensteerExtractTemplate",
     additionalProperties: true
   }
 );
@@ -4456,13 +4453,13 @@ var opensteerDomExtractInputSchema = defineSchema({
   ...objectSchema(
     {
       persist: stringSchema(),
-      schema: opensteerExtractSchemaSchema
+      template: opensteerExtractTemplateSchema
     },
     {
       title: "OpensteerDomExtractInput"
     }
   ),
-  anyOf: [defineSchema({ required: ["persist"] }), defineSchema({ required: ["schema"] })]
+  anyOf: [defineSchema({ required: ["persist"] }), defineSchema({ required: ["template"] })]
 });
 var jsonValueSchema2 = recordSchema({}, { title: "JsonValueRecord" });
 var opensteerDomExtractOutputSchema = objectSchema(
@@ -6845,21 +6842,6 @@ var DEFAULT_SETTLE_DELAYS = {
   "dom-action": 100,
   snapshot: 0
 };
-var defaultSnapshotSettleObserver = {
-  async settle(input) {
-    if (input.trigger !== "snapshot") {
-      return false;
-    }
-    await input.engine.waitForVisualStability({
-      pageRef: input.pageRef,
-      ...input.remainingMs === void 0 ? {} : { timeoutMs: input.remainingMs },
-      settleMs: DEFAULT_VISUAL_STABILITY_SETTLE_MS,
-      scope: "visible-frames"
-    });
-    return true;
-  }
-};
-Object.freeze(defaultSnapshotSettleObserver);
 var DOM_ACTION_VISUAL_STABILITY_PROFILES = {
   "dom.click": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
   "dom.input": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
@@ -6912,6 +6894,7 @@ var defaultNavigationSettleObserver = {
       return false;
     }
     try {
+      const startedAt = Date.now();
       await input.engine.waitForPostLoadQuiet({
         pageRef: input.pageRef,
         timeoutMs: effectiveTimeout,
@@ -6919,9 +6902,13 @@ var defaultNavigationSettleObserver = {
         captureWindowMs: Math.min(NAVIGATION_POST_LOAD_CAPTURE_WINDOW_MS, effectiveTimeout),
         signal: input.signal
       });
+      const visualTimeout = Math.max(0, effectiveTimeout - (Date.now() - startedAt));
+      if (visualTimeout <= 0) {
+        return true;
+      }
       await input.engine.waitForVisualStability({
         pageRef: input.pageRef,
-        timeoutMs: effectiveTimeout,
+        timeoutMs: visualTimeout,
         settleMs: profile.settleMs,
         scope: profile.scope
       });
@@ -6933,7 +6920,6 @@ var defaultNavigationSettleObserver = {
 };
 Object.freeze(defaultNavigationSettleObserver);
 var DEFAULT_SETTLE_OBSERVERS = Object.freeze([
-  defaultSnapshotSettleObserver,
   defaultDomActionSettleObserver,
   defaultNavigationSettleObserver
 ]);
@@ -7386,6 +7372,9 @@ function buildClauseSelector(node, clause) {
   if (!clause || typeof clause !== "object") {
     return "";
   }
+  if (clause.kind === "text") {
+    return "";
+  }
   if (clause.kind === "position") {
     if (clause.axis === "nthOfType") {
       return `:nth-of-type(${Math.max(1, Number(node.position?.nthOfType || 1))})`;
@@ -7510,7 +7499,7 @@ function resolveExtractedValueInContext(normalizedValue, options) {
 function stripPositionClauses(nodes) {
   return (nodes || []).map((node) => ({
     ...node,
-    match: (node.match || []).filter((clause) => clause.kind !== "position")
+    match: (node.match || []).filter((clause) => clause.kind !== "position" && clause.kind !== "text")
   }));
 }
 function dedupeSelectors(selectors) {
@@ -8087,9 +8076,17 @@ function resolveDomPathInScope(index, domPath, scope) {
   if (!candidates.length) {
     return null;
   }
+  const lastNode = domPath[domPath.length - 1];
+  const textClauses = lastNode?.match.filter((c) => c.kind === "text") ?? [];
   let fallback = null;
   for (const selector of candidates) {
-    const matches = querySelectorAllInScope(index, selector, scope);
+    let matches = querySelectorAllInScope(index, selector, scope);
+    if (textClauses.length > 0 && matches.length > 1) {
+      const filtered = matches.filter((node) => matchesTextClauses(node, textClauses));
+      if (filtered.length > 0) {
+        matches = filtered;
+      }
+    }
     if (matches.length === 1) {
       return {
         node: matches[0],
@@ -8109,6 +8106,10 @@ function resolveDomPathInScope(index, domPath, scope) {
   }
   return fallback;
 }
+function matchesTextClauses(node, clauses) {
+  const text = (node.textContent ?? "").replace(/\s+/g, " ").trim();
+  return clauses.every((clause) => text.includes(clause.value));
+}
 function queryAllDomPathInScope(index, domPath, scope) {
   const selectors = buildPathCandidates(domPath);
   for (const selector of selectors) {
@@ -8267,7 +8268,13 @@ function clonePathNode(node) {
   };
 }
 function cloneMatchClause(clause) {
-  return clause.kind === "position" ? { kind: "position", axis: clause.axis } : {
+  if (clause.kind === "position") {
+    return { kind: "position", axis: clause.axis };
+  }
+  if (clause.kind === "text") {
+    return { kind: "text", value: clause.value };
+  }
+  return {
     kind: "attr",
     key: clause.key,
     ...clause.op === void 0 ? {} : { op: clause.op },
@@ -8322,6 +8329,13 @@ function normalizeMatch(rawMatch, attrs, position, tag) {
           op,
           ...value === void 0 ? {} : { value }
         });
+        continue;
+      }
+      if (record.kind === "text") {
+        const textValue = typeof record.value === "string" ? record.value.trim() : "";
+        if (textValue) {
+          push({ kind: "text", value: textValue.slice(0, 80) });
+        }
       }
     }
   }
@@ -8689,7 +8703,7 @@ function isTimeoutError(error) {
 }
 
 // ../runtime-core/src/runtimes/dom/executor.ts
-var MAX_DOM_ACTION_ATTEMPTS = 3;
+var MAX_DOM_ACTION_ATTEMPTS = 2;
 var DEFAULT_SCROLL_OPTIONS = {
   block: "center",
   inline: "center"
@@ -9176,11 +9190,12 @@ var DomActionExecutor = class {
     throw this.createActionabilityError(
       operation,
       "obscured",
-      `hit test resolved ${hit.nodeRef} outside the target subtree rooted at ${resolved.nodeRef}`,
+      `target is obscured by ${assessment.blockingDescription ?? "another element"} at the click point`,
       {
         ...details,
         hitRelation: assessment.relation,
         ...assessment.ambiguous === void 0 ? {} : { hitAmbiguous: assessment.ambiguous },
+        ...assessment.blockingDescription === void 0 ? {} : { blockingDescription: assessment.blockingDescription },
         ...assessment.canonicalTarget === void 0 ? {} : {
           canonicalNodeRef: assessment.canonicalTarget.nodeRef,
           canonicalDocumentRef: assessment.canonicalTarget.documentRef,
@@ -9194,8 +9209,7 @@ var DomActionExecutor = class {
         hitMissingFromSnapshot: !resolved.snapshot.nodes.some(
           (node) => node.nodeRef === hit.nodeRef
         )
-      },
-      true
+      }
     );
   }
   async resolveActionablePointerTarget(session, operation, resolved) {
@@ -9407,7 +9421,12 @@ var DefaultDomRuntime = class {
     });
   }
   async buildPath(input) {
-    return sanitizeReplayElementPath(await this.requireBridge().buildReplayPath(input.locator));
+    return sanitizeReplayElementPath(
+      await this.requireBridge().buildReplayPath(
+        input.locator,
+        input.enableTextMatch ? { enableTextMatch: true } : void 0
+      )
+    );
   }
   async resolveTarget(input) {
     return this.withSnapshotSession((session) => this.resolveTargetWithSession(session, input));
@@ -9627,7 +9646,7 @@ var DefaultDomRuntime = class {
     if (resolvedByLocator) {
       const { snapshot, node } = resolvedByLocator;
       const anchor = await this.buildAnchorFromSnapshotNode(session, snapshot, node);
-      const replayPath = await this.tryBuildPathFromNode(snapshot, node);
+      const replayPath = await this.tryBuildPathFromNode(snapshot, node, { enableTextMatch: true });
       return this.createResolvedTarget("live", snapshot, node, anchor, {
         ...target.persist === void 0 ? {} : { persist: target.persist },
         ...replayPath === void 0 ? {} : { replayPath }
@@ -9645,11 +9664,12 @@ var DefaultDomRuntime = class {
     const { snapshot, node } = resolved;
     const anchor = await this.buildAnchorFromSnapshotNode(session, snapshot, node);
     const writeDescriptor = descriptorWriter ?? ((input) => this.descriptors.write(input));
-    const replayPath = await this.tryBuildPathFromNode(snapshot, node);
+    const enableTextMatch = method !== "extract";
+    const replayPath = await this.tryBuildPathFromNode(snapshot, node, { enableTextMatch });
     const descriptor = target.persist === void 0 ? void 0 : await writeDescriptor({
       method,
       persist: target.persist,
-      path: replayPath ?? await this.buildPathForNode(snapshot, node),
+      path: replayPath ?? await this.buildPathForNode(snapshot, node, { enableTextMatch }),
       sourceUrl: snapshot.url
     });
     return this.createResolvedTarget("selector", snapshot, node, anchor, {
@@ -9749,7 +9769,7 @@ var DefaultDomRuntime = class {
         `Unable to resolve structural anchor "${buildPathSelectorHint(anchor)}" in the current session`
       );
     }
-    const replayPath = await this.tryBuildPathFromNode(context.snapshot, target.node);
+    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 }
@@ -9920,19 +9940,20 @@ var DefaultDomRuntime = class {
     }
     return this.bridge;
   }
-  async buildPathForNode(snapshot, node) {
+  async buildPathForNode(snapshot, node, options) {
     if (node.nodeRef === void 0) {
       throw new Error(
         `snapshot node ${String(node.snapshotNodeId)} does not expose a live node reference`
       );
     }
     return this.buildPath({
-      locator: createNodeLocator(snapshot.documentRef, snapshot.documentEpoch, node.nodeRef)
+      locator: createNodeLocator(snapshot.documentRef, snapshot.documentEpoch, node.nodeRef),
+      ...options?.enableTextMatch ? { enableTextMatch: true } : {}
     });
   }
-  async tryBuildPathFromNode(snapshot, node) {
+  async tryBuildPathFromNode(snapshot, node, options) {
     try {
-      return await this.buildPathForNode(snapshot, node);
+      return await this.buildPathForNode(snapshot, node, options);
     } catch {
       return void 0;
     }
@@ -10546,6 +10567,9 @@ function relaxPathForSingleSample(path18, mode) {
         }
         return !isLast;
       }
+      if (clause.kind === "text") {
+        return false;
+      }
       const key = String(clause.key || "").trim().toLowerCase();
       if (!key || !shouldKeepAttrForSingleSample(key)) {
         return false;
@@ -10648,9 +10672,11 @@ function buildNodeStructure(node) {
     }
     structuralAttrs[key] = value;
   }
-  const matchClauses = (node.match || []).map(
-    (clause) => clause.kind === "position" ? `position:${clause.axis}` : `attr:${String(clause.key || "").trim().toLowerCase()}`
-  ).sort();
+  const matchClauses = (node.match || []).map((clause) => {
+    if (clause.kind === "position") return `position:${clause.axis}`;
+    if (clause.kind === "text") return `text:${clause.value}`;
+    return `attr:${String(clause.key || "").trim().toLowerCase()}`;
+  }).sort();
   return {
     tag,
     attrs: structuralAttrs,
@@ -11056,6 +11082,9 @@ function mergeMatchByMajority(matchLists, attrs, threshold, positionFlags = {
       });
       continue;
     }
+    if (clause.kind === "text") {
+      continue;
+    }
     if (clause.axis === "nthOfType") {
       if (positionFlags.hasNthOfType) {
         merged.push({ kind: "position", axis: "nthOfType" });
@@ -11200,9 +11229,9 @@ function isPersistedObjectNode(node) {
 }
 
 // ../runtime-core/src/sdk/extraction.ts
-function assertValidOpensteerExtractionSchemaRoot(schema) {
-  if (!schema || typeof schema !== "object" || Array.isArray(schema)) {
-    throw new Error("Invalid extraction schema: expected a JSON object at the top level.");
+function assertValidOpensteerExtractionTemplateRoot(template) {
+  if (!template || typeof template !== "object" || Array.isArray(template)) {
+    throw new Error("Invalid extraction template: expected a JSON object at the top level.");
   }
 }
 function isPersistedOpensteerExtractionValueNode2(value) {
@@ -11224,12 +11253,12 @@ function isPersistedOpensteerExtractionArrayNode2(value) {
   return "$array" in value;
 }
 async function compileOpensteerExtractionFieldTargets(options) {
-  assertValidOpensteerExtractionSchemaRoot(options.schema);
+  assertValidOpensteerExtractionTemplateRoot(options.template);
   const fields = [];
-  await collectFieldTargetsFromSchemaObject({
+  await collectFieldTargetsFromTemplateObject({
     dom: options.dom,
     pageRef: options.pageRef,
-    value: options.schema,
+    value: options.template,
     path: "",
     fields,
     insideArray: false
@@ -11281,13 +11310,13 @@ function createOpensteerExtractionDescriptorStore(options) {
   }
   return new MemoryOpensteerExtractionDescriptorStore(namespace);
 }
-async function collectFieldTargetsFromSchemaObject(options) {
+async function collectFieldTargetsFromTemplateObject(options) {
   for (const [key, childValue] of Object.entries(options.value)) {
     const normalizedKey = normalizeKey(key);
     if (!normalizedKey) {
       continue;
     }
-    await collectFieldTargetsFromSchemaValue({
+    await collectFieldTargetsFromTemplateValue({
       dom: options.dom,
       pageRef: options.pageRef,
       value: childValue,
@@ -11297,8 +11326,8 @@ async function collectFieldTargetsFromSchemaObject(options) {
     });
   }
 }
-async function collectFieldTargetsFromSchemaValue(options) {
-  const normalizedField = normalizeSchemaField(options.value);
+async function collectFieldTargetsFromTemplateValue(options) {
+  const normalizedField = normalizeTemplateField(options.value);
   if (normalizedField !== null) {
     options.fields.push(
       await compileFieldTarget({
@@ -11313,12 +11342,12 @@ async function collectFieldTargetsFromSchemaValue(options) {
   if (Array.isArray(options.value)) {
     if (options.insideArray) {
       throw new Error(
-        `Nested arrays are not supported in extraction schema at "${labelForPath(options.path)}".`
+        `Nested arrays are not supported in extraction template at "${labelForPath(options.path)}".`
       );
     }
     if (options.value.length === 0) {
       throw new Error(
-        `Extraction array "${labelForPath(options.path)}" must include at least one representative item.`
+        `Extraction array "${labelForPath(options.path)}" must include at least one representative template item.`
       );
     }
     for (let index = 0; index < options.value.length; index += 1) {
@@ -11329,7 +11358,7 @@ async function collectFieldTargetsFromSchemaValue(options) {
         );
       }
       const fieldCountBeforeItem = options.fields.length;
-      await collectFieldTargetsFromSchemaObject({
+      await collectFieldTargetsFromTemplateObject({
         dom: options.dom,
         pageRef: options.pageRef,
         value: itemValue,
@@ -11340,7 +11369,7 @@ async function collectFieldTargetsFromSchemaValue(options) {
       const itemFields = options.fields.slice(fieldCountBeforeItem);
       if (!itemFields.some((field) => !("source" in field))) {
         throw new Error(
-          `Extraction array "${labelForPath(options.path)}" item ${String(index)} must include at least one element- or selector-backed field.`
+          `Extraction array "${labelForPath(options.path)}" item ${String(index)} must include at least one element number or selector field.`
         );
       }
     }
@@ -11348,10 +11377,10 @@ async function collectFieldTargetsFromSchemaValue(options) {
   }
   if (!options.value || typeof options.value !== "object") {
     throw new Error(
-      `Invalid extraction schema value at "${labelForPath(options.path)}": expected an object, array, or field descriptor.`
+      `Invalid extraction template value at "${labelForPath(options.path)}": expected an object, array, or field descriptor.`
     );
   }
-  await collectFieldTargetsFromSchemaObject({
+  await collectFieldTargetsFromTemplateObject({
     dom: options.dom,
     pageRef: options.pageRef,
     value: options.value,
@@ -11383,7 +11412,7 @@ async function compileFieldTarget(options) {
     path: await resolveSelectorFieldPath({
       dom: options.dom,
       pageRef: options.pageRef,
-      selector: `[c="${String(options.field.element)}"]`
+      selector: `[c="${String(options.field.c)}"]`
     }),
     ...options.field.attribute === void 0 ? {} : { attribute: options.field.attribute }
   };
@@ -11684,24 +11713,29 @@ function countNonNullLeaves(value) {
   }
   return Object.values(value).reduce((sum, item) => sum + countNonNullLeaves(item), 0);
 }
-function normalizeSchemaField(value) {
+function normalizeTemplateField(value) {
+  if (typeof value === "number") {
+    return {
+      c: normalizeExtractionCounter(value)
+    };
+  }
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return null;
   }
   const raw = value;
-  const hasElement = raw.element !== void 0;
+  const hasCounter = raw.c !== void 0 || raw.element !== void 0;
   const hasSelector = raw.selector !== void 0;
   const hasSource = raw.source !== void 0;
-  const targetCount = Number(hasElement) + Number(hasSelector) + Number(hasSource);
+  const targetCount = Number(hasCounter) + Number(hasSelector) + Number(hasSource);
   if (targetCount === 0) {
     return null;
   }
   if (targetCount !== 1) {
     throw new Error(
-      "Extraction field descriptors must specify exactly one of element, selector, or source."
+      "Extraction field descriptors must specify exactly one of c/element, selector, or source."
     );
   }
-  const attribute = raw.attribute === void 0 ? void 0 : normalizeNonEmptyString2("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)}".`);
@@ -11716,17 +11750,20 @@ function normalizeSchemaField(value) {
       ...attribute === void 0 ? {} : { attribute }
     };
   }
-  const element = Number(raw.element);
-  if (!Number.isInteger(element) || element < 1) {
-    throw new Error(
-      `Extraction field element must be a positive integer, received ${String(raw.element)}.`
-    );
-  }
   return {
-    element,
+    c: normalizeExtractionCounter(raw.c ?? raw.element),
     ...attribute === void 0 ? {} : { attribute }
   };
 }
+function normalizeExtractionCounter(value) {
+  const counter = Number(value);
+  if (!Number.isInteger(counter) || counter < 1) {
+    throw new Error(
+      `Extraction element number must be a positive integer, received ${String(value)}.`
+    );
+  }
+  return counter;
+}
 function normalizeNamespace(namespace) {
   const normalized = String(namespace ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
@@ -11757,7 +11794,7 @@ function parseExtractionDescriptorRecord(record) {
       kind: "dom-extraction",
       persist: raw.persist,
       root,
-      ...typeof raw.schemaHash === "string" ? { schemaHash: raw.schemaHash } : {},
+      ...typeof raw.templateHash === "string" ? { templateHash: raw.templateHash } : typeof raw.schemaHash === "string" ? { templateHash: raw.schemaHash } : {},
       ...typeof raw.sourceUrl === "string" ? { sourceUrl: raw.sourceUrl } : {}
     }
   };
@@ -11843,7 +11880,7 @@ var FilesystemOpensteerExtractionDescriptorStore = class {
       kind: "dom-extraction",
       persist: input.persist,
       root: input.root,
-      ...input.schemaHash === void 0 ? {} : { schemaHash: input.schemaHash },
+      ...input.templateHash === void 0 ? {} : { templateHash: input.templateHash },
       ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
     };
     const key = persistKey(this.namespace, input.persist);
@@ -11892,7 +11929,7 @@ var MemoryOpensteerExtractionDescriptorStore = class {
       kind: "dom-extraction",
       persist: input.persist,
       root: input.root,
-      ...input.schemaHash === void 0 ? {} : { schemaHash: input.schemaHash },
+      ...input.templateHash === void 0 ? {} : { templateHash: input.templateHash },
       ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
     };
     const key = persistKey(this.namespace, input.persist);
@@ -13862,7 +13899,8 @@ function normalizeOpensteerEngineName(value, source = "engine") {
   if (normalized === "playwright" || normalized === "abp") {
     return normalized;
   }
-  throw new Error(
+  throw new OpensteerProtocolError(
+    "invalid-argument",
     `${source} must be one of ${OPENSTEER_ENGINE_NAMES.join(", ")}; received "${value}".`
   );
 }
@@ -13871,7 +13909,8 @@ function assertSupportedEngineOptions(input) {
     return;
   }
   if (typeof input.browser === "object" && input.browser !== null && input.browser.mode === "attach") {
-    throw new Error(
+    throw new OpensteerProtocolError(
+      "invalid-argument",
       'ABP engine does not support browser.mode="attach". Use the Playwright engine for attach flows.'
     );
   }
@@ -13879,7 +13918,8 @@ function assertSupportedEngineOptions(input) {
   if (unsupportedContextOptionNames.length === 0) {
     return;
   }
-  throw new Error(
+  throw new OpensteerProtocolError(
+    "invalid-argument",
     `ABP engine does not support ${unsupportedContextOptionNames.join(", ")}. Supported ABP context options: context.viewport.`
   );
 }
@@ -14981,6 +15021,48 @@ function isOpensteerEnvironmentKey(key) {
   return key.startsWith(OPENSTEER_ENV_PREFIX);
 }
 
+// src/internal/errors.ts
+function normalizeThrownOpensteerError(error, fallbackMessage) {
+  if (isOpensteerProtocolError(error)) {
+    return toOpensteerError(error);
+  }
+  if (isBrowserCoreError(error)) {
+    return createOpensteerError(error.code, error.message, {
+      retriable: error.retriable,
+      ...error.details === void 0 ? {} : { details: error.details }
+    });
+  }
+  if (error instanceof OpensteerAttachAmbiguousError) {
+    return createOpensteerError("conflict", error.message, {
+      details: {
+        candidates: error.candidates,
+        code: error.code,
+        name: error.name
+      }
+    });
+  }
+  if (error instanceof Error && "opensteerError" in error && typeof error.opensteerError === "object" && error.opensteerError !== null) {
+    const oe = error.opensteerError;
+    return createOpensteerError(oe.code, oe.message, {
+      retriable: oe.retriable,
+      ...oe.capability === void 0 ? {} : { capability: oe.capability },
+      ...oe.details === void 0 ? {} : { details: oe.details }
+    });
+  }
+  if (error instanceof Error) {
+    return createOpensteerError("operation-failed", error.message, {
+      details: {
+        name: error.name
+      }
+    });
+  }
+  return createOpensteerError("internal", fallbackMessage, {
+    details: {
+      value: error
+    }
+  });
+}
+
 // src/provider/config.ts
 var OPENSTEER_PROVIDER_MODES = ["local", "cloud"];
 function assertProviderSupportsEngine(provider, engine) {
@@ -14988,7 +15070,8 @@ function assertProviderSupportsEngine(provider, engine) {
     return;
   }
   if (provider === "cloud") {
-    throw new Error(
+    throw new OpensteerProtocolError(
+      "invalid-argument",
       "ABP is not supported for provider=cloud. Cloud provider currently requires Playwright."
     );
   }
@@ -14998,7 +15081,8 @@ function normalizeOpensteerProviderMode(value, source = "OPENSTEER_PROVIDER") {
   if (normalized === OPENSTEER_PROVIDER_MODES[0] || normalized === OPENSTEER_PROVIDER_MODES[1]) {
     return normalized;
   }
-  throw new Error(
+  throw new OpensteerProtocolError(
+    "invalid-argument",
     `${source} must be one of ${OPENSTEER_PROVIDER_MODES.join(", ")}; received "${value}".`
   );
 }
@@ -15438,6 +15522,24 @@ async function sleep3(ms) {
 // src/cloud/client.ts
 var CLOUD_CLOSE_TIMEOUT_MS = 6e4;
 var CLOUD_CLOSE_POLL_INTERVAL_MS = 250;
+var OpensteerCloudRequestError = class extends Error {
+  statusCode;
+  code;
+  details;
+  method;
+  pathname;
+  url;
+  constructor(args) {
+    super(args.message);
+    this.name = "OpensteerCloudRequestError";
+    this.statusCode = args.statusCode;
+    this.code = args.code;
+    this.details = args.details;
+    this.method = args.method;
+    this.pathname = args.pathname;
+    this.url = args.url;
+  }
+};
 var OpensteerCloudClient = class {
   constructor(config) {
     this.config = config;
@@ -15613,7 +15715,11 @@ var OpensteerCloudClient = class {
       });
     }
     if (!response.ok) {
-      throw new Error(`${init.method} ${pathname} failed with ${String(response.status)}.`);
+      throw await createCloudRequestError(response, {
+        method: init.method,
+        pathname,
+        url
+      });
     }
     return response;
   }
@@ -15661,6 +15767,36 @@ function wrapCloudFetchError(error, input) {
   wrapped.name = error.name;
   return wrapped;
 }
+async function createCloudRequestError(response, input) {
+  const payload = await readCloudErrorPayload(response);
+  return new OpensteerCloudRequestError({
+    statusCode: response.status,
+    method: input.method,
+    pathname: input.pathname,
+    url: input.url,
+    message: payload?.error ?? `${input.method} ${input.pathname} failed with ${String(response.status)}.`,
+    ...payload?.code === void 0 ? {} : { code: payload.code },
+    ...payload?.details === void 0 ? {} : { details: payload.details }
+  });
+}
+async function readCloudErrorPayload(response) {
+  try {
+    return asCloudErrorPayload(await response.json());
+  } catch {
+    return void 0;
+  }
+}
+function asCloudErrorPayload(value) {
+  if (value === null || typeof value !== "object") {
+    return void 0;
+  }
+  const payload = value;
+  return {
+    ...typeof payload.error === "string" ? { error: payload.error } : {},
+    ...typeof payload.code === "string" ? { code: payload.code } : {},
+    ..."details" in payload ? { details: payload.details } : {}
+  };
+}
 
 // src/cloud/config.ts
 function resolveCloudConfig(input = {}) {
@@ -15691,13 +15827,13 @@ function resolveCloudConfig(input = {}) {
 
 // ../runtime-core/package.json
 var package_default = {
-  version: "0.2.3"};
+  version: "0.2.5"};
 
 // ../runtime-core/src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
 
 // ../runtime-core/src/internal/errors.ts
-function normalizeThrownOpensteerError(error, fallbackMessage) {
+function normalizeThrownOpensteerError2(error, fallbackMessage) {
   if (isOpensteerProtocolError(error)) {
     return toOpensteerError(error);
   }
@@ -16737,10 +16873,19 @@ var VOID_TAGS = /* @__PURE__ */ new Set([
 // ../runtime-core/src/sdk/snapshot/cleaner.ts
 var STRIP_TAGS = /* @__PURE__ */ new Set(["script", "style", "noscript", "meta", "link", "template"]);
 var TEXT_ATTR_MAX = 150;
-var URL_ATTR_MAX = 500;
-var URL_ATTRS = /* @__PURE__ */ new Set(["href", "src", "srcset"]);
+var SRCSET_ATTR_MAX = 160;
+var MIDDLE_TRUNCATED_URL_ATTRS = /* @__PURE__ */ new Set(["href", "src"]);
 var TEXT_ATTRS = /* @__PURE__ */ new Set(["alt", "title", "aria-label", "placeholder", "value"]);
-var TRUNCATION_SUFFIX = " [truncated]";
+var TRUNCATION_SUFFIX = "...";
+var MIDDLE_TRUNCATION_MARKER = "...";
+var MIDDLE_TRUNCATION_HEAD_MAX = 40;
+var MIDDLE_TRUNCATION_TAIL_MAX = 20;
+var SRCSET_CANDIDATE_HEAD_MAX = 36;
+var SRCSET_CANDIDATE_TAIL_MAX = 12;
+var SRCSET_COMPACT_CANDIDATE_HEAD_MAX = 20;
+var SRCSET_COMPACT_CANDIDATE_TAIL_MAX = 8;
+var SRCSET_FALLBACK_HEAD_MAX = 56;
+var SRCSET_FALLBACK_TAIL_MAX = 20;
 var NOISE_SELECTORS = [
   `[${OPENSTEER_HIDDEN_ATTR}]`,
   "[hidden]",
@@ -16803,184 +16948,554 @@ function truncateValue(value, max) {
   }
   return `${head}${TRUNCATION_SUFFIX}`;
 }
+function takeValueWithinSerializedLengthFromEnd(value, max) {
+  let serializedLength = 0;
+  const chars = [];
+  for (let index = value.length - 1; index >= 0; index -= 1) {
+    const char = value[index];
+    let nextLength = 1;
+    if (char === "&") {
+      nextLength = 5;
+    } else if (char === "<" || char === ">") {
+      nextLength = 4;
+    } else if (char === '"') {
+      nextLength = 6;
+    }
+    if (serializedLength + nextLength > max) {
+      break;
+    }
+    chars.push(char);
+    serializedLength += nextLength;
+  }
+  return chars.reverse().join("");
+}
+function truncateValueInMiddle(value, headMax, tailMax, marker = MIDDLE_TRUNCATION_MARKER) {
+  const markerLength = getSerializedLength(marker);
+  const max = headMax + markerLength + tailMax;
+  if (getSerializedLength(value) <= max) {
+    return value;
+  }
+  const head = takeValueWithinSerializedLength(value, headMax).replace(/\s+$/u, "");
+  const tail = takeValueWithinSerializedLengthFromEnd(value, tailMax).replace(/^\s+/u, "");
+  if (head.length === 0) {
+    return tail.length === 0 ? marker : `${marker}${tail}`;
+  }
+  if (tail.length === 0) {
+    return `${head}${marker}`;
+  }
+  return `${head}${marker}${tail}`;
+}
 function getAttrLimit(attr) {
-  if (URL_ATTRS.has(attr)) {
-    return URL_ATTR_MAX;
+  if (attr === "srcset") {
+    return SRCSET_ATTR_MAX;
   }
   if (TEXT_ATTRS.has(attr)) {
     return TEXT_ATTR_MAX;
   }
   return void 0;
 }
+function shouldBoundAttr(attr) {
+  return MIDDLE_TRUNCATED_URL_ATTRS.has(attr) || getAttrLimit(attr) !== void 0;
+}
 function setBoundedAttr(el, attr, value) {
+  if (MIDDLE_TRUNCATED_URL_ATTRS.has(attr)) {
+    el.attr(
+      attr,
+      truncateValueInMiddle(value, MIDDLE_TRUNCATION_HEAD_MAX, MIDDLE_TRUNCATION_TAIL_MAX)
+    );
+    return;
+  }
   const limit = getAttrLimit(attr);
+  if (attr === "srcset" && limit !== void 0) {
+    el.attr(attr, truncateSrcsetValue(value, limit));
+    return;
+  }
   el.attr(attr, limit === void 0 ? value : truncateValue(value, limit));
 }
-function removeNoise($) {
-  for (const tag of STRIP_TAGS) {
-    $(tag).remove();
+function truncateSrcsetValue(value, max) {
+  if (getSerializedLength(value) <= max) {
+    return value;
   }
-  $(NOISE_SELECTORS.join(", ")).remove();
-}
-function removeComments($) {
-  $("*").contents().each(function removeComment() {
-    if (this.type === "comment") {
-      $(this).remove();
-    }
-  });
-}
-function markInlineSelfHiddenFallback($) {
-  $(
-    "[style*='visibility: hidden'], [style*='visibility:hidden'], [style*='visibility: collapse'], [style*='visibility:collapse']"
-  ).each(function markInlineVisibilityHidden() {
-    const el = $(this);
-    if (el.attr(OPENSTEER_HIDDEN_ATTR) === void 0) {
-      el.attr(OPENSTEER_SELF_HIDDEN_ATTR, "1");
-    }
-  });
-}
-function pruneSelfHiddenNodes($) {
-  const nodes = [];
-  $(`[${OPENSTEER_SELF_HIDDEN_ATTR}]`).each(function collectSelfHiddenNodes() {
-    nodes.push($(this));
-  });
-  nodes.sort((left, right) => right.parents().length - left.parents().length);
-  for (const el of nodes) {
-    if (!el[0]) {
-      continue;
-    }
-    el.contents().each(function removeSelfHiddenText() {
-      if (this.type === "text") {
-        $(this).remove();
-      }
-    });
-    if (el.children().length === 0) {
-      el.remove();
-    }
+  const candidates = parseSrcsetCandidates2(value);
+  if (candidates.length === 0) {
+    return truncateValueInMiddle(value, SRCSET_FALLBACK_HEAD_MAX, SRCSET_FALLBACK_TAIL_MAX);
   }
-}
-function hasDirectText($, el) {
-  return el.contents().filter(function hasDirectNodeText() {
-    return this.type === "text" && $(this).text().trim() !== "";
-  }).length > 0;
-}
-function hasTextDeep(el) {
-  return el.text().trim().length > 0;
-}
-function hasActionLabel(attrs) {
-  return typeof attrs["aria-label"] === "string" && attrs["aria-label"].trim() !== "" || typeof attrs["aria-labelledby"] === "string" && attrs["aria-labelledby"].trim() !== "" || typeof attrs["aria-describedby"] === "string" && attrs["aria-describedby"].trim() !== "" || typeof attrs.title === "string" && attrs.title.trim() !== "" || typeof attrs.placeholder === "string" && attrs.placeholder.trim() !== "" || typeof attrs.value === "string" && attrs.value.trim() !== "";
-}
-function unwrapActionNode($, el) {
-  if (hasTextDeep(el)) {
-    if (el.prev().length > 0) {
-      el.before(" ");
-    }
-    if (el.next().length > 0) {
-      el.after(" ");
+  for (const [headMax, tailMax, includeBest] of [
+    [SRCSET_CANDIDATE_HEAD_MAX, SRCSET_CANDIDATE_TAIL_MAX, true],
+    [SRCSET_COMPACT_CANDIDATE_HEAD_MAX, SRCSET_COMPACT_CANDIDATE_TAIL_MAX, true],
+    [SRCSET_COMPACT_CANDIDATE_HEAD_MAX, SRCSET_COMPACT_CANDIDATE_TAIL_MAX, false]
+  ]) {
+    const compact = buildTruncatedSrcsetValue(candidates, headMax, tailMax, includeBest);
+    if (getSerializedLength(compact) <= max) {
+      return compact;
     }
   }
-  el.replaceWith(el.contents());
+  return truncateValueInMiddle(value, SRCSET_FALLBACK_HEAD_MAX, SRCSET_FALLBACK_TAIL_MAX);
 }
-function stripToAttrs(el, keep) {
-  const attrs = el.attr() || {};
-  for (const attr of Object.keys(attrs)) {
-    if (!keep.has(attr)) {
-      el.removeAttr(attr);
-      continue;
-    }
-    const value = el.attr(attr);
-    if (typeof value !== "string") {
-      continue;
-    }
-    if (getAttrLimit(attr) !== void 0) {
-      setBoundedAttr(el, attr, value);
+function buildTruncatedSrcsetValue(candidates, headMax, tailMax, includeBest) {
+  const kept = getPreferredSrcsetCandidateIndices(candidates, includeBest);
+  const parts = [];
+  let previousIndex;
+  for (const candidateIndex of kept) {
+    if (previousIndex !== void 0 && candidateIndex - previousIndex > 1) {
+      parts.push(MIDDLE_TRUNCATION_MARKER);
     }
+    parts.push(formatSrcsetCandidate(candidates[candidateIndex], headMax, tailMax));
+    previousIndex = candidateIndex;
   }
+  return parts.join(", ");
 }
-function restoreBoundedAttr(el, attr, value) {
-  if (typeof value !== "string") {
-    return;
+function getPreferredSrcsetCandidateIndices(candidates, includeBest) {
+  if (candidates.length === 0) {
+    return [];
   }
-  const trimmed = value.trim();
-  if (trimmed === "") {
-    return;
+  const kept = /* @__PURE__ */ new Set([0, candidates.length - 1]);
+  if (includeBest) {
+    kept.add(pickBestSrcsetCandidateIndex(candidates));
   }
-  setBoundedAttr(el, attr, value);
+  return [...kept].filter((index) => index >= 0 && index < candidates.length).sort((a, b) => a - b);
 }
-function deduplicateImages(html) {
-  const seen = /* @__PURE__ */ new Set();
-  return html.replace(/<img\b([^>]*)>/gi, (full, attrContent) => {
-    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;
-    }
-    if (!src) {
-      return full;
+function pickBestSrcsetCandidateIndex(candidates) {
+  let bestWidthIndex = -1;
+  let bestWidth = -1;
+  let bestDensityIndex = -1;
+  let bestDensity = -1;
+  for (let index = 0; index < candidates.length; index += 1) {
+    const candidate = candidates[index];
+    if (typeof candidate.width === "number" && Number.isFinite(candidate.width) && candidate.width > bestWidth) {
+      bestWidth = candidate.width;
+      bestWidthIndex = index;
     }
-    if (seen.has(src)) {
-      return "";
+    if (typeof candidate.density === "number" && Number.isFinite(candidate.density) && candidate.density > bestDensity) {
+      bestDensity = candidate.density;
+      bestDensityIndex = index;
     }
-    seen.add(src);
-    return full;
-  });
-}
-function isPreservedImageElement($, el) {
-  const tag = (el[0]?.tagName || "").toLowerCase();
-  if (tag === "img") {
-    return true;
   }
-  if (tag === "picture") {
-    const hasImg = el.find("img").length > 0;
-    const hasSource = el.find("source[src], source[srcset]").length > 0;
-    return hasImg || hasSource;
+  if (bestWidthIndex >= 0) {
+    return bestWidthIndex;
   }
-  if (tag === "source") {
-    const inPicture = el.parents("picture").length > 0;
-    const hasSrc = el.attr("src") != null && el.attr("src").trim() !== "" || el.attr("srcset") != null && el.attr("srcset").trim() !== "";
-    return inPicture && hasSrc;
+  if (bestDensityIndex >= 0) {
+    return bestDensityIndex;
   }
-  return false;
+  return candidates.length - 1;
 }
-function flattenExtractionTree($) {
-  const flatten = (root) => {
-    root.find("*").each(function flattenNode() {
-      const el = $(this);
-      const node = el[0];
-      if (!node) {
-        return;
-      }
-      const tag = (node.tagName || "").toLowerCase();
-      if (ROOT_TAGS.has(tag) || isBoundaryTag(tag)) {
-        return;
-      }
-      if (isPreservedImageElement($, el)) {
-        return;
-      }
-      if (tag === "a") {
-        el.children().each(function flattenAnchorChild() {
-          flatten($(this));
-        });
-        return;
-      }
-      const hasText = hasDirectText($, el);
-      if (hasText) {
-        return;
-      }
-      if (el.children().length === 0) {
-        el.remove();
-        return;
-      }
-      el.children().each(function flattenChild() {
-        flatten($(this));
-      });
-      el.replaceWith(el.contents());
+function formatSrcsetCandidate(candidate, headMax, tailMax) {
+  const url = truncateValueInMiddle(candidate.url, headMax, tailMax);
+  return candidate.descriptorText ? `${url} ${candidate.descriptorText}` : url;
+}
+function parseSrcsetCandidates2(raw) {
+  const text = raw.trim();
+  if (!text) {
+    return [];
+  }
+  const out = [];
+  let index = 0;
+  while (index < text.length) {
+    index = skipSrcsetSeparators(text, index);
+    if (index >= text.length) {
+      break;
+    }
+    const urlToken = readSrcsetUrlToken(text, index);
+    index = urlToken.nextIndex;
+    const url = urlToken.value.trim();
+    if (!url) {
+      continue;
+    }
+    index = skipSrcsetWhitespace(text, index);
+    const descriptors = [];
+    while (index < text.length && text[index] !== ",") {
+      const descriptorToken = readSrcsetDescriptorToken(text, index);
+      if (!descriptorToken.value) {
+        index = descriptorToken.nextIndex;
+        continue;
+      }
+      descriptors.push(descriptorToken.value);
+      index = descriptorToken.nextIndex;
+      index = skipSrcsetWhitespace(text, index);
+    }
+    if (index < text.length && text[index] === ",") {
+      index += 1;
+    }
+    let width = null;
+    let density = null;
+    for (const descriptor of descriptors) {
+      const token = descriptor.trim().toLowerCase();
+      if (!token) {
+        continue;
+      }
+      const widthMatch = token.match(/^(\d+)w$/);
+      if (widthMatch) {
+        const parsed = Number.parseInt(widthMatch[1], 10);
+        if (Number.isFinite(parsed)) {
+          width = parsed;
+        }
+        continue;
+      }
+      const densityMatch = token.match(/^(\d*\.?\d+)x$/);
+      if (densityMatch) {
+        const parsed = Number.parseFloat(densityMatch[1]);
+        if (Number.isFinite(parsed)) {
+          density = parsed;
+        }
+      }
+    }
+    out.push({
+      url,
+      descriptorText: descriptors.join(" "),
+      width,
+      density
     });
+  }
+  return out;
+}
+function skipSrcsetWhitespace(value, index) {
+  let cursor = index;
+  while (cursor < value.length && /\s/u.test(value[cursor])) {
+    cursor += 1;
+  }
+  return cursor;
+}
+function skipSrcsetSeparators(value, index) {
+  let cursor = skipSrcsetWhitespace(value, index);
+  while (cursor < value.length && value[cursor] === ",") {
+    cursor += 1;
+    cursor = skipSrcsetWhitespace(value, cursor);
+  }
+  return cursor;
+}
+function readSrcsetUrlToken(value, index) {
+  let cursor = index;
+  let out = "";
+  const isDataUrl = value.slice(index, index + 5).toLowerCase().startsWith("data:");
+  while (cursor < value.length) {
+    const char = value[cursor];
+    if (/\s/u.test(char)) {
+      break;
+    }
+    if (char === "," && !isDataUrl) {
+      break;
+    }
+    out += char;
+    cursor += 1;
+  }
+  if (isDataUrl && out.endsWith(",") && cursor < value.length) {
+    out = out.slice(0, -1);
+  }
+  return {
+    value: out,
+    nextIndex: cursor
+  };
+}
+function readSrcsetDescriptorToken(value, index) {
+  let cursor = skipSrcsetWhitespace(value, index);
+  let out = "";
+  while (cursor < value.length) {
+    const char = value[cursor];
+    if (char === "," || /\s/u.test(char)) {
+      break;
+    }
+    out += char;
+    cursor += 1;
+  }
+  return {
+    value: out.trim(),
+    nextIndex: cursor
+  };
+}
+function removeNoise($) {
+  for (const tag of STRIP_TAGS) {
+    $(tag).remove();
+  }
+  $(NOISE_SELECTORS.join(", ")).remove();
+}
+function removeComments($) {
+  $("*").contents().each(function removeComment() {
+    if (this.type === "comment") {
+      $(this).remove();
+    }
+  });
+}
+function markInlineSelfHiddenFallback($) {
+  $(
+    "[style*='visibility: hidden'], [style*='visibility:hidden'], [style*='visibility: collapse'], [style*='visibility:collapse']"
+  ).each(function markInlineVisibilityHidden() {
+    const el = $(this);
+    if (el.attr(OPENSTEER_HIDDEN_ATTR) === void 0) {
+      el.attr(OPENSTEER_SELF_HIDDEN_ATTR, "1");
+    }
+  });
+}
+function pruneSelfHiddenNodes($) {
+  for (const node of getElementsInReverseDocumentOrder($)) {
+    if (node.attribs?.[OPENSTEER_SELF_HIDDEN_ATTR] === void 0) {
+      continue;
+    }
+    const el = $(node);
+    el.contents().each(function removeSelfHiddenText() {
+      if (this.type === "text") {
+        $(this).remove();
+      }
+    });
+    if (!hasElementChildren(node)) {
+      el.remove();
+    }
+  }
+}
+function getChildNodes(node) {
+  return node?.children ?? [];
+}
+function isElementLikeNode(node) {
+  return node?.type === "tag" || node?.type === "script" || node?.type === "style";
+}
+function hasDirectText(node) {
+  if (!node) {
+    return false;
+  }
+  for (const child of getChildNodes(node)) {
+    if (child.type === "text" && (child.data || "").trim() !== "") {
+      return true;
+    }
+  }
+  return false;
+}
+function hasElementChildren(node) {
+  if (!node) {
+    return false;
+  }
+  for (const child of getChildNodes(node)) {
+    if (isElementLikeNode(child)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasTextDeepNode(node) {
+  if (!node) {
+    return false;
+  }
+  if (node.type === "text") {
+    return (node.data || "").trim() !== "";
+  }
+  for (const child of getChildNodes(node)) {
+    if (hasTextDeepNode(child)) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasActionLabel(attrs) {
+  return typeof attrs["aria-label"] === "string" && attrs["aria-label"].trim() !== "" || typeof attrs["aria-labelledby"] === "string" && attrs["aria-labelledby"].trim() !== "" || typeof attrs["aria-describedby"] === "string" && attrs["aria-describedby"].trim() !== "" || typeof attrs.title === "string" && attrs.title.trim() !== "" || typeof attrs.placeholder === "string" && attrs.placeholder.trim() !== "" || typeof attrs.value === "string" && attrs.value.trim() !== "";
+}
+function unwrapActionNode($, el) {
+  if (hasTextDeepNode(el[0])) {
+    if (el.prev().length > 0) {
+      el.before(" ");
+    }
+    if (el.next().length > 0) {
+      el.after(" ");
+    }
+  }
+  el.replaceWith(el.contents());
+}
+function stripToAttrs(el, keep) {
+  const attrs = el.attr() || {};
+  for (const attr of Object.keys(attrs)) {
+    if (!keep.has(attr)) {
+      el.removeAttr(attr);
+      continue;
+    }
+    const value = el.attr(attr);
+    if (typeof value !== "string") {
+      continue;
+    }
+    if (shouldBoundAttr(attr)) {
+      setBoundedAttr(el, attr, value);
+    }
+  }
+}
+function restoreBoundedAttr(el, attr, value) {
+  if (typeof value !== "string") {
+    return;
+  }
+  const trimmed = value.trim();
+  if (trimmed === "") {
+    return;
+  }
+  setBoundedAttr(el, attr, value);
+}
+function deduplicateImages(html) {
+  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;
+    }
+    if (!src) {
+      return full;
+    }
+    if (seen.has(src)) {
+      return "";
+    }
+    seen.add(src);
+    return full;
+  });
+}
+function hasAttribute2(node, attr) {
+  return node?.attribs?.[attr] !== void 0;
+}
+function hasPictureAncestor(node) {
+  let current = node?.parent;
+  while (current) {
+    if (isElementLikeNode(current) && (current.tagName || "").toLowerCase() === "picture") {
+      return true;
+    }
+    current = current.parent;
+  }
+  return false;
+}
+function pictureHasPreservedDescendant(node) {
+  if (!node) {
+    return false;
+  }
+  for (const child of getChildNodes(node)) {
+    if (!isElementLikeNode(child)) {
+      continue;
+    }
+    const tag = (child.tagName || "").toLowerCase();
+    if (tag === "img") {
+      return true;
+    }
+    if (tag === "source" && typeof child.attribs?.src === "string" && child.attribs.src.trim() !== "") {
+      return true;
+    }
+    if (tag === "source" && typeof child.attribs?.srcset === "string" && child.attribs.srcset.trim() !== "") {
+      return true;
+    }
+    if (pictureHasPreservedDescendant(child)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isPreservedImageElement(node) {
+  const tag = (node?.tagName || "").toLowerCase();
+  if (tag === "img") {
+    return true;
+  }
+  if (tag === "picture") {
+    return pictureHasPreservedDescendant(node);
+  }
+  if (tag === "source") {
+    const inPicture = hasPictureAncestor(node);
+    const hasSrc = typeof node?.attribs?.src === "string" && node.attribs.src.trim() !== "" || typeof node?.attribs?.srcset === "string" && node.attribs.srcset.trim() !== "";
+    return inPicture && hasSrc;
+  }
+  return false;
+}
+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);
+    const tag = (node.tagName || "").toLowerCase();
+    if (ROOT_TAGS.has(tag) || isBoundaryTag(tag) || isPreservedImageElement(node)) {
+      continue;
+    }
+    if (tag === "a" || hasDirectText(node)) {
+      continue;
+    }
+    if (!hasElementChildren(node)) {
+      el.remove();
+      continue;
+    }
+    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"));
+}
+function isIndicatorPictureSource(node) {
+  return (node?.tagName || "").toLowerCase() === "source" && hasPictureAncestor(node) && (hasAttribute2(node, "src") || hasAttribute2(node, "srcset"));
+}
+function isSemanticIndicator(node) {
+  const tag = (node?.tagName || "").toLowerCase();
+  if (tag === "svg") {
+    return true;
+  }
+  return hasAttribute2(node, "aria-label") || hasAttribute2(node, "title") || hasAttribute2(node, "data-icon") || node?.attribs?.role === "img";
+}
+function findIndicatorDescendant(root) {
+  if (!root) {
+    return void 0;
+  }
+  let firstImage;
+  let firstSource;
+  let firstSemantic;
+  const visit = (node) => {
+    if (!isElementLikeNode(node)) {
+      return false;
+    }
+    if (isIndicatorImage(node)) {
+      firstImage = node;
+      return true;
+    }
+    if (firstSource === void 0 && isIndicatorPictureSource(node)) {
+      firstSource = node;
+    }
+    if (firstSemantic === void 0 && isSemanticIndicator(node)) {
+      firstSemantic = node;
+    }
+    for (const child of getChildNodes(node)) {
+      if (visit(child)) {
+        return true;
+      }
+    }
+    return false;
   };
-  flatten($.root());
+  for (const child of getChildNodes(root)) {
+    if (visit(child)) {
+      return firstImage;
+    }
+  }
+  return firstImage ?? firstSource ?? firstSemantic;
 }
 function serializeForExtraction($, root) {
   const lines = [];
@@ -17049,7 +17564,7 @@ function serializeForExtraction($, root) {
     lines.push(`${"  ".repeat(depth)}</${tagName}>`);
   }
   traverse(root, 0);
-  return lines.join("\n");
+  return lines.map((l) => l.trim()).filter((l) => l.length > 0).join("");
 }
 function isClickable($, el, context) {
   if (context.hasPreMarked) {
@@ -17141,7 +17656,11 @@ function cleanForExtraction(html) {
     }
   });
   flattenExtractionTree($clean);
-  return deduplicateImages(serializeForExtraction($clean, $clean.root()[0]));
+  const root = $clean.root()[0];
+  if (root === void 0) {
+    return "";
+  }
+  return deduplicateImages(serializeForExtraction($clean, root));
 }
 function cleanForAction(html) {
   if (!html.trim()) {
@@ -17167,22 +17686,12 @@ function cleanForAction(html) {
   $(`[${clickableMark}]`).each(function markIndicators() {
     const el = $(this);
     const wrapperAttrs = el.attr() || {};
-    if (hasTextDeep(el) || hasActionLabel(wrapperAttrs)) {
+    if (hasTextDeepNode(el[0]) || hasActionLabel(wrapperAttrs)) {
       return;
     }
-    const imageIndicator = el.find("img[alt], img[src], img[srcset]").first();
-    if (imageIndicator.length) {
-      imageIndicator.attr(indicatorMark, "1");
-      return;
-    }
-    const pictureSourceIndicator = el.find("picture source[src], picture source[srcset]").first();
-    if (pictureSourceIndicator.length) {
-      pictureSourceIndicator.attr(indicatorMark, "1");
-      return;
-    }
-    const semanticIndicator = el.find('[aria-label], [title], [data-icon], [role="img"], svg').first();
-    if (semanticIndicator.length) {
-      semanticIndicator.attr(indicatorMark, "1");
+    const indicatorNode = findIndicatorDescendant(el[0]);
+    if (indicatorNode !== void 0) {
+      $(indicatorNode).attr(indicatorMark, "1");
     }
   });
   $(`[${clickableMark}]`).each(function removeEmptyClickable() {
@@ -17192,7 +17701,7 @@ function cleanForAction(html) {
     if (NATIVE_INTERACTIVE_TAGS.has(tag) || tag === "a") {
       return;
     }
-    if (el.children().length > 0 || hasDirectText($, el)) {
+    if (hasElementChildren(node) || hasDirectText(node)) {
       return;
     }
     const wrapperAttrs = el.attr() || {};
@@ -17215,49 +17724,34 @@ function cleanForAction(html) {
       if (!isBoundaryTag(tag)) {
         ancestor.attr(branchMark, "1");
       }
-      current = ancestor.parent();
-    }
-  });
-  let changed = true;
-  while (changed) {
-    changed = false;
-    const nodes = [];
-    $("*").each(function collectNodes() {
-      nodes.push($(this));
-    });
-    nodes.sort((left, right) => right.parents().length - left.parents().length);
-    for (const el of nodes) {
-      const node = el[0];
-      if (!node) {
-        continue;
-      }
-      const tag = (node.tagName || "").toLowerCase();
-      if (ROOT_TAGS.has(tag) || isBoundaryTag(tag)) {
-        continue;
-      }
-      if (el.attr(clickableMark) !== void 0 || el.attr(indicatorMark) !== void 0) {
-        continue;
-      }
-      const insideClickable = el.parents(`[${clickableMark}]`).length > 0;
-      const preserveBranch = el.attr(branchMark) !== void 0;
-      const hasContent = el.children().length > 0 || hasDirectText($, el);
-      if (insideClickable || preserveBranch) {
-        if (!hasContent) {
-          el.remove();
-        } else {
-          unwrapActionNode($, el);
-        }
-        changed = true;
-        continue;
-      }
+      current = ancestor.parent();
+    }
+  });
+  for (const node of getElementsByDepthDescending($)) {
+    const el = $(node);
+    const tag = (node.tagName || "").toLowerCase();
+    if (ROOT_TAGS.has(tag) || isBoundaryTag(tag)) {
+      continue;
+    }
+    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();
-        changed = true;
-        continue;
+      } else {
+        unwrapActionNode($, el);
       }
-      unwrapActionNode($, el);
-      changed = true;
+      continue;
+    }
+    if (!hasContent) {
+      el.remove();
+      continue;
     }
+    unwrapActionNode($, el);
   }
   $.root().find("*").contents().each(function normalizeActionTextNodes() {
     if (this.type !== "text") {
@@ -17337,21 +17831,7 @@ function cleanForAction(html) {
       OPENSTEER_SPARSE_COUNTER_ATTR
     ]);
     if (clickable) {
-      for (const attr of [
-        "href",
-        "role",
-        "type",
-        "title",
-        "placeholder",
-        "value",
-        "aria-label",
-        "aria-labelledby",
-        "aria-describedby",
-        "aria-expanded",
-        "aria-pressed",
-        "aria-selected",
-        "aria-haspopup"
-      ]) {
+      for (const attr of ["href", "role", "type", "title", "placeholder", "value", "aria-label"]) {
         keep.add(attr);
       }
     }
@@ -17971,9 +18451,9 @@ function renderNode(snapshot, node, nodesById, snapshotsByDocumentRef, snapshotI
   const snapshotAttributes = normalizeNodeAttributes(node.attributes);
   const authoredAttributes = stripInternalSnapshotAttributes(snapshotAttributes);
   const attributes = [...authoredAttributes];
-  const subtreeHidden = hasAttribute2(snapshotAttributes, OPENSTEER_HIDDEN_ATTR) || isLikelySubtreeHidden(node);
-  const selfHidden = !subtreeHidden && (hasAttribute2(snapshotAttributes, OPENSTEER_SELF_HIDDEN_ATTR) || isLikelySelfHidden(node, nodesById));
-  const interactive = !subtreeHidden && !selfHidden && (hasAttribute2(snapshotAttributes, OPENSTEER_INTERACTIVE_ATTR) || isLikelyInteractive(tagName, node, 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));
   if (interactive) {
     attributes.push({ name: OPENSTEER_INTERACTIVE_ATTR, value: "1" });
   }
@@ -18291,7 +18771,7 @@ function parseOpacity(value) {
   const parsed = Number.parseFloat(value);
   return Number.isFinite(parsed) ? parsed : Number.NaN;
 }
-function hasAttribute2(attributes, name) {
+function hasAttribute3(attributes, name) {
   const normalizedName = name.toLowerCase();
   return attributes.some((attribute) => attribute.name.toLowerCase() === normalizedName);
 }
@@ -20252,12 +20732,12 @@ var OpensteerSessionRuntime = class {
         async (timeout) => {
           let descriptor2;
           let data;
-          if (input.schema !== void 0) {
-            assertValidOpensteerExtractionSchemaRoot(input.schema);
+          if (input.template !== void 0) {
+            assertValidOpensteerExtractionTemplateRoot(input.template);
             const fieldTargets = await timeout.runStep(
               () => compileOpensteerExtractionFieldTargets({
                 pageRef,
-                schema: input.schema,
+                template: input.template,
                 dom: this.requireDom()
               })
             );
@@ -20289,7 +20769,7 @@ var OpensteerSessionRuntime = class {
                 () => descriptors.write({
                   persist,
                   root: payload,
-                  schemaHash: canonicalJsonString(input.schema),
+                  templateHash: canonicalJsonString(input.template),
                   sourceUrl: pageInfo.url
                 })
               );
@@ -20349,7 +20829,7 @@ var OpensteerSessionRuntime = class {
         artifacts,
         data: {
           ...input.persist === void 0 ? {} : { persist: input.persist },
-          ...descriptor?.payload.schemaHash === void 0 ? {} : { schemaHash: descriptor.payload.schemaHash },
+          ...descriptor?.payload.templateHash === void 0 ? {} : { templateHash: descriptor.payload.templateHash },
           data: output.data
         },
         context: buildRuntimeTraceContext({
@@ -24486,7 +24966,7 @@ function toOpensteerResolvedTarget2(target) {
   };
 }
 function normalizeOpensteerError(error) {
-  return normalizeThrownOpensteerError(error, "Unknown Opensteer runtime failure");
+  return normalizeThrownOpensteerError2(error, "Unknown Opensteer runtime failure");
 }
 function observationArtifactKindFromManifest(kind) {
   switch (kind) {
@@ -24659,142 +25139,6 @@ function screenshotMediaType(format2) {
       return "image/webp";
   }
 }
-
-// ../runtime-core/src/sdk/semantic-dispatch.ts
-async function dispatchSemanticOperation(runtime, operation, input, options = {}) {
-  switch (operation) {
-    case "session.open":
-      return runtime.open(input, options);
-    case "page.list":
-      return runtime.listPages(
-        input,
-        options
-      );
-    case "page.new":
-      return runtime.newPage(input, options);
-    case "page.activate":
-      return runtime.activatePage(
-        input,
-        options
-      );
-    case "page.close":
-      return runtime.closePage(
-        input,
-        options
-      );
-    case "page.goto":
-      return runtime.goto(input, options);
-    case "page.evaluate":
-      return runtime.evaluate(
-        input,
-        options
-      );
-    case "page.add-init-script":
-      return runtime.addInitScript(
-        input,
-        options
-      );
-    case "page.snapshot":
-      return runtime.snapshot(
-        input,
-        options
-      );
-    case "dom.click":
-      return runtime.click(input, options);
-    case "dom.hover":
-      return runtime.hover(input, options);
-    case "dom.input":
-      return runtime.input(input, options);
-    case "dom.scroll":
-      return runtime.scroll(input, options);
-    case "dom.extract":
-      return runtime.extract(input, options);
-    case "network.query":
-      return runtime.queryNetwork(
-        input,
-        options
-      );
-    case "network.detail":
-      return runtime.getNetworkDetail(
-        input,
-        options
-      );
-    case "interaction.capture":
-      return runtime.captureInteraction(
-        input,
-        options
-      );
-    case "interaction.get":
-      return runtime.getInteraction(
-        input,
-        options
-      );
-    case "interaction.diff":
-      return runtime.diffInteraction(
-        input,
-        options
-      );
-    case "interaction.replay":
-      return runtime.replayInteraction(
-        input,
-        options
-      );
-    case "artifact.read":
-      return runtime.readArtifact(
-        input,
-        options
-      );
-    case "session.cookies":
-      return runtime.getCookies(
-        input,
-        options
-      );
-    case "session.storage":
-      return runtime.getStorageSnapshot(
-        input,
-        options
-      );
-    case "session.state":
-      return runtime.getBrowserState(
-        input,
-        options
-      );
-    case "session.fetch":
-      return runtime.fetch(input, options);
-    case "scripts.capture":
-      return runtime.captureScripts(
-        input,
-        options
-      );
-    case "scripts.beautify":
-      return runtime.beautifyScript(
-        input,
-        options
-      );
-    case "scripts.deobfuscate":
-      return runtime.deobfuscateScript(
-        input,
-        options
-      );
-    case "scripts.sandbox":
-      return runtime.sandboxScript(
-        input,
-        options
-      );
-    case "captcha.solve":
-      return runtime.solveCaptcha(
-        input,
-        options
-      );
-    case "computer.execute":
-      return runtime.computerExecute(
-        input,
-        options
-      );
-    case "session.close":
-      return runtime.close(options);
-  }
-}
 var OpensteerSemanticRestError = class extends Error {
   opensteerError;
   statusCode;
@@ -25322,6 +25666,7 @@ function payloadByteLength(value) {
 
 // src/cloud/session-proxy.ts
 var TEMPORARY_CLOUD_WORKSPACE_PREFIX = "opensteer-cloud-workspace-";
+var CLOUD_SESSION_REUSE_EXPIRY_SKEW_MS = 1e4;
 var CloudSessionProxy = class {
   rootPath;
   workspace;
@@ -25335,6 +25680,8 @@ var CloudSessionProxy = class {
   automation;
   workspaceStore;
   syncWorkspaceOnClose = false;
+  liveSessionStateEstablished = false;
+  storedInstrumentation = [];
   constructor(cloud, options = {}) {
     this.cloud = cloud;
     this.workspace = options.workspace;
@@ -25364,15 +25711,12 @@ var CloudSessionProxy = class {
     if (this.client === void 0 && this.sessionId === void 0 && persisted !== void 0 && await this.isReusableCloudSession(persisted.sessionId)) {
       this.bindClient(persisted);
     }
-    if (this.automation) {
-      try {
-        const sessionInfo = await this.automation.getSessionInfo();
-        return {
-          ...sessionInfo,
-          ...this.workspace === void 0 ? {} : { workspace: this.workspace }
-        };
-      } catch {
-      }
+    const sessionInfo = this.automation ? await this.automation.getSessionInfo().catch(() => void 0) : void 0;
+    if (sessionInfo !== void 0) {
+      return {
+        ...sessionInfo,
+        ...this.workspace === void 0 ? {} : { workspace: this.workspace }
+      };
     }
     return {
       provider: {
@@ -25484,12 +25828,26 @@ var CloudSessionProxy = class {
     return this.invokeSemanticOperation("session.cookies", input);
   }
   async route(input) {
-    await this.ensureSession();
-    return this.requireAutomation().route(input);
+    const registration = await this.invokeBootstrapInstrumentationOperation(
+      "instrumentation.route",
+      (automation) => automation.route(input)
+    );
+    this.storedInstrumentation.push({
+      kind: "route",
+      input
+    });
+    return registration;
   }
   async interceptScript(input) {
-    await this.ensureSession();
-    return this.requireAutomation().interceptScript(input);
+    const registration = await this.invokeBootstrapInstrumentationOperation(
+      "instrumentation.intercept-script",
+      (automation) => automation.interceptScript(input)
+    );
+    this.storedInstrumentation.push({
+      kind: "intercept-script",
+      input
+    });
+    return registration;
   }
   async getStorageSnapshot(input = {}) {
     return this.invokeSemanticOperation("session.storage", input);
@@ -25537,6 +25895,8 @@ var CloudSessionProxy = class {
       this.client = void 0;
       this.sessionId = void 0;
       this.semanticGrant = void 0;
+      this.liveSessionStateEstablished = false;
+      this.storedInstrumentation.length = 0;
       if (this.cleanupRootOnClose) {
         await promises.rm(this.rootPath, { recursive: true, force: true }).catch(() => void 0);
       }
@@ -25564,6 +25924,8 @@ var CloudSessionProxy = class {
     this.automation = void 0;
     this.sessionId = void 0;
     this.semanticGrant = void 0;
+    this.liveSessionStateEstablished = false;
+    this.storedInstrumentation.length = 0;
     if (syncError !== void 0) {
       throw syncError;
     }
@@ -25611,6 +25973,7 @@ var CloudSessionProxy = class {
     };
     await this.writePersistedSession(record);
     this.bindClient(record, session.initialGrants?.semantic);
+    await this.restoreStoredInstrumentation();
   }
   async syncWorkspaceToCloud() {
     if (this.workspace === void 0) {
@@ -25622,6 +25985,7 @@ var CloudSessionProxy = class {
   bindClient(record, initialSemanticGrant) {
     this.sessionId = record.sessionId;
     this.semanticGrant = initialSemanticGrant?.kind === "semantic" ? initialSemanticGrant : void 0;
+    this.liveSessionStateEstablished = false;
     this.client = new OpensteerSemanticRestClient({
       getBaseUrl: async () => (await this.ensureSemanticGrant()).url,
       getAuthorizationHeader: async () => `Bearer ${(await this.ensureSemanticGrant()).token}`,
@@ -25629,6 +25993,19 @@ var CloudSessionProxy = class {
     });
     this.automation = new OpensteerCloudAutomationClient(this.cloud, record.sessionId);
   }
+  async restoreStoredInstrumentation() {
+    if (this.storedInstrumentation.length === 0) {
+      return;
+    }
+    const automation = this.requireAutomation();
+    for (const registration of this.storedInstrumentation) {
+      if (registration.kind === "route") {
+        await automation.route(registration.input);
+      } else {
+        await automation.interceptScript(registration.input);
+      }
+    }
+  }
   async ensureWorkspaceStore() {
     if (this.workspaceStore !== void 0) {
       return this.workspaceStore;
@@ -25651,13 +26028,22 @@ var CloudSessionProxy = class {
   async clearPersistedSession() {
     await clearPersistedSessionRecord(this.rootPath, "cloud").catch(() => void 0);
   }
+  async invalidateSession() {
+    await this.automation?.close().catch(() => void 0);
+    this.automation = void 0;
+    this.client = void 0;
+    this.sessionId = void 0;
+    this.semanticGrant = void 0;
+    this.liveSessionStateEstablished = false;
+    await this.clearPersistedSession();
+  }
   async isReusableCloudSession(sessionId, timeout) {
     try {
       const session = await this.cloud.getSession(sessionId, {
         signal: timeout?.signal,
         timeoutMs: timeout?.remainingMs()
       });
-      return session.status !== "closed" && session.status !== "failed";
+      return isReusableCloudSessionState(session);
     } catch (error) {
       if (isMissingCloudSessionError(error)) {
         return false;
@@ -25706,26 +26092,79 @@ var CloudSessionProxy = class {
     try {
       await this.ensureSemanticGrant(true);
       return true;
-    } catch {
+    } catch (refreshError) {
+      if (await this.resetStaleSession(refreshError)) {
+        throw refreshError;
+      }
       return false;
     }
   }
   async invokeSemanticOperation(operation, input, sessionInit = {}) {
-    return this.runOperationWithPolicy(operation, async (timeout) => {
+    return this.runOperationWithSessionRecovery(operation, async (timeout) => {
       await this.ensureSession(sessionInit, timeout);
       await this.ensureSemanticGrant(false, timeout);
-      return this.requireClient().invoke(operation, input, {
+      const output = await this.requireClient().invoke(operation, input, {
         signal: timeout.signal,
         timeoutMs: timeout.remainingMs()
       });
+      this.noteSuccessfulLiveOperation(operation);
+      return output;
     });
   }
   async invokeAutomationOperation(operation, invoke, sessionInit = {}) {
-    return this.runOperationWithPolicy(operation, async (timeout) => {
+    return this.runOperationWithSessionRecovery(operation, async (timeout) => {
       await this.ensureSession(sessionInit, timeout);
-      return invoke(this.requireAutomation());
+      const output = await invoke(this.requireAutomation());
+      this.noteSuccessfulLiveOperation(operation);
+      return output;
+    });
+  }
+  async invokeBootstrapInstrumentationOperation(operation, invoke) {
+    let recovered = false;
+    while (true) {
+      try {
+        await this.ensureSession();
+        return await invoke(this.requireAutomation());
+      } catch (error) {
+        const stale = await this.resetStaleSession(error);
+        if (!stale || recovered || !this.canRecoverWithFreshSession(operation)) {
+          throw error;
+        }
+        recovered = true;
+      }
+    }
+  }
+  async runOperationWithSessionRecovery(operation, invoke) {
+    return this.runOperationWithPolicy(operation, async (timeout) => {
+      let recovered = false;
+      while (true) {
+        try {
+          return await invoke(timeout);
+        } catch (error) {
+          const stale = await this.resetStaleSession(error);
+          if (!stale || recovered || !this.canRecoverWithFreshSession(operation)) {
+            throw error;
+          }
+          recovered = true;
+        }
+      }
     });
   }
+  async resetStaleSession(error) {
+    if (!isRecoverableCloudSessionError(error)) {
+      return false;
+    }
+    await this.invalidateSession();
+    return true;
+  }
+  canRecoverWithFreshSession(operation) {
+    return !this.liveSessionStateEstablished && isBootstrapRecoveryOperation(operation);
+  }
+  noteSuccessfulLiveOperation(operation) {
+    if (operation === "session.open" || operation === "page.list" || operation === "page.new" || operation === "page.activate" || operation === "page.close" || operation === "page.goto" || operation === "page.evaluate" || operation === "page.add-init-script" || operation === "page.snapshot" || operation === "dom.click" || operation === "dom.hover" || operation === "dom.input" || operation === "dom.scroll" || operation === "dom.extract" || operation === "network.query" || operation === "network.detail" || operation === "interaction.capture" || operation === "interaction.get" || operation === "interaction.diff" || operation === "interaction.replay" || operation === "scripts.capture" || operation === "artifact.read" || operation === "scripts.beautify" || operation === "scripts.deobfuscate" || operation === "scripts.sandbox" || operation === "captcha.solve" || operation === "session.cookies" || operation === "session.storage" || operation === "session.state" || operation === "session.fetch" || operation === "computer.execute") {
+      this.liveSessionStateEstablished = true;
+    }
+  }
   async runOperationWithPolicy(operation, invoke) {
     return runWithPolicyTimeout(this.policy.timeout, { operation }, invoke);
   }
@@ -25749,8 +26188,29 @@ function assertSupportedCloudBrowserMode(browser) {
   }
 }
 function isMissingCloudSessionError(error) {
+  if (error instanceof OpensteerCloudRequestError) {
+    return error.statusCode === 404 && (error.code === void 0 || error.code === "CLOUD_SESSION_NOT_FOUND");
+  }
   return error instanceof Error && /\b404\b/.test(error.message);
 }
+function isRecoverableCloudSessionError(error) {
+  if (!(error instanceof OpensteerCloudRequestError)) {
+    return false;
+  }
+  if (error.statusCode === 404) {
+    return error.code === void 0 || error.code === "CLOUD_SESSION_NOT_FOUND";
+  }
+  return error.statusCode === 409 && error.code === "CLOUD_SESSION_STALE";
+}
+function isBootstrapRecoveryOperation(operation) {
+  return operation === "session.open" || operation === "instrumentation.route" || operation === "instrumentation.intercept-script";
+}
+function isReusableCloudSessionState(session) {
+  if (session.status === "closing" || session.status === "closed" || session.status === "failed") {
+    return false;
+  }
+  return !(typeof session.expiresAt === "number" && session.expiresAt <= Date.now() + CLOUD_SESSION_REUSE_EXPIRY_SKEW_MS);
+}
 function isLoopbackBaseUrl(baseUrl) {
   let url;
   try {
@@ -25798,39 +26258,6 @@ var OpensteerRuntime = class extends OpensteerSessionRuntime {
     );
   }
 };
-var OpensteerSessionRuntime2 = class extends OpensteerSessionRuntime {
-  constructor(options) {
-    const rootPath = options.rootPath ?? path10__default.default.resolve(options.rootDir ?? process.cwd());
-    const cleanupRootOnClose = options.cleanupRootOnClose ?? false;
-    const engineName = options.engineName ?? DEFAULT_OPENSTEER_ENGINE;
-    assertSupportedEngineOptions({
-      engineName,
-      ...options.browser === void 0 ? {} : { browser: options.browser },
-      ...options.context === void 0 ? {} : { context: options.context }
-    });
-    super(
-      buildSharedRuntimeOptions({
-        name: options.name,
-        ...options.rootDir === void 0 ? {} : { rootDir: options.rootDir },
-        rootPath,
-        ...options.environment === void 0 ? {} : { environment: options.environment },
-        ...options.browser === void 0 ? {} : { browser: options.browser },
-        ...options.launch === void 0 ? {} : { launch: options.launch },
-        ...options.context === void 0 ? {} : { context: options.context },
-        engineName,
-        ...options.engine === void 0 ? {} : { engine: options.engine },
-        ...options.engineFactory === void 0 ? {} : { engineFactory: options.engineFactory },
-        ...options.policy === void 0 ? {} : { policy: options.policy },
-        ...options.descriptorStore === void 0 ? {} : { descriptorStore: options.descriptorStore },
-        ...options.extractionDescriptorStore === void 0 ? {} : { extractionDescriptorStore: options.extractionDescriptorStore },
-        cleanupRootOnClose,
-        ...options.observability === void 0 ? {} : { observability: options.observability },
-        ...options.observationSessionId === void 0 ? {} : { observationSessionId: options.observationSessionId },
-        ...options.observationSink === void 0 ? {} : { observationSink: options.observationSink }
-      })
-    );
-  }
-};
 function buildSharedRuntimeOptions(input) {
   const ownership = resolveOwnership(input.browser);
   const engineFactory = input.engineFactory ?? ((factoryOptions) => new OpensteerBrowserManager({
@@ -25945,6 +26372,25 @@ var SessionCookieJar = class {
     return this.cookies.map((cookie) => `${cookie.name}=${cookie.value}`).join("; ");
   }
 };
+function createSdkProtocolError(error, fallbackMessage) {
+  const normalized = normalizeThrownOpensteerError(error, fallbackMessage);
+  return new OpensteerProtocolError(normalized.code, normalized.message, {
+    cause: error,
+    retriable: normalized.retriable,
+    ...normalized.capability === void 0 ? {} : { capability: normalized.capability },
+    ...normalized.details === void 0 ? {} : { details: normalized.details }
+  });
+}
+async function wrapSdkError(operation, fn) {
+  try {
+    return await fn();
+  } catch (error) {
+    if (isOpensteerProtocolError(error)) {
+      throw error;
+    }
+    throw createSdkProtocolError(error, `${operation} failed`);
+  }
+}
 var Opensteer = class {
   runtime;
   browserManager;
@@ -25952,210 +26398,265 @@ var Opensteer = class {
   dom;
   network;
   constructor(options = {}) {
-    const environment = resolveOpensteerEnvironment(options.rootDir);
-    const { provider, engineName, ...runtimeOptions } = options;
-    const runtimeConfig = resolveOpensteerRuntimeConfig({
-      ...provider === void 0 ? {} : { provider },
-      environment
-    });
-    if (runtimeConfig.provider.mode === "cloud") {
-      this.browserManager = void 0;
-      this.runtime = createOpensteerSemanticRuntime({
-        ...provider === void 0 ? {} : { provider },
-        ...engineName === void 0 ? {} : { engine: engineName },
-        environment,
-        runtimeOptions
-      });
-      this.browser = createUnsupportedBrowserController();
-    } else {
-      this.browserManager = new OpensteerBrowserManager({
-        ...runtimeOptions.rootDir === void 0 ? {} : { rootDir: runtimeOptions.rootDir },
-        ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
-        ...runtimeOptions.workspace === void 0 ? {} : { workspace: runtimeOptions.workspace },
-        ...engineName === void 0 ? {} : { engineName },
-        environment,
-        ...runtimeOptions.browser === void 0 ? {} : { browser: runtimeOptions.browser },
-        ...runtimeOptions.launch === void 0 ? {} : { launch: runtimeOptions.launch },
-        ...runtimeOptions.context === void 0 ? {} : { context: runtimeOptions.context }
-      });
-      this.runtime = createOpensteerSemanticRuntime({
+    try {
+      const environment = resolveOpensteerEnvironment(options.rootDir);
+      const { provider, engineName, ...runtimeOptions } = options;
+      const runtimeConfig = resolveOpensteerRuntimeConfig({
         ...provider === void 0 ? {} : { provider },
-        ...engineName === void 0 ? {} : { engine: engineName },
-        environment,
-        runtimeOptions: {
-          ...runtimeOptions,
-          rootPath: this.browserManager.rootPath,
-          cleanupRootOnClose: this.browserManager.cleanupRootOnDisconnect
-        }
+        environment
       });
-      this.browser = {
-        status: () => this.browserManager.status(),
-        clone: (input) => this.browserManager.clonePersistentBrowser(input),
-        reset: () => this.browserManager.reset(),
-        delete: () => this.browserManager.delete()
+      if (runtimeConfig.provider.mode === "cloud") {
+        this.browserManager = void 0;
+        this.runtime = createOpensteerSemanticRuntime({
+          ...provider === void 0 ? {} : { provider },
+          ...engineName === void 0 ? {} : { engine: engineName },
+          environment,
+          runtimeOptions
+        });
+        this.browser = createUnsupportedBrowserController();
+      } else {
+        this.browserManager = new OpensteerBrowserManager({
+          ...runtimeOptions.rootDir === void 0 ? {} : { rootDir: runtimeOptions.rootDir },
+          ...runtimeOptions.rootPath === void 0 ? {} : { rootPath: runtimeOptions.rootPath },
+          ...runtimeOptions.workspace === void 0 ? {} : { workspace: runtimeOptions.workspace },
+          ...engineName === void 0 ? {} : { engineName },
+          environment,
+          ...runtimeOptions.browser === void 0 ? {} : { browser: runtimeOptions.browser },
+          ...runtimeOptions.launch === void 0 ? {} : { launch: runtimeOptions.launch },
+          ...runtimeOptions.context === void 0 ? {} : { context: runtimeOptions.context }
+        });
+        this.runtime = createOpensteerSemanticRuntime({
+          ...provider === void 0 ? {} : { provider },
+          ...engineName === void 0 ? {} : { engine: engineName },
+          environment,
+          runtimeOptions: {
+            ...runtimeOptions,
+            rootPath: this.browserManager.rootPath,
+            cleanupRootOnClose: this.browserManager.cleanupRootOnDisconnect
+          }
+        });
+        this.browser = {
+          status: () => wrapSdkError("browser.status", () => this.browserManager.status()),
+          clone: (input) => wrapSdkError("browser.clone", () => this.browserManager.clonePersistentBrowser(input)),
+          reset: () => wrapSdkError("browser.reset", () => this.browserManager.reset()),
+          delete: () => wrapSdkError("browser.delete", () => this.browserManager.delete())
+        };
+      }
+      this.dom = {
+        click: (input) => this.click(input),
+        hover: (input) => this.hover(input),
+        input: (input) => this.input(input),
+        scroll: (input) => this.scroll(input)
+      };
+      this.network = {
+        query: (input = {}) => wrapSdkError("network.query", () => this.runtime.queryNetwork(input)),
+        detail: (recordId, options2) => wrapSdkError(
+          "network.detail",
+          () => this.runtime.getNetworkDetail({ recordId, ...options2 })
+        )
       };
+    } catch (error) {
+      if (isOpensteerProtocolError(error)) {
+        throw error;
+      }
+      throw createSdkProtocolError(error, "Failed to initialize Opensteer");
     }
-    this.dom = {
-      click: (input) => this.click(input),
-      hover: (input) => this.hover(input),
-      input: (input) => this.input(input),
-      scroll: (input) => this.scroll(input)
-    };
-    this.network = {
-      query: (input = {}) => this.runtime.queryNetwork(input),
-      detail: (recordId, options2) => this.runtime.getNetworkDetail({ recordId, ...options2 })
-    };
   }
   async open(input = {}) {
-    return this.runtime.open(typeof input === "string" ? { url: input } : input);
+    return wrapSdkError(
+      "session.open",
+      () => this.runtime.open(typeof input === "string" ? { url: input } : input)
+    );
   }
   async info() {
-    return this.runtime.info();
+    return wrapSdkError("session.info", () => this.runtime.info());
   }
   async listPages(input = {}) {
-    return this.runtime.listPages(input);
+    return wrapSdkError("page.list", () => this.runtime.listPages(input));
   }
   async newPage(input = {}) {
-    return this.runtime.newPage(input);
+    return wrapSdkError("page.new", () => this.runtime.newPage(input));
   }
   async activatePage(input) {
-    return this.runtime.activatePage(input);
+    return wrapSdkError("page.activate", () => this.runtime.activatePage(input));
   }
   async closePage(input = {}) {
-    return this.runtime.closePage(input);
+    return wrapSdkError("page.close", () => this.runtime.closePage(input));
   }
   async goto(url, options = {}) {
-    return this.runtime.goto({
-      url,
-      ...options
-    });
+    return wrapSdkError(
+      "page.goto",
+      () => this.runtime.goto({
+        url,
+        ...options
+      })
+    );
   }
   async evaluate(input) {
-    const normalized = typeof input === "string" ? {
-      script: input
-    } : input;
-    return (await this.runtime.evaluate(normalized)).value;
+    return wrapSdkError("page.evaluate", async () => {
+      const normalized = typeof input === "string" ? {
+        script: input
+      } : input;
+      return (await this.runtime.evaluate(normalized)).value;
+    });
   }
   async addInitScript(input) {
-    return this.runtime.addInitScript(
-      typeof input === "string" ? {
-        script: input
-      } : input
+    return wrapSdkError(
+      "page.addInitScript",
+      () => this.runtime.addInitScript(
+        typeof input === "string" ? {
+          script: input
+        } : input
+      )
     );
   }
   async click(input) {
-    const { button, clickCount, modifiers, ...target } = input;
-    return this.runtime.click({
-      ...normalizeTargetOptions(target),
-      ...button === void 0 ? {} : { button },
-      ...clickCount === void 0 ? {} : { clickCount },
-      ...modifiers === void 0 ? {} : { modifiers }
+    return wrapSdkError("dom.click", () => {
+      const { button, clickCount, modifiers, ...target } = input;
+      return this.runtime.click({
+        ...normalizeTargetOptions(target),
+        ...button === void 0 ? {} : { button },
+        ...clickCount === void 0 ? {} : { clickCount },
+        ...modifiers === void 0 ? {} : { modifiers }
+      });
     });
   }
   async hover(input) {
-    return this.runtime.hover(normalizeTargetOptions(input));
+    return wrapSdkError("dom.hover", () => this.runtime.hover(normalizeTargetOptions(input)));
   }
   async input(input) {
-    return this.runtime.input({
-      ...normalizeTargetOptions(input),
-      text: input.text,
-      ...input.pressEnter === void 0 ? {} : { pressEnter: input.pressEnter }
-    });
+    return wrapSdkError(
+      "dom.input",
+      () => this.runtime.input({
+        ...normalizeTargetOptions(input),
+        text: input.text,
+        ...input.pressEnter === void 0 ? {} : { pressEnter: input.pressEnter }
+      })
+    );
   }
   async scroll(input) {
-    return this.runtime.scroll({
-      ...normalizeTargetOptions(input),
-      direction: input.direction,
-      amount: input.amount
-    });
+    return wrapSdkError(
+      "dom.scroll",
+      () => this.runtime.scroll({
+        ...normalizeTargetOptions(input),
+        direction: input.direction,
+        amount: input.amount
+      })
+    );
   }
   async extract(input) {
-    return (await this.runtime.extract(input)).data;
+    return wrapSdkError("extract", async () => (await this.runtime.extract(input)).data);
   }
   async waitForPage(input = {}) {
-    const baseline = new Set((await this.runtime.listPages()).pages.map((page) => page.pageRef));
-    const timeoutAt = Date.now() + (input.timeoutMs ?? 3e4);
-    const pollIntervalMs = input.pollIntervalMs ?? 100;
-    while (true) {
-      const match = (await this.runtime.listPages()).pages.find((page) => {
-        if (baseline.has(page.pageRef)) {
-          return false;
-        }
-        if (input.openerPageRef !== void 0 && page.openerPageRef !== input.openerPageRef) {
-          return false;
+    return wrapSdkError("page.waitForPage", async () => {
+      const baseline = new Set((await this.runtime.listPages()).pages.map((page) => page.pageRef));
+      const timeoutAt = Date.now() + (input.timeoutMs ?? 3e4);
+      const pollIntervalMs = input.pollIntervalMs ?? 100;
+      while (true) {
+        const match = (await this.runtime.listPages()).pages.find((page) => {
+          if (baseline.has(page.pageRef)) {
+            return false;
+          }
+          if (input.openerPageRef !== void 0 && page.openerPageRef !== input.openerPageRef) {
+            return false;
+          }
+          if (input.urlIncludes !== void 0 && !page.url.includes(input.urlIncludes)) {
+            return false;
+          }
+          return true;
+        });
+        if (match !== void 0) {
+          return match;
         }
-        if (input.urlIncludes !== void 0 && !page.url.includes(input.urlIncludes)) {
-          return false;
+        if (Date.now() >= timeoutAt) {
+          throw new OpensteerProtocolError("timeout", "waitForPage timed out");
         }
-        return true;
-      });
-      if (match !== void 0) {
-        return match;
+        await delay3(pollIntervalMs);
       }
-      if (Date.now() >= timeoutAt) {
-        throw new Error("waitForPage timed out");
-      }
-      await delay3(pollIntervalMs);
-    }
-  }
-  async snapshot(mode = "action") {
-    return (await this.runtime.snapshot({ mode })).html;
+    });
   }
   async cookies(domain) {
-    return new SessionCookieJar(
-      await this.runtime.getCookies(domain === void 0 ? {} : { domain })
+    return wrapSdkError(
+      "session.cookies",
+      async () => new SessionCookieJar(await this.runtime.getCookies(domain === void 0 ? {} : { domain }))
     );
   }
   async storage(domain, type = "local") {
-    const snapshot = await this.runtime.getStorageSnapshot(domain === void 0 ? {} : { domain });
-    const domainSnapshot = pickStorageDomainSnapshot(snapshot, domain);
-    if (domainSnapshot === void 0) {
-      return {};
-    }
-    const entries = type === "local" ? domainSnapshot.localStorage : domainSnapshot.sessionStorage;
-    return Object.fromEntries(entries.map((entry) => [entry.key, entry.value]));
+    return wrapSdkError("session.storage", async () => {
+      const snapshot = await this.runtime.getStorageSnapshot(
+        domain === void 0 ? {} : { domain }
+      );
+      const domainSnapshot = pickStorageDomainSnapshot(snapshot, domain);
+      if (domainSnapshot === void 0) {
+        return {};
+      }
+      const entries = type === "local" ? domainSnapshot.localStorage : domainSnapshot.sessionStorage;
+      return Object.fromEntries(entries.map((entry) => [entry.key, entry.value]));
+    });
   }
   async state(domain) {
-    return this.runtime.getBrowserState(domain === void 0 ? {} : { domain });
+    return wrapSdkError(
+      "session.state",
+      () => this.runtime.getBrowserState(domain === void 0 ? {} : { domain })
+    );
   }
   async fetch(url, options = {}) {
-    const input = buildFetchInput(url, options);
-    const result = await this.runtime.fetch(input);
-    if (result.response === void 0) {
-      throw new Error(result.note ?? `session.fetch did not produce a response for ${url}`);
-    }
-    return toResponse(result.response);
+    return wrapSdkError("session.fetch", async () => {
+      const input = buildFetchInput(url, options);
+      const result = await this.runtime.fetch(input);
+      if (result.response === void 0) {
+        throw new OpensteerProtocolError(
+          "operation-failed",
+          result.note ?? `session.fetch did not produce a response for ${url}`
+        );
+      }
+      return toResponse(result.response);
+    });
   }
   async computerExecute(input) {
-    return this.runtime.computerExecute(input);
+    return wrapSdkError("session.computerExecute", () => this.runtime.computerExecute(input));
   }
   async route(input) {
-    return this.requireOwnedInstrumentationRuntime("route").route(input);
+    return wrapSdkError(
+      "session.route",
+      () => this.requireOwnedInstrumentationRuntime("route").route(input)
+    );
   }
   async interceptScript(input) {
-    return this.requireOwnedInstrumentationRuntime("interceptScript").interceptScript(input);
+    return wrapSdkError(
+      "session.interceptScript",
+      () => this.requireOwnedInstrumentationRuntime("interceptScript").interceptScript(input)
+    );
   }
   async close() {
-    if (this.browserManager === void 0 || this.browserManager.mode === "temporary") {
-      return this.runtime.close();
-    }
-    const output = await this.runtime.close();
-    await this.browserManager.close();
-    return output;
+    return wrapSdkError("session.close", async () => {
+      if (this.browserManager === void 0 || this.browserManager.mode === "temporary") {
+        return this.runtime.close();
+      }
+      const output = await this.runtime.close();
+      await this.browserManager.close();
+      return output;
+    });
   }
   async disconnect() {
-    await this.runtime.disconnect();
+    return wrapSdkError("session.disconnect", () => this.runtime.disconnect());
   }
   requireOwnedInstrumentationRuntime(method) {
     if (typeof this.runtime.route === "function" && typeof this.runtime.interceptScript === "function") {
       return this.runtime;
     }
-    throw new Error(`${method}() is not available for this session runtime.`);
+    throw new OpensteerProtocolError(
+      "unsupported-operation",
+      `${method}() is not available for this session runtime.`
+    );
   }
 };
 function createUnsupportedBrowserController() {
   const fail = async () => {
-    throw new Error("browser.* helpers are only available in local mode.");
+    throw new OpensteerProtocolError(
+      "unsupported-operation",
+      "browser.* helpers are only available in local mode."
+    );
   };
   return {
     status: fail,
@@ -26168,7 +26669,10 @@ function normalizeTargetOptions(input) {
   const hasElement = input.element !== void 0;
   const hasSelector = input.selector !== void 0;
   if (hasElement && hasSelector) {
-    throw new Error("Specify exactly one of element, selector, or persist.");
+    throw new OpensteerProtocolError(
+      "invalid-argument",
+      "Specify exactly one of element, selector, or persist."
+    );
   }
   if (hasElement) {
     return {
@@ -26191,7 +26695,10 @@ function normalizeTargetOptions(input) {
     };
   }
   if (input.persist === void 0) {
-    throw new Error("Specify exactly one of element, selector, or persist.");
+    throw new OpensteerProtocolError(
+      "invalid-argument",
+      "Specify exactly one of element, selector, or persist."
+    );
   }
   return {
     target: {
@@ -26251,7 +26758,6 @@ function delay3(ms) {
   return new Promise((resolve4) => setTimeout(resolve4, ms));
 }
 
-exports.CloudSessionProxy = CloudSessionProxy;
 exports.DEFAULT_OPENSTEER_ENGINE = DEFAULT_OPENSTEER_ENGINE;
 exports.DEFERRED_MATCH_ATTR_KEYS = DEFERRED_MATCH_ATTR_KEYS;
 exports.ElementPathError = ElementPathError;
@@ -26264,8 +26770,7 @@ exports.Opensteer = Opensteer;
 exports.OpensteerAttachAmbiguousError = OpensteerAttachAmbiguousError;
 exports.OpensteerBrowserManager = OpensteerBrowserManager;
 exports.OpensteerCloudClient = OpensteerCloudClient;
-exports.OpensteerRuntime = OpensteerRuntime;
-exports.OpensteerSessionRuntime = OpensteerSessionRuntime2;
+exports.OpensteerProtocolError = OpensteerProtocolError;
 exports.STABLE_PRIMARY_ATTR_KEYS = STABLE_PRIMARY_ATTR_KEYS;
 exports.assertProviderSupportsEngine = assertProviderSupportsEngine;
 exports.buildArrayFieldPathCandidates = buildArrayFieldPathCandidates;
@@ -26285,7 +26790,6 @@ exports.createDomRuntime = createDomRuntime;
 exports.createFilesystemOpensteerWorkspace = createFilesystemOpensteerWorkspace;
 exports.createObservationStore = createObservationStore;
 exports.createOpensteerExtractionDescriptorStore = createOpensteerExtractionDescriptorStore;
-exports.createOpensteerSemanticRuntime = createOpensteerSemanticRuntime;
 exports.defaultFallbackPolicy = defaultFallbackPolicy;
 exports.defaultPolicy = defaultPolicy;
 exports.defaultRetryPolicy = defaultRetryPolicy;
@@ -26293,10 +26797,10 @@ exports.defaultSettlePolicy = defaultSettlePolicy;
 exports.defaultTimeoutPolicy = defaultTimeoutPolicy;
 exports.delayWithSignal = delayWithSignal;
 exports.discoverLocalCdpBrowsers = discoverLocalCdpBrowsers;
-exports.dispatchSemanticOperation = dispatchSemanticOperation;
 exports.hashDomDescriptorPersist = hashDomDescriptorPersist;
 exports.inspectCdpEndpoint = inspectCdpEndpoint;
 exports.isCurrentUrlField = isCurrentUrlField;
+exports.isOpensteerProtocolError = isOpensteerProtocolError;
 exports.isValidCssAttributeKey = isValidCssAttributeKey;
 exports.listLocalChromeProfiles = listLocalChromeProfiles;
 exports.manifestToExternalBinaryLocation = manifestToExternalBinaryLocation;
@@ -26305,6 +26809,7 @@ exports.normalizeObservabilityConfig = normalizeObservabilityConfig;
 exports.normalizeOpensteerEngineName = normalizeOpensteerEngineName;
 exports.normalizeOpensteerProviderMode = normalizeOpensteerProviderMode;
 exports.normalizeWorkspaceId = normalizeWorkspaceId;
+exports.opensteerErrorCodes = opensteerErrorCodes;
 exports.parseDomDescriptorRecord = parseDomDescriptorRecord;
 exports.parseExtractionDescriptorRecord = parseExtractionDescriptorRecord;
 exports.readPersistedCloudSessionRecord = readPersistedCloudSessionRecord;