browserscale-ts 1.4.0 → 1.7.0

package/dist/gen/wrc_pb.d.ts

@@ -2129,6 +2129,276 @@ export type ModifyRequestResponse = Message<"browserscale.v1.ModifyRequestRespon
  * Use `create(ModifyRequestResponseSchema)` to create a new message.
  */
 export declare const ModifyRequestResponseSchema: GenMessage<ModifyRequestResponse>;
+/**
+ * @generated from message browserscale.v1.StartNetworkCaptureRequest
+ */
+export type StartNetworkCaptureRequest = Message<"browserscale.v1.StartNetworkCaptureRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * URL wildcards to capture; empty captures everything in the session.
+     * Prefix an entry with "!" to exclude it.
+     *
+     * @generated from field: repeated string patterns = 3;
+     */
+    patterns: string[];
+    /**
+     * Response body capture: "none" (default), "text" or "all".
+     *
+     * @generated from field: string bodies = 4;
+     */
+    bodies: string;
+    /**
+     * Narrows body capture further; empty applies `bodies` to every captured
+     * exchange.
+     *
+     * @generated from field: repeated string body_patterns = 5;
+     */
+    bodyPatterns: string[];
+};
+/**
+ * Describes the message browserscale.v1.StartNetworkCaptureRequest.
+ * Use `create(StartNetworkCaptureRequestSchema)` to create a new message.
+ */
+export declare const StartNetworkCaptureRequestSchema: GenMessage<StartNetworkCaptureRequest>;
+/**
+ * @generated from message browserscale.v1.StopNetworkCaptureRequest
+ */
+export type StopNetworkCaptureRequest = Message<"browserscale.v1.StopNetworkCaptureRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.StopNetworkCaptureRequest.
+ * Use `create(StopNetworkCaptureRequestSchema)` to create a new message.
+ */
+export declare const StopNetworkCaptureRequestSchema: GenMessage<StopNetworkCaptureRequest>;
+/**
+ * @generated from message browserscale.v1.StopNetworkCaptureResponse
+ */
+export type StopNetworkCaptureResponse = Message<"browserscale.v1.StopNetworkCaptureResponse"> & {
+    /**
+     * False if no capture was running for this session.
+     *
+     * @generated from field: bool stopped = 1;
+     */
+    stopped: boolean;
+};
+/**
+ * Describes the message browserscale.v1.StopNetworkCaptureResponse.
+ * Use `create(StopNetworkCaptureResponseSchema)` to create a new message.
+ */
+export declare const StopNetworkCaptureResponseSchema: GenMessage<StopNetworkCaptureResponse>;
+/**
+ * @generated from message browserscale.v1.StreamNetworkExchangesRequest
+ */
+export type StreamNetworkExchangesRequest = Message<"browserscale.v1.StreamNetworkExchangesRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.StreamNetworkExchangesRequest.
+ * Use `create(StreamNetworkExchangesRequestSchema)` to create a new message.
+ */
+export declare const StreamNetworkExchangesRequestSchema: GenMessage<StreamNetworkExchangesRequest>;
+/**
+ * @generated from message browserscale.v1.NetworkExchangeEvent
+ */
+export type NetworkExchangeEvent = Message<"browserscale.v1.NetworkExchangeEvent"> & {
+    /**
+     * @generated from field: browserscale.v1.NetworkExchange exchange = 1;
+     */
+    exchange?: NetworkExchange;
+    /**
+     * Cumulative exchanges dropped for this subscriber because it read slower
+     * than the page produced them. Non-zero means the log has holes.
+     *
+     * @generated from field: uint64 dropped = 2;
+     */
+    dropped: bigint;
+};
+/**
+ * Describes the message browserscale.v1.NetworkExchangeEvent.
+ * Use `create(NetworkExchangeEventSchema)` to create a new message.
+ */
+export declare const NetworkExchangeEventSchema: GenMessage<NetworkExchangeEvent>;
+/**
+ * One request together with the response it received.
+ *
+ * A redirect is not a special case: every hop is reported as its own exchange,
+ * sharing chain_id with its siblings and counting up redirect_index.
+ *
+ * @generated from message browserscale.v1.NetworkExchange
+ */
+export type NetworkExchange = Message<"browserscale.v1.NetworkExchange"> & {
+    /**
+     * Unique per hop.
+     *
+     * @generated from field: string request_id = 1;
+     */
+    requestId: string;
+    /**
+     * Shared by every hop of one redirect chain.
+     *
+     * @generated from field: string chain_id = 2;
+     */
+    chainId: string;
+    /**
+     * 0 for the original request, incremented once per redirect followed.
+     *
+     * @generated from field: int32 redirect_index = 3;
+     */
+    redirectIndex: number;
+    /**
+     * DevTools frame token of the originating frame; empty for workers.
+     *
+     * @generated from field: string frame_id = 4;
+     */
+    frameId: string;
+    /**
+     * Whether that frame runs in its own process.
+     *
+     * @generated from field: bool is_oopif = 5;
+     */
+    isOopif: boolean;
+    /**
+     * "document" | "subframe" | "script" | "stylesheet" | "image" | "font" |
+     * "media" | "fetch" | "worker" | "manifest" | "object" | "csp-report" |
+     * "other". fetch(), XMLHttpRequest and EventSource all report "fetch" —
+     * they are indistinguishable in the browser process.
+     *
+     * @generated from field: string resource_type = 6;
+     */
+    resourceType: string;
+    /**
+     * @generated from field: string method = 7;
+     */
+    method: string;
+    /**
+     * @generated from field: string url = 8;
+     */
+    url: string;
+    /**
+     * Origin that initiated the request; empty if browser-initiated.
+     *
+     * @generated from field: string initiator_url = 9;
+     */
+    initiatorUrl: string;
+    /**
+     * @generated from field: repeated browserscale.v1.Header request_headers = 10;
+     */
+    requestHeaders: Header[];
+    /**
+     * True when request_headers are the bytes actually put on the wire —
+     * Cookie, User-Agent, Sec-* and encoding included. False means they are what
+     * the renderer asked for, before the network service filled in the rest.
+     *
+     * @generated from field: bool request_headers_are_wire = 11;
+     */
+    requestHeadersAreWire: boolean;
+    /**
+     * Inline request body, capped by the browser. File and streamed uploads are
+     * not included; request_body_truncated is set when anything was left out.
+     *
+     * @generated from field: bytes request_body = 12;
+     */
+    requestBody: Uint8Array;
+    /**
+     * @generated from field: bool request_body_truncated = 13;
+     */
+    requestBodyTruncated: boolean;
+    /**
+     * False when the request failed before any response arrived.
+     *
+     * @generated from field: bool has_response = 14;
+     */
+    hasResponse: boolean;
+    /**
+     * @generated from field: int32 status_code = 15;
+     */
+    statusCode: number;
+    /**
+     * @generated from field: string status_text = 16;
+     */
+    statusText: string;
+    /**
+     * @generated from field: string mime_type = 17;
+     */
+    mimeType: string;
+    /**
+     * Negotiated ALPN protocol, e.g. "h2" or "http/1.1".
+     *
+     * @generated from field: string protocol = 18;
+     */
+    protocol: string;
+    /**
+     * @generated from field: string remote_address = 19;
+     */
+    remoteAddress: string;
+    /**
+     * "network" | "cache" | "serviceWorker" | "wrcStaticCache" | "wrcSynthetic"
+     *
+     * @generated from field: string served_from = 20;
+     */
+    servedFrom: string;
+    /**
+     * @generated from field: repeated browserscale.v1.Header response_headers = 21;
+     */
+    responseHeaders: Header[];
+    /**
+     * @generated from field: bool response_headers_are_wire = 22;
+     */
+    responseHeadersAreWire: boolean;
+    /**
+     * Populated only when body capture was requested and applied. Bodies cross
+     * the browser boundary as text, so binary content (bodies="all" on an image)
+     * does not arrive intact.
+     *
+     * @generated from field: bytes response_body = 23;
+     */
+    responseBody: Uint8Array;
+    /**
+     * @generated from field: bool response_body_truncated = 24;
+     */
+    responseBodyTruncated: boolean;
+    /**
+     * @generated from field: bool response_body_captured = 25;
+     */
+    responseBodyCaptured: boolean;
+    /**
+     * @generated from field: int64 encoded_data_length = 26;
+     */
+    encodedDataLength: bigint;
+    /**
+     * Net error name (e.g. "net::ERR_ABORTED"); empty on success.
+     *
+     * @generated from field: string error = 27;
+     */
+    error: string;
+};
+/**
+ * Describes the message browserscale.v1.NetworkExchange.
+ * Use `create(NetworkExchangeSchema)` to create a new message.
+ */
+export declare const NetworkExchangeSchema: GenMessage<NetworkExchange>;
 /**
  * @generated from message browserscale.v1.GetCookiesRequest
  */
