@opensteer/runtime-core 0.1.1 → 0.1.2

package/dist/index.js

@@ -13,7 +13,7 @@ import vm from 'vm';
 
 // package.json
 var package_default = {
-  version: "0.1.1"};
+  version: "0.1.2"};
 
 // src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -970,14 +970,10 @@ var networkRecordSchema = objectSchema(
     ]
   }
 );
-var networkQuerySourceSchema = enumSchema(["live", "saved"], {
-  title: "NetworkQuerySource"
-});
 var networkQueryRecordSchema = objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
-    source: networkQuerySourceSchema,
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tags: arraySchema(stringSchema({ minLength: 1 }), {
       uniqueItems: true
     }),
@@ -986,7 +982,7 @@ var networkQueryRecordSchema = objectSchema(
   },
   {
     title: "NetworkQueryRecord",
-    required: ["recordId", "source", "record"]
+    required: ["recordId", "record"]
   }
 );
 arraySchema(headerEntrySchema, {
@@ -1457,8 +1453,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     objectSchema(
       {
         kind: enumSchema(["goto"]),
-        url: stringSchema({ minLength: 1 }),
-        networkTag: stringSchema({ minLength: 1 })
+        url: stringSchema({ minLength: 1 })
       },
       {
         title: "OpensteerAuthRecipeGotoStep",
@@ -1467,8 +1462,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     ),
     objectSchema(
       {
-        kind: enumSchema(["reload"]),
-        networkTag: stringSchema({ minLength: 1 })
+        kind: enumSchema(["reload"])
       },
       {
         title: "OpensteerAuthRecipeReloadStep",
@@ -1682,13 +1676,10 @@ 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 }),
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 }),
     url: stringSchema({ minLength: 1 }),
     hostname: stringSchema({ minLength: 1 }),
@@ -1712,12 +1703,12 @@ var opensteerNetworkQueryOutputSchema = objectSchema(
     required: ["records"]
   }
 );
