browserscale-ts 1.7.1 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,4 @@
1
1
  import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
2
- import type { EmptySchema } from "@bufbuild/protobuf/wkt";
3
2
  import type { Message } from "@bufbuild/protobuf";
4
3
  /**
5
4
  * Describes the file wrc.proto.
@@ -349,6 +348,13 @@ export type WaitResult = Message<"browserscale.v1.WaitResult"> & {
349
348
  * @generated from field: browserscale.v1.Rect bounds = 5;
350
349
  */
351
350
  bounds?: Rect;
351
+ /**
352
+ * False iff nothing matched before the deadline. Redundant with index -1, and
353
+ * carried anyway so every command answers the same question the same way.
354
+ *
355
+ * @generated from field: bool success = 7;
356
+ */
357
+ success: boolean;
352
358
  /**
353
359
  * Present iff no condition matched before the deadline (index is -1): the
354
360
  * per-condition breakdown of why nothing matched. A timeout is a normal
@@ -563,10 +569,62 @@ export type OccluderInfo = Message<"browserscale.v1.OccluderInfo"> & {
563
569
  * Use `create(OccluderInfoSchema)` to create a new message.
564
570
  */
565
571
  export declare const OccluderInfoSchema: GenMessage<OccluderInfo>;
572
+ /**
573
+ * The shape every error detail here shares, and the type used directly by
574
+ * commands with nothing to report beyond what went wrong. Present in a result
575
+ * iff that command's success is false.
576
+ *
577
+ * Genuine transport failures — a malformed request, a dead session, the page
578
+ * going away — stay gRPC errors and never arrive here. This only ever describes
579
+ * a semantic outcome: the browser worked and the page did not cooperate.
580
+ *
581
+ * @generated from message browserscale.v1.CommandError
582
+ */
583
+ export type CommandError = Message<"browserscale.v1.CommandError"> & {
584
+ /**
585
+ * Machine-stable, lowercase, scoped to the command that returned it.
586
+ *
587
+ * @generated from field: string code = 1;
588
+ */
589
+ code: string;
590
+ /**
591
+ * Human-readable detail, possibly empty. Never parse this; parse code.
592
+ *
593
+ * @generated from field: string message = 2;
594
+ */
595
+ message: string;
596
+ };
597
+ /**
598
+ * Describes the message browserscale.v1.CommandError.
599
+ * Use `create(CommandErrorSchema)` to create a new message.
600
+ */
601
+ export declare const CommandErrorSchema: GenMessage<CommandError>;
602
+ /**
603
+ * What the commands that have nothing else to report return, in place of the
604
+ * empty response they used to give. Every command answers whether it worked, so
605
+ * a semantic refusal never has to be inferred from the absence of an error, and
606
+ * a command that grows a failure mode later does not change shape.
607
+ *
608
+ * @generated from message browserscale.v1.CommandResult
609
+ */
610
+ export type CommandResult = Message<"browserscale.v1.CommandResult"> & {
611
+ /**
612
+ * @generated from field: bool success = 1;
613
+ */
614
+ success: boolean;
615
+ /**
616
+ * @generated from field: optional browserscale.v1.CommandError error = 2;
617
+ */
618
+ error?: CommandError;
619
+ };
620
+ /**
621
+ * Describes the message browserscale.v1.CommandResult.
622
+ * Use `create(CommandResultSchema)` to create a new message.
623
+ */
624
+ export declare const CommandResultSchema: GenMessage<CommandResult>;
566
625
  /**
567
626
  * Error detail for a Click that did not land. Present in ClickResult iff
568
- * success is false. First instance of the per-command WRCError<Command>
569
- * convention; other commands migrate to the same shape later.
627
+ * success is false. CommandError plus the occlusion specifics.
570
628
  *
571
629
  * @generated from message browserscale.v1.ClickError
572
630
  */
@@ -788,6 +846,18 @@ export type AddReactionResponse = Message<"browserscale.v1.AddReactionResponse">
788
846
  * @generated from field: string reaction_id = 1;
789
847
  */
790
848
  reactionId: string;
849
+ /**
850
+ * Always true today: this command has no semantic failure of its own. Both
851
+ * fields are carried so every response answers the same question the same
852
+ * way, and so a future failure mode is an added code, not a new shape.
853
+ *
854
+ * @generated from field: bool success = 2;
855
+ */
856
+ success: boolean;
857
+ /**
858
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
859
+ */
860
+ error?: CommandError;
791
861
  };
792
862
  /**
793
863
  * Describes the message browserscale.v1.AddReactionResponse.
@@ -828,6 +898,18 @@ export type RemoveReactionResponse = Message<"browserscale.v1.RemoveReactionResp
828
898
  * @generated from field: bool removed = 1;
829
899
  */
830
900
  removed: boolean;
901
+ /**
902
+ * Always true today: this command has no semantic failure of its own. Both
903
+ * fields are carried so every response answers the same question the same
904
+ * way, and so a future failure mode is an added code, not a new shape.
905
+ *
906
+ * @generated from field: bool success = 2;
907
+ */
908
+ success: boolean;
909
+ /**
910
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
911
+ */
912
+ error?: CommandError;
831
913
  };
