opensteer 0.8.9 → 0.8.11

package/dist/index.d.cts

@@ -397,6 +397,27 @@ interface BrowserCapabilities {
     };
 }
 
+interface PostLoadTrackerSnapshot {
+    readonly lastTrackedNetworkActivityAt: number;
+    readonly trackedPendingFetches: number;
+    readonly trackedPendingXhrs: number;
+}
+
+interface ActionBoundarySnapshot {
+    readonly pageRef: PageRef;
+    readonly documentRef: DocumentRef;
+    readonly url?: string;
+    readonly tracker?: PostLoadTrackerSnapshot;
+}
+type ActionBoundarySettleTrigger = "dom-action" | "navigation";
+type ActionBoundaryTimedOutPhase = "bootstrap";
+interface ActionBoundaryOutcome {
+    readonly trigger: ActionBoundarySettleTrigger;
+    readonly crossDocument: boolean;
+    readonly bootstrapSettled: boolean;
+    readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
+}
+
 type ConsoleLevel = "debug" | "log" | "info" | "warn" | "error" | "trace";
 interface StepEventBase {
     readonly eventId: string;
@@ -717,12 +738,22 @@ interface BrowserInspector {
         readonly frameRef?: FrameRef;
         readonly documentRef?: DocumentRef;
     }): Promise<DomSnapshot>;
+    getActionBoundarySnapshot(input: {
+        readonly pageRef: PageRef;
+    }): Promise<ActionBoundarySnapshot>;
     waitForVisualStability(input: {
         readonly pageRef: PageRef;
         readonly timeoutMs?: number;
         readonly settleMs?: number;
         readonly scope?: VisualStabilityScope;
     }): Promise<void>;
