@opensteer/runtime-core 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,5 +1,5 @@
 import path6 from 'path';
-import { randomUUID, createHash } from 'crypto';
+import { createHash, randomUUID } from 'crypto';
 import { rm, mkdir, access, readFile, mkdtemp, writeFile, rename, open, readdir } from 'fs/promises';
 import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
@@ -13,7 +13,7 @@ import vm from 'vm';
 
 // package.json
 var package_default = {
-  version: "0.1.0"};
+  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, {
@@ -1296,12 +1292,6 @@ var opensteerRegistryProvenanceSchema = objectSchema(
     required: ["source"]
   }
 );
-var opensteerRequestPlanLifecycleSchema = enumSchema(
-  ["draft", "active", "deprecated", "retired"],
-  {
-    title: "OpensteerRequestPlanLifecycle"
-  }
-);
 var opensteerRequestPlanFreshnessSchema = objectSchema(
   {
     lastValidatedAt: integerSchema({ minimum: 0 }),
@@ -1324,23 +1314,12 @@ var opensteerRequestPlanRecordSchema = objectSchema(
       uniqueItems: true
     }),
     provenance: opensteerRegistryProvenanceSchema,
-    lifecycle: opensteerRequestPlanLifecycleSchema,
     freshness: opensteerRequestPlanFreshnessSchema,
     payload: opensteerRequestPlanPayloadSchema
   },
   {
     title: "OpensteerRequestPlanRecord",
-    required: [
-      "id",
-      "key",
-      "version",
-      "createdAt",
-      "updatedAt",
-      "contentHash",
-      "tags",
-      "lifecycle",
-      "payload"
-    ]
+    required: ["id", "key", "version", "createdAt", "updatedAt", "contentHash", "tags", "payload"]
   }
 );
 var jsonValueSchema = defineSchema({
@@ -1474,8 +1453,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     objectSchema(
       {
         kind: enumSchema(["goto"]),
-        url: stringSchema({ minLength: 1 }),
-        networkTag: stringSchema({ minLength: 1 })
+        url: stringSchema({ minLength: 1 })
       },
       {
         title: "OpensteerAuthRecipeGotoStep",
@@ -1484,8 +1462,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     ),
     objectSchema(
       {
-        kind: enumSchema(["reload"]),
-        networkTag: stringSchema({ minLength: 1 })
+        kind: enumSchema(["reload"])
       },
       {
         title: "OpensteerAuthRecipeReloadStep",
@@ -1699,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 }),
@@ -1729,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 }),
@@ -1744,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 })
   },
   {
@@ -1783,7 +1758,6 @@ var opensteerWriteRequestPlanInputSchema = objectSchema(
       uniqueItems: true
     }),
     provenance: opensteerRegistryProvenanceSchema,
-    lifecycle: opensteerRequestPlanLifecycleSchema,
     freshness: opensteerRequestPlanFreshnessSchema,
     payload: opensteerRequestPlanPayloadSchema
   },