832
914
  /**
833
915
  * Describes the message browserscale.v1.RemoveReactionResponse.
@@ -864,6 +946,18 @@ export type ListReactionsResponse = Message<"browserscale.v1.ListReactionsRespon
864
946
  * @generated from field: repeated browserscale.v1.ReactionInfo reactions = 1;
865
947
  */
866
948
  reactions: ReactionInfo[];
949
+ /**
950
+ * Always true today: this command has no semantic failure of its own. Both
951
+ * fields are carried so every response answers the same question the same
952
+ * way, and so a future failure mode is an added code, not a new shape.
953
+ *
954
+ * @generated from field: bool success = 2;
955
+ */
956
+ success: boolean;
957
+ /**
958
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
959
+ */
960
+ error?: CommandError;
867
961
  };
868
962
  /**
869
963
  * Describes the message browserscale.v1.ListReactionsResponse.
@@ -1341,12 +1435,131 @@ export type GetPagesResponse = Message<"browserscale.v1.GetPagesResponse"> & {
1341
1435
  * @generated from field: repeated browserscale.v1.PageInfo pages = 1;
1342
1436
  */
1343
1437
  pages: PageInfo[];
1438
+ /**
1439
+ * Always true today: this command has no semantic failure of its own. Both
1440
+ * fields are carried so every response answers the same question the same
1441
+ * way, and so a future failure mode is an added code, not a new shape.
1442
+ *
1443
+ * @generated from field: bool success = 2;
1444
+ */
1445
+ success: boolean;
1446
+ /**
1447
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
1448
+ */
1449
+ error?: CommandError;
1344
1450
  };
1345
1451
  /**
1346
1452
  * Describes the message browserscale.v1.GetPagesResponse.
1347
1453
  * Use `create(GetPagesResponseSchema)` to create a new message.
1348
1454
  */
1349
1455
  export declare const GetPagesResponseSchema: GenMessage<GetPagesResponse>;
1456
+ /**
1457
+ * What a session's browser has consumed since the session started: the CPU
1458
+ * time and memory of every process that rendered its pages — main frames,
1459
+ * cross-site iframes and the workers they host — including processes that have
1460
+ * since exited. Work done on the session's behalf in processes it shares with
1461
+ * other sessions is not included. The stop endpoint returns the same object, in
1462
+ * its JSON form, as the session's final usage.
1463
+ *
1464
+ * @generated from message browserscale.v1.SessionUsage
1465
+ */
1466
+ export type SessionUsage = Message<"browserscale.v1.SessionUsage"> & {
1467
+ /**
1468
+ * Real time since the session's browser was created, in seconds.
1469
+ *
1470
+ * @generated from field: double wall_time = 1;
1471
+ */
1472
+ wallTime: number;
1473
+ /**
1474
+ * CPU time in seconds, user plus kernel. Only time a thread actually ran on a
1475
+ * core counts; waiting and idling do not.
1476
+ *
1477
+ * @generated from field: double cpu_time = 2;
1478
+ */
1479
+ cpuTime: number;
1480
+ /**
1481
+ * The least memory the session held once its browser was ready, in bytes.
1482
+ * Sampled about once a second.
1483
+ *
1484
+ * @generated from field: double min_memory = 3;
1485
+ */
1486
+ minMemory: number;
1487
+ /**
1488
+ * The memory held, averaged over wall_time, in bytes; average_memory *
1489
+ * wall_time is the memory-time used. Sampled about once a second, so short
1490
+ * spikes count toward the peak but barely toward the average.
1491
+ *
1492
+ * @generated from field: double average_memory = 4;
1493
+ */
1494
+ averageMemory: number;
1495
+ /**
1496
+ * The most memory held at any one moment, in bytes.
1497
+ *
1498
+ * @generated from field: double peak_memory = 5;
1499
+ */
1500
+ peakMemory: number;
1501
+ /**
1502
+ * Renderer processes that hosted at least one of the session's frames: one
1503
+ * per site its pages and cross-site iframes needed.
1504
+ *
1505
+ * @generated from field: int32 renderers_used = 6;
1506
+ */
1507
+ renderersUsed: number;
1508
+ /**
1509
+ * Child frames created in the session's pages, whether or not they got a
1510
+ * process of their own.
1511
+ *
1512
+ * @generated from field: int32 frames_created = 7;
1513
+ */
1514
+ framesCreated: number;
1515
+ };
1516
+ /**
1517
+ * Describes the message browserscale.v1.SessionUsage.
1518
+ * Use `create(SessionUsageSchema)` to create a new message.
1519
+ */
1520
+ export declare const SessionUsageSchema: GenMessage<SessionUsage>;
1521
+ /**
1522
+ * @generated from message browserscale.v1.GetUsageRequest
1523
+ */
1524
+ export type GetUsageRequest = Message<"browserscale.v1.GetUsageRequest"> & {
1525
+ /**
1526
+ * @generated from field: string session_id = 1;
1527
+ */
1528
+ sessionId: string;
1529
+ /**
1530
+ * @generated from field: string api_key = 2;
1531
+ */
1532
+ apiKey: string;
1533
+ };
1534
+ /**
1535
+ * Describes the message browserscale.v1.GetUsageRequest.
1536
+ * Use `create(GetUsageRequestSchema)` to create a new message.
1537
+ */
1538
+ export declare const GetUsageRequestSchema: GenMessage<GetUsageRequest>;
1539
+ /**
1540
+ * @generated from message browserscale.v1.GetUsageResponse
1541
+ */
1542
+ export type GetUsageResponse = Message<"browserscale.v1.GetUsageResponse"> & {
1543
+ /**
1544
+ * @generated from field: browserscale.v1.SessionUsage usage = 1;
1545
+ */
1546
+ usage?: SessionUsage;
1547
+ /**
1548
+ * Always true today: this command has no semantic failure of its own.
1549
+ *
1550
+ * @generated from field: bool success = 2;
1551
+ */
1552
+ success: boolean;
1553
+ /**
1554
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
1555
+ */
1556
+ error?: CommandError;
1557
+ };
1558
+ /**
1559
+ * Describes the message browserscale.v1.GetUsageResponse.
1560
+ * Use `create(GetUsageResponseSchema)` to create a new message.
1561
+ */
1562
+ export declare const GetUsageResponseSchema: GenMessage<GetUsageResponse>;
1350
1563
  /**
1351
1564
  * @generated from message browserscale.v1.NavigateRequest
1352
1565
  */
