dsh-subscriptions 0.1.1 → 0.1.2

package/lib/providers/minimax-usage.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderUsage } from './common.js';
+/** MiniMax subscription quota, not the balance API for sk-api-* inference keys. */
+export declare function fetchMiniMaxUsage(key: string, region: 'global' | 'cn', http?: typeof fetch, signal?: AbortSignal): Promise<ProviderUsage>;

package/lib/providers/minimax-usage.js

@@ -0,0 +1,55 @@
+/** MiniMax subscription quota, not the balance API for sk-api-* inference keys. */
+export async function fetchMiniMaxUsage(key, region, http = fetch, signal) {
+    if (key.startsWith('sk-api-'))
+        throw new Error('MiniMax requires a subscription key, not a pay-as-you-go key');
+    const response = await http(`https://www.minimax.${region === 'cn' ? 'cn' : 'io'}/v1/token_plan/remains`, {
+        headers: { authorization: `Bearer ${key}`, 'content-type': 'application/json' },
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (!response.ok)
+        throw new Error(`MiniMax usage endpoint returned HTTP ${response.status}`);
+    const body = await response.json();
+    if ((body?.base_resp?.status_code !== undefined && body.base_resp.status_code !== 0) || !Array.isArray(body?.model_remains)) {
+        throw new Error('MiniMax usage response failed or has no quota records');
+    }
+    const windows = [];
+    for (const raw of body.model_remains) {
+        if (raw === null || typeof raw !== 'object')
+            continue;
+        const row = raw;
+        if (typeof row.model_name !== 'string')
+            continue;
+        for (const [prefix, startKey, endKey, fallback] of [
+            ['current_interval', 'start_time', 'end_time', 'session'],
+            ['current_weekly', 'weekly_start_time', 'weekly_end_time', 'weekly'],
+        ]) {
+            const status = row[`${prefix}_status`];
+            if (status === 3)
+                continue; // Unlimited pools cannot have a finite percentage.
+            const remaining = row[`${prefix}_remaining_percent`];
+            const boost = prefix === 'current_weekly' ? row.weekly_boost_permille ?? 1000 : 1000;
+            if (typeof boost !== 'number' || !Number.isFinite(boost) || boost <= 0)
+                continue;
+            const total = row[`${prefix}_total_count`];
+            const count = row[`${prefix}_usage_count`];
+            if (typeof total !== 'number' || !Number.isFinite(total) || total <= 0)
+                continue;
+            // Official CLI compatibility: absent percentages use legacy remaining counts.
+            const usedPercent = typeof remaining === 'number' ? 100 - remaining * boost / 1000
+                : typeof total === 'number' && total > 0 && typeof count === 'number' ? (1 - count / total) * 100 : undefined;
+            if (usedPercent === undefined || !Number.isFinite(usedPercent) || usedPercent < 0 || usedPercent > 100)
+                continue;
+            const start = row[startKey];
+            const end = row[endKey];
+            const validBounds = typeof start === 'number' && Number.isFinite(start) && start > 0
+                && typeof end === 'number' && Number.isFinite(end) && end > start;
+            windows.push({ kind: fallback === 'session' && validBounds && end - start !== 18_000_000 ? 'other' : fallback,
+                scope: row.model_name, usedPercent,
+                ...(validBounds ? { startsAt: start, resetsAt: end } : {}),
+            });
+        }
+    }
+    if (!windows.length)
+        throw new Error('MiniMax has no supported finite quota windows');
+    return { supported: true, plan: 'MiniMax', windows };
+}

package/lib/providers/pool-usage.js

@@ -107,7 +107,7 @@ export class PoolUsageTracker {
                 // every display surface — this is what was previously showing, so
                 // keep showing it (even through a forced refresh: retrying past the
                 // cooldown is exactly the retry storm `cooldownMs` exists to avoid).
-                return entry.lastSnapshot;
+                return { ...entry.lastSnapshot, stale: true };
             }
             else {
                 throw entry.error;
@@ -122,7 +122,7 @@ export class PoolUsageTracker {
             // snapshot was on record before it ran onto the new failure entry.
             const failed = this.entries.get(key);
             if (failed?.snapshot === undefined && failed?.lastSnapshot !== undefined)
-                return failed.lastSnapshot;
+                return { ...failed.lastSnapshot, stale: true };
             throw error;
         }
     }
@@ -155,8 +155,10 @@ export class PoolUsageTracker {
             // consecutive failure, even though nothing newer ever replaced it.
             const prior = this.entries.get(key);
             const lastSnapshot = prior?.snapshot ?? prior?.lastSnapshot;
-            pending = fetcher().then((snapshot) => {
-                this.entries.set(key, { snapshot, at: Date.now() });
+            pending = fetcher().then((value) => {
+                const at = Date.now();
+                const snapshot = { ...value, observedAt: at, stale: false };
+                this.entries.set(key, { snapshot, at });
                 return snapshot;
             }, (error) => {
                 if (!isMissingOrInvalidCredential(error)) {

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DSH Subscriptions",
+    "description": "Unified subscription providers and usage dashboard for DeepSeek Harness"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "订阅中心",
+    "description": "将 ChatGPT、Claude、Grok 等订阅制模型接入 DeepSeek Harness，附带用量看板"
+  }
+}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "dsh-subscriptions",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Unified subscription providers and usage dashboard for DeepSeek Harness",
+  "icon": "./icon.svg",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -43,12 +44,15 @@
       "types": "./vendor/cursor/index.d.ts",
       "default": "./vendor/cursor/index.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "files": [
     "lib",
     "vendor/cursor",
-    "cordis.patch.yml"
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg"
   ],
   "dsh": {
     "bundle": {