dsh-connect-minimaxcode 0.6.8 → 0.7.0

package/lib/index.js

@@ -1,4 +1,5 @@
 import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
@@ -733,6 +734,68 @@ function imageInputHooks(ctx) {
 	};
 }
 //#endregion
+//#region src/failure.ts
+/**
+* Match a shape of the upstream's message.
+*
+* The patterns name *facts* rather than identifiers: "no active subscription"
+* is a fact about the account, "2062" is a number another system chose.
+*/
+const SHAPES = [
+	{
+		kind: "subscription",
+		pattern: /no active (token plan|subscription)|not subscribed|no subscription/i
+	},
+	{
+		kind: "credentials",
+		pattern: /login fail|log ?in fail|unauthorized|invalid api[ _-]?key|api secret key|invalid credential|authentication (failed|error)/i
+	},
+	{
+		kind: "quota",
+		pattern: /insufficient|quota (exceed|exhaust)|balance (is )?(not enough|insufficient)|not enough (credit|balance)|credit (exceed|exhaust)|超出|余额不足/i
+	},
+	{
+		kind: "rate-limited",
+		pattern: /rate ?limit|too many requests|请求过于频繁|频率限制/i
+	},
+	{
+		kind: "parameters",
+		pattern: /invalid (parameter|argument|request|value)|parameter .* (invalid|must be|not allowed)|unsupported (parameter|value|model)|must be (a |an )?(string|number|array|object|boolean)|参数(错误|无效)|不合法/i
+	}
+];
+/**
+* Classify a failure by what the upstream said and how it said it.
+*
+* @param message - The upstream's message, or a description of what went
+*   wrong locally.
+* @param status - The HTTP status the answer arrived with, when there was one.
+* @returns The kind of failure. A failure this plugin does not recognise is
+*   `upstream` rather than a guess: the remedy for an unknown failure is to
+*   show the upstream's words, not to pretend to know better.
+*/
+function classifyFailure(message, status) {
+	if (status === 401 || status === 403) return "credentials";
+	if (status === 429) return "rate-limited";
+	for (const shape of SHAPES) if (shape.pattern.test(message)) return shape.kind;
+	if (status === 400 || status === 422) return "parameters";
+	return "upstream";
+}
+/**
+* How long to hold off before trying the same thing again.
+*
+* A failure that spent nothing has nothing to cool down: the caller fixed
+* something and may try again at once. A failure that happened after the
+* upstream accepted the work may already have been charged for, so a retry
+* right away is another charge — that one waits.
+*
+* @returns The wait in milliseconds, or zero when no wait is warranted.
+*/
+function cooldownFor(failure) {
+	return failure.charged ? COOLDOWN_MS : 0;
+}
+/** The wait after a failure that may already have been charged for. */
+const COOLDOWN_MS = 3e4;
+//#endregion
 //#region src/status-route.ts
 /** Route this plugin mounts, matching its settings card. */
 const MINIMAX_STATUS_PATH = "/plugins/dsh-connect-minimaxcode/status";
@@ -787,6 +850,8 @@ function statusDocument(deps) {
 		...deps.login === void 0 ? {} : { login: deps.login },
 		...deps.usageProfile === void 0 ? {} : { usageProfile: deps.usageProfile },
 		...deps.plan === void 0 ? {} : { plan: deps.plan },
+		...deps.diagnostics === void 0 ? {} : { diagnostics: deps.diagnostics },
+		...deps.showPill === void 0 ? {} : { showPill: deps.showPill },
 		...deps.capability === void 0 ? {} : { capability: deps.capability },
 		...deps.generation === void 0 ? {} : { generation: deps.generation }
 	};
