opensteer 0.8.7 → 0.8.8

package/dist/index.cjs

@@ -1464,7 +1464,7 @@ var networkRecordSchema = objectSchema(
 var networkQueryRecordSchema = objectSchema(
   {
     recordId: stringSchema({ minLength: 1 }),
-    actionId: stringSchema({ minLength: 1 }),
+    capture: stringSchema({ minLength: 1 }),
     tags: arraySchema(stringSchema({ minLength: 1 }), {
       uniqueItems: true
     }),
@@ -1944,8 +1944,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     objectSchema(
       {
         kind: enumSchema(["goto"]),
-        url: stringSchema({ minLength: 1 }),
-        networkTag: stringSchema({ minLength: 1 })
+        url: stringSchema({ minLength: 1 })
       },
       {
         title: "OpensteerAuthRecipeGotoStep",
@@ -1954,8 +1953,7 @@ var opensteerRecipeStepSchema = oneOfSchema(
     ),
     objectSchema(
       {
-        kind: enumSchema(["reload"]),
-        networkTag: stringSchema({ minLength: 1 })
+        kind: enumSchema(["reload"])
       },
       {
         title: "OpensteerAuthRecipeReloadStep",
@@ -2172,7 +2170,7 @@ var opensteerNetworkQueryInputSchema = 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 }),
@@ -2201,7 +2199,7 @@ 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 }),
@@ -2226,6 +2224,7 @@ var opensteerNetworkTagOutputSchema = objectSchema(
 );
 var opensteerNetworkClearInputSchema = objectSchema(
   {
+    capture: stringSchema({ minLength: 1 }),
     tag: stringSchema({ minLength: 1 })
   },
   {
@@ -6077,7 +6076,7 @@ var opensteerPageCloseOutputSchema = objectSchema(
 var opensteerPageGotoInputSchema = objectSchema(
   {
     url: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerPageGotoInput",
@@ -6228,7 +6227,7 @@ var opensteerDomClickInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomClickInput",
@@ -6239,7 +6238,7 @@ var opensteerDomHoverInputSchema = objectSchema(
   {
     target: opensteerTargetInputSchema,
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomHoverInput",
@@ -6252,7 +6251,7 @@ var opensteerDomInputInputSchema = objectSchema(
     text: stringSchema(),
     pressEnter: { type: "boolean" },
     persistAsDescription: stringSchema(),
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerDomInputInput",
@@ -6265,7 +6264,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",
@@ -6466,7 +6465,7 @@ var opensteerComputerExecuteInputSchema = objectSchema(
   {
     action: opensteerComputerActionSchema,
     screenshot: opensteerComputerScreenshotOptionsSchema,
-    networkTag: stringSchema({ minLength: 1 })
+    captureNetwork: stringSchema({ minLength: 1 })
   },
   {
     title: "OpensteerComputerExecuteInput",
@@ -7602,7 +7601,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,
@@ -7715,39 +7714,31 @@ var SqliteSavedNetworkStore = class {
   }
   async clear(input = {}) {
     const database = await this.requireDatabase();
-    const countAll = database.prepare(`
-      SELECT COUNT(*) AS cleared
-      FROM saved_network_records
-    `);
-    const countByTag = database.prepare(`
-      SELECT COUNT(DISTINCT record_id) AS cleared
-      FROM saved_network_tags
-      WHERE tag = @tag
-    `);
-    const deleteAllTags = database.prepare(`DELETE FROM saved_network_tags`);
+    const countAll = database.prepare(`SELECT COUNT(*) AS cleared FROM saved_network_records`);
     const deleteAllRecords = database.prepare(`DELETE FROM saved_network_records`);
-    const deleteTag = database.prepare(`
-      DELETE FROM saved_network_tags
-      WHERE tag = @tag
+    const { whereSql, parameters } = buildSavedNetworkWhere(input);
+    const countFiltered = database.prepare(`
+      SELECT COUNT(*) AS cleared
+      FROM saved_network_records r
+      ${whereSql}
     `);
-    const deleteOrphans = database.prepare(`
+    const deleteFiltered = database.prepare(`
       DELETE FROM saved_network_records
-      WHERE NOT EXISTS (
-        SELECT 1
-        FROM saved_network_tags t
-        WHERE t.record_id = saved_network_records.record_id
+      WHERE record_id IN (
+        SELECT r.record_id
+        FROM saved_network_records r
+        ${whereSql}
       )
     `);
     return withSqliteTransaction(database, () => {
-      const tag = input.tag;
-      const cleared = tag === void 0 ? countAll.get().cleared : countByTag.get({ tag }).cleared;
-      if (tag === void 0) {
-        deleteAllTags.run();
+      if (input.capture === void 0 && input.tag === void 0) {
+        const cleared2 = countAll.get().cleared;
         deleteAllRecords.run();
-        return cleared;
+        return cleared2;
       }
-      deleteTag.run({ tag });
-      deleteOrphans.run();
+      const args = parameters;
+      const cleared = countFiltered.get(...args).cleared;
+      deleteFiltered.run(...args);
       return cleared;
     });
   }
@@ -7802,7 +7793,7 @@ var SqliteSavedNetworkStore = class {
         page_ref_key TEXT NOT NULL,
         frame_ref TEXT,
         document_ref TEXT,
-        action_id TEXT,
+        capture TEXT,
         method TEXT NOT NULL,
         method_lc TEXT NOT NULL,
         url TEXT NOT NULL,
@@ -7841,6 +7832,9 @@ var SqliteSavedNetworkStore = class {
       CREATE INDEX IF NOT EXISTS saved_network_records_saved_at
         ON saved_network_records (saved_at DESC);
 
+      CREATE INDEX IF NOT EXISTS saved_network_records_capture
+        ON saved_network_records (capture);
+
       CREATE TABLE IF NOT EXISTS saved_network_tags (
         record_id TEXT NOT NULL REFERENCES saved_network_records(record_id) ON DELETE CASCADE,
         tag TEXT NOT NULL,
@@ -7856,6 +7850,7 @@ var SqliteSavedNetworkStore = class {
       "capture_state",
       "TEXT NOT NULL DEFAULT 'complete'"
     );
+    this.ensureColumn(database, "saved_network_records", "capture", "TEXT");
     this.ensureColumn(
       database,
       "saved_network_records",
@@ -7896,9 +7891,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(`
@@ -7960,7 +7955,7 @@ function buildSavedNetworkUpsertSql(bodyWriteMode) {
         page_ref_key,
         frame_ref,
         document_ref,
-        action_id,
+        capture,
         method,
         method_lc,
         url,
@@ -7999,7 +7994,7 @@ function buildSavedNetworkUpsertSql(bodyWriteMode) {
         @page_ref_key,
         @frame_ref,
         @document_ref,
-        @action_id,
+        @capture,
         @method,
         @method_lc,
         @url,
@@ -8036,7 +8031,7 @@ function buildSavedNetworkUpsertSql(bodyWriteMode) {
         page_ref_key = excluded.page_ref_key,
         frame_ref = excluded.frame_ref,
         document_ref = excluded.document_ref,
-        action_id = excluded.action_id,
+        capture = excluded.capture,
         method = excluded.method,
         method_lc = excluded.method_lc,
         url = excluded.url,
@@ -8131,7 +8126,7 @@ function inflateSavedNetworkRow(row, includeBodies) {
   }
   return {
     recordId: row.record_id,
-    ...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
@@ -8471,9 +8466,9 @@ 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,
@@ -10270,6 +10265,7 @@ var MemoryDomDescriptorStore = class {
 };
 
 // ../runtime-core/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);
@@ -10281,6 +10277,35 @@ async function captureActionBoundarySnapshot(engine, 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";
+}
 
 // ../runtime-core/src/runtimes/dom/executor.ts
 var MAX_DOM_ACTION_ATTEMPTS = 3;
@@ -10413,7 +10438,7 @@ 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, {
@@ -10437,7 +10462,15 @@ var DomActionExecutor = class {
             );
             finalResolved = enterResolved;
           }
-          await this.settle(finalResolved.pageRef, "dom.input", timeout, finalSnapshot);
+          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;
@@ -10514,12 +10547,13 @@ var DomActionExecutor = class {
             () => captureActionBoundarySnapshot(this.options.engine, pointerTarget.resolved.pageRef)
           );
           const outcome = await dispatch(pointerTarget, point, timeout);
-          await this.settle(
+          const settleDiagnostics = await this.settle(
             pointerTarget.resolved.pageRef,
             input.operation,
             timeout,
             actionBoundarySnapshot
           );
+          recordActionBoundaryDiagnostics(timeout.signal, settleDiagnostics);
           return outcome;
         } catch (error) {
           lastError = error;
@@ -10539,22 +10573,47 @@ var DomActionExecutor = class {
   }
   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, trigger) => settleWithPolicy(this.options.policy.settle, {
-          operation,
-          trigger,
-          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) {
@@ -15817,7 +15876,7 @@ async function sleep(ms) {
 
 // ../runtime-core/package.json
 var package_default = {
-  version: "0.1.1"};
+  version: "0.1.2"};
 
 // ../runtime-core/src/version.ts
 var OPENSTEER_RUNTIME_CORE_VERSION = package_default.version;
@@ -16118,6 +16177,7 @@ var DefaultComputerUseRuntime = class {
     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,
@@ -16126,16 +16186,35 @@ var DefaultComputerUseRuntime = class {
         screenshot,
         signal: input.timeout.signal,
         remainingMs: () => input.timeout.remainingMs(),
-        policySettle: async (pageRef, trigger) => settleWithPolicy(this.options.policy.settle, {
-          operation: "computer.execute",
-          trigger,
-          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 {
@@ -17508,7 +17587,7 @@ function resolveBodyEncoding(charset) {
 var NetworkHistory = class {
   metadataByRequestId = /* @__PURE__ */ new Map();
   requestIdByRecordId = /* @__PURE__ */ new Map();
-  requestIdsByActionId = /* @__PURE__ */ new Map();
+  requestIdsByCapture = /* @__PURE__ */ new Map();
   requestIdsByTag = /* @__PURE__ */ new Map();
   tombstonedRequestIds = /* @__PURE__ */ new Set();
   materialize(records, options = {}) {
@@ -17555,17 +17634,17 @@ var NetworkHistory = class {
     }
     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) {
@@ -17585,8 +17664,8 @@ var NetworkHistory = 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) ?? []);
@@ -17597,20 +17676,6 @@ var NetworkHistory = class {
   getKnownRequestIds() {
     return new Set(this.metadataByRequestId.keys());
   }
-  clearTag(tag) {
-    const requestIds = [...this.requestIdsByTag.get(tag) ?? []];
-    this.requestIdsByTag.delete(tag);
-    for (const requestId of requestIds) {
-      const metadata = this.metadataByRequestId.get(requestId);
-      if (!metadata) {
-        continue;
-      }
-      metadata.tags.delete(tag);
-      if (metadata.tags.size === 0) {
-        this.tombstoneRequestIds([requestId]);
-      }
-    }
-  }
   tombstoneRequestIds(requestIds) {
     for (const requestId of requestIds) {
       this.tombstonedRequestIds.add(requestId);
@@ -17620,8 +17685,8 @@ var NetworkHistory = class {
       }
       this.metadataByRequestId.delete(requestId);
       this.requestIdByRecordId.delete(metadata.recordId);
-      if (metadata.actionId !== void 0) {
-        this.requestIdsByActionId.get(metadata.actionId)?.delete(requestId);
+      if (metadata.capture !== void 0) {
+        this.requestIdsByCapture.get(metadata.capture)?.delete(requestId);
       }
       for (const tag of metadata.tags) {
         this.requestIdsByTag.get(tag)?.delete(requestId);
@@ -17631,7 +17696,7 @@ var NetworkHistory = class {
   clear() {
     this.metadataByRequestId.clear();
     this.requestIdByRecordId.clear();
-    this.requestIdsByActionId.clear();
+    this.requestIdsByCapture.clear();
     this.requestIdsByTag.clear();
     this.tombstonedRequestIds.clear();
   }
@@ -17654,7 +17719,7 @@ var NetworkHistory = class {
     }
     return {
       recordId: metadata.recordId,
-      ...metadata.actionId === void 0 ? {} : { actionId: metadata.actionId },
+      ...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, {
@@ -22472,6 +22537,7 @@ function diffInteractionTraces(left, right) {
 
 // ../runtime-core/src/sdk/runtime.ts
 var requireForAuthRecipeHook = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
+var MUTATION_CAPTURE_FINALIZE_TIMEOUT_MS = 5e3;
 var OpensteerSessionRuntime = class {
   workspace;
   rootPath;
@@ -22854,34 +22920,32 @@ var OpensteerSessionRuntime = class {
     assertValidSemanticOperationInput("page.goto", input);
     const pageRef = await this.ensurePageRef();
     const startedAt = Date.now();
+    let mutationCaptureDiagnostics;
     try {
-      const { navigation, state } = await this.runWithOperationTimeout(
+      const { navigation, state } = await this.runMutationCapturedOperation(
         "page.goto",
+        {
+          ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
+          options
+        },
         async (timeout) => {
-          const baselineRequestIds = await this.beginMutationCapture(timeout);
-          try {
-            const navigation2 = await this.navigatePage(
-              {
-                operation: "page.goto",
-                pageRef,
-                url: input.url
-              },
-              timeout
-            );
-            timeout.throwIfAborted();
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
-            return {
-              navigation: navigation2,
-              state: await timeout.runStep(() => this.readSessionState())
-            };
-          } catch (error) {
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag).catch(
-              () => void 0
-            );
-            throw error;
-          }
+          const navigation2 = await this.navigatePage(
+            {
+              operation: "page.goto",
+              pageRef,
+              url: input.url
+            },
+            timeout
+          );
+          timeout.throwIfAborted();
+          return {
+            navigation: navigation2,
+            state: await timeout.runStep(() => this.readSessionState())
+          };
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "page.goto",
@@ -22890,7 +22954,8 @@ var OpensteerSessionRuntime = class {
         outcome: "ok",
         data: {
           url: input.url,
-          state
+          state,
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
@@ -22906,6 +22971,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: buildMutationCaptureTraceData(mutationCaptureDiagnostics),
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -22918,34 +22984,29 @@ 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 baselineRequestIds = await this.beginMutationCapture(timeout);
-          try {
-            const remainingMs = timeout.remainingMs();
-            const evaluated = await timeout.runStep(
-              () => this.requireEngine().evaluatePage({
-                pageRef,
-                script: input.script,
-                ...input.args === void 0 ? {} : { args: input.args },
-                ...remainingMs === void 0 ? {} : { timeoutMs: remainingMs }
-              })
-            );
-            await this.completeMutationCapture(timeout, baselineRequestIds, void 0);
-            return {
+          const remainingMs = timeout.remainingMs();
+          const evaluated = await timeout.runStep(
+            () => this.requireEngine().evaluatePage({
               pageRef,
-              value: toJsonValueOrNull(evaluated.data)
-            };
-          } catch (error) {
-            await this.completeMutationCapture(timeout, baselineRequestIds, void 0).catch(
-              () => void 0
-            );
-            throw error;
-          }
+              script: input.script,
+              ...input.args === void 0 ? {} : { args: input.args },
+              ...remainingMs === void 0 ? {} : { timeoutMs: remainingMs }
+            })
+          );
+          return {
+            pageRef,
+            value: toJsonValueOrNull(evaluated.data)
+          };
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "page.evaluate",
@@ -22954,7 +23015,8 @@ var OpensteerSessionRuntime = class {
         outcome: "ok",
         data: {
           pageRef: output.pageRef,
-          value: output.value
+          value: output.value,
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
         },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
@@ -22969,6 +23031,7 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: buildMutationCaptureTraceData(mutationCaptureDiagnostics),
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -23408,17 +23471,29 @@ var OpensteerSessionRuntime = class {
         "network.clear",
         async (timeout) => {
           if (this.sessionRef !== void 0) {
-            const liveRequestIds = await this.readLiveRequestIds(timeout, {
-              includeCurrentPageOnly: false
-            });
-            if (input.tag === 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.tag === void 0) {
+          if (input.capture === void 0 && input.tag === void 0) {
             this.networkHistory.tombstoneRequestIds(this.networkHistory.getKnownRequestIds());
-          } else {
-            this.networkHistory.clearTag(input.tag);
           }
           return {
             clearedCount: await timeout.runStep(() => root.registry.savedNetwork.clear(input))
@@ -23432,6 +23507,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
         }
@@ -24613,7 +24689,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])
@@ -26285,33 +26363,38 @@ var OpensteerSessionRuntime = class {
     assertValidSemanticOperationInput("computer.execute", input);
     const pageRef = await this.ensurePageRef();
     const startedAt = Date.now();
+    let mutationCaptureDiagnostics;
+    let boundaryDiagnostics;
     try {
-      const { artifacts, output } = await this.runWithOperationTimeout(
+      const { artifacts, output } = await this.runMutationCapturedOperation(
         "computer.execute",
+        {
+          ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork },
+          options
+        },
         async (timeout) => {
-          const baselineRequestIds = await this.beginMutationCapture(timeout);
           try {
             const output2 = await this.requireComputer().execute({
               pageRef,
               input,
               timeout
             });
+            boundaryDiagnostics = takeActionBoundaryDiagnostics(timeout.signal);
             timeout.throwIfAborted();
             this.pageRef = output2.pageRef;
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag);
             const artifacts2 = await this.persistComputerArtifacts(output2, timeout);
             return {
               artifacts: { manifests: artifacts2.manifests },
               output: artifacts2.output
             };
           } catch (error) {
-            await this.completeMutationCapture(timeout, baselineRequestIds, input.networkTag).catch(
-              () => void 0
-            );
+            boundaryDiagnostics ??= takeActionBoundaryDiagnostics(timeout.signal);
             throw error;
           }
         },
-        options
+        (diagnostics) => {
+          mutationCaptureDiagnostics = diagnostics;
+        }
       );
       await this.appendTrace({
         operation: "computer.execute",
@@ -26327,6 +26410,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({
@@ -26345,6 +26430,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
@@ -26448,33 +26537,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({
@@ -26485,7 +26579,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,
@@ -26503,6 +26599,10 @@ var OpensteerSessionRuntime = class {
         completedAt: Date.now(),
         outcome: "error",
         error,
+        data: {
+          ...boundaryDiagnostics === void 0 ? {} : { settle: boundaryDiagnostics },
+          ...buildMutationCaptureTraceData(mutationCaptureDiagnostics)
+        },
         context: buildRuntimeTraceContext({
           sessionRef: this.sessionRef,
           pageRef
@@ -26612,7 +26712,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 },
@@ -26818,32 +26918,68 @@ 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.networkHistory.assignActionId(delta, `action:${crypto.randomUUID()}`);
-    if (networkTag !== void 0) {
-      this.networkHistory.addTag(delta, networkTag);
-    }
-    await this.persistLiveRequestIds(
+    this.networkHistory.assignCapture(delta, plan.capture);
+    await this.persistLiveRequestIdsWithSignal(
       delta.map((record) => record.record.requestId),
-      timeout,
+      signal,
       {
         includeCurrentPageOnly: true
       }
@@ -27250,27 +27386,28 @@ var OpensteerSessionRuntime = class {
     });
   }
   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 timeout.runStep(
-      () => this.readBrowserNetworkRecords(
-        {
-          includeBodies: true,
-          includeCurrentPageOnly: options.includeCurrentPageOnly,
-          ...options.pageRef === void 0 ? {} : { pageRef: options.pageRef },
-          requestIds
-        },
-        timeout.signal
-      )
-    );
-    return timeout.runStep(
-      () => this.networkHistory.persist(browserRecords, root.registry.savedNetwork, {
-        bodyWriteMode: "authoritative",
-        redactSecretHeaders: false
-      })
+    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) {
@@ -27312,7 +27449,7 @@ var OpensteerSessionRuntime = class {
       ...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.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 },
@@ -27329,7 +27466,7 @@ var OpensteerSessionRuntime = class {
       ...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.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 },
@@ -28891,8 +29028,8 @@ function resolveLiveQueryRequestIds(input, history) {
   if (input.requestId !== void 0) {
     requestIdCandidates.push(/* @__PURE__ */ new Set([input.requestId]));
   }
-  if (input.actionId !== void 0) {
-    requestIdCandidates.push(history.getRequestIdsForActionId(input.actionId));
+  if (input.capture !== void 0) {
+    requestIdCandidates.push(history.getRequestIdsForCapture(input.capture));
   }
   if (input.tag !== void 0) {
     requestIdCandidates.push(history.getRequestIdsForTag(input.tag));
@@ -28939,7 +29076,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)) {
@@ -31349,9 +31486,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":
@@ -33672,7 +33840,7 @@ function normalizeTargetOptions(input) {
         element: input.element
       },
       ...input.description === void 0 ? {} : { persistAsDescription: input.description },
-      ...input.networkTag === void 0 ? {} : { networkTag: input.networkTag }
+      ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork }
     };
   }
   if (hasSelector) {
@@ -33682,7 +33850,7 @@ function normalizeTargetOptions(input) {
         selector: input.selector
       },
       ...input.description === void 0 ? {} : { persistAsDescription: input.description },
-      ...input.networkTag === void 0 ? {} : { networkTag: input.networkTag }
+      ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork }
     };
   }
   if (input.description === void 0) {
@@ -33693,7 +33861,7 @@ function normalizeTargetOptions(input) {
       kind: "description",
       description: input.description
     },
-    ...input.networkTag === void 0 ? {} : { networkTag: input.networkTag }
+    ...input.captureNetwork === void 0 ? {} : { captureNetwork: input.captureNetwork }
   };
 }
 function delay2(ms) {