@@ -1393,6 +1606,17 @@ export type NavigateResponse = Message<"browserscale.v1.NavigateResponse"> & {
1393
1606
  * @generated from field: string url = 2;
1394
1607
  */
1395
1608
  url: string;
1609
+ /**
1610
+ * False iff the command refused; then error carries the code. See the
1611
+ * protocol definition for which codes this command can return.
1612
+ *
1613
+ * @generated from field: bool success = 3;
1614
+ */
1615
+ success: boolean;
1616
+ /**
1617
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
1618
+ */
1619
+ error?: CommandError;
1396
1620
  };
1397
1621
  /**
1398
1622
  * Describes the message browserscale.v1.NavigateResponse.
@@ -1494,68 +1718,24 @@ export type EvaluateResponse = Message<"browserscale.v1.EvaluateResponse"> & {
1494
1718
  * @generated from field: browserscale.v1.Rect bounds = 4;
1495
1719
  */
1496
1720
  bounds?: Rect;
1497
- };
1498
- /**
1499
- * Describes the message browserscale.v1.EvaluateResponse.
1500
- * Use `create(EvaluateResponseSchema)` to create a new message.
1501
- */
1502
- export declare const EvaluateResponseSchema: GenMessage<EvaluateResponse>;
1503
- /**
1504
- * Run executes a JavaScript automation script inside the God-VM — a bare V8
1505
- * isolate that lives outside every renderer.
1506
- *
1507
- * @generated from message browserscale.v1.RunRequest
1508
- */
1509
- export type RunRequest = Message<"browserscale.v1.RunRequest"> & {
1510
- /**
1511
- * @generated from field: string session_id = 1;
1512
- */
1513
- sessionId: string;
1514
- /**
1515
- * @generated from field: string api_key = 2;
1516
- */
1517
- apiKey: string;
1518
- /**
1519
- * JavaScript source to execute in the God-VM.
1520
- *
1521
- * @generated from field: string source = 3;
1522
- */
1523
- source: string;
1524
1721
  /**
1525
- * Page the script should be able to drive (reserved; frame bridge wired in a
1526
- * follow-up). Optional for now — ignored server-side.
1722
+ * False iff the expression never produced a value (then error is present).
1723
+ * An expression that answers falsy is a success, so a broken expression is
1724
+ * never mistaken for a false one.
1527
1725
  *
1528
- * @generated from field: optional string page_id = 4;
1529
- */
1530
- pageId?: string;
1531
- };
1532
- /**
1533
- * Describes the message browserscale.v1.RunRequest.
1534
- * Use `create(RunRequestSchema)` to create a new message.
1535
- */
1536
- export declare const RunRequestSchema: GenMessage<RunRequest>;
1537
- /**
1538
- * @generated from message browserscale.v1.RunResponse
1539
- */
1540
- export type RunResponse = Message<"browserscale.v1.RunResponse"> & {
1541
- /**
1542
- * False if compilation or execution threw; then `result` holds the message.
1543
- *
1544
- * @generated from field: bool success = 1;
1726
+ * @generated from field: bool success = 5;
1545
1727
  */
1546
1728
  success: boolean;
1547
1729
  /**
1548
- * JSON-serialized result value (or "undefined"), or the error message.
1549
- *
1550
- * @generated from field: string result = 2;
1730
+ * @generated from field: optional browserscale.v1.CommandError error = 6;
1551
1731
  */
1552
- result: string;
1732
+ error?: CommandError;
1553
1733
  };
