Skip to content

Commit b36623f

Browse files
stainless-app[bot]RobertCraigie
stainless-app[bot]
authored and
RobertCraigie
committed
feat(api): adds web search capabilities to the Claude API
1 parent a6ae129 commit b36623f

File tree

17 files changed

+913
-62
lines changed

17 files changed

+913
-62
lines changed

‎.stats.yml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 21
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-ea0576fceb17a0976feca9aa03aa426984d6fe1390f2bcdbf9de0212a81c8334.yml
3-
openapi_spec_hash: d2d7ec2a7a35a1ed2443c3b690c802c4
4-
config_hash: 9d5b992847099d8fe5a5c09e66adbe5f
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-7015ea2d98991d6c2e7931c521e36448778fe868cc1b8a21173898d67b14b819.yml
3+
openapi_spec_hash: 2007ff815a3f39af8cebe1976d50f17d
4+
config_hash: 4d0dcf47d77eae22d34624d2ac0f0b46

‎MIGRATION.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,9 @@ client.example.list(undefined, { headers: { ... } });
6868
This affects the following methods:
6969

7070
- `client.messages.batches.list()`
71+
- `client.models.retrieve()`
7172
- `client.models.list()`
73+
- `client.beta.models.retrieve()`
7274
- `client.beta.models.list()`
7375
- `client.beta.messages.batches.retrieve()`
7476
- `client.beta.messages.batches.list()`

‎api.md‎

Lines changed: 30 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,10 @@ Types:
2929
- <code><a href="./src/resources/messages/messages.ts">CitationContentBlockLocationParam</a></code>
3030
- <code><a href="./src/resources/messages/messages.ts">CitationPageLocation</a></code>
3131
- <code><a href="./src/resources/messages/messages.ts">CitationPageLocationParam</a></code>
32+
- <code><a href="./src/resources/messages/messages.ts">CitationWebSearchResultLocationParam</a></code>
3233
- <code><a href="./src/resources/messages/messages.ts">CitationsConfigParam</a></code>
3334
- <code><a href="./src/resources/messages/messages.ts">CitationsDelta</a></code>
35+
- <code><a href="./src/resources/messages/messages.ts">CitationsWebSearchResultLocation</a></code>
3436
- <code><a href="./src/resources/messages/messages.ts">ContentBlock</a></code>
3537
- <code><a href="./src/resources/messages/messages.ts">ContentBlockDeltaEvent</a></code>
3638
- <code><a href="./src/resources/messages/messages.ts">ContentBlockParam</a></code>
@@ -63,6 +65,9 @@ Types:
6365
- <code><a href="./src/resources/messages/messages.ts">RawMessageStreamEvent</a></code>
6466
- <code><a href="./src/resources/messages/messages.ts">RedactedThinkingBlock</a></code>
6567
- <code><a href="./src/resources/messages/messages.ts">RedactedThinkingBlockParam</a></code>
68+
- <code><a href="./src/resources/messages/messages.ts">ServerToolUsage</a></code>
69+
- <code><a href="./src/resources/messages/messages.ts">ServerToolUseBlock</a></code>
70+
- <code><a href="./src/resources/messages/messages.ts">ServerToolUseBlockParam</a></code>
6671
- <code><a href="./src/resources/messages/messages.ts">SignatureDelta</a></code>
6772
- <code><a href="./src/resources/messages/messages.ts">StopReason</a></code>
6873
- <code><a href="./src/resources/messages/messages.ts">TextBlock</a></code>
@@ -91,6 +96,15 @@ Types:
9196
- <code><a href="./src/resources/messages/messages.ts">URLImageSource</a></code>
9297
- <code><a href="./src/resources/messages/messages.ts">URLPDFSource</a></code>
9398
- <code><a href="./src/resources/messages/messages.ts">Usage</a></code>
99+
- <code><a href="./src/resources/messages/messages.ts">WebSearchResultBlock</a></code>
100+
- <code><a href="./src/resources/messages/messages.ts">WebSearchResultBlockParam</a></code>
101+
- <code><a href="./src/resources/messages/messages.ts">WebSearchTool20250305</a></code>
102+
- <code><a href="./src/resources/messages/messages.ts">WebSearchToolRequestError</a></code>
103+
- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlock</a></code>
104+
- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlockContent</a></code>
105+
- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlockParam</a></code>
106+
- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultBlockParamContent</a></code>
107+
- <code><a href="./src/resources/messages/messages.ts">WebSearchToolResultError</a></code>
94108

