@anthropic-ai/sdk 0.117.1 → 0.119.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (277) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/client.d.mts +8 -2
  3. package/client.d.mts.map +1 -1
  4. package/client.d.ts +8 -2
  5. package/client.d.ts.map +1 -1
  6. package/client.js +7 -1
  7. package/client.js.map +1 -1
  8. package/client.mjs +7 -1
  9. package/client.mjs.map +1 -1
  10. package/core/api-promise.d.mts +1 -0
  11. package/core/api-promise.d.mts.map +1 -1
  12. package/core/api-promise.d.ts +1 -0
  13. package/core/api-promise.d.ts.map +1 -1
  14. package/core/api-promise.js +7 -2
  15. package/core/api-promise.js.map +1 -1
  16. package/core/api-promise.mjs +8 -3
  17. package/core/api-promise.mjs.map +1 -1
  18. package/core/error.d.mts +1 -0
  19. package/core/error.d.mts.map +1 -1
  20. package/core/error.d.ts +1 -0
  21. package/core/error.d.ts.map +1 -1
  22. package/core/error.js +1 -0
  23. package/core/error.js.map +1 -1
  24. package/core/error.mjs +1 -0
  25. package/core/error.mjs.map +1 -1
  26. package/core/middleware.js +1 -1
  27. package/core/middleware.js.map +1 -1
  28. package/core/middleware.mjs +2 -2
  29. package/core/middleware.mjs.map +1 -1
  30. package/helpers/beta/zod.d.mts.map +1 -1
  31. package/helpers/beta/zod.d.ts.map +1 -1
  32. package/helpers/beta/zod.js +1 -2
  33. package/helpers/beta/zod.js.map +1 -1
  34. package/helpers/beta/zod.mjs +1 -2
  35. package/helpers/beta/zod.mjs.map +1 -1
  36. package/helpers/zod.d.mts.map +1 -1
  37. package/helpers/zod.d.ts.map +1 -1
  38. package/helpers/zod.js +1 -2
  39. package/helpers/zod.js.map +1 -1
  40. package/helpers/zod.mjs +1 -2
  41. package/helpers/zod.mjs.map +1 -1
  42. package/internal/parse.d.mts +2 -1
  43. package/internal/parse.d.mts.map +1 -1
  44. package/internal/parse.d.ts +2 -1
  45. package/internal/parse.d.ts.map +1 -1
  46. package/internal/parse.js +6 -6
  47. package/internal/parse.js.map +1 -1
  48. package/internal/parse.mjs +5 -5
  49. package/internal/parse.mjs.map +1 -1
  50. package/lib/BetaMessageStream.d.mts +2 -0
  51. package/lib/BetaMessageStream.d.mts.map +1 -1
  52. package/lib/BetaMessageStream.d.ts +2 -0
  53. package/lib/BetaMessageStream.d.ts.map +1 -1
  54. package/lib/BetaMessageStream.js +8 -2
  55. package/lib/BetaMessageStream.js.map +1 -1
  56. package/lib/BetaMessageStream.mjs +8 -2
  57. package/lib/BetaMessageStream.mjs.map +1 -1
  58. package/lib/MessageStream.d.mts +2 -0
  59. package/lib/MessageStream.d.mts.map +1 -1
  60. package/lib/MessageStream.d.ts +2 -0
  61. package/lib/MessageStream.d.ts.map +1 -1
  62. package/lib/MessageStream.js +8 -2
  63. package/lib/MessageStream.js.map +1 -1
  64. package/lib/MessageStream.mjs +8 -2
  65. package/lib/MessageStream.mjs.map +1 -1
  66. package/lib/environments/worker.d.mts +10 -6
  67. package/lib/environments/worker.d.mts.map +1 -1
  68. package/lib/environments/worker.d.ts +10 -6
  69. package/lib/environments/worker.d.ts.map +1 -1
  70. package/lib/environments/worker.js +22 -15
  71. package/lib/environments/worker.js.map +1 -1
  72. package/lib/environments/worker.mjs +22 -15
  73. package/lib/environments/worker.mjs.map +1 -1
  74. package/lib/tools/BetaRunnableTool.d.mts +21 -40
  75. package/lib/tools/BetaRunnableTool.d.mts.map +1 -1
  76. package/lib/tools/BetaRunnableTool.d.ts +21 -40
  77. package/lib/tools/BetaRunnableTool.d.ts.map +1 -1
  78. package/lib/tools/BetaRunnableTool.js +7 -16
  79. package/lib/tools/BetaRunnableTool.js.map +1 -1
  80. package/lib/tools/BetaRunnableTool.mjs +7 -16
  81. package/lib/tools/BetaRunnableTool.mjs.map +1 -1
  82. package/lib/tools/BetaToolRunner.d.mts.map +1 -1
  83. package/lib/tools/BetaToolRunner.d.ts.map +1 -1
  84. package/lib/tools/BetaToolRunner.js +3 -13
  85. package/lib/tools/BetaToolRunner.js.map +1 -1
  86. package/lib/tools/BetaToolRunner.mjs +3 -13
  87. package/lib/tools/BetaToolRunner.mjs.map +1 -1
  88. package/lib/tools/SessionToolRunner.d.mts +6 -0
  89. package/lib/tools/SessionToolRunner.d.mts.map +1 -1
  90. package/lib/tools/SessionToolRunner.d.ts +6 -0
  91. package/lib/tools/SessionToolRunner.d.ts.map +1 -1
  92. package/lib/tools/SessionToolRunner.js +37 -8
  93. package/lib/tools/SessionToolRunner.js.map +1 -1
  94. package/lib/tools/SessionToolRunner.mjs +38 -9
  95. package/lib/tools/SessionToolRunner.mjs.map +1 -1
  96. package/package.json +1 -1
  97. package/resources/beta/agents/agents.d.mts +3 -3
  98. package/resources/beta/agents/agents.d.ts +3 -3
  99. package/resources/beta/agents/agents.js +1 -1
  100. package/resources/beta/agents/agents.mjs +1 -1
  101. package/resources/beta/beta.d.mts +5 -5
  102. package/resources/beta/beta.d.mts.map +1 -1
  103. package/resources/beta/beta.d.ts +5 -5
  104. package/resources/beta/beta.d.ts.map +1 -1
  105. package/resources/beta/beta.js.map +1 -1
  106. package/resources/beta/beta.mjs.map +1 -1
  107. package/resources/beta/dreams.d.mts +2 -2
  108. package/resources/beta/dreams.d.ts +2 -2
  109. package/resources/beta/environments/environments.d.mts +4 -3
  110. package/resources/beta/environments/environments.d.mts.map +1 -1
  111. package/resources/beta/environments/environments.d.ts +4 -3
  112. package/resources/beta/environments/environments.d.ts.map +1 -1
  113. package/resources/beta/environments/environments.js.map +1 -1
  114. package/resources/beta/environments/environments.mjs.map +1 -1
  115. package/resources/beta/files.d.mts +22 -22
  116. package/resources/beta/files.d.mts.map +1 -1
  117. package/resources/beta/files.d.ts +22 -22
  118. package/resources/beta/files.d.ts.map +1 -1
  119. package/resources/beta/files.js +4 -4
  120. package/resources/beta/files.js.map +1 -1
  121. package/resources/beta/files.mjs +4 -4
  122. package/resources/beta/files.mjs.map +1 -1
  123. package/resources/beta/index.d.mts +2 -2
  124. package/resources/beta/index.d.mts.map +1 -1
  125. package/resources/beta/index.d.ts +2 -2
  126. package/resources/beta/index.d.ts.map +1 -1
  127. package/resources/beta/index.js.map +1 -1
  128. package/resources/beta/index.mjs.map +1 -1
  129. package/resources/beta/memory-stores/index.d.mts +1 -1
  130. package/resources/beta/memory-stores/index.d.mts.map +1 -1
  131. package/resources/beta/memory-stores/index.d.ts +1 -1
  132. package/resources/beta/memory-stores/index.d.ts.map +1 -1
  133. package/resources/beta/memory-stores/index.js.map +1 -1
  134. package/resources/beta/memory-stores/index.mjs.map +1 -1
  135. package/resources/beta/memory-stores/memory-stores.d.mts +2 -2
  136. package/resources/beta/memory-stores/memory-stores.d.mts.map +1 -1
  137. package/resources/beta/memory-stores/memory-stores.d.ts +2 -2
  138. package/resources/beta/memory-stores/memory-stores.d.ts.map +1 -1
  139. package/resources/beta/memory-stores/memory-stores.js.map +1 -1
  140. package/resources/beta/memory-stores/memory-stores.mjs.map +1 -1
  141. package/resources/beta/memory-stores/memory-versions.d.mts +17 -2
  142. package/resources/beta/memory-stores/memory-versions.d.mts.map +1 -1
  143. package/resources/beta/memory-stores/memory-versions.d.ts +17 -2
  144. package/resources/beta/memory-stores/memory-versions.d.ts.map +1 -1
  145. package/resources/beta/messages/batches.d.mts +1 -1
  146. package/resources/beta/messages/batches.d.ts +1 -1
  147. package/resources/beta/messages/batches.js +1 -1
  148. package/resources/beta/messages/batches.mjs +1 -1
  149. package/resources/beta/messages/index.d.mts +1 -1
  150. package/resources/beta/messages/index.d.mts.map +1 -1
  151. package/resources/beta/messages/index.d.ts +1 -1
  152. package/resources/beta/messages/index.d.ts.map +1 -1
  153. package/resources/beta/messages/index.js.map +1 -1
  154. package/resources/beta/messages/index.mjs.map +1 -1
  155. package/resources/beta/messages/messages.d.mts +1204 -25
  156. package/resources/beta/messages/messages.d.mts.map +1 -1
  157. package/resources/beta/messages/messages.d.ts +1204 -25
  158. package/resources/beta/messages/messages.d.ts.map +1 -1
  159. package/resources/beta/messages/messages.js +1 -1
  160. package/resources/beta/messages/messages.js.map +1 -1
  161. package/resources/beta/messages/messages.mjs +1 -1
  162. package/resources/beta/messages/messages.mjs.map +1 -1
  163. package/resources/beta/sessions/sessions.d.mts +1 -1
  164. package/resources/beta/sessions/sessions.d.ts +1 -1
  165. package/resources/beta/user-profiles.d.mts +35 -9
  166. package/resources/beta/user-profiles.d.mts.map +1 -1
  167. package/resources/beta/user-profiles.d.ts +35 -9
  168. package/resources/beta/user-profiles.d.ts.map +1 -1
  169. package/resources/beta/user-profiles.js +5 -5
  170. package/resources/beta/user-profiles.mjs +5 -5
  171. package/resources/files.d.mts +105 -0
  172. package/resources/files.d.mts.map +1 -0
  173. package/resources/files.d.ts +105 -0
  174. package/resources/files.d.ts.map +1 -0
  175. package/resources/files.js +52 -0
  176. package/resources/files.js.map +1 -0
  177. package/resources/files.mjs +48 -0
  178. package/resources/files.mjs.map +1 -0
  179. package/resources/index.d.mts +3 -1
  180. package/resources/index.d.mts.map +1 -1
  181. package/resources/index.d.ts +3 -1
  182. package/resources/index.d.ts.map +1 -1
  183. package/resources/index.js +5 -1
  184. package/resources/index.js.map +1 -1
  185. package/resources/index.mjs +2 -0
  186. package/resources/index.mjs.map +1 -1
  187. package/resources/messages/batches.d.mts +1 -1
  188. package/resources/messages/batches.d.ts +1 -1
  189. package/resources/messages/batches.js +1 -1
  190. package/resources/messages/batches.mjs +1 -1
  191. package/resources/messages/index.d.mts +1 -1
  192. package/resources/messages/index.d.mts.map +1 -1
  193. package/resources/messages/index.d.ts +1 -1
  194. package/resources/messages/index.d.ts.map +1 -1
  195. package/resources/messages/index.js.map +1 -1
  196. package/resources/messages/index.mjs.map +1 -1
  197. package/resources/messages/messages.d.mts +1270 -28
  198. package/resources/messages/messages.d.mts.map +1 -1
  199. package/resources/messages/messages.d.ts +1270 -28
  200. package/resources/messages/messages.d.ts.map +1 -1
  201. package/resources/messages/messages.js +1 -1
  202. package/resources/messages/messages.js.map +1 -1
  203. package/resources/messages/messages.mjs +1 -1
  204. package/resources/messages/messages.mjs.map +1 -1
  205. package/resources/skills/index.d.mts +3 -0
  206. package/resources/skills/index.d.mts.map +1 -0
  207. package/resources/skills/index.d.ts +3 -0
  208. package/resources/skills/index.d.ts.map +1 -0
  209. package/resources/skills/index.js +9 -0
  210. package/resources/skills/index.js.map +1 -0
  211. package/resources/skills/index.mjs +4 -0
  212. package/resources/skills/index.mjs.map +1 -0
  213. package/resources/skills/skills.d.mts +129 -0
  214. package/resources/skills/skills.d.mts.map +1 -0
  215. package/resources/skills/skills.d.ts +129 -0
  216. package/resources/skills/skills.d.ts.map +1 -0
  217. package/resources/skills/skills.js +44 -0
  218. package/resources/skills/skills.js.map +1 -0
  219. package/resources/skills/skills.mjs +39 -0
  220. package/resources/skills/skills.mjs.map +1 -0
  221. package/resources/skills/versions.d.mts +104 -0
  222. package/resources/skills/versions.d.mts.map +1 -0
  223. package/resources/skills/versions.d.ts +104 -0
  224. package/resources/skills/versions.d.ts.map +1 -0
  225. package/resources/skills/versions.js +41 -0
  226. package/resources/skills/versions.js.map +1 -0
  227. package/resources/skills/versions.mjs +37 -0
  228. package/resources/skills/versions.mjs.map +1 -0
  229. package/resources/skills.d.mts +2 -0
  230. package/resources/skills.d.mts.map +1 -0
  231. package/resources/skills.d.ts +2 -0
  232. package/resources/skills.d.ts.map +1 -0
  233. package/resources/skills.js +6 -0
  234. package/resources/skills.js.map +1 -0
  235. package/resources/skills.mjs +3 -0
  236. package/resources/skills.mjs.map +1 -0
  237. package/src/client.ts +173 -3
  238. package/src/core/api-promise.ts +14 -4
  239. package/src/core/error.ts +2 -0
  240. package/src/core/middleware.ts +2 -2
  241. package/src/helpers/beta/zod.ts +1 -3
  242. package/src/helpers/zod.ts +1 -3
  243. package/src/internal/parse.ts +6 -6
  244. package/src/lib/BetaMessageStream.ts +8 -0
  245. package/src/lib/MessageStream.ts +8 -0
  246. package/src/lib/environments/worker.ts +28 -14
  247. package/src/lib/tools/BetaRunnableTool.ts +26 -43
  248. package/src/lib/tools/BetaToolRunner.ts +6 -13
  249. package/src/lib/tools/SessionToolRunner.ts +39 -6
  250. package/src/resources/beta/agents/agents.ts +3 -3
  251. package/src/resources/beta/beta.ts +127 -8
  252. package/src/resources/beta/dreams.ts +2 -2
  253. package/src/resources/beta/environments/environments.ts +4 -3
  254. package/src/resources/beta/files.ts +27 -27
  255. package/src/resources/beta/index.ts +63 -4
  256. package/src/resources/beta/memory-stores/index.ts +1 -0
  257. package/src/resources/beta/memory-stores/memory-stores.ts +2 -0
  258. package/src/resources/beta/memory-stores/memory-versions.ts +21 -1
  259. package/src/resources/beta/messages/batches.ts +1 -1
  260. package/src/resources/beta/messages/index.ts +60 -1
  261. package/src/resources/beta/messages/messages.ts +1862 -435
  262. package/src/resources/beta/sessions/sessions.ts +1 -1
  263. package/src/resources/beta/user-profiles.ts +44 -15
  264. package/src/resources/files.ts +163 -0
  265. package/src/resources/index.ts +83 -1
  266. package/src/resources/messages/batches.ts +1 -1
  267. package/src/resources/messages/index.ts +66 -1
  268. package/src/resources/messages/messages.ts +1830 -320
  269. package/src/resources/skills/index.ts +21 -0
  270. package/src/resources/skills/skills.ts +194 -0
  271. package/src/resources/skills/versions.ts +160 -0
  272. package/src/resources/skills.ts +3 -0
  273. package/src/version.ts +1 -1
  274. package/version.d.mts +1 -1
  275. package/version.d.ts +1 -1
  276. package/version.js +1 -1
  277. package/version.mjs +1 -1