1554
1734
  /**
1555
- * Describes the message browserscale.v1.RunResponse.
1556
- * Use `create(RunResponseSchema)` to create a new message.
1735
+ * Describes the message browserscale.v1.EvaluateResponse.
1736
+ * Use `create(EvaluateResponseSchema)` to create a new message.
1557
1737
  */
1558
- export declare const RunResponseSchema: GenMessage<RunResponse>;
1738
+ export declare const EvaluateResponseSchema: GenMessage<EvaluateResponse>;
1559
1739
  /**
1560
1740
  * Note: named "WaitForAnyParams" instead of "WaitForAnyRequest" to avoid
1561
1741
  * colliding with the rpc method name "WaitForAnyRequest" (network intercept).
@@ -2023,6 +2203,17 @@ export type WaitForAnyRequestResponse = Message<"browserscale.v1.WaitForAnyReque
2023
2203
  * @generated from field: browserscale.v1.InterceptedRequest request = 2;
2024
2204
  */
2025
2205
  request?: InterceptedRequest;
2206
+ /**
2207
+ * False iff the command refused; then error carries the code. See the
2208
+ * protocol definition for which codes this command can return.
2209
+ *
2210
+ * @generated from field: bool success = 3;
2211
+ */
2212
+ success: boolean;
2213
+ /**
2214
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
2215
+ */
2216
+ error?: CommandError;
2026
2217
  };
2027
2218
  /**
2028
2219
  * Describes the message browserscale.v1.WaitForAnyRequestResponse.
@@ -2073,6 +2264,17 @@ export type WaitForAnyResponseResponse = Message<"browserscale.v1.WaitForAnyResp
2073
2264
  * @generated from field: browserscale.v1.InterceptedResponse response = 2;
2074
2265
  */
2075
2266
  response?: InterceptedResponse;
2267
+ /**
2268
+ * False iff the command refused; then error carries the code. See the
2269
+ * protocol definition for which codes this command can return.
2270
+ *
2271
+ * @generated from field: bool success = 3;
2272
+ */
2273
+ success: boolean;
2274
+ /**
2275
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
2276
+ */
2277
+ error?: CommandError;
2076
2278
  };
2077
2279
  /**
2078
2280
  * Describes the message browserscale.v1.WaitForAnyResponseResponse.
@@ -2123,6 +2325,17 @@ export type ModifyRequestResponse = Message<"browserscale.v1.ModifyRequestRespon
2123
2325
  * @generated from field: browserscale.v1.InterceptedRequest request = 1;
2124
2326
  */
2125
2327
  request?: InterceptedRequest;
2328
+ /**
2329
+ * False iff the command refused; then error carries the code. See the
2330
+ * protocol definition for which codes this command can return.
2331
+ *
2332
+ * @generated from field: bool success = 2;
2333
+ */
2334
+ success: boolean;
2335
+ /**
2336
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
2337
+ */
2338
+ error?: CommandError;
2126
2339
  };
2127
2340
  /**
2128
2341
  * Describes the message browserscale.v1.ModifyRequestResponse.
@@ -2195,6 +2408,18 @@ export type StopNetworkCaptureResponse = Message<"browserscale.v1.StopNetworkCap
2195
2408
  * @generated from field: bool stopped = 1;
2196
2409
  */
2197
2410
  stopped: boolean;
2411
+ /**
2412
+ * Always true today: this command has no semantic failure of its own. Both
2413
+ * fields are carried so every response answers the same question the same
2414
+ * way, and so a future failure mode is an added code, not a new shape.
2415
+ *
2416
+ * @generated from field: bool success = 2;
2417
+ */
2418
+ success: boolean;
2419
+ /**
2420
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
2421
+ */
2422
+ error?: CommandError;
2198
2423
  };
2199
2424
  /**
2200
2425
  * Describes the message browserscale.v1.StopNetworkCaptureResponse.
@@ -2425,6 +2650,18 @@ export type GetCookiesResponse = Message<"browserscale.v1.GetCookiesResponse"> &
2425
2650
  * @generated from field: repeated browserscale.v1.CookieParam cookies = 1;
2426
2651
  */
2427
2652
  cookies: CookieParam[];
2653
+ /**
2654
+ * Always true today: this command has no semantic failure of its own. Both
2655
+ * fields are carried so every response answers the same question the same
2656
+ * way, and so a future failure mode is an added code, not a new shape.
2657
+ *
2658
+ * @generated from field: bool success = 2;
2659
+ */
2660
+ success: boolean;
2661
+ /**
2662
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
2663
+ */
2664
+ error?: CommandError;
2428
2665
  };
2429
2666
  /**
2430
2667
  * Describes the message browserscale.v1.GetCookiesResponse.
@@ -2550,6 +2787,18 @@ export type GetStorageResponse = Message<"browserscale.v1.GetStorageResponse"> &
2550
2787
  * @generated from field: repeated browserscale.v1.StorageOriginEntry storage = 1;
2551
2788
  */
2552
2789
  storage: StorageOriginEntry[];