95109
Methods:
96110

@@ -129,7 +143,7 @@ Types:
129143

130144
Methods:
131145

132-
- <code title="get /v1/models/{model_id}">client.models.<a href="./src/resources/models.ts">retrieve</a>(modelID) -> ModelInfo</code>
146+
- <code title="get /v1/models/{model_id}">client.models.<a href="./src/resources/models.ts">retrieve</a>(modelID, { ...params }) -> ModelInfo</code>
133147
- <code title="get /v1/models">client.models.<a href="./src/resources/models.ts">list</a>({ ...params }) -> ModelInfosPage</code>
134148

135149
# Beta
@@ -157,7 +171,7 @@ Types:
157171

158172
Methods:
159173

160-
- <code title="get /v1/models/{model_id}?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">retrieve</a>(modelID) -> BetaModelInfo</code>
174+
- <code title="get /v1/models/{model_id}?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">retrieve</a>(modelID, { ...params }) -> BetaModelInfo</code>
161175
- <code title="get /v1/models?beta=true">client.beta.models.<a href="./src/resources/beta/models.ts">list</a>({ ...params }) -> BetaModelInfosPage</code>
162176

163177
## Messages
@@ -174,8 +188,10 @@ Types:
174188
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationContentBlockLocationParam</a></code>
175189
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationPageLocation</a></code>
176190
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationPageLocationParam</a></code>
191+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationWebSearchResultLocationParam</a></code>
177192
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationsConfigParam</a></code>
178193
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationsDelta</a></code>
194+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaCitationsWebSearchResultLocation</a></code>
179195
- <code><a href="./src/resources/beta/messages/messages.ts">BetaContentBlock</a></code>
180196
- <code><a href="./src/resources/beta/messages/messages.ts">BetaContentBlockParam</a></code>
181197
- <code><a href="./src/resources/beta/messages/messages.ts">BetaContentBlockSource</a></code>
@@ -198,6 +214,9 @@ Types:
198214
- <code><a href="./src/resources/beta/messages/messages.ts">BetaRawMessageStreamEvent</a></code>
199215
- <code><a href="./src/resources/beta/messages/messages.ts">BetaRedactedThinkingBlock</a></code>
200216
- <code><a href="./src/resources/beta/messages/messages.ts">BetaRedactedThinkingBlockParam</a></code>
217+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaServerToolUsage</a></code>
218+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaServerToolUseBlock</a></code>
219+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaServerToolUseBlockParam</a></code>
201220
- <code><a href="./src/resources/beta/messages/messages.ts">BetaSignatureDelta</a></code>
202221
- <code><a href="./src/resources/beta/messages/messages.ts">BetaStopReason</a></code>
203222
- <code><a href="./src/resources/beta/messages/messages.ts">BetaTextBlock</a></code>
@@ -230,6 +249,15 @@ Types:
230249
- <code><a href="./src/resources/beta/messages/messages.ts">BetaURLImageSource</a></code>
231250
- <code><a href="./src/resources/beta/messages/messages.ts">BetaURLPDFSource</a></code>
232251
- <code><a href="./src/resources/beta/messages/messages.ts">BetaUsage</a></code>
252+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchResultBlock</a></code>
253+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchResultBlockParam</a></code>
254+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchTool20250305</a></code>
255+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolRequestError</a></code>
256+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlock</a></code>
257+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlockContent</a></code>
258+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlockParam</a></code>
259+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultBlockParamContent</a></code>
260+
- <code><a href="./src/resources/beta/messages/messages.ts">BetaWebSearchToolResultError</a></code>
233261

234262
Methods:
235263

