@gtrabanco/pi-nan-provider 0.7.0 → 0.10.0

package/scripts/check-pi-sdk-versions.mjs

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+/**
+ * Monitor PI SDK versions and NaN-related dependencies for pi-nan-provider.
+ *
+ * This script:
+ * 1. Reads current versions from package.json (devDependencies and peerDependencies).
+ * 2. Queries npm for latest versions.
+ * 3. Flags version bumps and checks compatibility.
+ *
+ * Exit 0 = nothing to do.
+ * Exit 1 = updates available.
+ *
+ * Usage:
+ *   node scripts/check-pi-sdk-versions.mjs --report
+ *   node scripts/check-pi-sdk-versions.mjs --fail
+ *   node scripts/check-pi-sdk-versions.mjs  (JSON output for CI)
+ */
+
+import https from "node:https";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
+
+// ---------------------------------------------------------------------------
+// Config
+// ---------------------------------------------------------------------------
+
+const ROOT = fileURLToPath(new URL("../", import.meta.url));
+
+/**
+ * Packages that ship from the `@earendil-works` scope and carry Pi SDK code.
+ * pi-nan-provider depends on these for AI model operations.
+ */
+const SDK_PACKAGES = [
+  "@earendil-works/pi-ai",
+  "@earendil-works/pi-coding-agent",
+];
+
+// ---------------------------------------------------------------------------
+// Package.json reader
+// ---------------------------------------------------------------------------
+
+function readPackageJson() {
+  const raw = readFileSync(new URL("../package.json", import.meta.url), "utf-8");
+  return JSON.parse(raw);
+}
+
+/**
+ * Get the currently constrained version for a package from
+ * devDependencies and peerDependencies.
+ */
+function getConstrainedVersion(pkg, packageName) {
+  const sources = ["devDependencies", "peerDependencies"];
+  for (const src of sources) {
+    const ver = pkg[src]?.[packageName];
+    if (ver) return { version: ver, source: src };
+  }
+  return null;
+}
+
+// ---------------------------------------------------------------------------
+// npm registry client (no dependencies)
+// ---------------------------------------------------------------------------
+
+function npmGet(packageName) {
+  return new Promise((resolve, reject) => {
+    const req = https.get(
+      `https://registry.npmjs.org/${encodeURIComponent(packageName)}`,
+      { headers: { accept: "application/json" } },
+      (res) => {
+        if (res.statusCode !== 200) {
+          reject(new Error(`npm registry returned ${res.statusCode} for ${packageName}`));
+          return;
+        }
+        let data = "";
+        res.on("data", (chunk) => (data += chunk));
+        res.on("end", () => resolve(JSON.parse(data)));
+      }
+    );
+    req.on("error", reject);
+    req.setTimeout(15_000, () => {
+      req.destroy();
+      reject(new Error(`Timeout fetching ${packageName} from npm`));
+    });
+  });
+}
+
+function npmLatest(packageName) {
+  return npmGet(packageName).then((data) => {
+    const distTags = data["dist-tags"] ?? {};
+    const latestVersion = distTags["latest"];
+    if (!latestVersion) {
+      throw new Error(`No "latest" dist-tag for ${packageName}`);
+    }
+    const versions = Object.keys(data.versions ?? {}).sort((a, b) => {
+      const pa = a.split(".").map(Number);
+      const pb = b.split(".").map(Number);
+      for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va < vb) return -1;
+        if (va > vb) return 1;
+      }
+      return 0;
+    });
+    return { latestVersion, latestTag: "latest", allVersions: versions, data };
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Semver helpers
+// ---------------------------------------------------------------------------
+
+function parseSemver(version) {
+  // Handle versions like "1" (major only) or "1.2" (major.minor)
+  let normalized = version;
+  while (normalized.split(".").length < 3) {
+    normalized += ".0";
+  }
+  const m = normalized.match(/^(\d+)\.(\d+)\.(\d+)/);
+  if (!m) return null;
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]), raw: version };
+}
+
+function bumpLevel(current, target) {
+  const c = parseSemver(current);
+  const t = parseSemver(target);
+  if (!c || !t) return "unknown";
+  if (t.major > c.major) return "major";
+  if (t.minor > c.minor) return "minor";
+  if (t.patch > c.patch) return "patch";
+  return "none";
+}
+
+/**
+ * Check if a version satisfies a semver range.
+ * Handles caret, tilde, comparison operators, and ranges.
+ */
+function checkSemverSatisfies(version, range) {
+  const cVer = parseSemver(version);
+  if (!cVer) return false;
+
+  // Handle disjunction (OR): ">=1.0.0 <2.0.0 || >=3.0.0"
+  if (range.includes("||")) {
+    const parts = range.split("||").map((p) => p.trim());
+    return parts.some((part) => checkSemverSatisfies(version, part));
+  }
+
+  // Handle conjunction (AND via spaces): ">=1.0.0 <2.0.0"
+  const parts = [];
+  let current = "";
+  const tokens = range.split(/\s+/);
+  for (const token of tokens) {
+    if (token.startsWith(">=") || token.startsWith("<=") ||
+        token.startsWith(">") || token.startsWith("<") || token.startsWith("=") ||
+        token.startsWith("^") || token.startsWith("~")) {
+      if (current && !current.startsWith("^") && !current.startsWith("~")) {
+        parts.push(current);
+      }
+      current = token;
+    } else if (current) {
+      current = current + " " + token;
+    } else {
+      current = token;
+    }
+  }
+  if (current) parts.push(current);
+
+  if (parts.length > 1) {
+    // Check each part
+    return parts.every((part) => checkSemverSatisfies(version, part));
+  }
+
+  // Single constraint
+  const constraint = range.trim();
+
+  // Handle caret: ^X.Y.Z
+  if (constraint.startsWith("^")) {
+    const target = parseSemver(constraint.slice(1));
+    if (!target) return false;
+    // ^0.x: same major and minor >= target.minor
+    // ^1.x+: same major and minor >= target.minor
+    return cVer.major === target.major && cVer.minor >= target.minor;
+  }
+
+  // Handle tilde: ~X.Y.Z
+  if (constraint.startsWith("~")) {
+    const target = parseSemver(constraint.slice(1));
+    if (!target) return false;
+    return cVer.major === target.major && cVer.minor === target.minor && cVer.patch >= target.patch;
+  }
+
+  // Handle comparison: >=X.Y.Z, <X.Y.Z, =X.Y.Z, etc.
+  let op = "";
+  let verStr = constraint;
+  if (constraint.startsWith(">=")) {
+    op = ">=";
+    verStr = constraint.slice(2);
+  } else if (constraint.startsWith("<=")) {
+    op = "<=";
+    verStr = constraint.slice(2);
+  } else if (constraint.startsWith(">")) {
+    op = ">";
+    verStr = constraint.slice(1);
+  } else if (constraint.startsWith("<")) {
+    op = "<";
+    verStr = constraint.slice(1);
+  } else if (constraint.startsWith("=")) {
+    op = "=";
+    verStr = constraint.slice(1);
+  }
+
+  const target = parseSemver(verStr);
+  if (!target) return false;
+
+  const cmp = semverCompare(cVer, target);
+
+  switch (op) {
+    case ">=": return cmp >= 0;
+    case "<=": return cmp <= 0;
+    case ">": return cmp > 0;
+    case "<": return cmp < 0;
+    case "=": return cmp === 0;
+    default: return false;
+  }
+}
+
+function semverCompare(a, b) {
+  if (a.major !== b.major) return a.major - b.major;
+  if (a.minor !== b.minor) return a.minor - b.minor;
+  return (a.patch ?? 0) - (b.patch ?? 0);
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+async function main() {
+  const args = process.argv.slice(2);
+  const flags = {
+    report: args.includes("--report"),
+    fail: args.includes("--fail"),
+  };
+
+  const pkg = readPackageJson();
+
+  const results = [];
+  let exitCode = 0;
+
+  for (const packageName of SDK_PACKAGES) {
+    try {
+      const npmInfo = await npmLatest(packageName);
+      const constrained = getConstrainedVersion(pkg, packageName);
+
+      if (!constrained) {
+        results.push({
+          packageName,
+          status: "not-found",
+          message: "Not found in package.json dependencies",
+        });
+        continue;
+      }
+
+      // Extract numeric version from constraint
+      let constraintVer = constrained.version;
+      // Remove version range operators to get the base version
+      if (constraintVer.startsWith("^")) {
+        constraintVer = constraintVer.slice(1);
+      } else if (constraintVer.startsWith("~")) {
+        constraintVer = constraintVer.slice(1);
+      }
+
+      const bump = bumpLevel(constraintVer, npmInfo.latestVersion);
+
+      // Check if latest satisfies peer dependencies
+      const peerRange = pkg.peerDependencies?.[packageName] ?? null;
+      const latestSatisfiesPeer = peerRange
+        ? checkSemverSatisfies(npmInfo.latestVersion, peerRange)
+        : true;
+
+      // Check if current satisfies peer dependencies
+      const currentSatisfiesPeer = peerRange
+        ? checkSemverSatisfies(constraintVer, peerRange)
+        : true;
+
+      const result = {
+        packageName,
+        source: constrained.source,
+        constrainedVersion: constrained.version,
+        constraintVer,
+        latestVersion: npmInfo.latestVersion,
+        latestTag: npmInfo.latestTag,
+        bump,
+        peerRange,
+        latestSatisfiesPeer,
+        currentSatisfiesPeer,
+        totalVersions: npmInfo.allVersions.length,
+        allVersions: npmInfo.allVersions,
+      };
+
+      // Determine status
+      if (!currentSatisfiesPeer) {
+        result.status = "WARNING";
+        result.message = `Current version ${constraintVer} does NOT satisfy peer dependency range ${peerRange}`;
+        exitCode = 1;
+      } else if (bump === "major" && npmInfo.latestVersion !== constraintVer) {
+        result.status = "BREAKING";
+        result.message = `Major version bump: ${constraintVer} → ${npmInfo.latestVersion}. Review changelog before upgrading.`;
+        if (latestSatisfiesPeer) {
+          result.message += ` Latest version satisfies peer dependency range.`;
+        } else {
+          result.message += ` ⚠️ Latest version does NOT satisfy peer dependency range!`;
+        }
+        exitCode = 1;
+      } else if (bump === "minor" && npmInfo.latestVersion !== constraintVer) {
+        result.status = "minor";
+        result.message = `Minor version bump: ${constraintVer} → ${npmInfo.latestVersion}. Check for API changes.`;
+        exitCode = 1;
+      } else if (bump === "patch" && npmInfo.latestVersion !== constraintVer) {
+        result.status = "patch";
+        result.message = `Patch version bump: ${constraintVer} → ${npmInfo.latestVersion}. May be safe to update.`;
+      } else {
+        result.status = "up-to-date";
+        result.message = `Already on latest version.`;
+      }
+
+      if (latestSatisfiesPeer && bump !== "none") {
+        result.message += ` Latest satisfies peer dependency range.`;
+      } else if (!latestSatisfiesPeer) {
+        result.message += ` Latest does NOT satisfy peer dependency range!`;
+      }
+
+      results.push(result);
+    } catch (err) {
+      results.push({
+        packageName,
+        status: "error",
+        message: err.message,
+      });
+      exitCode = 1;
+    }
+  }
+
+  // Print report
+  if (flags.report) {
+    console.log("\n=== PI SDK Version Monitor (pi-nan-provider) ===\n");
+
+    for (const r of results) {
+      if (r.status === "not-found") {
+        console.log(`  ❌ ${r.packageName}: ${r.message}`);
+        continue;
+      }
+      if (r.status === "error") {
+        console.log(`  ⚠️  ${r.packageName}: ${r.message}`);
+        continue;
+      }
+      if (r.status === "up-to-date") {
+        console.log(`  ✅ ${r.packageName}: ${r.message} (${r.latestVersion})`);
+        continue;
+      }
+      if (r.status === "WARNING") {
+        console.log(`  ❗ ${r.packageName}: ${r.message} (current: ${r.constrainedVersion})`);
+        continue;
+      }
+      const icon = r.status === "BREAKING" ? "🔴" : r.status === "minor" ? "🟡" : "🟢";
+      console.log(`  ${icon} ${r.packageName}: ${r.message} (${r.source}: ${r.constrainedVersion})`);
+      console.log(`     → Latest available: ${r.latestVersion} (tag: ${r.latestTag})`);
+      if (r.peerRange) {
+        console.log(`     → Peer dependency range: ${r.peerRange}`);
+        console.log(`     → Latest satisfies peer range: ${r.latestSatisfiesPeer ? "✅" : "❌"}`);
+      }
+      if (r.bump === "major") {
+        console.log(`     → Total versions published: ${r.totalVersions}`);
+      }
+    }
+
+    console.log();
+  } else {
+    // JSON output for CI consumption
+    console.log(JSON.stringify(results, null, 2));
+  }
+
+  if (flags.fail && exitCode === 1) {
+    process.exit(1);
+  }
+
+  process.exit(exitCode);
+}
+
+main().catch((err) => {
+  console.error("Fatal:", err.message);
+  process.exit(2);
+});

package/scripts/generate-models.ts

@@ -8,16 +8,28 @@
  * package. Run before publishing (`bun run generate-models`, wired into
  * `prepublishOnly`).
  *
+ * Sources of truth (maintainer instruction, reaffirmed 2026-09-29):
+ * - https://nan.builders/docs/models decides WHICH models exist — which ids
+ *   belong in the chat catalog, which are premium/live-only, which were
+ *   removed by the provider, which are not chat models at all. Every
+ *   exclusion cites it.
+ * - models.dev (provider "nan") supplies the numeric limits for the ids it
+ *   documents; a divergence from the docs is recorded in MANUAL_OVERRIDES
+ *   with a source note.
+ *
  * Provenance rules (enforced, not decorative):
  * - Every emitted number must come from models.dev or an explicit
  *   MANUAL_OVERRIDES note recording where it was confirmed. Nothing invented.
- * - The founding models (qwen3.6, gemma4, deepseek-v4-flash, mimo-v2.5) MUST
- *   exist on models.dev with complete limits, or this script exits non-zero.
+ * - The official community chat models (qwen3.6, gemma4, deepseek-v4-flash,
+ *   mimo-v2.6-flash) MUST reach the catalog — from models.dev or from a
+ *   MANUAL_ONLY entry — or this script exits non-zero.
  * - Any other models.dev entry missing `limit.context`/`limit.output` is
- *   skipped and flagged "needs manual verification" — never guessed.
+ *   skipped and flagged "needs manual verification" — never guessed. Entries
+ *   that are not chat models are excluded via NON_CHAT_MODEL_IDS instead.
  * - models.dev modalities are intersected with pi's supported input set
- *   ("text" | "image"); e.g. mimo-v2.5's audio input is not representable in
- *   pi's Model type and is dropped from `input` (noted on the entry).
+ *   ("text" | "image"); e.g. mimo-v2.6-flash's audio input is not
+ *   representable in pi's Model type and is dropped from `input` (noted on
+ *   the entry).
  */
 
 import type { GeneratedModelEntry } from "../src/fetch-models.ts";