2790
+ /**
2791
+ * Always true today: this command has no semantic failure of its own. Both
2792
+ * fields are carried so every response answers the same question the same
2793
+ * way, and so a future failure mode is an added code, not a new shape.
2794
+ *
2795
+ * @generated from field: bool success = 2;
2796
+ */
2797
+ success: boolean;
2798
+ /**
2799
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
2800
+ */
2801
+ error?: CommandError;
2553
2802
  };
2554
2803
  /**
2555
2804
  * Describes the message browserscale.v1.GetStorageResponse.
@@ -2721,6 +2970,18 @@ export type GetAuthSessionResponse = Message<"browserscale.v1.GetAuthSessionResp
2721
2970
  * @generated from field: optional browserscale.v1.AuthSession session = 1;
2722
2971
  */
2723
2972
  session?: AuthSession;
2973
+ /**
2974
+ * Always true today: this command has no semantic failure of its own. Both
2975
+ * fields are carried so every response answers the same question the same
2976
+ * way, and so a future failure mode is an added code, not a new shape.
2977
+ *
2978
+ * @generated from field: bool success = 2;
2979
+ */
2980
+ success: boolean;
2981
+ /**
2982
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
2983
+ */
2984
+ error?: CommandError;
2724
2985
  };
2725
2986
  /**
2726
2987
  * Describes the message browserscale.v1.GetAuthSessionResponse.
@@ -2793,6 +3054,18 @@ export type GetDOMResponse = Message<"browserscale.v1.GetDOMResponse"> & {
2793
3054
  * @generated from field: string dom = 1;
2794
3055
  */
2795
3056
  dom: string;
3057
+ /**
3058
+ * Always true today: this command has no semantic failure of its own. Both
3059
+ * fields are carried so every response answers the same question the same
3060
+ * way, and so a future failure mode is an added code, not a new shape.
3061
+ *
3062
+ * @generated from field: bool success = 2;
3063
+ */
3064
+ success: boolean;
3065
+ /**
3066
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
3067
+ */
3068
+ error?: CommandError;
2796
3069
  };
2797
3070
  /**
2798
3071
  * Describes the message browserscale.v1.GetDOMResponse.
@@ -2900,6 +3173,17 @@ export type GetObservationResponse = Message<"browserscale.v1.GetObservationResp
2900
3173
  * @generated from field: string observation = 1;
2901
3174
  */
2902
3175
  observation: string;
3176
+ /**
3177
+ * False iff the command refused; then error carries the code. See the
3178
+ * protocol definition for which codes this command can return.
3179
+ *
3180
+ * @generated from field: bool success = 3;
3181
+ */
3182
+ success: boolean;
3183
+ /**
3184
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
3185
+ */
3186
+ error?: CommandError;
2903
3187
  };
2904
3188
  /**
2905
3189
  * Describes the message browserscale.v1.GetObservationResponse.
@@ -3009,6 +3293,17 @@ export type StartDomMirrorResponse = Message<"browserscale.v1.StartDomMirrorResp
3009
3293
  * @generated from field: uint64 seq = 3;
3010
3294
  */
3011
3295
  seq: bigint;
3296
+ /**
3297
+ * False iff the command refused; then error carries the code. See the
3298
+ * protocol definition for which codes this command can return.
3299
+ *
3300
+ * @generated from field: bool success = 5;
3301
+ */
3302
+ success: boolean;
3303
+ /**
3304
+ * @generated from field: optional browserscale.v1.CommandError error = 6;
3305
+ */
3306
+ error?: CommandError;
3012
3307
  };
3013
3308
  /**
3014
3309
  * Describes the message browserscale.v1.StartDomMirrorResponse.
@@ -3085,6 +3380,17 @@ export type GetDomChildrenResponse = Message<"browserscale.v1.GetDomChildrenResp
3085
3380
  * @generated from field: uint64 seq = 2;
3086
3381
  */
3087
3382
  seq: bigint;
3383
+ /**
3384
+ * False iff the command refused; then error carries the code. See the
3385
+ * protocol definition for which codes this command can return.
3386
+ *
3387
+ * @generated from field: bool success = 3;
3388
+ */
3389
+ success: boolean;
3390
+ /**
3391
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
3392
+ */
3393
+ error?: CommandError;
3088
3394
  };
3089
3395
  /**
3090
3396
  * Describes the message browserscale.v1.GetDomChildrenResponse.
@@ -3162,6 +3468,17 @@ export type RevealDomNodeResponse = Message<"browserscale.v1.RevealDomNodeRespon
3162
3468
  * @generated from field: uint64 seq = 2;
3163
3469
  */
3164
3470
  seq: bigint;
3471
+ /**
3472
+ * False iff the command refused; then error carries the code. See the
3473
+ * protocol definition for which codes this command can return.
3474
+ *
3475
+ * @generated from field: bool success = 3;
3476
+ */
3477
+ success: boolean;
3478
+ /**
3479
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
3480
+ */
3481
+ error?: CommandError;
3165
3482
  };
