opensteer 0.4.1 → 0.4.2

package/dist/index.d.ts

@@ -33,6 +33,27 @@ interface ElementPath {
     nodes: DomPath;
 }
 
+type ActionFailureCode = 'TARGET_NOT_FOUND' | 'TARGET_UNAVAILABLE' | 'TARGET_STALE' | 'TARGET_AMBIGUOUS' | 'BLOCKED_BY_INTERCEPTOR' | 'NOT_VISIBLE' | 'NOT_ENABLED' | 'NOT_EDITABLE' | 'INVALID_TARGET' | 'INVALID_OPTIONS' | 'ACTION_TIMEOUT' | 'UNKNOWN';
+type ActionFailureClassificationSource = 'typed_error' | 'playwright_call_log' | 'dom_probe' | 'message_heuristic' | 'unknown';
+interface ActionFailureBlocker {
+    tag: string;
+    id: string | null;
+    classes: string[];
+    role: string | null;
+    text: string | null;
+}
+interface ActionFailureDetails {
+    blocker?: ActionFailureBlocker;
+    observation?: string;
+}
+interface ActionFailure {
+    code: ActionFailureCode;
+    message: string;
+    retryable: boolean;
+    classificationSource: ActionFailureClassificationSource;
+    details?: ActionFailureDetails;
+}
+
 type SnapshotMode = 'action' | 'extraction' | 'clickable' | 'scrollable' | 'full';
 interface SnapshotOptions {
     mode?: SnapshotMode;
@@ -78,43 +99,55 @@ interface LaunchOptions {
     executablePath?: string;
     slowMo?: number;
     context?: BrowserContextOptions;
-    /** Connect to a running Chrome via CDP. Example: "http://localhost:9222" */
-    cdpUrl?: string;
-    /** Use an installed browser: "chrome", "chrome-beta", "msedge" */
+    /** Connect to a running browser. Example: "http://localhost:9222" */
+    connectUrl?: string;
+    /** Browser channel: "chrome", "chrome-beta", or "msedge" */
     channel?: string;
-    /** Chrome user data directory. Preserves cookies, extensions, and sessions. */
-    userDataDir?: string;
+    /** Browser profile directory. Preserves cookies, extensions, and sessions. */
+    profileDir?: string;
+    /** Connection timeout in milliseconds. */
+    timeout?: number;
 }
 interface OpensteerBrowserConfig {
     headless?: boolean;
     executablePath?: string;
     slowMo?: number;
-    /** Connect to a running Chrome via CDP. Example: "http://localhost:9222" */
-    cdpUrl?: string;
-    /** Use an installed browser: "chrome", "chrome-beta", "msedge" */
+    /** Connect to a running browser. Example: "http://localhost:9222" */
+    connectUrl?: string;
+    /** Browser channel: "chrome", "chrome-beta", or "msedge" */
     channel?: string;
-    /** Chrome user data directory. Preserves cookies, extensions, and sessions. */
-    userDataDir?: string;
+    /** Browser profile directory. Preserves cookies, extensions, and sessions. */
+    profileDir?: string;
 }
 interface OpensteerStorageConfig {
     rootDir?: string;
 }
-interface OpensteerCloudConfig {
-    enabled: boolean;
-    key?: string;
+type OpensteerMode = 'local' | 'remote';
+interface OpensteerRemoteOptions {
+    apiKey?: string;
+    baseUrl?: string;
 }
 interface OpensteerConfig {
     name?: string;
     browser?: OpensteerBrowserConfig;
     storage?: OpensteerStorageConfig;
-    cloud?: OpensteerCloudConfig;
+    mode?: OpensteerMode;
+    remote?: OpensteerRemoteOptions;
     model?: string;
     debug?: boolean;
 }
+interface ActionWaitOptions {
+    enabled?: boolean;
+    timeout?: number;
+    settleMs?: number;
+    networkQuietMs?: number;
+    includeNetwork?: boolean;
+}
 interface BaseActionOptions {
     description?: string;
     element?: number;
     selector?: string;
+    wait?: false | ActionWaitOptions;
 }
 interface ClickOptions extends BaseActionOptions {
     button?: 'left' | 'right' | 'middle';
@@ -270,7 +303,7 @@ declare class Opensteer {
     private readonly namespace;
     private readonly storage;
     private readonly pool;
-    private readonly cloud;
+    private readonly remote;
     private browser;
     private pageRef;
     private contextRef;
@@ -279,14 +312,15 @@ declare class Opensteer {
     constructor(config?: OpensteerConfig);
     private createLazyResolveCallback;
     private createLazyExtractCallback;
-    private bindCloudActionMethods;
-    private invokeCloudAction;
+    private invokeRemoteActionAndResetCache;
+    private invokeRemoteAction;
+    private buildActionError;
     get page(): Page;
     get context(): BrowserContext;
     launch(options?: LaunchOptions): Promise<void>;
     static from(page: Page, config?: OpensteerConfig): Opensteer;
     close(): Promise<void>;
-    private syncLocalSelectorCacheToCloud;
+    private syncLocalSelectorCacheToRemote;
     goto(url: string, options?: GotoOptions): Promise<void>;
     snapshot(options?: SnapshotOptions): Promise<string>;
     state(): Promise<StateResult>;
@@ -326,12 +360,14 @@ declare class Opensteer {
     getConfig(): OpensteerConfig;
     getStorage(): LocalSelectorStorage;
     clearCache(): void;
+    private runWithPostActionWait;
     private executeClickVariant;
     private resolvePath;
     private resolvePathWithAi;
     private buildPathFromElement;
     private tryBuildPathFromCounter;
     private resolveCounterHandle;
+    private resolveCounterHandleForAction;
     private buildPathFromResolvedHandle;
     private withIndexedIframeContext;
     private readPathFromCounterIndex;
@@ -356,16 +392,33 @@ declare class Opensteer {
     private normalizePath;
 }
 
-declare function waitForVisualStability(page: Page, options?: {
+interface VisualStabilityOptions {
     timeout?: number;
     settleMs?: number;
-}): Promise<void>;
+}
+declare function waitForVisualStability(page: Page, options?: VisualStabilityOptions): Promise<void>;
 
 interface ActionExecutionResult {
     ok: boolean;
     path?: ElementPath;
     usedSelector?: string;
     error?: string;
+    failure?: ActionFailure;
+}
+
+interface OpensteerActionErrorOptions {
+    action: string;
+    failure: ActionFailure;
+    selectorUsed?: string | null;
+    message?: string;
+    cause?: unknown;
+}
+declare class OpensteerActionError extends Error {
+    readonly action: string;
+    readonly code: ActionFailureCode;
+    readonly failure: ActionFailure;
+    readonly selectorUsed: string | null;
+    constructor(options: OpensteerActionErrorOptions);
 }
 
 declare function performClick(page: Page, path: ElementPath, options: ClickOptions): Promise<ActionExecutionResult>;
@@ -444,11 +497,11 @@ declare class ElementPathError extends Error {
     constructor(code: ElementPathErrorCode, message: string);
 }
 
-declare const OV_NODE_ID_ATTR = "data-ov-node-id";
-declare const OV_BOUNDARY_ATTR = "data-ov-boundary";
-declare const OV_UNAVAILABLE_ATTR = "data-ov-unavailable";
-declare const OV_IFRAME_BOUNDARY_TAG = "ov-iframe-root";
-declare const OV_SHADOW_BOUNDARY_TAG = "ov-shadow-root";
+declare const OS_NODE_ID_ATTR = "data-os-node-id";
+declare const OS_BOUNDARY_ATTR = "data-os-boundary";
+declare const OS_UNAVAILABLE_ATTR = "data-os-unavailable";
+declare const OS_IFRAME_BOUNDARY_TAG = "os-iframe-root";
+declare const OS_SHADOW_BOUNDARY_TAG = "os-shadow-root";
 interface SerializeOptions {
     detectOverlays?: boolean;
 }
@@ -529,6 +582,9 @@ interface PreparedSnapshot {
 }
 declare function prepareSnapshot(page: Page, options?: SnapshotOptions): Promise<PreparedSnapshot>;
 
+declare function normalizeNamespace(input?: string): string;
+declare function resolveNamespaceDir(rootDir: string, namespace: string): string;
+
 declare function createResolveCallback(model: string, options?: {
     temperature?: number;
     maxTokens?: number | null;
@@ -547,21 +603,22 @@ interface AiModelConfig {
     maxTokens?: number | null;
 }
 
-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_INTERNAL';
-interface CloudSessionCreateRequest {
+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 {
     name?: string;
     model?: string;
     launchContext?: Record<string, unknown>;
 }
-interface CloudSessionCreateResponse {
+interface RemoteSessionCreateResponse {
     sessionId: string;
     actionWsUrl: string;
     cdpWsUrl: string;
     actionToken: string;
     cdpToken: string;
+    expiresAt?: number;
 }
-interface CloudSelectorCacheImportEntry {
+interface RemoteSelectorCacheImportEntry {
     namespace: string;
     siteOrigin: string;
     method: string;
@@ -571,50 +628,55 @@ interface CloudSelectorCacheImportEntry {
     createdAt: number;
     updatedAt: number;
 }
-interface CloudSelectorCacheImportRequest {
-    entries: CloudSelectorCacheImportEntry[];
+interface RemoteSelectorCacheImportRequest {
+    entries: RemoteSelectorCacheImportEntry[];
 }
-interface CloudSelectorCacheImportResponse {
+interface RemoteSelectorCacheImportResponse {
     imported: number;
     inserted: number;
     updated: number;
     skipped: number;
 }
-interface CloudActionRequest {
+interface RemoteActionRequest {
     id: number;
-    method: CloudActionMethod;
+    method: RemoteActionMethod;
     args: Record<string, unknown>;
     sessionId: string;
     token: string;
 }
-interface CloudActionSuccess {
+interface RemoteActionSuccess {
     id: number;
     ok: true;
     result: unknown;
 }
-interface CloudActionFailure {
+interface RemoteActionFailure {
     id: number;
     ok: false;
     error: string;
-    code: CloudErrorCode;
+    code: RemoteErrorCode;
+    details?: RemoteActionFailureDetails;
+}
+type RemoteActionResponse = RemoteActionSuccess | RemoteActionFailure;
+interface RemoteActionFailureDetails {
+    actionFailure?: ActionFailure;
 }
-type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
 
-declare class OpensteerCloudError extends Error {
-    readonly code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR';
+declare class OpensteerRemoteError extends Error {
+    readonly code: RemoteErrorCode | 'REMOTE_TRANSPORT_ERROR';
     readonly status?: number;
-    constructor(code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR', message: string, status?: number);
+    readonly details?: RemoteActionFailureDetails | Record<string, unknown>;
+    constructor(code: RemoteErrorCode | 'REMOTE_TRANSPORT_ERROR', message: string, status?: number, details?: RemoteActionFailureDetails | Record<string, unknown>);
 }
-declare function cloudUnsupportedMethodError(method: string, message?: string): OpensteerCloudError;
-declare function cloudNotLaunchedError(): OpensteerCloudError;
+declare function remoteUnsupportedMethodError(method: string, message?: string): OpensteerRemoteError;
+declare function remoteNotLaunchedError(): OpensteerRemoteError;
 
-declare class CloudSessionClient {
+declare class RemoteSessionClient {
     private readonly baseUrl;
     private readonly key;
     constructor(baseUrl: string, key: string);
-    create(request: CloudSessionCreateRequest): Promise<CloudSessionCreateResponse>;
+    create(request: RemoteSessionCreateRequest): Promise<RemoteSessionCreateResponse>;
     close(sessionId: string): Promise<void>;
-    importSelectorCache(request: CloudSelectorCacheImportRequest): Promise<CloudSelectorCacheImportResponse>;
+    importSelectorCache(request: RemoteSelectorCacheImportRequest): Promise<RemoteSelectorCacheImportResponse>;
     private importSelectorCacheBatch;
 }
 
@@ -632,25 +694,25 @@ declare class ActionWsClient {
     private closed;
     private constructor();
     static connect(options: ActionWsClientOptions): Promise<ActionWsClient>;
-    request<T>(method: CloudActionMethod, args: Record<string, unknown>): Promise<T>;
+    request<T>(method: RemoteActionMethod, args: Record<string, unknown>): Promise<T>;
     close(): Promise<void>;
     private handleMessage;
     private rejectAll;
 }
 
-interface CloudCdpConnectArgs {
+interface RemoteCdpConnectArgs {
     wsUrl: string;
     token: string;
 }
-interface CloudCdpConnection {
+interface RemoteCdpConnection {
     browser: Browser;
     context: BrowserContext;
     page: Page;
 }
-declare class CloudCdpClient {
-    connect(args: CloudCdpConnectArgs): Promise<CloudCdpConnection>;
+declare class RemoteCdpClient {
+    connect(args: RemoteCdpConnectArgs): Promise<RemoteCdpConnection>;
 }
 
-declare function collectLocalSelectorCacheEntries(storage: LocalSelectorStorage): CloudSelectorCacheImportEntry[];
+declare function collectLocalSelectorCacheEntries(storage: LocalSelectorStorage): RemoteSelectorCacheImportEntry[];
 
-export { type ActionExecutionResult, type ActionResult, 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 CloudActionMethod, type CloudActionRequest, type CloudActionResponse, type CloudActionSuccess, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, type CloudErrorCode, type CloudSelectorCacheImportEntry, type CloudSelectorCacheImportRequest, type CloudSelectorCacheImportResponse, CloudSessionClient, type CloudSessionCreateRequest, type CloudSessionCreateResponse, 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, OV_BOUNDARY_ATTR, OV_IFRAME_BOUNDARY_TAG, OV_NODE_ID_ATTR, OV_SHADOW_BOUNDARY_TAG, OV_UNAVAILABLE_ATTR, Opensteer, type OpensteerBrowserConfig, type OpensteerCloudConfig, OpensteerCloudError, 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, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, ensureLiveCounters, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, resolveCounterElement, resolveCountersBatch, resolveElementPath, 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 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 };

package/dist/index.js

@@ -1,20 +1,21 @@
 import {
   ActionWsClient,
-  CloudCdpClient,
-  CloudSessionClient,
   CounterResolutionError,
   ElementPathError,
   LocalSelectorStorage,
   OPENSTEER_HIDDEN_ATTR,
   OPENSTEER_INTERACTIVE_ATTR,
   OPENSTEER_SCROLLABLE_ATTR,
-  OV_BOUNDARY_ATTR,
-  OV_IFRAME_BOUNDARY_TAG,
-  OV_NODE_ID_ATTR,
-  OV_SHADOW_BOUNDARY_TAG,
-  OV_UNAVAILABLE_ATTR,
+  OS_BOUNDARY_ATTR,
+  OS_IFRAME_BOUNDARY_TAG,
+  OS_NODE_ID_ATTR,
+  OS_SHADOW_BOUNDARY_TAG,
+  OS_UNAVAILABLE_ATTR,
   Opensteer,
-  OpensteerCloudError,
+  OpensteerActionError,
+  OpensteerRemoteError,
+  RemoteCdpClient,
+  RemoteSessionClient,
   buildElementPathFromHandle,
   buildElementPathFromSelector,
   buildPathSelectorHint,
@@ -26,8 +27,6 @@ import {
   clearCookies,
   cloneElementPath,
   closeTab,
-  cloudNotLaunchedError,
-  cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
   createEmptyRegistry,
@@ -47,6 +46,7 @@ import {
   importCookies,
   listTabs,
   markInteractiveElements,
+  normalizeNamespace,
   performClick,
   performFileUpload,
   performHover,
@@ -55,16 +55,19 @@ import {
   performSelect,
   prepareSnapshot,
   pressKey,
+  remoteNotLaunchedError,
+  remoteUnsupportedMethodError,
   resolveCounterElement,
   resolveCountersBatch,
   resolveElementPath,
+  resolveNamespaceDir,
   sanitizeElementPath,
   serializePageHTML,
   setCookie,
   switchTab,
   typeText,
   waitForVisualStability
-} from "./chunk-OXFW5I3Y.js";
+} from "./chunk-6L24FEKD.js";
 import {
   createResolveCallback
 } from "./chunk-SRJLH34D.js";
@@ -77,21 +80,22 @@ import {
 } from "./chunk-L4FHT64T.js";
 export {
   ActionWsClient,
-  CloudCdpClient,
-  CloudSessionClient,
   CounterResolutionError,
   ElementPathError,
   LocalSelectorStorage,
   OPENSTEER_HIDDEN_ATTR,
   OPENSTEER_INTERACTIVE_ATTR,
   OPENSTEER_SCROLLABLE_ATTR,
-  OV_BOUNDARY_ATTR,
-  OV_IFRAME_BOUNDARY_TAG,
-  OV_NODE_ID_ATTR,
-  OV_SHADOW_BOUNDARY_TAG,
-  OV_UNAVAILABLE_ATTR,
+  OS_BOUNDARY_ATTR,
+  OS_IFRAME_BOUNDARY_TAG,
+  OS_NODE_ID_ATTR,
+  OS_SHADOW_BOUNDARY_TAG,
+  OS_UNAVAILABLE_ATTR,
   Opensteer,
-  OpensteerCloudError,
+  OpensteerActionError,
+  OpensteerRemoteError,
+  RemoteCdpClient,
+  RemoteSessionClient,
   buildElementPathFromHandle,
   buildElementPathFromSelector,
   buildPathSelectorHint,
@@ -103,8 +107,6 @@ export {
   clearCookies,
   cloneElementPath,
   closeTab,
-  cloudNotLaunchedError,
-  cloudUnsupportedMethodError,
   collectLocalSelectorCacheEntries,
   countArrayItemsWithPath,
   createEmptyRegistry,
@@ -127,6 +129,7 @@ export {
   importCookies,
   listTabs,
   markInteractiveElements,
+  normalizeNamespace,
   performClick,
   performFileUpload,
   performHover,
@@ -135,9 +138,12 @@ export {
   performSelect,
   prepareSnapshot,
   pressKey,
+  remoteNotLaunchedError,
+  remoteUnsupportedMethodError,
   resolveCounterElement,
   resolveCountersBatch,
   resolveElementPath,
+  resolveNamespaceDir,
   sanitizeElementPath,
   serializePageHTML,
   setCookie,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "opensteer",
-    "version": "0.4.1",
+    "version": "0.4.2",
     "packageManager": "pnpm@10.29.3",
     "description": "Open-source browser automation SDK with robust selectors and deterministic replay.",
     "license": "MIT",
@@ -38,34 +38,26 @@
         "typecheck": "tsc -p tsconfig.json --noEmit"
     },
     "dependencies": {
+        "@ai-sdk/anthropic": "^3.0.46",
+        "@ai-sdk/google": "^3.0.30",
+        "@ai-sdk/groq": "^3.0.24",
+        "@ai-sdk/openai": "^3.0.26",
+        "@ai-sdk/xai": "^3.0.57",
+        "ai": "^6.0.77",
         "cheerio": "^1.0.0-rc.12",
         "dotenv": "^17.2.4",
         "playwright": "^1.50.0",
-        "ws": "^8.18.0"
+        "ws": "^8.18.0",
+        "zod": "^4.3.6"
     },
     "devDependencies": {
-        "@ai-sdk/openai": "^3.0.26",
         "@types/node": "^22.10.0",
         "@types/ws": "^8.5.13",
-        "ai": "^6.0.77",
         "domhandler": "^5.0.3",
         "tsup": "^8.0.1",
         "typescript": "^5.6.3",
         "vite": "^7.3.1",
-        "vitest": "^2.1.8",
-        "zod": "^4.3.6"
-    },
-    "peerDependencies": {
-        "ai": ">=4.0.0",
-        "zod": ">=3.0.0"
-    },
-    "peerDependenciesMeta": {
-        "ai": {
-            "optional": true
-        },
-        "zod": {
-            "optional": true
-        }
+        "vitest": "^2.1.8"
     },
     "pnpm": {
         "onlyBuiltDependencies": [