@ai-sdk/moonshotai 0.0.19 → 0.0.24

package/CHANGELOG.md

@@ -1,5 +1,56 @@
 # @ai-sdk/moonshotai
 
+## 0.0.24
+
+### Patch Changes
+
+- 9391f70: Add first-class Moonshot V1 auto and vision-preview model IDs while preserving custom and retired model ID support.
+- e8a4fca: feat(provider/moonshotai): support Partial Mode for final assistant message prefixes
+- 51f05ce: feat(provider/moonshotai): support chat log probabilities
+- 497745e: Preserve Moonshot chat response metadata for generated and streamed responses.
+- ff9e44b: Preserve documented Moonshot API error codes in HTTP and streaming errors.
+- 30a28c2: Add provider-specific names for Moonshot AI system, user, and assistant messages.
+- a5854a9: Add support for Moonshot predicted outputs.
+- b909d7a: Support Kimi K3 dynamic tool-loading system messages.
+
+## 0.0.23
+
+### Patch Changes
+
+- 71b1bb5: fix(provider/moonshotai): send max output tokens with the current Moonshot request field
+- Updated dependencies [77d33c0]
+  - @ai-sdk/provider-utils@3.0.35
+  - @ai-sdk/openai-compatible@1.0.52
+
+## 0.0.22
+
+### Patch Changes
+
+- cef6cbe: Normalize Moonshot structured output schemas and enable strict validation by default.
+- c4c0ba6: Use native JSON Schema structured outputs for official Moonshot V1 models.
+- Updated dependencies [e264a35]
+  - @ai-sdk/openai-compatible@1.0.51
+
+## 0.0.21
+
+### Patch Changes
+
+- 2836c36: fix(provider/moonshotai): align thinking and reasoning options by model
+- 104d4e2: fix(provider/moonshotai): omit unsupported sampling parameters for Kimi models
+- 47a3944: Omit required tool choice with a warning for Moonshot Kimi models that reject it.
+- Updated dependencies [2fff9f1]
+- Updated dependencies [f364ea0]
+  - @ai-sdk/provider-utils@3.0.34
+  - @ai-sdk/openai-compatible@1.0.50
+
+## 0.0.20
+
+### Patch Changes
+
+- Updated dependencies [9e8e087]
+  - @ai-sdk/provider-utils@3.0.33
+  - @ai-sdk/openai-compatible@1.0.49
+
 ## 0.0.19
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # AI SDK - Moonshot AI Provider
 
