@browserbasehq/orca 3.0.8-stable-1 → 3.0.9-alpha-2

package/dist/index.d.ts

@@ -191,6 +191,7 @@ declare class Frame implements FrameManager {
     private getMainWorldExecutionContextId;
 }
 
+type MouseButton = "left" | "right" | "middle";
 interface SetInputFilePayload {
     name: string;
     mimeType?: string;
@@ -199,7 +200,6 @@ interface SetInputFilePayload {
 }
 type SetInputFilesArgument = string | string[] | SetInputFilePayload | SetInputFilePayload[];
 
-type MouseButton = "left" | "right" | "middle";
 /**
  * Locator
  *
@@ -367,7 +367,7 @@ declare class Locator {
      */
     innerText(): Promise<string>;
     /**
-     * For API parity, returns the same locator (querySelector already returns the first match).
+     * Return a locator narrowed to the first match.
      */
     first(): Locator;
     /** Return a locator narrowed to the element at the given zero-based index. */
@@ -380,6 +380,14 @@ declare class Locator {
         nodeId: Protocol.DOM.NodeId | null;
         objectId: Protocol.Runtime.RemoteObjectId;
     }>;
+    /**
+     * Resolve all matching nodes for this locator.
+     * If the locator is narrowed via nth(), only that index is returned.
+     */
+    resolveNodesForMask(): Promise<Array<{
+        nodeId: Protocol.DOM.NodeId | null;
+        objectId: Protocol.Runtime.RemoteObjectId;
+    }>>;
     /** Compute a center point from a BoxModel content quad */
     private centerFromBoxContent;
 }
@@ -476,7 +484,8 @@ declare class FrameLocator {
 declare class LocatorDelegate {
     private readonly fl;
     private readonly sel;
-    constructor(fl: FrameLocator, sel: string);
+    private readonly nthIndex;
+    constructor(fl: FrameLocator, sel: string, nthIndex?: number);
     private real;
     click(options?: {
         button?: "left" | "right" | "middle";
@@ -497,6 +506,7 @@ declare class LocatorDelegate {
     innerText(): Promise<string>;
     count(): Promise<number>;
     first(): LocatorDelegate;
+    nth(index: number): LocatorDelegate;
 }
 
 type RemoteObject = Protocol.Runtime.RemoteObject;
@@ -1283,6 +1293,22 @@ declare const AgentConfigSchema: z$1.ZodObject<{
     }, z$1.core.$strip>, z$1.ZodString]>>;
     systemPrompt: z$1.ZodOptional<z$1.ZodString>;
     cua: z$1.ZodOptional<z$1.ZodBoolean>;
+    mode: z$1.ZodOptional<z$1.ZodEnum<{
+        cua: "cua";
+        dom: "dom";
+        hybrid: "hybrid";
+    }>>;
+    executionModel: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
+        provider: z$1.ZodOptional<z$1.ZodEnum<{
+            openai: "openai";
+            anthropic: "anthropic";
+            google: "google";
+            microsoft: "microsoft";
+        }>>;
+        modelName: z$1.ZodString;
+        apiKey: z$1.ZodOptional<z$1.ZodString>;
+        baseURL: z$1.ZodOptional<z$1.ZodString>;
+    }, z$1.core.$strip>, z$1.ZodString]>>;
 }, z$1.core.$strip>;
 /** Action taken by the agent during execution */
 declare const AgentActionSchema: z$1.ZodObject<{
@@ -1357,6 +1383,22 @@ declare const AgentExecuteRequestSchema: z$1.ZodObject<{
         }, z$1.core.$strip>, z$1.ZodString]>>;
         systemPrompt: z$1.ZodOptional<z$1.ZodString>;
         cua: z$1.ZodOptional<z$1.ZodBoolean>;
+        mode: z$1.ZodOptional<z$1.ZodEnum<{
+            cua: "cua";
+            dom: "dom";
+            hybrid: "hybrid";
+        }>>;
+        executionModel: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodObject<{
+            provider: z$1.ZodOptional<z$1.ZodEnum<{
+                openai: "openai";
+                anthropic: "anthropic";
+                google: "google";
+                microsoft: "microsoft";
+            }>>;
+            modelName: z$1.ZodString;
+            apiKey: z$1.ZodOptional<z$1.ZodString>;
+            baseURL: z$1.ZodOptional<z$1.ZodString>;
+        }, z$1.core.$strip>, z$1.ZodString]>>;
     }, z$1.core.$strip>;
     executeOptions: z$1.ZodObject<{
         instruction: z$1.ZodString;
@@ -2877,6 +2919,7 @@ declare class Page {
      * Supports iframe hop notation with '>>' (e.g., 'iframe#checkout >> .submit-btn').
      *
      * @param selector CSS selector to wait for (supports '>>' for iframe hops)
+     * @param options
      * @param options.state Element state to wait for: 'attached' | 'detached' | 'visible' | 'hidden' (default: 'visible')
      * @param options.timeout Maximum time to wait in milliseconds (default: 30000)
      * @param options.pierceShadow Whether to search inside shadow DOM (default: true)