opensteer 0.8.14 → 0.8.15

package/README.md

@@ -185,7 +185,7 @@ Use `snapshot("action")` or `snapshot("extraction")` during exploration. The sna
 - `hover({ element? | selector? | persist?, captureNetwork? })`
 - `input({ text, element? | selector? | persist?, captureNetwork? })`
 - `scroll({ direction, amount, element? | selector? | persist?, captureNetwork? })`
-- `extract({ persist, schema? })`
+- `extract({ schema } | { persist, schema? })`
 - `network.query(input?)`
 - `network.detail(recordId)`
 - `network.replay(recordId, overrides?)`

package/dist/{chunk-BRUJHMWO.js → chunk-DFQCK2U6.js}

@@ -6487,11 +6487,11 @@ var targetByElementSchema2 = objectSchema(
 var targetByPersistSchema2 = objectSchema(
   {
     kind: enumSchema(["persist"]),
-    name: stringSchema()
+    persist: stringSchema()
   },
   {
     title: "OpensteerTargetByPersist",
-    required: ["kind", "name"]
+    required: ["kind", "persist"]
   }
 );
 var targetBySelectorSchema2 = objectSchema(
@@ -6538,8 +6538,7 @@ var opensteerResolvedTargetSchema = objectSchema(
 var opensteerActionResultSchema = objectSchema(
   {
     target: opensteerResolvedTargetSchema,
-    point: pointSchema,
-    persisted: stringSchema()
+    point: pointSchema
   },
   {
     title: "OpensteerActionResult",
@@ -10547,8 +10546,8 @@ function createDomDescriptorStore(options) {
   }
   return new MemoryDomDescriptorStore(namespace);
 }
-function hashDomDescriptorName(name) {
-  return sha256Hex2(name.trim());
+function hashDomDescriptorPersist(persist) {
+  return sha256Hex2(persist.trim());
 }
 var DOM_DESCRIPTOR_METHOD_ALIASES = Object.freeze({
   click: "dom.click",
@@ -10562,14 +10561,14 @@ function normalizeDomDescriptorMethod(method) {
 }
 function buildDomDescriptorKeys(options) {
   const namespace = normalizeDomDescriptorNamespace(options.namespace);
-  const nameHash = hashDomDescriptorName(options.name);
+  const persistHash = hashDomDescriptorPersist(options.persist);
   const rawMethod = options.method.trim();
   const canonicalMethod = normalizeDomDescriptorMethod(rawMethod);
   const methods = /* @__PURE__ */ new Set([canonicalMethod]);
   if (rawMethod.length > 0) {
     methods.add(rawMethod);
   }
-  return [...methods].map((method) => `dom:${namespace}:${method}:${nameHash}`);
+  return [...methods].map((method) => `dom:${namespace}:${method}:${persistHash}`);
 }
 function buildDomDescriptorKey(options) {
   return buildDomDescriptorKeys(options)[0];
@@ -10585,7 +10584,7 @@ function buildDomDescriptorPayload(input) {
   return {
     kind: "dom-target",
     method: normalizeDomDescriptorMethod(input.method),
-    name: input.name,
+    persist: input.persist,
     path: sanitizeReplayElementPath(input.path),
     ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
   };
@@ -10602,8 +10601,7 @@ function parseDomDescriptorRecord(record) {
   if (raw.kind !== "dom-target") {
     return void 0;
   }
-  const name = typeof raw.name === "string" ? raw.name : typeof raw.description === "string" ? raw.description : void 0;
-  if (typeof raw.method !== "string" || name === void 0) {
+  if (typeof raw.method !== "string" || typeof raw.persist !== "string") {
     return void 0;
   }
   if (!raw.path || typeof raw.path !== "object" || Array.isArray(raw.path)) {
@@ -10615,7 +10613,7 @@ function parseDomDescriptorRecord(record) {
   const normalizedPayload = {
     kind: "dom-target",
     method: normalizeDomDescriptorMethod(raw.method),
-    name,
+    persist: raw.persist,
     path: sanitizeReplayElementPath(raw.path),
     ...typeof raw.sourceUrl === "string" ? { sourceUrl: raw.sourceUrl } : {}
   };
@@ -10637,7 +10635,7 @@ var FilesystemDomDescriptorStore = class {
     for (const key of buildDomDescriptorKeys({
       namespace: this.namespace,
       method: input.method,
-      name: input.name
+      persist: input.persist
     })) {
       const record = await this.registry.resolve({ key });
       if (!record) {
@@ -10652,7 +10650,7 @@ var FilesystemDomDescriptorStore = class {
     const key = buildDomDescriptorKey({
       namespace: this.namespace,
       method: input.method,
-      name: input.name
+      persist: input.persist
     });
     const version = buildDomDescriptorVersion(payload);
     const existing = await this.registry.resolve({ key, version });
@@ -10695,7 +10693,7 @@ var MemoryDomDescriptorStore = class {
     for (const key of buildDomDescriptorKeys({
       namespace: this.namespace,
       method: input.method,
-      name: input.name
+      persist: input.persist
     })) {
       const record = this.latestByKey.get(key);
       if (record) {
@@ -10709,7 +10707,7 @@ var MemoryDomDescriptorStore = class {
     const key = buildDomDescriptorKey({
       namespace: this.namespace,
       method: input.method,
-      name: input.name
+      persist: input.persist
     });
     const version = buildDomDescriptorVersion(payload);
     const existing = this.recordsByKey.get(key)?.get(version);
@@ -11676,15 +11674,15 @@ var DefaultDomRuntime = class {
   async resolveDescriptorTarget(session, pageRef, method, target) {
     const descriptor = await this.descriptors.read({
       method,
-      name: target.name
+      persist: target.persist
     });
     if (!descriptor) {
       throw new OpensteerProtocolError(
         "not-found",
-        `no stored DOM descriptor found for "${target.name}"`,
+        `no stored DOM descriptor found for "${target.persist}"`,
         {
           details: {
-            name: target.name,
+            persist: target.persist,
             kind: "dom-descriptor"
           }
         }
@@ -11698,7 +11696,7 @@ var DefaultDomRuntime = class {
       pageRef,
       descriptor.payload.path,
       "descriptor",
-      descriptor.payload.name,
+      descriptor.payload.persist,
       descriptor
     );
   }
@@ -11728,7 +11726,7 @@ var DefaultDomRuntime = class {
     const replayPath = await this.tryBuildPathFromNode(snapshot, node);
     const descriptor = target.persist === void 0 ? void 0 : await writeDescriptor({
       method,
-      name: target.persist,
+      persist: target.persist,
       path: replayPath ?? await this.buildPathForNode(snapshot, node),
       sourceUrl: snapshot.url
     });
@@ -13820,8 +13818,7 @@ function parseExtractionDescriptorRecord(record) {
     return void 0;
   }
   const raw = payload;
-  const persist = typeof raw.persist === "string" ? raw.persist : raw.description;
-  if (raw.kind !== "dom-extraction" || typeof persist !== "string") {
+  if (raw.kind !== "dom-extraction" || typeof raw.persist !== "string") {
     return void 0;
   }
   const root = normalizePersistedExtractionNode(raw.root, "root");
@@ -13836,7 +13833,7 @@ function parseExtractionDescriptorRecord(record) {
     updatedAt: record.updatedAt,
     payload: {
       kind: "dom-extraction",
-      persist,
+      persist: raw.persist,
       root,
       ...typeof raw.schemaHash === "string" ? { schemaHash: raw.schemaHash } : {},
       ...typeof raw.sourceUrl === "string" ? { sourceUrl: raw.sourceUrl } : {}
@@ -16795,8 +16792,8 @@ var OpensteerCloudClient = class {
         entries: entries.map((entry) => ({
           workspace: entry.workspace,
           method: entry.method,
-          descriptionHash: entry.nameHash,
-          ...entry.name === void 0 ? {} : { description: entry.name },
+          persistHash: entry.persistHash,
+          ...entry.persist === void 0 ? {} : { persist: entry.persist },
           path: entry.path,
           ...entry.schemaHash === void 0 ? {} : { schemaHash: entry.schemaHash },
           createdAt: entry.createdAt,
@@ -19090,7 +19087,7 @@ function ensureSparseCountersForAllRecords(counterRecords) {
     )
   );
 }
-async function clearLiveCounters(engine, pageRef) {
+async function clearOpensteerLiveCounters(engine, pageRef) {
   const frames = await engine.listFrames({ pageRef });
   const failures = [];
   for (const frame of frames) {
@@ -19188,7 +19185,7 @@ async function compileOpensteerSnapshot(options) {
         engine: options.engine,
         pageRef: options.pageRef
       });
-      await clearLiveCounters(options.engine, options.pageRef);
+      await clearOpensteerLiveCounters(options.engine, options.pageRef);
       await assignSparseCountersToLiveDom(options.engine, options.pageRef);
       const pageInfo = await options.engine.getPageInfo({ pageRef: options.pageRef });
       const mainSnapshot = await getMainDocumentSnapshot(options.engine, options.pageRef);
@@ -19225,7 +19222,7 @@ async function compileOpensteerSnapshot(options) {
         counters: [...compiledHtml.counterRecords.values()].map(toPublicCounterRecord)
       };
     } catch (error) {
-      await clearLiveCounters(options.engine, options.pageRef).catch(() => void 0);
+      await clearOpensteerLiveCounters(options.engine, options.pageRef).catch(() => void 0);
       if (attempt < MAX_LIVE_COUNTER_SYNC_ATTEMPTS && isLiveCounterSyncError(error)) {
         lastCounterSyncError = error;
         continue;
@@ -22589,6 +22586,7 @@ var OpensteerSessionRuntime = class {
             });
             boundaryDiagnostics = takeActionBoundaryDiagnostics(timeout.signal);
             timeout.throwIfAborted();
+            await this.invalidateLiveSnapshotCounters([pageRef, output2.pageRef], timeout);
             this.pageRef = output2.pageRef;
             const artifacts2 = await this.persistComputerArtifacts(output2, timeout);
             return {
@@ -22778,7 +22776,7 @@ var OpensteerSessionRuntime = class {
           mutationCaptureDiagnostics = diagnostics;
         }
       );
-      const output = toOpensteerActionResult(executed.result, preparedTarget.persisted);
+      const output = toOpensteerActionResult(executed.result);
       const actionEvents = "events" in executed.result ? executed.result.events : void 0;
       await this.appendTrace({
         operation,
@@ -22789,7 +22787,6 @@ var OpensteerSessionRuntime = class {
         data: {
           target: output.target,
           ...output.point === void 0 ? {} : { point: output.point },
-          ...output.persisted === void 0 ? {} : { persisted: output.persisted },
           ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
           ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
@@ -22853,7 +22850,7 @@ var OpensteerSessionRuntime = class {
       await timeout.runStep(
         () => this.requireDom().writeDescriptor({
           method,
-          name: persist,
+          persist,
           path: stablePath2,
           sourceUrl: resolved2.snapshot.url
         })
@@ -22861,9 +22858,8 @@ var OpensteerSessionRuntime = class {
       return {
         target: {
           kind: "descriptor",
-          name: persist
-        },
-        persisted: persist
+          persist
+        }
       };
     }
     const resolved = await timeout.runStep(
@@ -22886,7 +22882,7 @@ var OpensteerSessionRuntime = class {
     await timeout.runStep(
       () => this.requireDom().writeDescriptor({
         method,
-        name: persist,
+        persist,
         path: stablePath,
         sourceUrl: resolved.snapshot.url
       })
@@ -22894,9 +22890,8 @@ var OpensteerSessionRuntime = class {
     return {
       target: {
         kind: "descriptor",
-        name: persist
-      },
-      persisted: persist
+        persist
+      }
     };
   }
   async queryLiveNetwork(input, timeout, options = {}) {
@@ -22952,6 +22947,18 @@ var OpensteerSessionRuntime = class {
     const byRequestId = new Map(withBodies.map((record) => [record.record.requestId, record]));
     return limited.map((record) => byRequestId.get(record.record.requestId) ?? record);
   }
+  async invalidateLiveSnapshotCounters(pageRefs, timeout) {
+    const engine = this.requireEngine();
+    for (const pageRef of new Set(pageRefs)) {
+      try {
+        await timeout.runStep(() => clearOpensteerLiveCounters(engine, pageRef));
+      } catch (error) {
+        if (!isIgnorableRuntimeBindingError(error)) {
+          throw error;
+        }
+      }
+    }
+  }
   async captureScriptsInternal(pageRef, input, timeout) {
     const root = await this.ensureRoot();
     const evaluated = await timeout.runStep(
@@ -24077,7 +24084,7 @@ var OpensteerSessionRuntime = class {
     if (target.kind === "persist") {
       return {
         kind: "descriptor",
-        name: target.name
+        persist: target.persist
       };
     }
     if (target.kind === "selector") {
@@ -25794,7 +25801,7 @@ function normalizeNamespace2(value) {
   const normalized = String(value ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
-function toOpensteerActionResult(result, persisted) {
+function toOpensteerActionResult(result) {
   return {
     target: toOpensteerResolvedTarget2(result.resolved),
     ...result.point === void 0 ? {} : {
@@ -25802,8 +25809,7 @@ function toOpensteerActionResult(result, persisted) {
         x: result.point.x,
         y: result.point.y
       }
-    },
-    ...persisted === void 0 ? {} : { persisted }
+    }
   };
 }
 function toOpensteerResolvedTarget2(target) {
@@ -28921,6 +28927,6 @@ function isOpensteerEnvironmentKey(key) {
   return key.startsWith(OPENSTEER_ENV_PREFIX);
 }
 
-export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, FlowRecorderCollector, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime2 as OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, generateReplayScript, hashDomDescriptorName, inspectCdpEndpoint, isCurrentUrlField, isProcessRunning, isValidCssAttributeKey, listLocalChromeProfiles, loadEnvironment, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, pathExists, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, requireCloudAppBaseUrl, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerEnvironment, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };
-//# sourceMappingURL=chunk-BRUJHMWO.js.map
-//# sourceMappingURL=chunk-BRUJHMWO.js.map
+export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, FlowRecorderCollector, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime2 as OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, generateReplayScript, hashDomDescriptorPersist, inspectCdpEndpoint, isCurrentUrlField, isProcessRunning, isValidCssAttributeKey, listLocalChromeProfiles, loadEnvironment, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, pathExists, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, requireCloudAppBaseUrl, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerEnvironment, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };
+//# sourceMappingURL=chunk-DFQCK2U6.js.map
+//# sourceMappingURL=chunk-DFQCK2U6.js.map