opensteer 0.9.5 → 0.9.7

package/dist/index.d.cts

@@ -398,6 +398,7 @@ interface BrowserCapabilities {
 }
 
 interface PostLoadTrackerSnapshot {
+    readonly lastMutationAt: number;
     readonly lastTrackedNetworkActivityAt: number;
     readonly trackedPendingFetches: number;
     readonly trackedPendingXhrs: number;
@@ -415,6 +416,8 @@ interface ActionBoundaryOutcome {
     readonly trigger: ActionBoundarySettleTrigger;
     readonly crossDocument: boolean;
     readonly bootstrapSettled: boolean;
+    readonly observedMutationQuietMs?: number;
+    readonly postLoadHandled?: boolean;
     readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
 }
 
@@ -745,6 +748,7 @@ interface BrowserInspector {
         readonly pageRef: PageRef;
         readonly timeoutMs?: number;
         readonly settleMs?: number;
+        readonly initialQuietMs?: number;
         readonly scope?: VisualStabilityScope;
     }): Promise<void>;
     waitForPostLoadQuiet(input: {
@@ -1339,6 +1343,20 @@ interface OpensteerError {
     readonly capability?: OpensteerCapability;
     readonly details?: Readonly<Record<string, unknown>>;
 }
+interface OpensteerErrorOptions {
+    readonly cause?: unknown;
+    readonly retriable?: boolean;
+    readonly capability?: OpensteerCapability;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+declare class OpensteerProtocolError extends Error {
+    readonly code: OpensteerErrorCode;
+    readonly retriable: boolean;
+    readonly capability: OpensteerCapability | undefined;
+    readonly details: Readonly<Record<string, unknown>> | undefined;
+    constructor(code: OpensteerErrorCode, message: string, options?: OpensteerErrorOptions);
+}
+declare function isOpensteerProtocolError(value: unknown): value is OpensteerProtocolError;
 
 type OpensteerArtifactKind = "screenshot" | "html-snapshot" | "dom-snapshot" | "cookies" | "storage-snapshot" | "script-source";
 type ArtifactRelation = "result" | "before" | "after" | "capture" | "evidence" | "snapshot";
@@ -1614,27 +1632,11 @@ interface OpensteerStealthProfileInput {
     readonly locale?: string;
     readonly timezoneId?: string;
 }
-interface OpensteerResolvedTarget {
-    readonly pageRef: PageRef;
-    readonly frameRef: FrameRef;
-    readonly documentRef: DocumentRef;
-    readonly documentEpoch: DocumentEpoch;
-    readonly nodeRef: NodeRef;
+interface OpensteerActionResult {
     readonly tagName: string;
-    readonly pathHint: string;
     readonly persist?: string;
-    readonly selectorUsed?: string;
-}
-interface OpensteerActionResult {
-    readonly target: OpensteerResolvedTarget;
-    readonly point?: {
-        readonly x: number;
-        readonly y: number;
-    };
 }
-interface OpensteerSessionState {
-    readonly sessionRef: SessionRef;
-    readonly pageRef: PageRef;
+interface OpensteerNavigationSummary {
     readonly url: string;
     readonly title: string;
 }
@@ -1645,7 +1647,7 @@ interface OpensteerOpenInput {
     readonly launch?: OpensteerBrowserLaunchOptions;
     readonly context?: OpensteerBrowserContextOptions;
 }
-interface OpensteerOpenOutput extends OpensteerSessionState {
+interface OpensteerOpenOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageListInput {
 }
@@ -1657,12 +1659,13 @@ interface OpensteerPageNewInput {
     readonly url?: string;
     readonly openerPageRef?: PageRef;
 }
-interface OpensteerPageNewOutput extends OpensteerSessionState {
+interface OpensteerPageNewOutput extends OpensteerNavigationSummary {
+    readonly pageRef: PageRef;
 }
 interface OpensteerPageActivateInput {
     readonly pageRef: PageRef;
 }
-interface OpensteerPageActivateOutput extends OpensteerSessionState {
+interface OpensteerPageActivateOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageCloseInput {
     readonly pageRef?: PageRef;
@@ -1676,7 +1679,7 @@ interface OpensteerPageGotoInput {
     readonly url: string;
     readonly captureNetwork?: string;
 }
-interface OpensteerPageGotoOutput extends OpensteerSessionState {
+interface OpensteerPageGotoOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageEvaluateInput {
     readonly script: string;
@@ -1752,39 +1755,22 @@ interface OpensteerComputerScreenshotOptions {
     readonly includeCursor?: boolean;
     readonly disableAnnotations?: readonly OpensteerComputerAnnotation[];
 }
+interface OpensteerScreenshotSummary {
+    readonly payload: ExternalBinaryLocation;
+    readonly format: "png" | "jpeg" | "webp";
+    readonly size: Size;
+    readonly coordinateSpace: CoordinateSpace;
+    readonly clip?: Rect;
+}
 interface OpensteerComputerExecuteInput {
     readonly action: OpensteerComputerAction;
     readonly screenshot?: OpensteerComputerScreenshotOptions;
     readonly captureNetwork?: string;
 }
-interface OpensteerComputerDisplayScale {
-    readonly x: number;
-    readonly y: number;
-}
-interface OpensteerComputerTracePoint {
-    readonly role: "point" | "start" | "end";
-    readonly point: Point;
-    readonly hitTest?: HitTestResult;
-    readonly target?: OpensteerResolvedTarget;
-}
-interface OpensteerComputerTraceEnrichment {
-    readonly points: readonly OpensteerComputerTracePoint[];
-}
-interface OpensteerComputerExecuteTiming {
-    readonly actionMs: number;
-    readonly waitMs: number;
-    readonly totalMs: number;
-}
 interface OpensteerComputerExecuteOutput {
-    readonly action: OpensteerComputerAction;
-    readonly pageRef: PageRef;
-    readonly screenshot: ScreenshotArtifact;
-    readonly displayViewport: ViewportMetrics;
-    readonly nativeViewport: ViewportMetrics;
-    readonly displayScale: OpensteerComputerDisplayScale;
-    readonly events: readonly StepEvent[];
-    readonly timing: OpensteerComputerExecuteTiming;
-    readonly trace?: OpensteerComputerTraceEnrichment;
+    readonly url: string;
+    readonly title: string;
+    readonly screenshot: OpensteerScreenshotSummary;
 }
 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.detail", "interaction.capture", "interaction.get", "interaction.diff", "interaction.replay", "artifact.read", "session.cookies", "session.storage", "session.state", "session.fetch", "scripts.capture", "scripts.beautify", "scripts.deobfuscate", "scripts.sandbox", "captcha.solve", "computer.execute", "session.close"];
 type OpensteerSemanticOperationName = (typeof opensteerSemanticOperationNames)[number];
@@ -1871,7 +1857,11 @@ interface PositionMatchClause {
     readonly kind: "position";
     readonly axis: "nthOfType" | "nthChild";
 }
-type MatchClause = AttributeMatchClause | PositionMatchClause;
+interface TextMatchClause {
+    readonly kind: "text";
+    readonly value: string;
+}
+type MatchClause = AttributeMatchClause | PositionMatchClause | TextMatchClause;
 interface PathNodePosition {
     readonly nthChild: number;
     readonly nthOfType: number;
@@ -1921,18 +1911,22 @@ interface DomActionSettleOptions {
     readonly snapshot?: ActionBoundarySnapshot;
     readonly signal: AbortSignal;
     remainingMs(): number | undefined;
-    policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger): Promise<void>;
+    policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger, boundary?: ActionBoundaryOutcome): Promise<void>;
 }
 type DomPointerHitRelation = "self" | "descendant" | "ancestor" | "same-owner" | "outside" | "unknown";
 interface DomPointerHitAssessment {
     readonly relation: DomPointerHitRelation;
     readonly blocking: boolean;
     readonly ambiguous?: boolean;
+    readonly blockingDescription?: string;
     readonly canonicalTarget?: NodeLocator;
     readonly hitOwner?: NodeLocator;
 }
+interface BuildReplayPathOptions {
+    readonly enableTextMatch?: boolean;
+}
 interface DomActionBridge {
-    buildReplayPath(locator: NodeLocator): Promise<ReplayElementPath>;
+    buildReplayPath(locator: NodeLocator, options?: BuildReplayPathOptions): Promise<ReplayElementPath>;
     inspectActionTarget(locator: NodeLocator): Promise<DomActionTargetInspection>;
     canonicalizePointerTarget(locator: NodeLocator): Promise<NodeLocator>;
     classifyPointerHit(input: {
@@ -2327,6 +2321,8 @@ interface SettleContext extends SettleDelayInput {
     readonly pageRef: PageRef;
     readonly signal: AbortSignal;
     readonly remainingMs: number | undefined;
+    readonly observedMutationQuietMs?: number;
+    readonly postLoadHandled?: boolean;
 }
 interface SettleObserver {
     settle(input: SettleContext): Promise<boolean>;
@@ -2436,6 +2432,7 @@ interface ResolvedDomTarget {
 }
 interface DomBuildPathInput {
     readonly locator: NodeLocator;
+    readonly enableTextMatch?: boolean;
 }
 interface DomResolveTargetInput {
     readonly pageRef: PageRef;
@@ -2692,6 +2689,7 @@ interface WorkspaceBrowserManifest {
 }
 interface WorkspaceLiveBrowserRecord {
     readonly mode: "persistent";
+    readonly ownership: "owned" | "attached";
     readonly engine: OpensteerEngineName;
     readonly endpoint?: string;
     readonly baseUrl?: string;
@@ -3035,6 +3033,12 @@ interface OpensteerCloudSessionDescriptor {
 }
 interface OpensteerCloudSessionState {
     readonly status?: string;
+    readonly runtimeWorkerId?: string;
+    readonly registryDesiredRevision?: number;
+    readonly registryLoadedRevision?: number;
+    readonly idleTimeoutMs?: number;
+    readonly absoluteTtlMs?: number;
+    readonly expiresAt?: number;
 }
 interface CloudRequestOptions {
     readonly signal?: AbortSignal | undefined;
@@ -3084,6 +3088,7 @@ interface PersistedSessionRecordBase {
 interface PersistedLocalBrowserSessionRecord extends PersistedSessionRecordBase {
     readonly provider: "local";
     readonly engine: "playwright" | "abp";
+    readonly ownership?: Exclude<OpensteerSessionOwnership, "managed">;
     readonly endpoint?: string;
     readonly baseUrl?: string;
     readonly remoteDebuggingUrl?: string;
@@ -3143,4 +3148,4 @@ declare function discoverLocalCdpBrowsers(input?: {
     readonly timeoutMs?: number;
 }): Promise<readonly LocalCdpBrowserCandidate[]>;
 
-export { type AnchorTargetRef, type AppendTraceEntryInput, type ArtifactManifest, type ArtifactPayloadType, type ArtifactScope, 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 CloudSessionLaunchConfig, 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 OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserState, type OpensteerBrowserStatus, type OpensteerClickOptions, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerCookieJar, type OpensteerDomController, type OpensteerEngineName, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchOptions, type OpensteerFetchedRouteResponse, type OpensteerGotoOptions, type OpensteerInputOptions, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkController, type OpensteerNetworkDetailResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerOptions, type OpensteerPolicy, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerResolvedProvider, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, type OpensteerRuntimeOptions, type OpensteerScrollOptions, type OpensteerSessionRuntimeOptions, type OpensteerStorageMap, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, 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 UpdateRequestPlanFreshnessInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRequestPlanInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, hashDomDescriptorPersist, 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 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 CloudSessionLaunchConfig, 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 OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserState, type OpensteerBrowserStatus, type OpensteerClickOptions, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerCookieJar, type OpensteerDomController, type OpensteerEngineName, type OpensteerError, type OpensteerErrorCode, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchOptions, type OpensteerFetchedRouteResponse, type OpensteerGotoOptions, type OpensteerInputOptions, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkController, type OpensteerNetworkDetailResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerOptions, type OpensteerPolicy, OpensteerProtocolError, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerResolvedProvider, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, type OpensteerRuntimeOptions, type OpensteerScrollOptions, type OpensteerSessionRuntimeOptions, type OpensteerStorageMap, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, 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 UpdateRequestPlanFreshnessInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRequestPlanInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, hashDomDescriptorPersist, inspectCdpEndpoint, isCurrentUrlField, isOpensteerProtocolError, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, opensteerErrorCodes, 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

@@ -398,6 +398,7 @@ interface BrowserCapabilities {
 }
 
 interface PostLoadTrackerSnapshot {
+    readonly lastMutationAt: number;
     readonly lastTrackedNetworkActivityAt: number;
     readonly trackedPendingFetches: number;
     readonly trackedPendingXhrs: number;
@@ -415,6 +416,8 @@ interface ActionBoundaryOutcome {
     readonly trigger: ActionBoundarySettleTrigger;
     readonly crossDocument: boolean;
     readonly bootstrapSettled: boolean;
+    readonly observedMutationQuietMs?: number;
+    readonly postLoadHandled?: boolean;
     readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
 }
 
@@ -745,6 +748,7 @@ interface BrowserInspector {
         readonly pageRef: PageRef;
         readonly timeoutMs?: number;
         readonly settleMs?: number;
+        readonly initialQuietMs?: number;
         readonly scope?: VisualStabilityScope;
     }): Promise<void>;
     waitForPostLoadQuiet(input: {
@@ -1339,6 +1343,20 @@ interface OpensteerError {
     readonly capability?: OpensteerCapability;
     readonly details?: Readonly<Record<string, unknown>>;
 }
+interface OpensteerErrorOptions {
+    readonly cause?: unknown;
+    readonly retriable?: boolean;
+    readonly capability?: OpensteerCapability;
+    readonly details?: Readonly<Record<string, unknown>>;
+}
+declare class OpensteerProtocolError extends Error {
+    readonly code: OpensteerErrorCode;
+    readonly retriable: boolean;
+    readonly capability: OpensteerCapability | undefined;
+    readonly details: Readonly<Record<string, unknown>> | undefined;
+    constructor(code: OpensteerErrorCode, message: string, options?: OpensteerErrorOptions);
+}
+declare function isOpensteerProtocolError(value: unknown): value is OpensteerProtocolError;
 
 type OpensteerArtifactKind = "screenshot" | "html-snapshot" | "dom-snapshot" | "cookies" | "storage-snapshot" | "script-source";
 type ArtifactRelation = "result" | "before" | "after" | "capture" | "evidence" | "snapshot";
@@ -1614,27 +1632,11 @@ interface OpensteerStealthProfileInput {
     readonly locale?: string;
     readonly timezoneId?: string;
 }
-interface OpensteerResolvedTarget {
-    readonly pageRef: PageRef;
-    readonly frameRef: FrameRef;
-    readonly documentRef: DocumentRef;
-    readonly documentEpoch: DocumentEpoch;
-    readonly nodeRef: NodeRef;
+interface OpensteerActionResult {
     readonly tagName: string;
-    readonly pathHint: string;
     readonly persist?: string;
-    readonly selectorUsed?: string;
-}
-interface OpensteerActionResult {
-    readonly target: OpensteerResolvedTarget;
-    readonly point?: {
-        readonly x: number;
-        readonly y: number;
-    };
 }
-interface OpensteerSessionState {
-    readonly sessionRef: SessionRef;
-    readonly pageRef: PageRef;
+interface OpensteerNavigationSummary {
     readonly url: string;
     readonly title: string;
 }
@@ -1645,7 +1647,7 @@ interface OpensteerOpenInput {
     readonly launch?: OpensteerBrowserLaunchOptions;
     readonly context?: OpensteerBrowserContextOptions;
 }
-interface OpensteerOpenOutput extends OpensteerSessionState {
+interface OpensteerOpenOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageListInput {
 }
@@ -1657,12 +1659,13 @@ interface OpensteerPageNewInput {
     readonly url?: string;
     readonly openerPageRef?: PageRef;
 }
-interface OpensteerPageNewOutput extends OpensteerSessionState {
+interface OpensteerPageNewOutput extends OpensteerNavigationSummary {
+    readonly pageRef: PageRef;
 }
 interface OpensteerPageActivateInput {
     readonly pageRef: PageRef;
 }
-interface OpensteerPageActivateOutput extends OpensteerSessionState {
+interface OpensteerPageActivateOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageCloseInput {
     readonly pageRef?: PageRef;
@@ -1676,7 +1679,7 @@ interface OpensteerPageGotoInput {
     readonly url: string;
     readonly captureNetwork?: string;
 }
-interface OpensteerPageGotoOutput extends OpensteerSessionState {
+interface OpensteerPageGotoOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageEvaluateInput {
     readonly script: string;
@@ -1752,39 +1755,22 @@ interface OpensteerComputerScreenshotOptions {
     readonly includeCursor?: boolean;
     readonly disableAnnotations?: readonly OpensteerComputerAnnotation[];
 }
+interface OpensteerScreenshotSummary {
+    readonly payload: ExternalBinaryLocation;
+    readonly format: "png" | "jpeg" | "webp";
+    readonly size: Size;
+    readonly coordinateSpace: CoordinateSpace;
+    readonly clip?: Rect;
+}
 interface OpensteerComputerExecuteInput {
     readonly action: OpensteerComputerAction;
     readonly screenshot?: OpensteerComputerScreenshotOptions;
     readonly captureNetwork?: string;
 }
-interface OpensteerComputerDisplayScale {
-    readonly x: number;
-    readonly y: number;
-}
-interface OpensteerComputerTracePoint {
-    readonly role: "point" | "start" | "end";
-    readonly point: Point;
-    readonly hitTest?: HitTestResult;
-    readonly target?: OpensteerResolvedTarget;
-}
-interface OpensteerComputerTraceEnrichment {
-    readonly points: readonly OpensteerComputerTracePoint[];
-}
-interface OpensteerComputerExecuteTiming {
-    readonly actionMs: number;
-    readonly waitMs: number;
-    readonly totalMs: number;
-}
 interface OpensteerComputerExecuteOutput {
-    readonly action: OpensteerComputerAction;
-    readonly pageRef: PageRef;
-    readonly screenshot: ScreenshotArtifact;
-    readonly displayViewport: ViewportMetrics;
-    readonly nativeViewport: ViewportMetrics;
-    readonly displayScale: OpensteerComputerDisplayScale;
-    readonly events: readonly StepEvent[];
-    readonly timing: OpensteerComputerExecuteTiming;
-    readonly trace?: OpensteerComputerTraceEnrichment;
+    readonly url: string;
+    readonly title: string;
+    readonly screenshot: OpensteerScreenshotSummary;
 }
 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.detail", "interaction.capture", "interaction.get", "interaction.diff", "interaction.replay", "artifact.read", "session.cookies", "session.storage", "session.state", "session.fetch", "scripts.capture", "scripts.beautify", "scripts.deobfuscate", "scripts.sandbox", "captcha.solve", "computer.execute", "session.close"];
 type OpensteerSemanticOperationName = (typeof opensteerSemanticOperationNames)[number];
@@ -1871,7 +1857,11 @@ interface PositionMatchClause {
     readonly kind: "position";
     readonly axis: "nthOfType" | "nthChild";
 }
-type MatchClause = AttributeMatchClause | PositionMatchClause;
+interface TextMatchClause {
+    readonly kind: "text";
+    readonly value: string;
+}
+type MatchClause = AttributeMatchClause | PositionMatchClause | TextMatchClause;
 interface PathNodePosition {
     readonly nthChild: number;
     readonly nthOfType: number;
@@ -1921,18 +1911,22 @@ interface DomActionSettleOptions {
     readonly snapshot?: ActionBoundarySnapshot;
     readonly signal: AbortSignal;
     remainingMs(): number | undefined;
-    policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger): Promise<void>;
+    policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger, boundary?: ActionBoundaryOutcome): Promise<void>;
 }
 type DomPointerHitRelation = "self" | "descendant" | "ancestor" | "same-owner" | "outside" | "unknown";
 interface DomPointerHitAssessment {
     readonly relation: DomPointerHitRelation;
     readonly blocking: boolean;
     readonly ambiguous?: boolean;
+    readonly blockingDescription?: string;
     readonly canonicalTarget?: NodeLocator;
     readonly hitOwner?: NodeLocator;
 }
+interface BuildReplayPathOptions {
+    readonly enableTextMatch?: boolean;
+}
 interface DomActionBridge {
-    buildReplayPath(locator: NodeLocator): Promise<ReplayElementPath>;
+    buildReplayPath(locator: NodeLocator, options?: BuildReplayPathOptions): Promise<ReplayElementPath>;
     inspectActionTarget(locator: NodeLocator): Promise<DomActionTargetInspection>;
     canonicalizePointerTarget(locator: NodeLocator): Promise<NodeLocator>;
     classifyPointerHit(input: {
@@ -2327,6 +2321,8 @@ interface SettleContext extends SettleDelayInput {
     readonly pageRef: PageRef;
     readonly signal: AbortSignal;
     readonly remainingMs: number | undefined;
+    readonly observedMutationQuietMs?: number;
+    readonly postLoadHandled?: boolean;
 }
 interface SettleObserver {
     settle(input: SettleContext): Promise<boolean>;
@@ -2436,6 +2432,7 @@ interface ResolvedDomTarget {
 }
 interface DomBuildPathInput {
     readonly locator: NodeLocator;
+    readonly enableTextMatch?: boolean;
 }
 interface DomResolveTargetInput {
     readonly pageRef: PageRef;
@@ -2692,6 +2689,7 @@ interface WorkspaceBrowserManifest {
 }
 interface WorkspaceLiveBrowserRecord {
     readonly mode: "persistent";
+    readonly ownership: "owned" | "attached";
     readonly engine: OpensteerEngineName;
     readonly endpoint?: string;
     readonly baseUrl?: string;
@@ -3035,6 +3033,12 @@ interface OpensteerCloudSessionDescriptor {
 }
 interface OpensteerCloudSessionState {
     readonly status?: string;
+    readonly runtimeWorkerId?: string;
+    readonly registryDesiredRevision?: number;
+    readonly registryLoadedRevision?: number;
+    readonly idleTimeoutMs?: number;
+    readonly absoluteTtlMs?: number;
+    readonly expiresAt?: number;
 }
 interface CloudRequestOptions {
     readonly signal?: AbortSignal | undefined;
@@ -3084,6 +3088,7 @@ interface PersistedSessionRecordBase {
 interface PersistedLocalBrowserSessionRecord extends PersistedSessionRecordBase {
     readonly provider: "local";
     readonly engine: "playwright" | "abp";
+    readonly ownership?: Exclude<OpensteerSessionOwnership, "managed">;
     readonly endpoint?: string;
     readonly baseUrl?: string;
     readonly remoteDebuggingUrl?: string;
@@ -3143,4 +3148,4 @@ declare function discoverLocalCdpBrowsers(input?: {
     readonly timeoutMs?: number;
 }): Promise<readonly LocalCdpBrowserCandidate[]>;
 
-export { type AnchorTargetRef, type AppendTraceEntryInput, type ArtifactManifest, type ArtifactPayloadType, type ArtifactScope, 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 CloudSessionLaunchConfig, 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 OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserState, type OpensteerBrowserStatus, type OpensteerClickOptions, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerCookieJar, type OpensteerDomController, type OpensteerEngineName, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchOptions, type OpensteerFetchedRouteResponse, type OpensteerGotoOptions, type OpensteerInputOptions, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkController, type OpensteerNetworkDetailResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerOptions, type OpensteerPolicy, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerResolvedProvider, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, type OpensteerRuntimeOptions, type OpensteerScrollOptions, type OpensteerSessionRuntimeOptions, type OpensteerStorageMap, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, 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 UpdateRequestPlanFreshnessInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRequestPlanInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, hashDomDescriptorPersist, 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 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 CloudSessionLaunchConfig, 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 OpensteerArtifactStore, OpensteerAttachAmbiguousError, type OpensteerBrowserCloneOptions, type OpensteerBrowserController, OpensteerBrowserManager, type OpensteerBrowserManagerOptions, type OpensteerBrowserState, type OpensteerBrowserStatus, type OpensteerClickOptions, OpensteerCloudClient, type OpensteerCloudConfig, type OpensteerCloudProviderOptions, type OpensteerCloudSessionCreateInput, type OpensteerCloudSessionDescriptor, type OpensteerComputerExecuteOptions, type OpensteerCookieJar, type OpensteerDomController, type OpensteerEngineName, type OpensteerError, type OpensteerErrorCode, type OpensteerExtractOptions, type OpensteerExtractionDescriptorPayload, type OpensteerExtractionDescriptorRecord, type OpensteerExtractionDescriptorStore, type OpensteerFetchOptions, type OpensteerFetchedRouteResponse, type OpensteerGotoOptions, type OpensteerInputOptions, type OpensteerInterceptScriptOptions, type OpensteerLiveSessionProvider, type OpensteerLocalProviderOptions, type OpensteerNetworkController, type OpensteerNetworkDetailResult, type OpensteerNetworkQueryOptions, type OpensteerNetworkQueryResult, type OpensteerOptions, type OpensteerPolicy, OpensteerProtocolError, type OpensteerProviderMode, type OpensteerProviderOptions, type OpensteerProviderSource, type OpensteerResolvedProvider, type OpensteerRouteHandlerResult, type OpensteerRouteOptions, type OpensteerRouteRegistration, type OpensteerRuntimeOptions, type OpensteerScrollOptions, type OpensteerSessionRuntimeOptions, type OpensteerStorageMap, type OpensteerTargetOptions, type OpensteerTraceStore, type OpensteerWaitForPageOptions, type OpensteerWorkspaceManifest, type PathNode, type PersistedCloudSessionRecord, type PersistedLocalBrowserSessionRecord, type PersistedSessionRecord, type ProtocolArtifactDelivery, type RegistryProvenance, type RegistryRecord, type ReplayElementPath, type RequestPlanRecord, type RequestPlanRegistryStore, type ResolveRegistryRecordInput, type ResolvedDomTarget, type RetryDecision, type RetryEvaluationInput, type RetryPolicy, 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 UpdateRequestPlanFreshnessInput, type WorkspaceBrowserBootstrap, type WorkspaceBrowserManifest, type WorkspaceLiveBrowserRecord, type WriteBinaryArtifactInput, type WriteDescriptorInput, type WriteInteractionTraceInput, type WriteRequestPlanInput, type WriteStructuredArtifactInput, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, clearPersistedSessionRecord, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createArtifactStore, createDomDescriptorStore, createDomRuntime, createFilesystemOpensteerWorkspace, createObservationStore, createOpensteerExtractionDescriptorStore, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, hashDomDescriptorPersist, inspectCdpEndpoint, isCurrentUrlField, isOpensteerProtocolError, isValidCssAttributeKey, listLocalChromeProfiles, manifestToExternalBinaryLocation, normalizeExtractedValue, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeOpensteerProviderMode, normalizeWorkspaceId, opensteerErrorCodes, 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,6 +1,6 @@
-export { Opensteer } from './chunk-7D45QUZ3.js';
-export { DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OpensteerCloudClient, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createDomDescriptorStore, createDomRuntime, createOpensteerExtractionDescriptorStore, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, hashDomDescriptorPersist, isCurrentUrlField, isValidCssAttributeKey, normalizeExtractedValue, normalizeOpensteerProviderMode, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveCloudConfig, resolveDomActionBridge, resolveExtractedValueInContext, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath } from './chunk-7LQL5YUR.js';
-export { DEFAULT_OPENSTEER_ENGINE, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerBrowserManager, createArtifactStore, createFilesystemOpensteerWorkspace, createObservationStore, manifestToExternalBinaryLocation, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeWorkspaceId, resolveFilesystemWorkspacePath, resolveOpensteerEngineName } from './chunk-GSCQQKZZ.js';
-export { OpensteerAttachAmbiguousError, clearPersistedSessionRecord, discoverLocalCdpBrowsers, inspectCdpEndpoint, listLocalChromeProfiles, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudSessionRecordPath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, writePersistedSessionRecord } from './chunk-T5P2QGZ3.js';
+export { Opensteer } from './chunk-52UNH5UW.js';
+export { DEFERRED_MATCH_ATTR_KEYS, ElementPathError, MATCH_ATTRIBUTE_PRIORITY, OPENSTEER_DOM_ACTION_BRIDGE_SYMBOL, OpensteerCloudClient, STABLE_PRIMARY_ATTR_KEYS, assertProviderSupportsEngine, buildArrayFieldPathCandidates, buildDomDescriptorKey, buildDomDescriptorPayload, buildDomDescriptorVersion, buildPathCandidates, buildPathSelectorHint, buildSegmentSelector, cloneElementPath, cloneReplayElementPath, cloneStructuralElementAnchor, createDomDescriptorStore, createDomRuntime, createOpensteerExtractionDescriptorStore, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, hashDomDescriptorPersist, isCurrentUrlField, isValidCssAttributeKey, normalizeExtractedValue, normalizeOpensteerProviderMode, parseDomDescriptorRecord, parseExtractionDescriptorRecord, resolveCloudConfig, resolveDomActionBridge, resolveExtractedValueInContext, resolveOpensteerProvider, resolveOpensteerRuntimeConfig, runWithPolicyTimeout, sanitizeElementPath, sanitizeReplayElementPath, sanitizeStructuralElementAnchor, settleWithPolicy, shouldKeepAttributeForPath } from './chunk-3OHKIPBD.js';
+export { DEFAULT_OPENSTEER_ENGINE, OPENSTEER_ENGINE_NAMES, OPENSTEER_FILESYSTEM_WORKSPACE_LAYOUT, OPENSTEER_FILESYSTEM_WORKSPACE_VERSION, OpensteerBrowserManager, OpensteerProtocolError, createArtifactStore, createFilesystemOpensteerWorkspace, createObservationStore, isOpensteerProtocolError, manifestToExternalBinaryLocation, normalizeObservabilityConfig, normalizeOpensteerEngineName, normalizeWorkspaceId, opensteerErrorCodes, resolveFilesystemWorkspacePath, resolveOpensteerEngineName } from './chunk-PJXN7HED.js';
+export { OpensteerAttachAmbiguousError, clearPersistedSessionRecord, discoverLocalCdpBrowsers, inspectCdpEndpoint, listLocalChromeProfiles, readPersistedCloudSessionRecord, readPersistedLocalBrowserSessionRecord, readPersistedSessionRecord, resolveCloudSessionRecordPath, resolveLiveSessionRecordPath, resolveLocalSessionRecordPath, writePersistedSessionRecord } from './chunk-U4BUCIZ4.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/local-view/public/assets/app.js

@@ -1556,7 +1556,16 @@ class LocalViewApp {
 
       const meta = document.createElement("span");
       meta.className = "session-info";
-      meta.textContent = [session.workspace, `pid ${session.pid}`].filter(Boolean).join(" \u00b7 ");
+      meta.textContent = [
+        session.workspace,
+        Number.isInteger(session.pid) && session.pid > 0
+          ? `pid ${session.pid}`
+          : session.ownership === "attached"
+            ? "attached"
+            : "",
+      ]
+        .filter(Boolean)
+        .join(" \u00b7 ");
 
       row2.append(badge, meta);