@anthropic-ai/sdk 0.62.0 → 0.63.1

package/lib/tools/ToolRunner.js

@@ -0,0 +1,288 @@
+"use strict";
+var _BetaToolRunner_instances, _BetaToolRunner_consumed, _BetaToolRunner_mutated, _BetaToolRunner_state, _BetaToolRunner_message, _BetaToolRunner_toolResponse, _BetaToolRunner_completion, _BetaToolRunner_iterationCount, _BetaToolRunner_generateToolResponse;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BetaToolRunner = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const error_1 = require("../../core/error.js");
+/**
+ * Just Promise.withResolvers(), which is not available in all environments.
+ */
+function promiseWithResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve: resolve, reject: reject };
+}
+/**
+ * A ToolRunner handles the automatic conversation loop between the assistant and tools.
+ *
+ * A ToolRunner is an async iterable that yields either BetaMessage or BetaMessageStream objects
+ * depending on the streaming configuration.
+ */
+class BetaToolRunner {
+    constructor(client, params) {
+        _BetaToolRunner_instances.add(this);
+        this.client = client;
+        /** Whether the async iterator has been consumed */
+        _BetaToolRunner_consumed.set(this, false);
+        /** Whether parameters have been mutated since the last API call */
+        _BetaToolRunner_mutated.set(this, false);
+        /** Current state containing the request parameters */
+        _BetaToolRunner_state.set(this, void 0);
+        /** Promise for the last message received from the assistant */
+        _BetaToolRunner_message.set(this, void 0);
+        /** Cached tool response to avoid redundant executions */
+        _BetaToolRunner_toolResponse.set(this, void 0);
+        /** Promise resolvers for waiting on completion */
+        _BetaToolRunner_completion.set(this, void 0);
+        /** Number of iterations (API requests) made so far */
+        _BetaToolRunner_iterationCount.set(this, 0);
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_state, {
+            params: {
+                // You can't clone the entire params since there are functions as handlers.
+                // You also don't really need to clone params.messages, but it probably will prevent a foot gun
+                // somewhere.
+                ...params,
+                messages: structuredClone(params.messages),
+            },
+        }, "f");
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_completion, promiseWithResolvers(), "f");
+    }
+    async *[(_BetaToolRunner_consumed = new WeakMap(), _BetaToolRunner_mutated = new WeakMap(), _BetaToolRunner_state = new WeakMap(), _BetaToolRunner_message = new WeakMap(), _BetaToolRunner_toolResponse = new WeakMap(), _BetaToolRunner_completion = new WeakMap(), _BetaToolRunner_iterationCount = new WeakMap(), _BetaToolRunner_instances = new WeakSet(), Symbol.asyncIterator)]() {
+        var _a;
+        if (tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_consumed, "f")) {
+            throw new error_1.AnthropicError('Cannot iterate over a consumed stream');
+        }
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_consumed, true, "f");
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_mutated, true, "f");
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
+        try {
+            while (true) {
+                let stream;
+                try {
+                    if (tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.max_iterations &&
+                        tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_iterationCount, "f") >= tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.max_iterations) {
+                        break;
+                    }
+                    tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_mutated, false, "f");
+                    tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_message, undefined, "f");
+                    tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
+                    tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_iterationCount, (_a = tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_iterationCount, "f"), _a++, _a), "f");
+                    const { max_iterations, ...params } = tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params;
+                    if (params.stream) {
+                        stream = this.client.beta.messages.stream({ ...params });
+                        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_message, stream.finalMessage(), "f");
+                        yield stream;
+                    }
+                    else {
+                        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_message, this.client.beta.messages.create({ ...params, stream: false }), "f");
+                        yield tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f");
+                    }
+                    if (!tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_mutated, "f")) {
+                        const { role, content } = await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f");
+                        tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.push({ role, content });
+                    }
+                    const toolMessage = await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_instances, "m", _BetaToolRunner_generateToolResponse).call(this, tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.at(-1));
+                    if (toolMessage) {
+                        tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.push(toolMessage);
+                    }
+                    if (!toolMessage && !tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_mutated, "f")) {
+                        break;
+                    }
+                }
+                finally {
+                    if (stream) {
+                        stream.abort();
+                    }
+                }
+            }
+            if (!tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f")) {
+                throw new error_1.AnthropicError('ToolRunner concluded without a message from the server');
+            }
+            tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").resolve(await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f"));
+        }
+        catch (error) {
+            tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_consumed, false, "f");
+            // Silence unhandled promise errors
+            tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").promise.catch(() => { });
+            tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").reject(error);
+            tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_completion, promiseWithResolvers(), "f");
+            throw error;
+        }
+    }
+    setMessagesParams(paramsOrMutator) {
+        if (typeof paramsOrMutator === 'function') {
+            tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params = paramsOrMutator(tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params);
+        }
+        else {
+            tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params = paramsOrMutator;
+        }
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_mutated, true, "f");
+        // Invalidate cached tool response since parameters changed
+        tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
+    }
+    /**
+     * Get the tool response for the last message from the assistant.
+     * Avoids redundant tool executions by caching results.
+     *
+     * @returns A promise that resolves to a BetaMessageParam containing tool results, or null if no tools need to be executed
+     *
+     * @example
+     * const toolResponse = await runner.generateToolResponse();
+     * if (toolResponse) {
+     *   console.log('Tool results:', toolResponse.content);
+     * }
+     */
+    async generateToolResponse() {
+        const message = (await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f")) ?? this.params.messages.at(-1);
+        if (!message) {
+            return null;
+        }
+        return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_instances, "m", _BetaToolRunner_generateToolResponse).call(this, message);
+    }
+    /**
+     * Wait for the async iterator to complete. This works even if the async iterator hasn't yet started, and
+     * will wait for an instance to start and go to completion.
+     *
+     * @returns A promise that resolves to the final BetaMessage when the iterator completes
+     *
+     * @example
+     * // Start consuming the iterator
+     * for await (const message of runner) {
+     *   console.log('Message:', message.content);
+     * }
+     *
+     * // Meanwhile, wait for completion from another part of the code
+     * const finalMessage = await runner.done();
+     * console.log('Final response:', finalMessage.content);
+     */
+    done() {
+        return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").promise;
+    }
+    /**
+     * Returns a promise indicating that the stream is done. Unlike .done(), this will eagerly read the stream:
+     * * If the iterator has not been consumed, consume the entire iterator and return the final message from the
+     * assistant.
+     * * If the iterator has been consumed, waits for it to complete and returns the final message.
+     *
+     * @returns A promise that resolves to the final BetaMessage from the conversation
+     * @throws {AnthropicError} If no messages were processed during the conversation
+     *
+     * @example
+     * const finalMessage = await runner.runUntilDone();
+     * console.log('Final response:', finalMessage.content);
+     */
+    async runUntilDone() {
+        // If not yet consumed, start consuming and wait for completion
+        if (!tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_consumed, "f")) {
+            for await (const _ of this) {
+                // Iterator naturally populates this.#message
+            }
+        }
+        // If consumed but not completed, wait for completion
+        return this.done();
+    }
+    /**
+     * Get the current parameters being used by the ToolRunner.
+     *
+     * @returns A readonly view of the current ToolRunnerParams
+     *
+     * @example
+     * const currentParams = runner.params;
+     * console.log('Current model:', currentParams.model);
+     * console.log('Message count:', currentParams.messages.length);
+     */
+    get params() {
+        return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params;
+    }
+    /**
+     * Add one or more messages to the conversation history.
+     *
+     * @param messages - One or more BetaMessageParam objects to add to the conversation
+     *
+     * @example
+     * runner.pushMessages(
+     *   { role: 'user', content: 'Also, what about the weather in NYC?' }
+     * );
+     *
+     * @example
+     * // Adding multiple messages
+     * runner.pushMessages(
+     *   { role: 'user', content: 'What about NYC?' },
+     *   { role: 'user', content: 'And Boston?' }
+     * );
+     */
+    pushMessages(...messages) {
+        this.setMessagesParams((params) => ({
+            ...params,
+            messages: [...params.messages, ...messages],
+        }));
+    }
+    /**
+     * Makes the ToolRunner directly awaitable, equivalent to calling .runUntilDone()
+     * This allows using `await runner` instead of `await runner.runUntilDone()`
+     */
+    then(onfulfilled, onrejected) {
+        return this.runUntilDone().then(onfulfilled, onrejected);
+    }
+}
+exports.BetaToolRunner = BetaToolRunner;
+_BetaToolRunner_generateToolResponse = async function _BetaToolRunner_generateToolResponse(lastMessage) {
+    if (tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f") !== undefined) {
+        return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f");
+    }
+    tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, generateToolResponse(tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params, lastMessage), "f");
+    return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f");
+};
+async function generateToolResponse(params, lastMessage = params.messages.at(-1)) {
+    // Only process if the last message is from the assistant and has tool use blocks
+    if (!lastMessage ||
+        lastMessage.role !== 'assistant' ||
+        !lastMessage.content ||
+        typeof lastMessage.content === 'string') {
+        return null;
+    }
+    const toolUseBlocks = lastMessage.content.filter((content) => content.type === 'tool_use');
+    if (toolUseBlocks.length === 0) {
+        return null;
+    }
+    const toolResults = await Promise.all(toolUseBlocks.map(async (toolUse) => {
+        const tool = params.tools.find((t) => t.name === toolUse.name);
+        if (!tool || !('run' in tool)) {
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: `Error: Tool '${toolUse.name}' not found`,
+                is_error: true,
+            };
+        }
+        try {
+            let input = toolUse.input;
+            if ('parse' in tool && tool.parse) {
+                input = tool.parse(input);
+            }
+            const result = await tool.run(input);
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: result,
+            };
+        }
+        catch (error) {
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                is_error: true,
+            };
+        }
+    }));
+    return {
+        role: 'user',
+        content: toolResults,
+    };
+}
+//# sourceMappingURL=ToolRunner.js.map

