@anthropic-ai/sdk 0.93.0 → 0.95.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (247) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/bin/migration-config.json +185 -0
  3. package/client.d.mts +7 -4
  4. package/client.d.mts.map +1 -1
  5. package/client.d.ts +7 -4
  6. package/client.d.ts.map +1 -1
  7. package/client.js +5 -4
  8. package/client.js.map +1 -1
  9. package/client.mjs +5 -4
  10. package/client.mjs.map +1 -1
  11. package/core/credentials.d.mts +20 -0
  12. package/core/credentials.d.mts.map +1 -1
  13. package/core/credentials.d.ts +20 -0
  14. package/core/credentials.d.ts.map +1 -1
  15. package/core/credentials.js +30 -11
  16. package/core/credentials.js.map +1 -1
  17. package/core/credentials.mjs +27 -9
  18. package/core/credentials.mjs.map +1 -1
  19. package/core/streaming.d.mts.map +1 -1
  20. package/core/streaming.d.ts.map +1 -1
  21. package/core/streaming.js +15 -1
  22. package/core/streaming.js.map +1 -1
  23. package/core/streaming.mjs +15 -1
  24. package/core/streaming.mjs.map +1 -1
  25. package/internal/qs/formats.d.mts +7 -0
  26. package/internal/qs/formats.d.mts.map +1 -0
  27. package/internal/qs/formats.d.ts +7 -0
  28. package/internal/qs/formats.d.ts.map +1 -0
  29. package/internal/qs/formats.js +13 -0
  30. package/internal/qs/formats.js.map +1 -0
  31. package/internal/qs/formats.mjs +9 -0
  32. package/internal/qs/formats.mjs.map +1 -0
  33. package/internal/qs/index.d.mts +10 -0
  34. package/internal/qs/index.d.mts.map +1 -0
  35. package/internal/qs/index.d.ts +10 -0
  36. package/internal/qs/index.d.ts.map +1 -0
  37. package/internal/qs/index.js +14 -0
  38. package/internal/qs/index.js.map +1 -0
  39. package/internal/qs/index.mjs +10 -0
  40. package/internal/qs/index.mjs.map +1 -0
  41. package/internal/qs/stringify.d.mts +3 -0
  42. package/internal/qs/stringify.d.mts.map +1 -0
  43. package/internal/qs/stringify.d.ts +3 -0
  44. package/internal/qs/stringify.d.ts.map +1 -0
  45. package/internal/qs/stringify.js +277 -0
  46. package/internal/qs/stringify.js.map +1 -0
  47. package/internal/qs/stringify.mjs +274 -0
  48. package/internal/qs/stringify.mjs.map +1 -0
  49. package/internal/qs/types.d.mts +57 -0
  50. package/internal/qs/types.d.mts.map +1 -0
  51. package/internal/qs/types.d.ts +57 -0
  52. package/internal/qs/types.d.ts.map +1 -0
  53. package/internal/qs/types.js +3 -0
  54. package/internal/qs/types.js.map +1 -0
  55. package/internal/qs/types.mjs +2 -0
  56. package/internal/qs/types.mjs.map +1 -0
  57. package/internal/qs/utils.d.mts +15 -0
  58. package/internal/qs/utils.d.mts.map +1 -0
  59. package/internal/qs/utils.d.ts +15 -0
  60. package/internal/qs/utils.d.ts.map +1 -0
  61. package/internal/qs/utils.js +230 -0
  62. package/internal/qs/utils.js.map +1 -0
  63. package/internal/qs/utils.mjs +217 -0
  64. package/internal/qs/utils.mjs.map +1 -0
  65. package/internal/utils/query.d.mts +0 -3
  66. package/internal/utils/query.d.mts.map +1 -1
  67. package/internal/utils/query.d.ts +0 -3
  68. package/internal/utils/query.d.ts.map +1 -1
  69. package/internal/utils/query.js +3 -16
  70. package/internal/utils/query.js.map +1 -1
  71. package/internal/utils/query.mjs +2 -16
  72. package/internal/utils/query.mjs.map +1 -1
  73. package/lib/credentials/credential-chain.d.mts.map +1 -1
  74. package/lib/credentials/credential-chain.d.ts.map +1 -1
  75. package/lib/credentials/credential-chain.js +18 -10
  76. package/lib/credentials/credential-chain.js.map +1 -1
  77. package/lib/credentials/credential-chain.mjs +19 -11
  78. package/lib/credentials/credential-chain.mjs.map +1 -1
  79. package/lib/credentials/oidc-federation.d.mts +12 -0
  80. package/lib/credentials/oidc-federation.d.mts.map +1 -1
  81. package/lib/credentials/oidc-federation.d.ts +12 -0
  82. package/lib/credentials/oidc-federation.d.ts.map +1 -1
  83. package/lib/credentials/oidc-federation.js +14 -1
  84. package/lib/credentials/oidc-federation.js.map +1 -1
  85. package/lib/credentials/oidc-federation.mjs +14 -1
  86. package/lib/credentials/oidc-federation.mjs.map +1 -1
  87. package/package.json +2 -1
  88. package/resources/beta/agents/agents.d.mts +60 -1
  89. package/resources/beta/agents/agents.d.mts.map +1 -1
  90. package/resources/beta/agents/agents.d.ts +60 -1
  91. package/resources/beta/agents/agents.d.ts.map +1 -1
  92. package/resources/beta/agents/agents.js.map +1 -1
  93. package/resources/beta/agents/agents.mjs.map +1 -1
  94. package/resources/beta/agents/index.d.mts +1 -1
  95. package/resources/beta/agents/index.d.mts.map +1 -1
  96. package/resources/beta/agents/index.d.ts +1 -1
  97. package/resources/beta/agents/index.d.ts.map +1 -1
  98. package/resources/beta/agents/index.js.map +1 -1
  99. package/resources/beta/agents/index.mjs.map +1 -1
  100. package/resources/beta/beta.d.mts +9 -5
  101. package/resources/beta/beta.d.mts.map +1 -1
  102. package/resources/beta/beta.d.ts +9 -5
  103. package/resources/beta/beta.d.ts.map +1 -1
  104. package/resources/beta/beta.js +4 -0
  105. package/resources/beta/beta.js.map +1 -1
  106. package/resources/beta/beta.mjs +4 -0
  107. package/resources/beta/beta.mjs.map +1 -1
  108. package/resources/beta/index.d.mts +3 -2
  109. package/resources/beta/index.d.mts.map +1 -1
  110. package/resources/beta/index.d.ts +3 -2
  111. package/resources/beta/index.d.ts.map +1 -1
  112. package/resources/beta/index.js +3 -1
  113. package/resources/beta/index.js.map +1 -1
  114. package/resources/beta/index.mjs +1 -0
  115. package/resources/beta/index.mjs.map +1 -1
  116. package/resources/beta/messages/messages.d.mts +88 -0
  117. package/resources/beta/messages/messages.d.mts.map +1 -1
  118. package/resources/beta/messages/messages.d.ts +88 -0
  119. package/resources/beta/messages/messages.d.ts.map +1 -1
  120. package/resources/beta/messages/messages.js.map +1 -1
  121. package/resources/beta/messages/messages.mjs.map +1 -1
  122. package/resources/beta/sessions/events.d.mts +436 -5
  123. package/resources/beta/sessions/events.d.mts.map +1 -1
  124. package/resources/beta/sessions/events.d.ts +436 -5
  125. package/resources/beta/sessions/events.d.ts.map +1 -1
  126. package/resources/beta/sessions/index.d.mts +3 -2
  127. package/resources/beta/sessions/index.d.mts.map +1 -1
  128. package/resources/beta/sessions/index.d.ts +3 -2
  129. package/resources/beta/sessions/index.d.ts.map +1 -1
  130. package/resources/beta/sessions/index.js +3 -1
  131. package/resources/beta/sessions/index.js.map +1 -1
  132. package/resources/beta/sessions/index.mjs +1 -0
  133. package/resources/beta/sessions/index.mjs.map +1 -1
  134. package/resources/beta/sessions/sessions.d.mts +99 -3
  135. package/resources/beta/sessions/sessions.d.mts.map +1 -1
  136. package/resources/beta/sessions/sessions.d.ts +99 -3
  137. package/resources/beta/sessions/sessions.d.ts.map +1 -1
  138. package/resources/beta/sessions/sessions.js +4 -0
  139. package/resources/beta/sessions/sessions.js.map +1 -1
  140. package/resources/beta/sessions/sessions.mjs +4 -0
  141. package/resources/beta/sessions/sessions.mjs.map +1 -1
  142. package/resources/beta/sessions/threads/events.d.mts +64 -0
  143. package/resources/beta/sessions/threads/events.d.mts.map +1 -0
  144. package/resources/beta/sessions/threads/events.d.ts +64 -0
  145. package/resources/beta/sessions/threads/events.d.ts.map +1 -0
  146. package/resources/beta/sessions/threads/events.js +60 -0
  147. package/resources/beta/sessions/threads/events.js.map +1 -0
  148. package/resources/beta/sessions/threads/events.mjs +56 -0
  149. package/resources/beta/sessions/threads/events.mjs.map +1 -0
  150. package/resources/beta/sessions/threads/index.d.mts +3 -0
  151. package/resources/beta/sessions/threads/index.d.mts.map +1 -0
  152. package/resources/beta/sessions/threads/index.d.ts +3 -0
  153. package/resources/beta/sessions/threads/index.d.ts.map +1 -0
  154. package/resources/beta/sessions/threads/index.js +9 -0
  155. package/resources/beta/sessions/threads/index.js.map +1 -0
  156. package/resources/beta/sessions/threads/index.mjs +4 -0
  157. package/resources/beta/sessions/threads/index.mjs.map +1 -0
  158. package/resources/beta/sessions/threads/threads.d.mts +203 -0
  159. package/resources/beta/sessions/threads/threads.d.mts.map +1 -0
  160. package/resources/beta/sessions/threads/threads.d.ts +203 -0
  161. package/resources/beta/sessions/threads/threads.d.ts.map +1 -0
  162. package/resources/beta/sessions/threads/threads.js +88 -0
  163. package/resources/beta/sessions/threads/threads.js.map +1 -0
  164. package/resources/beta/sessions/threads/threads.mjs +83 -0
  165. package/resources/beta/sessions/threads/threads.mjs.map +1 -0
  166. package/resources/beta/sessions/threads.d.mts +2 -0
  167. package/resources/beta/sessions/threads.d.mts.map +1 -0
  168. package/resources/beta/sessions/threads.d.ts +2 -0
  169. package/resources/beta/sessions/threads.d.ts.map +1 -0
  170. package/resources/beta/sessions/threads.js +6 -0
  171. package/resources/beta/sessions/threads.js.map +1 -0
  172. package/resources/beta/sessions/threads.mjs +3 -0
  173. package/resources/beta/sessions/threads.mjs.map +1 -0
  174. package/resources/beta/user-profiles.d.mts +36 -0
  175. package/resources/beta/user-profiles.d.mts.map +1 -1
  176. package/resources/beta/user-profiles.d.ts +36 -0
  177. package/resources/beta/user-profiles.d.ts.map +1 -1
  178. package/resources/beta/vaults/credentials.d.mts +109 -1
  179. package/resources/beta/vaults/credentials.d.mts.map +1 -1
  180. package/resources/beta/vaults/credentials.d.ts +109 -1
  181. package/resources/beta/vaults/credentials.d.ts.map +1 -1
  182. package/resources/beta/vaults/credentials.js +22 -0
  183. package/resources/beta/vaults/credentials.js.map +1 -1
  184. package/resources/beta/vaults/credentials.mjs +22 -0
  185. package/resources/beta/vaults/credentials.mjs.map +1 -1
  186. package/resources/beta/vaults/index.d.mts +1 -1
  187. package/resources/beta/vaults/index.d.mts.map +1 -1
  188. package/resources/beta/vaults/index.d.ts +1 -1
  189. package/resources/beta/vaults/index.d.ts.map +1 -1
  190. package/resources/beta/vaults/index.js.map +1 -1
  191. package/resources/beta/vaults/index.mjs.map +1 -1
  192. package/resources/beta/vaults/vaults.d.mts +2 -2
  193. package/resources/beta/vaults/vaults.d.mts.map +1 -1
  194. package/resources/beta/vaults/vaults.d.ts +2 -2
  195. package/resources/beta/vaults/vaults.d.ts.map +1 -1
  196. package/resources/beta/vaults/vaults.js.map +1 -1
  197. package/resources/beta/vaults/vaults.mjs.map +1 -1
  198. package/resources/beta/webhooks.d.mts +256 -0
  199. package/resources/beta/webhooks.d.mts.map +1 -0
  200. package/resources/beta/webhooks.d.ts +256 -0
  201. package/resources/beta/webhooks.d.ts.map +1 -0
  202. package/resources/beta/webhooks.js +20 -0
  203. package/resources/beta/webhooks.js.map +1 -0
  204. package/resources/beta/webhooks.mjs +16 -0
  205. package/resources/beta/webhooks.mjs.map +1 -0
  206. package/resources/messages/messages.d.mts +88 -0
  207. package/resources/messages/messages.d.mts.map +1 -1
  208. package/resources/messages/messages.d.ts +88 -0
  209. package/resources/messages/messages.d.ts.map +1 -1
  210. package/resources/messages/messages.js.map +1 -1
  211. package/resources/messages/messages.mjs.map +1 -1
  212. package/src/client.ts +17 -4
  213. package/src/core/credentials.ts +39 -9
  214. package/src/core/streaming.ts +15 -1
  215. package/src/internal/qs/LICENSE.md +13 -0
  216. package/src/internal/qs/README.md +3 -0
  217. package/src/internal/qs/formats.ts +10 -0
  218. package/src/internal/qs/index.ts +13 -0
  219. package/src/internal/qs/stringify.ts +385 -0
  220. package/src/internal/qs/types.ts +71 -0
  221. package/src/internal/qs/utils.ts +265 -0
  222. package/src/internal/utils/query.ts +2 -18
  223. package/src/lib/credentials/credential-chain.ts +19 -11
  224. package/src/lib/credentials/oidc-federation.ts +29 -1
  225. package/src/resources/beta/agents/agents.ts +74 -0
  226. package/src/resources/beta/agents/index.ts +4 -0
  227. package/src/resources/beta/beta.ts +80 -1
  228. package/src/resources/beta/index.ts +37 -0
  229. package/src/resources/beta/messages/messages.ts +88 -0
  230. package/src/resources/beta/sessions/events.ts +565 -3
  231. package/src/resources/beta/sessions/index.ts +34 -0
  232. package/src/resources/beta/sessions/sessions.ts +179 -0
  233. package/src/resources/beta/sessions/threads/events.ts +107 -0
  234. package/src/resources/beta/sessions/threads/index.ts +16 -0
  235. package/src/resources/beta/sessions/threads/threads.ts +344 -0
  236. package/src/resources/beta/sessions/threads.ts +3 -0
  237. package/src/resources/beta/user-profiles.ts +42 -0
  238. package/src/resources/beta/vaults/credentials.ts +150 -0
  239. package/src/resources/beta/vaults/index.ts +6 -0
  240. package/src/resources/beta/vaults/vaults.ts +12 -0
  241. package/src/resources/beta/webhooks.ts +417 -0
  242. package/src/resources/messages/messages.ts +88 -0
  243. package/src/version.ts +1 -1
  244. package/version.d.mts +1 -1
  245. package/version.d.ts +1 -1
  246. package/version.js +1 -1
  247. package/version.mjs +1 -1