-The **[Moonshot AI provider](https://ai-sdk.dev/providers/ai-sdk-providers/moonshotai)** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for the [Moonshot AI](https://platform.moonshot.cn) platform, including the Kimi model series.
+The **[Moonshot AI provider](https://ai-sdk.dev/providers/ai-sdk-providers/moonshotai)** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for the [Kimi API Platform](https://platform.kimi.ai/docs), including the Kimi model series.
 
 > **Deploying to Vercel?** With Vercel's AI Gateway you can access Moonshot AI (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
 
@@ -40,25 +40,53 @@ const { text } = await generateText({
 });
 ```
 
-## Thinking Mode Example (Kimi K2 Thinking)
+## Reasoning Effort Example (Kimi K3)
 
 ```ts
-import { moonshotai } from '@ai-sdk/moonshotai';
+import { moonshotai, type MoonshotAIProviderOptions } from '@ai-sdk/moonshotai';
 import { generateText } from 'ai';
 
-const { text } = await generateText({
-  model: moonshotai('kimi-k2.5'),
-  prompt: 'Invent a new holiday and describe its traditions.',
+const { text, reasoningText } = await generateText({
+  model: moonshotai('kimi-k3'),
+  prompt: 'Solve this problem step by step: What is 15% of 240?',
+  providerOptions: {
+    moonshotai: {
+      reasoningEffort: 'high',
+    } satisfies MoonshotAIProviderOptions,
+  },
+});
+
+console.log(reasoningText);
+console.log(text);
+```
+
+Kimi K2.6 supports thinking and non-thinking modes. Enable it with
+`thinking: { type: 'enabled' }` or disable it with
+`thinking: { type: 'disabled' }`.
+
+Kimi K2.7 Code always has thinking enabled and uses Preserved Thinking. Keep
+reasoning history in multi-turn conversations:
+
+```ts
+import {
+  moonshotai,
+  type MoonshotAIProviderOptions,
+} from '@ai-sdk/moonshotai';
+import { generateText } from 'ai';
+
+const { text, reasoningText } = await generateText({
+  model: moonshotai('kimi-k2.7-code'),
+  prompt: 'Solve this problem step by step: What is 15% of 240?',
   providerOptions: {
     moonshotai: {
-      thinking: {
-        type: 'enabled',
-        budgetTokens: 2048,
-      },
-      reasoningHistory: 'interleaved',
-    } as MoonshotAIProviderOptions,
+      thinking: { type: 'enabled' },
+      reasoningHistory: 'preserved',
+    } satisfies MoonshotAIProviderOptions,
   },
 });
+
+console.log(reasoningText);
+console.log(text);
 ```
 
 ## Documentation

package/dist/index.d.mts

@@ -1,24 +1,68 @@
-import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
+import { LanguageModelV2FunctionTool, ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
 import { FetchFunction } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
-type MoonshotAIChatModelId = 'moonshot-v1-8k' | 'moonshot-v1-32k' | 'moonshot-v1-128k' | 'kimi-k2' | 'kimi-k2-0905' | 'kimi-k2-thinking' | 'kimi-k2-thinking-turbo' | 'kimi-k2-turbo' | 'kimi-k2.5' | 'kimi-k3' | (string & {});
-declare const moonshotaiProviderOptions: z.ZodObject<{
-    reasoningEffort: z.ZodOptional<z.ZodLiteral<"max">>;
-    thinking: z.ZodOptional<z.ZodObject<{
-        type: z.ZodOptional<z.ZodEnum<{
-            enabled: "enabled";
-            disabled: "disabled";
-        }>>;
-        budgetTokens: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    reasoningHistory: z.ZodOptional<z.ZodEnum<{
-        disabled: "disabled";
-        interleaved: "interleaved";
-        preserved: "preserved";
-    }>>;
+type MoonshotAIChatModelId = 'moonshot-v1-auto' | 'moonshot-v1-8k' | 'moonshot-v1-32k' | 'moonshot-v1-128k' | 'moonshot-v1-8k-vision-preview' | 'moonshot-v1-32k-vision-preview' | 'moonshot-v1-128k-vision-preview' | 'kimi-k2.5' | 'kimi-k2.6' | 'kimi-k2.7-code' | 'kimi-k2.7-code-highspeed' | 'kimi-k3' | (string & {});
+type MoonshotAIProviderOptions = {
+    /**
+     * Whether to use strict JSON schema validation for structured outputs.
+     *
+     * @default true
+     */
+    strictJsonSchema?: boolean;
+    /** Whether to return log probabilities for generated tokens. */
+    logprobs?: boolean;
+    /**
+     * Number of most likely tokens to return at each token position.
+     * Setting this option automatically enables `logprobs`.
+     */
+    topLogprobs?: number;
+    /** Reasoning effort for Kimi K3. */
+    reasoningEffort?: 'low' | 'high' | 'max';
+    /**
+     * Static predicted content that can accelerate responses when much of the
+     * output is known ahead of time.
+     */
+    prediction?: {
+        type: 'content';
+        content: string | Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    /** Controls thinking on Kimi K2.5 and K2.6. K2.7 is always enabled. */
+    thinking?: {
+        type?: 'enabled' | 'disabled';
+        /**
+         * @deprecated Moonshot Chat Completions does not support thinking budgets.
+         * This value is ignored with a warning.
+         */
+        budgetTokens?: number;
+    };
+    /**
+     * Controls preserved reasoning behavior in multi-turn conversations.
+     * `disabled` and `interleaved` are compatibility values that leave the
+     * request unchanged. `preserved` maps to `thinking.keep: 'all'` for Kimi
+     * K2.6. Kimi K2.7 and K3 preserve reasoning by default.
+     */
+    reasoningHistory?: 'disabled' | 'interleaved' | 'preserved';
+};
+declare const moonshotaiMessageProviderOptions: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type MoonshotAIMessageProviderOptions = z.infer<typeof moonshotaiMessageProviderOptions>;
+declare const moonshotaiAssistantMessageProviderOptions: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    partial: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
-type MoonshotAIProviderOptions = z.infer<typeof moonshotaiProviderOptions>;
+type MoonshotAIAssistantMessageProviderOptions = z.infer<typeof moonshotaiAssistantMessageProviderOptions>;
+type MoonshotAISystemMessageProviderOptions = MoonshotAIMessageProviderOptions & {
+    /** Function tools to load at this point in a Kimi K3 conversation. */
+    tools?: Array<Pick<LanguageModelV2FunctionTool, 'type' | 'name' | 'description' | 'inputSchema'> & {
+        /** Whether Moonshot should enforce the tool input schema strictly. */
+        strict?: boolean;
+    }>;
+};
 
 interface MoonshotAIProviderSettings {
     /**
@@ -57,4 +101,4 @@ interface MoonshotAIProvider extends ProviderV2 {
 declare function createMoonshotAI(options?: MoonshotAIProviderSettings): MoonshotAIProvider;
 declare const moonshotai: MoonshotAIProvider;
 
-export { type MoonshotAIChatModelId, type MoonshotAIProvider, type MoonshotAIProviderOptions, type MoonshotAIProviderSettings, createMoonshotAI, moonshotai };
+export { type MoonshotAIAssistantMessageProviderOptions, type MoonshotAIChatModelId, type MoonshotAIMessageProviderOptions, type MoonshotAIProvider, type MoonshotAIProviderOptions, type MoonshotAIProviderSettings, type MoonshotAISystemMessageProviderOptions, createMoonshotAI, moonshotai };

package/dist/index.d.ts

@@ -1,24 +1,68 @@
-import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
+import { LanguageModelV2FunctionTool, ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
 import { FetchFunction } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
-type MoonshotAIChatModelId = 'moonshot-v1-8k' | 'moonshot-v1-32k' | 'moonshot-v1-128k' | 'kimi-k2' | 'kimi-k2-0905' | 'kimi-k2-thinking' | 'kimi-k2-thinking-turbo' | 'kimi-k2-turbo' | 'kimi-k2.5' | 'kimi-k3' | (string & {});
-declare const moonshotaiProviderOptions: z.ZodObject<{
-    reasoningEffort: z.ZodOptional<z.ZodLiteral<"max">>;
-    thinking: z.ZodOptional<z.ZodObject<{
-        type: z.ZodOptional<z.ZodEnum<{
-            enabled: "enabled";
-            disabled: "disabled";
-        }>>;
-        budgetTokens: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    reasoningHistory: z.ZodOptional<z.ZodEnum<{
-        disabled: "disabled";
-        interleaved: "interleaved";
-        preserved: "preserved";
-    }>>;
+type MoonshotAIChatModelId = 'moonshot-v1-auto' | 'moonshot-v1-8k' | 'moonshot-v1-32k' | 'moonshot-v1-128k' | 'moonshot-v1-8k-vision-preview' | 'moonshot-v1-32k-vision-preview' | 'moonshot-v1-128k-vision-preview' | 'kimi-k2.5' | 'kimi-k2.6' | 'kimi-k2.7-code' | 'kimi-k2.7-code-highspeed' | 'kimi-k3' | (string & {});
+type MoonshotAIProviderOptions = {
+    /**
+     * Whether to use strict JSON schema validation for structured outputs.
+     *
+     * @default true
+     */
+    strictJsonSchema?: boolean;
+    /** Whether to return log probabilities for generated tokens. */
+    logprobs?: boolean;
+    /**
+     * Number of most likely tokens to return at each token position.
+     * Setting this option automatically enables `logprobs`.
+     */
+    topLogprobs?: number;
+    /** Reasoning effort for Kimi K3. */
+    reasoningEffort?: 'low' | 'high' | 'max';
+    /**
+     * Static predicted content that can accelerate responses when much of the
+     * output is known ahead of time.
+     */
+    prediction?: {
+        type: 'content';
+        content: string | Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    /** Controls thinking on Kimi K2.5 and K2.6. K2.7 is always enabled. */
+    thinking?: {
+        type?: 'enabled' | 'disabled';
+        /**
+         * @deprecated Moonshot Chat Completions does not support thinking budgets.
+         * This value is ignored with a warning.
+         */
+        budgetTokens?: number;
+    };
+    /**
+     * Controls preserved reasoning behavior in multi-turn conversations.
+     * `disabled` and `interleaved` are compatibility values that leave the
+     * request unchanged. `preserved` maps to `thinking.keep: 'all'` for Kimi
+     * K2.6. Kimi K2.7 and K3 preserve reasoning by default.
+     */
+    reasoningHistory?: 'disabled' | 'interleaved' | 'preserved';
+};
+declare const moonshotaiMessageProviderOptions: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type MoonshotAIMessageProviderOptions = z.infer<typeof moonshotaiMessageProviderOptions>;
+declare const moonshotaiAssistantMessageProviderOptions: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    partial: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strip>;
-type MoonshotAIProviderOptions = z.infer<typeof moonshotaiProviderOptions>;
+type MoonshotAIAssistantMessageProviderOptions = z.infer<typeof moonshotaiAssistantMessageProviderOptions>;
+type MoonshotAISystemMessageProviderOptions = MoonshotAIMessageProviderOptions & {
+    /** Function tools to load at this point in a Kimi K3 conversation. */
+    tools?: Array<Pick<LanguageModelV2FunctionTool, 'type' | 'name' | 'description' | 'inputSchema'> & {
+        /** Whether Moonshot should enforce the tool input schema strictly. */
+        strict?: boolean;
+    }>;
+};
 
 interface MoonshotAIProviderSettings {
     /**
@@ -57,4 +101,4 @@ interface MoonshotAIProvider extends ProviderV2 {
 declare function createMoonshotAI(options?: MoonshotAIProviderSettings): MoonshotAIProvider;
 declare const moonshotai: MoonshotAIProvider;
 
-export { type MoonshotAIChatModelId, type MoonshotAIProvider, type MoonshotAIProviderOptions, type MoonshotAIProviderSettings, createMoonshotAI, moonshotai };
+export { type MoonshotAIAssistantMessageProviderOptions, type MoonshotAIChatModelId, type MoonshotAIMessageProviderOptions, type MoonshotAIProvider, type MoonshotAIProviderOptions, type MoonshotAIProviderSettings, type MoonshotAISystemMessageProviderOptions, createMoonshotAI, moonshotai };