@anthropic-ai/sdk 0.94.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 (222) hide show
  1. package/CHANGELOG.md +13 -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/streaming.d.mts.map +1 -1
  12. package/core/streaming.d.ts.map +1 -1
  13. package/core/streaming.js +15 -1
  14. package/core/streaming.js.map +1 -1
  15. package/core/streaming.mjs +15 -1
  16. package/core/streaming.mjs.map +1 -1
  17. package/internal/qs/formats.d.mts +7 -0
  18. package/internal/qs/formats.d.mts.map +1 -0
  19. package/internal/qs/formats.d.ts +7 -0
  20. package/internal/qs/formats.d.ts.map +1 -0
  21. package/internal/qs/formats.js +13 -0
  22. package/internal/qs/formats.js.map +1 -0
  23. package/internal/qs/formats.mjs +9 -0
  24. package/internal/qs/formats.mjs.map +1 -0
  25. package/internal/qs/index.d.mts +10 -0
  26. package/internal/qs/index.d.mts.map +1 -0
  27. package/internal/qs/index.d.ts +10 -0
  28. package/internal/qs/index.d.ts.map +1 -0
  29. package/internal/qs/index.js +14 -0
  30. package/internal/qs/index.js.map +1 -0
  31. package/internal/qs/index.mjs +10 -0
  32. package/internal/qs/index.mjs.map +1 -0
  33. package/internal/qs/stringify.d.mts +3 -0
  34. package/internal/qs/stringify.d.mts.map +1 -0
  35. package/internal/qs/stringify.d.ts +3 -0
  36. package/internal/qs/stringify.d.ts.map +1 -0
  37. package/internal/qs/stringify.js +277 -0
  38. package/internal/qs/stringify.js.map +1 -0
  39. package/internal/qs/stringify.mjs +274 -0
  40. package/internal/qs/stringify.mjs.map +1 -0
  41. package/internal/qs/types.d.mts +57 -0
  42. package/internal/qs/types.d.mts.map +1 -0
  43. package/internal/qs/types.d.ts +57 -0
  44. package/internal/qs/types.d.ts.map +1 -0
  45. package/internal/qs/types.js +3 -0
  46. package/internal/qs/types.js.map +1 -0
  47. package/internal/qs/types.mjs +2 -0
  48. package/internal/qs/types.mjs.map +1 -0
  49. package/internal/qs/utils.d.mts +15 -0
  50. package/internal/qs/utils.d.mts.map +1 -0
  51. package/internal/qs/utils.d.ts +15 -0
  52. package/internal/qs/utils.d.ts.map +1 -0
  53. package/internal/qs/utils.js +230 -0
  54. package/internal/qs/utils.js.map +1 -0
  55. package/internal/qs/utils.mjs +217 -0
  56. package/internal/qs/utils.mjs.map +1 -0
  57. package/internal/utils/query.d.mts +0 -3
  58. package/internal/utils/query.d.mts.map +1 -1
  59. package/internal/utils/query.d.ts +0 -3
  60. package/internal/utils/query.d.ts.map +1 -1
  61. package/internal/utils/query.js +3 -16
  62. package/internal/utils/query.js.map +1 -1
  63. package/internal/utils/query.mjs +2 -16
  64. package/internal/utils/query.mjs.map +1 -1
  65. package/package.json +2 -1
  66. package/resources/beta/agents/agents.d.mts +60 -1
  67. package/resources/beta/agents/agents.d.mts.map +1 -1
  68. package/resources/beta/agents/agents.d.ts +60 -1
  69. package/resources/beta/agents/agents.d.ts.map +1 -1
  70. package/resources/beta/agents/agents.js.map +1 -1
  71. package/resources/beta/agents/agents.mjs.map +1 -1
  72. package/resources/beta/agents/index.d.mts +1 -1
  73. package/resources/beta/agents/index.d.mts.map +1 -1
  74. package/resources/beta/agents/index.d.ts +1 -1
  75. package/resources/beta/agents/index.d.ts.map +1 -1
  76. package/resources/beta/agents/index.js.map +1 -1
  77. package/resources/beta/agents/index.mjs.map +1 -1
  78. package/resources/beta/beta.d.mts +9 -5
  79. package/resources/beta/beta.d.mts.map +1 -1
  80. package/resources/beta/beta.d.ts +9 -5
  81. package/resources/beta/beta.d.ts.map +1 -1
  82. package/resources/beta/beta.js +4 -0
  83. package/resources/beta/beta.js.map +1 -1
  84. package/resources/beta/beta.mjs +4 -0
  85. package/resources/beta/beta.mjs.map +1 -1
  86. package/resources/beta/index.d.mts +3 -2
  87. package/resources/beta/index.d.mts.map +1 -1
  88. package/resources/beta/index.d.ts +3 -2
  89. package/resources/beta/index.d.ts.map +1 -1
  90. package/resources/beta/index.js +3 -1
  91. package/resources/beta/index.js.map +1 -1
  92. package/resources/beta/index.mjs +1 -0
  93. package/resources/beta/index.mjs.map +1 -1
  94. package/resources/beta/messages/messages.d.mts +88 -0
  95. package/resources/beta/messages/messages.d.mts.map +1 -1
  96. package/resources/beta/messages/messages.d.ts +88 -0
  97. package/resources/beta/messages/messages.d.ts.map +1 -1
  98. package/resources/beta/messages/messages.js.map +1 -1
  99. package/resources/beta/messages/messages.mjs.map +1 -1
  100. package/resources/beta/sessions/events.d.mts +436 -5
  101. package/resources/beta/sessions/events.d.mts.map +1 -1
  102. package/resources/beta/sessions/events.d.ts +436 -5
  103. package/resources/beta/sessions/events.d.ts.map +1 -1
  104. package/resources/beta/sessions/index.d.mts +3 -2
  105. package/resources/beta/sessions/index.d.mts.map +1 -1
  106. package/resources/beta/sessions/index.d.ts +3 -2
  107. package/resources/beta/sessions/index.d.ts.map +1 -1
  108. package/resources/beta/sessions/index.js +3 -1
  109. package/resources/beta/sessions/index.js.map +1 -1
  110. package/resources/beta/sessions/index.mjs +1 -0
  111. package/resources/beta/sessions/index.mjs.map +1 -1
  112. package/resources/beta/sessions/sessions.d.mts +99 -3
  113. package/resources/beta/sessions/sessions.d.mts.map +1 -1
  114. package/resources/beta/sessions/sessions.d.ts +99 -3
  115. package/resources/beta/sessions/sessions.d.ts.map +1 -1
  116. package/resources/beta/sessions/sessions.js +4 -0
  117. package/resources/beta/sessions/sessions.js.map +1 -1
  118. package/resources/beta/sessions/sessions.mjs +4 -0
  119. package/resources/beta/sessions/sessions.mjs.map +1 -1
  120. package/resources/beta/sessions/threads/events.d.mts +64 -0
  121. package/resources/beta/sessions/threads/events.d.mts.map +1 -0
  122. package/resources/beta/sessions/threads/events.d.ts +64 -0
  123. package/resources/beta/sessions/threads/events.d.ts.map +1 -0
  124. package/resources/beta/sessions/threads/events.js +60 -0
  125. package/resources/beta/sessions/threads/events.js.map +1 -0
  126. package/resources/beta/sessions/threads/events.mjs +56 -0
  127. package/resources/beta/sessions/threads/events.mjs.map +1 -0
  128. package/resources/beta/sessions/threads/index.d.mts +3 -0
  129. package/resources/beta/sessions/threads/index.d.mts.map +1 -0
  130. package/resources/beta/sessions/threads/index.d.ts +3 -0
  131. package/resources/beta/sessions/threads/index.d.ts.map +1 -0
  132. package/resources/beta/sessions/threads/index.js +9 -0
  133. package/resources/beta/sessions/threads/index.js.map +1 -0
  134. package/resources/beta/sessions/threads/index.mjs +4 -0
  135. package/resources/beta/sessions/threads/index.mjs.map +1 -0
  136. package/resources/beta/sessions/threads/threads.d.mts +203 -0
  137. package/resources/beta/sessions/threads/threads.d.mts.map +1 -0
  138. package/resources/beta/sessions/threads/threads.d.ts +203 -0
  139. package/resources/beta/sessions/threads/threads.d.ts.map +1 -0
  140. package/resources/beta/sessions/threads/threads.js +88 -0
  141. package/resources/beta/sessions/threads/threads.js.map +1 -0
  142. package/resources/beta/sessions/threads/threads.mjs +83 -0
  143. package/resources/beta/sessions/threads/threads.mjs.map +1 -0
  144. package/resources/beta/sessions/threads.d.mts +2 -0
  145. package/resources/beta/sessions/threads.d.mts.map +1 -0
  146. package/resources/beta/sessions/threads.d.ts +2 -0
  147. package/resources/beta/sessions/threads.d.ts.map +1 -0
  148. package/resources/beta/sessions/threads.js +6 -0
  149. package/resources/beta/sessions/threads.js.map +1 -0
  150. package/resources/beta/sessions/threads.mjs +3 -0
  151. package/resources/beta/sessions/threads.mjs.map +1 -0
  152. package/resources/beta/user-profiles.d.mts +36 -0
  153. package/resources/beta/user-profiles.d.mts.map +1 -1
  154. package/resources/beta/user-profiles.d.ts +36 -0
  155. package/resources/beta/user-profiles.d.ts.map +1 -1
  156. package/resources/beta/vaults/credentials.d.mts +109 -1
  157. package/resources/beta/vaults/credentials.d.mts.map +1 -1
  158. package/resources/beta/vaults/credentials.d.ts +109 -1
  159. package/resources/beta/vaults/credentials.d.ts.map +1 -1
  160. package/resources/beta/vaults/credentials.js +22 -0
  161. package/resources/beta/vaults/credentials.js.map +1 -1
  162. package/resources/beta/vaults/credentials.mjs +22 -0
  163. package/resources/beta/vaults/credentials.mjs.map +1 -1
  164. package/resources/beta/vaults/index.d.mts +1 -1
  165. package/resources/beta/vaults/index.d.mts.map +1 -1
  166. package/resources/beta/vaults/index.d.ts +1 -1
  167. package/resources/beta/vaults/index.d.ts.map +1 -1
  168. package/resources/beta/vaults/index.js.map +1 -1
  169. package/resources/beta/vaults/index.mjs.map +1 -1
  170. package/resources/beta/vaults/vaults.d.mts +2 -2
  171. package/resources/beta/vaults/vaults.d.mts.map +1 -1
  172. package/resources/beta/vaults/vaults.d.ts +2 -2
  173. package/resources/beta/vaults/vaults.d.ts.map +1 -1
  174. package/resources/beta/vaults/vaults.js.map +1 -1
  175. package/resources/beta/vaults/vaults.mjs.map +1 -1
  176. package/resources/beta/webhooks.d.mts +256 -0
  177. package/resources/beta/webhooks.d.mts.map +1 -0
  178. package/resources/beta/webhooks.d.ts +256 -0
  179. package/resources/beta/webhooks.d.ts.map +1 -0
  180. package/resources/beta/webhooks.js +20 -0
  181. package/resources/beta/webhooks.js.map +1 -0
  182. package/resources/beta/webhooks.mjs +16 -0
  183. package/resources/beta/webhooks.mjs.map +1 -0
  184. package/resources/messages/messages.d.mts +88 -0
  185. package/resources/messages/messages.d.mts.map +1 -1
  186. package/resources/messages/messages.d.ts +88 -0
  187. package/resources/messages/messages.d.ts.map +1 -1
  188. package/resources/messages/messages.js.map +1 -1
  189. package/resources/messages/messages.mjs.map +1 -1
  190. package/src/client.ts +17 -4
  191. package/src/core/streaming.ts +15 -1
  192. package/src/internal/qs/LICENSE.md +13 -0
  193. package/src/internal/qs/README.md +3 -0
  194. package/src/internal/qs/formats.ts +10 -0
  195. package/src/internal/qs/index.ts +13 -0
  196. package/src/internal/qs/stringify.ts +385 -0
  197. package/src/internal/qs/types.ts +71 -0
  198. package/src/internal/qs/utils.ts +265 -0
  199. package/src/internal/utils/query.ts +2 -18
  200. package/src/resources/beta/agents/agents.ts +74 -0
  201. package/src/resources/beta/agents/index.ts +4 -0
  202. package/src/resources/beta/beta.ts +80 -1
  203. package/src/resources/beta/index.ts +37 -0
  204. package/src/resources/beta/messages/messages.ts +88 -0
  205. package/src/resources/beta/sessions/events.ts +565 -3
  206. package/src/resources/beta/sessions/index.ts +34 -0
  207. package/src/resources/beta/sessions/sessions.ts +179 -0
  208. package/src/resources/beta/sessions/threads/events.ts +107 -0
  209. package/src/resources/beta/sessions/threads/index.ts +16 -0
  210. package/src/resources/beta/sessions/threads/threads.ts +344 -0
  211. package/src/resources/beta/sessions/threads.ts +3 -0
  212. package/src/resources/beta/user-profiles.ts +42 -0
  213. package/src/resources/beta/vaults/credentials.ts +150 -0
  214. package/src/resources/beta/vaults/index.ts +6 -0
  215. package/src/resources/beta/vaults/vaults.ts +12 -0
  216. package/src/resources/beta/webhooks.ts +417 -0
  217. package/src/resources/messages/messages.ts +88 -0
  218. package/src/version.ts +1 -1
  219. package/version.d.mts +1 -1
  220. package/version.d.ts +1 -1
  221. package/version.js +1 -1
  222. package/version.mjs +1 -1
