@victor-software-house/pi-openai-proxy 0.2.0 → 0.2.2

package/README.md

@@ -231,7 +231,7 @@ 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
+### Auto-start with a pi session
 
 ```bash
 pi --proxy
@@ -239,7 +239,24 @@ pi --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.
 
-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.
+Note: the `--proxy` flag is registered by the extension at runtime and does not appear in `pi --help`.
+
+### Standalone (background) mode
+
+For a proxy that outlives pi sessions, run the binary directly:
+
+```bash
+# Foreground
+pi-openai-proxy
+
+# Background
+pi-openai-proxy &
+
+# With custom port
+PI_PROXY_PORT=8080 pi-openai-proxy &
+```
+
+The extension detects externally running instances and shows their status via `/proxy status` without trying to manage them.
 
 ## Architecture
 

package/extensions/proxy.ts

@@ -359,10 +359,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 +393,8 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 
 	// --- Settings panel ---
 
+	let lastGeneratedToken = "";
+
 	function buildSettingItems(): SettingItem[] {
 		return [
 			{
@@ -410,7 +414,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 +454,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":
@@ -483,42 +494,51 @@ export default function proxyExtension(pi: ExtensionAPI): void {
 
 		await ctx.ui.custom<void>(
 			(tui, theme, _kb, done) => {
-				const container = new Container();
-				container.addChild(new Text(theme.fg("accent", theme.bold("Proxy Settings")), 1, 0));
-				container.addChild(new Text(theme.fg("dim", getConfigPath()), 1, 0));
-
-				const settingsList = new SettingsList(
-					buildSettingItems(),
-					10,
-					getSettingsListTheme(),
-					(id, newValue) => {
-						applySetting(id, newValue);
-						// Rebuild items to reflect normalized values
-						settingsList.setItems(buildSettingItems());
-						tui.requestRender();
-					},
-					() => done(undefined),
-					{ enableSearch: true },
-				);
+				function build(): { container: Container; settingsList: SettingsList } {
+					const container = new Container();
+					container.addChild(new Text(theme.fg("accent", theme.bold("Proxy Settings")), 1, 0));
+					container.addChild(new Text(theme.fg("dim", getConfigPath()), 1, 0));
+
+					const settingsList = new SettingsList(
+						buildSettingItems(),
+						10,
+						getSettingsListTheme(),
+						(id, newValue) => {
+							lastGeneratedToken = "";
+							applySetting(id, newValue);
+							if (lastGeneratedToken.length > 0) {
+								ctx.ui.notify(`Auth token: ${lastGeneratedToken}`, "info");
+							}
+							current = build();
+							tui.requestRender();
+						},
+						() => done(undefined),
+						{ enableSearch: true },
+					);
+
+					container.addChild(settingsList);
+					container.addChild(
+						new Text(
+							theme.fg("dim", "Esc: close | Arrow keys: navigate | Space: toggle | Restart proxy to apply"),
+							1,
+							0,
+						),
+					);
+
+					return { container, settingsList };
+				}
 
-				container.addChild(settingsList);
-				container.addChild(
-					new Text(
-						theme.fg("dim", "Esc: close | Arrow keys: navigate | Space: toggle | Restart proxy to apply"),
-						1,
-						0,
-					),
-				);
+				let current = build();
 
 				return {
 					render(width: number): string[] {
-						return container.render(width);
+						return current.container.render(width);
 					},
 					invalidate(): void {
-						container.invalidate();
+						current.container.invalidate();
 					},
 					handleInput(data: string): void {
-						settingsList.handleInput?.(data);
+						current.settingsList.handleInput?.(data);
 						tui.requestRender();
 					},
 				};

package/package.json

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