refactoring (ai): restructure provider-defined tools (#6808)

## Background

Provider-defined tools need to access the tool definition and related
types. However, these are currently defined in the `ai` package which
creates a circular dependency and update problem.

## Summary

* Move tool and model message definitions into `provider-utils`.
* Update provider defined tools to use correct type definitions.

## Related Issues

Prerequisite for #6807

Author: lgrammel

.changeset/curvy-sloths-impress.md

@@ -0,0 +1,5 @@
+---
+'@ai-sdk/provider-utils': major
+---
+
+refactoring (ai): restructure provider-defined tools

examples/ai-core/src/generate-text/anthropic-computer-use-editor.ts

@@ -11,9 +11,8 @@ This is a test file.
   const result = await generateText({
     model: anthropic('claude-3-5-sonnet-20241022'),
     tools: {
-      str_replace_editor: anthropic.tools.textEditor_20241022({
+      str_replace_editor: anthropic.tools.textEditor_20250124({
         async execute({ command, path, old_str, new_str }) {
-          console.log({ command, path, old_str, new_str });
           switch (command) {
             case 'view': {
               return editorContent;
@@ -32,6 +31,9 @@ This is a test file.
             }
           }
         },
+        onInputAvailable: ({ input }) => {
+          console.log('onInputAvailable', input);
+        },
       }),
     },
     prompt: 'Update my README file to talk about AI.',

packages/ai/core/embed/embed-many.ts

@@ -1,3 +1,4 @@
+import { ProviderOptions } from '@ai-sdk/provider-utils';
 import { prepareRetries } from '../../src/util/prepare-retries';
 import { splitArray } from '../../src/util/split-array';
 import { assembleOperationName } from '../telemetry/assemble-operation-name';
@@ -6,7 +7,7 @@ import { getTracer } from '../telemetry/get-tracer';
 import { recordSpan } from '../telemetry/record-span';
 import { selectTelemetryAttributes } from '../telemetry/select-telemetry-attributes';
 import { TelemetrySettings } from '../telemetry/telemetry-settings';
-import { Embedding, EmbeddingModel, ProviderOptions } from '../types';
+import { Embedding, EmbeddingModel } from '../types';
 import { EmbedManyResult } from './embed-many-result';
 
 /**

packages/ai/core/embed/embed.ts

@@ -1,11 +1,12 @@
+import { ProviderOptions } from '@ai-sdk/provider-utils';
 import { prepareRetries } from '../../src/util/prepare-retries';
 import { assembleOperationName } from '../telemetry/assemble-operation-name';
 import { getBaseTelemetryAttributes } from '../telemetry/get-base-telemetry-attributes';
 import { getTracer } from '../telemetry/get-tracer';
 import { recordSpan } from '../telemetry/record-span';
 import { selectTelemetryAttributes } from '../telemetry/select-telemetry-attributes';
 import { TelemetrySettings } from '../telemetry/telemetry-settings';
-import { EmbeddingModel, ProviderOptions } from '../types';
+import { EmbeddingModel } from '../types';
 import { EmbedResult } from './embed-result';
 
 /**

packages/ai/core/generate-image/generate-image.ts

@@ -11,8 +11,8 @@ import {
 } from '../generate-text/generated-file';
 import { ImageGenerationWarning } from '../types/image-model';
 import { ImageModelResponseMetadata } from '../types/image-model-response-metadata';
-import { ProviderOptions } from '../types/provider-metadata';
 import { GenerateImageResult } from './generate-image-result';
+import { ProviderOptions } from '@ai-sdk/provider-utils';
 
 /**
 Generates images using an image model.

packages/ai/core/generate-object/generate-object.ts

@@ -6,6 +6,7 @@ import {
 import {
   createIdGenerator,
   InferSchema,
+  ProviderOptions,
   safeParseJSON,
   Schema,
 } from '@ai-sdk/provider-utils';
@@ -36,7 +37,7 @@ import {
 } from '../types/language-model';
 import { LanguageModelRequestMetadata } from '../types/language-model-request-metadata';
 import { LanguageModelResponseMetadata } from '../types/language-model-response-metadata';
-import { ProviderMetadata, ProviderOptions } from '../types/provider-metadata';
+import { ProviderMetadata } from '../types/provider-metadata';
 import { LanguageModelUsage } from '../types/usage';
 import { GenerateObjectResult } from './generate-object-result';
 import { getOutputStrategy } from './output-strategy';

packages/ai/core/generate-object/stream-object.ts

@@ -8,6 +8,7 @@ import {
 } from '@ai-sdk/provider';
 import {
   createIdGenerator,
+  ProviderOptions,
   type InferSchema,
   type Schema,
 } from '@ai-sdk/provider-utils';
@@ -43,7 +44,7 @@ import { TelemetrySettings } from '../telemetry/telemetry-settings';
 import { CallWarning, LanguageModel } from '../types/language-model';
 import { LanguageModelRequestMetadata } from '../types/language-model-request-metadata';
 import { LanguageModelResponseMetadata } from '../types/language-model-response-metadata';
-import { ProviderMetadata, ProviderOptions } from '../types/provider-metadata';
+import { ProviderMetadata } from '../types/provider-metadata';
 import { LanguageModelUsage } from '../types/usage';
 import { getOutputStrategy, OutputStrategy } from './output-strategy';
 import { ObjectStreamPart, StreamObjectResult } from './stream-object-result';

packages/ai/core/generate-speech/generate-speech.ts

@@ -5,14 +5,14 @@ import {
   detectMediaType,
 } from '../../src/util/detect-media-type';
 import { prepareRetries } from '../../src/util/prepare-retries';
-import { ProviderOptions } from '../types/provider-metadata';
 import { SpeechWarning } from '../types/speech-model';
 import { SpeechModelResponseMetadata } from '../types/speech-model-response-metadata';
 import { SpeechResult } from './generate-speech-result';
 import {
   DefaultGeneratedAudioFile,
   GeneratedAudioFile,
 } from './generated-audio-file';
+import { ProviderOptions } from '@ai-sdk/provider-utils';
 
 /**
 Generates speech audio using a speech model.

packages/ai/core/generate-text/generate-text-result.ts

@@ -1,4 +1,4 @@
-import { ReasoningPart } from '../prompt/content-part';
+import { ReasoningPart } from '@ai-sdk/provider-utils';
 import { CallWarning, FinishReason, ProviderMetadata } from '../types';
 import { Source } from '../types/language-model';
 import { LanguageModelRequestMetadata } from '../types/language-model-request-metadata';

packages/ai/core/generate-text/generate-text.ts

@@ -3,7 +3,11 @@ import {
   LanguageModelV2Content,
   LanguageModelV2ToolCall,
 } from '@ai-sdk/provider';
-import { createIdGenerator, IdGenerator } from '@ai-sdk/provider-utils';
+import {
+  createIdGenerator,
+  IdGenerator,
+  ProviderOptions,
+} from '@ai-sdk/provider-utils';
 import { Tracer } from '@opentelemetry/api';
 import { NoOutputSpecifiedError } from '../../src/error/no-output-specified-error';
 import { asArray } from '../../src/util/as-array';
@@ -24,7 +28,7 @@ import { recordSpan } from '../telemetry/record-span';
 import { selectTelemetryAttributes } from '../telemetry/select-telemetry-attributes';
 import { stringifyForTelemetry } from '../telemetry/stringify-for-telemetry';
 import { TelemetrySettings } from '../telemetry/telemetry-settings';
-import { LanguageModel, ProviderOptions, ToolChoice } from '../types';
+import { LanguageModel, ToolChoice } from '../types';
 import { addLanguageModelUsage, LanguageModelUsage } from '../types/usage';
 import { ContentPart } from './content-part';
 import { extractContentText } from './extract-content-text';