gsd-pi 2.71.0 → 2.72.0-dev.3118184

package/packages/pi-ai/dist/utils/oauth/github-copilot.test.js

@@ -0,0 +1,57 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { githubCopilotOAuthProvider } from "./github-copilot.js";
+function makeModel(provider, id) {
+    return {
+        id,
+        name: id,
+        api: "openai-completions",
+        provider,
+        baseUrl: `${provider}:`,
+        reasoning: false,
+        input: ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 128000,
+        maxTokens: 16384,
+    };
+}
+function makeCredentials(overrides = {}) {
+    return {
+        type: "oauth",
+        access: "copilot-token",
+        refresh: "refresh-token",
+        expires: Date.now() + 60_000,
+        ...overrides,
+    };
+}
+test("githubCopilotOAuthProvider.modifyModels filters unavailable copilot models (#3849)", () => {
+    const models = [
+        makeModel("github-copilot", "gpt-5"),
+        makeModel("github-copilot", "claude-sonnet-4"),
+        makeModel("openai", "gpt-4.1"),
+    ];
+    assert.ok(githubCopilotOAuthProvider.modifyModels, "github copilot provider should expose modifyModels");
+    const modified = githubCopilotOAuthProvider.modifyModels(models, makeCredentials({
+        modelLimits: {
+            "gpt-5": { contextWindow: 256000, maxTokens: 32000 },
+        },
+    }));
+    assert.deepEqual(modified.map((model) => `${model.provider}/${model.id}`), ["github-copilot/gpt-5", "openai/gpt-4.1"]);
+    const copilotModel = modified.find((model) => model.provider === "github-copilot" && model.id === "gpt-5");
+    assert.ok(copilotModel, "available copilot model should remain");
+    assert.equal(copilotModel.contextWindow, 256000);
+    assert.equal(copilotModel.maxTokens, 32000);
+    assert.match(copilotModel.baseUrl, /githubcopilot\.com/);
+});
+test("githubCopilotOAuthProvider.modifyModels keeps all copilot models when limits are unavailable", () => {
+    const models = [
+        makeModel("github-copilot", "gpt-5"),
+        makeModel("github-copilot", "claude-sonnet-4"),
+    ];
+    assert.ok(githubCopilotOAuthProvider.modifyModels, "github copilot provider should expose modifyModels");
+    const modified = githubCopilotOAuthProvider.modifyModels(models, makeCredentials());
+    assert.equal(modified.length, 2, "lack of limits should not hide every copilot model");
+    assert.ok(modified.every((model) => model.provider === "github-copilot"));
+    assert.ok(modified.every((model) => model.baseUrl.includes("githubcopilot.com")));
+});
+//# sourceMappingURL=github-copilot.test.js.map

