@opensteer/runtime-core 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { BrowserCoreEngine, PageRef, NetworkRecord, HeaderEntry, BodyPayload, SessionRef } from '@opensteer/browser-core';
-import { OpensteerSemanticOperationName, OpensteerArtifactKind, ArtifactProvenance, TraceContext, HtmlSnapshot, DomSnapshot, CookieRecord, StorageSnapshot, ScriptSourceArtifactData, ArtifactRelation, ArtifactReference, OpensteerArtifact, OpensteerRequestPlanPayload, OpensteerRequestPlanLifecycle, OpensteerRequestPlanFreshness, OpensteerAuthRecipePayload, OpensteerRecipePayload, OpensteerReverseCasePayload, OpensteerInteractionTracePayload, OpensteerReversePackagePayload, OpensteerReverseReportPayload, NetworkQueryRecord, NetworkResourceType, TraceOutcome, OpensteerEvent, OpensteerError, TraceRecord, TraceBundle, OpensteerBrowserOptions, OpensteerBrowserLaunchOptions, OpensteerBrowserContextOptions, OpensteerSessionInfo, OpensteerOpenInput, OpensteerOpenOutput, OpensteerPageListInput, OpensteerPageListOutput, OpensteerPageNewInput, OpensteerPageNewOutput, OpensteerPageActivateInput, OpensteerPageActivateOutput, OpensteerPageCloseInput, OpensteerPageCloseOutput, OpensteerPageGotoInput, OpensteerPageGotoOutput, OpensteerPageEvaluateInput, OpensteerPageEvaluateOutput, OpensteerAddInitScriptInput, OpensteerAddInitScriptOutput, OpensteerPageSnapshotInput, OpensteerPageSnapshotOutput, OpensteerDomClickInput, OpensteerActionResult, OpensteerDomHoverInput, OpensteerDomInputInput, OpensteerDomScrollInput, OpensteerDomExtractInput, OpensteerDomExtractOutput, OpensteerNetworkQueryInput, OpensteerNetworkQueryOutput, OpensteerNetworkSaveInput, OpensteerNetworkSaveOutput, OpensteerNetworkClearInput, OpensteerNetworkClearOutput, OpensteerCaptureScriptsInput, OpensteerCaptureScriptsOutput, OpensteerNetworkMinimizeInput, OpensteerNetworkMinimizeOutput, OpensteerNetworkDiffInput, OpensteerNetworkDiffOutput, OpensteerArtifactReadInput, OpensteerArtifactReadOutput, OpensteerTransportProbeInput, OpensteerTransportProbeOutput, OpensteerReverseDiscoverInput, OpensteerReverseDiscoverOutput, OpensteerReverseQueryInput, OpensteerReverseQueryOutput, OpensteerReversePackageCreateInput, OpensteerReversePackageCreateOutput, OpensteerReversePackageRunInput, OpensteerReversePackageRunOutput, OpensteerReverseExportInput, OpensteerReverseExportOutput, OpensteerReverseReportInput, OpensteerReverseReportOutput, OpensteerReversePackageGetInput, OpensteerReversePackageGetOutput, OpensteerReversePackageListInput, OpensteerReversePackageListOutput, OpensteerReversePackagePatchInput, OpensteerReversePackagePatchOutput, OpensteerInteractionCaptureInput, OpensteerInteractionCaptureOutput, OpensteerInteractionGetInput, OpensteerInteractionGetOutput, OpensteerInteractionDiffInput, OpensteerInteractionDiffOutput, OpensteerInteractionReplayInput, OpensteerInteractionReplayOutput, OpensteerScriptBeautifyInput, OpensteerScriptBeautifyOutput, OpensteerScriptDeobfuscateInput, OpensteerScriptDeobfuscateOutput, OpensteerScriptSandboxInput, OpensteerScriptSandboxOutput, OpensteerCaptchaSolveInput, OpensteerCaptchaSolveOutput, OpensteerInferRequestPlanInput, OpensteerWriteRequestPlanInput, OpensteerGetRequestPlanInput, OpensteerListRequestPlansInput, OpensteerListRequestPlansOutput, OpensteerWriteAuthRecipeInput, OpensteerWriteRecipeInput, OpensteerGetAuthRecipeInput, OpensteerGetRecipeInput, OpensteerListAuthRecipesInput, OpensteerListAuthRecipesOutput, OpensteerListRecipesInput, OpensteerListRecipesOutput, OpensteerRunAuthRecipeInput, OpensteerRunAuthRecipeOutput, OpensteerRunRecipeInput, OpensteerRunRecipeOutput, OpensteerRawRequestInput, OpensteerRawRequestOutput, OpensteerRequestExecuteInput, OpensteerRequestExecuteOutput, OpensteerComputerExecuteInput, OpensteerComputerExecuteOutput, OpensteerSessionCloseOutput } from '@opensteer/protocol';
+import { OpensteerSemanticOperationName, OpensteerArtifactKind, ArtifactProvenance, TraceContext, HtmlSnapshot, DomSnapshot, CookieRecord, StorageSnapshot, ScriptSourceArtifactData, ArtifactRelation, ArtifactReference, OpensteerArtifact, OpensteerAuthRecipePayload, OpensteerRequestPlanPayload, OpensteerRequestPlanFreshness, OpensteerRecipePayload, OpensteerReverseCasePayload, OpensteerInteractionTracePayload, OpensteerReversePackagePayload, OpensteerReverseReportPayload, NetworkQueryRecord, NetworkResourceType, TraceOutcome, OpensteerEvent, OpensteerError, TraceRecord, TraceBundle, ReplayElementPath, OpensteerBrowserOptions, OpensteerBrowserLaunchOptions, OpensteerBrowserContextOptions, OpensteerSessionInfo, OpensteerOpenInput, OpensteerOpenOutput, OpensteerPageListInput, OpensteerPageListOutput, OpensteerPageNewInput, OpensteerPageNewOutput, OpensteerPageActivateInput, OpensteerPageActivateOutput, OpensteerPageCloseInput, OpensteerPageCloseOutput, OpensteerPageGotoInput, OpensteerPageGotoOutput, OpensteerPageEvaluateInput, OpensteerPageEvaluateOutput, OpensteerAddInitScriptInput, OpensteerAddInitScriptOutput, OpensteerPageSnapshotInput, OpensteerPageSnapshotOutput, OpensteerDomClickInput, OpensteerActionResult, OpensteerDomHoverInput, OpensteerDomInputInput, OpensteerDomScrollInput, OpensteerDomExtractInput, OpensteerDomExtractOutput, OpensteerNetworkQueryInput, OpensteerNetworkQueryOutput, OpensteerNetworkTagInput, OpensteerNetworkTagOutput, OpensteerNetworkClearInput, OpensteerNetworkClearOutput, OpensteerCaptureScriptsInput, OpensteerCaptureScriptsOutput, OpensteerNetworkMinimizeInput, OpensteerNetworkMinimizeOutput, OpensteerNetworkDiffInput, OpensteerNetworkDiffOutput, OpensteerArtifactReadInput, OpensteerArtifactReadOutput, OpensteerTransportProbeInput, OpensteerTransportProbeOutput, OpensteerReverseDiscoverInput, OpensteerReverseDiscoverOutput, OpensteerReverseQueryInput, OpensteerReverseQueryOutput, OpensteerReversePackageCreateInput, OpensteerReversePackageCreateOutput, OpensteerReversePackageRunInput, OpensteerReversePackageRunOutput, OpensteerReverseExportInput, OpensteerReverseExportOutput, OpensteerReverseReportInput, OpensteerReverseReportOutput, OpensteerReversePackageGetInput, OpensteerReversePackageGetOutput, OpensteerReversePackageListInput, OpensteerReversePackageListOutput, OpensteerReversePackagePatchInput, OpensteerReversePackagePatchOutput, OpensteerInteractionCaptureInput, OpensteerInteractionCaptureOutput, OpensteerInteractionGetInput, OpensteerInteractionGetOutput, OpensteerInteractionDiffInput, OpensteerInteractionDiffOutput, OpensteerInteractionReplayInput, OpensteerInteractionReplayOutput, OpensteerScriptBeautifyInput, OpensteerScriptBeautifyOutput, OpensteerScriptDeobfuscateInput, OpensteerScriptDeobfuscateOutput, OpensteerScriptSandboxInput, OpensteerScriptSandboxOutput, OpensteerCaptchaSolveInput, OpensteerCaptchaSolveOutput, OpensteerInferRequestPlanInput, OpensteerWriteRequestPlanInput, OpensteerGetRequestPlanInput, OpensteerListRequestPlansInput, OpensteerListRequestPlansOutput, OpensteerWriteAuthRecipeInput, OpensteerWriteRecipeInput, OpensteerGetAuthRecipeInput, OpensteerGetRecipeInput, OpensteerListAuthRecipesInput, OpensteerListAuthRecipesOutput, OpensteerListRecipesInput, OpensteerListRecipesOutput, OpensteerRunAuthRecipeInput, OpensteerRunAuthRecipeOutput, OpensteerRunRecipeInput, OpensteerRunRecipeOutput, OpensteerRawRequestInput, OpensteerRawRequestOutput, OpensteerRequestExecuteInput, OpensteerRequestExecuteOutput, OpensteerComputerExecuteInput, OpensteerComputerExecuteOutput, OpensteerSessionCloseOutput } from '@opensteer/protocol';
+export { ReplayElementPath } from '@opensteer/protocol';
 
 declare const OPENSTEER_RUNTIME_CORE_VERSION: string;
 
