feat(quota): add Zhipu AI Coding Plan usage tracking (#756)

- Add zhipuai-coding-plan provider for quota monitoring - Support TOKENS_LIMIT (5-hour window) and TIME_LIMIT (MCP tools monthly) - Update UI provider list and TypeScript types - Register provider in server quota registry
2026-04-11 22:15:19 +03:00
parent bdcff3a5b7
commit a3d73a8b67
6 changed files with 268 additions and 0 deletions
@@ -26,6 +26,7 @@ These provider IDs are currently dispatchable via `fetchQuotaForProvider(provide
 | `nano-gpt` | NanoGPT | `providers/nanogpt.js` | `nano-gpt`, `nanogpt`, `nano_gpt` |
 | `openrouter` | OpenRouter | `providers/openrouter.js` | `openrouter` |
 | `zai-coding-plan` | z.ai | `providers/zai.js` | `zai-coding-plan`, `zai`, `z.ai` |
+| `zhipuai-coding-plan` | Zhipu AI Coding Plan | `providers/zhipuai-coding-plan.js` | `zhipuai-coding-plan` |
 | `minimax-coding-plan` | MiniMax Coding Plan (minimax.io) | `providers/minimax-coding-plan.js` | `minimax-coding-plan` |
 | `minimax-cn-coding-plan` | MiniMax Coding Plan (minimaxi.com) | `providers/minimax-cn-coding-plan.js` | `minimax-cn-coding-plan` |
 | `ollama-cloud` | Ollama Cloud | `providers/ollama-cloud.js` | Cookie file at `~/.config/ollama-quota/cookie` (raw session cookie string) |
@@ -16,6 +16,7 @@ import * as nanogpt from './nanogpt.js';
 import * as openai from './openai.js';
 import * as openrouter from './openrouter.js';
 import * as zai from './zai.js';
+import * as zhipuaiCodingPlan from './zhipuai-coding-plan.js';
 import * as minimaxCodingPlan from './minimax-coding-plan.js';
 import * as minimaxCnCodingPlan from './minimax-cn-coding-plan.js';
 import * as ollamaCloud from './ollama-cloud.js';
@@ -46,6 +47,12 @@ const registry = {
    isConfigured: zai.isConfigured,
    fetchQuota: zai.fetchQuota
  },
+  'zhipuai-coding-plan': {
+    providerId: zhipuaiCodingPlan.providerId,
+    providerName: zhipuaiCodingPlan.providerName,
+    isConfigured: zhipuaiCodingPlan.isConfigured,
+    fetchQuota: zhipuaiCodingPlan.fetchQuota
+  },
  'kimi-for-coding': {
    providerId: kimi.providerId,
    providerName: kimi.providerName,
@@ -153,6 +160,7 @@ export const fetchCopilotAddonQuota = copilot.fetchQuotaAddon;
 export const fetchKimiQuota = kimi.fetchQuota;
 export const fetchOpenRouterQuota = openrouter.fetchQuota;
 export const fetchZaiQuota = zai.fetchQuota;
+export const fetchZhipuaiCodingPlanQuota = zhipuaiCodingPlan.fetchQuota;
 export const fetchNanoGptQuota = nanogpt.fetchQuota;
 export const fetchMinimaxCodingPlanQuota = minimaxCodingPlan.fetchQuota;
 export const fetchMinimaxCnCodingPlanQuota = minimaxCnCodingPlan.fetchQuota;
@@ -0,0 +1,133 @@
+/**
+ * Zhipu AI Coding Plan quota fetch
+ *
+ * API: https://open.bigmodel.cn/api/monitor/usage/quota/limit
+ *
+ * Response limits:
+ * - TOKENS_LIMIT: Token usage (5-hour rolling window)
+ * - TIME_LIMIT: MCP tools usage (monthly window)
+ *
+ * @typedef {Object} TokensLimit
+ * @property {string} type - 'TOKENS_LIMIT'
+ * @property {number} [unit]
+ * @property {number} [number]
+ * @property {number} [nextResetTime]
+ * @property {number} [percentage]
+ *
+ * @typedef {Object} McpToolsTimeLimit
+ * @property {string} type - 'TIME_LIMIT'
+ * @property {number} [unit]
+ * @property {number} [number]
+ * @property {number} [usage]
+ * @property {number} [currentValue]
+ * @property {number} [remaining]
+ * @property {number} [percentage]
+ * @property {number} [nextResetTime]
+ * @property {Array<{modelCode: string, usage: number}>} [usageDetails]
+ */
+import { readAuthFile } from '../../opencode/auth.js';
+import {
+  getAuthEntry,
+  normalizeAuthEntry,
+  buildResult,
+  toUsageWindow,
+  resolveWindowSeconds,
+  normalizeTimestamp
+} from '../utils/index.js';
+
+export const providerId = 'zhipuai-coding-plan';
+export const providerName = 'Zhipu AI Coding Plan';
+export const aliases = ['zhipuai-coding-plan'];
+
+export const isConfigured = () => {
+  const auth = readAuthFile();
+  const entry = normalizeAuthEntry(getAuthEntry(auth, aliases));
+  return Boolean(entry?.key || entry?.token);
+};
+
+export const fetchQuota = async () => {
+  const auth = readAuthFile();
+  const entry = normalizeAuthEntry(getAuthEntry(auth, aliases));
+  const apiKey = entry?.key ?? entry?.token;
+
+  if (!apiKey) {
+    return buildResult({
+      providerId,
+      providerName,
+      ok: false,
+      configured: false,
+      error: 'Not configured'
+    });
+  }
+
+  try {
+    const response = await fetch('https://open.bigmodel.cn/api/monitor/usage/quota/limit', {
+      method: 'GET',
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        'Content-Type': 'application/json'
+      }
+    });
+
+    if (!response.ok) {
+      return buildResult({
+        providerId,
+        providerName,
+        ok: false,
+        configured: true,
+        error: `API error: ${response.status}`
+      });
+    }
+
+    const payload = await response.json();
+    const limits = Array.isArray(payload?.data?.limits) ? payload.data.limits : [];
+
+    const tokensLimit = limits.find((limit) => limit?.type === 'TOKENS_LIMIT');
+    const mcpToolsTimeLimit = limits.find((limit) => limit?.type === 'TIME_LIMIT');
+
+    const windows = {};
+
+    // Handle TOKENS_LIMIT (5-hour window for token usage)
+    if (tokensLimit) {
+      const windowSeconds = resolveWindowSeconds(tokensLimit);
+      const resetAt = tokensLimit?.nextResetTime ? normalizeTimestamp(tokensLimit.nextResetTime) : null;
+      const usedPercent = typeof tokensLimit?.percentage === 'number' ? tokensLimit.percentage : null;
+
+      windows['Tokens'] = toUsageWindow({
+        usedPercent,
+        windowSeconds,
+        resetAt
+      });
+    }
+
+    // Handle TIME_LIMIT (MCP tools monthly window)
+    if (mcpToolsTimeLimit) {
+      // TIME_LIMIT unit=5 means 1 month (30 days)
+      const monthSeconds = 30 * 24 * 60 * 60;
+      const resetAt = mcpToolsTimeLimit?.nextResetTime ? normalizeTimestamp(mcpToolsTimeLimit.nextResetTime) : null;
+      const usedPercent = typeof mcpToolsTimeLimit?.percentage === 'number' ? mcpToolsTimeLimit.percentage : null;
+
+      windows['MCP Tools'] = toUsageWindow({
+        usedPercent,
+        windowSeconds: monthSeconds,
+        resetAt
+      });
+    }
+
+    return buildResult({
+      providerId,
+      providerName,
+      ok: true,
+      configured: true,
+      usage: { windows }
+    });
+  } catch (error) {
+    return buildResult({
+      providerId,
+      providerName,
+      ok: false,
+      configured: true,
+      error: error instanceof Error ? error.message : 'Request failed'
+    });
+  }
+};