package/packages/pi-ai/dist/utils/oauth/github-copilot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-copilot.test.js","sourceRoot":"","sources":["../../../src/utils/oauth/github-copilot.test.ts"],"names":[],"mappings":"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","sourcesContent":["import assert from \"node:assert/strict\";\nimport test from \"node:test\";\n\nimport type { Api, Model } from \"../../types.js\";\nimport type { OAuthCredentials } from \"./index.js\";\nimport { githubCopilotOAuthProvider } from \"./github-copilot.js\";\n\nfunction makeModel(provider: string, id: string): Model<Api> {\n\treturn {\n\t\tid,\n\t\tname: id,\n\t\tapi: \"openai-completions\",\n\t\tprovider,\n\t\tbaseUrl: `${provider}:`,\n\t\treasoning: false,\n\t\tinput: [\"text\"],\n\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\t\tcontextWindow: 128000,\n\t\tmaxTokens: 16384,\n\t};\n}\n\nfunction makeCredentials(overrides: Partial<OAuthCredentials & { modelLimits?: Record<string, { contextWindow: number; maxTokens: number }> }> = {}) {\n\treturn {\n\t\ttype: \"oauth\" as const,\n\t\taccess: \"copilot-token\",\n\t\trefresh: \"refresh-token\",\n\t\texpires: Date.now() + 60_000,\n\t\t...overrides,\n\t};\n}\n\ntest(\"githubCopilotOAuthProvider.modifyModels filters unavailable copilot models (#3849)\", () => {\n\tconst models = [\n\t\tmakeModel(\"github-copilot\", \"gpt-5\"),\n\t\tmakeModel(\"github-copilot\", \"claude-sonnet-4\"),\n\t\tmakeModel(\"openai\", \"gpt-4.1\"),\n\t];\n\n\tassert.ok(githubCopilotOAuthProvider.modifyModels, \"github copilot provider should expose modifyModels\");\n\tconst modified = githubCopilotOAuthProvider.modifyModels(models, makeCredentials({\n\t\tmodelLimits: {\n\t\t\t\"gpt-5\": { contextWindow: 256000, maxTokens: 32000 },\n\t\t},\n\t}));\n\n\tassert.deepEqual(\n\t\tmodified.map((model) => `${model.provider}/${model.id}`),\n\t\t[\"github-copilot/gpt-5\", \"openai/gpt-4.1\"],\n\t);\n\n\tconst copilotModel = modified.find((model) => model.provider === \"github-copilot\" && model.id === \"gpt-5\");\n\tassert.ok(copilotModel, \"available copilot model should remain\");\n\tassert.equal(copilotModel.contextWindow, 256000);\n\tassert.equal(copilotModel.maxTokens, 32000);\n\tassert.match(copilotModel.baseUrl, /githubcopilot\\.com/);\n});\n\ntest(\"githubCopilotOAuthProvider.modifyModels keeps all copilot models when limits are unavailable\", () => {\n\tconst models = [\n\t\tmakeModel(\"github-copilot\", \"gpt-5\"),\n\t\tmakeModel(\"github-copilot\", \"claude-sonnet-4\"),\n\t];\n\n\tassert.ok(githubCopilotOAuthProvider.modifyModels, \"github copilot provider should expose modifyModels\");\n\tconst modified = githubCopilotOAuthProvider.modifyModels(models, makeCredentials());\n\n\tassert.equal(modified.length, 2, \"lack of limits should not hide every copilot model\");\n\tassert.ok(modified.every((model) => model.provider === \"github-copilot\"));\n\tassert.ok(modified.every((model) => model.baseUrl.includes(\"githubcopilot.com\")));\n});\n"]}

package/packages/pi-ai/src/env-api-keys.ts

@@ -137,6 +137,7 @@ export function getEnvApiKey(provider: any): string | undefined {
 		"opencode-go": "OPENCODE_API_KEY",
 		"kimi-coding": "KIMI_API_KEY",
 		"alibaba-coding-plan": "ALIBABA_API_KEY",
+		"alibaba-dashscope": "DASHSCOPE_API_KEY",
 		ollama: "OLLAMA_API_KEY",
 		"ollama-cloud": "OLLAMA_API_KEY",
 		"custom-openai": "CUSTOM_OPENAI_API_KEY",

package/packages/pi-ai/src/models.custom.ts

@@ -170,6 +170,104 @@ export const CUSTOM_MODELS = {
 		} satisfies Model<"openai-completions">,
 	},
 