@@ -163,10 +164,8 @@ type InteractionTraceRecord = RegistryRecord<OpensteerInteractionTracePayload>;
 type ReverseCaseRecord = RegistryRecord<OpensteerReverseCasePayload>;
 type ReversePackageRecord = RegistryRecord<OpensteerReversePackagePayload>;
 type ReverseReportRecord = RegistryRecord<OpensteerReverseReportPayload>;
-type RequestPlanLifecycle = OpensteerRequestPlanLifecycle;
 type RequestPlanFreshness = OpensteerRequestPlanFreshness;
 interface RequestPlanRecord extends RegistryRecord<OpensteerRequestPlanPayload> {
-    readonly lifecycle: RequestPlanLifecycle;
     readonly freshness?: RequestPlanFreshness;
 }
 interface ResolveRegistryRecordInput {
@@ -184,7 +183,6 @@ interface WriteDescriptorInput<TPayload = JsonValue> {
     readonly payload: TPayload;
 }
 interface WriteRequestPlanInput extends WriteDescriptorInput<OpensteerRequestPlanPayload> {
-    readonly lifecycle?: RequestPlanLifecycle;
     readonly freshness?: RequestPlanFreshness;
 }
 interface WriteAuthRecipeInput extends WriteDescriptorInput<OpensteerAuthRecipePayload> {
@@ -202,10 +200,9 @@ interface WriteReverseReportInput extends WriteDescriptorInput<OpensteerReverseR
 interface ListRegistryRecordsInput {
     readonly key?: string;
 }
-interface UpdateRequestPlanMetadataInput {
+interface UpdateRequestPlanFreshnessInput {
     readonly id: string;
     readonly updatedAt?: number;
-    readonly lifecycle?: RequestPlanLifecycle;
     readonly freshness?: RequestPlanFreshness;
 }
 interface UpdateReverseCaseInput {
@@ -220,6 +217,7 @@ interface DescriptorRegistryStore {
     readonly indexesDirectory: string;
     write(input: WriteDescriptorInput): Promise<DescriptorRecord>;
     getById(id: string): Promise<DescriptorRecord | undefined>;
+    list(input?: ListRegistryRecordsInput): Promise<readonly DescriptorRecord[]>;
     resolve(input: ResolveRegistryRecordInput): Promise<DescriptorRecord | undefined>;
 }
 interface RequestPlanRegistryStore {
@@ -229,7 +227,7 @@ interface RequestPlanRegistryStore {
     getById(id: string): Promise<RequestPlanRecord | undefined>;
     list(input?: ListRegistryRecordsInput): Promise<readonly RequestPlanRecord[]>;
     resolve(input: ResolveRegistryRecordInput): Promise<RequestPlanRecord | undefined>;
-    updateMetadata(input: UpdateRequestPlanMetadataInput): Promise<RequestPlanRecord>;
+    updateFreshness(input: UpdateRequestPlanFreshnessInput): Promise<RequestPlanRecord>;
 }
 interface AuthRecipeRegistryStore {
     readonly recordsDirectory: string;
@@ -280,9 +278,10 @@ interface ReverseReportRegistryStore {
 }
 
 interface SavedNetworkQueryInput {
+    readonly pageRef?: NetworkQueryRecord["record"]["pageRef"];
     readonly recordId?: string;
     readonly requestId?: string;
-    readonly actionId?: string;
+    readonly capture?: string;
     readonly tag?: string;
     readonly url?: string;
     readonly hostname?: string;
@@ -293,15 +292,22 @@ interface SavedNetworkQueryInput {
     readonly includeBodies?: boolean;
     readonly limit?: number;
 }
+type SavedNetworkBodyWriteMode = "authoritative" | "metadata-only";
+interface SavedNetworkSaveOptions {
+    readonly bodyWriteMode: SavedNetworkBodyWriteMode;
+    readonly tag?: string;
+}
 interface SavedNetworkStore {
     readonly databasePath: string;
     initialize(): Promise<void>;
-    save(records: readonly NetworkQueryRecord[], tag?: string): Promise<number>;
+    save(records: readonly NetworkQueryRecord[], options: SavedNetworkSaveOptions): Promise<number>;
+    tagByFilter(filter: SavedNetworkQueryInput, tag: string): Promise<number>;
     query(input?: SavedNetworkQueryInput): Promise<readonly NetworkQueryRecord[]>;
     getByRecordId(recordId: string, options?: {
         readonly includeBodies?: boolean;
     }): Promise<NetworkQueryRecord | undefined>;
     clear(input?: {
+        readonly capture?: string;
         readonly tag?: string;
     }): Promise<number>;
 }
@@ -389,8 +395,8 @@ interface FilesystemOpensteerWorkspace {
     readonly browserManifestPath: string;
     readonly browserUserDataDir: string;
     readonly livePath: string;
-    readonly liveSessionPath: string;
-    readonly liveBrowserPath: string;
+    readonly liveLocalPath: string;
+    readonly liveCloudPath: string;
     readonly artifactsPath: string;
     readonly tracesPath: string;
     readonly registryPath: string;
@@ -417,6 +423,55 @@ declare function resolveFilesystemWorkspacePath(input: {
 }): string;
 declare function createFilesystemOpensteerWorkspace(options: CreateFilesystemOpensteerWorkspaceOptions): Promise<FilesystemOpensteerWorkspace>;
 
+type ElementPath = ReplayElementPath;
+interface DomDescriptorPayload {
+    readonly kind: "dom-target";
+    readonly method: string;
+    readonly description: string;
+    readonly path: ReplayElementPath;
+    readonly sourceUrl?: string;
+}
+interface DomDescriptorRecord {
+    readonly id: string;
+    readonly key: string;
+    readonly version: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly payload: DomDescriptorPayload;
+}
+interface DomWriteDescriptorInput {
+    readonly method: string;
+    readonly description: string;
+    readonly path: ReplayElementPath;
+    readonly sourceUrl?: string;
+    readonly createdAt?: number;
+    readonly updatedAt?: number;
+}
+interface DomReadDescriptorInput {
+    readonly method: string;
+    readonly description: string;
+}
+
+interface DomDescriptorStore {
+    read(input: DomReadDescriptorInput): Promise<DomDescriptorRecord | undefined>;
+    write(input: DomWriteDescriptorInput): Promise<DomDescriptorRecord>;
+}
+declare function createDomDescriptorStore(options: {
+    readonly root?: FilesystemOpensteerWorkspace;
+    readonly namespace?: string;
+}): DomDescriptorStore;
+declare function hashDomDescriptorDescription(description: string): string;
+declare function buildDomDescriptorKey(options: {
+    readonly namespace?: string;
+    readonly method: string;
+    readonly description: string;
+}): string;
+declare function buildDomDescriptorPayload(input: DomWriteDescriptorInput): DomDescriptorPayload;
+declare function buildDomDescriptorVersion(payload: DomDescriptorPayload): string;
+declare function parseDomDescriptorRecord(record: DescriptorRecord): DomDescriptorRecord | undefined;
+
+declare function sanitizeReplayElementPath(path: ReplayElementPath): ReplayElementPath;
+
 interface OpensteerRouteRequest {
     readonly url: string;
     readonly method: string;
@@ -473,6 +528,61 @@ interface OpensteerInterceptScriptOptions {
     }) => string | Promise<string>;
 }
 
+interface PersistedOpensteerExtractionValueNode {
+    readonly $path: ElementPath;
+    readonly attribute?: string;
+}
+interface PersistedOpensteerExtractionSourceNode {
+    readonly $source: "current_url";
+}
+interface PersistedOpensteerExtractionArrayVariantNode {
+    readonly itemParentPath: ElementPath;
+    readonly item: PersistedOpensteerExtractionNode;
+}
+interface PersistedOpensteerExtractionArrayNode {
+    readonly $array: {
+        readonly variants: readonly PersistedOpensteerExtractionArrayVariantNode[];
+    };
+}
+interface PersistedOpensteerExtractionObjectNode {
+    readonly [key: string]: PersistedOpensteerExtractionNode;
+}
+type PersistedOpensteerExtractionNode = PersistedOpensteerExtractionValueNode | PersistedOpensteerExtractionSourceNode | PersistedOpensteerExtractionArrayNode | PersistedOpensteerExtractionObjectNode;
+type PersistedOpensteerExtractionPayload = PersistedOpensteerExtractionObjectNode;
+interface OpensteerExtractionDescriptorPayload {
+    readonly kind: "dom-extraction";
+    readonly description: string;
+    readonly root: PersistedOpensteerExtractionPayload;
+    readonly schemaHash?: string;
+    readonly sourceUrl?: string;
+}
+interface OpensteerExtractionDescriptorRecord {
+    readonly id: string;
+    readonly key: string;
+    readonly version: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly payload: OpensteerExtractionDescriptorPayload;
+}
+interface OpensteerExtractionDescriptorStore {
+    read(input: {
+        readonly description: string;
+    }): Promise<OpensteerExtractionDescriptorRecord | undefined>;
+    write(input: {
+        readonly description: string;
+        readonly root: PersistedOpensteerExtractionPayload;
+        readonly schemaHash?: string;
+        readonly sourceUrl?: string;
+        readonly createdAt?: number;
+        readonly updatedAt?: number;
+    }): Promise<OpensteerExtractionDescriptorRecord>;
+}
+declare function createOpensteerExtractionDescriptorStore(options: {
+    readonly root?: FilesystemOpensteerWorkspace;
+    readonly namespace?: string;
+}): OpensteerExtractionDescriptorStore;
+declare function parseExtractionDescriptorRecord(record: DescriptorRecord): OpensteerExtractionDescriptorRecord | undefined;
+
 interface OpensteerEngineFactoryOptions {
     readonly browser?: OpensteerBrowserOptions;
     readonly launch?: OpensteerBrowserLaunchOptions;
@@ -488,6 +598,15 @@ interface OpensteerSessionRuntimeOptions {
     readonly engine?: BrowserCoreEngine;
     readonly engineFactory?: OpensteerEngineFactory;
     readonly policy?: OpensteerPolicy;
+    readonly descriptorStore?: DomDescriptorStore;
+    readonly extractionDescriptorStore?: OpensteerExtractionDescriptorStore;
+    readonly registryOverrides?: {
+        readonly requestPlans?: RequestPlanRegistryStore;
+        readonly authRecipes?: AuthRecipeRegistryStore;
+        readonly recipes?: RecipeRegistryStore;
+        readonly reverseCases?: ReverseCaseRegistryStore;
+        readonly reversePackages?: ReversePackageRegistryStore;
+    };
     readonly cleanupRootOnClose?: boolean;
     readonly sessionInfo?: Partial<Omit<OpensteerSessionInfo, "sessionId" | "activePageRef">>;
 }
@@ -501,19 +620,20 @@ declare class OpensteerSessionRuntime {
     private readonly injectedEngine;
     private readonly engineFactory;
     private readonly policy;
+    private readonly injectedDescriptorStore;
+    private readonly injectedExtractionDescriptorStore;
+    private readonly registryOverrides;
     private readonly cleanupRootOnClose;
     private readonly sessionInfoBase;
     private root;
     private engine;
     private dom;
     private computer;
-    private readonly networkJournal;
+    private readonly networkHistory;
     private extractionDescriptors;
     private sessionRef;
     private pageRef;
     private runId;
-    private latestSnapshot;
-    private readonly backgroundNetworkPersistence;
     private readonly cookieJars;
     private readonly recipeCache;
     private ownsEngine;
@@ -534,7 +654,7 @@ declare class OpensteerSessionRuntime {
     scroll(input: OpensteerDomScrollInput, options?: RuntimeOperationOptions): Promise<OpensteerActionResult>;
     extract(input: OpensteerDomExtractInput, options?: RuntimeOperationOptions): Promise<OpensteerDomExtractOutput>;
     queryNetwork(input?: OpensteerNetworkQueryInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkQueryOutput>;
-    saveNetwork(input: OpensteerNetworkSaveInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkSaveOutput>;
+    tagNetwork(input: OpensteerNetworkTagInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkTagOutput>;
     clearNetwork(input?: OpensteerNetworkClearInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkClearOutput>;
     captureScripts(input?: OpensteerCaptureScriptsInput, options?: RuntimeOperationOptions): Promise<OpensteerCaptureScriptsOutput>;
     minimizeNetwork(input: OpensteerNetworkMinimizeInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkMinimizeOutput>;
@@ -609,8 +729,10 @@ declare class OpensteerSessionRuntime {
     private queryLiveNetwork;
     private captureScriptsInternal;
     private materializeCapturedScript;
+    private runMutationCapturedOperation;
     private beginMutationCapture;
-    private completeMutationCapture;
+    private finalizeMutationCaptureBestEffort;
+    private completeMutationCaptureWithSignal;
     private resolveNetworkRecordByRecordId;
     private resolveCurrentStateSource;
     private resolveReverseCaseById;
@@ -626,7 +748,13 @@ declare class OpensteerSessionRuntime {
     private waitForMatchingReplayRecord;
     private isObservedReplayRecordSettled;
     private replayInteractionTraceById;
+    private readBrowserNetworkRecords;
     private readLiveNetworkRecords;
+    private persistLiveRequestIds;
+    private persistLiveRequestIdsWithSignal;
+    private syncPersistedNetworkSelection;
+    private toSavedNetworkQueryInput;
+    private toQueryInputFromTagInput;
     private readLiveRequestIds;
     private observeLiveTransportDelta;
     private executeTransportRequestWithJournal;
@@ -666,8 +794,7 @@ declare class OpensteerSessionRuntime {
     private updateCookieJarFromResponse;
     private readCookieValue;
     private readStorageValue;
-    private scheduleBackgroundNetworkSaveByRequestIds;
-    private flushBackgroundNetworkPersistence;
+    private flushPersistedNetworkHistory;
     private toDomTargetRef;
     private ensureRoot;
     private ensureEngine;
@@ -710,7 +837,7 @@ interface OpensteerSemanticRuntime {
     scroll(input: OpensteerDomScrollInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerActionResult>;
     extract(input: OpensteerDomExtractInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerDomExtractOutput>;
     queryNetwork(input?: OpensteerNetworkQueryInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkQueryOutput>;
-    saveNetwork(input: OpensteerNetworkSaveInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkSaveOutput>;
+    tagNetwork(input: OpensteerNetworkTagInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkTagOutput>;
     minimizeNetwork(input: OpensteerNetworkMinimizeInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkMinimizeOutput>;
     diffNetwork(input: OpensteerNetworkDiffInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkDiffOutput>;
     probeNetwork(input: OpensteerTransportProbeInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerTransportProbeOutput>;
@@ -763,4 +890,4 @@ declare function dispatchSemanticOperation(runtime: OpensteerSemanticRuntime, op
     readonly signal?: AbortSignal;
 }): Promise<unknown>;
 
-export { type CreateFilesystemOpensteerWorkspaceOptions, type FilesystemOpensteerWorkspace, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, type OpensteerEngineFactory, type OpensteerEngineFactoryOptions, type OpensteerRuntimeOperationOptions, type OpensteerRuntimeWorkspace, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerWorkspaceManifest, createFilesystemOpensteerWorkspace, dispatchSemanticOperation, normalizeWorkspaceId, resolveFilesystemWorkspacePath };
+export { type AuthRecipeRecord, type AuthRecipeRegistryStore, type CreateFilesystemOpensteerWorkspaceOptions, type DescriptorRecord, type DescriptorRegistryStore, type DomDescriptorPayload, type DomDescriptorRecord, type DomDescriptorStore, type DomReadDescriptorInput, type DomWriteDescriptorInput, type FilesystemOpensteerWorkspace, type InteractionTraceRecord, type InteractionTraceRegistryStore, type ListRegistryRecordsInput, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, type OpensteerEngineFactory, type OpensteerEngineFactoryOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerRuntimeOperationOptions, type OpensteerRuntimeWorkspace, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerWorkspaceManifest, type RecipeRecord, type RecipeRegistryStore, type RegistryProvenance, type RequestPlanFreshness, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ReverseCaseRecord, type ReverseCaseRegistryStore, type ReversePackageRecord, type ReversePackageRegistryStore, type ReverseReportRecord, type ReverseReportRegistryStore, type UpdateRequestPlanFreshnessInput, type UpdateReverseCaseInput, type WriteAuthRecipeInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRecipeInput, type WriteRequestPlanInput, type WriteReverseCaseInput, type WriteReversePackageInput, type WriteReverseReportInput, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, createDomDescriptorStore, createFilesystemOpensteerWorkspace, createOpensteerExtractionDescriptorStore, dispatchSemanticOperation, hashDomDescriptorDescription, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveFilesystemWorkspacePath, sanitizeReplayElementPath };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { BrowserCoreEngine, PageRef, NetworkRecord, HeaderEntry, BodyPayload, SessionRef } from '@opensteer/browser-core';
-import { OpensteerSemanticOperationName, OpensteerArtifactKind, ArtifactProvenance, TraceContext, HtmlSnapshot, DomSnapshot, CookieRecord, StorageSnapshot, ScriptSourceArtifactData, ArtifactRelation, ArtifactReference, OpensteerArtifact, OpensteerRequestPlanPayload, OpensteerRequestPlanLifecycle, OpensteerRequestPlanFreshness, OpensteerAuthRecipePayload, OpensteerRecipePayload, OpensteerReverseCasePayload, OpensteerInteractionTracePayload, OpensteerReversePackagePayload, OpensteerReverseReportPayload, NetworkQueryRecord, NetworkResourceType, TraceOutcome, OpensteerEvent, OpensteerError, TraceRecord, TraceBundle, OpensteerBrowserOptions, OpensteerBrowserLaunchOptions, OpensteerBrowserContextOptions, OpensteerSessionInfo, OpensteerOpenInput, OpensteerOpenOutput, OpensteerPageListInput, OpensteerPageListOutput, OpensteerPageNewInput, OpensteerPageNewOutput, OpensteerPageActivateInput, OpensteerPageActivateOutput, OpensteerPageCloseInput, OpensteerPageCloseOutput, OpensteerPageGotoInput, OpensteerPageGotoOutput, OpensteerPageEvaluateInput, OpensteerPageEvaluateOutput, OpensteerAddInitScriptInput, OpensteerAddInitScriptOutput, OpensteerPageSnapshotInput, OpensteerPageSnapshotOutput, OpensteerDomClickInput, OpensteerActionResult, OpensteerDomHoverInput, OpensteerDomInputInput, OpensteerDomScrollInput, OpensteerDomExtractInput, OpensteerDomExtractOutput, OpensteerNetworkQueryInput, OpensteerNetworkQueryOutput, OpensteerNetworkSaveInput, OpensteerNetworkSaveOutput, OpensteerNetworkClearInput, OpensteerNetworkClearOutput, OpensteerCaptureScriptsInput, OpensteerCaptureScriptsOutput, OpensteerNetworkMinimizeInput, OpensteerNetworkMinimizeOutput, OpensteerNetworkDiffInput, OpensteerNetworkDiffOutput, OpensteerArtifactReadInput, OpensteerArtifactReadOutput, OpensteerTransportProbeInput, OpensteerTransportProbeOutput, OpensteerReverseDiscoverInput, OpensteerReverseDiscoverOutput, OpensteerReverseQueryInput, OpensteerReverseQueryOutput, OpensteerReversePackageCreateInput, OpensteerReversePackageCreateOutput, OpensteerReversePackageRunInput, OpensteerReversePackageRunOutput, OpensteerReverseExportInput, OpensteerReverseExportOutput, OpensteerReverseReportInput, OpensteerReverseReportOutput, OpensteerReversePackageGetInput, OpensteerReversePackageGetOutput, OpensteerReversePackageListInput, OpensteerReversePackageListOutput, OpensteerReversePackagePatchInput, OpensteerReversePackagePatchOutput, OpensteerInteractionCaptureInput, OpensteerInteractionCaptureOutput, OpensteerInteractionGetInput, OpensteerInteractionGetOutput, OpensteerInteractionDiffInput, OpensteerInteractionDiffOutput, OpensteerInteractionReplayInput, OpensteerInteractionReplayOutput, OpensteerScriptBeautifyInput, OpensteerScriptBeautifyOutput, OpensteerScriptDeobfuscateInput, OpensteerScriptDeobfuscateOutput, OpensteerScriptSandboxInput, OpensteerScriptSandboxOutput, OpensteerCaptchaSolveInput, OpensteerCaptchaSolveOutput, OpensteerInferRequestPlanInput, OpensteerWriteRequestPlanInput, OpensteerGetRequestPlanInput, OpensteerListRequestPlansInput, OpensteerListRequestPlansOutput, OpensteerWriteAuthRecipeInput, OpensteerWriteRecipeInput, OpensteerGetAuthRecipeInput, OpensteerGetRecipeInput, OpensteerListAuthRecipesInput, OpensteerListAuthRecipesOutput, OpensteerListRecipesInput, OpensteerListRecipesOutput, OpensteerRunAuthRecipeInput, OpensteerRunAuthRecipeOutput, OpensteerRunRecipeInput, OpensteerRunRecipeOutput, OpensteerRawRequestInput, OpensteerRawRequestOutput, OpensteerRequestExecuteInput, OpensteerRequestExecuteOutput, OpensteerComputerExecuteInput, OpensteerComputerExecuteOutput, OpensteerSessionCloseOutput } from '@opensteer/protocol';
+import { OpensteerSemanticOperationName, OpensteerArtifactKind, ArtifactProvenance, TraceContext, HtmlSnapshot, DomSnapshot, CookieRecord, StorageSnapshot, ScriptSourceArtifactData, ArtifactRelation, ArtifactReference, OpensteerArtifact, OpensteerAuthRecipePayload, OpensteerRequestPlanPayload, OpensteerRequestPlanFreshness, OpensteerRecipePayload, OpensteerReverseCasePayload, OpensteerInteractionTracePayload, OpensteerReversePackagePayload, OpensteerReverseReportPayload, NetworkQueryRecord, NetworkResourceType, TraceOutcome, OpensteerEvent, OpensteerError, TraceRecord, TraceBundle, ReplayElementPath, OpensteerBrowserOptions, OpensteerBrowserLaunchOptions, OpensteerBrowserContextOptions, OpensteerSessionInfo, OpensteerOpenInput, OpensteerOpenOutput, OpensteerPageListInput, OpensteerPageListOutput, OpensteerPageNewInput, OpensteerPageNewOutput, OpensteerPageActivateInput, OpensteerPageActivateOutput, OpensteerPageCloseInput, OpensteerPageCloseOutput, OpensteerPageGotoInput, OpensteerPageGotoOutput, OpensteerPageEvaluateInput, OpensteerPageEvaluateOutput, OpensteerAddInitScriptInput, OpensteerAddInitScriptOutput, OpensteerPageSnapshotInput, OpensteerPageSnapshotOutput, OpensteerDomClickInput, OpensteerActionResult, OpensteerDomHoverInput, OpensteerDomInputInput, OpensteerDomScrollInput, OpensteerDomExtractInput, OpensteerDomExtractOutput, OpensteerNetworkQueryInput, OpensteerNetworkQueryOutput, OpensteerNetworkTagInput, OpensteerNetworkTagOutput, OpensteerNetworkClearInput, OpensteerNetworkClearOutput, OpensteerCaptureScriptsInput, OpensteerCaptureScriptsOutput, OpensteerNetworkMinimizeInput, OpensteerNetworkMinimizeOutput, OpensteerNetworkDiffInput, OpensteerNetworkDiffOutput, OpensteerArtifactReadInput, OpensteerArtifactReadOutput, OpensteerTransportProbeInput, OpensteerTransportProbeOutput, OpensteerReverseDiscoverInput, OpensteerReverseDiscoverOutput, OpensteerReverseQueryInput, OpensteerReverseQueryOutput, OpensteerReversePackageCreateInput, OpensteerReversePackageCreateOutput, OpensteerReversePackageRunInput, OpensteerReversePackageRunOutput, OpensteerReverseExportInput, OpensteerReverseExportOutput, OpensteerReverseReportInput, OpensteerReverseReportOutput, OpensteerReversePackageGetInput, OpensteerReversePackageGetOutput, OpensteerReversePackageListInput, OpensteerReversePackageListOutput, OpensteerReversePackagePatchInput, OpensteerReversePackagePatchOutput, OpensteerInteractionCaptureInput, OpensteerInteractionCaptureOutput, OpensteerInteractionGetInput, OpensteerInteractionGetOutput, OpensteerInteractionDiffInput, OpensteerInteractionDiffOutput, OpensteerInteractionReplayInput, OpensteerInteractionReplayOutput, OpensteerScriptBeautifyInput, OpensteerScriptBeautifyOutput, OpensteerScriptDeobfuscateInput, OpensteerScriptDeobfuscateOutput, OpensteerScriptSandboxInput, OpensteerScriptSandboxOutput, OpensteerCaptchaSolveInput, OpensteerCaptchaSolveOutput, OpensteerInferRequestPlanInput, OpensteerWriteRequestPlanInput, OpensteerGetRequestPlanInput, OpensteerListRequestPlansInput, OpensteerListRequestPlansOutput, OpensteerWriteAuthRecipeInput, OpensteerWriteRecipeInput, OpensteerGetAuthRecipeInput, OpensteerGetRecipeInput, OpensteerListAuthRecipesInput, OpensteerListAuthRecipesOutput, OpensteerListRecipesInput, OpensteerListRecipesOutput, OpensteerRunAuthRecipeInput, OpensteerRunAuthRecipeOutput, OpensteerRunRecipeInput, OpensteerRunRecipeOutput, OpensteerRawRequestInput, OpensteerRawRequestOutput, OpensteerRequestExecuteInput, OpensteerRequestExecuteOutput, OpensteerComputerExecuteInput, OpensteerComputerExecuteOutput, OpensteerSessionCloseOutput } from '@opensteer/protocol';
+export { ReplayElementPath } from '@opensteer/protocol';
 
 declare const OPENSTEER_RUNTIME_CORE_VERSION: string;
 
@@ -163,10 +164,8 @@ type InteractionTraceRecord = RegistryRecord<OpensteerInteractionTracePayload>;
 type ReverseCaseRecord = RegistryRecord<OpensteerReverseCasePayload>;
 type ReversePackageRecord = RegistryRecord<OpensteerReversePackagePayload>;
 type ReverseReportRecord = RegistryRecord<OpensteerReverseReportPayload>;
-type RequestPlanLifecycle = OpensteerRequestPlanLifecycle;
 type RequestPlanFreshness = OpensteerRequestPlanFreshness;
 interface RequestPlanRecord extends RegistryRecord<OpensteerRequestPlanPayload> {
-    readonly lifecycle: RequestPlanLifecycle;
     readonly freshness?: RequestPlanFreshness;
 }
 interface ResolveRegistryRecordInput {
@@ -184,7 +183,6 @@ interface WriteDescriptorInput<TPayload = JsonValue> {
     readonly payload: TPayload;
 }
 interface WriteRequestPlanInput extends WriteDescriptorInput<OpensteerRequestPlanPayload> {
-    readonly lifecycle?: RequestPlanLifecycle;
     readonly freshness?: RequestPlanFreshness;
 }
 interface WriteAuthRecipeInput extends WriteDescriptorInput<OpensteerAuthRecipePayload> {
@@ -202,10 +200,9 @@ interface WriteReverseReportInput extends WriteDescriptorInput<OpensteerReverseR
 interface ListRegistryRecordsInput {
     readonly key?: string;
 }
-interface UpdateRequestPlanMetadataInput {
+interface UpdateRequestPlanFreshnessInput {
     readonly id: string;
     readonly updatedAt?: number;
-    readonly lifecycle?: RequestPlanLifecycle;
     readonly freshness?: RequestPlanFreshness;
 }
 interface UpdateReverseCaseInput {
@@ -220,6 +217,7 @@ interface DescriptorRegistryStore {
     readonly indexesDirectory: string;
     write(input: WriteDescriptorInput): Promise<DescriptorRecord>;
     getById(id: string): Promise<DescriptorRecord | undefined>;
+    list(input?: ListRegistryRecordsInput): Promise<readonly DescriptorRecord[]>;
     resolve(input: ResolveRegistryRecordInput): Promise<DescriptorRecord | undefined>;
 }
 interface RequestPlanRegistryStore {
@@ -229,7 +227,7 @@ interface RequestPlanRegistryStore {
     getById(id: string): Promise<RequestPlanRecord | undefined>;
     list(input?: ListRegistryRecordsInput): Promise<readonly RequestPlanRecord[]>;
     resolve(input: ResolveRegistryRecordInput): Promise<RequestPlanRecord | undefined>;
-    updateMetadata(input: UpdateRequestPlanMetadataInput): Promise<RequestPlanRecord>;
+    updateFreshness(input: UpdateRequestPlanFreshnessInput): Promise<RequestPlanRecord>;
 }
 interface AuthRecipeRegistryStore {
     readonly recordsDirectory: string;
@@ -280,9 +278,10 @@ interface ReverseReportRegistryStore {
 }
 
 interface SavedNetworkQueryInput {
+    readonly pageRef?: NetworkQueryRecord["record"]["pageRef"];
     readonly recordId?: string;
     readonly requestId?: string;
-    readonly actionId?: string;
+    readonly capture?: string;
     readonly tag?: string;
     readonly url?: string;
     readonly hostname?: string;
@@ -293,15 +292,22 @@ interface SavedNetworkQueryInput {
     readonly includeBodies?: boolean;
     readonly limit?: number;
 }
+type SavedNetworkBodyWriteMode = "authoritative" | "metadata-only";
+interface SavedNetworkSaveOptions {
+    readonly bodyWriteMode: SavedNetworkBodyWriteMode;
+    readonly tag?: string;
+}
 interface SavedNetworkStore {
     readonly databasePath: string;
     initialize(): Promise<void>;
-    save(records: readonly NetworkQueryRecord[], tag?: string): Promise<number>;
+    save(records: readonly NetworkQueryRecord[], options: SavedNetworkSaveOptions): Promise<number>;
+    tagByFilter(filter: SavedNetworkQueryInput, tag: string): Promise<number>;
     query(input?: SavedNetworkQueryInput): Promise<readonly NetworkQueryRecord[]>;
     getByRecordId(recordId: string, options?: {
         readonly includeBodies?: boolean;
     }): Promise<NetworkQueryRecord | undefined>;
     clear(input?: {
+        readonly capture?: string;
         readonly tag?: string;
     }): Promise<number>;
 }
@@ -389,8 +395,8 @@ interface FilesystemOpensteerWorkspace {
     readonly browserManifestPath: string;
     readonly browserUserDataDir: string;
     readonly livePath: string;
-    readonly liveSessionPath: string;
-    readonly liveBrowserPath: string;
+    readonly liveLocalPath: string;
+    readonly liveCloudPath: string;
     readonly artifactsPath: string;
     readonly tracesPath: string;
     readonly registryPath: string;
@@ -417,6 +423,55 @@ declare function resolveFilesystemWorkspacePath(input: {
 }): string;
 declare function createFilesystemOpensteerWorkspace(options: CreateFilesystemOpensteerWorkspaceOptions): Promise<FilesystemOpensteerWorkspace>;
 
+type ElementPath = ReplayElementPath;
+interface DomDescriptorPayload {
+    readonly kind: "dom-target";
+    readonly method: string;
+    readonly description: string;
+    readonly path: ReplayElementPath;
+    readonly sourceUrl?: string;
+}
+interface DomDescriptorRecord {
+    readonly id: string;
+    readonly key: string;
+    readonly version: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly payload: DomDescriptorPayload;
+}
+interface DomWriteDescriptorInput {
+    readonly method: string;
+    readonly description: string;
+    readonly path: ReplayElementPath;
+    readonly sourceUrl?: string;
+    readonly createdAt?: number;
+    readonly updatedAt?: number;
+}
+interface DomReadDescriptorInput {
+    readonly method: string;
+    readonly description: string;
+}
+
+interface DomDescriptorStore {
+    read(input: DomReadDescriptorInput): Promise<DomDescriptorRecord | undefined>;
+    write(input: DomWriteDescriptorInput): Promise<DomDescriptorRecord>;
+}
+declare function createDomDescriptorStore(options: {
+    readonly root?: FilesystemOpensteerWorkspace;
+    readonly namespace?: string;
+}): DomDescriptorStore;
+declare function hashDomDescriptorDescription(description: string): string;
+declare function buildDomDescriptorKey(options: {
+    readonly namespace?: string;
+    readonly method: string;
+    readonly description: string;
+}): string;
+declare function buildDomDescriptorPayload(input: DomWriteDescriptorInput): DomDescriptorPayload;
+declare function buildDomDescriptorVersion(payload: DomDescriptorPayload): string;
+declare function parseDomDescriptorRecord(record: DescriptorRecord): DomDescriptorRecord | undefined;
+
+declare function sanitizeReplayElementPath(path: ReplayElementPath): ReplayElementPath;
+
 interface OpensteerRouteRequest {
     readonly url: string;
     readonly method: string;
@@ -473,6 +528,61 @@ interface OpensteerInterceptScriptOptions {
     }) => string | Promise<string>;
 }
 
+interface PersistedOpensteerExtractionValueNode {
+    readonly $path: ElementPath;
+    readonly attribute?: string;
+}
+interface PersistedOpensteerExtractionSourceNode {
+    readonly $source: "current_url";
+}
+interface PersistedOpensteerExtractionArrayVariantNode {
+    readonly itemParentPath: ElementPath;
+    readonly item: PersistedOpensteerExtractionNode;
+}
+interface PersistedOpensteerExtractionArrayNode {
+    readonly $array: {
+        readonly variants: readonly PersistedOpensteerExtractionArrayVariantNode[];
+    };
+}
+interface PersistedOpensteerExtractionObjectNode {
+    readonly [key: string]: PersistedOpensteerExtractionNode;
+}
+type PersistedOpensteerExtractionNode = PersistedOpensteerExtractionValueNode | PersistedOpensteerExtractionSourceNode | PersistedOpensteerExtractionArrayNode | PersistedOpensteerExtractionObjectNode;
+type PersistedOpensteerExtractionPayload = PersistedOpensteerExtractionObjectNode;
+interface OpensteerExtractionDescriptorPayload {
+    readonly kind: "dom-extraction";
+    readonly description: string;
+    readonly root: PersistedOpensteerExtractionPayload;
+    readonly schemaHash?: string;
+    readonly sourceUrl?: string;
+}
+interface OpensteerExtractionDescriptorRecord {
+    readonly id: string;
+    readonly key: string;
+    readonly version: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly payload: OpensteerExtractionDescriptorPayload;
+}
+interface OpensteerExtractionDescriptorStore {
+    read(input: {
+        readonly description: string;
+    }): Promise<OpensteerExtractionDescriptorRecord | undefined>;
+    write(input: {
+        readonly description: string;
+        readonly root: PersistedOpensteerExtractionPayload;
+        readonly schemaHash?: string;
+        readonly sourceUrl?: string;
+        readonly createdAt?: number;
+        readonly updatedAt?: number;
+    }): Promise<OpensteerExtractionDescriptorRecord>;
+}
+declare function createOpensteerExtractionDescriptorStore(options: {
+    readonly root?: FilesystemOpensteerWorkspace;
+    readonly namespace?: string;
+}): OpensteerExtractionDescriptorStore;
+declare function parseExtractionDescriptorRecord(record: DescriptorRecord): OpensteerExtractionDescriptorRecord | undefined;
+
 interface OpensteerEngineFactoryOptions {
     readonly browser?: OpensteerBrowserOptions;
     readonly launch?: OpensteerBrowserLaunchOptions;
@@ -488,6 +598,15 @@ interface OpensteerSessionRuntimeOptions {
     readonly engine?: BrowserCoreEngine;
     readonly engineFactory?: OpensteerEngineFactory;
     readonly policy?: OpensteerPolicy;
+    readonly descriptorStore?: DomDescriptorStore;
+    readonly extractionDescriptorStore?: OpensteerExtractionDescriptorStore;
+    readonly registryOverrides?: {
+        readonly requestPlans?: RequestPlanRegistryStore;
+        readonly authRecipes?: AuthRecipeRegistryStore;
+        readonly recipes?: RecipeRegistryStore;
+        readonly reverseCases?: ReverseCaseRegistryStore;
+        readonly reversePackages?: ReversePackageRegistryStore;
+    };
     readonly cleanupRootOnClose?: boolean;
     readonly sessionInfo?: Partial<Omit<OpensteerSessionInfo, "sessionId" | "activePageRef">>;
 }
@@ -501,19 +620,20 @@ declare class OpensteerSessionRuntime {
     private readonly injectedEngine;
     private readonly engineFactory;
     private readonly policy;
+    private readonly injectedDescriptorStore;
+    private readonly injectedExtractionDescriptorStore;
+    private readonly registryOverrides;
     private readonly cleanupRootOnClose;
     private readonly sessionInfoBase;
     private root;
     private engine;
     private dom;
     private computer;
-    private readonly networkJournal;
+    private readonly networkHistory;
     private extractionDescriptors;
     private sessionRef;
     private pageRef;
     private runId;
-    private latestSnapshot;
-    private readonly backgroundNetworkPersistence;
     private readonly cookieJars;
     private readonly recipeCache;
     private ownsEngine;
@@ -534,7 +654,7 @@ declare class OpensteerSessionRuntime {
     scroll(input: OpensteerDomScrollInput, options?: RuntimeOperationOptions): Promise<OpensteerActionResult>;
     extract(input: OpensteerDomExtractInput, options?: RuntimeOperationOptions): Promise<OpensteerDomExtractOutput>;
     queryNetwork(input?: OpensteerNetworkQueryInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkQueryOutput>;
-    saveNetwork(input: OpensteerNetworkSaveInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkSaveOutput>;
+    tagNetwork(input: OpensteerNetworkTagInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkTagOutput>;
     clearNetwork(input?: OpensteerNetworkClearInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkClearOutput>;
     captureScripts(input?: OpensteerCaptureScriptsInput, options?: RuntimeOperationOptions): Promise<OpensteerCaptureScriptsOutput>;
     minimizeNetwork(input: OpensteerNetworkMinimizeInput, options?: RuntimeOperationOptions): Promise<OpensteerNetworkMinimizeOutput>;
@@ -609,8 +729,10 @@ declare class OpensteerSessionRuntime {
     private queryLiveNetwork;
     private captureScriptsInternal;
     private materializeCapturedScript;
+    private runMutationCapturedOperation;
     private beginMutationCapture;
-    private completeMutationCapture;
+    private finalizeMutationCaptureBestEffort;
+    private completeMutationCaptureWithSignal;
     private resolveNetworkRecordByRecordId;
     private resolveCurrentStateSource;
     private resolveReverseCaseById;
@@ -626,7 +748,13 @@ declare class OpensteerSessionRuntime {
     private waitForMatchingReplayRecord;
     private isObservedReplayRecordSettled;
     private replayInteractionTraceById;
+    private readBrowserNetworkRecords;
     private readLiveNetworkRecords;
+    private persistLiveRequestIds;
+    private persistLiveRequestIdsWithSignal;
+    private syncPersistedNetworkSelection;
+    private toSavedNetworkQueryInput;
+    private toQueryInputFromTagInput;
     private readLiveRequestIds;
     private observeLiveTransportDelta;
     private executeTransportRequestWithJournal;
@@ -666,8 +794,7 @@ declare class OpensteerSessionRuntime {
     private updateCookieJarFromResponse;
     private readCookieValue;
     private readStorageValue;
-    private scheduleBackgroundNetworkSaveByRequestIds;
-    private flushBackgroundNetworkPersistence;
+    private flushPersistedNetworkHistory;
     private toDomTargetRef;
     private ensureRoot;
     private ensureEngine;
@@ -710,7 +837,7 @@ interface OpensteerSemanticRuntime {
     scroll(input: OpensteerDomScrollInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerActionResult>;
     extract(input: OpensteerDomExtractInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerDomExtractOutput>;
     queryNetwork(input?: OpensteerNetworkQueryInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkQueryOutput>;
-    saveNetwork(input: OpensteerNetworkSaveInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkSaveOutput>;
+    tagNetwork(input: OpensteerNetworkTagInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkTagOutput>;
     minimizeNetwork(input: OpensteerNetworkMinimizeInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkMinimizeOutput>;
     diffNetwork(input: OpensteerNetworkDiffInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkDiffOutput>;
     probeNetwork(input: OpensteerTransportProbeInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerTransportProbeOutput>;
@@ -763,4 +890,4 @@ declare function dispatchSemanticOperation(runtime: OpensteerSemanticRuntime, op
     readonly signal?: AbortSignal;
 }): Promise<unknown>;
 
-export { type CreateFilesystemOpensteerWorkspaceOptions, type FilesystemOpensteerWorkspace, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, type OpensteerEngineFactory, type OpensteerEngineFactoryOptions, type OpensteerRuntimeOperationOptions, type OpensteerRuntimeWorkspace, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerWorkspaceManifest, createFilesystemOpensteerWorkspace, dispatchSemanticOperation, normalizeWorkspaceId, resolveFilesystemWorkspacePath };
+export { type AuthRecipeRecord, type AuthRecipeRegistryStore, type CreateFilesystemOpensteerWorkspaceOptions, type DescriptorRecord, type DescriptorRegistryStore, type DomDescriptorPayload, type DomDescriptorRecord, type DomDescriptorStore, type DomReadDescriptorInput, type DomWriteDescriptorInput, type FilesystemOpensteerWorkspace, type InteractionTraceRecord, type InteractionTraceRegistryStore, type ListRegistryRecordsInput, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OPENSTEER_RUNTIME_CORE_VERSION, type OpensteerEngineFactory, type OpensteerEngineFactoryOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerRuntimeOperationOptions, type OpensteerRuntimeWorkspace, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerWorkspaceManifest, type RecipeRecord, type RecipeRegistryStore, type RegistryProvenance, type RequestPlanFreshness, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ReverseCaseRecord, type ReverseCaseRegistryStore, type ReversePackageRecord, type ReversePackageRegistryStore, type ReverseReportRecord, type ReverseReportRegistryStore, type UpdateRequestPlanFreshnessInput, type UpdateReverseCaseInput, type WriteAuthRecipeInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRecipeInput, type WriteRequestPlanInput, type WriteReverseCaseInput, type WriteReversePackageInput, type WriteReverseReportInput, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, createDomDescriptorStore, createFilesystemOpensteerWorkspace, createOpensteerExtractionDescriptorStore, dispatchSemanticOperation, hashDomDescriptorDescription, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveFilesystemWorkspacePath, sanitizeReplayElementPath };