@@ -139,6 +139,13 @@ export interface BetaManagedAgentsAgentCustomToolUseEvent {
139
139
  processed_at: string;
140
140
 
141
141
  type: 'agent.custom_tool_use';
142
+
143
+ /**
144
+ * When set, this event was cross-posted from a subagent's thread to surface its
145
+ * custom tool use on the primary thread's stream. Empty on the thread's own
146
+ * events. Echo this on a `user.custom_tool_result` event to route the result back.
147
+ */
148
+ session_thread_id?: string | null;
142
149
  }
143
150
 
144
151
  /**
@@ -208,6 +215,14 @@ export interface BetaManagedAgentsAgentMCPToolUseEvent {
208
215
  * AgentEvaluatedPermission enum
209
216
  */
210
217
  evaluated_permission?: 'allow' | 'ask' | 'deny';
218
+
219
+ /**
220
+ * When set, this event was cross-posted from a subagent's thread to surface its
221
+ * permission request on the primary thread's stream. Empty on the thread's own
222
+ * events. Echo this on a `user.tool_confirmation` event to route the approval
223
+ * back.
224
+ */
225
+ session_thread_id?: string | null;
211
226
  }
212
227
 
213
228
  /**
@@ -267,6 +282,74 @@ export interface BetaManagedAgentsAgentThreadContextCompactedEvent {
267
282
  type: 'agent.thread_context_compacted';
268
283
  }
269
284
 
285
+ /**
286
+ * Delivery event written to the target thread's input stream when an
287
+ * agent-to-agent message arrives.
288
+ */
289
+ export interface BetaManagedAgentsAgentThreadMessageReceivedEvent {
290
+ /**
291
+ * Unique identifier for this event.
292
+ */
293
+ id: string;
294
+
295
+ /**
296
+ * Message content blocks.
297
+ */
298
+ content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
299
+
300
+ /**
301
+ * Public `sthr_` ID of the thread that sent the message.
302
+ */
303
+ from_session_thread_id: string;
304
+
305
+ /**
306
+ * A timestamp in RFC 3339 format
307
+ */
308
+ processed_at: string;
309
+
310
+ type: 'agent.thread_message_received';
311
+
312
+ /**
313
+ * Name of the callable agent this message came from. Absent when received from the
314
+ * primary agent.
315
+ */
316
+ from_agent_name?: string | null;
317
+ }
318
+
319
+ /**
320
+ * Observability event emitted to the sender's output stream when an agent-to-agent
321
+ * message is sent.
322
+ */
323
+ export interface BetaManagedAgentsAgentThreadMessageSentEvent {
324
+ /**
325
+ * Unique identifier for this event.
326
+ */
327
+ id: string;
328
+
329
+ /**
330
+ * Message content blocks.
331
+ */
332
+ content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
333
+
334
+ /**
335
+ * A timestamp in RFC 3339 format
336
+ */
337
+ processed_at: string;
338
+
339
+ /**
340
+ * Public `sthr_` ID of the thread the message was sent to.
341
+ */
342
+ to_session_thread_id: string;
343
+
344
+ type: 'agent.thread_message_sent';
345
+
346
+ /**
347
+ * Name of the callable agent this message was sent to. Absent when sent to the
348
+ * primary agent.
349
+ */
350
+ to_agent_name?: string | null;
351
+ }
352
+
270
353
  /**
271
354
  * Event representing the result of an agent tool execution.
272
355
  */
