pi-clinepass 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -2,9 +2,18 @@
 
 All notable changes to this project will be documented in this file.
 
-## 0.1.5 - 2026-09-12
+## 0.1.7 - 2026-10-01
 
-- New paid model: `cline-pass/deepseek-v4.1-flash` (measured rates pending calibration)
+- Retired model removed: `cline-free/gemini-3.8-flash` (dropped from the gateway's free tier)
+- Free-route client headers track the latest CLI release
+
+## 0.1.6 - 2026-09-25
+
+- New free models: `cline-free/gemini-3.8-flash` (mandatory low/medium/high reasoning), `stealth/space-bunny-alpha`, `cline-free/mimo-v2.6-flash`, and `cline-free/deepseek-v4.1-flash`
+- New paid model: `cline-pass/muse-spark-1.3-contributor` ($0.10/$0.20/$0.01)
+- Retired models removed from catalog
+- Error classification refined: upstream provider errors, 402 (insufficient credits), 404 (model not found), and 5xx gateway errors no longer misclassified as expired auth
+- Free-route client headers updated to latest CLI convention
 
 ## 0.1.4 - 2026-09-09
 

package/README.md

@@ -25,7 +25,7 @@ Dollar-based limits, live cost tracking, and plan cap reporting.
 
 ## Highlights
 
-- **22 Models**: 16 ClinePass models on a dollar-based limit system plus 6 free tier models
+- **16 Models**: 12 ClinePass models on a dollar-based limit system plus 4 free tier models
 - **Live Status Meter**: Per-turn and session cost directly in the pi footer
 - **Plan Utilization**: 5-hour, weekly, and monthly caps tracked via `/clinepass`
 - **Price Calibration**: measure real gateway billing from `/clinepass` to keep displayed prices honest

package/package.json

@@ -1,54 +1,54 @@
-{
-  "name": "pi-clinepass",
-  "version": "0.1.5",
-  "description": "ClinePass for pi — static measured-price catalog, server-truth billing meter, free models",
-  "keywords": [
-    "ai",
-    "cline",
-    "cline-pass",
-    "clinepass",
-    "pi",
-    "pi-coding-agent",
-    "pi-package",
-    "pi-extension"
-  ],
-  "license": "MIT",
-  "author": "fifidayone",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/fifidayone/pi-clinepass.git"
-  },
-  "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
-  "files": [
-    "src",
-    "CHANGELOG.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
-  },
-  "devDependencies": {
-    "@types/node": "^26.3.0",
-    "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
-  },
-  "pi": {
-    "extensions": [
-      "./src/index.ts"
-    ],
-    "image": "https://raw.githubusercontent.com/fifidayone/pi-clinepass/main/assets/report.png"
-  }
-}
+{
+  "name": "pi-clinepass",
+  "version": "0.1.7",
+  "description": "ClinePass for pi — static measured-price catalog, server-truth billing meter, free models",
+  "keywords": [
+    "ai",
+    "cline",
+    "cline-pass",
+    "clinepass",
+    "pi",
+    "pi-coding-agent",
+    "pi-package",
+    "pi-extension"
+  ],
+  "license": "MIT",
+  "author": "fifidayone",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fifidayone/pi-clinepass.git"
+  },
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "src",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^26.3.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ],
+    "image": "https://raw.githubusercontent.com/fifidayone/pi-clinepass/main/assets/report.png"
+  }
+}

package/src/catalog.ts