-var opensteerNetworkSaveInputSchema = objectSchema(
+var opensteerNetworkTagInputSchema = objectSchema(
   {
     pageRef: pageRefSchema,
     recordId: stringSchema({ minLength: 1 }),
     requestId: stringSchema({ minLength: 1 }),
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 }),
     url: stringSchema({ minLength: 1 }),
     hostname: stringSchema({ minLength: 1 }),
@@ -1727,21 +1718,22 @@ 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(
   {
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 })
   },
   {
@@ -5199,7 +5191,7 @@ var opensteerSemanticOperationNames = [
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -5260,7 +5252,7 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -5580,7 +5572,7 @@ var opensteerPageCloseOutputSchema = objectSchema(
 var opensteerPageGotoInputSchema = objectSchema(
   {
     url: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerPageGotoInput",
@@ -5731,7 +5723,7 @@ var opensteerDomClickInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomClickInput",
@@ -5742,7 +5734,7 @@ var opensteerDomHoverInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomHoverInput",
@@ -5755,7 +5747,7 @@ var opensteerDomInputInputSchema = objectSchema(
     text: stringSchema(),
     pressEnter: { type: "boolean" },
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomInputInput",
@@ -5768,7 +5760,7 @@ var opensteerDomScrollInputSchema = objectSchema(
     direction: enumSchema(["up", "down", "left", "right"]),
     amount: integerSchema({ minimum: 1 }),
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomScrollInput",
@@ -5969,7 +5961,7 @@ var opensteerComputerExecuteInputSchema = objectSchema(
   {
     action: opensteerComputerActionSchema,
     screenshot: opensteerComputerScreenshotOptionsSchema,
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerComputerExecuteInput",
@@ -6170,18 +6162,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",
@@ -7002,6 +6993,49 @@ function mediaTypeExtension(mediaType) {
   }
 }
 
+// src/action-boundary.ts
+var actionBoundaryDiagnosticsBySignal = /* @__PURE__ */ new WeakMap();
+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
+  };
+}
+function createActionBoundaryDiagnostics(input) {
+  return {
+    trigger: input.boundary.trigger,
+    crossDocument: input.boundary.crossDocument,
+    bootstrapSettled: input.boundary.bootstrapSettled,
+    visualSettled: input.visualSettled,
+    ...input.boundary.timedOutPhase !== void 0 ? { timedOutPhase: input.boundary.timedOutPhase } : !input.visualSettled ? { timedOutPhase: "visual" } : {}
+  };
+}
+function recordActionBoundaryDiagnostics(signal, diagnostics) {
+  actionBoundaryDiagnosticsBySignal.set(signal, diagnostics);
+}
+function takeActionBoundaryDiagnostics(signal) {
+  const diagnostics = actionBoundaryDiagnosticsBySignal.get(signal);
+  actionBoundaryDiagnosticsBySignal.delete(signal);
+  return diagnostics;
+}
+function isSoftSettleTimeoutError(error, signal) {
+  if (isTimeoutError(error)) {
+    return true;
+  }
+  return signal?.aborted === true && isTimeoutError(signal.reason) && (error === signal.reason || isAbortError(error));
+}
+function isAbortError(error) {
+  return error instanceof Error && error.name === "AbortError";
+}
+function isTimeoutError(error) {
+  return isOpensteerProtocolError(error) && error.code === "timeout";
+}
+
 // src/internal/errors.ts
 function normalizeThrownOpensteerError(error, fallbackMessage) {
   if (isOpensteerProtocolError(error)) {
@@ -7034,13 +7068,13 @@ var DEFAULT_TIMEOUTS = {
   "page.add-init-script": 1e4,
   "page.snapshot": 15e3,
   "computer.execute": 3e4,
-  "dom.click": 1e4,
+  "dom.click": 3e4,
   "dom.hover": 1e4,
-  "dom.input": 1e4,
+  "dom.input": 3e4,
   "dom.scroll": 1e4,
   "dom.extract": 15e3,
   "network.query": 15e3,
-  "network.save": 15e3,
+  "network.tag": 15e3,
   "network.clear": 1e4,
   "scripts.capture": 15e3,
   "request.raw": 3e4,
@@ -7855,7 +7889,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
@@ -7864,123 +7898,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)
@@ -8004,7 +7922,7 @@ var SqliteSavedNetworkStore = class {
           page_ref_key: pageRefKey,
           frame_ref: entry.record.frameRef ?? null,
           document_ref: entry.record.documentRef ?? null,
-          action_id: entry.actionId ?? null,
+          capture: entry.capture ?? null,
           method: entry.record.method,
           method_lc: entry.record.method.toLowerCase(),
           url: entry.record.url,
@@ -8036,10 +7954,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;
         }
@@ -8047,6 +7969,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));
@@ -8080,39 +8035,31 @@ var SqliteSavedNetworkStore = class {
   }
   async clear(input = {}) {
     const database = await this.requireDatabase();
-    const countAll = database.prepare(`
-      SELECT COUNT(*) AS cleared
-      FROM saved_network_records
-    `);
-    const countByTag = database.prepare(`
-      SELECT COUNT(DISTINCT record_id) AS cleared
-      FROM saved_network_tags
-      WHERE tag = @tag
-    `);
-    const deleteAllTags = database.prepare(`DELETE FROM saved_network_tags`);
+    const countAll = database.prepare(`SELECT COUNT(*) AS cleared FROM saved_network_records`);
     const deleteAllRecords = database.prepare(`DELETE FROM saved_network_records`);
-    const deleteTag = database.prepare(`
-      DELETE FROM saved_network_tags
-      WHERE tag = @tag
+    const { whereSql, parameters } = buildSavedNetworkWhere(input);
+    const countFiltered = database.prepare(`
+      SELECT COUNT(*) AS cleared
+      FROM saved_network_records r
+      ${whereSql}
     `);
-    const deleteOrphans = database.prepare(`
+    const deleteFiltered = database.prepare(`
       DELETE FROM saved_network_records
-      WHERE NOT EXISTS (
-        SELECT 1
-        FROM saved_network_tags t
-        WHERE t.record_id = saved_network_records.record_id
+      WHERE record_id IN (
+        SELECT r.record_id
+        FROM saved_network_records r
+        ${whereSql}
       )
     `);
     return withSqliteTransaction(database, () => {
-      const tag = input.tag;
-      const cleared = tag === void 0 ? countAll.get().cleared : countByTag.get({ tag }).cleared;
-      if (tag === void 0) {
-        deleteAllTags.run();
+      if (input.capture === void 0 && input.tag === void 0) {
+        const cleared2 = countAll.get().cleared;
         deleteAllRecords.run();
-        return cleared;
+        return cleared2;
       }
-      deleteTag.run({ tag });
-      deleteOrphans.run();
+      const args = parameters;
+      const cleared = countFiltered.get(...args).cleared;
+      deleteFiltered.run(...args);
       return cleared;
     });
   }
@@ -8167,7 +8114,7 @@ var SqliteSavedNetworkStore = class {
         page_ref_key TEXT NOT NULL,
         frame_ref TEXT,
         document_ref TEXT,
-        action_id TEXT,
+        capture TEXT,
         method TEXT NOT NULL,
         method_lc TEXT NOT NULL,
         url TEXT NOT NULL,
@@ -8206,6 +8153,9 @@ var SqliteSavedNetworkStore = class {
       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,
@@ -8221,6 +8171,7 @@ var SqliteSavedNetworkStore = class {
       "capture_state",
       "TEXT NOT NULL DEFAULT 'complete'"
     );
+    this.ensureColumn(database, "saved_network_records", "capture", "TEXT");
     this.ensureColumn(
       database,
       "saved_network_records",
@@ -8249,6 +8200,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);
@@ -8257,9 +8212,9 @@ function buildSavedNetworkWhere(input) {
     clauses.push("r.request_id = ?");
     parameters.push(input.requestId);
   }
-  if (input.actionId !== void 0) {
-    clauses.push("r.action_id = ?");
-    parameters.push(input.actionId);
+  if (input.capture !== void 0) {
+    clauses.push("r.capture = ?");
+    parameters.push(input.capture);
   }
   if (input.tag !== void 0) {
     clauses.push(`
@@ -8301,6 +8256,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,
+        capture,
+        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,
+        @capture,
+        @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,
+        capture = excluded.capture,
+        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;
@@ -8371,8 +8447,7 @@ function inflateSavedNetworkRow(row, includeBodies) {
   }
   return {
     recordId: row.record_id,
-    source: "saved",
-    ...row.action_id === null ? {} : { actionId: row.action_id },
+    ...row.capture === null ? {} : { capture: row.capture },
     ...row.tags === null || row.tags.length === 0 ? {} : { tags: row.tags.split(TAG_DELIMITER).filter((tag) => tag.length > 0) },
     savedAt: row.saved_at,
     record
@@ -10328,8 +10403,9 @@ var DomActionExecutor = class {
             })
           );
           let finalResolved = resolved;
+          let finalSnapshot;
           if (input.pressEnter) {
-            await this.settle(resolved.pageRef, "dom.input", timeout);
+            await this.waitForPressEnterReaction(timeout);
             const enterSession = this.options.createResolutionSession();
             const enterResolved = await timeout.runStep(
               () => this.options.resolveTarget(enterSession, {
@@ -10343,6 +10419,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"
@@ -10350,7 +10429,15 @@ var DomActionExecutor = class {
             );
             finalResolved = enterResolved;
           }
-          await this.settle(finalResolved.pageRef, "dom.input", timeout);
+          const settleDiagnostics = await this.settle(
+            finalResolved.pageRef,
+            "dom.input",
+            timeout,
+            finalSnapshot
+          );
+          if (finalSnapshot !== void 0) {
+            recordActionBoundaryDiagnostics(timeout.signal, settleDiagnostics);
+          }
           return finalResolved;
         } catch (error) {
           lastError = error;
@@ -10423,8 +10510,17 @@ 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);
+          const settleDiagnostics = await this.settle(
+            pointerTarget.resolved.pageRef,
+            input.operation,
+            timeout,
+            actionBoundarySnapshot
+          );
+          recordActionBoundaryDiagnostics(timeout.signal, settleDiagnostics);
           return outcome;
         } catch (error) {
           lastError = error;
@@ -10442,23 +10538,49 @@ 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(
+    let visualSettled = true;
+    const boundary = await timeout.runStep(
       () => bridge.finalizeDomAction(pageRef, {
         operation,
+        ...snapshot === void 0 ? {} : { snapshot },
         signal: timeout.signal,
         remainingMs: () => timeout.remainingMs(),
-        policySettle: (targetPageRef) => settleWithPolicy(this.options.policy.settle, {
-          operation,
-          trigger: "dom-action",
-          engine: this.options.engine,
-          pageRef: targetPageRef,
-          signal: timeout.signal,
-          remainingMs: timeout.remainingMs()
-        })
+        policySettle: async (targetPageRef, trigger) => {
+          try {
+            await settleWithPolicy(this.options.policy.settle, {
+              operation,
+              trigger,
+              engine: this.options.engine,
+              pageRef: targetPageRef,
+              signal: timeout.signal,
+              remainingMs: timeout.remainingMs()
+            });
+          } catch (error) {
+            if (snapshot !== void 0 && isSoftSettleTimeoutError(error, timeout.signal)) {
+              visualSettled = false;
+              return;
+            }
+            throw error;
+          }
+        }
       })
     );
+    return createActionBoundaryDiagnostics({
+      boundary,
+      visualSettled
+    });
+  }
+  async waitForPressEnterReaction(timeout) {
+    const delayMs = this.options.policy.settle.resolveDelayMs({
+      operation: "dom.input",
+      trigger: "dom-action"
+    });
+    if (delayMs <= 0) {
+      return;
+    }
+    await delayWithSignal(delayMs, timeout.signal);
   }
   requireBridge() {
     if (this.bridge !== void 0) {
@@ -11725,23 +11847,47 @@ 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)
+    );
+    let visualSettled = true;
     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, {
-          operation: "computer.execute",
-          trigger: "dom-action",
-          engine: this.options.engine,
-          pageRef,
-          signal: input.timeout.signal,
-          remainingMs: input.timeout.remainingMs()
-        })
+        policySettle: async (pageRef, trigger) => {
+          try {
+            await settleWithPolicy(this.options.policy.settle, {
+              operation: "computer.execute",
+              trigger,
+              engine: this.options.engine,
+              pageRef,
+              signal: input.timeout.signal,
+              remainingMs: input.timeout.remainingMs()
+            });
+          } catch (error) {
+            if (pageRef === input.pageRef && isSoftSettleTimeoutError(error, input.timeout.signal)) {
+              visualSettled = false;
+              return;
+            }
+            throw error;
+          }
+        }
       })
     );
+    if (executed.boundary !== void 0 && executed.pageRef === input.pageRef) {
+      recordActionBoundaryDiagnostics(
+        input.timeout.signal,
+        createActionBoundaryDiagnostics({
+          boundary: executed.boundary,
+          visualSettled
+        })
+      );
+    }
     let trace = void 0;
     if (!input.timeout.signal.aborted) {
       try {
@@ -11854,8 +12000,8 @@ async function dispatchSemanticOperation(runtime, operation, input, options = {}
         input,
         options
       );
-    case "network.save":
-      return runtime.saveNetwork(
+    case "network.tag":
+      return runtime.tagNetwork(
         input,
         options
       );
@@ -12729,9 +12875,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 }
@@ -13111,63 +13257,67 @@ function resolveBodyEncoding(charset) {
       return "utf8";
   }
 }
-var NetworkJournal = class {
+var NetworkHistory = class {
   metadataByRequestId = /* @__PURE__ */ new Map();
   requestIdByRecordId = /* @__PURE__ */ new Map();
-  requestIdsByActionId = /* @__PURE__ */ new Map();
+  requestIdsByCapture = /* @__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:${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) {
+  assignCapture(records, capture) {
     for (const record of records) {
       const metadata = this.metadataByRequestId.get(record.record.requestId);
-      if (!metadata || metadata.actionId === actionId) {
+      if (!metadata || metadata.capture === capture) {
         continue;
       }
-      if (metadata.actionId !== void 0) {
-        this.requestIdsByActionId.get(metadata.actionId)?.delete(record.record.requestId);
+      if (metadata.capture !== void 0) {
+        this.requestIdsByCapture.get(metadata.capture)?.delete(record.record.requestId);
       }
-      metadata.actionId = actionId;
-      this.addIndexedRequestId(this.requestIdsByActionId, actionId, record.record.requestId);
+      metadata.capture = capture;
+      this.addIndexedRequestId(this.requestIdsByCapture, capture, record.record.requestId);
     }
   }
   addTag(records, tag) {
@@ -13187,8 +13337,8 @@ var NetworkJournal = class {
   getRequestId(recordId) {
     return this.requestIdByRecordId.get(recordId);
   }
-  getRequestIdsForActionId(actionId) {
-    return new Set(this.requestIdsByActionId.get(actionId) ?? []);
+  getRequestIdsForCapture(capture) {
+    return new Set(this.requestIdsByCapture.get(capture) ?? []);
   }
   getRequestIdsForTag(tag) {
     return new Set(this.requestIdsByTag.get(tag) ?? []);
@@ -13196,11 +13346,59 @@ var NetworkJournal = class {
   getPageRefForRequestId(requestId) {
     return this.metadataByRequestId.get(requestId)?.pageRef;
   }
+  getKnownRequestIds() {
+    return new Set(this.metadataByRequestId.keys());
+  }
+  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.capture !== void 0) {
+        this.requestIdsByCapture.get(metadata.capture)?.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.requestIdsByCapture.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:${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.capture === void 0 ? {} : { capture: metadata.capture },
+      ...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();
@@ -19935,6 +20133,7 @@ function diffInteractionTraces(left, right) {
 
 // src/sdk/runtime.ts
 var requireForAuthRecipeHook = createRequire(import.meta.url);
+var MUTATION_CAPTURE_FINALIZE_TIMEOUT_MS = 5e3;
 var OpensteerSessionRuntime = class {
   workspace;
   rootPath;
@@ -19951,12 +20150,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;
@@ -20318,34 +20516,32 @@ var OpensteerSessionRuntime = class {
     assertValidSemanticOperationInput("page.goto", input);
     const pageRef = await this.ensurePageRef();
     const startedAt = Date.now();
+    let mutationCaptureDiagnostics;
     try {
-      const { navigation, state } = await this.runWithOperationTimeout(
+      const { navigation, state } = await this.runMutationCapturedOperation(
         "page.goto",
+        {
+          ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
+          options
+        },
         async (timeout) => {
-          const baselineRequestIds = await this.beginMutationCapture(timeout);
-          try {
-            const navigation2 = await this.navigatePage(
-              {
-                operation: "page.goto",
-                pageRef,
-                url: input.url
-              },
-              timeout
-            );
-            timeout.throwIfAborted();
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
-            return {
-              navigation: navigation2,
-              state: await timeout.runStep(() => this.readSessionState())
-            };
-          } catch (error) {
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag).catch(
-              () => void 0
-            );
-            throw error;
-          }
+          const navigation2 = await this.navigatePage(
+            {
+              operation: "page.goto",
+              pageRef,
+              url: input.url
+            },
+            timeout
+          );
+          timeout.throwIfAborted();
+          return {
+            navigation: navigation2,
+            state: await timeout.runStep(() => this.readSessionState())
+          };
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "page.goto",
@@ -20354,7 +20550,8 @@ var OpensteerSessionRuntime = class {
         outcome: "ok",
         data: {
           url: input.url,
-          state
+          state,
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
@@ -20370,6 +20567,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: buildMutationCaptureTraceData(mutationCaptureDiagnostics),
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -20382,9 +20580,11 @@ var OpensteerSessionRuntime = class {
     assertValidSemanticOperationInput("page.evaluate", input);
     const pageRef = input.pageRef ?? await this.ensurePageRef();
     const startedAt = Date.now();
+    let mutationCaptureDiagnostics;
     try {
-      const output = await this.runWithOperationTimeout(
+      const output = await this.runMutationCapturedOperation(
         "page.evaluate",
+        { options },
         async (timeout) => {
           const remainingMs = timeout.remainingMs();
           const evaluated = await timeout.runStep(
@@ -20400,7 +20600,9 @@ var OpensteerSessionRuntime = class {
             value: toJsonValueOrNull(evaluated.data)
           };
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "page.evaluate",
@@ -20409,7 +20611,8 @@ var OpensteerSessionRuntime = class {
         outcome: "ok",
         data: {
           pageRef: output.pageRef,
-          value: output.value
+          value: output.value,
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
@@ -20424,6 +20627,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: buildMutationCaptureTraceData(mutationCaptureDiagnostics),
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -20762,38 +20966,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
@@ -20804,7 +20989,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
@@ -20830,56 +21014,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",
@@ -20896,7 +21066,31 @@ var OpensteerSessionRuntime = class {
       const output = await this.runWithOperationTimeout(
         "network.clear",
         async (timeout) => {
-          await timeout.runStep(() => this.flushBackgroundNetworkPersistence());
+          if (this.sessionRef !== void 0) {
+            if (input.capture !== void 0 || input.tag !== void 0) {
+              const records = await this.queryLiveNetwork(
+                {
+                  ...input.capture === void 0 ? {} : { capture: input.capture },
+                  ...input.tag === void 0 ? {} : { tag: input.tag }
+                },
+                timeout,
+                {
+                  ignoreLimit: true
+                }
+              );
+              this.networkHistory.tombstoneRequestIds(
+                records.map((record) => record.record.requestId)
+              );
+            } else {
+              const liveRequestIds = await this.readLiveRequestIds(timeout, {
+                includeCurrentPageOnly: false
+              });
+              this.networkHistory.tombstoneRequestIds(liveRequestIds);
+            }
+          }
+          if (input.capture === void 0 && input.tag === void 0) {
+            this.networkHistory.tombstoneRequestIds(this.networkHistory.getKnownRequestIds());
+          }
           return {
             clearedCount: await timeout.runStep(() => root.registry.savedNetwork.clear(input))
           };
@@ -20909,6 +21103,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "ok",
         data: {
+          ...input.capture === void 0 ? {} : { capture: input.capture },
           ...input.tag === void 0 ? {} : { tag: input.tag },
           clearedCount: output.clearedCount
         }
@@ -21613,7 +21808,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 },
@@ -21629,7 +21823,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({
@@ -21644,7 +21838,10 @@ var OpensteerSessionRuntime = class {
     const observationId = `observation:${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,
@@ -21740,7 +21937,7 @@ var OpensteerSessionRuntime = class {
             includeBodies: true,
             redactSecretHeaders: false
           }),
-          observedAt: this.networkJournal.getObservedAt(recordId)
+          observedAt: this.networkHistory.getObservedAt(recordId)
         }))
       );
       const clusteredRecords = observationRecords.map((entry) => {
@@ -22088,7 +22285,9 @@ var OpensteerSessionRuntime = class {
       };
     }
     const bindings = /* @__PURE__ */ new Map();
-    const baselineRequestIds = await this.beginMutationCapture(timeout);
+    const baselineRequestIds = await this.readLiveRequestIds(timeout, {
+      includeCurrentPageOnly: true
+    });
     const pageRef = explicitPageRef ?? await this.ensurePageRef();
     const validatorMap = new Map(
       packageRecord.payload.validators.map((validator) => [validator.id, validator])
@@ -22680,7 +22879,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),
@@ -23023,7 +23225,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({
@@ -23757,33 +23959,38 @@ var OpensteerSessionRuntime = class {
     assertValidSemanticOperationInput("computer.execute", input);
     const pageRef = await this.ensurePageRef();
     const startedAt = Date.now();
+    let mutationCaptureDiagnostics;
+    let boundaryDiagnostics;
     try {
-      const { artifacts, output } = await this.runWithOperationTimeout(
+      const { artifacts, output } = await this.runMutationCapturedOperation(
         "computer.execute",
+        {
+          ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
+          options
+        },
         async (timeout) => {
-          const baselineRequestIds = await this.beginMutationCapture(timeout);
           try {
             const output2 = await this.requireComputer().execute({
               pageRef,
               input,
               timeout
             });
+            boundaryDiagnostics = takeActionBoundaryDiagnostics(timeout.signal);
             timeout.throwIfAborted();
             this.pageRef = output2.pageRef;
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
             const artifacts2 = await this.persistComputerArtifacts(output2, timeout);
             return {
               artifacts: { manifests: artifacts2.manifests },
               output: artifacts2.output
             };
           } catch (error) {
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag).catch(
-              () => void 0
-            );
+            boundaryDiagnostics ??= takeActionBoundaryDiagnostics(timeout.signal);
             throw error;
           }
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "computer.execute",
@@ -23799,6 +24006,8 @@ var OpensteerSessionRuntime = class {
           nativeViewport: output.nativeViewport,
           displayScale: output.displayScale,
           timing: output.timing,
+          ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics),
           ...output.trace === void 0 ? {} : { trace: output.trace }
         },
         context: buildRuntimeTraceContext({
@@ -23817,6 +24026,10 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: {
+          ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
+        },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef: this.pageRef
@@ -23835,7 +24048,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;
           }
@@ -23904,10 +24117,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
@@ -23923,33 +24133,38 @@ var OpensteerSessionRuntime = class {
   async runDomAction(operation, input, executor, options = {}) {
     const pageRef = await this.ensurePageRef();
     const startedAt = Date.now();
+    let mutationCaptureDiagnostics;
+    let boundaryDiagnostics;
     try {
-      const { executed, preparedTarget } = await this.runWithOperationTimeout(
+      const { executed, preparedTarget } = await this.runMutationCapturedOperation(
         operation,
+        {
+          ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
+          options
+        },
         async (timeout) => {
-          const baselineRequestIds = await this.beginMutationCapture(timeout);
+          const preparedTarget2 = await this.prepareDomTarget(
+            pageRef,
+            operation,
+            input.target,
+            input.persistAsDescription,
+            timeout
+          );
           try {
-            const preparedTarget2 = await this.prepareDomTarget(
-              pageRef,
-              operation,
-              input.target,
-              input.persistAsDescription,
-              timeout
-            );
             const executed2 = await executor(pageRef, preparedTarget2.target, timeout);
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
+            boundaryDiagnostics = takeActionBoundaryDiagnostics(timeout.signal);
             return {
               executed: executed2,
               preparedTarget: preparedTarget2
             };
           } catch (error) {
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag).catch(
-              () => void 0
-            );
+            boundaryDiagnostics ??= takeActionBoundaryDiagnostics(timeout.signal);
             throw error;
           }
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       const output = toOpensteerActionResult(executed.result, preparedTarget.persistedDescription);
       await this.appendTrace({
@@ -23960,7 +24175,9 @@ var OpensteerSessionRuntime = class {
         data: {
           target: output.target,
           ...output.point === void 0 ? {} : { point: output.point },
-          ...output.persistedDescription === void 0 ? {} : { persistedDescription: output.persistedDescription }
+          ...output.persistedDescription === void 0 ? {} : { persistedDescription: output.persistedDescription },
+          ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
@@ -23978,6 +24195,10 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: {
+          ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
+        },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -23999,7 +24220,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,
@@ -24062,11 +24286,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(
@@ -24084,7 +24308,7 @@ var OpensteerSessionRuntime = class {
     const filtered = filterNetworkQueryRecords(metadataRecords, {
       ...input.recordId === void 0 ? {} : { recordId: input.recordId },
       ...input.requestId === void 0 ? {} : { requestId: input.requestId },
-      ...input.actionId === void 0 ? {} : { actionId: input.actionId },
+      ...input.capture === void 0 ? {} : { capture: input.capture },
       ...input.tag === void 0 ? {} : { tag: input.tag },
       ...input.url === void 0 ? {} : { url: input.url },
       ...input.hostname === void 0 ? {} : { hostname: input.hostname },
@@ -24093,7 +24317,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) {
@@ -24290,40 +24514,95 @@ var OpensteerSessionRuntime = class {
       artifactId: manifest.artifactId
     };
   }
-  beginMutationCapture(timeout) {
-    return this.readLiveRequestIds(timeout, {
-      includeCurrentPageOnly: true
-    });
-  }
-  async completeMutationCapture(timeout, baselineRequestIds, networkTag) {
-    const records = await timeout.runStep(
-      () => this.readLiveNetworkRecords(
-        {
-          includeBodies: false,
-          includeCurrentPageOnly: true
+  async runMutationCapturedOperation(operation, input, execute, onFinalized) {
+    let plan;
+    try {
+      const result = await this.runWithOperationTimeout(
+        operation,
+        async (timeout) => {
+          plan = await this.beginMutationCapture(timeout, input.captureNetwork);
+          return execute(timeout);
         },
-        timeout.signal
-      )
+        input.options
+      );
+      const diagnostics = await this.finalizeMutationCaptureBestEffort(plan);
+      onFinalized?.(diagnostics);
+      return result;
+    } catch (error) {
+      const diagnostics = await this.finalizeMutationCaptureBestEffort(plan);
+      onFinalized?.(diagnostics);
+      throw error;
+    }
+  }
+  async beginMutationCapture(timeout, capture) {
+    if (capture === void 0) {
+      return void 0;
+    }
+    return {
+      baselineRequestIds: await this.readLiveRequestIds(timeout, {
+        includeCurrentPageOnly: true
+      }),
+      capture
+    };
+  }
+  async finalizeMutationCaptureBestEffort(plan) {
+    if (plan === void 0) {
+      return {};
+    }
+    try {
+      await withDetachedTimeoutSignal(MUTATION_CAPTURE_FINALIZE_TIMEOUT_MS, async (signal) => {
+        await this.completeMutationCaptureWithSignal(signal, plan);
+      });
+      return {};
+    } catch (error) {
+      return {
+        finalizeError: normalizeOpensteerError(error)
+      };
+    }
+  }
+  async completeMutationCaptureWithSignal(signal, plan) {
+    const records = await this.readLiveNetworkRecords(
+      {
+        includeBodies: false,
+        includeCurrentPageOnly: true
+      },
+      signal
     );
-    const delta = records.filter((record) => !baselineRequestIds.has(record.record.requestId));
+    const delta = records.filter((record) => !plan.baselineRequestIds.has(record.record.requestId));
     if (delta.length === 0) {
       return;
     }
-    this.networkJournal.assignActionId(delta, `action:${randomUUID()}`);
-    if (networkTag === void 0) {
-      return;
-    }
-    this.networkJournal.addTag(delta, networkTag);
-    this.scheduleBackgroundNetworkSaveByRequestIds(
+    this.networkHistory.assignCapture(delta, plan.capture);
+    await this.persistLiveRequestIdsWithSignal(
       delta.map((record) => record.record.requestId),
-      networkTag
+      signal,
+      {
+        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
@@ -24334,24 +24613,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;
@@ -24591,7 +24861,6 @@ var OpensteerSessionRuntime = class {
       timeout.throwIfAborted();
       const records = await this.queryLiveNetwork(
         {
-          source: "live",
           pageRef,
           url,
           method,
@@ -24622,7 +24891,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 },
@@ -24688,12 +24956,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 },
@@ -24706,10 +24974,103 @@ 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) {
+    return timeout.runStep(
+      () => this.persistLiveRequestIdsWithSignal(requestIds, timeout.signal, options)
+    );
+  }
+  async persistLiveRequestIdsWithSignal(requestIds, signal, options) {
+    if (requestIds.length === 0) {
+      return [];
+    }
+    const root = await this.ensureRoot();
+    const browserRecords = await this.readBrowserNetworkRecords(
+      {
+        includeBodies: true,
+        includeCurrentPageOnly: options.includeCurrentPageOnly,
+        ...options.pageRef === void 0 ? {} : { pageRef: options.pageRef },
+        requestIds
+      },
+      signal
+    );
+    return 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.capture === void 0 ? {} : { capture: input.capture },
+      ...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.capture === void 0 ? {} : { capture: input.capture },
+      ...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(
@@ -24733,7 +25094,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, {
@@ -25017,7 +25388,6 @@ var OpensteerSessionRuntime = class {
     const syntheticSessionRef = binding?.sessionRef ?? createSessionRef(`${transportLabel}-${this.workspace}`);
     const record = {
       recordId,
-      source: "saved",
       savedAt: now,
       record: {
         kind: "http",
@@ -25039,7 +25409,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) {
@@ -25412,7 +25785,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) },
@@ -25870,37 +26242,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") {
@@ -25935,7 +26277,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 {
@@ -26192,8 +26536,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;
@@ -26269,10 +26612,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 [];
     }
@@ -26281,25 +26624,25 @@ function resolveLiveQueryRequestIds(input, journal) {
   if (input.requestId !== void 0) {
     requestIdCandidates.push(/* @__PURE__ */ new Set([input.requestId]));
   }
-  if (input.actionId !== void 0) {
-    requestIdCandidates.push(journal.getRequestIdsForActionId(input.actionId));
+  if (input.capture !== void 0) {
+    requestIdCandidates.push(history.getRequestIdsForCapture(input.capture));
   }
   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;
     }
@@ -26329,7 +26672,7 @@ function filterNetworkQueryRecords(records, input) {
     if (input.requestId !== void 0 && record.record.requestId !== input.requestId) {
       return false;
     }
-    if (input.actionId !== void 0 && record.actionId !== input.actionId) {
+    if (input.capture !== void 0 && record.capture !== input.capture) {
       return false;
     }
     if (input.tag !== void 0 && !(record.tags ?? []).includes(input.tag)) {
@@ -26341,10 +26684,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;
     }
@@ -26551,7 +26894,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: {
@@ -26770,12 +27113,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";
@@ -28739,9 +29082,40 @@ function toOpensteerResolvedTarget2(target) {
 function normalizeOpensteerError(error) {
   return normalizeThrownOpensteerError(error, "Unknown Opensteer runtime failure");
 }
+function buildMutationCaptureTraceData(diagnostics) {
+  if (diagnostics?.finalizeError === void 0) {
+    return {};
+  }
+  return {
+    networkCapture: {
+      finalizeError: diagnostics.finalizeError
+    }
+  };
+}
 function isIgnorableRuntimeBindingError(error) {
   return isBrowserCoreError(error) && (error.code === "not-found" || error.code === "page-closed" || error.code === "session-closed");
 }
+async function withDetachedTimeoutSignal(timeoutMs, operation) {
+  const controller = new AbortController();
+  const timeoutError = new OpensteerProtocolError(
+    "timeout",
+    `mutation capture finalization exceeded ${String(timeoutMs)}ms timeout`,
+    {
+      details: {
+        policy: "mutation-capture-finalize",
+        budgetMs: timeoutMs
+      }
+    }
+  );
+  const timer = setTimeout(() => {
+    controller.abort(timeoutError);
+  }, timeoutMs);
+  try {
+    return await operation(controller.signal);
+  } finally {
+    clearTimeout(timer);
+  }
+}
 function screenshotMediaType(format2) {
   switch (format2) {
     case "png":