@@ -329,6 +412,14 @@ export interface BetaManagedAgentsAgentToolUseEvent {
329
412
  * AgentEvaluatedPermission enum
330
413
  */
331
414
  evaluated_permission?: 'allow' | 'ask' | 'deny';
415
+
416
+ /**
417
+ * When set, this event was cross-posted from a subagent's thread to surface its
418
+ * permission request on the primary thread's stream. Empty on the thread's own
419
+ * events. Echo this on a `user.tool_confirmation` event to route the approval
420
+ * back.
421
+ */
422
+ session_thread_id?: string | null;
332
423
  }
333
424
 
334
425
  /**
@@ -422,7 +513,8 @@ export type BetaManagedAgentsEventParams =
422
513
  | BetaManagedAgentsUserMessageEventParams
423
514
  | BetaManagedAgentsUserInterruptEventParams
424
515
  | BetaManagedAgentsUserToolConfirmationEventParams
425
- | BetaManagedAgentsUserCustomToolResultEventParams;
516
+ | BetaManagedAgentsUserCustomToolResultEventParams
517
+ | BetaManagedAgentsUserDefineOutcomeEventParams;
426
518
 
427
519
  /**
428
520
  * Document referenced by file ID.
@@ -448,6 +540,30 @@ export interface BetaManagedAgentsFileImageSource {
448
540
  type: 'file';
449
541
  }
450
542
 
543
+ /**
544
+ * Rubric referenced by a file uploaded via the Files API.
545
+ */
546
+ export interface BetaManagedAgentsFileRubric {
547
+ /**
548
+ * ID of the rubric file.
549
+ */
550
+ file_id: string;
551
+
552
+ type: 'file';
553
+ }
554
+
555
+ /**
556
+ * Rubric referenced by a file uploaded via the Files API.
557
+ */
558
+ export interface BetaManagedAgentsFileRubricParams {
559
+ /**
560
+ * ID of the rubric file.
561
+ */
562
+ file_id: string;
563
+
564
+ type: 'file';
565
+ }
566
+
451
567
  /**
452
568
  * Image content specified directly as base64 data or as a reference via a URL.
453
569
  */
