@anthropic-ai/sdk 0.118.0 → 0.119.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.
Files changed (137) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/client.d.mts +8 -2
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +8 -2
  5. package/client.d.ts.map +1 -1
  6. package/client.js +6 -0
  7. package/client.js.map +1 -1
  8. package/client.mjs +6 -0
  9. package/client.mjs.map +1 -1
  10. package/lib/tools/BetaRunnableTool.d.mts +4 -1
  11. package/lib/tools/BetaRunnableTool.d.mts.map +1 -1
  12. package/lib/tools/BetaRunnableTool.d.ts +4 -1
  13. package/lib/tools/BetaRunnableTool.d.ts.map +1 -1
  14. package/lib/tools/BetaRunnableTool.js +7 -2
  15. package/lib/tools/BetaRunnableTool.js.map +1 -1
  16. package/lib/tools/BetaRunnableTool.mjs +7 -2
  17. package/lib/tools/BetaRunnableTool.mjs.map +1 -1
  18. package/lib/tools/BetaToolRunner.d.mts.map +1 -1
  19. package/lib/tools/BetaToolRunner.d.ts.map +1 -1
  20. package/lib/tools/BetaToolRunner.js +3 -1
  21. package/lib/tools/BetaToolRunner.js.map +1 -1
  22. package/lib/tools/BetaToolRunner.mjs +3 -1
  23. package/lib/tools/BetaToolRunner.mjs.map +1 -1
  24. package/package.json +1 -1
  25. package/resources/beta/beta.d.mts +4 -4
  26. package/resources/beta/beta.d.mts.map +1 -1
  27. package/resources/beta/beta.d.ts +4 -4
  28. package/resources/beta/beta.d.ts.map +1 -1
  29. package/resources/beta/beta.js.map +1 -1
  30. package/resources/beta/beta.mjs.map +1 -1
  31. package/resources/beta/files.d.mts +22 -22
  32. package/resources/beta/files.d.mts.map +1 -1
  33. package/resources/beta/files.d.ts +22 -22
  34. package/resources/beta/files.d.ts.map +1 -1
  35. package/resources/beta/files.js +4 -4
  36. package/resources/beta/files.js.map +1 -1
  37. package/resources/beta/files.mjs +4 -4
  38. package/resources/beta/files.mjs.map +1 -1
  39. package/resources/beta/index.d.mts +2 -2
  40. package/resources/beta/index.d.mts.map +1 -1
  41. package/resources/beta/index.d.ts +2 -2
  42. package/resources/beta/index.d.ts.map +1 -1
  43. package/resources/beta/index.js.map +1 -1
  44. package/resources/beta/index.mjs.map +1 -1
  45. package/resources/beta/messages/index.d.mts +1 -1
  46. package/resources/beta/messages/index.d.mts.map +1 -1
  47. package/resources/beta/messages/index.d.ts +1 -1
  48. package/resources/beta/messages/index.d.ts.map +1 -1
  49. package/resources/beta/messages/index.js.map +1 -1
  50. package/resources/beta/messages/index.mjs.map +1 -1
  51. package/resources/beta/messages/messages.d.mts +1201 -4
  52. package/resources/beta/messages/messages.d.mts.map +1 -1
  53. package/resources/beta/messages/messages.d.ts +1201 -4
  54. package/resources/beta/messages/messages.d.ts.map +1 -1
  55. package/resources/beta/messages/messages.js.map +1 -1
  56. package/resources/beta/messages/messages.mjs.map +1 -1
  57. package/resources/files.d.mts +105 -0
  58. package/resources/files.d.mts.map +1 -0
  59. package/resources/files.d.ts +105 -0
  60. package/resources/files.d.ts.map +1 -0
  61. package/resources/files.js +52 -0
  62. package/resources/files.js.map +1 -0
  63. package/resources/files.mjs +48 -0
  64. package/resources/files.mjs.map +1 -0
  65. package/resources/index.d.mts +3 -1
  66. package/resources/index.d.mts.map +1 -1
  67. package/resources/index.d.ts +3 -1
  68. package/resources/index.d.ts.map +1 -1
  69. package/resources/index.js +5 -1
  70. package/resources/index.js.map +1 -1
  71. package/resources/index.mjs +2 -0
  72. package/resources/index.mjs.map +1 -1
  73. package/resources/messages/index.d.mts +1 -1
  74. package/resources/messages/index.d.mts.map +1 -1
  75. package/resources/messages/index.d.ts +1 -1
  76. package/resources/messages/index.d.ts.map +1 -1
  77. package/resources/messages/index.js.map +1 -1
  78. package/resources/messages/index.mjs.map +1 -1
  79. package/resources/messages/messages.d.mts +1267 -7
  80. package/resources/messages/messages.d.mts.map +1 -1
  81. package/resources/messages/messages.d.ts +1267 -7
  82. package/resources/messages/messages.d.ts.map +1 -1
  83. package/resources/messages/messages.js.map +1 -1
  84. package/resources/messages/messages.mjs.map +1 -1
  85. package/resources/skills/index.d.mts +3 -0
  86. package/resources/skills/index.d.mts.map +1 -0
  87. package/resources/skills/index.d.ts +3 -0
  88. package/resources/skills/index.d.ts.map +1 -0
  89. package/resources/skills/index.js +9 -0
  90. package/resources/skills/index.js.map +1 -0
  91. package/resources/skills/index.mjs +4 -0
  92. package/resources/skills/index.mjs.map +1 -0
  93. package/resources/skills/skills.d.mts +129 -0
  94. package/resources/skills/skills.d.mts.map +1 -0
  95. package/resources/skills/skills.d.ts +129 -0
  96. package/resources/skills/skills.d.ts.map +1 -0
  97. package/resources/skills/skills.js +44 -0
  98. package/resources/skills/skills.js.map +1 -0
  99. package/resources/skills/skills.mjs +39 -0
  100. package/resources/skills/skills.mjs.map +1 -0
  101. package/resources/skills/versions.d.mts +104 -0
  102. package/resources/skills/versions.d.mts.map +1 -0
  103. package/resources/skills/versions.d.ts +104 -0
  104. package/resources/skills/versions.d.ts.map +1 -0
  105. package/resources/skills/versions.js +41 -0
  106. package/resources/skills/versions.js.map +1 -0
  107. package/resources/skills/versions.mjs +37 -0
  108. package/resources/skills/versions.mjs.map +1 -0
  109. package/resources/skills.d.mts +2 -0
  110. package/resources/skills.d.mts.map +1 -0
  111. package/resources/skills.d.ts +2 -0
  112. package/resources/skills.d.ts.map +1 -0
  113. package/resources/skills.js +6 -0
  114. package/resources/skills.js.map +1 -0
  115. package/resources/skills.mjs +3 -0
  116. package/resources/skills.mjs.map +1 -0
  117. package/src/client.ts +172 -0
  118. package/src/lib/tools/BetaRunnableTool.ts +9 -2
  119. package/src/lib/tools/BetaToolRunner.ts +6 -1
  120. package/src/resources/beta/beta.ts +126 -6
  121. package/src/resources/beta/files.ts +27 -27
  122. package/src/resources/beta/index.ts +63 -3
  123. package/src/resources/beta/messages/index.ts +60 -0
  124. package/src/resources/beta/messages/messages.ts +1861 -411
  125. package/src/resources/files.ts +163 -0
  126. package/src/resources/index.ts +83 -0
  127. package/src/resources/messages/index.ts +66 -0
  128. package/src/resources/messages/messages.ts +1648 -115
  129. package/src/resources/skills/index.ts +21 -0
  130. package/src/resources/skills/skills.ts +194 -0
  131. package/src/resources/skills/versions.ts +160 -0
  132. package/src/resources/skills.ts +3 -0
  133. package/src/version.ts +1 -1
  134. package/version.d.mts +1 -1
  135. package/version.d.ts +1 -1
  136. package/version.js +1 -1
  137. package/version.mjs +1 -1
@@ -562,448 +562,1462 @@ export interface BetaBashCodeExecutionToolResultErrorParam {
562
562
  type: 'bash_code_execution_tool_result_error';
563
563
  }
564
564
 
