@opensteer/runtime-core 0.1.6 → 0.1.7

package/dist/index.cjs

@@ -41,7 +41,7 @@ var vm__default = /*#__PURE__*/_interopDefault(vm);
 
 // package.json
 var package_default = {
-  version: "0.1.6"};
+  version: "0.1.7"};
 
 // src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -2422,6 +2422,20 @@ var opensteerNetworkRedirectHopSchema = objectSchema(
     required: ["method", "url"]
   }
 );
+var opensteerReplayAttemptSchema = objectSchema(
+  {
+    transport: transportKindSchema,
+    status: integerSchema({ minimum: 100, maximum: 599 }),
+    ok: { type: "boolean" },
+    durationMs: integerSchema({ minimum: 0 }),
+    note: stringSchema(),
+    error: stringSchema()
+  },
+  {
+    title: "OpensteerReplayAttempt",
+    required: ["transport", "ok", "durationMs"]
+  }
+);
 var opensteerNetworkDetailOutputSchema = objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
@@ -2445,28 +2459,24 @@ var opensteerNetworkDetailOutputSchema = objectSchema(
       }
     ),
     redirectChain: arraySchema(opensteerNetworkRedirectHopSchema),
-    notes: arraySchema(stringSchema())
+    notes: arraySchema(stringSchema()),
+    transportProbe: objectSchema(
+      {
+        recommended: transportKindSchema,
+        attempts: arraySchema(opensteerReplayAttemptSchema)
+      },
+      {
+        title: "OpensteerTransportProbeResult",
+        required: ["attempts"]
+      }
+    )
   },
   {
     title: "OpensteerNetworkDetailOutput",
     required: ["recordId", "summary", "requestHeaders", "responseHeaders"]
   }
 );
-var opensteerReplayAttemptSchema = objectSchema(
-  {
-    transport: transportKindSchema,
-    status: integerSchema({ minimum: 100, maximum: 599 }),
-    ok: { type: "boolean" },
-    durationMs: integerSchema({ minimum: 0 }),
-    note: stringSchema(),
-    error: stringSchema()
-  },
-  {
-    title: "OpensteerReplayAttempt",
-    required: ["transport", "ok", "durationMs"]
-  }
-);
-var opensteerNetworkReplayInputSchema = objectSchema(
+objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
     pageRef: pageRefSchema,
@@ -2480,7 +2490,6 @@ var opensteerNetworkReplayInputSchema = objectSchema(
     required: ["recordId"]
   }
 );