@@ -628,6 +744,7 @@ export interface BetaManagedAgentsSendSessionEvents {
628
744
  | BetaManagedAgentsUserInterruptEvent
629
745
  | BetaManagedAgentsUserToolConfirmationEvent
630
746
  | BetaManagedAgentsUserCustomToolResultEvent
747
+ | BetaManagedAgentsUserDefineOutcomeEvent
631
748
  >;
632
749
  }
633
750
 
@@ -702,15 +819,26 @@ export type BetaManagedAgentsSessionEvent =
702
819
  | BetaManagedAgentsAgentMCPToolResultEvent
703
820
  | BetaManagedAgentsAgentToolUseEvent
704
821
  | BetaManagedAgentsAgentToolResultEvent
822
+ | BetaManagedAgentsAgentThreadMessageReceivedEvent
823
+ | BetaManagedAgentsAgentThreadMessageSentEvent
705
824
  | BetaManagedAgentsAgentThreadContextCompactedEvent
706
825
  | BetaManagedAgentsSessionErrorEvent
707
826
  | BetaManagedAgentsSessionStatusRescheduledEvent
708
827
  | BetaManagedAgentsSessionStatusRunningEvent
709
828
  | BetaManagedAgentsSessionStatusIdleEvent
710
829
  | BetaManagedAgentsSessionStatusTerminatedEvent
830
+ | BetaManagedAgentsSessionThreadCreatedEvent
831
+ | BetaManagedAgentsSpanOutcomeEvaluationStartEvent
832
+ | BetaManagedAgentsSpanOutcomeEvaluationEndEvent
711
833
  | BetaManagedAgentsSpanModelRequestStartEvent
712
834
  | BetaManagedAgentsSpanModelRequestEndEvent
713
- | BetaManagedAgentsSessionDeletedEvent;
835
+ | BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent
836
+ | BetaManagedAgentsUserDefineOutcomeEvent
837
+ | BetaManagedAgentsSessionDeletedEvent
838
+ | BetaManagedAgentsSessionThreadStatusRunningEvent
839
+ | BetaManagedAgentsSessionThreadStatusIdleEvent
840
+ | BetaManagedAgentsSessionThreadStatusTerminatedEvent
841
+ | BetaManagedAgentsSessionThreadStatusRescheduledEvent;
714
842
 
