@anthropic-ai/sdk 0.62.0 → 0.63.1

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 (90) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +47 -12
  3. package/helpers/beta/json-schema.d.mts +19 -0
  4. package/helpers/beta/json-schema.d.mts.map +1 -0
  5. package/helpers/beta/json-schema.d.ts +19 -0
  6. package/helpers/beta/json-schema.d.ts.map +1 -0
  7. package/helpers/beta/json-schema.js +22 -0
  8. package/helpers/beta/json-schema.js.map +1 -0
  9. package/helpers/beta/json-schema.mjs +19 -0
  10. package/helpers/beta/json-schema.mjs.map +1 -0
  11. package/helpers/beta/zod.d.mts +16 -0
  12. package/helpers/beta/zod.d.mts.map +1 -0
  13. package/helpers/beta/zod.d.ts +16 -0
  14. package/helpers/beta/zod.d.ts.map +1 -0
  15. package/helpers/beta/zod.js +28 -0
  16. package/helpers/beta/zod.js.map +1 -0
  17. package/helpers/beta/zod.mjs +24 -0
  18. package/helpers/beta/zod.mjs.map +1 -0
  19. package/internal/utils/values.js +3 -3
  20. package/internal/utils/values.js.map +1 -1
  21. package/internal/utils/values.mjs +3 -3
  22. package/internal/utils/values.mjs.map +1 -1
  23. package/lib/tools/BetaRunnableTool.d.mts +7 -0
  24. package/lib/tools/BetaRunnableTool.d.mts.map +1 -0
  25. package/lib/tools/BetaRunnableTool.d.ts +7 -0
  26. package/lib/tools/BetaRunnableTool.d.ts.map +1 -0
  27. package/lib/tools/BetaRunnableTool.js +3 -0
  28. package/lib/tools/BetaRunnableTool.js.map +1 -0
  29. package/lib/tools/BetaRunnableTool.mjs +2 -0
  30. package/lib/tools/BetaRunnableTool.mjs.map +1 -0
  31. package/lib/tools/BetaToolRunner.d.mts +132 -0
  32. package/lib/tools/BetaToolRunner.d.mts.map +1 -0
  33. package/lib/tools/BetaToolRunner.d.ts +132 -0
  34. package/lib/tools/BetaToolRunner.d.ts.map +1 -0
  35. package/lib/tools/BetaToolRunner.js +288 -0
  36. package/lib/tools/BetaToolRunner.js.map +1 -0
  37. package/lib/tools/BetaToolRunner.mjs +284 -0
  38. package/lib/tools/BetaToolRunner.mjs.map +1 -0
  39. package/lib/tools/ToolRunner.d.mts +132 -0
  40. package/lib/tools/ToolRunner.d.mts.map +1 -0
  41. package/lib/tools/ToolRunner.d.ts +132 -0
  42. package/lib/tools/ToolRunner.d.ts.map +1 -0
  43. package/lib/tools/ToolRunner.js +288 -0
  44. package/lib/tools/ToolRunner.js.map +1 -0
  45. package/lib/tools/ToolRunner.mjs +284 -0
  46. package/lib/tools/ToolRunner.mjs.map +1 -0
  47. package/package.json +22 -2
  48. package/resources/beta/beta.d.mts +2 -2
  49. package/resources/beta/beta.d.mts.map +1 -1
  50. package/resources/beta/beta.d.ts +2 -2
  51. package/resources/beta/beta.d.ts.map +1 -1
  52. package/resources/beta/beta.js.map +1 -1
  53. package/resources/beta/beta.mjs.map +1 -1
  54. package/resources/beta/index.d.mts +1 -1
  55. package/resources/beta/index.d.mts.map +1 -1
  56. package/resources/beta/index.d.ts +1 -1
  57. package/resources/beta/index.d.ts.map +1 -1
  58. package/resources/beta/index.js.map +1 -1
  59. package/resources/beta/index.mjs.map +1 -1
  60. package/resources/beta/messages/index.d.mts +2 -1
  61. package/resources/beta/messages/index.d.mts.map +1 -1
  62. package/resources/beta/messages/index.d.ts +2 -1
  63. package/resources/beta/messages/index.d.ts.map +1 -1
  64. package/resources/beta/messages/index.js +3 -1
  65. package/resources/beta/messages/index.js.map +1 -1
  66. package/resources/beta/messages/index.mjs +1 -0
  67. package/resources/beta/messages/index.mjs.map +1 -1
  68. package/resources/beta/messages/messages.d.mts +13 -2
  69. package/resources/beta/messages/messages.d.mts.map +1 -1
  70. package/resources/beta/messages/messages.d.ts +13 -2
  71. package/resources/beta/messages/messages.d.ts.map +1 -1
  72. package/resources/beta/messages/messages.js +9 -2
  73. package/resources/beta/messages/messages.js.map +1 -1
  74. package/resources/beta/messages/messages.mjs +7 -1
  75. package/resources/beta/messages/messages.mjs.map +1 -1
  76. package/src/helpers/beta/json-schema.ts +32 -0
  77. package/src/helpers/beta/zod.ts +35 -0
  78. package/src/internal/utils/values.ts +3 -3
  79. package/src/lib/tools/BetaRunnableTool.ts +10 -0
  80. package/src/lib/tools/BetaToolRunner.ts +374 -0
  81. package/src/lib/tools/ToolRunner.ts +374 -0
  82. package/src/resources/beta/beta.ts +2 -0
  83. package/src/resources/beta/index.ts +1 -0
  84. package/src/resources/beta/messages/index.ts +2 -0
  85. package/src/resources/beta/messages/messages.ts +20 -2
  86. package/src/version.ts +1 -1
  87. package/version.d.mts +1 -1
  88. package/version.d.ts +1 -1
  89. package/version.js +1 -1
  90. package/version.mjs +1 -1