@@ -39,17 +51,23 @@ const REASONING_EFFORT_VALUES_FROM_DOCS: Record<string, string[]> = {
 	...REASONING_EFFORT_VALUES,
 	// deepseek-v4-flash: any value (no effect) — model decides per request
 	"deepseek-v4-flash": [],
-	// qwen3.8-flash, mimo-v2.5: accepted, depth not adjustable
+	// qwen3.8-flash, mimo-v2.6-flash: accepted, depth not adjustable
 	"qwen3.8-flash": [],
-	"mimo-v2.5": [],
+	"mimo-v2.6-flash": [],
 };
 
 const MODELS_DEV_API_URL = "https://models.dev/api.json";
 const SOURCE_PROVIDER_ID = "nan";
 const FETCH_TIMEOUT_MS = 15_000;
 
-/** Models the founding prompt requires in the catalog; absence is fatal. */
-const REQUIRED_MODEL_IDS = ["qwen3.6", "gemma4", "deepseek-v4-flash", "mimo-v2.5"] as const;
+/**
+ * Official community chat models per https://nan.builders/docs/models
+ * (checked 2026-09-29; glm5.3 is premium-tier and deliberately live-only).
+ * Each MUST reach the catalog — from models.dev or from a MANUAL_ONLY entry —
+ * or generation fails. The docs decide this set, not models.dev: models.dev
+ * dropped mimo-v2.5 together with the docs in 2026-09.
+ */
+const REQUIRED_MODEL_IDS = ["qwen3.6", "gemma4", "deepseek-v4-flash", "mimo-v2.6-flash"] as const;
 
 /** pi's Model.input only supports these values. */
 const PI_SUPPORTED_INPUT = new Set(["text", "image"]);
