opensteer 0.9.4 → 0.9.6

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { OpensteerEngineFactory, DomDescriptorStore as DomDescriptorStore$1, OpensteerExtractionDescriptorStore as OpensteerExtractionDescriptorStore$1, OpensteerSessionRuntime as OpensteerSessionRuntime$1 } from '@opensteer/runtime-core';
+import { OpensteerEngineFactory, DomDescriptorStore as DomDescriptorStore$1, OpensteerExtractionDescriptorStore as OpensteerExtractionDescriptorStore$1 } from '@opensteer/runtime-core';
 export { OpensteerEngineFactory, OpensteerEngineFactoryOptions, OpensteerRuntimeWorkspace } from '@opensteer/runtime-core';
 
 type JsonPrimitive$1 = boolean | number | string | null;
@@ -935,12 +935,6 @@ interface OpensteerRequestPlanPayload {
     readonly retryPolicy?: OpensteerRequestRetryPolicy;
     readonly auth?: OpensteerRequestPlanAuth;
 }
-interface OpensteerRegistryProvenance {
-    readonly source: string;
-    readonly sourceId?: string;
-    readonly capturedAt?: number;
-    readonly notes?: string;
-}
 interface OpensteerRequestPlanFreshness {
     readonly lastValidatedAt?: number;
     readonly staleAt?: number;
@@ -1031,10 +1025,6 @@ interface OpensteerNetworkDetailOutput {
         readonly attempts: readonly OpensteerReplayAttempt[];
     };
 }
