pi-freeflow 1.15.0 → 1.15.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.15.2
+
+### Patch Changes
+
+- Relay traffic is now spent only on the free models the pool exists for: requests for other models go straight upstream even with the relay pool on, cutting relay bandwidth. Applies in automatic and always-on modes; relay-off behavior is unchanged.
+- The disabled-deployment rollover now triggers only on genuine hosting verdicts, so ordinary payment and quota refusals always surface immediately without cooling a healthy relay. Relay-list imports also no longer show a negative removal count when the file holds more relays than the current pool.
+
+## 1.15.1
+
+### Patch Changes
+
+- Requests now roll over to the next relay when the current one answers with a disabled-deployment verdict, instead of failing on the first relay and requiring a manual switch. Other payment and quota refusals still surface immediately.
+
+## 1.15.0
+
+### Minor Changes
+
+- Free-tier requests now use native session identifiers and an up-to-date client version, after the upstream gateway began rejecting older formats with a free-tier error. `/freeflow test` also gains an end-to-end chat check that verifies a relay can actually run inference, not just list models.
+
 ## 1.14.0
 
 ### Minor Changes

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-freeflow",
   "type": "module",
-  "version": "1.15.0",
+  "version": "1.15.2",
   "description": "Thin provider for OMP/Pi — model list + dumb relay proxy + log; host pi-ai owns thinking/normalization",
   "main": "extensions/index.ts",
   "types": "src/index.ts",

package/src/proxy.ts

@@ -89,6 +89,21 @@ function withRateLimitHint(status: number, data: string): string {
 	return data;
 }
 
+/**
+ * Relay eligibility: only free-catalog models ride relay egress. Returns true
+ * when the model is a non-empty string present in MODEL_MAP or KILO_MODEL_IDS
+ * (Kilo traffic leaves via its own branch regardless), and when the model is
+ * missing/empty (e.g. GET /v1/models carries no body — preserve routing).
+ * Anything else (unknown/paid model ids, non-strings) goes direct upstream.
+ */
+export function isRelayEligibleModel(model: unknown): boolean {
+	if (model === undefined || model === null) return true;
+	if (typeof model !== "string") return false;
+	if (model.trim() === "") return true;
+	const canonical = resolveCanonicalModelId(model.trim());
+	return MODEL_MAP.has(canonical) || KILO_MODEL_IDS.has(canonical);
+}
+
 /**
  * Extract client IP address from incoming HTTP request.
  */
@@ -692,12 +707,18 @@ export function startProxy(
 						res.end(data);
 					}
 				} else {
-					// OpenCode routing — relay when enabled, else direct upstream
+					// OpenCode routing — relay egress is for free-catalog models
+					// only; unknown/paid models go direct upstream.
 					const relayState = getActiveRelayState();
-					const shouldUseRelay =
+					const relayPoolOn =
 						relayState.mode !== "off" &&
 						relayState.enabled !== false &&
 						Boolean(relayState.url || (relayState.relays && relayState.relays.length > 0));
+					const relayEligible = isRelayEligibleModel(parsedBody?.model);
+					const shouldUseRelay = relayPoolOn && relayEligible;
+					if (relayPoolOn && !relayEligible) {
+						log("info", `relay bypass for non-catalog model ${String(parsedBody?.model ?? "?")} — routing direct upstream`, { model: parsedBody?.model }, reqId);
+					}
 					if (shouldUseRelay) {
 						const fullUrl = `${UPSTREAM_OPENCODE}${req.url ?? "/"}`;
 						const activeHost = relayState.url