browserscale-ts 1.2.1 → 1.3.0

package/dist/gen/wrc_pb.d.ts

@@ -637,18 +637,298 @@ export type ClickResult = Message<"browserscale.v1.ClickResult"> & {
  * Use `create(ClickResultSchema)` to create a new message.
  */
 export declare const ClickResultSchema: GenMessage<ClickResult>;
+/**
+ * ReactionInfo (WRC.pdl ReactionInfo) describes a still-pending reaction as
+ * returned by ListReactions. One-shot reactions that already fired are gone.
+ *
+ * @generated from message browserscale.v1.ReactionInfo
+ */
+export type ReactionInfo = Message<"browserscale.v1.ReactionInfo"> & {
+    /**
+     * Stable id assigned by AddReaction; pass to RemoveReaction.
+     *
+     * @generated from field: string reaction_id = 1;
+     */
+    reactionId: string;
+    /**
+     * The match's CSS selector, if it matches by selector.
+     *
+     * @generated from field: optional string match_selector = 2;
+     */
+    matchSelector?: string;
+    /**
+     * The match's JS expression, if it matches by expression.
+     *
+     * @generated from field: optional string match_js_expression = 3;
+     */
+    matchJsExpression?: string;
+    /**
+     * Click-target selector, if the action targets a different element.
+     *
+     * @generated from field: optional string action_selector = 4;
+     */
+    actionSelector?: string;
+    /**
+     * Click-target JS expression, if the action targets a different element.
+     *
+     * @generated from field: optional string action_js_expression = 5;
+     */
+    actionJsExpression?: string;
+    /**
+     * Frame scope: a specific frameId, empty for the main frame, or "ALL_FRAMES".
+     *
+     * @generated from field: string frame_id = 6;
+     */
+    frameId: string;
+    /**
+     * Whether the match additionally requires the element to be visible.
+     *
+     * @generated from field: bool visible = 7;
+     */
+    visible: boolean;
+};
+/**
+ * Describes the message browserscale.v1.ReactionInfo.
+ * Use `create(ReactionInfoSchema)` to create a new message.
+ */
+export declare const ReactionInfoSchema: GenMessage<ReactionInfo>;
+/**
+ * @generated from message browserscale.v1.AddReactionRequest
+ */
+export type AddReactionRequest = Message<"browserscale.v1.AddReactionRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: string page_id = 3;
+     */
+    pageId: string;
+    /**
+     * Exactly one of match_selector / match_js_expression must be set.
+     *
+     * @generated from field: optional string match_selector = 4;
+     */
+    matchSelector?: string;
+    /**
+     * @generated from field: optional string match_js_expression = 5;
+     */
+    matchJsExpression?: string;
+    /**
+     * Where to watch: a specific frameId, empty/omitted for the main frame, or
+     * "ALL_FRAMES" to watch every frame.
+     *
+     * @generated from field: optional string frame_id = 6;
+     */
+    frameId?: string;
+    /**
+     * Require the matched element to be visible before firing.
+     *
+     * @generated from field: optional bool visible = 7;
+     */
+    visible?: boolean;
+    /**
+     * Optional click-target CSS selector, resolved in the matched element's
+     * frame. Omitted → click the matched element itself.
+     *
+     * @generated from field: optional string action_selector = 8;
+     */
+    actionSelector?: string;
+    /**
+     * Optional click-target JS expression (mutually exclusive with
+     * action_selector).
+     *
+     * @generated from field: optional string action_js_expression = 9;
+     */
+    actionJsExpression?: string;
+    /**
+     * "left" (default), "right", or "middle".
+     *
+     * @generated from field: optional string button = 10;
+     */
+    button?: string;
+    /**
+     * 1 = single click (default), 2 = double click.
+     *
+     * @generated from field: optional int32 click_count = 11;
+     */
+    clickCount?: number;
+    /**
+     * Poll cadence in ms for the shared page loop. Default 300.
+     *
+     * @generated from field: optional double interval = 12;
+     */
+    interval?: number;
+};
+/**
+ * Describes the message browserscale.v1.AddReactionRequest.
+ * Use `create(AddReactionRequestSchema)` to create a new message.
+ */
+export declare const AddReactionRequestSchema: GenMessage<AddReactionRequest>;
+/**
+ * @generated from message browserscale.v1.AddReactionResponse
+ */
+export type AddReactionResponse = Message<"browserscale.v1.AddReactionResponse"> & {
+    /**
+     * Id of the registered reaction (pass to RemoveReaction).
+     *
+     * @generated from field: string reaction_id = 1;
+     */
+    reactionId: string;
+};
+/**
+ * Describes the message browserscale.v1.AddReactionResponse.
+ * Use `create(AddReactionResponseSchema)` to create a new message.
+ */
+export declare const AddReactionResponseSchema: GenMessage<AddReactionResponse>;
+/**
+ * @generated from message browserscale.v1.RemoveReactionRequest
+ */
+export type RemoveReactionRequest = Message<"browserscale.v1.RemoveReactionRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * Id returned by AddReaction.
+     *
+     * @generated from field: string reaction_id = 3;
+     */
+    reactionId: string;
+};
+/**
+ * Describes the message browserscale.v1.RemoveReactionRequest.
+ * Use `create(RemoveReactionRequestSchema)` to create a new message.
+ */
+export declare const RemoveReactionRequestSchema: GenMessage<RemoveReactionRequest>;
+/**
+ * @generated from message browserscale.v1.RemoveReactionResponse
+ */
+export type RemoveReactionResponse = Message<"browserscale.v1.RemoveReactionResponse"> & {
+    /**
+     * True if a pending reaction with this id existed and was removed.
+     *
+     * @generated from field: bool removed = 1;
+     */
+    removed: boolean;
+};
+/**
+ * Describes the message browserscale.v1.RemoveReactionResponse.
+ * Use `create(RemoveReactionResponseSchema)` to create a new message.
+ */
+export declare const RemoveReactionResponseSchema: GenMessage<RemoveReactionResponse>;
+/**
+ * @generated from message browserscale.v1.ListReactionsRequest
+ */
+export type ListReactionsRequest = Message<"browserscale.v1.ListReactionsRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: string page_id = 3;
+     */
+    pageId: string;
+};
+/**
+ * Describes the message browserscale.v1.ListReactionsRequest.
+ * Use `create(ListReactionsRequestSchema)` to create a new message.
+ */
+export declare const ListReactionsRequestSchema: GenMessage<ListReactionsRequest>;
+/**
+ * @generated from message browserscale.v1.ListReactionsResponse
+ */
+export type ListReactionsResponse = Message<"browserscale.v1.ListReactionsResponse"> & {
+    /**
+     * @generated from field: repeated browserscale.v1.ReactionInfo reactions = 1;
+     */
+    reactions: ReactionInfo[];
+};
+/**
+ * Describes the message browserscale.v1.ListReactionsResponse.
+ * Use `create(ListReactionsResponseSchema)` to create a new message.
+ */
+export declare const ListReactionsResponseSchema: GenMessage<ListReactionsResponse>;
 /**
  * Error detail for a Fill that did not complete. Present in FillResult iff
  * success is false. Fill focuses the field with the exact same smart click as
  * Click, so any pre-typing failure is a click failure: code/message mirror it
  * and the full click diagnostics are nested under click_error.
+ * ElementRef is a lightweight descriptor of an element — enough for an agent to
+ * identify it (and decide what to do) without another DOM round-trip. Used to
+ * name the element that stole focus in a fill focus-loss failure.
  *
+ * @generated from message browserscale.v1.ElementRef
+ */
+export type ElementRef = Message<"browserscale.v1.ElementRef"> & {
+    /**
+     * @generated from field: int32 backend_node_id = 1;
+     */
+    backendNodeId: number;
+    /**
+     * Upper-case tag name, e.g. "INPUT", "BUTTON", "DIV".
+     *
+     * @generated from field: string tag_name = 2;
+     */
+    tagName: string;
+    /**
+     * @generated from field: optional string id = 3;
+     */
+    id?: string;
+    /**
+     * @generated from field: optional string name = 4;
+     */
+    name?: string;
+    /**
+     * @generated from field: optional string class_name = 5;
+     */
+    className?: string;
+    /**
+     * <input> type, if the element is an <input>.
+     *
+     * @generated from field: optional string input_type = 6;
+     */
+    inputType?: string;
+    /**
+     * Whitespace-collapsed textContent/value snippet (max 120 chars).
+     *
+     * @generated from field: optional string text = 7;
+     */
+    text?: string;
+    /**
+     * Whether this element is itself an editable text sink (input/textarea/
+     * contenteditable).
+     *
+     * @generated from field: bool editable = 8;
+     */
+    editable: boolean;
+};
+/**
+ * Describes the message browserscale.v1.ElementRef.
+ * Use `create(ElementRefSchema)` to create a new message.
+ */
+export declare const ElementRefSchema: GenMessage<ElementRef>;
+/**
  * @generated from message browserscale.v1.FillError
  */
 export type FillError = Message<"browserscale.v1.FillError"> & {
     /**
-     * Mirrored from the underlying click failure: "not_found",
-     * "occluded_no_reachable_point" or "occluded_after_evade".
+     * "not_found", "occluded_no_reachable_point", "occluded_after_evade"
+     * (mirrored from the underlying focus click; diagnostics under click_error),
+     * "focus_stolen" (another element took focus; focused_element names it) or
+     * "focus_lost" (focus left the target and nothing is focused).
      *
      * @generated from field: string code = 1;
      */
@@ -658,11 +938,38 @@ export type FillError = Message<"browserscale.v1.FillError"> & {
      */
     message: string;
     /**
-     * The underlying click-core failure that prevented focusing/typing.
+     * The underlying click-core failure that prevented focusing/typing. Present
+     * for the click-phase codes; absent for "focus_stolen"/"focus_lost".
      *
      * @generated from field: optional browserscale.v1.ClickError click_error = 3;
      */
     clickError?: ClickError;
+    /**
+     * For "focus_stolen"/"focus_lost": backendNodeId that held focus when fill
+     * gave up (0 if nothing was focused). Diagnostic only.
+     *
+     * @generated from field: optional int32 focused_backend_node_id = 4;
+     */
+    focusedBackendNodeId?: number;
+    /**
+     * For "focus_stolen": full descriptor of the element that holds focus
+     * instead of the target, so the agent can act on it.
+     *
+     * @generated from field: optional browserscale.v1.ElementRef focused_element = 5;
+     */
+    focusedElement?: ElementRef;
+    /**
+     * The fill target's own state at the point of failure: whether it is still an
+     * editable text sink, and its current text length. Present for the focus_*
+     * codes; lets the agent tell "field vanished/readonly" from "focus stolen".
+     *
+     * @generated from field: optional bool target_editable = 6;
+     */
+    targetEditable?: boolean;
+    /**
+     * @generated from field: optional int32 target_value_length = 7;
+     */
+    targetValueLength?: number;
 };
 /**
  * Describes the message browserscale.v1.FillError.
@@ -1590,6 +1897,21 @@ export type FillRequest = Message<"browserscale.v1.FillRequest"> & {
      * @generated from field: optional bool clear_first = 9;
      */
     clearFirst?: boolean;
+    /**
+     * Budget in ms to make the field focusable+clickable before giving up
+     * (locate, scroll, settle, un-occlude); mirrors Click's timeout. Omit for
+     * the server default (5000). 0 = one-shot (no retry).
+     *
+     * @generated from field: optional double timeout = 10;
+     */
+    timeout?: number;
+    /**
+     * Settle window in ms before the focus click; mirrors Click's steady_time.
+     * Omit for the server default (750). 0 skips settling.
+     *
+     * @generated from field: optional double steady_time = 11;
+     */
+    steadyTime?: number;
 };
 /**
  * Describes the message browserscale.v1.FillRequest.
@@ -2288,6 +2610,44 @@ export type InsertTextRequest = Message<"browserscale.v1.InsertTextRequest"> & {
  * Use `create(InsertTextRequestSchema)` to create a new message.
  */
 export declare const InsertTextRequestSchema: GenMessage<InsertTextRequest>;