@@ -164,28 +164,23 @@ function model(
 /** Measured prices ($/1M tokens: input/output/cacheRead) — latest verified. */
 export const MODELS: readonly ClinePassModel[] = [
   // ── Free models (Cline free tier, cost 0) ──────────────────────────────
-  model("cline-free/longcat-2.0", "LongCat 2.0", [0, 0, 0], 921_600, 131_072, ["text"], ALL_THINKING),
-  model("z-ai/glm-5.3-flash", "GLM-5.3 Flash", [0, 0, 0], 921_600, 131_072, ["text", "image"], MAX_HIGH_LOW_MANDATORY),
-  model("deepseek/deepseek-v4-flash", "DeepSeek V4 Flash", [0, 0, 0], 921_600, 131_072, ["text"], MAX_HIGH_LOW),
-  model("poolside/laguna-s-2.1:free", "Laguna S-2.1", [0, 0, 0], 262_144, 131_072, ["text"], ALL_THINKING),
-  model("cline-free/solar-pro4", "Solar Pro 4", [0, 0, 0], 524_288, 131_072, ["text"], OFF_MEDIUM_HIGH),
+  model("stealth/space-bunny-alpha", "Space Bunny Alpha", [0, 0, 0], 921_600, 131_072, ["text", "image"], ALL_THINKING),
+  model("cline-free/mimo-v2.6-flash", "MiMo-V2.6-Flash", [0, 0, 0], 921_600, 131_072, ["text", "image"], ALL_THINKING),
+  model("cline-free/deepseek-v4.1-flash", "DeepSeek V4.1 Flash", [0, 0, 0], 921_600, 131_072, ["text", "image"], MAX_HIGH_LOW),
   model("cline-free/muse-spark-1.3-contributor", "Muse Spark 1.3 Contributor", [0, 0, 0], 921_600, 131_072, ["text", "image"], MANDATORY_NO_MAX),
   // ── ClinePass models (measured billing prices) ─────────────────────────
-  model("cline-pass/glm-5.3-flash", "GLM-5.3 Flash", [0.15, 0.5, 0.03], 921_600, 131_072, ["text", "image"], MAX_HIGH_LOW_MANDATORY),
   model("cline-pass/glm-5.3", "GLM-5.3", [1.4, 4.4, 0.26], 921_600, 131_072, ["text"], MAX_HIGH_LOW_MANDATORY),
-  model("cline-pass/glm-5.2", "GLM-5.2", [1.4, 4.4, 0.26], 921_600, 131_072, ["text"], XHIGH_HIGH),
-  model("cline-pass/kimi-k2.7-code", "Kimi K2.7 Code", [1.58, 6.67, 0.32], 262_144, 131_072, ["text", "image"], ALL_MANDATORY),
-  model("cline-pass/kimi-k2.6", "Kimi K2.6", [1.58, 6.67, 0.27], 262_144, 131_072, ["text", "image"], ALL_THINKING),
+  model("cline-pass/glm-5.3-flash", "GLM-5.3 Flash", [0.15, 0.5, 0.03], 921_600, 131_072, ["text", "image"], MAX_HIGH_LOW_MANDATORY),
   model("cline-pass/kimi-k3", "Kimi K3", [6.0, 30.0, 0.6], 921_600, 131_072, ["text", "image"], MAX_HIGH_LOW),
   model("cline-pass/deepseek-v4-pro", "DeepSeek V4 Pro", [1.65, 4.95, 0.06], 921_600, 131_072, ["text"], MAX_HIGH_LOW),
   model("cline-pass/deepseek-v4.1-flash", "DeepSeek V4.1 Flash", [0.3, 1.2, 0.006], 921_600, 131_072, ["text", "image"], MAX_HIGH_LOW),
-  model("cline-pass/deepseek-v4-flash", "DeepSeek V4 Flash", [0.44, 1.32, 0.014], 921_600, 131_072, ["text"], MAX_HIGH_LOW),
   model("cline-pass/mimo-v2.5", "MiMo-V2.5", [0.14, 0.28, 0.0028], 921_600, 131_072, ["text", "image"], ALL_THINKING),
   model("cline-pass/mimo-v2.5-pro", "MiMo-V2.5-Pro", [0.435, 0.87, 0.0036], 921_600, 131_072, ["text"], ALL_THINKING),
   model("cline-pass/minimax-m3", "MiniMax M3", [0.5, 2.0, 0.1], 921_600, 131_072, ["text", "image"], ALL_THINKING),
-  model("cline-pass/qwen3.7-plus", "Qwen3.7 Plus", [0.67, 2.67, 0.07], 921_600, 131_072, ["text", "image"], ALL_THINKING),
-  model("cline-pass/qwen3.7-max", "Qwen3.7 Max", [4.17, 12.5, 0.83], 921_600, 131_072, ["text"], ALL_THINKING),
+  model("cline-pass/muse-spark-1.3-contributor", "Muse Spark 1.3 Contributor", [0.10, 0.20, 0.01], 921_600, 131_072, ["text", "image"], MANDATORY_NO_MAX),
   model("cline-pass/qwen3.8-max", "Qwen3.8 Max", [2.75, 8.25, 0.34], 921_600, 131_072, ["text", "image"], XHIGH_MEDIUM_LOW),
+  model("cline-pass/qwen3.7-max", "Qwen3.7 Max", [4.17, 12.5, 0.83], 921_600, 131_072, ["text"], ALL_THINKING),
+  model("cline-pass/qwen3.7-plus", "Qwen3.7 Plus", [0.67, 2.67, 0.07], 921_600, 131_072, ["text", "image"], ALL_THINKING),
 ];
 
 export function modelIds(): string[] {
@@ -195,5 +190,6 @@ export function modelIds(): string[] {
 /** True for the Cline free-tier models — derived from the catalog itself
  * (cost 0), so adding a free model never needs a second edit here. */
 export function isFreeModel(id: string): boolean {
-  return MODELS.some((m) => m.id === id && m.cost.input === 0);
+  const normalized = id.startsWith("clinepass/") ? id.slice(10) : id;
+  return MODELS.some((m) => m.id === normalized && m.cost.input === 0);
 }

package/src/errors.ts

@@ -16,6 +16,10 @@ export type ClinePassErrorType =
   | "rate_limited"
   | "free_limit_reached"
   | "free_route_forbidden"
+  | "insufficient_credits"
+  | "model_not_found"
+  | "upstream_error"
+  | "server_error"
   | "unknown";
 
 function matchesAny(text: string, patterns: string[]): boolean {
@@ -35,7 +39,15 @@ export const CLINEPASS_ERROR_MESSAGES: Record<ClinePassErrorType, string> = {
   free_route_forbidden:
     "Free model route unavailable (HTTP 403). The free route is gated to Cline product " +
     "surfaces — retry in a moment, or switch to a ClinePass model.",
-  unknown: "ClinePass request failed. Check your subscription at app.cline.bot or run `pi /login`.",
+  insufficient_credits:
+    "Insufficient Cline credits. Top up your balance at app.cline.bot/credits or switch to a free/subscription model.",
+  model_not_found:
+    "Model not found on Cline gateway (HTTP 404). Run `/model` to select an available model.",
+  upstream_error:
+    "Upstream model provider error. The model host returned an error — retry in a moment, or switch to another model.",
+  server_error:
+    "Cline gateway server error. The service is temporarily unavailable — please retry in a moment.",
+  unknown: "ClinePass request failed. Please check app.cline.bot or try again later.",
 };
 
 /**
@@ -52,23 +64,50 @@ export function classifyClinePassError(
 } {
   const lower = errorMessage.toLowerCase();
 
-  if (matchesAny(lower, ["401", "unauthorized", "invalid api key", "invalid_api_key"])) {
-    return { type: "auth_expired", message: CLINEPASS_ERROR_MESSAGES.auth_expired };
+  // 1. Upstream Provider / Inference host errors:
+  // Must precede auth checks because upstream errors (e.g. OpenRouter/Meta/DeepSeek)
+  // often forward payloads containing "401" or "invalid_api_key" from the host,
+  // which does not mean the user's ClinePass authentication has expired.
+  if (
+    matchesAny(lower, [
+      "provider returned error",
+      "failed to generate stream from openrouter",
+      "openrouter",
+      "inference request failed",
+      "failed to invoke model",
+      "provider_error_code",
+    ])
+  ) {
+    return { type: "upstream_error", message: CLINEPASS_ERROR_MESSAGES.upstream_error };
   }
-  if (matchesAny(lower, ["429", "rate limit", "too many requests", "rate_limit"])) {
-    return { type: "rate_limited", message: CLINEPASS_ERROR_MESSAGES.rate_limited };
+
+  // 2. Insufficient Credits (HTTP 402)
+  if (matchesAny(lower, ["insufficient_credits", "insufficient balance", "buy_credits_url", "402"])) {
+    return { type: "insufficient_credits", message: CLINEPASS_ERROR_MESSAGES.insufficient_credits };
   }
+
+  // 3. Model Not Found (HTTP 404)
+  if (matchesAny(lower, ["model not found", "model_not_found"]) || /\b404\b/.test(lower)) {
+    return { type: "model_not_found", message: CLINEPASS_ERROR_MESSAGES.model_not_found };
+  }
+
+  // 4. Rate Limits & Free limits
   if (matchesAny(lower, ["free limit reached", "free limit", "try again in"])) {
     return { type: "free_limit_reached", message: CLINEPASS_ERROR_MESSAGES.free_limit_reached };
   }
+  if (matchesAny(lower, ["rate limit", "too many requests", "rate_limit"]) || /\b429\b/.test(lower)) {
+    return { type: "rate_limited", message: CLINEPASS_ERROR_MESSAGES.rate_limited };
+  }
+
+  // 5. Subscription & Route Access (HTTP 403)
   if (
     matchesAny(lower, [
-      "403",
-      "forbidden",
       "subscription required",
       "not subscribed",
       "organization accounts cannot use",
-    ])
+      "forbidden",
+    ]) ||
+    /\b403\b/.test(lower)
   ) {
     // Every free-tier route is gated to Cline product surfaces — a 403 on a
     // free model is a route-gate rejection, not a subscription problem.
@@ -77,6 +116,28 @@ export function classifyClinePassError(
     }
     return { type: "not_subscribed", message: CLINEPASS_ERROR_MESSAGES.not_subscribed };
   }
+
+  // 6. Gateway / Server 5xx Errors
+  if (
+    matchesAny(lower, [
+      "bad gateway",
+      "service unavailable",
+      "gateway timeout",
+      "internal server error",
+    ]) ||
+    /\b(500|502|503|504)\b/.test(lower)
+  ) {
+    return { type: "server_error", message: CLINEPASS_ERROR_MESSAGES.server_error };
+  }
+
+  // 7. Client Authentication (genuine 401 / unauthorized from Cline gateway)
+  if (
+    matchesAny(lower, ["unauthorized", "invalid api key", "invalid_api_key"]) ||
+    /\b401\b/.test(lower)
+  ) {
+    return { type: "auth_expired", message: CLINEPASS_ERROR_MESSAGES.auth_expired };
+  }
+
   return { type: "unknown", message: CLINEPASS_ERROR_MESSAGES.unknown };
 }
 

package/src/headers.ts

@@ -11,7 +11,7 @@
 import { release } from "node:os";
 import { isFreeModel } from "./catalog.js";
 
-const FALLBACK_CLINE_VERSION = "3.0.61";
+const FALLBACK_CLINE_VERSION = "3.0.67";
 const VERSION_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 const NPM_REGISTRY_URL = "https://registry.npmjs.org/cline/latest";
 
@@ -73,11 +73,14 @@ export function needsFreeModelHeaders(modelId: string): boolean {
 export function buildFreeModelHeadersSync(): Record<string, string> {
   const version = cachedVersion ?? FALLBACK_CLINE_VERSION;
   return {
-    "x-client-type": "cli",
-    "x-client-version": version,
-    "x-core-version": version,
-    "x-platform": process.platform,
-    "x-platform-version": release(),
-    "user-agent": `Cline/${version}`,
+    "HTTP-Referer": "https://cline.bot",
+    "X-Title": "Cline",
+    "X-IS-MULTIROOT": "false",
+    "X-CLIENT-TYPE": "cline-cli",
+    "X-CLIENT-VERSION": version,
+    "X-CORE-VERSION": version,
+    "X-PLATFORM": process.platform,
+    "X-PLATFORM-VERSION": release(),
+    "User-Agent": `Cline/${version}`,
   };
 }

package/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * pi-clinepass — ClinePass for pi.
  *
- * Registers the `clinepass` provider (14 paid models with measured billing
+ * Registers the `clinepass` provider (12 paid models with measured billing
  * prices + 4 free models) and wires the hooks that keep pi's numbers real:
  *   - message_end → server-truth cost meter + session total + error surface + thinking repair
  *   - before_provider_headers → free-route Cline-CLI headers