dsh-custom-api 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 6zev
+
+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

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# DSH Custom API — Model Discovery & Capability Enhancer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<p align="center">
+  <img src="./icon.svg" width="80" height="80" alt="DSH Custom API Logo" />
+</p>
+
+Plugin mở rộng cho **DeepSeek Harness (DSH)**, kết hợp **API Endpoint Metadata**, cơ sở dữ liệu mở **[Models.dev](https://models.dev/)** và bộ quy chuẩn **Vendor Reasoning Ladders** (tham khảo từ [dsh-dc-ai-api](https://github.com/dabeecao/dsh-dc-ai-api)) để tự động khám phá và cấu hình hoàn chỉnh các model từ Custom API:
+- 🖼️ **Vision (Multimodal Image Input)**: Nhận diện model đa phương thức, tự gán `input: ["text", "image"]`.
+- 🧠 **Thinking / Reasoning Effort**: Gán chuẩn thang đo suy nghĩ của từng hãng (`none/low/high/max` cho DeepSeek, 5 mức cho Claude & OpenAI, Flash ladder cho Gemini, v.v.).
+- 🛠️ **Tool Calling**: Đảm bảo tương thích hoàn toàn cho việc gọi Function / Tools của Agent.
+- 📏 **Context Window & Max Tokens**: Trích xuất kích thước ngữ cảnh và kẹp giới hạn token chuẩn xác.
+
+---
+
+## 🚀 Cài Đặt
+
+### 1. Cài đặt qua npm registry
+```bash
+dsh plugin --profile web add dsh-custom-api
+```
+
+### 2. Cài đặt trực tiếp từ GitHub
+```bash
+dsh plugin --profile web add github:6zev/dsh-custom-api
+```
+
+---
+
+## 🌟 Tính Năng Nổi Bật
+
+### 1. Phân Tích Khả Năng Model 3 Tầng (Không Đoán Mò)
+1. **Tier 1 - Trực tiếp từ API Endpoint Metadata**:
+   - Trích xuất các trường `architecture.modality`, `modalities.input`, `supported_parameters`, `capabilities`, `features`, `model_info`.
+2. **Tier 2 - Tra cứu [Models.dev](https://models.dev/) Database**:
+   - Tự động cache và đối soát hơn 4.800+ models từ cơ sở dữ liệu mở quốc tế [Models.dev](https://models.dev/).
+   - Trích xuất chính xác giới hạn context, output tokens, cờ vision và reasoning.
+3. **Tier 3 - Heuristic Fallback**:
+   - Dự phòng thông minh cho các model nội bộ mới ra mắt.
+
+### 2. Thang Đo Reasoning Chuẩn Theo Từng Hãng (Vendor Ladders)
+| Hãng (Family) | Thang đo Thinking Effort | Đặc điểm |
+| :--- | :--- | :--- |
+| **DeepSeek** | `none` / `low` / `high` / `max` | `thinkingFormat: "deepseek"` |
+| **OpenAI (GPT / o-series)** | `low` / `medium` / `high` / `xhigh` / `max` | Chuẩn 5 mức OpenAI |
+| **Google Gemini** | Theo từng model (`GEMINI_LEVELS`): `minimal`, `low`, `medium`, `high` | Không có `max` |
+| **Anthropic Claude** | `low` / `medium` / `high` / `xhigh` / `max` | Chuẩn Claude 3.7+ |
+| **xAI Grok** | `low` / `medium` / `high` / `xhigh` | Không có `off` |
+| **Zhipu GLM** | `none` / `high` / `max` | Chuẩn GLM-5.2+ |
+| **Qwen & Khác** | Toggle only (`off: null`, `high: high`) | Bật/tắt suy nghĩ |
+| **Model thường** | `reasoningEfforts: false` | Tắt hoàn toàn thinking |
+
+### 3. Lọc Bỏ Endpoint Thuần Sinh Ảnh
+- Tự động loại bỏ các endpoint như `gpt-image-*`, `grok-imagine-*`, `flux`, `midjourney` khỏi Chat Catalog để tránh lỗi giao thức.
+
+---
+
+## 📖 Cách Sử Dụng
+
+### 1. Dùng Slash Command trong chat
+- Quét API và cấu hình ngay vào DSH:
+  ```text
+  /discover-models https://api.your-relay.com/v1 sk-xxxx my-provider
+  ```
+- Nâng cấp toàn bộ model hiện có trong DSH:
+  ```text
+  /enhance-models
+  ```
+
+### 2. Dùng Web UI Settings
+1. Vào **Settings -> Models -> Custom model API**.
+2. Nhập URL và API Key, bấm **Fetch models**. Plugin sẽ can thiệp để danh sách model trả về đã nhận diện sẵn Vision và Thinking.
+
+### 3. Giao việc cho AI Agent
+Bạn chỉ cần nhắn cho AI:
+> *"Quét endpoint https://dc-ai.dabeecao.org/v1 với API key ... và lưu vào DSH giúp tôi"*
+
+---
+
+## 🔐 Cấu Hình Trusted Publisher (npm)
+
+Workflow GitHub Actions (`.github/workflows/publish.yml`) đã được tích hợp sẵn quyền OIDC `id-token: write` và cờ `--provenance`.
+
+Để liên kết Trusted Publisher trên npm:
+1. Truy cập: [https://www.npmjs.com/package/dsh-custom-api/access](https://www.npmjs.com/package/dsh-custom-api/access)
+2. Trong phần **Publishing Access** $\rightarrow$ **Trusted Publishers**, chọn **Add Trusted Publisher** $\rightarrow$ **GitHub Actions**.
+3. Điền:
+   - **Repository Owner**: `6zev`
+   - **Repository Name**: `dsh-custom-api`
+   - **Workflow filename**: `publish.yml`
+4. Từ các lần phát hành tiếp theo, GitHub Actions sẽ tự động xác thực và ký số Provenance mà không cần secret token tĩnh.
+
+---
+
+## 📄 Giấy Phép
+
+MIT License © 2026 [6zev](https://github.com/6zev)

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: custom-model-discovery
+      name: dsh-custom-api
+      config: {}

package/icon.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="48" height="48" fill="none">
+  <defs>
+    <linearGradient id="grad1" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#4f46e5" />
+      <stop offset="100%" stop-color="#06b6d4" />
+    </linearGradient>
+  </defs>
+  <rect width="24" height="24" rx="6" fill="url(#grad1)" />
+  <!-- Sparkle / Discovery icon -->
+  <path d="M12 4L13.5 9.5L19 11L13.5 12.5L12 18L10.5 12.5L5 11L10.5 9.5L12 4Z" fill="#ffffff" />
+  <!-- Eye / Vision hint -->
+  <circle cx="17.5" cy="6.5" r="1.5" fill="#fef08a" />
+  <!-- Tool / Brain node -->
+  <circle cx="6.5" cy="17.5" r="1.5" fill="#a7f3d0" />
+</svg>

package/lib/index.js

@@ -0,0 +1,934 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Plugin: @local/dsh-model-discovery
+ * Tự động phát hiện model từ Custom API (OpenAI/Anthropic compatible),
+ * kết hợp API Endpoint Metadata, models.dev và bộ quy chuẩn Reasoning Ladder theo từng hãng (vendor)
+ * lấy cảm hứng từ dsh-dc-ai-api.
+ */
+
+export const name = 'dsh-custom-api';
+export const inject = ['llm', 'tools', 'commands', 'configEditor'];
+
+const CACHE_PATH = '/root/.dsh/storages/models-dev-cache.json';
+const MODELS_DEV_URL = 'https://models.dev/api.json';
+const MODELS_DEV_TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
+
+export const DEFAULT_CONTEXT_WINDOW = 262144;
+export const DEFAULT_MAX_TOKENS = 32768;
+
+/**
+ * Các provider chính thống được ưu tiên lấy metadata chuẩn nhất trong models.dev
+ */
+const PREFERRED_PROVIDERS = new Set([
+  'openai',
+  'anthropic',
+  'google',
+  'deepseek',
+  'xai',
+  'zhipuai',
+  'z-ai',
+  'alibaba',
+  'moonshotai',
+  'minimax',
+  'mistral',
+]);
+
+/** Model id chỉ sinh ảnh (image generation), không phải chat model */
+const IMAGE_MODEL_ID = /(^|[-_.])(image|imagine)([-_.]|$)/i;
+
+/** Cụm từ mô tả chắc chắn hỗ trợ Vision */
+const VISION_DESCRIPTION =
+  /\b(vision|visual|multimodal|image input|input images?|accepts? images?|image understanding|image reasoning|text and image)\b/i;
+
+/** Cụm từ mô tả chắc chắn là text-only (bản finetune bỏ vision) */
+const TEXT_ONLY_DESCRIPTION = /\btext[- ]only\b|\btext input\b/i;
+
+/** Model ID và từ khóa biểu thị Thinking / Reasoning */
+const THINKING_MODEL_ID = /(^|[-_.])(thinking|reasoner|r1|o1|o3|o4|qwq|qvq)([-_.]|$)/i;
+const THINKING_DESCRIPTION =
+  /\b(thinking|reasoning|reasoner|thought|chain[- ]of[- ]thought|deep thinking)\b/i;
+
+/**
+ * Reasoning Ladder chuẩn hóa theo từng hãng từ tài liệu API chính thức:
+ * - DeepSeek: none / low / high / max (api-docs.deepseek.com)
+ * - OpenAI: low / medium / high / xhigh / max (platform.openai.com)
+ * - Gemini: per-model (low/medium/high, Flash dòng 3.x có thêm minimal)
+ * - Claude: low / medium / high / xhigh / max (platform.claude.com)
+ * - Grok: low / medium / high / xhigh (docs.x.ai)
+ * - GLM: none / high / max (docs.z.ai)
+ * - Qwen: toggle only (off: null, high: high)
+ */
+const FAMILY_EFFORTS = Object.freeze({
+  deepseek: { off: 'none', low: 'low', high: 'high', max: 'max' },
+  openai: { low: 'low', medium: 'medium', high: 'high', xhigh: 'xhigh', max: 'max' },
+  gemini: { low: 'low', medium: 'medium', high: 'high' },
+  claude: { low: 'low', medium: 'medium', high: 'high', xhigh: 'xhigh', max: 'max' },
+  grok: { low: 'low', medium: 'medium', high: 'high', xhigh: 'xhigh' },
+  glm: { off: 'none', high: 'high', max: 'max' },
+  qwen: { off: null, high: 'high' },
+  other: { off: null, high: 'high' },
+});
+
+const GEMINI_LEVELS = Object.freeze({
+  'gemini-4-argon': ['low', 'medium', 'high'],
+  'gemini-3.8-flash': ['low', 'medium', 'high'],
+  'gemini-3.6-flash': ['minimal', 'low', 'medium', 'high'],
+  'gemini-3.5-flash-lite': ['minimal', 'low', 'medium', 'high'],
+  'gemini-3.1-pro-preview': ['low', 'medium', 'high'],
+  'gemini-3.1-flash-lite-image': ['minimal', 'high'],
+  'gemini-3-flash-preview': ['minimal', 'low', 'medium', 'high'],
+  'gemini-3-pro-preview': ['low', 'high'],
+  'gemini-2.5-pro': ['low', 'medium', 'high'],
+  'gemini-2.5-flash': ['low', 'medium', 'high'],
+  'gemini-2.5-flash-lite': ['low', 'medium', 'high'],
+  'gemini-2.0-flash-thinking': ['low', 'medium', 'high'],
+});
+
+function geminiEfforts(id) {
+  const norm = String(id).toLowerCase();
+  const documented = GEMINI_LEVELS[norm] || ['low', 'medium', 'high'];
+  const efforts = {};
+  for (const level of documented) efforts[level] = level;
+  return efforts;
+}
+
+export function normalizeModelId(id) {
+  const tail = String(id).toLowerCase().split('/').pop() || '';
+  return tail
+    .replace(/[._]/g, '-')
+    .replace(/[^a-z0-9-]/g, '')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+// In-memory models.dev index
+let exactIndex = new Map();
+let normalizedIndex = new Map();
+let rawModelsDevData = null;
+let isLoaded = false;
+
+function pickBest(candidates) {
+  let best = undefined;
+  let bestScore = -1;
+  for (const candidate of candidates) {
+    let score = 0;
+    if (Array.isArray(candidate.modalities?.input) && candidate.modalities.input.length > 0) score += 4;
+    if (Number.isFinite(candidate.limit?.context) && candidate.limit.context > 0) score += 2;
+    if (Number.isFinite(candidate.limit?.output) && candidate.limit.output > 0) score += 1;
+    if (typeof candidate.reasoning === 'boolean') score += 1;
+    if (PREFERRED_PROVIDERS.has(candidate.provider)) score += 1;
+    if (score > bestScore) {
+      bestScore = score;
+      best = candidate;
+    }
+  }
+  return best;
+}
+
+function buildModelsDevIndex(data) {
+  rawModelsDevData = data;
+  exactIndex = new Map();
+  normalizedIndex = new Map();
+
+  for (const [providerId, provider] of Object.entries(data)) {
+    if (!provider || typeof provider.models !== 'object') continue;
+    for (const [mId, mData] of Object.entries(provider.models || {})) {
+      if (!mData || typeof mData !== 'object') continue;
+      const record = { ...mData, provider: providerId, modelId: mId };
+
+      if (!exactIndex.has(mId)) exactIndex.set(mId, []);
+      exactIndex.get(mId).push(record);
+
+      const norm = normalizeModelId(mId);
+      if (!normalizedIndex.has(norm)) normalizedIndex.set(norm, []);
+      normalizedIndex.get(norm).push(record);
+    }
+  }
+  isLoaded = true;
+}
+
+async function initModelsDevDatabase(logger) {
+  try {
+    if (fs.existsSync(CACHE_PATH)) {
+      const content = fs.readFileSync(CACHE_PATH, 'utf8');
+      const data = JSON.parse(content);
+      buildModelsDevIndex(data);
+      logger?.info(`models.dev index loaded from cache: ${exactIndex.size} model keys`);
+    }
+  } catch (err) {
+    logger?.warn(`Failed to read models.dev cache: ${err.message}`);
+  }
+
+  // Tự động kiểm tra làm mới cache nền
+  try {
+    let shouldFetch = !fs.existsSync(CACHE_PATH);
+    if (!shouldFetch) {
+      const stat = fs.statSync(CACHE_PATH);
+      if (Date.now() - stat.mtimeMs > MODELS_DEV_TTL_MS) shouldFetch = true;
+    }
+
+    if (shouldFetch) {
+      fetch(MODELS_DEV_URL, { signal: AbortSignal.timeout(15000) })
+        .then((res) => {
+          if (!res.ok) throw new Error(`HTTP ${res.status}`);
+          return res.json();
+        })
+        .then((data) => {
+          fs.mkdirSync(path.dirname(CACHE_PATH), { recursive: true });
+          fs.writeFileSync(CACHE_PATH, JSON.stringify(data), 'utf8');
+          buildModelsDevIndex(data);
+          logger?.info('models.dev database refreshed from online registry');
+        })
+        .catch((err) => {
+          logger?.warn(`models.dev background refresh skipped: ${err.message}`);
+        });
+    }
+  } catch (err) {
+    logger?.warn(`models.dev init error: ${err.message}`);
+  }
+}
+
+function lookupModelsDev(id) {
+  if (!isLoaded || !id) return null;
+  const exact = exactIndex.get(id);
+  if (exact && exact.length > 0) return { ...pickBest(exact), matchType: 'exact' };
+
+  const norm = normalizeModelId(id);
+  const normalized = normalizedIndex.get(norm);
+  if (normalized && normalized.length > 0) return { ...pickBest(normalized), matchType: 'normalized' };
+
+  // Fuzzy Token Overlap
+  if (rawModelsDevData) {
+    const tokens = id.toLowerCase().split(/[-_./:]/).filter((t) => t.length >= 3);
+    if (tokens.length >= 1) {
+      for (const [pId, p] of Object.entries(rawModelsDevData)) {
+        for (const [mId, mData] of Object.entries(p.models || {})) {
+          const ms = mId.toLowerCase();
+          const matchedCount = tokens.filter((t) => ms.includes(t)).length;
+          if (matchedCount >= 2 || (tokens.length === 1 && ms.includes(tokens[0]))) {
+            return {
+              ...mData,
+              modelId: mId,
+              provider: pId,
+              matchType: 'fuzzy',
+              matchedFrom: mId,
+            };
+          }
+        }
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Trích xuất trực tiếp capabilities từ API Endpoint Metadata
+ */
+function extractFromApiMetadata(raw) {
+  if (!raw || typeof raw !== 'object') return {};
+  const result = {};
+
+  if (
+    raw.modalities?.input?.includes('image') ||
+    raw.input_modalities?.includes('image') ||
+    (typeof raw.architecture?.modality === 'string' && raw.architecture.modality.includes('image')) ||
+    raw.supports_vision === true ||
+    raw.capabilities?.vision === true ||
+    raw.features?.includes('vision') ||
+    raw.model_info?.supports_vision === true ||
+    raw.attachment === true
+  ) {
+    result.vision = true;
+  }
+
+  if (
+    raw.tool_call === true ||
+    raw.supports_function_calling === true ||
+    raw.capabilities?.tools === true ||
+    raw.features?.includes('tools') ||
+    raw.supported_parameters?.includes('tools') ||
+    raw.supported_parameters?.includes('tool_choice')
+  ) {
+    result.toolCall = true;
+  }
+
+  if (
+    raw.supports_thinking === true ||
+    raw.reasoning === true ||
+    (Array.isArray(raw.reasoning_options) && raw.reasoning_options.length > 0) ||
+    raw.capabilities?.reasoning === true ||
+    raw.features?.includes('reasoning') ||
+    raw.features?.includes('thinking') ||
+    raw.supported_parameters?.includes('reasoning') ||
+    raw.supported_parameters?.includes('include_reasoning') ||
+    raw.supported_parameters?.includes('reasoning_effort')
+  ) {
+    result.reasoning = true;
+  }
+
+  const context =
+    raw.context_length ||
+    raw.context_window ||
+    raw.contextWindow ||
+    raw.max_input_tokens ||
+    raw.max_model_len ||
+    raw.limit?.context;
+
+  if (typeof context === 'number' && Number.isFinite(context) && context > 0) {
+    result.contextWindow = context;
+  }
+
+  const output =
+    raw.max_output_tokens ||
+    raw.max_completion_tokens ||
+    raw.maxTokens ||
+    raw.max_tokens ||
+    raw.limit?.output ||
+    raw.top_provider?.max_completion_tokens;
+
+  if (typeof output === 'number' && Number.isFinite(output) && output > 0) {
+    result.maxTokens = output;
+  }
+
+  return result;
+}
+
+/**
+ * Nhận diện Family của model (theo chuẩn dc-ai-api)
+ */
+function identifyModelFamily(id, dev) {
+  const s = String(id).toLowerCase();
+  const provider = String(dev?.provider || '').toLowerCase();
+
+  if (s.includes('deepseek') || s.startsWith('r1') || s.includes('-r1') || provider === 'deepseek') {
+    return 'deepseek';
+  }
+  if (
+    s.startsWith('gpt-') ||
+    s.includes('-gpt-') ||
+    s.startsWith('o1') ||
+    s.startsWith('o3') ||
+    s.startsWith('o4') ||
+    provider === 'openai'
+  ) {
+    return 'openai';
+  }
+  if (s.includes('gemini') || provider === 'google') return 'gemini';
+  if (s.includes('claude') || provider === 'anthropic') return 'claude';
+  if (s.includes('grok') || provider === 'xai') return 'grok';
+  if (s.includes('glm') || provider === 'zhipuai' || provider === 'z-ai') return 'glm';
+  if (s.includes('qwen') || provider === 'alibaba') return 'qwen';
+
+  return 'other';
+}
+
+/**
+ * Xác định Reasoning Efforts chuẩn hóa
+ */
+function determineReasoningEfforts(id, model, dev, forceThinking) {
+  let isThinking = forceThinking;
+  if (!isThinking) {
+    if (typeof model?.supports_thinking === 'boolean') isThinking = model.supports_thinking;
+    else if (dev?.reasoning === true) isThinking = true;
+    else if (THINKING_MODEL_ID.test(String(id))) isThinking = true;
+    else {
+      const desc = typeof model?.description === 'string' ? model.description : '';
+      isThinking = THINKING_DESCRIPTION.test(desc);
+    }
+  }
+
+  if (!isThinking) return false;
+
+  const family = identifyModelFamily(id, dev);
+  if (family === 'gemini') return geminiEfforts(id);
+  return { ...FAMILY_EFFORTS[family] };
+}
+
+/**
+ * Phát hiện Vision (Image Input)
+ */
+function determineVision(id, model, dev, forceVision) {
+  if (forceVision) return true;
+  const desc = typeof model?.description === 'string' ? model.description : '';
+  if (TEXT_ONLY_DESCRIPTION.test(desc)) return false;
+
+  const inputs = dev?.modalities?.input;
+  if (Array.isArray(inputs) && inputs.length > 0) {
+    return inputs.includes('image');
+  }
+
+  if (dev?.attachment === true) return true;
+  if (VISION_DESCRIPTION.test(desc)) return true;
+
+  // Fallback pattern matching
+  const s = String(id).toLowerCase();
+  return (
+    s.includes('vision') ||
+    s.includes('vl') ||
+    s.includes('4o') ||
+    s.includes('4-turbo') ||
+    s.includes('gemini') ||
+    s.includes('claude') ||
+    s.includes('pixtral') ||
+    s.includes('llava') ||
+    s.includes('omni') ||
+    s.includes('internvl') ||
+    s.includes('multimodal')
+  );
+}
+
+/**
+ * Kiểm tra model có phải thuần Image generation không (không chat được)
+ */
+function isImageGenerationEndpoint(id, dev) {
+  if (IMAGE_MODEL_ID.test(String(id))) return true;
+  const output = dev?.modalities?.output;
+  return Array.isArray(output) && output.length > 0 && output.every((m) => m !== 'text');
+}
+
+/**
+ * Giải quyết và gán năng lực hoàn chỉnh cho một model
+ */
+function resolveCapabilities(rawModel, opts = {}) {
+  const id = typeof rawModel === 'string' ? rawModel : rawModel.id;
+  const dev = lookupModelsDev(id);
+  const apiMeta = extractFromApiMetadata(rawModel);
+
+  const isImageEndpoint = isImageGenerationEndpoint(id, dev);
+  const hasVision = determineVision(id, rawModel, dev, opts.forceVision);
+  const reasoningEfforts = determineReasoningEfforts(id, rawModel, dev, opts.forceThinking);
+
+  // Tool calls
+  const hasToolCall = !isImageEndpoint && (apiMeta.toolCall !== false && dev?.tool_call !== false);
+
+  // Context window & Output limit
+  const contextWindow =
+    apiMeta.contextWindow ||
+    (typeof rawModel === 'object' && rawModel.contextWindow) ||
+    dev?.limit?.context ||
+    DEFAULT_CONTEXT_WINDOW;
+
+  const rawMaxTokens =
+    apiMeta.maxTokens ||
+    (typeof rawModel === 'object' && rawModel.maxTokens) ||
+    dev?.limit?.output ||
+    DEFAULT_MAX_TOKENS;
+
+  // Clamp maxTokens vào contextWindow (tránh lỗi provider từ chối)
+  const maxTokens = Math.min(rawMaxTokens, contextWindow);
+
+  const name =
+    (typeof rawModel === 'object' && (rawModel.name || rawModel.display_name)) ||
+    dev?.name ||
+    id;
+
+  const modelEntry = {
+    id,
+    name,
+    contextWindow,
+    maxTokens,
+    input: hasVision ? ['text', 'image'] : ['text'],
+    reasoningEfforts: reasoningEfforts ? reasoningEfforts : false,
+  };
+
+  const apiProtocol = opts.api || 'openai-completions';
+  if (reasoningEfforts && apiProtocol === 'openai-completions') {
+    const s = id.toLowerCase();
+    const isDeepSeek = s.includes('deepseek') || s.includes('r1');
+    modelEntry.compat = {
+      supportsReasoningEffort: true,
+      ...(isDeepSeek ? { thinkingFormat: 'deepseek' } : {}),
+    };
+  }
+
+  return {
+    modelEntry,
+    hasVision,
+    hasThinking: Boolean(reasoningEfforts),
+    hasToolCall,
+    isImageEndpoint,
+    sources: {
+      matchedInModelsDev: dev ? dev.modelId : null,
+      modelsDevProvider: dev ? dev.provider : null,
+      family: identifyModelFamily(id, dev),
+    },
+  };
+}
+
+async function fetchModelsFromApi(baseURL, apiKey, apiProtocol = 'openai-completions') {
+  let cleanUrl = baseURL.trim().replace(/\/+$/, '');
+  const urlsToTry = cleanUrl.endsWith('/v1')
+    ? [`${cleanUrl}/models`]
+    : [`${cleanUrl}/v1/models`, `${cleanUrl}/models`];
+
+  const headers = { Accept: 'application/json' };
+  if (apiKey) {
+    if (apiProtocol === 'anthropic-messages') {
+      headers['x-api-key'] = apiKey;
+      headers['anthropic-version'] = '2023-06-01';
+    } else {
+      headers['Authorization'] = `Bearer ${apiKey}`;
+    }
+  }
+
+  let lastError = null;
+  for (const url of urlsToTry) {
+    try {
+      const res = await fetch(url, { method: 'GET', headers });
+      if (res.ok) {
+        const data = await res.json();
+        let list = [];
+        if (Array.isArray(data)) list = data;
+        else if (Array.isArray(data.data)) list = data.data;
+        else if (data.models && typeof data.models === 'object') {
+          list = Array.isArray(data.models) ? data.models : Object.values(data.models);
+        }
+        if (list.length > 0) return { url, models: list };
+      } else {
+        lastError = new Error(`HTTP ${res.status} ${res.statusText} from ${url}`);
+      }
+    } catch (err) {
+      lastError = err;
+    }
+  }
+
+  throw new Error(`Không thể lấy danh sách model từ ${baseURL}: ${lastError?.message || 'Không tìm thấy models'}`);
+}
+
+export function apply(ctx) {
+  initModelsDevDatabase(ctx.logger);
+  ctx.logger?.info('Custom Model Discovery Plugin (API Metadata + models.dev + Vendor Reasoning Ladders) active');
+
+  // =========================================================================
+  // 1. Live Hook vào ctx.llm.discoverModels (Web UI Settings -> Models)
+  // =========================================================================
+  if (ctx.llm && typeof ctx.llm.discoverModels === 'function') {
+    const originalDiscoverModels = ctx.llm.discoverModels.bind(ctx.llm);
+    ctx.llm.discoverModels = async function (settingsNs, request, signal) {
+      const discovered = await originalDiscoverModels(settingsNs, request, signal);
+      if (!Array.isArray(discovered)) return discovered;
+
+      return discovered.map((model) => {
+        const cap = resolveCapabilities(model);
+        return {
+          ...model,
+          contextWindow: cap.modelEntry.contextWindow,
+          maxTokens: cap.modelEntry.maxTokens,
+          inputModalities: cap.hasVision ? ['text', 'image'] : ['text'],
+        };
+      });
+    };
+    ctx.effect(() => () => {
+      ctx.llm.discoverModels = originalDiscoverModels;
+    });
+  }
+
+  // =========================================================================
+  // 2. Live Hook vào ctx.llm.resolveModelInfo (Chat / Agent Execution)
+  // =========================================================================
+  if (ctx.llm && typeof ctx.llm.resolveModelInfo === 'function') {
+    const originalResolveModelInfo = ctx.llm.resolveModelInfo.bind(ctx.llm);
+    ctx.llm.resolveModelInfo = async function (provider, model, signal) {
+      const info = await originalResolveModelInfo(provider, model, signal);
+      if (!info) return info;
+
+      const cap = resolveCapabilities(model);
+
+      if (cap.hasThinking && !info.reasoning) {
+        info.reasoning = {
+          efforts: Object.keys(cap.modelEntry.reasoningEfforts)
+            .filter((lvl) => lvl !== 'off')
+            .map((lvl) => ({
+              id: lvl,
+              name: lvl.charAt(0).toUpperCase() + lvl.slice(1),
+            })),
+          defaultEffort: 'medium',
+        };
+      }
+
+      if (cap.hasVision) {
+        const modalities = new Set(info.inputModalities || ['text']);
+        modalities.add('image');
+        info.inputModalities = Array.from(modalities);
+      }
+
+      return info;
+    };
+    ctx.effect(() => () => {
+      ctx.llm.resolveModelInfo = originalResolveModelInfo;
+    });
+  }
+
+  // =========================================================================
+  // 3. Hàm lưu cấu hình vào DSH giữ nguyên compat tùy biến (preserveCompat)
+  // =========================================================================
+  async function updateDshProviderConfig(providerId, providerData) {
+    if (!ctx.configEditor) {
+      throw new Error('configEditor service is not available');
+    }
+
+    const entries = ctx.configEditor.entries();
+    const entry = entries.find((e) => e.options?.id === 'llm-pi-ai' || e.patchId === 'llm-pi-ai' || e.id === 'include:llm-pi-ai');
+    if (!entry) {
+      throw new Error('Không tìm thấy entry include:llm-pi-ai');
+    }
+
+    await ctx.configEditor.edit(entry, (current = {}) => {
+      const next = structuredClone(current);
+      if (!next.providers) next.providers = {};
+      const existing = next.providers[providerId] || {};
+
+      // Giữ lại compat tùy biến của từng model cũ nếu có
+      const existingCompat = new Map();
+      for (const m of existing.models || []) {
+        if (m && m.id && m.compat) existingCompat.set(m.id, m.compat);
+      }
+
+      const mergedModels = (providerData.models || []).map((m) => {
+        if (existingCompat.has(m.id)) {
+          return {
+            ...m,
+            compat: { ...m.compat, ...existingCompat.get(m.id) },
+          };
+        }
+        return m;
+      });
+
+      next.providers[providerId] = {
+        ...existing,
+        ...providerData,
+        models: mergedModels,
+      };
+
+      return next;
+    });
+  }
+
+  // =========================================================================
+  // 4. Tool: discover_custom_models
+  // =========================================================================
+  if (ctx.tools && typeof ctx.tools.register === 'function') {
+    ctx.tools.register({
+      name: 'discover_custom_models',
+      description: 'Tự động quét endpoint Custom API, kết hợp metadata API, models.dev và thang đo reasoning vendor chuẩn để tự gắn Vision, Thinking/Effort và Tool Calls, rồi lưu vào DSH.',
+      parameters: {
+        type: 'object',
+        properties: {
+          baseURL: {
+            type: 'string',
+            description: 'URL của API (ví dụ: https://api.openai.com/v1 hoặc https://dc-ai.dabeecao.org/v1)',
+          },
+          apiKey: {
+            type: 'string',
+            description: 'API key (nếu cần xác thực)',
+          },
+          providerId: {
+            type: 'string',
+            description: 'ID định danh cho provider trong DSH. Nếu để trống sẽ tự tạo từ hostname.',
+          },
+          api: {
+            type: 'string',
+            enum: ['openai-completions', 'openai-responses', 'anthropic-messages'],
+            description: 'Giao thức API. Mặc định là openai-completions.',
+          },
+          forceVision: {
+            type: 'boolean',
+            description: 'Bật Vision cho tất cả model. Mặc định false.',
+          },
+          forceThinking: {
+            type: 'boolean',
+            description: 'Bật Thinking/Reasoning effort cho tất cả model. Mặc định false.',
+          },
+          autoSave: {
+            type: 'boolean',
+            description: 'Tự động lưu vào cấu hình DSH ngay lập tức. Mặc định true.',
+          },
+        },
+        required: ['baseURL'],
+      },
+      output: {
+        schema: { type: 'object' },
+        render(args, value) {
+          return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+        },
+      },
+      async execute(args) {
+        const {
+          baseURL,
+          apiKey = '',
+          api = 'openai-completions',
+          forceVision = false,
+          forceThinking = false,
+          autoSave = true,
+        } = args;
+
+        let providerId = args.providerId;
+        if (!providerId) {
+          try {
+            const parsed = new URL(baseURL);
+            providerId = parsed.hostname.replace(/[^a-zA-Z0-9_-]/g, '_');
+          } catch {
+            providerId = 'custom_api';
+          }
+        }
+
+        const { url: discoveredUrl, models: rawModels } = await fetchModelsFromApi(baseURL, apiKey, api);
+
+        const analyzedModels = [];
+        let visionCount = 0;
+        let thinkingCount = 0;
+        let toolCount = 0;
+        const details = [];
+
+        for (const raw of rawModels) {
+          const cap = resolveCapabilities(raw, {
+            forceVision,
+            forceThinking,
+            api,
+          });
+
+          // Lọc bỏ endpoint thuần sinh ảnh (Flux/Midjourney/DALL-E) khỏi chat catalog
+          if (cap.isImageEndpoint) continue;
+
+          if (cap.hasVision) visionCount++;
+          if (cap.hasThinking) thinkingCount++;
+          if (cap.hasToolCall) toolCount++;
+
+          analyzedModels.push(cap.modelEntry);
+          details.push({
+            id: cap.modelEntry.id,
+            name: cap.modelEntry.name,
+            family: cap.sources.family,
+            vision: cap.hasVision,
+            thinking: cap.hasThinking,
+            reasoningEfforts: cap.modelEntry.reasoningEfforts,
+            toolCall: cap.hasToolCall,
+            contextWindow: cap.modelEntry.contextWindow,
+            maxTokens: cap.modelEntry.maxTokens,
+            modelsDevMatch: cap.sources.matchedInModelsDev,
+          });
+        }
+
+        let saved = false;
+        let saveError = null;
+        if (autoSave) {
+          try {
+            await updateDshProviderConfig(providerId, {
+              api,
+              baseURL: baseURL.trim().replace(/\/+$/, ''),
+              ...(apiKey ? { apiKeyEnv: apiKey } : {}),
+              displayName: providerId,
+              models: analyzedModels,
+            });
+            saved = true;
+          } catch (err) {
+            saveError = err.message;
+          }
+        }
+
+        return {
+          status: 'success',
+          providerId,
+          discoveredEndpoint: discoveredUrl,
+          totalChatModels: analyzedModels.length,
+          visionModelsCount: visionCount,
+          thinkingModelsCount: thinkingCount,
+          toolCallingModelsCount: toolCount,
+          savedToDsh: saved,
+          saveError,
+          models: details,
+        };
+      },
+    });
+
+    // =========================================================================
+    // 5. Tool: enhance_existing_providers
+    // =========================================================================
+    ctx.tools.register({
+      name: 'enhance_existing_providers',
+      description: 'Quét toàn bộ provider hiện có trong DSH, dùng models.dev và vendor reasoning ladder để nâng cấp Vision, Thinking và Tool Calls.',
+      parameters: {
+        type: 'object',
+        properties: {
+          providerId: {
+            type: 'string',
+            description: 'Chỉ định một provider cụ thể, hoặc để trống để nâng cấp tất cả.',
+          },
+          forceVision: {
+            type: 'boolean',
+            description: 'Bật Vision cho tất cả model. Mặc định false.',
+          },
+          forceThinking: {
+            type: 'boolean',
+            description: 'Bật Thinking cho tất cả model. Mặc định false.',
+          },
+        },
+      },
+      output: {
+        schema: { type: 'object' },
+        render(args, value) {
+          return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+        },
+      },
+      async execute(args = {}) {
+        if (!ctx.configEditor) {
+          throw new Error('configEditor service is not available');
+        }
+
+        const entries = ctx.configEditor.entries();
+        const entry = entries.find((e) => e.options?.id === 'llm-pi-ai' || e.patchId === 'llm-pi-ai' || e.id === 'include:llm-pi-ai');
+        if (!entry) {
+          throw new Error('Không tìm thấy entry include:llm-pi-ai');
+        }
+
+        let updatedReport = {};
+
+        await ctx.configEditor.edit(entry, (current = {}) => {
+          const next = structuredClone(current);
+          if (!next.providers) return next;
+
+          const targetProviders = args.providerId ? [args.providerId] : Object.keys(next.providers);
+
+          for (const pid of targetProviders) {
+            const p = next.providers[pid];
+            if (!p || !Array.isArray(p.models)) continue;
+
+            let modified = 0;
+            let visionEnhanced = 0;
+            let thinkingEnhanced = 0;
+
+            p.models = p.models.map((m) => {
+              const cap = resolveCapabilities(m, {
+                forceVision: args.forceVision,
+                forceThinking: args.forceThinking,
+                api: p.api,
+              });
+
+              const merged = {
+                ...cap.modelEntry,
+                ...m,
+                input: (cap.hasVision || m.input?.includes('image')) ? ['text', 'image'] : (m.input || ['text']),
+                contextWindow: m.contextWindow || cap.modelEntry.contextWindow,
+                maxTokens: Math.min(m.maxTokens || cap.modelEntry.maxTokens, m.contextWindow || cap.modelEntry.contextWindow),
+              };
+
+              if (cap.hasThinking && !merged.reasoningEfforts) {
+                merged.reasoningEfforts = cap.modelEntry.reasoningEfforts;
+                if (p.api === 'openai-completions') {
+                  const s = m.id.toLowerCase();
+                  const isDeepSeek = s.includes('deepseek') || s.includes('r1');
+                  merged.compat = {
+                    ...merged.compat,
+                    supportsReasoningEffort: true,
+                    ...(isDeepSeek ? { thinkingFormat: 'deepseek' } : {}),
+                  };
+                }
+              }
+
+              if (merged.input.includes('image')) visionEnhanced++;
+              if (merged.reasoningEfforts) thinkingEnhanced++;
+              modified++;
+              return merged;
+            });
+
+            updatedReport[pid] = {
+              totalModels: p.models.length,
+              enhancedModels: modified,
+              visionModels: visionEnhanced,
+              thinkingModels: thinkingEnhanced,
+            };
+          }
+
+          return next;
+        });
+
+        return {
+          status: 'success',
+          updatedReport,
+        };
+      },
+    });
+  }
+
+  // =========================================================================
+  // 6. Slash Commands: /discover-models và /enhance-models
+  // =========================================================================
+  if (ctx.commands && typeof ctx.commands.register === 'function') {
+    ctx.commands.register({
+      name: 'discover-models',
+      description: 'Tự động phát hiện model từ Custom API (API metadata + models.dev + Vendor Ladders)',
+      input: {
+        hint: '<baseURL> [apiKey] [providerId]',
+      },
+      async handler(invocation) {
+        const parts = invocation.rawInput.trim().split(/\s+/).filter(Boolean);
+        if (parts.length === 0) {
+          return {
+            kind: 'error',
+            text: 'Cú pháp: /discover-models <baseURL> [apiKey] [providerId]\nVí dụ: /discover-models https://dc-ai.dabeecao.org/v1 dc_xxxx dc-ai',
+          };
+        }
+
+        const baseURL = parts[0];
+        const apiKey = parts[1] || '';
+        const providerId = parts[2] || '';
+
+        try {
+          const tool = ctx.tools.get('discover_custom_models');
+          if (!tool) throw new Error('Tool discover_custom_models chưa sẵn sàng');
+
+          const result = await ctx.tools.execute({
+            callId: `cmd_${Date.now()}`,
+            name: 'discover_custom_models',
+            arguments: { baseURL, apiKey, providerId, autoSave: true },
+            signal: invocation.signal,
+          });
+
+          if (result.isError) {
+            return { kind: 'error', text: `Thất bại: ${result.error?.message || 'Lỗi không xác định'}` };
+          }
+
+          const val = result.value;
+          return {
+            kind: 'success',
+            text: `✅ Đã quét thành công ${val.totalChatModels} chat models từ ${val.discoveredEndpoint}!\n- 🖼️ Vision models: ${val.visionModelsCount}\n- 🧠 Thinking models: ${val.thinkingModelsCount}\n- 🛠️ Tool Calling: ${val.toolCallingModelsCount}\n- 💾 Đã lưu vào DSH: ${val.savedToDsh ? 'Thành công (ID: ' + val.providerId + ')' : 'Lỗi: ' + val.saveError}`,
+          };
+        } catch (err) {
+          return { kind: 'error', text: `Lỗi: ${err.message}` };
+        }
+      },
+    });
+
+    ctx.commands.register({
+      name: 'enhance-models',
+      description: 'Nâng cấp toàn bộ model hiện có trong DSH với thang đo Vendor Thinking & Vision',
+      async handler(invocation) {
+        try {
+          const tool = ctx.tools.get('enhance_existing_providers');
+          if (!tool) throw new Error('Tool enhance_existing_providers chưa sẵn sàng');
+
+          const result = await ctx.tools.execute({
+            callId: `cmd_${Date.now()}`,
+            name: 'enhance_existing_providers',
+            arguments: {},
+            signal: invocation.signal,
+          });
+
+          if (result.isError) {
+            return { kind: 'error', text: `Thất bại: ${result.error?.message || 'Lỗi không xác định'}` };
+          }
+
+          return {
+            kind: 'success',
+            text: `✅ Đã nâng cấp các provider hiện có qua models.dev & vendor ladders thành công!\n${JSON.stringify(result.value.updatedReport, null, 2)}`,
+          };
+        } catch (err) {
+          return { kind: 'error', text: `Lỗi: ${err.message}` };
+        }
+      },
+    });
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Model Auto-Discovery & Capability Enhancer",
+    "description": "Automatically discovers custom API models and configures vision, reasoning/thinking effort, and tool calls."
+  }
+}

package/locale/vi.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Tự động phát hiện & cấu hình Model Custom API",
+    "description": "Tự động phát hiện model từ Custom API và tự gắn vision, thinking/reasoning effort và tool calls."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "自定义 API 模型自动发现与能力增强",
+    "description": "自动发现自定义 API 端点模型，并自动挂载视觉 (Vision)、思考力度 (Thinking/Reasoning Effort) 与工具调用 (Tool Calls)。"
+  }
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "dsh-custom-api",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "DeepSeek Harness plugin: Auto-discovery, Vision, Reasoning/Thinking Effort & Tool Calls for Custom Model APIs",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "lib",
+    "locale",
+    "cordis.patch.yml",
+    "icon.svg",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "custom-api",
+    "models-dev",
+    "ai-models",
+    "vision",
+    "thinking-effort",
+    "reasoning"
+  ],
+  "author": "6zev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/6zev/dsh-custom-api.git"
+  },
+  "homepage": "https://github.com/6zev/dsh-custom-api#readme",
+  "bugs": {
+    "url": "https://github.com/6zev/dsh-custom-api/issues"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}