565
- export interface BetaCacheControlEphemeral {
566
- type: 'ephemeral';
565
+ /**
566
+ * `close_tab`'s config overrides.
567
+ */
568
+ export interface BetaBrowserCloseTabConfig {
569
+ /**
570
+ * Defer loading for this member. Must resolve to the same value on every enabled
571
+ * member of the toolset.
572
+ */
573
+ defer_loading?: boolean | null;
567
574
 
568
575
  /**
569
- * The time-to-live for the cache control breakpoint.
570
- *
571
- * This may be one the following values:
572
- *
573
- * - `5m`: 5 minutes
574
- * - `1h`: 1 hour
575
- *
576
- * Defaults to `5m`. See
577
- * [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
578
- * for details.
576
+ * Whether this member is offered to the model. Default is per member, per the
577
+ * toolset's documentation. A member whose enabled resolves false is withheld from
578
+ * the served schema.
579
579
  */
580
- ttl?: '5m' | '1h';
580
+ enabled?: boolean | null;
581
581
  }
582
582
 
583
- export interface BetaCacheCreation {
583
+ /**
584
+ * `double_click`'s config overrides.
585
+ */
586
+ export interface BetaBrowserDoubleClickConfig {
584
587
  /**
585
- * The number of input tokens used to create the 1 hour cache entry.
588
+ * Defer loading for this member. Must resolve to the same value on every enabled
589
+ * member of the toolset.
586
590
  */
587
- ephemeral_1h_input_tokens: number;
591
+ defer_loading?: boolean | null;
588
592
 
589
593
  /**
590
- * The number of input tokens used to create the 5 minute cache entry.
594
+ * Whether this member is offered to the model. Default is per member, per the
595
+ * toolset's documentation. A member whose enabled resolves false is withheld from
596
+ * the served schema.
591
597
  */
592
- ephemeral_5m_input_tokens: number;
598
+ enabled?: boolean | null;
593
599
  }
594
600
 
595
- export interface BetaCacheMissMessagesChanged {
601
+ /**
602
+ * `file_upload`'s config overrides.
603
+ */
604
+ export interface BetaBrowserFileUploadConfig {
596
605
  /**
597
- * Approximate number of input tokens that would have been read from cache had the
598
- * prefix matched the previous request.
606
+ * Defer loading for this member. Must resolve to the same value on every enabled
607
+ * member of the toolset.
599
608
  */
600
- cache_missed_input_tokens: number;
609
+ defer_loading?: boolean | null;
601
610
 
602
- type: 'messages_changed';
611
+ /**
612
+ * Whether this member is offered to the model. Default is per member, per the
613
+ * toolset's documentation. A member whose enabled resolves false is withheld from
614
+ * the served schema.
615
+ */
616
+ enabled?: boolean | null;
603
617
  }
604
618
 
605
- export interface BetaCacheMissModelChanged {
619
+ /**
620
+ * `find`'s config overrides.
621
+ */
622
+ export interface BetaBrowserFindConfig {
606
623
  /**
607
- * Approximate number of input tokens that would have been read from cache had the
608
- * prefix matched the previous request.
624
+ * Defer loading for this member. Must resolve to the same value on every enabled
625
+ * member of the toolset.
609
626
  */
610
- cache_missed_input_tokens: number;
627
+ defer_loading?: boolean | null;
611
628
 
612
- type: 'model_changed';
629
+ /**
630
+ * Whether this member is offered to the model. Default is per member, per the
631
+ * toolset's documentation. A member whose enabled resolves false is withheld from
632
+ * the served schema.
633
+ */
634
+ enabled?: boolean | null;
613
635
  }
614
636
 
615
- export interface BetaCacheMissPreviousMessageNotFound {
616
- type: 'previous_message_not_found';
637
+ /**
638
+ * `form_input`'s config overrides.
639
+ */
640
+ export interface BetaBrowserFormInputConfig {
641
+ /**
642
+ * Defer loading for this member. Must resolve to the same value on every enabled
643
+ * member of the toolset.
644
+ */
645
+ defer_loading?: boolean | null;
646
+
647
+ /**
648
+ * Whether this member is offered to the model. Default is per member, per the
649
+ * toolset's documentation. A member whose enabled resolves false is withheld from
650
+ * the served schema.
651
+ */
652
+ enabled?: boolean | null;
617
653
  }
618
654
 
619
- export interface BetaCacheMissSystemChanged {
655
+ /**
656
+ * `get_page_text`'s config overrides.
657
+ */
658
+ export interface BetaBrowserGetPageTextConfig {
620
659
  /**
621
- * Approximate number of input tokens that would have been read from cache had the
622
- * prefix matched the previous request.
660
+ * Defer loading for this member. Must resolve to the same value on every enabled
661
+ * member of the toolset.
623
662
  */
624
- cache_missed_input_tokens: number;
663
+ defer_loading?: boolean | null;
625
664
 
626
- type: 'system_changed';
665
+ /**
666
+ * Whether this member is offered to the model. Default is per member, per the
667
+ * toolset's documentation. A member whose enabled resolves false is withheld from
668
+ * the served schema.
669
+ */
670
+ enabled?: boolean | null;
627
671
  }
628
672
 
629
- export interface BetaCacheMissToolsChanged {
673
+ /**
674
+ * `hold_key`'s config overrides.
675
+ */
676
+ export interface BetaBrowserHoldKeyConfig {
630
677
  /**
631
- * Approximate number of input tokens that would have been read from cache had the
632
- * prefix matched the previous request.
678
+ * Defer loading for this member. Must resolve to the same value on every enabled
679
+ * member of the toolset.
633
680
  */
634
- cache_missed_input_tokens: number;
681
+ defer_loading?: boolean | null;
635
682
 
636
- type: 'tools_changed';
683
+ /**
684
+ * Whether this member is offered to the model. Default is per member, per the
685
+ * toolset's documentation. A member whose enabled resolves false is withheld from
686
+ * the served schema.
687
+ */
688
+ enabled?: boolean | null;
637
689
  }
638
690
 
639
- export interface BetaCacheMissUnavailable {
640
- type: 'unavailable';
641
- }
691
+ /**
692
+ * `hover`'s config overrides.
693
+ */
694
+ export interface BetaBrowserHoverConfig {
695
+ /**
696
+ * Defer loading for this member. Must resolve to the same value on every enabled
697
+ * member of the toolset.
698
+ */
699
+ defer_loading?: boolean | null;
642
700
 
643
- export interface BetaCitationCharLocation {
644
- cited_text: string;
701
+ /**
702
+ * Whether this member is offered to the model. Default is per member, per the
703
+ * toolset's documentation. A member whose enabled resolves false is withheld from
704
+ * the served schema.
705
+ */
706
+ enabled?: boolean | null;
707
+ }
645
708
 
646
- document_index: number;
709
+ /**
710
+ * `javascript_exec`'s config overrides.
711
+ */
712
+ export interface BetaBrowserJavascriptExecConfig {
713
+ /**
714
+ * Defer loading for this member. Must resolve to the same value on every enabled
715
+ * member of the toolset.
716
+ */
717
+ defer_loading?: boolean | null;
647
718
 
648
- document_title: string | null;
719
+ /**
720
+ * Whether this member is offered to the model. Default is per member, per the
721
+ * toolset's documentation. A member whose enabled resolves false is withheld from
722
+ * the served schema.
723
+ */
724
+ enabled?: boolean | null;
725
+ }
649
726
 
650
- end_char_index: number;
727
+ /**
728
+ * `key`'s config overrides.
729
+ */
730
+ export interface BetaBrowserKeyConfig {
731
+ /**
732
+ * Defer loading for this member. Must resolve to the same value on every enabled
733
+ * member of the toolset.
734
+ */
735
+ defer_loading?: boolean | null;
651
736
 
652
- file_id: string | null;
737
+ /**
738
+ * Whether this member is offered to the model. Default is per member, per the
739
+ * toolset's documentation. A member whose enabled resolves false is withheld from
740
+ * the served schema.
741
+ */
742
+ enabled?: boolean | null;
743
+ }
653
744
 
654
- start_char_index: number;
745
+ /**
746
+ * `left_click`'s config overrides.
747
+ */
748
+ export interface BetaBrowserLeftClickConfig {
749
+ /**
750
+ * Defer loading for this member. Must resolve to the same value on every enabled
751
+ * member of the toolset.
752
+ */
753
+ defer_loading?: boolean | null;
655
754
 
656
- type: 'char_location';
755
+ /**
756
+ * Whether this member is offered to the model. Default is per member, per the
757
+ * toolset's documentation. A member whose enabled resolves false is withheld from
758
+ * the served schema.
759
+ */
760
+ enabled?: boolean | null;
657
761
  }
658
762
 
659
- export interface BetaCitationCharLocationParam {
660
- cited_text: string;
763
+ /**
764
+ * `left_click_drag`'s config overrides.
765
+ */
766
+ export interface BetaBrowserLeftClickDragConfig {
767
+ /**
768
+ * Defer loading for this member. Must resolve to the same value on every enabled
769
+ * member of the toolset.
770
+ */
771
+ defer_loading?: boolean | null;
661
772
 
662
- document_index: number;
773
+ /**
774
+ * Whether this member is offered to the model. Default is per member, per the
775
+ * toolset's documentation. A member whose enabled resolves false is withheld from
776
+ * the served schema.
777
+ */
778
+ enabled?: boolean | null;
779
+ }
663
780
 
664
- document_title: string | null;
781
+ /**
782
+ * `left_mouse_down`'s config overrides.
783
+ */
784
+ export interface BetaBrowserLeftMouseDownConfig {
785
+ /**
786
+ * Defer loading for this member. Must resolve to the same value on every enabled
787
+ * member of the toolset.
788
+ */
789
+ defer_loading?: boolean | null;
665
790
 
666
- end_char_index: number;
791
+ /**
792
+ * Whether this member is offered to the model. Default is per member, per the
793
+ * toolset's documentation. A member whose enabled resolves false is withheld from
794
+ * the served schema.
795
+ */
796
+ enabled?: boolean | null;
797
+ }
667
798
 
668
- start_char_index: number;
799
+ /**
800
+ * `left_mouse_up`'s config overrides.
801
+ */
802
+ export interface BetaBrowserLeftMouseUpConfig {
803
+ /**
804
+ * Defer loading for this member. Must resolve to the same value on every enabled
805
+ * member of the toolset.
806
+ */
807
+ defer_loading?: boolean | null;
669
808
 
670
- type: 'char_location';
809
+ /**
810
+ * Whether this member is offered to the model. Default is per member, per the
811
+ * toolset's documentation. A member whose enabled resolves false is withheld from
812
+ * the served schema.
813
+ */
814
+ enabled?: boolean | null;
671
815
  }
672
816
 
673
- export interface BetaCitationConfig {
674
- enabled: boolean;
675
- }
817
+ /**
818
+ * `list_tabs`'s config overrides.
819
+ */
820
+ export interface BetaBrowserListTabsConfig {
821
+ /**
822
+ * Defer loading for this member. Must resolve to the same value on every enabled
823
+ * member of the toolset.
824
+ */
825
+ defer_loading?: boolean | null;
676
826
 
677
- export interface BetaCitationContentBlockLocation {
678
827
  /**
679
- * The full text of the cited block range, concatenated.
680
- *
681
- * Always equals the contents of `content[start_block_index:end_block_index]`
682
- * joined together. The text block is the minimal citable unit; this field is never
683
- * a substring of a single block. Not counted toward output tokens, and not counted
684
- * toward input tokens when sent back in subsequent turns.
828
+ * Whether this member is offered to the model. Default is per member, per the
829
+ * toolset's documentation. A member whose enabled resolves false is withheld from
830
+ * the served schema.
685
831
  */
686
- cited_text: string;
832
+ enabled?: boolean | null;
833
+ }
687
834
 
688
- document_index: number;
835
+ /**
836
+ * `middle_click`'s config overrides.
837
+ */
838
+ export interface BetaBrowserMiddleClickConfig {
839
+ /**
840
+ * Defer loading for this member. Must resolve to the same value on every enabled
841
+ * member of the toolset.
842
+ */
843
+ defer_loading?: boolean | null;
689
844
 
690
- document_title: string | null;
845
+ /**
846
+ * Whether this member is offered to the model. Default is per member, per the
847
+ * toolset's documentation. A member whose enabled resolves false is withheld from
848
+ * the served schema.
849
+ */
850
+ enabled?: boolean | null;
851
+ }
691
852
 
853
+ /**
854
+ * `mouse_move`'s config overrides.
855
+ */
856
+ export interface BetaBrowserMouseMoveConfig {
692
857
  /**
693
- * Exclusive 0-based end index of the cited block range in the source's `content`
694
- * array.
695
- *
696
- * Always greater than `start_block_index`; a single-block citation has
697
- * `end_block_index = start_block_index + 1`.
858
+ * Defer loading for this member. Must resolve to the same value on every enabled
859
+ * member of the toolset.
698
860
  */
699
- end_block_index: number;
861
+ defer_loading?: boolean | null;
700
862
 
701
- file_id: string | null;
863
+ /**
864
+ * Whether this member is offered to the model. Default is per member, per the
865
+ * toolset's documentation. A member whose enabled resolves false is withheld from
866
+ * the served schema.
867
+ */
868
+ enabled?: boolean | null;
869
+ }
702
870
 
871
+ /**
872
+ * `navigate`'s config overrides.
873
+ */
874
+ export interface BetaBrowserNavigateConfig {
703
875
  /**
704
- * 0-based index of the first cited block in the source's `content` array.
876
+ * Defer loading for this member. Must resolve to the same value on every enabled
877
+ * member of the toolset.
705
878
  */
706
- start_block_index: number;
879
+ defer_loading?: boolean | null;
707
880
 
708
- type: 'content_block_location';
881
+ /**
882
+ * Whether this member is offered to the model. Default is per member, per the
883
+ * toolset's documentation. A member whose enabled resolves false is withheld from
884
+ * the served schema.
885
+ */
886
+ enabled?: boolean | null;
709
887
  }
710
888
 
711
- export interface BetaCitationContentBlockLocationParam {
889
+ /**
890
+ * `new_tab`'s config overrides.
891
+ */
892
+ export interface BetaBrowserNewTabConfig {
712
893
  /**
713
- * The full text of the cited block range, concatenated.
714
- *
715
- * Always equals the contents of `content[start_block_index:end_block_index]`
716
- * joined together. The text block is the minimal citable unit; this field is never
717
- * a substring of a single block. Not counted toward output tokens, and not counted
718
- * toward input tokens when sent back in subsequent turns.
894
+ * Defer loading for this member. Must resolve to the same value on every enabled
895
+ * member of the toolset.
719
896
  */
720
- cited_text: string;
897
+ defer_loading?: boolean | null;
721
898
 
722
- document_index: number;
899
+ /**
900
+ * Whether this member is offered to the model. Default is per member, per the
901
+ * toolset's documentation. A member whose enabled resolves false is withheld from
902
+ * the served schema.
903
+ */
904
+ enabled?: boolean | null;
905
+ }
723
906
 
724
- document_title: string | null;
907
+ /**
908
+ * `read_console`'s config overrides.
909
+ */
910
+ export interface BetaBrowserReadConsoleConfig {
911
+ /**
912
+ * Defer loading for this member. Must resolve to the same value on every enabled
913
+ * member of the toolset.
914
+ */
915
+ defer_loading?: boolean | null;
725
916
 
726
917
  /**
727
- * Exclusive 0-based end index of the cited block range in the source's `content`
728
- * array.
729
- *
730
- * Always greater than `start_block_index`; a single-block citation has
731
- * `end_block_index = start_block_index + 1`.
918
+ * Whether this member is offered to the model. Default is per member, per the
919
+ * toolset's documentation. A member whose enabled resolves false is withheld from
920
+ * the served schema.
732
921
  */
733
- end_block_index: number;
922
+ enabled?: boolean | null;
923
+ }
734
924
 
925
+ /**
926
+ * `read_network`'s config overrides.
927
+ */
928
+ export interface BetaBrowserReadNetworkConfig {
735
929
  /**
736
- * 0-based index of the first cited block in the source's `content` array.
930
+ * Defer loading for this member. Must resolve to the same value on every enabled
931
+ * member of the toolset.
737
932
  */
738
- start_block_index: number;
933
+ defer_loading?: boolean | null;
739
934
 
740
- type: 'content_block_location';
935
+ /**
936
+ * Whether this member is offered to the model. Default is per member, per the
937
+ * toolset's documentation. A member whose enabled resolves false is withheld from
938
+ * the served schema.
939
+ */
940
+ enabled?: boolean | null;
741
941
  }
742
942
 
743
- export interface BetaCitationPageLocation {
744
- cited_text: string;
745
-
746
- document_index: number;
943
+ /**
944
+ * `read_page`'s config overrides.
945
+ */
946
+ export interface BetaBrowserReadPageConfig {
947
+ /**
948
+ * Defer loading for this member. Must resolve to the same value on every enabled
949
+ * member of the toolset.
950
+ */
951
+ defer_loading?: boolean | null;
747
952
 
748
- document_title: string | null;
953
+ /**
954
+ * Whether this member is offered to the model. Default is per member, per the
955
+ * toolset's documentation. A member whose enabled resolves false is withheld from
956
+ * the served schema.
957
+ */
958
+ enabled?: boolean | null;
959
+ }
749
960
 
750
- end_page_number: number;
961
+ /**
962
+ * `right_click`'s config overrides.
963
+ */
964
+ export interface BetaBrowserRightClickConfig {
965
+ /**
966
+ * Defer loading for this member. Must resolve to the same value on every enabled
967
+ * member of the toolset.
968
+ */
969
+ defer_loading?: boolean | null;
751
970
 
752
- file_id: string | null;
971
+ /**
972
+ * Whether this member is offered to the model. Default is per member, per the
973
+ * toolset's documentation. A member whose enabled resolves false is withheld from
974
+ * the served schema.
975
+ */
976
+ enabled?: boolean | null;
977
+ }
753
978
 
754
- start_page_number: number;
979
+ /**
980
+ * `screenshot`'s config overrides.
981
+ */
982
+ export interface BetaBrowserScreenshotConfig {
983
+ /**
984
+ * Defer loading for this member. Must resolve to the same value on every enabled
985
+ * member of the toolset.
986
+ */
987
+ defer_loading?: boolean | null;
755
988
 
756
- type: 'page_location';
989
+ /**
990
+ * Whether this member is offered to the model. Default is per member, per the
991
+ * toolset's documentation. A member whose enabled resolves false is withheld from
992
+ * the served schema.
993
+ */
994
+ enabled?: boolean | null;
757
995
  }
758
996
 
759
- export interface BetaCitationPageLocationParam {
760
- cited_text: string;
997
+ /**
998
+ * `scroll`'s config overrides.
999
+ */
1000
+ export interface BetaBrowserScrollConfig {
1001
+ /**
1002
+ * Defer loading for this member. Must resolve to the same value on every enabled
1003
+ * member of the toolset.
1004
+ */
1005
+ defer_loading?: boolean | null;
761
1006
 
762
- document_index: number;
1007
+ /**
1008
+ * Whether this member is offered to the model. Default is per member, per the
1009
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1010
+ * the served schema.
1011
+ */
1012
+ enabled?: boolean | null;
1013
+ }
763
1014
 
764
- document_title: string | null;
1015
+ /**
1016
+ * `scroll_to`'s config overrides.
1017
+ */
1018
+ export interface BetaBrowserScrollToConfig {
1019
+ /**
1020
+ * Defer loading for this member. Must resolve to the same value on every enabled
1021
+ * member of the toolset.
1022
+ */
1023
+ defer_loading?: boolean | null;
765
1024
 
766
- end_page_number: number;
1025
+ /**
1026
+ * Whether this member is offered to the model. Default is per member, per the
1027
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1028
+ * the served schema.
1029
+ */
1030
+ enabled?: boolean | null;
1031
+ }
767
1032
 
768
- start_page_number: number;
1033
+ /**
1034
+ * The caller's browser state after a browser toolset member call — the full
1035
+ * inventory of open tabs, which tab is active, and any side effects (tabs opened,
1036
+ * download state changes) the call produced.
1037
+ *
1038
+ * At most one per `tool_result`, only on a non-error result answering a browser
1039
+ * toolset member `tool_use`. The server renders the model-visible text from it;
1040
+ * the model never sees the raw fields.
1041
+ */
1042
+ export interface BetaBrowserStateBlockParam {
1043
+ /**
1044
+ * All tabs open in the browser after this call — the full inventory, not a delta.
1045
+ * May be empty. Whenever non-empty, exactly one entry carries `active: true`.
1046
+ */
1047
+ tabs: Array<BetaBrowserStateTabEntry>;
769
1048
 
770
- type: 'page_location';
771
- }
1049
+ type: 'browser_state';
772
1050
 
773
- export interface BetaCitationSearchResultLocation {
774
1051
  /**
775
- * The full text of the cited block range, concatenated.
776
- *
777
- * Always equals the contents of `content[start_block_index:end_block_index]`
778
- * joined together. The text block is the minimal citable unit; this field is never
779
- * a substring of a single block. Not counted toward output tokens, and not counted
780
- * toward input tokens when sent back in subsequent turns.
1052
+ * Create a cache control breakpoint at this content block.
781
1053
  */
782
- cited_text: string;
1054
+ cache_control?: BetaCacheControlEphemeral | null;
783
1055
 
784
1056
  /**
785
- * Exclusive 0-based end index of the cited block range in the source's `content`
786
- * array.
787
- *
788
- * Always greater than `start_block_index`; a single-block citation has
789
- * `end_block_index = start_block_index + 1`.
1057
+ * Tabs opened and download state changes during this call. "Nothing to report" is
1058
+ * expressed by omitting the field, never by an empty list.
790
1059
  */
791
- end_block_index: number;
1060
+ state_changes?: Array<BetaBrowserStateChange> | null;
1061
+ }
1062
+
1063
+ /**
1064
+ * A tab this call's execution opened that remains open at its end — the creation
1065
+ * delta of the `tabs` inventory, not an event log.
1066
+ *
1067
+ * Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
1068
+ * which must include the same `tab_id`. A tab opened during a failed call gets no
1069
+ * deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
1070
+ */
1071
+ export type BetaBrowserStateChange =
1072
+ | BetaBrowserStateChangeTabOpened
1073
+ | BetaBrowserStateChangeDownloadStarted
1074
+ | BetaBrowserStateChangeDownloadCompleted
1075
+ | BetaBrowserStateChangeDownloadFailed;
792
1076
 
1077
+ /**
1078
+ * A file download that finished during this call, reported with the same
1079
+ * `download_id` as its `download_started` — or without a prior `download_started`,
1080
+ * when the download finished during the call that started it (at most one state
1081
+ * change per `download_id` per result).
1082
+ */
1083
+ export interface BetaBrowserStateChangeDownloadCompleted {
793
1084
  /**
794
- * 0-based index of the cited search result among all `search_result` content
795
- * blocks in the request, in the order they appear across messages and tool
796
- * results.
797
- *
798
- * Counted separately from `document_index`; server-side web search results are not
799
- * included in this count.
1085
+ * The caller-assigned identifier for this download, stable across the state
1086
+ * changes reporting it.
800
1087
  */
801
- search_result_index: number;
1088
+ download_id: string;
802
1089
 
803
- source: string;
1090
+ type: 'download_completed';
804
1091
 
805
1092
  /**
806
- * 0-based index of the first cited block in the source's `content` array.
1093
+ * The final post-redirect URL the download was served from.
807
1094
  */
808
- start_block_index: number;
1095
+ url: string;
809
1096
 
810
- title: string | null;
1097
+ /**
1098
+ * Where the executor saved the file, on the executor's filesystem. Only included
1099
+ * when another tool in the same environment can read the file at that path.
1100
+ */
1101
+ path?: string | null;
811
1102
 
812
- type: 'search_result_location';
1103
+ /**
1104
+ * The completed download's size.
1105
+ */
1106
+ size_bytes?: number | null;
813
1107
  }
814
1108
 
815
- export interface BetaCitationSearchResultLocationParam {
1109
+ /**
1110
+ * A file download that failed — or was cancelled — during this call.
1111
+ */
1112
+ export interface BetaBrowserStateChangeDownloadFailed {
816
1113
  /**
817
- * The full text of the cited block range, concatenated.
818
- *
819
- * Always equals the contents of `content[start_block_index:end_block_index]`
820
- * joined together. The text block is the minimal citable unit; this field is never
821
- * a substring of a single block. Not counted toward output tokens, and not counted
822
- * toward input tokens when sent back in subsequent turns.
1114
+ * The caller-assigned identifier for this download, stable across the state
1115
+ * changes reporting it.
823
1116
  */
824
- cited_text: string;
1117
+ download_id: string;
1118
+
1119
+ type: 'download_failed';
825
1120
 
826
1121
  /**
827
- * Exclusive 0-based end index of the cited block range in the source's `content`
828
- * array.
829
- *
830
- * Always greater than `start_block_index`; a single-block citation has
831
- * `end_block_index = start_block_index + 1`.
1122
+ * The final post-redirect URL the download was served from.
832
1123
  */
833
- end_block_index: number;
1124
+ url: string;
834
1125
 
835
1126
  /**
836
- * 0-based index of the cited search result among all `search_result` content
837
- * blocks in the request, in the order they appear across messages and tool
838
- * results.
839
- *
840
- * Counted separately from `document_index`; server-side web search results are not
841
- * included in this count.
1127
+ * The failure or cancellation detail, when known.
842
1128
  */
843
- search_result_index: number;
844
-
845
- source: string;
1129
+ error?: string | null;
1130
+ }
846
1131
 
1132
+ /**
1133
+ * A file download that started during this call.
1134
+ */
1135
+ export interface BetaBrowserStateChangeDownloadStarted {
847
1136
  /**
848
- * 0-based index of the first cited block in the source's `content` array.
1137
+ * The caller-assigned identifier for this download, stable across the state
1138
+ * changes reporting it.
849
1139
  */
850
- start_block_index: number;
1140
+ download_id: string;
851
1141
 
852
- title: string | null;
1142
+ type: 'download_started';
853
1143
 
854
- type: 'search_result_location';
1144
+ /**
1145
+ * The final post-redirect URL the download was served from.
1146
+ */
1147
+ url: string;
855
1148
  }
856
1149
 
857
- export interface BetaCitationWebSearchResultLocationParam {
858
- cited_text: string;
1150
+ /**
1151
+ * A tab this call's execution opened that remains open at its end — the creation
1152
+ * delta of the `tabs` inventory, not an event log.
1153
+ *
1154
+ * Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
1155
+ * which must include the same `tab_id`. A tab opened during a failed call gets no
1156
+ * deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
1157
+ */
1158
+ export interface BetaBrowserStateChangeTabOpened {
1159
+ /**
1160
+ * The `tab_id` of the opened tab, present in `tabs`.
1161
+ */
1162
+ tab_id: string;
859
1163
 
860
- encrypted_index: string;
1164
+ type: 'tab_opened';
1165
+ }
861
1166
 
862
- title: string | null;
1167
+ /**
1168
+ * One open browser tab reported in a `browser_state` block's `tabs` inventory.
1169
+ *
1170
+ * `tab_id` is the caller-assigned identifier for the tab; `title` and `url`
1171
+ * describe the page the tab is currently showing and may be empty strings (a blank
1172
+ * tab legitimately has both empty). `active` marks the tab that is active after
1173
+ * this call; whenever `tabs` is non-empty, exactly one entry is marked.
1174
+ */
1175
+ export interface BetaBrowserStateTabEntry {
1176
+ /**
1177
+ * The caller-assigned identifier for this tab, unique within the inventory.
1178
+ */
1179
+ tab_id: string;
863
1180
 
864
- type: 'web_search_result_location';
1181
+ /**
1182
+ * The title of the page the tab is showing. May be empty.
1183
+ */
1184
+ title: string;
865
1185
 
1186
+ /**
1187
+ * The URL of the page the tab is showing. May be empty.
1188
+ */
866
1189
  url: string;
867
- }
868
1190
 
869
- export interface BetaCitationsConfigParam {
870
- enabled?: boolean;
1191
+ /**
1192
+ * Whether this tab is the active tab after this call. Whenever `tabs` is
1193
+ * non-empty, exactly one entry is marked `active: true`.
1194
+ */
1195
+ active?: boolean;
871
1196
  }
872
1197
 
873
- export interface BetaCitationsDelta {
874
- citation:
875
- | BetaCitationCharLocation
876
- | BetaCitationPageLocation
877
- | BetaCitationContentBlockLocation
878
- | BetaCitationsWebSearchResultLocation
879
- | BetaCitationSearchResultLocation;
1198
+ /**
1199
+ * `switch_tab`'s config overrides.
1200
+ */
1201
+ export interface BetaBrowserSwitchTabConfig {
1202
+ /**
1203
+ * Defer loading for this member. Must resolve to the same value on every enabled
1204
+ * member of the toolset.
1205
+ */
1206
+ defer_loading?: boolean | null;
880
1207
 
881
- type: 'citations_delta';
1208
+ /**
1209
+ * Whether this member is offered to the model. Default is per member, per the
1210
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1211
+ * the served schema.
1212
+ */
1213
+ enabled?: boolean | null;
882
1214
  }
883
1215
 
884
- export interface BetaCitationsWebSearchResultLocation {
885
- cited_text: string;
886
-
887
- encrypted_index: string;
1216
+ /**
1217
+ * The browser toolset: a single `tools[]` entry (carrying no `name`) that declares
1218
+ * the browser tool family. The model is served the family's tool with any members
1219
+ * disabled via `configs` removed from its schema.
1220
+ */
1221
+ export interface BetaBrowserToolset20260801 {
1222
+ type: 'browser_toolset_20260801';
888
1223
 
889
- title: string | null;
1224
+ allowed_callers?: Array<
1225
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1226
+ >;
890
1227
 
891
- type: 'web_search_result_location';
1228
+ /**
1229
+ * Create a cache control breakpoint at this content block.
1230
+ */
1231
+ cache_control?: BetaCacheControlEphemeral | null;
892
1232
 
893
- url: string;
1233
+ /**
1234
+ * Per-member configuration for `browser_toolset_20260801`: one optional field per
1235
+ * member tool, keyed by the member name — the same name the member's `tool_use`
1236
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
1237
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
1238
+ * toolset version's complete member set.
1239
+ */
1240
+ configs?: BetaBrowserToolsetConfigs | null;
894
1241
  }
895
1242
 
896
- export interface BetaClearThinking20251015Edit {
897
- type: 'clear_thinking_20251015';
1243
+ /**
1244
+ * Per-member configuration for `browser_toolset_20260801`: one optional field per
1245
+ * member tool, keyed by the member name — the same name the member's `tool_use`
1246
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
1247
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
1248
+ * toolset version's complete member set.
1249
+ */
1250
+ export interface BetaBrowserToolsetConfigs {
1251
+ /**
1252
+ * `close_tab`'s config overrides.
1253
+ */
1254
+ close_tab?: BetaBrowserCloseTabConfig | null;
898
1255
 
899
1256
  /**
900
- * Number of most recent assistant turns to keep thinking blocks for. Older turns
901
- * will have their thinking blocks removed.
1257
+ * `double_click`'s config overrides.
902
1258
  */
903
- keep?: BetaThinkingTurns | BetaAllThinkingTurns | 'all';
904
- }
1259
+ double_click?: BetaBrowserDoubleClickConfig | null;
905
1260
 
906
- export interface BetaClearThinking20251015EditResponse {
907
1261
  /**
908
- * Number of input tokens cleared by this edit.
1262
+ * `file_upload`'s config overrides.
909
1263
  */
910
- cleared_input_tokens: number;
1264
+ file_upload?: BetaBrowserFileUploadConfig | null;
911
1265
 
912
1266
  /**
913
- * Number of thinking turns that were cleared.
1267
+ * `find`'s config overrides.
914
1268
  */
915
- cleared_thinking_turns: number;
1269
+ find?: BetaBrowserFindConfig | null;
916
1270
 
917
1271
  /**
918
- * The type of context management edit applied.
1272
+ * `form_input`'s config overrides.
919
1273
  */
920
- type: 'clear_thinking_20251015';
921
- }
1274
+ form_input?: BetaBrowserFormInputConfig | null;
922
1275
 
923
- export interface BetaClearToolUses20250919Edit {
924
- type: 'clear_tool_uses_20250919';
1276
+ /**
1277
+ * `get_page_text`'s config overrides.
1278
+ */
1279
+ get_page_text?: BetaBrowserGetPageTextConfig | null;
925
1280
 
926
1281
  /**
927
- * Minimum number of tokens that must be cleared when triggered. Context will only
928
- * be modified if at least this many tokens can be removed.
1282
+ * `hold_key`'s config overrides.
929
1283
  */
930
- clear_at_least?: BetaInputTokensClearAtLeast | null;
1284
+ hold_key?: BetaBrowserHoldKeyConfig | null;
931
1285
 
932
1286
  /**
933
- * Whether to clear all tool inputs (bool) or specific tool inputs to clear (list)
1287
+ * `hover`'s config overrides.
934
1288
  */
935
- clear_tool_inputs?: boolean | Array<string> | null;
1289
+ hover?: BetaBrowserHoverConfig | null;
936
1290
 
937
1291
  /**
938
- * Tool names whose uses are preserved from clearing
1292
+ * `javascript_exec`'s config overrides.
939
1293
  */
940
- exclude_tools?: Array<string> | null;
1294
+ javascript_exec?: BetaBrowserJavascriptExecConfig | null;
941
1295
 
942
1296
  /**
943
- * Number of tool uses to retain in the conversation
1297
+ * `key`'s config overrides.
944
1298
  */
945
- keep?: BetaToolUsesKeep;
1299
+ key?: BetaBrowserKeyConfig | null;
946
1300
 
947
1301
  /**
948
- * Condition that triggers the context management strategy
1302
+ * `left_click`'s config overrides.
949
1303
  */
950
- trigger?: BetaInputTokensTrigger | BetaToolUsesTrigger;
951
- }
1304
+ left_click?: BetaBrowserLeftClickConfig | null;
952
1305
 
953
- export interface BetaClearToolUses20250919EditResponse {
954
1306
  /**
955
- * Number of input tokens cleared by this edit.
1307
+ * `left_click_drag`'s config overrides.
956
1308
  */
957
- cleared_input_tokens: number;
1309
+ left_click_drag?: BetaBrowserLeftClickDragConfig | null;
958
1310
 
959
1311
  /**
960
- * Number of tool uses that were cleared.
1312
+ * `left_mouse_down`'s config overrides.
961
1313
  */
962
- cleared_tool_uses: number;
1314
+ left_mouse_down?: BetaBrowserLeftMouseDownConfig | null;
963
1315
 
964
1316
  /**
965
- * The type of context management edit applied.
1317
+ * `left_mouse_up`'s config overrides.
966
1318
  */
967
- type: 'clear_tool_uses_20250919';
968
- }
1319
+ left_mouse_up?: BetaBrowserLeftMouseUpConfig | null;
969
1320
 
970
- export interface BetaCodeExecutionOutputBlock {
971
- file_id: string;
1321
+ /**
1322
+ * `list_tabs`'s config overrides.
1323
+ */
1324
+ list_tabs?: BetaBrowserListTabsConfig | null;
972
1325
 
973
- type: 'code_execution_output';
974
- }
1326
+ /**
1327
+ * `middle_click`'s config overrides.
1328
+ */
1329
+ middle_click?: BetaBrowserMiddleClickConfig | null;
975
1330
 
976
- export interface BetaCodeExecutionOutputBlockParam {
977
- file_id: string;
1331
+ /**
1332
+ * `mouse_move`'s config overrides.
1333
+ */
1334
+ mouse_move?: BetaBrowserMouseMoveConfig | null;
978
1335
 
979
- type: 'code_execution_output';
980
- }
1336
+ /**
1337
+ * `navigate`'s config overrides.
1338
+ */
1339
+ navigate?: BetaBrowserNavigateConfig | null;
981
1340
 
982
- export interface BetaCodeExecutionResultBlock {
983
- content: Array<BetaCodeExecutionOutputBlock>;
1341
+ /**
1342
+ * `new_tab`'s config overrides.
1343
+ */
1344
+ new_tab?: BetaBrowserNewTabConfig | null;
984
1345
 
985
- return_code: number;
1346
+ /**
1347
+ * `read_console`'s config overrides.
1348
+ */
1349
+ read_console?: BetaBrowserReadConsoleConfig | null;
986
1350
 
987
- stderr: string;
1351
+ /**
1352
+ * `read_network`'s config overrides.
1353
+ */
1354
+ read_network?: BetaBrowserReadNetworkConfig | null;
988
1355
 
989
- stdout: string;
1356
+ /**
1357
+ * `read_page`'s config overrides.
1358
+ */
1359
+ read_page?: BetaBrowserReadPageConfig | null;
990
1360
 
991
- type: 'code_execution_result';
992
- }
1361
+ /**
1362
+ * `right_click`'s config overrides.
1363
+ */
1364
+ right_click?: BetaBrowserRightClickConfig | null;
993
1365
 
994
- export interface BetaCodeExecutionResultBlockParam {
995
- content: Array<BetaCodeExecutionOutputBlockParam>;
1366
+ /**
1367
+ * `screenshot`'s config overrides.
1368
+ */
1369
+ screenshot?: BetaBrowserScreenshotConfig | null;
996
1370
 
997
- return_code: number;
1371
+ /**
1372
+ * `scroll`'s config overrides.
1373
+ */
1374
+ scroll?: BetaBrowserScrollConfig | null;
998
1375
 
999
- stderr: string;
1376
+ /**
1377
+ * `scroll_to`'s config overrides.
1378
+ */
1379
+ scroll_to?: BetaBrowserScrollToConfig | null;
1380
+
1381
+ /**
1382
+ * `switch_tab`'s config overrides.
1383
+ */
1384
+ switch_tab?: BetaBrowserSwitchTabConfig | null;
1385
+
1386
+ /**
1387
+ * `triple_click`'s config overrides.
1388
+ */
1389
+ triple_click?: BetaBrowserTripleClickConfig | null;
1390
+
1391
+ /**
1392
+ * `type`'s config overrides.
1393
+ */
1394
+ type?: BetaBrowserTypeConfig | null;
1395
+
1396
+ /**
1397
+ * `wait`'s config overrides.
1398
+ */
1399
+ wait?: BetaBrowserWaitConfig | null;
1400
+
1401
+ /**
1402
+ * `zoom`'s config overrides.
1403
+ */
1404
+ zoom?: BetaBrowserZoomConfig | null;
1405
+ }
1406
+
1407
+ /**
1408
+ * `triple_click`'s config overrides.
1409
+ */
1410
+ export interface BetaBrowserTripleClickConfig {
1411
+ /**
1412
+ * Defer loading for this member. Must resolve to the same value on every enabled
1413
+ * member of the toolset.
1414
+ */
1415
+ defer_loading?: boolean | null;
1416
+
1417
+ /**
1418
+ * Whether this member is offered to the model. Default is per member, per the
1419
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1420
+ * the served schema.
1421
+ */
1422
+ enabled?: boolean | null;
1423
+ }
1424
+
1425
+ /**
1426
+ * `type`'s config overrides.
1427
+ */
1428
+ export interface BetaBrowserTypeConfig {
1429
+ /**
1430
+ * Defer loading for this member. Must resolve to the same value on every enabled
1431
+ * member of the toolset.
1432
+ */
1433
+ defer_loading?: boolean | null;
1434
+
1435
+ /**
1436
+ * Whether this member is offered to the model. Default is per member, per the
1437
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1438
+ * the served schema.
1439
+ */
1440
+ enabled?: boolean | null;
1441
+ }
1442
+
1443
+ /**
1444
+ * `wait`'s config overrides.
1445
+ */
1446
+ export interface BetaBrowserWaitConfig {
1447
+ /**
1448
+ * Defer loading for this member. Must resolve to the same value on every enabled
1449
+ * member of the toolset.
1450
+ */
1451
+ defer_loading?: boolean | null;
1452
+
1453
+ /**
1454
+ * Whether this member is offered to the model. Default is per member, per the
1455
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1456
+ * the served schema.
1457
+ */
1458
+ enabled?: boolean | null;
1459
+ }
1460
+
1461
+ /**
1462
+ * `zoom`'s config overrides.
1463
+ */
1464
+ export interface BetaBrowserZoomConfig {
1465
+ /**
1466
+ * Defer loading for this member. Must resolve to the same value on every enabled
1467
+ * member of the toolset.
1468
+ */
1469
+ defer_loading?: boolean | null;
1470
+
1471
+ /**
1472
+ * Whether this member is offered to the model. Default is per member, per the
1473
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1474
+ * the served schema.
1475
+ */
1476
+ enabled?: boolean | null;
1477
+ }
1478
+
1479
+ export interface BetaCacheControlEphemeral {
1480
+ type: 'ephemeral';
1481
+
1482
+ /**
1483
+ * The time-to-live for the cache control breakpoint.
1484
+ *
1485
+ * This may be one the following values:
1486
+ *
1487
+ * - `5m`: 5 minutes
1488
+ * - `1h`: 1 hour
1489
+ *
1490
+ * Defaults to `5m`. See
1491
+ * [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
1492
+ * for details.
1493
+ */
1494
+ ttl?: '5m' | '1h';
1495
+ }
1496
+
1497
+ export interface BetaCacheCreation {
1498
+ /**
1499
+ * The number of input tokens used to create the 1 hour cache entry.
1500
+ */
1501
+ ephemeral_1h_input_tokens: number;
1502
+
1503
+ /**
1504
+ * The number of input tokens used to create the 5 minute cache entry.
1505
+ */
1506
+ ephemeral_5m_input_tokens: number;
1507
+ }
1508
+
1509
+ export interface BetaCacheMissMessagesChanged {
1510
+ /**
1511
+ * Approximate number of input tokens that would have been read from cache had the
1512
+ * prefix matched the previous request.
1513
+ */
1514
+ cache_missed_input_tokens: number;
1515
+
1516
+ type: 'messages_changed';
1517
+ }
1518
+
1519
+ export interface BetaCacheMissModelChanged {
1520
+ /**
1521
+ * Approximate number of input tokens that would have been read from cache had the
1522
+ * prefix matched the previous request.
1523
+ */
1524
+ cache_missed_input_tokens: number;
1525
+
1526
+ type: 'model_changed';
1527
+ }
1528
+
1529
+ export interface BetaCacheMissPreviousMessageNotFound {
1530
+ type: 'previous_message_not_found';
1531
+ }
1532
+
1533
+ export interface BetaCacheMissSystemChanged {
1534
+ /**
1535
+ * Approximate number of input tokens that would have been read from cache had the
1536
+ * prefix matched the previous request.
1537
+ */
1538
+ cache_missed_input_tokens: number;
1539
+
1540
+ type: 'system_changed';
1541
+ }
1542
+
1543
+ export interface BetaCacheMissToolsChanged {
1544
+ /**
1545
+ * Approximate number of input tokens that would have been read from cache had the
1546
+ * prefix matched the previous request.
1547
+ */
1548
+ cache_missed_input_tokens: number;
1549
+
1550
+ type: 'tools_changed';
1551
+ }
1552
+
1553
+ export interface BetaCacheMissUnavailable {
1554
+ type: 'unavailable';
1555
+ }
1556
+
1557
+ export interface BetaCitationCharLocation {
1558
+ cited_text: string;
1559
+
1560
+ document_index: number;
1561
+
1562
+ document_title: string | null;
1563
+
1564
+ end_char_index: number;
1565
+
1566
+ file_id: string | null;
1567
+
1568
+ start_char_index: number;
1569
+
1570
+ type: 'char_location';
1571
+ }
1572
+
1573
+ export interface BetaCitationCharLocationParam {
1574
+ cited_text: string;
1575
+
1576
+ document_index: number;
1577
+
1578
+ document_title: string | null;
1579
+
1580
+ end_char_index: number;
1581
+
1582
+ start_char_index: number;
1583
+
1584
+ type: 'char_location';
1585
+ }
1586
+
1587
+ export interface BetaCitationConfig {
1588
+ enabled: boolean;
1589
+ }
1590
+
1591
+ export interface BetaCitationContentBlockLocation {
1592
+ /**
1593
+ * The full text of the cited block range, concatenated.
1594
+ *
1595
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1596
+ * joined together. The text block is the minimal citable unit; this field is never
1597
+ * a substring of a single block. Not counted toward output tokens, and not counted
1598
+ * toward input tokens when sent back in subsequent turns.
1599
+ */
1600
+ cited_text: string;
1601
+
1602
+ document_index: number;
1603
+
1604
+ document_title: string | null;
1605
+
1606
+ /**
1607
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1608
+ * array.
1609
+ *
1610
+ * Always greater than `start_block_index`; a single-block citation has
1611
+ * `end_block_index = start_block_index + 1`.
1612
+ */
1613
+ end_block_index: number;
1614
+
1615
+ file_id: string | null;
1616
+
1617
+ /**
1618
+ * 0-based index of the first cited block in the source's `content` array.
1619
+ */
1620
+ start_block_index: number;
1621
+
1622
+ type: 'content_block_location';
1623
+ }
1624
+
1625
+ export interface BetaCitationContentBlockLocationParam {
1626
+ /**
1627
+ * The full text of the cited block range, concatenated.
1628
+ *
1629
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1630
+ * joined together. The text block is the minimal citable unit; this field is never
1631
+ * a substring of a single block. Not counted toward output tokens, and not counted
1632
+ * toward input tokens when sent back in subsequent turns.
1633
+ */
1634
+ cited_text: string;
1635
+
1636
+ document_index: number;
1637
+
1638
+ document_title: string | null;
1639
+
1640
+ /**
1641
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1642
+ * array.
1643
+ *
1644
+ * Always greater than `start_block_index`; a single-block citation has
1645
+ * `end_block_index = start_block_index + 1`.
1646
+ */
1647
+ end_block_index: number;
1648
+
1649
+ /**
1650
+ * 0-based index of the first cited block in the source's `content` array.
1651
+ */
1652
+ start_block_index: number;
1653
+
1654
+ type: 'content_block_location';
1655
+ }
1656
+
1657
+ export interface BetaCitationPageLocation {
1658
+ cited_text: string;
1659
+
1660
+ document_index: number;
1661
+
1662
+ document_title: string | null;
1663
+
1664
+ end_page_number: number;
1665
+
1666
+ file_id: string | null;
1667
+
1668
+ start_page_number: number;
1669
+
1670
+ type: 'page_location';
1671
+ }
1672
+
1673
+ export interface BetaCitationPageLocationParam {
1674
+ cited_text: string;
1675
+
1676
+ document_index: number;
1677
+
1678
+ document_title: string | null;
1679
+
1680
+ end_page_number: number;
1681
+
1682
+ start_page_number: number;
1683
+
1684
+ type: 'page_location';
1685
+ }
1686
+
1687
+ export interface BetaCitationSearchResultLocation {
1688
+ /**
1689
+ * The full text of the cited block range, concatenated.
1690
+ *
1691
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1692
+ * joined together. The text block is the minimal citable unit; this field is never
1693
+ * a substring of a single block. Not counted toward output tokens, and not counted
1694
+ * toward input tokens when sent back in subsequent turns.
1695
+ */
1696
+ cited_text: string;
1697
+
1698
+ /**
1699
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1700
+ * array.
1701
+ *
1702
+ * Always greater than `start_block_index`; a single-block citation has
1703
+ * `end_block_index = start_block_index + 1`.
1704
+ */
1705
+ end_block_index: number;
1706
+
1707
+ /**
1708
+ * 0-based index of the cited search result among all `search_result` content
1709
+ * blocks in the request, in the order they appear across messages and tool
1710
+ * results.
1711
+ *
1712
+ * Counted separately from `document_index`; server-side web search results are not
1713
+ * included in this count.
1714
+ */
1715
+ search_result_index: number;
1716
+
1717
+ source: string;
1718
+
1719
+ /**
1720
+ * 0-based index of the first cited block in the source's `content` array.
1721
+ */
1722
+ start_block_index: number;
1723
+
1724
+ title: string | null;
1725
+
1726
+ type: 'search_result_location';
1727
+ }
1728
+
1729
+ export interface BetaCitationSearchResultLocationParam {
1730
+ /**
1731
+ * The full text of the cited block range, concatenated.
1732
+ *
1733
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1734
+ * joined together. The text block is the minimal citable unit; this field is never
1735
+ * a substring of a single block. Not counted toward output tokens, and not counted
1736
+ * toward input tokens when sent back in subsequent turns.
1737
+ */
1738
+ cited_text: string;
1739
+
1740
+ /**
1741
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1742
+ * array.
1743
+ *
1744
+ * Always greater than `start_block_index`; a single-block citation has
1745
+ * `end_block_index = start_block_index + 1`.
1746
+ */
1747
+ end_block_index: number;
1748
+
1749
+ /**
1750
+ * 0-based index of the cited search result among all `search_result` content
1751
+ * blocks in the request, in the order they appear across messages and tool
1752
+ * results.
1753
+ *
1754
+ * Counted separately from `document_index`; server-side web search results are not
1755
+ * included in this count.
1756
+ */
1757
+ search_result_index: number;
1758
+
1759
+ source: string;
1760
+
1761
+ /**
1762
+ * 0-based index of the first cited block in the source's `content` array.
1763
+ */
1764
+ start_block_index: number;
1765
+
1766
+ title: string | null;
1767
+
1768
+ type: 'search_result_location';
1769
+ }
1770
+
1771
+ export interface BetaCitationWebSearchResultLocationParam {
1772
+ cited_text: string;
1773
+
1774
+ encrypted_index: string;
1775
+
1776
+ title: string | null;
1777
+
1778
+ type: 'web_search_result_location';
1779
+
1780
+ url: string;
1781
+ }
1782
+
1783
+ export interface BetaCitationsConfigParam {
1784
+ enabled?: boolean;
1785
+ }
1786
+
1787
+ export interface BetaCitationsDelta {
1788
+ citation:
1789
+ | BetaCitationCharLocation
1790
+ | BetaCitationPageLocation
1791
+ | BetaCitationContentBlockLocation
1792
+ | BetaCitationsWebSearchResultLocation
1793
+ | BetaCitationSearchResultLocation;
1794
+
1795
+ type: 'citations_delta';
1796
+ }
1797
+
1798
+ export interface BetaCitationsWebSearchResultLocation {
1799
+ cited_text: string;
1800
+
1801
+ encrypted_index: string;
1802
+
1803
+ title: string | null;
1804
+
1805
+ type: 'web_search_result_location';
1806
+
1807
+ url: string;
1808
+ }
1809
+
1810
+ export interface BetaClearThinking20251015Edit {
1811
+ type: 'clear_thinking_20251015';
1812
+
1813
+ /**
1814
+ * Number of most recent assistant turns to keep thinking blocks for. Older turns
1815
+ * will have their thinking blocks removed.
1816
+ */
1817
+ keep?: BetaThinkingTurns | BetaAllThinkingTurns | 'all';
1818
+ }
1819
+
1820
+ export interface BetaClearThinking20251015EditResponse {
1821
+ /**
1822
+ * Number of input tokens cleared by this edit.
1823
+ */
1824
+ cleared_input_tokens: number;
1825
+
1826
+ /**
1827
+ * Number of thinking turns that were cleared.
1828
+ */
1829
+ cleared_thinking_turns: number;
1830
+
1831
+ /**
1832
+ * The type of context management edit applied.
1833
+ */
1834
+ type: 'clear_thinking_20251015';
1835
+ }
1836
+
1837
+ export interface BetaClearToolUses20250919Edit {
1838
+ type: 'clear_tool_uses_20250919';
1839
+
1840
+ /**
1841
+ * Minimum number of tokens that must be cleared when triggered. Context will only
1842
+ * be modified if at least this many tokens can be removed.
1843
+ */
1844
+ clear_at_least?: BetaInputTokensClearAtLeast | null;
1845
+
1846
+ /**
1847
+ * Whether to clear all tool inputs (bool) or specific tool inputs to clear (list)
1848
+ */
1849
+ clear_tool_inputs?: boolean | Array<string> | null;
1850
+
1851
+ /**
1852
+ * Tool names whose uses are preserved from clearing
1853
+ */
1854
+ exclude_tools?: Array<string> | null;
1855
+
1856
+ /**
1857
+ * Number of tool uses to retain in the conversation
1858
+ */
1859
+ keep?: BetaToolUsesKeep;
1860
+
1861
+ /**
1862
+ * Condition that triggers the context management strategy
1863
+ */
1864
+ trigger?: BetaInputTokensTrigger | BetaToolUsesTrigger;
1865
+ }
1866
+
1867
+ export interface BetaClearToolUses20250919EditResponse {
1868
+ /**
1869
+ * Number of input tokens cleared by this edit.
1870
+ */
1871
+ cleared_input_tokens: number;
1872
+
1873
+ /**
1874
+ * Number of tool uses that were cleared.
1875
+ */
1876
+ cleared_tool_uses: number;
1877
+
1878
+ /**
1879
+ * The type of context management edit applied.
1880
+ */
1881
+ type: 'clear_tool_uses_20250919';
1882
+ }
1883
+
1884
+ export interface BetaCodeExecutionOutputBlock {
1885
+ file_id: string;
1886
+
1887
+ type: 'code_execution_output';
1888
+ }
1889
+
1890
+ export interface BetaCodeExecutionOutputBlockParam {
1891
+ file_id: string;
1892
+
1893
+ type: 'code_execution_output';
1894
+ }
1895
+
1896
+ export interface BetaCodeExecutionResultBlock {
1897
+ content: Array<BetaCodeExecutionOutputBlock>;
1898
+
1899
+ return_code: number;
1900
+
1901
+ stderr: string;
1902
+
1903
+ stdout: string;
1904
+
1905
+ type: 'code_execution_result';
1906
+ }
1907
+
1908
+ export interface BetaCodeExecutionResultBlockParam {
1909
+ content: Array<BetaCodeExecutionOutputBlockParam>;
1910
+
1911
+ return_code: number;
1912
+
1913
+ stderr: string;
1914
+
1915
+ stdout: string;
1916
+
1917
+ type: 'code_execution_result';
1918
+ }
1919
+
1920
+ export interface BetaCodeExecutionTool20250522 {
1921
+ /**
1922
+ * Name of the tool.
1923
+ *
1924
+ * This is how the tool will be called by the model and in `tool_use` blocks.
1925
+ */
1926
+ name: 'code_execution';
1927
+
1928
+ type: 'code_execution_20250522';
1929
+
1930
+ allowed_callers?: Array<
1931
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1932
+ >;
1933
+
1934
+ /**
1935
+ * Create a cache control breakpoint at this content block.
1936
+ */
1937
+ cache_control?: BetaCacheControlEphemeral | null;
1938
+
1939
+ /**
1940
+ * If true, tool will not be included in initial system prompt. Only loaded when
1941
+ * returned via tool_reference from tool search.
1942
+ */
1943
+ defer_loading?: boolean;
1944
+
1945
+ /**
1946
+ * When true, guarantees schema validation on tool names and inputs
1947
+ */
1948
+ strict?: boolean;
1949
+ }
1950
+
1951
+ export interface BetaCodeExecutionTool20250825 {
1952
+ /**
1953
+ * Name of the tool.
1954
+ *
1955
+ * This is how the tool will be called by the model and in `tool_use` blocks.
1956
+ */
1957
+ name: 'code_execution';
1958
+
1959
+ type: 'code_execution_20250825';
1960
+
1961
+ allowed_callers?: Array<
1962
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1963
+ >;
1964
+
1965
+ /**
1966
+ * Create a cache control breakpoint at this content block.
1967
+ */
1968
+ cache_control?: BetaCacheControlEphemeral | null;
1969
+
1970
+ /**
1971
+ * If true, tool will not be included in initial system prompt. Only loaded when
1972
+ * returned via tool_reference from tool search.
1973
+ */
1974
+ defer_loading?: boolean;
1975
+
1976
+ /**
1977
+ * When true, guarantees schema validation on tool names and inputs
1978
+ */
1979
+ strict?: boolean;
1980
+ }
1981
+
1982
+ /**
1983
+ * Code execution tool with REPL state persistence (daemon mode + gVisor
1984
+ * checkpoint).
1985
+ */
1986
+ export interface BetaCodeExecutionTool20260120 {
1987
+ /**
1988
+ * Name of the tool.
1989
+ *
1990
+ * This is how the tool will be called by the model and in `tool_use` blocks.
1991
+ */
1992
+ name: 'code_execution';
1000
1993
 
1001
- stdout: string;
1994
+ type: 'code_execution_20260120';
1002
1995
 
1003
- type: 'code_execution_result';
1996
+ allowed_callers?: Array<
1997
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1998
+ >;
1999
+
2000
+ /**
2001
+ * Create a cache control breakpoint at this content block.
2002
+ */
2003
+ cache_control?: BetaCacheControlEphemeral | null;
2004
+
2005
+ /**
2006
+ * If true, tool will not be included in initial system prompt. Only loaded when
2007
+ * returned via tool_reference from tool search.
2008
+ */
2009
+ defer_loading?: boolean;
2010
+
2011
+ /**
2012
+ * When true, guarantees schema validation on tool names and inputs
2013
+ */
2014
+ strict?: boolean;
1004
2015
  }
1005
2016
 
1006
- export interface BetaCodeExecutionTool20250522 {
2017
+ /**
2018
+ * Code execution tool with REPL state persistence.
2019
+ */
2020
+ export interface BetaCodeExecutionTool20260521 {
1007
2021
  /**
1008
2022
  * Name of the tool.
1009
2023
  *
@@ -1011,7 +2025,7 @@ export interface BetaCodeExecutionTool20250522 {
1011
2025
  */
1012
2026
  name: 'code_execution';
1013
2027
 
1014
- type: 'code_execution_20250522';
2028
+ type: 'code_execution_20260521';
1015
2029
 
1016
2030
  allowed_callers?: Array<
1017
2031
  'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
@@ -1020,297 +2034,627 @@ export interface BetaCodeExecutionTool20250522 {
1020
2034
  /**
1021
2035
  * Create a cache control breakpoint at this content block.
1022
2036
  */
1023
- cache_control?: BetaCacheControlEphemeral | null;
2037
+ cache_control?: BetaCacheControlEphemeral | null;
2038
+
2039
+ /**
2040
+ * If true, tool will not be included in initial system prompt. Only loaded when
2041
+ * returned via tool_reference from tool search.
2042
+ */
2043
+ defer_loading?: boolean;
2044
+
2045
+ /**
2046
+ * When true, guarantees schema validation on tool names and inputs
2047
+ */
2048
+ strict?: boolean;
2049
+ }
2050
+
2051
+ export interface BetaCodeExecutionToolResultBlock {
2052
+ /**
2053
+ * Code execution result with encrypted stdout for PFC + web_search results.
2054
+ */
2055
+ content: BetaCodeExecutionToolResultBlockContent;
2056
+
2057
+ tool_use_id: string;
2058
+
2059
+ type: 'code_execution_tool_result';
2060
+ }
2061
+
2062
+ /**
2063
+ * Code execution result with encrypted stdout for PFC + web_search results.
2064
+ */
2065
+ export type BetaCodeExecutionToolResultBlockContent =
2066
+ | BetaCodeExecutionToolResultError
2067
+ | BetaCodeExecutionResultBlock
2068
+ | BetaEncryptedCodeExecutionResultBlock;
2069
+
2070
+ export interface BetaCodeExecutionToolResultBlockParam {
2071
+ /**
2072
+ * Code execution result with encrypted stdout for PFC + web_search results.
2073
+ */
2074
+ content: BetaCodeExecutionToolResultBlockParamContent;
2075
+
2076
+ tool_use_id: string;
2077
+
2078
+ type: 'code_execution_tool_result';
2079
+
2080
+ /**
2081
+ * Create a cache control breakpoint at this content block.
2082
+ */
2083
+ cache_control?: BetaCacheControlEphemeral | null;
2084
+ }
2085
+
2086
+ /**
2087
+ * Code execution result with encrypted stdout for PFC + web_search results.
2088
+ */
2089
+ export type BetaCodeExecutionToolResultBlockParamContent =
2090
+ | BetaCodeExecutionToolResultErrorParam
2091
+ | BetaCodeExecutionResultBlockParam
2092
+ | BetaEncryptedCodeExecutionResultBlockParam;
2093
+
2094
+ export interface BetaCodeExecutionToolResultError {
2095
+ error_code: BetaCodeExecutionToolResultErrorCode;
2096
+
2097
+ type: 'code_execution_tool_result_error';
2098
+ }
2099
+
2100
+ export type BetaCodeExecutionToolResultErrorCode =
2101
+ | 'invalid_tool_input'
2102
+ | 'unavailable'
2103
+ | 'too_many_requests'
2104
+ | 'execution_time_exceeded';
2105
+
2106
+ export interface BetaCodeExecutionToolResultErrorParam {
2107
+ error_code: BetaCodeExecutionToolResultErrorCode;
2108
+
2109
+ type: 'code_execution_tool_result_error';
2110
+ }
2111
+
2112
+ /**
2113
+ * Automatically compact older context when reaching the configured trigger
2114
+ * threshold.
2115
+ */
2116
+ export interface BetaCompact20260112Edit {
2117
+ type: 'compact_20260112';
2118
+
2119
+ /**
2120
+ * Additional instructions for summarization.
2121
+ */
2122
+ instructions?: string | null;
2123
+
2124
+ /**
2125
+ * Whether to pause after compaction and return the compaction block to the user.
2126
+ */
2127
+ pause_after_compaction?: boolean;
2128
+
2129
+ /**
2130
+ * When to trigger compaction. Defaults to 150000 input tokens.
2131
+ */
2132
+ trigger?: BetaInputTokensTrigger | null;
2133
+ }
2134
+
2135
+ /**
2136
+ * A compaction block returned when autocompact is triggered.
2137
+ *
2138
+ * When content is None, it indicates the compaction failed to produce a valid
2139
+ * summary (e.g., malformed output from the model). Clients may round-trip
2140
+ * compaction blocks with null content; the server treats them as no-ops.
2141
+ */
2142
+ export interface BetaCompactionBlock {
2143
+ /**
2144
+ * Summary of compacted content, or null if compaction failed
2145
+ */
2146
+ content: string | null;
2147
+
2148
+ /**
2149
+ * Opaque metadata from prior compaction, to be round-tripped verbatim
2150
+ */
2151
+ encrypted_content: string | null;
2152
+
2153
+ type: 'compaction';
2154
+ }
2155
+
2156
+ /**
2157
+ * A compaction block containing summary of previous context.
2158
+ *
2159
+ * Users should round-trip these blocks from responses to subsequent requests to
2160
+ * maintain context across compaction boundaries.
2161
+ *
2162
+ * When content is None, the block represents a failed compaction. The server
2163
+ * treats these as no-ops. Empty string content is not allowed.
2164
+ */
2165
+ export interface BetaCompactionBlockParam {
2166
+ type: 'compaction';
2167
+
2168
+ /**
2169
+ * Create a cache control breakpoint at this content block.
2170
+ */
2171
+ cache_control?: BetaCacheControlEphemeral | null;
2172
+
2173
+ /**
2174
+ * Summary of previously compacted content, or null if compaction failed
2175
+ */
2176
+ content?: string | null;
2177
+
2178
+ /**
2179
+ * Opaque metadata from prior compaction, to be round-tripped verbatim
2180
+ */
2181
+ encrypted_content?: string | null;
2182
+ }
2183
+
2184
+ export interface BetaCompactionContentBlockDelta {
2185
+ content: string | null;
2186
+
2187
+ /**
2188
+ * Opaque metadata from prior compaction, to be round-tripped verbatim
2189
+ */
2190
+ encrypted_content: string | null;
2191
+
2192
+ type: 'compaction_delta';
2193
+ }
2194
+
2195
+ /**
2196
+ * Token usage for a compaction iteration.
2197
+ */
2198
+ export interface BetaCompactionIterationUsage {
2199
+ /**
2200
+ * Breakdown of cached tokens by TTL
2201
+ */
2202
+ cache_creation: BetaCacheCreation | null;
2203
+
2204
+ /**
2205
+ * The number of input tokens used to create the cache entry.
2206
+ */
2207
+ cache_creation_input_tokens: number;
2208
+
2209
+ /**
2210
+ * The number of input tokens read from the cache.
2211
+ */
2212
+ cache_read_input_tokens: number;
2213
+
2214
+ /**
2215
+ * The number of input tokens which were used.
2216
+ */
2217
+ input_tokens: number;
2218
+
2219
+ /**
2220
+ * The number of output tokens which were used.
2221
+ */
2222
+ output_tokens: number;
2223
+
2224
+ /**
2225
+ * Usage for a compaction iteration
2226
+ */
2227
+ type: 'compaction';
2228
+ }
2229
+
2230
+ /**
2231
+ * `cursor_position`'s config overrides.
2232
+ */
2233
+ export interface BetaComputerCursorPositionConfig {
2234
+ /**
2235
+ * Defer loading for this member. Must resolve to the same value on every enabled
2236
+ * member of the toolset.
2237
+ */
2238
+ defer_loading?: boolean | null;
2239
+
2240
+ /**
2241
+ * Whether this member is offered to the model. Default is per member, per the
2242
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2243
+ * the served schema.
2244
+ */
2245
+ enabled?: boolean | null;
2246
+ }
2247
+
2248
+ /**
2249
+ * `double_click`'s config overrides.
2250
+ */
2251
+ export interface BetaComputerDoubleClickConfig {
2252
+ /**
2253
+ * Defer loading for this member. Must resolve to the same value on every enabled
2254
+ * member of the toolset.
2255
+ */
2256
+ defer_loading?: boolean | null;
2257
+
2258
+ /**
2259
+ * Whether this member is offered to the model. Default is per member, per the
2260
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2261
+ * the served schema.
2262
+ */
2263
+ enabled?: boolean | null;
2264
+ }
2265
+
2266
+ /**
2267
+ * `hold_key`'s config overrides.
2268
+ */
2269
+ export interface BetaComputerHoldKeyConfig {
2270
+ /**
2271
+ * Defer loading for this member. Must resolve to the same value on every enabled
2272
+ * member of the toolset.
2273
+ */
2274
+ defer_loading?: boolean | null;
2275
+
2276
+ /**
2277
+ * Whether this member is offered to the model. Default is per member, per the
2278
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2279
+ * the served schema.
2280
+ */
2281
+ enabled?: boolean | null;
2282
+ }
1024
2283
 
2284
+ /**
2285
+ * `key`'s config overrides.
2286
+ */
2287
+ export interface BetaComputerKeyConfig {
1025
2288
  /**
1026
- * If true, tool will not be included in initial system prompt. Only loaded when
1027
- * returned via tool_reference from tool search.
2289
+ * Defer loading for this member. Must resolve to the same value on every enabled
2290
+ * member of the toolset.
1028
2291
  */
1029
- defer_loading?: boolean;
2292
+ defer_loading?: boolean | null;
1030
2293
 
1031
2294
  /**
1032
- * When true, guarantees schema validation on tool names and inputs
2295
+ * Whether this member is offered to the model. Default is per member, per the
2296
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2297
+ * the served schema.
1033
2298
  */
1034
- strict?: boolean;
2299
+ enabled?: boolean | null;
1035
2300
  }
1036
2301
 
1037
- export interface BetaCodeExecutionTool20250825 {
2302
+ /**
2303
+ * `left_click`'s config overrides.
2304
+ */
2305
+ export interface BetaComputerLeftClickConfig {
1038
2306
  /**
1039
- * Name of the tool.
1040
- *
1041
- * This is how the tool will be called by the model and in `tool_use` blocks.
2307
+ * Defer loading for this member. Must resolve to the same value on every enabled
2308
+ * member of the toolset.
1042
2309
  */
1043
- name: 'code_execution';
1044
-
1045
- type: 'code_execution_20250825';
1046
-
1047
- allowed_callers?: Array<
1048
- 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1049
- >;
2310
+ defer_loading?: boolean | null;
1050
2311
 
1051
2312
  /**
1052
- * Create a cache control breakpoint at this content block.
2313
+ * Whether this member is offered to the model. Default is per member, per the
2314
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2315
+ * the served schema.
1053
2316
  */
1054
- cache_control?: BetaCacheControlEphemeral | null;
2317
+ enabled?: boolean | null;
2318
+ }
1055
2319
 
2320
+ /**
2321
+ * `left_click_drag`'s config overrides.
2322
+ */
2323
+ export interface BetaComputerLeftClickDragConfig {
1056
2324
  /**
1057
- * If true, tool will not be included in initial system prompt. Only loaded when
1058
- * returned via tool_reference from tool search.
2325
+ * Defer loading for this member. Must resolve to the same value on every enabled
2326
+ * member of the toolset.
1059
2327
  */
1060
- defer_loading?: boolean;
2328
+ defer_loading?: boolean | null;
1061
2329
 
1062
2330
  /**
1063
- * When true, guarantees schema validation on tool names and inputs
2331
+ * Whether this member is offered to the model. Default is per member, per the
2332
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2333
+ * the served schema.
1064
2334
  */
1065
- strict?: boolean;
2335
+ enabled?: boolean | null;
1066
2336
  }
1067
2337
 
1068
2338
  /**
1069
- * Code execution tool with REPL state persistence (daemon mode + gVisor
1070
- * checkpoint).
2339
+ * `left_mouse_down`'s config overrides.
1071
2340
  */
1072
- export interface BetaCodeExecutionTool20260120 {
2341
+ export interface BetaComputerLeftMouseDownConfig {
1073
2342
  /**
1074
- * Name of the tool.
1075
- *
1076
- * This is how the tool will be called by the model and in `tool_use` blocks.
2343
+ * Defer loading for this member. Must resolve to the same value on every enabled
2344
+ * member of the toolset.
1077
2345
  */
1078
- name: 'code_execution';
1079
-
1080
- type: 'code_execution_20260120';
1081
-
1082
- allowed_callers?: Array<
1083
- 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1084
- >;
2346
+ defer_loading?: boolean | null;
1085
2347
 
1086
2348
  /**
1087
- * Create a cache control breakpoint at this content block.
2349
+ * Whether this member is offered to the model. Default is per member, per the
2350
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2351
+ * the served schema.
1088
2352
  */
1089
- cache_control?: BetaCacheControlEphemeral | null;
2353
+ enabled?: boolean | null;
2354
+ }
1090
2355
 
2356
+ /**
2357
+ * `left_mouse_up`'s config overrides.
2358
+ */
2359
+ export interface BetaComputerLeftMouseUpConfig {
1091
2360
  /**
1092
- * If true, tool will not be included in initial system prompt. Only loaded when
1093
- * returned via tool_reference from tool search.
2361
+ * Defer loading for this member. Must resolve to the same value on every enabled
2362
+ * member of the toolset.
1094
2363
  */
1095
- defer_loading?: boolean;
2364
+ defer_loading?: boolean | null;
1096
2365
 
1097
2366
  /**
1098
- * When true, guarantees schema validation on tool names and inputs
2367
+ * Whether this member is offered to the model. Default is per member, per the
2368
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2369
+ * the served schema.
1099
2370
  */
1100
- strict?: boolean;
2371
+ enabled?: boolean | null;
1101
2372
  }
1102
2373
 
1103
2374
  /**
1104
- * Code execution tool with REPL state persistence.
2375
+ * `middle_click`'s config overrides.
1105
2376
  */
1106
- export interface BetaCodeExecutionTool20260521 {
2377
+ export interface BetaComputerMiddleClickConfig {
1107
2378
  /**
1108
- * Name of the tool.
1109
- *
1110
- * This is how the tool will be called by the model and in `tool_use` blocks.
2379
+ * Defer loading for this member. Must resolve to the same value on every enabled
2380
+ * member of the toolset.
1111
2381
  */
1112
- name: 'code_execution';
2382
+ defer_loading?: boolean | null;
1113
2383
 
1114
- type: 'code_execution_20260521';
2384
+ /**
2385
+ * Whether this member is offered to the model. Default is per member, per the
2386
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2387
+ * the served schema.
2388
+ */
2389
+ enabled?: boolean | null;
2390
+ }
1115
2391
 
1116
- allowed_callers?: Array<
1117
- 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1118
- >;
2392
+ /**
2393
+ * `mouse_move`'s config overrides.
2394
+ */
2395
+ export interface BetaComputerMouseMoveConfig {
2396
+ /**
2397
+ * Defer loading for this member. Must resolve to the same value on every enabled
2398
+ * member of the toolset.
2399
+ */
2400
+ defer_loading?: boolean | null;
1119
2401
 
1120
2402
  /**
1121
- * Create a cache control breakpoint at this content block.
2403
+ * Whether this member is offered to the model. Default is per member, per the
2404
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2405
+ * the served schema.
1122
2406
  */
1123
- cache_control?: BetaCacheControlEphemeral | null;
2407
+ enabled?: boolean | null;
2408
+ }
1124
2409
 
2410
+ /**
2411
+ * `right_click`'s config overrides.
2412
+ */
2413
+ export interface BetaComputerRightClickConfig {
1125
2414
  /**
1126
- * If true, tool will not be included in initial system prompt. Only loaded when
1127
- * returned via tool_reference from tool search.
2415
+ * Defer loading for this member. Must resolve to the same value on every enabled
2416
+ * member of the toolset.
1128
2417
  */
1129
- defer_loading?: boolean;
2418
+ defer_loading?: boolean | null;
1130
2419
 
1131
2420
  /**
1132
- * When true, guarantees schema validation on tool names and inputs
2421
+ * Whether this member is offered to the model. Default is per member, per the
2422
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2423
+ * the served schema.
1133
2424
  */
1134
- strict?: boolean;
2425
+ enabled?: boolean | null;
1135
2426
  }
1136
2427
 
1137
- export interface BetaCodeExecutionToolResultBlock {
2428
+ /**
2429
+ * `screenshot`'s config overrides.
2430
+ */
2431
+ export interface BetaComputerScreenshotConfig {
1138
2432
  /**
1139
- * Code execution result with encrypted stdout for PFC + web_search results.
2433
+ * Defer loading for this member. Must resolve to the same value on every enabled
2434
+ * member of the toolset.
1140
2435
  */
1141
- content: BetaCodeExecutionToolResultBlockContent;
2436
+ defer_loading?: boolean | null;
1142
2437
 
1143
- tool_use_id: string;
1144
-
1145
- type: 'code_execution_tool_result';
2438
+ /**
2439
+ * Whether this member is offered to the model. Default is per member, per the
2440
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2441
+ * the served schema.
2442
+ */
2443
+ enabled?: boolean | null;
1146
2444
  }
1147
2445
 
1148
2446
  /**
1149
- * Code execution result with encrypted stdout for PFC + web_search results.
2447
+ * `scroll`'s config overrides.
1150
2448
  */
1151
- export type BetaCodeExecutionToolResultBlockContent =
1152
- | BetaCodeExecutionToolResultError
1153
- | BetaCodeExecutionResultBlock
1154
- | BetaEncryptedCodeExecutionResultBlock;
2449
+ export interface BetaComputerScrollConfig {
2450
+ /**
2451
+ * Defer loading for this member. Must resolve to the same value on every enabled
2452
+ * member of the toolset.
2453
+ */
2454
+ defer_loading?: boolean | null;
1155
2455
 
1156
- export interface BetaCodeExecutionToolResultBlockParam {
1157
2456
  /**
1158
- * Code execution result with encrypted stdout for PFC + web_search results.
2457
+ * Whether this member is offered to the model. Default is per member, per the
2458
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2459
+ * the served schema.
1159
2460
  */
1160
- content: BetaCodeExecutionToolResultBlockParamContent;
2461
+ enabled?: boolean | null;
2462
+ }
1161
2463
 
1162
- tool_use_id: string;
2464
+ /**
2465
+ * The computer toolset: a single `tools[]` entry (carrying no `name`) that
2466
+ * declares the computer tool family. The model is served the family's tool with
2467
+ * any members disabled via `configs` removed from its schema. Every member is
2468
+ * enabled by default, zoom included. The single-tool options `display_number` and
2469
+ * `enable_zoom` are not fields of a toolset entry — it carries only `type`,
2470
+ * `configs`, and `cache_control`; zoom is controlled via `configs.zoom.enabled`.
2471
+ */
2472
+ export interface BetaComputerToolset20260801 {
2473
+ type: 'computer_toolset_20260801';
1163
2474
 
1164
- type: 'code_execution_tool_result';
2475
+ allowed_callers?: Array<
2476
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
2477
+ >;
1165
2478
 
1166
2479
  /**
1167
2480
  * Create a cache control breakpoint at this content block.
1168
2481
  */
1169
2482
  cache_control?: BetaCacheControlEphemeral | null;
2483
+
2484
+ /**
2485
+ * Per-member configuration for `computer_toolset_20260801`: one optional field per
2486
+ * member tool, keyed by the member name — the same name the member's `tool_use`
2487
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
2488
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
2489
+ * toolset version's complete member set.
2490
+ */
2491
+ configs?: BetaComputerToolsetConfigs | null;
1170
2492
  }
1171
2493
 
1172
2494
  /**
1173
- * Code execution result with encrypted stdout for PFC + web_search results.
2495
+ * Per-member configuration for `computer_toolset_20260801`: one optional field per
2496
+ * member tool, keyed by the member name — the same name the member's `tool_use`
2497
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
2498
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
2499
+ * toolset version's complete member set.
1174
2500
  */
1175
- export type BetaCodeExecutionToolResultBlockParamContent =
1176
- | BetaCodeExecutionToolResultErrorParam
1177
- | BetaCodeExecutionResultBlockParam
1178
- | BetaEncryptedCodeExecutionResultBlockParam;
2501
+ export interface BetaComputerToolsetConfigs {
2502
+ /**
2503
+ * `cursor_position`'s config overrides.
2504
+ */
2505
+ cursor_position?: BetaComputerCursorPositionConfig | null;
1179
2506
 
1180
- export interface BetaCodeExecutionToolResultError {
1181
- error_code: BetaCodeExecutionToolResultErrorCode;
2507
+ /**
2508
+ * `double_click`'s config overrides.
2509
+ */
2510
+ double_click?: BetaComputerDoubleClickConfig | null;
1182
2511
 
1183
- type: 'code_execution_tool_result_error';
1184
- }
2512
+ /**
2513
+ * `hold_key`'s config overrides.
2514
+ */
2515
+ hold_key?: BetaComputerHoldKeyConfig | null;
1185
2516
 
1186
- export type BetaCodeExecutionToolResultErrorCode =
1187
- | 'invalid_tool_input'
1188
- | 'unavailable'
1189
- | 'too_many_requests'
1190
- | 'execution_time_exceeded';
2517
+ /**
2518
+ * `key`'s config overrides.
2519
+ */
2520
+ key?: BetaComputerKeyConfig | null;
1191
2521
 
1192
- export interface BetaCodeExecutionToolResultErrorParam {
1193
- error_code: BetaCodeExecutionToolResultErrorCode;
2522
+ /**
2523
+ * `left_click`'s config overrides.
2524
+ */
2525
+ left_click?: BetaComputerLeftClickConfig | null;
1194
2526
 
1195
- type: 'code_execution_tool_result_error';
1196
- }
2527
+ /**
2528
+ * `left_click_drag`'s config overrides.
2529
+ */
2530
+ left_click_drag?: BetaComputerLeftClickDragConfig | null;
1197
2531
 
1198
- /**
1199
- * Automatically compact older context when reaching the configured trigger
1200
- * threshold.
1201
- */
1202
- export interface BetaCompact20260112Edit {
1203
- type: 'compact_20260112';
2532
+ /**
2533
+ * `left_mouse_down`'s config overrides.
2534
+ */
2535
+ left_mouse_down?: BetaComputerLeftMouseDownConfig | null;
1204
2536
 
1205
2537
  /**
1206
- * Additional instructions for summarization.
2538
+ * `left_mouse_up`'s config overrides.
1207
2539
  */
1208
- instructions?: string | null;
2540
+ left_mouse_up?: BetaComputerLeftMouseUpConfig | null;
1209
2541
 
1210
2542
  /**
1211
- * Whether to pause after compaction and return the compaction block to the user.
2543
+ * `middle_click`'s config overrides.
1212
2544
  */
1213
- pause_after_compaction?: boolean;
2545
+ middle_click?: BetaComputerMiddleClickConfig | null;
1214
2546
 
1215
2547
  /**
1216
- * When to trigger compaction. Defaults to 150000 input tokens.
2548
+ * `mouse_move`'s config overrides.
1217
2549
  */
1218
- trigger?: BetaInputTokensTrigger | null;
1219
- }
2550
+ mouse_move?: BetaComputerMouseMoveConfig | null;
1220
2551
 
1221
- /**
1222
- * A compaction block returned when autocompact is triggered.
1223
- *
1224
- * When content is None, it indicates the compaction failed to produce a valid
1225
- * summary (e.g., malformed output from the model). Clients may round-trip
1226
- * compaction blocks with null content; the server treats them as no-ops.
1227
- */
1228
- export interface BetaCompactionBlock {
1229
2552
  /**
1230
- * Summary of compacted content, or null if compaction failed
2553
+ * `right_click`'s config overrides.
1231
2554
  */
1232
- content: string | null;
2555
+ right_click?: BetaComputerRightClickConfig | null;
1233
2556
 
1234
2557
  /**
1235
- * Opaque metadata from prior compaction, to be round-tripped verbatim
2558
+ * `screenshot`'s config overrides.
1236
2559
  */
1237
- encrypted_content: string | null;
2560
+ screenshot?: BetaComputerScreenshotConfig | null;
1238
2561
 
1239
- type: 'compaction';
1240
- }
2562
+ /**
2563
+ * `scroll`'s config overrides.
2564
+ */
2565
+ scroll?: BetaComputerScrollConfig | null;
1241
2566
 
1242
- /**
1243
- * A compaction block containing summary of previous context.
1244
- *
1245
- * Users should round-trip these blocks from responses to subsequent requests to
1246
- * maintain context across compaction boundaries.
1247
- *
1248
- * When content is None, the block represents a failed compaction. The server
1249
- * treats these as no-ops. Empty string content is not allowed.
1250
- */
1251
- export interface BetaCompactionBlockParam {
1252
- type: 'compaction';
2567
+ /**
2568
+ * `triple_click`'s config overrides.
2569
+ */
2570
+ triple_click?: BetaComputerTripleClickConfig | null;
1253
2571
 
1254
2572
  /**
1255
- * Create a cache control breakpoint at this content block.
2573
+ * `type`'s config overrides.
1256
2574
  */
1257
- cache_control?: BetaCacheControlEphemeral | null;
2575
+ type?: BetaComputerTypeConfig | null;
1258
2576
 
1259
2577
  /**
1260
- * Summary of previously compacted content, or null if compaction failed
2578
+ * `wait`'s config overrides.
1261
2579
  */
1262
- content?: string | null;
2580
+ wait?: BetaComputerWaitConfig | null;
1263
2581
 
1264
2582
  /**
1265
- * Opaque metadata from prior compaction, to be round-tripped verbatim
2583
+ * `zoom`'s config overrides.
1266
2584
  */
1267
- encrypted_content?: string | null;
2585
+ zoom?: BetaComputerZoomConfig | null;
1268
2586
  }
1269
2587
 
1270
- export interface BetaCompactionContentBlockDelta {
1271
- content: string | null;
1272
-
2588
+ /**
2589
+ * `triple_click`'s config overrides.
2590
+ */
2591
+ export interface BetaComputerTripleClickConfig {
1273
2592
  /**
1274
- * Opaque metadata from prior compaction, to be round-tripped verbatim
2593
+ * Defer loading for this member. Must resolve to the same value on every enabled
2594
+ * member of the toolset.
1275
2595
  */
1276
- encrypted_content: string | null;
2596
+ defer_loading?: boolean | null;
1277
2597
 
1278
- type: 'compaction_delta';
2598
+ /**
2599
+ * Whether this member is offered to the model. Default is per member, per the
2600
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2601
+ * the served schema.
2602
+ */
2603
+ enabled?: boolean | null;
1279
2604
  }
1280
2605
 
1281
2606
  /**
1282
- * Token usage for a compaction iteration.
2607
+ * `type`'s config overrides.
1283
2608
  */
1284
- export interface BetaCompactionIterationUsage {
2609
+ export interface BetaComputerTypeConfig {
1285
2610
  /**
1286
- * Breakdown of cached tokens by TTL
2611
+ * Defer loading for this member. Must resolve to the same value on every enabled
2612
+ * member of the toolset.
1287
2613
  */
1288
- cache_creation: BetaCacheCreation | null;
2614
+ defer_loading?: boolean | null;
1289
2615
 
1290
2616
  /**
1291
- * The number of input tokens used to create the cache entry.
2617
+ * Whether this member is offered to the model. Default is per member, per the
2618
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2619
+ * the served schema.
1292
2620
  */
1293
- cache_creation_input_tokens: number;
2621
+ enabled?: boolean | null;
2622
+ }
1294
2623
 
2624
+ /**
2625
+ * `wait`'s config overrides.
2626
+ */
2627
+ export interface BetaComputerWaitConfig {
1295
2628
  /**
1296
- * The number of input tokens read from the cache.
2629
+ * Defer loading for this member. Must resolve to the same value on every enabled
2630
+ * member of the toolset.
1297
2631
  */
1298
- cache_read_input_tokens: number;
2632
+ defer_loading?: boolean | null;
1299
2633
 
1300
2634
  /**
1301
- * The number of input tokens which were used.
2635
+ * Whether this member is offered to the model. Default is per member, per the
2636
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2637
+ * the served schema.
1302
2638
  */
1303
- input_tokens: number;
2639
+ enabled?: boolean | null;
2640
+ }
1304
2641
 
2642
+ /**
2643
+ * `zoom`'s config overrides.
2644
+ */
2645
+ export interface BetaComputerZoomConfig {
1305
2646
  /**
1306
- * The number of output tokens which were used.
2647
+ * Defer loading for this member. Must resolve to the same value on every enabled
2648
+ * member of the toolset.
1307
2649
  */
1308
- output_tokens: number;
2650
+ defer_loading?: boolean | null;
1309
2651
 
1310
2652
  /**
1311
- * Usage for a compaction iteration
2653
+ * Whether this member is offered to the model. Default is per member, per the
2654
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2655
+ * the served schema.
1312
2656
  */
1313
- type: 'compaction';
2657
+ enabled?: boolean | null;
1314
2658
  }
1315
2659
 
1316
2660
  /**
@@ -1862,6 +3206,32 @@ export interface BetaImageBlockParam {
1862
3206
  * Create a cache control breakpoint at this content block.
1863
3207
  */
1864
3208
  cache_control?: BetaCacheControlEphemeral | null;
3209
+
3210
+ /**
3211
+ * Configures the transformations the server applies to this image before the model
3212
+ * observes it. Each key names a condition the server transforms images for; its
3213
+ * value selects the transformation applied. Omitted keys keep their default
3214
+ * behavior, and an empty object is equivalent to omitting the field.
3215
+ */
3216
+ transformations?: BetaImageTransformationsParam | null;
3217
+ }
3218
+
3219
+ /**
3220
+ * Configures the transformations the server applies to this image before the model
3221
+ * observes it. Each key names a condition the server transforms images for; its
3222
+ * value selects the transformation applied. Omitted keys keep their default
3223
+ * behavior, and an empty object is equivalent to omitting the field.
3224
+ */
3225
+ export interface BetaImageTransformationsParam {
3226
+ /**
3227
+ * What the server does when this image exceeds the model's maximum image size.
3228
+ * `"downsize"` (the default) scales the image down to fit, which changes the
3229
+ * dimensions the model observes without telling you. `"error"` instead rejects the
3230
+ * request with a 400 error naming the image's dimensions and the largest
3231
+ * dimensions that fit, so you can scale the image deliberately — your image is
3232
+ * never silently scaled down.
3233
+ */
3234
+ oversized_image?: 'downsize' | 'error';
1865
3235
  }
1866
3236
 
1867
3237
  export interface BetaInputJSONDelta {
@@ -3690,9 +5060,15 @@ export interface BetaToolResultBlockParam {
3690
5060
  | BetaSearchResultBlockParam
3691
5061
  | BetaRequestDocumentBlock
3692
5062
  | BetaToolReferenceBlockParam
5063
+ | BetaBrowserStateBlockParam
3693
5064
  >;
3694
5065
 
3695
5066
  is_error?: boolean;
5067
+
5068
+ /**
5069
+ * For a toolset member tool_result, the toolset family of the paired tool_use.
5070
+ */
5071
+ toolset_name?: string | null;
3696
5072
  }
3697
5073
 
3698
5074
  export interface BetaToolSearchToolBm25_20251119 {
@@ -3958,11 +5334,13 @@ export type BetaToolUnion =
3958
5334
  | BetaCodeExecutionTool20250825
3959
5335
  | BetaCodeExecutionTool20260120
3960
5336
  | BetaCodeExecutionTool20260521
5337
+ | BetaBrowserToolset20260801
3961
5338
  | BetaToolComputerUse20241022
3962
5339
  | BetaMemoryTool20250818
3963
5340
  | BetaToolComputerUse20250124
3964
5341
  | BetaToolTextEditor20241022
3965
5342
  | BetaToolComputerUse20251124
5343
+ | BetaComputerToolset20260801
3966
5344
  | BetaToolTextEditor20250124
3967
5345
  | BetaToolTextEditor20250429
3968
5346
  | BetaToolTextEditor20250728
@@ -3991,6 +5369,11 @@ export interface BetaToolUseBlock {
3991
5369
  * Tool invocation directly from the model.
3992
5370
  */
3993
5371
  caller?: BetaDirectCaller | BetaServerToolCaller | BetaServerToolCaller20260120;
5372
+
5373
+ /**
5374
+ * For a toolset member tool_use, the toolset family.
5375
+ */
5376
+ toolset_name?: string | null;
3994
5377
  }
3995
5378
 
3996
5379
  export interface BetaToolUseBlockParam {
@@ -4011,6 +5394,11 @@ export interface BetaToolUseBlockParam {
4011
5394
  * Tool invocation directly from the model.
4012
5395
  */
4013
5396
  caller?: BetaDirectCaller | BetaServerToolCaller | BetaServerToolCaller20260120;
5397
+
5398
+ /**
5399
+ * For a toolset member tool_use, the toolset family this member belongs to.
5400
+ */
5401
+ toolset_name?: string | null;
4014
5402
  }
4015
5403
 
4016
5404
  export interface BetaToolUsesKeep {
@@ -5371,11 +6759,13 @@ export interface MessageCountTokensParams {
5371
6759
  | BetaCodeExecutionTool20250825
5372
6760
  | BetaCodeExecutionTool20260120
5373
6761
  | BetaCodeExecutionTool20260521
6762
+ | BetaBrowserToolset20260801
5374
6763
  | BetaToolComputerUse20241022
5375
6764
  | BetaMemoryTool20250818
5376
6765
  | BetaToolComputerUse20250124
5377
6766
  | BetaToolTextEditor20241022
5378
6767
  | BetaToolComputerUse20251124
6768
+ | BetaComputerToolset20260801
5379
6769
  | BetaToolTextEditor20250124
5380
6770
  | BetaToolTextEditor20250429
5381
6771
  | BetaToolTextEditor20250728
@@ -5436,6 +6826,46 @@ export declare namespace Messages {
5436
6826
  type BetaBashCodeExecutionToolResultBlockParam as BetaBashCodeExecutionToolResultBlockParam,
5437
6827
  type BetaBashCodeExecutionToolResultError as BetaBashCodeExecutionToolResultError,
5438
6828
  type BetaBashCodeExecutionToolResultErrorParam as BetaBashCodeExecutionToolResultErrorParam,
6829
+ type BetaBrowserCloseTabConfig as BetaBrowserCloseTabConfig,
6830
+ type BetaBrowserDoubleClickConfig as BetaBrowserDoubleClickConfig,
6831
+ type BetaBrowserFileUploadConfig as BetaBrowserFileUploadConfig,
6832
+ type BetaBrowserFindConfig as BetaBrowserFindConfig,
6833
+ type BetaBrowserFormInputConfig as BetaBrowserFormInputConfig,
6834
+ type BetaBrowserGetPageTextConfig as BetaBrowserGetPageTextConfig,
6835
+ type BetaBrowserHoldKeyConfig as BetaBrowserHoldKeyConfig,
6836
+ type BetaBrowserHoverConfig as BetaBrowserHoverConfig,
6837
+ type BetaBrowserJavascriptExecConfig as BetaBrowserJavascriptExecConfig,
6838
+ type BetaBrowserKeyConfig as BetaBrowserKeyConfig,
6839
+ type BetaBrowserLeftClickConfig as BetaBrowserLeftClickConfig,
6840
+ type BetaBrowserLeftClickDragConfig as BetaBrowserLeftClickDragConfig,
6841
+ type BetaBrowserLeftMouseDownConfig as BetaBrowserLeftMouseDownConfig,
6842
+ type BetaBrowserLeftMouseUpConfig as BetaBrowserLeftMouseUpConfig,
6843
+ type BetaBrowserListTabsConfig as BetaBrowserListTabsConfig,
6844
+ type BetaBrowserMiddleClickConfig as BetaBrowserMiddleClickConfig,
6845
+ type BetaBrowserMouseMoveConfig as BetaBrowserMouseMoveConfig,
6846
+ type BetaBrowserNavigateConfig as BetaBrowserNavigateConfig,
6847
+ type BetaBrowserNewTabConfig as BetaBrowserNewTabConfig,
6848
+ type BetaBrowserReadConsoleConfig as BetaBrowserReadConsoleConfig,
6849
+ type BetaBrowserReadNetworkConfig as BetaBrowserReadNetworkConfig,
6850
+ type BetaBrowserReadPageConfig as BetaBrowserReadPageConfig,
6851
+ type BetaBrowserRightClickConfig as BetaBrowserRightClickConfig,
6852
+ type BetaBrowserScreenshotConfig as BetaBrowserScreenshotConfig,
6853
+ type BetaBrowserScrollConfig as BetaBrowserScrollConfig,
6854
+ type BetaBrowserScrollToConfig as BetaBrowserScrollToConfig,
6855
+ type BetaBrowserStateBlockParam as BetaBrowserStateBlockParam,
6856
+ type BetaBrowserStateChange as BetaBrowserStateChange,
6857
+ type BetaBrowserStateChangeDownloadCompleted as BetaBrowserStateChangeDownloadCompleted,
6858
+ type BetaBrowserStateChangeDownloadFailed as BetaBrowserStateChangeDownloadFailed,
6859
+ type BetaBrowserStateChangeDownloadStarted as BetaBrowserStateChangeDownloadStarted,
6860
+ type BetaBrowserStateChangeTabOpened as BetaBrowserStateChangeTabOpened,
6861
+ type BetaBrowserStateTabEntry as BetaBrowserStateTabEntry,
6862
+ type BetaBrowserSwitchTabConfig as BetaBrowserSwitchTabConfig,
6863
+ type BetaBrowserToolset20260801 as BetaBrowserToolset20260801,
6864
+ type BetaBrowserToolsetConfigs as BetaBrowserToolsetConfigs,
6865
+ type BetaBrowserTripleClickConfig as BetaBrowserTripleClickConfig,
6866
+ type BetaBrowserTypeConfig as BetaBrowserTypeConfig,
6867
+ type BetaBrowserWaitConfig as BetaBrowserWaitConfig,
6868
+ type BetaBrowserZoomConfig as BetaBrowserZoomConfig,
5439
6869
  type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
5440
6870
  type BetaCacheCreation as BetaCacheCreation,
5441
6871
  type BetaCacheMissMessagesChanged as BetaCacheMissMessagesChanged,
@@ -5481,6 +6911,25 @@ export declare namespace Messages {
5481
6911
  type BetaCompactionBlockParam as BetaCompactionBlockParam,
5482
6912
  type BetaCompactionContentBlockDelta as BetaCompactionContentBlockDelta,
5483
6913
  type BetaCompactionIterationUsage as BetaCompactionIterationUsage,
6914
+ type BetaComputerCursorPositionConfig as BetaComputerCursorPositionConfig,
6915
+ type BetaComputerDoubleClickConfig as BetaComputerDoubleClickConfig,
6916
+ type BetaComputerHoldKeyConfig as BetaComputerHoldKeyConfig,
6917
+ type BetaComputerKeyConfig as BetaComputerKeyConfig,
6918
+ type BetaComputerLeftClickConfig as BetaComputerLeftClickConfig,
6919
+ type BetaComputerLeftClickDragConfig as BetaComputerLeftClickDragConfig,
6920
+ type BetaComputerLeftMouseDownConfig as BetaComputerLeftMouseDownConfig,
6921
+ type BetaComputerLeftMouseUpConfig as BetaComputerLeftMouseUpConfig,
6922
+ type BetaComputerMiddleClickConfig as BetaComputerMiddleClickConfig,
6923
+ type BetaComputerMouseMoveConfig as BetaComputerMouseMoveConfig,
6924
+ type BetaComputerRightClickConfig as BetaComputerRightClickConfig,
6925
+ type BetaComputerScreenshotConfig as BetaComputerScreenshotConfig,
6926
+ type BetaComputerScrollConfig as BetaComputerScrollConfig,
6927
+ type BetaComputerToolset20260801 as BetaComputerToolset20260801,
6928
+ type BetaComputerToolsetConfigs as BetaComputerToolsetConfigs,
6929
+ type BetaComputerTripleClickConfig as BetaComputerTripleClickConfig,
6930
+ type BetaComputerTypeConfig as BetaComputerTypeConfig,
6931
+ type BetaComputerWaitConfig as BetaComputerWaitConfig,
6932
+ type BetaComputerZoomConfig as BetaComputerZoomConfig,
5484
6933
  type BetaContainer as BetaContainer,
5485
6934
  type BetaContainerParams as BetaContainerParams,
5486
6935
  type BetaContainerUploadBlock as BetaContainerUploadBlock,
@@ -5513,6 +6962,7 @@ export declare namespace Messages {
5513
6962
  type BetaFileDocumentSource as BetaFileDocumentSource,
5514
6963
  type BetaFileImageSource as BetaFileImageSource,
5515
6964
  type BetaImageBlockParam as BetaImageBlockParam,
6965
+ type BetaImageTransformationsParam as BetaImageTransformationsParam,
5516
6966
  type BetaInputJSONDelta as BetaInputJSONDelta,
5517
6967
  type BetaInputTokensClearAtLeast as BetaInputTokensClearAtLeast,
5518
6968
  type BetaInputTokensTrigger as BetaInputTokensTrigger,