715
843
  /**
716
844
  * The agent is idle waiting on one or more blocking user-input events (tool
@@ -812,6 +940,155 @@ export interface BetaManagedAgentsSessionStatusTerminatedEvent {
812
940
  type: 'session.status_terminated';
813
941
  }
814
942
 
943
+ /**
944
+ * Emitted when a subagent is spawned as a new thread. Written to the parent
945
+ * thread's output stream so clients observing the session see child creation.
946
+ */
947
+ export interface BetaManagedAgentsSessionThreadCreatedEvent {
948
+ /**
949
+ * Unique identifier for this event.
950
+ */
951
+ id: string;
952
+
953
+ /**
954
+ * Name of the callable agent the thread runs.
955
+ */
956
+ agent_name: string;
957
+
958
+ /**
959
+ * A timestamp in RFC 3339 format
960
+ */
961
+ processed_at: string;
962
+
963
+ /**
964
+ * Public `sthr_` ID of the newly created thread.
965
+ */
966
+ session_thread_id: string;
967
+
968
+ type: 'session.thread_created';
969
+ }
970
+
971
+ /**
972
+ * A session thread has yielded and is awaiting input. Emitted on the thread's own
973
+ * stream and cross-posted to the primary stream for child threads.
974
+ */
975
+ export interface BetaManagedAgentsSessionThreadStatusIdleEvent {
976
+ /**
977
+ * Unique identifier for this event.
978
+ */
979
+ id: string;
980
+
981
+ /**
982
+ * Name of the agent the thread runs.
983
+ */
984
+ agent_name: string;
985
+
986
+ /**
987
+ * A timestamp in RFC 3339 format
988
+ */
989
+ processed_at: string;
990
+
991
+ /**
992
+ * Public sthr\_ ID of the thread that went idle.
993
+ */
994
+ session_thread_id: string;
995
+
996
+ /**
997
+ * The agent completed its turn naturally and is ready for the next user message.
998
+ */
999
+ stop_reason:
1000
+ | BetaManagedAgentsSessionEndTurn
1001
+ | BetaManagedAgentsSessionRequiresAction
1002
+ | BetaManagedAgentsSessionRetriesExhausted;
1003
+
1004
+ type: 'session.thread_status_idle';
1005
+ }
1006
+
1007
+ /**
1008
+ * A session thread hit a transient error and is retrying automatically. Emitted on
1009
+ * the thread's own stream and cross-posted to the primary stream for child
1010
+ * threads.
1011
+ */
1012
+ export interface BetaManagedAgentsSessionThreadStatusRescheduledEvent {
1013
+ /**
1014
+ * Unique identifier for this event.
1015
+ */
1016
+ id: string;
1017
+
1018
+ /**
1019
+ * Name of the agent the thread runs.
1020
+ */
1021
+ agent_name: string;
1022
+
1023
+ /**
1024
+ * A timestamp in RFC 3339 format
1025
+ */
1026
+ processed_at: string;
1027
+
1028
+ /**
1029
+ * Public sthr\_ ID of the thread that is retrying.
1030
+ */
1031
+ session_thread_id: string;
1032
+
1033
+ type: 'session.thread_status_rescheduled';
1034
+ }
1035
+
1036
+ /**
1037
+ * A session thread has begun executing. Emitted on the thread's own stream and
1038
+ * cross-posted to the primary stream for child threads.
1039
+ */
1040
+ export interface BetaManagedAgentsSessionThreadStatusRunningEvent {
1041
+ /**
1042
+ * Unique identifier for this event.
1043
+ */
1044
+ id: string;
1045
+
1046
+ /**
1047
+ * Name of the agent the thread runs.
1048
+ */
1049
+ agent_name: string;
1050
+
1051
+ /**
1052
+ * A timestamp in RFC 3339 format
1053
+ */
1054
+ processed_at: string;
1055
+
1056
+ /**
1057
+ * Public sthr\_ ID of the thread that started running.
1058
+ */
1059
+ session_thread_id: string;
1060
+
1061
+ type: 'session.thread_status_running';
1062
+ }
1063
+
1064
+ /**
1065
+ * A session thread has terminated and will accept no further input. Emitted on the
1066
+ * thread's own stream and cross-posted to the primary stream for child threads.
1067
+ */
1068
+ export interface BetaManagedAgentsSessionThreadStatusTerminatedEvent {
1069
+ /**
1070
+ * Unique identifier for this event.
1071
+ */
1072
+ id: string;
1073
+
1074
+ /**
1075
+ * Name of the agent the thread runs.
1076
+ */
1077
+ agent_name: string;
1078
+
1079
+ /**
1080
+ * A timestamp in RFC 3339 format
1081
+ */
1082
+ processed_at: string;
1083
+
1084
+ /**
1085
+ * Public sthr\_ ID of the thread that terminated.
1086
+ */
1087
+ session_thread_id: string;
1088
+
1089
+ type: 'session.thread_status_terminated';
1090
+ }
1091
+
815
1092
  /**
816
1093
  * Emitted when a model request completes.
817
1094
  */
@@ -893,6 +1170,123 @@ export interface BetaManagedAgentsSpanModelUsage {
893
1170
  speed?: 'standard' | 'fast' | null;
894
1171
  }
895
1172
 