-interface OpensteerNetworkDetailInput {
-    readonly recordId: string;
-    readonly probe?: boolean;
-}
 interface OpensteerReplayAttempt {
     readonly transport: TransportKind;
     readonly status?: number;
@@ -1055,32 +1045,7 @@ interface OpensteerSessionFetchInput {
     readonly cookies?: boolean;
     readonly followRedirects?: boolean;
 }
-interface OpensteerSessionFetchOutput {
-    readonly transport?: TransportKind;
-    readonly attempts: readonly OpensteerReplayAttempt[];
-    readonly response?: OpensteerRequestResponseResult;
-    readonly data?: JsonValue$1 | string;
-    readonly note?: string;
-}
-interface OpensteerCookieQueryInput {
-    readonly domain?: string;
-}
-interface OpensteerCookieQueryOutput {
-    readonly domain?: string;
-    readonly cookies: readonly CookieRecord[];
-}
 type OpensteerStorageArea = "local" | "session";
-interface OpensteerStorageQueryInput {
-    readonly domain?: string;
-}
-interface OpensteerStorageDomainSnapshot {
-    readonly domain: string;
-    readonly localStorage: readonly StorageEntry[];
-    readonly sessionStorage: readonly StorageEntry[];
-}
-interface OpensteerStorageQueryOutput {
-    readonly domains: readonly OpensteerStorageDomainSnapshot[];
-}
 interface OpensteerHiddenField {
     readonly path: string;
     readonly name: string;
@@ -1094,9 +1059,6 @@ interface OpensteerStateDomainSnapshot {
     readonly sessionStorage: readonly StorageEntry[];
     readonly globals?: Readonly<Record<string, JsonValue$1>>;
 }
-interface OpensteerStateQueryInput {
-    readonly domain?: string;
-}
 interface OpensteerStateQueryOutput {
     readonly domains: readonly OpensteerStateDomainSnapshot[];
 }
@@ -1114,14 +1076,6 @@ interface OpensteerBase64RequestBodyInput {
     readonly contentType?: string;
 }
 type OpensteerRequestBodyInput = OpensteerJsonRequestBodyInput | OpensteerTextRequestBodyInput | OpensteerBase64RequestBodyInput;
-interface OpensteerRequestResponseResult {
-    readonly url: string;
-    readonly status: number;
-    readonly statusText: string;
-    readonly headers: readonly HeaderEntry[];
-    readonly body?: BodyPayload;
-    readonly redirected: boolean;
-}
 
 interface OpensteerStateSnapshot {
     readonly id: string;
@@ -1385,6 +1339,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";
@@ -1448,35 +1416,6 @@ interface ArtifactReference {
     readonly kind: OpensteerArtifactKind;
     readonly relation: ArtifactRelation;
 }
-interface OpensteerArtifactReadInput {
-    readonly artifactId: string;
-}
-interface OpensteerArtifactReadOutput {
-    readonly artifact: OpensteerArtifact;
-}
-
-type CaptchaType = "recaptcha-v2" | "hcaptcha" | "turnstile";
-type CaptchaProvider = "2captcha" | "capsolver";
-interface CaptchaDetectionResult {
-    readonly type: CaptchaType;
-    readonly siteKey: string;
-    readonly pageUrl: string;
-}
-interface OpensteerCaptchaSolveInput {
-    readonly provider: CaptchaProvider;
-    readonly apiKey: string;
-    readonly pageRef?: PageRef;
-    readonly timeoutMs?: number;
-    readonly type?: CaptchaType;
-    readonly siteKey?: string;
-    readonly pageUrl?: string;
-}
-interface OpensteerCaptchaSolveOutput {
-    readonly captcha: CaptchaDetectionResult;
-    readonly token: string;
-    readonly injected: boolean;
-    readonly provider: CaptchaProvider;
-}
 
 type TraceOutcome = "ok" | "error";
 interface TraceContext {
@@ -1622,7 +1561,6 @@ interface ObservationSink {
     openSession(input: OpenObservationSessionInput): Promise<SessionObservationSink>;
 }
 
-type OpensteerSnapshotMode = "action" | "extraction";
 interface OpensteerBrowserLaunchOptions {
     readonly headless?: boolean;
     readonly executablePath?: string;
@@ -1690,19 +1628,6 @@ interface OpensteerStealthProfileInput {
     readonly locale?: string;
     readonly timezoneId?: string;
 }
-interface OpensteerTargetByElement {
-    readonly kind: "element";
-    readonly element: number;
-}
-interface OpensteerTargetByPersist {
-    readonly kind: "persist";
-    readonly persist: string;
-}
-interface OpensteerTargetBySelector {
-    readonly kind: "selector";
-    readonly selector: string;
-}
-type OpensteerTargetInput = OpensteerTargetByElement | OpensteerTargetByPersist | OpensteerTargetBySelector;
 interface OpensteerResolvedTarget {
     readonly pageRef: PageRef;
     readonly frameRef: FrameRef;
@@ -1721,24 +1646,6 @@ interface OpensteerActionResult {
         readonly y: number;
     };
 }
-interface OpensteerSnapshotCounter {
-    readonly element: number;
-    readonly pageRef: PageRef;
-    readonly frameRef: FrameRef;
-    readonly documentRef: DocumentRef;
-    readonly documentEpoch: DocumentEpoch;
-    readonly nodeRef?: NodeRef;
-    readonly tagName: string;
-    readonly pathHint: string;
-    readonly text?: string;
-    readonly attributes?: readonly {
-        readonly name: string;
-        readonly value: string;
-    }[];
-    readonly iframeDepth: number;
-    readonly shadowDepth: number;
-    readonly interactive: boolean;
-}
 interface OpensteerSessionState {
     readonly sessionRef: SessionRef;
     readonly pageRef: PageRef;
@@ -1804,66 +1711,6 @@ interface OpensteerAddInitScriptOutput {
     readonly sessionRef: SessionRef;
     readonly pageRef?: PageRef;
 }
-interface OpensteerCaptureScriptsInput {
-    readonly pageRef?: PageRef;
-    readonly includeInline?: boolean;
-    readonly includeExternal?: boolean;
-    readonly includeDynamic?: boolean;
-    readonly includeWorkers?: boolean;
-    readonly urlFilter?: string;
-    readonly persist?: boolean;
-}
-interface OpensteerCapturedScript extends ScriptSourceArtifactData {
-    readonly artifactId?: string;
-}
-interface OpensteerCaptureScriptsOutput {
-    readonly pageRef: PageRef;
-    readonly scripts: readonly OpensteerCapturedScript[];
-}
-interface OpensteerPageSnapshotInput {
-    readonly mode?: OpensteerSnapshotMode;
-}
-interface OpensteerPageSnapshotOutput {
-    readonly url: string;
-    readonly title: string;
-    readonly mode: OpensteerSnapshotMode;
-    readonly html: string;
-    readonly counters: readonly OpensteerSnapshotCounter[];
-}
-interface OpensteerDomClickInput {
-    readonly target: OpensteerTargetInput;
-    readonly button?: OpensteerComputerMouseButton;
-    readonly clickCount?: number;
-    readonly modifiers?: readonly OpensteerComputerKeyModifier[];
-    readonly persist?: string;
-    readonly captureNetwork?: string;
-}
-interface OpensteerDomHoverInput {
-    readonly target: OpensteerTargetInput;
-    readonly persist?: string;
-    readonly captureNetwork?: string;
-}
-interface OpensteerDomInputInput {
-    readonly target: OpensteerTargetInput;
-    readonly text: string;
-    readonly pressEnter?: boolean;
-    readonly persist?: string;
-    readonly captureNetwork?: string;
-}
-interface OpensteerDomScrollInput {
-    readonly target: OpensteerTargetInput;
-    readonly direction: "up" | "down" | "left" | "right";
-    readonly amount: number;
-    readonly persist?: string;
-    readonly captureNetwork?: string;
-}
-interface OpensteerDomExtractInput {
-    readonly persist?: string;
-    readonly schema?: Readonly<Record<string, unknown>>;
-}
-interface OpensteerDomExtractOutput {
-    readonly data: JsonValue$1;
-}
 interface OpensteerSessionCloseOutput {
     readonly closed: true;
 }
@@ -2006,87 +1853,6 @@ interface OpensteerSessionInfo {
     readonly runtime?: OpensteerRuntimeVersionInfo;
 }
 
-interface OpensteerScriptBeautifyInput {
-    readonly artifactId?: string;
-    readonly content?: string;
-    readonly persist?: boolean;
-}
-interface OpensteerScriptBeautifyOutput {
-    readonly content: string;
-    readonly artifactId?: string;
-    readonly bytesBefore: number;
-    readonly bytesAfter: number;
-}
-interface OpensteerScriptDeobfuscateInput {
-    readonly artifactId?: string;
-    readonly content?: string;
-    readonly persist?: boolean;
-}
-interface OpensteerScriptDeobfuscateOutput {
-    readonly content: string;
-    readonly artifactId?: string;
-    readonly transforms: readonly string[];
-    readonly bytesBefore: number;
-    readonly bytesAfter: number;
-}
-type SandboxFidelity = "minimal" | "standard" | "full";
-type SandboxAjaxMode = "passthrough" | "capture" | "mock";
-interface SandboxAjaxRoute {
-    readonly urlPattern: string;
-    readonly mode: SandboxAjaxMode;
-    readonly mockResponse?: {
-        readonly status: number;
-        readonly headers?: Readonly<Record<string, string>>;
-        readonly body?: string;
-    };
-}
-interface OpensteerScriptSandboxInput {
-    readonly artifactId?: string;
-    readonly content?: string;
-    readonly fidelity?: SandboxFidelity;
-    readonly ajaxRoutes?: readonly SandboxAjaxRoute[];
-    readonly cookies?: Readonly<Record<string, string>>;
-    readonly globals?: Readonly<Record<string, unknown>>;
-    readonly timeoutMs?: number;
-    readonly clockMode?: "real" | "manual";
-}
-interface SandboxCapturedAjaxCall {
-    readonly method: string;
-    readonly url: string;
-    readonly headers: Readonly<Record<string, string>>;
-    readonly body?: string;
-    readonly timestamp: number;
-}
-interface OpensteerScriptSandboxOutput {
-    readonly result?: unknown;
-    readonly capturedAjax: readonly SandboxCapturedAjaxCall[];
-    readonly errors: readonly string[];
-    readonly durationMs: number;
-}
-
-type OpensteerInteractionCaptureStep = {
-    readonly kind: "goto";
-    readonly url: string;
-} | {
-    readonly kind: "click";
-    readonly target: OpensteerTargetInput;
-} | {
-    readonly kind: "hover";
-    readonly target: OpensteerTargetInput;
-} | {
-    readonly kind: "input";
-    readonly target: OpensteerTargetInput;
-    readonly text: string;
-    readonly pressEnter?: boolean;
-} | {
-    readonly kind: "scroll";
-    readonly target: OpensteerTargetInput;
-    readonly direction: "up" | "down" | "left" | "right";
-    readonly amount: number;
-} | {
-    readonly kind: "wait";
-    readonly durationMs: number;
-};
 interface OpensteerInteractionEventRecord {
     readonly type: string;
     readonly timestamp: number;
@@ -2107,67 +1873,6 @@ interface OpensteerInteractionTracePayload {
     readonly caseId?: string;
     readonly notes?: string;
 }
-interface OpensteerInteractionTraceRecord {
-    readonly id: string;
-    readonly key: string;
-    readonly version: string;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-    readonly contentHash: string;
-    readonly tags: readonly string[];
-    readonly provenance?: OpensteerRegistryProvenance;
-    readonly payload: OpensteerInteractionTracePayload;
-}
-interface OpensteerInteractionCaptureInput {
-    readonly key?: string;
-    readonly pageRef?: PageRef;
-    readonly durationMs?: number;
-    readonly script?: string;
-    readonly args?: readonly JsonValue$1[];
-    readonly steps?: readonly OpensteerInteractionCaptureStep[];
-    readonly includeStorage?: boolean;
-    readonly includeSessionStorage?: boolean;
-    readonly includeIndexedDb?: boolean;
-    readonly globalNames?: readonly string[];
-    readonly caseId?: string;
-    readonly notes?: string;
-    readonly tags?: readonly string[];
-}
-interface OpensteerInteractionCaptureOutput {
-    readonly trace: OpensteerInteractionTraceRecord;
-}
-interface OpensteerInteractionGetInput {
-    readonly traceId: string;
-}
-interface OpensteerInteractionGetOutput {
-    readonly trace: OpensteerInteractionTraceRecord;
-}
-interface OpensteerInteractionDiffInput {
-    readonly leftTraceId: string;
-    readonly rightTraceId: string;
-}
-interface OpensteerInteractionDiffOutput {
-    readonly summary: {
-        readonly eventCountDelta: number;
-        readonly propertyMismatchCount: number;
-        readonly stateMismatchCount: number;
-        readonly downstreamRequestMismatchCount: number;
-    };
-    readonly eventSequenceMismatches: readonly string[];
-    readonly eventPropertyMismatches: readonly string[];
-    readonly stateMismatches: readonly string[];
-    readonly downstreamRequestMismatches: readonly string[];
-}
-interface OpensteerInteractionReplayInput {
-    readonly traceId: string;
-    readonly pageRef?: PageRef;
-}
-interface OpensteerInteractionReplayOutput {
-    readonly traceId: string;
-    readonly replayedEventCount: number;
-    readonly success: boolean;
-    readonly error?: string;
-}
 
 type MatchOperator = "exact" | "startsWith" | "contains";
 interface AttributeMatchClause {
@@ -2180,7 +1885,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;
@@ -2237,11 +1946,15 @@ 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: {
@@ -2745,6 +2458,7 @@ interface ResolvedDomTarget {
 }
 interface DomBuildPathInput {
     readonly locator: NodeLocator;
+    readonly enableTextMatch?: boolean;
 }
 interface DomResolveTargetInput {
     readonly pageRef: PageRef;
@@ -2942,7 +2656,7 @@ interface OpensteerExtractionDescriptorPayload {
     readonly kind: "dom-extraction";
     readonly persist: string;
     readonly root: PersistedOpensteerExtractionPayload;
-    readonly schemaHash?: string;
+    readonly templateHash?: string;
     readonly sourceUrl?: string;
 }
 interface OpensteerExtractionDescriptorRecord {
@@ -2960,7 +2674,7 @@ interface OpensteerExtractionDescriptorStore {
     write(input: {
         readonly persist: string;
         readonly root: PersistedOpensteerExtractionPayload;
-        readonly schemaHash?: string;
+        readonly templateHash?: string;
         readonly sourceUrl?: string;
         readonly createdAt?: number;
         readonly updatedAt?: number;
@@ -3189,12 +2903,6 @@ interface OpensteerSessionRuntimeOptions {
     readonly observationSessionId?: string;
     readonly observationSink?: ObservationSink;
 }
-declare class OpensteerRuntime extends OpensteerSessionRuntime$1 {
-    constructor(options?: OpensteerRuntimeOptions);
-}
-declare class OpensteerSessionRuntime extends OpensteerSessionRuntime$1 {
-    constructor(options: OpensteerSessionRuntimeOptions);
-}
 
 interface OpensteerTargetOptions {
     readonly element?: number;
@@ -3215,13 +2923,9 @@ interface OpensteerScrollOptions extends OpensteerTargetOptions {
     readonly direction: "up" | "down" | "left" | "right";
     readonly amount: number;
 }
-type OpensteerExtractOptions = {
+interface OpensteerExtractOptions {
     readonly persist: string;
-    readonly schema?: Record<string, unknown>;
-} | {
-    readonly persist?: string;
-    readonly schema: Record<string, unknown>;
-};
+}
 interface OpensteerWaitForPageOptions {
     readonly openerPageRef?: string;
     readonly urlIncludes?: string;
@@ -3293,7 +2997,6 @@ declare class Opensteer {
     scroll(input: OpensteerScrollOptions): Promise<OpensteerActionResult>;
     extract(input: OpensteerExtractOptions): Promise<unknown>;
     waitForPage(input?: OpensteerWaitForPageOptions): Promise<OpensteerPageListOutput["pages"][number]>;
-    snapshot(mode?: OpensteerSnapshotMode): Promise<string>;
     cookies(domain?: string): Promise<OpensteerCookieJar>;
     storage(domain?: string, type?: OpensteerStorageArea): Promise<OpensteerStorageMap>;
     state(domain?: string): Promise<OpensteerBrowserState>;
@@ -3317,50 +3020,6 @@ declare function resolveCloudConfig(input?: {
     readonly environment?: OpensteerEnvironment;
 }): OpensteerCloudConfig | undefined;
 
-interface OpensteerRuntimeOperationOptions {
-    readonly signal?: AbortSignal;
-    readonly timeoutMs?: number;
-}
-interface OpensteerSemanticRuntime {
-    info(options?: OpensteerRuntimeOperationOptions): Promise<OpensteerSessionInfo>;
-    open(input?: OpensteerOpenInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerOpenOutput>;
-    listPages(input?: OpensteerPageListInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageListOutput>;
-    newPage(input?: OpensteerPageNewInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageNewOutput>;
-    activatePage(input: OpensteerPageActivateInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageActivateOutput>;
-    closePage(input?: OpensteerPageCloseInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageCloseOutput>;
-    goto(input: OpensteerPageGotoInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageGotoOutput>;
-    evaluate(input: OpensteerPageEvaluateInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageEvaluateOutput>;
-    addInitScript(input: OpensteerAddInitScriptInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerAddInitScriptOutput>;
-    snapshot(input?: OpensteerPageSnapshotInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerPageSnapshotOutput>;
-    click(input: OpensteerDomClickInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerActionResult>;
-    hover(input: OpensteerDomHoverInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerActionResult>;
-    input(input: OpensteerDomInputInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerActionResult>;
-    scroll(input: OpensteerDomScrollInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerActionResult>;
-    extract(input: OpensteerDomExtractInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerDomExtractOutput>;
-    queryNetwork(input?: OpensteerNetworkQueryInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkQueryOutput>;
-    getNetworkDetail(input: OpensteerNetworkDetailInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerNetworkDetailOutput>;
-    captureInteraction(input: OpensteerInteractionCaptureInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerInteractionCaptureOutput>;
-    getInteraction(input: OpensteerInteractionGetInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerInteractionGetOutput>;
-    diffInteraction(input: OpensteerInteractionDiffInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerInteractionDiffOutput>;
-    replayInteraction(input: OpensteerInteractionReplayInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerInteractionReplayOutput>;
-    captureScripts(input?: OpensteerCaptureScriptsInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerCaptureScriptsOutput>;
-    readArtifact(input: OpensteerArtifactReadInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerArtifactReadOutput>;
-    beautifyScript(input: OpensteerScriptBeautifyInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerScriptBeautifyOutput>;
-    deobfuscateScript(input: OpensteerScriptDeobfuscateInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerScriptDeobfuscateOutput>;
-    sandboxScript(input: OpensteerScriptSandboxInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerScriptSandboxOutput>;
-    solveCaptcha(input: OpensteerCaptchaSolveInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerCaptchaSolveOutput>;
-    getCookies(input?: OpensteerCookieQueryInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerCookieQueryOutput>;
-    getStorageSnapshot(input?: OpensteerStorageQueryInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerStorageQueryOutput>;
-    getBrowserState(input?: OpensteerStateQueryInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerStateQueryOutput>;
-    fetch(input: OpensteerSessionFetchInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerSessionFetchOutput>;
-    computerExecute(input: OpensteerComputerExecuteInput, options?: OpensteerRuntimeOperationOptions): Promise<OpensteerComputerExecuteOutput>;
-    close(options?: OpensteerRuntimeOperationOptions): Promise<OpensteerSessionCloseOutput>;
-}
-
-interface OpensteerDisconnectableRuntime extends OpensteerSemanticRuntime {
-    disconnect(): Promise<void>;
-}
-
 interface OpensteerResolvedRuntimeConfig {
     readonly provider: OpensteerResolvedProvider;
     readonly cloud?: OpensteerCloudConfig;
@@ -3369,12 +3028,6 @@ declare function resolveOpensteerRuntimeConfig(input?: {
     readonly provider?: OpensteerProviderOptions;
     readonly environment?: OpensteerEnvironment;
 }): OpensteerResolvedRuntimeConfig;
-declare function createOpensteerSemanticRuntime(input?: {
-    readonly runtimeOptions?: OpensteerRuntimeOptions;
-    readonly engine?: OpensteerEngineName;
-    readonly provider?: OpensteerProviderOptions;
-    readonly environment?: OpensteerEnvironment;
-}): OpensteerDisconnectableRuntime;
 
 type BrowserBrandId = "chrome" | "chrome-canary" | "chromium" | "brave" | "edge" | "vivaldi" | "helium";
 
@@ -3405,6 +3058,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;
@@ -3478,88 +3137,6 @@ declare function readPersistedLocalBrowserSessionRecord(rootPath: string): Promi
 declare function writePersistedSessionRecord(rootPath: string, record: PersistedSessionRecord): Promise<void>;
 declare function clearPersistedSessionRecord(rootPath: string, provider: OpensteerLiveSessionProvider): Promise<void>;
 
-interface CloudSessionProxyOptions {
-    readonly rootDir?: string;
-    readonly rootPath?: string;
-    readonly workspace?: string;
-    readonly policy?: OpensteerPolicy;
-    readonly cleanupRootOnClose?: boolean;
-    readonly observability?: Partial<ObservabilityConfig>;
-}
-
-declare class CloudSessionProxy implements OpensteerDisconnectableRuntime {
-    readonly rootPath: string;
-    readonly workspace: string | undefined;
-    private readonly cleanupRootOnClose;
-    private readonly cloud;
-    private readonly observability;
-    private readonly policy;
-    private sessionId;
-    private semanticGrant;
-    private client;
-    private automation;
-    private workspaceStore;
-    private syncWorkspaceOnClose;
-    constructor(cloud: OpensteerCloudClient, options?: CloudSessionProxyOptions);
-    open(input?: OpensteerOpenInput): Promise<OpensteerOpenOutput>;
-    info(): Promise<OpensteerSessionInfo>;
-    listPages(input?: OpensteerPageListInput): Promise<OpensteerPageListOutput>;
-    newPage(input?: OpensteerPageNewInput): Promise<OpensteerPageNewOutput>;
-    activatePage(input: OpensteerPageActivateInput): Promise<OpensteerPageActivateOutput>;
-    closePage(input?: OpensteerPageCloseInput): Promise<OpensteerPageCloseOutput>;
-    goto(input: OpensteerPageGotoInput): Promise<OpensteerPageGotoOutput>;
-    evaluate(input: OpensteerPageEvaluateInput): Promise<OpensteerPageEvaluateOutput>;
-    addInitScript(input: OpensteerAddInitScriptInput): Promise<OpensteerAddInitScriptOutput>;
-    snapshot(input?: OpensteerPageSnapshotInput): Promise<OpensteerPageSnapshotOutput>;
-    click(input: OpensteerDomClickInput): Promise<OpensteerActionResult>;
-    hover(input: OpensteerDomHoverInput): Promise<OpensteerActionResult>;
-    input(input: OpensteerDomInputInput): Promise<OpensteerActionResult>;
-    scroll(input: OpensteerDomScrollInput): Promise<OpensteerActionResult>;
-    extract(input: OpensteerDomExtractInput): Promise<OpensteerDomExtractOutput>;
-    queryNetwork(input?: OpensteerNetworkQueryInput): Promise<OpensteerNetworkQueryOutput>;
-    getNetworkDetail(input: OpensteerNetworkDetailInput): Promise<OpensteerNetworkDetailOutput>;
-    captureInteraction(input: OpensteerInteractionCaptureInput): Promise<OpensteerInteractionCaptureOutput>;
-    getInteraction(input: OpensteerInteractionGetInput): Promise<OpensteerInteractionGetOutput>;
-    diffInteraction(input: OpensteerInteractionDiffInput): Promise<OpensteerInteractionDiffOutput>;
-    replayInteraction(input: OpensteerInteractionReplayInput): Promise<OpensteerInteractionReplayOutput>;
-    captureScripts(input?: OpensteerCaptureScriptsInput): Promise<OpensteerCaptureScriptsOutput>;
-    readArtifact(input: OpensteerArtifactReadInput): Promise<OpensteerArtifactReadOutput>;
-    beautifyScript(input: OpensteerScriptBeautifyInput): Promise<OpensteerScriptBeautifyOutput>;
-    deobfuscateScript(input: OpensteerScriptDeobfuscateInput): Promise<OpensteerScriptDeobfuscateOutput>;
-    sandboxScript(input: OpensteerScriptSandboxInput): Promise<OpensteerScriptSandboxOutput>;
-    solveCaptcha(input: OpensteerCaptchaSolveInput): Promise<OpensteerCaptchaSolveOutput>;
-    getCookies(input?: OpensteerCookieQueryInput): Promise<OpensteerCookieQueryOutput>;
-    route(input: OpensteerRouteOptions): Promise<OpensteerRouteRegistration>;
-    interceptScript(input: OpensteerInterceptScriptOptions): Promise<OpensteerRouteRegistration>;
-    getStorageSnapshot(input?: OpensteerStorageQueryInput): Promise<OpensteerStorageQueryOutput>;
-    getBrowserState(input?: OpensteerStateQueryInput): Promise<OpensteerStateQueryOutput>;
-    fetch(input: OpensteerSessionFetchInput): Promise<OpensteerSessionFetchOutput>;
-    computerExecute(input: OpensteerComputerExecuteInput): Promise<OpensteerComputerExecuteOutput>;
-    close(): Promise<OpensteerSessionCloseOutput>;
-    disconnect(): Promise<void>;
-    private ensureSession;
-    private syncWorkspaceToCloud;
-    private bindClient;
-    private ensureWorkspaceStore;
-    private loadPersistedSession;
-    private writePersistedSession;
-    private clearPersistedSession;
-    private isReusableCloudSession;
-    private requireClient;
-    private requireAutomation;
-    private ensureSemanticGrant;
-    private handleSemanticClientError;
-    private invokeSemanticOperation;
-    private invokeAutomationOperation;
-    private runOperationWithPolicy;
-    private shouldUseLocalCloudTransport;
-}
-
-declare function dispatchSemanticOperation(runtime: OpensteerSemanticRuntime, operation: OpensteerSemanticOperationName, input: unknown, options?: {
-    readonly signal?: AbortSignal;
-    readonly timeoutMs?: number;
-}): Promise<unknown>;
-
 interface LocalChromeProfileDescriptor {
     readonly directory: string;
     readonly name: string;
@@ -3595,4 +3172,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, 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 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 OpensteerDisconnectableRuntime, 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, OpensteerRuntime, type OpensteerRuntimeOptions, type OpensteerScrollOptions, type OpensteerSemanticRuntime, OpensteerSessionRuntime, 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, createOpensteerSemanticRuntime, defaultFallbackPolicy, defaultPolicy, defaultRetryPolicy, defaultSettlePolicy, defaultTimeoutPolicy, delayWithSignal, discoverLocalCdpBrowsers, dispatchSemanticOperation, 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 };