@@ -2341,6 +2611,146 @@ export type ClearStorageRequest = Message<"browserscale.v1.ClearStorageRequest">
  * Use `create(ClearStorageRequestSchema)` to create a new message.
  */
 export declare const ClearStorageRequestSchema: GenMessage<ClearStorageRequest>;
+/**
+ * One Device Bound Session Credentials entry (WRC.DbscSession).
+ *
+ * @generated from message browserscale.v1.DbscSession
+ */
+export type DbscSession = Message<"browserscale.v1.DbscSession"> & {
+    /**
+     * Serialized net::SchemefulSite (eTLD+1 site key), e.g. "https://google.com".
+     *
+     * @generated from field: string site = 1;
+     */
+    site: string;
+    /**
+     * Base64 of the serialized net.device_bound_sessions.proto.Session
+     * (includes the wrapped binding key; portable under WRC's software
+     * UnexportableKeyProvider).
+     *
+     * @generated from field: string session = 2;
+     */
+    session: string;
+};
+/**
+ * Describes the message browserscale.v1.DbscSession.
+ * Use `create(DbscSessionSchema)` to create a new message.
+ */
+export declare const DbscSessionSchema: GenMessage<DbscSession>;
+/**
+ * Portable snapshot of a context's signed-in Google account and/or DBSC
+ * sessions (WRC.AuthSession). All fields optional so partial state round-trips.
+ *
+ * @generated from message browserscale.v1.AuthSession
+ */
+export type AuthSession = Message<"browserscale.v1.AuthSession"> & {
+    /**
+     * Gaia obfuscated account id.
+     *
+     * @generated from field: optional string gaia_id = 1;
+     */
+    gaiaId?: string;
+    /**
+     * Account email.
+     *
+     * @generated from field: optional string email = 2;
+     */
+    email?: string;
+    /**
+     * OAuth refresh token (persistent).
+     *
+     * @generated from field: optional string refresh_token = 3;
+     */
+    refreshToken?: string;
+    /**
+     * Base64 of the wrapped device-binding key for the refresh token.
+     * Empty/absent = unbound token.
+     *
+     * @generated from field: optional string wrapped_binding_key = 4;
+     */
+    wrappedBindingKey?: string;
+    /**
+     * Signin-scoped device id; must travel with the token.
+     *
+     * @generated from field: optional string signin_scoped_device_id = 5;
+     */
+    signinScopedDeviceId?: string;
+    /**
+     * True if the account should be restored at Sync consent.
+     *
+     * @generated from field: optional bool sync_consent = 6;
+     */
+    syncConsent?: boolean;
+    /**
+     * Device Bound Session Credentials for this context (all bound sites).
+     *
+     * @generated from field: repeated browserscale.v1.DbscSession dbsc_sessions = 7;
+     */
+    dbscSessions: DbscSession[];
+};
+/**
+ * Describes the message browserscale.v1.AuthSession.
+ * Use `create(AuthSessionSchema)` to create a new message.
+ */
+export declare const AuthSessionSchema: GenMessage<AuthSession>;
+/**
+ * @generated from message browserscale.v1.GetAuthSessionRequest
+ */
+export type GetAuthSessionRequest = Message<"browserscale.v1.GetAuthSessionRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.GetAuthSessionRequest.
+ * Use `create(GetAuthSessionRequestSchema)` to create a new message.
+ */
+export declare const GetAuthSessionRequestSchema: GenMessage<GetAuthSessionRequest>;
+/**
+ * @generated from message browserscale.v1.GetAuthSessionResponse
+ */
+export type GetAuthSessionResponse = Message<"browserscale.v1.GetAuthSessionResponse"> & {
+    /**
+     * Present only if the context has exportable auth/DBSC state.
+     *
+     * @generated from field: optional browserscale.v1.AuthSession session = 1;
+     */
+    session?: AuthSession;
+};
+/**
+ * Describes the message browserscale.v1.GetAuthSessionResponse.
+ * Use `create(GetAuthSessionResponseSchema)` to create a new message.
+ */
+export declare const GetAuthSessionResponseSchema: GenMessage<GetAuthSessionResponse>;
+/**
+ * @generated from message browserscale.v1.SetAuthSessionRequest
+ */
+export type SetAuthSessionRequest = Message<"browserscale.v1.SetAuthSessionRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * Session to import (as returned by GetAuthSession).
+     *
+     * @generated from field: browserscale.v1.AuthSession session = 3;
+     */
+    session?: AuthSession;
+};
+/**
+ * Describes the message browserscale.v1.SetAuthSessionRequest.
+ * Use `create(SetAuthSessionRequestSchema)` to create a new message.
+ */
+export declare const SetAuthSessionRequestSchema: GenMessage<SetAuthSessionRequest>;
 /**
  * @generated from message browserscale.v1.GetDOMRequest
  */
@@ -2540,9 +2950,9 @@ export type GetDOMHashResponse = Message<"browserscale.v1.GetDOMHashResponse"> &
  */
 export declare const GetDOMHashResponseSchema: GenMessage<GetDOMHashResponse>;
 /**
- * @generated from message browserscale.v1.InspectAtPositionRequest
+ * @generated from message browserscale.v1.StartDomMirrorRequest
  */
