npm - @opensteer/runtime-core - Versions diffs - 0.1.0 → 0.1.1 - Mend

@opensteer/runtime-core 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -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, 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';
+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;
@@ -389,8 +387,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 +415,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 +520,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 +590,13 @@ 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 cleanupRootOnClose?: boolean;
     readonly sessionInfo?: Partial<Omit<OpensteerSessionInfo, "sessionId" | "activePageRef">>;
 }
@@ -501,6 +610,9 @@ 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;
@@ -512,7 +624,6 @@ declare class OpensteerSessionRuntime {
     private sessionRef;
     private pageRef;
     private runId;
-    private latestSnapshot;
     private readonly backgroundNetworkPersistence;
     private readonly cookieJars;
     private readonly recipeCache;
@@ -763,4 +874,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 UpdateRequestPlanFreshnessInput, type WriteAuthRecipeInput, type WriteRecipeInput, type WriteRequestPlanInput, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, createDomDescriptorStore, createFilesystemOpensteerWorkspace, createOpensteerExtractionDescriptorStore, dispatchSemanticOperation, hashDomDescriptorDescription, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveFilesystemWorkspacePath, sanitizeReplayElementPath };

package/dist/index.d.ts CHANGED Viewed

@@ -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, 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';
+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;
@@ -389,8 +387,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 +415,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 +520,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 +590,13 @@ 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 cleanupRootOnClose?: boolean;
     readonly sessionInfo?: Partial<Omit<OpensteerSessionInfo, "sessionId" | "activePageRef">>;
 }
@@ -501,6 +610,9 @@ 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;
@@ -512,7 +624,6 @@ declare class OpensteerSessionRuntime {
     private sessionRef;
     private pageRef;
     private runId;
-    private latestSnapshot;
     private readonly backgroundNetworkPersistence;
     private readonly cookieJars;
     private readonly recipeCache;
@@ -763,4 +874,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 UpdateRequestPlanFreshnessInput, type WriteAuthRecipeInput, type WriteRecipeInput, type WriteRequestPlanInput, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, createDomDescriptorStore, createFilesystemOpensteerWorkspace, createOpensteerExtractionDescriptorStore, dispatchSemanticOperation, hashDomDescriptorDescription, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveFilesystemWorkspacePath, sanitizeReplayElementPath };