pi-freeflow 1.0.5 → 1.0.7

package/README.md

@@ -137,17 +137,6 @@ export default {
       status: response.status,
       headers: response.headers,
     });
-  }
-};
-```
-
-After deploying, register your Cloudflare Worker URL in OMP:
-```text
-/freeflow use https://your-worker-name.your-subdomain.workers.dev
-```
-
----
-
 ### 2. Vercel Relay
 Deploy using the built-in deploy command:
 ```text
@@ -159,13 +148,20 @@ Deploy using the built-in deploy command:
 
 ## 🛠️ 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.
+
+To change the base port:
+```env
+FREEFLOW_PORT=19000
+```
+
 View live debug logs:
 ```bash
 cat ~/.pi/agent/pi-freeflow.log | tail -n 30
 # or inside OMP:
 /freeflow logs
 ```
-
 ---
 
 ## 📄 License

package/extensions/index.ts

@@ -25,7 +25,7 @@ if (!process.env.BANSOS_API_KEY) {
 const UPSTREAM_OPENCODE = "https://opencode.ai/zen";
 // KiloCode gateway — OpenAI-compatible; free models are keyless (200 req/hr per IP)
 const KILO_CHAT_URL = "https://api.kilo.ai/api/gateway/chat/completions";
-const PORT = Number(process.env.BANSOS_PORT) || 18080;
+const PORT = Number(process.env.FREEFLOW_PORT || process.env.BANSOS_PORT) || 18080;
 const HOST = "127.0.0.1";
 const API = `${UPSTREAM_OPENCODE}/v1`;
 const OPENCODE_USER_AGENT = "opencode/latest/1.14.50/cli";
@@ -1267,23 +1267,43 @@ function startProxy(
 	});
 }
 
-// ── Main extension ─────────────────────────────────────────────────
-export default async function (pi: ExtensionAPI) {
-	log("info", "extension loading...");
-	let server: http.Server;
-	let actualPort: number;
+// Probe whether an existing freeflow proxy is already running on a port
+async function isProxyAlive(port: number): Promise<boolean> {
 	try {
-		const r = await startProxy();
-		server = r.server;
-		actualPort = r.port;
+		const res = await fetch(`http://${HOST}:${port}/v1/models`, {
+			signal: AbortSignal.timeout(500),
+		});
+		return res.ok;
 	} catch {
-		log(
-			"error",
-			"extension inactive — could not bind proxy port. resolve the port conflict and restart pi.",
-		);
-		return;
+		return false;
 	}
+}
 
+// ── Main extension ─────────────────────────────────────────────────
+export default async function (pi: ExtensionAPI) {
+	log("info", "extension loading...");
+	let server: http.Server | null = null;
+	let actualPort = PORT;
+
+	// Single-Port Shared Pattern: If proxy is already running on PORT (e.g. parent session),
+	// subagents reuse http://127.0.0.1:18080 directly without spawning redundant servers!
+	const alreadyRunning = await isProxyAlive(PORT);
+	if (alreadyRunning) {
+		log("info", `reusing existing freeflow proxy on http://${HOST}:${PORT}`);
+		actualPort = PORT;
+	} else {
+		try {
+			const r = await startProxy();
+			server = r.server;
+			actualPort = r.port;
+		} catch {
+			log(
+				"error",
+				"extension inactive — could not bind proxy port. resolve the port conflict and restart pi.",
+			);
+			return;
+		}
+	}
 	// Health check opencode models
 	log("info", `checking ${KNOWN_MODELS.length} opencode model(s)...`);
 	const opencodeChecks = await Promise.all(

package/package.json

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