@victor-software-house/pi-openai-proxy 0.2.1 → 0.2.3

package/README.md

@@ -231,15 +231,22 @@ pi install npm:@victor-software-house/pi-openai-proxy
 
 `/proxy` (or `/proxy config`) opens an interactive settings panel where you can configure the bind address, port, auth token, remote images, body size limit, and upstream timeout. Changes are saved to `~/.pi/agent/proxy-config.json` immediately. Restart the proxy to apply changes.
 
-### Auto-start with pi
+### Standalone (background) mode
+
+For a proxy that outlives pi sessions, run the binary directly:
 
 ```bash
-pi --proxy
-```
+# Foreground
+pi-openai-proxy
 
-The proxy starts automatically on session start and stops when the session ends. A status indicator in the footer shows the proxy URL and model count.
+# Background
+pi-openai-proxy &
+
+# With custom port
+PI_PROXY_PORT=8080 pi-openai-proxy &
+```
 
-The proxy can also run standalone (see [Installation](#installation) above). The extension detects externally running instances and shows their status without trying to manage them.
+The extension detects externally running instances and shows their status via `/proxy status` without trying to manage them.
 
 ## Architecture
 

package/extensions/proxy.ts

@@ -11,9 +11,6 @@
  *   /proxy path       Show config file location
  *   /proxy reset      Restore default settings
  *   /proxy help       Usage line
- *
- * Flag:
- *   --proxy           Auto-start on session start
  */
 
 import {
@@ -156,23 +153,11 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 		return `http://${config.host}:${String(config.port)}`;
 	}
 
-	// --- Flag ---
-
-	pi.registerFlag("proxy", {
-		description: "Start the OpenAI proxy on session start",
-		type: "boolean",
-		default: false,
-	});
-
 	// --- Lifecycle ---
 
 	pi.on("session_start", async (_event, ctx) => {
 		config = loadConfig();
-		if (pi.getFlag("--proxy")) {
-			await startProxy(ctx);
-		} else {
-			await refreshStatus(ctx);
-		}
+		await refreshStatus(ctx);
 	});
 
 	pi.on("session_shutdown", async () => {
@@ -359,10 +344,12 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 
 	async function showConfig(ctx: ExtensionContext): Promise<void> {
 		config = loadConfig();
+		const authDisplay =
+			config.authToken.length > 0 ? `enabled (token: ${config.authToken})` : "disabled";
 		const lines = [
 			`host: ${config.host}`,
 			`port: ${String(config.port)}`,
-			`auth: ${config.authToken.length > 0 ? "enabled" : "disabled"}`,
+			`auth: ${authDisplay}`,
 			`remote images: ${String(config.remoteImages)}`,
 			`max body: ${String(config.maxBodySizeMb)} MB`,
 			`upstream timeout: ${String(config.upstreamTimeoutSec)}s`,
@@ -391,6 +378,8 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 
 	// --- Settings panel ---
 
+	let lastGeneratedToken = "";
+
 	function buildSettingItems(): SettingItem[] {
 		return [
 			{
@@ -410,7 +399,10 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 			{
 				id: "authToken",
 				label: "Proxy auth",
-				description: "Require bearer token for all requests",
+				description:
+					config.authToken.length > 0
+						? `Token: ${config.authToken.slice(0, 8)}... (use /proxy show to copy)`
+						: "Require bearer token for all requests",
 				currentValue: config.authToken.length > 0 ? "enabled" : "disabled",
 				values: ["disabled", "enabled"],
 			},
@@ -447,17 +439,21 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 				config = { ...config, port: clampInt(Number.parseInt(value, 10), 1, 65535, config.port) };
 				break;
 			case "authToken":
-				// Toggle: "enabled" keeps current token or sets placeholder; "disabled" clears
+				// Toggle: "enabled" keeps current token or generates one; "disabled" clears
 				if (value === "disabled") {
 					config = { ...config, authToken: "" };
 				} else if (config.authToken.length === 0) {
 					// Generate a random token on first enable
 					const bytes = new Uint8Array(16);
 					crypto.getRandomValues(bytes);
-					const token = Array.from(bytes)
-						.map((b) => b.toString(16).padStart(2, "0"))
-						.join("");
-					config = { ...config, authToken: token };
+					config = {
+						...config,
+						authToken: Array.from(bytes)
+							.map((b) => b.toString(16).padStart(2, "0"))
+							.join(""),
+					};
+					// Stash token so the caller can notify the user
+					lastGeneratedToken = config.authToken;
 				}
 				break;
 			case "remoteImages":
@@ -493,7 +489,11 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 						10,
 						getSettingsListTheme(),
 						(id, newValue) => {
+							lastGeneratedToken = "";
 							applySetting(id, newValue);
+							if (lastGeneratedToken.length > 0) {
+								ctx.ui.notify(`Auth token: ${lastGeneratedToken}`, "info");
+							}
 							current = build();
 							tui.requestRender();
 						},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@victor-software-house/pi-openai-proxy",
-	"version": "0.2.1",
+	"version": "0.2.3",
 	"description": "Local OpenAI-compatible HTTP proxy built on pi's SDK",
 	"license": "MIT",
 	"author": "Victor Software House",