@@ -8,6 +8,8 @@ export {
8
8
  type BetaManagedAgentsAgentMessageEvent,
9
9
  type BetaManagedAgentsAgentThinkingEvent,
10
10
  type BetaManagedAgentsAgentThreadContextCompactedEvent,
11
+ type BetaManagedAgentsAgentThreadMessageReceivedEvent,
12
+ type BetaManagedAgentsAgentThreadMessageSentEvent,
11
13
  type BetaManagedAgentsAgentToolResultEvent,
12
14
  type BetaManagedAgentsAgentToolUseEvent,
13
15
  type BetaManagedAgentsBase64DocumentSource,
@@ -17,6 +19,8 @@ export {
17
19
  type BetaManagedAgentsEventParams,
18
20
  type BetaManagedAgentsFileDocumentSource,
19
21
  type BetaManagedAgentsFileImageSource,
22
+ type BetaManagedAgentsFileRubric,
23
+ type BetaManagedAgentsFileRubricParams,
20
24
  type BetaManagedAgentsImageBlock,
21
25
  type BetaManagedAgentsMCPAuthenticationFailedError,
22
26
  type BetaManagedAgentsMCPConnectionFailedError,
@@ -38,16 +42,28 @@ export {
38
42
  type BetaManagedAgentsSessionStatusRescheduledEvent,
39
43
  type BetaManagedAgentsSessionStatusRunningEvent,
40
44
  type BetaManagedAgentsSessionStatusTerminatedEvent,
45
+ type BetaManagedAgentsSessionThreadCreatedEvent,
46
+ type BetaManagedAgentsSessionThreadStatusIdleEvent,
47
+ type BetaManagedAgentsSessionThreadStatusRescheduledEvent,
48
+ type BetaManagedAgentsSessionThreadStatusRunningEvent,
49
+ type BetaManagedAgentsSessionThreadStatusTerminatedEvent,
41
50
  type BetaManagedAgentsSpanModelRequestEndEvent,
42
51
  type BetaManagedAgentsSpanModelRequestStartEvent,
43
52
  type BetaManagedAgentsSpanModelUsage,
53
+ type BetaManagedAgentsSpanOutcomeEvaluationEndEvent,
54
+ type BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
55
+ type BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
44
56
  type BetaManagedAgentsStreamSessionEvents,
45
57
  type BetaManagedAgentsTextBlock,
58
+ type BetaManagedAgentsTextRubric,
59
+ type BetaManagedAgentsTextRubricParams,
46
60
  type BetaManagedAgentsUnknownError,
47
61
  type BetaManagedAgentsURLDocumentSource,
48
62
  type BetaManagedAgentsURLImageSource,
49
63
  type BetaManagedAgentsUserCustomToolResultEvent,
50
64
  type BetaManagedAgentsUserCustomToolResultEventParams,
65
+ type BetaManagedAgentsUserDefineOutcomeEvent,
66
+ type BetaManagedAgentsUserDefineOutcomeEventParams,
51
67
  type BetaManagedAgentsUserInterruptEvent,
52
68
  type BetaManagedAgentsUserInterruptEventParams,
53
69
  type BetaManagedAgentsUserMessageEvent,
@@ -85,8 +101,13 @@ export {
85
101
  type BetaManagedAgentsFileResourceParams,
86
102
  type BetaManagedAgentsGitHubRepositoryResourceParams,
87
103
  type BetaManagedAgentsMemoryStoreResourceParam,
104
+ type BetaManagedAgentsMultiagent,
105
+ type BetaManagedAgentsMultiagentParams,
106
+ type BetaManagedAgentsMultiagentRosterEntryParams,
107
+ type BetaManagedAgentsOutcomeEvaluationResource,
88
108
  type BetaManagedAgentsSession,
89
109
  type BetaManagedAgentsSessionAgent,
110
+ type BetaManagedAgentsSessionMultiagentCoordinator,
90
111
  type BetaManagedAgentsSessionStats,
91
112
  type BetaManagedAgentsSessionUsage,
92
113
  type SessionCreateParams,
@@ -97,3 +118,16 @@ export {
97
118
  type SessionArchiveParams,
98
119
  type BetaManagedAgentsSessionsPageCursor,
99
120
  } from './sessions';
121
+ export {
122
+ Threads,
123
+ type BetaManagedAgentsSessionThread,
124
+ type BetaManagedAgentsSessionThreadAgent,
125
+ type BetaManagedAgentsSessionThreadStats,
126
+ type BetaManagedAgentsSessionThreadStatus,
127
+ type BetaManagedAgentsSessionThreadUsage,
128
+ type BetaManagedAgentsStreamSessionThreadEvents,
129
+ type ThreadRetrieveParams,
130
+ type ThreadListParams,
131
+ type ThreadArchiveParams,
132
+ type BetaManagedAgentsSessionThreadsPageCursor,
133
+ } from './threads/index';
@@ -11,6 +11,8 @@ import {
11
11
  BetaManagedAgentsAgentMessageEvent,
12
12
  BetaManagedAgentsAgentThinkingEvent,
13
13
  BetaManagedAgentsAgentThreadContextCompactedEvent,
14
+ BetaManagedAgentsAgentThreadMessageReceivedEvent,
15
+ BetaManagedAgentsAgentThreadMessageSentEvent,
14
16
  BetaManagedAgentsAgentToolResultEvent,
15
17
  BetaManagedAgentsAgentToolUseEvent,
16
18
  BetaManagedAgentsBase64DocumentSource,
@@ -20,6 +22,8 @@ import {
20
22
  BetaManagedAgentsEventParams,
21
23
  BetaManagedAgentsFileDocumentSource,
22
24
  BetaManagedAgentsFileImageSource,
25
+ BetaManagedAgentsFileRubric,
26
+ BetaManagedAgentsFileRubricParams,
23
27
  BetaManagedAgentsImageBlock,
24
28
  BetaManagedAgentsMCPAuthenticationFailedError,
25
29
  BetaManagedAgentsMCPConnectionFailedError,
@@ -42,16 +46,28 @@ import {
42
46
  BetaManagedAgentsSessionStatusRescheduledEvent,
43
47
  BetaManagedAgentsSessionStatusRunningEvent,
44
48
  BetaManagedAgentsSessionStatusTerminatedEvent,
49
+ BetaManagedAgentsSessionThreadCreatedEvent,
50
+ BetaManagedAgentsSessionThreadStatusIdleEvent,
51
+ BetaManagedAgentsSessionThreadStatusRescheduledEvent,
52
+ BetaManagedAgentsSessionThreadStatusRunningEvent,
53
+ BetaManagedAgentsSessionThreadStatusTerminatedEvent,
45
54
  BetaManagedAgentsSpanModelRequestEndEvent,
46
55
  BetaManagedAgentsSpanModelRequestStartEvent,
47
56
  BetaManagedAgentsSpanModelUsage,
57
+ BetaManagedAgentsSpanOutcomeEvaluationEndEvent,
58
+ BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
59
+ BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
48
60
  BetaManagedAgentsStreamSessionEvents,
49
61
  BetaManagedAgentsTextBlock,
62
+ BetaManagedAgentsTextRubric,
63
+ BetaManagedAgentsTextRubricParams,
50
64
  BetaManagedAgentsURLDocumentSource,
51
65
  BetaManagedAgentsURLImageSource,
52
66
  BetaManagedAgentsUnknownError,
53
67
  BetaManagedAgentsUserCustomToolResultEvent,
54
68
  BetaManagedAgentsUserCustomToolResultEventParams,
69
+ BetaManagedAgentsUserDefineOutcomeEvent,
70
+ BetaManagedAgentsUserDefineOutcomeEventParams,
55
71
  BetaManagedAgentsUserInterruptEvent,
56
72
  BetaManagedAgentsUserInterruptEventParams,
57
73
  BetaManagedAgentsUserMessageEvent,
@@ -80,6 +96,20 @@ import {
80
96
  ResourceUpdateResponse,
81
97
  Resources,
82
98
  } from './resources';
99
+ import * as ThreadsAPI from './threads/threads';
100
+ import {
101
+ BetaManagedAgentsSessionThread,
102
+ BetaManagedAgentsSessionThreadAgent,
103
+ BetaManagedAgentsSessionThreadStats,
104
+ BetaManagedAgentsSessionThreadStatus,
105
+ BetaManagedAgentsSessionThreadUsage,
106
+ BetaManagedAgentsSessionThreadsPageCursor,
107
+ BetaManagedAgentsStreamSessionThreadEvents,
108
+ ThreadArchiveParams,
109
+ ThreadListParams,
110
+ ThreadRetrieveParams,
111
+ Threads,
112
+ } from './threads/threads';
83
113
  import { APIPromise } from '../../../core/api-promise';
84
114
  import { PageCursor, type PageCursorParams, PagePromise } from '../../../core/pagination';
85
115
  import { buildHeaders } from '../../../internal/headers';
@@ -89,6 +119,7 @@ import { path } from '../../../internal/utils/path';
89
119
  export class Sessions extends APIResource {
90
120
  events: EventsAPI.Events = new EventsAPI.Events(this._client);
91
121
  resources: ResourcesAPI.Resources = new ResourcesAPI.Resources(this._client);
122
+ threads: ThreadsAPI.Threads = new ThreadsAPI.Threads(this._client);
92
123
 
93
124
  /**
94
125
  * Create Session
@@ -377,6 +408,87 @@ export interface BetaManagedAgentsMemoryStoreResourceParam {
377
408
  instructions?: string | null;
378
409
  }
379
410
 
411
+ /**
412
+ * Resolved coordinator topology with a concrete agent roster.
413
+ */
414
+ export interface BetaManagedAgentsMultiagent {
415
+ /**
416
+ * Agents the coordinator may spawn as session threads, each resolved to a specific
417
+ * version.
418
+ */
419
+ agents: Array<AgentsAPI.BetaManagedAgentsAgentReference>;
420
+
421
+ type: 'coordinator';
422
+ }
423
+
424
+ /**
425
+ * A coordinator topology: the session's primary thread orchestrates work by
426
+ * spawning session threads, each running an agent drawn from the `agents` roster.
427
+ */
428
+ export interface BetaManagedAgentsMultiagentParams {
429
+ /**
430
+ * Agents the coordinator may spawn as session threads. 1–20 entries. Each entry is
431
+ * an agent ID string, a versioned `{"type":"agent","id","version"}` reference, or
432
+ * `{"type":"self"}` to allow recursive self-invocation. Entries must reference
433
+ * distinct agents (after resolving `self` and string forms); at most one `self`.
434
+ * Referenced agents must exist, must not be archived, and must not themselves have
435
+ * `multiagent` set (depth limit 1).
436
+ */
437
+ agents: Array<BetaManagedAgentsMultiagentRosterEntryParams>;
438
+
439
+ type: 'coordinator';
440
+ }
441
+
442
+ /**
443
+ * An entry in a multiagent roster: an agent ID string, a versioned agent
444
+ * reference, or `self`.
445
+ */
446
+ export type BetaManagedAgentsMultiagentRosterEntryParams =
447
+ | string
448
+ | BetaManagedAgentsAgentParams
449
+ | AgentsAPI.BetaManagedAgentsMultiagentSelfParams;
450
+
451
+ /**
452
+ * Evaluation state for a single outcome defined via a define_outcome event.
453
+ */
454
+ export interface BetaManagedAgentsOutcomeEvaluationResource {
455
+ /**
456
+ * A timestamp in RFC 3339 format
457
+ */
458
+ completed_at: string | null;
459
+
460
+ /**
461
+ * What the agent should produce.
462
+ */
463
+ description: string;
464
+
465
+ /**
466
+ * Grader's verdict text from the most recent evaluation. For satisfied, explains
467
+ * why criteria are met; for needs_revision (intermediate), what's missing; for
468
+ * failed, why unrecoverable.
469
+ */
470
+ explanation: string | null;
471
+
472
+ /**
473
+ * 0-indexed revision cycle the outcome is currently on.
474
+ */
475
+ iteration: number;
476
+
477
+ /**
478
+ * Server-generated outc\_ ID for this outcome.
479
+ */
480
+ outcome_id: string;
481
+
482
+ /**
483
+ * Current evaluation state. 'pending' before the agent begins work; 'running'
484
+ * while producing or revising; 'evaluating' while the grader scores;
485
+ * 'satisfied'/'max_iterations_reached'/'failed'/'interrupted' are terminal.
486
+ */
487
+ result: string;
488
+
489
+ type: 'outcome_evaluation';
490
+ }
491
+
380
492
  /**
381
493
  * A Managed Agents `session`.
382
494
  */
@@ -403,6 +515,12 @@ export interface BetaManagedAgentsSession {
403
515
 
404
516
  metadata: { [key: string]: string };
405
517
 
518
+ /**
519
+ * Per-outcome evaluation state. One entry per define_outcome event sent to the
520
+ * session.
521
+ */
522
+ outcome_evaluations: Array<BetaManagedAgentsOutcomeEvaluationResource>;
523
+
406
524
  resources: Array<ResourcesAPI.BetaManagedAgentsSessionResource>;
407
525
 
408
526
  /**
@@ -452,6 +570,12 @@ export interface BetaManagedAgentsSessionAgent {
452
570
  */
453
571
  model: AgentsAPI.BetaManagedAgentsModelConfig;
454
572
 
573
+ /**
574
+ * Resolved coordinator topology with full agent definitions for each roster
575
+ * member.
576
+ */
577
+ multiagent: BetaManagedAgentsSessionMultiagentCoordinator | null;
578
+
455
579
  name: string;
456
580
 
457
581
  skills: Array<AgentsAPI.BetaManagedAgentsAnthropicSkill | AgentsAPI.BetaManagedAgentsCustomSkill>;
@@ -469,6 +593,19 @@ export interface BetaManagedAgentsSessionAgent {
469
593
  version: number;
470
594
  }
471
595
 
596
+ /**
597
+ * Resolved coordinator topology with full agent definitions for each roster
598
+ * member.
599
+ */
600
+ export interface BetaManagedAgentsSessionMultiagentCoordinator {
601
+ /**
602
+ * Full `agent` definitions the coordinator may spawn as session threads.
603
+ */
604
+ agents: Array<ThreadsAPI.BetaManagedAgentsSessionThreadAgent>;
605
+
606
+ type: 'coordinator';
607
+ }
608
+
472
609
  /**
473
610
  * Timing statistics for a session.
474
611
  */
@@ -638,6 +775,12 @@ export interface SessionListParams extends PageCursorParams {
638
775
  */
639
776
  order?: 'asc' | 'desc';
640
777
 
778
+ /**
779
+ * Query param: Filter by session status. Repeat the parameter to match any of
780
+ * multiple statuses.
781
+ */
782
+ statuses?: Array<'rescheduling' | 'running' | 'idle' | 'terminated'>;
783
+
641
784
  /**
642
785
  * Header param: Optional header to specify the beta version(s) you want to use.
643
786
  */
@@ -660,6 +803,7 @@ export interface SessionArchiveParams {
660
803
 
661
804
  Sessions.Events = Events;
662
805
  Sessions.Resources = Resources;
806
+ Sessions.Threads = Threads;
663
807
 
664
808
  export declare namespace Sessions {
665
809
  export {
@@ -671,8 +815,13 @@ export declare namespace Sessions {
671
815
  type BetaManagedAgentsFileResourceParams as BetaManagedAgentsFileResourceParams,
672
816
  type BetaManagedAgentsGitHubRepositoryResourceParams as BetaManagedAgentsGitHubRepositoryResourceParams,
673
817
  type BetaManagedAgentsMemoryStoreResourceParam as BetaManagedAgentsMemoryStoreResourceParam,
818
+ type BetaManagedAgentsMultiagent as BetaManagedAgentsMultiagent,
819
+ type BetaManagedAgentsMultiagentParams as BetaManagedAgentsMultiagentParams,
820
+ type BetaManagedAgentsMultiagentRosterEntryParams as BetaManagedAgentsMultiagentRosterEntryParams,
821
+ type BetaManagedAgentsOutcomeEvaluationResource as BetaManagedAgentsOutcomeEvaluationResource,
674
822
  type BetaManagedAgentsSession as BetaManagedAgentsSession,
675
823
  type BetaManagedAgentsSessionAgent as BetaManagedAgentsSessionAgent,
824
+ type BetaManagedAgentsSessionMultiagentCoordinator as BetaManagedAgentsSessionMultiagentCoordinator,
676
825
  type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
677
826
  type BetaManagedAgentsSessionUsage as BetaManagedAgentsSessionUsage,
678
827
  type BetaManagedAgentsSessionsPageCursor as BetaManagedAgentsSessionsPageCursor,
@@ -692,6 +841,8 @@ export declare namespace Sessions {
692
841
  type BetaManagedAgentsAgentMessageEvent as BetaManagedAgentsAgentMessageEvent,
693
842
  type BetaManagedAgentsAgentThinkingEvent as BetaManagedAgentsAgentThinkingEvent,
694
843
  type BetaManagedAgentsAgentThreadContextCompactedEvent as BetaManagedAgentsAgentThreadContextCompactedEvent,
844
+ type BetaManagedAgentsAgentThreadMessageReceivedEvent as BetaManagedAgentsAgentThreadMessageReceivedEvent,
845
+ type BetaManagedAgentsAgentThreadMessageSentEvent as BetaManagedAgentsAgentThreadMessageSentEvent,
695
846
  type BetaManagedAgentsAgentToolResultEvent as BetaManagedAgentsAgentToolResultEvent,
696
847
  type BetaManagedAgentsAgentToolUseEvent as BetaManagedAgentsAgentToolUseEvent,
697
848
  type BetaManagedAgentsBase64DocumentSource as BetaManagedAgentsBase64DocumentSource,
@@ -701,6 +852,8 @@ export declare namespace Sessions {
701
852
  type BetaManagedAgentsEventParams as BetaManagedAgentsEventParams,
702
853
  type BetaManagedAgentsFileDocumentSource as BetaManagedAgentsFileDocumentSource,
703
854
  type BetaManagedAgentsFileImageSource as BetaManagedAgentsFileImageSource,
855
+ type BetaManagedAgentsFileRubric as BetaManagedAgentsFileRubric,
856
+ type BetaManagedAgentsFileRubricParams as BetaManagedAgentsFileRubricParams,
704
857
  type BetaManagedAgentsImageBlock as BetaManagedAgentsImageBlock,
705
858
  type BetaManagedAgentsMCPAuthenticationFailedError as BetaManagedAgentsMCPAuthenticationFailedError,
706
859
  type BetaManagedAgentsMCPConnectionFailedError as BetaManagedAgentsMCPConnectionFailedError,
@@ -722,16 +875,28 @@ export declare namespace Sessions {
722
875
  type BetaManagedAgentsSessionStatusRescheduledEvent as BetaManagedAgentsSessionStatusRescheduledEvent,
723
876
  type BetaManagedAgentsSessionStatusRunningEvent as BetaManagedAgentsSessionStatusRunningEvent,
724
877
  type BetaManagedAgentsSessionStatusTerminatedEvent as BetaManagedAgentsSessionStatusTerminatedEvent,
878
+ type BetaManagedAgentsSessionThreadCreatedEvent as BetaManagedAgentsSessionThreadCreatedEvent,
879
+ type BetaManagedAgentsSessionThreadStatusIdleEvent as BetaManagedAgentsSessionThreadStatusIdleEvent,
880
+ type BetaManagedAgentsSessionThreadStatusRescheduledEvent as BetaManagedAgentsSessionThreadStatusRescheduledEvent,
881
+ type BetaManagedAgentsSessionThreadStatusRunningEvent as BetaManagedAgentsSessionThreadStatusRunningEvent,
882
+ type BetaManagedAgentsSessionThreadStatusTerminatedEvent as BetaManagedAgentsSessionThreadStatusTerminatedEvent,
725
883
  type BetaManagedAgentsSpanModelRequestEndEvent as BetaManagedAgentsSpanModelRequestEndEvent,
726
884
  type BetaManagedAgentsSpanModelRequestStartEvent as BetaManagedAgentsSpanModelRequestStartEvent,
727
885
  type BetaManagedAgentsSpanModelUsage as BetaManagedAgentsSpanModelUsage,
886
+ type BetaManagedAgentsSpanOutcomeEvaluationEndEvent as BetaManagedAgentsSpanOutcomeEvaluationEndEvent,
887
+ type BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent as BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
888
+ type BetaManagedAgentsSpanOutcomeEvaluationStartEvent as BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
728
889
  type BetaManagedAgentsStreamSessionEvents as BetaManagedAgentsStreamSessionEvents,
729
890
  type BetaManagedAgentsTextBlock as BetaManagedAgentsTextBlock,
891
+ type BetaManagedAgentsTextRubric as BetaManagedAgentsTextRubric,
892
+ type BetaManagedAgentsTextRubricParams as BetaManagedAgentsTextRubricParams,
730
893
  type BetaManagedAgentsUnknownError as BetaManagedAgentsUnknownError,
731
894
  type BetaManagedAgentsURLDocumentSource as BetaManagedAgentsURLDocumentSource,
732
895
  type BetaManagedAgentsURLImageSource as BetaManagedAgentsURLImageSource,
733
896
  type BetaManagedAgentsUserCustomToolResultEvent as BetaManagedAgentsUserCustomToolResultEvent,
734
897
  type BetaManagedAgentsUserCustomToolResultEventParams as BetaManagedAgentsUserCustomToolResultEventParams,
898
+ type BetaManagedAgentsUserDefineOutcomeEvent as BetaManagedAgentsUserDefineOutcomeEvent,
899
+ type BetaManagedAgentsUserDefineOutcomeEventParams as BetaManagedAgentsUserDefineOutcomeEventParams,
735
900
  type BetaManagedAgentsUserInterruptEvent as BetaManagedAgentsUserInterruptEvent,
736
901
  type BetaManagedAgentsUserInterruptEventParams as BetaManagedAgentsUserInterruptEventParams,
737
902
  type BetaManagedAgentsUserMessageEvent as BetaManagedAgentsUserMessageEvent,
@@ -760,4 +925,18 @@ export declare namespace Sessions {
760
925
  type ResourceDeleteParams as ResourceDeleteParams,
761
926
  type ResourceAddParams as ResourceAddParams,
762
927
  };
928
+
929
+ export {
930
+ Threads as Threads,
931
+ type BetaManagedAgentsSessionThread as BetaManagedAgentsSessionThread,
932
+ type BetaManagedAgentsSessionThreadAgent as BetaManagedAgentsSessionThreadAgent,
933
+ type BetaManagedAgentsSessionThreadStats as BetaManagedAgentsSessionThreadStats,
934
+ type BetaManagedAgentsSessionThreadStatus as BetaManagedAgentsSessionThreadStatus,
935
+ type BetaManagedAgentsSessionThreadUsage as BetaManagedAgentsSessionThreadUsage,
936
+ type BetaManagedAgentsStreamSessionThreadEvents as BetaManagedAgentsStreamSessionThreadEvents,
937
+ type BetaManagedAgentsSessionThreadsPageCursor as BetaManagedAgentsSessionThreadsPageCursor,
938
+ type ThreadRetrieveParams as ThreadRetrieveParams,
939
+ type ThreadListParams as ThreadListParams,
940
+ type ThreadArchiveParams as ThreadArchiveParams,
941
+ };
763
942
  }
@@ -0,0 +1,107 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ import { APIResource } from '../../../../core/resource';
4
+ import * as BetaAPI from '../../beta';
5
+ import * as EventsAPI from '../events';
6
+ import { BetaManagedAgentsSessionEventsPageCursor } from '../events';
7
+ import * as ThreadsAPI from './threads';
8
+ import { APIPromise } from '../../../../core/api-promise';
9
+ import { PageCursor, type PageCursorParams, PagePromise } from '../../../../core/pagination';
10
+ import { Stream } from '../../../../core/streaming';
11
+ import { buildHeaders } from '../../../../internal/headers';
12
+ import { RequestOptions } from '../../../../internal/request-options';
13
+ import { path } from '../../../../internal/utils/path';
14
+
15
+ export class Events extends APIResource {
16
+ /**
17
+ * List Session Thread Events
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * // Automatically fetches more pages as needed.
22
+ * for await (const betaManagedAgentsSessionEvent of client.beta.sessions.threads.events.list(
23
+ * 'sthr_011CZkZVWa6oIjw0rgXZpnBt',
24
+ * { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
25
+ * )) {
26
+ * // ...
27
+ * }
28
+ * ```
29
+ */
30
+ list(
31
+ threadID: string,
32
+ params: EventListParams,
33
+ options?: RequestOptions,
34
+ ): PagePromise<BetaManagedAgentsSessionEventsPageCursor, EventsAPI.BetaManagedAgentsSessionEvent> {
35
+ const { session_id, betas, ...query } = params;
36
+ return this._client.getAPIList(
37
+ path`/v1/sessions/${session_id}/threads/${threadID}/events?beta=true`,
38
+ PageCursor<EventsAPI.BetaManagedAgentsSessionEvent>,
39
+ {
40
+ query,
41
+ ...options,
42
+ headers: buildHeaders([
43
+ { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
44
+ options?.headers,
45
+ ]),
46
+ },
47
+ );
48
+ }
49
+
50
+ /**
51
+ * Stream Session Thread Events
52
+ *
53
+ * @example
54
+ * ```ts
55
+ * const betaManagedAgentsStreamSessionThreadEvents =
56
+ * await client.beta.sessions.threads.events.stream(
57
+ * 'sthr_011CZkZVWa6oIjw0rgXZpnBt',
58
+ * { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
59
+ * );
60
+ * ```
61
+ */
62
+ stream(
63
+ threadID: string,
64
+ params: EventStreamParams,
65
+ options?: RequestOptions,
66
+ ): APIPromise<Stream<ThreadsAPI.BetaManagedAgentsStreamSessionThreadEvents>> {
67
+ const { session_id, betas } = params;
68
+ return this._client.get(path`/v1/sessions/${session_id}/threads/${threadID}/stream?beta=true`, {
69
+ ...options,
70
+ headers: buildHeaders([
71
+ { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
72
+ options?.headers,
73
+ ]),
74
+ stream: true,
75
+ }) as APIPromise<Stream<ThreadsAPI.BetaManagedAgentsStreamSessionThreadEvents>>;
76
+ }
77
+ }
78
+
79
+ export interface EventListParams extends PageCursorParams {
80
+ /**
81
+ * Path param: Path parameter session_id
82
+ */
83
+ session_id: string;
84
+
85
+ /**
86
+ * Header param: Optional header to specify the beta version(s) you want to use.
87
+ */
88
+ betas?: Array<BetaAPI.AnthropicBeta>;
89
+ }
90
+
91
+ export interface EventStreamParams {
92
+ /**
93
+ * Path param: Path parameter session_id
94
+ */
95
+ session_id: string;
96
+
97
+ /**
98
+ * Header param: Optional header to specify the beta version(s) you want to use.
99
+ */
100
+ betas?: Array<BetaAPI.AnthropicBeta>;
101
+ }
102
+
103
+ export declare namespace Events {
104
+ export { type EventListParams as EventListParams, type EventStreamParams as EventStreamParams };
105
+ }
106
+
107
+ export { type BetaManagedAgentsSessionEventsPageCursor };
@@ -0,0 +1,16 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ export { Events, type EventListParams, type EventStreamParams } from './events';
4
+ export {
5
+ Threads,
6
+ type BetaManagedAgentsSessionThread,
7
+ type BetaManagedAgentsSessionThreadAgent,
8
+ type BetaManagedAgentsSessionThreadStats,
9
+ type BetaManagedAgentsSessionThreadStatus,
10
+ type BetaManagedAgentsSessionThreadUsage,
11
+ type BetaManagedAgentsStreamSessionThreadEvents,
12
+ type ThreadRetrieveParams,
13
+ type ThreadListParams,
14
+ type ThreadArchiveParams,
15
+ type BetaManagedAgentsSessionThreadsPageCursor,
16
+ } from './threads';