@ai-sdk/alibaba 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @ai-sdk/alibaba
+
+## 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,121 @@
+# 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 { text, usage } = await generateText({
+  model: alibaba('qwen-plus'),
+  messages: [
+    {
+      role: 'system',
+      content: 'You are a helpful assistant. [... long system prompt ...]',
+      providerMetadata: {
+        alibaba: {
+          cacheControl: { type: 'ephemeral' },
+        },
+      },
+    },
+    {
+      role: 'user',
+      content: 'What is the capital of France?',
+    },
+  ],
+});
+```
+
+## 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,77 @@
+import { FetchFunction } from '@ai-sdk/provider-utils';
+import { ProviderV3, LanguageModelV3 } from '@ai-sdk/provider';
+import { z } from 'zod/v4';
+
+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 alibabaProviderOptions: z.ZodObject<{
+    enableThinking: z.ZodOptional<z.ZodBoolean>;
+    thinkingBudget: z.ZodOptional<z.ZodNumber>;
+    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AlibabaProviderOptions = z.infer<typeof alibabaProviderOptions>;
+
+interface AlibabaProvider extends ProviderV3 {
+    (modelId: AlibabaChatModelId): LanguageModelV3;
+    /**
+     * Creates a model for text generation.
+     */
+    languageModel(modelId: AlibabaChatModelId): LanguageModelV3;
+    /**
+     * Creates a chat model for text generation.
+     */
+    chatModel(modelId: AlibabaChatModelId): LanguageModelV3;
+}
+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;
+    /**
+     * 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 AlibabaCacheControl = {
+    type: string;
+};
+
+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 AlibabaProvider, type AlibabaProviderOptions, type AlibabaProviderSettings, type AlibabaUsage, VERSION, alibaba, createAlibaba };

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+import { FetchFunction } from '@ai-sdk/provider-utils';
+import { ProviderV3, LanguageModelV3 } from '@ai-sdk/provider';
+import { z } from 'zod/v4';
+
+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 alibabaProviderOptions: z.ZodObject<{
+    enableThinking: z.ZodOptional<z.ZodBoolean>;
+    thinkingBudget: z.ZodOptional<z.ZodNumber>;
+    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type AlibabaProviderOptions = z.infer<typeof alibabaProviderOptions>;
+
+interface AlibabaProvider extends ProviderV3 {
+    (modelId: AlibabaChatModelId): LanguageModelV3;
+    /**
+     * Creates a model for text generation.
+     */
+    languageModel(modelId: AlibabaChatModelId): LanguageModelV3;
+    /**
+     * Creates a chat model for text generation.
+     */
+    chatModel(modelId: AlibabaChatModelId): LanguageModelV3;
+}
+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;
+    /**
+     * 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 AlibabaCacheControl = {
+    type: string;
+};
+
+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 AlibabaProvider, type AlibabaProviderOptions, type AlibabaProviderSettings, type AlibabaUsage, VERSION, alibaba, createAlibaba };