pi-umans-provider 1.0.3 → 1.0.5

package/AGENTS.md

@@ -7,6 +7,7 @@ The following files are **idempotent** and regenerated by `scripts/update-models
 | File | Why it's auto-generated |
 |------|------------------------|
 | `models.json` | Built from the provider API. `update-models.js` fetches models, preserves curated data for known IDs, and writes this file. |
+| `deprecated-models.json` | Graveyard for models the API delisted. update-models.js stamps them with deprecatedAt and pi keeps serving them for a 2-week grace period, then evicts them. Never edit by hand. |
 | `README.md` (model table) | The table under `## Available Models` is replaced in-place by `update-models.js` after merging base models → patch → custom models. |
 
 ## Correct Files to Edit

package/README.md

@@ -28,9 +28,11 @@ _A [pi](https://github.com/earendil-works/pi-coding-agent) provider extension wi
 | Model | Base | Context | Vision | Reasoning | Max Output |
 |-------|------|---------|--------|-----------|------------|
 | Coder | Kimi K2.7-Code | 262K | ✅ | ✅ | 33K |
+| DeepSeek V4 Flash (experimental) | DeepSeek-V4-Flash | 1.0M | ❌ | ✅ | 393K |
 | Flash | Qwen3.6-35B-A3B | 262K | ✅ | ✅ | 33K |
 | GLM 5.2 | GLM-5.2 | 406K | ❌ | ✅ | 131K |
 | Kimi K2.7 Code | Kimi K2.7-Code | 262K | ✅ | ✅ | 33K |
+| Kimi K3 | Kimi K3 | 1.0M | ✅ | ✅ | 131K |
 | Qwen3.6 35B A3B | Qwen3.6-35B-A3B | 262K | ✅ | ✅ | 33K |
 
 > **Note:** `umans-flash-beta` is deprecated (sunset 2026-06-07). Use `umans-flash` instead.

package/deprecated-models.json

@@ -0,0 +1 @@
+{}

package/index.ts

@@ -42,6 +42,7 @@ import type { OAuthLoginCallbacks } from "@earendil-works/pi-ai";
 import modelsData from "./models.json" with { type: "json" };
 import customModelsData from "./custom-models.json" with { type: "json" };
 import patchData from "./patch.json" with { type: "json" };
+import deprecatedData from "./deprecated-models.json" with { type: "json" };
 import fs from "fs";
 import path from "path";
 
@@ -192,7 +193,10 @@ function applyPatch(model: JsonModel, patch: PatchEntry): JsonModel {
 function buildModels(base: JsonModel[], custom: JsonModel[], patch: PatchData): JsonModel[] {
   const modelMap = new Map<string, JsonModel>();
 
-  for (const model of base) {
+  // Seed with the base list plus grace-period deprecated models so patch.json
+  // entries apply to deprecated models exactly as while the model was live
+  // (withDeprecated keeps live data on id conflicts).
+  for (const model of withDeprecated(base)) {
     modelMap.set(model.id, model);
   }
 
@@ -324,6 +328,35 @@ function mergeWithEmbedded(liveModels: JsonModel[], embeddedModels: JsonModel[])
   return result;
 }
 
+// Grace period for delisted models. When the provider API stops listing a
+// model, update-models.js moves its last-known definition into
+// deprecated-models.json (stamped with deprecatedAt) instead of dropping it.
+// For 14 days the model keeps working here so in-flight sessions and saved
+// model settings do not break; afterwards it is evicted permanently.
+const DEPRECATED_MODEL_TTL_MS = 14 * 24 * 60 * 60 * 1000;
+
+// Grace-period deprecated models with deprecation metadata stripped.
+function activeDeprecatedModels(): JsonModel[] {
+  const now = Date.now();
+  const result: JsonModel[] = [];
+  for (const entry of Object.values(deprecatedData as Record<string, JsonModel & { deprecatedAt?: string }>)) {
+    if (!entry?.id) continue;
+    const removedAt = Date.parse(entry.deprecatedAt ?? "");
+    if (Number.isNaN(removedAt) || now - removedAt > DEPRECATED_MODEL_TTL_MS) continue;
+    const model = { ...entry } as JsonModel & { deprecatedAt?: string };
+    delete model.deprecatedAt;
+    result.push(model);
+  }
+  return result;
+}
+
+// Append grace-period deprecated models the list does not already have (live data wins).
+function withDeprecated(models: JsonModel[]): JsonModel[] {
+  const seen = new Set(models.map((m) => m.id));
+  const extras = activeDeprecatedModels().filter((m) => !seen.has(m.id));
+  return extras.length > 0 ? [...models, ...extras] : models;
+}
+
 function loadStaleModels(embeddedModels: JsonModel[]): JsonModel[] {
   const cached = loadCachedModels();
   if (!cached || cached.length === 0) return embeddedModels;

package/models.json

@@ -16,6 +16,22 @@
     "contextWindow": 262144,
     "maxTokens": 32768
   },
+  {
+    "id": "umans-deepseek-v4-flash-0731",
+    "name": "Umans DeepSeek V4 Flash (experimental)",
+    "reasoning": true,
+    "input": [
+      "text"
+    ],
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "contextWindow": 1048576,
+    "maxTokens": 393215
+  },
   {
     "id": "umans-flash",
     "name": "Umans Flash",
@@ -66,6 +82,23 @@
     "contextWindow": 262144,
     "maxTokens": 32768
   },
+  {
+    "id": "umans-kimi-k3",
+    "name": "Umans Kimi K3",
+    "reasoning": true,
+    "input": [
+      "text",
+      "image"
+    ],
+    "cost": {
+      "input": 0,
+      "output": 0,
+      "cacheRead": 0,
+      "cacheWrite": 0
+    },
+    "contextWindow": 1048576,
+    "maxTokens": 131071
+  },
   {
     "id": "umans-qwen3.6-35b-a3b",
     "name": "Umans Qwen3.6 35B A3B",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-umans-provider",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "UMANS provider extension for pi - Access Kimi K2.6, GLM 5.1, Qwen 3.6, and coding-optimized models through the UMANS API",
   "type": "module",
   "main": "index.ts",

package/patch.json

@@ -1,6 +1,8 @@
 {
   "umans-coder": {
-    "thinkingLevelMap": { "off": "none" },
+    "thinkingLevelMap": {
+      "off": "none"
+    },
     "compat": {
       "supportsDeveloperRole": false,
       "supportsReasoningEffort": true,
@@ -8,15 +10,9 @@
     }
   },
   "umans-flash": {
-    "thinkingLevelMap": { "off": "none" },
-    "compat": {
-      "supportsDeveloperRole": false,
-      "supportsReasoningEffort": true,
-      "requiresReasoningContentOnAssistantMessages": true
-    }
-  },
-  "umans-kimi-k2.6": {
-    "thinkingLevelMap": { "off": "none" },
+    "thinkingLevelMap": {
+      "off": "none"
+    },
     "compat": {
       "supportsDeveloperRole": false,
       "supportsReasoningEffort": true,
@@ -24,43 +20,71 @@
     }
   },
   "umans-kimi-k2.7": {
-    "thinkingLevelMap": { "off": "none" },
+    "thinkingLevelMap": {
+      "off": "none"
+    },
     "compat": {
       "supportsDeveloperRole": false,
       "supportsReasoningEffort": true,
       "requiresReasoningContentOnAssistantMessages": true
     }
   },
-  "umans-glm-5.1": {
-    "thinkingLevelMap": { "off": "none" },
+  "umans-glm-5.2": {
+    "thinkingLevelMap": {
+      "off": "none"
+    },
     "compat": {
       "supportsDeveloperRole": false,
       "supportsReasoningEffort": true,
       "requiresReasoningContentOnAssistantMessages": true
     }
   },
-  "umans-glm-5.2": {
-    "thinkingLevelMap": { "off": "none" },
+  "umans-qwen3.6-35b-a3b": {
+    "thinkingLevelMap": {
+      "off": "none"
+    },
     "compat": {
       "supportsDeveloperRole": false,
       "supportsReasoningEffort": true,
       "requiresReasoningContentOnAssistantMessages": true
     }
   },
-  "umans-glm-5.2-nvfp4": {
-    "thinkingLevelMap": { "off": "none" },
+  "umans-deepseek-v4-flash-0731": {
+    "reasoning": true,
+    "thinkingLevelMap": {
+      "off": "none",
+      "minimal": null,
+      "low": "high",
+      "medium": "high",
+      "high": "high",
+      "xhigh": null,
+      "max": "max"
+    },
     "compat": {
-      "supportsDeveloperRole": false,
-      "supportsReasoningEffort": true,
-      "requiresReasoningContentOnAssistantMessages": true
+      "thinkingFormat": "openai",
+      "maxTokensField": "max_tokens",
+      "supportsReasoningEffort": true
     }
   },
-  "umans-qwen3.6-35b-a3b": {
-    "thinkingLevelMap": { "off": "none" },
+  "umans-kimi-k3": {
+    "reasoning": true,
+    "input": [
+      "text",
+      "image"
+    ],
+    "thinkingLevelMap": {
+      "off": null,
+      "minimal": null,
+      "low": "low",
+      "medium": null,
+      "high": "high",
+      "xhigh": null,
+      "max": "max"
+    },
     "compat": {
-      "supportsDeveloperRole": false,
-      "supportsReasoningEffort": true,
-      "requiresReasoningContentOnAssistantMessages": true
+      "thinkingFormat": "openai",
+      "maxTokensField": "max_tokens",
+      "supportsReasoningEffort": true
     }
   }
 }

package/scripts/update-models.js

@@ -154,6 +154,67 @@ function cleanModelForJson(model) {
   return cleanModel;
 }
 
+// Grace period for delisted models: update-models.js moves models the API no
+// longer lists into deprecated-models.json (stamped with deprecatedAt) instead
+// of dropping them; the runtime appends them back so sessions and saved model
+// settings keep working, and after 14 days they are evicted permanently.
+const DEPRECATED_MODEL_TTL_MS = 14 * 24 * 60 * 60 * 1000;
+
+/**
+ * Reconcile deprecated-models.json against the freshly fetched model list.
+ * - in old models.json but not the API: moved into the deprecated file
+ *   (deprecatedAt = now; preserved on repeat runs so the grace clock is not reset)
+ * - back in the API: resurrected (dropped from the deprecated file)
+ * - deprecatedAt older than 14 days: evicted permanently
+ * Must run BEFORE the new models.json is written; it reads the old file itself.
+ */
+function updateDeprecatedModels(modelsJsonPath, newModels) {
+  const deprecatedPath = path.join(path.dirname(modelsJsonPath), 'deprecated-models.json');
+
+  let oldModels = [];
+  try {
+    const parsed = JSON.parse(fs.readFileSync(modelsJsonPath, 'utf8'));
+    if (Array.isArray(parsed)) oldModels = parsed;
+  } catch { /* first run: no previous models.json */ }
+
+  let deprecated = {};
+  try {
+    const parsed = JSON.parse(fs.readFileSync(deprecatedPath, 'utf8'));
+    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) deprecated = parsed;
+  } catch { /* no graveyard yet */ }
+
+  const currentIds = new Set(newModels.map(m => m.id));
+  const now = new Date().toISOString();
+  const added = [];
+  const resurrected = [];
+  const evicted = [];
+
+  for (const old of oldModels) {
+    if (old && old.id && !currentIds.has(old.id) && !deprecated[old.id]) {
+      deprecated[old.id] = { ...old, deprecatedAt: now };
+      added.push(old.id);
+    }
+  }
+
+  for (const [id, entry] of Object.entries(deprecated)) {
+    if (currentIds.has(id)) {
+      delete deprecated[id];
+      resurrected.push(id);
+      continue;
+    }
+    const removedAt = Date.parse(entry && entry.deprecatedAt ? entry.deprecatedAt : '');
+    if (Number.isNaN(removedAt) || Date.now() - removedAt > DEPRECATED_MODEL_TTL_MS) {
+      delete deprecated[id];
+      evicted.push(id);
+    }
+  }
+
+  if (added.length > 0 || resurrected.length > 0 || evicted.length > 0) {
+    fs.writeFileSync(deprecatedPath, JSON.stringify(deprecated, null, 2) + '\n');
+    console.log('Updated deprecated-models.json ' + JSON.stringify({ added, resurrected, evicted }));
+  }
+}
+
 async function main() {
   console.log(`Fetching models from ${MODELS_INFO_API_URL}...`);
 
@@ -214,6 +275,8 @@ async function main() {
 
     // Update models.json — pure API data, no patches baked in
     const cleanModels = apiTransformed.map(cleanModelForJson);
+    // Move delisted models to deprecated-models.json BEFORE models.json is overwritten
+    updateDeprecatedModels(MODELS_JSON_PATH, cleanModels);
     fs.writeFileSync(MODELS_JSON_PATH, JSON.stringify(cleanModels, null, 2) + "\n");
     console.log("✓ Updated models.json (pure API data)");