@@ -75,6 +93,20 @@ const MANUAL_NOTES: Record<string, string> = {
 const PROVIDER_REMOVED_MODEL_IDS: Record<string, string> = {
 	"glm5.2":
 		"removed by NaN (2026-09-05); absent from the official chat model list in https://nan.builders/openapi.json and https://nan.builders/docs/models (checked 2026-09-07) while models.dev provider nan still listed it — excluded so regeneration does not resurrect it",
+	"mimo-v2.5":
+		"removed by NaN (checked 2026-09-29): zero mentions in https://nan.builders/docs/models and in the model param description of https://nan.builders/openapi.json, and models.dev provider nan dropped it as well — superseded by mimo-v2.6-flash; excluded so regeneration does not resurrect it",
+};
+
+/**
+ * models.dev entries that are not chat models. They can never join a chat
+ * catalog (their output is an image, and models.dev reports limit.output 0),
+ * so they are excluded with the docs as the reason instead of being flagged
+ * "needs manual verification" forever — that flag would suggest limits worth
+ * confirming for a model this package must not serve as chat.
+ */
+const NON_CHAT_MODEL_IDS: Record<string, string> = {
+	"qwen-image-2.1":
+		"image-generation model (text→image; output modality image) documented in https://nan.builders/docs/models and https://nan.builders/openapi.json (checked 2026-09-29) — not a chat model, out of the static chat catalog (models.dev reports limit.output 0)",
 };
 
 /**
@@ -221,6 +253,10 @@ function convertModel(modelId: string, m: ModelsDevModel): GeneratedModel | { sk
 	if (removedReason) {
 		return { skip: `provider-removed: "${modelId}" excluded from the catalog (${removedReason})` };
 	}
+	const nonChatReason = NON_CHAT_MODEL_IDS[modelId];
+	if (nonChatReason) {
+		return { skip: `non-chat: "${modelId}" excluded from the chat catalog (${nonChatReason})` };
+	}
 	const liveOnlyReason = LIVE_ONLY_MODEL_IDS[modelId];
 	if (liveOnlyReason) {
 		return { skip: `live-only: "${modelId}" kept out of the static catalog (${liveOnlyReason})` };
@@ -301,8 +337,20 @@ async function main(): Promise<void> {
 		}
 	}
 
-	// Add manual-only models (not yet on models.dev).
+	// Add manual-only models (models.dev provider "nan" does not list them).
+	// When models.dev starts listing one, the manual entry is NOT emitted —
+	// otherwise the id would reach the catalog twice — and the reason plus the
+	// original manual provenance are attached to the models.dev-derived entry,
+	// so the manual data never disappears silently.
+	const entryById = new Map(entries.map((entry) => [entry.id, entry]));
 	for (const [modelId, detail] of Object.entries(MANUAL_ONLY_MODEL_IDS)) {
+		const existing = entryById.get(modelId);
+		if (existing) {
+			const note = `manual-only: "${modelId}" skipped: models.dev provider "${SOURCE_PROVIDER_ID}" now lists it, so the manual-only entry is not emitted and the models.dev values are used (${detail})`;
+			existing.notes = [...(existing.notes ?? []), note];
+			console.warn(`generate-models: skipped ${note}`);
+			continue;
+		}
 		const override = MANUAL_OVERRIDES[modelId];
 		if (override) {
 			console.log(`generate-models: manual override for "${modelId}" (${Object.keys(override).filter((k) => k !== "note").join(", ")})`);
@@ -318,8 +366,9 @@ async function main(): Promise<void> {
 	const missingRequired = REQUIRED_MODEL_IDS.filter((id) => !entryIds.has(id));
 	if (missingRequired.length > 0) {
 		fail(
-			`required models missing from models.dev provider "${SOURCE_PROVIDER_ID}": ${missingRequired.join(", ")} — ` +
-				"do NOT invent their data; confirm and add them via MANUAL_OVERRIDES with a source note.",
+			`required models missing from the catalog: ${missingRequired.join(", ")} (official community chat models per ` +
+				"https://nan.builders/docs/models) — do NOT invent their data; confirm them in the docs and add them " +
+				"via MANUAL_OVERRIDES (models.dev lists them) or MANUAL_ONLY_MODEL_IDS (models.dev does not), with a source note.",
 		);
 	}
 
@@ -333,6 +382,9 @@ async function main(): Promise<void> {
 			...Object.entries(PROVIDER_REMOVED_MODEL_IDS).map(
 				([id, reason]) => `provider-removed: "${id}" excluded from the catalog (${reason})`,
 			),
+			...Object.entries(NON_CHAT_MODEL_IDS).map(
+				([id, reason]) => `non-chat: "${id}" excluded from the chat catalog (${reason})`,
+			),
 			...Object.entries(LIVE_ONLY_MODEL_IDS).map(
 				([id, reason]) => `live-only: "${id}" kept out of the static catalog (${reason})`,
 			),

package/scripts/manual-overrides.ts

@@ -43,7 +43,7 @@ export interface ManualModelOverride {
 
 /**
  * Reasoning effort values sourced from the NaN docs (https://nan.builders/docs/models
- * #controlling-reasoning, checked 2026-09-25).
+ * #controlling-reasoning, checked 2026-09-29).
  *
  * models.dev has NO `reasoning_effort_values` field — only `reasoning_options`
  * (which is [{type:"toggle"}] or []), so this mapping must be hand-maintained
@@ -55,7 +55,10 @@ export interface ManualModelOverride {
  * - glm5.3, glm5.3-flash: fully controllable (low/medium/high/max)
  * - qwen3.6, gemma4: none/minimal skip reasoning, others cap depth
  * - deepseek-v4-flash: any value accepted but model decides per-request
- * - qwen3.8-flash, mimo-v2.5, mimo-v2.6-flash: accepted, depth not adjustable
+ * - qwen3.8-flash, mimo-v2.6-flash: accepted, depth not adjustable
+ *
+ * (mimo-v2.5, which used to share that last row, was removed by NaN — absent
+ * from the docs and from openapi.json, checked 2026-09-29.)
  *
  * A model with reasoning_effort_values=[] means the parameter is accepted but
  * the model manages its own reasoning depth — it is never an error.
@@ -68,13 +71,22 @@ export const REASONING_EFFORT_VALUES: Record<string, string[]> = {
 };
 
 /**
- * Models that NaN serves but models.dev provider nan hasn't listed yet.
- * Mirrors the generator's MANUAL_ONLY_MODEL_IDS — kept in sync so the
- * generator and the tests share the same source.
+ * Provenance for the manual-only mimo-v2.6-flash entry, shared by
+ * MANUAL_ONLY_MODEL_IDS (generator) and MANUAL_ONLY_MODELS (tests) so both
+ * sides assert the exact same string.
+ */
+const MANUAL_ONLY_NOTE =
+	"omnimodal model (text, image, audio input) served by NaN; limits and modalities from https://nan.builders/docs/models#mimo-v2-6-flash (checked 2026-09-25, quotas re-checked 2026-09-29): 1,048,576 context / 131,072 max output / 1.0B monthly quota per member. Reasoning: accepted, depth not adjustable (docs table, checked 2026-09-29). Tool calling: yes. Streaming: yes. Input modalities (pi-representable): text, image (audio not representable in pi's Model type). Fallback entry: emitted only while models.dev provider nan does not list the model — models.dev started listing it on 2026-09-29, so the generator then keeps the models.dev values and attaches this note to that entry instead of emitting a second one.";
+
+/**
+ * Models NaN serves that models.dev provider nan may not list. Mirrors the
+ * generator's MANUAL_ONLY_MODEL_IDS — kept in sync so the generator and the
+ * tests share the same source. An entry stops being emitted as soon as
+ * models.dev lists the model; the note above then rides on the models.dev
+ * entry, so the manual data never vanishes silently.
  */
 export const MANUAL_ONLY_MODEL_IDS: Record<string, string> = {
-	"mimo-v2.6-flash":
-		"omnimodal model (text, image, audio input) served by NaN, not yet listed on models.dev provider nan (checked 2026-09-25); included so the live /models refresh does not hand it UNKNOWN_MODEL_LIMITS. Same limits as mimo-v2.5: 1,048,576 / 131,072 / 1.0B monthly quota per member. Reasoning: accepted, depth not adjustable. Tool calling: yes. Streaming: yes. Input modalities (pi-representable): text, image (audio not representable in pi's Model type).",
+	"mimo-v2.6-flash": MANUAL_ONLY_NOTE,
 };
 
 /**
@@ -89,7 +101,7 @@ export const MANUAL_ONLY_MODELS: Record<string, ManualModelOverride> = {
 		reasoningEffortValues: [],
 		contextWindow: 1_048_576,
 		maxTokens: 131_072,
-		note: "omnimodal model (text, image, audio input) served by NaN, not yet listed on models.dev provider nan (checked 2026-09-25); included so the live /models refresh does not hand it UNKNOWN_MODEL_LIMITS. Same limits as mimo-v2.5: 1,048,576 / 131,072 / 1.0B monthly quota per member. Reasoning: accepted, depth not adjustable. Tool calling: yes. Streaming: yes. Input modalities (pi-representable): text, image (audio not representable in pi's Model type).",
+		note: MANUAL_ONLY_NOTE,
 	},
 };