1173
+ /**
1174
+ * Emitted when an outcome evaluation cycle completes. Carries the verdict and
1175
+ * aggregate token usage. A verdict of `needs_revision` means another evaluation
1176
+ * cycle follows; `satisfied`, `max_iterations_reached`, `failed`, or `interrupted`
1177
+ * are terminal — no further evaluation cycles follow.
1178
+ */
1179
+ export interface BetaManagedAgentsSpanOutcomeEvaluationEndEvent {
1180
+ /**
1181
+ * Unique identifier for this event.
1182
+ */
1183
+ id: string;
1184
+
1185
+ /**
1186
+ * Human-readable explanation of the verdict. For `needs_revision`, describes which
1187
+ * criteria failed and why.
1188
+ */
1189
+ explanation: string;
1190
+
1191
+ /**
1192
+ * 0-indexed revision cycle, matching the corresponding
1193
+ * `span.outcome_evaluation_start`.
1194
+ */
1195
+ iteration: number;
1196
+
1197
+ /**
1198
+ * The id of the corresponding `span.outcome_evaluation_start` event.
1199
+ */
1200
+ outcome_evaluation_start_id: string;
1201
+
1202
+ /**
1203
+ * The `outc_` ID of the outcome being evaluated.
1204
+ */
1205
+ outcome_id: string;
1206
+
1207
+ /**
1208
+ * A timestamp in RFC 3339 format
1209
+ */
1210
+ processed_at: string;
1211
+
1212
+ /**
1213
+ * Evaluation verdict. 'satisfied': criteria met, session goes idle.
1214
+ * 'needs_revision': criteria not met, another revision cycle follows.
1215
+ * 'max_iterations_reached': evaluation budget exhausted with criteria still unmet
1216
+ * — one final acknowledgment turn follows before the session goes idle, but no
1217
+ * further evaluation runs. 'failed': grader determined the rubric does not apply
1218
+ * to the deliverables. 'interrupted': user sent an interrupt while evaluation was
1219
+ * in progress.
1220
+ */
1221
+ result: string;
1222
+
1223
+ type: 'span.outcome_evaluation_end';
1224
+
1225
+ /**
1226
+ * Token usage for a single model request.
1227
+ */
1228
+ usage: BetaManagedAgentsSpanModelUsage;
1229
+ }
1230
+
1231
+ /**
1232
+ * Periodic heartbeat emitted while an outcome evaluation cycle is in progress.
1233
+ * Distinguishes 'evaluation is actively running' from 'evaluation is stuck'
1234
+ * between the corresponding `span.outcome_evaluation_start` and
1235
+ * `span.outcome_evaluation_end` events.
1236
+ */
1237
+ export interface BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent {
1238
+ /**
1239
+ * Unique identifier for this event.
1240
+ */
1241
+ id: string;
1242
+
1243
+ /**
1244
+ * 0-indexed revision cycle, matching the corresponding
1245
+ * `span.outcome_evaluation_start`.
1246
+ */
1247
+ iteration: number;
1248
+
1249
+ /**
1250
+ * The `outc_` ID of the outcome being evaluated.
1251
+ */
1252
+ outcome_id: string;
1253
+
1254
+ /**
1255
+ * A timestamp in RFC 3339 format
1256
+ */
1257
+ processed_at: string;
1258
+
1259
+ type: 'span.outcome_evaluation_ongoing';
1260
+ }
1261
+
1262
+ /**
1263
+ * Emitted when an outcome evaluation cycle begins.
1264
+ */
1265
+ export interface BetaManagedAgentsSpanOutcomeEvaluationStartEvent {
1266
+ /**
1267
+ * Unique identifier for this event.
1268
+ */
1269
+ id: string;
1270
+
1271
+ /**
1272
+ * 0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation
1273
+ * after the first revision; etc.
1274
+ */
1275
+ iteration: number;
1276
+
1277
+ /**
1278
+ * The `outc_` ID of the outcome being evaluated.
1279
+ */
1280
+ outcome_id: string;
1281
+
1282
+ /**
1283
+ * A timestamp in RFC 3339 format
1284
+ */
1285
+ processed_at: string;
1286
+
1287
+ type: 'span.outcome_evaluation_start';
1288
+ }
1289
+
896
1290
  /**
897
1291
  * Server-sent event in the session stream.
898
1292
  */
@@ -908,15 +1302,26 @@ export type BetaManagedAgentsStreamSessionEvents =
908
1302
  | BetaManagedAgentsAgentMCPToolResultEvent
909
1303
  | BetaManagedAgentsAgentToolUseEvent
910
1304
  | BetaManagedAgentsAgentToolResultEvent
1305
+ | BetaManagedAgentsAgentThreadMessageReceivedEvent
1306
+ | BetaManagedAgentsAgentThreadMessageSentEvent
911
1307
  | BetaManagedAgentsAgentThreadContextCompactedEvent
912
1308
  | BetaManagedAgentsSessionErrorEvent
913
1309
  | BetaManagedAgentsSessionStatusRescheduledEvent
914
1310
  | BetaManagedAgentsSessionStatusRunningEvent
915
1311
  | BetaManagedAgentsSessionStatusIdleEvent
916
1312
  | BetaManagedAgentsSessionStatusTerminatedEvent
1313
+ | BetaManagedAgentsSessionThreadCreatedEvent
1314
+ | BetaManagedAgentsSpanOutcomeEvaluationStartEvent
1315
+ | BetaManagedAgentsSpanOutcomeEvaluationEndEvent
917
1316
  | BetaManagedAgentsSpanModelRequestStartEvent
918
1317
  | BetaManagedAgentsSpanModelRequestEndEvent
919
- | BetaManagedAgentsSessionDeletedEvent;
1318
+ | BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent
1319
+ | BetaManagedAgentsUserDefineOutcomeEvent
1320
+ | BetaManagedAgentsSessionDeletedEvent
1321
+ | BetaManagedAgentsSessionThreadStatusRunningEvent
1322
+ | BetaManagedAgentsSessionThreadStatusIdleEvent
1323
+ | BetaManagedAgentsSessionThreadStatusTerminatedEvent
1324
+ | BetaManagedAgentsSessionThreadStatusRescheduledEvent;
920
1325
 
921
1326
  /**
922
1327
  * Regular text content.
@@ -930,6 +1335,31 @@ export interface BetaManagedAgentsTextBlock {
930
1335
  type: 'text';
931
1336
  }
932
1337
 
1338
+ /**
1339
+ * Rubric content provided inline as text.
1340
+ */
1341
+ export interface BetaManagedAgentsTextRubric {
1342
+ /**
1343
+ * Rubric content. Plain text or markdown — the grader treats it as freeform text.
1344
+ */
1345
+ content: string;
1346
+
1347
+ type: 'text';
1348
+ }
1349
+
1350
+ /**
1351
+ * Rubric content provided inline as text.
1352
+ */
1353
+ export interface BetaManagedAgentsTextRubricParams {
1354
+ /**
1355
+ * Rubric content. Plain text or markdown — the grader treats it as freeform text.
1356
+ * Maximum 262144 characters.
1357
+ */
1358
+ content: string;
1359
+
1360
+ type: 'text';
1361
+ }
1362
+
933
1363
  /**
934
1364
  * An unknown or unexpected error occurred during session execution. A fallback
935
1365
  * variant; clients that don't recognize a new error code can match on
@@ -1009,6 +1439,12 @@ export interface BetaManagedAgentsUserCustomToolResultEvent {
1009
1439
  * A timestamp in RFC 3339 format
1010
1440
  */