package/lib/tools/ToolRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRunner.js","sourceRoot":"","sources":["../../src/lib/tools/ToolRunner.ts"],"names":[],"mappings":"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"}

package/lib/tools/ToolRunner.mjs

@@ -0,0 +1,284 @@
+var _BetaToolRunner_instances, _BetaToolRunner_consumed, _BetaToolRunner_mutated, _BetaToolRunner_state, _BetaToolRunner_message, _BetaToolRunner_toolResponse, _BetaToolRunner_completion, _BetaToolRunner_iterationCount, _BetaToolRunner_generateToolResponse;
+import { __classPrivateFieldGet, __classPrivateFieldSet } from "../../internal/tslib.mjs";
+import { AnthropicError } from "../../core/error.mjs";
+/**
+ * Just Promise.withResolvers(), which is not available in all environments.
+ */
+function promiseWithResolvers() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve: resolve, reject: reject };
+}
+/**
+ * A ToolRunner handles the automatic conversation loop between the assistant and tools.
+ *
+ * A ToolRunner is an async iterable that yields either BetaMessage or BetaMessageStream objects
+ * depending on the streaming configuration.
+ */
+export class BetaToolRunner {
+    constructor(client, params) {
+        _BetaToolRunner_instances.add(this);
+        this.client = client;
+        /** Whether the async iterator has been consumed */
+        _BetaToolRunner_consumed.set(this, false);
+        /** Whether parameters have been mutated since the last API call */
+        _BetaToolRunner_mutated.set(this, false);
+        /** Current state containing the request parameters */
+        _BetaToolRunner_state.set(this, void 0);
+        /** Promise for the last message received from the assistant */
+        _BetaToolRunner_message.set(this, void 0);
+        /** Cached tool response to avoid redundant executions */
+        _BetaToolRunner_toolResponse.set(this, void 0);
+        /** Promise resolvers for waiting on completion */
+        _BetaToolRunner_completion.set(this, void 0);
+        /** Number of iterations (API requests) made so far */
+        _BetaToolRunner_iterationCount.set(this, 0);
+        __classPrivateFieldSet(this, _BetaToolRunner_state, {
+            params: {
+                // You can't clone the entire params since there are functions as handlers.
+                // You also don't really need to clone params.messages, but it probably will prevent a foot gun
+                // somewhere.
+                ...params,
+                messages: structuredClone(params.messages),
+            },
+        }, "f");
+        __classPrivateFieldSet(this, _BetaToolRunner_completion, promiseWithResolvers(), "f");
+    }
+    async *[(_BetaToolRunner_consumed = new WeakMap(), _BetaToolRunner_mutated = new WeakMap(), _BetaToolRunner_state = new WeakMap(), _BetaToolRunner_message = new WeakMap(), _BetaToolRunner_toolResponse = new WeakMap(), _BetaToolRunner_completion = new WeakMap(), _BetaToolRunner_iterationCount = new WeakMap(), _BetaToolRunner_instances = new WeakSet(), Symbol.asyncIterator)]() {
+        var _a;
+        if (__classPrivateFieldGet(this, _BetaToolRunner_consumed, "f")) {
+            throw new AnthropicError('Cannot iterate over a consumed stream');
+        }
+        __classPrivateFieldSet(this, _BetaToolRunner_consumed, true, "f");
+        __classPrivateFieldSet(this, _BetaToolRunner_mutated, true, "f");
+        __classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
+        try {
+            while (true) {
+                let stream;
+                try {
+                    if (__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.max_iterations &&
+                        __classPrivateFieldGet(this, _BetaToolRunner_iterationCount, "f") >= __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.max_iterations) {
+                        break;
+                    }
+                    __classPrivateFieldSet(this, _BetaToolRunner_mutated, false, "f");
+                    __classPrivateFieldSet(this, _BetaToolRunner_message, undefined, "f");
+                    __classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
+                    __classPrivateFieldSet(this, _BetaToolRunner_iterationCount, (_a = __classPrivateFieldGet(this, _BetaToolRunner_iterationCount, "f"), _a++, _a), "f");
+                    const { max_iterations, ...params } = __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params;
+                    if (params.stream) {
+                        stream = this.client.beta.messages.stream({ ...params });
+                        __classPrivateFieldSet(this, _BetaToolRunner_message, stream.finalMessage(), "f");
+                        yield stream;
+                    }
+                    else {
+                        __classPrivateFieldSet(this, _BetaToolRunner_message, this.client.beta.messages.create({ ...params, stream: false }), "f");
+                        yield __classPrivateFieldGet(this, _BetaToolRunner_message, "f");
+                    }
+                    if (!__classPrivateFieldGet(this, _BetaToolRunner_mutated, "f")) {
+                        const { role, content } = await __classPrivateFieldGet(this, _BetaToolRunner_message, "f");
+                        __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.push({ role, content });
+                    }
+                    const toolMessage = await __classPrivateFieldGet(this, _BetaToolRunner_instances, "m", _BetaToolRunner_generateToolResponse).call(this, __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.at(-1));
+                    if (toolMessage) {
+                        __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.push(toolMessage);
+                    }
+                    if (!toolMessage && !__classPrivateFieldGet(this, _BetaToolRunner_mutated, "f")) {
+                        break;
+                    }
+                }
+                finally {
+                    if (stream) {
+                        stream.abort();
+                    }
+                }
+            }
+            if (!__classPrivateFieldGet(this, _BetaToolRunner_message, "f")) {
+                throw new AnthropicError('ToolRunner concluded without a message from the server');
+            }
+            __classPrivateFieldGet(this, _BetaToolRunner_completion, "f").resolve(await __classPrivateFieldGet(this, _BetaToolRunner_message, "f"));
+        }
+        catch (error) {
+            __classPrivateFieldSet(this, _BetaToolRunner_consumed, false, "f");
+            // Silence unhandled promise errors
+            __classPrivateFieldGet(this, _BetaToolRunner_completion, "f").promise.catch(() => { });
+            __classPrivateFieldGet(this, _BetaToolRunner_completion, "f").reject(error);
+            __classPrivateFieldSet(this, _BetaToolRunner_completion, promiseWithResolvers(), "f");
+            throw error;
+        }
+    }
+    setMessagesParams(paramsOrMutator) {
+        if (typeof paramsOrMutator === 'function') {
+            __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params = paramsOrMutator(__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params);
+        }
+        else {
+            __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params = paramsOrMutator;
+        }
+        __classPrivateFieldSet(this, _BetaToolRunner_mutated, true, "f");
+        // Invalidate cached tool response since parameters changed
+        __classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
+    }
+    /**
+     * Get the tool response for the last message from the assistant.
+     * Avoids redundant tool executions by caching results.
+     *
+     * @returns A promise that resolves to a BetaMessageParam containing tool results, or null if no tools need to be executed
+     *
+     * @example
+     * const toolResponse = await runner.generateToolResponse();
+     * if (toolResponse) {
+     *   console.log('Tool results:', toolResponse.content);
+     * }
+     */
+    async generateToolResponse() {
+        const message = (await __classPrivateFieldGet(this, _BetaToolRunner_message, "f")) ?? this.params.messages.at(-1);
+        if (!message) {
+            return null;
+        }
+        return __classPrivateFieldGet(this, _BetaToolRunner_instances, "m", _BetaToolRunner_generateToolResponse).call(this, message);
+    }
+    /**
+     * Wait for the async iterator to complete. This works even if the async iterator hasn't yet started, and
+     * will wait for an instance to start and go to completion.
+     *
+     * @returns A promise that resolves to the final BetaMessage when the iterator completes
+     *
+     * @example
+     * // Start consuming the iterator
+     * for await (const message of runner) {
+     *   console.log('Message:', message.content);
+     * }
+     *
+     * // Meanwhile, wait for completion from another part of the code
+     * const finalMessage = await runner.done();
+     * console.log('Final response:', finalMessage.content);
+     */
+    done() {
+        return __classPrivateFieldGet(this, _BetaToolRunner_completion, "f").promise;
+    }
+    /**
+     * Returns a promise indicating that the stream is done. Unlike .done(), this will eagerly read the stream:
+     * * If the iterator has not been consumed, consume the entire iterator and return the final message from the
+     * assistant.
+     * * If the iterator has been consumed, waits for it to complete and returns the final message.
+     *
+     * @returns A promise that resolves to the final BetaMessage from the conversation
+     * @throws {AnthropicError} If no messages were processed during the conversation
+     *
+     * @example
+     * const finalMessage = await runner.runUntilDone();
+     * console.log('Final response:', finalMessage.content);
+     */
+    async runUntilDone() {
+        // If not yet consumed, start consuming and wait for completion
+        if (!__classPrivateFieldGet(this, _BetaToolRunner_consumed, "f")) {
+            for await (const _ of this) {
+                // Iterator naturally populates this.#message
+            }
+        }
+        // If consumed but not completed, wait for completion
+        return this.done();
+    }
+    /**
+     * Get the current parameters being used by the ToolRunner.
+     *
+     * @returns A readonly view of the current ToolRunnerParams
+     *
+     * @example
+     * const currentParams = runner.params;
+     * console.log('Current model:', currentParams.model);
+     * console.log('Message count:', currentParams.messages.length);
+     */
+    get params() {
+        return __classPrivateFieldGet(this, _BetaToolRunner_state, "f").params;
+    }
+    /**
+     * Add one or more messages to the conversation history.
+     *
+     * @param messages - One or more BetaMessageParam objects to add to the conversation
+     *
+     * @example
+     * runner.pushMessages(
+     *   { role: 'user', content: 'Also, what about the weather in NYC?' }
+     * );
+     *
+     * @example
+     * // Adding multiple messages
+     * runner.pushMessages(
+     *   { role: 'user', content: 'What about NYC?' },
+     *   { role: 'user', content: 'And Boston?' }
+     * );
+     */
+    pushMessages(...messages) {
+        this.setMessagesParams((params) => ({
+            ...params,
+            messages: [...params.messages, ...messages],
+        }));
+    }
+    /**
+     * Makes the ToolRunner directly awaitable, equivalent to calling .runUntilDone()
+     * This allows using `await runner` instead of `await runner.runUntilDone()`
+     */
+    then(onfulfilled, onrejected) {
+        return this.runUntilDone().then(onfulfilled, onrejected);
+    }
+}
+_BetaToolRunner_generateToolResponse = async function _BetaToolRunner_generateToolResponse(lastMessage) {
+    if (__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f") !== undefined) {
+        return __classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f");
+    }
+    __classPrivateFieldSet(this, _BetaToolRunner_toolResponse, generateToolResponse(__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params, lastMessage), "f");
+    return __classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f");
+};
+async function generateToolResponse(params, lastMessage = params.messages.at(-1)) {
+    // Only process if the last message is from the assistant and has tool use blocks
+    if (!lastMessage ||
+        lastMessage.role !== 'assistant' ||
+        !lastMessage.content ||
+        typeof lastMessage.content === 'string') {
+        return null;
+    }
+    const toolUseBlocks = lastMessage.content.filter((content) => content.type === 'tool_use');
+    if (toolUseBlocks.length === 0) {
+        return null;
+    }
+    const toolResults = await Promise.all(toolUseBlocks.map(async (toolUse) => {
+        const tool = params.tools.find((t) => t.name === toolUse.name);
+        if (!tool || !('run' in tool)) {
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: `Error: Tool '${toolUse.name}' not found`,
+                is_error: true,
+            };
+        }
+        try {
+            let input = toolUse.input;
+            if ('parse' in tool && tool.parse) {
+                input = tool.parse(input);
+            }
+            const result = await tool.run(input);
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: result,
+            };
+        }
+        catch (error) {
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                is_error: true,
+            };
+        }
+    }));
+    return {
+        role: 'user',
+        content: toolResults,
+    };
+}
+//# sourceMappingURL=ToolRunner.mjs.map

package/lib/tools/ToolRunner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRunner.mjs","sourceRoot":"","sources":["../../src/lib/tools/ToolRunner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anthropic-ai/sdk",
-  "version": "0.62.0",
+  "version": "0.63.1",
   "description": "The official TypeScript library for the Anthropic API",
   "author": "Anthropic <support@anthropic.com>",
   "types": "./index.d.ts",
@@ -24,7 +24,17 @@
     "lint": "./scripts/lint",
     "fix": "./scripts/format"
   },
-  "dependencies": {},
+  "dependencies": {
+    "json-schema-to-ts": "^3.1.1"
+  },
+  "peerDependencies": {
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
   "bin": {
     "anthropic-ai-sdk": "bin/cli"
   },
@@ -87,6 +97,16 @@
     "./error.mjs": {
       "default": "./error.mjs"
     },
+    "./helpers/*.mjs": {
+      "default": "./helpers/*.mjs"
+    },
+    "./helpers/*.js": {
+      "default": "./helpers/*.js"
+    },
+    "./helpers/*": {
+      "import": "./helpers/*.mjs",
+      "require": "./helpers/*.js"
+    },
     "./index": {
       "import": "./index.mjs",
       "require": "./index.js"