@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
@@ -0,0 +1,344 @@
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 AgentsAPI from '../../agents/agents';
6
+ import * as EventsAPI from '../events';
7
+ import * as SessionsAPI from '../sessions';
8
+ import * as ThreadsEventsAPI from './events';
9
+ import { EventListParams, EventStreamParams, Events } from './events';
10
+ import { APIPromise } from '../../../../core/api-promise';
11
+ import { PageCursor, type PageCursorParams, PagePromise } from '../../../../core/pagination';
12
+ import { buildHeaders } from '../../../../internal/headers';
13
+ import { RequestOptions } from '../../../../internal/request-options';
14
+ import { path } from '../../../../internal/utils/path';
15
+
16
+ export class Threads extends APIResource {
17
+ events: ThreadsEventsAPI.Events = new ThreadsEventsAPI.Events(this._client);
18
+
19
+ /**
20
+ * Get Session Thread
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * const betaManagedAgentsSessionThread =
25
+ * await client.beta.sessions.threads.retrieve(
26
+ * 'sthr_011CZkZVWa6oIjw0rgXZpnBt',
27
+ * { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
28
+ * );
29
+ * ```
30
+ */
31
+ retrieve(
32
+ threadID: string,
33
+ params: ThreadRetrieveParams,
34
+ options?: RequestOptions,
35
+ ): APIPromise<BetaManagedAgentsSessionThread> {
36
+ const { session_id, betas } = params;
37
+ return this._client.get(path`/v1/sessions/${session_id}/threads/${threadID}?beta=true`, {
38
+ ...options,
39
+ headers: buildHeaders([
40
+ { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
41
+ options?.headers,
42
+ ]),
43
+ });
44
+ }
45
+
46
+ /**
47
+ * List Session Threads
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * // Automatically fetches more pages as needed.
52
+ * for await (const betaManagedAgentsSessionThread of client.beta.sessions.threads.list(
53
+ * 'sesn_011CZkZAtmR3yMPDzynEDxu7',
54
+ * )) {
55
+ * // ...
56
+ * }
57
+ * ```
58
+ */
59
+ list(
60
+ sessionID: string,
61
+ params: ThreadListParams | null | undefined = {},
62
+ options?: RequestOptions,
63
+ ): PagePromise<BetaManagedAgentsSessionThreadsPageCursor, BetaManagedAgentsSessionThread> {
64
+ const { betas, ...query } = params ?? {};
65
+ return this._client.getAPIList(
66
+ path`/v1/sessions/${sessionID}/threads?beta=true`,
67
+ PageCursor<BetaManagedAgentsSessionThread>,
68
+ {
69
+ query,
70
+ ...options,
71
+ headers: buildHeaders([
72
+ { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
73
+ options?.headers,
74
+ ]),
75
+ },
76
+ );
77
+ }
78
+
79
+ /**
80
+ * Archive Session Thread
81
+ *
82
+ * @example
83
+ * ```ts
84
+ * const betaManagedAgentsSessionThread =
85
+ * await client.beta.sessions.threads.archive(
86
+ * 'sthr_011CZkZVWa6oIjw0rgXZpnBt',
87
+ * { session_id: 'sesn_011CZkZAtmR3yMPDzynEDxu7' },
88
+ * );
89
+ * ```
90
+ */
91
+ archive(
92
+ threadID: string,
93
+ params: ThreadArchiveParams,
94
+ options?: RequestOptions,
95
+ ): APIPromise<BetaManagedAgentsSessionThread> {
96
+ const { session_id, betas } = params;
97
+ return this._client.post(path`/v1/sessions/${session_id}/threads/${threadID}/archive?beta=true`, {
98
+ ...options,
99
+ headers: buildHeaders([
100
+ { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
101
+ options?.headers,
102
+ ]),
103
+ });
104
+ }
105
+ }
106
+
107
+ export type BetaManagedAgentsSessionThreadsPageCursor = PageCursor<BetaManagedAgentsSessionThread>;
108
+
109
+ /**
110
+ * An execution thread within a `session`. Each session has one primary thread plus
111
+ * zero or more child threads spawned by the coordinator.
112
+ */
113
+ export interface BetaManagedAgentsSessionThread {
114
+ /**
115
+ * Unique identifier for this thread.
116
+ */
117
+ id: string;
118
+
119
+ /**
120
+ * Resolved `agent` definition for a single `session_thread`. Snapshot of the agent
121
+ * at thread creation time. The multiagent roster is not repeated here; read it
122
+ * from `Session.agent`.
123
+ */
124
+ agent: BetaManagedAgentsSessionThreadAgent;
125
+
126
+ /**
127
+ * A timestamp in RFC 3339 format
128
+ */
129
+ archived_at: string | null;
130
+
131
+ /**
132
+ * A timestamp in RFC 3339 format
133
+ */
134
+ created_at: string;
135
+
136
+ /**
137
+ * Parent thread that spawned this thread. Null for the primary thread.
138
+ */
139
+ parent_thread_id: string | null;
140
+
141
+ /**
142
+ * The session this thread belongs to.
143
+ */
144
+ session_id: string;
145
+
146
+ /**
147
+ * Timing statistics for a session thread.
148
+ */
149
+ stats: BetaManagedAgentsSessionThreadStats | null;
150
+
151
+ /**
152
+ * SessionThreadStatus enum
153
+ */
154
+ status: BetaManagedAgentsSessionThreadStatus;
155
+
156
+ type: 'session_thread';
157
+
158
+ /**
159
+ * A timestamp in RFC 3339 format
160
+ */
161
+ updated_at: string;
162
+
163
+ /**
164
+ * Cumulative token usage for a session thread across all turns.
165
+ */
166
+ usage: BetaManagedAgentsSessionThreadUsage | null;
167
+ }
168
+
169
+ /**
170
+ * Resolved `agent` definition for a single `session_thread`. Snapshot of the agent
171
+ * at thread creation time. The multiagent roster is not repeated here; read it
172
+ * from `Session.agent`.
173
+ */
174
+ export interface BetaManagedAgentsSessionThreadAgent {
175
+ id: string;
176
+
177
+ description: string | null;
178
+
179
+ mcp_servers: Array<AgentsAPI.BetaManagedAgentsMCPServerURLDefinition>;
180
+
181
+ /**
182
+ * Model identifier and configuration.
183
+ */
184
+ model: AgentsAPI.BetaManagedAgentsModelConfig;
185
+
186
+ name: string;
187
+
188
+ skills: Array<AgentsAPI.BetaManagedAgentsAnthropicSkill | AgentsAPI.BetaManagedAgentsCustomSkill>;
189
+
190
+ system: string | null;
191
+
192
+ tools: Array<
193
+ | AgentsAPI.BetaManagedAgentsAgentToolset20260401
194
+ | AgentsAPI.BetaManagedAgentsMCPToolset
195
+ | AgentsAPI.BetaManagedAgentsCustomTool
196
+ >;
197
+
198
+ type: 'agent';
199
+
200
+ version: number;
201
+ }
202
+
203
+ /**
204
+ * Timing statistics for a session thread.
205
+ */
206
+ export interface BetaManagedAgentsSessionThreadStats {
207
+ /**
208
+ * Cumulative time in seconds the thread spent actively running. Excludes idle
209
+ * time.
210
+ */
211
+ active_seconds?: number;
212
+
213
+ /**
214
+ * Elapsed time since thread creation in seconds. For archived threads, frozen at
215
+ * the final update.
216
+ */
217
+ duration_seconds?: number;
218
+
219
+ /**
220
+ * Time in seconds for the thread to begin running. Zero for child threads, which
221
+ * start immediately.
222
+ */
223
+ startup_seconds?: number;
224
+ }
225
+
226
+ /**
227
+ * SessionThreadStatus enum
228
+ */
229
+ export type BetaManagedAgentsSessionThreadStatus = 'running' | 'idle' | 'rescheduling' | 'terminated';
230
+
231
+ /**
232
+ * Cumulative token usage for a session thread across all turns.
233
+ */
234
+ export interface BetaManagedAgentsSessionThreadUsage {
235
+ /**
236
+ * Prompt-cache creation token usage broken down by cache lifetime.
237
+ */
238
+ cache_creation?: SessionsAPI.BetaManagedAgentsCacheCreationUsage;
239
+
240
+ /**
241
+ * Total tokens read from prompt cache.
242
+ */
243
+ cache_read_input_tokens?: number;
244
+
245
+ /**
246
+ * Total input tokens consumed across all turns.
247
+ */
248
+ input_tokens?: number;
249
+
250
+ /**
251
+ * Total output tokens generated across all turns.
252
+ */
253
+ output_tokens?: number;
254
+ }
255
+
256
+ /**
257
+ * Server-sent event in a single thread's stream.
258
+ */
259
+ export type BetaManagedAgentsStreamSessionThreadEvents =
260
+ | EventsAPI.BetaManagedAgentsUserMessageEvent
261
+ | EventsAPI.BetaManagedAgentsUserInterruptEvent
262
+ | EventsAPI.BetaManagedAgentsUserToolConfirmationEvent
263
+ | EventsAPI.BetaManagedAgentsUserCustomToolResultEvent
264
+ | EventsAPI.BetaManagedAgentsAgentCustomToolUseEvent
265
+ | EventsAPI.BetaManagedAgentsAgentMessageEvent
266
+ | EventsAPI.BetaManagedAgentsAgentThinkingEvent
267
+ | EventsAPI.BetaManagedAgentsAgentMCPToolUseEvent
268
+ | EventsAPI.BetaManagedAgentsAgentMCPToolResultEvent
269
+ | EventsAPI.BetaManagedAgentsAgentToolUseEvent
270
+ | EventsAPI.BetaManagedAgentsAgentToolResultEvent
271
+ | EventsAPI.BetaManagedAgentsAgentThreadMessageReceivedEvent
272
+ | EventsAPI.BetaManagedAgentsAgentThreadMessageSentEvent
273
+ | EventsAPI.BetaManagedAgentsAgentThreadContextCompactedEvent
274
+ | EventsAPI.BetaManagedAgentsSessionErrorEvent
275
+ | EventsAPI.BetaManagedAgentsSessionStatusRescheduledEvent
276
+ | EventsAPI.BetaManagedAgentsSessionStatusRunningEvent
277
+ | EventsAPI.BetaManagedAgentsSessionStatusIdleEvent
278
+ | EventsAPI.BetaManagedAgentsSessionStatusTerminatedEvent
279
+ | EventsAPI.BetaManagedAgentsSessionThreadCreatedEvent
280
+ | EventsAPI.BetaManagedAgentsSpanOutcomeEvaluationStartEvent
281
+ | EventsAPI.BetaManagedAgentsSpanOutcomeEvaluationEndEvent
282
+ | EventsAPI.BetaManagedAgentsSpanModelRequestStartEvent
283
+ | EventsAPI.BetaManagedAgentsSpanModelRequestEndEvent
284
+ | EventsAPI.BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent
285
+ | EventsAPI.BetaManagedAgentsUserDefineOutcomeEvent
286
+ | EventsAPI.BetaManagedAgentsSessionDeletedEvent
287
+ | EventsAPI.BetaManagedAgentsSessionThreadStatusRunningEvent
288
+ | EventsAPI.BetaManagedAgentsSessionThreadStatusIdleEvent
289
+ | EventsAPI.BetaManagedAgentsSessionThreadStatusTerminatedEvent
290
+ | EventsAPI.BetaManagedAgentsSessionThreadStatusRescheduledEvent;
291
+
292
+ export interface ThreadRetrieveParams {
293
+ /**
294
+ * Path param: Path parameter session_id
295
+ */
296
+ session_id: string;
297
+
298
+ /**
299
+ * Header param: Optional header to specify the beta version(s) you want to use.
300
+ */
301
+ betas?: Array<BetaAPI.AnthropicBeta>;
302
+ }
303
+
304
+ export interface ThreadListParams extends PageCursorParams {
305
+ /**
306
+ * Header param: Optional header to specify the beta version(s) you want to use.
307
+ */
308
+ betas?: Array<BetaAPI.AnthropicBeta>;
309
+ }
310
+
311
+ export interface ThreadArchiveParams {
312
+ /**
313
+ * Path param: Path parameter session_id
314
+ */
315
+ session_id: string;
316
+
317
+ /**
318
+ * Header param: Optional header to specify the beta version(s) you want to use.
319
+ */
320
+ betas?: Array<BetaAPI.AnthropicBeta>;
321
+ }
322
+
323
+ Threads.Events = Events;
324
+
325
+ export declare namespace Threads {
326
+ export {
327
+ type BetaManagedAgentsSessionThread as BetaManagedAgentsSessionThread,
328
+ type BetaManagedAgentsSessionThreadAgent as BetaManagedAgentsSessionThreadAgent,
329
+ type BetaManagedAgentsSessionThreadStats as BetaManagedAgentsSessionThreadStats,
330
+ type BetaManagedAgentsSessionThreadStatus as BetaManagedAgentsSessionThreadStatus,
331
+ type BetaManagedAgentsSessionThreadUsage as BetaManagedAgentsSessionThreadUsage,
332
+ type BetaManagedAgentsStreamSessionThreadEvents as BetaManagedAgentsStreamSessionThreadEvents,
333
+ type BetaManagedAgentsSessionThreadsPageCursor as BetaManagedAgentsSessionThreadsPageCursor,
334
+ type ThreadRetrieveParams as ThreadRetrieveParams,
335
+ type ThreadListParams as ThreadListParams,
336
+ type ThreadArchiveParams as ThreadArchiveParams,
337
+ };
338
+
339
+ export {
340
+ Events as Events,
341
+ type EventListParams as EventListParams,
342
+ type EventStreamParams as EventStreamParams,
343
+ };
344
+ }
@@ -0,0 +1,3 @@
1
+ // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
2
+
3
+ export * from './threads/index';
@@ -155,6 +155,13 @@ export interface BetaUserProfile {
155
155
  */
156
156
  metadata: { [key: string]: string };
157
157
 
158
+ /**
159
+ * How the entity behind a user profile relates to the platform that owns the API
160
+ * key. `external`: an individual end-user of the platform. `resold`: a company the
161
+ * platform resells Claude access to. `internal`: the platform's own usage.
162
+ */
163
+ relationship: 'external' | 'resold' | 'internal';
164
+
158
165
  /**
159
166
  * Trust grants for this profile, keyed by grant name. Key omitted when no grant is
160
167
  * active or in flight.
@@ -175,6 +182,12 @@ export interface BetaUserProfile {
175
182
  * Platform's own identifier for this user. Not enforced unique.
176
183
  */
177
184
  external_id?: string | null;
185
+
186
+ /**
187
+ * Display name of the entity this profile represents. For `resold` this is the
188
+ * resold-to company's name.
189
+ */
190
+ name?: string | null;
178
191
  }
179
192
 
180
193
  export interface BetaUserProfileEnrollmentURL {
@@ -215,6 +228,21 @@ export interface UserProfileCreateParams {
215
228
  */
216
229
  metadata?: { [key: string]: string };
217
230
 
231
+ /**
232
+ * Body param: Display name of the entity this profile represents. Required when
233
+ * relationship is `resold` (the resold-to company's name); optional otherwise.
234
+ * Maximum 255 characters.
235
+ */
236
+ name?: string | null;
237
+
238
+ /**
239
+ * Body param: How the entity behind a user profile relates to the platform that
240
+ * owns the API key. `external`: an individual end-user of the platform. `resold`:
241
+ * a company the platform resells Claude access to. `internal`: the platform's own
242
+ * usage.
243
+ */
244
+ relationship?: 'external' | 'resold' | 'internal';
245
+
218
246
  /**
219
247
  * Header param: Optional header to specify the beta version(s) you want to use.
220
248
  */
@@ -243,6 +271,20 @@ export interface UserProfileUpdateParams {
243
271
  */
244
272
  metadata?: { [key: string]: string };
245
273
 
274
+ /**
275
+ * Body param: If present, replaces the stored name. Omit to leave unchanged.
276
+ * Maximum 255 characters.
277
+ */
278
+ name?: string | null;
279
+
280
+ /**
281
+ * Body param: How the entity behind a user profile relates to the platform that
282
+ * owns the API key. `external`: an individual end-user of the platform. `resold`:
283
+ * a company the platform resells Claude access to. `internal`: the platform's own
284
+ * usage.
285
+ */
286
+ relationship?: 'external' | 'resold' | 'internal' | null;
287
+
246
288
  /**
247
289
  * Header param: Optional header to specify the beta version(s) you want to use.
248
290
  */
@@ -185,6 +185,36 @@ export class Credentials extends APIResource {
185
185
  ]),
186
186
  });
187
187
  }
188
+
189
+ /**
190
+ * Validate Credential
191
+ *
192
+ * @example
193
+ * ```ts
194
+ * const betaManagedAgentsCredentialValidation =
195
+ * await client.beta.vaults.credentials.mcpOAuthValidate(
196
+ * 'vcrd_011CZkZEMt8gZan2iYOQfSkw',
197
+ * { vault_id: 'vlt_011CZkZDLs7fYzm1hXNPeRjv' },
198
+ * );
199
+ * ```
200
+ */
201
+ mcpOAuthValidate(
202
+ credentialID: string,
203
+ params: CredentialMCPOAuthValidateParams,
204
+ options?: RequestOptions,
205
+ ): APIPromise<BetaManagedAgentsCredentialValidation> {
206
+ const { vault_id, betas } = params;
207
+ return this._client.post(
208
+ path`/v1/vaults/${vault_id}/credentials/${credentialID}/mcp_oauth_validate?beta=true`,
209
+ {
210
+ ...options,
211
+ headers: buildHeaders([
212
+ { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
213
+ options?.headers,
214
+ ]),
215
+ },
216
+ );
217
+ }
188
218
  }
189
219
 
190
220
  export type BetaManagedAgentsCredentialsPageCursor = PageCursor<BetaManagedAgentsCredential>;
@@ -237,6 +267,53 @@ export interface BetaManagedAgentsCredential {
237
267
  display_name?: string | null;
238
268
  }
239
269
 
270
+ /**
271
+ * Result of live-probing a credential against its configured MCP server.
272
+ */
273
+ export interface BetaManagedAgentsCredentialValidation {
274
+ /**
275
+ * Unique identifier of the credential that was validated.
276
+ */
277
+ credential_id: string;
278
+
279
+ /**
280
+ * Whether the credential has a refresh token configured.
281
+ */
282
+ has_refresh_token: boolean;
283
+
284
+ /**
285
+ * The failing step of an MCP validation probe.
286
+ */
287
+ mcp_probe: BetaManagedAgentsMCPProbe | null;
288
+
289
+ /**
290
+ * Outcome of a refresh-token exchange attempted during credential validation.
291
+ */
292
+ refresh: BetaManagedAgentsRefreshObject | null;
293
+
294
+ /**
295
+ * Overall verdict of a credential validation probe.
296
+ */
297
+ status: BetaManagedAgentsCredentialValidationStatus;
298
+
299
+ type: 'vault_credential_validation';
300
+
301
+ /**
302
+ * A timestamp in RFC 3339 format
303
+ */
304
+ validated_at: string;
305
+
306
+ /**
307
+ * Identifier of the vault containing the credential.
308
+ */
309
+ vault_id: string;
310
+ }
311
+
312
+ /**
313
+ * Overall verdict of a credential validation probe.
314
+ */
315
+ export type BetaManagedAgentsCredentialValidationStatus = 'valid' | 'invalid' | 'unknown';
316
+
240
317
  /**
241
318
  * Confirmation of a deleted credential.
242
319
  */
@@ -414,6 +491,61 @@ export interface BetaManagedAgentsMCPOAuthUpdateParams {
414
491
  refresh?: BetaManagedAgentsMCPOAuthRefreshUpdateParams | null;
415
492
  }
416
493
 
494
+ /**
495
+ * The failing step of an MCP validation probe.
496
+ */
497
+ export interface BetaManagedAgentsMCPProbe {
498
+ /**
499
+ * An HTTP response captured during a credential validation probe.
500
+ */
501
+ http_response: BetaManagedAgentsRefreshHTTPResponse | null;
502
+
503
+ /**
504
+ * The MCP method that failed (for example `initialize` or `tools/list`).
505
+ */
506
+ method: string;
507
+ }
508
+
509
+ /**
510
+ * An HTTP response captured during a credential validation probe.
511
+ */
512
+ export interface BetaManagedAgentsRefreshHTTPResponse {
513
+ /**
514
+ * Response body. May be truncated and has sensitive values scrubbed.
515
+ */
516
+ body: string;
517
+
518
+ /**
519
+ * Whether `body` was truncated.
520
+ */
521
+ body_truncated: boolean;
522
+
523
+ /**
524
+ * Value of the `Content-Type` response header.
525
+ */
526
+ content_type: string;
527
+
528
+ /**
529
+ * HTTP status code.
530
+ */
531
+ status_code: number;
532
+ }
533
+
534
+ /**
535
+ * Outcome of a refresh-token exchange attempted during credential validation.
536
+ */
537
+ export interface BetaManagedAgentsRefreshObject {
538
+ /**
539
+ * An HTTP response captured during a credential validation probe.
540
+ */
541
+ http_response: BetaManagedAgentsRefreshHTTPResponse | null;
542
+
543
+ /**
544
+ * Outcome of a refresh-token exchange attempted during credential validation.
545
+ */
546
+ status: 'succeeded' | 'failed' | 'connect_error' | 'no_refresh_token';
547
+ }
548
+
417
549
  /**
418
550
  * Static bearer token credential details for an MCP server.
419
551
  */
@@ -631,9 +763,23 @@ export interface CredentialArchiveParams {
631
763
  betas?: Array<BetaAPI.AnthropicBeta>;
632
764
  }
633
765
 
766
+ export interface CredentialMCPOAuthValidateParams {
767
+ /**
768
+ * Path param: Path parameter vault_id
769
+ */
770
+ vault_id: string;
771
+
772
+ /**
773
+ * Header param: Optional header to specify the beta version(s) you want to use.
774
+ */
775
+ betas?: Array<BetaAPI.AnthropicBeta>;
776
+ }
777
+
634
778
  export declare namespace Credentials {
635
779
  export {
636
780
  type BetaManagedAgentsCredential as BetaManagedAgentsCredential,
781
+ type BetaManagedAgentsCredentialValidation as BetaManagedAgentsCredentialValidation,
782
+ type BetaManagedAgentsCredentialValidationStatus as BetaManagedAgentsCredentialValidationStatus,
637
783
  type BetaManagedAgentsDeletedCredential as BetaManagedAgentsDeletedCredential,
638
784
  type BetaManagedAgentsMCPOAuthAuthResponse as BetaManagedAgentsMCPOAuthAuthResponse,
639
785
  type BetaManagedAgentsMCPOAuthCreateParams as BetaManagedAgentsMCPOAuthCreateParams,
@@ -641,6 +787,9 @@ export declare namespace Credentials {
641
787
  type BetaManagedAgentsMCPOAuthRefreshResponse as BetaManagedAgentsMCPOAuthRefreshResponse,
642
788
  type BetaManagedAgentsMCPOAuthRefreshUpdateParams as BetaManagedAgentsMCPOAuthRefreshUpdateParams,
643
789
  type BetaManagedAgentsMCPOAuthUpdateParams as BetaManagedAgentsMCPOAuthUpdateParams,
790
+ type BetaManagedAgentsMCPProbe as BetaManagedAgentsMCPProbe,
791
+ type BetaManagedAgentsRefreshHTTPResponse as BetaManagedAgentsRefreshHTTPResponse,
792
+ type BetaManagedAgentsRefreshObject as BetaManagedAgentsRefreshObject,
644
793
  type BetaManagedAgentsStaticBearerAuthResponse as BetaManagedAgentsStaticBearerAuthResponse,
645
794
  type BetaManagedAgentsStaticBearerCreateParams as BetaManagedAgentsStaticBearerCreateParams,
646
795
  type BetaManagedAgentsStaticBearerUpdateParams as BetaManagedAgentsStaticBearerUpdateParams,
@@ -659,5 +808,6 @@ export declare namespace Credentials {
659
808
  type CredentialListParams as CredentialListParams,
660
809
  type CredentialDeleteParams as CredentialDeleteParams,
661
810
  type CredentialArchiveParams as CredentialArchiveParams,
811
+ type CredentialMCPOAuthValidateParams as CredentialMCPOAuthValidateParams,
662
812
  };
663
813
  }
@@ -3,6 +3,8 @@
3
3
  export {
4
4
  Credentials,
5
5
  type BetaManagedAgentsCredential,
6
+ type BetaManagedAgentsCredentialValidation,
7
+ type BetaManagedAgentsCredentialValidationStatus,
6
8
  type BetaManagedAgentsDeletedCredential,
7
9
  type BetaManagedAgentsMCPOAuthAuthResponse,
8
10
  type BetaManagedAgentsMCPOAuthCreateParams,
@@ -10,6 +12,9 @@ export {
10
12
  type BetaManagedAgentsMCPOAuthRefreshResponse,
11
13
  type BetaManagedAgentsMCPOAuthRefreshUpdateParams,
12
14
  type BetaManagedAgentsMCPOAuthUpdateParams,
15
+ type BetaManagedAgentsMCPProbe,
16
+ type BetaManagedAgentsRefreshHTTPResponse,
17
+ type BetaManagedAgentsRefreshObject,
13
18
  type BetaManagedAgentsStaticBearerAuthResponse,
14
19
  type BetaManagedAgentsStaticBearerCreateParams,
15
20
  type BetaManagedAgentsStaticBearerUpdateParams,
@@ -27,6 +32,7 @@ export {
27
32
  type CredentialListParams,
28
33
  type CredentialDeleteParams,
29
34
  type CredentialArchiveParams,
35
+ type CredentialMCPOAuthValidateParams,
30
36
  type BetaManagedAgentsCredentialsPageCursor,
31
37
  } from './credentials';
32
38
  export {
@@ -5,6 +5,8 @@ import * as BetaAPI from '../beta';
5
5
  import * as CredentialsAPI from './credentials';
6
6
  import {
7
7
  BetaManagedAgentsCredential,
8
+ BetaManagedAgentsCredentialValidation,
9
+ BetaManagedAgentsCredentialValidationStatus,
8
10
  BetaManagedAgentsCredentialsPageCursor,
9
11
  BetaManagedAgentsDeletedCredential,
10
12
  BetaManagedAgentsMCPOAuthAuthResponse,
@@ -13,6 +15,9 @@ import {
13
15
  BetaManagedAgentsMCPOAuthRefreshResponse,
14
16
  BetaManagedAgentsMCPOAuthRefreshUpdateParams,
15
17
  BetaManagedAgentsMCPOAuthUpdateParams,
18
+ BetaManagedAgentsMCPProbe,
19
+ BetaManagedAgentsRefreshHTTPResponse,
20
+ BetaManagedAgentsRefreshObject,
16
21
  BetaManagedAgentsStaticBearerAuthResponse,
17
22
  BetaManagedAgentsStaticBearerCreateParams,
18
23
  BetaManagedAgentsStaticBearerUpdateParams,
@@ -28,6 +33,7 @@ import {
28
33
  CredentialCreateParams,
29
34
  CredentialDeleteParams,
30
35
  CredentialListParams,
36
+ CredentialMCPOAuthValidateParams,
31
37
  CredentialRetrieveParams,
32
38
  CredentialUpdateParams,
33
39
  Credentials,
@@ -334,6 +340,8 @@ export declare namespace Vaults {
334
340
  export {
335
341
  Credentials as Credentials,
336
342
  type BetaManagedAgentsCredential as BetaManagedAgentsCredential,
343
+ type BetaManagedAgentsCredentialValidation as BetaManagedAgentsCredentialValidation,
344
+ type BetaManagedAgentsCredentialValidationStatus as BetaManagedAgentsCredentialValidationStatus,
337
345
  type BetaManagedAgentsDeletedCredential as BetaManagedAgentsDeletedCredential,
338
346
  type BetaManagedAgentsMCPOAuthAuthResponse as BetaManagedAgentsMCPOAuthAuthResponse,
339
347
  type BetaManagedAgentsMCPOAuthCreateParams as BetaManagedAgentsMCPOAuthCreateParams,
@@ -341,6 +349,9 @@ export declare namespace Vaults {
341
349
  type BetaManagedAgentsMCPOAuthRefreshResponse as BetaManagedAgentsMCPOAuthRefreshResponse,
342
350
  type BetaManagedAgentsMCPOAuthRefreshUpdateParams as BetaManagedAgentsMCPOAuthRefreshUpdateParams,
343
351
  type BetaManagedAgentsMCPOAuthUpdateParams as BetaManagedAgentsMCPOAuthUpdateParams,
352
+ type BetaManagedAgentsMCPProbe as BetaManagedAgentsMCPProbe,
353
+ type BetaManagedAgentsRefreshHTTPResponse as BetaManagedAgentsRefreshHTTPResponse,
354
+ type BetaManagedAgentsRefreshObject as BetaManagedAgentsRefreshObject,
344
355
  type BetaManagedAgentsStaticBearerAuthResponse as BetaManagedAgentsStaticBearerAuthResponse,
345
356
  type BetaManagedAgentsStaticBearerCreateParams as BetaManagedAgentsStaticBearerCreateParams,
346
357
  type BetaManagedAgentsStaticBearerUpdateParams as BetaManagedAgentsStaticBearerUpdateParams,
@@ -359,5 +370,6 @@ export declare namespace Vaults {
359
370
  type CredentialListParams as CredentialListParams,
360
371
  type CredentialDeleteParams as CredentialDeleteParams,
361
372
  type CredentialArchiveParams as CredentialArchiveParams,
373
+ type CredentialMCPOAuthValidateParams as CredentialMCPOAuthValidateParams,
362
374
  };
363
375
  }