@wrongstack/core 0.292.1 → 0.293.0

package/dist/models/alibaba-token-plan-catalog.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Offline **floor** for the Alibaba Cloud Model Studio Token Plan (Personal
+ * Edition) models, sourced from the official documentation at:
+ *   https://www.alibabacloud.com/help/en/model-studio/token-plan-personal-overview
+ *
+ * Source-of-truth precedence (live path wins):
+ *  1. The curated overlay `packages/cli/data/providers.json` — provider
+ *     `alibaba-token-plan` — synced from the official doc + cached + bundled
+ *     offline by `DefaultModelsRegistry` (overlayUrl/overlayFile). Editing
+ *     that JSON and pushing updates every client without a code release;
+ *     this is the authoritative list whenever the registry overlay is wired
+ *     (the CLI path).
+ *  2. This hardcoded table — the last-resort floor used where no overlay is
+ *     available (a standalone registry without the bundled file) and by the
+ *     CLI auth-menu login flow, which needs a synchronous id list.
+ *
+ * Keep this in lockstep with the `alibaba-token-plan` block in
+ * `providers.json`; the drift-guard test
+ * `packages/cli/tests/alibaba-token-plan-catalog-overlay-sync.test.ts`
+ * asserts they agree.
+ *
+ * ─── Correction context: models.dev vs Token Plan ─────────────────────
+ * The models.dev catalog (fetched by DefaultModelsRegistry) reports the
+ * FULL Alibaba Cloud Model Studio model inventory — hundreds of models
+ * across pay-per-use, legacy snapshots, Team Edition, and Personal Edition.
+ * The Token Plan (Personal Edition) is an exact-string allowlist that
+ * covers only **11 models** from 5 brands. The following models.dev
+ * entries are **NOT in the Personal Edition** and must NOT appear in the
+ * provider's model list:
+ *
+ *  ❌ qwen3.6-plus          Team Edition only
+ *  ❌ deepseek-v4-flash      Team Edition only
+ *  ❌ deepseek-v3.2          Team Edition only
+ *  ❌ qwen-image-2.0         Team Edition only  (Qwen image gen)
+ *  ❌ qwen-image-2.0-pro     Team Edition only
+ *  ❌ kimi-k2.7-code         Team Edition only (Moonshot AI)
+ *  ❌ kimi-k2.6              Team Edition only
+ *  ❌ kimi-k2.5              Team Edition only
+ *  ❌ glm-5.1                Team Edition only
+ *  ❌ glm-5                  Team Edition only
+ *  ❌ MiniMax-M2.5           Team Edition only
+ *  ❌ qwen3-max              Legacy pay-per-use (not in any Token Plan)
+ *  ❌ qwen3.5-plus / flash   Legacy pay-per-use
+ *  ❌ qwen3-coder-plus       Legacy pay-per-use
+ *  ❌ qwen-long              10M-token model, not in Token Plan
+ *  ❌ qwen3-math-plus        Specialised model, not in Token Plan
+ *  ❌ qwen3-235b-a22b        Open-weight, pay-per-use
+ *  ❌ wan2.7-t2v-turbo       Different Wanx variant, verify availability
+ *
+ * See packages/cli/data/providers.json for the authoritative model
+ * allowlist.
+ * ──────────────────────────────────────────────────────────────────────
+ */
+export interface AlibabaTokenPlanModelMeta {
+    /** The wire id sent to the backend (e.g. `qwen3.7-max`). */
+    id: string;
+    /** Human-readable display name shown in pickers. */
+    name: string;
+    /** One-line capability blurb. */
+    description: string;
+    /** Capability tags — which modality/feature this model supports. */
+    capabilities: string[];
+    /** Context window in tokens (where applicable). */
+    contextWindow?: number;
+    /** Max output tokens (where documented). */
+    maxOutput?: number;
+    /** The recommended / latest model — tagged "(current)" in the official UI. */
+    current?: boolean;
+    /** Explicit input modality declaration (e.g. image-conditioned video models). */
+    inputs?: ReadonlyArray<'text' | 'image'>;
+}
+/**
+ * Token Plan Personal Edition models, newest-first. The first entry is the
+ * recommended default (`current`). Order is significant: callers that need a
+ * default model id use `ALIBABA_TOKEN_PLAN_MODELS[0]`.
+ *
+ * Corresponds to the "Supported models" table on:
+ * https://www.alibabacloud.com/help/en/model-studio/token-plan-personal-overview
+ *
+ * Last verified: 2026-07-20 (official doc last updated Jul 19, 2026)
+ */
+export declare const ALIBABA_TOKEN_PLAN_MODELS: ReadonlyArray<AlibabaTokenPlanModelMeta>;
+/** Look up the canonical metadata for a Token Plan model id, or `undefined`. */
+export declare function alibabaTokenPlanModelMeta(id: string): AlibabaTokenPlanModelMeta | undefined;
+//# sourceMappingURL=alibaba-token-plan-catalog.d.ts.map

