chore (streams): deprecate streaming helpers that have a provider replacement (#1757)

Author: lgrammel

.changeset/thin-bulldogs-add.md

@@ -0,0 +1,5 @@
+---
+'ai': patch
+---
+
+chore (streams): deprecate streaming helpers that have a provider replacement

packages/core/streams/anthropic-stream.ts

@@ -177,6 +177,8 @@ async function* streamable(
  * Accepts either a fetch Response from the Anthropic `POST /v1/complete` endpoint,
  * or the return value of `await client.completions.create({ stream: true })`
  * from the `@anthropic-ai/sdk` package.
+ *
+ * @deprecated Use the [Anthropic provider](https://sdk.vercel.ai/providers/ai-sdk-providers/anthropic) instead.
  */
 export function AnthropicStream(
   res:

packages/core/streams/google-generative-ai-stream.ts

@@ -48,6 +48,9 @@ async function* streamable(response: {
   }
 }
 
+/**
+ * @deprecated Use the [Google Generative AI provider](https://sdk.vercel.ai/providers/ai-sdk-providers/google-generative-ai) instead.
+ */
 export function GoogleGenerativeAIStream(
   response: {
     stream: AsyncIterable<GenerateContentResponse>;

packages/core/streams/langchain-stream.ts

@@ -5,7 +5,7 @@ import {
 import { createStreamDataTransformer } from './stream-data';
 
 /**
-@deprecated Use LangChainAdapter.toAIStream() instead.
+ * @deprecated Use [LangChainAdapter](https://sdk.vercel.ai/providers/adapters/langchain) instead.
  */
 export function LangChainStream(callbacks?: AIStreamCallbacksAndOptions) {
   const stream = new TransformStream();

packages/core/streams/mistral-stream.ts

@@ -46,6 +46,9 @@ async function* streamable(stream: AsyncIterable<ChatCompletionResponseChunk>) {
   }
 }
 
+/*
+ * @deprecated Use the [Mistral provider](https://sdk.vercel.ai/providers/ai-sdk-providers/mistral) instead.
+ */
 export function MistralStream(
   response: AsyncGenerator<ChatCompletionResponseChunk, void, unknown>,
   callbacks?: AIStreamCallbacksAndOptions,

packages/core/streams/openai-stream.ts

@@ -437,6 +437,9 @@ function isCompletion(data: OpenAIStreamReturnTypes): data is Completion {
   );
 }
 
+/**
+ * @deprecated Use the [OpenAI provider](https://sdk.vercel.ai/providers/ai-sdk-providers/openai) instead.
+ */
 export function OpenAIStream(
   res: Response | AsyncIterableOpenAIStreamReturnTypes,
   callbacks?: OpenAIStreamCallbacks,