@opensteer/runtime-core 0.1.6 → 0.2.0

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.2.0"};
 
 // src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -2386,6 +2386,16 @@ var opensteerNetworkQueryOutputSchema = objectSchema(
     required: ["records"]
   }
 );
+var opensteerNetworkDetailInputSchema = objectSchema(
+  {
+    recordId: stringSchema({ minLength: 1 }),
+    probe: { type: "boolean" }
+  },
+  {
+    title: "OpensteerNetworkDetailInput",
+    required: ["recordId"]
+  }
+);
 var opensteerParsedCookieSchema = objectSchema(
   {
     name: stringSchema({ minLength: 1 }),
@@ -2422,6 +2432,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 +2469,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,9 +2500,8 @@ var opensteerNetworkReplayInputSchema = objectSchema(
     required: ["recordId"]
   }
 );
-var opensteerNetworkReplayOutputSchema;
 var opensteerSessionFetchTransportSchema = enumSchema(
-  ["auto", "direct", "matched-tls", "page"],
+  ["auto", "direct", "matched-tls", "context", "page"],
   {
     title: "OpensteerSessionFetchTransport"
   }
@@ -2822,7 +2841,7 @@ var opensteerRequestResponseResultSchema = objectSchema(
     required: ["url", "status", "statusText", "headers", "redirected"]
   }
 );
-opensteerNetworkReplayOutputSchema = objectSchema(
+objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
     transport: transportKindSchema,
@@ -5789,7 +5808,6 @@ var opensteerExposedSemanticOperationNames = [
   "dom.extract",
   "network.query",
   "network.detail",
-  "network.replay",
   "interaction.capture",
   "interaction.get",
   "interaction.diff",
@@ -5826,7 +5844,6 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.extract",
   "network.query",
   "network.detail",
-  "network.replay",
   "interaction.capture",
   "interaction.get",
   "interaction.diff",
@@ -5947,11 +5964,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 +6015,7 @@ var opensteerResolvedTargetSchema = objectSchema(
 var opensteerActionResultSchema = objectSchema(
   {
     target: opensteerResolvedTargetSchema,
-    point: pointSchema,
-    persisted: stringSchema()
+    point: pointSchema
   },
   {
     title: "OpensteerActionResult",
@@ -6256,18 +6272,12 @@ var opensteerPageSnapshotOutputSchema = objectSchema(
     required: ["url", "title", "mode", "html", "counters"]
   }
 );
-var opensteerNetworkDetailInputSchema = objectSchema(
-  {
-    recordId: stringSchema({ minLength: 1 })
-  },
+var opensteerComputerMouseButtonSchema = enumSchema(
+  ["left", "middle", "right"],
   {
-    title: "OpensteerNetworkDetailInput",
-    required: ["recordId"]
+    title: "OpensteerComputerMouseButton"
   }
 );
-var opensteerComputerMouseButtonSchema = enumSchema(["left", "middle", "right"], {
-  title: "OpensteerComputerMouseButton"
-});
 var opensteerComputerKeyModifierSchema = enumSchema(
   ["Shift", "Control", "Alt", "Meta"],
   {
@@ -6344,10 +6354,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 +6734,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.",
@@ -6841,6 +6841,7 @@ var opensteerSemanticOperationSpecificationsBase = [
         case "direct":
           return [];
         case "matched-tls":
+        case "context":
           return ["inspect.cookies"];
         case "page":
           return ["pages.manage"];
@@ -7540,7 +7541,6 @@ var DEFAULT_TIMEOUTS = {
   "dom.extract": 15e3,
   "network.query": 15e3,
   "network.detail": 15e3,
-  "network.replay": 3e4,
   "scripts.capture": 15e3,
   "session.cookies": 1e4,
   "session.storage": 1e4,
@@ -8362,13 +8362,6 @@ var SqliteSavedNetworkStore = class {
   }
   async save(records, options) {
     const database = await this.requireDatabase();
-    const readExisting = database.prepare(`
-        SELECT record_id
-        FROM saved_network_records
-        WHERE session_ref = @session_ref
-          AND page_ref_key = @page_ref_key
-          AND request_id = @request_id
-      `);
     const upsertRecord = database.prepare(buildSavedNetworkUpsertSql(options.bodyWriteMode));
     const insertTag = database.prepare(`
       INSERT OR IGNORE INTO saved_network_tags (record_id, tag)
@@ -8379,14 +8372,8 @@ var SqliteSavedNetworkStore = class {
       for (const entry of records) {
         const url = new URL(entry.record.url);
         const pageRefKey = entry.record.pageRef ?? "";
-        const existing = readExisting.get({
-          session_ref: entry.record.sessionRef,
-          page_ref_key: pageRefKey,
-          request_id: entry.record.requestId
-        }) ?? void 0;
-        const recordId = existing?.record_id ?? entry.recordId;
         upsertRecord.run({
-          record_id: recordId,
+          record_id: entry.recordId,
           request_id: entry.record.requestId,
           session_ref: entry.record.sessionRef,
           page_ref: entry.record.pageRef ?? null,
@@ -8431,7 +8418,7 @@ var SqliteSavedNetworkStore = class {
         }
         for (const currentTag of tags) {
           const result = insertTag.run({
-            record_id: recordId,
+            record_id: entry.recordId,
             tag: currentTag
           });
           savedCount += result.changes ?? 0;
@@ -8534,6 +8521,49 @@ var SqliteSavedNetworkStore = class {
       return cleared;
     });
   }
+  async *iterateBatches(options = {}) {
+    const database = await this.requireDatabase();
+    const batchSize = Math.max(1, Math.min(options.batchSize ?? 500, 1e3));
+    let cursor;
+    while (true) {
+      const rows = database.prepare(
+        `
+      SELECT
+        r.*,
+        GROUP_CONCAT(t.tag, '${TAG_DELIMITER}') AS tags
+      FROM saved_network_records r
+      LEFT JOIN saved_network_tags t
+        ON t.record_id = r.record_id
+      ${cursor === void 0 ? "" : "WHERE r.saved_at > ? OR (r.saved_at = ? AND r.record_id > ?)"}
+      GROUP BY r.record_id
+      ORDER BY r.saved_at ASC, r.record_id ASC
+      LIMIT ?
+    `
+      ).all(
+        ...cursor === void 0 ? [] : [cursor.savedAt, cursor.savedAt, cursor.recordId],
+        batchSize
+      );
+      if (rows.length === 0) {
+        return;
+      }
+      yield rows.map((row) => inflateSavedNetworkRow(row, options.includeBodies ?? true));
+      const lastRow = rows.at(-1);
+      if (lastRow === void 0) {
+        return;
+      }
+      cursor = {
+        savedAt: lastRow.saved_at,
+        recordId: lastRow.record_id
+      };
+    }
+  }
+  close() {
+    if (this.database !== void 0) {
+      closeSqliteDatabase(this.database);
+      this.database = void 0;
+      this.databaseInitialization = void 0;
+    }
+  }
   async requireDatabase() {
     if (this.database) {
       return this.database;
@@ -8618,15 +8648,6 @@ var SqliteSavedNetworkStore = class {
         saved_at INTEGER NOT NULL
       );
 
-      CREATE UNIQUE INDEX IF NOT EXISTS saved_network_records_scope_request
-        ON saved_network_records (session_ref, page_ref_key, request_id);
-
-      CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
-        ON saved_network_records (saved_at DESC);
-
-      CREATE INDEX IF NOT EXISTS saved_network_records_capture
-        ON saved_network_records (capture);
-
       CREATE TABLE IF NOT EXISTS saved_network_tags (
         record_id TEXT NOT NULL REFERENCES saved_network_records(record_id) ON DELETE CASCADE,
         tag TEXT NOT NULL,
@@ -8636,6 +8657,19 @@ var SqliteSavedNetworkStore = class {
       CREATE INDEX IF NOT EXISTS saved_network_tags_tag
         ON saved_network_tags (tag);
     `);
+    database.exec(`DROP INDEX IF EXISTS saved_network_records_scope_request`);
+    database.exec(`
+      CREATE INDEX IF NOT EXISTS saved_network_records_scope_request
+        ON saved_network_records (session_ref, page_ref_key, request_id)
+    `);
+    database.exec(`
+      CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
+        ON saved_network_records (saved_at DESC)
+    `);
+    database.exec(`
+      CREATE INDEX IF NOT EXISTS saved_network_records_capture
+        ON saved_network_records (capture)
+    `);
     this.ensureColumn(
       database,
       "saved_network_records",
@@ -8955,6 +8989,14 @@ function withSqliteTransaction(database, task) {
 function createSavedNetworkStore(rootPath) {
   return new SqliteSavedNetworkStore(rootPath);
 }
+async function* iterateSavedNetworkRecordBatches(rootPath, options = {}) {
+  const store = new SqliteSavedNetworkStore(rootPath);
+  try {
+    yield* store.iterateBatches(options);
+  } finally {
+    store.close();
+  }
+}
 function normalizeContext(context) {
   return {
     ...context?.sessionRef === void 0 ? {} : { sessionRef: context.sessionRef },
@@ -10602,8 +10644,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 +10659,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 +10682,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 +10699,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 +10711,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 +10733,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 +10748,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 +10791,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 +10805,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 +11737,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 +11759,7 @@ var DefaultDomRuntime = class {
       pageRef,
       descriptor.payload.path,
       "descriptor",
-      descriptor.payload.name,
+      descriptor.payload.persist,
       descriptor
     );
   }
@@ -11748,7 +11789,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 +14805,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 +14820,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 +16075,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 +16173,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 +16210,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;
@@ -17823,6 +17863,9 @@ var MUTATION_CAPTURE_FINALIZE_TIMEOUT_MS = 5e3;
 var PERSISTED_NETWORK_FLUSH_TIMEOUT_MS = 5e3;
 var PENDING_OPERATION_EVENT_CAPTURE_LIMIT = 64;
 var PENDING_OPERATION_EVENT_CAPTURE_SKEW_MS = 1e3;
+var REPLAY_PROBE_MIN_ATTEMPT_TIMEOUT_MS = 3e3;
+var REPLAY_PROBE_MAX_ATTEMPT_TIMEOUT_MS = 15e3;
+var REPLAY_PROBE_POST_SUCCESS_ATTEMPT_TIMEOUT_MS = 5e3;
 var OpensteerSessionRuntime = class {
   workspace;
   rootPath;
@@ -18684,26 +18727,27 @@ var OpensteerSessionRuntime = class {
     }
   }
   async queryNetwork(input = {}, options = {}) {
-    assertValidSemanticOperationInput("network.query", input);
+    const normalizedInput = normalizeNetworkQueryInput(input);
+    assertValidSemanticOperationInput("network.query", normalizedInput);
     const root = await this.ensureRoot();
     const startedAt = Date.now();
     try {
       const output = await this.runWithOperationTimeout(
         "network.query",
         async (timeout) => {
-          await this.syncPersistedNetworkSelection(timeout, input, {
+          await this.syncPersistedNetworkSelection(timeout, normalizedInput, {
             includeBodies: false
           });
           const rawRecords = await timeout.runStep(
             () => root.registry.savedNetwork.query({
-              ...this.toSavedNetworkQueryInput(input),
-              limit: Math.max(input.limit ?? 50, 1e3)
+              ...this.toSavedNetworkQueryInput(normalizedInput),
+              limit: Math.max(normalizedInput.limit ?? 50, 1e3)
             })
           );
-          const filtered = filterNetworkSummaryRecords(rawRecords, input);
+          const filtered = filterNetworkSummaryRecords(rawRecords, normalizedInput);
           const sorted = sortPersistedNetworkRecordsChronologically(filtered);
-          const sliced = sliceNetworkSummaryWindow(sorted, input);
-          const limited = sliced.slice(0, Math.max(1, Math.min(input.limit ?? 50, 200)));
+          const sliced = sliceNetworkSummaryWindow(sorted, normalizedInput);
+          const limited = sliced.slice(0, Math.max(1, Math.min(normalizedInput.limit ?? 50, 200)));
           const summaries = await this.buildNetworkSummaryRecords(limited, timeout);
           return {
             records: summaries
@@ -18717,9 +18761,9 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "ok",
         data: {
-          limit: input.limit ?? 50,
-          ...input.capture === void 0 ? {} : { capture: input.capture },
-          ...input.json === true ? { json: true } : {},
+          limit: normalizedInput.limit ?? 50,
+          ...normalizedInput.capture === void 0 ? {} : { capture: normalizedInput.capture },
+          ...normalizedInput.json === true ? { json: true } : {},
           count: output.records.length
         },
         context: buildRuntimeTraceContext({
@@ -18744,16 +18788,22 @@ var OpensteerSessionRuntime = class {
     }
   }
   async getNetworkDetail(input, options = {}) {
+    const normalizedRecordId = normalizeNetworkRecordId(input.recordId);
     const startedAt = Date.now();
     try {
       const output = await this.runWithOperationTimeout(
         "network.detail",
         async (timeout) => {
-          const record = await this.resolveNetworkRecordByRecordId(input.recordId, timeout, {
+          const record = await this.resolveNetworkRecordByRecordId(normalizedRecordId, timeout, {
             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
       );
@@ -18763,8 +18813,8 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "ok",
         data: {
-          recordId: input.recordId,
-          status: output.summary.status,
+          recordId: normalizedRecordId,
+          ...output.summary.status === void 0 ? {} : { status: output.summary.status },
           url: output.summary.url
         },
         context: buildRuntimeTraceContext({
@@ -18788,54 +18838,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 +19433,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 +19536,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 +19726,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 +19737,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 +19800,7 @@ var OpensteerSessionRuntime = class {
       await timeout.runStep(
         () => this.requireDom().writeDescriptor({
           method,
-          name: persist,
+          persist,
           path: stablePath2,
           sourceUrl: resolved2.snapshot.url
         })
@@ -19806,9 +19808,8 @@ var OpensteerSessionRuntime = class {
       return {
         target: {
           kind: "descriptor",
-          name: persist
-        },
-        persisted: persist
+          persist
+        }
       };
     }
     const resolved = await timeout.runStep(
@@ -19831,7 +19832,7 @@ var OpensteerSessionRuntime = class {
     await timeout.runStep(
       () => this.requireDom().writeDescriptor({
         method,
-        name: persist,
+        persist,
         path: stablePath,
         sourceUrl: resolved.snapshot.url
       })
@@ -19839,9 +19840,8 @@ var OpensteerSessionRuntime = class {
     return {
       target: {
         kind: "descriptor",
-        name: persist
-      },
-      persisted: persist
+        persist
+      }
     };
   }
   async queryLiveNetwork(input, timeout, options = {}) {
@@ -19897,6 +19897,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(
@@ -20206,7 +20218,9 @@ var OpensteerSessionRuntime = class {
       ...graphql.persisted === void 0 ? {} : { persisted: graphql.persisted },
       ...graphqlVariables === void 0 ? {} : { variables: graphqlVariables }
     };
-    const requestBody = shouldShowRequestBody(record.record.method) && record.record.requestBody !== void 0 ? buildStructuredBodyPreview(record.record.requestBody, record.record.requestHeaders) : void 0;
+    const requestBody = shouldShowRequestBody(record.record.method) && record.record.requestBody !== void 0 ? buildStructuredBodyPreview(record.record.requestBody, record.record.requestHeaders, {
+      truncateData: false
+    }) : void 0;
     const responseBody = record.record.responseBody === void 0 ? void 0 : buildStructuredBodyPreview(record.record.responseBody, record.record.responseHeaders);
     const notes = detectNetworkRecordNotes(record);
     return {
@@ -20226,6 +20240,52 @@ 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();
+      const attemptTimeoutMs = resolveReplayProbeAttemptTimeoutMs({
+        remainingMs: timeout.remainingMs(),
+        transportsRemaining: REPLAY_TRANSPORT_LADDER.length - attempts.length,
+        recommendedFound: recommended !== void 0
+      });
+      try {
+        const output = await this.executeReplayTransportAttemptWithinBudget(
+          transport,
+          request,
+          timeout,
+          attemptTimeoutMs
+        );
+        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: normalizeProbeTransportAttemptError(transport, error, attemptTimeoutMs)
+        });
+      }
+    }
+    return {
+      ...recommended === void 0 ? {} : { recommended },
+      attempts
+    };
+  }
   async buildRedirectChain(record, timeout) {
     if (record.record.redirectFromRequestId === void 0 && record.record.redirectToRequestId === void 0) {
       return {};
@@ -20344,57 +20404,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;
@@ -20472,6 +20481,23 @@ var OpensteerSessionRuntime = class {
       }
     }
   }
+  async executeReplayTransportAttemptWithinBudget(transport, request, timeout, attemptTimeoutMs) {
+    if (attemptTimeoutMs === void 0) {
+      return this.executeReplayTransportAttempt(transport, request, timeout);
+    }
+    return runWithPolicyTimeout(
+      {
+        resolveTimeoutMs() {
+          return attemptTimeoutMs;
+        }
+      },
+      {
+        operation: timeout.operation,
+        signal: timeout.signal
+      },
+      (attemptTimeout) => this.executeReplayTransportAttempt(transport, request, attemptTimeout)
+    );
+  }
   async executeFetchTransportAttempt(transport, request, timeout, input) {
     let prepared = finalizeMaterializedTransportRequest(request, transport);
     if (input.cookies !== false && transport === "direct-http" && this.currentBinding() !== void 0) {
@@ -21022,7 +21048,7 @@ var OpensteerSessionRuntime = class {
     if (target.kind === "persist") {
       return {
         kind: "descriptor",
-        name: target.name
+        persist: target.persist
       };
     }
     if (target.kind === "selector") {
@@ -21386,10 +21412,15 @@ var OpensteerSessionRuntime = class {
     return this.observationSessionId ?? this.sessionRef;
   }
   runWithOperationTimeout(operation, callback, options = {}) {
+    const timeoutPolicy = options.timeoutMs === void 0 ? this.policy.timeout : {
+      resolveTimeoutMs() {
+        return options.timeoutMs;
+      }
+    };
     const existingCollector = this.operationEventStorage.getStore();
     if (existingCollector !== void 0) {
       return runWithPolicyTimeout(
-        this.policy.timeout,
+        timeoutPolicy,
         {
           operation,
           ...options.signal === void 0 ? {} : { signal: options.signal }
@@ -21402,7 +21433,7 @@ var OpensteerSessionRuntime = class {
     return this.operationEventStorage.run(collector, async () => {
       try {
         return await runWithPolicyTimeout(
-          this.policy.timeout,
+          timeoutPolicy,
           {
             operation,
             ...options.signal === void 0 ? {} : { signal: options.signal }
@@ -21572,6 +21603,21 @@ function buildEngineNetworkRecordFilters(input) {
 function normalizeNetworkStatusFilter(status) {
   return String(status);
 }
+function normalizeNetworkQueryInput(input) {
+  return {
+    ...input,
+    ...input.recordId === void 0 ? {} : { recordId: normalizeNetworkRecordId(input.recordId) },
+    ...input.before === void 0 ? {} : { before: normalizeNetworkRecordId(input.before) },
+    ...input.after === void 0 ? {} : { after: normalizeNetworkRecordId(input.after) }
+  };
+}
+function normalizeNetworkRecordId(recordId) {
+  const trimmed = recordId.trim();
+  if (trimmed.length === 0 || trimmed.startsWith("record:")) {
+    return trimmed;
+  }
+  return `record:${trimmed}`;
+}
 function resolveLiveQueryRequestIds(input, history) {
   const requestIdCandidates = [];
   if (input.recordId !== void 0) {
@@ -21784,6 +21830,20 @@ var REPLAY_TRANSPORT_LADDER = [
   "context-http",
   "page-http"
 ];
+function resolveReplayProbeAttemptTimeoutMs(input) {
+  const attemptCapMs = input.recommendedFound ? REPLAY_PROBE_POST_SUCCESS_ATTEMPT_TIMEOUT_MS : REPLAY_PROBE_MAX_ATTEMPT_TIMEOUT_MS;
+  const clampedRemaining = input.remainingMs === void 0 ? void 0 : Math.max(0, input.remainingMs);
+  if (clampedRemaining === 0) {
+    return 0;
+  }
+  if (clampedRemaining === void 0) {
+    return attemptCapMs;
+  }
+  const sliceMs = Math.floor(clampedRemaining / Math.max(1, input.transportsRemaining));
+  const minimumBudgetAffordable = clampedRemaining >= REPLAY_PROBE_MIN_ATTEMPT_TIMEOUT_MS * input.transportsRemaining;
+  const attemptBudgetMs = minimumBudgetAffordable ? Math.max(REPLAY_PROBE_MIN_ATTEMPT_TIMEOUT_MS, sliceMs) : sliceMs;
+  return Math.min(clampedRemaining, attemptCapMs, Math.max(1, attemptBudgetMs));
+}
 function filterNetworkSummaryRecords(records, input) {
   return records.filter((record) => {
     if (record.record.resourceType === "preflight" || record.record.method === "OPTIONS") {
@@ -21956,10 +22016,10 @@ function extractGraphqlOperationName(queryText) {
 function shouldShowRequestBody(method) {
   return !["GET", "HEAD", "DELETE", "OPTIONS"].includes(method.trim().toUpperCase());
 }
-function buildStructuredBodyPreview(body, headers) {
+function buildStructuredBodyPreview(body, headers, options = {}) {
   const contentType = headerValue(headers, "content-type") ?? body?.mimeType;
   const parsed = parseStructuredPayload(body, contentType);
-  const data = parsed === void 0 ? void 0 : typeof parsed === "string" ? truncateInlineText(parsed) : truncateStructuredValue(parsed);
+  const data = parsed === void 0 ? void 0 : options.truncateData === false ? parsed : typeof parsed === "string" ? truncateInlineText(parsed) : truncateStructuredValue(parsed);
   return {
     bytes: body?.originalByteLength ?? body?.capturedByteLength ?? 0,
     ...contentType === void 0 ? {} : { contentType },
@@ -22172,10 +22232,12 @@ function resolveSessionFetchTransportLadder(transport) {
       return ["direct-http"];
     case "matched-tls":
       return ["matched-tls"];
+    case "context":
+      return ["context-http"];
     case "page":
       return ["page-http"];
     case "auto":
-      return ["direct-http", "matched-tls", "page-http"];
+      return ["direct-http", "matched-tls", "context-http", "page-http"];
   }
 }
 function detectChallengeNoteFromRecord(record) {
@@ -22320,6 +22382,12 @@ function diffStorageSnapshot(left, right) {
 function normalizeRuntimeErrorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
+function normalizeProbeTransportAttemptError(transport, error, attemptTimeoutMs) {
+  if (attemptTimeoutMs !== void 0 && error instanceof OpensteerProtocolError && error.code === "timeout") {
+    return `${transport} probe exceeded ${String(attemptTimeoutMs)}ms`;
+  }
+  return normalizeRuntimeErrorMessage(error);
+}
 function applyBrowserCookiesToTransportRequest(request, cookies) {
   if (cookies.length === 0) {
     return request;
@@ -22739,7 +22807,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 +22815,7 @@ function toOpensteerActionResult(result, persisted) {
         x: result.point.x,
         y: result.point.y
       }
-    },
-    ...persisted === void 0 ? {} : { persisted }
+    }
   };
 }
 function toOpensteerResolvedTarget2(target) {
@@ -22998,11 +23065,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,
@@ -24860,9 +24922,11 @@ exports.createFilesystemOpensteerWorkspace = createFilesystemOpensteerWorkspace;
 exports.createFlowRecorderInstallScript = createFlowRecorderInstallScript;
 exports.createObservationStore = createObservationStore;
 exports.createOpensteerExtractionDescriptorStore = createOpensteerExtractionDescriptorStore;
+exports.createSavedNetworkStore = createSavedNetworkStore;
 exports.dispatchSemanticOperation = dispatchSemanticOperation;
 exports.generateReplayScript = generateReplayScript;
-exports.hashDomDescriptorName = hashDomDescriptorName;
+exports.hashDomDescriptorPersist = hashDomDescriptorPersist;
+exports.iterateSavedNetworkRecordBatches = iterateSavedNetworkRecordBatches;
 exports.manifestToExternalBinaryLocation = manifestToExternalBinaryLocation;
 exports.normalizeObservabilityConfig = normalizeObservabilityConfig;
 exports.normalizeWorkspaceId = normalizeWorkspaceId;