Events changedapi/beta/sessions/events
Recorded here
Lines+351added
Lines−5removed
From line
993
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits29to this page, all time
### Beta Managed Agents Compaction Limit Reached Error ### Beta Managed Agents Tool Use Limit Reached Error
The whole hunk
from line 993, old and new numbered
/
This page is larger than the 256 KiB this site keeps, so one side of the diff below stops where the stored text does.
from line 993
993993
994994 Unique identifier for this event.
995995
996 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 10 more`
996 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 12 more`
997997
998998 - `BetaManagedAgentsUnknownError object`
999999
from line 1225
12251225
12261226 ID of the vault containing the affected credential.
12271227
1228 - `BetaManagedAgentsToolUseLimitReachedError object`
1229
1230 The turn stopped because the agent loop reached its limit on tool-use rounds (one model response that calls tools, plus running those tools, is one round), not because a request failed. The thread goes idle with `stop_reason: retries_exhausted` (a child thread then terminates); the next `user.message` starts a new turn.
1231
1232 - `type: "tool_use_limit_reached_error"`
1233
1234 - `message: string`
1235
1236 Human-readable error description.
1237
1238 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
1239
1240 What the client should do next.
1241
1242 - `BetaManagedAgentsRetryStatusRetrying object`
1243
1244 The server is retrying automatically. Client should wait; the same error type may fire again as retrying, then once as exhausted when the retry budget runs out.
1245
1246 - `BetaManagedAgentsRetryStatusExhausted object`
1247
1248 This turn is dead; queued inputs are flushed and the session returns to idle. Client may send a new prompt.
1249
1250 - `BetaManagedAgentsRetryStatusTerminal object`
1251
1252 The session encountered a terminal error and will transition to `terminated` state.
1253
1254 - `BetaManagedAgentsCompactionLimitReachedError object`
1255
1256 The turn stopped because the context was compacted the maximum number of times in a row without the model producing a message or a tool call, not because a request failed. The thread goes idle with `stop_reason: retries_exhausted` (a child thread then terminates); the next `user.message` starts a new turn.
1257
1258 - `type: "compaction_limit_reached_error"`
1259
1260 - `message: string`
1261
1262 Human-readable error description.
1263
1264 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
1265
1266 What the client should do next.
1267
1268 - `BetaManagedAgentsRetryStatusRetrying object`
1269
1270 The server is retrying automatically. Client should wait; the same error type may fire again as retrying, then once as exhausted when the retry budget runs out.
1271
1272 - `BetaManagedAgentsRetryStatusExhausted object`
1273
1274 This turn is dead; queued inputs are flushed and the session returns to idle. Client may send a new prompt.
1275
1276 - `BetaManagedAgentsRetryStatusTerminal object`
1277
1278 The session encountered a terminal error and will transition to `terminated` state.
1279
12281280 - `BetaManagedAgentsRepositoryAuthenticationError object`
12291281
12301282 The repository host rejected the credentials, or required credentials and received none.
from line 2569
25172569
25182570 Two-letter ISO 3166-1 country code, uppercase.
25192571
2572 pattern: ^[A-Z]{2}$
2573
25202574 - `region: optional string or null`
25212575
25222576 Region or state name.
from line 2873
28192873
28202874 Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.
28212875
2876 pattern: ^(0|[1-9]\d*)$
2877
28222878 - `currency: BetaCurrency`
28232879
28242880 Uppercase ISO-4217 currency code. `USD` is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.
from line 5163
51075163
51085164 Unique identifier for this event.
51095165
5110 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 10 more`
5166 - `error: BetaManagedAgentsUnknownError or BetaManagedAgentsModelOverloadedError or BetaManagedAgentsModelRateLimitedError or 12 more`
51115167
51125168 - `BetaManagedAgentsUnknownError object`
51135169
from line 5395
53395395
53405396 ID of the vault containing the affected credential.
53415397
5398 - `BetaManagedAgentsToolUseLimitReachedError object`
5399
5400 The turn stopped because the agent loop reached its limit on tool-use rounds (one model response that calls tools, plus running those tools, is one round), not because a request failed. The thread goes idle with `stop_reason: retries_exhausted` (a child thread then terminates); the next `user.message` starts a new turn.
5401
5402 - `type: "tool_use_limit_reached_error"`
5403
5404 - `message: string`
5405
5406 Human-readable error description.
5407
5408 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
5409
5410 What the client should do next.
5411
5412 - `BetaManagedAgentsRetryStatusRetrying object`
5413
5414 The server is retrying automatically. Client should wait; the same error type may fire again as retrying, then once as exhausted when the retry budget runs out.
5415
5416 - `BetaManagedAgentsRetryStatusExhausted object`
5417
5418 This turn is dead; queued inputs are flushed and the session returns to idle. Client may send a new prompt.
5419
5420 - `BetaManagedAgentsRetryStatusTerminal object`
5421
5422 The session encountered a terminal error and will transition to `terminated` state.
5423
5424 - `BetaManagedAgentsCompactionLimitReachedError object`
5425
5426 The turn stopped because the context was compacted the maximum number of times in a row without the model producing a message or a tool call, not because a request failed. The thread goes idle with `stop_reason: retries_exhausted` (a child thread then terminates); the next `user.message` starts a new turn.
5427
5428 - `type: "compaction_limit_reached_error"`
5429
5430 - `message: string`
5431
5432 Human-readable error description.
5433
5434 - `retry_status: BetaManagedAgentsRetryStatusRetrying or BetaManagedAgentsRetryStatusExhausted or BetaManagedAgentsRetryStatusTerminal`
5435
5436 What the client should do next.
5437
5438 - `BetaManagedAgentsRetryStatusRetrying object`
5439
5440 The server is retrying automatically. Client should wait; the same error type may fire again as retrying, then once as exhausted when the retry budget runs out.
5441
5442 - `BetaManagedAgentsRetryStatusExhausted object`
5443
5444 This turn is dead; queued inputs are flushed and the session returns to idle. Client may send a new prompt.
5445
5446 - `BetaManagedAgentsRetryStatusTerminal object`
5447
5448 The session encountered a terminal error and will transition to `terminated` state.
5449
53425450 - `BetaManagedAgentsRepositoryAuthenticationError object`
53435451
53445452 The repository host rejected the credentials, or required credentials and received none.
from line 6739
66316739
66326740 Two-letter ISO 3166-1 country code, uppercase.
66336741
6742 pattern: ^[A-Z]{2}$
6743
66346744 - `region: optional string or null`
66356745
66366746 Region or state name.
from line 7043
69337043
69347044 Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.
69357045
7046 pattern: ^(0|[1-9]\d*)$
7047
69367048 - `currency: BetaCurrency`
69377049
69387050 Uppercase ISO-4217 currency code. `USD` is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.
from line 8476
83648476
83658477 - `id: string`
83668478
8367 Unique identifier for this event.
8368
8369 - `processed_at: string`
8370
8371 Timestamp when this event was processed.
8372
8373 format: date-time
8374
8375 - `tool_use_id: string`
8376
8377 The id of the `agent.tool_use` event this result corresponds to.
8378
8379 - `content: optional array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsSearchResultBlock`
8380
8381 The result content returned by the tool.
8382
8383 - `BetaManagedAgentsTextBlock object`
8384
8385 Regular text content.
8386
8387 - `type: "text"`
8388
8389 - `text: string`
8390
8391 The text content.
8392
8393 minLength: 1
8394
8395 - `BetaManagedAgentsImageBlock object`
8396
8397 Image content specified directly as base64 data or as a reference via a URL.
8398
8399 - `type: "image"`
8400
8401 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
8402
8403 The source of the image data.
8404
8405 - `BetaManagedAgentsBase64ImageSource object`
8406
8407 Base64-encoded image data.
8408
8409 - `type: "base64"`
8410
8411 - `data: string`
8412
8413 Base64-encoded image data.
8414
8415 minLength: 1
8416
8417 - `media_type: string`
8418
8419 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
8420
8421 minLength: 1
8422
8423 - `BetaManagedAgentsURLImageSource object`
8424
8425 Image referenced by URL.
8426
8427 - `type: "url"`
8428
8429 - `url: string`
8430
8431 URL of the image to fetch.
8432
8433 minLength: 1
8434
8435 - `BetaManagedAgentsFileImageSource object`
8436
8437 Image referenced by file ID.
8438
8439 - `type: "file"`
8440
8441 - `file_id: string`
8442
8443 ID of a previously uploaded file.
8444
8445 minLength: 1
8446
8447 - `BetaManagedAgentsDocumentBlock object`
8448
8449 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
8450
8451 - `type: "document"`
8452
8453 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
8454
8455 The source of the document data.
8456
8457 - `BetaManagedAgentsBase64DocumentSource object`
8458
8459 Base64-encoded document data.
8460
8461 - `type: "base64"`
8462
8463 - `data: string`
8464
8465 Base64-encoded document data.
8466
8467 minLength: 1
8468
8469 - `media_type: string`
8470
8471 MIME type of the document (e.g., "application/pdf").
8472
8473 minLength: 1
8474
8475 - `BetaManagedAgentsPlainTextDocumentSource object`
8476
8477 Plain text document content.
8478
8479 - `type: "text"`
8480
8481 - `data: string`
8482
8483 The plain text content.
8484
8485 minLength: 1
8486
8487 - `media_type: "text/plain"`
8488
8489 MIME type of the text content. Must be "text/plain".
8490
8491 - `BetaManagedAgentsURLDocumentSource object`
8492
8493 Document referenced by URL.
8494
8495 - `type: "url"`
8496
8497 - `url: string`
8498
8499 URL of the document to fetch.
8500
8501 minLength: 1
8502
8503 - `BetaManagedAgentsFileDocumentSource object`
8504
8505 Document referenced by file ID.
8506
8507 - `type: "file"`
8508
8509 - `file_id: string`
8510
8511 ID of a previously uploaded file.
8512
8513 minLength: 1
8514
8515 - `context: optional string or null`
8516
8517 Additional context about the document for the model.
8518
8519 - `title: optional string or null`
8520
8521 The title of the document.
8522
8523 - `BetaManagedAgentsSearchResultBlock object`
8524
8525 A block containing a web search result.
8526
8527 - `type: "search_result"`
8528
8529 - `citations: BetaManagedAgentsSearchResultCitations`
8530
8531 Citation settings for this search result.
8532
8533 - `enabled: boolean`
8534
8535 Whether citations are enabled for this search result.
8536
8537 - `content: array of BetaManagedAgentsSearchResultContent`
8538
8539 Array of text content blocks from the search result.
8540
8541 - `type: "text"`
8542
8543 - `text: string`
8544
8545 The text content.
8546
8547 minLength: 1
8548
8549 - `source: string`
8550
8551 The URL source of the search result.
8552
8553 minLength: 1
8554
8555 - `title: string`
8556
8557 The title of the search result.
8558
8559 minLength: 1
8560
8561 - `is_error: optional boolean or null`
8562
8563 Whether the tool execution resulted in an error.
8564
8565### Beta Managed Agents Agent Tool Use Event
8566
8567- `BetaManagedAgentsAgentToolUseEvent object`
8568
8569 Event emitted when the agent invokes a built-in agent tool.
8570
8571 - `type: "agent.tool_use"`
8572
8573 - `id: string`
8574
8575 Unique identifier for this event.
8576
8577 - `input: map[unknown]`
8578
8579 Input parameters for the tool call.
8580
8581 - `name: string`
8582
8583 Name of the agent tool being used.
8584
8585 - `processed_at: string`
8586
8587 Timestamp when this event was processed.
8588
8589 format: date-time
8590
8591 - `evaluated_permission: optional BetaManagedAgentsAgentEvaluatedPermission`
8592
8593 The evaluated permission policy for this tool invocation.
8594
8595 - `"allow"`
8596
8597 - `"ask"`
8598
8599 - `"deny"`
8600
8601 - `evaluation: optional BetaManagedAgentsAgentToolEvaluation`
8602
8603 Which resolved permission_policy produced evaluated_permission: always_allow, always_ask, or auto (with the server's per-invocation judgement). Absent only when the server refused the call before any policy applied (fo
8479
No line in this hunk matches that.