mirror of
https://github.com/tvytlx/ai-agent-deep-dive.git
synced 2026-04-05 08:34:47 +08:00
Add extracted source directory and README navigation
This commit is contained in:
Shawn Bot
200
extracted-source/node_modules/@anthropic-ai/sdk/resources/beta/messages/batches.mjs
generated
vendored
Normal file
200
extracted-source/node_modules/@anthropic-ai/sdk/resources/beta/messages/batches.mjs
generated
vendored
Normal file
@@ -0,0 +1,200 @@
|
||||
// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
|
||||
import { APIResource } from "../../../core/resource.mjs";
|
||||
import { Page } from "../../../core/pagination.mjs";
|
||||
import { buildHeaders } from "../../../internal/headers.mjs";
|
||||
import { JSONLDecoder } from "../../../internal/decoders/jsonl.mjs";
|
||||
import { AnthropicError } from "../../../error.mjs";
|
||||
import { path } from "../../../internal/utils/path.mjs";
|
||||
export class Batches extends APIResource {
|
||||
/**
|
||||
* Send a batch of Message creation requests.
|
||||
*
|
||||
* The Message Batches API can be used to process multiple Messages API requests at
|
||||
* once. Once a Message Batch is created, it begins processing immediately. Batches
|
||||
* can take up to 24 hours to complete.
|
||||
*
|
||||
* Learn more about the Message Batches API in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const betaMessageBatch =
|
||||
* await client.beta.messages.batches.create({
|
||||
* requests: [
|
||||
* {
|
||||
* custom_id: 'my-custom-id-1',
|
||||
* params: {
|
||||
* max_tokens: 1024,
|
||||
* messages: [
|
||||
* { content: 'Hello, world', role: 'user' },
|
||||
* ],
|
||||
* model: 'claude-opus-4-6',
|
||||
* },
|
||||
* },
|
||||
* ],
|
||||
* });
|
||||
* ```
|
||||
*/
|
||||
create(params, options) {
|
||||
const { betas, ...body } = params;
|
||||
return this._client.post('/v1/messages/batches?beta=true', {
|
||||
body,
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
});
|
||||
}
|
||||
/**
|
||||
* This endpoint is idempotent and can be used to poll for Message Batch
|
||||
* completion. To access the results of a Message Batch, make a request to the
|
||||
* `results_url` field in the response.
|
||||
*
|
||||
* Learn more about the Message Batches API in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const betaMessageBatch =
|
||||
* await client.beta.messages.batches.retrieve(
|
||||
* 'message_batch_id',
|
||||
* );
|
||||
* ```
|
||||
*/
|
||||
retrieve(messageBatchID, params = {}, options) {
|
||||
const { betas } = params ?? {};
|
||||
return this._client.get(path `/v1/messages/batches/${messageBatchID}?beta=true`, {
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
});
|
||||
}
|
||||
/**
|
||||
* List all Message Batches within a Workspace. Most recently created batches are
|
||||
* returned first.
|
||||
*
|
||||
* Learn more about the Message Batches API in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* // Automatically fetches more pages as needed.
|
||||
* for await (const betaMessageBatch of client.beta.messages.batches.list()) {
|
||||
* // ...
|
||||
* }
|
||||
* ```
|
||||
*/
|
||||
list(params = {}, options) {
|
||||
const { betas, ...query } = params ?? {};
|
||||
return this._client.getAPIList('/v1/messages/batches?beta=true', (Page), {
|
||||
query,
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Delete a Message Batch.
|
||||
*
|
||||
* Message Batches can only be deleted once they've finished processing. If you'd
|
||||
* like to delete an in-progress batch, you must first cancel it.
|
||||
*
|
||||
* Learn more about the Message Batches API in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const betaDeletedMessageBatch =
|
||||
* await client.beta.messages.batches.delete(
|
||||
* 'message_batch_id',
|
||||
* );
|
||||
* ```
|
||||
*/
|
||||
delete(messageBatchID, params = {}, options) {
|
||||
const { betas } = params ?? {};
|
||||
return this._client.delete(path `/v1/messages/batches/${messageBatchID}?beta=true`, {
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Batches may be canceled any time before processing ends. Once cancellation is
|
||||
* initiated, the batch enters a `canceling` state, at which time the system may
|
||||
* complete any in-progress, non-interruptible requests before finalizing
|
||||
* cancellation.
|
||||
*
|
||||
* The number of canceled requests is specified in `request_counts`. To determine
|
||||
* which requests were canceled, check the individual results within the batch.
|
||||
* Note that cancellation may not result in any canceled requests if they were
|
||||
* non-interruptible.
|
||||
*
|
||||
* Learn more about the Message Batches API in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const betaMessageBatch =
|
||||
* await client.beta.messages.batches.cancel(
|
||||
* 'message_batch_id',
|
||||
* );
|
||||
* ```
|
||||
*/
|
||||
cancel(messageBatchID, params = {}, options) {
|
||||
const { betas } = params ?? {};
|
||||
return this._client.post(path `/v1/messages/batches/${messageBatchID}/cancel?beta=true`, {
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Streams the results of a Message Batch as a `.jsonl` file.
|
||||
*
|
||||
* Each line in the file is a JSON object containing the result of a single request
|
||||
* in the Message Batch. Results are not guaranteed to be in the same order as
|
||||
* requests. Use the `custom_id` field to match results to requests.
|
||||
*
|
||||
* Learn more about the Message Batches API in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const betaMessageBatchIndividualResponse =
|
||||
* await client.beta.messages.batches.results(
|
||||
* 'message_batch_id',
|
||||
* );
|
||||
* ```
|
||||
*/
|
||||
async results(messageBatchID, params = {}, options) {
|
||||
const batch = await this.retrieve(messageBatchID);
|
||||
if (!batch.results_url) {
|
||||
throw new AnthropicError(`No batch \`results_url\`; Has it finished processing? ${batch.processing_status} - ${batch.id}`);
|
||||
}
|
||||
const { betas } = params ?? {};
|
||||
return this._client
|
||||
.get(batch.results_url, {
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{
|
||||
'anthropic-beta': [...(betas ?? []), 'message-batches-2024-09-24'].toString(),
|
||||
Accept: 'application/binary',
|
||||
},
|
||||
options?.headers,
|
||||
]),
|
||||
stream: true,
|
||||
__binaryResponse: true,
|
||||
})
|
||||
._thenUnwrap((_, props) => JSONLDecoder.fromResponse(props.response, props.controller));
|
||||
}
|
||||
}
|
||||
//# sourceMappingURL=batches.mjs.map
|
||||
156
extracted-source/node_modules/@anthropic-ai/sdk/resources/beta/messages/messages.mjs
generated
vendored
Normal file
156
extracted-source/node_modules/@anthropic-ai/sdk/resources/beta/messages/messages.mjs
generated
vendored
Normal file
@@ -0,0 +1,156 @@
|
||||
// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
|
||||
import { AnthropicError } from "../../../error.mjs";
|
||||
import { APIResource } from "../../../core/resource.mjs";
|
||||
import { MODEL_NONSTREAMING_TOKENS } from "../../../internal/constants.mjs";
|
||||
import { buildHeaders } from "../../../internal/headers.mjs";
|
||||
import { stainlessHelperHeader } from "../../../lib/stainless-helper-header.mjs";
|
||||
import { parseBetaMessage, } from "../../../lib/beta-parser.mjs";
|
||||
import { BetaMessageStream } from "../../../lib/BetaMessageStream.mjs";
|
||||
import { BetaToolRunner, } from "../../../lib/tools/BetaToolRunner.mjs";
|
||||
import { ToolError } from "../../../lib/tools/ToolError.mjs";
|
||||
import * as BatchesAPI from "./batches.mjs";
|
||||
import { Batches, } from "./batches.mjs";
|
||||
const DEPRECATED_MODELS = {
|
||||
'claude-1.3': 'November 6th, 2024',
|
||||
'claude-1.3-100k': 'November 6th, 2024',
|
||||
'claude-instant-1.1': 'November 6th, 2024',
|
||||
'claude-instant-1.1-100k': 'November 6th, 2024',
|
||||
'claude-instant-1.2': 'November 6th, 2024',
|
||||
'claude-3-sonnet-20240229': 'July 21st, 2025',
|
||||
'claude-3-opus-20240229': 'January 5th, 2026',
|
||||
'claude-2.1': 'July 21st, 2025',
|
||||
'claude-2.0': 'July 21st, 2025',
|
||||
'claude-3-7-sonnet-latest': 'February 19th, 2026',
|
||||
'claude-3-7-sonnet-20250219': 'February 19th, 2026',
|
||||
};
|
||||
const MODELS_TO_WARN_WITH_THINKING_ENABLED = ['claude-opus-4-6'];
|
||||
export class Messages extends APIResource {
|
||||
constructor() {
|
||||
super(...arguments);
|
||||
this.batches = new BatchesAPI.Batches(this._client);
|
||||
}
|
||||
create(params, options) {
|
||||
// Transform deprecated output_format to output_config.format
|
||||
const modifiedParams = transformOutputFormat(params);
|
||||
const { betas, ...body } = modifiedParams;
|
||||
if (body.model in DEPRECATED_MODELS) {
|
||||
console.warn(`The model '${body.model}' is deprecated and will reach end-of-life on ${DEPRECATED_MODELS[body.model]}\nPlease migrate to a newer model. Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more information.`);
|
||||
}
|
||||
if (body.model in MODELS_TO_WARN_WITH_THINKING_ENABLED &&
|
||||
body.thinking &&
|
||||
body.thinking.type === 'enabled') {
|
||||
console.warn(`Using Claude with ${body.model} and 'thinking.type=enabled' is deprecated. Use 'thinking.type=adaptive' instead which results in better model performance in our testing: https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking`);
|
||||
}
|
||||
let timeout = this._client._options.timeout;
|
||||
if (!body.stream && timeout == null) {
|
||||
const maxNonstreamingTokens = MODEL_NONSTREAMING_TOKENS[body.model] ?? undefined;
|
||||
timeout = this._client.calculateNonstreamingTimeout(body.max_tokens, maxNonstreamingTokens);
|
||||
}
|
||||
// Collect helper info from tools and messages
|
||||
const helperHeader = stainlessHelperHeader(body.tools, body.messages);
|
||||
return this._client.post('/v1/messages?beta=true', {
|
||||
body,
|
||||
timeout: timeout ?? 600000,
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ ...(betas?.toString() != null ? { 'anthropic-beta': betas?.toString() } : undefined) },
|
||||
helperHeader,
|
||||
options?.headers,
|
||||
]),
|
||||
stream: modifiedParams.stream ?? false,
|
||||
});
|
||||
}
|
||||
/**
|
||||
* Send a structured list of input messages with text and/or image content, along with an expected `output_format` and
|
||||
* the response will be automatically parsed and available in the `parsed_output` property of the message.
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const message = await client.beta.messages.parse({
|
||||
* model: 'claude-3-5-sonnet-20241022',
|
||||
* max_tokens: 1024,
|
||||
* messages: [{ role: 'user', content: 'What is 2+2?' }],
|
||||
* output_format: zodOutputFormat(z.object({ answer: z.number() }), 'math'),
|
||||
* });
|
||||
*
|
||||
* console.log(message.parsed_output?.answer); // 4
|
||||
* ```
|
||||
*/
|
||||
parse(params, options) {
|
||||
options = {
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(params.betas ?? []), 'structured-outputs-2025-12-15'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
};
|
||||
return this.create(params, options).then((message) => parseBetaMessage(message, params, { logger: this._client.logger ?? console }));
|
||||
}
|
||||
/**
|
||||
* Create a Message stream
|
||||
*/
|
||||
stream(body, options) {
|
||||
return BetaMessageStream.createMessage(this, body, options);
|
||||
}
|
||||
/**
|
||||
* Count the number of tokens in a Message.
|
||||
*
|
||||
* The Token Count API can be used to count the number of tokens in a Message,
|
||||
* including tools, images, and documents, without creating it.
|
||||
*
|
||||
* Learn more about token counting in our
|
||||
* [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
|
||||
*
|
||||
* @example
|
||||
* ```ts
|
||||
* const betaMessageTokensCount =
|
||||
* await client.beta.messages.countTokens({
|
||||
* messages: [{ content: 'string', role: 'user' }],
|
||||
* model: 'claude-opus-4-6',
|
||||
* });
|
||||
* ```
|
||||
*/
|
||||
countTokens(params, options) {
|
||||
// Transform deprecated output_format to output_config.format
|
||||
const modifiedParams = transformOutputFormat(params);
|
||||
const { betas, ...body } = modifiedParams;
|
||||
return this._client.post('/v1/messages/count_tokens?beta=true', {
|
||||
body,
|
||||
...options,
|
||||
headers: buildHeaders([
|
||||
{ 'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString() },
|
||||
options?.headers,
|
||||
]),
|
||||
});
|
||||
}
|
||||
toolRunner(body, options) {
|
||||
return new BetaToolRunner(this._client, body, options);
|
||||
}
|
||||
}
|
||||
/**
|
||||
* Transform deprecated output_format to output_config.format
|
||||
* Returns a modified copy of the params without mutating the original
|
||||
*/
|
||||
function transformOutputFormat(params) {
|
||||
if (!params.output_format) {
|
||||
return params;
|
||||
}
|
||||
if (params.output_config?.format) {
|
||||
throw new AnthropicError('Both output_format and output_config.format were provided. ' +
|
||||
'Please use only output_config.format (output_format is deprecated).');
|
||||
}
|
||||
const { output_format, ...rest } = params;
|
||||
return {
|
||||
...rest,
|
||||
output_config: {
|
||||
...params.output_config,
|
||||
format: output_format,
|
||||
},
|
||||
};
|
||||
}
|
||||
export { BetaToolRunner } from "../../../lib/tools/BetaToolRunner.mjs";
|
||||
export { ToolError } from "../../../lib/tools/ToolError.mjs";
|
||||
Messages.Batches = Batches;
|
||||
Messages.BetaToolRunner = BetaToolRunner;
|
||||
Messages.ToolError = ToolError;
|
||||
//# sourceMappingURL=messages.mjs.map
|
||||
Reference in New Issue
Block a user