package/dist/models/alibaba-token-plan-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alibaba-token-plan-catalog.d.ts","sourceRoot":"","sources":["../../src/models/alibaba-token-plan-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iFAAiF;IACjF,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,EAAE,aAAa,CAAC,yBAAyB,CAiG9E,CAAC;AAMF,gFAAgF;AAChF,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,GACT,yBAAyB,GAAG,SAAS,CAEvC"}

package/dist/models/index.d.ts

@@ -3,6 +3,7 @@ export { DefaultModeStore, loadProjectModes, loadUserModes, type ModeLoaderOptio
 export { LLMSelector, type LLMSelectorOptions } from './llm-selector.js';
 export { resolveProviderModelList, describeCatalogModel, type ProviderModelDescriptor, } from './provider-model-resolve.js';
 export { CODEX_MODELS, codexModelMeta, type CodexModelMeta } from './codex-catalog.js';
+export { ALIBABA_TOKEN_PLAN_MODELS, alibabaTokenPlanModelMeta, type AlibabaTokenPlanModelMeta, } from './alibaba-token-plan-catalog.js';
 export { MODEL_PROFILES, TASK_TO_ROLE, inferTaskType, findModelProfile, scoreModelForTask, type ModelProfile, type TaskType, } from './model-intelligence.js';
 export { ModelRouter, type RouterConfig, type ModelPick, type RouterCosts, type ModelIntelligenceEntry, } from './model-router.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,4BAA4B,GAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGvF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,KAAK,4BAA4B,GAClC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC"}

package/dist/models/index.js

@@ -2,6 +2,75 @@
 import * as fs2 from "node:fs/promises";
 import * as path2 from "node:path";
 
+// src/utils/term.ts
+var hasStdout = () => typeof process !== "undefined" && !!process.stdout;
+function isStdoutTTY() {
+  return hasStdout() && Boolean(process.stdout.isTTY);
+}
+var ESCAPE_TERMINATOR = Object.freeze({
+  BEL: "\x07",
+  // OSC 0 / OSC 2 (title)
+  ST: "\x1B\\"
+  // DCS / strict OSC
+});
+
+// src/utils/color.ts
+var isColorTty = () => {
+  if (envFlag(process.env.NO_COLOR)) return false;
+  if (envFlag(process.env.FORCE_COLOR)) return true;
+  return isStdoutTTY();
+};
+function envFlag(value) {
+  if (value === void 0) return false;
+  if (value.trim() === "") return false;
+  return !/^(0|false|no|off)$/i.test(value.trim());
+}
+var COLOR = isColorTty();
+var wrap = (open2, close) => (s) => COLOR ? `\x1B[${open2}m${s}\x1B[${close}m` : s;
+var color = {
+  reset: wrap("0", "0"),
+  bold: wrap("1", "22"),
+  dim: wrap("2", "22"),
+  italic: wrap("3", "23"),
+  underline: wrap("4", "24"),
+  red: wrap("31", "39"),
+  green: wrap("32", "39"),
+  yellow: wrap("33", "39"),
+  blue: wrap("34", "39"),
+  magenta: wrap("35", "39"),
+  cyan: wrap("36", "39"),
+  gray: wrap("90", "39"),
+  amber: wrap("38;5;214", "39"),
+  pink: wrap("38;5;205", "39"),
+  bgRed: wrap("41", "49"),
+  bgGreen: wrap("42", "49")
+};
+
+// src/infrastructure/logger.ts
+var COLORS = {
+  error: color.red,
+  warn: color.yellow,
+  info: color.cyan,
+  debug: color.gray,
+  trace: color.dim
+};
+var noOpLogger = {
+  // 'error' is the quietest level the Logger contract offers; the methods
+  // discard everything regardless, this only matters to level checks.
+  level: "error",
+  error: () => {
+  },
+  warn: () => {
+  },
+  info: () => {
+  },
+  debug: () => {
+  },
+  trace: () => {
+  },
+  child: () => noOpLogger
+};
+
 // src/utils/atomic-write.ts
 import { randomBytes } from "node:crypto";
 import * as fs from "node:fs/promises";
@@ -84,15 +153,30 @@ function estimateMessageTokens(messages) {
 }
 
 // src/utils/merge-models-payload.ts
+var REMOVE_PROVIDERS_KEY = "_removeProviders";
+var REMOVE_MODELS_KEY = "_removeModels";
 function mergeModelsPayload(base, overlay) {
+  const removeProviders = Array.isArray(overlay[REMOVE_PROVIDERS_KEY]) ? overlay[REMOVE_PROVIDERS_KEY] : [];
+  const removeModels = overlay[REMOVE_MODELS_KEY] && typeof overlay[REMOVE_MODELS_KEY] === "object" ? overlay[REMOVE_MODELS_KEY] : {};
   const out = {};
   for (const [id, provider] of Object.entries(base)) {
     out[id] = cloneProvider(provider);
   }
   for (const [id, ovProvider] of Object.entries(overlay)) {
+    if (id === REMOVE_PROVIDERS_KEY || id === REMOVE_MODELS_KEY) continue;
     const existing = out[id];
     out[id] = existing ? mergeProvider(existing, ovProvider) : cloneProvider(ovProvider);
   }
+  for (const providerId of removeProviders) {
+    delete out[providerId];
+  }
+  for (const [providerId, modelIds] of Object.entries(removeModels)) {
+    const provider = out[providerId];
+    if (!provider || !provider.models) continue;
+    for (const modelId of modelIds) {
+      delete provider.models[modelId];
+    }
+  }
   return out;
 }
 function mergeProvider(base, overlay) {
@@ -381,6 +465,7 @@ var DefaultModelsRegistry = class {
   overlayUrl;
   overlayFile;
   overlayCacheFile;
+  logger;
   constructor(opts) {
     this.cacheFile = opts.cacheFile;
     this.url = opts.url ?? process.env[ENV_URL_KEY] ?? DEFAULT_URL;
@@ -394,6 +479,7 @@ var DefaultModelsRegistry = class {
     this.overlayUrl = opts.overlayUrl;
     this.overlayFile = opts.overlayFile;
     this.overlayCacheFile = opts.overlayCacheFile ?? (opts.overlayUrl ? path2.join(path2.dirname(opts.cacheFile), "models-overlay-cache.json") : void 0);
+    this.logger = opts.logger ?? noOpLogger;
   }
   async load(opts = {}) {
     if (this.payload && !opts.force) return this.payload;
@@ -442,16 +528,18 @@ var DefaultModelsRegistry = class {
       if (cached && this.isWithinMaxStaleAge(cached.fetchedAt)) {
         this.fetchedAt = new Date(cached.fetchedAt);
         const ageSeconds = Math.floor((Date.now() - this.fetchedAt.getTime()) / 1e3);
-        console.warn(
-          `ModelsRegistry: models.dev unavailable (${toErrorMessage(err)}); using stale cache from ${formatAge(ageSeconds)} ago. Run \`wstack models refresh\` to retry.`
+        this.logger.warn(
+          `ModelsRegistry: models.dev unavailable (${toErrorMessage(err)}); using stale cache from ${formatAge(ageSeconds)} ago. Run \`wstack models refresh\` to retry.`,
+          { event: "models_registry.stale_cache_fallback" }
         );
         return cached.payload;
       }
       if (overlayAvailable) {
-        console.warn(
+        this.logger.warn(
           `ModelsRegistry: models.dev unavailable (${toErrorMessage(
             err
-          )}); serving curated overlay only.`
+          )}); serving curated overlay only.`,
+          { event: "models_registry.overlay_only_fallback" }
         );
         return {};
       }
@@ -547,8 +635,9 @@ var DefaultModelsRegistry = class {
       const cached = await this.readCacheAt(this.overlayCacheFile);
       if (cached && this.isWithinMaxStaleAge(cached.fetchedAt)) {
         const ageSeconds = Math.floor((Date.now() - new Date(cached.fetchedAt).getTime()) / 1e3);
-        console.warn(
-          `ModelsRegistry: overlay unavailable; using stale overlay from ${formatAge(ageSeconds)} ago.`
+        this.logger.warn(
+          `ModelsRegistry: overlay unavailable; using stale overlay from ${formatAge(ageSeconds)} ago.`,
+          { event: "models_registry.overlay_stale_fallback", ageSeconds }
         );
         return cached.payload;
       }
@@ -1129,11 +1218,13 @@ var LLMSelector = class {
   systemPrompt;
   maxOutputTokens;
   oneShotOrchestrator;
+  logger;
   constructor(opts) {
     this.provider = opts.provider;
     this.model = opts.model ?? "unknown";
+    this.logger = opts.logger ?? noOpLogger;
     if (this.model === "unknown" && (process.env["NODE_ENV"] === "development" || process.env["WRONGSTACK_DEBUG"] === "1")) {
-      console.warn(
+      this.logger.warn(
         "[LLMSelector] model not set \u2014 selector will use the provider default. Set `model` explicitly in LLMSelectorOptions to silence this warning."
       );
     }
@@ -1183,14 +1274,9 @@ IMPORTANT: Total conversation (${totalTokens} tokens) exceeds budget (${effectiv
       }
     } catch (err) {
       if (err instanceof Error) {
-        console.warn(
-          JSON.stringify({
-            level: "warn",
-            event: "llm_selector.call_failed",
-            message: `selector call failed, using recency fallback: ${err.message}`,
-            timestamp: (/* @__PURE__ */ new Date()).toISOString()
-          })
-        );
+        this.logger.warn(`selector call failed, using recency fallback: ${err.message}`, {
+          event: "llm_selector.call_failed"
+        });
       }
       return this.fallbackSelect(messages, effectiveBudget);
     } finally {
@@ -1391,6 +1477,103 @@ function resolveProviderModelList(savedModels, catalog, providerHint, siblingCat
   return out;
 }
 
+// src/models/alibaba-token-plan-catalog.ts
+var ALIBABA_TOKEN_PLAN_MODELS = [
+  // ── Qwen (flagship) ──────────────────────────────────────────────
+  {
+    id: "qwen3.8-max-preview",
+    name: "Qwen3.8 Max Preview",
+    description: "2.4T-parameter multimodal reasoning \u2014 text, image, video, documents. 10% Credits rate during preview. Night discount (22:00-08:00 UTC+8).",
+    capabilities: ["reasoning", "visual-understanding", "text-generation"],
+    contextWindow: 1e6,
+    // speculative — matches Qwen3.7 Max; official docs pending
+    maxOutput: 65536,
+    current: true
+  },
+  {
+    id: "qwen3.7-max",
+    name: "Qwen3.7 Max",
+    description: "Top-tier pure-text reasoning model \u2014 strongest in the Qwen3.7 series. 1M context, thinking mode, function calling.",
+    capabilities: ["reasoning", "text-generation"],
+    contextWindow: 1e6,
+    maxOutput: 65536
+  },
+  {
+    id: "qwen3.7-plus",
+    name: "Qwen3.7 Plus",
+    description: "Balanced flagship \u2014 reasoning, visual understanding, text generation. 1M context, built-in tools.",
+    capabilities: ["reasoning", "visual-understanding", "text-generation"],
+    contextWindow: 1e6,
+    maxOutput: 65536
+  },
+  {
+    id: "qwen3.6-flash",
+    name: "Qwen3.6 Flash",
+    description: "Cost-effective reasoning model \u2014 vision + text, 1M context, same context length as flagship at lower cost.",
+    capabilities: ["reasoning", "visual-understanding", "text-generation"],
+    contextWindow: 1e6,
+    maxOutput: 65536
+  },
+  // ── Zhipu AI ──────────────────────────────────────────────────────
+  {
+    id: "glm-5.2",
+    name: "GLM-5.2",
+    description: "Zhipu AI flagship text-generation model \u2014 reasoning, text, 198K context, function calling, structured output.",
+    capabilities: ["reasoning", "text-generation"],
+    contextWindow: 198e3,
+    maxOutput: 65536
+  },
+  // ── DeepSeek ──────────────────────────────────────────────────────
+  {
+    id: "deepseek-v4-pro",
+    name: "DeepSeek V4 Pro",
+    description: "Frontier reasoning + text generation model. 1M context, always-thinking mode.",
+    capabilities: ["reasoning", "text-generation"],
+    contextWindow: 1e6,
+    maxOutput: 65536
+  },
+  // ── Wanx (image generation) ────────────────────────────────────────
+  {
+    id: "wan2.7-image",
+    name: "Wan2.7 Image",
+    description: "Text-to-image generation model by Wanx.",
+    capabilities: ["image-generation"]
+  },
+  {
+    id: "wan2.7-image-pro",
+    name: "Wan2.7 Image Pro",
+    description: "Higher-quality text-to-image generation model by Wanx.",
+    capabilities: ["image-generation"]
+  },
+  // ── HappyHorse (video generation) ─────────────────────────────────
+  {
+    id: "happyhorse-1.1-t2v",
+    name: "HappyHorse 1.1 T2V",
+    description: "Text-to-video generation model by HappyHorse.",
+    capabilities: ["video-generation"]
+  },
+  {
+    id: "happyhorse-1.1-i2v",
+    name: "HappyHorse 1.1 I2V",
+    description: "Image-to-video generation model by HappyHorse.",
+    capabilities: ["video-generation"],
+    inputs: ["text", "image"]
+  },
+  {
+    id: "happyhorse-1.1-r2v",
+    name: "HappyHorse 1.1 R2V",
+    description: "Reference-to-video generation model by HappyHorse.",
+    capabilities: ["video-generation"],
+    inputs: ["text", "image"]
+  }
+];
+var BY_ID2 = new Map(
+  ALIBABA_TOKEN_PLAN_MODELS.map((m) => [m.id, m])
+);
+function alibabaTokenPlanModelMeta(id) {
+  return BY_ID2.get(id);
+}
+
 // src/models/model-intelligence.ts
 var MODEL_PROFILES = [
   // ── Anthropic ──
@@ -1882,6 +2065,7 @@ var ModelRouter = class {
   }
 };
 export {
+  ALIBABA_TOKEN_PLAN_MODELS,
   CODEX_MODELS,
   DefaultModeStore,
   DefaultModelsRegistry,
@@ -1889,6 +2073,7 @@ export {
   MODEL_PROFILES,
   ModelRouter,
   TASK_TO_ROLE,
+  alibabaTokenPlanModelMeta,
   classifyFamily,
   codexModelMeta,
   describeCatalogModel,