+	// ─── Alibaba DashScope ───────────────────────────────────────────────
+	// Regular DashScope API for users without the Coding Plan.
+	// Uses the international OpenAI-compatible endpoint.
+	// Requires DASHSCOPE_API_KEY from: dashscope.console.aliyun.com
+	// Pricing: https://www.alibabacloud.com/help/en/model-studio/model-pricing
+	"alibaba-dashscope": {
+		"qwen3-max": {
+			id: "qwen3-max",
+			name: "Qwen3 Max",
+			api: "openai-completions",
+			provider: "alibaba-dashscope",
+			baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+			reasoning: true,
+			input: ["text"],
+			cost: {
+				input: 1.2,
+				output: 6,
+				cacheRead: 0,
+				cacheWrite: 0,
+			},
+			contextWindow: 1000000,
+			maxTokens: 32768,
+			compat: { thinkingFormat: "qwen", supportsDeveloperRole: false },
+		} satisfies Model<"openai-completions">,
+		"qwen3.5-plus": {
+			id: "qwen3.5-plus",
+			name: "Qwen3.5 Plus",
+			api: "openai-completions",
+			provider: "alibaba-dashscope",
+			baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+			reasoning: true,
+			input: ["text"],
+			cost: {
+				input: 0.4,
+				output: 1.2,
+				cacheRead: 0,
+				cacheWrite: 0,
+			},
+			contextWindow: 1000000,
+			maxTokens: 65536,
+			compat: { thinkingFormat: "qwen", supportsDeveloperRole: false },
+		} satisfies Model<"openai-completions">,
+		"qwen3.5-flash": {
+			id: "qwen3.5-flash",
+			name: "Qwen3.5 Flash",
+			api: "openai-completions",
+			provider: "alibaba-dashscope",
+			baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+			reasoning: false,
+			input: ["text"],
+			cost: {
+				input: 0.1,
+				output: 0.4,
+				cacheRead: 0,
+				cacheWrite: 0,
+			},
+			contextWindow: 1000000,
+			maxTokens: 32768,
+			compat: { supportsDeveloperRole: false },
+		} satisfies Model<"openai-completions">,
+		"qwen3-coder-plus": {
+			id: "qwen3-coder-plus",
+			name: "Qwen3 Coder Plus",
+			api: "openai-completions",
+			provider: "alibaba-dashscope",
+			baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+			reasoning: false,
+			input: ["text"],
+			cost: {
+				input: 1.0,
+				output: 5.0,
+				cacheRead: 0,
+				cacheWrite: 0,
+			},
+			contextWindow: 1000000,
+			maxTokens: 65536,
+			compat: { supportsDeveloperRole: false },
+		} satisfies Model<"openai-completions">,
+		"qwen3.6-plus": {
+			id: "qwen3.6-plus",
+			name: "Qwen3.6 Plus",
+			api: "openai-completions",
+			provider: "alibaba-dashscope",
+			baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+			reasoning: true,
+			input: ["text"],
+			cost: {
+				input: 0.5,
+				output: 3.0,
+				cacheRead: 0,
+				cacheWrite: 0,
+			},
+			contextWindow: 1000000,
+			maxTokens: 65536,
+			compat: { thinkingFormat: "qwen", supportsDeveloperRole: false },
+		} satisfies Model<"openai-completions">,
+	},
+
 	// ─── Z.AI (GLM-5.1) ────────────────────────────────────────────────
 	// GLM-5.1 is the latest GLM model from Zhipu AI, not yet in models.dev.
 	// Uses the Z.AI Coding Plan endpoint (OpenAI-compatible).

package/packages/pi-ai/src/models.generated.test.ts