+/**
+ * Type dispatches `text` as a per-key stream of real keyboard events to the
+ * currently focused element (untargeted, no focus pinning) — unlike InsertText,
+ * which is a single IME-style commit. Focus may move between fields mid-stream
+ * (e.g. OTP inputs that auto-advance on each digit). For a strict, target-bound
+ * value that must stay focused, use Fill instead.
+ *
+ * @generated from message browserscale.v1.TypeRequest
+ */
+export type TypeRequest = Message<"browserscale.v1.TypeRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: string page_id = 3;
+     */
+    pageId: string;
+    /**
+     * @generated from field: string text = 4;
+     */
+    text: string;
+    /**
+     * Clear the currently focused field first (Ctrl+A, Delete). Default false.
+     *
+     * @generated from field: optional bool clear_first = 5;
+     */
+    clearFirst?: boolean;
+};
+/**
+ * Describes the message browserscale.v1.TypeRequest.
+ * Use `create(TypeRequestSchema)` to create a new message.
+ */
+export declare const TypeRequestSchema: GenMessage<TypeRequest>;
 /**
  * Fires a single key-down (PressKey) or key-up (ReleaseKey) event. For
  * full press cycles (down + char + up) call PressKey followed by ReleaseKey,
@@ -2659,6 +3019,136 @@ export type SolveCaptchaResponse = Message<"browserscale.v1.SolveCaptchaResponse
  * Use `create(SolveCaptchaResponseSchema)` to create a new message.
  */
 export declare const SolveCaptchaResponseSchema: GenMessage<SolveCaptchaResponse>;