3166
3483
  /**
3167
3484
  * Describes the message browserscale.v1.RevealDomNodeResponse.
@@ -3200,6 +3517,18 @@ export type GetDomRevisionResponse = Message<"browserscale.v1.GetDomRevisionResp
3200
3517
  * @generated from field: uint64 revision = 1;
3201
3518
  */
3202
3519
  revision: bigint;
3520
+ /**
3521
+ * Always true today: this command has no semantic failure of its own. Both
3522
+ * fields are carried so every response answers the same question the same
3523
+ * way, and so a future failure mode is an added code, not a new shape.
3524
+ *
3525
+ * @generated from field: bool success = 2;
3526
+ */
3527
+ success: boolean;
3528
+ /**
3529
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
3530
+ */
3531
+ error?: CommandError;
3203
3532
  };
3204
3533
  /**
3205
3534
  * Describes the message browserscale.v1.GetDomRevisionResponse.
@@ -3392,6 +3721,18 @@ export type InspectAtPositionResponse = Message<"browserscale.v1.InspectAtPositi
3392
3721
  * @generated from field: browserscale.v1.Rect bounds = 6;
3393
3722
  */
3394
3723
  bounds?: Rect;
3724
+ /**
3725
+ * Always true today: this command has no semantic failure of its own. Both
3726
+ * fields are carried so every response answers the same question the same
3727
+ * way, and so a future failure mode is an added code, not a new shape.
3728
+ *
3729
+ * @generated from field: bool success = 7;
3730
+ */
3731
+ success: boolean;
3732
+ /**
3733
+ * @generated from field: optional browserscale.v1.CommandError error = 8;
3734
+ */
3735
+ error?: CommandError;
3395
3736
  };
3396
3737
  /**
3397
3738
  * Describes the message browserscale.v1.InspectAtPositionResponse.
@@ -3617,6 +3958,18 @@ export type GetSelectionResponse = Message<"browserscale.v1.GetSelectionResponse
3617
3958
  * @generated from field: string text = 1;
3618
3959
  */
3619
3960
  text: string;
3961
+ /**
3962
+ * Always true today: this command has no semantic failure of its own. Both
3963
+ * fields are carried so every response answers the same question the same
3964
+ * way, and so a future failure mode is an added code, not a new shape.
3965
+ *
3966
+ * @generated from field: bool success = 2;
3967
+ */
3968
+ success: boolean;
3969
+ /**
3970
+ * @generated from field: optional browserscale.v1.CommandError error = 3;
3971
+ */
3972
+ error?: CommandError;
3620
3973
  };
3621
3974
  /**
3622
3975
  * Describes the message browserscale.v1.GetSelectionResponse.
@@ -3684,6 +4037,17 @@ export type ScreenshotResponse = Message<"browserscale.v1.ScreenshotResponse"> &
3684
4037
  * @generated from field: int32 height = 3;
3685
4038
  */
3686
4039
  height: number;
4040
+ /**
4041
+ * False iff the command refused; then error carries the code. See the
4042
+ * protocol definition for which codes this command can return.
4043
+ *
4044
+ * @generated from field: bool success = 4;
4045
+ */
4046
+ success: boolean;
4047
+ /**
4048
+ * @generated from field: optional browserscale.v1.CommandError error = 5;
4049
+ */
4050
+ error?: CommandError;
3687
4051
  };
3688
4052
  /**
3689
4053
  * Describes the message browserscale.v1.ScreenshotResponse.
@@ -3812,6 +4176,12 @@ export type ReadCanvasResponse = Message<"browserscale.v1.ReadCanvasResponse"> &
3812
4176
  * @generated from field: bool origin_clean = 7;
3813
4177
  */
3814
4178
  originClean: boolean;
4179
+ /**
4180
+ * Present iff success is false: "not_found", "not_element" or "not_readable".
4181
+ *
4182
+ * @generated from field: optional browserscale.v1.CommandError error = 8;
4183
+ */
4184
+ error?: CommandError;
3815
4185
  };
3816
4186
  /**
3817
4187
  * Describes the message browserscale.v1.ReadCanvasResponse.
@@ -3973,6 +4343,17 @@ export type StartStreamResponse = Message<"browserscale.v1.StartStreamResponse">
3973
4343
  * @generated from field: browserscale.v1.Rect viewport = 2;
3974
4344
  */
3975
4345
  viewport?: Rect;
4346
+ /**
4347
+ * False iff the command refused; then error carries the code. See the
4348
+ * protocol definition for which codes this command can return.
4349
+ *
4350
+ * @generated from field: bool success = 3;
4351
+ */
4352
+ success: boolean;
4353
+ /**
4354
+ * @generated from field: optional browserscale.v1.CommandError error = 4;
4355
+ */
4356
+ error?: CommandError;
3976
4357
  };
3977
4358
  /**
3978
4359
  * Describes the message browserscale.v1.StartStreamResponse.
@@ -3997,15 +4378,6 @@ export type StopStreamRequest = Message<"browserscale.v1.StopStreamRequest"> & {
3997
4378
  * Use `create(StopStreamRequestSchema)` to create a new message.
3998
4379
  */
