@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.
- package/CHANGELOG.md +36 -0
- package/client.d.mts +8 -2
- package/client.d.mts.map +1 -1
- package/client.d.ts +8 -2
- package/client.d.ts.map +1 -1
- package/client.js +7 -1
- package/client.js.map +1 -1
- package/client.mjs +7 -1
- package/client.mjs.map +1 -1
- package/core/api-promise.d.mts +1 -0
- package/core/api-promise.d.mts.map +1 -1
- package/core/api-promise.d.ts +1 -0
- package/core/api-promise.d.ts.map +1 -1
- package/core/api-promise.js +7 -2
- package/core/api-promise.js.map +1 -1
- package/core/api-promise.mjs +8 -3
- package/core/api-promise.mjs.map +1 -1
- package/core/error.d.mts +1 -0
- package/core/error.d.mts.map +1 -1
- package/core/error.d.ts +1 -0
- package/core/error.d.ts.map +1 -1
- package/core/error.js +1 -0
- package/core/error.js.map +1 -1
- package/core/error.mjs +1 -0
- package/core/error.mjs.map +1 -1
- package/core/middleware.js +1 -1
- package/core/middleware.js.map +1 -1
- package/core/middleware.mjs +2 -2
- package/core/middleware.mjs.map +1 -1
- package/helpers/beta/zod.d.mts.map +1 -1
- package/helpers/beta/zod.d.ts.map +1 -1
- package/helpers/beta/zod.js +1 -2
- package/helpers/beta/zod.js.map +1 -1
- package/helpers/beta/zod.mjs +1 -2
- package/helpers/beta/zod.mjs.map +1 -1
- package/helpers/zod.d.mts.map +1 -1
- package/helpers/zod.d.ts.map +1 -1
- package/helpers/zod.js +1 -2
- package/helpers/zod.js.map +1 -1
- package/helpers/zod.mjs +1 -2
- package/helpers/zod.mjs.map +1 -1
- package/internal/parse.d.mts +2 -1
- package/internal/parse.d.mts.map +1 -1
- package/internal/parse.d.ts +2 -1
- package/internal/parse.d.ts.map +1 -1
- package/internal/parse.js +6 -6
- package/internal/parse.js.map +1 -1
- package/internal/parse.mjs +5 -5
- package/internal/parse.mjs.map +1 -1
- package/lib/BetaMessageStream.d.mts +2 -0
- package/lib/BetaMessageStream.d.mts.map +1 -1
- package/lib/BetaMessageStream.d.ts +2 -0
- package/lib/BetaMessageStream.d.ts.map +1 -1
- package/lib/BetaMessageStream.js +8 -2
- package/lib/BetaMessageStream.js.map +1 -1
- package/lib/BetaMessageStream.mjs +8 -2
- package/lib/BetaMessageStream.mjs.map +1 -1
- package/lib/MessageStream.d.mts +2 -0
- package/lib/MessageStream.d.mts.map +1 -1
- package/lib/MessageStream.d.ts +2 -0
- package/lib/MessageStream.d.ts.map +1 -1
- package/lib/MessageStream.js +8 -2
- package/lib/MessageStream.js.map +1 -1
- package/lib/MessageStream.mjs +8 -2
- package/lib/MessageStream.mjs.map +1 -1
- package/lib/environments/worker.d.mts +10 -6
- package/lib/environments/worker.d.mts.map +1 -1
- package/lib/environments/worker.d.ts +10 -6
- package/lib/environments/worker.d.ts.map +1 -1
- package/lib/environments/worker.js +22 -15
- package/lib/environments/worker.js.map +1 -1
- package/lib/environments/worker.mjs +22 -15
- package/lib/environments/worker.mjs.map +1 -1
- package/lib/tools/BetaRunnableTool.d.mts +21 -40
- package/lib/tools/BetaRunnableTool.d.mts.map +1 -1
- package/lib/tools/BetaRunnableTool.d.ts +21 -40
- package/lib/tools/BetaRunnableTool.d.ts.map +1 -1
- package/lib/tools/BetaRunnableTool.js +7 -16
- package/lib/tools/BetaRunnableTool.js.map +1 -1
- package/lib/tools/BetaRunnableTool.mjs +7 -16
- package/lib/tools/BetaRunnableTool.mjs.map +1 -1
- package/lib/tools/BetaToolRunner.d.mts.map +1 -1
- package/lib/tools/BetaToolRunner.d.ts.map +1 -1
- package/lib/tools/BetaToolRunner.js +3 -13
- package/lib/tools/BetaToolRunner.js.map +1 -1
- package/lib/tools/BetaToolRunner.mjs +3 -13
- package/lib/tools/BetaToolRunner.mjs.map +1 -1
- package/lib/tools/SessionToolRunner.d.mts +6 -0
- package/lib/tools/SessionToolRunner.d.mts.map +1 -1
- package/lib/tools/SessionToolRunner.d.ts +6 -0
- package/lib/tools/SessionToolRunner.d.ts.map +1 -1
- package/lib/tools/SessionToolRunner.js +37 -8
- package/lib/tools/SessionToolRunner.js.map +1 -1
- package/lib/tools/SessionToolRunner.mjs +38 -9
- package/lib/tools/SessionToolRunner.mjs.map +1 -1
- package/package.json +1 -1
- package/resources/beta/agents/agents.d.mts +3 -3
- package/resources/beta/agents/agents.d.ts +3 -3
- package/resources/beta/agents/agents.js +1 -1
- package/resources/beta/agents/agents.mjs +1 -1
- package/resources/beta/beta.d.mts +5 -5
- package/resources/beta/beta.d.mts.map +1 -1
- package/resources/beta/beta.d.ts +5 -5
- package/resources/beta/beta.d.ts.map +1 -1
- package/resources/beta/beta.js.map +1 -1
- package/resources/beta/beta.mjs.map +1 -1
- package/resources/beta/dreams.d.mts +2 -2
- package/resources/beta/dreams.d.ts +2 -2
- package/resources/beta/environments/environments.d.mts +4 -3
- package/resources/beta/environments/environments.d.mts.map +1 -1
- package/resources/beta/environments/environments.d.ts +4 -3
- package/resources/beta/environments/environments.d.ts.map +1 -1
- package/resources/beta/environments/environments.js.map +1 -1
- package/resources/beta/environments/environments.mjs.map +1 -1
- package/resources/beta/files.d.mts +22 -22
- package/resources/beta/files.d.mts.map +1 -1
- package/resources/beta/files.d.ts +22 -22
- package/resources/beta/files.d.ts.map +1 -1
- package/resources/beta/files.js +4 -4
- package/resources/beta/files.js.map +1 -1
- package/resources/beta/files.mjs +4 -4
- package/resources/beta/files.mjs.map +1 -1
- package/resources/beta/index.d.mts +2 -2
- package/resources/beta/index.d.mts.map +1 -1
- package/resources/beta/index.d.ts +2 -2
- package/resources/beta/index.d.ts.map +1 -1
- package/resources/beta/index.js.map +1 -1
- package/resources/beta/index.mjs.map +1 -1
- package/resources/beta/memory-stores/index.d.mts +1 -1
- package/resources/beta/memory-stores/index.d.mts.map +1 -1
- package/resources/beta/memory-stores/index.d.ts +1 -1
- package/resources/beta/memory-stores/index.d.ts.map +1 -1
- package/resources/beta/memory-stores/index.js.map +1 -1
- package/resources/beta/memory-stores/index.mjs.map +1 -1
- package/resources/beta/memory-stores/memory-stores.d.mts +2 -2
- package/resources/beta/memory-stores/memory-stores.d.mts.map +1 -1
- package/resources/beta/memory-stores/memory-stores.d.ts +2 -2
- package/resources/beta/memory-stores/memory-stores.d.ts.map +1 -1
- package/resources/beta/memory-stores/memory-stores.js.map +1 -1
- package/resources/beta/memory-stores/memory-stores.mjs.map +1 -1
- package/resources/beta/memory-stores/memory-versions.d.mts +17 -2
- package/resources/beta/memory-stores/memory-versions.d.mts.map +1 -1
- package/resources/beta/memory-stores/memory-versions.d.ts +17 -2
- package/resources/beta/memory-stores/memory-versions.d.ts.map +1 -1
- package/resources/beta/messages/batches.d.mts +1 -1
- package/resources/beta/messages/batches.d.ts +1 -1
- package/resources/beta/messages/batches.js +1 -1
- package/resources/beta/messages/batches.mjs +1 -1
- package/resources/beta/messages/index.d.mts +1 -1
- package/resources/beta/messages/index.d.mts.map +1 -1
- package/resources/beta/messages/index.d.ts +1 -1
- package/resources/beta/messages/index.d.ts.map +1 -1
- package/resources/beta/messages/index.js.map +1 -1
- package/resources/beta/messages/index.mjs.map +1 -1
- package/resources/beta/messages/messages.d.mts +1204 -25
- package/resources/beta/messages/messages.d.mts.map +1 -1
- package/resources/beta/messages/messages.d.ts +1204 -25
- package/resources/beta/messages/messages.d.ts.map +1 -1
- package/resources/beta/messages/messages.js +1 -1
- package/resources/beta/messages/messages.js.map +1 -1
- package/resources/beta/messages/messages.mjs +1 -1
- package/resources/beta/messages/messages.mjs.map +1 -1
- package/resources/beta/sessions/sessions.d.mts +1 -1
- package/resources/beta/sessions/sessions.d.ts +1 -1
- package/resources/beta/user-profiles.d.mts +35 -9
- package/resources/beta/user-profiles.d.mts.map +1 -1
- package/resources/beta/user-profiles.d.ts +35 -9
- package/resources/beta/user-profiles.d.ts.map +1 -1
- package/resources/beta/user-profiles.js +5 -5
- package/resources/beta/user-profiles.mjs +5 -5
- package/resources/files.d.mts +105 -0
- package/resources/files.d.mts.map +1 -0
- package/resources/files.d.ts +105 -0
- package/resources/files.d.ts.map +1 -0
- package/resources/files.js +52 -0
- package/resources/files.js.map +1 -0
- package/resources/files.mjs +48 -0
- package/resources/files.mjs.map +1 -0
- package/resources/index.d.mts +3 -1
- package/resources/index.d.mts.map +1 -1
- package/resources/index.d.ts +3 -1
- package/resources/index.d.ts.map +1 -1
- package/resources/index.js +5 -1
- package/resources/index.js.map +1 -1
- package/resources/index.mjs +2 -0
- package/resources/index.mjs.map +1 -1
- package/resources/messages/batches.d.mts +1 -1
- package/resources/messages/batches.d.ts +1 -1
- package/resources/messages/batches.js +1 -1
- package/resources/messages/batches.mjs +1 -1
- package/resources/messages/index.d.mts +1 -1
- package/resources/messages/index.d.mts.map +1 -1
- package/resources/messages/index.d.ts +1 -1
- package/resources/messages/index.d.ts.map +1 -1
- package/resources/messages/index.js.map +1 -1
- package/resources/messages/index.mjs.map +1 -1
- package/resources/messages/messages.d.mts +1270 -28
- package/resources/messages/messages.d.mts.map +1 -1
- package/resources/messages/messages.d.ts +1270 -28
- package/resources/messages/messages.d.ts.map +1 -1
- package/resources/messages/messages.js +1 -1
- package/resources/messages/messages.js.map +1 -1
- package/resources/messages/messages.mjs +1 -1
- package/resources/messages/messages.mjs.map +1 -1
- package/resources/skills/index.d.mts +3 -0
- package/resources/skills/index.d.mts.map +1 -0
- package/resources/skills/index.d.ts +3 -0
- package/resources/skills/index.d.ts.map +1 -0
- package/resources/skills/index.js +9 -0
- package/resources/skills/index.js.map +1 -0
- package/resources/skills/index.mjs +4 -0
- package/resources/skills/index.mjs.map +1 -0
- package/resources/skills/skills.d.mts +129 -0
- package/resources/skills/skills.d.mts.map +1 -0
- package/resources/skills/skills.d.ts +129 -0
- package/resources/skills/skills.d.ts.map +1 -0
- package/resources/skills/skills.js +44 -0
- package/resources/skills/skills.js.map +1 -0
- package/resources/skills/skills.mjs +39 -0
- package/resources/skills/skills.mjs.map +1 -0
- package/resources/skills/versions.d.mts +104 -0
- package/resources/skills/versions.d.mts.map +1 -0
- package/resources/skills/versions.d.ts +104 -0
- package/resources/skills/versions.d.ts.map +1 -0
- package/resources/skills/versions.js +41 -0
- package/resources/skills/versions.js.map +1 -0
- package/resources/skills/versions.mjs +37 -0
- package/resources/skills/versions.mjs.map +1 -0
- package/resources/skills.d.mts +2 -0
- package/resources/skills.d.mts.map +1 -0
- package/resources/skills.d.ts +2 -0
- package/resources/skills.d.ts.map +1 -0
- package/resources/skills.js +6 -0
- package/resources/skills.js.map +1 -0
- package/resources/skills.mjs +3 -0
- package/resources/skills.mjs.map +1 -0
- package/src/client.ts +173 -3
- package/src/core/api-promise.ts +14 -4
- package/src/core/error.ts +2 -0
- package/src/core/middleware.ts +2 -2
- package/src/helpers/beta/zod.ts +1 -3
- package/src/helpers/zod.ts +1 -3
- package/src/internal/parse.ts +6 -6
- package/src/lib/BetaMessageStream.ts +8 -0
- package/src/lib/MessageStream.ts +8 -0
- package/src/lib/environments/worker.ts +28 -14
- package/src/lib/tools/BetaRunnableTool.ts +26 -43
- package/src/lib/tools/BetaToolRunner.ts +6 -13
- package/src/lib/tools/SessionToolRunner.ts +39 -6
- package/src/resources/beta/agents/agents.ts +3 -3
- package/src/resources/beta/beta.ts +127 -8
- package/src/resources/beta/dreams.ts +2 -2
- package/src/resources/beta/environments/environments.ts +4 -3
- package/src/resources/beta/files.ts +27 -27
- package/src/resources/beta/index.ts +63 -4
- package/src/resources/beta/memory-stores/index.ts +1 -0
- package/src/resources/beta/memory-stores/memory-stores.ts +2 -0
- package/src/resources/beta/memory-stores/memory-versions.ts +21 -1
- package/src/resources/beta/messages/batches.ts +1 -1
- package/src/resources/beta/messages/index.ts +60 -1
- package/src/resources/beta/messages/messages.ts +1862 -435
- package/src/resources/beta/sessions/sessions.ts +1 -1
- package/src/resources/beta/user-profiles.ts +44 -15
- package/src/resources/files.ts +163 -0
- package/src/resources/index.ts +83 -1
- package/src/resources/messages/batches.ts +1 -1
- package/src/resources/messages/index.ts +66 -1
- package/src/resources/messages/messages.ts +1830 -320
- package/src/resources/skills/index.ts +21 -0
- package/src/resources/skills/skills.ts +194 -0
- package/src/resources/skills/versions.ts +160 -0
- package/src/resources/skills.ts +3 -0
- package/src/version.ts +1 -1
- package/version.d.mts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- 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-
|
|
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-
|
|
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
|
-
|
|
294
|
-
|
|
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
|
-
*
|
|
298
|
-
*
|
|
299
|
-
*
|
|
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
|
-
|
|
308
|
+
enabled?: boolean | null;
|
|
309
309
|
}
|
|
310
310
|
|
|
311
|
-
|
|
311
|
+
/**
|
|
312
|
+
* `double_click`'s config overrides.
|
|
313
|
+
*/
|
|
314
|
+
export interface BrowserDoubleClickConfig {
|
|
312
315
|
/**
|
|
313
|
-
*
|
|
316
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
317
|
+
* member of the toolset.
|
|
314
318
|
*/
|
|
315
|
-
|
|
319
|
+
defer_loading?: boolean | null;
|
|
316
320
|
|
|
317
321
|
/**
|
|
318
|
-
*
|
|
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
|
-
|
|
326
|
+
enabled?: boolean | null;
|
|
321
327
|
}
|
|
322
328
|
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
340
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
437
|
+
/**
|
|
438
|
+
* `javascript_exec`'s config overrides.
|
|
439
|
+
*/
|
|
440
|
+
export interface BrowserJavascriptExecConfig {
|
|
354
441
|
/**
|
|
355
|
-
*
|
|
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
|
-
|
|
363
|
-
|
|
364
|
-
document_index: number;
|
|
445
|
+
defer_loading?: boolean | null;
|
|
365
446
|
|
|
366
|
-
|
|
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
|
-
*
|
|
370
|
-
*
|
|
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
|
-
|
|
463
|
+
defer_loading?: boolean | null;
|
|
376
464
|
|
|
377
|
-
|
|
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
|
-
*
|
|
478
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
479
|
+
* member of the toolset.
|
|
381
480
|
*/
|
|
382
|
-
|
|
481
|
+
defer_loading?: boolean | null;
|
|
383
482
|
|
|
384
|
-
|
|
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
|
-
|
|
491
|
+
/**
|
|
492
|
+
* `left_click_drag`'s config overrides.
|
|
493
|
+
*/
|
|
494
|
+
export interface BrowserLeftClickDragConfig {
|
|
388
495
|
/**
|
|
389
|
-
*
|
|
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
|
-
|
|
499
|
+
defer_loading?: boolean | null;
|
|
397
500
|
|
|
398
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
404
|
-
*
|
|
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
|
-
|
|
524
|
+
enabled?: boolean | null;
|
|
525
|
+
}
|
|
410
526
|
|
|
527
|
+
/**
|
|
528
|
+
* `left_mouse_up`'s config overrides.
|
|
529
|
+
*/
|
|
530
|
+
export interface BrowserLeftMouseUpConfig {
|
|
411
531
|
/**
|
|
412
|
-
*
|
|
532
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
533
|
+
* member of the toolset.
|
|
413
534
|
*/
|
|
414
|
-
|
|
535
|
+
defer_loading?: boolean | null;
|
|
415
536
|
|
|
416
|
-
|
|
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
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
436
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
653
|
+
/**
|
|
654
|
+
* `read_network`'s config overrides.
|
|
655
|
+
*/
|
|
656
|
+
export interface BrowserReadNetworkConfig {
|
|
450
657
|
/**
|
|
451
|
-
*
|
|
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
|
-
|
|
661
|
+
defer_loading?: boolean | null;
|
|
459
662
|
|
|
460
663
|
/**
|
|
461
|
-
*
|
|
462
|
-
*
|
|
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
|
-
|
|
668
|
+
enabled?: boolean | null;
|
|
669
|
+
}
|
|
468
670
|
|
|
671
|
+
/**
|
|
672
|
+
* `read_page`'s config overrides.
|
|
673
|
+
*/
|
|
674
|
+
export interface BrowserReadPageConfig {
|
|
469
675
|
/**
|
|
470
|
-
*
|
|
471
|
-
*
|
|
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
|
-
|
|
478
|
-
|
|
479
|
-
source: string;
|
|
679
|
+
defer_loading?: boolean | null;
|
|
480
680
|
|
|
481
681
|
/**
|
|
482
|
-
*
|
|
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
|
-
|
|
686
|
+
enabled?: boolean | null;
|
|
687
|
+
}
|
|
485
688
|
|
|
486
|
-
|
|
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
|
-
|
|
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
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
501
|
-
|
|
1540
|
+
/**
|
|
1541
|
+
* Create a cache control breakpoint at this content block.
|
|
1542
|
+
*/
|
|
1543
|
+
cache_control?: CacheControlEphemeral | null;
|
|
502
1544
|
|
|
503
|
-
|
|
504
|
-
|
|
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
|
-
|
|
508
|
-
|
|
1551
|
+
/**
|
|
1552
|
+
* When true, guarantees schema validation on tool names and inputs
|
|
1553
|
+
*/
|
|
1554
|
+
strict?: boolean;
|
|
509
1555
|
}
|
|
510
1556
|
|
|
511
|
-
export interface
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
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: '
|
|
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
|
-
|
|
1588
|
+
/**
|
|
1589
|
+
* Code execution tool with REPL state persistence (daemon mode + gVisor
|
|
1590
|
+
* checkpoint).
|
|
1591
|
+
*/
|
|
1592
|
+
export interface CodeExecutionTool20260120 {
|
|
523
1593
|
/**
|
|
524
|
-
*
|
|
1594
|
+
* Name of the tool.
|
|
525
1595
|
*
|
|
526
|
-
*
|
|
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
|
-
|
|
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
|
-
*
|
|
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
|
-
|
|
1609
|
+
cache_control?: CacheControlEphemeral | null;
|
|
541
1610
|
|
|
542
1611
|
/**
|
|
543
|
-
*
|
|
544
|
-
*
|
|
545
|
-
|
|
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
|
-
*
|
|
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
|
-
|
|
1632
|
+
name: 'code_execution';
|
|
551
1633
|
|
|
552
|
-
|
|
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
|
-
*
|
|
1641
|
+
* Create a cache control breakpoint at this content block.
|
|
556
1642
|
*/
|
|
557
|
-
|
|
1643
|
+
cache_control?: CacheControlEphemeral | null;
|
|
558
1644
|
|
|
559
|
-
|
|
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
|
-
|
|
1651
|
+
/**
|
|
1652
|
+
* When true, guarantees schema validation on tool names and inputs
|
|
1653
|
+
*/
|
|
1654
|
+
strict?: boolean;
|
|
562
1655
|
}
|
|
563
1656
|
|
|
564
|
-
export interface
|
|
565
|
-
|
|
1657
|
+
export interface CodeExecutionToolResultBlock {
|
|
1658
|
+
/**
|
|
1659
|
+
* Code execution result with encrypted stdout for PFC + web_search results.
|
|
1660
|
+
*/
|
|
1661
|
+
content: CodeExecutionToolResultBlockContent;
|
|
566
1662
|
|
|
567
|
-
|
|
1663
|
+
tool_use_id: string;
|
|
568
1664
|
|
|
569
|
-
|
|
1665
|
+
type: 'code_execution_tool_result';
|
|
1666
|
+
}
|
|
570
1667
|
|
|
571
|
-
|
|
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
|
-
|
|
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
|
-
|
|
577
|
-
|
|
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
|
-
|
|
1700
|
+
export interface CodeExecutionToolResultError {
|
|
1701
|
+
error_code: CodeExecutionToolResultErrorCode;
|
|
1702
|
+
|
|
1703
|
+
type: 'code_execution_tool_result_error';
|
|
580
1704
|
}
|
|
581
1705
|
|
|
582
|
-
export
|
|
583
|
-
|
|
1706
|
+
export type CodeExecutionToolResultErrorCode =
|
|
1707
|
+
| 'invalid_tool_input'
|
|
1708
|
+
| 'unavailable'
|
|
1709
|
+
| 'too_many_requests'
|
|
1710
|
+
| 'execution_time_exceeded';
|
|
584
1711
|
|
|
585
|
-
|
|
1712
|
+
export interface CodeExecutionToolResultErrorParam {
|
|
1713
|
+
error_code: CodeExecutionToolResultErrorCode;
|
|
1714
|
+
|
|
1715
|
+
type: 'code_execution_tool_result_error';
|
|
586
1716
|
}
|
|
587
1717
|
|
|
588
|
-
|
|
589
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
601
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
1880
|
+
/**
|
|
1881
|
+
* `mouse_move`'s config overrides.
|
|
1882
|
+
*/
|
|
1883
|
+
export interface ComputerMouseMoveConfig {
|
|
613
1884
|
/**
|
|
614
|
-
*
|
|
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
|
-
|
|
1888
|
+
defer_loading?: boolean | null;
|
|
619
1889
|
|
|
620
|
-
|
|
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
|
-
|
|
623
|
-
|
|
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
|
-
*
|
|
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
|
-
|
|
1913
|
+
enabled?: boolean | null;
|
|
1914
|
+
}
|
|
630
1915
|
|
|
1916
|
+
/**
|
|
1917
|
+
* `screenshot`'s config overrides.
|
|
1918
|
+
*/
|
|
1919
|
+
export interface ComputerScreenshotConfig {
|
|
631
1920
|
/**
|
|
632
|
-
*
|
|
633
|
-
*
|
|
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
|
-
*
|
|
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
|
-
|
|
1931
|
+
enabled?: boolean | null;
|
|
641
1932
|
}
|
|
642
1933
|
|
|
643
|
-
|
|
1934
|
+
/**
|
|
1935
|
+
* `scroll`'s config overrides.
|
|
1936
|
+
*/
|
|
1937
|
+
export interface ComputerScrollConfig {
|
|
644
1938
|
/**
|
|
645
|
-
*
|
|
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
|
-
|
|
1942
|
+
defer_loading?: boolean | null;
|
|
650
1943
|
|
|
651
|
-
|
|
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
|
-
*
|
|
664
|
-
*
|
|
665
|
-
|
|
666
|
-
|
|
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
|
-
|
|
1979
|
+
configs?: ComputerToolsetConfigs | null;
|
|
672
1980
|
}
|
|
673
1981
|
|
|
674
1982
|
/**
|
|
675
|
-
*
|
|
676
|
-
*
|
|
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
|
|
1989
|
+
export interface ComputerToolsetConfigs {
|
|
679
1990
|
/**
|
|
680
|
-
*
|
|
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
|
-
|
|
1993
|
+
cursor_position?: ComputerCursorPositionConfig | null;
|
|
685
1994
|
|
|
686
|
-
|
|
1995
|
+
/**
|
|
1996
|
+
* `double_click`'s config overrides.
|
|
1997
|
+
*/
|
|
1998
|
+
double_click?: ComputerDoubleClickConfig | null;
|
|
687
1999
|
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
2000
|
+
/**
|
|
2001
|
+
* `hold_key`'s config overrides.
|
|
2002
|
+
*/
|
|
2003
|
+
hold_key?: ComputerHoldKeyConfig | null;
|
|
691
2004
|
|
|
692
2005
|
/**
|
|
693
|
-
*
|
|
2006
|
+
* `key`'s config overrides.
|
|
694
2007
|
*/
|
|
695
|
-
|
|
2008
|
+
key?: ComputerKeyConfig | null;
|
|
696
2009
|
|
|
697
2010
|
/**
|
|
698
|
-
*
|
|
699
|
-
* returned via tool_reference from tool search.
|
|
2011
|
+
* `left_click`'s config overrides.
|
|
700
2012
|
*/
|
|
701
|
-
|
|
2013
|
+
left_click?: ComputerLeftClickConfig | null;
|
|
702
2014
|
|
|
703
2015
|
/**
|
|
704
|
-
*
|
|
2016
|
+
* `left_click_drag`'s config overrides.
|
|
705
2017
|
*/
|
|
706
|
-
|
|
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
|
-
*
|
|
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
|
-
|
|
2023
|
+
left_mouse_down?: ComputerLeftMouseDownConfig | null;
|
|
719
2024
|
|
|
720
|
-
|
|
2025
|
+
/**
|
|
2026
|
+
* `left_mouse_up`'s config overrides.
|
|
2027
|
+
*/
|
|
2028
|
+
left_mouse_up?: ComputerLeftMouseUpConfig | null;
|
|
721
2029
|
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
2030
|
+
/**
|
|
2031
|
+
* `middle_click`'s config overrides.
|
|
2032
|
+
*/
|
|
2033
|
+
middle_click?: ComputerMiddleClickConfig | null;
|
|
725
2034
|
|
|
726
2035
|
/**
|
|
727
|
-
*
|
|
2036
|
+
* `mouse_move`'s config overrides.
|
|
728
2037
|
*/
|
|
729
|
-
|
|
2038
|
+
mouse_move?: ComputerMouseMoveConfig | null;
|
|
730
2039
|
|
|
731
2040
|
/**
|
|
732
|
-
*
|
|
733
|
-
* returned via tool_reference from tool search.
|
|
2041
|
+
* `right_click`'s config overrides.
|
|
734
2042
|
*/
|
|
735
|
-
|
|
2043
|
+
right_click?: ComputerRightClickConfig | null;
|
|
736
2044
|
|
|
737
2045
|
/**
|
|
738
|
-
*
|
|
2046
|
+
* `screenshot`'s config overrides.
|
|
739
2047
|
*/
|
|
740
|
-
|
|
741
|
-
}
|
|
2048
|
+
screenshot?: ComputerScreenshotConfig | null;
|
|
742
2049
|
|
|
743
|
-
export interface CodeExecutionToolResultBlock {
|
|
744
2050
|
/**
|
|
745
|
-
*
|
|
2051
|
+
* `scroll`'s config overrides.
|
|
746
2052
|
*/
|
|
747
|
-
|
|
2053
|
+
scroll?: ComputerScrollConfig | null;
|
|
748
2054
|
|
|
749
|
-
|
|
2055
|
+
/**
|
|
2056
|
+
* `triple_click`'s config overrides.
|
|
2057
|
+
*/
|
|
2058
|
+
triple_click?: ComputerTripleClickConfig | null;
|
|
750
2059
|
|
|
751
|
-
|
|
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
|
-
*
|
|
2077
|
+
* `triple_click`'s config overrides.
|
|
756
2078
|
*/
|
|
757
|
-
export
|
|
758
|
-
| CodeExecutionToolResultError
|
|
759
|
-
| CodeExecutionResultBlock
|
|
760
|
-
| EncryptedCodeExecutionResultBlock;
|
|
761
|
-
|
|
762
|
-
export interface CodeExecutionToolResultBlockParam {
|
|
2079
|
+
export interface ComputerTripleClickConfig {
|
|
763
2080
|
/**
|
|
764
|
-
*
|
|
2081
|
+
* Defer loading for this member. Must resolve to the same value on every enabled
|
|
2082
|
+
* member of the toolset.
|
|
765
2083
|
*/
|
|
766
|
-
|
|
2084
|
+
defer_loading?: boolean | null;
|
|
767
2085
|
|
|
768
|
-
|
|
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
|
-
|
|
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
|
-
*
|
|
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
|
-
|
|
2109
|
+
enabled?: boolean | null;
|
|
776
2110
|
}
|
|
777
2111
|
|
|
778
2112
|
/**
|
|
779
|
-
*
|
|
2113
|
+
* `wait`'s config overrides.
|
|
780
2114
|
*/
|
|
781
|
-
export
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
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
|
-
|
|
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
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
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
|
-
|
|
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?:
|
|
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,
|