ai 7.0.59 → 7.0.60

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # ai
 
+## 7.0.60
+
+### Patch Changes
+
+- 79c52ef: Align `ToolLoopAgent` `prepareCall` types with the settings available and honored at runtime.
+- Updated dependencies [3cc1bb6]
+  - @ai-sdk/gateway@4.0.48
+
 ## 7.0.59
 
 ### Patch Changes

package/dist/index.d.ts

@@ -5122,9 +5122,9 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
      *   }),
      * ```
      */
-    prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>, 'onStepEnd' | 'onStepFinish'> & Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolApproval' | 'experimental_toolCallers' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & {
+    prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>, 'abortSignal' | 'timeout' | 'onStart' | 'experimental_onStart' | 'onStepStart' | 'experimental_onStepStart' | 'onToolExecutionStart' | 'onToolExecutionEnd' | 'onStepEnd' | 'onStepFinish' | 'onEnd' | 'onFinish'> & Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'toolChoice' | 'maxRetries' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolApproval' | 'experimental_toolCallers' | 'prepareStep' | 'repairToolCall' | 'experimental_repairToolCall' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & {
         toolsContext: InferToolSetContext<TOOLS>;
-    }) => MaybePromiseLike<Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolApproval' | 'experimental_toolCallers' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & Omit<Prompt, 'system'> & {
+    }) => MaybePromiseLike<Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'toolChoice' | 'maxRetries' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolApproval' | 'experimental_toolCallers' | 'prepareStep' | 'repairToolCall' | 'experimental_repairToolCall' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & Omit<Prompt, 'system'> & {
         toolsContext: InferToolSetContext<TOOLS>;
     }>;
 };

package/dist/index.js

@@ -1143,7 +1143,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.59" : "0.0.0-test";
+var VERSION = true ? "7.0.60" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/dist/internal/index.js

@@ -92,7 +92,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.59" : "0.0.0-test";
+var VERSION = true ? "7.0.60" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({

package/docs/03-ai-sdk-harnesses/02-harness-agent.mdx

@@ -364,7 +364,8 @@ console.log(preparation.identity);
 - `harness`: the adapter instance.
 - `sandbox`: a `HarnessV1SandboxProvider`.
 - `id`: optional stable agent identifier.
-- `instructions`: instructions applied once to a fresh session.
+- `instructions`: instructions appended to the runtime's system or developer
+  prompt when supported, or prepended to the first user prompt otherwise.
 - `stopWhen`: condition(s) for finishing a result slice after a completed
   harness tool step that can continue into another model step.
 - `tools`: AI SDK tools executed by the host when the harness calls them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai",
-  "version": "7.0.59",
+  "version": "7.0.60",
   "type": "module",
   "description": "AI SDK by Vercel - build apps like ChatGPT, Claude, Gemini, and more with a single interface for any model using the Vercel AI Gateway or go direct to OpenAI, Anthropic, Google, or any other model provider.",
   "license": "Apache-2.0",
@@ -42,7 +42,7 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/gateway": "4.0.47",
+    "@ai-sdk/gateway": "4.0.48",
     "@ai-sdk/provider": "4.0.7",
     "@ai-sdk/provider-utils": "5.0.26"
   },

package/src/agent/tool-loop-agent-settings.ts

@@ -307,7 +307,18 @@ export type ToolLoopAgentSettings<
           NoInfer<TOOLS>,
           NoInfer<RUNTIME_CONTEXT>
         >,
-        'onStepEnd' | 'onStepFinish'
+        | 'abortSignal'
+        | 'timeout'
+        | 'onStart'
+        | 'experimental_onStart'
+        | 'onStepStart'
+        | 'experimental_onStepStart'
+        | 'onToolExecutionStart'
+        | 'onToolExecutionEnd'
+        | 'onStepEnd'
+        | 'onStepFinish'
+        | 'onEnd'
+        | 'onFinish'
       > &
         Pick<
           ToolLoopAgentSettings<
@@ -318,6 +329,8 @@ export type ToolLoopAgentSettings<
           >,
           | 'model'
           | 'tools'
+          | 'toolChoice'
+          | 'maxRetries'
           | 'maxOutputTokens'
           | 'temperature'
           | 'topP'
@@ -337,6 +350,9 @@ export type ToolLoopAgentSettings<
           | 'toolOrder'
           | 'toolApproval'
           | 'experimental_toolCallers'
+          | 'prepareStep'
+          | 'repairToolCall'
+          | 'experimental_repairToolCall'
           | 'providerOptions'
           | 'experimental_download'
           | 'experimental_refineToolInput'
@@ -354,6 +370,8 @@ export type ToolLoopAgentSettings<
         >,
         | 'model'
         | 'tools'
+        | 'toolChoice'
+        | 'maxRetries'
         | 'maxOutputTokens'
         | 'temperature'
         | 'topP'
@@ -373,6 +391,9 @@ export type ToolLoopAgentSettings<
         | 'toolOrder'
         | 'toolApproval'
         | 'experimental_toolCallers'
+        | 'prepareStep'
+        | 'repairToolCall'
+        | 'experimental_repairToolCall'
         | 'providerOptions'
         | 'experimental_download'
         | 'experimental_refineToolInput'