@@ -51,7 +51,7 @@ export class Messages extends APIResource {
51
51
  * const message = await client.messages.create({
52
52
  * max_tokens: 1024,
53
53
  * messages: [{ content: 'Hello, world', role: 'user' }],
54
- * model: 'claude-opus-4-6',
54
+ * model: 'claude-opus-5',
55
55
  * });
56
56
  * ```
57
57
  */
@@ -181,7 +181,7 @@ export class Messages extends APIResource {
181
181
  * const messageTokensCount =
182
182
  * await client.messages.countTokens({
183
183
  * messages: [{ content: 'Hello, world', role: 'user' }],
184
- * model: 'claude-opus-4-6',
184
+ * model: 'claude-opus-5',
185
185
  * });
186
186
  * ```
187
187
  */
@@ -290,365 +290,1675 @@ export interface BashCodeExecutionToolResultErrorParam {
290
290
  type: 'bash_code_execution_tool_result_error';
291
291
  }
292
292
 
293
- export interface CacheControlEphemeral {
294
- type: 'ephemeral';
293
+ /**
294
+ * `close_tab`'s config overrides.
295
+ */
296
+ export interface BrowserCloseTabConfig {
297
+ /**
298
+ * Defer loading for this member. Must resolve to the same value on every enabled
299
+ * member of the toolset.
300
+ */
301
+ defer_loading?: boolean | null;
295
302
 
296
303
  /**
297
- * The time-to-live for the cache control breakpoint.
298
- *
299
- * This may be one the following values:
300
- *
301
- * - `5m`: 5 minutes
302
- * - `1h`: 1 hour
303
- *
304
- * Defaults to `5m`. See
305
- * [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
306
- * for details.
304
+ * Whether this member is offered to the model. Default is per member, per the
305
+ * toolset's documentation. A member whose enabled resolves false is withheld from
306
+ * the served schema.
307
307
  */
308
- ttl?: '5m' | '1h';
308
+ enabled?: boolean | null;
309
309
  }
310
310
 
311
- export interface CacheCreation {
311
+ /**
312
+ * `double_click`'s config overrides.
313
+ */
314
+ export interface BrowserDoubleClickConfig {
312
315
  /**
313
- * The number of input tokens used to create the 1 hour cache entry.
316
+ * Defer loading for this member. Must resolve to the same value on every enabled
317
+ * member of the toolset.
314
318
  */
315
- ephemeral_1h_input_tokens: number;
319
+ defer_loading?: boolean | null;
316
320
 
317
321
  /**
318
- * The number of input tokens used to create the 5 minute cache entry.
322
+ * Whether this member is offered to the model. Default is per member, per the
323
+ * toolset's documentation. A member whose enabled resolves false is withheld from
324
+ * the served schema.
319
325
  */
320
- ephemeral_5m_input_tokens: number;
326
+ enabled?: boolean | null;
321
327
  }
322
328
 
323
- export interface CitationCharLocation {
324
- cited_text: string;
325
-
326
- document_index: number;
329
+ /**
330
+ * `file_upload`'s config overrides.
331
+ */
332
+ export interface BrowserFileUploadConfig {
333
+ /**
334
+ * Defer loading for this member. Must resolve to the same value on every enabled
335
+ * member of the toolset.
336
+ */
337
+ defer_loading?: boolean | null;
327
338
 
328
- document_title: string | null;
339
+ /**
340
+ * Whether this member is offered to the model. Default is per member, per the
341
+ * toolset's documentation. A member whose enabled resolves false is withheld from
342
+ * the served schema.
343
+ */
344
+ enabled?: boolean | null;
345
+ }
329
346
 
330
- end_char_index: number;
347
+ /**
348
+ * `find`'s config overrides.
349
+ */
350
+ export interface BrowserFindConfig {
351
+ /**
352
+ * Defer loading for this member. Must resolve to the same value on every enabled
353
+ * member of the toolset.
354
+ */
355
+ defer_loading?: boolean | null;
331
356
 
332
- file_id: string | null;
357
+ /**
358
+ * Whether this member is offered to the model. Default is per member, per the
359
+ * toolset's documentation. A member whose enabled resolves false is withheld from
360
+ * the served schema.
361
+ */
362
+ enabled?: boolean | null;
363
+ }
333
364
 
334
- start_char_index: number;
365
+ /**
366
+ * `form_input`'s config overrides.
367
+ */
368
+ export interface BrowserFormInputConfig {
369
+ /**
370
+ * Defer loading for this member. Must resolve to the same value on every enabled
371
+ * member of the toolset.
372
+ */
373
+ defer_loading?: boolean | null;
335
374
 
336
- type: 'char_location';
375
+ /**
376
+ * Whether this member is offered to the model. Default is per member, per the
377
+ * toolset's documentation. A member whose enabled resolves false is withheld from
378
+ * the served schema.
379
+ */
380
+ enabled?: boolean | null;
337
381
  }
338
382
 
339
- export interface CitationCharLocationParam {
340
- cited_text: string;
383
+ /**
384
+ * `get_page_text`'s config overrides.
385
+ */
386
+ export interface BrowserGetPageTextConfig {
387
+ /**
388
+ * Defer loading for this member. Must resolve to the same value on every enabled
389
+ * member of the toolset.
390
+ */
391
+ defer_loading?: boolean | null;
341
392
 
342
- document_index: number;
393
+ /**
394
+ * Whether this member is offered to the model. Default is per member, per the
395
+ * toolset's documentation. A member whose enabled resolves false is withheld from
396
+ * the served schema.
397
+ */
398
+ enabled?: boolean | null;
399
+ }
343
400
 
344
- document_title: string | null;
401
+ /**
402
+ * `hold_key`'s config overrides.
403
+ */
404
+ export interface BrowserHoldKeyConfig {
405
+ /**
406
+ * Defer loading for this member. Must resolve to the same value on every enabled
407
+ * member of the toolset.
408
+ */
409
+ defer_loading?: boolean | null;
345
410
 
346
- end_char_index: number;
411
+ /**
412
+ * Whether this member is offered to the model. Default is per member, per the
413
+ * toolset's documentation. A member whose enabled resolves false is withheld from
414
+ * the served schema.
415
+ */
416
+ enabled?: boolean | null;
417
+ }
347
418
 
348
- start_char_index: number;
419
+ /**
420
+ * `hover`'s config overrides.
421
+ */
422
+ export interface BrowserHoverConfig {
423
+ /**
424
+ * Defer loading for this member. Must resolve to the same value on every enabled
425
+ * member of the toolset.
426
+ */
427
+ defer_loading?: boolean | null;
349
428
 
350
- type: 'char_location';
429
+ /**
430
+ * Whether this member is offered to the model. Default is per member, per the
431
+ * toolset's documentation. A member whose enabled resolves false is withheld from
432
+ * the served schema.
433
+ */
434
+ enabled?: boolean | null;
351
435
  }
352
436
 
353
- export interface CitationContentBlockLocation {
437
+ /**
438
+ * `javascript_exec`'s config overrides.
439
+ */
440
+ export interface BrowserJavascriptExecConfig {
354
441
  /**
355
- * The full text of the cited block range, concatenated.
356
- *
357
- * Always equals the contents of `content[start_block_index:end_block_index]`
358
- * joined together. The text block is the minimal citable unit; this field is never
359
- * a substring of a single block. Not counted toward output tokens, and not counted
360
- * toward input tokens when sent back in subsequent turns.
442
+ * Defer loading for this member. Must resolve to the same value on every enabled
443
+ * member of the toolset.
361
444
  */
362
- cited_text: string;
363
-
364
- document_index: number;
445
+ defer_loading?: boolean | null;
365
446
 
366
- document_title: string | null;
447
+ /**
448
+ * Whether this member is offered to the model. Default is per member, per the
449
+ * toolset's documentation. A member whose enabled resolves false is withheld from
450
+ * the served schema.
451
+ */
452
+ enabled?: boolean | null;
453
+ }
367
454
 
455
+ /**
456
+ * `key`'s config overrides.
457
+ */
458
+ export interface BrowserKeyConfig {
368
459
  /**
369
- * Exclusive 0-based end index of the cited block range in the source's `content`
370
- * array.
371
- *
372
- * Always greater than `start_block_index`; a single-block citation has
373
- * `end_block_index = start_block_index + 1`.
460
+ * Defer loading for this member. Must resolve to the same value on every enabled
461
+ * member of the toolset.
374
462
  */
375
- end_block_index: number;
463
+ defer_loading?: boolean | null;
376
464
 
377
- file_id: string | null;
465
+ /**
466
+ * Whether this member is offered to the model. Default is per member, per the
467
+ * toolset's documentation. A member whose enabled resolves false is withheld from
468
+ * the served schema.
469
+ */
470
+ enabled?: boolean | null;
471
+ }
378
472
 
473
+ /**
474
+ * `left_click`'s config overrides.
475
+ */
476
+ export interface BrowserLeftClickConfig {
379
477
  /**
380
- * 0-based index of the first cited block in the source's `content` array.
478
+ * Defer loading for this member. Must resolve to the same value on every enabled
479
+ * member of the toolset.
381
480
  */
382
- start_block_index: number;
481
+ defer_loading?: boolean | null;
383
482
 
384
- type: 'content_block_location';
483
+ /**
484
+ * Whether this member is offered to the model. Default is per member, per the
485
+ * toolset's documentation. A member whose enabled resolves false is withheld from
486
+ * the served schema.
487
+ */
488
+ enabled?: boolean | null;
385
489
  }
386
490
 
387
- export interface CitationContentBlockLocationParam {
491
+ /**
492
+ * `left_click_drag`'s config overrides.
493
+ */
494
+ export interface BrowserLeftClickDragConfig {
388
495
  /**
389
- * The full text of the cited block range, concatenated.
390
- *
391
- * Always equals the contents of `content[start_block_index:end_block_index]`
392
- * joined together. The text block is the minimal citable unit; this field is never
393
- * a substring of a single block. Not counted toward output tokens, and not counted
394
- * toward input tokens when sent back in subsequent turns.
496
+ * Defer loading for this member. Must resolve to the same value on every enabled
497
+ * member of the toolset.
395
498
  */
396
- cited_text: string;
499
+ defer_loading?: boolean | null;
397
500
 
398
- document_index: number;
501
+ /**
502
+ * Whether this member is offered to the model. Default is per member, per the
503
+ * toolset's documentation. A member whose enabled resolves false is withheld from
504
+ * the served schema.
505
+ */
506
+ enabled?: boolean | null;
507
+ }
399
508
 
400
- document_title: string | null;
509
+ /**
510
+ * `left_mouse_down`'s config overrides.
511
+ */
512
+ export interface BrowserLeftMouseDownConfig {
513
+ /**
514
+ * Defer loading for this member. Must resolve to the same value on every enabled
515
+ * member of the toolset.
516
+ */
517
+ defer_loading?: boolean | null;
401
518
 
402
519
  /**
403
- * Exclusive 0-based end index of the cited block range in the source's `content`
404
- * array.
405
- *
406
- * Always greater than `start_block_index`; a single-block citation has
407
- * `end_block_index = start_block_index + 1`.
520
+ * Whether this member is offered to the model. Default is per member, per the
521
+ * toolset's documentation. A member whose enabled resolves false is withheld from
522
+ * the served schema.
408
523
  */
409
- end_block_index: number;
524
+ enabled?: boolean | null;
525
+ }
410
526
 
527
+ /**
528
+ * `left_mouse_up`'s config overrides.
529
+ */
530
+ export interface BrowserLeftMouseUpConfig {
411
531
  /**
412
- * 0-based index of the first cited block in the source's `content` array.
532
+ * Defer loading for this member. Must resolve to the same value on every enabled
533
+ * member of the toolset.
413
534
  */
414
- start_block_index: number;
535
+ defer_loading?: boolean | null;
415
536
 
416
- type: 'content_block_location';
537
+ /**
538
+ * Whether this member is offered to the model. Default is per member, per the
539
+ * toolset's documentation. A member whose enabled resolves false is withheld from
540
+ * the served schema.
541
+ */
542
+ enabled?: boolean | null;
417
543
  }
418
544
 
419
- export interface CitationPageLocation {
420
- cited_text: string;
421
-
422
- document_index: number;
545
+ /**
546
+ * `list_tabs`'s config overrides.
547
+ */
548
+ export interface BrowserListTabsConfig {
549
+ /**
550
+ * Defer loading for this member. Must resolve to the same value on every enabled
551
+ * member of the toolset.
552
+ */
553
+ defer_loading?: boolean | null;
423
554
 
424
- document_title: string | null;
555
+ /**
556
+ * Whether this member is offered to the model. Default is per member, per the
557
+ * toolset's documentation. A member whose enabled resolves false is withheld from
558
+ * the served schema.
559
+ */
560
+ enabled?: boolean | null;
561
+ }
425
562
 
426
- end_page_number: number;
563
+ /**
564
+ * `middle_click`'s config overrides.
565
+ */
566
+ export interface BrowserMiddleClickConfig {
567
+ /**
568
+ * Defer loading for this member. Must resolve to the same value on every enabled
569
+ * member of the toolset.
570
+ */
571
+ defer_loading?: boolean | null;
427
572
 
428
- file_id: string | null;
573
+ /**
574
+ * Whether this member is offered to the model. Default is per member, per the
575
+ * toolset's documentation. A member whose enabled resolves false is withheld from
576
+ * the served schema.
577
+ */
578
+ enabled?: boolean | null;
579
+ }
429
580
 
430
- start_page_number: number;
581
+ /**
582
+ * `mouse_move`'s config overrides.
583
+ */
584
+ export interface BrowserMouseMoveConfig {
585
+ /**
586
+ * Defer loading for this member. Must resolve to the same value on every enabled
587
+ * member of the toolset.
588
+ */
589
+ defer_loading?: boolean | null;
431
590
 
432
- type: 'page_location';
591
+ /**
592
+ * Whether this member is offered to the model. Default is per member, per the
593
+ * toolset's documentation. A member whose enabled resolves false is withheld from
594
+ * the served schema.
595
+ */
596
+ enabled?: boolean | null;
433
597
  }
434
598
 
435
- export interface CitationPageLocationParam {
436
- cited_text: string;
599
+ /**
600
+ * `navigate`'s config overrides.
601
+ */
602
+ export interface BrowserNavigateConfig {
603
+ /**
604
+ * Defer loading for this member. Must resolve to the same value on every enabled
605
+ * member of the toolset.
606
+ */
607
+ defer_loading?: boolean | null;
437
608
 
438
- document_index: number;
609
+ /**
610
+ * Whether this member is offered to the model. Default is per member, per the
611
+ * toolset's documentation. A member whose enabled resolves false is withheld from
612
+ * the served schema.
613
+ */
614
+ enabled?: boolean | null;
615
+ }
439
616
 
440
- document_title: string | null;
617
+ /**
618
+ * `new_tab`'s config overrides.
619
+ */
620
+ export interface BrowserNewTabConfig {
621
+ /**
622
+ * Defer loading for this member. Must resolve to the same value on every enabled
623
+ * member of the toolset.
624
+ */
625
+ defer_loading?: boolean | null;
441
626
 
442
- end_page_number: number;
627
+ /**
628
+ * Whether this member is offered to the model. Default is per member, per the
629
+ * toolset's documentation. A member whose enabled resolves false is withheld from
630
+ * the served schema.
631
+ */
632
+ enabled?: boolean | null;
633
+ }
443
634
 
444
- start_page_number: number;
635
+ /**
636
+ * `read_console`'s config overrides.
637
+ */
638
+ export interface BrowserReadConsoleConfig {
639
+ /**
640
+ * Defer loading for this member. Must resolve to the same value on every enabled
641
+ * member of the toolset.
642
+ */
643
+ defer_loading?: boolean | null;
445
644
 
446
- type: 'page_location';
645
+ /**
646
+ * Whether this member is offered to the model. Default is per member, per the
647
+ * toolset's documentation. A member whose enabled resolves false is withheld from
648
+ * the served schema.
649
+ */
650
+ enabled?: boolean | null;
447
651
  }
448
652
 
449
- export interface CitationSearchResultLocationParam {
653
+ /**
654
+ * `read_network`'s config overrides.
655
+ */
656
+ export interface BrowserReadNetworkConfig {
450
657
  /**
451
- * The full text of the cited block range, concatenated.
452
- *
453
- * Always equals the contents of `content[start_block_index:end_block_index]`
454
- * joined together. The text block is the minimal citable unit; this field is never
455
- * a substring of a single block. Not counted toward output tokens, and not counted
456
- * toward input tokens when sent back in subsequent turns.
658
+ * Defer loading for this member. Must resolve to the same value on every enabled
659
+ * member of the toolset.
457
660
  */
458
- cited_text: string;
661
+ defer_loading?: boolean | null;
459
662
 
460
663
  /**
461
- * Exclusive 0-based end index of the cited block range in the source's `content`
462
- * array.
463
- *
464
- * Always greater than `start_block_index`; a single-block citation has
465
- * `end_block_index = start_block_index + 1`.
664
+ * Whether this member is offered to the model. Default is per member, per the
665
+ * toolset's documentation. A member whose enabled resolves false is withheld from
666
+ * the served schema.
466
667
  */
467
- end_block_index: number;
668
+ enabled?: boolean | null;
669
+ }
468
670
 
671
+ /**
672
+ * `read_page`'s config overrides.
673
+ */
674
+ export interface BrowserReadPageConfig {
469
675
  /**
470
- * 0-based index of the cited search result among all `search_result` content
471
- * blocks in the request, in the order they appear across messages and tool
472
- * results.
473
- *
474
- * Counted separately from `document_index`; server-side web search results are not
475
- * included in this count.
676
+ * Defer loading for this member. Must resolve to the same value on every enabled
677
+ * member of the toolset.
476
678
  */
477
- search_result_index: number;
478
-
479
- source: string;
679
+ defer_loading?: boolean | null;
480
680
 
481
681
  /**
482
- * 0-based index of the first cited block in the source's `content` array.
682
+ * Whether this member is offered to the model. Default is per member, per the
683
+ * toolset's documentation. A member whose enabled resolves false is withheld from
684
+ * the served schema.
483
685
  */
484
- start_block_index: number;
686
+ enabled?: boolean | null;
687
+ }
485
688
 
486
- title: string | null;
689
+ /**
690
+ * `right_click`'s config overrides.
691
+ */
692
+ export interface BrowserRightClickConfig {
693
+ /**
694
+ * Defer loading for this member. Must resolve to the same value on every enabled
695
+ * member of the toolset.
696
+ */
697
+ defer_loading?: boolean | null;
487
698
 
488
- type: 'search_result_location';
699
+ /**
700
+ * Whether this member is offered to the model. Default is per member, per the
701
+ * toolset's documentation. A member whose enabled resolves false is withheld from
702
+ * the served schema.
703
+ */
704
+ enabled?: boolean | null;
489
705
  }
490
706
 
491
- export interface CitationWebSearchResultLocationParam {
492
- cited_text: string;
493
-
494
- encrypted_index: string;
707
+ /**
708
+ * `screenshot`'s config overrides.
709
+ */
710
+ export interface BrowserScreenshotConfig {
711
+ /**
712
+ * Defer loading for this member. Must resolve to the same value on every enabled
713
+ * member of the toolset.
714
+ */
715
+ defer_loading?: boolean | null;
495
716
 
496
- title: string | null;
717
+ /**
718
+ * Whether this member is offered to the model. Default is per member, per the
719
+ * toolset's documentation. A member whose enabled resolves false is withheld from
720
+ * the served schema.
721
+ */
722
+ enabled?: boolean | null;
723
+ }
497
724
 
498
- type: 'web_search_result_location';
725
+ /**
726
+ * `scroll`'s config overrides.
727
+ */
728
+ export interface BrowserScrollConfig {
729
+ /**
730
+ * Defer loading for this member. Must resolve to the same value on every enabled
731
+ * member of the toolset.
732
+ */
733
+ defer_loading?: boolean | null;
734
+
735
+ /**
736
+ * Whether this member is offered to the model. Default is per member, per the
737
+ * toolset's documentation. A member whose enabled resolves false is withheld from
738
+ * the served schema.
739
+ */
740
+ enabled?: boolean | null;
741
+ }
742
+
743
+ /**
744
+ * `scroll_to`'s config overrides.
745
+ */
746
+ export interface BrowserScrollToConfig {
747
+ /**
748
+ * Defer loading for this member. Must resolve to the same value on every enabled
749
+ * member of the toolset.
750
+ */
751
+ defer_loading?: boolean | null;
752
+
753
+ /**
754
+ * Whether this member is offered to the model. Default is per member, per the
755
+ * toolset's documentation. A member whose enabled resolves false is withheld from
756
+ * the served schema.
757
+ */
758
+ enabled?: boolean | null;
759
+ }
760
+
761
+ /**
762
+ * The caller's browser state after a browser toolset member call — the full
763
+ * inventory of open tabs, which tab is active, and any side effects (tabs opened,
764
+ * download state changes) the call produced.
765
+ *
766
+ * At most one per `tool_result`, only on a non-error result answering a browser
767
+ * toolset member `tool_use`. The server renders the model-visible text from it;
768
+ * the model never sees the raw fields.
769
+ */
770
+ export interface BrowserStateBlockParam {
771
+ /**
772
+ * All tabs open in the browser after this call — the full inventory, not a delta.
773
+ * May be empty. Whenever non-empty, exactly one entry carries `active: true`.
774
+ */
775
+ tabs: Array<BrowserStateTabEntry>;
776
+
777
+ type: 'browser_state';
778
+
779
+ /**
780
+ * Create a cache control breakpoint at this content block.
781
+ */
782
+ cache_control?: CacheControlEphemeral | null;
783
+
784
+ /**
785
+ * Tabs opened and download state changes during this call. "Nothing to report" is
786
+ * expressed by omitting the field, never by an empty list.
787
+ */
788
+ state_changes?: Array<BrowserStateChange> | null;
789
+ }
790
+
791
+ /**
792
+ * A tab this call's execution opened that remains open at its end — the creation
793
+ * delta of the `tabs` inventory, not an event log.
794
+ *
795
+ * Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
796
+ * which must include the same `tab_id`. A tab opened during a failed call gets no
797
+ * deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
798
+ */
799
+ export type BrowserStateChange =
800
+ | BrowserStateChangeTabOpened
801
+ | BrowserStateChangeDownloadStarted
802
+ | BrowserStateChangeDownloadCompleted
803
+ | BrowserStateChangeDownloadFailed;
804
+
805
+ /**
806
+ * A file download that finished during this call, reported with the same
807
+ * `download_id` as its `download_started` — or without a prior `download_started`,
808
+ * when the download finished during the call that started it (at most one state
809
+ * change per `download_id` per result).
810
+ */
811
+ export interface BrowserStateChangeDownloadCompleted {
812
+ /**
813
+ * The caller-assigned identifier for this download, stable across the state
814
+ * changes reporting it.
815
+ */
816
+ download_id: string;
817
+
818
+ type: 'download_completed';
819
+
820
+ /**
821
+ * The final post-redirect URL the download was served from.
822
+ */
823
+ url: string;
824
+
825
+ /**
826
+ * Where the executor saved the file, on the executor's filesystem. Only included
827
+ * when another tool in the same environment can read the file at that path.
828
+ */
829
+ path?: string | null;
830
+
831
+ /**
832
+ * The completed download's size.
833
+ */
834
+ size_bytes?: number | null;
835
+ }
836
+
837
+ /**
838
+ * A file download that failed — or was cancelled — during this call.
839
+ */
840
+ export interface BrowserStateChangeDownloadFailed {
841
+ /**
842
+ * The caller-assigned identifier for this download, stable across the state
843
+ * changes reporting it.
844
+ */
845
+ download_id: string;
846
+
847
+ type: 'download_failed';
848
+
849
+ /**
850
+ * The final post-redirect URL the download was served from.
851
+ */
852
+ url: string;
853
+
854
+ /**
855
+ * The failure or cancellation detail, when known.
856
+ */
857
+ error?: string | null;
858
+ }
859
+
860
+ /**
861
+ * A file download that started during this call.
862
+ */
863
+ export interface BrowserStateChangeDownloadStarted {
864
+ /**
865
+ * The caller-assigned identifier for this download, stable across the state
866
+ * changes reporting it.
867
+ */
868
+ download_id: string;
869
+
870
+ type: 'download_started';
871
+
872
+ /**
873
+ * The final post-redirect URL the download was served from.
874
+ */
875
+ url: string;
876
+ }
877
+
878
+ /**
879
+ * A tab this call's execution opened that remains open at its end — the creation
880
+ * delta of the `tabs` inventory, not an event log.
881
+ *
882
+ * Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
883
+ * which must include the same `tab_id`. A tab opened during a failed call gets no
884
+ * deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
885
+ */
886
+ export interface BrowserStateChangeTabOpened {
887
+ /**
888
+ * The `tab_id` of the opened tab, present in `tabs`.
889
+ */
890
+ tab_id: string;
891
+
892
+ type: 'tab_opened';
893
+ }
894
+
895
+ /**
896
+ * One open browser tab reported in a `browser_state` block's `tabs` inventory.
897
+ *
898
+ * `tab_id` is the caller-assigned identifier for the tab; `title` and `url`
899
+ * describe the page the tab is currently showing and may be empty strings (a blank
900
+ * tab legitimately has both empty). `active` marks the tab that is active after
901
+ * this call; whenever `tabs` is non-empty, exactly one entry is marked.
902
+ */
903
+ export interface BrowserStateTabEntry {
904
+ /**
905
+ * The caller-assigned identifier for this tab, unique within the inventory.
906
+ */
907
+ tab_id: string;
908
+
909
+ /**
910
+ * The title of the page the tab is showing. May be empty.
911
+ */
912
+ title: string;
913
+
914
+ /**
915
+ * The URL of the page the tab is showing. May be empty.
916
+ */
917
+ url: string;
918
+
919
+ /**
920
+ * Whether this tab is the active tab after this call. Whenever `tabs` is
921
+ * non-empty, exactly one entry is marked `active: true`.
922
+ */
923
+ active?: boolean;
924
+ }
925
+
926
+ /**
927
+ * `switch_tab`'s config overrides.
928
+ */
929
+ export interface BrowserSwitchTabConfig {
930
+ /**
931
+ * Defer loading for this member. Must resolve to the same value on every enabled
932
+ * member of the toolset.
933
+ */
934
+ defer_loading?: boolean | null;
935
+
936
+ /**
937
+ * Whether this member is offered to the model. Default is per member, per the
938
+ * toolset's documentation. A member whose enabled resolves false is withheld from
939
+ * the served schema.
940
+ */
941
+ enabled?: boolean | null;
942
+ }
943
+
944
+ /**
945
+ * The browser toolset: a single `tools[]` entry (carrying no `name`) that declares
946
+ * the browser tool family. The model is served the family's tool with any members
947
+ * disabled via `configs` removed from its schema.
948
+ */
949
+ export interface BrowserToolset20260801 {
950
+ type: 'browser_toolset_20260801';
951
+
952
+ allowed_callers?: Array<
953
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
954
+ >;
955
+
956
+ /**
957
+ * Create a cache control breakpoint at this content block.
958
+ */
959
+ cache_control?: CacheControlEphemeral | null;
960
+
961
+ /**
962
+ * Per-member configuration for `browser_toolset_20260801`: one optional field per
963
+ * member tool, keyed by the member name — the same name the member's `tool_use`
964
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
965
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
966
+ * toolset version's complete member set.
967
+ */
968
+ configs?: BrowserToolsetConfigs | null;
969
+ }
970
+
971
+ /**
972
+ * Per-member configuration for `browser_toolset_20260801`: one optional field per
973
+ * member tool, keyed by the member name — the same name the member's `tool_use`
974
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
975
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
976
+ * toolset version's complete member set.
977
+ */
978
+ export interface BrowserToolsetConfigs {
979
+ /**
980
+ * `close_tab`'s config overrides.
981
+ */
982
+ close_tab?: BrowserCloseTabConfig | null;
983
+
984
+ /**
985
+ * `double_click`'s config overrides.
986
+ */
987
+ double_click?: BrowserDoubleClickConfig | null;
988
+
989
+ /**
990
+ * `file_upload`'s config overrides.
991
+ */
992
+ file_upload?: BrowserFileUploadConfig | null;
993
+
994
+ /**
995
+ * `find`'s config overrides.
996
+ */
997
+ find?: BrowserFindConfig | null;
998
+
999
+ /**
1000
+ * `form_input`'s config overrides.
1001
+ */
1002
+ form_input?: BrowserFormInputConfig | null;
1003
+
1004
+ /**
1005
+ * `get_page_text`'s config overrides.
1006
+ */
1007
+ get_page_text?: BrowserGetPageTextConfig | null;
1008
+
1009
+ /**
1010
+ * `hold_key`'s config overrides.
1011
+ */
1012
+ hold_key?: BrowserHoldKeyConfig | null;
1013
+
1014
+ /**
1015
+ * `hover`'s config overrides.
1016
+ */
1017
+ hover?: BrowserHoverConfig | null;
1018
+
1019
+ /**
1020
+ * `javascript_exec`'s config overrides.
1021
+ */
1022
+ javascript_exec?: BrowserJavascriptExecConfig | null;
1023
+
1024
+ /**
1025
+ * `key`'s config overrides.
1026
+ */
1027
+ key?: BrowserKeyConfig | null;
1028
+
1029
+ /**
1030
+ * `left_click`'s config overrides.
1031
+ */
1032
+ left_click?: BrowserLeftClickConfig | null;
1033
+
1034
+ /**
1035
+ * `left_click_drag`'s config overrides.
1036
+ */
1037
+ left_click_drag?: BrowserLeftClickDragConfig | null;
1038
+
1039
+ /**
1040
+ * `left_mouse_down`'s config overrides.
1041
+ */
1042
+ left_mouse_down?: BrowserLeftMouseDownConfig | null;
1043
+
1044
+ /**
1045
+ * `left_mouse_up`'s config overrides.
1046
+ */
1047
+ left_mouse_up?: BrowserLeftMouseUpConfig | null;
1048
+
1049
+ /**
1050
+ * `list_tabs`'s config overrides.
1051
+ */
1052
+ list_tabs?: BrowserListTabsConfig | null;
1053
+
1054
+ /**
1055
+ * `middle_click`'s config overrides.
1056
+ */
1057
+ middle_click?: BrowserMiddleClickConfig | null;
1058
+
1059
+ /**
1060
+ * `mouse_move`'s config overrides.
1061
+ */
1062
+ mouse_move?: BrowserMouseMoveConfig | null;
1063
+
1064
+ /**
1065
+ * `navigate`'s config overrides.
1066
+ */
1067
+ navigate?: BrowserNavigateConfig | null;
1068
+
1069
+ /**
1070
+ * `new_tab`'s config overrides.
1071
+ */
1072
+ new_tab?: BrowserNewTabConfig | null;
1073
+
1074
+ /**
1075
+ * `read_console`'s config overrides.
1076
+ */
1077
+ read_console?: BrowserReadConsoleConfig | null;
1078
+
1079
+ /**
1080
+ * `read_network`'s config overrides.
1081
+ */
1082
+ read_network?: BrowserReadNetworkConfig | null;
1083
+
1084
+ /**
1085
+ * `read_page`'s config overrides.
1086
+ */
1087
+ read_page?: BrowserReadPageConfig | null;
1088
+
1089
+ /**
1090
+ * `right_click`'s config overrides.
1091
+ */
1092
+ right_click?: BrowserRightClickConfig | null;
1093
+
1094
+ /**
1095
+ * `screenshot`'s config overrides.
1096
+ */
1097
+ screenshot?: BrowserScreenshotConfig | null;
1098
+
1099
+ /**
1100
+ * `scroll`'s config overrides.
1101
+ */
1102
+ scroll?: BrowserScrollConfig | null;
1103
+
1104
+ /**
1105
+ * `scroll_to`'s config overrides.
1106
+ */
1107
+ scroll_to?: BrowserScrollToConfig | null;
1108
+
1109
+ /**
1110
+ * `switch_tab`'s config overrides.
1111
+ */
1112
+ switch_tab?: BrowserSwitchTabConfig | null;
1113
+
1114
+ /**
1115
+ * `triple_click`'s config overrides.
1116
+ */
1117
+ triple_click?: BrowserTripleClickConfig | null;
1118
+
1119
+ /**
1120
+ * `type`'s config overrides.
1121
+ */
1122
+ type?: BrowserTypeConfig | null;
1123
+
1124
+ /**
1125
+ * `wait`'s config overrides.
1126
+ */
1127
+ wait?: BrowserWaitConfig | null;
1128
+
1129
+ /**
1130
+ * `zoom`'s config overrides.
1131
+ */
1132
+ zoom?: BrowserZoomConfig | null;
1133
+ }
1134
+
1135
+ /**
1136
+ * `triple_click`'s config overrides.
1137
+ */
1138
+ export interface BrowserTripleClickConfig {
1139
+ /**
1140
+ * Defer loading for this member. Must resolve to the same value on every enabled
1141
+ * member of the toolset.
1142
+ */
1143
+ defer_loading?: boolean | null;
1144
+
1145
+ /**
1146
+ * Whether this member is offered to the model. Default is per member, per the
1147
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1148
+ * the served schema.
1149
+ */
1150
+ enabled?: boolean | null;
1151
+ }
1152
+
1153
+ /**
1154
+ * `type`'s config overrides.
1155
+ */
1156
+ export interface BrowserTypeConfig {
1157
+ /**
1158
+ * Defer loading for this member. Must resolve to the same value on every enabled
1159
+ * member of the toolset.
1160
+ */
1161
+ defer_loading?: boolean | null;
1162
+
1163
+ /**
1164
+ * Whether this member is offered to the model. Default is per member, per the
1165
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1166
+ * the served schema.
1167
+ */
1168
+ enabled?: boolean | null;
1169
+ }
1170
+
1171
+ /**
1172
+ * `wait`'s config overrides.
1173
+ */
1174
+ export interface BrowserWaitConfig {
1175
+ /**
1176
+ * Defer loading for this member. Must resolve to the same value on every enabled
1177
+ * member of the toolset.
1178
+ */
1179
+ defer_loading?: boolean | null;
1180
+
1181
+ /**
1182
+ * Whether this member is offered to the model. Default is per member, per the
1183
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1184
+ * the served schema.
1185
+ */
1186
+ enabled?: boolean | null;
1187
+ }
1188
+
1189
+ /**
1190
+ * `zoom`'s config overrides.
1191
+ */
1192
+ export interface BrowserZoomConfig {
1193
+ /**
1194
+ * Defer loading for this member. Must resolve to the same value on every enabled
1195
+ * member of the toolset.
1196
+ */
1197
+ defer_loading?: boolean | null;
1198
+
1199
+ /**
1200
+ * Whether this member is offered to the model. Default is per member, per the
1201
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1202
+ * the served schema.
1203
+ */
1204
+ enabled?: boolean | null;
1205
+ }
1206
+
1207
+ export interface CacheControlEphemeral {
1208
+ type: 'ephemeral';
1209
+
1210
+ /**
1211
+ * The time-to-live for the cache control breakpoint.
1212
+ *
1213
+ * This may be one the following values:
1214
+ *
1215
+ * - `5m`: 5 minutes
1216
+ * - `1h`: 1 hour
1217
+ *
1218
+ * Defaults to `5m`. See
1219
+ * [prompt caching pricing](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)
1220
+ * for details.
1221
+ */
1222
+ ttl?: '5m' | '1h';
1223
+ }
1224
+
1225
+ export interface CacheCreation {
1226
+ /**
1227
+ * The number of input tokens used to create the 1 hour cache entry.
1228
+ */
1229
+ ephemeral_1h_input_tokens: number;
1230
+
1231
+ /**
1232
+ * The number of input tokens used to create the 5 minute cache entry.
1233
+ */
1234
+ ephemeral_5m_input_tokens: number;
1235
+ }
1236
+
1237
+ export interface CitationCharLocation {
1238
+ cited_text: string;
1239
+
1240
+ document_index: number;
1241
+
1242
+ document_title: string | null;
1243
+
1244
+ end_char_index: number;
1245
+
1246
+ file_id: string | null;
1247
+
1248
+ start_char_index: number;
1249
+
1250
+ type: 'char_location';
1251
+ }
1252
+
1253
+ export interface CitationCharLocationParam {
1254
+ cited_text: string;
1255
+
1256
+ document_index: number;
1257
+
1258
+ document_title: string | null;
1259
+
1260
+ end_char_index: number;
1261
+
1262
+ start_char_index: number;
1263
+
1264
+ type: 'char_location';
1265
+ }
1266
+
1267
+ export interface CitationContentBlockLocation {
1268
+ /**
1269
+ * The full text of the cited block range, concatenated.
1270
+ *
1271
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1272
+ * joined together. The text block is the minimal citable unit; this field is never
1273
+ * a substring of a single block. Not counted toward output tokens, and not counted
1274
+ * toward input tokens when sent back in subsequent turns.
1275
+ */
1276
+ cited_text: string;
1277
+
1278
+ document_index: number;
1279
+
1280
+ document_title: string | null;
1281
+
1282
+ /**
1283
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1284
+ * array.
1285
+ *
1286
+ * Always greater than `start_block_index`; a single-block citation has
1287
+ * `end_block_index = start_block_index + 1`.
1288
+ */
1289
+ end_block_index: number;
1290
+
1291
+ file_id: string | null;
1292
+
1293
+ /**
1294
+ * 0-based index of the first cited block in the source's `content` array.
1295
+ */
1296
+ start_block_index: number;
1297
+
1298
+ type: 'content_block_location';
1299
+ }
1300
+
1301
+ export interface CitationContentBlockLocationParam {
1302
+ /**
1303
+ * The full text of the cited block range, concatenated.
1304
+ *
1305
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1306
+ * joined together. The text block is the minimal citable unit; this field is never
1307
+ * a substring of a single block. Not counted toward output tokens, and not counted
1308
+ * toward input tokens when sent back in subsequent turns.
1309
+ */
1310
+ cited_text: string;
1311
+
1312
+ document_index: number;
1313
+
1314
+ document_title: string | null;
1315
+
1316
+ /**
1317
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1318
+ * array.
1319
+ *
1320
+ * Always greater than `start_block_index`; a single-block citation has
1321
+ * `end_block_index = start_block_index + 1`.
1322
+ */
1323
+ end_block_index: number;
1324
+
1325
+ /**
1326
+ * 0-based index of the first cited block in the source's `content` array.
1327
+ */
1328
+ start_block_index: number;
1329
+
1330
+ type: 'content_block_location';
1331
+ }
1332
+
1333
+ export interface CitationPageLocation {
1334
+ cited_text: string;
1335
+
1336
+ document_index: number;
1337
+
1338
+ document_title: string | null;
1339
+
1340
+ end_page_number: number;
1341
+
1342
+ file_id: string | null;
1343
+
1344
+ start_page_number: number;
1345
+
1346
+ type: 'page_location';
1347
+ }
1348
+
1349
+ export interface CitationPageLocationParam {
1350
+ cited_text: string;
1351
+
1352
+ document_index: number;
1353
+
1354
+ document_title: string | null;
1355
+
1356
+ end_page_number: number;
1357
+
1358
+ start_page_number: number;
1359
+
1360
+ type: 'page_location';
1361
+ }
1362
+
1363
+ export interface CitationSearchResultLocationParam {
1364
+ /**
1365
+ * The full text of the cited block range, concatenated.
1366
+ *
1367
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1368
+ * joined together. The text block is the minimal citable unit; this field is never
1369
+ * a substring of a single block. Not counted toward output tokens, and not counted
1370
+ * toward input tokens when sent back in subsequent turns.
1371
+ */
1372
+ cited_text: string;
1373
+
1374
+ /**
1375
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1376
+ * array.
1377
+ *
1378
+ * Always greater than `start_block_index`; a single-block citation has
1379
+ * `end_block_index = start_block_index + 1`.
1380
+ */
1381
+ end_block_index: number;
1382
+
1383
+ /**
1384
+ * 0-based index of the cited search result among all `search_result` content
1385
+ * blocks in the request, in the order they appear across messages and tool
1386
+ * results.
1387
+ *
1388
+ * Counted separately from `document_index`; server-side web search results are not
1389
+ * included in this count.
1390
+ */
1391
+ search_result_index: number;
1392
+
1393
+ source: string;
1394
+
1395
+ /**
1396
+ * 0-based index of the first cited block in the source's `content` array.
1397
+ */
1398
+ start_block_index: number;
1399
+
1400
+ title: string | null;
1401
+
1402
+ type: 'search_result_location';
1403
+ }
1404
+
1405
+ export interface CitationWebSearchResultLocationParam {
1406
+ cited_text: string;
1407
+
1408
+ encrypted_index: string;
1409
+
1410
+ title: string | null;
1411
+
1412
+ type: 'web_search_result_location';
1413
+
1414
+ url: string;
1415
+ }
1416
+
1417
+ export interface CitationsConfig {
1418
+ enabled: boolean;
1419
+ }
1420
+
1421
+ export interface CitationsConfigParam {
1422
+ enabled?: boolean;
1423
+ }
1424
+
1425
+ export interface CitationsDelta {
1426
+ citation:
1427
+ | CitationCharLocation
1428
+ | CitationPageLocation
1429
+ | CitationContentBlockLocation
1430
+ | CitationsWebSearchResultLocation
1431
+ | CitationsSearchResultLocation;
1432
+
1433
+ type: 'citations_delta';
1434
+ }
1435
+
1436
+ export interface CitationsSearchResultLocation {
1437
+ /**
1438
+ * The full text of the cited block range, concatenated.
1439
+ *
1440
+ * Always equals the contents of `content[start_block_index:end_block_index]`
1441
+ * joined together. The text block is the minimal citable unit; this field is never
1442
+ * a substring of a single block. Not counted toward output tokens, and not counted
1443
+ * toward input tokens when sent back in subsequent turns.
1444
+ */
1445
+ cited_text: string;
1446
+
1447
+ /**
1448
+ * Exclusive 0-based end index of the cited block range in the source's `content`
1449
+ * array.
1450
+ *
1451
+ * Always greater than `start_block_index`; a single-block citation has
1452
+ * `end_block_index = start_block_index + 1`.
1453
+ */
1454
+ end_block_index: number;
1455
+
1456
+ /**
1457
+ * 0-based index of the cited search result among all `search_result` content
1458
+ * blocks in the request, in the order they appear across messages and tool
1459
+ * results.
1460
+ *
1461
+ * Counted separately from `document_index`; server-side web search results are not
1462
+ * included in this count.
1463
+ */
1464
+ search_result_index: number;
1465
+
1466
+ source: string;
1467
+
1468
+ /**
1469
+ * 0-based index of the first cited block in the source's `content` array.
1470
+ */
1471
+ start_block_index: number;
1472
+
1473
+ title: string | null;
1474
+
1475
+ type: 'search_result_location';
1476
+ }
1477
+
1478
+ export interface CitationsWebSearchResultLocation {
1479
+ cited_text: string;
1480
+
1481
+ encrypted_index: string;
1482
+
1483
+ title: string | null;
1484
+
1485
+ type: 'web_search_result_location';
1486
+
1487
+ url: string;
1488
+ }
1489
+
1490
+ export interface CodeExecutionOutputBlock {
1491
+ file_id: string;
1492
+
1493
+ type: 'code_execution_output';
1494
+ }
1495
+
1496
+ export interface CodeExecutionOutputBlockParam {
1497
+ file_id: string;
1498
+
1499
+ type: 'code_execution_output';
1500
+ }
1501
+
1502
+ export interface CodeExecutionResultBlock {
1503
+ content: Array<CodeExecutionOutputBlock>;
1504
+
1505
+ return_code: number;
1506
+
1507
+ stderr: string;
1508
+
1509
+ stdout: string;
1510
+
1511
+ type: 'code_execution_result';
1512
+ }
1513
+
1514
+ export interface CodeExecutionResultBlockParam {
1515
+ content: Array<CodeExecutionOutputBlockParam>;
1516
+
1517
+ return_code: number;
1518
+
1519
+ stderr: string;
1520
+
1521
+ stdout: string;
1522
+
1523
+ type: 'code_execution_result';
1524
+ }
1525
+
1526
+ export interface CodeExecutionTool20250522 {
1527
+ /**
1528
+ * Name of the tool.
1529
+ *
1530
+ * This is how the tool will be called by the model and in `tool_use` blocks.
1531
+ */
1532
+ name: 'code_execution';
1533
+
1534
+ type: 'code_execution_20250522';
1535
+
1536
+ allowed_callers?: Array<
1537
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1538
+ >;
499
1539
 
500
- url: string;
501
- }
1540
+ /**
1541
+ * Create a cache control breakpoint at this content block.
1542
+ */
1543
+ cache_control?: CacheControlEphemeral | null;
502
1544
 
503
- export interface CitationsConfig {
504
- enabled: boolean;
505
- }
1545
+ /**
1546
+ * If true, tool will not be included in initial system prompt. Only loaded when
1547
+ * returned via tool_reference from tool search.
1548
+ */
1549
+ defer_loading?: boolean;
506
1550
 
507
- export interface CitationsConfigParam {
508
- enabled?: boolean;
1551
+ /**
1552
+ * When true, guarantees schema validation on tool names and inputs
1553
+ */
1554
+ strict?: boolean;
509
1555
  }
510
1556
 
511
- export interface CitationsDelta {
512
- citation:
513
- | CitationCharLocation
514
- | CitationPageLocation
515
- | CitationContentBlockLocation
516
- | CitationsWebSearchResultLocation
517
- | CitationsSearchResultLocation;
1557
+ export interface CodeExecutionTool20250825 {
1558
+ /**
1559
+ * Name of the tool.
1560
+ *
1561
+ * This is how the tool will be called by the model and in `tool_use` blocks.
1562
+ */
1563
+ name: 'code_execution';
518
1564
 
519
- type: 'citations_delta';
1565
+ type: 'code_execution_20250825';
1566
+
1567
+ allowed_callers?: Array<
1568
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1569
+ >;
1570
+
1571
+ /**
1572
+ * Create a cache control breakpoint at this content block.
1573
+ */
1574
+ cache_control?: CacheControlEphemeral | null;
1575
+
1576
+ /**
1577
+ * If true, tool will not be included in initial system prompt. Only loaded when
1578
+ * returned via tool_reference from tool search.
1579
+ */
1580
+ defer_loading?: boolean;
1581
+
1582
+ /**
1583
+ * When true, guarantees schema validation on tool names and inputs
1584
+ */
1585
+ strict?: boolean;
520
1586
  }
521
1587
 
522
- export interface CitationsSearchResultLocation {
1588
+ /**
1589
+ * Code execution tool with REPL state persistence (daemon mode + gVisor
1590
+ * checkpoint).
1591
+ */
1592
+ export interface CodeExecutionTool20260120 {
523
1593
  /**
524
- * The full text of the cited block range, concatenated.
1594
+ * Name of the tool.
525
1595
  *
526
- * Always equals the contents of `content[start_block_index:end_block_index]`
527
- * joined together. The text block is the minimal citable unit; this field is never
528
- * a substring of a single block. Not counted toward output tokens, and not counted
529
- * toward input tokens when sent back in subsequent turns.
1596
+ * This is how the tool will be called by the model and in `tool_use` blocks.
530
1597
  */
531
- cited_text: string;
1598
+ name: 'code_execution';
1599
+
1600
+ type: 'code_execution_20260120';
1601
+
1602
+ allowed_callers?: Array<
1603
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1604
+ >;
532
1605
 
533
1606
  /**
534
- * Exclusive 0-based end index of the cited block range in the source's `content`
535
- * array.
536
- *
537
- * Always greater than `start_block_index`; a single-block citation has
538
- * `end_block_index = start_block_index + 1`.
1607
+ * Create a cache control breakpoint at this content block.
539
1608
  */
540
- end_block_index: number;
1609
+ cache_control?: CacheControlEphemeral | null;
541
1610
 
542
1611
  /**
543
- * 0-based index of the cited search result among all `search_result` content
544
- * blocks in the request, in the order they appear across messages and tool
545
- * results.
1612
+ * If true, tool will not be included in initial system prompt. Only loaded when
1613
+ * returned via tool_reference from tool search.
1614
+ */
1615
+ defer_loading?: boolean;
1616
+
1617
+ /**
1618
+ * When true, guarantees schema validation on tool names and inputs
1619
+ */
1620
+ strict?: boolean;
1621
+ }
1622
+
1623
+ /**
1624
+ * Code execution tool with REPL state persistence.
1625
+ */
1626
+ export interface CodeExecutionTool20260521 {
1627
+ /**
1628
+ * Name of the tool.
546
1629
  *
547
- * Counted separately from `document_index`; server-side web search results are not
548
- * included in this count.
1630
+ * This is how the tool will be called by the model and in `tool_use` blocks.
549
1631
  */
550
- search_result_index: number;
1632
+ name: 'code_execution';
551
1633
 
552
- source: string;
1634
+ type: 'code_execution_20260521';
1635
+
1636
+ allowed_callers?: Array<
1637
+ 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
1638
+ >;
553
1639
 
554
1640
  /**
555
- * 0-based index of the first cited block in the source's `content` array.
1641
+ * Create a cache control breakpoint at this content block.
556
1642
  */
557
- start_block_index: number;
1643
+ cache_control?: CacheControlEphemeral | null;
558
1644
 
559
- title: string | null;
1645
+ /**
1646
+ * If true, tool will not be included in initial system prompt. Only loaded when
1647
+ * returned via tool_reference from tool search.
1648
+ */
1649
+ defer_loading?: boolean;
560
1650
 
561
- type: 'search_result_location';
1651
+ /**
1652
+ * When true, guarantees schema validation on tool names and inputs
1653
+ */
1654
+ strict?: boolean;
562
1655
  }
563
1656
 
564
- export interface CitationsWebSearchResultLocation {
565
- cited_text: string;
1657
+ export interface CodeExecutionToolResultBlock {
1658
+ /**
1659
+ * Code execution result with encrypted stdout for PFC + web_search results.
1660
+ */
1661
+ content: CodeExecutionToolResultBlockContent;
566
1662
 
567
- encrypted_index: string;
1663
+ tool_use_id: string;
568
1664
 
569
- title: string | null;
1665
+ type: 'code_execution_tool_result';
1666
+ }
570
1667
 
571
- type: 'web_search_result_location';
1668
+ /**
1669
+ * Code execution result with encrypted stdout for PFC + web_search results.
1670
+ */
1671
+ export type CodeExecutionToolResultBlockContent =
1672
+ | CodeExecutionToolResultError
1673
+ | CodeExecutionResultBlock
1674
+ | EncryptedCodeExecutionResultBlock;
572
1675
 
573
- url: string;
1676
+ export interface CodeExecutionToolResultBlockParam {
1677
+ /**
1678
+ * Code execution result with encrypted stdout for PFC + web_search results.
1679
+ */
1680
+ content: CodeExecutionToolResultBlockParamContent;
1681
+
1682
+ tool_use_id: string;
1683
+
1684
+ type: 'code_execution_tool_result';
1685
+
1686
+ /**
1687
+ * Create a cache control breakpoint at this content block.
1688
+ */
1689
+ cache_control?: CacheControlEphemeral | null;
574
1690
  }
575
1691
 
576
- export interface CodeExecutionOutputBlock {
577
- file_id: string;
1692
+ /**
1693
+ * Code execution result with encrypted stdout for PFC + web_search results.
1694
+ */
1695
+ export type CodeExecutionToolResultBlockParamContent =
1696
+ | CodeExecutionToolResultErrorParam
1697
+ | CodeExecutionResultBlockParam
1698
+ | EncryptedCodeExecutionResultBlockParam;
578
1699
 
579
- type: 'code_execution_output';
1700
+ export interface CodeExecutionToolResultError {
1701
+ error_code: CodeExecutionToolResultErrorCode;
1702
+
1703
+ type: 'code_execution_tool_result_error';
580
1704
  }
581
1705
 
582
- export interface CodeExecutionOutputBlockParam {
583
- file_id: string;
1706
+ export type CodeExecutionToolResultErrorCode =
1707
+ | 'invalid_tool_input'
1708
+ | 'unavailable'
1709
+ | 'too_many_requests'
1710
+ | 'execution_time_exceeded';
584
1711
 
585
- type: 'code_execution_output';
1712
+ export interface CodeExecutionToolResultErrorParam {
1713
+ error_code: CodeExecutionToolResultErrorCode;
1714
+
1715
+ type: 'code_execution_tool_result_error';
586
1716
  }
587
1717
 
588
- export interface CodeExecutionResultBlock {
589
- content: Array<CodeExecutionOutputBlock>;
1718
+ /**
1719
+ * `cursor_position`'s config overrides.
1720
+ */
1721
+ export interface ComputerCursorPositionConfig {
1722
+ /**
1723
+ * Defer loading for this member. Must resolve to the same value on every enabled
1724
+ * member of the toolset.
1725
+ */
1726
+ defer_loading?: boolean | null;
590
1727
 
591
- return_code: number;
1728
+ /**
1729
+ * Whether this member is offered to the model. Default is per member, per the
1730
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1731
+ * the served schema.
1732
+ */
1733
+ enabled?: boolean | null;
1734
+ }
592
1735
 
593
- stderr: string;
1736
+ /**
1737
+ * `double_click`'s config overrides.
1738
+ */
1739
+ export interface ComputerDoubleClickConfig {
1740
+ /**
1741
+ * Defer loading for this member. Must resolve to the same value on every enabled
1742
+ * member of the toolset.
1743
+ */
1744
+ defer_loading?: boolean | null;
594
1745
 
595
- stdout: string;
1746
+ /**
1747
+ * Whether this member is offered to the model. Default is per member, per the
1748
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1749
+ * the served schema.
1750
+ */
1751
+ enabled?: boolean | null;
1752
+ }
596
1753
 
597
- type: 'code_execution_result';
1754
+ /**
1755
+ * `hold_key`'s config overrides.
1756
+ */
1757
+ export interface ComputerHoldKeyConfig {
1758
+ /**
1759
+ * Defer loading for this member. Must resolve to the same value on every enabled
1760
+ * member of the toolset.
1761
+ */
1762
+ defer_loading?: boolean | null;
1763
+
1764
+ /**
1765
+ * Whether this member is offered to the model. Default is per member, per the
1766
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1767
+ * the served schema.
1768
+ */
1769
+ enabled?: boolean | null;
598
1770
  }
599
1771
 
600
- export interface CodeExecutionResultBlockParam {
601
- content: Array<CodeExecutionOutputBlockParam>;
1772
+ /**
1773
+ * `key`'s config overrides.
1774
+ */
1775
+ export interface ComputerKeyConfig {
1776
+ /**
1777
+ * Defer loading for this member. Must resolve to the same value on every enabled
1778
+ * member of the toolset.
1779
+ */
1780
+ defer_loading?: boolean | null;
1781
+
1782
+ /**
1783
+ * Whether this member is offered to the model. Default is per member, per the
1784
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1785
+ * the served schema.
1786
+ */
1787
+ enabled?: boolean | null;
1788
+ }
1789
+
1790
+ /**
1791
+ * `left_click`'s config overrides.
1792
+ */
1793
+ export interface ComputerLeftClickConfig {
1794
+ /**
1795
+ * Defer loading for this member. Must resolve to the same value on every enabled
1796
+ * member of the toolset.
1797
+ */
1798
+ defer_loading?: boolean | null;
1799
+
1800
+ /**
1801
+ * Whether this member is offered to the model. Default is per member, per the
1802
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1803
+ * the served schema.
1804
+ */
1805
+ enabled?: boolean | null;
1806
+ }
1807
+
1808
+ /**
1809
+ * `left_click_drag`'s config overrides.
1810
+ */
1811
+ export interface ComputerLeftClickDragConfig {
1812
+ /**
1813
+ * Defer loading for this member. Must resolve to the same value on every enabled
1814
+ * member of the toolset.
1815
+ */
1816
+ defer_loading?: boolean | null;
1817
+
1818
+ /**
1819
+ * Whether this member is offered to the model. Default is per member, per the
1820
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1821
+ * the served schema.
1822
+ */
1823
+ enabled?: boolean | null;
1824
+ }
1825
+
1826
+ /**
1827
+ * `left_mouse_down`'s config overrides.
1828
+ */
1829
+ export interface ComputerLeftMouseDownConfig {
1830
+ /**
1831
+ * Defer loading for this member. Must resolve to the same value on every enabled
1832
+ * member of the toolset.
1833
+ */
1834
+ defer_loading?: boolean | null;
1835
+
1836
+ /**
1837
+ * Whether this member is offered to the model. Default is per member, per the
1838
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1839
+ * the served schema.
1840
+ */
1841
+ enabled?: boolean | null;
1842
+ }
602
1843
 
603
- return_code: number;
1844
+ /**
1845
+ * `left_mouse_up`'s config overrides.
1846
+ */
1847
+ export interface ComputerLeftMouseUpConfig {
1848
+ /**
1849
+ * Defer loading for this member. Must resolve to the same value on every enabled
1850
+ * member of the toolset.
1851
+ */
1852
+ defer_loading?: boolean | null;
604
1853
 
605
- stderr: string;
1854
+ /**
1855
+ * Whether this member is offered to the model. Default is per member, per the
1856
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1857
+ * the served schema.
1858
+ */
1859
+ enabled?: boolean | null;
1860
+ }
606
1861
 
607
- stdout: string;
1862
+ /**
1863
+ * `middle_click`'s config overrides.
1864
+ */
1865
+ export interface ComputerMiddleClickConfig {
1866
+ /**
1867
+ * Defer loading for this member. Must resolve to the same value on every enabled
1868
+ * member of the toolset.
1869
+ */
1870
+ defer_loading?: boolean | null;
608
1871
 
609
- type: 'code_execution_result';
1872
+ /**
1873
+ * Whether this member is offered to the model. Default is per member, per the
1874
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1875
+ * the served schema.
1876
+ */
1877
+ enabled?: boolean | null;
610
1878
  }
611
1879
 
612
- export interface CodeExecutionTool20250522 {
1880
+ /**
1881
+ * `mouse_move`'s config overrides.
1882
+ */
1883
+ export interface ComputerMouseMoveConfig {
613
1884
  /**
614
- * Name of the tool.
615
- *
616
- * This is how the tool will be called by the model and in `tool_use` blocks.
1885
+ * Defer loading for this member. Must resolve to the same value on every enabled
1886
+ * member of the toolset.
617
1887
  */
618
- name: 'code_execution';
1888
+ defer_loading?: boolean | null;
619
1889
 
620
- type: 'code_execution_20250522';
1890
+ /**
1891
+ * Whether this member is offered to the model. Default is per member, per the
1892
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1893
+ * the served schema.
1894
+ */
1895
+ enabled?: boolean | null;
1896
+ }
621
1897
 
622
- allowed_callers?: Array<
623
- 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
624
- >;
1898
+ /**
1899
+ * `right_click`'s config overrides.
1900
+ */
1901
+ export interface ComputerRightClickConfig {
1902
+ /**
1903
+ * Defer loading for this member. Must resolve to the same value on every enabled
1904
+ * member of the toolset.
1905
+ */
1906
+ defer_loading?: boolean | null;
625
1907
 
626
1908
  /**
627
- * Create a cache control breakpoint at this content block.
1909
+ * Whether this member is offered to the model. Default is per member, per the
1910
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1911
+ * the served schema.
628
1912
  */
629
- cache_control?: CacheControlEphemeral | null;
1913
+ enabled?: boolean | null;
1914
+ }
630
1915
 
1916
+ /**
1917
+ * `screenshot`'s config overrides.
1918
+ */
1919
+ export interface ComputerScreenshotConfig {
631
1920
  /**
632
- * If true, tool will not be included in initial system prompt. Only loaded when
633
- * returned via tool_reference from tool search.
1921
+ * Defer loading for this member. Must resolve to the same value on every enabled
1922
+ * member of the toolset.
634
1923
  */
635
- defer_loading?: boolean;
1924
+ defer_loading?: boolean | null;
636
1925
 
637
1926
  /**
638
- * When true, guarantees schema validation on tool names and inputs
1927
+ * Whether this member is offered to the model. Default is per member, per the
1928
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1929
+ * the served schema.
639
1930
  */
640
- strict?: boolean;
1931
+ enabled?: boolean | null;
641
1932
  }
642
1933
 
643
- export interface CodeExecutionTool20250825 {
1934
+ /**
1935
+ * `scroll`'s config overrides.
1936
+ */
1937
+ export interface ComputerScrollConfig {
644
1938
  /**
645
- * Name of the tool.
646
- *
647
- * This is how the tool will be called by the model and in `tool_use` blocks.
1939
+ * Defer loading for this member. Must resolve to the same value on every enabled
1940
+ * member of the toolset.
648
1941
  */
649
- name: 'code_execution';
1942
+ defer_loading?: boolean | null;
650
1943
 
651
- type: 'code_execution_20250825';
1944
+ /**
1945
+ * Whether this member is offered to the model. Default is per member, per the
1946
+ * toolset's documentation. A member whose enabled resolves false is withheld from
1947
+ * the served schema.
1948
+ */
1949
+ enabled?: boolean | null;
1950
+ }
1951
+
1952
+ /**
1953
+ * The computer toolset: a single `tools[]` entry (carrying no `name`) that
1954
+ * declares the computer tool family. The model is served the family's tool with
1955
+ * any members disabled via `configs` removed from its schema. Every member is
1956
+ * enabled by default, zoom included. The single-tool options `display_number` and
1957
+ * `enable_zoom` are not fields of a toolset entry — it carries only `type`,
1958
+ * `configs`, and `cache_control`; zoom is controlled via `configs.zoom.enabled`.
1959
+ */
1960
+ export interface ComputerToolset20260801 {
1961
+ type: 'computer_toolset_20260801';
652
1962
 
653
1963
  allowed_callers?: Array<
654
1964
  'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
@@ -660,145 +1970,179 @@ export interface CodeExecutionTool20250825 {
660
1970
  cache_control?: CacheControlEphemeral | null;
661
1971
 
662
1972
  /**
663
- * If true, tool will not be included in initial system prompt. Only loaded when
664
- * returned via tool_reference from tool search.
665
- */
666
- defer_loading?: boolean;
667
-
668
- /**
669
- * When true, guarantees schema validation on tool names and inputs
1973
+ * Per-member configuration for `computer_toolset_20260801`: one optional field per
1974
+ * member tool, keyed by the member name — the same name the member's `tool_use`
1975
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
1976
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
1977
+ * toolset version's complete member set.
670
1978
  */
671
- strict?: boolean;
1979
+ configs?: ComputerToolsetConfigs | null;
672
1980
  }
673
1981
 
674
1982
  /**
675
- * Code execution tool with REPL state persistence (daemon mode + gVisor
676
- * checkpoint).
1983
+ * Per-member configuration for `computer_toolset_20260801`: one optional field per
1984
+ * member tool, keyed by the member name — the same name the member's `tool_use`
1985
+ * blocks carry. Every member is an accepted key, and a member's defaults apply
1986
+ * wherever its key is absent. Unknown keys are rejected: the field set is this
1987
+ * toolset version's complete member set.
677
1988
  */
678
- export interface CodeExecutionTool20260120 {
1989
+ export interface ComputerToolsetConfigs {
679
1990
  /**
680
- * Name of the tool.
681
- *
682
- * This is how the tool will be called by the model and in `tool_use` blocks.
1991
+ * `cursor_position`'s config overrides.
683
1992
  */
684
- name: 'code_execution';
1993
+ cursor_position?: ComputerCursorPositionConfig | null;
685
1994
 
686
- type: 'code_execution_20260120';
1995
+ /**
1996
+ * `double_click`'s config overrides.
1997
+ */
1998
+ double_click?: ComputerDoubleClickConfig | null;
687
1999
 
688
- allowed_callers?: Array<
689
- 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
690
- >;
2000
+ /**
2001
+ * `hold_key`'s config overrides.
2002
+ */
2003
+ hold_key?: ComputerHoldKeyConfig | null;
691
2004
 
692
2005
  /**
693
- * Create a cache control breakpoint at this content block.
2006
+ * `key`'s config overrides.
694
2007
  */
695
- cache_control?: CacheControlEphemeral | null;
2008
+ key?: ComputerKeyConfig | null;
696
2009
 
697
2010
  /**
698
- * If true, tool will not be included in initial system prompt. Only loaded when
699
- * returned via tool_reference from tool search.
2011
+ * `left_click`'s config overrides.
700
2012
  */
701
- defer_loading?: boolean;
2013
+ left_click?: ComputerLeftClickConfig | null;
702
2014
 
703
2015
  /**
704
- * When true, guarantees schema validation on tool names and inputs
2016
+ * `left_click_drag`'s config overrides.
705
2017
  */
706
- strict?: boolean;
707
- }
2018
+ left_click_drag?: ComputerLeftClickDragConfig | null;
708
2019
 
709
- /**
710
- * Code execution tool with REPL state persistence.
711
- */
712
- export interface CodeExecutionTool20260521 {
713
2020
  /**
714
- * Name of the tool.
715
- *
716
- * This is how the tool will be called by the model and in `tool_use` blocks.
2021
+ * `left_mouse_down`'s config overrides.
717
2022
  */
718
- name: 'code_execution';
2023
+ left_mouse_down?: ComputerLeftMouseDownConfig | null;
719
2024
 
720
- type: 'code_execution_20260521';
2025
+ /**
2026
+ * `left_mouse_up`'s config overrides.
2027
+ */
2028
+ left_mouse_up?: ComputerLeftMouseUpConfig | null;
721
2029
 
722
- allowed_callers?: Array<
723
- 'direct' | 'code_execution_20250825' | 'code_execution_20260120' | 'code_execution_20260521'
724
- >;
2030
+ /**
2031
+ * `middle_click`'s config overrides.
2032
+ */
2033
+ middle_click?: ComputerMiddleClickConfig | null;
725
2034
 
726
2035
  /**
727
- * Create a cache control breakpoint at this content block.
2036
+ * `mouse_move`'s config overrides.
728
2037
  */
729
- cache_control?: CacheControlEphemeral | null;
2038
+ mouse_move?: ComputerMouseMoveConfig | null;
730
2039
 
731
2040
  /**
732
- * If true, tool will not be included in initial system prompt. Only loaded when
733
- * returned via tool_reference from tool search.
2041
+ * `right_click`'s config overrides.
734
2042
  */
735
- defer_loading?: boolean;
2043
+ right_click?: ComputerRightClickConfig | null;
736
2044
 
737
2045
  /**
738
- * When true, guarantees schema validation on tool names and inputs
2046
+ * `screenshot`'s config overrides.
739
2047
  */
740
- strict?: boolean;
741
- }
2048
+ screenshot?: ComputerScreenshotConfig | null;
742
2049
 
743
- export interface CodeExecutionToolResultBlock {
744
2050
  /**
745
- * Code execution result with encrypted stdout for PFC + web_search results.
2051
+ * `scroll`'s config overrides.
746
2052
  */
747
- content: CodeExecutionToolResultBlockContent;
2053
+ scroll?: ComputerScrollConfig | null;
748
2054
 
749
- tool_use_id: string;
2055
+ /**
2056
+ * `triple_click`'s config overrides.
2057
+ */
2058
+ triple_click?: ComputerTripleClickConfig | null;
750
2059
 
751
- type: 'code_execution_tool_result';
2060
+ /**
2061
+ * `type`'s config overrides.
2062
+ */
2063
+ type?: ComputerTypeConfig | null;
2064
+
2065
+ /**
2066
+ * `wait`'s config overrides.
2067
+ */
2068
+ wait?: ComputerWaitConfig | null;
2069
+
2070
+ /**
2071
+ * `zoom`'s config overrides.
2072
+ */
2073
+ zoom?: ComputerZoomConfig | null;
752
2074
  }
753
2075
 
754
2076
  /**
755
- * Code execution result with encrypted stdout for PFC + web_search results.
2077
+ * `triple_click`'s config overrides.
756
2078
  */
757
- export type CodeExecutionToolResultBlockContent =
758
- | CodeExecutionToolResultError
759
- | CodeExecutionResultBlock
760
- | EncryptedCodeExecutionResultBlock;
761
-
762
- export interface CodeExecutionToolResultBlockParam {
2079
+ export interface ComputerTripleClickConfig {
763
2080
  /**
764
- * Code execution result with encrypted stdout for PFC + web_search results.
2081
+ * Defer loading for this member. Must resolve to the same value on every enabled
2082
+ * member of the toolset.
765
2083
  */
766
- content: CodeExecutionToolResultBlockParamContent;
2084
+ defer_loading?: boolean | null;
767
2085
 
768
- tool_use_id: string;
2086
+ /**
2087
+ * Whether this member is offered to the model. Default is per member, per the
2088
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2089
+ * the served schema.
2090
+ */
2091
+ enabled?: boolean | null;
2092
+ }
769
2093
 
770
- type: 'code_execution_tool_result';
2094
+ /**
2095
+ * `type`'s config overrides.
2096
+ */
2097
+ export interface ComputerTypeConfig {
2098
+ /**
2099
+ * Defer loading for this member. Must resolve to the same value on every enabled
2100
+ * member of the toolset.
2101
+ */
2102
+ defer_loading?: boolean | null;
771
2103
 
772
2104
  /**
773
- * Create a cache control breakpoint at this content block.
2105
+ * Whether this member is offered to the model. Default is per member, per the
2106
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2107
+ * the served schema.
774
2108
  */
775
- cache_control?: CacheControlEphemeral | null;
2109
+ enabled?: boolean | null;
776
2110
  }
777
2111
 
778
2112
  /**
779
- * Code execution result with encrypted stdout for PFC + web_search results.
2113
+ * `wait`'s config overrides.
780
2114
  */
781
- export type CodeExecutionToolResultBlockParamContent =
782
- | CodeExecutionToolResultErrorParam
783
- | CodeExecutionResultBlockParam
784
- | EncryptedCodeExecutionResultBlockParam;
785
-
786
- export interface CodeExecutionToolResultError {
787
- error_code: CodeExecutionToolResultErrorCode;
2115
+ export interface ComputerWaitConfig {
2116
+ /**
2117
+ * Defer loading for this member. Must resolve to the same value on every enabled
2118
+ * member of the toolset.
2119
+ */
2120
+ defer_loading?: boolean | null;
788
2121
 
789
- type: 'code_execution_tool_result_error';
2122
+ /**
2123
+ * Whether this member is offered to the model. Default is per member, per the
2124
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2125
+ * the served schema.
2126
+ */
2127
+ enabled?: boolean | null;
790
2128
  }
791
2129
 
792
- export type CodeExecutionToolResultErrorCode =
793
- | 'invalid_tool_input'
794
- | 'unavailable'
795
- | 'too_many_requests'
796
- | 'execution_time_exceeded';
797
-
798
- export interface CodeExecutionToolResultErrorParam {
799
- error_code: CodeExecutionToolResultErrorCode;
2130
+ /**
2131
+ * `zoom`'s config overrides.
2132
+ */
2133
+ export interface ComputerZoomConfig {
2134
+ /**
2135
+ * Defer loading for this member. Must resolve to the same value on every enabled
2136
+ * member of the toolset.
2137
+ */
2138
+ defer_loading?: boolean | null;
800
2139
 
801
- type: 'code_execution_tool_result_error';
2140
+ /**
2141
+ * Whether this member is offered to the model. Default is per member, per the
2142
+ * toolset's documentation. A member whose enabled resolves false is withheld from
2143
+ * the served schema.
2144
+ */
2145
+ enabled?: boolean | null;
802
2146
  }
803
2147
 
804
2148
  /**
@@ -815,6 +2159,46 @@ export interface Container {
815
2159
  * The time at which the container will expire.
816
2160
  */
817
2161
  expires_at: string;
2162
+
2163
+ /**
2164
+ * Skills loaded in the container
2165
+ */
2166
+ skills: Array<ContainerSkill> | null;
2167
+ }
2168
+
2169
+ /**
2170
+ * Container parameters with skills to be loaded.
2171
+ */
2172
+ export interface ContainerParams {
2173
+ /**
2174
+ * Container id
2175
+ */
2176
+ id?: string | null;
2177
+
2178
+ /**
2179
+ * List of skills to load in the container
2180
+ */
2181
+ skills?: Array<SkillParams> | null;
2182
+ }
2183
+
2184
+ /**
2185
+ * A skill that was loaded in a container (response model).
2186
+ */
2187
+ export interface ContainerSkill {
2188
+ /**
2189
+ * Skill ID
2190
+ */
2191
+ skill_id: string;
2192
+
2193
+ /**
2194
+ * Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
2195
+ */
2196
+ type: 'anthropic' | 'custom';
2197
+
2198
+ /**
2199
+ * Skill version or 'latest' for most recent version
2200
+ */
2201
+ version: string;
818
2202
  }
819
2203
 
820
2204
  /**
@@ -877,8 +2261,7 @@ export type ContentBlockParam =
877
2261
  | BashCodeExecutionToolResultBlockParam
878
2262
  | TextEditorCodeExecutionToolResultBlockParam
879
2263
  | ToolSearchToolResultBlockParam
880
- | ContainerUploadBlockParam
881
- | MidConversationSystemBlockParam;
2264
+ | ContainerUploadBlockParam;
882
2265
 
883
2266
  export interface ContentBlockSource {
884
2267
  content: string | Array<ContentBlockSourceContent>;
@@ -912,7 +2295,7 @@ export interface DocumentBlock {
912
2295
  }
913
2296
 
914
2297
  export interface DocumentBlockParam {
915
- source: Base64PDFSource | PlainTextSource | ContentBlockSource | URLPDFSource;
2298
+ source: Base64PDFSource | PlainTextSource | ContentBlockSource | URLPDFSource | FileDocumentSource;
916
2299
 
917
2300
  type: 'document';
918
2301
 
@@ -958,8 +2341,20 @@ export interface EncryptedCodeExecutionResultBlockParam {
958
2341
  type: 'encrypted_code_execution_result';
959
2342
  }
960
2343
 
2344
+ export interface FileDocumentSource {
2345
+ file_id: string;
2346
+
2347
+ type: 'file';
2348
+ }
2349
+
2350
+ export interface FileImageSource {
2351
+ file_id: string;
2352
+
2353
+ type: 'file';
2354
+ }
2355
+
961
2356
  export interface ImageBlockParam {
962
- source: Base64ImageSource | URLImageSource;
2357
+ source: Base64ImageSource | URLImageSource | FileImageSource;
963
2358
 
964
2359
  type: 'image';
965
2360
 
@@ -967,6 +2362,32 @@ export interface ImageBlockParam {
967
2362
  * Create a cache control breakpoint at this content block.
968
2363
  */
969
2364
  cache_control?: CacheControlEphemeral | null;
2365
+
2366
+ /**
2367
+ * Configures the transformations the server applies to this image before the model
2368
+ * observes it. Each key names a condition the server transforms images for; its
2369
+ * value selects the transformation applied. Omitted keys keep their default
2370
+ * behavior, and an empty object is equivalent to omitting the field.
2371
+ */
2372
+ transformations?: ImageTransformationsParam | null;
2373
+ }
2374
+
2375
+ /**
2376
+ * Configures the transformations the server applies to this image before the model
2377
+ * observes it. Each key names a condition the server transforms images for; its
2378
+ * value selects the transformation applied. Omitted keys keep their default
2379
+ * behavior, and an empty object is equivalent to omitting the field.
2380
+ */
2381
+ export interface ImageTransformationsParam {
2382
+ /**
2383
+ * What the server does when this image exceeds the model's maximum image size.
2384
+ * `"downsize"` (the default) scales the image down to fit, which changes the
2385
+ * dimensions the model observes without telling you. `"error"` instead rejects the
2386
+ * request with a 400 error naming the image's dimensions and the largest
2387
+ * dimensions that fit, so you can scale the image deliberately — your image is
2388
+ * never silently scaled down.
2389
+ */
2390
+ oversized_image?: 'downsize' | 'error';
970
2391
  }
971
2392
 
972
2393
  export interface InputJSONDelta {
@@ -1153,7 +2574,9 @@ export type MessageCountTokensTool =
1153
2574
  | CodeExecutionTool20250825
1154
2575
  | CodeExecutionTool20260120
1155
2576
  | CodeExecutionTool20260521
2577
+ | BrowserToolset20260801
1156
2578
  | MemoryTool20250818
2579
+ | ComputerToolset20260801
1157
2580
  | ToolTextEditor20250124
1158
2581
  | ToolTextEditor20250429
1159
2582
  | ToolTextEditor20250728
@@ -1167,6 +2590,11 @@ export type MessageCountTokensTool =
1167
2590
  | ToolSearchToolBm25_20251119
1168
2591
  | ToolSearchToolRegex20251119;
1169
2592
 
2593
+ /**
2594
+ * Container identifier for reuse across requests.
2595
+ */
2596
+ export type MessageCreateParamsContainer = ContainerParams | string;
2597
+
1170
2598
  export interface MessageDeltaUsage {
1171
2599
  /**
1172
2600
  * The cumulative number of input tokens used to create the cache entry.
@@ -1229,27 +2657,6 @@ export interface Metadata {
1229
2657
  user_id?: string | null;
1230
2658
  }
1231
2659
 
1232
- /**
1233
- * System instructions that appear mid-conversation.
1234
- *
1235
- * Use this block to provide or update system-level instructions at a specific
1236
- * point in the conversation, rather than only via the top-level `system`
1237
- * parameter.
1238
- */
1239
- export interface MidConversationSystemBlockParam {
1240
- /**
1241
- * System instruction text blocks.
1242
- */
1243
- content: Array<TextBlockParam>;
1244
-
1245
- type: 'mid_conv_system';
1246
-
1247
- /**
1248
- * Create a cache control breakpoint at this content block.
1249
- */
1250
- cache_control?: CacheControlEphemeral | null;
1251
- }
1252
-
1253
2660
  /**
1254
2661
  * The model that will complete your prompt.
1255
2662
  *
@@ -1587,6 +2994,26 @@ export interface SignatureDelta {
1587
2994
  type: 'signature_delta';
1588
2995
  }
1589
2996
 
2997
+ /**
2998
+ * Specification for a skill to be loaded in a container (request model).
2999
+ */
3000
+ export interface SkillParams {
3001
+ /**
3002
+ * Skill ID
3003
+ */
3004
+ skill_id: string;
3005
+
3006
+ /**
3007
+ * Type of skill - either 'anthropic' (built-in) or 'custom' (user-defined)
3008
+ */
3009
+ type: 'anthropic' | 'custom';
3010
+
3011
+ /**
3012
+ * Skill version or 'latest' for most recent version
3013
+ */
3014
+ version?: string;
3015
+ }
3016
+
1590
3017
  export type StopReason =
1591
3018
  | 'end_turn'
1592
3019
  | 'max_tokens'
@@ -2082,9 +3509,15 @@ export interface ToolResultBlockParam {
2082
3509
  | SearchResultBlockParam
2083
3510
  | DocumentBlockParam
2084
3511
  | ToolReferenceBlockParam
3512
+ | BrowserStateBlockParam
2085
3513
  >;
2086
3514
 
2087
3515
  is_error?: boolean;
3516
+
3517
+ /**
3518
+ * For a toolset member tool_result, the toolset family of the paired tool_use.
3519
+ */
3520
+ toolset_name?: string | null;
2088
3521
  }
2089
3522
 
2090
3523
  export interface ToolSearchToolBm25_20251119 {
@@ -2320,7 +3753,9 @@ export type ToolUnion =
2320
3753
  | CodeExecutionTool20250825
2321
3754
  | CodeExecutionTool20260120
2322
3755
  | CodeExecutionTool20260521
3756
+ | BrowserToolset20260801
2323
3757
  | MemoryTool20250818
3758
+ | ComputerToolset20260801
2324
3759
  | ToolTextEditor20250124
2325
3760
  | ToolTextEditor20250429
2326
3761
  | ToolTextEditor20250728
@@ -2347,6 +3782,11 @@ export interface ToolUseBlock {
2347
3782
  name: string;
2348
3783
 
2349
3784
  type: 'tool_use';
3785
+
3786
+ /**
3787
+ * For a toolset member tool_use, the toolset family.
3788
+ */
3789
+ toolset_name?: string | null;
2350
3790
  }
2351
3791
 
2352
3792
  export interface ToolUseBlockParam {
@@ -2367,6 +3807,11 @@ export interface ToolUseBlockParam {
2367
3807
  * Tool invocation directly from the model.
2368
3808
  */
2369
3809
  caller?: DirectCaller | ServerToolCaller | ServerToolCaller20260120;
3810
+
3811
+ /**
3812
+ * For a toolset member tool_use, the toolset family this member belongs to.
3813
+ */
3814
+ toolset_name?: string | null;
2370
3815
  }
2371
3816
 
2372
3817
  export interface URLImageSource {
@@ -3195,7 +4640,7 @@ export interface MessageCreateParamsBase {
3195
4640
  /**
3196
4641
  * Body param: Container identifier for reuse across requests.
3197
4642
  */
3198
- container?: string | null;
4643
+ container?: MessageCreateParamsContainer | null;
3199
4644
 
3200
4645
  /**
3201
4646
  * Body param: Specifies the geographic region for inference processing. If not
@@ -3635,6 +5080,46 @@ export declare namespace Messages {
3635
5080
  type BashCodeExecutionToolResultError as BashCodeExecutionToolResultError,
3636
5081
  type BashCodeExecutionToolResultErrorCode as BashCodeExecutionToolResultErrorCode,
3637
5082
  type BashCodeExecutionToolResultErrorParam as BashCodeExecutionToolResultErrorParam,
5083
+ type BrowserCloseTabConfig as BrowserCloseTabConfig,
5084
+ type BrowserDoubleClickConfig as BrowserDoubleClickConfig,
5085
+ type BrowserFileUploadConfig as BrowserFileUploadConfig,
5086
+ type BrowserFindConfig as BrowserFindConfig,
5087
+ type BrowserFormInputConfig as BrowserFormInputConfig,
5088
+ type BrowserGetPageTextConfig as BrowserGetPageTextConfig,
5089
+ type BrowserHoldKeyConfig as BrowserHoldKeyConfig,
5090
+ type BrowserHoverConfig as BrowserHoverConfig,
5091
+ type BrowserJavascriptExecConfig as BrowserJavascriptExecConfig,
5092
+ type BrowserKeyConfig as BrowserKeyConfig,
5093
+ type BrowserLeftClickConfig as BrowserLeftClickConfig,
5094
+ type BrowserLeftClickDragConfig as BrowserLeftClickDragConfig,
5095
+ type BrowserLeftMouseDownConfig as BrowserLeftMouseDownConfig,
5096
+ type BrowserLeftMouseUpConfig as BrowserLeftMouseUpConfig,
5097
+ type BrowserListTabsConfig as BrowserListTabsConfig,
5098
+ type BrowserMiddleClickConfig as BrowserMiddleClickConfig,
5099
+ type BrowserMouseMoveConfig as BrowserMouseMoveConfig,
5100
+ type BrowserNavigateConfig as BrowserNavigateConfig,
5101
+ type BrowserNewTabConfig as BrowserNewTabConfig,
5102
+ type BrowserReadConsoleConfig as BrowserReadConsoleConfig,
5103
+ type BrowserReadNetworkConfig as BrowserReadNetworkConfig,
5104
+ type BrowserReadPageConfig as BrowserReadPageConfig,
5105
+ type BrowserRightClickConfig as BrowserRightClickConfig,
5106
+ type BrowserScreenshotConfig as BrowserScreenshotConfig,
5107
+ type BrowserScrollConfig as BrowserScrollConfig,
5108
+ type BrowserScrollToConfig as BrowserScrollToConfig,
5109
+ type BrowserStateBlockParam as BrowserStateBlockParam,
5110
+ type BrowserStateChange as BrowserStateChange,
5111
+ type BrowserStateChangeDownloadCompleted as BrowserStateChangeDownloadCompleted,
5112
+ type BrowserStateChangeDownloadFailed as BrowserStateChangeDownloadFailed,
5113
+ type BrowserStateChangeDownloadStarted as BrowserStateChangeDownloadStarted,
5114
+ type BrowserStateChangeTabOpened as BrowserStateChangeTabOpened,
5115
+ type BrowserStateTabEntry as BrowserStateTabEntry,
5116
+ type BrowserSwitchTabConfig as BrowserSwitchTabConfig,
5117
+ type BrowserToolset20260801 as BrowserToolset20260801,
5118
+ type BrowserToolsetConfigs as BrowserToolsetConfigs,
5119
+ type BrowserTripleClickConfig as BrowserTripleClickConfig,
5120
+ type BrowserTypeConfig as BrowserTypeConfig,
5121
+ type BrowserWaitConfig as BrowserWaitConfig,
5122
+ type BrowserZoomConfig as BrowserZoomConfig,
3638
5123
  type CacheControlEphemeral as CacheControlEphemeral,
3639
5124
  type CacheCreation as CacheCreation,
3640
5125
  type CitationCharLocation as CitationCharLocation,
@@ -3665,7 +5150,28 @@ export declare namespace Messages {
3665
5150
  type CodeExecutionToolResultError as CodeExecutionToolResultError,
3666
5151
  type CodeExecutionToolResultErrorCode as CodeExecutionToolResultErrorCode,
3667
5152
  type CodeExecutionToolResultErrorParam as CodeExecutionToolResultErrorParam,
5153
+ type ComputerCursorPositionConfig as ComputerCursorPositionConfig,
5154
+ type ComputerDoubleClickConfig as ComputerDoubleClickConfig,
5155
+ type ComputerHoldKeyConfig as ComputerHoldKeyConfig,
5156
+ type ComputerKeyConfig as ComputerKeyConfig,
5157
+ type ComputerLeftClickConfig as ComputerLeftClickConfig,
5158
+ type ComputerLeftClickDragConfig as ComputerLeftClickDragConfig,
5159
+ type ComputerLeftMouseDownConfig as ComputerLeftMouseDownConfig,
5160
+ type ComputerLeftMouseUpConfig as ComputerLeftMouseUpConfig,
5161
+ type ComputerMiddleClickConfig as ComputerMiddleClickConfig,
5162
+ type ComputerMouseMoveConfig as ComputerMouseMoveConfig,
5163
+ type ComputerRightClickConfig as ComputerRightClickConfig,
5164
+ type ComputerScreenshotConfig as ComputerScreenshotConfig,
5165
+ type ComputerScrollConfig as ComputerScrollConfig,
5166
+ type ComputerToolset20260801 as ComputerToolset20260801,
5167
+ type ComputerToolsetConfigs as ComputerToolsetConfigs,
5168
+ type ComputerTripleClickConfig as ComputerTripleClickConfig,
5169
+ type ComputerTypeConfig as ComputerTypeConfig,
5170
+ type ComputerWaitConfig as ComputerWaitConfig,
5171
+ type ComputerZoomConfig as ComputerZoomConfig,
3668
5172
  type Container as Container,
5173
+ type ContainerParams as ContainerParams,
5174
+ type ContainerSkill as ContainerSkill,
3669
5175
  type ContainerUploadBlock as ContainerUploadBlock,
3670
5176
  type ContainerUploadBlockParam as ContainerUploadBlockParam,
3671
5177
  type ContentBlock as ContentBlock,
@@ -3679,18 +5185,21 @@ export declare namespace Messages {
3679
5185
  type DocumentBlockParam as DocumentBlockParam,
3680
5186
  type EncryptedCodeExecutionResultBlock as EncryptedCodeExecutionResultBlock,
3681
5187
  type EncryptedCodeExecutionResultBlockParam as EncryptedCodeExecutionResultBlockParam,
5188
+ type FileDocumentSource as FileDocumentSource,
5189
+ type FileImageSource as FileImageSource,
3682
5190
  type ImageBlockParam as ImageBlockParam,
5191
+ type ImageTransformationsParam as ImageTransformationsParam,
3683
5192
  type InputJSONDelta as InputJSONDelta,
3684
5193
  type JSONOutputFormat as JSONOutputFormat,
3685
5194
  type MemoryTool20250818 as MemoryTool20250818,
3686
5195
  type Message as Message,
3687
5196
  type MessageCountTokensTool as MessageCountTokensTool,
5197
+ type MessageCreateParamsContainer as MessageCreateParamsContainer,
3688
5198
  type MessageDeltaEvent as MessageDeltaEvent,
3689
5199
  type MessageDeltaUsage as MessageDeltaUsage,
3690
5200
  type MessageParam as MessageParam,
3691
5201
  type MessageTokensCount as MessageTokensCount,
3692
5202
  type Metadata as Metadata,
3693
- type MidConversationSystemBlockParam as MidConversationSystemBlockParam,
3694
5203
  type Model as Model,
3695
5204
  type OutputConfig as OutputConfig,
3696
5205
  type OutputTokensDetails as OutputTokensDetails,
@@ -3713,6 +5222,7 @@ export declare namespace Messages {
3713
5222
  type ServerToolUseBlock as ServerToolUseBlock,
3714
5223
  type ServerToolUseBlockParam as ServerToolUseBlockParam,
3715
5224
  type SignatureDelta as SignatureDelta,
5225
+ type SkillParams as SkillParams,
3716
5226
  type StopReason as StopReason,
3717
5227
  type TextBlock as TextBlock,
3718
5228
  type TextBlockParam as TextBlockParam,