-var opensteerNetworkReplayOutputSchema;
 var opensteerSessionFetchTransportSchema = enumSchema(
   ["auto", "direct", "matched-tls", "page"],
   {
@@ -2822,7 +2831,7 @@ var opensteerRequestResponseResultSchema = objectSchema(
     required: ["url", "status", "statusText", "headers", "redirected"]
   }
 );
-opensteerNetworkReplayOutputSchema = objectSchema(
+objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
     transport: transportKindSchema,
@@ -5789,7 +5798,6 @@ var opensteerExposedSemanticOperationNames = [
   "dom.extract",
   "network.query",
   "network.detail",
-  "network.replay",
   "interaction.capture",
   "interaction.get",
   "interaction.diff",
@@ -5826,7 +5834,6 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.extract",
   "network.query",
   "network.detail",
-  "network.replay",
   "interaction.capture",
   "interaction.get",
   "interaction.diff",
@@ -5947,11 +5954,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(
@@ -5998,8 +6005,7 @@ var opensteerResolvedTargetSchema = objectSchema(
 var opensteerActionResultSchema = objectSchema(
   {
     target: opensteerResolvedTargetSchema,
-    point: pointSchema,
-    persisted: stringSchema()
+    point: pointSchema
   },
   {
     title: "OpensteerActionResult",
@@ -6265,9 +6271,12 @@ var opensteerNetworkDetailInputSchema = objectSchema(
     required: ["recordId"]
   }
 );
-var opensteerComputerMouseButtonSchema = enumSchema(["left", "middle", "right"], {
-  title: "OpensteerComputerMouseButton"
-});
+var opensteerComputerMouseButtonSchema = enumSchema(
+  ["left", "middle", "right"],
+  {
+    title: "OpensteerComputerMouseButton"
+  }
+);
 var opensteerComputerKeyModifierSchema = enumSchema(
   ["Shift", "Control", "Alt", "Meta"],
   {
@@ -6344,10 +6353,7 @@ var opensteerDomExtractInputSchema = defineSchema({
       title: "OpensteerDomExtractInput"
     }
   ),
-  anyOf: [
-    defineSchema({ required: ["persist"] }),
-    defineSchema({ required: ["schema"] })
-  ]
+  anyOf: [defineSchema({ required: ["persist"] }), defineSchema({ required: ["schema"] })]
 });
 var jsonValueSchema3 = recordSchema({}, { title: "JsonValueRecord" });
 var opensteerDomExtractOutputSchema = objectSchema(
@@ -6727,13 +6733,6 @@ var opensteerSemanticOperationSpecificationsBase = [
     outputSchema: opensteerNetworkDetailOutputSchema,
     requiredCapabilities: ["inspect.network", "inspect.networkBodies"]
   }),
-  defineSemanticOperationSpec({
-    name: "network.replay",
-    description: "Replay a captured request through the transport ladder and report the transport that worked.",
-    inputSchema: opensteerNetworkReplayInputSchema,
-    outputSchema: opensteerNetworkReplayOutputSchema,
-    requiredCapabilities: ["inspect.network", "inspect.cookies", "pages.manage"]
-  }),
   defineSemanticOperationSpec({
     name: "interaction.capture",
     description: "Capture a guarded interaction window, including event properties, state changes, and downstream network.",
@@ -10602,8 +10601,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",
@@ -10617,14 +10616,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];
@@ -10640,7 +10639,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 }
   };
@@ -10657,8 +10656,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)) {
@@ -10670,7 +10668,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 } : {}
   };
@@ -10692,7 +10690,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) {
@@ -10707,7 +10705,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 });
@@ -10750,7 +10748,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) {
@@ -10764,7 +10762,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);
@@ -11696,15 +11694,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"
           }
         }
@@ -11718,7 +11716,7 @@ var DefaultDomRuntime = class {
       pageRef,
       descriptor.payload.path,
       "descriptor",
-      descriptor.payload.name,
+      descriptor.payload.persist,
       descriptor
     );
   }
@@ -11748,7 +11746,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
     });
@@ -14764,8 +14762,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");
@@ -14780,7 +14777,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 } : {}
@@ -16035,7 +16032,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) {
@@ -16133,7 +16130,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);
@@ -16170,7 +16167,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;
@@ -18753,7 +18750,12 @@ var OpensteerSessionRuntime = class {
             includeBodies: true,
             redactSecretHeaders: false
           });
-          return this.buildNetworkDetail(record, timeout);
+          const detail = await this.buildNetworkDetail(record, timeout);
+          if (input.probe !== true) {
+            return detail;
+          }
+          const transportProbe = await this.probeTransportsForRecord(record, timeout);
+          return transportProbe === void 0 ? detail : { ...detail, transportProbe };
         },
         options
       );
@@ -18788,54 +18790,6 @@ var OpensteerSessionRuntime = class {
       throw error;
     }
   }
