pi-freeflow 1.3.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +12 -14
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,22 +1,20 @@
1
1
  # pi-freeflow
2
2
 
3
- > 🌊 **FreeFlow**: Free AI Model Provider for [Oh My Pi (OMP)](https://omp.sh) and [Pi](https://pi.dev) with **Multi-Cloud Rolling Relay** (Cloudflare Workers / Vercel), **Up to 1M Context Windows**, **Auto-Switch Failover**, and **Real-Time Streaming**.
3
+ > 🌊 **FreeFlow** — Thin provider for [Oh My Pi (OMP)](https://omp.sh) & [Pi](https://pi.dev): **model list + relay proxy + log**. The rest (thinking, normalization, provider composition) is handled by the host `pi-ai` system — `pi-freeflow` just provides 23 free models via a multi-cloud rolling relay.
4
4
 
5
5
  ---
6
6
 
7
- ## ✨ Features
8
-
9
- - 🆓 **23 Free Models**: Curated access to OpenCode Zen and KiloCode free AI models.
10
- - 🧠 **Full 1M Context Windows**: Pre-configured with up to 1,048,576 tokens context window and vision (image) support.
11
- - ⚡ **Real-Time SSE Streaming**: Zero-buffering chunk streaming with instant token delivery.
12
- - 🛡️ **Multi-Cloud Rolling Egress Relay**:
13
- - Support for **Cloudflare Workers**, **Vercel Edge**, and **Deno Deploy**.
14
- - **Sticky Active Proxy**: Stays on the healthy proxy without unnecessary round-robin churn.
15
- - **Auto-Switch Failover**: Instantly rolls to the next proxy when encountering `HTTP 429` (Rate Limit), `502/503/504`, or Network Timeouts.
16
- - **Direct Fallback**: Transparently falls back to direct upstream if all relays are exhausted.
17
- - 🔇 **Full Quiet Mode**: Clean status bar indicators without intrusive console overlays in the TUI.
18
- - 📝 **Persistent Background Logging**: Automatic diagnostic logs recorded to `~/.pi/agent/pi-freeflow.log` with 5MB auto-rotation.
19
- - 🤖 **Sub-Agent Ready**: Seamlessly shared across concurrent parallel sub-agent tasks.
7
+ ## ✨ Features — Minimal by Design
8
+
9
+ `pi-freeflow` is **thin**: **model list + relay proxy + log**. Host `pi-ai`/OMP owns thinking, normalization, and provider composition.
10
+
11
+ - 📋 **23 Free Models** — `9 OpenCode Zen + 14 Kilo` via host `fetchDynamicModels` (24h cache, disk-only, no subagent live fetch)
12
+ - 🌐 **Dumb Relay Proxy** — `http://127.0.0.1:18080` dumb pipe: `x-relay-target/path` → 7-pool (CF Workers + Vercel Edge) round-robin seamless `429` roll → direct fallback; host already normalized `reasoning_effort`/`thinking`
13
+ - 📝 **Persistent Log** — `~/.pi/agent/pi-freeflow.log` 5MB rotate, `pi-freeflow-debug.json` toggle, `GET /v1/models` pathname-guarded (no `?query` paid leak)
14
+ - 🤖 **Sub-agent Ready** — shared daemon `18080` (or `18081` fallback) reused across parallel subagents; round-robin primary + `willUseRelay` bypass prevents local `127.0.0.1` 429
15
+ - ⚡ **SSE Streaming** — zero-buffer chunk pipe, `thinking_delta` pass-through (host parses)
16
+
17
+ > **Philosophy:** *model list + relay proxy + log — the rest is Pi.* No `src/normalizer.ts` duplication; `pi-ai` owns `compat.thinkingFormat` (11 variants), `clampThinkingBudgetToAnswerRoom`, `transformMessages`.
20
18
 
21
19
  ---
22
20
 
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "pi-freeflow",
3
3
  "type": "module",
4
- "version": "1.3.0",
5
- "description": "Multi-cloud rolling fallback relay for OpenCode Zen and KiloCode free models in Oh My Pi (OMP) and Pi",
4
+ "version": "1.3.1",
5
+ "description": "Thin provider for OMP/Pi — model list + dumb relay proxy + log; host pi-ai owns thinking/normalization",
6
6
  "main": "extensions/index.ts",
7
7
  "types": "src/index.ts",
8
8
  "keywords": [