opensteer 0.9.6 → 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: {
@@ -1628,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;
 }
@@ -1659,7 +1647,7 @@ interface OpensteerOpenInput {
     readonly launch?: OpensteerBrowserLaunchOptions;
     readonly context?: OpensteerBrowserContextOptions;
 }
-interface OpensteerOpenOutput extends OpensteerSessionState {
+interface OpensteerOpenOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageListInput {
 }
@@ -1671,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;
@@ -1690,7 +1679,7 @@ interface OpensteerPageGotoInput {
     readonly url: string;
     readonly captureNetwork?: string;
 }
-interface OpensteerPageGotoOutput extends OpensteerSessionState {
+interface OpensteerPageGotoOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageEvaluateInput {
     readonly script: string;
@@ -1766,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];
@@ -1939,7 +1911,7 @@ 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 {
@@ -2349,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>;
@@ -2715,6 +2689,7 @@ interface WorkspaceBrowserManifest {
 }
 interface WorkspaceLiveBrowserRecord {
     readonly mode: "persistent";
+    readonly ownership: "owned" | "attached";
     readonly engine: OpensteerEngineName;
     readonly endpoint?: string;
     readonly baseUrl?: string;
@@ -3113,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;

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: {
@@ -1628,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;
 }
@@ -1659,7 +1647,7 @@ interface OpensteerOpenInput {
     readonly launch?: OpensteerBrowserLaunchOptions;
     readonly context?: OpensteerBrowserContextOptions;
 }
-interface OpensteerOpenOutput extends OpensteerSessionState {
+interface OpensteerOpenOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageListInput {
 }
@@ -1671,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;
@@ -1690,7 +1679,7 @@ interface OpensteerPageGotoInput {
     readonly url: string;
     readonly captureNetwork?: string;
 }
-interface OpensteerPageGotoOutput extends OpensteerSessionState {
+interface OpensteerPageGotoOutput extends OpensteerNavigationSummary {
 }
 interface OpensteerPageEvaluateInput {
     readonly script: string;
@@ -1766,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];
@@ -1939,7 +1911,7 @@ 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 {
@@ -2349,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>;
@@ -2715,6 +2689,7 @@ interface WorkspaceBrowserManifest {
 }
 interface WorkspaceLiveBrowserRecord {
     readonly mode: "persistent";
+    readonly ownership: "owned" | "attached";
     readonly engine: OpensteerEngineName;
     readonly endpoint?: string;
     readonly baseUrl?: string;
@@ -3113,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;

package/dist/index.js

@@ -1,6 +1,6 @@
-export { Opensteer } from './chunk-L4NF74KI.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-BVRIPCWA.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-3XBQRZZC.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);