3999
4380
  export declare const StopStreamRequestSchema: GenMessage<StopStreamRequest>;
4000
- /**
4001
- * @generated from message browserscale.v1.StopStreamResponse
4002
- */
4003
- export type StopStreamResponse = Message<"browserscale.v1.StopStreamResponse"> & {};
4004
- /**
4005
- * Describes the message browserscale.v1.StopStreamResponse.
4006
- * Use `create(StopStreamResponseSchema)` to create a new message.
4007
- */
4008
- export declare const StopStreamResponseSchema: GenMessage<StopStreamResponse>;
4009
4381
  /**
4010
4382
  * One console line a script printed.
4011
4383
  *
@@ -4366,7 +4738,7 @@ export declare const Browser: GenService<{
4366
4738
  setProxy: {
4367
4739
  methodKind: "unary";
4368
4740
  input: typeof SetProxyRequestSchema;
4369
- output: typeof EmptySchema;
4741
+ output: typeof CommandResultSchema;
4370
4742
  };
4371
4743
  /**
4372
4744
  * @generated from rpc browserscale.v1.Browser.GetPages
@@ -4376,6 +4748,17 @@ export declare const Browser: GenService<{
4376
4748
  input: typeof GetPagesRequestSchema;
4377
4749
  output: typeof GetPagesResponseSchema;
4378
4750
  };
4751
+ /**
4752
+ * What the session has consumed so far. The final figures need no call of
4753
+ * their own: the stop endpoint returns them.
4754
+ *
4755
+ * @generated from rpc browserscale.v1.Browser.GetUsage
4756
+ */
4757
+ getUsage: {
4758
+ methodKind: "unary";
4759
+ input: typeof GetUsageRequestSchema;
4760
+ output: typeof GetUsageResponseSchema;
4761
+ };
4379
4762
  /**
4380
4763
  * Page navigation / content
4381
4764
  *
@@ -4392,7 +4775,7 @@ export declare const Browser: GenService<{
4392
4775
  loadHTML: {
4393
4776
  methodKind: "unary";
4394
4777
  input: typeof LoadHTMLRequestSchema;
4395
- output: typeof EmptySchema;
4778
+ output: typeof CommandResultSchema;
4396
4779
  };
4397
4780
  /**
4398
4781
  * Evaluation
@@ -4404,14 +4787,6 @@ export declare const Browser: GenService<{
4404
4787
  input: typeof EvaluateRequestSchema;
4405
4788
  output: typeof EvaluateResponseSchema;
4406
4789
  };
4407
- /**
4408
- * @generated from rpc browserscale.v1.Browser.Run
4409
- */
4410
- run: {
4411
- methodKind: "unary";
4412
- input: typeof RunRequestSchema;
4413
- output: typeof RunResponseSchema;
4414
- };
4415
4790
  /**
4416
4791
  * Waiting
4417
4792
  *
@@ -4508,7 +4883,7 @@ export declare const Browser: GenService<{
4508
4883
  setBlockList: {
4509
4884
  methodKind: "unary";
4510
4885
  input: typeof SetBlockListRequestSchema;
4511
- output: typeof EmptySchema;
4886
+ output: typeof CommandResultSchema;
4512
4887
  };
4513
4888
  /**
4514
4889
  * @generated from rpc browserscale.v1.Browser.SetStaticPaths
@@ -4516,7 +4891,7 @@ export declare const Browser: GenService<{
4516
4891
  setStaticPaths: {
4517
4892
  methodKind: "unary";
4518
4893
  input: typeof SetStaticPathsRequestSchema;
4519
- output: typeof EmptySchema;
4894
+ output: typeof CommandResultSchema;
4520
4895
  };
4521
4896
  /**
4522
4897
  * @generated from rpc browserscale.v1.Browser.WaitForAnyRequest
@@ -4553,7 +4928,7 @@ export declare const Browser: GenService<{
4553
4928
  startNetworkCapture: {
4554
4929
  methodKind: "unary";
4555
4930
  input: typeof StartNetworkCaptureRequestSchema;
4556
- output: typeof EmptySchema;
4931
+ output: typeof CommandResultSchema;
4557
4932
  };
4558
4933
  /**
4559
4934
  * @generated from rpc browserscale.v1.Browser.StopNetworkCapture
@@ -4587,7 +4962,7 @@ export declare const Browser: GenService<{
4587
4962
  setCookies: {
4588
4963
  methodKind: "unary";
4589
4964
  input: typeof SetCookiesRequestSchema;
4590
- output: typeof EmptySchema;
4965
+ output: typeof CommandResultSchema;
4591
4966
  };
4592
4967
  /**
4593
4968
  * @generated from rpc browserscale.v1.Browser.ClearCookies
@@ -4595,7 +4970,7 @@ export declare const Browser: GenService<{
4595
4970
  clearCookies: {
4596
4971
  methodKind: "unary";
4597
4972
  input: typeof ClearCookiesRequestSchema;
4598
- output: typeof EmptySchema;
4973
+ output: typeof CommandResultSchema;
4599
4974
  };
4600
4975
  /**
4601
4976
  * Storage (localStorage)
@@ -4613,7 +4988,7 @@ export declare const Browser: GenService<{
4613
4988
  setStorage: {
4614
4989
  methodKind: "unary";
4615
4990
  input: typeof SetStorageRequestSchema;
4616
- output: typeof EmptySchema;
4991
+ output: typeof CommandResultSchema;
4617
4992
  };
4618
4993
  /**
4619
4994
  * @generated from rpc browserscale.v1.Browser.ClearStorage
@@ -4621,7 +4996,7 @@ export declare const Browser: GenService<{
4621
4996
  clearStorage: {
4622
4997
  methodKind: "unary";
4623
4998
  input: typeof ClearStorageRequestSchema;
4624
- output: typeof EmptySchema;
4999
+ output: typeof CommandResultSchema;
4625
5000
  };
4626
5001
  /**
4627
5002
  * Auth / DBSC (portable signed-in persona)
@@ -4639,7 +5014,7 @@ export declare const Browser: GenService<{
4639
5014
  setAuthSession: {
4640
5015
  methodKind: "unary";
4641
5016
  input: typeof SetAuthSessionRequestSchema;
4642
- output: typeof EmptySchema;
5017
+ output: typeof CommandResultSchema;
4643
5018
  };
4644
5019
  /**
4645
5020
  * DOM / observation
@@ -4681,7 +5056,7 @@ export declare const Browser: GenService<{
4681
5056
  highlightNode: {
4682
5057
  methodKind: "unary";
4683
5058
  input: typeof HighlightNodeRequestSchema;
4684
- output: typeof EmptySchema;
5059
+ output: typeof CommandResultSchema;
4685
5060
  };
4686
5061
  /**
4687
5062
  * DOM mirror — an incremental view of the page's DOM, as ONE tree.
@@ -4715,7 +5090,7 @@ export declare const Browser: GenService<{
4715
5090
  stopDomMirror: {
4716
5091
  methodKind: "unary";
4717
5092
  input: typeof StopDomMirrorRequestSchema;
4718
- output: typeof EmptySchema;
5093
+ output: typeof CommandResultSchema;
4719
5094
  };
4720
5095
  /**
4721
5096
  * @generated from rpc browserscale.v1.Browser.GetDomChildren
@@ -4731,7 +5106,7 @@ export declare const Browser: GenService<{
4731
5106
  releaseDomSubtree: {
4732
5107
  methodKind: "unary";
4733
5108
  input: typeof ReleaseDomSubtreeRequestSchema;
4734
- output: typeof EmptySchema;
5109
+ output: typeof CommandResultSchema;
4735
5110
  };
4736
5111
  /**
4737
5112
  * @generated from rpc browserscale.v1.Browser.RevealDomNode
@@ -4783,7 +5158,7 @@ export declare const Browser: GenService<{
4783
5158
  insertText: {
4784
5159
  methodKind: "unary";
4785
5160
  input: typeof InsertTextRequestSchema;
4786
- output: typeof EmptySchema;
5161
+ output: typeof CommandResultSchema;
4787
5162
  };
4788
5163
  /**
4789
5164
  * @generated from rpc browserscale.v1.Browser.Type
@@ -4791,7 +5166,7 @@ export declare const Browser: GenService<{
4791
5166
  type: {
4792
5167
  methodKind: "unary";
4793
5168
  input: typeof TypeRequestSchema;
4794
- output: typeof EmptySchema;
5169
+ output: typeof CommandResultSchema;
4795
5170
  };
4796
5171
  /**
4797
5172
  * @generated from rpc browserscale.v1.Browser.PressKey
@@ -4799,7 +5174,7 @@ export declare const Browser: GenService<{
4799
5174
  pressKey: {
4800
5175
  methodKind: "unary";
4801
5176
  input: typeof PressKeyRequestSchema;
4802
- output: typeof EmptySchema;
5177
+ output: typeof CommandResultSchema;
4803
5178
  };
4804
5179
  /**
4805
5180
  * @generated from rpc browserscale.v1.Browser.ReleaseKey
@@ -4807,7 +5182,7 @@ export declare const Browser: GenService<{
4807
5182
  releaseKey: {
4808
5183
  methodKind: "unary";
4809
5184
  input: typeof ReleaseKeyRequestSchema;
4810
- output: typeof EmptySchema;
5185
+ output: typeof CommandResultSchema;
4811
5186
  };
4812
5187
  /**
4813
5188
  * @generated from rpc browserscale.v1.Browser.GetSelection
@@ -4855,7 +5230,7 @@ export declare const Browser: GenService<{
4855
5230
  stopStream: {
4856
5231
  methodKind: "unary";
4857
5232
  input: typeof StopStreamRequestSchema;
4858
- output: typeof StopStreamResponseSchema;
5233
+ output: typeof CommandResultSchema;
4859
5234
  };
4860
5235
  /**
4861
5236
  * Scripts — automation that runs inside the browser process rather than