+    waitForPostLoadQuiet(input: {
+        readonly pageRef: PageRef;
+        readonly timeoutMs?: number;
+        readonly quietMs?: number;
+        readonly captureWindowMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<void>;
     readText(input: NodeLocator): Promise<string | null>;
     readAttributes(input: NodeLocator): Promise<readonly {
         readonly name: string;
@@ -775,19 +806,6 @@ interface BrowserInstrumentation {
 interface BrowserCoreEngine extends BrowserExecutor, BrowserInspector, SessionTransportExecutor, BrowserInstrumentation {
 }
 
-interface ActionBoundarySnapshot {
-    readonly pageRef: PageRef;
-    readonly documentRef: DocumentRef;
-}
-type ActionBoundarySettleTrigger = "dom-action" | "navigation";
-type ActionBoundaryTimedOutPhase = "bootstrap";
-interface ActionBoundaryOutcome {
-    readonly trigger: ActionBoundarySettleTrigger;
-    readonly crossDocument: boolean;
-    readonly bootstrapSettled: boolean;
-    readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
-}
-
 interface BodyPayload {
     readonly data: string;
     readonly encoding: BodyPayloadEncoding;
@@ -1321,6 +1339,8 @@ type OpensteerCapability = (typeof opensteerCapabilities)[number];
 
 declare const cloudSessionStatuses: readonly ["provisioning", "active", "closing", "closed", "failed"];
 type CloudSessionStatus = (typeof cloudSessionStatuses)[number];
+declare const cloudSessionRecordingStatuses: readonly ["idle", "recording", "completed", "failed"];
+type CloudSessionRecordingStatus = (typeof cloudSessionRecordingStatuses)[number];
 declare const cloudSessionSourceTypes: readonly ["agent-thread", "agent-run", "project-agent-run", "local-cloud", "manual"];
 type CloudSessionSourceType = (typeof cloudSessionSourceTypes)[number];
 type CloudSessionVisibilityScope = "team" | "owner";
@@ -1412,6 +1432,21 @@ interface CloudSessionSummary {
     readonly sourceRef?: string;
     readonly label?: string;
 }
+interface CloudSessionRecordingResult {
+    readonly fileName: string;
+    readonly script: string;
+    readonly actionCount: number;
+}
+interface CloudSessionRecordingState {
+    readonly sessionId: string;
+    readonly status: CloudSessionRecordingStatus;
+    readonly actionCount: number;
+    readonly startedAt?: number;
+    readonly stoppedAt?: number;
+    readonly updatedAt: number;
+    readonly error?: string;
+    readonly result?: CloudSessionRecordingResult;
+}
 interface CloudSelectorCacheImportEntry {
     readonly workspace: string;
     readonly method: string;
@@ -1944,6 +1979,9 @@ interface OpensteerPageSnapshotOutput {
 }
 interface OpensteerDomClickInput {
     readonly target: OpensteerTargetInput;
+    readonly button?: OpensteerComputerMouseButton;
+    readonly clickCount?: number;
+    readonly modifiers?: readonly OpensteerComputerKeyModifier[];
     readonly persistAsDescription?: string;
     readonly captureNetwork?: string;
 }
@@ -2065,8 +2103,9 @@ interface OpensteerComputerExecuteOutput {
 declare const opensteerSemanticOperationNames: readonly ["session.open", "page.list", "page.new", "page.activate", "page.close", "page.goto", "page.evaluate", "page.add-init-script", "page.snapshot", "dom.click", "dom.hover", "dom.input", "dom.scroll", "dom.extract", "network.query", "network.tag", "network.clear", "network.minimize", "network.diff", "network.probe", "reverse.discover", "reverse.query", "reverse.package.create", "reverse.package.run", "reverse.export", "reverse.report", "reverse.package.get", "reverse.package.list", "reverse.package.patch", "interaction.capture", "interaction.get", "interaction.diff", "interaction.replay", "artifact.read", "inspect.cookies", "inspect.storage", "scripts.capture", "scripts.beautify", "scripts.deobfuscate", "scripts.sandbox", "captcha.solve", "request.raw", "request-plan.infer", "request-plan.write", "request-plan.get", "request-plan.list", "recipe.write", "recipe.get", "recipe.list", "recipe.run", "auth-recipe.write", "auth-recipe.get", "auth-recipe.list", "auth-recipe.run", "request.execute", "computer.execute", "session.close"];
 type OpensteerSemanticOperationName = (typeof opensteerSemanticOperationNames)[number];
 
-declare const opensteerSessionGrantKinds: readonly ["automation", "view", "cdp"];
+declare const opensteerSessionGrantKinds: readonly ["semantic", "automation", "view", "cdp"];
 type OpensteerSessionGrantKind = (typeof opensteerSessionGrantKinds)[number];
+type OpensteerSessionGrantTransport = "http" | "ws";
 type OpensteerProviderMode$1 = "local" | "cloud";
 type OpensteerSessionOwnership = "owned" | "attached" | "managed";
 interface OpensteerProviderDescriptor {
@@ -2088,7 +2127,8 @@ interface OpensteerSessionCapabilities {
 }
 interface OpensteerSessionGrant {
     readonly kind: OpensteerSessionGrantKind;
-    readonly wsUrl: string;
+    readonly transport: OpensteerSessionGrantTransport;
+    readonly url: string;
     readonly token: string;
     readonly expiresAt: number;
 }
@@ -3791,6 +3831,10 @@ 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;
@@ -4067,6 +4111,7 @@ interface OpensteerCloudProviderOptions {
     readonly mode: "cloud";
     readonly apiKey?: string;
     readonly baseUrl?: string;
+    readonly appBaseUrl?: string;
     readonly browserProfile?: CloudBrowserProfilePreference;
     readonly region?: string;
     readonly sessionId?: string;
@@ -4145,6 +4190,11 @@ interface OpensteerTargetOptions {
     readonly description?: string;
     readonly captureNetwork?: string;
 }
+interface OpensteerClickOptions extends OpensteerTargetOptions {
+    readonly button?: OpensteerComputerMouseButton;
+    readonly clickCount?: number;
+    readonly modifiers?: readonly OpensteerComputerKeyModifier[];
+}
 interface OpensteerInputOptions extends OpensteerTargetOptions {
     readonly text: string;
     readonly pressEnter?: boolean;
@@ -4255,7 +4305,7 @@ declare class Opensteer {
     evaluate(input: string | OpensteerPageEvaluateInput): Promise<OpensteerPageEvaluateOutput["value"]>;
     evaluateJson(input: string | OpensteerPageEvaluateInput): Promise<OpensteerPageEvaluateOutput["value"]>;
     addInitScript(input: string | OpensteerAddInitScriptInput): Promise<OpensteerAddInitScriptOutput>;
-    click(input: OpensteerTargetOptions): Promise<OpensteerActionResult>;
+    click(input: OpensteerClickOptions): Promise<OpensteerActionResult>;
     hover(input: OpensteerTargetOptions): Promise<OpensteerActionResult>;
     input(input: OpensteerInputOptions): Promise<OpensteerActionResult>;
     scroll(input: OpensteerScrollOptions): Promise<OpensteerActionResult>;
@@ -4323,6 +4373,7 @@ type OpensteerEnvironment = Record<string, string | undefined>;
 interface OpensteerCloudConfig {
     readonly apiKey: string;
     readonly baseUrl: string;
+    readonly appBaseUrl?: string;
     readonly browserProfile?: CloudBrowserProfilePreference;
 }
 declare function resolveCloudConfig(input?: {
@@ -4434,11 +4485,17 @@ interface OpensteerCloudSessionCreateInput {
     readonly context?: OpensteerBrowserContextOptions;
     readonly browserProfile?: CloudBrowserProfilePreference;
     readonly observability?: Partial<ObservabilityConfig>;
+    readonly sourceType?: "manual" | "local-cloud";
+    readonly sourceRef?: string;
+    readonly localWorkspaceRootPath?: string;
+    readonly locality?: "auto" | "off";
 }
 interface OpensteerCloudSessionDescriptor {
     readonly sessionId: string;
-    readonly baseUrl: string;
     readonly status?: string;
+    readonly baseUrl?: string;
+    readonly initialGrants?: Partial<Record<OpensteerSessionGrantKind, OpensteerSessionGrant>>;
+    readonly initialGrantExpiresAt?: number;
 }
 interface OpensteerCloudSessionState {
     readonly status?: string;
@@ -4452,6 +4509,9 @@ declare class OpensteerCloudClient {
     listSessions(): Promise<unknown>;
     getSession(sessionId: string): Promise<OpensteerCloudSessionState>;
     issueAccess(sessionId: string, capabilities: readonly OpensteerSessionGrantKind[]): Promise<OpensteerSessionAccessGrantResponse>;
+    getSessionRecording(sessionId: string): Promise<CloudSessionRecordingState>;
+    startSessionRecording(sessionId: string): Promise<CloudSessionRecordingState>;
+    stopSessionRecording(sessionId: string): Promise<CloudSessionRecordingState>;
     closeSession(sessionId: string): Promise<void>;
     createBrowserProfileImport(input: BrowserProfileImportCreateRequest): Promise<BrowserProfileImportCreateResponse>;
     uploadBrowserProfileImportPayload(input: {
@@ -4501,7 +4561,6 @@ interface PersistedLocalBrowserSessionRecord extends PersistedSessionRecordBase
 interface PersistedCloudSessionRecord extends PersistedSessionRecordBase {
     readonly provider: "cloud";
     readonly sessionId: string;
-    readonly baseUrl: string;
     readonly startedAt: number;
 }
 type PersistedSessionRecord = PersistedLocalBrowserSessionRecord | PersistedCloudSessionRecord;
@@ -4529,7 +4588,7 @@ declare class CloudSessionProxy implements OpensteerDisconnectableRuntime {
     private readonly cloud;
     private readonly observability;
     private sessionId;
-    private sessionBaseUrl;
+    private semanticGrant;
     private client;
     private automation;
     private workspaceStore;
@@ -4610,6 +4669,9 @@ declare class CloudSessionProxy implements OpensteerDisconnectableRuntime {
     private isReusableCloudSession;
     private requireClient;
     private requireAutomation;
+    private ensureSemanticGrant;
+    private handleSemanticClientError;
+    private shouldUseLocalCloudTransport;
 }
 
 declare function dispatchSemanticOperation(runtime: OpensteerSemanticRuntime, operation: OpensteerSemanticOperationName, input: unknown, options?: {
@@ -4651,4 +4713,4 @@ declare function discoverLocalCdpBrowsers(input?: {
     readonly timeoutMs?: number;
 }): Promise<readonly LocalCdpBrowserCandidate[]>;
 
-export { type AnchorTargetRef, type AppendTraceEntryInput, type ArtifactManifest, type ArtifactPayloadType, type ArtifactScope, type AuthRecipeRecord, type AuthRecipeRegistryStore, type BrowserProfileArchiveFormat, type BrowserProfileCreateRequest, type BrowserProfileDescriptor, type BrowserProfileImportCreateRequest, type BrowserProfileImportCreateResponse, type BrowserProfileImportDescriptor, type BrowserProfileImportStatus, type BrowserProfileListResponse, type BrowserProfileStatus, type CloudBrowserContextConfig, type CloudBrowserExtensionConfig, type CloudBrowserLaunchConfig, type CloudBrowserProfileLaunchPreference, type CloudBrowserProfilePreference, type CloudFingerprintMode, type CloudFingerprintPreference, type CloudGeolocation, type CloudProxyMode, type CloudProxyPreference, type CloudProxyProtocol, type CloudRegistryImportEntry, type CloudRegistryImportRequest, type CloudRegistryImportResponse, type CloudRequestPlanImportEntry, type CloudRequestPlanImportRequest, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, type CloudSessionLaunchConfig, CloudSessionProxy, type CloudSessionProxyOptions, type CloudSessionSourceType, type CloudSessionStatus, type CloudSessionSummary, type CloudSessionVisibilityScope, type CloudViewport, type ContextHop, type CreateFilesystemOpensteerWorkspaceOptions, type CreateTraceRunInput, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, type DescriptorRecord, type DescriptorRegistryStore, type DomActionBridge, type DomActionBridgeProvider, type DomActionOutcome, type DomActionPolicyOperation, type DomActionScrollAlignment, type DomActionScrollOptions, type DomActionSettleOptions, type DomActionTargetInspection, type DomArrayFieldSelector, type DomArrayRowMetadata, type DomArraySelector, type DomBuildPathInput, type DomClickInput, type DomDescriptorPayload, type DomDescriptorRecord, type DomDescriptorStore, type DomExtractArrayRowsInput, type DomExtractFieldSelector, type DomExtractFieldsInput, type DomExtractedArrayRow, type DomHoverInput, type DomInputInput, type DomPath, type DomReadDescriptorInput, type DomResolveTargetInput, type DomRuntime, type DomScrollInput, type DomTargetRef, type DomWriteDescriptorInput, type ElementPath, ElementPathError, type FallbackDecision, type FallbackEvaluationInput, type FallbackPolicy, FilesystemArtifactStore, type FilesystemObservationStore, type FilesystemOpensteerWorkspace, type InspectedCdpEndpoint, type InteractionTraceRecord, type InteractionTraceRegistryStore, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListObservationArtifactsInput, type ListObservationEventsInput, type LocalCdpBrowserCandidate, type LocalChromeProfileDescriptor, MATCH_ATTRIBUTE_PRIORITY, type MatchClause, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, Opensteer, type OpensteerAddInitScriptOptions, type OpensteerArtifactReadOptions, type OpensteerArtifactReadResult, type OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserStatus, type OpensteerCaptchaSolveOptions, type OpensteerCaptchaSolveResult, type OpensteerCaptureScriptsOptions, type OpensteerCaptureScriptsResult, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerComputerExecuteResult, type OpensteerDisconnectableRuntime, type OpensteerEngineName, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchedRouteResponse, type OpensteerInputOptions, type OpensteerInteractionCaptureOptions, type OpensteerInteractionCaptureResult, type OpensteerInteractionDiffOptions, type OpensteerInteractionDiffResult, type OpensteerInteractionReplayOptions, type OpensteerInteractionReplayResult, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkClearOptions, type OpensteerNetworkClearResult, type OpensteerNetworkDiffOptions, type OpensteerNetworkDiffResult, type OpensteerNetworkMinimizeOptions, type OpensteerNetworkMinimizeResult, type OpensteerNetworkProbeOptions, type OpensteerNetworkProbeResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerNetworkTagOptions, type OpensteerNetworkTagResult, type OpensteerOptions, type OpensteerPolicy, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerRawRequestOptions, type OpensteerRawRequestResult, type OpensteerRequestOptions, type OpensteerRequestResult, type OpensteerResolvedProvider, type OpensteerReverseDiscoverOptions, type OpensteerReverseDiscoverResult, type OpensteerReverseExportOptions, type OpensteerReverseExportResult, type OpensteerReversePackageCreateOptions, type OpensteerReversePackageCreateResult, type OpensteerReversePackageGetOptions, type OpensteerReversePackageGetResult, type OpensteerReversePackageListOptions, type OpensteerReversePackageListResult, type OpensteerReversePackagePatchOptions, type OpensteerReversePackagePatchResult, type OpensteerReversePackageRunOptions, type OpensteerReversePackageRunResult, type OpensteerReverseQueryOptions, type OpensteerReverseQueryResult, type OpensteerReverseReportOptions, type OpensteerReverseReportResult, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, OpensteerRuntime, type OpensteerRuntimeOptions, type OpensteerScriptBeautifyOptions, type OpensteerScriptBeautifyResult, type OpensteerScriptDeobfuscateOptions, type OpensteerScriptDeobfuscateResult, type OpensteerScriptSandboxOptions, type OpensteerScriptSandboxResult, type OpensteerScrollOptions, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerSnapshotOptions, type OpensteerSnapshotResult, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForNetworkOptions, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RecipeRecord, type RecipeRegistryStore, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanFreshness, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, type ReverseCaseRecord, type ReverseCaseRegistryStore, type ReversePackageRecord, type ReversePackageRegistryStore, type ReverseReportRecord, type ReverseReportRegistryStore, STABLE_PRIMARY_ATTR_KEYS, type SavedNetworkQueryInput, type SavedNetworkStore, type SettleContext, type SettleDelayInput, type SettleObserver, type SettlePolicy, type SettleTrigger, type StoredArtifactPayload, type StoredArtifactRecord, type StructuralElementAnchor, type StructuredArtifactKind, type SyncBrowserProfileCookiesInput, type TimeoutExecutionContext, type TimeoutPolicy, type TimeoutResolutionInput, type TraceEntryRecord, type TraceRunManifest, type UpdateReverseCaseInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteAuthRecipeInput, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRecipeInput, type WriteRequestPlanInput, type WriteReverseCaseInput, type WriteReversePackageInput, type WriteReverseReportInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };
+export { type AnchorTargetRef, type AppendTraceEntryInput, type ArtifactManifest, type ArtifactPayloadType, type ArtifactScope, type AuthRecipeRecord, type AuthRecipeRegistryStore, type BrowserProfileArchiveFormat, type BrowserProfileCreateRequest, type BrowserProfileDescriptor, type BrowserProfileImportCreateRequest, type BrowserProfileImportCreateResponse, type BrowserProfileImportDescriptor, type BrowserProfileImportStatus, type BrowserProfileListResponse, type BrowserProfileStatus, type CloudBrowserContextConfig, type CloudBrowserExtensionConfig, type CloudBrowserLaunchConfig, type CloudBrowserProfileLaunchPreference, type CloudBrowserProfilePreference, type CloudFingerprintMode, type CloudFingerprintPreference, type CloudGeolocation, type CloudProxyMode, type CloudProxyPreference, type CloudProxyProtocol, type CloudRegistryImportEntry, type CloudRegistryImportRequest, type CloudRegistryImportResponse, type CloudRequestPlanImportEntry, type CloudRequestPlanImportRequest, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, type CloudSessionLaunchConfig, CloudSessionProxy, type CloudSessionProxyOptions, type CloudSessionSourceType, type CloudSessionStatus, type CloudSessionSummary, type CloudSessionVisibilityScope, type CloudViewport, type ContextHop, type CreateFilesystemOpensteerWorkspaceOptions, type CreateTraceRunInput, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, type DescriptorRecord, type DescriptorRegistryStore, type DomActionBridge, type DomActionBridgeProvider, type DomActionOutcome, type DomActionPolicyOperation, type DomActionScrollAlignment, type DomActionScrollOptions, type DomActionSettleOptions, type DomActionTargetInspection, type DomArrayFieldSelector, type DomArrayRowMetadata, type DomArraySelector, type DomBuildPathInput, type DomClickInput, type DomDescriptorPayload, type DomDescriptorRecord, type DomDescriptorStore, type DomExtractArrayRowsInput, type DomExtractFieldSelector, type DomExtractFieldsInput, type DomExtractedArrayRow, type DomHoverInput, type DomInputInput, type DomPath, type DomReadDescriptorInput, type DomResolveTargetInput, type DomRuntime, type DomScrollInput, type DomTargetRef, type DomWriteDescriptorInput, type ElementPath, ElementPathError, type FallbackDecision, type FallbackEvaluationInput, type FallbackPolicy, FilesystemArtifactStore, type FilesystemObservationStore, type FilesystemOpensteerWorkspace, type InspectedCdpEndpoint, type InteractionTraceRecord, type InteractionTraceRegistryStore, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListObservationArtifactsInput, type ListObservationEventsInput, type LocalCdpBrowserCandidate, type LocalChromeProfileDescriptor, MATCH_ATTRIBUTE_PRIORITY, type MatchClause, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, Opensteer, type OpensteerAddInitScriptOptions, type OpensteerArtifactReadOptions, type OpensteerArtifactReadResult, type OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserStatus, type OpensteerCaptchaSolveOptions, type OpensteerCaptchaSolveResult, type OpensteerCaptureScriptsOptions, type OpensteerCaptureScriptsResult, type OpensteerClickOptions, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerComputerExecuteResult, type OpensteerDisconnectableRuntime, type OpensteerEngineName, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchedRouteResponse, type OpensteerInputOptions, type OpensteerInteractionCaptureOptions, type OpensteerInteractionCaptureResult, type OpensteerInteractionDiffOptions, type OpensteerInteractionDiffResult, type OpensteerInteractionReplayOptions, type OpensteerInteractionReplayResult, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkClearOptions, type OpensteerNetworkClearResult, type OpensteerNetworkDiffOptions, type OpensteerNetworkDiffResult, type OpensteerNetworkMinimizeOptions, type OpensteerNetworkMinimizeResult, type OpensteerNetworkProbeOptions, type OpensteerNetworkProbeResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerNetworkTagOptions, type OpensteerNetworkTagResult, type OpensteerOptions, type OpensteerPolicy, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerRawRequestOptions, type OpensteerRawRequestResult, type OpensteerRequestOptions, type OpensteerRequestResult, type OpensteerResolvedProvider, type OpensteerReverseDiscoverOptions, type OpensteerReverseDiscoverResult, type OpensteerReverseExportOptions, type OpensteerReverseExportResult, type OpensteerReversePackageCreateOptions, type OpensteerReversePackageCreateResult, type OpensteerReversePackageGetOptions, type OpensteerReversePackageGetResult, type OpensteerReversePackageListOptions, type OpensteerReversePackageListResult, type OpensteerReversePackagePatchOptions, type OpensteerReversePackagePatchResult, type OpensteerReversePackageRunOptions, type OpensteerReversePackageRunResult, type OpensteerReverseQueryOptions, type OpensteerReverseQueryResult, type OpensteerReverseReportOptions, type OpensteerReverseReportResult, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, OpensteerRuntime, type OpensteerRuntimeOptions, type OpensteerScriptBeautifyOptions, type OpensteerScriptBeautifyResult, type OpensteerScriptDeobfuscateOptions, type OpensteerScriptDeobfuscateResult, type OpensteerScriptSandboxOptions, type OpensteerScriptSandboxResult, type OpensteerScrollOptions, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerSnapshotOptions, type OpensteerSnapshotResult, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForNetworkOptions, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RecipeRecord, type RecipeRegistryStore, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanFreshness, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, type ReverseCaseRecord, type ReverseCaseRegistryStore, type ReversePackageRecord, type ReversePackageRegistryStore, type ReverseReportRecord, type ReverseReportRegistryStore, STABLE_PRIMARY_ATTR_KEYS, type SavedNetworkQueryInput, type SavedNetworkStore, type SettleContext, type SettleDelayInput, type SettleObserver, type SettlePolicy, type SettleTrigger, type StoredArtifactPayload, type StoredArtifactRecord, type StructuralElementAnchor, type StructuredArtifactKind, type SyncBrowserProfileCookiesInput, type TimeoutExecutionContext, type TimeoutPolicy, type TimeoutResolutionInput, type TraceEntryRecord, type TraceRunManifest, type UpdateReverseCaseInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteAuthRecipeInput, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRecipeInput, type WriteRequestPlanInput, type WriteReverseCaseInput, type WriteReversePackageInput, type WriteReverseReportInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };

package/dist/index.d.ts

@@ -397,6 +397,27 @@ interface BrowserCapabilities {
     };
 }
 
+interface PostLoadTrackerSnapshot {
+    readonly lastTrackedNetworkActivityAt: number;
+    readonly trackedPendingFetches: number;
+    readonly trackedPendingXhrs: number;
+}
+
+interface ActionBoundarySnapshot {
+    readonly pageRef: PageRef;
+    readonly documentRef: DocumentRef;
+    readonly url?: string;
+    readonly tracker?: PostLoadTrackerSnapshot;
+}
+type ActionBoundarySettleTrigger = "dom-action" | "navigation";
+type ActionBoundaryTimedOutPhase = "bootstrap";
+interface ActionBoundaryOutcome {
+    readonly trigger: ActionBoundarySettleTrigger;
+    readonly crossDocument: boolean;
+    readonly bootstrapSettled: boolean;
+    readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
+}
+
 type ConsoleLevel = "debug" | "log" | "info" | "warn" | "error" | "trace";
 interface StepEventBase {
     readonly eventId: string;
@@ -717,12 +738,22 @@ interface BrowserInspector {
         readonly frameRef?: FrameRef;
         readonly documentRef?: DocumentRef;
     }): Promise<DomSnapshot>;
+    getActionBoundarySnapshot(input: {
+        readonly pageRef: PageRef;
+    }): Promise<ActionBoundarySnapshot>;
     waitForVisualStability(input: {
         readonly pageRef: PageRef;
         readonly timeoutMs?: number;
         readonly settleMs?: number;
         readonly scope?: VisualStabilityScope;
     }): Promise<void>;
+    waitForPostLoadQuiet(input: {
+        readonly pageRef: PageRef;
+        readonly timeoutMs?: number;
+        readonly quietMs?: number;
+        readonly captureWindowMs?: number;
+        readonly signal?: AbortSignal;
+    }): Promise<void>;
     readText(input: NodeLocator): Promise<string | null>;
     readAttributes(input: NodeLocator): Promise<readonly {
         readonly name: string;
@@ -775,19 +806,6 @@ interface BrowserInstrumentation {
 interface BrowserCoreEngine extends BrowserExecutor, BrowserInspector, SessionTransportExecutor, BrowserInstrumentation {
 }
 
-interface ActionBoundarySnapshot {
-    readonly pageRef: PageRef;
-    readonly documentRef: DocumentRef;
-}
-type ActionBoundarySettleTrigger = "dom-action" | "navigation";
-type ActionBoundaryTimedOutPhase = "bootstrap";
-interface ActionBoundaryOutcome {
-    readonly trigger: ActionBoundarySettleTrigger;
-    readonly crossDocument: boolean;
-    readonly bootstrapSettled: boolean;
-    readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
-}
-
 interface BodyPayload {
     readonly data: string;
     readonly encoding: BodyPayloadEncoding;
@@ -1321,6 +1339,8 @@ type OpensteerCapability = (typeof opensteerCapabilities)[number];
 
 declare const cloudSessionStatuses: readonly ["provisioning", "active", "closing", "closed", "failed"];
 type CloudSessionStatus = (typeof cloudSessionStatuses)[number];
+declare const cloudSessionRecordingStatuses: readonly ["idle", "recording", "completed", "failed"];
+type CloudSessionRecordingStatus = (typeof cloudSessionRecordingStatuses)[number];
 declare const cloudSessionSourceTypes: readonly ["agent-thread", "agent-run", "project-agent-run", "local-cloud", "manual"];
 type CloudSessionSourceType = (typeof cloudSessionSourceTypes)[number];
 type CloudSessionVisibilityScope = "team" | "owner";
@@ -1412,6 +1432,21 @@ interface CloudSessionSummary {
     readonly sourceRef?: string;
     readonly label?: string;
 }
+interface CloudSessionRecordingResult {
+    readonly fileName: string;
+    readonly script: string;
+    readonly actionCount: number;
+}
+interface CloudSessionRecordingState {
+    readonly sessionId: string;
+    readonly status: CloudSessionRecordingStatus;
+    readonly actionCount: number;
+    readonly startedAt?: number;
+    readonly stoppedAt?: number;
+    readonly updatedAt: number;
+    readonly error?: string;
+    readonly result?: CloudSessionRecordingResult;
+}
 interface CloudSelectorCacheImportEntry {
     readonly workspace: string;
     readonly method: string;
@@ -1944,6 +1979,9 @@ interface OpensteerPageSnapshotOutput {
 }
 interface OpensteerDomClickInput {
     readonly target: OpensteerTargetInput;
+    readonly button?: OpensteerComputerMouseButton;
+    readonly clickCount?: number;
+    readonly modifiers?: readonly OpensteerComputerKeyModifier[];
     readonly persistAsDescription?: string;
     readonly captureNetwork?: string;
 }
@@ -2065,8 +2103,9 @@ interface OpensteerComputerExecuteOutput {
 declare const opensteerSemanticOperationNames: readonly ["session.open", "page.list", "page.new", "page.activate", "page.close", "page.goto", "page.evaluate", "page.add-init-script", "page.snapshot", "dom.click", "dom.hover", "dom.input", "dom.scroll", "dom.extract", "network.query", "network.tag", "network.clear", "network.minimize", "network.diff", "network.probe", "reverse.discover", "reverse.query", "reverse.package.create", "reverse.package.run", "reverse.export", "reverse.report", "reverse.package.get", "reverse.package.list", "reverse.package.patch", "interaction.capture", "interaction.get", "interaction.diff", "interaction.replay", "artifact.read", "inspect.cookies", "inspect.storage", "scripts.capture", "scripts.beautify", "scripts.deobfuscate", "scripts.sandbox", "captcha.solve", "request.raw", "request-plan.infer", "request-plan.write", "request-plan.get", "request-plan.list", "recipe.write", "recipe.get", "recipe.list", "recipe.run", "auth-recipe.write", "auth-recipe.get", "auth-recipe.list", "auth-recipe.run", "request.execute", "computer.execute", "session.close"];
 type OpensteerSemanticOperationName = (typeof opensteerSemanticOperationNames)[number];
 
-declare const opensteerSessionGrantKinds: readonly ["automation", "view", "cdp"];
+declare const opensteerSessionGrantKinds: readonly ["semantic", "automation", "view", "cdp"];
 type OpensteerSessionGrantKind = (typeof opensteerSessionGrantKinds)[number];
+type OpensteerSessionGrantTransport = "http" | "ws";
 type OpensteerProviderMode$1 = "local" | "cloud";
 type OpensteerSessionOwnership = "owned" | "attached" | "managed";
 interface OpensteerProviderDescriptor {
@@ -2088,7 +2127,8 @@ interface OpensteerSessionCapabilities {
 }
 interface OpensteerSessionGrant {
     readonly kind: OpensteerSessionGrantKind;
-    readonly wsUrl: string;
+    readonly transport: OpensteerSessionGrantTransport;
+    readonly url: string;
     readonly token: string;
     readonly expiresAt: number;
 }
@@ -3791,6 +3831,10 @@ 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;
@@ -4067,6 +4111,7 @@ interface OpensteerCloudProviderOptions {
     readonly mode: "cloud";
     readonly apiKey?: string;
     readonly baseUrl?: string;
+    readonly appBaseUrl?: string;
     readonly browserProfile?: CloudBrowserProfilePreference;
     readonly region?: string;
     readonly sessionId?: string;
@@ -4145,6 +4190,11 @@ interface OpensteerTargetOptions {
     readonly description?: string;
     readonly captureNetwork?: string;
 }
+interface OpensteerClickOptions extends OpensteerTargetOptions {
+    readonly button?: OpensteerComputerMouseButton;
+    readonly clickCount?: number;
+    readonly modifiers?: readonly OpensteerComputerKeyModifier[];
+}
 interface OpensteerInputOptions extends OpensteerTargetOptions {
     readonly text: string;
     readonly pressEnter?: boolean;
@@ -4255,7 +4305,7 @@ declare class Opensteer {
     evaluate(input: string | OpensteerPageEvaluateInput): Promise<OpensteerPageEvaluateOutput["value"]>;
     evaluateJson(input: string | OpensteerPageEvaluateInput): Promise<OpensteerPageEvaluateOutput["value"]>;
     addInitScript(input: string | OpensteerAddInitScriptInput): Promise<OpensteerAddInitScriptOutput>;
-    click(input: OpensteerTargetOptions): Promise<OpensteerActionResult>;
+    click(input: OpensteerClickOptions): Promise<OpensteerActionResult>;
     hover(input: OpensteerTargetOptions): Promise<OpensteerActionResult>;
     input(input: OpensteerInputOptions): Promise<OpensteerActionResult>;
     scroll(input: OpensteerScrollOptions): Promise<OpensteerActionResult>;
@@ -4323,6 +4373,7 @@ type OpensteerEnvironment = Record<string, string | undefined>;
 interface OpensteerCloudConfig {
     readonly apiKey: string;
     readonly baseUrl: string;
+    readonly appBaseUrl?: string;
     readonly browserProfile?: CloudBrowserProfilePreference;
 }
 declare function resolveCloudConfig(input?: {
@@ -4434,11 +4485,17 @@ interface OpensteerCloudSessionCreateInput {
     readonly context?: OpensteerBrowserContextOptions;
     readonly browserProfile?: CloudBrowserProfilePreference;
     readonly observability?: Partial<ObservabilityConfig>;
+    readonly sourceType?: "manual" | "local-cloud";
+    readonly sourceRef?: string;
+    readonly localWorkspaceRootPath?: string;
+    readonly locality?: "auto" | "off";
 }
 interface OpensteerCloudSessionDescriptor {
     readonly sessionId: string;
-    readonly baseUrl: string;
     readonly status?: string;
+    readonly baseUrl?: string;
+    readonly initialGrants?: Partial<Record<OpensteerSessionGrantKind, OpensteerSessionGrant>>;
+    readonly initialGrantExpiresAt?: number;
 }
 interface OpensteerCloudSessionState {
     readonly status?: string;
@@ -4452,6 +4509,9 @@ declare class OpensteerCloudClient {
     listSessions(): Promise<unknown>;
     getSession(sessionId: string): Promise<OpensteerCloudSessionState>;
     issueAccess(sessionId: string, capabilities: readonly OpensteerSessionGrantKind[]): Promise<OpensteerSessionAccessGrantResponse>;
+    getSessionRecording(sessionId: string): Promise<CloudSessionRecordingState>;
+    startSessionRecording(sessionId: string): Promise<CloudSessionRecordingState>;
+    stopSessionRecording(sessionId: string): Promise<CloudSessionRecordingState>;
     closeSession(sessionId: string): Promise<void>;
     createBrowserProfileImport(input: BrowserProfileImportCreateRequest): Promise<BrowserProfileImportCreateResponse>;
     uploadBrowserProfileImportPayload(input: {
@@ -4501,7 +4561,6 @@ interface PersistedLocalBrowserSessionRecord extends PersistedSessionRecordBase
 interface PersistedCloudSessionRecord extends PersistedSessionRecordBase {
     readonly provider: "cloud";
     readonly sessionId: string;
-    readonly baseUrl: string;
     readonly startedAt: number;
 }
 type PersistedSessionRecord = PersistedLocalBrowserSessionRecord | PersistedCloudSessionRecord;
@@ -4529,7 +4588,7 @@ declare class CloudSessionProxy implements OpensteerDisconnectableRuntime {
     private readonly cloud;
     private readonly observability;
     private sessionId;
-    private sessionBaseUrl;
+    private semanticGrant;
     private client;
     private automation;
     private workspaceStore;
@@ -4610,6 +4669,9 @@ declare class CloudSessionProxy implements OpensteerDisconnectableRuntime {
     private isReusableCloudSession;
     private requireClient;
     private requireAutomation;
+    private ensureSemanticGrant;
+    private handleSemanticClientError;
+    private shouldUseLocalCloudTransport;
 }
 
 declare function dispatchSemanticOperation(runtime: OpensteerSemanticRuntime, operation: OpensteerSemanticOperationName, input: unknown, options?: {
@@ -4651,4 +4713,4 @@ declare function discoverLocalCdpBrowsers(input?: {
     readonly timeoutMs?: number;
 }): Promise<readonly LocalCdpBrowserCandidate[]>;
 
-export { type AnchorTargetRef, type AppendTraceEntryInput, type ArtifactManifest, type ArtifactPayloadType, type ArtifactScope, type AuthRecipeRecord, type AuthRecipeRegistryStore, type BrowserProfileArchiveFormat, type BrowserProfileCreateRequest, type BrowserProfileDescriptor, type BrowserProfileImportCreateRequest, type BrowserProfileImportCreateResponse, type BrowserProfileImportDescriptor, type BrowserProfileImportStatus, type BrowserProfileListResponse, type BrowserProfileStatus, type CloudBrowserContextConfig, type CloudBrowserExtensionConfig, type CloudBrowserLaunchConfig, type CloudBrowserProfileLaunchPreference, type CloudBrowserProfilePreference, type CloudFingerprintMode, type CloudFingerprintPreference, type CloudGeolocation, type CloudProxyMode, type CloudProxyPreference, type CloudProxyProtocol, type CloudRegistryImportEntry, type CloudRegistryImportRequest, type CloudRegistryImportResponse, type CloudRequestPlanImportEntry, type CloudRequestPlanImportRequest, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, type CloudSessionLaunchConfig, CloudSessionProxy, type CloudSessionProxyOptions, type CloudSessionSourceType, type CloudSessionStatus, type CloudSessionSummary, type CloudSessionVisibilityScope, type CloudViewport, type ContextHop, type CreateFilesystemOpensteerWorkspaceOptions, type CreateTraceRunInput, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, type DescriptorRecord, type DescriptorRegistryStore, type DomActionBridge, type DomActionBridgeProvider, type DomActionOutcome, type DomActionPolicyOperation, type DomActionScrollAlignment, type DomActionScrollOptions, type DomActionSettleOptions, type DomActionTargetInspection, type DomArrayFieldSelector, type DomArrayRowMetadata, type DomArraySelector, type DomBuildPathInput, type DomClickInput, type DomDescriptorPayload, type DomDescriptorRecord, type DomDescriptorStore, type DomExtractArrayRowsInput, type DomExtractFieldSelector, type DomExtractFieldsInput, type DomExtractedArrayRow, type DomHoverInput, type DomInputInput, type DomPath, type DomReadDescriptorInput, type DomResolveTargetInput, type DomRuntime, type DomScrollInput, type DomTargetRef, type DomWriteDescriptorInput, type ElementPath, ElementPathError, type FallbackDecision, type FallbackEvaluationInput, type FallbackPolicy, FilesystemArtifactStore, type FilesystemObservationStore, type FilesystemOpensteerWorkspace, type InspectedCdpEndpoint, type InteractionTraceRecord, type InteractionTraceRegistryStore, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListObservationArtifactsInput, type ListObservationEventsInput, type LocalCdpBrowserCandidate, type LocalChromeProfileDescriptor, MATCH_ATTRIBUTE_PRIORITY, type MatchClause, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, Opensteer, type OpensteerAddInitScriptOptions, type OpensteerArtifactReadOptions, type OpensteerArtifactReadResult, type OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserStatus, type OpensteerCaptchaSolveOptions, type OpensteerCaptchaSolveResult, type OpensteerCaptureScriptsOptions, type OpensteerCaptureScriptsResult, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerComputerExecuteResult, type OpensteerDisconnectableRuntime, type OpensteerEngineName, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchedRouteResponse, type OpensteerInputOptions, type OpensteerInteractionCaptureOptions, type OpensteerInteractionCaptureResult, type OpensteerInteractionDiffOptions, type OpensteerInteractionDiffResult, type OpensteerInteractionReplayOptions, type OpensteerInteractionReplayResult, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkClearOptions, type OpensteerNetworkClearResult, type OpensteerNetworkDiffOptions, type OpensteerNetworkDiffResult, type OpensteerNetworkMinimizeOptions, type OpensteerNetworkMinimizeResult, type OpensteerNetworkProbeOptions, type OpensteerNetworkProbeResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerNetworkTagOptions, type OpensteerNetworkTagResult, type OpensteerOptions, type OpensteerPolicy, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerRawRequestOptions, type OpensteerRawRequestResult, type OpensteerRequestOptions, type OpensteerRequestResult, type OpensteerResolvedProvider, type OpensteerReverseDiscoverOptions, type OpensteerReverseDiscoverResult, type OpensteerReverseExportOptions, type OpensteerReverseExportResult, type OpensteerReversePackageCreateOptions, type OpensteerReversePackageCreateResult, type OpensteerReversePackageGetOptions, type OpensteerReversePackageGetResult, type OpensteerReversePackageListOptions, type OpensteerReversePackageListResult, type OpensteerReversePackagePatchOptions, type OpensteerReversePackagePatchResult, type OpensteerReversePackageRunOptions, type OpensteerReversePackageRunResult, type OpensteerReverseQueryOptions, type OpensteerReverseQueryResult, type OpensteerReverseReportOptions, type OpensteerReverseReportResult, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, OpensteerRuntime, type OpensteerRuntimeOptions, type OpensteerScriptBeautifyOptions, type OpensteerScriptBeautifyResult, type OpensteerScriptDeobfuscateOptions, type OpensteerScriptDeobfuscateResult, type OpensteerScriptSandboxOptions, type OpensteerScriptSandboxResult, type OpensteerScrollOptions, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerSnapshotOptions, type OpensteerSnapshotResult, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForNetworkOptions, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RecipeRecord, type RecipeRegistryStore, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanFreshness, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, type ReverseCaseRecord, type ReverseCaseRegistryStore, type ReversePackageRecord, type ReversePackageRegistryStore, type ReverseReportRecord, type ReverseReportRegistryStore, STABLE_PRIMARY_ATTR_KEYS, type SavedNetworkQueryInput, type SavedNetworkStore, type SettleContext, type SettleDelayInput, type SettleObserver, type SettlePolicy, type SettleTrigger, type StoredArtifactPayload, type StoredArtifactRecord, type StructuralElementAnchor, type StructuredArtifactKind, type SyncBrowserProfileCookiesInput, type TimeoutExecutionContext, type TimeoutPolicy, type TimeoutResolutionInput, type TraceEntryRecord, type TraceRunManifest, type UpdateReverseCaseInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteAuthRecipeInput, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRecipeInput, type WriteRequestPlanInput, type WriteReverseCaseInput, type WriteReversePackageInput, type WriteReverseReportInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };
+export { type AnchorTargetRef, type AppendTraceEntryInput, type ArtifactManifest, type ArtifactPayloadType, type ArtifactScope, type AuthRecipeRecord, type AuthRecipeRegistryStore, type BrowserProfileArchiveFormat, type BrowserProfileCreateRequest, type BrowserProfileDescriptor, type BrowserProfileImportCreateRequest, type BrowserProfileImportCreateResponse, type BrowserProfileImportDescriptor, type BrowserProfileImportStatus, type BrowserProfileListResponse, type BrowserProfileStatus, type CloudBrowserContextConfig, type CloudBrowserExtensionConfig, type CloudBrowserLaunchConfig, type CloudBrowserProfileLaunchPreference, type CloudBrowserProfilePreference, type CloudFingerprintMode, type CloudFingerprintPreference, type CloudGeolocation, type CloudProxyMode, type CloudProxyPreference, type CloudProxyProtocol, type CloudRegistryImportEntry, type CloudRegistryImportRequest, type CloudRegistryImportResponse, type CloudRequestPlanImportEntry, type CloudRequestPlanImportRequest, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, type CloudSessionLaunchConfig, CloudSessionProxy, type CloudSessionProxyOptions, type CloudSessionSourceType, type CloudSessionStatus, type CloudSessionSummary, type CloudSessionVisibilityScope, type CloudViewport, type ContextHop, type CreateFilesystemOpensteerWorkspaceOptions, type CreateTraceRunInput, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, type DescriptorRecord, type DescriptorRegistryStore, type DomActionBridge, type DomActionBridgeProvider, type DomActionOutcome, type DomActionPolicyOperation, type DomActionScrollAlignment, type DomActionScrollOptions, type DomActionSettleOptions, type DomActionTargetInspection, type DomArrayFieldSelector, type DomArrayRowMetadata, type DomArraySelector, type DomBuildPathInput, type DomClickInput, type DomDescriptorPayload, type DomDescriptorRecord, type DomDescriptorStore, type DomExtractArrayRowsInput, type DomExtractFieldSelector, type DomExtractFieldsInput, type DomExtractedArrayRow, type DomHoverInput, type DomInputInput, type DomPath, type DomReadDescriptorInput, type DomResolveTargetInput, type DomRuntime, type DomScrollInput, type DomTargetRef, type DomWriteDescriptorInput, type ElementPath, ElementPathError, type FallbackDecision, type FallbackEvaluationInput, type FallbackPolicy, FilesystemArtifactStore, type FilesystemObservationStore, type FilesystemOpensteerWorkspace, type InspectedCdpEndpoint, type InteractionTraceRecord, type InteractionTraceRegistryStore, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type ListObservationArtifactsInput, type ListObservationEventsInput, type LocalCdpBrowserCandidate, type LocalChromeProfileDescriptor, MATCH_ATTRIBUTE_PRIORITY, type MatchClause, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, Opensteer, type OpensteerAddInitScriptOptions, type OpensteerArtifactReadOptions, type OpensteerArtifactReadResult, type OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserStatus, type OpensteerCaptchaSolveOptions, type OpensteerCaptchaSolveResult, type OpensteerCaptureScriptsOptions, type OpensteerCaptureScriptsResult, type OpensteerClickOptions, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerComputerExecuteResult, type OpensteerDisconnectableRuntime, type OpensteerEngineName, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchedRouteResponse, type OpensteerInputOptions, type OpensteerInteractionCaptureOptions, type OpensteerInteractionCaptureResult, type OpensteerInteractionDiffOptions, type OpensteerInteractionDiffResult, type OpensteerInteractionReplayOptions, type OpensteerInteractionReplayResult, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkClearOptions, type OpensteerNetworkClearResult, type OpensteerNetworkDiffOptions, type OpensteerNetworkDiffResult, type OpensteerNetworkMinimizeOptions, type OpensteerNetworkMinimizeResult, type OpensteerNetworkProbeOptions, type OpensteerNetworkProbeResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerNetworkTagOptions, type OpensteerNetworkTagResult, type OpensteerOptions, type OpensteerPolicy, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerRawRequestOptions, type OpensteerRawRequestResult, type OpensteerRequestOptions, type OpensteerRequestResult, type OpensteerResolvedProvider, type OpensteerReverseDiscoverOptions, type OpensteerReverseDiscoverResult, type OpensteerReverseExportOptions, type OpensteerReverseExportResult, type OpensteerReversePackageCreateOptions, type OpensteerReversePackageCreateResult, type OpensteerReversePackageGetOptions, type OpensteerReversePackageGetResult, type OpensteerReversePackageListOptions, type OpensteerReversePackageListResult, type OpensteerReversePackagePatchOptions, type OpensteerReversePackagePatchResult, type OpensteerReversePackageRunOptions, type OpensteerReversePackageRunResult, type OpensteerReverseQueryOptions, type OpensteerReverseQueryResult, type OpensteerReverseReportOptions, type OpensteerReverseReportResult, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, OpensteerRuntime, type OpensteerRuntimeOptions, type OpensteerScriptBeautifyOptions, type OpensteerScriptBeautifyResult, type OpensteerScriptDeobfuscateOptions, type OpensteerScriptDeobfuscateResult, type OpensteerScriptSandboxOptions, type OpensteerScriptSandboxResult, type OpensteerScrollOptions, type OpensteerSemanticRuntime, OpensteerSessionRuntime, type OpensteerSessionRuntimeOptions, type OpensteerSnapshotOptions, type OpensteerSnapshotResult, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForNetworkOptions, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RecipeRecord, type RecipeRegistryStore, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanFreshness, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, type ReverseCaseRecord, type ReverseCaseRegistryStore, type ReversePackageRecord, type ReversePackageRegistryStore, type ReverseReportRecord, type ReverseReportRegistryStore, STABLE_PRIMARY_ATTR_KEYS, type SavedNetworkQueryInput, type SavedNetworkStore, type SettleContext, type SettleDelayInput, type SettleObserver, type SettlePolicy, type SettleTrigger, type StoredArtifactPayload, type StoredArtifactRecord, type StructuralElementAnchor, type StructuredArtifactKind, type SyncBrowserProfileCookiesInput, type TimeoutExecutionContext, type TimeoutPolicy, type TimeoutResolutionInput, type TraceEntryRecord, type TraceRunManifest, type UpdateReverseCaseInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteAuthRecipeInput, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRecipeInput, type WriteRequestPlanInput, type WriteReverseCaseInput, type WriteReversePackageInput, type WriteReverseReportInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager } from './chunk-RO6WAWWG.js';
-export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord } from './chunk-RO6WAWWG.js';
+import { resolveOpensteerEnvironment, resolveOpensteerRuntimeConfig, createOpensteerSemanticRuntime, OpensteerBrowserManager } from './chunk-33FDEOQY.js';
+export { CloudSessionProxy, DEFAULT_OPENSTEER_ENGINE, DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerAttachAmbiguousError, OpensteerBrowserManager, OpensteerCloudClient, OpensteerRuntime, OpensteerSessionRuntime, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, hashDomDescriptorDescription, inspectCdpEndpoint, isCurrentUrlField, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, parseDomDescriptorRecord, parseExtractionDescriptorRecord, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudConfig, resolveCloudSessionRecordPath, resolveDomActionBridge, resolveExtractedValueInContext, resolveFilesystemWorkspacePath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, resolveOpensteerEngineName, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath, writePersistedSessionRecord } from './chunk-33FDEOQY.js';
 
 // src/sdk/opensteer.ts
 var Opensteer = class {
@@ -90,7 +90,13 @@ var Opensteer = class {
     return this.runtime.addInitScript(normalized);
   }
   async click(input) {
-    const normalized = normalizeTargetOptions(input);
+    const { button, clickCount, modifiers, ...target } = input;
+    const normalized = {
+      ...normalizeTargetOptions(target),
+      ...button === void 0 ? {} : { button },
+      ...clickCount === void 0 ? {} : { clickCount },
+      ...modifiers === void 0 ? {} : { modifiers }
+    };
     return this.runtime.click(normalized);
   }
   async hover(input) {