@@ -0,0 +1,132 @@
1
+ import { BetaRunnableTool } from "./BetaRunnableTool.js";
2
+ import { Anthropic } from "../../index.js";
3
+ import { BetaMessage, BetaMessageParam, BetaToolUnion, MessageCreateParams } from "../../resources/beta.js";
4
+ import { BetaMessageStream } from "../BetaMessageStream.js";
5
+ /**
6
+ * A ToolRunner handles the automatic conversation loop between the assistant and tools.
7
+ *
8
+ * A ToolRunner is an async iterable that yields either BetaMessage or BetaMessageStream objects
9
+ * depending on the streaming configuration.
10
+ */
11
+ export declare class BetaToolRunner<Stream extends boolean> {
12
+ #private;
13
+ private client;
14
+ constructor(client: Anthropic, params: BetaToolRunnerParams);
15
+ [Symbol.asyncIterator](): AsyncIterator<Stream extends true ? BetaMessageStream : Stream extends false ? BetaMessage : BetaMessage | BetaMessageStream>;
16
+ /**
17
+ * Update the parameters for the next API call. This invalidates any cached tool responses.
18
+ *
19
+ * @param paramsOrMutator - Either new parameters or a function to mutate existing parameters
20
+ *
21
+ * @example
22
+ * // Direct parameter update
23
+ * runner.setMessagesParams({
24
+ * model: 'claude-3-5-haiku-latest',
25
+ * max_tokens: 500,
26
+ * });
27
+ *
28
+ * @example
29
+ * // Using a mutator function
30
+ * runner.setMessagesParams((params) => ({
31
+ * ...params,
32
+ * max_tokens: 100,
33
+ * }));
34
+ */
35
+ setMessagesParams(params: BetaToolRunnerParams): void;
36
+ setMessagesParams(mutator: (prevParams: BetaToolRunnerParams) => BetaToolRunnerParams): void;
37
+ /**
38
+ * Get the tool response for the last message from the assistant.
39
+ * Avoids redundant tool executions by caching results.
40
+ *
41
+ * @returns A promise that resolves to a BetaMessageParam containing tool results, or null if no tools need to be executed
42
+ *
43
+ * @example
44
+ * const toolResponse = await runner.generateToolResponse();
45
+ * if (toolResponse) {
46
+ * console.log('Tool results:', toolResponse.content);
47
+ * }
48
+ */
49
+ generateToolResponse(): Promise<Anthropic.Beta.Messages.BetaMessageParam | null>;
50
+ /**
51
+ * Wait for the async iterator to complete. This works even if the async iterator hasn't yet started, and
52
+ * will wait for an instance to start and go to completion.
53
+ *
54
+ * @returns A promise that resolves to the final BetaMessage when the iterator completes
55
+ *
56
+ * @example
57
+ * // Start consuming the iterator
58
+ * for await (const message of runner) {
59
+ * console.log('Message:', message.content);
60
+ * }
61
+ *
62
+ * // Meanwhile, wait for completion from another part of the code
63
+ * const finalMessage = await runner.done();
64
+ * console.log('Final response:', finalMessage.content);
65
+ */
66
+ done(): Promise<BetaMessage>;
67
+ /**
68
+ * Returns a promise indicating that the stream is done. Unlike .done(), this will eagerly read the stream:
69
+ * * If the iterator has not been consumed, consume the entire iterator and return the final message from the
70
+ * assistant.
71
+ * * If the iterator has been consumed, waits for it to complete and returns the final message.
72
+ *
73
+ * @returns A promise that resolves to the final BetaMessage from the conversation
74
+ * @throws {AnthropicError} If no messages were processed during the conversation
75
+ *
76
+ * @example
77
+ * const finalMessage = await runner.runUntilDone();
78
+ * console.log('Final response:', finalMessage.content);
79
+ */
80
+ runUntilDone(): Promise<BetaMessage>;
81
+ /**
82
+ * Get the current parameters being used by the ToolRunner.
83
+ *
84
+ * @returns A readonly view of the current ToolRunnerParams
85
+ *
86
+ * @example
87
+ * const currentParams = runner.params;
88
+ * console.log('Current model:', currentParams.model);
89
+ * console.log('Message count:', currentParams.messages.length);
90
+ */
91
+ get params(): Readonly<BetaToolRunnerParams>;
92
+ /**
93
+ * Add one or more messages to the conversation history.
94
+ *
95
+ * @param messages - One or more BetaMessageParam objects to add to the conversation
96
+ *
97
+ * @example
98
+ * runner.pushMessages(
99
+ * { role: 'user', content: 'Also, what about the weather in NYC?' }
100
+ * );
101
+ *
102
+ * @example
103
+ * // Adding multiple messages
104
+ * runner.pushMessages(
105
+ * { role: 'user', content: 'What about NYC?' },
106
+ * { role: 'user', content: 'And Boston?' }
107
+ * );
108
+ */
109
+ pushMessages(...messages: BetaMessageParam[]): void;
110
+ /**
111
+ * Makes the ToolRunner directly awaitable, equivalent to calling .runUntilDone()
112
+ * This allows using `await runner` instead of `await runner.runUntilDone()`
113
+ */
114
+ then<TResult1 = BetaMessage, TResult2 = never>(onfulfilled?: ((value: BetaMessage) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
115
+ }
116
+ type Simplify<T> = {
117
+ [KeyType in keyof T]: T[KeyType];
118
+ } & {};
119
+ /**
120
+ * Parameters for creating a ToolRunner, extending MessageCreateParams with runnable tools.
121
+ */
122
+ export type BetaToolRunnerParams = Simplify<Omit<MessageCreateParams, 'tools'> & {
123
+ tools: (BetaToolUnion | BetaRunnableTool<any>)[];
124
+ /**
125
+ * Maximum number of iterations (API requests) to make in the tool execution loop.
126
+ * Each iteration consists of: assistant response → tool execution → tool results.
127
+ * When exceeded, the loop will terminate even if tools are still being requested.
128
+ */
129
+ max_iterations?: number;
130
+ }>;
131
+ export {};
132
+ //# sourceMappingURL=BetaToolRunner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BetaToolRunner.d.ts","sourceRoot":"","sources":["../../src/lib/tools/BetaToolRunner.ts"],"names":[],"mappings":"OAAO,EAAE,gBAAgB,EAAE;OACpB,EAAE,SAAS,EAAE;OAEb,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,mBAAmB,EAAE;OACrE,EAAE,iBAAiB,EAAE;AAmB5B;;;;;GAKG;AACH,qBAAa,cAAc,CAAC,MAAM,SAAS,OAAO;;IAqB9C,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS,EACzB,MAAM,EAAE,oBAAoB;IAevB,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAC5C,MAAM,SAAS,IAAI,GAAG,iBAAiB,GACrC,MAAM,SAAS,KAAK,GAAG,WAAW,GAClC,WAAW,GAAG,iBAAiB,CAClC;IAsED;;;;;;;;;;;;;;;;;;OAkBG;IACH,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IACrD,iBAAiB,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,oBAAoB,GAAG,IAAI;IAc5F;;;;;;;;;;;OAWG;IACG,oBAAoB;IAgB1B;;;;;;;;;;;;;;;OAeG;IACH,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAI5B;;;;;;;;;;;;OAYG;IACG,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC;IAY1C;;;;;;;;;OASG;IACH,IAAI,MAAM,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAE3C;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,GAAG,QAAQ,EAAE,gBAAgB,EAAE;IAO5C;;;OAGG;IACH,IAAI,CAAC,QAAQ,GAAG,WAAW,EAAE,QAAQ,GAAG,KAAK,EAC3C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,EAC3F,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,GAAG,IAAI,GAClF,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;CAGhC;AA+DD,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC;CAAE,GAAG,EAAE,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAAG;IACnC,KAAK,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACjD;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CACF,CAAC"}
@@ -0,0 +1,288 @@
1
+ "use strict";
2
+ var _BetaToolRunner_instances, _BetaToolRunner_consumed, _BetaToolRunner_mutated, _BetaToolRunner_state, _BetaToolRunner_message, _BetaToolRunner_toolResponse, _BetaToolRunner_completion, _BetaToolRunner_iterationCount, _BetaToolRunner_generateToolResponse;
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.BetaToolRunner = void 0;
5
+ const tslib_1 = require("../../internal/tslib.js");
6
+ const error_1 = require("../../core/error.js");
7
+ /**
8
+ * Just Promise.withResolvers(), which is not available in all environments.
9
+ */
10
+ function promiseWithResolvers() {
11
+ let resolve;
12
+ let reject;
13
+ const promise = new Promise((res, rej) => {
14
+ resolve = res;
15
+ reject = rej;
16
+ });
17
+ return { promise, resolve: resolve, reject: reject };
18
+ }
19
+ /**
20
+ * A ToolRunner handles the automatic conversation loop between the assistant and tools.
21
+ *
22
+ * A ToolRunner is an async iterable that yields either BetaMessage or BetaMessageStream objects
23
+ * depending on the streaming configuration.
24
+ */
25
+ class BetaToolRunner {
26
+ constructor(client, params) {
27
+ _BetaToolRunner_instances.add(this);
28
+ this.client = client;
29
+ /** Whether the async iterator has been consumed */
30
+ _BetaToolRunner_consumed.set(this, false);
31
+ /** Whether parameters have been mutated since the last API call */
32
+ _BetaToolRunner_mutated.set(this, false);
33
+ /** Current state containing the request parameters */
34
+ _BetaToolRunner_state.set(this, void 0);
35
+ /** Promise for the last message received from the assistant */
36
+ _BetaToolRunner_message.set(this, void 0);
37
+ /** Cached tool response to avoid redundant executions */
38
+ _BetaToolRunner_toolResponse.set(this, void 0);
39
+ /** Promise resolvers for waiting on completion */
40
+ _BetaToolRunner_completion.set(this, void 0);
41
+ /** Number of iterations (API requests) made so far */
42
+ _BetaToolRunner_iterationCount.set(this, 0);
43
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_state, {
44
+ params: {
45
+ // You can't clone the entire params since there are functions as handlers.
46
+ // You also don't really need to clone params.messages, but it probably will prevent a foot gun
47
+ // somewhere.
48
+ ...params,
49
+ messages: structuredClone(params.messages),
50
+ },
51
+ }, "f");
52
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_completion, promiseWithResolvers(), "f");
53
+ }
54
+ 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)]() {
55
+ var _a;
56
+ if (tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_consumed, "f")) {
57
+ throw new error_1.AnthropicError('Cannot iterate over a consumed stream');
58
+ }
59
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_consumed, true, "f");
60
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_mutated, true, "f");
61
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
62
+ try {
63
+ while (true) {
64
+ let stream;
65
+ try {
66
+ if (tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.max_iterations &&
67
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_iterationCount, "f") >= tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.max_iterations) {
68
+ break;
69
+ }
70
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_mutated, false, "f");
71
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_message, undefined, "f");
72
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
73
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_iterationCount, (_a = tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_iterationCount, "f"), _a++, _a), "f");
74
+ const { max_iterations, ...params } = tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params;
75
+ if (params.stream) {
76
+ stream = this.client.beta.messages.stream({ ...params });
77
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_message, stream.finalMessage(), "f");
78
+ yield stream;
79
+ }
80
+ else {
81
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_message, this.client.beta.messages.create({ ...params, stream: false }), "f");
82
+ yield tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f");
83
+ }
84
+ if (!tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_mutated, "f")) {
85
+ const { role, content } = await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f");
86
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.push({ role, content });
87
+ }
88
+ 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));
89
+ if (toolMessage) {
90
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params.messages.push(toolMessage);
91
+ }
92
+ if (!toolMessage && !tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_mutated, "f")) {
93
+ break;
94
+ }
95
+ }
96
+ finally {
97
+ if (stream) {
98
+ stream.abort();
99
+ }
100
+ }
101
+ }
102
+ if (!tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f")) {
103
+ throw new error_1.AnthropicError('ToolRunner concluded without a message from the server');
104
+ }
105
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").resolve(await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f"));
106
+ }
107
+ catch (error) {
108
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_consumed, false, "f");
109
+ // Silence unhandled promise errors
110
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").promise.catch(() => { });
111
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").reject(error);
112
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_completion, promiseWithResolvers(), "f");
113
+ throw error;
114
+ }
115
+ }
116
+ setMessagesParams(paramsOrMutator) {
117
+ if (typeof paramsOrMutator === 'function') {
118
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params = paramsOrMutator(tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params);
119
+ }
120
+ else {
121
+ tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params = paramsOrMutator;
122
+ }
123
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_mutated, true, "f");
124
+ // Invalidate cached tool response since parameters changed
125
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, undefined, "f");
126
+ }
127
+ /**
128
+ * Get the tool response for the last message from the assistant.
129
+ * Avoids redundant tool executions by caching results.
130
+ *
131
+ * @returns A promise that resolves to a BetaMessageParam containing tool results, or null if no tools need to be executed
132
+ *
133
+ * @example
134
+ * const toolResponse = await runner.generateToolResponse();
135
+ * if (toolResponse) {
136
+ * console.log('Tool results:', toolResponse.content);
137
+ * }
138
+ */
139
+ async generateToolResponse() {
140
+ const message = (await tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_message, "f")) ?? this.params.messages.at(-1);
141
+ if (!message) {
142
+ return null;
143
+ }
144
+ return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_instances, "m", _BetaToolRunner_generateToolResponse).call(this, message);
145
+ }
146
+ /**
147
+ * Wait for the async iterator to complete. This works even if the async iterator hasn't yet started, and
148
+ * will wait for an instance to start and go to completion.
149
+ *
150
+ * @returns A promise that resolves to the final BetaMessage when the iterator completes
151
+ *
152
+ * @example
153
+ * // Start consuming the iterator
154
+ * for await (const message of runner) {
155
+ * console.log('Message:', message.content);
156
+ * }
157
+ *
158
+ * // Meanwhile, wait for completion from another part of the code
159
+ * const finalMessage = await runner.done();
160
+ * console.log('Final response:', finalMessage.content);
161
+ */
162
+ done() {
163
+ return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_completion, "f").promise;
164
+ }
165
+ /**
166
+ * Returns a promise indicating that the stream is done. Unlike .done(), this will eagerly read the stream:
167
+ * * If the iterator has not been consumed, consume the entire iterator and return the final message from the
168
+ * assistant.
169
+ * * If the iterator has been consumed, waits for it to complete and returns the final message.
170
+ *
171
+ * @returns A promise that resolves to the final BetaMessage from the conversation
172
+ * @throws {AnthropicError} If no messages were processed during the conversation
173
+ *
174
+ * @example
175
+ * const finalMessage = await runner.runUntilDone();
176
+ * console.log('Final response:', finalMessage.content);
177
+ */
178
+ async runUntilDone() {
179
+ // If not yet consumed, start consuming and wait for completion
180
+ if (!tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_consumed, "f")) {
181
+ for await (const _ of this) {
182
+ // Iterator naturally populates this.#message
183
+ }
184
+ }
185
+ // If consumed but not completed, wait for completion
186
+ return this.done();
187
+ }
188
+ /**
189
+ * Get the current parameters being used by the ToolRunner.
190
+ *
191
+ * @returns A readonly view of the current ToolRunnerParams
192
+ *
193
+ * @example
194
+ * const currentParams = runner.params;
195
+ * console.log('Current model:', currentParams.model);
196
+ * console.log('Message count:', currentParams.messages.length);
197
+ */
198
+ get params() {
199
+ return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params;
200
+ }
201
+ /**
202
+ * Add one or more messages to the conversation history.
203
+ *
204
+ * @param messages - One or more BetaMessageParam objects to add to the conversation
205
+ *
206
+ * @example
207
+ * runner.pushMessages(
208
+ * { role: 'user', content: 'Also, what about the weather in NYC?' }
209
+ * );
210
+ *
211
+ * @example
212
+ * // Adding multiple messages
213
+ * runner.pushMessages(
214
+ * { role: 'user', content: 'What about NYC?' },
215
+ * { role: 'user', content: 'And Boston?' }
216
+ * );
217
+ */
218
+ pushMessages(...messages) {
219
+ this.setMessagesParams((params) => ({
220
+ ...params,
221
+ messages: [...params.messages, ...messages],
222
+ }));
223
+ }
224
+ /**
225
+ * Makes the ToolRunner directly awaitable, equivalent to calling .runUntilDone()
226
+ * This allows using `await runner` instead of `await runner.runUntilDone()`
227
+ */
228
+ then(onfulfilled, onrejected) {
229
+ return this.runUntilDone().then(onfulfilled, onrejected);
230
+ }
231
+ }
232
+ exports.BetaToolRunner = BetaToolRunner;
233
+ _BetaToolRunner_generateToolResponse = async function _BetaToolRunner_generateToolResponse(lastMessage) {
234
+ if (tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f") !== undefined) {
235
+ return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f");
236
+ }
237
+ tslib_1.__classPrivateFieldSet(this, _BetaToolRunner_toolResponse, generateToolResponse(tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_state, "f").params, lastMessage), "f");
238
+ return tslib_1.__classPrivateFieldGet(this, _BetaToolRunner_toolResponse, "f");
239
+ };
240
+ async function generateToolResponse(params, lastMessage = params.messages.at(-1)) {
241
+ // Only process if the last message is from the assistant and has tool use blocks
242
+ if (!lastMessage ||
243
+ lastMessage.role !== 'assistant' ||
244
+ !lastMessage.content ||
245
+ typeof lastMessage.content === 'string') {
246
+ return null;
247
+ }
248
+ const toolUseBlocks = lastMessage.content.filter((content) => content.type === 'tool_use');
249
+ if (toolUseBlocks.length === 0) {
250
+ return null;
251
+ }
252
+ const toolResults = await Promise.all(toolUseBlocks.map(async (toolUse) => {
253
+ const tool = params.tools.find((t) => t.name === toolUse.name);
254
+ if (!tool || !('run' in tool)) {
255
+ return {
256
+ type: 'tool_result',
257
+ tool_use_id: toolUse.id,
258
+ content: `Error: Tool '${toolUse.name}' not found`,
259
+ is_error: true,
260
+ };
261
+ }
262
+ try {
263
+ let input = toolUse.input;
264
+ if ('parse' in tool && tool.parse) {
265
+ input = tool.parse(input);
266
+ }
267
+ const result = await tool.run(input);
268
+ return {
269
+ type: 'tool_result',
270
+ tool_use_id: toolUse.id,
271
+ content: result,
272
+ };
273
+ }
274
+ catch (error) {
275
+ return {
276
+ type: 'tool_result',
277
+ tool_use_id: toolUse.id,
278
+ content: `Error: ${error instanceof Error ? error.message : String(error)}`,
279
+ is_error: true,
280
+ };
281
+ }
282
+ }));
283
+ return {
284
+ role: 'user',
285
+ content: toolResults,
286
+ };
287
+ }
288
+ //# sourceMappingURL=BetaToolRunner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BetaToolRunner.js","sourceRoot":"","sources":["../../src/lib/tools/BetaToolRunner.ts"],"names":[],"mappings":"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"}