opensteer 0.8.6 → 0.8.7

package/dist/index.cjs

@@ -1461,13 +1461,9 @@ var networkRecordSchema = objectSchema(
     ]
   }
 );
-var networkQuerySourceSchema = enumSchema(["live", "saved"], {
-  title: "NetworkQuerySource"
-});
 var networkQueryRecordSchema = objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
-    source: networkQuerySourceSchema,
     actionId: stringSchema({ minLength: 1 }),
     tags: arraySchema(stringSchema({ minLength: 1 }), {
       uniqueItems: true
@@ -1477,7 +1473,7 @@ var networkQueryRecordSchema = objectSchema(
   },
   {
     title: "NetworkQueryRecord",
-    required: ["recordId", "source", "record"]
+    required: ["recordId", "record"]
   }
 );
 arraySchema(headerEntrySchema, {
@@ -2173,9 +2169,6 @@ var opensteerRecipeRecordSchema = objectSchema(
 var opensteerAuthRecipeRecordSchema = opensteerRecipeRecordSchema;
 var opensteerNetworkQueryInputSchema = objectSchema(
   {
-    source: enumSchema(["live", "saved"], {
-      title: "OpensteerNetworkQuerySource"
-    }),
     pageRef: pageRefSchema,
     recordId: stringSchema({ minLength: 1 }),
     requestId: stringSchema({ minLength: 1 }),
@@ -2203,7 +2196,7 @@ var opensteerNetworkQueryOutputSchema = objectSchema(
     required: ["records"]
   }
 );
-var opensteerNetworkSaveInputSchema = objectSchema(
+var opensteerNetworkTagInputSchema = objectSchema(
   {
     pageRef: pageRefSchema,
     recordId: stringSchema({ minLength: 1 }),
@@ -2218,17 +2211,17 @@ var opensteerNetworkSaveInputSchema = objectSchema(
     resourceType: networkResourceTypeSchema
   },
   {
-    title: "OpensteerNetworkSaveInput",
+    title: "OpensteerNetworkTagInput",
     required: ["tag"]
   }
 );
-var opensteerNetworkSaveOutputSchema = objectSchema(
+var opensteerNetworkTagOutputSchema = objectSchema(
   {
-    savedCount: integerSchema({ minimum: 0 })
+    taggedCount: integerSchema({ minimum: 0 })
   },
   {
-    title: "OpensteerNetworkSaveOutput",
-    required: ["savedCount"]
+    title: "OpensteerNetworkTagOutput",
+    required: ["taggedCount"]
   }
 );
 var opensteerNetworkClearInputSchema = objectSchema(
@@ -5703,7 +5696,7 @@ var opensteerSemanticOperationNames = [
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -5764,7 +5757,7 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -6674,18 +6667,17 @@ var opensteerSemanticOperationSpecificationsBase = [
   }),
   defineSemanticOperationSpec({
     name: "network.query",
-    description: "Query live or saved network records for reverse engineering workflows.",
+    description: "Query persisted network records for reverse engineering workflows.",
     inputSchema: opensteerNetworkQueryInputSchema,
     outputSchema: opensteerNetworkQueryOutputSchema,
-    requiredCapabilities: [],
-    resolveRequiredCapabilities: (input) => input.source === "saved" ? [] : input.includeBodies === true ? ["inspect.network", "inspect.networkBodies"] : ["inspect.network"]
+    requiredCapabilities: []
   }),
   defineSemanticOperationSpec({
-    name: "network.save",
-    description: "Persist filtered live network records into the saved network registry under a tag.",
-    inputSchema: opensteerNetworkSaveInputSchema,
-    outputSchema: opensteerNetworkSaveOutputSchema,
-    requiredCapabilities: ["inspect.network"]
+    name: "network.tag",
+    description: "Apply a tag to persisted network records matching the provided filters.",
+    inputSchema: opensteerNetworkTagInputSchema,
+    outputSchema: opensteerNetworkTagOutputSchema,
+    requiredCapabilities: []
   }),
   defineSemanticOperationSpec({
     name: "network.clear",
@@ -7577,7 +7569,7 @@ var SqliteSavedNetworkStore = class {
   async initialize() {
     await this.ensureDatabaseDirectory();
   }
-  async save(records, tag) {
+  async save(records, options) {
     const database = await this.requireDatabase();
     const readExisting = database.prepare(`
         SELECT record_id
@@ -7586,123 +7578,7 @@ var SqliteSavedNetworkStore = class {
           AND page_ref_key = @page_ref_key
           AND request_id = @request_id
       `);
-    const upsertRecord = database.prepare(`
-      INSERT INTO saved_network_records (
-        record_id,
-        request_id,
-        session_ref,
-        page_ref,
-        page_ref_key,
-        frame_ref,
-        document_ref,
-        action_id,
-        method,
-        method_lc,
-        url,
-        url_lc,
-        hostname,
-        hostname_lc,
-        path,
-        path_lc,
-        status,
-        status_text,
-        resource_type,
-        navigation_request,
-        request_headers_json,
-        response_headers_json,
-        request_body_json,
-        response_body_json,
-        initiator_json,
-        timing_json,
-        transfer_json,
-        source_json,
-        capture_state,
-        request_body_state,
-        response_body_state,
-        request_body_skip_reason,
-        response_body_skip_reason,
-        request_body_error,
-        response_body_error,
-        redirect_from_request_id,
-        redirect_to_request_id,
-        saved_at
-      ) VALUES (
-        @record_id,
-        @request_id,
-        @session_ref,
-        @page_ref,
-        @page_ref_key,
-        @frame_ref,
-        @document_ref,
-        @action_id,
-        @method,
-        @method_lc,
-        @url,
-        @url_lc,
-        @hostname,
-        @hostname_lc,
-        @path,
-        @path_lc,
-        @status,
-        @status_text,
-        @resource_type,
-        @navigation_request,
-        @request_headers_json,
-        @response_headers_json,
-        @request_body_json,
-        @response_body_json,
-        @initiator_json,
-        @timing_json,
-        @transfer_json,
-        @source_json,
-        @capture_state,
-        @request_body_state,
-        @response_body_state,
-        @request_body_skip_reason,
-        @response_body_skip_reason,
-        @request_body_error,
-        @response_body_error,
-        @redirect_from_request_id,
-        @redirect_to_request_id,
-        @saved_at
-      )
-      ON CONFLICT(record_id) DO UPDATE SET
-        page_ref = excluded.page_ref,
-        page_ref_key = excluded.page_ref_key,
-        frame_ref = excluded.frame_ref,
-        document_ref = excluded.document_ref,
-        action_id = excluded.action_id,
-        method = excluded.method,
-        method_lc = excluded.method_lc,
-        url = excluded.url,
-        url_lc = excluded.url_lc,
-        hostname = excluded.hostname,
-        hostname_lc = excluded.hostname_lc,
-        path = excluded.path,
-        path_lc = excluded.path_lc,
-        status = excluded.status,
-        status_text = excluded.status_text,
-        resource_type = excluded.resource_type,
-        navigation_request = excluded.navigation_request,
-        request_headers_json = excluded.request_headers_json,
-        response_headers_json = excluded.response_headers_json,
-        request_body_json = excluded.request_body_json,
-        response_body_json = excluded.response_body_json,
-        initiator_json = excluded.initiator_json,
-        timing_json = excluded.timing_json,
-        transfer_json = excluded.transfer_json,
-        source_json = excluded.source_json,
-        capture_state = excluded.capture_state,
-        request_body_state = excluded.request_body_state,
-        response_body_state = excluded.response_body_state,
-        request_body_skip_reason = excluded.request_body_skip_reason,
-        response_body_skip_reason = excluded.response_body_skip_reason,
-        request_body_error = excluded.request_body_error,
-        response_body_error = excluded.response_body_error,
-        redirect_from_request_id = excluded.redirect_from_request_id,
-        redirect_to_request_id = excluded.redirect_to_request_id,
-        saved_at = excluded.saved_at
-    `);
+    const upsertRecord = database.prepare(buildSavedNetworkUpsertSql(options.bodyWriteMode));
     const insertTag = database.prepare(`
       INSERT OR IGNORE INTO saved_network_tags (record_id, tag)
       VALUES (@record_id, @tag)
@@ -7758,10 +7634,14 @@ var SqliteSavedNetworkStore = class {
           redirect_to_request_id: entry.record.redirectToRequestId ?? null,
           saved_at: entry.savedAt ?? Date.now()
         });
-        if (tag !== void 0) {
+        const tags = new Set(entry.tags ?? []);
+        if (options.tag !== void 0) {
+          tags.add(options.tag);
+        }
+        for (const currentTag of tags) {
           const result = insertTag.run({
             record_id: recordId,
-            tag
+            tag: currentTag
           });
           savedCount += result.changes ?? 0;
         }
@@ -7769,6 +7649,39 @@ var SqliteSavedNetworkStore = class {
       return savedCount;
     });
   }
+  async tagByFilter(filter, tag) {
+    const database = await this.requireDatabase();
+    const { whereSql, parameters } = buildSavedNetworkWhere(filter);
+    const selectRecords = database.prepare(
+      `
+        SELECT r.record_id
+        FROM saved_network_records r
+        ${whereSql}
+      `
+    );
+    const insertTag = database.prepare(`
+      INSERT OR IGNORE INTO saved_network_tags (record_id, tag)
+      VALUES (@record_id, @tag)
+    `);
+    return withSqliteTransaction(database, () => {
+      let taggedCount = 0;
+      const rows = selectRecords.all(
+        ...parameters
+      );
+      for (const row of rows) {
+        const recordId = row.record_id;
+        if (typeof recordId !== "string") {
+          continue;
+        }
+        const result = insertTag.run({
+          record_id: recordId,
+          tag
+        });
+        taggedCount += result.changes ?? 0;
+      }
+      return taggedCount;
+    });
+  }
   async query(input = {}) {
     const database = await this.requireDatabase();
     const limit = Math.max(1, Math.min(input.limit ?? 50, 200));
@@ -7971,6 +7884,10 @@ var SqliteSavedNetworkStore = class {
 function buildSavedNetworkWhere(input) {
   const clauses = [];
   const parameters = [];
+  if (input.pageRef !== void 0) {
+    clauses.push("r.page_ref_key = ?");
+    parameters.push(input.pageRef);
+  }
   if (input.recordId !== void 0) {
     clauses.push("r.record_id = ?");
     parameters.push(input.recordId);
@@ -8023,6 +7940,127 @@ function buildSavedNetworkWhere(input) {
     parameters
   };
 }
+function buildSavedNetworkUpsertSql(bodyWriteMode) {
+  const bodyUpdateSql = bodyWriteMode === "authoritative" ? `
+        request_body_json = excluded.request_body_json,
+        response_body_json = excluded.response_body_json,
+        request_body_state = excluded.request_body_state,
+        response_body_state = excluded.response_body_state,
+        request_body_skip_reason = excluded.request_body_skip_reason,
+        response_body_skip_reason = excluded.response_body_skip_reason,
+        request_body_error = excluded.request_body_error,
+        response_body_error = excluded.response_body_error,
+` : "";
+  return `
+      INSERT INTO saved_network_records (
+        record_id,
+        request_id,
+        session_ref,
+        page_ref,
+        page_ref_key,
+        frame_ref,
+        document_ref,
+        action_id,
+        method,
+        method_lc,
+        url,
+        url_lc,
+        hostname,
+        hostname_lc,
+        path,
+        path_lc,
+        status,
+        status_text,
+        resource_type,
+        navigation_request,
+        request_headers_json,
+        response_headers_json,
+        request_body_json,
+        response_body_json,
+        initiator_json,
+        timing_json,
+        transfer_json,
+        source_json,
+        capture_state,
+        request_body_state,
+        response_body_state,
+        request_body_skip_reason,
+        response_body_skip_reason,
+        request_body_error,
+        response_body_error,
+        redirect_from_request_id,
+        redirect_to_request_id,
+        saved_at
+      ) VALUES (
+        @record_id,
+        @request_id,
+        @session_ref,
+        @page_ref,
+        @page_ref_key,
+        @frame_ref,
+        @document_ref,
+        @action_id,
+        @method,
+        @method_lc,
+        @url,
+        @url_lc,
+        @hostname,
+        @hostname_lc,
+        @path,
+        @path_lc,
+        @status,
+        @status_text,
+        @resource_type,
+        @navigation_request,
+        @request_headers_json,
+        @response_headers_json,
+        @request_body_json,
+        @response_body_json,
+        @initiator_json,
+        @timing_json,
+        @transfer_json,
+        @source_json,
+        @capture_state,
+        @request_body_state,
+        @response_body_state,
+        @request_body_skip_reason,
+        @response_body_skip_reason,
+        @request_body_error,
+        @response_body_error,
+        @redirect_from_request_id,
+        @redirect_to_request_id,
+        @saved_at
+      )
+      ON CONFLICT(record_id) DO UPDATE SET
+        page_ref = excluded.page_ref,
+        page_ref_key = excluded.page_ref_key,
+        frame_ref = excluded.frame_ref,
+        document_ref = excluded.document_ref,
+        action_id = excluded.action_id,
+        method = excluded.method,
+        method_lc = excluded.method_lc,
+        url = excluded.url,
+        url_lc = excluded.url_lc,
+        hostname = excluded.hostname,
+        hostname_lc = excluded.hostname_lc,
+        path = excluded.path,
+        path_lc = excluded.path_lc,
+        status = excluded.status,
+        status_text = excluded.status_text,
+        resource_type = excluded.resource_type,
+        navigation_request = excluded.navigation_request,
+        request_headers_json = excluded.request_headers_json,
+        response_headers_json = excluded.response_headers_json,
+${bodyUpdateSql}        initiator_json = excluded.initiator_json,
+        timing_json = excluded.timing_json,
+        transfer_json = excluded.transfer_json,
+        source_json = excluded.source_json,
+        capture_state = excluded.capture_state,
+        redirect_from_request_id = excluded.redirect_from_request_id,
+        redirect_to_request_id = excluded.redirect_to_request_id,
+        saved_at = MIN(saved_network_records.saved_at, excluded.saved_at)
+    `;
+}
 function inflateSavedNetworkRow(row, includeBodies) {
   const requestBody = includeBodies && row.request_body_json !== null ? JSON.parse(row.request_body_json) : void 0;
   const responseBody = includeBodies && row.response_body_json !== null ? JSON.parse(row.response_body_json) : void 0;
@@ -8093,7 +8131,6 @@ function inflateSavedNetworkRow(row, includeBodies) {
   }
   return {
     recordId: row.record_id,
-    source: "saved",
     ...row.action_id === null ? {} : { actionId: row.action_id },
     ...row.tags === null || row.tags.length === 0 ? {} : { tags: row.tags.split(TAG_DELIMITER).filter((tag) => tag.length > 0) },
     savedAt: row.saved_at,
@@ -8440,7 +8477,7 @@ var DEFAULT_TIMEOUTS = {
   "dom.scroll": 1e4,
   "dom.extract": 15e3,
   "network.query": 15e3,
-  "network.save": 15e3,
+  "network.tag": 15e3,
   "network.clear": 1e4,
   "scripts.capture": 15e3,
   "request.raw": 3e4,
@@ -10232,6 +10269,19 @@ var MemoryDomDescriptorStore = class {
   }
 };
 
+// ../runtime-core/src/action-boundary.ts
+async function captureActionBoundarySnapshot(engine, pageRef) {
+  const frames = await engine.listFrames({ pageRef });
+  const mainFrame = frames.find((frame) => frame.isMainFrame);
+  if (!mainFrame) {
+    throw new Error(`page ${pageRef} does not expose a main frame`);
+  }
+  return {
+    pageRef,
+    documentRef: mainFrame.documentRef
+  };
+}
+
 // ../runtime-core/src/runtimes/dom/executor.ts
 var MAX_DOM_ACTION_ATTEMPTS = 3;
 var DEFAULT_SCROLL_OPTIONS = {
@@ -10361,6 +10411,7 @@ var DomActionExecutor = class {
             })
           );
           let finalResolved = resolved;
+          let finalSnapshot;
           if (input.pressEnter) {
             await this.settle(resolved.pageRef, "dom.input", timeout);
             const enterSession = this.options.createResolutionSession();
@@ -10376,6 +10427,9 @@ var DomActionExecutor = class {
               () => bridge.inspectActionTarget(enterResolved.locator)
             );
             this.assertKeyboardActionable("dom.input", enterResolved, inspectionBeforeEnter);
+            finalSnapshot = await timeout.runStep(
+              () => captureActionBoundarySnapshot(this.options.engine, enterResolved.pageRef)
+            );
             await timeout.runStep(
               () => bridge.pressKey(enterResolved.locator, {
                 key: "Enter"
@@ -10383,7 +10437,7 @@ var DomActionExecutor = class {
             );
             finalResolved = enterResolved;
           }
-          await this.settle(finalResolved.pageRef, "dom.input", timeout);
+          await this.settle(finalResolved.pageRef, "dom.input", timeout, finalSnapshot);
           return finalResolved;
         } catch (error) {
           lastError = error;
@@ -10456,8 +10510,16 @@ var DomActionExecutor = class {
               );
             }
           }
+          const actionBoundarySnapshot = await timeout.runStep(
+            () => captureActionBoundarySnapshot(this.options.engine, pointerTarget.resolved.pageRef)
+          );
           const outcome = await dispatch(pointerTarget, point, timeout);
-          await this.settle(pointerTarget.resolved.pageRef, input.operation, timeout);
+          await this.settle(
+            pointerTarget.resolved.pageRef,
+            input.operation,
+            timeout,
+            actionBoundarySnapshot
+          );
           return outcome;
         } catch (error) {
           lastError = error;
@@ -10475,16 +10537,17 @@ var DomActionExecutor = class {
     }
     return runWithPolicyTimeout(this.options.policy.timeout, { operation }, execute);
   }
-  async settle(pageRef, operation, timeout) {
+  async settle(pageRef, operation, timeout, snapshot) {
     const bridge = this.requireBridge();
     await timeout.runStep(
       () => bridge.finalizeDomAction(pageRef, {
         operation,
+        ...snapshot === void 0 ? {} : { snapshot },
         signal: timeout.signal,
         remainingMs: () => timeout.remainingMs(),
-        policySettle: (targetPageRef) => settleWithPolicy(this.options.policy.settle, {
+        policySettle: (targetPageRef, trigger) => settleWithPolicy(this.options.policy.settle, {
           operation,
-          trigger: "dom-action",
+          trigger,
           engine: this.options.engine,
           pageRef: targetPageRef,
           signal: timeout.signal,
@@ -16052,16 +16115,20 @@ var DefaultComputerUseRuntime = class {
     const preActionDisplay = createComputerDisplayTransform(preActionNativeViewport);
     const nativeAction = toNativeComputerAction(input.input.action, preActionDisplay);
     const screenshot = normalizeScreenshotOptions(input.input.screenshot);
+    const snapshot = await input.timeout.runStep(
+      () => captureActionBoundarySnapshot(this.options.engine, input.pageRef)
+    );
     const executed = await input.timeout.runStep(
       () => bridge.execute({
         pageRef: input.pageRef,
+        snapshot,
         action: nativeAction,
         screenshot,
         signal: input.timeout.signal,
         remainingMs: () => input.timeout.remainingMs(),
-        policySettle: async (pageRef) => settleWithPolicy(this.options.policy.settle, {
+        policySettle: async (pageRef, trigger) => settleWithPolicy(this.options.policy.settle, {
           operation: "computer.execute",
-          trigger: "dom-action",
+          trigger,
           engine: this.options.engine,
           pageRef,
           signal: input.timeout.signal,
@@ -16181,8 +16248,8 @@ async function dispatchSemanticOperation(runtime, operation, input, options = {}
         input,
         options
       );
-    case "network.save":
-      return runtime.saveNetwork(
+    case "network.tag":
+      return runtime.tagNetwork(
         input,
         options
       );
@@ -17056,9 +17123,9 @@ function inferRequestPlanFromNetworkRecord(record, input, options = {}) {
     key: input.key,
     version: input.version,
     provenance: {
-      source: record.source === "saved" ? "saved-network-record" : "live-network-record",
+      source: record.savedAt === void 0 ? "network-record" : "saved-network-record",
       sourceId: record.recordId,
-      ...record.source === "saved" ? record.savedAt === void 0 ? {} : { capturedAt: record.savedAt } : options.observedAt === void 0 ? {} : { capturedAt: options.observedAt }
+      ...record.savedAt === void 0 ? options.observedAt === void 0 ? {} : { capturedAt: options.observedAt } : { capturedAt: record.savedAt }
     },
     payload,
     ...record.tags === void 0 || record.tags.length === 0 ? {} : { tags: record.tags }
@@ -17438,51 +17505,55 @@ function resolveBodyEncoding(charset) {
       return "utf8";
   }
 }
-var NetworkJournal = class {
+var NetworkHistory = class {
   metadataByRequestId = /* @__PURE__ */ new Map();
   requestIdByRecordId = /* @__PURE__ */ new Map();
   requestIdsByActionId = /* @__PURE__ */ new Map();
   requestIdsByTag = /* @__PURE__ */ new Map();
-  sync(records, options = {}) {
+  tombstonedRequestIds = /* @__PURE__ */ new Set();
+  materialize(records, options = {}) {
     const observedAt = Date.now();
-    return records.map((record) => this.materializeLiveRecord(record, observedAt, options));
-  }
-  materializeLiveRecord(record, observedAt, options = {}) {
-    let metadata = this.metadataByRequestId.get(record.requestId);
-    if (!metadata) {
-      metadata = {
-        recordId: `record:${crypto.randomUUID()}`,
-        observedAt,
-        ...record.pageRef === void 0 ? {} : { pageRef: record.pageRef },
-        tags: /* @__PURE__ */ new Set()
-      };
-      this.metadataByRequestId.set(record.requestId, metadata);
-      this.requestIdByRecordId.set(metadata.recordId, record.requestId);
-    } else if (metadata.pageRef === void 0 && record.pageRef !== void 0) {
-      metadata.pageRef = record.pageRef;
+    const materialized = [];
+    for (const record of records) {
+      const entry = this.materializeRecord(record, observedAt, options);
+      if (entry !== void 0) {
+        materialized.push(entry);
+      }
     }
-    return {
-      recordId: metadata.recordId,
-      source: "live",
-      ...metadata.actionId === void 0 ? {} : { actionId: metadata.actionId },
-      ...metadata.tags.size === 0 ? {} : { tags: [...metadata.tags].sort() },
-      record: toProtocolNetworkRecord(record, {
-        redactSecretHeaders: options.redactSecretHeaders ?? true
-      })
-    };
+    return materialized;
   }
-  diffNewRequestIds(records, baselineRequestIds) {
-    const observedAt = Date.now();
-    const all = records.map(
-      (record) => this.materializeLiveRecord(record, observedAt, {
-        redactSecretHeaders: true
-      })
-    );
-    const delta = all.filter((entry) => !baselineRequestIds.has(entry.record.requestId));
-    return {
-      all,
-      delta
-    };
+  async persist(records, store, options) {
+    const observedAt = options.observedAt ?? Date.now();
+    const metadataToSave = /* @__PURE__ */ new Set();
+    const persisted = [];
+    for (const record of records) {
+      const entry = this.materializeRecord(record, observedAt, {
+        ...options.redactSecretHeaders === void 0 ? {} : { redactSecretHeaders: options.redactSecretHeaders }
+      });
+      if (entry === void 0) {
+        continue;
+      }
+      const requestId = entry.record.requestId;
+      const metadata = this.metadataByRequestId.get(requestId);
+      if (metadata === void 0) {
+        continue;
+      }
+      const savedAt = metadata.savedAt ?? observedAt;
+      metadataToSave.add(metadata);
+      persisted.push({
+        ...entry,
+        savedAt
+      });
+    }
+    if (persisted.length > 0) {
+      await store.save(persisted, {
+        bodyWriteMode: options.bodyWriteMode
+      });
+      for (const metadata of metadataToSave) {
+        metadata.savedAt ??= observedAt;
+      }
+    }
+    return persisted;
   }
   assignActionId(records, actionId) {
     for (const record of records) {
@@ -17523,11 +17594,73 @@ var NetworkJournal = class {
   getPageRefForRequestId(requestId) {
     return this.metadataByRequestId.get(requestId)?.pageRef;
   }
+  getKnownRequestIds() {
+    return new Set(this.metadataByRequestId.keys());
+  }
+  clearTag(tag) {
+    const requestIds = [...this.requestIdsByTag.get(tag) ?? []];
+    this.requestIdsByTag.delete(tag);
+    for (const requestId of requestIds) {
+      const metadata = this.metadataByRequestId.get(requestId);
+      if (!metadata) {
+        continue;
+      }
+      metadata.tags.delete(tag);
+      if (metadata.tags.size === 0) {
+        this.tombstoneRequestIds([requestId]);
+      }
+    }
+  }
+  tombstoneRequestIds(requestIds) {
+    for (const requestId of requestIds) {
+      this.tombstonedRequestIds.add(requestId);
+      const metadata = this.metadataByRequestId.get(requestId);
+      if (!metadata) {
+        continue;
+      }
+      this.metadataByRequestId.delete(requestId);
+      this.requestIdByRecordId.delete(metadata.recordId);
+      if (metadata.actionId !== void 0) {
+        this.requestIdsByActionId.get(metadata.actionId)?.delete(requestId);
+      }
+      for (const tag of metadata.tags) {
+        this.requestIdsByTag.get(tag)?.delete(requestId);
+      }
+    }
+  }
   clear() {
     this.metadataByRequestId.clear();
     this.requestIdByRecordId.clear();
     this.requestIdsByActionId.clear();
     this.requestIdsByTag.clear();
+    this.tombstonedRequestIds.clear();
+  }
+  materializeRecord(record, observedAt, options) {
+    if (this.tombstonedRequestIds.has(record.requestId)) {
+      return void 0;
+    }
+    let metadata = this.metadataByRequestId.get(record.requestId);
+    if (!metadata) {
+      metadata = {
+        recordId: `record:${crypto.randomUUID()}`,
+        observedAt,
+        ...record.pageRef === void 0 ? {} : { pageRef: record.pageRef },
+        tags: /* @__PURE__ */ new Set()
+      };
+      this.metadataByRequestId.set(record.requestId, metadata);
+      this.requestIdByRecordId.set(metadata.recordId, record.requestId);
+    } else if (metadata.pageRef === void 0 && record.pageRef !== void 0) {
+      metadata.pageRef = record.pageRef;
+    }
+    return {
+      recordId: metadata.recordId,
+      ...metadata.actionId === void 0 ? {} : { actionId: metadata.actionId },
+      ...metadata.tags.size === 0 ? {} : { tags: [...metadata.tags].sort() },
+      ...metadata.savedAt === void 0 ? {} : { savedAt: metadata.savedAt },
+      record: toProtocolNetworkRecord(record, {
+        redactSecretHeaders: options.redactSecretHeaders ?? true
+      })
+    };
   }
   addIndexedRequestId(index, key, requestId) {
     const requestIds = index.get(key) ?? /* @__PURE__ */ new Set();
@@ -22355,12 +22488,11 @@ var OpensteerSessionRuntime = class {
   engine;
   dom;
   computer;
-  networkJournal = new NetworkJournal();
+  networkHistory = new NetworkHistory();
   extractionDescriptors;
   sessionRef;
   pageRef;
   runId;
-  backgroundNetworkPersistence = /* @__PURE__ */ new Set();
   cookieJars = /* @__PURE__ */ new Map();
   recipeCache = /* @__PURE__ */ new Map();
   ownsEngine = false;
@@ -22790,19 +22922,28 @@ var OpensteerSessionRuntime = class {
       const output = await this.runWithOperationTimeout(
         "page.evaluate",
         async (timeout) => {
-          const remainingMs = timeout.remainingMs();
-          const evaluated = await timeout.runStep(
-            () => this.requireEngine().evaluatePage({
+          const baselineRequestIds = await this.beginMutationCapture(timeout);
+          try {
+            const remainingMs = timeout.remainingMs();
+            const evaluated = await timeout.runStep(
+              () => this.requireEngine().evaluatePage({
+                pageRef,
+                script: input.script,
+                ...input.args === void 0 ? {} : { args: input.args },
+                ...remainingMs === void 0 ? {} : { timeoutMs: remainingMs }
+              })
+            );
+            await this.completeMutationCapture(timeout, baselineRequestIds, void 0);
+            return {
               pageRef,
-              script: input.script,
-              ...input.args === void 0 ? {} : { args: input.args },
-              ...remainingMs === void 0 ? {} : { timeoutMs: remainingMs }
-            })
-          );
-          return {
-            pageRef,
-            value: toJsonValueOrNull(evaluated.data)
-          };
+              value: toJsonValueOrNull(evaluated.data)
+            };
+          } catch (error) {
+            await this.completeMutationCapture(timeout, baselineRequestIds, void 0).catch(
+              () => void 0
+            );
+            throw error;
+          }
         },
         options
       );
@@ -23166,38 +23307,19 @@ var OpensteerSessionRuntime = class {
   }
   async queryNetwork(input = {}, options = {}) {
     assertValidSemanticOperationInput("network.query", input);
-    if (input.source !== "saved") {
-      await this.ensurePageRef();
-    }
     const root = await this.ensureRoot();
     const startedAt = Date.now();
     try {
       const output = await this.runWithOperationTimeout(
         "network.query",
         async (timeout) => {
-          if (input.source === "saved") {
-            await timeout.runStep(() => this.flushBackgroundNetworkPersistence());
-            return {
-              records: await timeout.runStep(
-                () => root.registry.savedNetwork.query({
-                  ...input.recordId === void 0 ? {} : { recordId: input.recordId },
-                  ...input.requestId === void 0 ? {} : { requestId: input.requestId },
-                  ...input.actionId === void 0 ? {} : { actionId: input.actionId },
-                  ...input.tag === void 0 ? {} : { tag: input.tag },
-                  ...input.url === void 0 ? {} : { url: input.url },
-                  ...input.hostname === void 0 ? {} : { hostname: input.hostname },
-                  ...input.path === void 0 ? {} : { path: input.path },
-                  ...input.method === void 0 ? {} : { method: input.method },
-                  ...input.status === void 0 ? {} : { status: input.status },
-                  ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType },
-                  ...input.includeBodies === void 0 ? {} : { includeBodies: input.includeBodies },
-                  ...input.limit === void 0 ? {} : { limit: input.limit }
-                })
-              )
-            };
-          }
+          await this.syncPersistedNetworkSelection(timeout, input, {
+            includeBodies: input.includeBodies ?? false
+          });
           return {
-            records: await this.queryLiveNetwork(input, timeout)
+            records: await timeout.runStep(
+              () => root.registry.savedNetwork.query(this.toSavedNetworkQueryInput(input))
+            )
           };
         },
         options
@@ -23208,7 +23330,6 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "ok",
         data: {
-          source: input.source ?? "live",
           includeBodies: input.includeBodies ?? false,
           limit: input.limit ?? 50,
           count: output.records.length
@@ -23234,56 +23355,42 @@ var OpensteerSessionRuntime = class {
       throw error;
     }
   }
-  async saveNetwork(input, options = {}) {
-    assertValidSemanticOperationInput("network.save", input);
-    await this.ensurePageRef();
+  async tagNetwork(input, options = {}) {
+    assertValidSemanticOperationInput("network.tag", input);
     const root = await this.ensureRoot();
+    const filter = this.toQueryInputFromTagInput(input);
+    const savedFilter = this.toSavedNetworkQueryInput(filter);
     const startedAt = Date.now();
     try {
       const output = await this.runWithOperationTimeout(
-        "network.save",
+        "network.tag",
         async (timeout) => {
-          const records = await this.queryLiveNetwork(
-            {
-              includeBodies: true,
-              source: "live",
-              ...input.pageRef === void 0 ? {} : { pageRef: input.pageRef },
-              ...input.recordId === void 0 ? {} : { recordId: input.recordId },
-              ...input.requestId === void 0 ? {} : { requestId: input.requestId },
-              ...input.actionId === void 0 ? {} : { actionId: input.actionId },
-              ...input.url === void 0 ? {} : { url: input.url },
-              ...input.hostname === void 0 ? {} : { hostname: input.hostname },
-              ...input.path === void 0 ? {} : { path: input.path },
-              ...input.method === void 0 ? {} : { method: input.method },
-              ...input.status === void 0 ? {} : { status: input.status },
-              ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType }
-            },
-            timeout,
-            { ignoreLimit: true, redactSecretHeaders: false }
-          );
-          this.networkJournal.addTag(records, input.tag);
+          const records = await this.syncPersistedNetworkSelection(timeout, filter, {
+            includeBodies: false
+          });
+          this.networkHistory.addTag(records, input.tag);
           return {
-            savedCount: await timeout.runStep(
-              () => root.registry.savedNetwork.save(records, input.tag)
+            taggedCount: await timeout.runStep(
+              () => root.registry.savedNetwork.tagByFilter(savedFilter, input.tag)
             )
           };
         },
         options
       );
       await this.appendTrace({
-        operation: "network.save",
+        operation: "network.tag",
         startedAt,
         completedAt: Date.now(),
         outcome: "ok",
         data: {
           tag: input.tag,
-          savedCount: output.savedCount
+          taggedCount: output.taggedCount
         }
       });
       return output;
     } catch (error) {
       await this.appendTrace({
-        operation: "network.save",
+        operation: "network.tag",
         startedAt,
         completedAt: Date.now(),
         outcome: "error",
@@ -23300,7 +23407,19 @@ var OpensteerSessionRuntime = class {
       const output = await this.runWithOperationTimeout(
         "network.clear",
         async (timeout) => {
-          await timeout.runStep(() => this.flushBackgroundNetworkPersistence());
+          if (this.sessionRef !== void 0) {
+            const liveRequestIds = await this.readLiveRequestIds(timeout, {
+              includeCurrentPageOnly: false
+            });
+            if (input.tag === void 0) {
+              this.networkHistory.tombstoneRequestIds(liveRequestIds);
+            }
+          }
+          if (input.tag === void 0) {
+            this.networkHistory.tombstoneRequestIds(this.networkHistory.getKnownRequestIds());
+          } else {
+            this.networkHistory.clearTag(input.tag);
+          }
           return {
             clearedCount: await timeout.runStep(() => root.registry.savedNetwork.clear(input))
           };
@@ -24017,7 +24136,6 @@ var OpensteerSessionRuntime = class {
     });
     const networkRecords = await this.queryLiveNetwork(
       {
-        source: "live",
         pageRef,
         ...input.network?.url === void 0 ? {} : { url: input.network.url },
         ...input.network?.hostname === void 0 ? {} : { hostname: input.network.hostname },
@@ -24033,7 +24151,7 @@ var OpensteerSessionRuntime = class {
     );
     const persistedNetwork = filterReverseObservationWindow(
       networkRecords.filter(isReverseRelevantNetworkRecord),
-      this.networkJournal,
+      this.networkHistory,
       input.captureWindowMs
     );
     const fallbackSavedNetwork = persistedNetwork.length === 0 ? (await root.registry.savedNetwork.query({
@@ -24048,7 +24166,10 @@ var OpensteerSessionRuntime = class {
     const observationId = `observation:${crypto.randomUUID()}`;
     const networkTag = `reverse-case:${caseRecord.id}:${observationId}`;
     if (observationNetwork.length > 0) {
-      await root.registry.savedNetwork.save(observationNetwork, networkTag);
+      await root.registry.savedNetwork.save(observationNetwork, {
+        tag: networkTag,
+        bodyWriteMode: input.network?.includeBodies === false ? "metadata-only" : "authoritative"
+      });
     }
     const scriptArtifactIds = input.includeScripts === false ? [] : (await this.captureScriptsInternal(
       pageRef,
@@ -24144,7 +24265,7 @@ var OpensteerSessionRuntime = class {
             includeBodies: true,
             redactSecretHeaders: false
           }),
-          observedAt: this.networkJournal.getObservedAt(recordId)
+          observedAt: this.networkHistory.getObservedAt(recordId)
         }))
       );
       const clusteredRecords = observationRecords.map((entry) => {
@@ -25084,7 +25205,10 @@ var OpensteerSessionRuntime = class {
           timeout.signal
         )).filter((record) => !baselineRequestIds.has(record.record.requestId));
         if (deltaRecords.length > 0) {
-          await root.registry.savedNetwork.save(deltaRecords, `interaction:${pageRef}`);
+          await root.registry.savedNetwork.save(deltaRecords, {
+            tag: `interaction:${pageRef}`,
+            bodyWriteMode: "authoritative"
+          });
         }
         const trace = await root.registry.interactionTraces.write({
           key: input.key ?? buildInteractionTraceKey(pageInfo.url),
@@ -25427,7 +25551,7 @@ var OpensteerSessionRuntime = class {
             includeBodies: true
           });
           const inferred = inferRequestPlanFromNetworkRecord(source, input, {
-            ...this.networkJournal.getObservedAt(source.recordId) === void 0 ? {} : { observedAt: this.networkJournal.getObservedAt(source.recordId) }
+            ...this.networkHistory.getObservedAt(source.recordId) === void 0 ? {} : { observedAt: this.networkHistory.getObservedAt(source.recordId) }
           });
           return timeout.runStep(
             () => root.registry.requestPlans.write({
@@ -26239,7 +26363,7 @@ var OpensteerSessionRuntime = class {
       await this.runWithOperationTimeout(
         "session.close",
         async (timeout) => {
-          await timeout.runStep(() => this.flushBackgroundNetworkPersistence());
+          await timeout.runStep(() => this.flushPersistedNetworkHistory());
           if (engine === void 0) {
             return;
           }
@@ -26308,10 +26432,7 @@ var OpensteerSessionRuntime = class {
   }
   async disconnect() {
     try {
-      await this.flushBackgroundNetworkPersistence();
-      if (this.sessionRef !== void 0 && this.pageRef !== void 0) {
-        await this.saveNetwork({ tag: "auto" }).catch(() => void 0);
-      }
+      await this.flushPersistedNetworkHistory();
     } finally {
       await this.resetRuntimeState({
         disposeEngine: true
@@ -26403,7 +26524,10 @@ var OpensteerSessionRuntime = class {
       };
     }
     if (target.kind === "element") {
-      const elementTarget = { kind: "selector", selector: `[c="${String(target.element)}"]` };
+      const elementTarget = {
+        kind: "selector",
+        selector: `[c="${String(target.element)}"]`
+      };
       const resolved2 = await timeout.runStep(
         () => this.requireDom().resolveTarget({
           pageRef,
@@ -26466,11 +26590,11 @@ var OpensteerSessionRuntime = class {
     };
   }
   async queryLiveNetwork(input, timeout, options = {}) {
-    const requestIds = resolveLiveQueryRequestIds(input, this.networkJournal);
+    const requestIds = resolveLiveQueryRequestIds(input, this.networkHistory);
     if (requestIds !== void 0 && requestIds.length === 0) {
       return [];
     }
-    const pageRef = resolveLiveQueryPageRef(input, this.pageRef, requestIds, this.networkJournal);
+    const pageRef = resolveLiveQueryPageRef(input, this.pageRef, requestIds, this.networkHistory);
     const includeCurrentPageOnly = pageRef === void 0 && input.recordId === void 0;
     const metadataRecords = await timeout.runStep(
       () => this.readLiveNetworkRecords(
@@ -26497,7 +26621,7 @@ var OpensteerSessionRuntime = class {
       ...input.status === void 0 ? {} : { status: input.status },
       ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType }
     });
-    const sorted = sortLiveNetworkRecords(filtered, this.networkJournal);
+    const sorted = sortLiveNetworkRecords(filtered, this.networkHistory);
     const limit = options.ignoreLimit ? sorted.length : Math.max(1, Math.min(input.limit ?? 50, 200));
     const limited = sorted.slice(0, limit);
     if (!(input.includeBodies ?? false) || limited.length === 0) {
@@ -26713,21 +26837,40 @@ var OpensteerSessionRuntime = class {
     if (delta.length === 0) {
       return;
     }
-    this.networkJournal.assignActionId(delta, `action:${crypto.randomUUID()}`);
-    if (networkTag === void 0) {
-      return;
+    this.networkHistory.assignActionId(delta, `action:${crypto.randomUUID()}`);
+    if (networkTag !== void 0) {
+      this.networkHistory.addTag(delta, networkTag);
     }
-    this.networkJournal.addTag(delta, networkTag);
-    this.scheduleBackgroundNetworkSaveByRequestIds(
+    await this.persistLiveRequestIds(
       delta.map((record) => record.record.requestId),
-      networkTag
+      timeout,
+      {
+        includeCurrentPageOnly: true
+      }
     );
   }
   async resolveNetworkRecordByRecordId(recordId, timeout, options) {
     const root = await this.ensureRoot();
+    await this.syncPersistedNetworkSelection(
+      timeout,
+      {
+        recordId,
+        includeBodies: options.includeBodies
+      },
+      {
+        includeBodies: options.includeBodies
+      }
+    );
+    const saved = await timeout.runStep(
+      () => root.registry.savedNetwork.getByRecordId(recordId, {
+        includeBodies: options.includeBodies
+      })
+    );
+    if (saved) {
+      return saved;
+    }
     const live = await this.queryLiveNetwork(
       {
-        source: "live",
         recordId,
         includeBodies: options.includeBodies,
         limit: 1
@@ -26738,24 +26881,15 @@ var OpensteerSessionRuntime = class {
         ...options.redactSecretHeaders === void 0 ? {} : { redactSecretHeaders: options.redactSecretHeaders }
       }
     );
-    if (live.length > 0) {
+    if (live[0] !== void 0) {
       return live[0];
     }
-    await timeout.runStep(() => this.flushBackgroundNetworkPersistence());
-    const saved = await timeout.runStep(
-      () => root.registry.savedNetwork.getByRecordId(recordId, {
-        includeBodies: options.includeBodies
-      })
-    );
-    if (!saved) {
-      throw new OpensteerProtocolError("not-found", `network record ${recordId} was not found`, {
-        details: {
-          recordId,
-          kind: "network-record"
-        }
-      });
-    }
-    return saved;
+    throw new OpensteerProtocolError("not-found", `network record ${recordId} was not found`, {
+      details: {
+        recordId,
+        kind: "network-record"
+      }
+    });
   }
   resolveCurrentStateSource() {
     const ownership = this.sessionInfoBase.provider?.ownership;
@@ -26995,7 +27129,6 @@ var OpensteerSessionRuntime = class {
       timeout.throwIfAborted();
       const records = await this.queryLiveNetwork(
         {
-          source: "live",
           pageRef,
           url,
           method,
@@ -27026,7 +27159,6 @@ var OpensteerSessionRuntime = class {
       timeout.throwIfAborted();
       const records = await this.queryLiveNetwork(
         {
-          source: "live",
           pageRef,
           ...filter.url === void 0 ? {} : { url: filter.url },
           ...filter.host === void 0 ? {} : { hostname: filter.host },
@@ -27092,12 +27224,12 @@ var OpensteerSessionRuntime = class {
       };
     }
   }
-  async readLiveNetworkRecords(input, signal) {
+  async readBrowserNetworkRecords(input, signal) {
     const sessionRef = this.sessionRef;
     if (!sessionRef) {
       throw new Error("Opensteer session is not initialized");
     }
-    const records = await this.requireEngine().getNetworkRecords({
+    return this.requireEngine().getNetworkRecords({
       sessionRef,
       ...input.includeCurrentPageOnly === false || input.pageRef !== void 0 ? input.pageRef === void 0 ? {} : { pageRef: input.pageRef } : this.pageRef === void 0 ? {} : { pageRef: this.pageRef },
       ...input.requestIds === void 0 ? {} : { requestIds: input.requestIds },
@@ -27110,10 +27242,102 @@ var OpensteerSessionRuntime = class {
       includeBodies: input.includeBodies,
       signal
     });
-    return this.networkJournal.sync(records, {
+  }
+  async readLiveNetworkRecords(input, signal) {
+    const records = await this.readBrowserNetworkRecords(input, signal);
+    return this.networkHistory.materialize(records, {
       redactSecretHeaders: input.redactSecretHeaders ?? true
     });
   }
+  async persistLiveRequestIds(requestIds, timeout, options) {
+    if (requestIds.length === 0) {
+      return [];
+    }
+    const root = await this.ensureRoot();
+    const browserRecords = await timeout.runStep(
+      () => this.readBrowserNetworkRecords(
+        {
+          includeBodies: true,
+          includeCurrentPageOnly: options.includeCurrentPageOnly,
+          ...options.pageRef === void 0 ? {} : { pageRef: options.pageRef },
+          requestIds
+        },
+        timeout.signal
+      )
+    );
+    return timeout.runStep(
+      () => this.networkHistory.persist(browserRecords, root.registry.savedNetwork, {
+        bodyWriteMode: "authoritative",
+        redactSecretHeaders: false
+      })
+    );
+  }
+  async syncPersistedNetworkSelection(timeout, input, options) {
+    if (this.sessionRef === void 0) {
+      return [];
+    }
+    const requestIds = resolveLiveQueryRequestIds(input, this.networkHistory);
+    if (requestIds !== void 0 && requestIds.length === 0) {
+      return [];
+    }
+    const pageRef = resolveLiveQueryPageRef(input, this.pageRef, requestIds, this.networkHistory);
+    const includeCurrentPageOnly = pageRef === void 0 && input.recordId === void 0;
+    const browserRecords = await timeout.runStep(
+      () => this.readBrowserNetworkRecords(
+        {
+          ...pageRef === void 0 ? {} : { pageRef },
+          ...requestIds === void 0 ? {} : { requestIds },
+          ...input.url === void 0 ? {} : { url: input.url },
+          ...input.hostname === void 0 ? {} : { hostname: input.hostname },
+          ...input.path === void 0 ? {} : { path: input.path },
+          ...input.method === void 0 ? {} : { method: input.method },
+          ...input.status === void 0 ? {} : { status: input.status },
+          ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType },
+          includeBodies: options.includeBodies,
+          includeCurrentPageOnly
+        },
+        timeout.signal
+      )
+    );
+    const root = await this.ensureRoot();
+    return timeout.runStep(
+      () => this.networkHistory.persist(browserRecords, root.registry.savedNetwork, {
+        bodyWriteMode: options.includeBodies ? "authoritative" : "metadata-only",
+        redactSecretHeaders: false
+      })
+    );
+  }
+  toSavedNetworkQueryInput(input) {
+    return {
+      ...input.pageRef === void 0 ? {} : { pageRef: input.pageRef },
+      ...input.recordId === void 0 ? {} : { recordId: input.recordId },
+      ...input.requestId === void 0 ? {} : { requestId: input.requestId },
+      ...input.actionId === void 0 ? {} : { actionId: input.actionId },
+      ...input.tag === void 0 ? {} : { tag: input.tag },
+      ...input.url === void 0 ? {} : { url: input.url },
+      ...input.hostname === void 0 ? {} : { hostname: input.hostname },
+      ...input.path === void 0 ? {} : { path: input.path },
+      ...input.method === void 0 ? {} : { method: input.method },
+      ...input.status === void 0 ? {} : { status: input.status },
+      ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType },
+      ...input.includeBodies === void 0 ? {} : { includeBodies: input.includeBodies },
+      ...input.limit === void 0 ? {} : { limit: input.limit }
+    };
+  }
+  toQueryInputFromTagInput(input) {
+    return {
+      ...input.pageRef === void 0 ? {} : { pageRef: input.pageRef },
+      ...input.recordId === void 0 ? {} : { recordId: input.recordId },
+      ...input.requestId === void 0 ? {} : { requestId: input.requestId },
+      ...input.actionId === void 0 ? {} : { actionId: input.actionId },
+      ...input.url === void 0 ? {} : { url: input.url },
+      ...input.hostname === void 0 ? {} : { hostname: input.hostname },
+      ...input.path === void 0 ? {} : { path: input.path },
+      ...input.method === void 0 ? {} : { method: input.method },
+      ...input.status === void 0 ? {} : { status: input.status },
+      ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType }
+    };
+  }
   async readLiveRequestIds(timeout, options) {
     const records = await timeout.runStep(
       () => this.readLiveNetworkRecords(
@@ -27137,7 +27361,17 @@ var OpensteerSessionRuntime = class {
       )
     );
     const delta = records.filter((record) => !baselineRequestIds.has(record.record.requestId));
-    return sortLiveNetworkRecords(delta, this.networkJournal)[0]?.recordId;
+    if (delta.length === 0) {
+      return void 0;
+    }
+    await this.persistLiveRequestIds(
+      delta.map((record) => record.record.requestId),
+      timeout,
+      {
+        includeCurrentPageOnly: options.includeCurrentPageOnly
+      }
+    );
+    return sortLiveNetworkRecords(delta, this.networkHistory)[0]?.recordId;
   }
   async executeTransportRequestWithJournal(request, timeout, sessionRef) {
     const baselineRequestIds = await this.readLiveRequestIds(timeout, {
@@ -27421,7 +27655,6 @@ var OpensteerSessionRuntime = class {
     const syntheticSessionRef = binding?.sessionRef ?? createSessionRef(`${transportLabel}-${this.workspace}`);
     const record = {
       recordId,
-      source: "saved",
       savedAt: now,
       record: {
         kind: "http",
@@ -27443,7 +27676,10 @@ var OpensteerSessionRuntime = class {
         ...response.body === void 0 ? {} : { responseBody: toProtocolBodyPayload(response.body) }
       }
     };
-    await root.registry.savedNetwork.save([record], tag);
+    await root.registry.savedNetwork.save([record], {
+      bodyWriteMode: "authoritative",
+      ...tag === void 0 ? {} : { tag }
+    });
     return recordId;
   }
   async executeResolvedRequestPlan(plan, input, timeout, binding) {
@@ -27816,7 +28052,6 @@ var OpensteerSessionRuntime = class {
         const record = await pollUntilResult(timeout, async () => {
           const matches = await this.queryLiveNetwork(
             {
-              source: "live",
               ...step.url === void 0 ? {} : { url: interpolateTemplate(step.url, variables) },
               ...step.hostname === void 0 ? {} : { hostname: interpolateTemplate(step.hostname, variables) },
               ...step.path === void 0 ? {} : { path: interpolateTemplate(step.path, variables) },
@@ -28274,37 +28509,7 @@ var OpensteerSessionRuntime = class {
     const pageUrl = step.pageUrl === void 0 ? void 0 : interpolateTemplate(step.pageUrl, variables);
     return snapshot.sessionStorage?.filter((entry) => entry.origin === origin).find((entry) => pageUrl === void 0 || entry.origin === new URL(pageUrl).origin)?.entries.find((entry) => entry.key === key)?.value;
   }
-  scheduleBackgroundNetworkSaveByRequestIds(requestIds, tag) {
-    const task = (async () => {
-      const root = await this.ensureRoot();
-      const requestIdSet = new Set(requestIds);
-      const records = await this.readLiveNetworkRecords(
-        {
-          includeBodies: true,
-          includeCurrentPageOnly: false,
-          ...this.pageRef === void 0 ? {} : { pageRef: this.pageRef },
-          requestIds,
-          redactSecretHeaders: false
-        },
-        new AbortController().signal
-      );
-      const filtered = records.filter((record) => requestIdSet.has(record.record.requestId));
-      if (filtered.length === 0) {
-        return;
-      }
-      await root.registry.savedNetwork.save(filtered, tag);
-    })();
-    this.backgroundNetworkPersistence.add(task);
-    task.finally(() => {
-      this.backgroundNetworkPersistence.delete(task);
-    });
-    void task.catch(() => void 0);
-  }
-  async flushBackgroundNetworkPersistence() {
-    if (this.backgroundNetworkPersistence.size === 0) {
-      return;
-    }
-    await Promise.all([...this.backgroundNetworkPersistence]);
+  async flushPersistedNetworkHistory() {
   }
   toDomTargetRef(target) {
     if (target.kind === "description") {
@@ -28339,7 +28544,9 @@ var OpensteerSessionRuntime = class {
             ...workspace.registry,
             ...overrides.requestPlans === void 0 ? {} : { requestPlans: overrides.requestPlans },
             ...overrides.authRecipes === void 0 ? {} : { authRecipes: overrides.authRecipes },
-            ...overrides.recipes === void 0 ? {} : { recipes: overrides.recipes }
+            ...overrides.recipes === void 0 ? {} : { recipes: overrides.recipes },
+            ...overrides.reverseCases === void 0 ? {} : { reverseCases: overrides.reverseCases },
+            ...overrides.reversePackages === void 0 ? {} : { reversePackages: overrides.reversePackages }
           }
         };
       } else {
@@ -28596,8 +28803,7 @@ var OpensteerSessionRuntime = class {
   }
   async resetRuntimeState(options) {
     const engine = this.engine;
-    this.networkJournal.clear();
-    this.backgroundNetworkPersistence.clear();
+    this.networkHistory.clear();
     this.sessionRef = void 0;
     this.pageRef = void 0;
     this.runId = void 0;
@@ -28673,10 +28879,10 @@ function buildEngineNetworkRecordFilters(input) {
     ...input.resourceType === void 0 ? {} : { resourceType: input.resourceType }
   };
 }
-function resolveLiveQueryRequestIds(input, journal) {
+function resolveLiveQueryRequestIds(input, history) {
   const requestIdCandidates = [];
   if (input.recordId !== void 0) {
-    const requestId = journal.getRequestId(input.recordId);
+    const requestId = history.getRequestId(input.recordId);
     if (requestId === void 0) {
       return [];
     }
@@ -28686,24 +28892,24 @@ function resolveLiveQueryRequestIds(input, journal) {
     requestIdCandidates.push(/* @__PURE__ */ new Set([input.requestId]));
   }
   if (input.actionId !== void 0) {
-    requestIdCandidates.push(journal.getRequestIdsForActionId(input.actionId));
+    requestIdCandidates.push(history.getRequestIdsForActionId(input.actionId));
   }
   if (input.tag !== void 0) {
-    requestIdCandidates.push(journal.getRequestIdsForTag(input.tag));
+    requestIdCandidates.push(history.getRequestIdsForTag(input.tag));
   }
   if (requestIdCandidates.length === 0) {
     return void 0;
   }
   return intersectRequestIdSets(requestIdCandidates);
 }
-function resolveLiveQueryPageRef(input, currentPageRef, requestIds, journal) {
+function resolveLiveQueryPageRef(input, currentPageRef, requestIds, history) {
   const requestedPageRef = selectLiveQueryPageRef(input, currentPageRef);
   if (requestedPageRef !== void 0 || requestIds === void 0) {
     return requestedPageRef;
   }
   const pageRefs = /* @__PURE__ */ new Set();
   for (const requestId of requestIds) {
-    const pageRef = journal.getPageRefForRequestId(requestId);
+    const pageRef = history.getPageRefForRequestId(requestId);
     if (pageRef === void 0) {
       continue;
     }
@@ -28745,10 +28951,10 @@ function filterNetworkQueryRecords(records, input) {
     return true;
   });
 }
-function sortLiveNetworkRecords(records, journal) {
+function sortLiveNetworkRecords(records, history) {
   return [...records].sort((left, right) => {
-    const leftObservedAt = journal.getObservedAt(left.recordId) ?? 0;
-    const rightObservedAt = journal.getObservedAt(right.recordId) ?? 0;
+    const leftObservedAt = history.getObservedAt(left.recordId) ?? 0;
+    const rightObservedAt = history.getObservedAt(right.recordId) ?? 0;
     if (leftObservedAt !== rightObservedAt) {
       return rightObservedAt - leftObservedAt;
     }
@@ -28955,7 +29161,7 @@ function buildMinimizedRequestPlan(input) {
     provenance: {
       source: "network-minimize",
       sourceId: input.record.recordId,
-      ...input.record.source === "saved" && input.record.savedAt !== void 0 ? { capturedAt: input.record.savedAt } : {}
+      ...input.record.savedAt === void 0 ? {} : { capturedAt: input.record.savedAt }
     },
     payload: normalizeRequestPlanPayload({
       transport: {
@@ -29174,12 +29380,12 @@ function originFromUrl(url) {
     return void 0;
   }
 }
-function filterReverseObservationWindow(records, journal, captureWindowMs) {
+function filterReverseObservationWindow(records, history, captureWindowMs) {
   if (captureWindowMs === void 0) {
     return records;
   }
   const observedAfter = Date.now() - captureWindowMs;
-  return records.filter((record) => (journal.getObservedAt(record.recordId) ?? 0) >= observedAfter);
+  return records.filter((record) => (history.getObservedAt(record.recordId) ?? 0) >= observedAfter);
 }
 function isReverseRelevantNetworkRecord(record) {
   return record.record.resourceType === "document" || record.record.resourceType === "fetch" || record.record.resourceType === "xhr" || record.record.resourceType === "websocket" || record.record.resourceType === "event-stream";
@@ -31186,6 +31392,7 @@ var OpensteerRuntime = class extends OpensteerSessionRuntime {
         ...options.policy === void 0 ? {} : { policy: options.policy },
         ...options.descriptorStore === void 0 ? {} : { descriptorStore: options.descriptorStore },
         ...options.extractionDescriptorStore === void 0 ? {} : { extractionDescriptorStore: options.extractionDescriptorStore },
+        ...options.registryOverrides === void 0 ? {} : { registryOverrides: options.registryOverrides },
         cleanupRootOnClose
       })
     );
@@ -31214,6 +31421,7 @@ var OpensteerSessionRuntime2 = class extends OpensteerSessionRuntime {
         ...options.policy === void 0 ? {} : { policy: options.policy },
         ...options.descriptorStore === void 0 ? {} : { descriptorStore: options.descriptorStore },
         ...options.extractionDescriptorStore === void 0 ? {} : { extractionDescriptorStore: options.extractionDescriptorStore },
+        ...options.registryOverrides === void 0 ? {} : { registryOverrides: options.registryOverrides },
         cleanupRootOnClose
       })
     );
@@ -31238,6 +31446,7 @@ function buildSharedRuntimeOptions(input) {
     ...input.policy === void 0 ? {} : { policy: input.policy },
     ...input.descriptorStore === void 0 ? {} : { descriptorStore: input.descriptorStore },
     ...input.extractionDescriptorStore === void 0 ? {} : { extractionDescriptorStore: input.extractionDescriptorStore },
+    ...input.registryOverrides === void 0 ? {} : { registryOverrides: input.registryOverrides },
     cleanupRootOnClose: input.cleanupRootOnClose,
     sessionInfo: {
       provider: {
@@ -31978,6 +32187,20 @@ var OpensteerCloudClient = class {
     });
     return await response.json();
   }
+  async importReverseCases(entries) {
+    const response = await this.request("/registry/reverse-cases/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
+  async importReversePackages(entries) {
+    const response = await this.request("/registry/reverse-packages/import", {
+      method: "POST",
+      body: { entries }
+    });
+    return await response.json();
+  }
   buildAuthorizationHeader() {
     return `Bearer ${this.config.apiKey}`;
   }
@@ -32493,11 +32716,13 @@ function asRecord(value) {
 var REGISTRY_SYNC_MAX_PAYLOAD_BYTES = 15e5;
 var REGISTRY_SYNC_MAX_ENTRIES_PER_BATCH = 100;
 async function syncLocalRegistryToCloud(client, workspace, store) {
-  const [descriptors, requestPlans, recipes, authRecipes] = await Promise.all([
+  const [descriptors, requestPlans, recipes, authRecipes, reverseCases, reversePackages] = await Promise.all([
     store.registry.descriptors.list(),
     store.registry.requestPlans.list(),
     store.registry.recipes.list(),
-    store.registry.authRecipes.list()
+    store.registry.authRecipes.list(),
+    store.registry.reverseCases.list(),
+    store.registry.reversePackages.list()
   ]);
   const descriptorEntries = descriptors.map((record) => toDescriptorImportEntry(workspace, record));
   await Promise.all([
@@ -32513,6 +32738,14 @@ async function syncLocalRegistryToCloud(client, workspace, store) {
     importInBatches(
       authRecipes.map((record) => toRegistryImportEntry(workspace, record)),
       (entries) => client.importAuthRecipes(entries)
+    ),
+    importInBatches(
+      reverseCases.map((record) => toRegistryImportEntry(workspace, record)),
+      (entries) => client.importReverseCases(entries)
+    ),
+    importInBatches(
+      reversePackages.map((record) => toRegistryImportEntry(workspace, record)),
+      (entries) => client.importReversePackages(entries)
     )
   ]);
 }
@@ -32722,9 +32955,9 @@ var CloudSessionProxy = class {
     await this.ensureSession();
     return this.requireClient().invoke("network.query", input);
   }
-  async saveNetwork(input) {
+  async tagNetwork(input) {
     await this.ensureSession();
-    return this.requireClient().invoke("network.save", input);
+    return this.requireClient().invoke("network.tag", input);
   }
   async minimizeNetwork(input) {
     await this.ensureSession();
@@ -33208,13 +33441,20 @@ var Opensteer = class {
     const { timeoutMs, pollIntervalMs, ...query } = input;
     const timeoutAt = Date.now() + (timeoutMs ?? 3e4);
     const pollInterval = pollIntervalMs ?? 100;
+    const baseline = new Set(
+      (await this.runtime.queryNetwork({
+        ...query,
+        limit: 200
+      })).records.map((record) => record.recordId)
+    );
     while (true) {
       const { records } = await this.runtime.queryNetwork({
         ...query,
-        limit: 1
+        limit: 200
       });
-      if (records[0] !== void 0) {
-        return records[0];
+      const next = records.find((record) => !baseline.has(record.recordId));
+      if (next !== void 0) {
+        return next;
       }
       if (Date.now() >= timeoutAt) {
         throw new Error("waitForNetwork timed out");
@@ -33255,8 +33495,8 @@ var Opensteer = class {
   async snapshot(input = {}) {
     return this.runtime.snapshot(typeof input === "string" ? { mode: input } : input);
   }
-  async saveNetwork(input) {
-    return this.runtime.saveNetwork(input);
+  async tagNetwork(input) {
+    return this.runtime.tagNetwork(input);
   }
   async minimizeNetwork(input) {
     return this.runtime.minimizeNetwork(input);