1011
1441
  processed_at?: string | null;
1442
+
1443
+ /**
1444
+ * Routes this result to a subagent thread. Copy from the `agent.custom_tool_use`
1445
+ * event's `session_thread_id`.
1446
+ */
1447
+ session_thread_id?: string | null;
1012
1448
  }
1013
1449
 
1014
1450
  /**
@@ -1036,6 +1472,68 @@ export interface BetaManagedAgentsUserCustomToolResultEventParams {
1036
1472
  is_error?: boolean | null;
1037
1473
  }
1038
1474
 
1475
+ /**
1476
+ * Echo of a `user.define_outcome` input event. Carries the server-generated
1477
+ * `outcome_id` that subsequent `span.outcome_evaluation_*` events reference.
1478
+ */
1479
+ export interface BetaManagedAgentsUserDefineOutcomeEvent {
1480
+ /**
1481
+ * Unique identifier for this event.
1482
+ */
1483
+ id: string;
1484
+
1485
+ /**
1486
+ * What the agent should produce. Copied from the input event.
1487
+ */
1488
+ description: string;
1489
+
1490
+ /**
1491
+ * Evaluate-then-revise cycles before giving up. Default 3, max 20.
1492
+ */
1493
+ max_iterations: number | null;
1494
+
1495
+ /**
1496
+ * Server-generated `outc_` ID for this outcome. Referenced by
1497
+ * `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list.
1498
+ */
1499
+ outcome_id: string;
1500
+
1501
+ /**
1502
+ * A timestamp in RFC 3339 format
1503
+ */
1504
+ processed_at: string;
1505
+
1506
+ /**
1507
+ * Rubric for grading the quality of an outcome.
1508
+ */
1509
+ rubric: BetaManagedAgentsFileRubric | BetaManagedAgentsTextRubric;
1510
+
1511
+ type: 'user.define_outcome';
1512
+ }
1513
+
1514
+ /**
1515
+ * Parameters for defining an outcome the agent should work toward. The agent
1516
+ * begins work on receipt.
1517
+ */
1518
+ export interface BetaManagedAgentsUserDefineOutcomeEventParams {
1519
+ /**
1520
+ * What the agent should produce. This is the task specification.
1521
+ */
1522
+ description: string;
1523
+
1524
+ /**
1525
+ * Rubric for grading the quality of an outcome.
1526
+ */
1527
+ rubric: BetaManagedAgentsFileRubricParams | BetaManagedAgentsTextRubricParams;
1528
+
1529
+ type: 'user.define_outcome';
1530
+
1531
+ /**
1532
+ * Eval→revision cycles before giving up. Default 3, max 20.
1533
+ */
1534
+ max_iterations?: number | null;
1535
+ }
1536
+
1039
1537
  /**
1040
1538
  * An interrupt event that pauses agent execution and returns control to the user.
1041
1539
  */
@@ -1051,6 +1549,13 @@ export interface BetaManagedAgentsUserInterruptEvent {
1051
1549
  * A timestamp in RFC 3339 format
1052
1550
  */
1053
1551
  processed_at?: string | null;
1552
+
1553
+ /**
1554
+ * If absent, interrupts every non-archived thread in a multiagent session (or the
1555
+ * primary alone in a single-agent session). If present, interrupts only the named
1556
+ * thread.
1557
+ */
1558
+ session_thread_id?: string | null;
1054
1559
  }
1055
1560
 
1056
1561
  /**
@@ -1058,6 +1563,13 @@ export interface BetaManagedAgentsUserInterruptEvent {
1058
1563
  */
1059
1564
  export interface BetaManagedAgentsUserInterruptEventParams {
1060
1565
  type: 'user.interrupt';
1566
+
1567
+ /**
1568
+ * If absent, interrupts every non-archived thread in a multiagent session (or the
1569
+ * primary alone in a single-agent session). If present, interrupts only the named
1570
+ * thread.
1571
+ */
1572
+ session_thread_id?: string | null;
1061
1573
  }
1062
1574
 
1063
1575
  /**
@@ -1128,6 +1640,13 @@ export interface BetaManagedAgentsUserToolConfirmationEvent {
1128
1640
  * A timestamp in RFC 3339 format
1129
1641
  */
1130
1642
  processed_at?: string | null;
1643
+
1644
+ /**
1645
+ * When set, the confirmation routes to this subagent's thread rather than the
1646
+ * primary. Echo this from the `session_thread_id` on the `agent.tool_use` or
1647
+ * `agent.mcp_tool_use` event that prompted the approval.
1648
+ */
1649
+ session_thread_id?: string | null;
1131
1650
  }
1132
1651
 
1133
1652
  /**
@@ -1157,12 +1676,39 @@ export interface BetaManagedAgentsUserToolConfirmationEventParams {
1157
1676
  }
1158
1677
 
1159
1678
  export interface EventListParams extends PageCursorParams {
1679
+ /**
1680
+ * Query param: Return events created after this time (exclusive).
1681
+ */
1682
+ 'created_at[gt]'?: string;
1683
+
1684
+ /**
1685
+ * Query param: Return events created at or after this time (inclusive).
1686
+ */
1687
+ 'created_at[gte]'?: string;
1688
+
1689
+ /**
1690
+ * Query param: Return events created before this time (exclusive).
1691
+ */
1692
+ 'created_at[lt]'?: string;
1693
+
1694
+ /**
1695
+ * Query param: Return events created at or before this time (inclusive).
1696
+ */
1697
+ 'created_at[lte]'?: string;
1698
+
1160
1699
  /**
1161
1700
  * Query param: Sort direction for results, ordered by created_at. Defaults to asc
1162
1701
  * (chronological).
1163
1702
  */
1164
1703
  order?: 'asc' | 'desc';
1165
1704
 
