opensteer 0.6.0 → 0.6.2

package/dist/index.d.ts

@@ -1,317 +1,9 @@
 import * as playwright from 'playwright';
-import { BrowserContextOptions, Page, BrowserContext, ElementHandle, Cookie, Browser } from 'playwright';
-
-type MatchOperator = 'exact' | 'startsWith' | 'contains';
-interface AttributeMatchClause {
-    kind: 'attr';
-    key: string;
-    op?: MatchOperator;
-    value?: string;
-}
-interface PositionMatchClause {
-    kind: 'position';
-    axis: 'nthOfType' | 'nthChild';
-}
-type MatchClause = AttributeMatchClause | PositionMatchClause;
-interface PathNodePosition {
-    nthChild: number;
-    nthOfType: number;
-}
-interface PathNode {
-    tag: string;
-    attrs: Record<string, string>;
-    position: PathNodePosition;
-    match: MatchClause[];
-}
-type DomPath = PathNode[];
-interface ContextHop {
-    kind: 'iframe' | 'shadow';
-    host: DomPath;
-}
-interface ElementPath {
-    context: ContextHop[];
-    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;
-    withCounters?: boolean;
-    markInteractive?: boolean;
-}
-interface ScreenshotOptions {
-    fullPage?: boolean;
-    type?: 'png' | 'jpeg';
-    /** Ignored for PNG. */
-    quality?: number;
-    omitBackground?: boolean;
-}
-interface AiResolveArgs {
-    html: string;
-    action: string;
-    description: string;
-    url: string | null;
-}
-interface AiResolveResult {
-    element?: number;
-    selector?: string;
-    path?: ElementPath;
-}
-type AiResolveCallbackResult = AiResolveResult | number | string | null | undefined;
-type AiResolveCallback = (args: AiResolveArgs) => Promise<AiResolveCallbackResult>;
-interface AiExtractArgs<TSchema = ExtractSchema> {
-    html: string;
-    schema: TSchema;
-    description?: string;
-    prompt?: string;
-    url: string | null;
-}
-type AiExtractResult<TData = unknown> = TData | ExtractionPlan | string;
-type AiExtractCallback = <TSchema = ExtractSchema, TData = unknown>(args: AiExtractArgs<TSchema>) => Promise<AiExtractResult<TData>>;
-interface GotoOptions {
-    timeout?: number;
-    waitUntil?: 'commit' | 'domcontentloaded' | 'load' | 'networkidle';
-    settleMs?: number;
-}
-interface LaunchOptions {
-    headless?: boolean;
-    executablePath?: string;
-    slowMo?: number;
-    context?: BrowserContextOptions;
-    /** Connect to a running browser. Example: "http://localhost:9222" */
-    connectUrl?: string;
-    /** Browser channel: "chrome", "chrome-beta", or "msedge" */
-    channel?: 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 browser. Example: "http://localhost:9222" */
-    connectUrl?: string;
-    /** Browser channel: "chrome", "chrome-beta", or "msedge" */
-    channel?: string;
-    /** Browser profile directory. Preserves cookies, extensions, and sessions. */
-    profileDir?: string;
-}
-interface OpensteerStorageConfig {
-    rootDir?: string;
-}
-type OpensteerAuthScheme = 'api-key' | 'bearer';
-type OpensteerCloudAnnouncePolicy = 'always' | 'off' | 'tty';
-interface OpensteerCloudOptions {
-    apiKey?: string;
-    baseUrl?: string;
-    authScheme?: OpensteerAuthScheme;
-    announce?: OpensteerCloudAnnouncePolicy;
-}
-type OpensteerCloudConfig = boolean | OpensteerCloudOptions;
-interface OpensteerConfig {
-    name?: string;
-    browser?: OpensteerBrowserConfig;
-    storage?: OpensteerStorageConfig;
-    cloud?: OpensteerCloudConfig;
-    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';
-    clickCount?: number;
-    modifiers?: Array<'Alt' | 'Control' | 'Meta' | 'Shift'>;
-}
-interface HoverOptions extends BaseActionOptions {
-    force?: boolean;
-    position?: {
-        x: number;
-        y: number;
-    };
-}
-interface InputOptions extends BaseActionOptions {
-    text: string;
-    clear?: boolean;
-    pressEnter?: boolean;
-}
-interface SelectOptions extends BaseActionOptions {
-    value?: string;
-    label?: string;
-    index?: number;
-}
-interface ScrollOptions extends BaseActionOptions {
-    direction?: 'up' | 'down' | 'left' | 'right';
-    amount?: number;
-}
-interface ExtractSchemaField {
-    element?: number;
-    selector?: string;
-    attribute?: string;
-    source?: 'current_url';
-}
-type ExtractSchemaValue = ExtractSchemaField | string | number | boolean | null | ExtractSchema | ExtractSchema[];
-interface ExtractSchema {
-    [key: string]: ExtractSchemaValue;
-}
-interface ExtractOptions<TSchema = ExtractSchema> extends BaseActionOptions {
-    schema?: TSchema;
-    prompt?: string;
-    snapshot?: SnapshotOptions;
-}
-interface ExtractionFieldPlan {
-    element?: number;
-    selector?: string;
-    attribute?: string;
-    source?: 'current_url';
-}
-interface ExtractionPlan {
-    fields?: Record<string, ExtractionFieldPlan>;
-    paths?: Record<string, ElementPath>;
-    data?: unknown;
-}
-interface ExtractFromPlanOptions<TSchema = ExtractSchema> {
-    description?: string;
-    schema: TSchema;
-    plan: ExtractionPlan;
-}
-interface ActionResult {
-    method: string;
-    namespace: string;
-    persisted: boolean;
-    pathFile: string | null;
-    selectorUsed?: string | null;
-}
-interface ExtractionRunResult<T = unknown> {
-    namespace: string;
-    persisted: boolean;
-    pathFile: string | null;
-    data: T;
-    paths: Record<string, ElementPath>;
-}
-interface StateResult {
-    url: string;
-    title: string;
-    html: string;
-}
-interface TabInfo {
-    index: number;
-    url: string;
-    title: string;
-    active: boolean;
-}
-interface CookieParam {
-    name: string;
-    value: string;
-    url?: string;
-    domain?: string;
-    path?: string;
-    expires?: number;
-    httpOnly?: boolean;
-    secure?: boolean;
-    sameSite?: 'Strict' | 'Lax' | 'None';
-}
-interface FileUploadOptions extends BaseActionOptions {
-    paths: string[];
-}
-interface BoundingBox {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-type OpensteerAgentMode = 'cua';
-type OpensteerAgentProvider = 'openai' | 'anthropic' | 'google';
-interface OpensteerAgentModelConfig {
-    modelName: string;
-    apiKey?: string;
-    baseUrl?: string;
-    organization?: string;
-    thinkingBudget?: number;
-    environment?: string;
-}
-interface OpensteerAgentConfig {
-    mode: OpensteerAgentMode;
-    model?: string | OpensteerAgentModelConfig;
-    systemPrompt?: string;
-    waitBetweenActionsMs?: number;
-}
-interface OpensteerAgentExecuteOptions {
-    instruction: string;
-    maxSteps?: number;
-    highlightCursor?: boolean;
-}
-interface OpensteerAgentUsage {
-    inputTokens: number;
-    outputTokens: number;
-    reasoningTokens?: number;
-    inferenceTimeMs: number;
-}
-interface OpensteerAgentAction {
-    type: string;
-    reasoning?: string;
-    button?: string;
-    clickCount?: number;
-    x?: number;
-    y?: number;
-    text?: string;
-    keys?: string[];
-    scrollX?: number;
-    scrollY?: number;
-    timeMs?: number;
-    url?: string;
-    path?: Array<{
-        x: number;
-        y: number;
-    }>;
-    [key: string]: unknown;
-}
-interface OpensteerAgentResult {
-    success: boolean;
-    completed: boolean;
-    message: string;
-    actions: OpensteerAgentAction[];
-    usage?: OpensteerAgentUsage;
-    provider: OpensteerAgentProvider;
-    model: string;
-}
-interface OpensteerAgentInstance {
-    execute(instructionOrOptions: string | OpensteerAgentExecuteOptions): Promise<OpensteerAgentResult>;
-}
+import { Page, BrowserContext, ElementHandle, Cookie, Browser } from 'playwright';
+import { a as OpensteerConfig, L as LaunchOptions, G as GotoOptions, S as SnapshotOptions, b as StateResult, c as ScreenshotOptions, d as ClickOptions, A as ActionResult, H as HoverOptions, I as InputOptions, e as SelectOptions, f as ScrollOptions, T as TabInfo, C as CookieParam, B as BaseActionOptions, g as BoundingBox, F as FileUploadOptions, E as ExtractOptions, h as ExtractFromPlanOptions, i as ExtractionRunResult, j as OpensteerCursorState, k as OpensteerAgentConfig, l as OpensteerAgentInstance, m as ElementPath, n as SnapshotMode, o as AiResolveCallback, p as AiExtractCallback, O as OpensteerAuthScheme, q as OpensteerAgentProvider, r as OpensteerAgentAction, s as OpensteerAgentResult, t as OpensteerAgentUsage, u as OpensteerCursorStyle, v as OpensteerCursorConfig, w as OpensteerAgentExecuteOptions } from './types-BxiRblC7.js';
+export { x as ActionWaitOptions, y as AiExtractArgs, z as AiExtractResult, D as AiResolveArgs, J as AiResolveCallbackResult, K as AiResolveResult, M as AttributeMatchClause, N as ContextHop, P as DomPath, Q as ExtractSchema, R as ExtractSchemaField, U as ExtractSchemaValue, V as ExtractionFieldPlan, W as ExtractionPlan, X as MatchClause, Y as MatchOperator, Z as OpensteerAgentMode, _ as OpensteerAgentModelConfig, $ as OpensteerBrowserConfig, a0 as OpensteerCloudAnnouncePolicy, a1 as OpensteerCloudBrowserProfileOptions, a2 as OpensteerCloudConfig, a3 as OpensteerCloudOptions, a4 as OpensteerCursorColor, a5 as OpensteerCursorProfile, a6 as OpensteerStorageConfig, a7 as PathNode, a8 as PathNodePosition, a9 as PositionMatchClause } from './types-BxiRblC7.js';
+import { A as ActionFailure, e as ActionFailureCode, C as CloudErrorCode, f as CloudActionFailureDetails, g as CloudSessionCreateRequest, h as CloudSessionCreateResponse, i as CloudSelectorCacheImportRequest, j as CloudSelectorCacheImportResponse, k as CloudActionMethod, l as CloudSelectorCacheImportEntry } from './browser-profile-client-CaL-mwqs.js';
+export { m as ActionFailureBlocker, n as ActionFailureClassificationSource, o as ActionFailureDetails, p as BrowserProfileArchiveFormat, q as BrowserProfileClient, c as BrowserProfileCreateRequest, d as BrowserProfileDescriptor, a as BrowserProfileListRequest, b as BrowserProfileListResponse, r as BrowserProfileProxyPolicy, B as BrowserProfileStatus, s as CloudActionFailure, t as CloudActionRequest, u as CloudActionResponse, v as CloudActionSuccess, w as CloudBrowserProfileLaunchPreference, x as CloudFingerprintMode, y as CloudSessionContractVersion, z as CloudSessionLaunchConfig, D as CloudSessionSourceType, E as CloudSessionSummary, F as cloudSessionContractVersion } from './browser-profile-client-CaL-mwqs.js';
 
 interface RegistryEntry {
     file: string;
@@ -375,6 +67,7 @@ declare class Opensteer {
     private ownsBrowser;
     private snapshotCache;
     private agentExecutionInFlight;
+    private cursorController;
     constructor(config?: OpensteerConfig);
     private logDebugError;
     private createLazyResolveCallback;
@@ -389,6 +82,7 @@ declare class Opensteer {
     getCloudSessionUrl(): string | null;
     private announceCloudSession;
     private shouldAnnounceCloudSession;
+    private buildCloudSessionLaunchConfig;
     launch(options?: LaunchOptions): Promise<void>;
     static from(page: Page, config?: OpensteerConfig): Opensteer;
     close(): Promise<void>;
@@ -430,9 +124,19 @@ declare class Opensteer {
     extractFromPlan<T = unknown>(options: ExtractFromPlanOptions): Promise<ExtractionRunResult<T>>;
     getNamespace(): string;
     getConfig(): OpensteerConfig;
+    setCursorEnabled(enabled: boolean): void;
+    getCursorState(): OpensteerCursorState;
     getStorage(): LocalSelectorStorage;
     clearCache(): void;
     agent(config: OpensteerAgentConfig): OpensteerAgentInstance;
+    private getCursorController;
+    private runWithCursorPreview;
+    private isCursorPreviewEnabled;
+    private previewCursorPoint;
+    private resolveCursorPointFromBoundingBox;
+    private resolveHandleTargetPoint;
+    private resolvePathTargetPoint;
+    private resolveViewportAnchorPoint;
     private runWithPostActionWait;
     private executeClickVariant;
     private resolvePath;
@@ -671,82 +375,6 @@ 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_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 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 CloudSelectorCacheImportEntry {
-    namespace: string;
-    siteOrigin: string;
-    method: string;
-    descriptionHash: string;
-    path: unknown;
-    schemaHash?: string;
-    createdAt: number;
-    updatedAt: number;
-}
-interface CloudSelectorCacheImportRequest {
-    entries: CloudSelectorCacheImportEntry[];
-}
-interface CloudSelectorCacheImportResponse {
-    imported: number;
-    inserted: number;
-    updated: number;
-    skipped: number;
-}
-interface CloudActionRequest {
-    id: number;
-    method: CloudActionMethod;
-    args: Record<string, unknown>;
-    sessionId: string;
-    token: string;
-}
-interface CloudActionSuccess {
-    id: number;
-    ok: true;
-    result: unknown;
-}
-interface CloudActionFailure {
-    id: number;
-    ok: false;
-    error: string;
-    code: CloudErrorCode;
-    details?: CloudActionFailureDetails;
-}
-type CloudActionResponse = CloudActionSuccess | CloudActionFailure;
-interface CloudActionFailureDetails {
-    actionFailure?: ActionFailure;
-}
-
 declare class OpensteerCloudError extends Error {
     readonly code: CloudErrorCode | 'CLOUD_TRANSPORT_ERROR';
     readonly status?: number;
@@ -765,7 +393,6 @@ declare class CloudSessionClient {
     close(sessionId: string): Promise<void>;
     importSelectorCache(request: CloudSelectorCacheImportRequest): Promise<CloudSelectorCacheImportResponse>;
     private importSelectorCacheBatch;
-    private authHeaders;
 }
 
 interface ActionWsClientOptions {
@@ -878,25 +505,144 @@ declare function resolveAgentConfig(args: {
 }): ResolvedAgentConfig;
 declare function createCuaClient(config: ResolvedAgentConfig): CuaClient;
 
+interface CursorPoint {
+    x: number;
+    y: number;
+}
+type CursorIntent = 'click' | 'dblclick' | 'rightclick' | 'hover' | 'input' | 'select' | 'scroll' | 'uploadFile' | 'agent';
+interface CursorMotionPlan {
+    points: CursorPoint[];
+    stepDelayMs: number;
+}
+type CursorCapabilityReason = 'disabled' | 'page_closed' | 'cdp_unavailable' | 'cdp_detached' | 'unsupported' | 'renderer_error';
+interface CursorStatus {
+    enabled: boolean;
+    active: boolean;
+    reason?: string;
+}
+
+interface CursorRenderer {
+    initialize(page: Page): Promise<void>;
+    move(point: CursorPoint, style: Required<OpensteerCursorStyle>): Promise<void>;
+    pulse(point: CursorPoint, style: Required<OpensteerCursorStyle>): Promise<void>;
+    clear(): Promise<void>;
+    dispose(): Promise<void>;
+    isActive(): boolean;
+    status(): CursorStatus;
+}
+
+interface CursorControllerOptions {
+    config?: OpensteerCursorConfig;
+    debug?: boolean;
+    renderer?: CursorRenderer;
+}
+declare class CursorController {
+    private readonly debug;
+    private readonly renderer;
+    private page;
+    private listenerPage;
+    private lastPoint;
+    private initializedForPage;
+    private lastInitializeAttemptAt;
+    private enabled;
+    private readonly profile;
+    private readonly style;
+    private readonly onDomContentLoaded;
+    constructor(options?: CursorControllerOptions);
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    getStatus(): CursorStatus;
+    attachPage(page: Page): Promise<void>;
+    preview(point: CursorPoint | null, intent: CursorIntent): Promise<void>;
+    clear(): Promise<void>;
+    dispose(): Promise<void>;
+    private ensureInitialized;
+    private attachPageListeners;
+    private detachPageListeners;
+    private planMotion;
+    private reinitializeIfEligible;
+    private initializeRenderer;
+    private restoreCursorAfterNavigation;
+    private resolveMotionStart;
+}
+
 interface CuaAgentHandlerOptions {
     page: Page;
     config: ResolvedAgentConfig;
     client: CuaClient;
-    debug: boolean;
+    cursorController: CursorController;
     onMutatingAction?: (action: OpensteerAgentAction) => void;
 }
 declare class OpensteerCuaAgentHandler {
     private readonly page;
     private readonly config;
     private readonly client;
-    private readonly debug;
+    private readonly cursorController;
     private readonly onMutatingAction?;
-    private cursorOverlayInjected;
     constructor(options: CuaAgentHandlerOptions);
     execute(options: OpensteerAgentExecuteOptions): Promise<OpensteerAgentResult>;
     private initializeClient;
     private resolveViewport;
-    private maybeRenderCursor;
+    private maybePreviewCursor;
+}
+
+interface SnappyMotionOptions {
+    minDurationMs?: number;
+    maxDurationMs?: number;
+    maxPoints?: number;
+}
+declare function planSnappyCursorMotion(from: CursorPoint, to: CursorPoint, options?: SnappyMotionOptions): CursorMotionPlan;
+
+declare class CdpOverlayCursorRenderer implements CursorRenderer {
+    private page;
+    private session;
+    private active;
+    private reason;
+    private lastMessage;
+    private lastPoint;
+    initialize(page: Page): Promise<void>;
+    isActive(): boolean;
+    status(): CursorStatus;
+    move(point: CursorPoint, style: Required<OpensteerCursorStyle>): Promise<void>;
+    pulse(point: CursorPoint, style: Required<OpensteerCursorStyle>): Promise<void>;
+    clear(): Promise<void>;
+    dispose(): Promise<void>;
+    private sendWithRecovery;
+    private createSession;
+    private cleanupSession;
+    private markInactive;
 }
 
-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 CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, 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 OpensteerAgentAction, OpensteerAgentActionError, OpensteerAgentApiError, OpensteerAgentBusyError, type OpensteerAgentConfig, OpensteerAgentConfigError, OpensteerAgentError, type OpensteerAgentExecuteOptions, OpensteerAgentExecutionError, type OpensteerAgentInstance, type OpensteerAgentMode, type OpensteerAgentModelConfig, type OpensteerAgentProvider, OpensteerAgentProviderError, type OpensteerAgentResult, type OpensteerAgentUsage, type OpensteerAuthScheme, type OpensteerBrowserConfig, type OpensteerCloudAnnouncePolicy, type OpensteerCloudConfig, OpensteerCloudError, type OpensteerCloudOptions, type OpensteerConfig, OpensteerCuaAgentHandler, 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, buildArrayFieldPathCandidates, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, cloudNotLaunchedError, cloudSessionContractVersion, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createCuaClient, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, prepareSnapshot, pressKey, queryAllByElementPath, resolveAgentConfig, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };
+/**
+ * Injects a real SVG cursor into the page via a Shadow DOM host.
+ *
+ * Stealth considerations:
+ * - Shadow DOM hides internal structure from page querySelectorAll
+ * - pointer-events: none so it never intercepts page interactions
+ * - No detectable side-effects on page behavior
+ * - Anti-bot systems look for navigator.webdriver, fingerprints, and timing —
+ *   not DOM overlays
+ *
+ * Performance:
+ * - Single absolutely-positioned element moved via CSS transform (GPU-composited)
+ * - No CDP round-trips per frame — just page.evaluate calls
+ * - Much faster than Overlay.highlightQuad protocol calls
+ */
+declare class SvgCursorRenderer implements CursorRenderer {
+    private page;
+    private active;
+    private reason;
+    private lastMessage;
+    initialize(page: Page): Promise<void>;
+    isActive(): boolean;
+    status(): CursorStatus;
+    move(point: CursorPoint, style: Required<OpensteerCursorStyle>): Promise<void>;
+    pulse(point: CursorPoint, style: Required<OpensteerCursorStyle>): Promise<void>;
+    clear(): Promise<void>;
+    dispose(): Promise<void>;
+    private reinject;
+    private markInactive;
+    private handleError;
+}
+
+export { type ActionExecutionResult, ActionFailure, ActionFailureCode, ActionResult, ActionWsClient, AiExtractCallback, type AiModelConfig, AiResolveCallback, type ArrayExtractedRow, type ArrayRowMetadata, type ArraySelector, BaseActionOptions, BoundingBox, CdpOverlayCursorRenderer, ClickOptions, CloudActionFailureDetails, CloudActionMethod, CloudCdpClient, type CloudCdpConnectArgs, type CloudCdpConnection, CloudErrorCode, CloudSelectorCacheImportEntry, CloudSelectorCacheImportRequest, CloudSelectorCacheImportResponse, CloudSessionClient, CloudSessionCreateRequest, CloudSessionCreateResponse, CookieParam, type CounterRequest, CounterResolutionError, type CounterResolutionErrorCode, type CursorCapabilityReason, CursorController, type CursorIntent, type CursorMotionPlan, type CursorPoint, type CursorRenderer, type CursorStatus, ElementPath, ElementPathError, type ElementPathErrorCode, ExtractFromPlanOptions, ExtractOptions, ExtractionRunResult, type FieldSelector, FileUploadOptions, GotoOptions, HoverOptions, InputOptions, LaunchOptions, LocalSelectorStorage, type MarkInteractivityOptions, 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, OpensteerAgentAction, OpensteerAgentActionError, OpensteerAgentApiError, OpensteerAgentBusyError, OpensteerAgentConfig, OpensteerAgentConfigError, OpensteerAgentError, OpensteerAgentExecuteOptions, OpensteerAgentExecutionError, OpensteerAgentInstance, OpensteerAgentProvider, OpensteerAgentProviderError, OpensteerAgentResult, OpensteerAgentUsage, OpensteerAuthScheme, OpensteerCloudError, OpensteerConfig, OpensteerCuaAgentHandler, OpensteerCursorConfig, OpensteerCursorState, OpensteerCursorStyle, type PreparedSnapshot, type RegistryEntry, type ResolvedElementPath, ScreenshotOptions, ScrollOptions, SelectOptions, type SelectorFile, type SelectorRegistry, type SerializeOptions, type SerializedNodeMeta, type SerializedPageHTML, SnapshotMode, SnapshotOptions, StateResult, SvgCursorRenderer, TabInfo, buildArrayFieldPathCandidates, buildElementPathFromHandle, buildElementPathFromSelector, buildPathSelectorHint, cleanForAction, cleanForClickable, cleanForExtraction, cleanForFull, cleanForScrollable, clearCookies, cloneElementPath, closeTab, cloudNotLaunchedError, cloudUnsupportedMethodError, collectLocalSelectorCacheEntries, countArrayItemsWithPath, createCuaClient, createEmptyRegistry, createExtractCallback, createResolveCallback, createTab, exportCookies, extractArrayRowsWithPaths, extractArrayWithPaths, extractWithPaths, getCookies, getElementAttributes, getElementBoundingBox, getElementText, getElementValue, getModelProvider, getPageHtml, getPageTitle, importCookies, listTabs, markInteractiveElements, normalizeNamespace, performClick, performFileUpload, performHover, performInput, performScroll, performSelect, planSnappyCursorMotion, prepareSnapshot, pressKey, queryAllByElementPath, resolveAgentConfig, resolveCounterElement, resolveCountersBatch, resolveElementPath, resolveNamespaceDir, sanitizeElementPath, serializePageHTML, setCookie, switchTab, typeText, waitForVisualStability };