@agentxin-ai/plugin-moonshot 0.0.2

package/README.md

@@ -0,0 +1,65 @@
+# AgentXin Plugin: Moonshot AI
+
+## Overview
+
+`@agentxin-ai/plugin-moonshot` connects [Moonshot AI (Kimi)](https://platform.moonshot.cn/) models to the [AgentXinAI](https://github.com/agentxin-ai/agentxin) platform. The plugin integrates Moonshot's OpenAI-compatible API so AgentXinAI agents can leverage Kimi's powerful long-context language models with context windows up to 128K tokens, including the latest K2 series with advanced reasoning capabilities.
+
+## Core Features
+
+- Ships `MoonshotModule`, which registers the NestJS provider strategy, lifecycle hooks, and configuration schema required by the plugin runtime.
+- Implements `MoonshotLargeLanguageModel`, a LangChain-powered adapter built on `ChatOpenAI` that supports streaming chat completions, function calling, and token accounting callbacks for agent telemetry.
+- Shares a console-ready `moonshot.yaml` that drives the AgentXinAI UI forms (icons, help links, credential prompts) for quick operator onboarding.
+- Supports multiple Moonshot model variants including:
+  - **Moonshot V1 Series**: `moonshot-v1-8k`, `moonshot-v1-32k`, `moonshot-v1-128k` for various context length requirements
+  - **Kimi K2 Series**: `kimi-k2-0711-preview`, `kimi-k2-0905-preview`, `kimi-k2-turbo-preview` for enhanced performance
+  - **Kimi K2 Thinking Series**: `kimi-k2-thinking`, `kimi-k2-thinking-turbo` for advanced reasoning tasks
+
+## Installation
+
+```bash
+npm install @agentxin-ai/plugin-moonshot
+```
+
+> **Peer Dependencies**: Ensure your host service also provides `@agentxin-ai/plugin-sdk`, `@nestjs/common`, `@nestjs/config`, `@metad/contracts`, `@langchain/openai`, `chalk`, and `zod`. Refer to `package.json` for exact versions.
+
+## Enabling in AgentXinAI
+
+1. Declare the plugin before bootstrapping the AgentXinAI server:
+   ```bash
+   PLUGINS=@agentxin-ai/plugin-moonshot
+   ```
+2. In the AgentXinAI admin console (or config file), create a model provider pointing to `moonshot`, then add individual models that map to the specific Moonshot/Kimi versions you want to use.
+
+## Credentials & Model Configuration
+
+The `moonshot.yaml` schema backs the form fields you see in the console:
+
+| Field      | Description                                                                                                    |
+| ---------- | -------------------------------------------------------------------------------------------------------------- |
+| `api_key`  | Required. Your Moonshot API Key from [platform.moonshot.cn/console/api-keys](https://platform.moonshot.cn/console/api-keys). |
+| `base_url` | Optional. Base URL for API requests (defaults to `https://api.moonshot.cn/v1`). Useful for proxy configurations. |
+
+During validation, the plugin instantiates a ChatOpenAI client with your credentials and sends a test message ("你好") to ensure connectivity and permissions.
+
+## Model Capabilities
+
+- **Long Context Support**: All Moonshot models excel at handling long-context scenarios, with the V1-128K variant supporting up to 128,000 tokens of context.
+- **Conversational Models**: `MoonshotLargeLanguageModel` merges provider credentials with per-model overrides, enables streaming, and registers token usage callbacks so agent telemetry stays accurate.
+- **Advanced Reasoning**: The K2 Thinking series models provide enhanced reasoning capabilities for complex problem-solving tasks.
+- **OpenAI Compatibility**: Built on LangChain's `ChatOpenAI`, ensuring seamless integration with existing OpenAI-compatible workflows.
+
+## Development & Debugging
+
+From the repo root, run Nx commands for this package:
+
+```bash
+cd agentxinai
+npx nx build @agentxin-ai/plugin-moonshot
+npx nx test @agentxin-ai/plugin-moonshot
+```
+
+Artifacts land in `agentxinai/models/moonshot/dist`. Jest settings live in `jest.config.ts`, and the asset copier runs via `npm run prepack` before publishing.
+
+## License
+
+This plugin is distributed under the [AGPL-3.0 License](../../../LICENSE) located at the repository root.

package/dist/_assets/icon_s_en.svg

@@ -0,0 +1,8 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="24" height="24" rx="6" fill="#1E1E1E"/>
+<path d="M12 4C11.4477 4 11 4.44772 11 5V7C11 7.55228 11.4477 8 12 8C12.5523 8 13 7.55228 13 7V5C13 4.44772 12.5523 4 12 4Z" fill="white"/>
+<path d="M12 16C11.4477 16 11 16.4477 11 17V19C11 19.5523 11.4477 20 12 20C12.5523 20 13 19.5523 13 19V17C13 16.4477 12.5523 16 12 16Z" fill="white"/>
+<path d="M7 12C7 11.4477 6.55228 11 6 11H4C3.44772 11 3 11.4477 3 12C3 12.5523 3.44772 13 4 13H6C6.55228 13 7 12.5523 7 12Z" fill="white"/>
+<path d="M20 11C20.5523 11 21 11.4477 21 12C21 12.5523 20.5523 13 20 13H18C17.4477 13 17 12.5523 17 12C17 11.4477 17.4477 11 18 11H20Z" fill="white"/>
+<circle cx="12" cy="12" r="3" fill="white"/>
+</svg>

package/dist/llm/_position.yaml

@@ -0,0 +1,6 @@
+- moonshot-v1-8k
+- moonshot-v1-32k
+- moonshot-v1-128k
+- kimi-k2-0711-preview
+- kimi-k2-thinking
+- kimi-k2-thinking-turbo

package/dist/llm/kimi-k2-0711-preview.yaml

@@ -0,0 +1,40 @@
+model: kimi-k2-0711-preview
+label:
+  zh_Hans: kimi-k2-0711-preview
+  en_US: kimi-k2-0711-preview
+model_type: llm
+features:
+  - agent-thought
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 128000
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+  - name: top_p
+    use_template: top_p
+  - name: max_tokens
+    use_template: max_tokens
+    default: 1024
+    min: 1
+    max: 128000
+  - name: response_format
+    label:
+      zh_Hans: 回复格式
+      en_US: Response Format
+    type: string
+    help:
+      zh_Hans: 指定模型必须输出的格式
+      en_US: specifying the format that the model must output
+    required: false
+    options:
+      - text
+      - json_object
+pricing:
+  input: '0.2'
+  output: '0.2'
+  unit: '0.001'
+  currency: RMB 

package/dist/llm/kimi-k2-0905-preview.yaml

@@ -0,0 +1,40 @@
+model: kimi-k2-0905-preview
+label:
+  zh_Hans: kimi-k2-0905-preview
+  en_US: kimi-k2-0905-preview
+model_type: llm
+features:
+  - agent-thought
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 256000
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+  - name: top_p
+    use_template: top_p
+  - name: max_tokens
+    use_template: max_tokens
+    default: 1024
+    min: 1
+    max: 256000
+  - name: response_format
+    label:
+      zh_Hans: 回复格式
+      en_US: Response Format
+    type: string
+    help:
+      zh_Hans: 指定模型必须输出的格式
+      en_US: specifying the format that the model must output
+    required: false
+    options:
+      - text
+      - json_object
+pricing:
+  input: '0.2'
+  output: '0.2'
+  unit: '0.001'
+  currency: RMB 

package/dist/llm/kimi-k2-thinking-turbo.yaml

@@ -0,0 +1,40 @@
+model: kimi-k2-thinking-turbo
+label:
+  zh_Hans: kimi-k2-thinking-turbo
+  en_US: kimi-k2-thinking-turbo
+model_type: llm
+features:
+  - agent-thought
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 262144
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+  - name: top_p
+    use_template: top_p
+  - name: max_tokens
+    use_template: max_tokens
+    default: 1024
+    min: 1
+    max: 262144
+  - name: response_format
+    label:
+      zh_Hans: 回复格式
+      en_US: Response Format
+    type: string
+    help:
+      zh_Hans: 指定模型必须输出的格式
+      en_US: specifying the format that the model must output
+    required: false
+    options:
+      - text
+      - json_object
+pricing:
+  input: '8'
+  output: '58'
+  unit: '0.000001'
+  currency: RMB

package/dist/llm/kimi-k2-thinking.yaml

@@ -0,0 +1,40 @@
+model: kimi-k2-thinking
+label:
+  zh_Hans: kimi-k2-thinking
+  en_US: kimi-k2-thinking
+model_type: llm
+features:
+  - agent-thought
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 262144
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+  - name: top_p
+    use_template: top_p
+  - name: max_tokens
+    use_template: max_tokens
+    default: 1024
+    min: 1
+    max: 262144
+  - name: response_format
+    label:
+      zh_Hans: 回复格式
+      en_US: Response Format
+    type: string
+    help:
+      zh_Hans: 指定模型必须输出的格式
+      en_US: specifying the format that the model must output
+    required: false
+    options:
+      - text
+      - json_object
+pricing:
+  input: '4'
+  output: '16'
+  unit: '0.000001'
+  currency: RMB

package/dist/llm/kimi-k2-turbo-preview.yaml

@@ -0,0 +1,40 @@
+model: kimi-k2-turbo-preview
+label:
+  zh_Hans: kimi-k2-turbo-preview
+  en_US: kimi-k2-turbo-preview
+model_type: llm
+features:
+  - agent-thought
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 256000
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+  - name: top_p
+    use_template: top_p
+  - name: max_tokens
+    use_template: max_tokens
+    default: 1024
+    min: 1
+    max: 256000
+  - name: response_format
+    label:
+      zh_Hans: 回复格式
+      en_US: Response Format
+    type: string
+    help:
+      zh_Hans: 指定模型必须输出的格式
+      en_US: specifying the format that the model must output
+    required: false
+    options:
+      - text
+      - json_object
+pricing:
+  input: '0.2'
+  output: '0.2'
+  unit: '0.001'
+  currency: RMB 

package/dist/llm/moonshot-v1-128k.yaml

@@ -0,0 +1,58 @@
+model: moonshot-v1-128k
+label:
+  en_US: Moonshot v1 128K
+  zh_Hans: 月之暗面 v1 128K
+model_type: llm
+features:
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 131072
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+    default: 0.3
+    min: 0
+    max: 1
+  - name: top_p
+    use_template: top_p
+    default: 1
+    min: 0
+    max: 1
+  - name: max_tokens
+    use_template: max_tokens
+    default: 4096
+    min: 1
+    max: 16384
+  - name: frequency_penalty
+    type: float
+    default: 0
+    min: 0
+    max: 2
+    label:
+      en_US: Frequency Penalty
+      zh_Hans: 频率惩罚
+    help:
+      en_US: Penalize new tokens based on their frequency in the text so far
+      zh_Hans: 根据新 token 在文本中的现有频率对其进行惩罚
+    required: false
+  - name: presence_penalty
+    type: float
+    default: 0
+    min: 0
+    max: 2
+    label:
+      en_US: Presence Penalty
+      zh_Hans: 存在惩罚
+    help:
+      en_US: Penalize new tokens based on whether they appear in the text so far
+      zh_Hans: 根据新 token 是否出现在文本中来对其进行惩罚
+    required: false
+pricing:
+  input: '5.06'
+  output: '5.06'
+  unit: '0.000001'
+  currency: CNY
+

package/dist/llm/moonshot-v1-32k.yaml

@@ -0,0 +1,58 @@
+model: moonshot-v1-32k
+label:
+  en_US: Moonshot v1 32K
+  zh_Hans: 月之暗面 v1 32K
+model_type: llm
+features:
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 32768
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+    default: 0.3
+    min: 0
+    max: 1
+  - name: top_p
+    use_template: top_p
+    default: 1
+    min: 0
+    max: 1
+  - name: max_tokens
+    use_template: max_tokens
+    default: 2048
+    min: 1
+    max: 32768
+  - name: frequency_penalty
+    type: float
+    default: 0
+    min: 0
+    max: 2
+    label:
+      en_US: Frequency Penalty
+      zh_Hans: 频率惩罚
+    help:
+      en_US: Penalize new tokens based on their frequency in the text so far
+      zh_Hans: 根据新 token 在文本中的现有频率对其进行惩罚
+    required: false
+  - name: presence_penalty
+    type: float
+    default: 0
+    min: 0
+    max: 2
+    label:
+      en_US: Presence Penalty
+      zh_Hans: 存在惩罚
+    help:
+      en_US: Penalize new tokens based on whether they appear in the text so far
+      zh_Hans: 根据新 token 是否出现在文本中来对其进行惩罚
+    required: false
+pricing:
+  input: '24.00'
+  output: '24.00'
+  unit: '0.000001'
+  currency: CNY
+

package/dist/llm/moonshot-v1-8k.yaml

@@ -0,0 +1,58 @@
+model: moonshot-v1-8k
+label:
+  en_US: Moonshot v1 8K
+  zh_Hans: 月之暗面 v1 8K
+model_type: llm
+features:
+  - tool-call
+  - multi-tool-call
+  - stream-tool-call
+model_properties:
+  mode: chat
+  context_size: 8192
+parameter_rules:
+  - name: temperature
+    use_template: temperature
+    default: 0.3
+    min: 0
+    max: 1
+  - name: top_p
+    use_template: top_p
+    default: 1
+    min: 0
+    max: 1
+  - name: max_tokens
+    use_template: max_tokens
+    default: 1024
+    min: 1
+    max: 8192
+  - name: frequency_penalty
+    type: float
+    default: 0
+    min: 0
+    max: 2
+    label:
+      en_US: Frequency Penalty
+      zh_Hans: 频率惩罚
+    help:
+      en_US: Penalize new tokens based on their frequency in the text so far
+      zh_Hans: 根据新 token 在文本中的现有频率对其进行惩罚
+    required: false
+  - name: presence_penalty
+    type: float
+    default: 0
+    min: 0
+    max: 2
+    label:
+      en_US: Presence Penalty
+      zh_Hans: 存在惩罚
+    help:
+      en_US: Penalize new tokens based on whether they appear in the text so far
+      zh_Hans: 根据新 token 是否出现在文本中来对其进行惩罚
+    required: false
+pricing:
+  input: '12.00'
+  output: '12.00'
+  unit: '0.000001'
+  currency: CNY
+

package/dist/moonshot.yaml

@@ -0,0 +1,95 @@
+background: '#FFFFFF'
+configurate_methods:
+- predefined-model
+- customizable-model
+description:
+  en_US: Models provided by Moonshot, such as moonshot-v1-8k, moonshot-v1-32k, and
+    moonshot-v1-128k.
+  zh_Hans: Moonshot 提供的模型，例如 moonshot-v1-8k、moonshot-v1-32k 和 moonshot-v1-128k。
+help:
+  title:
+    en_US: Get your API Key from Moonshot
+    zh_Hans: 从 Moonshot 获取 API Key
+  url:
+    en_US: https://platform.moonshot.cn/console/api-keys
+icon_large:
+  en_US: icon_l_en.png
+icon_small:
+  en_US: icon_k2_s_en.png
+label:
+  en_US: Moonshot
+  zh_Hans: 月之暗面
+model_credential_schema:
+  credential_form_schemas:
+  - label:
+      en_US: API Key
+    placeholder:
+      en_US: Enter your API Key
+      zh_Hans: 在此输入您的 API Key
+    required: true
+    type: secret-input
+    variable: api_key
+  - default: '4096'
+    label:
+      en_US: Model context size
+      zh_Hans: 模型上下文长度
+    placeholder:
+      en_US: Enter your Model context size
+      zh_Hans: 在此输入您的模型上下文长度
+    required: true
+    type: text-input
+    variable: context_size
+  - default: '4096'
+    label:
+      en_US: Upper bound for max tokens
+      zh_Hans: 最大 token 上限
+    type: text-input
+    variable: max_tokens
+  - default: no_call
+    label:
+      en_US: Function calling
+    options:
+    - label:
+        en_US: Not supported
+        zh_Hans: 不支持
+      value: no_call
+    - label:
+        en_US: Tool Call
+        zh_Hans: Tool Call
+      value: tool_call
+    required: false
+    type: select
+    variable: function_calling_type
+  model:
+    label:
+      en_US: Model Name
+      zh_Hans: 模型名称
+    placeholder:
+      en_US: Enter your model name
+      zh_Hans: 输入模型名称
+models:
+  llm:
+    position: models/llm/_position.yaml
+    predefined:
+    - models/llm/*.yaml
+provider: moonshot
+provider_credential_schema:
+  credential_form_schemas:
+  - label:
+      en_US: API Key
+    placeholder:
+      en_US: Enter your API Key
+      zh_Hans: 在此输入您的 API Key
+    required: true
+    type: secret-input
+    variable: api_key
+  - label:
+      en_US: API Base
+    placeholder:
+      en_US: Base URL, e.g. https://api.moonshot.cn/v1
+      zh_Hans: Base URL, 如：https://api.moonshot.cn/v1
+    required: false
+    type: text-input
+    variable: endpoint_url
+supported_model_types:
+- llm

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@agentxin-ai/plugin-moonshot",
+  "version": "0.0.2",
+  "author": {
+    "name": "AgentXinAI",
+    "url": "https://agentxinai.cn"
+  },
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentxin-ai/agentxin-plugins.git"
+  },
+  "bugs": {
+    "url": "https://github.com/agentxin-ai/agentxin-plugins/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@agentxin-plugins-starter/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "scripts": {
+    "prepack": "node ./scripts/copy-assets.mjs"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@langchain/openai": "0.6.9",
+    "@metad/contracts": "^3.6.1",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/config": "^4.0.2",
+    "@agentxin-ai/plugin-sdk": "^3.6.1",
+    "chalk": "4.1.2",
+    "zod": "3.25.67"
+  }
+}