-export type InspectAtPositionRequest = Message<"browserscale.v1.InspectAtPositionRequest"> & {
+export type StartDomMirrorRequest = Message<"browserscale.v1.StartDomMirrorRequest"> & {
     /**
      * @generated from field: string session_id = 1;
      */
@@ -2552,49 +2962,428 @@ export type InspectAtPositionRequest = Message<"browserscale.v1.InspectAtPositio
      */
     apiKey: string;
     /**
-     * @generated from field: string page_id = 3;
-     */
-    pageId: string;
-    /**
-     * Viewport-relative CSS pixels.
+     * Levels to serialize up front. Default 2 (#document -> <html> ->
+     * <head>/<body>) — enough to draw a collapsed tree. -1 walks everything and
+     * defeats the point of the mirror.
      *
-     * @generated from field: double x = 4;
+     * @generated from field: optional int32 depth = 4;
      */
-    x: number;
+    depth?: number;
     /**
-     * @generated from field: double y = 5;
+     * Descend into author shadow roots. Fixed for the life of the mirror.
+     *
+     * @generated from field: optional bool pierce = 5;
      */
-    y: number;
+    pierce?: boolean;
 };
 /**
- * Describes the message browserscale.v1.InspectAtPositionRequest.
- * Use `create(InspectAtPositionRequestSchema)` to create a new message.
+ * Describes the message browserscale.v1.StartDomMirrorRequest.
+ * Use `create(StartDomMirrorRequestSchema)` to create a new message.
  */
-export declare const InspectAtPositionRequestSchema: GenMessage<InspectAtPositionRequest>;
+export declare const StartDomMirrorRequestSchema: GenMessage<StartDomMirrorRequest>;
 /**
- * @generated from message browserscale.v1.InspectAtPositionResponse
+ * @generated from message browserscale.v1.StartDomMirrorResponse
  */
-export type InspectAtPositionResponse = Message<"browserscale.v1.InspectAtPositionResponse"> & {
+export type StartDomMirrorResponse = Message<"browserscale.v1.StartDomMirrorResponse"> & {
     /**
-     * 0 if nothing was found at (x, y).
+     * The MAIN frame's document, CDP DOM.Node-shaped JSON, the same format
+     * GetDOM returns.
      *
-     * @generated from field: int32 backend_node_id = 1;
+     * An <iframe> in it reports child_node_count 1 without carrying that child:
+     * the document it hosts is fetched with GetDomChildren like any other child
+     * list, and asking is also what starts mirroring that frame.
+     *
+     * @generated from field: string root = 1;
      */
-    backendNodeId: number;
+    root: string;
     /**
+     * The page's main frame.
+     *
      * @generated from field: string frame_id = 2;
      */
     frameId: string;
     /**
-     * @generated from field: string tag_name = 3;
-     */
-    tagName: string;
-    /**
-     * Trimmed text content (max ~200 chars, server-imposed).
+     * The page sequence this snapshot is the baseline for. Every DomUpdate after
+     * it carries a higher one.
      *
-     * @generated from field: string text_content = 4;
+     * @generated from field: uint64 seq = 3;
      */
-    textContent: string;
+    seq: bigint;
+};
+/**
+ * Describes the message browserscale.v1.StartDomMirrorResponse.
+ * Use `create(StartDomMirrorResponseSchema)` to create a new message.
+ */
+export declare const StartDomMirrorResponseSchema: GenMessage<StartDomMirrorResponse>;
+/**
+ * @generated from message browserscale.v1.StopDomMirrorRequest
+ */
+export type StopDomMirrorRequest = Message<"browserscale.v1.StopDomMirrorRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.StopDomMirrorRequest.
+ * Use `create(StopDomMirrorRequestSchema)` to create a new message.
+ */
+export declare const StopDomMirrorRequestSchema: GenMessage<StopDomMirrorRequest>;
+/**
+ * @generated from message browserscale.v1.GetDomChildrenRequest
+ */
+export type GetDomChildrenRequest = Message<"browserscale.v1.GetDomChildrenRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: int32 backend_node_id = 3;
+     */
+    backendNodeId: number;
+    /**
+     * @generated from field: optional string frame_id = 4;
+     */
+    frameId?: string;
+    /**
+     * Levels below the node. Default 1.
+     *
+     * @generated from field: optional int32 depth = 5;
+     */
+    depth?: number;
+};
+/**
+ * Describes the message browserscale.v1.GetDomChildrenRequest.
+ * Use `create(GetDomChildrenRequestSchema)` to create a new message.
+ */
+export declare const GetDomChildrenRequestSchema: GenMessage<GetDomChildrenRequest>;
+/**
+ * @generated from message browserscale.v1.GetDomChildrenResponse
+ */
+export type GetDomChildrenResponse = Message<"browserscale.v1.GetDomChildrenResponse"> & {
+    /**
+     * JSON array of DOM.Node. Empty for an id this mirror never handed out,
+     * which is also what a stale id from before a resync looks like.
+     *
+     * On an <iframe>/<frame>/<object> the one child is the document it hosts,
+     * and this call is what starts mirroring that frame.
+     *
+     * @generated from field: string children = 1;
+     */
+    children: string;
+    /**
+     * Page sequence this payload is valid as of.
+     *
+     * @generated from field: uint64 seq = 2;
+     */
+    seq: bigint;
+};
+/**
+ * Describes the message browserscale.v1.GetDomChildrenResponse.
+ * Use `create(GetDomChildrenResponseSchema)` to create a new message.
+ */
+export declare const GetDomChildrenResponseSchema: GenMessage<GetDomChildrenResponse>;
+/**
+ * @generated from message browserscale.v1.ReleaseDomSubtreeRequest
+ */
+export type ReleaseDomSubtreeRequest = Message<"browserscale.v1.ReleaseDomSubtreeRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: int32 backend_node_id = 3;
+     */
+    backendNodeId: number;
+    /**
+     * @generated from field: optional string frame_id = 4;
+     */
+    frameId?: string;
+};
+/**
+ * Describes the message browserscale.v1.ReleaseDomSubtreeRequest.
+ * Use `create(ReleaseDomSubtreeRequestSchema)` to create a new message.
+ */
+export declare const ReleaseDomSubtreeRequestSchema: GenMessage<ReleaseDomSubtreeRequest>;
+/**
+ * @generated from message browserscale.v1.RevealDomNodeRequest
+ */
+export type RevealDomNodeRequest = Message<"browserscale.v1.RevealDomNodeRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: int32 backend_node_id = 3;
+     */
+    backendNodeId: number;
+    /**
+     * @generated from field: optional string frame_id = 4;
+     */
+    frameId?: string;
+};
+/**
+ * Describes the message browserscale.v1.RevealDomNodeRequest.
+ * Use `create(RevealDomNodeRequestSchema)` to create a new message.
+ */
+export declare const RevealDomNodeRequestSchema: GenMessage<RevealDomNodeRequest>;
+/**
+ * @generated from message browserscale.v1.RevealDomNodeResponse
+ */
+export type RevealDomNodeResponse = Message<"browserscale.v1.RevealDomNodeResponse"> & {
+    /**
+     * JSON array of DOM.Node, the MAIN document first, each carrying one level
+     * of children, crossing into frames at the document nodes along it. A
+     * document's frame_id is the id space its own backend_node_id and everything
+     * after it counts in. Empty if the node is not on the page.
+     *
+     * @generated from field: string path = 1;
+     */
+    path: string;
+    /**
+     * Page sequence this payload is valid as of.
+     *
+     * @generated from field: uint64 seq = 2;
+     */
+    seq: bigint;
+};
+/**
+ * Describes the message browserscale.v1.RevealDomNodeResponse.
+ * Use `create(RevealDomNodeResponseSchema)` to create a new message.
+ */
+export declare const RevealDomNodeResponseSchema: GenMessage<RevealDomNodeResponse>;
+/**
+ * @generated from message browserscale.v1.GetDomRevisionRequest
+ */
+export type GetDomRevisionRequest = Message<"browserscale.v1.GetDomRevisionRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * @generated from field: optional string frame_id = 3;
+     */
+    frameId?: string;
+};
+/**
+ * Describes the message browserscale.v1.GetDomRevisionRequest.
+ * Use `create(GetDomRevisionRequestSchema)` to create a new message.
+ */
+export declare const GetDomRevisionRequestSchema: GenMessage<GetDomRevisionRequest>;
+/**
+ * @generated from message browserscale.v1.GetDomRevisionResponse
+ */
+export type GetDomRevisionResponse = Message<"browserscale.v1.GetDomRevisionResponse"> & {
+    /**
+     * Monotonic counter, meaningful only within the current document.
+     *
+     * @generated from field: uint64 revision = 1;
+     */
+    revision: bigint;
+};
+/**
+ * Describes the message browserscale.v1.GetDomRevisionResponse.
+ * Use `create(GetDomRevisionResponseSchema)` to create a new message.
+ */
+export declare const GetDomRevisionResponseSchema: GenMessage<GetDomRevisionResponse>;
+/**
+ * @generated from message browserscale.v1.StreamDomEventsRequest
+ */
+export type StreamDomEventsRequest = Message<"browserscale.v1.StreamDomEventsRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+};
+/**
+ * Describes the message browserscale.v1.StreamDomEventsRequest.
+ * Use `create(StreamDomEventsRequestSchema)` to create a new message.
+ */
+export declare const StreamDomEventsRequestSchema: GenMessage<StreamDomEventsRequest>;
+/**
+ * One batch of edits to the revealed part of the page's DOM.
+ *
+ * @generated from message browserscale.v1.DomUpdate
+ */
+export type DomUpdate = Message<"browserscale.v1.DomUpdate"> & {
+    /**
+     * The id space these entries' node ids live in. Node ids restart per frame,
+     * so this is half of every address in the batch.
+     *
+     * @generated from field: string frame_id = 1;
+     */
+    frameId: string;
+    /**
+     * Page sequence AFTER applying this batch. One clock for the whole page: an
+     * edit in an OOPIF and one in the main document are ordered against each
+     * other because both passed through the browser in the order it saw them.
+     *
+     * @generated from field: uint64 seq = 2;
+     */
+    seq: bigint;
+    /**
+     * JSON array of entries, ordered, to be applied in order. See the domUpdate
+     * event in WRC.pdl for the entry shapes.
+     *
+     * A frame's document arriving or being replaced is an edit like any other: a
+     * childNodeInserted or childNodeRemoved on the <iframe> that hosts it, both
+     * in the same batch when it is a replacement.
+     *
+     * @generated from field: string edits = 3;
+     */
+    edits: string;
+};
+/**
+ * Describes the message browserscale.v1.DomUpdate.
+ * Use `create(DomUpdateSchema)` to create a new message.
+ */
+export declare const DomUpdateSchema: GenMessage<DomUpdate>;
+/**
+ * The client's copy of the page is void and must be rebuilt by calling
+ * StartDomMirror again.
+ *
+ * Page-wide, because only the MAIN frame can void everything. A child frame
+ * losing its document is a childNodeRemoved plus a childNodeInserted on its
+ * owner, which costs that subtree rather than the page. Worth the distinction
+ * on any page carrying ad frames, where the page-wide version would otherwise
+ * fire continuously.
+ *
+ * @generated from message browserscale.v1.DomResync
+ */
+export type DomResync = Message<"browserscale.v1.DomResync"> & {
+    /**
+     * "documentReplaced", "overflow", "rendererGone" from the browser, or
+     * "slowReader" when this relay could not hold the backlog.
+     *
+     * @generated from field: string reason = 2;
+     */
+    reason: string;
+};
+/**
+ * Describes the message browserscale.v1.DomResync.
+ * Use `create(DomResyncSchema)` to create a new message.
+ */
+export declare const DomResyncSchema: GenMessage<DomResync>;
+/**
+ * Updates and resyncs share one stream because they are only meaningful
+ * relative to each other. On two streams a client could apply a batch that the
+ * resync it has not read yet already invalidated, and no amount of sequence
+ * bookkeeping recovers that ordering after the fact.
+ *
+ * There is deliberately no dropped-message counter, which the network exchange
+ * stream does have. A dropped exchange leaves a log with a hole in it; a
+ * dropped edit leaves a TREE THAT IS WRONG, and a client cannot tell the
+ * difference by looking at it. So a backlog this relay cannot hold is
+ * converted into a resync instead of being counted.
+ *
+ * @generated from message browserscale.v1.DomEvent
+ */
+export type DomEvent = Message<"browserscale.v1.DomEvent"> & {
+    /**
+     * @generated from oneof browserscale.v1.DomEvent.event
+     */
+    event: {
+        /**
+         * @generated from field: browserscale.v1.DomUpdate update = 1;
+         */
+        value: DomUpdate;
+        case: "update";
+    } | {
+        /**
+         * @generated from field: browserscale.v1.DomResync resync = 2;
+         */
+        value: DomResync;
+        case: "resync";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message browserscale.v1.DomEvent.
+ * Use `create(DomEventSchema)` to create a new message.
+ */
+export declare const DomEventSchema: GenMessage<DomEvent>;
+/**
+ * @generated from message browserscale.v1.InspectAtPositionRequest
+ */
+export type InspectAtPositionRequest = Message<"browserscale.v1.InspectAtPositionRequest"> & {
+    /**
+     * @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;
+    /**
+     * Viewport-relative CSS pixels.
+     *
+     * @generated from field: double x = 4;
+     */
+    x: number;
+    /**
+     * @generated from field: double y = 5;
+     */
+    y: number;
+};
+/**
+ * Describes the message browserscale.v1.InspectAtPositionRequest.
+ * Use `create(InspectAtPositionRequestSchema)` to create a new message.
+ */
+export declare const InspectAtPositionRequestSchema: GenMessage<InspectAtPositionRequest>;
+/**
+ * @generated from message browserscale.v1.InspectAtPositionResponse
+ */
+export type InspectAtPositionResponse = Message<"browserscale.v1.InspectAtPositionResponse"> & {
+    /**
+     * 0 if nothing was found at (x, y).
+     *
+     * @generated from field: int32 backend_node_id = 1;
+     */
+    backendNodeId: number;
+    /**
+     * @generated from field: string frame_id = 2;
+     */
+    frameId: string;
+    /**
+     * @generated from field: string tag_name = 3;
+     */
+    tagName: string;
+    /**
+     * Trimmed text content (max ~200 chars, server-imposed).
+     *
+     * @generated from field: string text_content = 4;
+     */
+    textContent: string;
     /**
      * @generated from field: bool is_visible = 5;
      */
@@ -2902,11 +3691,10 @@ export type ScreenshotResponse = Message<"browserscale.v1.ScreenshotResponse"> &
  */
 export declare const ScreenshotResponseSchema: GenMessage<ScreenshotResponse>;
 /**
- * ReadCanvas reads the pixels of a single <canvas> element directly in the
- * renderer, bypassing the origin-clean (tainted) security check and without
- * executing page JavaScript — so cross-origin/tainted canvases (common in
- * captchas) can be read. The element is addressed like any other action
- * target: by selector, js_expression, or backend_node_id.
+ * ReadCanvas reads the pixels of a <canvas> directly in the renderer, bypassing
+ * the origin-clean (tainted) security check and without executing page JS.
+ * Cross-origin/tainted canvases read fine. Targeted like click: by
+ * backendNodeId (preferred), CSS selector, or JS expression.
  *
  * @generated from message browserscale.v1.ReadCanvasRequest
  */
@@ -2936,105 +3724,395 @@ export type ReadCanvasRequest = Message<"browserscale.v1.ReadCanvasRequest"> & {
      */
     jsExpression?: string;
     /**
-     * Specific frameId, empty/omitted for main frame, or "ALL_FRAMES".
-     *
      * @generated from field: optional string frame_id = 7;
      */
     frameId?: string;
     /**
-     * Output encoding: "png" (default), "jpeg", "webp", or "rgba" for the raw
-     * unpremultiplied RGBA pixel buffer.
+     * Output format: "png" (default), "jpeg", "webp", or "rgba" for the raw
+     * unencoded RGBA pixel buffer.
+     *
+     * @generated from field: optional string format = 8;
+     */
+    format?: string;
+    /**
+     * Encode quality 0-100 for "jpeg"/"webp" (ignored otherwise). Default 90.
+     *
+     * @generated from field: optional int32 quality = 9;
+     */
+    quality?: number;
+    /**
+     * Optional sub-rectangle in canvas pixels (mirrors getImageData(sx,sy,sw,sh)).
+     * Omit sw/sh (or set <= 0) to read the full canvas.
+     *
+     * @generated from field: optional int32 sx = 10;
+     */
+    sx?: number;
+    /**
+     * @generated from field: optional int32 sy = 11;
+     */
+    sy?: number;
+    /**
+     * @generated from field: optional int32 sw = 12;
+     */
+    sw?: number;
+    /**
+     * @generated from field: optional int32 sh = 13;
+     */
+    sh?: number;
+};
+/**
+ * Describes the message browserscale.v1.ReadCanvasRequest.
+ * Use `create(ReadCanvasRequestSchema)` to create a new message.
+ */
+export declare const ReadCanvasRequestSchema: GenMessage<ReadCanvasRequest>;
+/**
+ * @generated from message browserscale.v1.ReadCanvasResponse
+ */
+export type ReadCanvasResponse = Message<"browserscale.v1.ReadCanvasResponse"> & {
+    /**
+     * Whether a <canvas> was found and read.
+     *
+     * @generated from field: bool success = 1;
+     */
+    success: boolean;
+    /**
+     * The frameId that contained the canvas.
+     *
+     * @generated from field: string frame_id = 2;
+     */
+    frameId: string;
+    /**
+     * Backend node ID of the canvas that was read.
+     *
+     * @generated from field: int32 backend_node_id = 3;
+     */
+    backendNodeId: number;
+    /**
+     * Encoded image bytes as base64 (png/jpeg/webp), or the raw RGBA buffer as
+     * base64 when format is "rgba".
+     *
+     * @generated from field: string data_base64 = 4;
+     */
+    dataBase64: string;
+    /**
+     * Pixel width of the returned image (canvas width, or sw if clipped).
+     *
+     * @generated from field: int32 width = 5;
+     */
+    width: number;
+    /**
+     * Pixel height of the returned image (canvas height, or sh if clipped).
+     *
+     * @generated from field: int32 height = 6;
+     */
+    height: number;
+    /**
+     * Whether the canvas was actually origin-clean. Informational only.
+     *
+     * @generated from field: bool origin_clean = 7;
+     */
+    originClean: boolean;
+};
+/**
+ * Describes the message browserscale.v1.ReadCanvasResponse.
+ * Use `create(ReadCanvasResponseSchema)` to create a new message.
+ */
+export declare const ReadCanvasResponseSchema: GenMessage<ReadCanvasResponse>;
+/**
+ * @generated from message browserscale.v1.SolveCaptchaRequest
+ */
+export type SolveCaptchaRequest = Message<"browserscale.v1.SolveCaptchaRequest"> & {
+    /**
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * Total time budget in ms. 0 = server default (60s).
+     *
+     * @generated from field: int32 timeout_ms = 3;
+     */
+    timeoutMs: number;
+    /**
+     * Retry the solve flow this many times before giving up.
+     *
+     * @generated from field: int32 retry_amount = 4;
+     */
+    retryAmount: number;
+};
+/**
+ * Describes the message browserscale.v1.SolveCaptchaRequest.
+ * Use `create(SolveCaptchaRequestSchema)` to create a new message.
+ */
+export declare const SolveCaptchaRequestSchema: GenMessage<SolveCaptchaRequest>;
+/**
+ * @generated from message browserscale.v1.SolveCaptchaResponse
+ */
+export type SolveCaptchaResponse = Message<"browserscale.v1.SolveCaptchaResponse"> & {
+    /**
+     * Solution token returned by the underlying challenge, when applicable.
+     * Empty on success — most challenges are completed in-page server-side
+     * and require no further action from the caller. Empty on failure too.
+     *
+     * @generated from field: string result = 1;
+     */
+    result: string;
+};
+/**
+ * Describes the 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;
+    /**
+     * Root-viewport size in CSS pixels — the coordinate space the input data
+     * channels expect. Delivered with the answer so the client can map pointer
+     * coordinates from the first frame on, without a getPages() round trip that
+     * races the stream. x/y are always 0. Later changes arrive as
+     * {"type":"viewport","width":W,"height":H} on the reliable "input" channel.
+     *
+     * @generated from field: browserscale.v1.Rect viewport = 2;
+     */
+    viewport?: Rect;
+};
+/**
+ * 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>;
+/**
+ * One console line a script printed.
+ *
+ * @generated from message browserscale.v1.ScriptLogEntry
+ */
+export type ScriptLogEntry = Message<"browserscale.v1.ScriptLogEntry"> & {
+    /**
+     * "info", "warning" or "error", from console.log / .warn / .error.
      *
-     * @generated from field: optional string format = 8;
+     * @generated from field: string level = 1;
      */
-    format?: string;
+    level: string;
     /**
-     * Encode quality 0-100 for "jpeg"/"webp" (ignored otherwise). Default 90.
+     * The arguments, already stringified the way console does it.
      *
-     * @generated from field: optional int32 quality = 9;
+     * @generated from field: string message = 2;
      */
-    quality?: number;
+    message: string;
     /**
-     * Optional sub-rectangle in canvas pixels (mirrors getImageData). The full
-     * canvas is read when sw/sh are omitted or <= 0.
+     * Unix milliseconds, stamped where the script printed rather than where the
+     * line was received, so the log stays ordered across a reconnect.
      *
-     * @generated from field: optional int32 sx = 10;
+     * @generated from field: int64 timestamp = 3;
      */
-    sx?: number;
+    timestamp: bigint;
+};
+/**
+ * Describes the message browserscale.v1.ScriptLogEntry.
+ * Use `create(ScriptLogEntrySchema)` to create a new message.
+ */
+export declare const ScriptLogEntrySchema: GenMessage<ScriptLogEntry>;
+/**
+ * @generated from message browserscale.v1.RunScriptRequest
+ */
+export type RunScriptRequest = Message<"browserscale.v1.RunScriptRequest"> & {
     /**
-     * @generated from field: optional int32 sy = 11;
+     * @generated from field: string session_id = 1;
      */
-    sy?: number;
+    sessionId: string;
     /**
-     * @generated from field: optional int32 sw = 12;
+     * @generated from field: string api_key = 2;
      */
-    sw?: number;
+    apiKey: string;
     /**
-     * @generated from field: optional int32 sh = 13;
+     * JavaScript source. Runs with `browser` bound to the session, so the script
+     * needs no setup of its own.
+     *
+     * @generated from field: string source = 3;
      */
-    sh?: number;
+    source: string;
 };
 /**
- * Describes the message browserscale.v1.ReadCanvasRequest.
- * Use `create(ReadCanvasRequestSchema)` to create a new message.
+ * Describes the message browserscale.v1.RunScriptRequest.
+ * Use `create(RunScriptRequestSchema)` to create a new message.
  */
-export declare const ReadCanvasRequestSchema: GenMessage<ReadCanvasRequest>;
+export declare const RunScriptRequestSchema: GenMessage<RunScriptRequest>;
 /**
- * @generated from message browserscale.v1.ReadCanvasResponse
+ * There is deliberately no timeout on RunScript. A deadline is only useful if
+ * it can cancel, and cancelling needs the run id — which this call does not
+ * learn until the reply it is waiting for. A caller who needs a bound uses
+ * StartScript, which hands the id over first, and StopScripts when the bound is
+ * hit. A caller who just wants out can StopScripts with no id.
+ *
+ * @generated from message browserscale.v1.RunScriptResponse
  */
-export type ReadCanvasResponse = Message<"browserscale.v1.ReadCanvasResponse"> & {
+export type RunScriptResponse = Message<"browserscale.v1.RunScriptResponse"> & {
     /**
      * @generated from field: bool success = 1;
      */
     success: boolean;
     /**
-     * Frame the canvas was resolved in.
-     *
-     * @generated from field: string frame_id = 2;
-     */
-    frameId: string;
-    /**
-     * Resolved DevTools backendNodeId of the canvas.
-     *
-     * @generated from field: int32 backend_node_id = 3;
-     */
-    backendNodeId: number;
-    /**
-     * Encoded image bytes as base64 (PNG by default), or the raw RGBA buffer
-     * when format == "rgba".
+     * The script's return value as JSON, "undefined" when it returned nothing,
+     * or the error message when success is false.
      *
-     * @generated from field: string data_base64 = 4;
+     * @generated from field: string result = 2;
      */
-    dataBase64: string;
+    result: string;
     /**
-     * Canvas width in pixels.
+     * The run's id. Arrives too late to follow the run, but names it for a caller
+     * that wants to match up log lines it already saw on the stream.
      *
-     * @generated from field: int32 width = 5;
+     * @generated from field: string run_id = 3;
      */
-    width: number;
+    runId: string;
     /**
-     * Canvas height in pixels.
+     * Everything the script logged, in order — whether or not anyone subscribed.
      *
-     * @generated from field: int32 height = 6;
+     * @generated from field: repeated browserscale.v1.ScriptLogEntry log = 4;
      */
-    height: number;
+    log: ScriptLogEntry[];
     /**
-     * Whether the canvas was origin-clean (untainted). Informational only —
-     * the read succeeds regardless.
+     * True when the script printed more than the reply holds, in which case log
+     * is the tail of the output rather than all of it.
      *
-     * @generated from field: bool origin_clean = 7;
+     * @generated from field: bool truncated = 5;
      */
-    originClean: boolean;
+    truncated: boolean;
 };
 /**
- * Describes the message browserscale.v1.ReadCanvasResponse.
- * Use `create(ReadCanvasResponseSchema)` to create a new message.
+ * Describes the message browserscale.v1.RunScriptResponse.
+ * Use `create(RunScriptResponseSchema)` to create a new message.
  */
-export declare const ReadCanvasResponseSchema: GenMessage<ReadCanvasResponse>;
+export declare const RunScriptResponseSchema: GenMessage<RunScriptResponse>;
 /**
- * @generated from message browserscale.v1.SolveCaptchaRequest
+ * @generated from message browserscale.v1.StartScriptRequest
  */
-export type SolveCaptchaRequest = Message<"browserscale.v1.SolveCaptchaRequest"> & {
+export type StartScriptRequest = Message<"browserscale.v1.StartScriptRequest"> & {
     /**
      * @generated from field: string session_id = 1;
      */
@@ -3044,70 +4122,96 @@ export type SolveCaptchaRequest = Message<"browserscale.v1.SolveCaptchaRequest">
      */
     apiKey: string;
     /**
-     * Total time budget in ms. 0 = server default (60s).
-     *
-     * @generated from field: int32 timeout_ms = 3;
+     * @generated from field: string source = 3;
      */
-    timeoutMs: number;
+    source: string;
+};
+/**
+ * Describes the message browserscale.v1.StartScriptRequest.
+ * Use `create(StartScriptRequestSchema)` to create a new message.
+ */
+export declare const StartScriptRequestSchema: GenMessage<StartScriptRequest>;
+/**
+ * @generated from message browserscale.v1.StartScriptResponse
+ */
+export type StartScriptResponse = Message<"browserscale.v1.StartScriptResponse"> & {
     /**
-     * Retry the solve flow this many times before giving up.
+     * Identifies the run for StopScripts, ListScriptRuns and the event stream.
      *
-     * @generated from field: int32 retry_amount = 4;
+     * @generated from field: string run_id = 1;
      */
-    retryAmount: number;
+    runId: string;
 };
 /**
- * Describes the message browserscale.v1.SolveCaptchaRequest.
- * Use `create(SolveCaptchaRequestSchema)` to create a new message.
+ * Describes the message browserscale.v1.StartScriptResponse.
+ * Use `create(StartScriptResponseSchema)` to create a new message.
  */
-export declare const SolveCaptchaRequestSchema: GenMessage<SolveCaptchaRequest>;
+export declare const StartScriptResponseSchema: GenMessage<StartScriptResponse>;
 /**
- * @generated from message browserscale.v1.SolveCaptchaResponse
+ * @generated from message browserscale.v1.StopScriptsRequest
  */
-export type SolveCaptchaResponse = Message<"browserscale.v1.SolveCaptchaResponse"> & {
+export type StopScriptsRequest = Message<"browserscale.v1.StopScriptsRequest"> & {
     /**
-     * Solution token returned by the underlying challenge, when applicable.
-     * Empty on success — most challenges are completed in-page server-side
-     * and require no further action from the caller. Empty on failure too.
+     * @generated from field: string session_id = 1;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string api_key = 2;
+     */
+    apiKey: string;
+    /**
+     * The run to cancel. Empty cancels every run in this session — the
+     * distinction is deliberately explicit, because there is no undo for either.
      *
-     * @generated from field: string result = 1;
+     * @generated from field: string run_id = 3;
      */
-    result: string;
+    runId: string;
 };
 /**
- * Describes the message browserscale.v1.SolveCaptchaResponse.
- * Use `create(SolveCaptchaResponseSchema)` to create a new message.
+ * Describes the message browserscale.v1.StopScriptsRequest.
+ * Use `create(StopScriptsRequestSchema)` to create a new message.
  */
-export declare const SolveCaptchaResponseSchema: GenMessage<SolveCaptchaResponse>;
+export declare const StopScriptsRequestSchema: GenMessage<StopScriptsRequest>;
 /**
- * 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
+ * @generated from message browserscale.v1.StopScriptsResponse
  */
-export type IceServer = Message<"browserscale.v1.IceServer"> & {
+export type StopScriptsResponse = Message<"browserscale.v1.StopScriptsResponse"> & {
     /**
-     * @generated from field: repeated string urls = 1;
+     * @generated from field: int32 stopped = 1;
      */
-    urls: string[];
+    stopped: number;
+};
+/**
+ * Describes the message browserscale.v1.StopScriptsResponse.
+ * Use `create(StopScriptsResponseSchema)` to create a new message.
+ */
+export declare const StopScriptsResponseSchema: GenMessage<StopScriptsResponse>;
+/**
+ * @generated from message browserscale.v1.ScriptRun
+ */
+export type ScriptRun = Message<"browserscale.v1.ScriptRun"> & {
     /**
-     * @generated from field: optional string username = 2;
+     * @generated from field: string run_id = 1;
      */
-    username?: string;
+    runId: string;
     /**
-     * @generated from field: optional string credential = 3;
+     * How long the run has been going, in ms. Reported as an age rather than a
+     * start time because that is what the browser knows — it counts from when the
+     * run was accepted, with no clock shared with the caller.
+     *
+     * @generated from field: int64 running_ms = 2;
      */
-    credential?: string;
+    runningMs: bigint;
 };
 /**
- * Describes the message browserscale.v1.IceServer.
- * Use `create(IceServerSchema)` to create a new message.
+ * Describes the message browserscale.v1.ScriptRun.
+ * Use `create(ScriptRunSchema)` to create a new message.
  */
-export declare const IceServerSchema: GenMessage<IceServer>;
+export declare const ScriptRunSchema: GenMessage<ScriptRun>;
 /**
- * @generated from message browserscale.v1.GetStreamConfigRequest
+ * @generated from message browserscale.v1.ListScriptRunsRequest
  */
-export type GetStreamConfigRequest = Message<"browserscale.v1.GetStreamConfigRequest"> & {
+export type ListScriptRunsRequest = Message<"browserscale.v1.ListScriptRunsRequest"> & {
     /**
      * @generated from field: string session_id = 1;
      */
@@ -3118,32 +4222,31 @@ export type GetStreamConfigRequest = Message<"browserscale.v1.GetStreamConfigReq
     apiKey: string;
 };
 /**
- * Describes the message browserscale.v1.GetStreamConfigRequest.
- * Use `create(GetStreamConfigRequestSchema)` to create a new message.
+ * Describes the message browserscale.v1.ListScriptRunsRequest.
+ * Use `create(ListScriptRunsRequestSchema)` to create a new message.
  */
-export declare const GetStreamConfigRequestSchema: GenMessage<GetStreamConfigRequest>;
+export declare const ListScriptRunsRequestSchema: GenMessage<ListScriptRunsRequest>;
 /**
- * @generated from message browserscale.v1.GetStreamConfigResponse
+ * @generated from message browserscale.v1.ListScriptRunsResponse
  */
-export type GetStreamConfigResponse = Message<"browserscale.v1.GetStreamConfigResponse"> & {
+export type ListScriptRunsResponse = Message<"browserscale.v1.ListScriptRunsResponse"> & {
     /**
-     * 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.
+     * Only runs still executing. A finished run is reported once on the event
+     * stream and then forgotten; this is not a history.
      *
-     * @generated from field: repeated browserscale.v1.IceServer ice_servers = 1;
+     * @generated from field: repeated browserscale.v1.ScriptRun runs = 1;
      */
-    iceServers: IceServer[];
+    runs: ScriptRun[];
 };
 /**
- * Describes the message browserscale.v1.GetStreamConfigResponse.
- * Use `create(GetStreamConfigResponseSchema)` to create a new message.
+ * Describes the message browserscale.v1.ListScriptRunsResponse.
+ * Use `create(ListScriptRunsResponseSchema)` to create a new message.
  */
-export declare const GetStreamConfigResponseSchema: GenMessage<GetStreamConfigResponse>;
+export declare const ListScriptRunsResponseSchema: GenMessage<ListScriptRunsResponse>;
 /**
- * @generated from message browserscale.v1.StartStreamRequest
+ * @generated from message browserscale.v1.StreamScriptEventsRequest
  */
-export type StartStreamRequest = Message<"browserscale.v1.StartStreamRequest"> & {
+export type StreamScriptEventsRequest = Message<"browserscale.v1.StreamScriptEventsRequest"> & {
     /**
      * @generated from field: string session_id = 1;
      */
@@ -3153,62 +4256,104 @@ export type StartStreamRequest = Message<"browserscale.v1.StartStreamRequest"> &
      */
     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.
+     * Report only this run. Empty reports every run in the session, which is what
+     * a dashboard wants and what a single follower does not.
      *
-     * @generated from field: string offer_sdp = 3;
+     * @generated from field: string run_id = 3;
      */
-    offerSdp: string;
+    runId: string;
 };
 /**
- * Describes the message browserscale.v1.StartStreamRequest.
- * Use `create(StartStreamRequestSchema)` to create a new message.
+ * Describes the message browserscale.v1.StreamScriptEventsRequest.
+ * Use `create(StreamScriptEventsRequestSchema)` to create a new message.
  */
-export declare const StartStreamRequestSchema: GenMessage<StartStreamRequest>;
+export declare const StreamScriptEventsRequestSchema: GenMessage<StreamScriptEventsRequest>;
 /**
- * @generated from message browserscale.v1.StartStreamResponse
+ * @generated from message browserscale.v1.ScriptLog
  */
-export type StartStreamResponse = Message<"browserscale.v1.StartStreamResponse"> & {
+export type ScriptLog = Message<"browserscale.v1.ScriptLog"> & {
     /**
-     * The browser's SDP answer to set as the client's remote description.
-     *
-     * @generated from field: string answer_sdp = 1;
+     * @generated from field: string run_id = 1;
      */
-    answerSdp: string;
+    runId: string;
+    /**
+     * @generated from field: browserscale.v1.ScriptLogEntry line = 2;
+     */
+    line?: ScriptLogEntry;
 };
 /**
- * Describes the message browserscale.v1.StartStreamResponse.
- * Use `create(StartStreamResponseSchema)` to create a new message.
+ * Describes the message browserscale.v1.ScriptLog.
+ * Use `create(ScriptLogSchema)` to create a new message.
  */
-export declare const StartStreamResponseSchema: GenMessage<StartStreamResponse>;
+export declare const ScriptLogSchema: GenMessage<ScriptLog>;
 /**
- * @generated from message browserscale.v1.StopStreamRequest
+ * @generated from message browserscale.v1.ScriptFinished
  */
-export type StopStreamRequest = Message<"browserscale.v1.StopStreamRequest"> & {
+export type ScriptFinished = Message<"browserscale.v1.ScriptFinished"> & {
     /**
-     * @generated from field: string session_id = 1;
+     * @generated from field: string run_id = 1;
      */
-    sessionId: string;
+    runId: string;
     /**
-     * @generated from field: string api_key = 2;
+     * @generated from field: bool success = 2;
      */
-    apiKey: string;
+    success: boolean;
+    /**
+     * The return value as JSON, or the error message when success is false — the
+     * same one field as in RunScriptResponse.
+     *
+     * @generated from field: string result = 3;
+     */
+    result: string;
+    /**
+     * True when the run ended because StopScripts cancelled it, or because the VM
+     * was torn down under it, rather than on its own.
+     *
+     * @generated from field: bool stopped = 4;
+     */
+    stopped: boolean;
 };
 /**
- * Describes the message browserscale.v1.StopStreamRequest.
- * Use `create(StopStreamRequestSchema)` to create a new message.
+ * Describes the message browserscale.v1.ScriptFinished.
+ * Use `create(ScriptFinishedSchema)` to create a new message.
  */
-export declare const StopStreamRequestSchema: GenMessage<StopStreamRequest>;
+export declare const ScriptFinishedSchema: GenMessage<ScriptFinished>;
 /**
- * @generated from message browserscale.v1.StopStreamResponse
+ * @generated from message browserscale.v1.ScriptEvent
  */
-export type StopStreamResponse = Message<"browserscale.v1.StopStreamResponse"> & {};
+export type ScriptEvent = Message<"browserscale.v1.ScriptEvent"> & {
+    /**
+     * @generated from oneof browserscale.v1.ScriptEvent.event
+     */
+    event: {
+        /**
+         * @generated from field: browserscale.v1.ScriptLog log = 1;
+         */
+        value: ScriptLog;
+        case: "log";
+    } | {
+        /**
+         * @generated from field: browserscale.v1.ScriptFinished finished = 2;
+         */
+        value: ScriptFinished;
+        case: "finished";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+    /**
+     * Cumulative events dropped for this subscriber because it read slower than
+     * the scripts produced them. Non-zero means the log has holes.
+     *
+     * @generated from field: uint64 dropped = 3;
+     */
+    dropped: bigint;
+};
 /**
- * Describes the message browserscale.v1.StopStreamResponse.
- * Use `create(StopStreamResponseSchema)` to create a new message.
+ * Describes the message browserscale.v1.ScriptEvent.
+ * Use `create(ScriptEventSchema)` to create a new message.
  */
-export declare const StopStreamResponseSchema: GenMessage<StopStreamResponse>;
+export declare const ScriptEventSchema: GenMessage<ScriptEvent>;
 /**
  * @generated from service browserscale.v1.Browser
  */
@@ -3397,6 +4542,35 @@ export declare const Browser: GenService<{
         input: typeof ModifyRequestRequestSchema;
         output: typeof ModifyRequestResponseSchema;
     };
+    /**
+     * Network capture — every matching request in the session, reported as it
+     * completes. Start/Stop are session state; the stream is a separate
+     * subscription, so a capture survives a reader reconnect and two readers
+     * can watch one capture.
+     *
+     * @generated from rpc browserscale.v1.Browser.StartNetworkCapture
+     */
+    startNetworkCapture: {
+        methodKind: "unary";
+        input: typeof StartNetworkCaptureRequestSchema;
+        output: typeof EmptySchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StopNetworkCapture
+     */
+    stopNetworkCapture: {
+        methodKind: "unary";
+        input: typeof StopNetworkCaptureRequestSchema;
+        output: typeof StopNetworkCaptureResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StreamNetworkExchanges
+     */
+    streamNetworkExchanges: {
+        methodKind: "server_streaming";
+        input: typeof StreamNetworkExchangesRequestSchema;
+        output: typeof NetworkExchangeEventSchema;
+    };
     /**
      * Cookies
      *
@@ -3449,6 +4623,24 @@ export declare const Browser: GenService<{
         input: typeof ClearStorageRequestSchema;
         output: typeof EmptySchema;
     };
+    /**
+     * Auth / DBSC (portable signed-in persona)
+     *
+     * @generated from rpc browserscale.v1.Browser.GetAuthSession
+     */
+    getAuthSession: {
+        methodKind: "unary";
+        input: typeof GetAuthSessionRequestSchema;
+        output: typeof GetAuthSessionResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.SetAuthSession
+     */
+    setAuthSession: {
+        methodKind: "unary";
+        input: typeof SetAuthSessionRequestSchema;
+        output: typeof EmptySchema;
+    };
     /**
      * DOM / observation
      *
@@ -3491,6 +4683,80 @@ export declare const Browser: GenService<{
         input: typeof HighlightNodeRequestSchema;
         output: typeof EmptySchema;
     };
+    /**
+     * DOM mirror — an incremental view of the page's DOM, as ONE tree.
+     * StartDomMirror returns the top of the main document and from then on the
+     * browser reports changes to the part the client has actually expanded; the
+     * reads grow and shrink that part. Together they replace polling GetDOMHash
+     * and re-fetching GetDOM.
+     *
+     * An <iframe> is an ordinary element whose one child is the document it
+     * hosts, fetched by expanding it — which is also what starts mirroring that
+     * frame, so frames cost nothing until someone opens one. There is no frame
+     * lifecycle to subscribe to. RevealDomNode reaches into a frame nobody
+     * opened and starts the ones on the way, which is what makes a hit test
+     * usable against a lazily loaded tree.
+     *
+     * Like network capture, the stream is a separate subscription so a mirror
+     * survives a reader reconnect. Unlike it, the stream carries both updates
+     * and resyncs on ONE channel: a resync means "everything you hold is void",
+     * which is only interpretable in order against the batches around it.
+     *
+     * @generated from rpc browserscale.v1.Browser.StartDomMirror
+     */
+    startDomMirror: {
+        methodKind: "unary";
+        input: typeof StartDomMirrorRequestSchema;
+        output: typeof StartDomMirrorResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StopDomMirror
+     */
+    stopDomMirror: {
+        methodKind: "unary";
+        input: typeof StopDomMirrorRequestSchema;
+        output: typeof EmptySchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.GetDomChildren
+     */
+    getDomChildren: {
+        methodKind: "unary";
+        input: typeof GetDomChildrenRequestSchema;
+        output: typeof GetDomChildrenResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.ReleaseDomSubtree
+     */
+    releaseDomSubtree: {
+        methodKind: "unary";
+        input: typeof ReleaseDomSubtreeRequestSchema;
+        output: typeof EmptySchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.RevealDomNode
+     */
+    revealDomNode: {
+        methodKind: "unary";
+        input: typeof RevealDomNodeRequestSchema;
+        output: typeof RevealDomNodeResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.GetDomRevision
+     */
+    getDomRevision: {
+        methodKind: "unary";
+        input: typeof GetDomRevisionRequestSchema;
+        output: typeof GetDomRevisionResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StreamDomEvents
+     */
+    streamDomEvents: {
+        methodKind: "server_streaming";
+        input: typeof StreamDomEventsRequestSchema;
+        output: typeof DomEventSchema;
+    };
     /**
      * Screenshot / capture
      *
@@ -3591,4 +4857,60 @@ export declare const Browser: GenService<{
         input: typeof StopStreamRequestSchema;
         output: typeof StopStreamResponseSchema;
     };
+    /**
+     * Scripts — automation that runs inside the browser process rather than
+     * across the network. The script gets the same `browser.*` surface this
+     * service exposes, but each call is a function call in the browser instead of
+     * a gRPC round trip, so a loop that is unusable at ~50ms per step costs
+     * microseconds. Worth it for anything chatty: waiting for a selector,
+     * scraping a list, walking pagination.
+     *
+     * Two modes, because a script is either something you wait for or something
+     * you leave running. RunScript blocks and hands back the return value with
+     * the whole log, which is what a one-shot caller wants. StartScript returns a
+     * run id immediately and the output arrives on the event stream, which is the
+     * only workable shape for a script that outlives the request.
+     *
+     * Like network capture the stream is a separate subscription, so output
+     * survives a reader reconnect and two readers can watch one run.
+     *
+     * @generated from rpc browserscale.v1.Browser.RunScript
+     */
+    runScript: {
+        methodKind: "unary";
+        input: typeof RunScriptRequestSchema;
+        output: typeof RunScriptResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StartScript
+     */
+    startScript: {
+        methodKind: "unary";
+        input: typeof StartScriptRequestSchema;
+        output: typeof StartScriptResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StopScripts
+     */
+    stopScripts: {
+        methodKind: "unary";
+        input: typeof StopScriptsRequestSchema;
+        output: typeof StopScriptsResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.ListScriptRuns
+     */
+    listScriptRuns: {
+        methodKind: "unary";
+        input: typeof ListScriptRunsRequestSchema;
+        output: typeof ListScriptRunsResponseSchema;
+    };
+    /**
+     * @generated from rpc browserscale.v1.Browser.StreamScriptEvents
+     */
+    streamScriptEvents: {
+        methodKind: "server_streaming";
+        input: typeof StreamScriptEventsRequestSchema;
+        output: typeof ScriptEventSchema;
+    };
 }>;