+/**
+ * IceServer is one entry for an RTCPeerConnection's iceServers config: a TURN
+ * (or STUN) URL plus the short-lived REST credentials to authenticate with it.
+ *
+ * @generated from message browserscale.v1.IceServer
+ */
+export type IceServer = Message<"browserscale.v1.IceServer"> & {
+    /**
+     * @generated from field: repeated string urls = 1;
+     */
+    urls: string[];
+    /**
+     * @generated from field: optional string username = 2;
+     */
+    username?: string;
+    /**
+     * @generated from field: optional string credential = 3;
+     */
+    credential?: string;
+};
+/**
+ * Describes the message browserscale.v1.IceServer.
+ * Use `create(IceServerSchema)` to create a new message.
+ */
+export declare const IceServerSchema: GenMessage<IceServer>;
+/**
+ * @generated from message browserscale.v1.GetStreamConfigRequest
+ */
+export type GetStreamConfigRequest = Message<"browserscale.v1.GetStreamConfigRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.GetStreamConfigRequest.
+ * Use `create(GetStreamConfigRequestSchema)` to create a new message.
+ */
+export declare const GetStreamConfigRequestSchema: GenMessage<GetStreamConfigRequest>;
+/**
+ * @generated from message browserscale.v1.GetStreamConfigResponse
+ */
+export type GetStreamConfigResponse = Message<"browserscale.v1.GetStreamConfigResponse"> & {
+    /**
+     * TURN/STUN servers with short-lived credentials. Put these in the client's
+     * RTCPeerConnection config BEFORE creating the offer, so it can gather relay
+     * candidates.
+     *
+     * @generated from field: repeated browserscale.v1.IceServer ice_servers = 1;
+     */
+    iceServers: IceServer[];
+};
+/**
+ * Describes the message browserscale.v1.GetStreamConfigResponse.
+ * Use `create(GetStreamConfigResponseSchema)` to create a new message.
+ */
+export declare const GetStreamConfigResponseSchema: GenMessage<GetStreamConfigResponse>;
+/**
+ * @generated from message browserscale.v1.StartStreamRequest
+ */
+export type StartStreamRequest = Message<"browserscale.v1.StartStreamRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * The client's SDP offer. The browser sets it as the remote description and
+     * returns its answer. Relay policy, frame rate and bitrate are decided by the
+     * server — the client only offers.
+     *
+     * @generated from field: string offer_sdp = 3;
+     */
+    offerSdp: string;
+};
+/**
+ * Describes the message browserscale.v1.StartStreamRequest.
+ * Use `create(StartStreamRequestSchema)` to create a new message.
+ */
+export declare const StartStreamRequestSchema: GenMessage<StartStreamRequest>;
+/**
+ * @generated from message browserscale.v1.StartStreamResponse
+ */
+export type StartStreamResponse = Message<"browserscale.v1.StartStreamResponse"> & {
+    /**
+     * The browser's SDP answer to set as the client's remote description.
+     *
+     * @generated from field: string answer_sdp = 1;
+     */
+    answerSdp: string;
+};
+/**
+ * Describes the message browserscale.v1.StartStreamResponse.
+ * Use `create(StartStreamResponseSchema)` to create a new message.
+ */
+export declare const StartStreamResponseSchema: GenMessage<StartStreamResponse>;
+/**
+ * @generated from message browserscale.v1.StopStreamRequest
+ */
+export type StopStreamRequest = Message<"browserscale.v1.StopStreamRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.StopStreamRequest.
+ * Use `create(StopStreamRequestSchema)` to create a new message.
+ */
+export declare const StopStreamRequestSchema: GenMessage<StopStreamRequest>;
+/**
+ * @generated from message browserscale.v1.StopStreamResponse
+ */
+export type StopStreamResponse = Message<"browserscale.v1.StopStreamResponse"> & {};
+/**
+ * Describes the message browserscale.v1.StopStreamResponse.
+ * Use `create(StopStreamResponseSchema)` to create a new message.
+ */
+export declare const StopStreamResponseSchema: GenMessage<StopStreamResponse>;
 /**
  * @generated from service browserscale.v1.Browser
  */
