@anthropic-ai/sdk
Version:
The official TypeScript library for the Anthropic API
230 lines • 9.88 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.ToolError = exports.BetaToolRunner = exports.BETA_COMPUTER_MEMBER_NAME_VALUES = exports.BETA_CLIENT_TOOL_UNION_KEYS = exports.BETA_BROWSER_MEMBER_NAME_VALUES = exports.Messages = void 0;
const tslib_1 = require("../../../internal/tslib.js");
const BatchesAPI = tslib_1.__importStar(require("./batches.js"));
const resource_1 = require("../../../core/resource.js");
const constants_1 = require("../../../internal/constants.js");
const headers_1 = require("../../../internal/headers.js");
const tracing_1 = require("../../../internal/tracing.js");
const tracing_2 = require("../../../lib/internal/tracing.js");
const attributes_1 = require("../../../lib/internal/tracing/attributes.js");
const beta_parser_1 = require("../../../lib/beta-parser.js");
const BetaMessageStream_1 = require("../../../lib/BetaMessageStream.js");
const beta_messages_request_1 = require("../../../lib/internal/beta-messages-request.js");
const BetaToolRunner_1 = require("../../../lib/tools/BetaToolRunner.js");
const ToolError_1 = require("../../../lib/tools/ToolError.js");
const batches_1 = require("./batches.js");
const DEPRECATED_MODELS = {
'claude-sonnet-4-5': 'November 30th, 2026',
'claude-sonnet-4-5-20250929': 'November 30th, 2026',
};
const MODELS_TO_WARN_WITH_THINKING_ENABLED = ['claude-mythos-preview', 'claude-opus-4-6'];
var Messages = /* @__PURE__ */ (() => {
class Messages extends resource_1.APIResource {
constructor() {
super(...arguments);
this.batches = new BatchesAPI.Batches(this._client);
}
create(params, options) {
// Transform deprecated output_format to output_config.format
const modifiedParams = (0, beta_messages_request_1.transformOutputFormat)(params);
const { betas, user_profile_id, workspace_id, ...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 (MODELS_TO_WARN_WITH_THINKING_ENABLED.includes(body.model) &&
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 = options?.timeout ?? this._client._options.timeout;
if (!body.stream && timeout == null) {
const maxNonstreamingTokens = constants_1.MODEL_NONSTREAMING_TOKENS[body.model] ?? undefined;
timeout = this._client.calculateNonstreamingTimeout(body.max_tokens, maxNonstreamingTokens);
}
const headers = (0, beta_messages_request_1.messagesCreateHeaders)(modifiedParams, options);
// A client whose spans are disabled computes nothing for one, and returns its request as it is.
const call = this._client._tracer &&
(0, tracing_1.startApiCallSpan)(this._client, 'anthropic.messages.create', options, (0, tracing_2.messagesCreateSpanSettings)(this._client, body, headers));
(0, tracing_2.recordMessagesCreateRequest)(this._client, call, body);
const request = this._client.post('/v1/messages?beta=true', {
body,
timeout: timeout ?? 600000,
...options,
__span: call,
headers,
stream: modifiedParams.stream ?? false,
});
return (call ?
request._thenUnwrap((data) => {
(0, tracing_2.recordMessagesCreateResponse)(this._client, call, body, data);
return data;
})
: request);
}
/**
* 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: (0, headers_1.buildHeaders)([
{ 'anthropic-beta': [...(params.betas ?? []), 'structured-outputs-2025-12-15'].toString() },
options?.headers,
]),
};
return this.create(params, options).then((message) => (0, beta_parser_1.parseBetaMessage)(message, params, { logger: this._client.logger ?? console }));
}
/**
* Create a Message stream
*/
stream(body, options) {
return BetaMessageStream_1.BetaMessageStream.createMessage(this, body, options, { client: this._client });
}
/**
* 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://platform.claude.com/docs/en/build-with-claude/token-counting)
*
* @example
* ```ts
* const betaMessageTokensCount =
* await client.beta.messages.countTokens({
* messages: [{ content: 'Hello, world', role: 'user' }],
* model: 'claude-opus-5-5',
* });
* ```
*/
countTokens(params, options) {
// Transform deprecated output_format to output_config.format
const modifiedParams = (0, beta_messages_request_1.transformOutputFormat)(params);
const { betas, user_profile_id, workspace_id, ...body } = modifiedParams;
const headers = (0, headers_1.buildHeaders)([
{
'anthropic-beta': [...(betas ?? []), 'token-counting-2024-11-01'].toString(),
...(user_profile_id != null ? { 'anthropic-user-profile-id': user_profile_id } : undefined),
...(workspace_id != null ? { 'anthropic-workspace-id': workspace_id } : undefined),
},
options?.headers,
]);
const call = (0, tracing_1.startApiCallSpan)(this._client, 'anthropic.messages.count_tokens', options, {
route: '/v1/messages/count_tokens',
attributes: { [attributes_1.ATTR_GEN_AI_REQUEST_MODEL]: body.model },
});
const request = this._client.post('/v1/messages/count_tokens?beta=true', {
body,
...options,
__span: call,
headers,
});
// Only a request with a span has a response to record.
return call ?
request._thenUnwrap((count) => {
(0, tracing_2.recordCountTokensResponse)(this._client, call, count);
return count;
})
: request;
}
toolRunner(body, options) {
return new BetaToolRunner_1.BetaToolRunner(this._client, body, options);
}
}
Messages.Batches = batches_1.Batches;
Messages.BetaToolRunner = BetaToolRunner_1.BetaToolRunner;
Messages.ToolError = ToolError_1.ToolError;
return Messages;
})();
exports.Messages = Messages;
exports.BETA_BROWSER_MEMBER_NAME_VALUES = [
'navigate',
'list_tabs',
'new_tab',
'switch_tab',
'close_tab',
'read_page',
'get_page_text',
'read_console',
'read_network',
'find',
'form_input',
'file_upload',
'scroll_to',
'screenshot',
'zoom',
'left_click',
'right_click',
'middle_click',
'double_click',
'triple_click',
'hover',
'left_click_drag',
'left_mouse_down',
'left_mouse_up',
'mouse_move',
'scroll',
'type',
'key',
'hold_key',
'wait',
'javascript_exec',
];
exports.BETA_CLIENT_TOOL_UNION_KEYS = [
'input_schema',
'name',
'allowed_callers',
'cache_control',
'defer_loading',
'description',
'eager_input_streaming',
'input_examples',
'strict',
'type',
'configs',
'display_height_px',
'display_width_px',
'display_number',
'enable_zoom',
'max_characters',
];
exports.BETA_COMPUTER_MEMBER_NAME_VALUES = [
'key',
'hold_key',
'type',
'cursor_position',
'mouse_move',
'left_mouse_down',
'left_mouse_up',
'left_click',
'left_click_drag',
'right_click',
'middle_click',
'double_click',
'triple_click',
'scroll',
'wait',
'screenshot',
'zoom',
];
var BetaToolRunner_2 = require("../../../lib/tools/BetaToolRunner.js");
Object.defineProperty(exports, "BetaToolRunner", { enumerable: true, get: function () { return BetaToolRunner_2.BetaToolRunner; } });
var ToolError_2 = require("../../../lib/tools/ToolError.js");
Object.defineProperty(exports, "ToolError", { enumerable: true, get: function () { return ToolError_2.ToolError; } });
//# sourceMappingURL=messages.js.map