pi-freeflow 1.1.4 → 1.1.6

package/README.md

@@ -94,10 +94,18 @@ omp plugin link /path/to/pi-freeflow
 
 ---
 
-## 🌐 Setting Up Your Own Egress Relays
+## 🌐 Setting Up Your Own Egress Relays (Multi-Cloud)
 
-### 1. Cloudflare Worker Relay (Recommended)
-Deploy this script to Cloudflare Workers (100,000 free requests/day):
+By default, FreeFlow works out of the box with direct upstream calls. To expand concurrency, bypass IP rate limits, and enable rolling failover, you can connect your own free cloud relays across **Cloudflare Workers**, **Vercel Edge**, **Deno Deploy**, or a **Linux VPS**.
+
+---
+
+### 1. Cloudflare Worker Relay (Recommended ⭐)
+> **Free Tier**: 100,000 requests/day · Low latency · No 25-second execution timeout.
+
+1. Go to [dash.cloudflare.com](https://dash.cloudflare.com) $\to$ **Workers & Pages** $\to$ **Create application** $\to$ **Create Worker**.
+2. Name your worker (e.g. `my-freeflow-relay`) $\to$ click **Deploy**.
+3. Click **Edit code**, paste this JavaScript, and click **Save and Deploy**:
 
 ```javascript
 const ALLOWED_TARGETS = ["https://opencode.ai", "https://api.kilo.ai"];
@@ -108,8 +116,9 @@ export default {
       return new Response(null, {
         headers: {
           "Access-Control-Allow-Origin": "*",
-          "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+          "Access-Control-Allow-Methods": "GET, POST, OPTIONS, HEAD",
           "Access-Control-Allow-Headers": "*",
+          "Access-Control-Max-Age": "86400",
         },
       });
     }
@@ -117,8 +126,8 @@ export default {
     const target = request.headers.get("x-relay-target");
     const relayPath = request.headers.get("x-relay-path") || "/";
 
-    if (!target || !ALLOWED_TARGETS.includes(target)) {
-      return new Response(JSON.stringify({ error: "Forbidden target" }), { status: 403 });
+    if (!target || !ALLOWED_TARGETS.includes(target.replace(/\/$/, ""))) {
+      return new Response(JSON.stringify({ error: "Forbidden target" }), { status: 403, headers: { "content-type": "application/json" } });
     }
 
     const targetUrl = target.replace(/\/$/, "") + relayPath;
@@ -126,42 +135,147 @@ export default {
     headers.delete("x-relay-target");
     headers.delete("x-relay-path");
     headers.delete("host");
+    headers.delete("cf-connecting-ip");
+    headers.delete("cf-ray");
+
+    try {
+      const response = await fetch(targetUrl, {
+        method: request.method,
+        headers,
+        body: request.method !== "GET" && request.method !== "HEAD" ? request.body : undefined,
+      });
 
-    const response = await fetch(targetUrl, {
-      method: request.method,
-      headers,
-      body: request.method !== "GET" && request.method !== "HEAD" ? request.body : undefined,
-    });
+      const outHeaders = new Headers(response.headers);
+      outHeaders.set("Access-Control-Allow-Origin", "*");
+      return new Response(response.body, { status: response.status, headers: outHeaders });
+    } catch (err) {
+      return new Response(JSON.stringify({ error: "Upstream failed", details: String(err) }), { status: 502, headers: { "content-type": "application/json" } });
+    }
+  },
+};
+```
 
-    return new Response(response.body, {
-      status: response.status,
-      headers: response.headers,
-    });
-### 2. Vercel Relay
-Deploy using the built-in deploy command:
+4. Copy your Worker URL and register it inside OMP:
+```text
+/freeflow use https://my-freeflow-relay.your-subdomain.workers.dev
+```
+
+---
+
+### 2. Vercel Edge Relay
+> **Free Tier**: 1,000,000 requests/month.
+
+#### Method A: Automated In-Memory CLI Deploy
+1. Generate a Vercel token at [vercel.com/account/tokens](https://vercel.com/account/tokens).
+2. In OMP TUI, run:
 ```text
 /freeflow deploy
 ```
-*(Prompts for your Vercel API token in-memory and automatically creates a private Edge Function relay).*
+*(Prompts for your token in-memory, provisions a private Edge Function, and adds it to your relay pool automatically).*
+
+#### Method B: Manual Git Deploy
+Deploy a Git repository with these 3 files:
+* **`api/relay.js`**:
+  ```javascript
+  const ALLOWED_TARGETS = ["https://opencode.ai", "https://api.kilo.ai"];
+  export const config = { runtime: "edge" };
+  export default async function handler(req) {
+    const target = req.headers.get("x-relay-target");
+    const relayPath = req.headers.get("x-relay-path") || "/";
+    if (!target || !ALLOWED_TARGETS.includes(target.replace(/\/$/, ""))) return new Response(JSON.stringify({ error: "Forbidden" }), { status: 403 });
+    const targetUrl = target.replace(/\/$/, "") + relayPath;
+    const headers = new Headers(req.headers);
+    headers.delete("x-relay-target"); headers.delete("x-relay-path"); headers.delete("host");
+    const response = await fetch(targetUrl, { method: req.method, headers, body: req.method !== "GET" && req.method !== "HEAD" ? req.body : undefined, duplex: "half" });
+    return new Response(response.body, { status: response.status, headers: response.headers });
+  }
+  ```
+* **`package.json`**: `{ "name": "freeflow-relay", "version": "1.0.0" }`
+* **`vercel.json`**: `{ "rewrites": [{ "source": "/(.*)", "destination": "/api/relay" }] }`
+
+---
+
+### 3. Deno Deploy Relay
+> **Free Tier**: 100,000 requests/day.
+
+1. Open [dash.deno.com](https://dash.deno.com) $\to$ **New Project** $\to$ **Playground**.
+2. Paste the following TypeScript code:
+
+```typescript
+const ALLOWED_TARGETS = ["https://opencode.ai", "https://api.kilo.ai"];
+
+Deno.serve(async (req) => {
+  if (req.method === "OPTIONS") {
+    return new Response(null, {
+      headers: {
+        "Access-Control-Allow-Origin": "*",
+        "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+        "Access-Control-Allow-Headers": "*",
+      },
+    });
+  }
+
+  const target = req.headers.get("x-relay-target");
+  const relayPath = req.headers.get("x-relay-path") || "/";
+  if (!target || !ALLOWED_TARGETS.includes(target.replace(/\/$/, ""))) {
+    return new Response(JSON.stringify({ error: "Forbidden target" }), { status: 403 });
+  }
+
+  const targetUrl = target.replace(/\/$/, "") + relayPath;
+  const headers = new Headers(req.headers);
+  headers.delete("x-relay-target");
+  headers.delete("x-relay-path");
+  headers.delete("host");
+
+  const response = await fetch(targetUrl, {
+    method: req.method,
+    headers,
+    body: req.method !== "GET" && req.method !== "HEAD" ? req.body : undefined,
+  });
+  return new Response(response.body, { status: response.status, headers: response.headers });
+});
+```
+3. Click **Deploy** and copy your Deno project URL (`https://project-name.deno.dev`).
+
+---
+
+## 🎮 Managing Relays in FreeFlow
+
+Inside the OMP / Pi TUI:
+```text
+/freeflow use <URL>     # Set active relay and add to saved pool
+/freeflow list          # View all saved relays with status indicators (★ = active)
+/freeflow status        # Check current relay health and egress mode
+/freeflow refresh       # Trigger live on-demand model catalog sync from upstream APIs
+/freeflow on            # Force enable relay egress mode
+/freeflow off           # Switch to direct upstream mode
+/freeflow remove <URL>  # Remove an inactive relay from pool
+/freeflow logs          # Show last 25 lines of debug logs
+```
 
 ---
 
 ## 🛠️ Diagnostics & Troubleshooting
 
 ### Custom Port Configuration
-By default, `pi-freeflow` uses a **Single Shared Port** (`18080`). All concurrent sub-agents automatically share the same master proxy port without spawning redundant servers.
+By default, `pi-freeflow` uses a **Single Shared Master Port** (`18080`). All concurrent sub-agents automatically reuse this master proxy without spawning redundant servers or extra sockets.
 
 To change the base port:
 ```env
 FREEFLOW_PORT=19000
 ```
 
-View live debug logs:
+### Subagent Credentials
+If subagents report missing provider keys, verify `~/.omp/agent/.env`:
+```env
+FREEFLOW_API_KEY=freeflow
+```
+
+### Live Logs
 ```bash
-cat ~/.pi/agent/pi-freeflow.log | tail -n 30
-# or inside OMP:
-/freeflow logs
+cat ~/.pi/agent/pi-freeflow.log | tail -n 40
 ```
+
 ---
 
 ## 📄 License

package/extensions/index.ts

@@ -1729,12 +1729,46 @@ export default async function (pi: ExtensionAPI) {
 	pi.registerCommand("freeflow", commandSpec);
 	pi.registerCommand("bansos", commandSpec);
 
-	// Reload persisted state on session start/resume (env overrides still win).
+	function updateStatusBar(ui?: ExtensionContext["ui"], providerName?: string) {
+		if (!ui) return;
+		if (relayState.enabled && relayState.relays.length > 0) {
+			const label = shortRelayLabel(relayState.url);
+			const idx = Math.max(
+				1,
+				relayState.relays.findIndex((r) => r.url === relayState.url) + 1,
+			);
+			const total = relayState.relays.length;
+			ui.setStatus?.("freeflow", `relay: ON | ${label} ${idx}/${total}`);
+		} else {
+			ui.setStatus?.("freeflow", undefined);
+		}
+		ui.setStatus?.("bansos", undefined);
+	}
+
+	// Reload persisted state on session start/resume and show status if active
 	pi.on?.("session_start", async (_event, ctx) => {
 		relayState = resolveRelayState();
 		statusUi = ctx.ui;
-		ctx.ui?.setStatus?.("freeflow", undefined);
-		ctx.ui?.setStatus?.("bansos", undefined);
+		updateStatusBar(ctx.ui);
+	});
+
+	// Update status bar immediately when user switches models
+	pi.on?.("model_select", async (event, ctx) => {
+		statusUi = ctx.ui;
+		const model =
+			event && typeof event === "object" && "model" in event
+				? event.model
+				: null;
+		const provider =
+			model && typeof model === "object" && "provider" in model
+				? String(model.provider)
+				: null;
+		if (provider === "freeflow") {
+			updateStatusBar(ctx.ui, "freeflow");
+		} else if (provider) {
+			// Clear status when switched to other providers (e.g. anthropic, openai)
+			ctx.ui?.setStatus?.("freeflow", undefined);
+		}
 	});
 
 	// Pi normally pauses after threshold compaction. Queue a follow-up while the

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "pi-freeflow",
 	"type": "module",
-	"version": "1.1.4",
+	"version": "1.1.6",
 	"description": "Personal multi-cloud rolling fallback relay for OpenCode Zen and KiloCode models in OMP/Pi",
 	"keywords": [
 		"pi-package",