-  async replayNetwork(input, options = {}) {
-    const startedAt = Date.now();
-    try {
-      const output = await this.runWithOperationTimeout(
-        "network.replay",
-        async (timeout) => {
-          const source = await this.resolveNetworkRecordByRecordId(input.recordId, timeout, {
-            includeBodies: true,
-            redactSecretHeaders: false
-          });
-          const replayRequest = buildReplayTransportRequest(source, input);
-          return this.executeNetworkReplay(source, replayRequest, timeout, {
-            ...input.pageRef === void 0 ? {} : { pageRef: input.pageRef }
-          });
-        },
-        options
-      );
-      await this.appendTrace({
-        operation: "network.replay",
-        startedAt,
-        completedAt: Date.now(),
-        outcome: "ok",
-        data: {
-          recordId: input.recordId,
-          transport: output.transport,
-          attempts: output.attempts.length
-        },
-        context: buildRuntimeTraceContext({
-          sessionRef: this.sessionRef,
-          pageRef: this.pageRef
-        })
-      });
-      return output;
-    } catch (error) {
-      await this.appendTrace({
-        operation: "network.replay",
-        startedAt,
-        completedAt: Date.now(),
-        outcome: "error",
-        error,
-        context: buildRuntimeTraceContext({
-          sessionRef: this.sessionRef,
-          pageRef: this.pageRef
-        })
-      });
-      throw error;
-    }
-  }
   async captureScripts(input = {}, options = {}) {
     assertValidSemanticOperationInput("scripts.capture", input);
     const pageRef = input.pageRef ?? await this.ensurePageRef();
@@ -19431,7 +19385,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "ok",
         data: {
-          transport: output.transport,
+          ...output.transport === void 0 ? {} : { transport: output.transport },
           attempts: output.attempts.length,
           ...output.response === void 0 ? {} : { status: output.response.status },
           url: input.url
@@ -19534,6 +19488,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 {
@@ -19723,7 +19678,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,
@@ -19734,7 +19689,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)
         },
@@ -19798,7 +19752,7 @@ var OpensteerSessionRuntime = class {
       await timeout.runStep(
         () => this.requireDom().writeDescriptor({
           method,
-          name: persist,
+          persist,
           path: stablePath2,
           sourceUrl: resolved2.snapshot.url
         })
@@ -19806,9 +19760,8 @@ var OpensteerSessionRuntime = class {
       return {
         target: {
           kind: "descriptor",
-          name: persist
-        },
-        persisted: persist
+          persist
+        }
       };
     }
     const resolved = await timeout.runStep(
@@ -19831,7 +19784,7 @@ var OpensteerSessionRuntime = class {
     await timeout.runStep(
       () => this.requireDom().writeDescriptor({
         method,
-        name: persist,
+        persist,
         path: stablePath,
         sourceUrl: resolved.snapshot.url
       })
@@ -19839,9 +19792,8 @@ var OpensteerSessionRuntime = class {
     return {
       target: {
         kind: "descriptor",
-        name: persist
-      },
-      persisted: persist
+        persist
+      }
     };
   }
   async queryLiveNetwork(input, timeout, options = {}) {
@@ -19897,6 +19849,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(
@@ -20226,6 +20190,42 @@ var OpensteerSessionRuntime = class {
       ...notes.length === 0 ? {} : { notes }
     };
   }
+  async probeTransportsForRecord(record, timeout) {
+    if (record.record.status === void 0) {
+      return void 0;
+    }
+    const request = buildReplayTransportRequest(record, { recordId: record.recordId });
+    const fingerprint = buildCapturedRecordSuccessFingerprint(record);
+    const attempts = [];
+    let recommended;
+    for (const transport of REPLAY_TRANSPORT_LADDER) {
+      const attemptStartedAt = Date.now();
+      try {
+        const output = await this.executeReplayTransportAttempt(transport, request, timeout);
+        const ok = matchesSuccessFingerprintFromProtocolResponse(output.response, fingerprint);
+        attempts.push({
+          transport,
+          status: output.response.status,
+          ok,
+          durationMs: Date.now() - attemptStartedAt
+        });
+        if (ok && recommended === void 0) {
+          recommended = transport;
+        }
+      } catch (error) {
+        attempts.push({
+          transport,
+          ok: false,
+          durationMs: Date.now() - attemptStartedAt,
+          error: normalizeRuntimeErrorMessage(error)
+        });
+      }
+    }
+    return {
+      ...recommended === void 0 ? {} : { recommended },
+      attempts
+    };
+  }
   async buildRedirectChain(record, timeout) {
     if (record.record.redirectFromRequestId === void 0 && record.record.redirectToRequestId === void 0) {
       return {};
@@ -20344,57 +20344,6 @@ var OpensteerSessionRuntime = class {
       })
     };
   }
-  async executeNetworkReplay(source, request, timeout, options) {
-    const fingerprint = buildCapturedRecordSuccessFingerprint(source);
-    const attempts = [];
-    let lastOutput;
-    for (const transport of REPLAY_TRANSPORT_LADDER) {
-      const attemptStartedAt = Date.now();
-      try {
-        const output = await this.executeReplayTransportAttempt(
-          transport,
-          request,
-          timeout,
-          options.pageRef
-        );
-        lastOutput = output;
-        const ok = matchesSuccessFingerprintFromProtocolResponse(output.response, fingerprint);
-        attempts.push({
-          transport,
-          status: output.response.status,
-          ok,
-          durationMs: Date.now() - attemptStartedAt
-        });
-        if (ok) {
-          const fallbackNote = attempts.length > 1 ? buildReplayFallbackNote(attempts, transport) : void 0;
-          const previewData2 = toStructuredPreviewData(output.data);
-          return {
-            recordId: source.recordId,
-            transport,
-            attempts,
-            response: output.response,
-            ...previewData2 === void 0 ? {} : { data: previewData2 },
-            ...fallbackNote === void 0 ? {} : { note: fallbackNote }
-          };
-        }
-      } catch (error) {
-        attempts.push({
-          transport,
-          ok: false,
-          durationMs: Date.now() - attemptStartedAt,
-          error: normalizeRuntimeErrorMessage(error)
-        });
-      }
-    }
-    const previewData = toStructuredPreviewData(lastOutput?.data);
-    return {
-      recordId: source.recordId,
-      attempts,
-      ...lastOutput?.response === void 0 ? {} : { response: lastOutput.response },
-      ...previewData === void 0 ? {} : { data: previewData },
-      note: "all replay transports failed to reproduce the captured response"
-    };
-  }
   async executeSessionFetch(request, input, timeout) {
     const attempts = [];
     let lastOutput;
@@ -21022,7 +20971,7 @@ var OpensteerSessionRuntime = class {
     if (target.kind === "persist") {
       return {
         kind: "descriptor",
-        name: target.name
+        persist: target.persist
       };
     }
     if (target.kind === "selector") {
@@ -22739,7 +22688,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 ? {} : {
@@ -22747,8 +22696,7 @@ function toOpensteerActionResult(result, persisted) {
         x: result.point.x,
         y: result.point.y
       }
-    },
-    ...persisted === void 0 ? {} : { persisted }
+    }
   };
 }
 function toOpensteerResolvedTarget2(target) {
@@ -22998,11 +22946,6 @@ async function dispatchSemanticOperation(runtime, operation, input, options = {}
         input,
         options
       );
-    case "network.replay":
-      return runtime.replayNetwork(
-        input,
-        options
-      );
     case "interaction.capture":
       return runtime.captureInteraction(
         input,
@@ -24862,7 +24805,7 @@ exports.createObservationStore = createObservationStore;
 exports.createOpensteerExtractionDescriptorStore = createOpensteerExtractionDescriptorStore;
 exports.dispatchSemanticOperation = dispatchSemanticOperation;
 exports.generateReplayScript = generateReplayScript;
-exports.hashDomDescriptorName = hashDomDescriptorName;
+exports.hashDomDescriptorPersist = hashDomDescriptorPersist;
 exports.manifestToExternalBinaryLocation = manifestToExternalBinaryLocation;
 exports.normalizeObservabilityConfig = normalizeObservabilityConfig;
 exports.normalizeWorkspaceId = normalizeWorkspaceId;