‎src/client.ts‎

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ import {
3030
CompletionCreateParamsStreaming,
3131
Completions,
3232
} from './resources/completions';
33-
import { ModelInfo, ModelInfosPage, ModelListParams, Models } from './resources/models';
33+
import { ModelInfo, ModelInfosPage, ModelListParams, ModelRetrieveParams, Models } from './resources/models';
3434
import { readEnv } from './internal/utils/env';
3535
import { formatRequestDetails, loggerFor } from './internal/utils/log';
3636
import { isEmptyObj } from './internal/utils/values';
@@ -59,8 +59,10 @@ import {
5959
CitationContentBlockLocationParam,
6060
CitationPageLocation,
6161
CitationPageLocationParam,
62+
CitationWebSearchResultLocationParam,
6263
CitationsConfigParam,
6364
CitationsDelta,
65+
CitationsWebSearchResultLocation,
6466
ContentBlock,
6567
ContentBlockDeltaEvent,
6668
ContentBlockParam,
@@ -99,6 +101,9 @@ import {
99101
RawMessageStreamEvent,
100102
RedactedThinkingBlock,
101103
RedactedThinkingBlockParam,
104+
ServerToolUsage,
105+
ServerToolUseBlock,
106+
ServerToolUseBlockParam,
102107
SignatureDelta,
103108
StopReason,
104109
TextBlock,
@@ -127,6 +132,15 @@ import {
127132
URLImageSource,
128133
URLPDFSource,
129134
Usage,
135+
WebSearchResultBlock,
136+
WebSearchResultBlockParam,
137+
WebSearchTool20250305,
138+
WebSearchToolRequestError,
139+
WebSearchToolResultBlock,
140+
WebSearchToolResultBlockContent,
141+
WebSearchToolResultBlockParam,
142+
WebSearchToolResultBlockParamContent,
143+
WebSearchToolResultError,
130144
} from './resources/messages/messages';
131145

132146
export interface ClientOptions {
@@ -920,8 +934,10 @@ export declare namespace Anthropic {
920934
type CitationContentBlockLocationParam as CitationContentBlockLocationParam,
921935
type CitationPageLocation as CitationPageLocation,
922936
type CitationPageLocationParam as CitationPageLocationParam,
937+
type CitationWebSearchResultLocationParam as CitationWebSearchResultLocationParam,
923938
type CitationsConfigParam as CitationsConfigParam,
924939
type CitationsDelta as CitationsDelta,
940+
type CitationsWebSearchResultLocation as CitationsWebSearchResultLocation,
925941
type ContentBlock as ContentBlock,
926942
type ContentBlockDeltaEvent as ContentBlockDeltaEvent,
927943
type ContentBlockParam as ContentBlockParam,
@@ -954,6 +970,9 @@ export declare namespace Anthropic {
954970
type RawMessageStreamEvent as RawMessageStreamEvent,
955971
type RedactedThinkingBlock as RedactedThinkingBlock,
956972
type RedactedThinkingBlockParam as RedactedThinkingBlockParam,
973+
type ServerToolUsage as ServerToolUsage,
974+
type ServerToolUseBlock as ServerToolUseBlock,
975+
type ServerToolUseBlockParam as ServerToolUseBlockParam,
957976
type SignatureDelta as SignatureDelta,
958977
type StopReason as StopReason,
959978
type TextBlock as TextBlock,
@@ -982,6 +1001,15 @@ export declare namespace Anthropic {
9821001
type URLImageSource as URLImageSource,
9831002
type URLPDFSource as URLPDFSource,
9841003
type Usage as Usage,
1004+
type WebSearchResultBlock as WebSearchResultBlock,
1005+
type WebSearchResultBlockParam as WebSearchResultBlockParam,
1006+
type WebSearchTool20250305 as WebSearchTool20250305,
1007+
type WebSearchToolRequestError as WebSearchToolRequestError,
1008+
type WebSearchToolResultBlock as WebSearchToolResultBlock,
1009+
type WebSearchToolResultBlockContent as WebSearchToolResultBlockContent,
1010+
type WebSearchToolResultBlockParam as WebSearchToolResultBlockParam,
1011+
type WebSearchToolResultBlockParamContent as WebSearchToolResultBlockParamContent,
1012+
type WebSearchToolResultError as WebSearchToolResultError,
9851013
type MessageCreateParams as MessageCreateParams,
9861014
type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
9871015
type MessageCreateParamsStreaming as MessageCreateParamsStreaming,
@@ -993,6 +1021,7 @@ export declare namespace Anthropic {
9931021
Models as Models,
9941022
type ModelInfo as ModelInfo,
9951023
type ModelInfosPage as ModelInfosPage,
1024+
type ModelRetrieveParams as ModelRetrieveParams,
9961025
type ModelListParams as ModelListParams,
9971026
};
9981027

‎src/resources/beta/beta.ts‎

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
import { APIResource } from '../../core/resource';
44
import * as ModelsAPI from './models';
5-
import { BetaModelInfo, BetaModelInfosPage, ModelListParams, Models } from './models';
5+
import { BetaModelInfo, BetaModelInfosPage, ModelListParams, ModelRetrieveParams, Models } from './models';
66
import * as MessagesAPI from './messages/messages';
77
import {
88
BetaBase64ImageSource,
@@ -15,8 +15,10 @@ import {
1515
BetaCitationContentBlockLocationParam,
1616
BetaCitationPageLocation,
1717
BetaCitationPageLocationParam,
18+
BetaCitationWebSearchResultLocationParam,
1819
BetaCitationsConfigParam,
1920
BetaCitationsDelta,
21+
BetaCitationsWebSearchResultLocation,
2022
BetaContentBlock,
2123
BetaContentBlockParam,
2224
BetaContentBlockSource,
@@ -39,6 +41,9 @@ import {
3941
BetaRawMessageStreamEvent,
4042
BetaRedactedThinkingBlock,
4143
BetaRedactedThinkingBlockParam,
44+
BetaServerToolUsage,
45+
BetaServerToolUseBlock,
46+
BetaServerToolUseBlockParam,
4247
BetaSignatureDelta,
4348
BetaStopReason,
4449
BetaTextBlock,
@@ -71,6 +76,15 @@ import {
7176
BetaURLImageSource,
7277
BetaURLPDFSource,
7378
BetaUsage,
79+
BetaWebSearchResultBlock,
80+
BetaWebSearchResultBlockParam,
81+
BetaWebSearchTool20250305,
82+
BetaWebSearchToolRequestError,
83+
BetaWebSearchToolResultBlock,
84+
BetaWebSearchToolResultBlockContent,
85+
BetaWebSearchToolResultBlockParam,
86+
BetaWebSearchToolResultBlockParamContent,
87+
BetaWebSearchToolResultError,
7488
MessageCountTokensParams,
7589
MessageCreateParams,
7690
MessageCreateParamsNonStreaming,
@@ -188,6 +202,7 @@ export declare namespace Beta {
188202
Models as Models,
189203
type BetaModelInfo as BetaModelInfo,
190204
type BetaModelInfosPage as BetaModelInfosPage,
205+
type ModelRetrieveParams as ModelRetrieveParams,
191206
type ModelListParams as ModelListParams,
192207
};
193208

@@ -203,8 +218,10 @@ export declare namespace Beta {
203218
type BetaCitationContentBlockLocationParam as BetaCitationContentBlockLocationParam,
204219
type BetaCitationPageLocation as BetaCitationPageLocation,
205220
type BetaCitationPageLocationParam as BetaCitationPageLocationParam,
221+
type BetaCitationWebSearchResultLocationParam as BetaCitationWebSearchResultLocationParam,
206222
type BetaCitationsConfigParam as BetaCitationsConfigParam,
207223
type BetaCitationsDelta as BetaCitationsDelta,
224+
type BetaCitationsWebSearchResultLocation as BetaCitationsWebSearchResultLocation,
208225
type BetaContentBlock as BetaContentBlock,
209226
type BetaContentBlockParam as BetaContentBlockParam,
210227
type BetaContentBlockSource as BetaContentBlockSource,
@@ -227,6 +244,9 @@ export declare namespace Beta {
227244
type BetaRawMessageStreamEvent as BetaRawMessageStreamEvent,
228245
type BetaRedactedThinkingBlock as BetaRedactedThinkingBlock,
229246
type BetaRedactedThinkingBlockParam as BetaRedactedThinkingBlockParam,
247+
type BetaServerToolUsage as BetaServerToolUsage,
248+
type BetaServerToolUseBlock as BetaServerToolUseBlock,
249+
type BetaServerToolUseBlockParam as BetaServerToolUseBlockParam,
230250
type BetaSignatureDelta as BetaSignatureDelta,
231251
type BetaStopReason as BetaStopReason,
232252
type BetaTextBlock as BetaTextBlock,
@@ -259,6 +279,15 @@ export declare namespace Beta {
259279
type BetaURLImageSource as BetaURLImageSource,
260280
type BetaURLPDFSource as BetaURLPDFSource,
261281
type BetaUsage as BetaUsage,
282+
type BetaWebSearchResultBlock as BetaWebSearchResultBlock,
283+
type BetaWebSearchResultBlockParam as BetaWebSearchResultBlockParam,
284+
type BetaWebSearchTool20250305 as BetaWebSearchTool20250305,
285+
type BetaWebSearchToolRequestError as BetaWebSearchToolRequestError,
286+
type BetaWebSearchToolResultBlock as BetaWebSearchToolResultBlock,
287+
type BetaWebSearchToolResultBlockContent as BetaWebSearchToolResultBlockContent,
288+
type BetaWebSearchToolResultBlockParam as BetaWebSearchToolResultBlockParam,
289+
type BetaWebSearchToolResultBlockParamContent as BetaWebSearchToolResultBlockParamContent,
290+
type BetaWebSearchToolResultError as BetaWebSearchToolResultError,
262291
type MessageCreateParams as MessageCreateParams,
263292
type MessageCreateParamsNonStreaming as MessageCreateParamsNonStreaming,
264293
type MessageCreateParamsStreaming as MessageCreateParamsStreaming,

‎src/resources/beta/index.ts‎

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,8 +27,10 @@ export {
2727
type BetaCitationContentBlockLocationParam,
2828
type BetaCitationPageLocation,
2929
type BetaCitationPageLocationParam,
30+
type BetaCitationWebSearchResultLocationParam,
3031
type BetaCitationsConfigParam,
3132
type BetaCitationsDelta,
33+
type BetaCitationsWebSearchResultLocation,
3234
type BetaContentBlock,
3335
type BetaContentBlockParam,
3436
type BetaContentBlockSource,
@@ -51,6 +53,9 @@ export {
5153
type BetaRawMessageStreamEvent,
5254
type BetaRedactedThinkingBlock,
5355
type BetaRedactedThinkingBlockParam,
56+
type BetaServerToolUsage,
57+
type BetaServerToolUseBlock,
58+
type BetaServerToolUseBlockParam,
5459
type BetaSignatureDelta,
5560
type BetaStopReason,
5661
type BetaTextBlock,
@@ -83,9 +88,24 @@ export {
8388
type BetaURLImageSource,
8489
type BetaURLPDFSource,
8590
type BetaUsage,
91+
type BetaWebSearchResultBlock,
92+
type BetaWebSearchResultBlockParam,
93+
type BetaWebSearchTool20250305,
94+
type BetaWebSearchToolRequestError,
95+
type BetaWebSearchToolResultBlock,
96+
type BetaWebSearchToolResultBlockContent,
97+
type BetaWebSearchToolResultBlockParam,
98+
type BetaWebSearchToolResultBlockParamContent,
99+
type BetaWebSearchToolResultError,
86100
type MessageCreateParams,
87101
type MessageCreateParamsNonStreaming,
88102
type MessageCreateParamsStreaming,
89103
type MessageCountTokensParams,
90104
} from './messages/index';
91-
export { Models, type BetaModelInfo, type ModelListParams, type BetaModelInfosPage } from './models';
105+
export {
106+
Models,
107+
type BetaModelInfo,
108+
type ModelRetrieveParams,
109+
type ModelListParams,
110+
type BetaModelInfosPage,
111+
} from './models';

‎src/resources/beta/messages/index.ts‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,10 @@ export {
3131
type BetaCitationContentBlockLocationParam,
3232
type BetaCitationPageLocation,
3333
type BetaCitationPageLocationParam,
34+
type BetaCitationWebSearchResultLocationParam,
3435
type BetaCitationsConfigParam,
3536
type BetaCitationsDelta,
37+
type BetaCitationsWebSearchResultLocation,
3638
type BetaContentBlock,
3739
type BetaContentBlockParam,
3840
type BetaContentBlockSource,
@@ -55,6 +57,9 @@ export {
5557
type BetaRawMessageStreamEvent,
5658
type BetaRedactedThinkingBlock,
5759
type BetaRedactedThinkingBlockParam,
60+
type BetaServerToolUsage,
61+
type BetaServerToolUseBlock,
62+
type BetaServerToolUseBlockParam,
5863
type BetaSignatureDelta,
5964
type BetaStopReason,
6065
type BetaTextBlock,
@@ -87,6 +92,15 @@ export {
8792
type BetaURLImageSource,
8893
type BetaURLPDFSource,
8994
type BetaUsage,
95+
type BetaWebSearchResultBlock,
96+
type BetaWebSearchResultBlockParam,
97+
type BetaWebSearchTool20250305,
98+
type BetaWebSearchToolRequestError,
99+
type BetaWebSearchToolResultBlock,
100+
type BetaWebSearchToolResultBlockContent,
101+
type BetaWebSearchToolResultBlockParam,
102+
type BetaWebSearchToolResultBlockParamContent,
103+
type BetaWebSearchToolResultError,
90104
type MessageCreateParams,
91105
type MessageCreateParamsNonStreaming,
92106
type MessageCreateParamsStreaming,

0 commit comments

Comments
 (0)