@@ -888,10 +953,27 @@ const VIDEO_DURATIONS = [
 var GenerationError = class extends Error {
 	/** The upstream's own status code, when it gave one. */
 	code;
-	constructor(message, code) {
+	/**
+	* What kind of failure this is, and what it cost.
+	*
+	* The verdict is what a caller acts on: it says whether the remedy is to
+	* change something, to sign in again, or to wait, and whether the work may
+	* already have been charged for.
+	*/
+	verdict;
+	constructor(message, code, verdict) {
 		super(message);
 		this.name = "GenerationError";
 		this.code = code;
+		this.verdict = {
+			kind: verdict?.kind ?? classifyFailure(message, code),
+			charged: verdict?.charged ?? false,
+			upstream: verdict?.upstream ?? (code === void 0 ? void 0 : {
+				status: code,
+				code,
+				message
+			})
+		};
 	}
 };
 /**
@@ -981,12 +1063,38 @@ async function callGeneration(apiKey, url, body, fetchImpl) {
 	try {
 		document = JSON.parse(text);
 	} catch {
-		if (!response.ok) throw new GenerationError(`generation request failed: HTTP ${response.status}`, response.status);
-		throw new GenerationError("generation response was not JSON");
+		if (!response.ok) throw new GenerationError(`generation request failed: HTTP ${response.status}`, response.status, {
+			charged: false,
+			upstream: {
+				status: response.status,
+				message: `generation request failed: HTTP ${response.status}`
+			}
+		});
+		throw new GenerationError("generation response was not JSON", void 0, { charged: false });
+	}
+	if (!response.ok) {
+		const message = readErrorMessage(document) ?? `generation request failed: HTTP ${response.status}`;
+		const code = readErrorCode(document);
+		throw new GenerationError(message, code ?? response.status, {
+			kind: classifyFailure(message, response.status),
+			charged: false,
+			upstream: {
+				status: response.status,
+				code,
+				message
+			}
+		});
 	}
-	if (!response.ok) throw new GenerationError(readErrorMessage(document) ?? `generation request failed: HTTP ${response.status}`, readErrorCode(document) ?? response.status);
 	const refusal = readBodyRefusal(document);
-	if (refusal !== void 0) throw new GenerationError(refusal.message, refusal.code);
+	if (refusal !== void 0) throw new GenerationError(refusal.message, refusal.code, {
+		kind: classifyFailure(refusal.message, response.status),
+		charged: false,
+		upstream: {
+			status: response.status,
+			code: refusal.code,
+			message: refusal.message
+		}
+	});
 	return document ?? {};
 }
 /**
@@ -1092,11 +1200,37 @@ async function queryVideoTask(options) {
 	try {
 		document = JSON.parse(text) ?? {};
 	} catch {
-		throw new GenerationError(`video task query failed: HTTP ${response.status}`, response.status);
+		throw new GenerationError(`video task query failed: HTTP ${response.status}`, response.status, {
+			charged: true,
+			upstream: {
+				status: response.status,
+				message: `video task query failed: HTTP ${response.status}`
+			}
+		});
+	}
+	if (!response.ok) {
+		const message = readErrorMessage(document) ?? `video task query failed: HTTP ${response.status}`;
+		const code = readErrorCode(document);
+		throw new GenerationError(message, code ?? response.status, {
+			kind: classifyFailure(message, response.status),
+			charged: true,
+			upstream: {
+				status: response.status,
+				code,
+				message
+			}
+		});
 	}
-	if (!response.ok) throw new GenerationError(readErrorMessage(document) ?? `video task query failed: HTTP ${response.status}`, readErrorCode(document) ?? response.status);
 	const refusal = readBodyRefusal(document);
-	if (refusal !== void 0) throw new GenerationError(refusal.message, refusal.code);
+	if (refusal !== void 0) throw new GenerationError(refusal.message, refusal.code, {
+		kind: classifyFailure(refusal.message, response.status),
+		charged: true,
+		upstream: {
+			status: response.status,
+			code: refusal.code,
+			message: refusal.message
+		}
+	});
 	const task = document.task ?? document;
 	const content = task.content;
 	const usage = task.usage;
@@ -2642,6 +2776,16 @@ var UsageMeter = class {
 };
 //#endregion
 //#region src/index.ts
+/**
+* MiniMax Code models for DeepSeek Harness.
+*
+* Registers one provider, `minimaxcode`, that serves the models the signed-in
+* MiniMax Code desktop app has access to. Streaming, tool calls, and
+* permissions stay Harness-owned; this plugin only supplies the route and the
+* catalog.
+*
+* @module dsh-connect-minimaxcode
+*/
 /** Loader entry name; also the id the bundle patch inserts. */
 /**
 * Whether a message says the server refused the credential itself.
@@ -2727,6 +2871,13 @@ function apply(ctx) {
 	/** What the card last reported about what the host offered it. */
 	let capability;
 	/**
+	* The most recent upstream failure, in its own words.
+	*
+	* It is kept verbatim and unedited: a report that carries it does not
+	* depend on the reader describing it correctly.
+	*/
+	let lastUpstreamError;
+	/**
 	* Give up on the plugin's own credential after the server refused it.
 	*
 	* A revoked token keeps its expiry date, so every later call would send the
@@ -3024,6 +3175,54 @@ function apply(ctx) {
 		};
 	};
 	/**
+	* This plugin's own version, read from the package it was installed as.
+	*
+	* It is read at runtime rather than written into the bundle, so the number
+	* in a report is the number of the package that is actually installed — a
+	* number baked in at build time would drift from it on the first release
+	* that forgot to rebuild.
+	*
+	* A package root that cannot be read leaves the field out rather than
+	* guessing: a wrong version in a report is worse than no version.
+	*/
+	function readPluginVersion() {
+		try {
+			const manifest = JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
+			return typeof manifest.version === "string" ? manifest.version : void 0;
+		} catch {
+			return;
+		}
+	}
+	/** This plugin's own version, read once when it loads. */
+	const PLUGIN_VERSION = readPluginVersion();
+	/**
+	* The facts a report needs, gathered in one place.
+	*
+	* Every line is a fact about this installation and nothing here changes
+	* anything: the section exists so that a person can copy it into a report
+	* without having to work out what to include.
+	*
+	* The host's own version is not in here, because the host does not offer
+	* it to a plugin — a line that had to be guessed would be worse than no
+	* line at all.
+	*/
+	const buildDiagnostics = async () => {
+		const auth = await buildAuthStatus();
+		return {
+			pluginVersion: PLUGIN_VERSION,
+			region,
+			hosts: [.../* @__PURE__ */ new Set([
+				MINIMAX_GATEWAYS[region],
+				MINIMAX_ACCOUNT_HOSTS[region],
+				MINIMAX_API_HOSTS[region]
+			])],
+			authSource: auth.state === "signed-in" ? buildLoginStatus().source : auth.state,
+			catalogSource: catalog.source,
+			lastUpstreamError,
+			...capability === void 0 ? {} : { capability: capability.findings }
+		};
+	};
+	/**
 	* The plan the account holds, as the card reads it.
 	*
 	* It comes from the same membership answer as the balance, so it is free.
@@ -3188,6 +3387,8 @@ function apply(ctx) {
 			usageProfile: buildUsageProfileStatus(),
 			plan: buildPlanStatus(),
 			capability,
+			diagnostics: await buildDiagnostics(),
+			showPill: pluginState.showPill ?? true,
 			generation: {
 				imageModels: [...IMAGE_MODELS],
 				imageAspectRatios: [...IMAGE_ASPECT_RATIOS],
@@ -3299,6 +3500,22 @@ function apply(ctx) {
 					state: result.state
 				};
 			}
+			case "pillVisible": {
+				const showPill = body.showPill;
+				if (typeof showPill !== "boolean") return {
+					ok: false,
+					error: "showPill 必须是布尔值"
+				};
+				pluginState = {
+					...pluginState,
+					showPill
+				};
+				await writePluginState(pluginState);
+				return {
+					ok: true,
+					showPill
+				};
+			}
 			case "settings": {
 				const autoCheckin = body.autoCheckin;
 				if (typeof autoCheckin !== "boolean") return {
@@ -3334,9 +3551,15 @@ function apply(ctx) {
 	const resolvePlanApiKey = async () => {
 		if (planApiKey !== void 0) return planApiKey;
 		const account = await resolveAccountCredential();
-		if (account.state !== "signed-in") throw new GenerationError("尚未登录 MiniMax Code");
+		if (account.state !== "signed-in") throw new GenerationError("尚未登录 MiniMax Code", void 0, {
+			kind: "credentials",
+			charged: false
+		});
 		const key = await fetchPlanApiKey(account.credential, region);
-		if (key === void 0) throw new GenerationError("账户没有开放平台密钥，无法调用生成接口");
+		if (key === void 0) throw new GenerationError("账户没有开放平台密钥，无法调用生成接口", void 0, {
+			kind: "credentials",
+			charged: false
+		});
 		planApiKey = key;
 		return key;
 	};
@@ -3383,7 +3606,10 @@ function apply(ctx) {
 		const prompt = typeof body.prompt === "string" ? body.prompt.trim() : "";
 		if (prompt.length === 0) return {
 			ok: false,
-			error: "请填写提示词"
+			error: "请填写提示词",
+			kind: "local",
+			charged: false,
+			cooldownMs: 0
 		};
 		const apiKey = await resolvePlanApiKey();
 		if (kind === "video") return {
@@ -3575,11 +3801,19 @@ function apply(ctx) {
 					res.end(JSON.stringify(await runGeneration(body)));
 				} catch (error) {
 					const status = error instanceof GenerationError ? 400 : 500;
+					if (error instanceof GenerationError) lastUpstreamError = error.verdict.upstream?.message ?? error.message;
 					res.writeHead(status, { "Content-Type": "application/json" });
+					const verdict = error instanceof GenerationError ? error.verdict : void 0;
 					res.end(JSON.stringify({
 						ok: false,
 						error: error instanceof Error ? error.message : String(error),
-						...error instanceof GenerationError && error.code !== void 0 ? { code: error.code } : {}
+						...error instanceof GenerationError && error.code !== void 0 ? { code: error.code } : {},
+						...verdict === void 0 ? {} : {
+							kind: verdict.kind,
+							charged: verdict.charged,
+							cooldownMs: cooldownFor(verdict)
+						},
+						...verdict?.upstream === void 0 ? {} : { upstream: verdict.upstream }
 					}));
 				}
 			}

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-minimaxcode",
   "displayName": "DSH Connect MiniMax Code",
   "description": "把本机已登录的 MiniMax Code 桌面 App 模型接入 DeepSeek Harness：零配置、Anthropic Messages 兼容、动态模型目录，并显示积分余额与到期 — bring MiniMax Code desktop app models into DSH with a dynamic model catalog and a credit balance with expiry details.",
-  "version": "0.6.8",
+  "version": "0.7.0",
   "author": "JeffTsuiCUG",
   "contributors": [
     {
@@ -39,7 +39,7 @@
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.2.1-rc.2 <0.3.0-0"
+    "dsh": ">=0.1.6-alpha.2 <0.3.0-0"
   },
   "icon": "./icon.svg",
   "main": "lib/index.js",
@@ -58,6 +58,7 @@
   "files": [
     "lib",
     "locale",
+    "docs",
     "icon.svg",
     "cordis.patch.yml",
     "README.md",
@@ -82,13 +83,13 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.4 <5.0.0",
-    "@deepseek-ai/dsh-atomic-write": ">=0.1.7-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-attachment": ">=0.1.7-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.7-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-llm-pi-ai": ">=0.1.7-rc.1 <0.3.0-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1 <0.3.0-0",
+    "@deepseek-ai/dsh-atomic-write": ">=0.1.6-alpha.2 <0.3.0-0",
+    "@deepseek-ai/dsh-attachment": ">=0.1.6-alpha.2 <0.3.0-0",
+    "@deepseek-ai/dsh-home-paths": ">=0.1.6-alpha.2 <0.3.0-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.6-alpha.2 <0.3.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.6-alpha.2 <0.3.0-0",
+    "@deepseek-ai/dsh-llm-pi-ai": ">=0.1.6-alpha.2 <0.3.0-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.6-alpha.2 <0.3.0-0",
     "@deepseek-ai/schemastery": ">=3.18.4 <4.0.0",
     "@earendil-works/pi-ai": ">=0.85.1"
   },