@@ -0,0 +1,373 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { MODELS } from "./models.generated.js";
+import { getModel, getModels, getProviders } from "./models.js";
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Regression: qwen/qwen3.6-plus missing from OpenRouter (issue #3582)
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("regression #3582 — qwen/qwen3.6-plus available via openrouter", () => {
+	it("qwen/qwen3.6-plus exists in MODELS['openrouter']", () => {
+		const model = MODELS["openrouter"]["qwen/qwen3.6-plus" as keyof (typeof MODELS)["openrouter"]];
+		assert.ok(model, "qwen/qwen3.6-plus must be present in MODELS.openrouter");
+	});
+
+	it("qwen/qwen3.6-plus is accessible via getModel()", () => {
+		const model = getModel("openrouter", "qwen/qwen3.6-plus" as any);
+		assert.ok(model, "getModel('openrouter', 'qwen/qwen3.6-plus') must return a model");
+	});
+
+	it("qwen/qwen3.6-plus has id matching its registry key", () => {
+		const model = getModel("openrouter", "qwen/qwen3.6-plus" as any);
+		assert.equal(model.id, "qwen/qwen3.6-plus");
+	});
+
+	it("qwen/qwen3.6-plus has provider set to openrouter", () => {
+		const model = getModel("openrouter", "qwen/qwen3.6-plus" as any);
+		assert.equal(model.provider, "openrouter");
+	});
+
+	it("qwen/qwen3.6-plus has reasoning enabled", () => {
+		const model = getModel("openrouter", "qwen/qwen3.6-plus" as any);
+		assert.equal(model.reasoning, true, "Qwen3.6 Plus is a reasoning model");
+	});
+
+	it("qwen/qwen3.6-plus has 1M context window", () => {
+		const model = getModel("openrouter", "qwen/qwen3.6-plus" as any);
+		assert.equal(model.contextWindow, 1_000_000);
+	});
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Regression: z-ai/glm-5.1 missing from OpenRouter (issue #4069)
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("regression #4069 — z-ai/glm-5.1 available via openrouter", () => {
+	it("z-ai/glm-5.1 exists in MODELS['openrouter']", () => {
+		const model = MODELS["openrouter"]["z-ai/glm-5.1" as keyof (typeof MODELS)["openrouter"]];
+		assert.ok(model, "z-ai/glm-5.1 must be present in MODELS.openrouter");
+	});
+
+	it("z-ai/glm-5.1 is accessible via getModel()", () => {
+		const model = getModel("openrouter", "z-ai/glm-5.1" as any);
+		assert.ok(model, "getModel('openrouter', 'z-ai/glm-5.1') must return a model");
+	});
+
+	it("z-ai/glm-5.1 has id matching its registry key", () => {
+		const model = getModel("openrouter", "z-ai/glm-5.1" as any);
+		assert.equal(model.id, "z-ai/glm-5.1");
+	});
+
+	it("z-ai/glm-5.1 has provider set to openrouter", () => {
+		const model = getModel("openrouter", "z-ai/glm-5.1" as any);
+		assert.equal(model.provider, "openrouter");
+	});
+
+	it("z-ai/glm-5.1 has a positive context window", () => {
+		const model = getModel("openrouter", "z-ai/glm-5.1" as any);
+		assert.ok(model.contextWindow > 0);
+	});
+
+	it("z-ai/glm-5.1 uses the OpenRouter base URL", () => {
+		const model = getModel("openrouter", "z-ai/glm-5.1" as any);
+		assert.equal(model.baseUrl, "https://openrouter.ai/api/v1");
+	});
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Structural invariants — every model in MODELS must be well-formed
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("MODELS structural invariants", () => {
+	type ModelEntry = { providerKey: string; modelKey: string; model: Record<string, unknown> };
+
+	function allModels(): ModelEntry[] {
+		const entries: ModelEntry[] = [];
+		for (const [providerKey, providerModels] of Object.entries(MODELS)) {
+			for (const [modelKey, model] of Object.entries(providerModels)) {
+				entries.push({ providerKey, modelKey, model: model as Record<string, unknown> });
+			}
+		}
+		return entries;
+	}
+
+	it("every model's id field matches its key in MODELS", () => {
+		const mismatches: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (model["id"] !== modelKey) {
+				mismatches.push(`${providerKey}/${modelKey}: id="${model["id"]}"`);
+			}
+		}
+		assert.deepEqual(mismatches, [], `Models where 'id' doesn't match registry key:\n  ${mismatches.join("\n  ")}`);
+	});
+
+	it("every model's provider field matches its parent provider key", () => {
+		const mismatches: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (model["provider"] !== providerKey) {
+				mismatches.push(`${providerKey}/${modelKey}: provider="${model["provider"]}"`);
+			}
+		}
+		assert.deepEqual(mismatches, [], `Models where 'provider' doesn't match parent key:\n  ${mismatches.join("\n  ")}`);
+	});
+
+	it("every model has a non-empty string name", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (typeof model["name"] !== "string" || model["name"].trim() === "") {
+				invalid.push(`${providerKey}/${modelKey}`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with missing or empty name:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model has a non-empty string api", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (typeof model["api"] !== "string" || model["api"].trim() === "") {
+				invalid.push(`${providerKey}/${modelKey}`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with missing or empty api:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model's baseUrl starts with https:// (or is empty for azure-openai-responses)", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (providerKey === "azure-openai-responses") continue;
+			const url = model["baseUrl"];
+			if (typeof url !== "string" || !url.startsWith("https://")) {
+				invalid.push(`${providerKey}/${modelKey}: baseUrl="${url}"`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with missing or non-HTTPS baseUrl:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("azure-openai-responses models have an empty baseUrl (runtime-configured)", () => {
+		const models = getModels("azure-openai-responses");
+		assert.ok(models.length > 0, "azure-openai-responses must have at least one model");
+		for (const model of models) {
+			assert.equal(model.baseUrl, "", `azure-openai-responses/${model.id} should have empty baseUrl`);
+		}
+	});
+
+	it("every model has a boolean reasoning field", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (typeof model["reasoning"] !== "boolean") {
+				invalid.push(`${providerKey}/${modelKey}: reasoning=${model["reasoning"]}`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with non-boolean reasoning:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model has a non-empty input array", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			const input = model["input"];
+			if (!Array.isArray(input) || input.length === 0) {
+				invalid.push(`${providerKey}/${modelKey}`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with missing or empty input array:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model has a positive contextWindow", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			const cw = model["contextWindow"];
+			if (typeof cw !== "number" || cw <= 0 || !Number.isFinite(cw)) {
+				invalid.push(`${providerKey}/${modelKey}: contextWindow=${cw}`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with invalid contextWindow:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model has a positive maxTokens", () => {
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			const mt = model["maxTokens"];
+			if (typeof mt !== "number" || mt <= 0 || !Number.isFinite(mt)) {
+				invalid.push(`${providerKey}/${modelKey}: maxTokens=${mt}`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with invalid maxTokens:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model's maxTokens does not exceed contextWindow", () => {
+		const knownExceptions = new Set([
+			"openrouter/meta-llama/llama-3-8b-instruct",
+			"openrouter/nex-agi/deepseek-v3.1-nex-n1",
+			"openrouter/openai/gpt-3.5-turbo-0613",
+			"openrouter/z-ai/glm-5",
+		]);
+
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (knownExceptions.has(`${providerKey}/${modelKey}`)) continue;
+			const cw = model["contextWindow"] as number;
+			const mt = model["maxTokens"] as number;
+			if (typeof cw === "number" && typeof mt === "number" && mt > cw) {
+				invalid.push(`${providerKey}/${modelKey}: maxTokens(${mt}) > contextWindow(${cw})`);
+			}
+		}
+		assert.deepEqual(invalid, [], `Models where maxTokens exceeds contextWindow:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("every model has a cost object with non-negative numeric fields", () => {
+		const knownNegativeCostModels = new Set([
+			"openrouter/openrouter/auto",
+		]);
+
+		const invalid: string[] = [];
+		for (const { providerKey, modelKey, model } of allModels()) {
+			if (knownNegativeCostModels.has(`${providerKey}/${modelKey}`)) continue;
+			const cost = model["cost"] as Record<string, unknown> | undefined;
+			if (!cost || typeof cost !== "object") {
+				invalid.push(`${providerKey}/${modelKey}: missing cost object`);
+				continue;
+			}
+			for (const field of ["input", "output", "cacheRead", "cacheWrite"] as const) {
+				const val = cost[field];
+				if (typeof val !== "number" || val < 0 || !Number.isFinite(val)) {
+					invalid.push(`${providerKey}/${modelKey}: cost.${field}=${val}`);
+				}
+			}
+		}
+		assert.deepEqual(invalid, [], `Models with invalid cost fields:\n  ${invalid.join("\n  ")}`);
+	});
+
+	it("no provider has duplicate model IDs", () => {
+		const duplicates: string[] = [];
+		for (const [providerKey, providerModels] of Object.entries(MODELS)) {
+			const ids = Object.values(providerModels).map((m) => (m as Record<string, unknown>)["id"] as string);
+			const seen = new Set<string>();
+			for (const id of ids) {
+				if (seen.has(id)) duplicates.push(`${providerKey}/${id}`);
+				seen.add(id);
+			}
+		}
+		assert.deepEqual(duplicates, [], `Duplicate model IDs within a provider:\n  ${duplicates.join("\n  ")}`);
+	});
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Registry shape
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("MODELS registry shape", () => {
+	it("has exactly 23 providers", () => {
+		const count = Object.keys(MODELS).length;
+		assert.equal(count, 23, `Expected 23 providers, got ${count}: ${Object.keys(MODELS).join(", ")}`);
+	});
+
+	it("has at least 200 models in total (sanity check)", () => {
+		let total = 0;
+		for (const providerModels of Object.values(MODELS)) {
+			total += Object.keys(providerModels).length;
+		}
+		assert.ok(total >= 200, `Registry has only ${total} models — unexpectedly small`);
+	});
+
+	it("all 23 expected providers are present", () => {
+		const expected = [
+			"amazon-bedrock",
+			"anthropic",
+			"azure-openai-responses",
+			"cerebras",
+			"github-copilot",
+			"google",
+			"google-antigravity",
+			"google-gemini-cli",
+			"google-vertex",
+			"groq",
+			"huggingface",
+			"kimi-coding",
+			"minimax",
+			"minimax-cn",
+			"mistral",
+			"openai",
+			"openai-codex",
+			"opencode",
+			"opencode-go",
+			"openrouter",
+			"vercel-ai-gateway",
+			"xai",
+			"zai",
+		];
+		const actual = Object.keys(MODELS).sort();
+		assert.deepEqual(actual, expected.sort());
+	});
+
+	it("getProviders() returns all generated providers", () => {
+		const providers = getProviders();
+		for (const p of Object.keys(MODELS)) {
+			assert.ok(providers.includes(p as any), `getProviders() missing generated provider: ${p}`);
+		}
+	});
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Removed models must not exist
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("removed models are absent from the registry", () => {
+	const removedModels: Array<{ provider: string; id: string }> = [
+		{ provider: "openrouter", id: "anthropic/claude-3.5-sonnet" },
+		{ provider: "openrouter", id: "anthropic/claude-3.5-sonnet-20240620" },
+		{ provider: "openrouter", id: "mistralai/mistral-small-24b-instruct-2501" },
+		{ provider: "openrouter", id: "mistralai/mistral-small-3.1-24b-instruct:free" },
+		{ provider: "openrouter", id: "qwen/qwen3-4b:free" },
+		{ provider: "openrouter", id: "stepfun/step-3.5-flash:free" },
+		{ provider: "openrouter", id: "x-ai/grok-4.20-beta" },
+		{ provider: "openrouter", id: "arcee-ai/trinity-mini:free" },
+		{ provider: "openrouter", id: "google/gemini-3-pro-preview" },
+		{ provider: "openrouter", id: "kwaipilot/kat-coder-pro" },
+		{ provider: "openrouter", id: "meituan/longcat-flash-thinking" },
+		{ provider: "vercel-ai-gateway", id: "xai/grok-2-vision" },
+		{ provider: "anthropic", id: "claude-3-7-sonnet-latest" },
+	];
+
+	for (const { provider, id } of removedModels) {
+		it(`${provider}/${id} has been removed`, () => {
+			const model = getModel(provider as any, id as any);
+			assert.equal(model, undefined, `${provider}/${id} should be removed but is still present`);
+		});
+	}
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Spot-checks for notable models added in this regeneration
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe("spot-checks for models added in this regeneration", () => {
+	const newModels: Array<{ provider: string; id: string; reasoning?: boolean }> = [
+		{ provider: "openrouter", id: "z-ai/glm-5.1" },
+		{ provider: "openrouter", id: "z-ai/glm-5v-turbo" },
+		{ provider: "openrouter", id: "google/gemma-4-31b-it" },
+		{ provider: "openrouter", id: "google/gemma-4-26b-a4b-it" },
+		{ provider: "openrouter", id: "arcee-ai/trinity-large-thinking", reasoning: true },
+		{ provider: "openrouter", id: "openai/gpt-audio" },
+		{ provider: "openrouter", id: "anthropic/claude-opus-4.6-fast" },
+		{ provider: "openrouter", id: "qwen/qwen3.6-plus" },
+		{ provider: "groq", id: "groq/compound" },
+		{ provider: "groq", id: "groq/compound-mini" },
+		{ provider: "huggingface", id: "zai-org/GLM-5.1" },
+		{ provider: "openai", id: "gpt-5.3-chat-latest" },
+		{ provider: "mistral", id: "mistral-small-2603" },
+		{ provider: "zai", id: "glm-5.1" },
+	];
+
+	for (const { provider, id, reasoning } of newModels) {
+		it(`${provider}/${id} is present in the registry`, () => {
+			const model = getModel(provider as any, id as any);
+			assert.ok(model, `Expected ${provider}/${id} to be present after regeneration`);
+			assert.equal(model.id, id);
+			assert.equal(model.provider, provider);
+			if (reasoning !== undefined) {
+				assert.equal(model.reasoning, reasoning, `${id} reasoning should be ${reasoning}`);
+			}
+		});
+	}
+});