opensteer 0.4.5 → 0.4.7

package/dist/index.d.cts

@@ -122,17 +122,21 @@ interface OpensteerBrowserConfig {
 interface OpensteerStorageConfig {
     rootDir?: string;
 }
-type OpensteerMode = 'local' | 'remote';
-interface OpensteerRemoteOptions {
+type OpensteerAuthScheme = 'api-key' | 'bearer';
+type OpensteerCloudAnnouncePolicy = 'always' | 'off' | 'tty';
+interface OpensteerCloudOptions {
     apiKey?: string;
     baseUrl?: string;
+    appUrl?: string;
+    authScheme?: OpensteerAuthScheme;
+    announce?: OpensteerCloudAnnouncePolicy;
 }
+type OpensteerCloudConfig = boolean | OpensteerCloudOptions;
 interface OpensteerConfig {
     name?: string;
     browser?: OpensteerBrowserConfig;
     storage?: OpensteerStorageConfig;
-    mode?: OpensteerMode;
-    remote?: OpensteerRemoteOptions;
+    cloud?: OpensteerCloudConfig;
     model?: string;
     debug?: boolean;
 }
@@ -303,7 +307,7 @@ declare class Opensteer {
     private readonly namespace;
     private readonly storage;
     private readonly pool;
-    private readonly remote;
+    private readonly cloud;
     private browser;
     private pageRef;
     private contextRef;
@@ -312,16 +316,19 @@ declare class Opensteer {
     constructor(config?: OpensteerConfig);
     private createLazyResolveCallback;
     private createLazyExtractCallback;
-    private invokeRemoteActionAndResetCache;
-    private invokeRemoteAction;
+    private invokeCloudActionAndResetCache;
+    private invokeCloudAction;
     private buildActionError;
     get page(): Page;
     get context(): BrowserContext;
-    getRemoteSessionId(): string | null;
+    getCloudSessionId(): string | null;
+    getCloudSessionUrl(): string | null;
+    private announceCloudSession;
+    private shouldAnnounceCloudSession;
     launch(options?: LaunchOptions): Promise<void>;
     static from(page: Page, config?: OpensteerConfig): Opensteer;
     close(): Promise<void>;
-    private syncLocalSelectorCacheToRemote;
+    private syncLocalSelectorCacheToCloud;
     goto(url: string, options?: GotoOptions): Promise<void>;
     snapshot(options?: SnapshotOptions): Promise<string>;
     state(): Promise<StateResult>;
@@ -604,22 +611,40 @@ interface AiModelConfig {
     maxTokens?: number | null;
 }
 
-type RemoteActionMethod = 'goto' | 'snapshot' | 'state' | 'click' | 'dblclick' | 'rightclick' | 'hover' | 'input' | 'select' | 'scroll' | 'tabs' | 'newTab' | 'switchTab' | 'closeTab' | 'getCookies' | 'setCookie' | 'clearCookies' | 'pressKey' | 'type' | 'getElementText' | 'getElementValue' | 'getElementAttributes' | 'getElementBoundingBox' | 'getHtml' | 'getTitle' | 'waitForText' | 'extract' | 'extractFromPlan' | 'clearCache' | 'uploadFile' | 'exportCookies' | 'importCookies' | 'screenshot';
-type RemoteErrorCode = 'REMOTE_AUTH_FAILED' | 'REMOTE_SESSION_NOT_FOUND' | 'REMOTE_SESSION_CLOSED' | 'REMOTE_UNSUPPORTED_METHOD' | 'REMOTE_INVALID_REQUEST' | 'REMOTE_MODEL_NOT_ALLOWED' | 'REMOTE_ACTION_FAILED' | 'REMOTE_CAPACITY_EXHAUSTED' | 'REMOTE_RUNTIME_UNAVAILABLE' | 'REMOTE_RUNTIME_MISMATCH' | 'REMOTE_SESSION_STALE' | 'REMOTE_CONTROL_PLANE_ERROR' | 'REMOTE_INTERNAL';
-interface RemoteSessionCreateRequest {
+type CloudActionMethod = 'goto' | 'snapshot' | 'state' | 'click' | 'dblclick' | 'rightclick' | 'hover' | 'input' | 'select' | 'scroll' | 'tabs' | 'newTab' | 'switchTab' | 'closeTab' | 'getCookies' | 'setCookie' | 'clearCookies' | 'pressKey' | 'type' | 'getElementText' | 'getElementValue' | 'getElementAttributes' | 'getElementBoundingBox' | 'getHtml' | 'getTitle' | 'waitForText' | 'extract' | 'extractFromPlan' | 'clearCache' | 'uploadFile' | 'exportCookies' | 'importCookies' | 'screenshot';
+type CloudErrorCode = 'CLOUD_AUTH_FAILED' | 'CLOUD_SESSION_NOT_FOUND' | 'CLOUD_SESSION_CLOSED' | 'CLOUD_UNSUPPORTED_METHOD' | 'CLOUD_INVALID_REQUEST' | 'CLOUD_MODEL_NOT_ALLOWED' | 'CLOUD_ACTION_FAILED' | 'CLOUD_CAPACITY_EXHAUSTED' | 'CLOUD_RUNTIME_UNAVAILABLE' | 'CLOUD_RUNTIME_MISMATCH' | 'CLOUD_SESSION_STALE' | 'CLOUD_CONTROL_PLANE_ERROR' | 'CLOUD_CONTRACT_MISMATCH' | 'CLOUD_INTERNAL';
+declare const cloudSessionContractVersion: "v3";
+type CloudSessionContractVersion = typeof cloudSessionContractVersion;
+type CloudSessionSourceType = 'agent-thread' | 'agent-run' | 'local-cloud' | 'manual';
+interface CloudSessionCreateRequest {
+    cloudSessionContractVersion: CloudSessionContractVersion;
+    sourceType: 'local-cloud';
+    clientSessionHint: string;
+    localRunId: string;
     name?: string;
     model?: string;
     launchContext?: Record<string, unknown>;
 }
-interface RemoteSessionCreateResponse {
+interface CloudSessionSummary {
+    sessionId: string;
+    workspaceId: string;
+    state: string;
+    createdAt: number;
+    sourceType: CloudSessionSourceType;
+    sourceRef?: string;
+    label?: string;
+}
+interface CloudSessionCreateResponse {
     sessionId: string;
     actionWsUrl: string;
     cdpWsUrl: string;
     actionToken: string;
     cdpToken: string;
     expiresAt?: number;
+    cloudSessionUrl: string;
+    cloudSession: CloudSessionSummary;
 }
-interface RemoteSelectorCacheImportEntry {
+interface CloudSelectorCacheImportEntry {
     namespace: string;
     siteOrigin: string;
     method: string;
@@ -629,56 +654,58 @@ interface RemoteSelectorCacheImportEntry {
     createdAt: number;
     updatedAt: number;
 }
-interface RemoteSelectorCacheImportRequest {
-    entries: RemoteSelectorCacheImportEntry[];
+interface CloudSelectorCacheImportRequest {
+    entries: CloudSelectorCacheImportEntry[];
 }
-interface RemoteSelectorCacheImportResponse {
+interface CloudSelectorCacheImportResponse {
     imported: number;
     inserted: number;
     updated: number;
     skipped: number;
 }
-interface RemoteActionRequest {
+interface CloudActionRequest {
     id: number;
-    method: RemoteActionMethod;
+    method: CloudActionMethod;
     args: Record<string, unknown>;
     sessionId: string;
     token: string;
 }
-interface RemoteActionSuccess {
+interface CloudActionSuccess {
     id: number;
     ok: true;
     result: unknown;
 }
-interface RemoteActionFailure {
+interface CloudActionFailure {
     id: number;
     ok: false;
     error: string;
-    code: RemoteErrorCode;
-    details?: RemoteActionFailureDetails;
+    code: CloudErrorCode;
+    details?: CloudActionFailureDetails;
 }
-type RemoteActionResponse = RemoteActionSuccess | RemoteActionFailure;
-interface RemoteActionFailureDetails {
+type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
+interface CloudActionFailureDetails {
     actionFailure?: ActionFailure;
 }
 
-declare class OpensteerRemoteError extends Error {
-    readonly code: RemoteErrorCode | 'REMOTE_TRANSPORT_ERROR';
+declare class OpensteerCloudError extends Error {
+    readonly code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR';
     readonly status?: number;
-    readonly details?: RemoteActionFailureDetails | Record<string, unknown>;
-    constructor(code: RemoteErrorCode | 'REMOTE_TRANSPORT_ERROR', message: string, status?: number, details?: RemoteActionFailureDetails | Record<string, unknown>);
+    readonly details?: CloudActionFailureDetails | Record<string, unknown>;
+    constructor(code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR', message: string, status?: number, details?: CloudActionFailureDetails | Record<string, unknown>);
 }
-declare function remoteUnsupportedMethodError(method: string, message?: string): OpensteerRemoteError;
-declare function remoteNotLaunchedError(): OpensteerRemoteError;
+declare function cloudUnsupportedMethodError(method: string, message?: string): OpensteerCloudError;
+declare function cloudNotLaunchedError(): OpensteerCloudError;
 
-declare class RemoteSessionClient {
+declare class CloudSessionClient {
     private readonly baseUrl;
     private readonly key;
-    constructor(baseUrl: string, key: string);
-    create(request: RemoteSessionCreateRequest): Promise<RemoteSessionCreateResponse>;
+    private readonly authScheme;
+    constructor(baseUrl: string, key: string, authScheme?: OpensteerAuthScheme);
+    create(request: CloudSessionCreateRequest): Promise<CloudSessionCreateResponse>;
     close(sessionId: string): Promise<void>;
-    importSelectorCache(request: RemoteSelectorCacheImportRequest): Promise<RemoteSelectorCacheImportResponse>;
+    importSelectorCache(request: CloudSelectorCacheImportRequest): Promise<CloudSelectorCacheImportResponse>;
     private importSelectorCacheBatch;
+    private authHeaders;
 }
 
 interface ActionWsClientOptions {
@@ -695,25 +722,25 @@ declare class ActionWsClient {
     private closed;
     private constructor();
     static connect(options: ActionWsClientOptions): Promise<ActionWsClient>;
-    request<T>(method: RemoteActionMethod, args: Record<string, unknown>): Promise<T>;
+    request<T>(method: CloudActionMethod, args: Record<string, unknown>): Promise<T>;
     close(): Promise<void>;
     private handleMessage;
     private rejectAll;
 }
 
-interface RemoteCdpConnectArgs {
+interface CloudCdpConnectArgs {
     wsUrl: string;
     token: string;
 }
-interface RemoteCdpConnection {
+interface CloudCdpConnection {
     browser: Browser;
     context: BrowserContext;
     page: Page;
 }
-declare class RemoteCdpClient {
-    connect(args: RemoteCdpConnectArgs): Promise<RemoteCdpConnection>;
+declare class CloudCdpClient {
+    connect(args: CloudCdpConnectArgs): Promise<CloudCdpConnection>;
 }
 
-declare function collectLocalSelectorCacheEntries(storage: LocalSelectorStorage): RemoteSelectorCacheImportEntry[];
+declare function collectLocalSelectorCacheEntries(storage: LocalSelectorStorage): CloudSelectorCacheImportEntry[];
 
-export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type ContextHop, type CookieParam, type CounterBinding, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type CounterSnapshotLike, type DomPath, type ElementPath, ElementPathError, type ElementPathErrorCode, type ExtractFromPlanOptions, type ExtractOptions, type ExtractSchema, type ExtractSchemaField, type ExtractSchemaValue, type ExtractionFieldPlan, type ExtractionPlan, type ExtractionRunResult, type FieldSelector, type FileUploadOptions, type GotoOptions, type HoverOptions, type InputOptions, type LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, type MatchClause, type MatchOperator, OPENSTEER_HIDDEN_ATTR, OPENSTEER_INTERACTIVE_ATTR, OPENSTEER_SCROLLABLE_ATTR, OS_BOUNDARY_ATTR, OS_IFRAME_BOUNDARY_TAG, OS_NODE_ID_ATTR, OS_SHADOW_BOUNDARY_TAG, OS_UNAVAILABLE_ATTR, Opensteer, OpensteerActionError, type OpensteerBrowserConfig, type OpensteerConfig, type OpensteerMode, OpensteerRemoteError, type OpensteerRemoteOptions, type OpensteerStorageConfig, type PathNode, type PathNodePosition, type PositionMatchClause, type PreparedSnapshot, type RegistryEntry, type RemoteActionFailure, type RemoteActionFailureDetails, type RemoteActionMethod, type RemoteActionRequest, type RemoteActionResponse, type RemoteActionSuccess, RemoteCdpClient, type RemoteCdpConnectArgs, type RemoteCdpConnection, type RemoteErrorCode, type RemoteSelectorCacheImportEntry, type RemoteSelectorCacheImportRequest, type RemoteSelectorCacheImportResponse, RemoteSessionClient, type RemoteSessionCreateRequest, type RemoteSessionCreateResponse, type ResolvedElementPath, type ScreenshotOptions, type ScrollOptions, type SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, type SnapshotMode, type SnapshotOptions, type StateResult, type TabInfo, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, ensureLiveCounters, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, remoteNotLaunchedError, remoteUnsupportedMethodError, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };
+export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type CloudActionFailure, type CloudActionFailureDetails, type CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionContractVersion, type CloudSessionCreateRequest, type CloudSessionCreateResponse, type CloudSessionSourceType, type CloudSessionSummary, type ContextHop, type CookieParam, type CounterBinding, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type CounterSnapshotLike, type DomPath, type ElementPath, ElementPathError, type ElementPathErrorCode, type ExtractFromPlanOptions, type ExtractOptions, type ExtractSchema, type ExtractSchemaField, type ExtractSchemaValue, type ExtractionFieldPlan, type ExtractionPlan, type ExtractionRunResult, type FieldSelector, type FileUploadOptions, type GotoOptions, type HoverOptions, type InputOptions, type LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, type MatchClause, type MatchOperator, OPENSTEER_HIDDEN_ATTR, OPENSTEER_INTERACTIVE_ATTR, OPENSTEER_SCROLLABLE_ATTR, OS_BOUNDARY_ATTR, OS_IFRAME_BOUNDARY_TAG, OS_NODE_ID_ATTR, OS_SHADOW_BOUNDARY_TAG, OS_UNAVAILABLE_ATTR, Opensteer, OpensteerActionError, type OpensteerAuthScheme, type OpensteerBrowserConfig, type OpensteerCloudAnnouncePolicy, type OpensteerCloudConfig, OpensteerCloudError, type OpensteerCloudOptions, type OpensteerConfig, type OpensteerStorageConfig, type PathNode, type PathNodePosition, type PositionMatchClause, type PreparedSnapshot, type RegistryEntry, type ResolvedElementPath, type ScreenshotOptions, type ScrollOptions, type SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, type SnapshotMode, type SnapshotOptions, type StateResult, type TabInfo, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, cloudNotLaunchedError, cloudSessionContractVersion, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, ensureLiveCounters, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };

package/dist/index.d.ts

@@ -122,17 +122,21 @@ interface OpensteerBrowserConfig {
 interface OpensteerStorageConfig {
     rootDir?: string;
 }
-type OpensteerMode = 'local' | 'remote';
-interface OpensteerRemoteOptions {
+type OpensteerAuthScheme = 'api-key' | 'bearer';
+type OpensteerCloudAnnouncePolicy = 'always' | 'off' | 'tty';
+interface OpensteerCloudOptions {
     apiKey?: string;
     baseUrl?: string;
+    appUrl?: string;
+    authScheme?: OpensteerAuthScheme;
+    announce?: OpensteerCloudAnnouncePolicy;
 }
+type OpensteerCloudConfig = boolean | OpensteerCloudOptions;
 interface OpensteerConfig {
     name?: string;
     browser?: OpensteerBrowserConfig;
     storage?: OpensteerStorageConfig;
-    mode?: OpensteerMode;
-    remote?: OpensteerRemoteOptions;
+    cloud?: OpensteerCloudConfig;
     model?: string;
     debug?: boolean;
 }
@@ -303,7 +307,7 @@ declare class Opensteer {
     private readonly namespace;
     private readonly storage;
     private readonly pool;
-    private readonly remote;
+    private readonly cloud;
     private browser;
     private pageRef;
     private contextRef;
@@ -312,16 +316,19 @@ declare class Opensteer {
     constructor(config?: OpensteerConfig);
     private createLazyResolveCallback;
     private createLazyExtractCallback;
-    private invokeRemoteActionAndResetCache;
-    private invokeRemoteAction;
+    private invokeCloudActionAndResetCache;
+    private invokeCloudAction;
     private buildActionError;
     get page(): Page;
     get context(): BrowserContext;
-    getRemoteSessionId(): string | null;
+    getCloudSessionId(): string | null;
+    getCloudSessionUrl(): string | null;
+    private announceCloudSession;
+    private shouldAnnounceCloudSession;
     launch(options?: LaunchOptions): Promise<void>;
     static from(page: Page, config?: OpensteerConfig): Opensteer;
     close(): Promise<void>;
-    private syncLocalSelectorCacheToRemote;
+    private syncLocalSelectorCacheToCloud;
     goto(url: string, options?: GotoOptions): Promise<void>;
     snapshot(options?: SnapshotOptions): Promise<string>;
     state(): Promise<StateResult>;
@@ -604,22 +611,40 @@ interface AiModelConfig {
     maxTokens?: number | null;
 }
 
-type RemoteActionMethod = 'goto' | 'snapshot' | 'state' | 'click' | 'dblclick' | 'rightclick' | 'hover' | 'input' | 'select' | 'scroll' | 'tabs' | 'newTab' | 'switchTab' | 'closeTab' | 'getCookies' | 'setCookie' | 'clearCookies' | 'pressKey' | 'type' | 'getElementText' | 'getElementValue' | 'getElementAttributes' | 'getElementBoundingBox' | 'getHtml' | 'getTitle' | 'waitForText' | 'extract' | 'extractFromPlan' | 'clearCache' | 'uploadFile' | 'exportCookies' | 'importCookies' | 'screenshot';
-type RemoteErrorCode = 'REMOTE_AUTH_FAILED' | 'REMOTE_SESSION_NOT_FOUND' | 'REMOTE_SESSION_CLOSED' | 'REMOTE_UNSUPPORTED_METHOD' | 'REMOTE_INVALID_REQUEST' | 'REMOTE_MODEL_NOT_ALLOWED' | 'REMOTE_ACTION_FAILED' | 'REMOTE_CAPACITY_EXHAUSTED' | 'REMOTE_RUNTIME_UNAVAILABLE' | 'REMOTE_RUNTIME_MISMATCH' | 'REMOTE_SESSION_STALE' | 'REMOTE_CONTROL_PLANE_ERROR' | 'REMOTE_INTERNAL';
-interface RemoteSessionCreateRequest {
+type CloudActionMethod = 'goto' | 'snapshot' | 'state' | 'click' | 'dblclick' | 'rightclick' | 'hover' | 'input' | 'select' | 'scroll' | 'tabs' | 'newTab' | 'switchTab' | 'closeTab' | 'getCookies' | 'setCookie' | 'clearCookies' | 'pressKey' | 'type' | 'getElementText' | 'getElementValue' | 'getElementAttributes' | 'getElementBoundingBox' | 'getHtml' | 'getTitle' | 'waitForText' | 'extract' | 'extractFromPlan' | 'clearCache' | 'uploadFile' | 'exportCookies' | 'importCookies' | 'screenshot';
+type CloudErrorCode = 'CLOUD_AUTH_FAILED' | 'CLOUD_SESSION_NOT_FOUND' | 'CLOUD_SESSION_CLOSED' | 'CLOUD_UNSUPPORTED_METHOD' | 'CLOUD_INVALID_REQUEST' | 'CLOUD_MODEL_NOT_ALLOWED' | 'CLOUD_ACTION_FAILED' | 'CLOUD_CAPACITY_EXHAUSTED' | 'CLOUD_RUNTIME_UNAVAILABLE' | 'CLOUD_RUNTIME_MISMATCH' | 'CLOUD_SESSION_STALE' | 'CLOUD_CONTROL_PLANE_ERROR' | 'CLOUD_CONTRACT_MISMATCH' | 'CLOUD_INTERNAL';
+declare const cloudSessionContractVersion: "v3";
+type CloudSessionContractVersion = typeof cloudSessionContractVersion;
+type CloudSessionSourceType = 'agent-thread' | 'agent-run' | 'local-cloud' | 'manual';
+interface CloudSessionCreateRequest {
+    cloudSessionContractVersion: CloudSessionContractVersion;
+    sourceType: 'local-cloud';
+    clientSessionHint: string;
+    localRunId: string;
     name?: string;
     model?: string;
     launchContext?: Record<string, unknown>;
 }
-interface RemoteSessionCreateResponse {
+interface CloudSessionSummary {
+    sessionId: string;
+    workspaceId: string;
+    state: string;
+    createdAt: number;
+    sourceType: CloudSessionSourceType;
+    sourceRef?: string;
+    label?: string;
+}
+interface CloudSessionCreateResponse {
     sessionId: string;
     actionWsUrl: string;
     cdpWsUrl: string;
     actionToken: string;
     cdpToken: string;
     expiresAt?: number;
+    cloudSessionUrl: string;
+    cloudSession: CloudSessionSummary;
 }
-interface RemoteSelectorCacheImportEntry {
+interface CloudSelectorCacheImportEntry {
     namespace: string;
     siteOrigin: string;
     method: string;
@@ -629,56 +654,58 @@ interface RemoteSelectorCacheImportEntry {
     createdAt: number;
     updatedAt: number;
 }
-interface RemoteSelectorCacheImportRequest {
-    entries: RemoteSelectorCacheImportEntry[];
+interface CloudSelectorCacheImportRequest {
+    entries: CloudSelectorCacheImportEntry[];
 }
-interface RemoteSelectorCacheImportResponse {
+interface CloudSelectorCacheImportResponse {
     imported: number;
     inserted: number;
     updated: number;
     skipped: number;
 }
-interface RemoteActionRequest {
+interface CloudActionRequest {
     id: number;
-    method: RemoteActionMethod;
+    method: CloudActionMethod;
     args: Record<string, unknown>;
     sessionId: string;
     token: string;
 }
-interface RemoteActionSuccess {
+interface CloudActionSuccess {
     id: number;
     ok: true;
     result: unknown;
 }
-interface RemoteActionFailure {
+interface CloudActionFailure {
     id: number;
     ok: false;
     error: string;
-    code: RemoteErrorCode;
-    details?: RemoteActionFailureDetails;
+    code: CloudErrorCode;
+    details?: CloudActionFailureDetails;
 }
-type RemoteActionResponse = RemoteActionSuccess | RemoteActionFailure;
-interface RemoteActionFailureDetails {
+type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
+interface CloudActionFailureDetails {
     actionFailure?: ActionFailure;
 }
 
-declare class OpensteerRemoteError extends Error {
-    readonly code: RemoteErrorCode | 'REMOTE_TRANSPORT_ERROR';
+declare class OpensteerCloudError extends Error {
+    readonly code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR';
     readonly status?: number;
-    readonly details?: RemoteActionFailureDetails | Record<string, unknown>;
-    constructor(code: RemoteErrorCode | 'REMOTE_TRANSPORT_ERROR', message: string, status?: number, details?: RemoteActionFailureDetails | Record<string, unknown>);
+    readonly details?: CloudActionFailureDetails | Record<string, unknown>;
+    constructor(code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR', message: string, status?: number, details?: CloudActionFailureDetails | Record<string, unknown>);
 }
-declare function remoteUnsupportedMethodError(method: string, message?: string): OpensteerRemoteError;
-declare function remoteNotLaunchedError(): OpensteerRemoteError;
+declare function cloudUnsupportedMethodError(method: string, message?: string): OpensteerCloudError;
+declare function cloudNotLaunchedError(): OpensteerCloudError;
 
-declare class RemoteSessionClient {
+declare class CloudSessionClient {
     private readonly baseUrl;
     private readonly key;
-    constructor(baseUrl: string, key: string);
-    create(request: RemoteSessionCreateRequest): Promise<RemoteSessionCreateResponse>;
+    private readonly authScheme;
+    constructor(baseUrl: string, key: string, authScheme?: OpensteerAuthScheme);
+    create(request: CloudSessionCreateRequest): Promise<CloudSessionCreateResponse>;
     close(sessionId: string): Promise<void>;
-    importSelectorCache(request: RemoteSelectorCacheImportRequest): Promise<RemoteSelectorCacheImportResponse>;
+    importSelectorCache(request: CloudSelectorCacheImportRequest): Promise<CloudSelectorCacheImportResponse>;
     private importSelectorCacheBatch;
+    private authHeaders;
 }
 
 interface ActionWsClientOptions {
@@ -695,25 +722,25 @@ declare class ActionWsClient {
     private closed;
     private constructor();
     static connect(options: ActionWsClientOptions): Promise<ActionWsClient>;
-    request<T>(method: RemoteActionMethod, args: Record<string, unknown>): Promise<T>;
+    request<T>(method: CloudActionMethod, args: Record<string, unknown>): Promise<T>;
     close(): Promise<void>;
     private handleMessage;
     private rejectAll;
 }
 
-interface RemoteCdpConnectArgs {
+interface CloudCdpConnectArgs {
     wsUrl: string;
     token: string;
 }
-interface RemoteCdpConnection {
+interface CloudCdpConnection {
     browser: Browser;
     context: BrowserContext;
     page: Page;
 }
-declare class RemoteCdpClient {
-    connect(args: RemoteCdpConnectArgs): Promise<RemoteCdpConnection>;
+declare class CloudCdpClient {
+    connect(args: CloudCdpConnectArgs): Promise<CloudCdpConnection>;
 }
 
-declare function collectLocalSelectorCacheEntries(storage: LocalSelectorStorage): RemoteSelectorCacheImportEntry[];
+declare function collectLocalSelectorCacheEntries(storage: LocalSelectorStorage): CloudSelectorCacheImportEntry[];
 
-export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type ContextHop, type CookieParam, type CounterBinding, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type CounterSnapshotLike, type DomPath, type ElementPath, ElementPathError, type ElementPathErrorCode, type ExtractFromPlanOptions, type ExtractOptions, type ExtractSchema, type ExtractSchemaField, type ExtractSchemaValue, type ExtractionFieldPlan, type ExtractionPlan, type ExtractionRunResult, type FieldSelector, type FileUploadOptions, type GotoOptions, type HoverOptions, type InputOptions, type LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, type MatchClause, type MatchOperator, OPENSTEER_HIDDEN_ATTR, OPENSTEER_INTERACTIVE_ATTR, OPENSTEER_SCROLLABLE_ATTR, OS_BOUNDARY_ATTR, OS_IFRAME_BOUNDARY_TAG, OS_NODE_ID_ATTR, OS_SHADOW_BOUNDARY_TAG, OS_UNAVAILABLE_ATTR, Opensteer, OpensteerActionError, type OpensteerBrowserConfig, type OpensteerConfig, type OpensteerMode, OpensteerRemoteError, type OpensteerRemoteOptions, type OpensteerStorageConfig, type PathNode, type PathNodePosition, type PositionMatchClause, type PreparedSnapshot, type RegistryEntry, type RemoteActionFailure, type RemoteActionFailureDetails, type RemoteActionMethod, type RemoteActionRequest, type RemoteActionResponse, type RemoteActionSuccess, RemoteCdpClient, type RemoteCdpConnectArgs, type RemoteCdpConnection, type RemoteErrorCode, type RemoteSelectorCacheImportEntry, type RemoteSelectorCacheImportRequest, type RemoteSelectorCacheImportResponse, RemoteSessionClient, type RemoteSessionCreateRequest, type RemoteSessionCreateResponse, type ResolvedElementPath, type ScreenshotOptions, type ScrollOptions, type SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, type SnapshotMode, type SnapshotOptions, type StateResult, type TabInfo, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, ensureLiveCounters, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, remoteNotLaunchedError, remoteUnsupportedMethodError, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };
+export { type ActionExecutionResult, type ActionFailure, type ActionFailureBlocker, type ActionFailureClassificationSource, type ActionFailureCode, type ActionFailureDetails, type ActionResult, type ActionWaitOptions, ActionWsClient, type AiExtractArgs, type AiExtractCallback, type AiExtractResult, type AiModelConfig, type AiResolveArgs, type AiResolveCallback, type AiResolveCallbackResult, type AiResolveResult, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, type AttributeMatchClause, type BaseActionOptions, type BoundingBox, type ClickOptions, type CloudActionFailure, type CloudActionFailureDetails, type CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionContractVersion, type CloudSessionCreateRequest, type CloudSessionCreateResponse, type CloudSessionSourceType, type CloudSessionSummary, type ContextHop, type CookieParam, type CounterBinding, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type CounterSnapshotLike, type DomPath, type ElementPath, ElementPathError, type ElementPathErrorCode, type ExtractFromPlanOptions, type ExtractOptions, type ExtractSchema, type ExtractSchemaField, type ExtractSchemaValue, type ExtractionFieldPlan, type ExtractionPlan, type ExtractionRunResult, type FieldSelector, type FileUploadOptions, type GotoOptions, type HoverOptions, type InputOptions, type LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, type MatchClause, type MatchOperator, OPENSTEER_HIDDEN_ATTR, OPENSTEER_INTERACTIVE_ATTR, OPENSTEER_SCROLLABLE_ATTR, OS_BOUNDARY_ATTR, OS_IFRAME_BOUNDARY_TAG, OS_NODE_ID_ATTR, OS_SHADOW_BOUNDARY_TAG, OS_UNAVAILABLE_ATTR, Opensteer, OpensteerActionError, type OpensteerAuthScheme, type OpensteerBrowserConfig, type OpensteerCloudAnnouncePolicy, type OpensteerCloudConfig, OpensteerCloudError, type OpensteerCloudOptions, type OpensteerConfig, type OpensteerStorageConfig, type PathNode, type PathNodePosition, type PositionMatchClause, type PreparedSnapshot, type RegistryEntry, type ResolvedElementPath, type ScreenshotOptions, type ScrollOptions, type SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, type SnapshotMode, type SnapshotOptions, type StateResult, type TabInfo, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, cloudNotLaunchedError, cloudSessionContractVersion, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, ensureLiveCounters, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };

package/dist/index.js

@@ -1,5 +1,7 @@
 import {
   ActionWsClient,
+  CloudCdpClient,
+  CloudSessionClient,
   CounterResolutionError,
   ElementPathError,
   LocalSelectorStorage,
@@ -13,9 +15,7 @@ import {
   OS_UNAVAILABLE_ATTR,
   Opensteer,
   OpensteerActionError,
-  OpensteerRemoteError,
-  RemoteCdpClient,
-  RemoteSessionClient,
+  OpensteerCloudError,
   buildElementPathFromHandle,
   buildElementPathFromSelector,
   buildPathSelectorHint,
@@ -27,6 +27,9 @@ import {
   clearCookies,
   cloneElementPath,
   closeTab,
+  cloudNotLaunchedError,
+  cloudSessionContractVersion,
+  cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
   createEmptyRegistry,
@@ -55,8 +58,6 @@ import {
   performSelect,
   prepareSnapshot,
   pressKey,
-  remoteNotLaunchedError,
-  remoteUnsupportedMethodError,
   resolveCounterElement,
   resolveCountersBatch,
   resolveElementPath,
@@ -67,7 +68,7 @@ import {
   switchTab,
   typeText,
   waitForVisualStability
-} from "./chunk-2NKR4JZ6.js";
+} from "./chunk-PIJI7FBH.js";
 import {
   createResolveCallback
 } from "./chunk-SRJLH34D.js";
@@ -80,6 +81,8 @@ import {
 } from "./chunk-L4FHT64T.js";
 export {
   ActionWsClient,
+  CloudCdpClient,
+  CloudSessionClient,
   CounterResolutionError,
   ElementPathError,
   LocalSelectorStorage,
@@ -93,9 +96,7 @@ export {
   OS_UNAVAILABLE_ATTR,
   Opensteer,
   OpensteerActionError,
-  OpensteerRemoteError,
-  RemoteCdpClient,
-  RemoteSessionClient,
+  OpensteerCloudError,
   buildElementPathFromHandle,
   buildElementPathFromSelector,
   buildPathSelectorHint,
@@ -107,6 +108,9 @@ export {
   clearCookies,
   cloneElementPath,
   closeTab,
+  cloudNotLaunchedError,
+  cloudSessionContractVersion,
+  cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
   createEmptyRegistry,
@@ -138,8 +142,6 @@ export {
   performSelect,
   prepareSnapshot,
   pressKey,
-  remoteNotLaunchedError,
-  remoteUnsupportedMethodError,
   resolveCounterElement,
   resolveCountersBatch,
   resolveElementPath,