@@ -2024,7 +1998,7 @@ var opensteerInferRequestPlanInputSchema = objectSchema(
     recordId: stringSchema({ minLength: 1 }),
     key: stringSchema({ minLength: 1 }),
     version: stringSchema({ minLength: 1 }),
-    lifecycle: opensteerRequestPlanLifecycleSchema
+    transport: transportKindSchema
   },
   {
     title: "OpensteerInferRequestPlanInput",
@@ -5217,7 +5191,7 @@ var opensteerSemanticOperationNames = [
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -5278,7 +5252,7 @@ var opensteerPackageRunnableSemanticOperationNames = /* @__PURE__ */ new Set([
   "dom.scroll",
   "dom.extract",
   "network.query",
-  "network.save",
+  "network.tag",
   "network.clear",
   "network.minimize",
   "network.diff",
@@ -5598,7 +5572,7 @@ var opensteerPageCloseOutputSchema = objectSchema(
 var opensteerPageGotoInputSchema = objectSchema(
   {
     url: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerPageGotoInput",
@@ -5749,7 +5723,7 @@ var opensteerDomClickInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomClickInput",
@@ -5760,7 +5734,7 @@ var opensteerDomHoverInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomHoverInput",
@@ -5773,7 +5747,7 @@ var opensteerDomInputInputSchema = objectSchema(
     text: stringSchema(),
     pressEnter: { type: "boolean" },
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomInputInput",
@@ -5786,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",
@@ -5987,7 +5961,7 @@ var opensteerComputerExecuteInputSchema = objectSchema(
   {
     action: opensteerComputerActionSchema,
     screenshot: opensteerComputerScreenshotOptionsSchema,
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerComputerExecuteInput",
@@ -6188,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",
@@ -7020,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)) {
@@ -7052,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,
@@ -7089,8 +7105,74 @@ var defaultSnapshotSettleObserver = {
   }
 };
 Object.freeze(defaultSnapshotSettleObserver);
+var DOM_ACTION_VISUAL_STABILITY_PROFILES = {
+  "dom.click": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.input": { settleMs: 750, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.scroll": { settleMs: 600, scope: "visible-frames", timeoutMs: 7e3 },
+  "dom.hover": { settleMs: 200, scope: "main-frame", timeoutMs: 2500 }
+};
+var DEFAULT_DOM_ACTION_VISUAL_STABILITY_PROFILE = {
+  settleMs: 750,
+  scope: "visible-frames",
+  timeoutMs: 7e3
+};
+var NAVIGATION_VISUAL_STABILITY_PROFILE = {
+  settleMs: 750,
+  scope: "visible-frames",
+  timeoutMs: 7e3
+};
+var defaultDomActionSettleObserver = {
+  async settle(input) {
+    if (input.trigger !== "dom-action") {
+      return false;
+    }
+    const profile = DOM_ACTION_VISUAL_STABILITY_PROFILES[input.operation] ?? DEFAULT_DOM_ACTION_VISUAL_STABILITY_PROFILE;
+    const effectiveTimeout = input.remainingMs === void 0 ? profile.timeoutMs : Math.min(profile.timeoutMs, input.remainingMs);
+    if (effectiveTimeout <= 0) {
+      return false;
+    }
+    try {
+      await input.engine.waitForVisualStability({
+        pageRef: input.pageRef,
+        timeoutMs: effectiveTimeout,
+        settleMs: profile.settleMs,
+        scope: profile.scope
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+Object.freeze(defaultDomActionSettleObserver);
+var defaultNavigationSettleObserver = {
+  async settle(input) {
+    if (input.trigger !== "navigation") {
+      return false;
+    }
+    const profile = NAVIGATION_VISUAL_STABILITY_PROFILE;
+    const effectiveTimeout = input.remainingMs === void 0 ? profile.timeoutMs : Math.min(profile.timeoutMs, input.remainingMs);
+    if (effectiveTimeout <= 0) {
+      return false;
+    }
+    try {
+      await input.engine.waitForVisualStability({
+        pageRef: input.pageRef,
+        timeoutMs: effectiveTimeout,
+        settleMs: profile.settleMs,
+        scope: profile.scope
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+Object.freeze(defaultNavigationSettleObserver);
 var DEFAULT_SETTLE_OBSERVERS = Object.freeze([
-  defaultSnapshotSettleObserver
+  defaultSnapshotSettleObserver,
+  defaultDomActionSettleObserver,
+  defaultNavigationSettleObserver
 ]);
 var defaultTimeoutPolicy = {
   resolveTimeoutMs(input) {
@@ -7341,9 +7423,7 @@ var FilesystemRegistryStore = class {
     if (input.version !== void 0) {
       return this.resolveIndexedRecord(key, normalizeNonEmptyString("version", input.version));
     }
-    const matches = (await this.readAllRecords()).filter(
-      (record) => this.isActive(record) && record.key === key
-    );
+    const matches = (await this.readAllRecords()).filter((record) => record.key === key);
     matches.sort(compareByCreatedAtAndId);
     return matches[0];
   }
@@ -7466,8 +7546,10 @@ var FilesystemDescriptorRegistry = class extends FilesystemRegistryStore {
     };
     return this.writeRecord(record);
   }
-  isActive(_record) {
-    return true;
+  async list(input = {}) {
+    const key = input.key === void 0 ? void 0 : normalizeNonEmptyString("key", input.key);
+    const records = await this.readAllRecords();
+    return key === void 0 ? records : records.filter((record) => record.key === key);
   }
 };
 var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
@@ -7497,7 +7579,6 @@ var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
       tags: normalizeTags(input.tags),
       ...provenance === void 0 ? {} : { provenance },
       payload,
-      lifecycle: input.lifecycle ?? "active",
       ...freshness === void 0 ? {} : { freshness }
     };
     return this.writeRecord(record);
@@ -7507,7 +7588,7 @@ var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  async updateMetadata(input) {
+  async updateFreshness(input) {
     const id = normalizeNonEmptyString("id", input.id);
     return withFilesystemLock(this.writeLockPath(), async () => {
       const existing = await this.getById(id);
@@ -7525,16 +7606,12 @@ var FilesystemRequestPlanRegistry = class extends FilesystemRegistryStore {
       const nextRecord = {
         ...existing,
         updatedAt: nextUpdatedAt,
-        lifecycle: input.lifecycle ?? existing.lifecycle,
         ...nextFreshness === void 0 ? {} : { freshness: nextFreshness }
       };
       await writeJsonFileAtomic(this.recordPath(id), nextRecord);
       return nextRecord;
     });
   }
-  isActive(record) {
-    return record.lifecycle === "active";
-  }
 };
 var FilesystemAuthRecipeRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7570,9 +7647,6 @@ var FilesystemAuthRecipeRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemRecipeRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7608,9 +7682,6 @@ var FilesystemRecipeRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemInteractionTraceRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7646,9 +7717,6 @@ var FilesystemInteractionTraceRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReverseCaseRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7712,9 +7780,6 @@ var FilesystemReverseCaseRegistry = class extends FilesystemRegistryStore {
       return nextRecord;
     });
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReversePackageRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7750,9 +7815,6 @@ var FilesystemReversePackageRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 var FilesystemReverseReportRegistry = class extends FilesystemRegistryStore {
   constructor(rootPath) {
@@ -7788,9 +7850,6 @@ var FilesystemReverseReportRegistry = class extends FilesystemRegistryStore {
     const records = await this.readAllRecords();
     return key === void 0 ? records : records.filter((record) => record.key === key);
   }
-  isActive(_record) {
-    return true;
-  }
 };
 function createDescriptorRegistry(rootPath) {
   return new FilesystemDescriptorRegistry(rootPath);
@@ -7818,101 +7877,20 @@ function createReverseReportRegistry(rootPath) {
 }
 var TAG_DELIMITER = "";
 var NODE_SQLITE_SPECIFIER = `node:${"sqlite"}`;
+var SAVED_NETWORK_SQLITE_SUPPORT_ERROR = "Saved-network operations require Node's built-in SQLite support. Use a Node runtime with node:sqlite enabled.";
 var SqliteSavedNetworkStore = class {
   databasePath;
   database;
+  directoryInitialization;
+  databaseInitialization;
   constructor(rootPath) {
     this.databasePath = path6.join(rootPath, "registry", "saved-network.sqlite");
   }
   async initialize() {
-    await ensureDirectory(path6.dirname(this.databasePath));
-    const { DatabaseSync } = await import(NODE_SQLITE_SPECIFIER);
-    const database = new DatabaseSync(this.databasePath);
-    database.exec("PRAGMA journal_mode = WAL");
-    database.exec("PRAGMA foreign_keys = ON");
-    database.exec(`
-      CREATE TABLE IF NOT EXISTS saved_network_records (
-        record_id TEXT PRIMARY KEY,
-        request_id TEXT NOT NULL,
-        session_ref TEXT NOT NULL,
-        page_ref TEXT,
-        page_ref_key TEXT NOT NULL,
-        frame_ref TEXT,
-        document_ref TEXT,
-        action_id TEXT,
-        method TEXT NOT NULL,
-        method_lc TEXT NOT NULL,
-        url TEXT NOT NULL,
-        url_lc TEXT NOT NULL,
-        hostname TEXT NOT NULL,
-        hostname_lc TEXT NOT NULL,
-        path TEXT NOT NULL,
-        path_lc TEXT NOT NULL,
-        status INTEGER,
-        status_text TEXT,
-        resource_type TEXT NOT NULL,
-        navigation_request INTEGER NOT NULL,
-        request_headers_json TEXT NOT NULL,
-        response_headers_json TEXT NOT NULL,
-        request_body_json TEXT,
-        response_body_json TEXT,
-        initiator_json TEXT,
-        timing_json TEXT,
-        transfer_json TEXT,
-        source_json TEXT,
-        capture_state TEXT NOT NULL,
-        request_body_state TEXT NOT NULL,
-        response_body_state TEXT NOT NULL,
-        request_body_skip_reason TEXT,
-        response_body_skip_reason TEXT,
-        request_body_error TEXT,
-        response_body_error TEXT,
-        redirect_from_request_id TEXT,
-        redirect_to_request_id TEXT,
-        saved_at INTEGER NOT NULL
-      );
-
-      CREATE UNIQUE INDEX IF NOT EXISTS saved_network_records_scope_request
-        ON saved_network_records (session_ref, page_ref_key, request_id);
-
-      CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
-        ON saved_network_records (saved_at DESC);
-
-      CREATE 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,
-        PRIMARY KEY (record_id, tag)
-      );
-
-      CREATE INDEX IF NOT EXISTS saved_network_tags_tag
-        ON saved_network_tags (tag);
-    `);
-    this.ensureColumn(
-      database,
-      "saved_network_records",
-      "capture_state",
-      "TEXT NOT NULL DEFAULT 'complete'"
-    );
-    this.ensureColumn(
-      database,
-      "saved_network_records",
-      "request_body_state",
-      "TEXT NOT NULL DEFAULT 'skipped'"
-    );
-    this.ensureColumn(
-      database,
-      "saved_network_records",
-      "response_body_state",
-      "TEXT NOT NULL DEFAULT 'skipped'"
-    );
-    this.ensureColumn(database, "saved_network_records", "request_body_skip_reason", "TEXT");
-    this.ensureColumn(database, "saved_network_records", "response_body_skip_reason", "TEXT");
-    this.ensureColumn(database, "saved_network_records", "request_body_error", "TEXT");
-    this.ensureColumn(database, "saved_network_records", "response_body_error", "TEXT");
-    this.database = database;
+    await this.ensureDatabaseDirectory();
   }
-  async save(records, tag) {
-    const database = this.requireDatabase();
+  async save(records, options) {
+    const database = await this.requireDatabase();
     const readExisting = database.prepare(`
         SELECT record_id
         FROM saved_network_records
@@ -7920,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)
@@ -8060,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,
@@ -8092,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;
         }
@@ -8103,8 +7969,41 @@ 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 = this.requireDatabase();
+    const database = await this.requireDatabase();
     const limit = Math.max(1, Math.min(input.limit ?? 50, 200));
     const { whereSql, parameters } = buildSavedNetworkWhere(input);
     const rows = database.prepare(
@@ -8135,48 +8034,160 @@ var SqliteSavedNetworkStore = class {
     return record;
   }
   async clear(input = {}) {
-    const database = 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 database = await this.requireDatabase();
+    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;
     });
   }
-  requireDatabase() {
-    if (!this.database) {
-      throw new Error("saved network store is not initialized");
+  async requireDatabase() {
+    if (this.database) {
+      return this.database;
+    }
+    this.databaseInitialization ??= this.openDatabase();
+    try {
+      return await this.databaseInitialization;
+    } catch (error) {
+      this.databaseInitialization = void 0;
+      throw error;
+    }
+  }
+  async openDatabase() {
+    await this.ensureDatabaseDirectory();
+    let DatabaseSync;
+    try {
+      ({ DatabaseSync } = await import(NODE_SQLITE_SPECIFIER));
+    } catch (error) {
+      throw normalizeSqliteImportError(error);
     }
-    return this.database;
+    const database = new DatabaseSync(this.databasePath);
+    try {
+      this.configureDatabase(database);
+      this.database = database;
+      return database;
+    } catch (error) {
+      closeSqliteDatabase(database);
+      throw error;
+    }
+  }
+  async ensureDatabaseDirectory() {
+    this.directoryInitialization ??= ensureDirectory(path6.dirname(this.databasePath)).catch(
+      (error) => {
+        this.directoryInitialization = void 0;
+        throw error;
+      }
+    );
+    await this.directoryInitialization;
+  }
+  configureDatabase(database) {
+    database.exec("PRAGMA journal_mode = WAL");
+    database.exec("PRAGMA foreign_keys = ON");
+    database.exec(`
+      CREATE TABLE IF NOT EXISTS saved_network_records (
+        record_id TEXT PRIMARY KEY,
+        request_id TEXT NOT NULL,
+        session_ref TEXT NOT NULL,
+        page_ref TEXT,
+        page_ref_key TEXT NOT NULL,
+        frame_ref TEXT,
+        document_ref TEXT,
+        capture TEXT,
+        method TEXT NOT NULL,
+        method_lc TEXT NOT NULL,
+        url TEXT NOT NULL,
+        url_lc TEXT NOT NULL,
+        hostname TEXT NOT NULL,
+        hostname_lc TEXT NOT NULL,
+        path TEXT NOT NULL,
+        path_lc TEXT NOT NULL,
+        status INTEGER,
+        status_text TEXT,
+        resource_type TEXT NOT NULL,
+        navigation_request INTEGER NOT NULL,
+        request_headers_json TEXT NOT NULL,
+        response_headers_json TEXT NOT NULL,
+        request_body_json TEXT,
+        response_body_json TEXT,
+        initiator_json TEXT,
+        timing_json TEXT,
+        transfer_json TEXT,
+        source_json TEXT,
+        capture_state TEXT NOT NULL,
+        request_body_state TEXT NOT NULL,
+        response_body_state TEXT NOT NULL,
+        request_body_skip_reason TEXT,
+        response_body_skip_reason TEXT,
+        request_body_error TEXT,
+        response_body_error TEXT,
+        redirect_from_request_id TEXT,
+        redirect_to_request_id TEXT,
+        saved_at INTEGER NOT NULL
+      );
+
+      CREATE UNIQUE INDEX IF NOT EXISTS saved_network_records_scope_request
+        ON saved_network_records (session_ref, page_ref_key, request_id);
+
+      CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
+        ON saved_network_records (saved_at DESC);
+
+      CREATE INDEX IF NOT EXISTS saved_network_records_capture
+        ON saved_network_records (capture);
+
+      CREATE TABLE IF NOT EXISTS saved_network_tags (
+        record_id TEXT NOT NULL REFERENCES saved_network_records(record_id) ON DELETE CASCADE,
+        tag TEXT NOT NULL,
+        PRIMARY KEY (record_id, tag)
+      );
+
+      CREATE INDEX IF NOT EXISTS saved_network_tags_tag
+        ON saved_network_tags (tag);
+    `);
+    this.ensureColumn(
+      database,
+      "saved_network_records",
+      "capture_state",
+      "TEXT NOT NULL DEFAULT 'complete'"
+    );
+    this.ensureColumn(database, "saved_network_records", "capture", "TEXT");
+    this.ensureColumn(
+      database,
+      "saved_network_records",
+      "request_body_state",
+      "TEXT NOT NULL DEFAULT 'skipped'"
+    );
+    this.ensureColumn(
+      database,
+      "saved_network_records",
+      "response_body_state",
+      "TEXT NOT NULL DEFAULT 'skipped'"
+    );
+    this.ensureColumn(database, "saved_network_records", "request_body_skip_reason", "TEXT");
+    this.ensureColumn(database, "saved_network_records", "response_body_skip_reason", "TEXT");
+    this.ensureColumn(database, "saved_network_records", "request_body_error", "TEXT");
+    this.ensureColumn(database, "saved_network_records", "response_body_error", "TEXT");
   }
   ensureColumn(database, table, column, definition) {
     const rows = database.prepare(`PRAGMA table_info(${table})`).all();
@@ -8189,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);
@@ -8197,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(`
@@ -8241,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;
@@ -8311,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
@@ -8321,6 +8456,20 @@ function inflateSavedNetworkRow(row, includeBodies) {
 function stringifyOptional(value) {
   return value === void 0 ? null : JSON.stringify(value);
 }
+function normalizeSqliteImportError(error) {
+  if (error instanceof Error && error.code === "ERR_UNKNOWN_BUILTIN_MODULE" && error.message.includes(NODE_SQLITE_SPECIFIER)) {
+    return new Error(SAVED_NETWORK_SQLITE_SUPPORT_ERROR, {
+      cause: error
+    });
+  }
+  return error instanceof Error ? error : new Error(String(error));
+}
+function closeSqliteDatabase(database) {
+  try {
+    database.close();
+  } catch {
+  }
+}
 function withSqliteTransaction(database, task) {
   database.exec("BEGIN IMMEDIATE");
   try {
@@ -8530,8 +8679,8 @@ async function createFilesystemOpensteerWorkspace(options) {
   const browserManifestPath = path6.join(browserPath, "manifest.json");
   const browserUserDataDir = path6.join(browserPath, "user-data");
   const livePath = path6.join(options.rootPath, "live");
-  const liveSessionPath = path6.join(livePath, "session.json");
-  const liveBrowserPath = path6.join(livePath, "browser.json");
+  const liveLocalPath = path6.join(livePath, "local.json");
+  const liveCloudPath = path6.join(livePath, "cloud.json");
   const artifactsPath = path6.join(options.rootPath, "artifacts");
   const tracesPath = path6.join(options.rootPath, "traces");
   const registryPath = path6.join(options.rootPath, "registry");
@@ -8606,8 +8755,8 @@ async function createFilesystemOpensteerWorkspace(options) {
     browserManifestPath,
     browserUserDataDir,
     livePath,
-    liveSessionPath,
-    liveBrowserPath,
+    liveLocalPath,
+    liveCloudPath,
     artifactsPath,
     tracesPath,
     registryPath,
@@ -8631,6 +8780,16 @@ async function createFilesystemOpensteerWorkspace(options) {
   };
 }
 
+// src/runtimes/dom/errors.ts
+var ElementPathError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ElementPathError";
+    this.code = code;
+  }
+};
+
 // src/runtimes/dom/match-policy.ts
 var ATTRIBUTE_DENY_KEYS = /* @__PURE__ */ new Set([
   "style",
@@ -9191,16 +9350,6 @@ function readDescriptorToken(value, index) {
     nextIndex: cursor
   };
 }
-
-// src/runtimes/dom/errors.ts
-var ElementPathError = class extends Error {
-  code;
-  constructor(code, message) {
-    super(message);
-    this.name = "ElementPathError";
-    this.code = code;
-  }
-};
 var selectorAdapter = {
   isTag(node) {
     return node.kind === "element" && node.source.nodeType === 1;
@@ -9955,24 +10104,31 @@ function collectChildrenInScope(index, node, scopeHostNodeRef) {
 function getShadowScopeNodeRef(index, node) {
   return findContainingShadowHostNode(index, node)?.nodeRef;
 }
+
+// src/runtimes/dom/descriptors.ts
 function createDomDescriptorStore(options) {
-  const namespace = normalizeNamespace(options.namespace);
+  const namespace = normalizeDomDescriptorNamespace(options.namespace);
   if (options.root) {
     return new FilesystemDomDescriptorStore(options.root.registry.descriptors, namespace);
   }
   return new MemoryDomDescriptorStore(namespace);
 }
-function descriptionKey(namespace, method, description) {
-  return `dom:${namespace}:${method}:${sha256Hex2(description.trim())}`;
+function hashDomDescriptorDescription(description) {
+  return sha256Hex2(description.trim());
 }
-function normalizeNamespace(namespace) {
+function buildDomDescriptorKey(options) {
+  return `dom:${normalizeDomDescriptorNamespace(options.namespace)}:${options.method}:${hashDomDescriptorDescription(
+    options.description
+  )}`;
+}
+function normalizeDomDescriptorNamespace(namespace) {
   const normalized = String(namespace || "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
 function sha256Hex2(value) {
   return createHash("sha256").update(value).digest("hex");
 }
-function buildPayload(input) {
+function buildDomDescriptorPayload(input) {
   return {
     kind: "dom-target",
     method: input.method,
@@ -9981,6 +10137,9 @@ function buildPayload(input) {
     ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
   };
 }
+function buildDomDescriptorVersion(payload) {
+  return sha256Hex2(canonicalJsonString(payload));
+}
 function parseDomDescriptorRecord(record) {
   const payload = record.payload;
   if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
@@ -10022,7 +10181,11 @@ var FilesystemDomDescriptorStore = class {
   }
   async read(input) {
     const record = await this.registry.resolve({
-      key: descriptionKey(this.namespace, input.method, input.description)
+      key: buildDomDescriptorKey({
+        namespace: this.namespace,
+        method: input.method,
+        description: input.description
+      })
     });
     if (!record) {
       return void 0;
@@ -10030,9 +10193,13 @@ var FilesystemDomDescriptorStore = class {
     return parseDomDescriptorRecord(record);
   }
   async write(input) {
-    const payload = buildPayload(input);
-    const key = descriptionKey(this.namespace, input.method, input.description);
-    const version = sha256Hex2(canonicalJsonString(payload));
+    const payload = buildDomDescriptorPayload(input);
+    const key = buildDomDescriptorKey({
+      namespace: this.namespace,
+      method: input.method,
+      description: input.description
+    });
+    const version = buildDomDescriptorVersion(payload);
     const existing = await this.registry.resolve({ key, version });
     if (existing) {
       const parsed2 = parseDomDescriptorRecord(existing);
@@ -10070,12 +10237,22 @@ var MemoryDomDescriptorStore = class {
   latestByKey = /* @__PURE__ */ new Map();
   recordsByKey = /* @__PURE__ */ new Map();
   async read(input) {
-    return this.latestByKey.get(descriptionKey(this.namespace, input.method, input.description));
+    return this.latestByKey.get(
+      buildDomDescriptorKey({
+        namespace: this.namespace,
+        method: input.method,
+        description: input.description
+      })
+    );
   }
   async write(input) {
-    const payload = buildPayload(input);
-    const key = descriptionKey(this.namespace, input.method, input.description);
-    const version = sha256Hex2(canonicalJsonString(payload));
+    const payload = buildDomDescriptorPayload(input);
+    const key = buildDomDescriptorKey({
+      namespace: this.namespace,
+      method: input.method,
+      description: input.description
+    });
+    const version = buildDomDescriptorVersion(payload);
     const existing = this.recordsByKey.get(key)?.get(version);
     if (existing) {
       return existing;
@@ -10226,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, {
@@ -10241,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"
@@ -10248,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;
@@ -10321,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;
@@ -10340,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) {
@@ -10718,7 +10942,7 @@ var DefaultDomRuntime = class {
   bridge;
   constructor(options) {
     this.engine = options.engine;
-    this.descriptors = createDomDescriptorStore({
+    this.descriptors = options.descriptorStore ?? createDomDescriptorStore({
       ...options.root === void 0 ? {} : { root: options.root },
       ...options.namespace === void 0 ? {} : { namespace: options.namespace }
     });
@@ -11623,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 {
@@ -11752,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
       );
@@ -12606,7 +12854,7 @@ function inferRequestPlanFromNetworkRecord(record, input, options = {}) {
   const body = inferRequestPlanBody(record.record.requestBody, requestContentType);
   const payload = normalizeRequestPlanPayload({
     transport: {
-      kind: "context-http"
+      kind: input.transport ?? "context-http"
     },
     endpoint: {
       method: record.record.method,
@@ -12626,11 +12874,10 @@ function inferRequestPlanFromNetworkRecord(record, input, options = {}) {
   return {
     key: input.key,
     version: input.version,
-    lifecycle: input.lifecycle ?? "draft",
     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 }
@@ -13010,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) {
@@ -13086,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) ?? []);
@@ -13095,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();
@@ -16898,7 +17197,6 @@ async function compileOpensteerExtractionFieldTargets(options) {
   await collectFieldTargetsFromSchemaObject({
     dom: options.dom,
     pageRef: options.pageRef,
-    latestSnapshotCounters: options.latestSnapshotCounters,
     value: options.schema,
     path: "",
     fields,
@@ -16916,22 +17214,11 @@ async function extractOpensteerExtractionFieldTargets(options) {
           source: "current_url"
         };
       }
-      if ("path" in field) {
-        return {
-          key: field.key,
-          target: {
-            kind: "path",
-            path: field.path
-          },
-          ...field.attribute === void 0 ? {} : { attribute: field.attribute }
-        };
-      }
       return {
         key: field.key,
         target: {
-          kind: "live",
-          locator: field.locator,
-          anchor: field.anchor
+          kind: "path",
+          path: field.path
         },
         ...field.attribute === void 0 ? {} : { attribute: field.attribute }
       };
@@ -16940,8 +17227,6 @@ async function extractOpensteerExtractionFieldTargets(options) {
 }
 async function compilePersistedOpensteerExtractionPayloadFromFieldTargets(options) {
   const fields = await resolvePersistableFieldTargets({
-    pageRef: options.pageRef,
-    dom: options.dom,
     fieldTargets: options.fieldTargets
   });
   const payload = buildPersistedOpensteerExtractionPayload(fields);
@@ -16955,7 +17240,7 @@ async function replayOpensteerExtractionPayload(options) {
   return extractPersistedObjectNode(options.pageRef, options.dom, options.payload);
 }
 function createOpensteerExtractionDescriptorStore(options) {
-  const namespace = normalizeNamespace2(options.namespace);
+  const namespace = normalizeNamespace(options.namespace);
   if (options.root) {
     return new FilesystemOpensteerExtractionDescriptorStore(
       options.root.registry.descriptors,
@@ -16973,7 +17258,6 @@ async function collectFieldTargetsFromSchemaObject(options) {
     await collectFieldTargetsFromSchemaValue({
       dom: options.dom,
       pageRef: options.pageRef,
-      latestSnapshotCounters: options.latestSnapshotCounters,
       value: childValue,
       path: joinDataPath(options.path, normalizedKey),
       fields: options.fields,
@@ -16988,7 +17272,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
       await compileFieldTarget({
         dom: options.dom,
         pageRef: options.pageRef,
-        latestSnapshotCounters: options.latestSnapshotCounters,
         field: normalizedField,
         path: options.path
       })
@@ -17017,7 +17300,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
       await collectFieldTargetsFromSchemaObject({
         dom: options.dom,
         pageRef: options.pageRef,
-        latestSnapshotCounters: options.latestSnapshotCounters,
         value: itemValue,
         path: appendDataPathIndex(options.path, index),
         fields: options.fields,
@@ -17040,7 +17322,6 @@ async function collectFieldTargetsFromSchemaValue(options) {
   await collectFieldTargetsFromSchemaObject({
     dom: options.dom,
     pageRef: options.pageRef,
-    latestSnapshotCounters: options.latestSnapshotCounters,
     value: options.value,
     path: options.path,
     fields: options.fields,
@@ -17067,10 +17348,10 @@ async function compileFieldTarget(options) {
   }
   return {
     key: options.path,
-    ...await resolveLiveFieldTarget({
-      latestSnapshotCounters: options.latestSnapshotCounters,
-      field: options.field,
-      path: options.path
+    path: await resolveSelectorFieldPath({
+      dom: options.dom,
+      pageRef: options.pageRef,
+      selector: `[c="${String(options.field.element)}"]`
     }),
     ...options.field.attribute === void 0 ? {} : { attribute: options.field.attribute }
   };
@@ -17088,24 +17369,6 @@ async function resolveSelectorFieldPath(options) {
     locator: resolved.locator
   });
 }
-async function resolveLiveFieldTarget(options) {
-  const counters = options.latestSnapshotCounters;
-  if (counters === void 0) {
-    throw new Error(
-      `Extraction schema field "${labelForPath(options.path)}" uses element ${String(options.field.element)} but no snapshot is available.`
-    );
-  }
-  const counter = counters.get(options.field.element);
-  if (!counter) {
-    throw new Error(
-      `Extraction schema field "${labelForPath(options.path)}" references missing counter ${String(options.field.element)}.`
-    );
-  }
-  return {
-    locator: counter.locator,
-    anchor: counter.anchor
-  };
-}
 async function resolvePersistableFieldTargets(options) {
   const fields = [];
   for (const field of options.fieldTargets) {
@@ -17116,29 +17379,9 @@ async function resolvePersistableFieldTargets(options) {
       });
       continue;
     }
-    if ("path" in field) {
-      fields.push({
-        key: field.key,
-        path: sanitizeElementPath(field.path),
-        ...field.attribute === void 0 ? {} : { attribute: field.attribute }
-      });
-      continue;
-    }
-    const resolved = await options.dom.resolveTarget({
-      pageRef: options.pageRef,
-      method: "extract",
-      target: {
-        kind: "live",
-        locator: field.locator,
-        anchor: field.anchor
-      }
-    });
-    const path9 = resolved.replayPath ?? await options.dom.buildPath({
-      locator: resolved.locator
-    });
     fields.push({
       key: field.key,
-      path: sanitizeElementPath(path9),
+      path: sanitizeElementPath(field.path),
       ...field.attribute === void 0 ? {} : { attribute: field.attribute }
     });
   }
@@ -17452,11 +17695,11 @@ function normalizeSchemaField(value) {
     ...attribute === void 0 ? {} : { attribute }
   };
 }
-function normalizeNamespace2(namespace) {
+function normalizeNamespace(namespace) {
   const normalized = String(namespace ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
-function descriptionKey2(namespace, description) {
+function descriptionKey(namespace, description) {
   return `extract:${namespace}:${sha256Hex3(description.trim())}`;
 }
 function parseExtractionDescriptorRecord(record) {
@@ -17559,7 +17802,7 @@ var FilesystemOpensteerExtractionDescriptorStore = class {
   }
   async read(input) {
     const record = await this.registry.resolve({
-      key: descriptionKey2(this.namespace, input.description)
+      key: descriptionKey(this.namespace, input.description)
     });
     return record === void 0 ? void 0 : parseExtractionDescriptorRecord(record);
   }
@@ -17571,7 +17814,7 @@ var FilesystemOpensteerExtractionDescriptorStore = class {
       ...input.schemaHash === void 0 ? {} : { schemaHash: input.schemaHash },
       ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
     };
-    const key = descriptionKey2(this.namespace, input.description);
+    const key = descriptionKey(this.namespace, input.description);
     const version = sha256Hex3(canonicalJsonString(payload));
     const existing = await this.registry.resolve({ key, version });
     if (existing) {
@@ -17610,7 +17853,7 @@ var MemoryOpensteerExtractionDescriptorStore = class {
   latestByKey = /* @__PURE__ */ new Map();
   recordsByKey = /* @__PURE__ */ new Map();
   async read(input) {
-    return this.latestByKey.get(descriptionKey2(this.namespace, input.description));
+    return this.latestByKey.get(descriptionKey(this.namespace, input.description));
   }
   async write(input) {
     const payload = {
@@ -17620,7 +17863,7 @@ var MemoryOpensteerExtractionDescriptorStore = class {
       ...input.schemaHash === void 0 ? {} : { schemaHash: input.schemaHash },
       ...input.sourceUrl === void 0 ? {} : { sourceUrl: input.sourceUrl }
     };
-    const key = descriptionKey2(this.namespace, input.description);
+    const key = descriptionKey(this.namespace, input.description);
     const version = sha256Hex3(canonicalJsonString(payload));
     const existing = this.recordsByKey.get(key)?.get(version);
     if (existing) {
@@ -17664,6 +17907,7 @@ var OPENSTEER_INTERACTIVE_ATTR = "data-opensteer-interactive";
 var OPENSTEER_HIDDEN_ATTR = "data-opensteer-hidden";
 var OPENSTEER_SCROLLABLE_ATTR = "data-opensteer-scrollable";
 var OPENSTEER_NODE_ID_ATTR = "data-os-node-id";
+var OPENSTEER_SPARSE_COUNTER_ATTR = "data-os-c";
 var OPENSTEER_BOUNDARY_ATTR = "data-os-boundary";
 var OPENSTEER_UNAVAILABLE_ATTR = "data-os-unavailable";
 var OPENSTEER_IFRAME_BOUNDARY_TAG = "os-iframe-root";
@@ -18168,7 +18412,82 @@ var VOID_TAGS2 = /* @__PURE__ */ new Set([
 ]);
 
 // src/sdk/snapshot/compiler.ts
+async function assignSparseCountersToLiveDom(engine, pageRef) {
+  try {
+    await engine.evaluatePage({
+      pageRef,
+      script: `(() => {
+        let counter = 1;
+        const walk = (root) => {
+          for (const child of root.children) {
+            child.setAttribute('data-os-c', String(counter++));
+            walk(child);
+            if (child.shadowRoot) walk(child.shadowRoot);
+          }
+        };
+        walk(document);
+      })()`
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function syncDenseCountersToLiveDom(engine, pageRef, sparseToDirectMapping) {
+  const mappingObj = Object.fromEntries(sparseToDirectMapping);
+  await engine.evaluatePage({
+    pageRef,
+    script: `((mapping) => {
+      const walk = (root) => {
+        for (const child of root.children) {
+          child.removeAttribute('c');
+          const sparse = child.getAttribute('data-os-c');
+          if (sparse !== null) {
+            const dense = mapping[sparse];
+            if (dense !== undefined) {
+              child.setAttribute('c', String(dense));
+            }
+            child.removeAttribute('data-os-c');
+          }
+          walk(child);
+          if (child.shadowRoot) walk(child.shadowRoot);
+        }
+      };
+      walk(document);
+    })`,
+    args: [mappingObj]
+  });
+}
+function renumberCountersDensely(cleanedHtml, counterRecords) {
+  const $ = cheerio.load(cleanedHtml, { xmlMode: false });
+  const newRecords = /* @__PURE__ */ new Map();
+  const sparseToDirectMapping = /* @__PURE__ */ new Map();
+  let nextDense = 1;
+  $("[c]").each(function renumberElement() {
+    const el = $(this);
+    const oldC = Number.parseInt(String(el.attr("c") || ""), 10);
+    if (!Number.isFinite(oldC)) {
+      return;
+    }
+    const record = counterRecords.get(oldC);
+    if (!record) {
+      return;
+    }
+    const denseC = nextDense++;
+    el.attr("c", String(denseC));
+    newRecords.set(denseC, { ...record, element: denseC });
+    if (record.sparseCounter !== void 0) {
+      sparseToDirectMapping.set(record.sparseCounter, denseC);
+    }
+  });
+  return {
+    html: $.html(),
+    counterRecords: newRecords,
+    sparseToDirectMapping
+  };
+}
 async function compileOpensteerSnapshot(options) {
+  const liveCountersEnabled = await assignSparseCountersToLiveDom(options.engine, options.pageRef);
   const pageInfo = await options.engine.getPageInfo({ pageRef: options.pageRef });
   const mainSnapshot = await getMainDocumentSnapshot(options.engine, options.pageRef);
   const snapshotsByDocumentRef = await collectDocumentSnapshots(options.engine, mainSnapshot);
@@ -18187,13 +18506,23 @@ async function compileOpensteerSnapshot(options) {
   const compiledHtml = assignCounters(rawHtml, renderedNodes);
   const cleanedHtml = options.mode === "extraction" ? cleanForExtraction(compiledHtml.html) : cleanForAction(compiledHtml.html);
   const filtered = retainVisibleCounterRecords(cleanedHtml, compiledHtml.counterRecords);
+  const dense = renumberCountersDensely(cleanedHtml, filtered);
+  if (liveCountersEnabled && dense.sparseToDirectMapping.size > 0) {
+    try {
+      await syncDenseCountersToLiveDom(
+        options.engine,
+        options.pageRef,
+        dense.sparseToDirectMapping
+      );
+    } catch {
+    }
+  }
   return {
     url: pageInfo.url,
     title: pageInfo.title,
     mode: options.mode,
-    html: cleanedHtml,
-    counters: [...filtered.values()].map(toPublicCounterRecord),
-    counterRecords: filtered
+    html: dense.html,
+    counters: [...dense.counterRecords.values()].map(toPublicCounterRecord)
   };
 }
 async function getMainDocumentSnapshot(engine, pageRef) {
@@ -18422,6 +18751,9 @@ function assignCounters(rawHtml, renderedNodes) {
     if (!rendered) {
       return;
     }
+    const rawSparseCounter = el.attr(OPENSTEER_SPARSE_COUNTER_ATTR);
+    el.removeAttr(OPENSTEER_SPARSE_COUNTER_ATTR);
+    const sparseCounter = rawSparseCounter ? Number.parseInt(rawSparseCounter, 10) : void 0;
     const counter = nextCounter++;
     el.attr("c", String(counter));
     counterRecords.set(counter, {
@@ -18439,7 +18771,8 @@ function assignCounters(rawHtml, renderedNodes) {
       shadowDepth: rendered.shadowDepth,
       interactive: rendered.interactive,
       locator: rendered.locator,
-      anchor: rendered.anchor
+      anchor: rendered.anchor,
+      ...sparseCounter !== void 0 && Number.isFinite(sparseCounter) ? { sparseCounter } : {}
     });
   });
   return {
@@ -19800,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;
@@ -19807,30 +20141,34 @@ var OpensteerSessionRuntime = class {
   injectedEngine;
   engineFactory;
   policy;
+  injectedDescriptorStore;
+  injectedExtractionDescriptorStore;
+  registryOverrides;
   cleanupRootOnClose;
   sessionInfoBase;
   root;
   engine;
   dom;
   computer;
-  networkJournal = new NetworkJournal();
+  networkHistory = new NetworkHistory();
   extractionDescriptors;
   sessionRef;
   pageRef;
   runId;
-  latestSnapshot;
-  backgroundNetworkPersistence = /* @__PURE__ */ new Set();
   cookieJars = /* @__PURE__ */ new Map();
   recipeCache = /* @__PURE__ */ new Map();
   ownsEngine = false;
   constructor(options) {
-    this.workspace = normalizeNamespace3(options.name);
+    this.workspace = normalizeNamespace2(options.name);
     this.workspaceName = options.workspaceName?.trim() === void 0 || options.workspaceName?.trim().length === 0 ? void 0 : options.workspaceName.trim();
     this.root = options.workspace;
     this.rootPath = options.workspace?.rootPath ?? options.rootPath ?? path6.resolve(process.cwd(), ".opensteer", "temporary", randomUUID());
     this.injectedEngine = options.engine;
     this.engineFactory = options.engineFactory;
     this.policy = options.policy ?? defaultPolicy();
+    this.injectedDescriptorStore = options.descriptorStore;
+    this.injectedExtractionDescriptorStore = options.extractionDescriptorStore;
+    this.registryOverrides = options.registryOverrides;
     this.cleanupRootOnClose = options.cleanupRootOnClose ?? options.workspace === void 0;
     this.sessionInfoBase = options.sessionInfo ?? {};
     if (this.injectedEngine === void 0 && this.engineFactory === void 0) {
@@ -19841,7 +20179,7 @@ var OpensteerSessionRuntime = class {
     const base = this.sessionInfoBase;
     return {
       provider: base.provider ?? {
-        kind: "local",
+        mode: "local",
         ownership: "owned",
         engine: "playwright"
       },
@@ -19866,7 +20204,7 @@ var OpensteerSessionRuntime = class {
   }
   async open(input = {}, options = {}) {
     assertValidSemanticOperationInput("session.open", input);
-    if (input.workspace !== void 0 && normalizeNamespace3(input.workspace) !== this.workspace) {
+    if (input.workspace !== void 0 && normalizeNamespace2(input.workspace) !== this.workspace) {
       throw new Error(
         `session.open requested workspace "${input.workspace}" but runtime is bound to "${this.workspace}"`
       );
@@ -19908,7 +20246,6 @@ var OpensteerSessionRuntime = class {
           timeout.throwIfAborted();
           this.sessionRef = sessionRef;
           this.pageRef = createdPage.data.pageRef;
-          this.latestSnapshot = void 0;
           await timeout.runStep(() => this.ensureSemantics());
           let frameRef2 = createdPage.frameRef;
           if (input.url !== void 0) {
@@ -20031,7 +20368,6 @@ var OpensteerSessionRuntime = class {
             })
           );
           this.pageRef = created.data.pageRef;
-          this.latestSnapshot = void 0;
           return this.readSessionState();
         },
         options
@@ -20074,7 +20410,6 @@ var OpensteerSessionRuntime = class {
             () => this.requireEngine().activatePage({ pageRef: input.pageRef })
           );
           this.pageRef = input.pageRef;
-          this.latestSnapshot = void 0;
           return this.readSessionState();
         },
         options
@@ -20138,7 +20473,6 @@ var OpensteerSessionRuntime = class {
             );
           }
           this.pageRef = activePageRef;
-          this.latestSnapshot = void 0;
           return {
             closedPageRef: targetPageRef,
             ...activePageRef === void 0 ? {} : { activePageRef },
@@ -20182,35 +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",
-        async (timeout) => {
-          const baselineRequestIds = await this.beginMutationCapture(timeout);
-          try {
-            const navigation2 = await this.navigatePage(
-              {
-                operation: "page.goto",
-                pageRef,
-                url: input.url
-              },
-              timeout
-            );
-            timeout.throwIfAborted();
-            this.latestSnapshot = void 0;
-            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;
-          }
+        {
+          ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
+          options
+        },
+        async (timeout) => {
+          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",
@@ -20219,7 +20550,8 @@ var OpensteerSessionRuntime = class {
         outcome: "ok",
         data: {
           url: input.url,
-          state
+          state,
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
@@ -20235,6 +20567,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: buildMutationCaptureTraceData(mutationCaptureDiagnostics),
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -20247,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(
@@ -20265,7 +20600,9 @@ var OpensteerSessionRuntime = class {
             value: toJsonValueOrNull(evaluated.data)
           };
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "page.evaluate",
@@ -20274,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,
@@ -20289,6 +20627,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: buildMutationCaptureTraceData(mutationCaptureDiagnostics),
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -20367,7 +20706,6 @@ var OpensteerSessionRuntime = class {
             })
           );
           timeout.throwIfAborted();
-          this.latestSnapshot = compiled;
           const artifacts2 = await this.captureSnapshotArtifacts(
             pageRef,
             {
@@ -20517,8 +20855,7 @@ var OpensteerSessionRuntime = class {
               () => compileOpensteerExtractionFieldTargets({
                 pageRef,
                 schema: input.schema,
-                dom: this.requireDom(),
-                ...this.latestSnapshot?.counterRecords === void 0 ? {} : { latestSnapshotCounters: this.latestSnapshot.counterRecords }
+                dom: this.requireDom()
               })
             );
             data = toCanonicalJsonValue(
@@ -20629,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
@@ -20671,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
@@ -20697,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",
@@ -20763,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))
           };
@@ -20776,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
         }
@@ -21480,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 },
@@ -21496,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({
@@ -21511,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,
@@ -21607,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) => {
@@ -21955,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])
@@ -22282,8 +22614,7 @@ var OpensteerSessionRuntime = class {
     const inferred = inferRequestPlanFromNetworkRecord(record, {
       recordId: candidate.recordId,
       key: input.key,
-      version: input.version,
-      lifecycle: "draft"
+      version: input.version
     });
     const defaultHeaders = inferred.payload.endpoint.defaultHeaders === void 0 ? void 0 : stripManagedRequestHeaders(
       inferred.payload.endpoint.defaultHeaders,
@@ -22548,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),
@@ -22891,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({
@@ -22911,8 +23245,7 @@ var OpensteerSessionRuntime = class {
           recordId: input.recordId,
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -22953,8 +23286,7 @@ var OpensteerSessionRuntime = class {
         data: {
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -23000,8 +23332,7 @@ var OpensteerSessionRuntime = class {
         data: {
           id: record.id,
           key: record.key,
-          version: record.version,
-          lifecycle: record.lifecycle
+          version: record.version
         }
       });
       return record;
@@ -23628,34 +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;
-            this.latestSnapshot = void 0;
-            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",
@@ -23671,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({
@@ -23689,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
@@ -23707,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;
           }
@@ -23776,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
@@ -23795,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({
@@ -23832,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,
@@ -23850,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
@@ -23871,19 +24220,15 @@ var OpensteerSessionRuntime = class {
       };
     }
     if (target.kind === "element") {
-      const counter = this.latestSnapshot?.counterRecords.get(target.element);
-      if (!counter) {
-        throw new Error(`no counter ${String(target.element)} is available in the latest snapshot`);
-      }
+      const elementTarget = {
+        kind: "selector",
+        selector: `[c="${String(target.element)}"]`
+      };
       const resolved2 = await timeout.runStep(
         () => this.requireDom().resolveTarget({
           pageRef,
           method,
-          target: {
-            kind: "live",
-            locator: counter.locator,
-            anchor: counter.anchor
-          }
+          target: elementTarget
         })
       );
       const stablePath2 = resolved2.replayPath ?? await timeout.runStep(
@@ -23941,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(
@@ -23963,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 },
@@ -23972,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) {
@@ -24169,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
@@ -24213,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;
@@ -24470,7 +24861,6 @@ var OpensteerSessionRuntime = class {
       timeout.throwIfAborted();
       const records = await this.queryLiveNetwork(
         {
-          source: "live",
           pageRef,
           url,
           method,
@@ -24501,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 },
@@ -24567,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 },
@@ -24585,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(
@@ -24612,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, {
@@ -24896,7 +25388,6 @@ var OpensteerSessionRuntime = class {
     const syntheticSessionRef = binding?.sessionRef ?? createSessionRef(`${transportLabel}-${this.workspace}`);
     const record = {
       recordId,
-      source: "saved",
       savedAt: now,
       record: {
         kind: "http",
@@ -24918,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) {
@@ -25126,7 +25620,7 @@ var OpensteerSessionRuntime = class {
   }
   async touchRequestPlanFreshness(plan) {
     const freshness = touchFreshness(plan.freshness);
-    await this.requireRoot().registry.requestPlans.updateMetadata({
+    await this.requireRoot().registry.requestPlans.updateFreshness({
       id: plan.id,
       ...freshness === void 0 ? {} : { freshness }
     });
@@ -25291,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) },
@@ -25749,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") {
@@ -25794,22 +26257,35 @@ var OpensteerSessionRuntime = class {
         selector: target.selector
       };
     }
-    const counter = this.latestSnapshot?.counterRecords.get(target.element);
-    if (!counter) {
-      throw new Error(`no counter ${String(target.element)} is available in the latest snapshot`);
-    }
     return {
-      kind: "live",
-      locator: counter.locator,
-      anchor: counter.anchor
+      kind: "selector",
+      selector: `[c="${String(target.element)}"]`
     };
   }
   async ensureRoot() {
-    this.root ??= await createFilesystemOpensteerWorkspace({
-      rootPath: this.rootPath,
-      ...this.workspaceName === void 0 ? {} : { workspace: this.workspaceName },
-      scope: this.workspaceName === void 0 ? "temporary" : "workspace"
-    });
+    if (!this.root) {
+      const workspace = await createFilesystemOpensteerWorkspace({
+        rootPath: this.rootPath,
+        ...this.workspaceName === void 0 ? {} : { workspace: this.workspaceName },
+        scope: this.workspaceName === void 0 ? "temporary" : "workspace"
+      });
+      if (this.registryOverrides) {
+        const overrides = this.registryOverrides;
+        this.root = {
+          ...workspace,
+          registry: {
+            ...workspace.registry,
+            ...overrides.requestPlans === void 0 ? {} : { requestPlans: overrides.requestPlans },
+            ...overrides.authRecipes === void 0 ? {} : { authRecipes: overrides.authRecipes },
+            ...overrides.recipes === void 0 ? {} : { recipes: overrides.recipes },
+            ...overrides.reverseCases === void 0 ? {} : { reverseCases: overrides.reverseCases },
+            ...overrides.reversePackages === void 0 ? {} : { reversePackages: overrides.reversePackages }
+          }
+        };
+      } else {
+        this.root = workspace;
+      }
+    }
     return this.root;
   }
   async ensureEngine(overrides = {}) {
@@ -25835,6 +26311,7 @@ var OpensteerSessionRuntime = class {
       engine,
       root,
       namespace: this.workspace,
+      ...this.injectedDescriptorStore === void 0 ? {} : { descriptorStore: this.injectedDescriptorStore },
       policy: this.policy
     });
     this.computer = createComputerUseRuntime({
@@ -25842,7 +26319,7 @@ var OpensteerSessionRuntime = class {
       dom: this.dom,
       policy: this.policy
     });
-    this.extractionDescriptors = createOpensteerExtractionDescriptorStore({
+    this.extractionDescriptors = this.injectedExtractionDescriptorStore ?? createOpensteerExtractionDescriptorStore({
       root,
       namespace: this.workspace
     });
@@ -26059,11 +26536,9 @@ 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.latestSnapshot = void 0;
     this.runId = void 0;
     this.dom = void 0;
     this.computer = void 0;
@@ -26137,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 [];
     }
@@ -26149,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;
     }
@@ -26197,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)) {
@@ -26209,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;
     }
@@ -26419,9 +26894,8 @@ 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 }
     },
-    lifecycle: "draft",
     payload: normalizeRequestPlanPayload({
       transport: {
         kind: input.transport
@@ -26639,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";
@@ -28576,7 +29050,7 @@ function directionToDelta(direction, amount) {
       return { x: amount, y: 0 };
   }
 }
-function normalizeNamespace3(value) {
+function normalizeNamespace2(value) {
   const normalized = String(value ?? "default").trim();
   return normalized.length === 0 ? "default" : normalized;
 }
@@ -28608,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":
@@ -28622,6 +29127,6 @@ function screenshotMediaType(format2) {
   }
 }
 
-export { OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, OpensteerSessionRuntime, createFilesystemOpensteerWorkspace, dispatchSemanticOperation, normalizeWorkspaceId, resolveFilesystemWorkspacePath };
+export { OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, OpensteerSessionRuntime, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, createDomDescriptorStore, createFilesystemOpensteerWorkspace, createOpensteerExtractionDescriptorStore, dispatchSemanticOperation, hashDomDescriptorDescription, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveFilesystemWorkspacePath, sanitizeReplayElementPath };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map