1705
+ /**
1706
+ * Query param: Filter by event type. Values match the `type` field on returned
1707
+ * events (for example, `user.message` or `agent.tool_use`). Omit to return all
1708
+ * event types.
1709
+ */
1710
+ types?: Array<string>;
1711
+
1166
1712
  /**
1167
1713
  * Header param: Optional header to specify the beta version(s) you want to use.
1168
1714
  */
@@ -1196,6 +1742,8 @@ export declare namespace Events {
1196
1742
  type BetaManagedAgentsAgentMessageEvent as BetaManagedAgentsAgentMessageEvent,
1197
1743
  type BetaManagedAgentsAgentThinkingEvent as BetaManagedAgentsAgentThinkingEvent,
1198
1744
  type BetaManagedAgentsAgentThreadContextCompactedEvent as BetaManagedAgentsAgentThreadContextCompactedEvent,
1745
+ type BetaManagedAgentsAgentThreadMessageReceivedEvent as BetaManagedAgentsAgentThreadMessageReceivedEvent,
1746
+ type BetaManagedAgentsAgentThreadMessageSentEvent as BetaManagedAgentsAgentThreadMessageSentEvent,
1199
1747
  type BetaManagedAgentsAgentToolResultEvent as BetaManagedAgentsAgentToolResultEvent,
1200
1748
  type BetaManagedAgentsAgentToolUseEvent as BetaManagedAgentsAgentToolUseEvent,
1201
1749
  type BetaManagedAgentsBase64DocumentSource as BetaManagedAgentsBase64DocumentSource,
@@ -1205,6 +1753,8 @@ export declare namespace Events {
1205
1753
  type BetaManagedAgentsEventParams as BetaManagedAgentsEventParams,
1206
1754
  type BetaManagedAgentsFileDocumentSource as BetaManagedAgentsFileDocumentSource,
1207
1755
  type BetaManagedAgentsFileImageSource as BetaManagedAgentsFileImageSource,
1756
+ type BetaManagedAgentsFileRubric as BetaManagedAgentsFileRubric,
1757
+ type BetaManagedAgentsFileRubricParams as BetaManagedAgentsFileRubricParams,
1208
1758
  type BetaManagedAgentsImageBlock as BetaManagedAgentsImageBlock,
1209
1759
  type BetaManagedAgentsMCPAuthenticationFailedError as BetaManagedAgentsMCPAuthenticationFailedError,
1210
1760
  type BetaManagedAgentsMCPConnectionFailedError as BetaManagedAgentsMCPConnectionFailedError,
@@ -1226,16 +1776,28 @@ export declare namespace Events {
1226
1776
  type BetaManagedAgentsSessionStatusRescheduledEvent as BetaManagedAgentsSessionStatusRescheduledEvent,
1227
1777
  type BetaManagedAgentsSessionStatusRunningEvent as BetaManagedAgentsSessionStatusRunningEvent,
1228
1778
  type BetaManagedAgentsSessionStatusTerminatedEvent as BetaManagedAgentsSessionStatusTerminatedEvent,
1779
+ type BetaManagedAgentsSessionThreadCreatedEvent as BetaManagedAgentsSessionThreadCreatedEvent,
1780
+ type BetaManagedAgentsSessionThreadStatusIdleEvent as BetaManagedAgentsSessionThreadStatusIdleEvent,
1781
+ type BetaManagedAgentsSessionThreadStatusRescheduledEvent as BetaManagedAgentsSessionThreadStatusRescheduledEvent,
1782
+ type BetaManagedAgentsSessionThreadStatusRunningEvent as BetaManagedAgentsSessionThreadStatusRunningEvent,
1783
+ type BetaManagedAgentsSessionThreadStatusTerminatedEvent as BetaManagedAgentsSessionThreadStatusTerminatedEvent,
1229
1784
  type BetaManagedAgentsSpanModelRequestEndEvent as BetaManagedAgentsSpanModelRequestEndEvent,
1230
1785
  type BetaManagedAgentsSpanModelRequestStartEvent as BetaManagedAgentsSpanModelRequestStartEvent,
1231
1786
  type BetaManagedAgentsSpanModelUsage as BetaManagedAgentsSpanModelUsage,
1787
+ type BetaManagedAgentsSpanOutcomeEvaluationEndEvent as BetaManagedAgentsSpanOutcomeEvaluationEndEvent,
1788
+ type BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent as BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
1789
+ type BetaManagedAgentsSpanOutcomeEvaluationStartEvent as BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
1232
1790
  type BetaManagedAgentsStreamSessionEvents as BetaManagedAgentsStreamSessionEvents,
1233
1791
  type BetaManagedAgentsTextBlock as BetaManagedAgentsTextBlock,
1792
+ type BetaManagedAgentsTextRubric as BetaManagedAgentsTextRubric,
1793
+ type BetaManagedAgentsTextRubricParams as BetaManagedAgentsTextRubricParams,
1234
1794
  type BetaManagedAgentsUnknownError as BetaManagedAgentsUnknownError,
1235
1795
  type BetaManagedAgentsURLDocumentSource as BetaManagedAgentsURLDocumentSource,
1236
1796
  type BetaManagedAgentsURLImageSource as BetaManagedAgentsURLImageSource,
1237
1797
  type BetaManagedAgentsUserCustomToolResultEvent as BetaManagedAgentsUserCustomToolResultEvent,
1238
1798
  type BetaManagedAgentsUserCustomToolResultEventParams as BetaManagedAgentsUserCustomToolResultEventParams,
1799
+ type BetaManagedAgentsUserDefineOutcomeEvent as BetaManagedAgentsUserDefineOutcomeEvent,
1800
+ type BetaManagedAgentsUserDefineOutcomeEventParams as BetaManagedAgentsUserDefineOutcomeEventParams,
1239
1801
  type BetaManagedAgentsUserInterruptEvent as BetaManagedAgentsUserInterruptEvent,
1240
1802
  type BetaManagedAgentsUserInterruptEventParams as BetaManagedAgentsUserInterruptEventParams,
1241
1803
  type BetaManagedAgentsUserMessageEvent as BetaManagedAgentsUserMessageEvent,