@ai-sdk/alibaba 0.0.0-b66d09a8-20260328011513

package/CHANGELOG.md

@@ -0,0 +1,229 @@
+# @ai-sdk/alibaba
+
+## 0.0.0-b66d09a8-20260328011513
+
+### Major Changes
+
+- 8359612: Start v7 pre-release
+
+### Patch Changes
+
+- 74d520f: feat: migrate providers to support new top-level `reasoning` parameter
+- 45b3d76: fix(security): prevent streaming tool calls from finalizing on parsable partial JSON
+
+  Streaming tool call arguments were finalized using `isParsableJson()` as a heuristic for completion. If partial accumulated JSON happened to be valid JSON before all chunks arrived, the tool call would be executed with incomplete arguments. Tool call finalization now only occurs in `flush()` after the stream is fully consumed.
+
+- 811cd8e: fix(provider/alibaba): handle single-item content array cache control
+- f7295cb: revert incorrect fix https://github.com/vercel/ai/pull/13172
+- 4ab27b9: chore(alibaba): update v3 specs to v4
+- Updated dependencies [74d520f]
+- Updated dependencies [531251e]
+- Updated dependencies [45b3d76]
+- Updated dependencies [1f509d4]
+- Updated dependencies [5c2a5a2]
+- Updated dependencies [f7d4f01]
+- Updated dependencies [776b617]
+- Updated dependencies [8f3e1da]
+- Updated dependencies [f7295cb]
+- Updated dependencies [3887c70]
+- Updated dependencies [61753c3]
+- Updated dependencies [8359612]
+  - @ai-sdk/openai-compatible@0.0.0-b66d09a8-20260328011513
+  - @ai-sdk/provider-utils@0.0.0-b66d09a8-20260328011513
+  - @ai-sdk/provider@0.0.0-b66d09a8-20260328011513
+
+## 2.0.0-beta.12
+
+### Patch Changes
+
+- Updated dependencies [1f509d4]
+  - @ai-sdk/provider-utils@5.0.0-beta.7
+  - @ai-sdk/provider@4.0.0-beta.5
+  - @ai-sdk/openai-compatible@3.0.0-beta.10
+
+## 2.0.0-beta.11
+
+### Patch Changes
+
+- 74d520f: feat: migrate providers to support new top-level `reasoning` parameter
+- Updated dependencies [74d520f]
+  - @ai-sdk/openai-compatible@3.0.0-beta.9
+
+## 2.0.0-beta.10
+
+### Patch Changes
+
+- Updated dependencies [3887c70]
+  - @ai-sdk/provider-utils@5.0.0-beta.6
+  - @ai-sdk/provider@4.0.0-beta.4
+  - @ai-sdk/openai-compatible@3.0.0-beta.8
+
+## 2.0.0-beta.9
+
+### Patch Changes
+
+- Updated dependencies [776b617]
+  - @ai-sdk/provider-utils@5.0.0-beta.5
+  - @ai-sdk/provider@4.0.0-beta.3
+  - @ai-sdk/openai-compatible@3.0.0-beta.7
+
+## 2.0.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+  - @ai-sdk/openai-compatible@3.0.0-beta.6
+
+## 2.0.0-beta.7
+
+### Patch Changes
+
+- 811cd8e: fix(provider/alibaba): handle single-item content array cache control
+
+## 2.0.0-beta.6
+
+### Patch Changes
+
+- Updated dependencies [f7d4f01]
+  - @ai-sdk/provider-utils@5.0.0-beta.3
+  - @ai-sdk/provider@4.0.0-beta.2
+  - @ai-sdk/openai-compatible@3.0.0-beta.5
+
+## 2.0.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [5c2a5a2]
+  - @ai-sdk/provider@4.0.0-beta.1
+  - @ai-sdk/openai-compatible@3.0.0-beta.4
+  - @ai-sdk/provider-utils@5.0.0-beta.2
+
+## 2.0.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies [8f3e1da]
+  - @ai-sdk/openai-compatible@3.0.0-beta.3
+
+## 2.0.0-beta.3
+
+### Patch Changes
+
+- 4ab27b9: chore(alibaba): update v3 specs to v4
+
+## 2.0.0-beta.2
+
+### Patch Changes
+
+- 45b3d76: fix(security): prevent streaming tool calls from finalizing on parsable partial JSON
+
+  Streaming tool call arguments were finalized using `isParsableJson()` as a heuristic for completion. If partial accumulated JSON happened to be valid JSON before all chunks arrived, the tool call would be executed with incomplete arguments. Tool call finalization now only occurs in `flush()` after the stream is fully consumed.
+
+- f7295cb: revert incorrect fix https://github.com/vercel/ai/pull/13172
+- Updated dependencies [45b3d76]
+- Updated dependencies [f7295cb]
+  - @ai-sdk/openai-compatible@3.0.0-beta.2
+
+## 2.0.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [531251e]
+  - @ai-sdk/provider-utils@5.0.0-beta.1
+  - @ai-sdk/openai-compatible@3.0.0-beta.1
+
+## 2.0.0-beta.0
+
+### Major Changes
+
+- 8359612: Start v7 pre-release
+
+### Patch Changes
+
+- Updated dependencies [8359612]
+  - @ai-sdk/openai-compatible@3.0.0-beta.0
+  - @ai-sdk/provider@4.0.0-beta.0
+  - @ai-sdk/provider-utils@5.0.0-beta.0
+
+## 1.0.10
+
+### Patch Changes
+
+- Updated dependencies [ad4cfc2]
+  - @ai-sdk/provider-utils@4.0.19
+  - @ai-sdk/openai-compatible@2.0.35
+
+## 1.0.9
+
+### Patch Changes
+
+- Updated dependencies [824b295]
+  - @ai-sdk/provider-utils@4.0.18
+  - @ai-sdk/openai-compatible@2.0.34
+
+## 1.0.8
+
+### Patch Changes
+
+- Updated dependencies [89caf28]
+  - @ai-sdk/openai-compatible@2.0.33
+
+## 1.0.7
+
+### Patch Changes
+
+- Updated dependencies [08336f1]
+  - @ai-sdk/provider-utils@4.0.17
+  - @ai-sdk/openai-compatible@2.0.32
+
+## 1.0.6
+
+### Patch Changes
+
+- Updated dependencies [58bc42d]
+  - @ai-sdk/provider-utils@4.0.16
+  - @ai-sdk/openai-compatible@2.0.31
+
+## 1.0.5
+
+### Patch Changes
+
+- 6fe0630: fix(provider/alibaba): fix cache control for non-system messages
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [4024a3a]
+  - @ai-sdk/provider-utils@4.0.15
+  - @ai-sdk/openai-compatible@2.0.30
+
+## 1.0.3
+
+### Patch Changes
+
+- 99fbed8: feat: normalize provider specific model options type names and ensure they are exported
+- Updated dependencies [99fbed8]
+  - @ai-sdk/openai-compatible@2.0.29
+
+## 1.0.2
+
+### Patch Changes
+
+- 4d8c6b9: feat (provider/alibaba): add video generation support
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [7168375]
+  - @ai-sdk/provider@3.0.8
+  - @ai-sdk/openai-compatible@2.0.28
+  - @ai-sdk/provider-utils@4.0.14
+
+## 1.0.0
+
+### Major Changes
+
+- aa924c7: feat(provider/alibaba): initial alibaba provider

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,130 @@
+# AI SDK - Alibaba Provider
+
+The **[Alibaba provider](https://ai-sdk.dev/providers/ai-sdk-providers/alibaba)** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for [Alibaba Cloud Model Studio](https://modelstudio.console.alibabacloud.com/), including the Qwen model series with advanced reasoning capabilities.
+
+## Setup
+
+The Alibaba provider is available in the `@ai-sdk/alibaba` module. You can install it with
+
+```bash
+npm i @ai-sdk/alibaba
+```
+
+## Skill for Coding Agents
+
+If you use coding agents such as Claude Code or Cursor, we highly recommend adding the AI SDK skill to your repository:
+
+```shell
+npx skills add vercel/ai
+```
+
+## Provider Instance
+
+You can import the default provider instance `alibaba` from `@ai-sdk/alibaba`:
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+```
+
+## Language Model Example
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: alibaba('qwen-plus'),
+  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
+});
+```
+
+## Thinking Mode Example (Qwen Reasoning Models)
+
+Alibaba's Qwen models support thinking/reasoning mode for complex problem-solving:
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText } from 'ai';
+
+const { text, reasoningText } = await generateText({
+  model: alibaba('qwen3-max'),
+  providerOptions: {
+    alibaba: {
+      enableThinking: true,
+      thinkingBudget: 2048,
+    },
+  },
+  prompt: 'How many "r"s are in the word "strawberry"?',
+});
+
+console.log('Reasoning:', reasoningText);
+console.log('Answer:', text);
+```
+
+## Tool Calling Example
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText, tool } from 'ai';
+import { z } from 'zod';
+
+const { text } = await generateText({
+  model: alibaba('qwen-plus'),
+  tools: {
+    weather: tool({
+      description: 'Get the weather in a location',
+      parameters: z.object({
+        location: z.string().describe('The location to get the weather for'),
+      }),
+      execute: async ({ location }) => ({
+        location,
+        temperature: 72 + Math.floor(Math.random() * 21) - 10,
+      }),
+    }),
+  },
+  prompt: 'What is the weather in San Francisco?',
+});
+```
+
+## Explicit Caching Example
+
+Alibaba supports both implicit and explicit prompt caching to reduce costs for repeated prompts.
+
+**Implicit caching** works automatically - the provider caches appropriate content without any configuration. For more control, you can use **explicit caching** by marking specific messages with `cacheControl`:
+
+```ts
+import { alibaba } from '@ai-sdk/alibaba';
+import { generateText } from 'ai';
+
+const longDocument = '... large document content ...';
+
+const { text, usage } = await generateText({
+  model: alibaba('qwen-plus'),
+  messages: [
+    {
+      role: 'user',
+      content: [
+        {
+          type: 'text',
+          text: 'Context: Please analyze this document.',
+        },
+        {
+          type: 'text',
+          text: longDocument,
+          providerOptions: {
+            alibaba: {
+              cacheControl: { type: 'ephemeral' },
+            },
+          },
+        },
+      ],
+    },
+  ],
+});
+```
+
+**Note:** The minimum content length for a cache block is 1,024 tokens.
+
+## Documentation
+
+Please check out the **[Alibaba provider documentation](https://ai-sdk.dev/providers/ai-sdk-providers/alibaba)** for more information.

package/dist/index.d.mts

@@ -0,0 +1,119 @@
+import { z } from 'zod/v4';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+import { ProviderV4, LanguageModelV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
+
+type AlibabaChatModelId = 'qwen3-max' | 'qwen3-max-preview' | 'qwen-plus' | 'qwen-plus-latest' | 'qwen-flash' | 'qwen-turbo' | 'qwen-turbo-latest' | 'qwen3-235b-a22b' | 'qwen3-32b' | 'qwen3-30b-a3b' | 'qwen3-14b' | 'qwen3-next-80b-a3b-thinking' | 'qwen3-235b-a22b-thinking-2507' | 'qwen3-30b-a3b-thinking-2507' | 'qwq-plus' | 'qwq-plus-latest' | 'qwq-32b' | 'qwen-coder' | 'qwen3-coder-plus' | 'qwen3-coder-flash' | (string & {});
+declare const alibabaLanguageModelOptions: z.ZodObject<{
+    enableThinking: z.ZodOptional<z.ZodBoolean>;
+    thinkingBudget: z.ZodOptional<z.ZodNumber>;
+    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AlibabaLanguageModelOptions = z.infer<typeof alibabaLanguageModelOptions>;
+
+type AlibabaCacheControl = {
+    type: string;
+};
+
+type AlibabaVideoModelId = 'wan2.6-t2v' | 'wan2.5-t2v-preview' | 'wan2.6-i2v' | 'wan2.6-i2v-flash' | 'wan2.6-r2v' | 'wan2.6-r2v-flash' | (string & {});
+
+interface AlibabaProvider extends ProviderV4 {
+    (modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a model for text generation.
+     */
+    languageModel(modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a chat model for text generation.
+     */
+    chatModel(modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: AlibabaVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: AlibabaVideoModelId): Experimental_VideoModelV4;
+}
+interface AlibabaProviderSettings {
+    /**
+     * Use a different URL prefix for API calls, e.g. to use proxy servers or regional endpoints.
+     * The default prefix is `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Use a different URL prefix for video generation API calls.
+     * The video API uses the DashScope native endpoint (not the OpenAI-compatible endpoint).
+     * The default prefix is `https://dashscope-intl.aliyuncs.com`.
+     */
+    videoBaseURL?: string;
+    /**
+     * API key that is being sent using the `Authorization` header.
+     * It defaults to the `ALIBABA_API_KEY` environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. You can use it as a middleware to intercept requests,
+     * or to provide a custom fetch implementation for e.g. testing.
+     */
+    fetch?: FetchFunction;
+    /**
+     * Include usage information in streaming responses.
+     * When enabled, token usage will be included in the final chunk.
+     *
+     * @default true
+     */
+    includeUsage?: boolean;
+}
+/**
+ * Create an Alibaba Cloud (Qwen) provider instance.
+ */
+declare function createAlibaba(options?: AlibabaProviderSettings): AlibabaProvider;
+declare const alibaba: AlibabaProvider;
+
+type AlibabaVideoModelOptions = {
+    /** Negative prompt to specify what to avoid (max 500 chars). */
+    negativePrompt?: string | null;
+    /** URL to audio file for audio-video sync (WAV/MP3, 3-30s, max 15MB). */
+    audioUrl?: string | null;
+    /** Enable prompt extension/rewriting for better generation. Defaults to true. */
+    promptExtend?: boolean | null;
+    /** Shot type: 'single' for single-shot or 'multi' for multi-shot narrative. */
+    shotType?: 'single' | 'multi' | null;
+    /** Whether to add watermark to generated video. Defaults to false. */
+    watermark?: boolean | null;
+    /** Enable audio generation (for I2V/R2V models). */
+    audio?: boolean | null;
+    /**
+     * Reference URLs for reference-to-video mode.
+     * Array of URLs to images (0-5) and/or videos (0-3), max 5 total.
+     * Use character identifiers (character1, character2) in prompts to reference them.
+     */
+    referenceUrls?: string[] | null;
+    /** Polling interval in milliseconds. Defaults to 5000 (5 seconds). */
+    pollIntervalMs?: number | null;
+    /** Maximum wait time in milliseconds for video generation. Defaults to 600000 (10 minutes). */
+    pollTimeoutMs?: number | null;
+    [key: string]: unknown;
+};
+
+type AlibabaUsage = {
+    prompt_tokens?: number | null;
+    completion_tokens?: number | null;
+    total_tokens?: number | null;
+    prompt_tokens_details?: {
+        cached_tokens?: number | null;
+        cache_creation_input_tokens?: number | null;
+    } | null;
+    completion_tokens_details?: {
+        reasoning_tokens?: number | null;
+    } | null;
+};
+
+declare const VERSION: string;
+
+export { type AlibabaCacheControl, type AlibabaChatModelId, type AlibabaLanguageModelOptions, type AlibabaProvider, type AlibabaLanguageModelOptions as AlibabaProviderOptions, type AlibabaProviderSettings, type AlibabaUsage, type AlibabaVideoModelId, type AlibabaVideoModelOptions, type AlibabaVideoModelOptions as AlibabaVideoProviderOptions, VERSION, alibaba, createAlibaba };

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod/v4';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+import { ProviderV4, LanguageModelV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
+
+type AlibabaChatModelId = 'qwen3-max' | 'qwen3-max-preview' | 'qwen-plus' | 'qwen-plus-latest' | 'qwen-flash' | 'qwen-turbo' | 'qwen-turbo-latest' | 'qwen3-235b-a22b' | 'qwen3-32b' | 'qwen3-30b-a3b' | 'qwen3-14b' | 'qwen3-next-80b-a3b-thinking' | 'qwen3-235b-a22b-thinking-2507' | 'qwen3-30b-a3b-thinking-2507' | 'qwq-plus' | 'qwq-plus-latest' | 'qwq-32b' | 'qwen-coder' | 'qwen3-coder-plus' | 'qwen3-coder-flash' | (string & {});
+declare const alibabaLanguageModelOptions: z.ZodObject<{
+    enableThinking: z.ZodOptional<z.ZodBoolean>;
+    thinkingBudget: z.ZodOptional<z.ZodNumber>;
+    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AlibabaLanguageModelOptions = z.infer<typeof alibabaLanguageModelOptions>;
+
+type AlibabaCacheControl = {
+    type: string;
+};
+
+type AlibabaVideoModelId = 'wan2.6-t2v' | 'wan2.5-t2v-preview' | 'wan2.6-i2v' | 'wan2.6-i2v-flash' | 'wan2.6-r2v' | 'wan2.6-r2v-flash' | (string & {});
+
+interface AlibabaProvider extends ProviderV4 {
+    (modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a model for text generation.
+     */
+    languageModel(modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a chat model for text generation.
+     */
+    chatModel(modelId: AlibabaChatModelId): LanguageModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: AlibabaVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: AlibabaVideoModelId): Experimental_VideoModelV4;
+}
+interface AlibabaProviderSettings {
+    /**
+     * Use a different URL prefix for API calls, e.g. to use proxy servers or regional endpoints.
+     * The default prefix is `https://dashscope-intl.aliyuncs.com/compatible-mode/v1`.
+     */
+    baseURL?: string;
+    /**
+     * Use a different URL prefix for video generation API calls.
+     * The video API uses the DashScope native endpoint (not the OpenAI-compatible endpoint).
+     * The default prefix is `https://dashscope-intl.aliyuncs.com`.
+     */
+    videoBaseURL?: string;
+    /**
+     * API key that is being sent using the `Authorization` header.
+     * It defaults to the `ALIBABA_API_KEY` environment variable.
+     */
+    apiKey?: string;
+    /**
+     * Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. You can use it as a middleware to intercept requests,
+     * or to provide a custom fetch implementation for e.g. testing.
+     */
+    fetch?: FetchFunction;
+    /**
+     * Include usage information in streaming responses.
+     * When enabled, token usage will be included in the final chunk.
+     *
+     * @default true
+     */
+    includeUsage?: boolean;
+}
+/**
+ * Create an Alibaba Cloud (Qwen) provider instance.
+ */
+declare function createAlibaba(options?: AlibabaProviderSettings): AlibabaProvider;
+declare const alibaba: AlibabaProvider;
+
+type AlibabaVideoModelOptions = {
+    /** Negative prompt to specify what to avoid (max 500 chars). */
+    negativePrompt?: string | null;
+    /** URL to audio file for audio-video sync (WAV/MP3, 3-30s, max 15MB). */
+    audioUrl?: string | null;
+    /** Enable prompt extension/rewriting for better generation. Defaults to true. */
+    promptExtend?: boolean | null;
+    /** Shot type: 'single' for single-shot or 'multi' for multi-shot narrative. */
+    shotType?: 'single' | 'multi' | null;
+    /** Whether to add watermark to generated video. Defaults to false. */
+    watermark?: boolean | null;
+    /** Enable audio generation (for I2V/R2V models). */
+    audio?: boolean | null;
+    /**
+     * Reference URLs for reference-to-video mode.
+     * Array of URLs to images (0-5) and/or videos (0-3), max 5 total.
+     * Use character identifiers (character1, character2) in prompts to reference them.
+     */
+    referenceUrls?: string[] | null;
+    /** Polling interval in milliseconds. Defaults to 5000 (5 seconds). */
+    pollIntervalMs?: number | null;
+    /** Maximum wait time in milliseconds for video generation. Defaults to 600000 (10 minutes). */
+    pollTimeoutMs?: number | null;
+    [key: string]: unknown;
+};
+
+type AlibabaUsage = {
+    prompt_tokens?: number | null;
+    completion_tokens?: number | null;
+    total_tokens?: number | null;
+    prompt_tokens_details?: {
+        cached_tokens?: number | null;
+        cache_creation_input_tokens?: number | null;
+    } | null;
+    completion_tokens_details?: {
+        reasoning_tokens?: number | null;
+    } | null;
+};
+
+declare const VERSION: string;
+
+export { type AlibabaCacheControl, type AlibabaChatModelId, type AlibabaLanguageModelOptions, type AlibabaProvider, type AlibabaLanguageModelOptions as AlibabaProviderOptions, type AlibabaProviderSettings, type AlibabaUsage, type AlibabaVideoModelId, type AlibabaVideoModelOptions, type AlibabaVideoModelOptions as AlibabaVideoProviderOptions, VERSION, alibaba, createAlibaba };