@anthropic-ai/sdk 0.118.0 → 0.120.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.
- package/CHANGELOG.md +21 -0
- package/client.d.mts +8 -2
- package/client.d.mts.map +1 -1
- package/client.d.ts +8 -2
- package/client.d.ts.map +1 -1
- package/client.js +6 -0
- package/client.js.map +1 -1
- package/client.mjs +6 -0
- package/client.mjs.map +1 -1
- package/helpers/beta/environments.d.mts +5 -4
- package/helpers/beta/environments.d.mts.map +1 -1
- package/helpers/beta/environments.d.ts +5 -4
- package/helpers/beta/environments.d.ts.map +1 -1
- package/helpers/beta/environments.js +5 -4
- package/helpers/beta/environments.js.map +1 -1
- package/helpers/beta/environments.mjs +5 -4
- package/helpers/beta/environments.mjs.map +1 -1
- package/internal/file-store.d.mts +136 -0
- package/internal/file-store.d.mts.map +1 -0
- package/internal/file-store.d.ts +136 -0
- package/internal/file-store.d.ts.map +1 -0
- package/internal/file-store.js +531 -0
- package/internal/file-store.js.map +1 -0
- package/internal/file-store.mjs +523 -0
- package/internal/file-store.mjs.map +1 -0
- package/lib/environments/poller.d.mts +6 -0
- package/lib/environments/poller.d.mts.map +1 -1
- package/lib/environments/poller.d.ts +6 -0
- package/lib/environments/poller.d.ts.map +1 -1
- package/lib/environments/poller.js +46 -1
- package/lib/environments/poller.js.map +1 -1
- package/lib/environments/poller.mjs +46 -1
- package/lib/environments/poller.mjs.map +1 -1
- package/lib/environments/worker.d.mts +89 -12
- package/lib/environments/worker.d.mts.map +1 -1
- package/lib/environments/worker.d.ts +89 -12
- package/lib/environments/worker.d.ts.map +1 -1
- package/lib/environments/worker.js +336 -67
- package/lib/environments/worker.js.map +1 -1
- package/lib/environments/worker.mjs +336 -68
- package/lib/environments/worker.mjs.map +1 -1
- package/lib/tools/BetaRunnableTool.d.mts +4 -1
- package/lib/tools/BetaRunnableTool.d.mts.map +1 -1
- package/lib/tools/BetaRunnableTool.d.ts +4 -1
- package/lib/tools/BetaRunnableTool.d.ts.map +1 -1
- package/lib/tools/BetaRunnableTool.js +7 -2
- package/lib/tools/BetaRunnableTool.js.map +1 -1
- package/lib/tools/BetaRunnableTool.mjs +7 -2
- package/lib/tools/BetaRunnableTool.mjs.map +1 -1
- package/lib/tools/BetaToolRunner.d.mts.map +1 -1
- package/lib/tools/BetaToolRunner.d.ts.map +1 -1
- package/lib/tools/BetaToolRunner.js +3 -1
- package/lib/tools/BetaToolRunner.js.map +1 -1
- package/lib/tools/BetaToolRunner.mjs +3 -1
- package/lib/tools/BetaToolRunner.mjs.map +1 -1
- package/package.json +1 -1
- package/resources/beta/agents/agents.d.mts +322 -27
- package/resources/beta/agents/agents.d.mts.map +1 -1
- package/resources/beta/agents/agents.d.ts +322 -27
- package/resources/beta/agents/agents.d.ts.map +1 -1
- package/resources/beta/agents/agents.js.map +1 -1
- package/resources/beta/agents/agents.mjs.map +1 -1
- package/resources/beta/agents/index.d.mts +1 -1
- package/resources/beta/agents/index.d.mts.map +1 -1
- package/resources/beta/agents/index.d.ts +1 -1
- package/resources/beta/agents/index.d.ts.map +1 -1
- package/resources/beta/agents/index.js.map +1 -1
- package/resources/beta/agents/index.mjs.map +1 -1
- package/resources/beta/beta.d.mts +6 -6
- package/resources/beta/beta.d.mts.map +1 -1
- package/resources/beta/beta.d.ts +6 -6
- package/resources/beta/beta.d.ts.map +1 -1
- package/resources/beta/beta.js.map +1 -1
- package/resources/beta/beta.mjs.map +1 -1
- package/resources/beta/environments/work.d.mts +5 -1
- package/resources/beta/environments/work.d.mts.map +1 -1
- package/resources/beta/environments/work.d.ts +5 -1
- package/resources/beta/environments/work.d.ts.map +1 -1
- package/resources/beta/environments/work.js +0 -17
- package/resources/beta/environments/work.js.map +1 -1
- package/resources/beta/environments/work.mjs +0 -17
- package/resources/beta/environments/work.mjs.map +1 -1
- package/resources/beta/files.d.mts +22 -22
- package/resources/beta/files.d.mts.map +1 -1
- package/resources/beta/files.d.ts +22 -22
- package/resources/beta/files.d.ts.map +1 -1
- package/resources/beta/files.js +4 -4
- package/resources/beta/files.js.map +1 -1
- package/resources/beta/files.mjs +4 -4
- package/resources/beta/files.mjs.map +1 -1
- package/resources/beta/index.d.mts +3 -3
- package/resources/beta/index.d.mts.map +1 -1
- package/resources/beta/index.d.ts +3 -3
- package/resources/beta/index.d.ts.map +1 -1
- package/resources/beta/index.js.map +1 -1
- package/resources/beta/index.mjs.map +1 -1
- package/resources/beta/messages/index.d.mts +1 -1
- package/resources/beta/messages/index.d.mts.map +1 -1
- package/resources/beta/messages/index.d.ts +1 -1
- package/resources/beta/messages/index.d.ts.map +1 -1
- package/resources/beta/messages/index.js.map +1 -1
- package/resources/beta/messages/index.mjs.map +1 -1
- package/resources/beta/messages/messages.d.mts +1202 -5
- package/resources/beta/messages/messages.d.mts.map +1 -1
- package/resources/beta/messages/messages.d.ts +1202 -5
- package/resources/beta/messages/messages.d.ts.map +1 -1
- package/resources/beta/messages/messages.js.map +1 -1
- package/resources/beta/messages/messages.mjs.map +1 -1
- package/resources/files.d.mts +105 -0
- package/resources/files.d.mts.map +1 -0
- package/resources/files.d.ts +105 -0
- package/resources/files.d.ts.map +1 -0
- package/resources/files.js +52 -0
- package/resources/files.js.map +1 -0
- package/resources/files.mjs +48 -0
- package/resources/files.mjs.map +1 -0
- package/resources/index.d.mts +3 -1
- package/resources/index.d.mts.map +1 -1
- package/resources/index.d.ts +3 -1
- package/resources/index.d.ts.map +1 -1
- package/resources/index.js +5 -1
- package/resources/index.js.map +1 -1
- package/resources/index.mjs +2 -0
- package/resources/index.mjs.map +1 -1
- package/resources/messages/index.d.mts +1 -1
- package/resources/messages/index.d.mts.map +1 -1
- package/resources/messages/index.d.ts +1 -1
- package/resources/messages/index.d.ts.map +1 -1
- package/resources/messages/index.js.map +1 -1
- package/resources/messages/index.mjs.map +1 -1
- package/resources/messages/messages.d.mts +1267 -7
- package/resources/messages/messages.d.mts.map +1 -1
- package/resources/messages/messages.d.ts +1267 -7
- package/resources/messages/messages.d.ts.map +1 -1
- package/resources/messages/messages.js.map +1 -1
- package/resources/messages/messages.mjs.map +1 -1
- package/resources/skills/index.d.mts +3 -0
- package/resources/skills/index.d.mts.map +1 -0
- package/resources/skills/index.d.ts +3 -0
- package/resources/skills/index.d.ts.map +1 -0
- package/resources/skills/index.js +9 -0
- package/resources/skills/index.js.map +1 -0
- package/resources/skills/index.mjs +4 -0
- package/resources/skills/index.mjs.map +1 -0
- package/resources/skills/skills.d.mts +129 -0
- package/resources/skills/skills.d.mts.map +1 -0
- package/resources/skills/skills.d.ts +129 -0
- package/resources/skills/skills.d.ts.map +1 -0
- package/resources/skills/skills.js +44 -0
- package/resources/skills/skills.js.map +1 -0
- package/resources/skills/skills.mjs +39 -0
- package/resources/skills/skills.mjs.map +1 -0
- package/resources/skills/versions.d.mts +104 -0
- package/resources/skills/versions.d.mts.map +1 -0
- package/resources/skills/versions.d.ts +104 -0
- package/resources/skills/versions.d.ts.map +1 -0
- package/resources/skills/versions.js +41 -0
- package/resources/skills/versions.js.map +1 -0
- package/resources/skills/versions.mjs +37 -0
- package/resources/skills/versions.mjs.map +1 -0
- package/resources/skills.d.mts +2 -0
- package/resources/skills.d.mts.map +1 -0
- package/resources/skills.d.ts +2 -0
- package/resources/skills.d.ts.map +1 -0
- package/resources/skills.js +6 -0
- package/resources/skills.js.map +1 -0
- package/resources/skills.mjs +3 -0
- package/resources/skills.mjs.map +1 -0
- package/src/client.ts +172 -0
- package/src/helpers/beta/environments.ts +5 -4
- package/src/internal/file-store.ts +550 -0
- package/src/lib/environments/poller.ts +47 -1
- package/src/lib/environments/worker.ts +419 -79
- package/src/lib/tools/BetaRunnableTool.ts +9 -2
- package/src/lib/tools/BetaToolRunner.ts +6 -1
- package/src/resources/beta/agents/agents.ts +435 -30
- package/src/resources/beta/agents/index.ts +17 -0
- package/src/resources/beta/beta.ts +160 -6
- package/src/resources/beta/environments/work.ts +7 -0
- package/src/resources/beta/files.ts +27 -27
- package/src/resources/beta/index.ts +80 -3
- package/src/resources/beta/messages/index.ts +60 -0
- package/src/resources/beta/messages/messages.ts +1865 -415
- package/src/resources/files.ts +163 -0
- package/src/resources/index.ts +83 -0
- package/src/resources/messages/index.ts +66 -0
- package/src/resources/messages/messages.ts +1648 -115
- package/src/resources/skills/index.ts +21 -0
- package/src/resources/skills/skills.ts +194 -0
- package/src/resources/skills/versions.ts +160 -0
- package/src/resources/skills.ts +3 -0
- package/src/tools/agent-toolset/fs-util.ts +40 -24
- package/src/tools/agent-toolset/memories.ts +1017 -0
- package/src/tools/agent-toolset/node.browser.ts +68 -0
- package/src/tools/agent-toolset/node.ts +139 -53
- package/src/tools/agent-toolset/skills.ts +29 -9
- package/src/tools/agent-toolset/sync-interval.ts +30 -0
- package/src/version.ts +1 -1
- package/tools/agent-toolset/fs-util.d.mts +23 -10
- package/tools/agent-toolset/fs-util.d.mts.map +1 -1
- package/tools/agent-toolset/fs-util.d.ts +23 -10
- package/tools/agent-toolset/fs-util.d.ts.map +1 -1
- package/tools/agent-toolset/fs-util.js +40 -25
- package/tools/agent-toolset/fs-util.js.map +1 -1
- package/tools/agent-toolset/fs-util.mjs +38 -25
- package/tools/agent-toolset/fs-util.mjs.map +1 -1
- package/tools/agent-toolset/memories.d.mts +173 -0
- package/tools/agent-toolset/memories.d.mts.map +1 -0
- package/tools/agent-toolset/memories.d.ts +173 -0
- package/tools/agent-toolset/memories.d.ts.map +1 -0
- package/tools/agent-toolset/memories.js +902 -0
- package/tools/agent-toolset/memories.js.map +1 -0
- package/tools/agent-toolset/memories.mjs +895 -0
- package/tools/agent-toolset/memories.mjs.map +1 -0
- package/tools/agent-toolset/node.browser.d.mts +31 -0
- package/tools/agent-toolset/node.browser.d.mts.map +1 -1
- package/tools/agent-toolset/node.browser.d.ts +31 -0
- package/tools/agent-toolset/node.browser.d.ts.map +1 -1
- package/tools/agent-toolset/node.browser.js +59 -1
- package/tools/agent-toolset/node.browser.js.map +1 -1
- package/tools/agent-toolset/node.browser.mjs +54 -0
- package/tools/agent-toolset/node.browser.mjs.map +1 -1
- package/tools/agent-toolset/node.d.mts +54 -22
- package/tools/agent-toolset/node.d.mts.map +1 -1
- package/tools/agent-toolset/node.d.ts +54 -22
- package/tools/agent-toolset/node.d.ts.map +1 -1
- package/tools/agent-toolset/node.js +83 -44
- package/tools/agent-toolset/node.js.map +1 -1
- package/tools/agent-toolset/node.mjs +77 -44
- package/tools/agent-toolset/node.mjs.map +1 -1
- package/tools/agent-toolset/skills.d.mts +16 -7
- package/tools/agent-toolset/skills.d.mts.map +1 -1
- package/tools/agent-toolset/skills.d.ts +16 -7
- package/tools/agent-toolset/skills.d.ts.map +1 -1
- package/tools/agent-toolset/skills.js +27 -9
- package/tools/agent-toolset/skills.js.map +1 -1
- package/tools/agent-toolset/skills.mjs +27 -9
- package/tools/agent-toolset/skills.mjs.map +1 -1
- package/tools/agent-toolset/sync-interval.d.mts +19 -0
- package/tools/agent-toolset/sync-interval.d.mts.map +1 -0
- package/tools/agent-toolset/sync-interval.d.ts +19 -0
- package/tools/agent-toolset/sync-interval.d.ts.map +1 -0
- package/tools/agent-toolset/sync-interval.js +29 -0
- package/tools/agent-toolset/sync-interval.js.map +1 -0
- package/tools/agent-toolset/sync-interval.mjs +25 -0
- package/tools/agent-toolset/sync-interval.mjs.map +1 -0
- package/version.d.mts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- 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
|
-
|
|
566
|
-
|
|
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
|
-
*
|
|
570
|
-
*
|
|
571
|
-
*
|
|
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
|
-
|
|
580
|
+
enabled?: boolean | null;
|
|
581
581
|
}
|
|
582
582
|
|
|
583
|
-
|
|
583
|
+
/**
|
|
584
|
+
* `double_click`'s config overrides.
|
|
585
|
+
*/
|
|
586
|
+
export interface BetaBrowserDoubleClickConfig {
|
|
584
587
|
/**
|
|
585
|
-
*
|
|
588
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
589
|
+
* member of the toolset.
|
|
586
590
|
*/
|
|
587
|
-
|
|
591
|
+
defer_loading?: boolean | null;
|
|
588
592
|
|
|
589
593
|
/**
|
|
590
|
-
*
|
|
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
|
-
|
|
598
|
+
enabled?: boolean | null;
|
|
593
599
|
}
|
|
594
600
|
|
|
595
|
-
|
|
601
|
+
/**
|
|
602
|
+
* `file_upload`'s config overrides.
|
|
603
|
+
*/
|
|
604
|
+
export interface BetaBrowserFileUploadConfig {
|
|
596
605
|
/**
|
|
597
|
-
*
|
|
598
|
-
*
|
|
606
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
607
|
+
* member of the toolset.
|
|
599
608
|
*/
|
|
600
|
-
|
|
609
|
+
defer_loading?: boolean | null;
|
|
601
610
|
|
|
602
|
-
|
|
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
|
-
|
|
619
|
+
/**
|
|
620
|
+
* `find`'s config overrides.
|
|
621
|
+
*/
|
|
622
|
+
export interface BetaBrowserFindConfig {
|
|
606
623
|
/**
|
|
607
|
-
*
|
|
608
|
-
*
|
|
624
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
625
|
+
* member of the toolset.
|
|
609
626
|
*/
|
|
610
|
-
|
|
627
|
+
defer_loading?: boolean | null;
|
|
611
628
|
|
|
612
|
-
|
|
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
|
-
|
|
616
|
-
|
|
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
|
-
|
|
655
|
+
/**
|
|
656
|
+
* `get_page_text`'s config overrides.
|
|
657
|
+
*/
|
|
658
|
+
export interface BetaBrowserGetPageTextConfig {
|
|
620
659
|
/**
|
|
621
|
-
*
|
|
622
|
-
*
|
|
660
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
661
|
+
* member of the toolset.
|
|
623
662
|
*/
|
|
624
|
-
|
|
663
|
+
defer_loading?: boolean | null;
|
|
625
664
|
|
|
626
|
-
|
|
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
|
-
|
|
673
|
+
/**
|
|
674
|
+
* `hold_key`'s config overrides.
|
|
675
|
+
*/
|
|
676
|
+
export interface BetaBrowserHoldKeyConfig {
|
|
630
677
|
/**
|
|
631
|
-
*
|
|
632
|
-
*
|
|
678
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
679
|
+
* member of the toolset.
|
|
633
680
|
*/
|
|
634
|
-
|
|
681
|
+
defer_loading?: boolean | null;
|
|
635
682
|
|
|
636
|
-
|
|
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
|
-
|
|
640
|
-
|
|
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
|
-
|
|
644
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
660
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
674
|
-
|
|
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
|
-
*
|
|
680
|
-
*
|
|
681
|
-
*
|
|
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
|
-
|
|
832
|
+
enabled?: boolean | null;
|
|
833
|
+
}
|
|
687
834
|
|
|
688
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
694
|
-
*
|
|
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
|
-
|
|
861
|
+
defer_loading?: boolean | null;
|
|
700
862
|
|
|
701
|
-
|
|
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
|
-
*
|
|
876
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
877
|
+
* member of the toolset.
|
|
705
878
|
*/
|
|
706
|
-
|
|
879
|
+
defer_loading?: boolean | null;
|
|
707
880
|
|
|
708
|
-
|
|
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
|
-
|
|
889
|
+
/**
|
|
890
|
+
* `new_tab`'s config overrides.
|
|
891
|
+
*/
|
|
892
|
+
export interface BetaBrowserNewTabConfig {
|
|
712
893
|
/**
|
|
713
|
-
*
|
|
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
|
-
|
|
897
|
+
defer_loading?: boolean | null;
|
|
721
898
|
|
|
722
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
728
|
-
*
|
|
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
|
-
|
|
922
|
+
enabled?: boolean | null;
|
|
923
|
+
}
|
|
734
924
|
|
|
925
|
+
/**
|
|
926
|
+
* `read_network`'s config overrides.
|
|
927
|
+
*/
|
|
928
|
+
export interface BetaBrowserReadNetworkConfig {
|
|
735
929
|
/**
|
|
736
|
-
*
|
|
930
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
931
|
+
* member of the toolset.
|
|
737
932
|
*/
|
|
738
|
-
|
|
933
|
+
defer_loading?: boolean | null;
|
|
739
934
|
|
|
740
|
-
|
|
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
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
760
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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: '
|
|
771
|
-
}
|
|
1049
|
+
type: 'browser_state';
|
|
772
1050
|
|
|
773
|
-
export interface BetaCitationSearchResultLocation {
|
|
774
1051
|
/**
|
|
775
|
-
*
|
|
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
|
-
|
|
1054
|
+
cache_control?: BetaCacheControlEphemeral | null;
|
|
783
1055
|
|
|
784
1056
|
/**
|
|
785
|
-
*
|
|
786
|
-
*
|
|
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
|
-
|
|
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
|
-
*
|
|
795
|
-
*
|
|
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
|
-
|
|
1088
|
+
download_id: string;
|
|
802
1089
|
|
|
803
|
-
|
|
1090
|
+
type: 'download_completed';
|
|
804
1091
|
|
|
805
1092
|
/**
|
|
806
|
-
*
|
|
1093
|
+
* The final post-redirect URL the download was served from.
|
|
807
1094
|
*/
|
|
808
|
-
|
|
1095
|
+
url: string;
|
|
809
1096
|
|
|
810
|
-
|
|
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
|
-
|
|
1103
|
+
/**
|
|
1104
|
+
* The completed download's size.
|
|
1105
|
+
*/
|
|
1106
|
+
size_bytes?: number | null;
|
|
813
1107
|
}
|
|
814
1108
|
|
|
815
|
-
|
|
1109
|
+
/**
|
|
1110
|
+
* A file download that failed — or was cancelled — during this call.
|
|
1111
|
+
*/
|
|
1112
|
+
export interface BetaBrowserStateChangeDownloadFailed {
|
|
816
1113
|
/**
|
|
817
|
-
* The
|
|
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
|
-
|
|
1117
|
+
download_id: string;
|
|
1118
|
+
|
|
1119
|
+
type: 'download_failed';
|
|
825
1120
|
|
|
826
1121
|
/**
|
|
827
|
-
*
|
|
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
|
-
|
|
1124
|
+
url: string;
|
|
834
1125
|
|
|
835
1126
|
/**
|
|
836
|
-
*
|
|
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
|
-
|
|
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
|
-
*
|
|
1137
|
+
* The caller-assigned identifier for this download, stable across the state
|
|
1138
|
+
* changes reporting it.
|
|
849
1139
|
*/
|
|
850
|
-
|
|
1140
|
+
download_id: string;
|
|
851
1141
|
|
|
852
|
-
|
|
1142
|
+
type: 'download_started';
|
|
853
1143
|
|
|
854
|
-
|
|
1144
|
+
/**
|
|
1145
|
+
* The final post-redirect URL the download was served from.
|
|
1146
|
+
*/
|
|
1147
|
+
url: string;
|
|
855
1148
|
}
|
|
856
1149
|
|
|
857
|
-
|
|
858
|
-
|
|
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
|
-
|
|
1164
|
+
type: 'tab_opened';
|
|
1165
|
+
}
|
|
861
1166
|
|
|
862
|
-
|
|
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
|
-
|
|
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
|
-
|
|
870
|
-
|
|
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
|
-
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
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
|
-
|
|
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
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
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
|
-
|
|
1224
|
+
allowed_callers?: Array<
|
|
1225
|
+
'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
|
|
1226
|
+
>;
|
|
890
1227
|
|
|
891
|
-
|
|
1228
|
+
/**
|
|
1229
|
+
* Create a cache control breakpoint at this content block.
|
|
1230
|
+
*/
|
|
1231
|
+
cache_control?: BetaCacheControlEphemeral | null;
|
|
892
1232
|
|
|
893
|
-
|
|
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
|
-
|
|
897
|
-
|
|
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
|
-
*
|
|
901
|
-
* will have their thinking blocks removed.
|
|
1257
|
+
* `double_click`'s config overrides.
|
|
902
1258
|
*/
|
|
903
|
-
|
|
904
|
-
}
|
|
1259
|
+
double_click?: BetaBrowserDoubleClickConfig | null;
|
|
905
1260
|
|
|
906
|
-
export interface BetaClearThinking20251015EditResponse {
|
|
907
1261
|
/**
|
|
908
|
-
*
|
|
1262
|
+
* `file_upload`'s config overrides.
|
|
909
1263
|
*/
|
|
910
|
-
|
|
1264
|
+
file_upload?: BetaBrowserFileUploadConfig | null;
|
|
911
1265
|
|
|
912
1266
|
/**
|
|
913
|
-
*
|
|
1267
|
+
* `find`'s config overrides.
|
|
914
1268
|
*/
|
|
915
|
-
|
|
1269
|
+
find?: BetaBrowserFindConfig | null;
|
|
916
1270
|
|
|
917
1271
|
/**
|
|
918
|
-
*
|
|
1272
|
+
* `form_input`'s config overrides.
|
|
919
1273
|
*/
|
|
920
|
-
|
|
921
|
-
}
|
|
1274
|
+
form_input?: BetaBrowserFormInputConfig | null;
|
|
922
1275
|
|
|
923
|
-
|
|
924
|
-
|
|
1276
|
+
/**
|
|
1277
|
+
* `get_page_text`'s config overrides.
|
|
1278
|
+
*/
|
|
1279
|
+
get_page_text?: BetaBrowserGetPageTextConfig | null;
|
|
925
1280
|
|
|
926
1281
|
/**
|
|
927
|
-
*
|
|
928
|
-
* be modified if at least this many tokens can be removed.
|
|
1282
|
+
* `hold_key`'s config overrides.
|
|
929
1283
|
*/
|
|
930
|
-
|
|
1284
|
+
hold_key?: BetaBrowserHoldKeyConfig | null;
|
|
931
1285
|
|
|
932
1286
|
/**
|
|
933
|
-
*
|
|
1287
|
+
* `hover`'s config overrides.
|
|
934
1288
|
*/
|
|
935
|
-
|
|
1289
|
+
hover?: BetaBrowserHoverConfig | null;
|
|
936
1290
|
|
|
937
1291
|
/**
|
|
938
|
-
*
|
|
1292
|
+
* `javascript_exec`'s config overrides.
|
|
939
1293
|
*/
|
|
940
|
-
|
|
1294
|
+
javascript_exec?: BetaBrowserJavascriptExecConfig | null;
|
|
941
1295
|
|
|
942
1296
|
/**
|
|
943
|
-
*
|
|
1297
|
+
* `key`'s config overrides.
|
|
944
1298
|
*/
|
|
945
|
-
|
|
1299
|
+
key?: BetaBrowserKeyConfig | null;
|
|
946
1300
|
|
|
947
1301
|
/**
|
|
948
|
-
*
|
|
1302
|
+
* `left_click`'s config overrides.
|
|
949
1303
|
*/
|
|
950
|
-
|
|
951
|
-
}
|
|
1304
|
+
left_click?: BetaBrowserLeftClickConfig | null;
|
|
952
1305
|
|
|
953
|
-
export interface BetaClearToolUses20250919EditResponse {
|
|
954
1306
|
/**
|
|
955
|
-
*
|
|
1307
|
+
* `left_click_drag`'s config overrides.
|
|
956
1308
|
*/
|
|
957
|
-
|
|
1309
|
+
left_click_drag?: BetaBrowserLeftClickDragConfig | null;
|
|
958
1310
|
|
|
959
1311
|
/**
|
|
960
|
-
*
|
|
1312
|
+
* `left_mouse_down`'s config overrides.
|
|
961
1313
|
*/
|
|
962
|
-
|
|
1314
|
+
left_mouse_down?: BetaBrowserLeftMouseDownConfig | null;
|
|
963
1315
|
|
|
964
1316
|
/**
|
|
965
|
-
*
|
|
1317
|
+
* `left_mouse_up`'s config overrides.
|
|
966
1318
|
*/
|
|
967
|
-
|
|
968
|
-
}
|
|
1319
|
+
left_mouse_up?: BetaBrowserLeftMouseUpConfig | null;
|
|
969
1320
|
|
|
970
|
-
|
|
971
|
-
|
|
1321
|
+
/**
|
|
1322
|
+
* `list_tabs`'s config overrides.
|
|
1323
|
+
*/
|
|
1324
|
+
list_tabs?: BetaBrowserListTabsConfig | null;
|
|
972
1325
|
|
|
973
|
-
|
|
974
|
-
|
|
1326
|
+
/**
|
|
1327
|
+
* `middle_click`'s config overrides.
|
|
1328
|
+
*/
|
|
1329
|
+
middle_click?: BetaBrowserMiddleClickConfig | null;
|
|
975
1330
|
|
|
976
|
-
|
|
977
|
-
|
|
1331
|
+
/**
|
|
1332
|
+
* `mouse_move`'s config overrides.
|
|
1333
|
+
*/
|
|
1334
|
+
mouse_move?: BetaBrowserMouseMoveConfig | null;
|
|
978
1335
|
|
|
979
|
-
|
|
980
|
-
|
|
1336
|
+
/**
|
|
1337
|
+
* `navigate`'s config overrides.
|
|
1338
|
+
*/
|
|
1339
|
+
navigate?: BetaBrowserNavigateConfig | null;
|
|
981
1340
|
|
|
982
|
-
|
|
983
|
-
|
|
1341
|
+
/**
|
|
1342
|
+
* `new_tab`'s config overrides.
|
|
1343
|
+
*/
|
|
1344
|
+
new_tab?: BetaBrowserNewTabConfig | null;
|
|
984
1345
|
|
|
985
|
-
|
|
1346
|
+
/**
|
|
1347
|
+
* `read_console`'s config overrides.
|
|
1348
|
+
*/
|
|
1349
|
+
read_console?: BetaBrowserReadConsoleConfig | null;
|
|
986
1350
|
|
|
987
|
-
|
|
1351
|
+
/**
|
|
1352
|
+
* `read_network`'s config overrides.
|
|
1353
|
+
*/
|
|
1354
|
+
read_network?: BetaBrowserReadNetworkConfig | null;
|
|
988
1355
|
|
|
989
|
-
|
|
1356
|
+
/**
|
|
1357
|
+
* `read_page`'s config overrides.
|
|
1358
|
+
*/
|
|
1359
|
+
read_page?: BetaBrowserReadPageConfig | null;
|
|
990
1360
|
|
|
991
|
-
|
|
992
|
-
|
|
1361
|
+
/**
|
|
1362
|
+
* `right_click`'s config overrides.
|
|
1363
|
+
*/
|
|
1364
|
+
right_click?: BetaBrowserRightClickConfig | null;
|
|
993
1365
|
|
|
994
|
-
|
|
995
|
-
|
|
1366
|
+
/**
|
|
1367
|
+
* `screenshot`'s config overrides.
|
|
1368
|
+
*/
|
|
1369
|
+
screenshot?: BetaBrowserScreenshotConfig | null;
|
|
996
1370
|
|
|
997
|
-
|
|
1371
|
+
/**
|
|
1372
|
+
* `scroll`'s config overrides.
|
|
1373
|
+
*/
|
|
1374
|
+
scroll?: BetaBrowserScrollConfig | null;
|
|
998
1375
|
|
|
999
|
-
|
|
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
|
-
|
|
1994
|
+
type: 'code_execution_20260120';
|
|
1002
1995
|
|
|
1003
|
-
|
|
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
|
-
|
|
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,306 +2025,636 @@ export interface BetaCodeExecutionTool20250522 {
|
|
|
1011
2025
|
*/
|
|
1012
2026
|
name: 'code_execution';
|
|
1013
2027
|
|
|
1014
|
-
type: '
|
|
2028
|
+
type: 'code_execution_20260521';
|
|
1015
2029
|
|
|
1016
2030
|
allowed_callers?: Array<
|
|
1017
2031
|
'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
|
|
1018
2032
|
>;
|
|
1019
2033
|
|
|
1020
2034
|
/**
|
|
1021
|
-
* Create a cache control breakpoint at this content block.
|
|
2035
|
+
* Create a cache control breakpoint at this content block.
|
|
2036
|
+
*/
|
|
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
|
+
}
|
|
2283
|
+
|
|
2284
|
+
/**
|
|
2285
|
+
* `key`'s config overrides.
|
|
2286
|
+
*/
|
|
2287
|
+
export interface BetaComputerKeyConfig {
|
|
2288
|
+
/**
|
|
2289
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2290
|
+
* member of the toolset.
|
|
2291
|
+
*/
|
|
2292
|
+
defer_loading?: boolean | null;
|
|
2293
|
+
|
|
2294
|
+
/**
|
|
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.
|
|
1022
2298
|
*/
|
|
1023
|
-
|
|
2299
|
+
enabled?: boolean | null;
|
|
2300
|
+
}
|
|
1024
2301
|
|
|
2302
|
+
/**
|
|
2303
|
+
* `left_click`'s config overrides.
|
|
2304
|
+
*/
|
|
2305
|
+
export interface BetaComputerLeftClickConfig {
|
|
1025
2306
|
/**
|
|
1026
|
-
*
|
|
1027
|
-
*
|
|
2307
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2308
|
+
* member of the toolset.
|
|
1028
2309
|
*/
|
|
1029
|
-
defer_loading?: boolean;
|
|
2310
|
+
defer_loading?: boolean | null;
|
|
1030
2311
|
|
|
1031
2312
|
/**
|
|
1032
|
-
*
|
|
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.
|
|
1033
2316
|
*/
|
|
1034
|
-
|
|
2317
|
+
enabled?: boolean | null;
|
|
1035
2318
|
}
|
|
1036
2319
|
|
|
1037
|
-
|
|
2320
|
+
/**
|
|
2321
|
+
* `left_click_drag`'s config overrides.
|
|
2322
|
+
*/
|
|
2323
|
+
export interface BetaComputerLeftClickDragConfig {
|
|
1038
2324
|
/**
|
|
1039
|
-
*
|
|
1040
|
-
*
|
|
1041
|
-
* This is how the tool will be called by the model and in `tool_use` blocks.
|
|
2325
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2326
|
+
* member of the toolset.
|
|
1042
2327
|
*/
|
|
1043
|
-
|
|
1044
|
-
|
|
1045
|
-
type: 'code_execution_20250825';
|
|
1046
|
-
|
|
1047
|
-
allowed_callers?: Array<
|
|
1048
|
-
'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
|
|
1049
|
-
>;
|
|
2328
|
+
defer_loading?: boolean | null;
|
|
1050
2329
|
|
|
1051
2330
|
/**
|
|
1052
|
-
*
|
|
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.
|
|
1053
2334
|
*/
|
|
1054
|
-
|
|
2335
|
+
enabled?: boolean | null;
|
|
2336
|
+
}
|
|
1055
2337
|
|
|
2338
|
+
/**
|
|
2339
|
+
* `left_mouse_down`'s config overrides.
|
|
2340
|
+
*/
|
|
2341
|
+
export interface BetaComputerLeftMouseDownConfig {
|
|
1056
2342
|
/**
|
|
1057
|
-
*
|
|
1058
|
-
*
|
|
2343
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2344
|
+
* member of the toolset.
|
|
1059
2345
|
*/
|
|
1060
|
-
defer_loading?: boolean;
|
|
2346
|
+
defer_loading?: boolean | null;
|
|
1061
2347
|
|
|
1062
2348
|
/**
|
|
1063
|
-
*
|
|
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.
|
|
1064
2352
|
*/
|
|
1065
|
-
|
|
2353
|
+
enabled?: boolean | null;
|
|
1066
2354
|
}
|
|
1067
2355
|
|
|
1068
2356
|
/**
|
|
1069
|
-
*
|
|
1070
|
-
* checkpoint).
|
|
2357
|
+
* `left_mouse_up`'s config overrides.
|
|
1071
2358
|
*/
|
|
1072
|
-
export interface
|
|
2359
|
+
export interface BetaComputerLeftMouseUpConfig {
|
|
1073
2360
|
/**
|
|
1074
|
-
*
|
|
1075
|
-
*
|
|
1076
|
-
* This is how the tool will be called by the model and in `tool_use` blocks.
|
|
2361
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2362
|
+
* member of the toolset.
|
|
1077
2363
|
*/
|
|
1078
|
-
|
|
1079
|
-
|
|
1080
|
-
type: 'code_execution_20260120';
|
|
1081
|
-
|
|
1082
|
-
allowed_callers?: Array<
|
|
1083
|
-
'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
|
|
1084
|
-
>;
|
|
2364
|
+
defer_loading?: boolean | null;
|
|
1085
2365
|
|
|
1086
2366
|
/**
|
|
1087
|
-
*
|
|
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.
|
|
1088
2370
|
*/
|
|
1089
|
-
|
|
2371
|
+
enabled?: boolean | null;
|
|
2372
|
+
}
|
|
1090
2373
|
|
|
2374
|
+
/**
|
|
2375
|
+
* `middle_click`'s config overrides.
|
|
2376
|
+
*/
|
|
2377
|
+
export interface BetaComputerMiddleClickConfig {
|
|
1091
2378
|
/**
|
|
1092
|
-
*
|
|
1093
|
-
*
|
|
2379
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2380
|
+
* member of the toolset.
|
|
1094
2381
|
*/
|
|
1095
|
-
defer_loading?: boolean;
|
|
2382
|
+
defer_loading?: boolean | null;
|
|
1096
2383
|
|
|
1097
2384
|
/**
|
|
1098
|
-
*
|
|
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.
|
|
1099
2388
|
*/
|
|
1100
|
-
|
|
2389
|
+
enabled?: boolean | null;
|
|
1101
2390
|
}
|
|
1102
2391
|
|
|
1103
2392
|
/**
|
|
1104
|
-
*
|
|
2393
|
+
* `mouse_move`'s config overrides.
|
|
1105
2394
|
*/
|
|
1106
|
-
export interface
|
|
2395
|
+
export interface BetaComputerMouseMoveConfig {
|
|
1107
2396
|
/**
|
|
1108
|
-
*
|
|
1109
|
-
*
|
|
1110
|
-
* This is how the tool will be called by the model and in `tool_use` blocks.
|
|
2397
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2398
|
+
* member of the toolset.
|
|
1111
2399
|
*/
|
|
1112
|
-
|
|
1113
|
-
|
|
1114
|
-
type: 'code_execution_20260521';
|
|
1115
|
-
|
|
1116
|
-
allowed_callers?: Array<
|
|
1117
|
-
'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
|
|
1118
|
-
>;
|
|
2400
|
+
defer_loading?: boolean | null;
|
|
1119
2401
|
|
|
1120
2402
|
/**
|
|
1121
|
-
*
|
|
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
|
-
|
|
2407
|
+
enabled?: boolean | null;
|
|
2408
|
+
}
|
|
1124
2409
|
|
|
2410
|
+
/**
|
|
2411
|
+
* `right_click`'s config overrides.
|
|
2412
|
+
*/
|
|
2413
|
+
export interface BetaComputerRightClickConfig {
|
|
1125
2414
|
/**
|
|
1126
|
-
*
|
|
1127
|
-
*
|
|
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
|
-
*
|
|
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
|
-
|
|
2425
|
+
enabled?: boolean | null;
|
|
1135
2426
|
}
|
|
1136
2427
|
|
|
1137
|
-
|
|
2428
|
+
/**
|
|
2429
|
+
* `screenshot`'s config overrides.
|
|
2430
|
+
*/
|
|
2431
|
+
export interface BetaComputerScreenshotConfig {
|
|
1138
2432
|
/**
|
|
1139
|
-
*
|
|
2433
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2434
|
+
* member of the toolset.
|
|
1140
2435
|
*/
|
|
1141
|
-
|
|
1142
|
-
|
|
1143
|
-
tool_use_id: string;
|
|
2436
|
+
defer_loading?: boolean | null;
|
|
1144
2437
|
|
|
1145
|
-
|
|
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
|
-
*
|
|
2447
|
+
* `scroll`'s config overrides.
|
|
1150
2448
|
*/
|
|
1151
|
-
export
|
|
1152
|
-
|
|
1153
|
-
|
|
1154
|
-
|
|
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
|
-
*
|
|
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
|
-
|
|
2461
|
+
enabled?: boolean | null;
|
|
2462
|
+
}
|
|
1161
2463
|
|
|
1162
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
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
|
|
1176
|
-
|
|
1177
|
-
|
|
1178
|
-
|
|
2501
|
+
export interface BetaComputerToolsetConfigs {
|
|
2502
|
+
/**
|
|
2503
|
+
* `cursor_position`'s config overrides.
|
|
2504
|
+
*/
|
|
2505
|
+
cursor_position?: BetaComputerCursorPositionConfig | null;
|
|
1179
2506
|
|
|
1180
|
-
|
|
1181
|
-
|
|
2507
|
+
/**
|
|
2508
|
+
* `double_click`'s config overrides.
|
|
2509
|
+
*/
|
|
2510
|
+
double_click?: BetaComputerDoubleClickConfig | null;
|
|
1182
2511
|
|
|
1183
|
-
|
|
1184
|
-
|
|
2512
|
+
/**
|
|
2513
|
+
* `hold_key`'s config overrides.
|
|
2514
|
+
*/
|
|
2515
|
+
hold_key?: BetaComputerHoldKeyConfig | null;
|
|
1185
2516
|
|
|
1186
|
-
|
|
1187
|
-
|
|
1188
|
-
|
|
1189
|
-
|
|
|
1190
|
-
| 'execution_time_exceeded';
|
|
2517
|
+
/**
|
|
2518
|
+
* `key`'s config overrides.
|
|
2519
|
+
*/
|
|
2520
|
+
key?: BetaComputerKeyConfig | null;
|
|
1191
2521
|
|
|
1192
|
-
|
|
1193
|
-
|
|
2522
|
+
/**
|
|
2523
|
+
* `left_click`'s config overrides.
|
|
2524
|
+
*/
|
|
2525
|
+
left_click?: BetaComputerLeftClickConfig | null;
|
|
1194
2526
|
|
|
1195
|
-
|
|
1196
|
-
|
|
2527
|
+
/**
|
|
2528
|
+
* `left_click_drag`'s config overrides.
|
|
2529
|
+
*/
|
|
2530
|
+
left_click_drag?: BetaComputerLeftClickDragConfig | null;
|
|
1197
2531
|
|
|
1198
|
-
/**
|
|
1199
|
-
|
|
1200
|
-
|
|
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
|
-
*
|
|
2538
|
+
* `left_mouse_up`'s config overrides.
|
|
1207
2539
|
*/
|
|
1208
|
-
|
|
2540
|
+
left_mouse_up?: BetaComputerLeftMouseUpConfig | null;
|
|
1209
2541
|
|
|
1210
2542
|
/**
|
|
1211
|
-
*
|
|
2543
|
+
* `middle_click`'s config overrides.
|
|
1212
2544
|
*/
|
|
1213
|
-
|
|
2545
|
+
middle_click?: BetaComputerMiddleClickConfig | null;
|
|
1214
2546
|
|
|
1215
2547
|
/**
|
|
1216
|
-
*
|
|
2548
|
+
* `mouse_move`'s config overrides.
|
|
1217
2549
|
*/
|
|
1218
|
-
|
|
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
|
-
*
|
|
2553
|
+
* `right_click`'s config overrides.
|
|
1231
2554
|
*/
|
|
1232
|
-
|
|
2555
|
+
right_click?: BetaComputerRightClickConfig | null;
|
|
1233
2556
|
|
|
1234
2557
|
/**
|
|
1235
|
-
*
|
|
2558
|
+
* `screenshot`'s config overrides.
|
|
1236
2559
|
*/
|
|
1237
|
-
|
|
2560
|
+
screenshot?: BetaComputerScreenshotConfig | null;
|
|
1238
2561
|
|
|
1239
|
-
|
|
1240
|
-
|
|
2562
|
+
/**
|
|
2563
|
+
* `scroll`'s config overrides.
|
|
2564
|
+
*/
|
|
2565
|
+
scroll?: BetaComputerScrollConfig | null;
|
|
1241
2566
|
|
|
1242
|
-
/**
|
|
1243
|
-
|
|
1244
|
-
|
|
1245
|
-
|
|
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
|
-
*
|
|
2573
|
+
* `type`'s config overrides.
|
|
1256
2574
|
*/
|
|
1257
|
-
|
|
2575
|
+
type?: BetaComputerTypeConfig | null;
|
|
1258
2576
|
|
|
1259
2577
|
/**
|
|
1260
|
-
*
|
|
2578
|
+
* `wait`'s config overrides.
|
|
1261
2579
|
*/
|
|
1262
|
-
|
|
2580
|
+
wait?: BetaComputerWaitConfig | null;
|
|
1263
2581
|
|
|
1264
2582
|
/**
|
|
1265
|
-
*
|
|
2583
|
+
* `zoom`'s config overrides.
|
|
1266
2584
|
*/
|
|
1267
|
-
|
|
2585
|
+
zoom?: BetaComputerZoomConfig | null;
|
|
1268
2586
|
}
|
|
1269
2587
|
|
|
1270
|
-
|
|
1271
|
-
|
|
1272
|
-
|
|
2588
|
+
/**
|
|
2589
|
+
* `triple_click`'s config overrides.
|
|
2590
|
+
*/
|
|
2591
|
+
export interface BetaComputerTripleClickConfig {
|
|
1273
2592
|
/**
|
|
1274
|
-
*
|
|
2593
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2594
|
+
* member of the toolset.
|
|
1275
2595
|
*/
|
|
1276
|
-
|
|
2596
|
+
defer_loading?: boolean | null;
|
|
1277
2597
|
|
|
1278
|
-
|
|
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
|
-
*
|
|
2607
|
+
* `type`'s config overrides.
|
|
1283
2608
|
*/
|
|
1284
|
-
export interface
|
|
2609
|
+
export interface BetaComputerTypeConfig {
|
|
1285
2610
|
/**
|
|
1286
|
-
*
|
|
2611
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2612
|
+
* member of the toolset.
|
|
1287
2613
|
*/
|
|
1288
|
-
|
|
2614
|
+
defer_loading?: boolean | null;
|
|
1289
2615
|
|
|
1290
2616
|
/**
|
|
1291
|
-
*
|
|
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
|
-
|
|
2621
|
+
enabled?: boolean | null;
|
|
2622
|
+
}
|
|
1294
2623
|
|
|
2624
|
+
/**
|
|
2625
|
+
* `wait`'s config overrides.
|
|
2626
|
+
*/
|
|
2627
|
+
export interface BetaComputerWaitConfig {
|
|
1295
2628
|
/**
|
|
1296
|
-
*
|
|
2629
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2630
|
+
* member of the toolset.
|
|
1297
2631
|
*/
|
|
1298
|
-
|
|
2632
|
+
defer_loading?: boolean | null;
|
|
1299
2633
|
|
|
1300
2634
|
/**
|
|
1301
|
-
*
|
|
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
|
-
|
|
2639
|
+
enabled?: boolean | null;
|
|
2640
|
+
}
|
|
1304
2641
|
|
|
2642
|
+
/**
|
|
2643
|
+
* `zoom`'s config overrides.
|
|
2644
|
+
*/
|
|
2645
|
+
export interface BetaComputerZoomConfig {
|
|
1305
2646
|
/**
|
|
1306
|
-
*
|
|
2647
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2648
|
+
* member of the toolset.
|
|
1307
2649
|
*/
|
|
1308
|
-
|
|
2650
|
+
defer_loading?: boolean | null;
|
|
1309
2651
|
|
|
1310
2652
|
/**
|
|
1311
|
-
*
|
|
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
|
-
|
|
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 {
|
|
@@ -2910,7 +4280,7 @@ export interface BetaSkill {
|
|
|
2910
4280
|
type: 'anthropic' | 'custom';
|
|
2911
4281
|
|
|
2912
4282
|
/**
|
|
2913
|
-
*
|
|
4283
|
+
* The resolved version: a skill version ID for custom skills.
|
|
2914
4284
|
*/
|
|
2915
4285
|
version: string;
|
|
2916
4286
|
}
|
|
@@ -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,
|