@@ -2777,6 +3267,34 @@ export declare const Browser: GenService<{
         input: typeof FillRequestSchema;
         output: typeof FillResultSchema;
     };
+    /**
+     * Reactions — one-shot background auto-click when a condition matches. A
+     * shared per-page poller fires only while the pointer is idle, so a reaction
+     * slots into the gaps of a retrying foreground action.
+     *
+     * @generated from rpc browserscale.v1.Browser.AddReaction
+     */
+    addReaction: {
+        methodKind: "unary";
+        input: typeof AddReactionRequestSchema;
+        output: typeof AddReactionResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.RemoveReaction
+     */
+    removeReaction: {
+        methodKind: "unary";
+        input: typeof RemoveReactionRequestSchema;
+        output: typeof RemoveReactionResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.ListReactions
+     */
+    listReactions: {
+        methodKind: "unary";
+        input: typeof ListReactionsRequestSchema;
+        output: typeof ListReactionsResponseSchema;
+    };
     /**
      * Network interception
      *
@@ -2941,6 +3459,14 @@ export declare const Browser: GenService<{
         input: typeof InsertTextRequestSchema;
         output: typeof EmptySchema;
     };
+    /**
+     * @generated from rpc browserscale.v1.Browser.Type
+     */
+    type: {
+        methodKind: "unary";
+        input: typeof TypeRequestSchema;
+        output: typeof EmptySchema;
+    };
     /**
      * @generated from rpc browserscale.v1.Browser.PressKey
      */
@@ -2975,4 +3501,34 @@ export declare const Browser: GenService<{
         input: typeof SolveCaptchaRequestSchema;
         output: typeof SolveCaptchaResponseSchema;
     };
+    /**
+     * Live streaming (WebRTC). The page is streamed as a video track over a
+     * WebRTC PeerConnection whose media is relayed through the TURN server. The
+     * caller creates the offer (client-offerer); the browser answers it.
+     * GetStreamConfig first hands out the ICE servers the client needs to build
+     * that offer.
+     *
+     * @generated from rpc browserscale.v1.Browser.GetStreamConfig
+     */
+    getStreamConfig: {
+        methodKind: "unary";
+        input: typeof GetStreamConfigRequestSchema;
+        output: typeof GetStreamConfigResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StartStream
+     */
+    startStream: {
+        methodKind: "unary";
+        input: typeof StartStreamRequestSchema;
+        output: typeof StartStreamResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StopStream
+     */
+    stopStream: {
+        methodKind: "unary";
+        input: typeof StopStreamRequestSchema;
+        output: typeof StopStreamResponseSchema;
+    };
 }>;