@core-ai/kimi 0.16.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omnifact (https://omnifact.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @core-ai/kimi
+
+[![npm](https://img.shields.io/npm/v/@core-ai/kimi.svg)](https://www.npmjs.com/package/@core-ai/kimi)
+
+Kimi (Moonshot AI) provider package for `@core-ai/core-ai`.
+
+## Installation
+
+```bash
+npm install @core-ai/core-ai @core-ai/kimi zod
+```
+
+## Usage
+
+```ts
+import { generate } from '@core-ai/core-ai';
+import { createKimi } from '@core-ai/kimi';
+
+const kimi = createKimi({
+    apiKey: process.env.KIMI_API_KEY,
+});
+
+const model = kimi.chatModel('kimi-k2.7-code');
+
+const result = await generate({
+    model,
+    messages: [{ role: 'user', content: 'Implement quicksort in TypeScript.' }],
+    maxTokens: 32768,
+});
+
+console.log(result.content);
+```
+
+By default, requests go to `https://api.moonshot.ai/v1`. Set `baseURL` to use a custom endpoint.
+
+## Supported models
+
+- `kimi-k2.7-code` — coding-focused agentic model with always-on thinking
+- `kimi-k2.7-code-highspeed` — same model with higher output speed
+
+## Reasoning and preserved thinking
+
+Kimi K2.7 Code always runs in thinking mode. The provider maps Moonshot's `reasoning_content` field to core-ai reasoning parts and preserves it across multi-turn conversations via `resultToMessage()`.
+
+## Fixed sampling constraints
+
+For `kimi-k2.7-code` and `kimi-k2.7-code-highspeed`, Moonshot fixes sampling parameters server-side. Do not pass custom `temperature` or `topP` values — the provider validates these locally and omits fixed parameters from requests.
+
+## Structured output
+
+`generateObject()` and `streamObject()` use Moonshot JSON Mode (`response_format: { type: 'json_object' }`) and validate the returned JSON with your Zod schema.
+
+Forced tool choice via `toolChoice: { type: 'tool', toolName }` is rejected on K2.7 Code models because Moonshot does not allow forced tool selection while thinking is always enabled.
+
+## Provider options
+
+Pass Kimi-specific options via `providerOptions.kimi`:
+
+```ts
+await generate({
+    model,
+    messages: [{ role: 'user', content: 'Hello' }],
+    providerOptions: {
+        kimi: {
+            parallelToolCalls: true,
+            stopSequences: ['END'],
+        },
+    },
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { ChatModel } from '@core-ai/core-ai';
+import { OpenAIProviderBaseOptions } from '@core-ai/openai';
+import { z } from 'zod';
+
+type KimiProviderOptions = OpenAIProviderBaseOptions;
+type KimiProvider = {
+    chatModel(modelId: string): ChatModel;
+};
+declare function createKimi(options?: KimiProviderOptions): KimiProvider;
+
+declare const DEFAULT_BASE_URL = "https://api.moonshot.ai/v1";
+
+declare const kimiGenerateProviderOptionsSchema: z.ZodObject<{
+    user: z.ZodOptional<z.ZodString>;
+    parallelToolCalls: z.ZodOptional<z.ZodBoolean>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+type KimiGenerateProviderOptions = z.infer<typeof kimiGenerateProviderOptionsSchema>;
+declare module '@core-ai/core-ai' {
+    interface GenerateProviderOptions {
+        kimi?: KimiGenerateProviderOptions;
+    }
+}
+type KimiReasoningMetadata = Record<string, never>;
+
+export { DEFAULT_BASE_URL, type KimiGenerateProviderOptions, type KimiProvider, type KimiProviderOptions, type KimiReasoningMetadata, createKimi, kimiGenerateProviderOptionsSchema };

package/dist/index.js

@@ -0,0 +1,76 @@
+// src/provider.ts
+import {
+  createOpenAIProvider
+} from "@core-ai/openai";
+
+// src/constants.ts
+var DEFAULT_BASE_URL = "https://api.moonshot.ai/v1";
+
+// src/model-capabilities.ts
+import {
+  UNKNOWN_MODEL
+} from "@core-ai/core-ai";
+var UNKNOWN_MODEL_CAPABILITIES = {
+  reasoning: {
+    mode: "unsupported",
+    supportedEfforts: [],
+    restrictsSamplingParams: false,
+    supportedToolChoices: ["auto", "none", "required", "tool"]
+  }
+};
+var K2_7_CODE_CAPABILITIES = {
+  reasoning: {
+    mode: "always-on",
+    supportedEfforts: [],
+    restrictsSamplingParams: true,
+    supportedToolChoices: ["auto", "none"]
+  }
+};
+var KIMI_MODEL_CAPABILITIES = {
+  [UNKNOWN_MODEL]: UNKNOWN_MODEL_CAPABILITIES,
+  "kimi-k2.7-code": K2_7_CODE_CAPABILITIES,
+  "kimi-k2.7-code-highspeed": K2_7_CODE_CAPABILITIES
+};
+
+// src/provider-options.ts
+import { openaiChatGenerateProviderOptionsSchema } from "@core-ai/openai";
+var kimiGenerateProviderOptionsSchema = openaiChatGenerateProviderOptionsSchema.pick({
+  parallelToolCalls: true,
+  stopSequences: true,
+  seed: true,
+  user: true
+});
+
+// src/provider.ts
+function createKimi(options = {}) {
+  if (!options.apiKey && !options.client) {
+    throw new Error("createKimi: apiKey is required.");
+  }
+  const provider = createOpenAIProvider(
+    {
+      ...options,
+      baseURL: options.baseURL ?? DEFAULT_BASE_URL
+    },
+    {
+      modelCapabilities: KIMI_MODEL_CAPABILITIES,
+      providerId: "kimi",
+      providerOptionsSchema: kimiGenerateProviderOptionsSchema,
+      defaultApi: "chat-completions",
+      compatibility: {
+        reasoning: {
+          requestField: "reasoning_content"
+        },
+        structuredOutputMode: "json-object",
+        maxTokensParameter: "max_tokens"
+      }
+    }
+  );
+  return {
+    chatModel: provider.chatModel
+  };
+}
+export {
+  DEFAULT_BASE_URL,
+  createKimi,
+  kimiGenerateProviderOptionsSchema
+};

package/package.json

@@ -0,0 +1,62 @@
+{
+    "name": "@core-ai/kimi",
+    "version": "0.16.0",
+    "description": "Kimi (Moonshot AI) provider package for @core-ai/core-ai",
+    "license": "MIT",
+    "author": "Omnifact (https://omnifact.ai)",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/agdevhq/core-ai.git",
+        "directory": "packages/kimi"
+    },
+    "keywords": [
+        "llm",
+        "ai",
+        "kimi",
+        "moonshot",
+        "provider",
+        "sdk"
+    ],
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "scripts": {
+        "build": "tsup",
+        "lint": "eslint src/ --max-warnings 0",
+        "check-types": "tsc --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "@core-ai/core-ai": "^0.16.0",
+        "@core-ai/openai": "^0.16.0"
+    },
+    "peerDependencies": {
+        "zod": "^4.0.0"
+    },
+    "devDependencies": {
+        "@core-ai/eslint-config": "*",
+        "@core-ai/testing": "*",
+        "@core-ai/typescript-config": "*",
+        "openai": "^6.47.0",
+        "typescript": "^5.7.3",
+        "vitest": "^3.2.4"
+    }
+}