proxitor 0.9.0-beta.2 → 0.9.0-beta.3

package/dist/cli.mjs

@@ -19924,10 +19924,6 @@ function withReq(id, message) {
 }
 //#endregion
 //#region src/commands/config/config.ts
-/**
-* Throws {@link MissingConfigError} via `findConfigFile` if no config is found.
-* Pass an explicit path to skip discovery and use that file directly.
-*/
 function requireConfigPath(explicitPath) {
 	return findConfigFile(explicitPath);
 }
@@ -19937,6 +19933,22 @@ function readConfigRaw(path) {
 function writeConfigRaw(path, content) {
 	writeFileSync(path, content, "utf-8");
 }
+function setGlobalConfigField(configPath, field, value) {
+	const doc = (0, import_dist.parseDocument)(readConfigRaw(configPath));
+	if (value === void 0) doc.delete(field);
+	else doc.set(field, value);
+	writeConfigRaw(configPath, doc.toString());
+}
+/**
+* Atomic batch write — updates multiple fields in a single read-parse-write
+* cycle, eliminating the risk of partial state on crash or Ctrl-C.
+*/
+function setGlobalConfigFields(configPath, fields) {
+	const doc = (0, import_dist.parseDocument)(readConfigRaw(configPath));
+	for (const [key, value] of Object.entries(fields)) if (value === void 0) doc.delete(key);
+	else doc.set(key, value);
+	writeConfigRaw(configPath, doc.toString());
+}
 function setModelOverride(configPath, modelKey, override) {
 	const doc = (0, import_dist.parseDocument)(readConfigRaw(configPath));
 	let overrides = doc.get("modelOverrides");
@@ -20173,6 +20185,206 @@ async function selectIgnoreProviders(providerOptions) {
 	return { provider: { ignore: values.length === 1 ? values[0] : values } };
 }
 //#endregion
+//#region src/commands/config/prompts.ts
+function maskKey(key) {
+	if (!key) return "(none)";
+	if (key.length <= 11) return "****";
+	return `${key.slice(0, 7)}…${key.slice(-4)}`;
+}
+async function askApiKey(currentKey) {
+	if (currentKey) log.info(`Current key: ${maskKey(currentKey)}`);
+	const apiKey = await text({
+		message: "OpenRouter API key",
+		placeholder: currentKey ? "Press Enter to keep current key" : "sk-or-v1-...",
+		validate: (v) => {
+			if (!v?.trim() && !currentKey) return "API key is required";
+		}
+	});
+	if (isCancel(apiKey)) return null;
+	note("You can also set the OPENROUTER_API_KEY environment variable\nto avoid storing the key in the config file.", "Tip");
+	return apiKey.trim() || currentKey;
+}
+async function askPort(current) {
+	const input = await text({
+		message: "Proxy port",
+		initialValue: String(current),
+		placeholder: String(DEFAULTS.port),
+		validate: (v) => {
+			if (!v?.trim()) return void 0;
+			const n = Number.parseInt(v, 10);
+			if (Number.isNaN(n) || n < 1 || n > 65535) return "Port must be 1–65535";
+		}
+	});
+	if (isCancel(input)) return null;
+	return input.trim() ? Number.parseInt(input, 10) : DEFAULTS.port;
+}
+async function askBaseUrl(current) {
+	const url = await text({
+		message: "OpenRouter API base URL",
+		placeholder: DEFAULTS.openrouterBaseUrl,
+		initialValue: current === DEFAULTS.openrouterBaseUrl ? "" : current,
+		validate: (v) => {
+			if (!v?.trim()) return void 0;
+			try {
+				if (!new URL(v.trim()).protocol.startsWith("http")) return "URL must start with http:// or https://";
+			} catch {
+				return "Invalid URL";
+			}
+		}
+	});
+	if (isCancel(url)) return null;
+	return url.trim() || DEFAULTS.openrouterBaseUrl;
+}
+async function askAuthType(current) {
+	const authType = await select({
+		message: "Authentication type",
+		initialValue: current,
+		options: [{
+			value: "bearer",
+			label: "Bearer token",
+			hint: "Standard OpenRouter"
+		}, {
+			value: "oauth",
+			label: "OAuth token",
+			hint: "Custom proxy providers"
+		}]
+	});
+	if (isCancel(authType)) return null;
+	return authType;
+}
+async function askHost(current) {
+	const isPreset = (v) => v === "0.0.0.0" || v === "127.0.0.1";
+	const host = await select({
+		message: "Listen address",
+		initialValue: isPreset(current) ? current : "__custom__",
+		options: [
+			{
+				value: "0.0.0.0",
+				label: "All interfaces (0.0.0.0)",
+				hint: "Default"
+			},
+			{
+				value: "127.0.0.1",
+				label: "Localhost only (127.0.0.1)",
+				hint: "More secure"
+			},
+			{
+				value: "__custom__",
+				label: "Custom address…",
+				hint: "Specific IP, hostname, or unix:/path"
+			}
+		]
+	});
+	if (isCancel(host)) return null;
+	if (host === "__custom__") {
+		const custom = await text({
+			message: "Custom listen address",
+			placeholder: "192.168.1.1",
+			initialValue: isPreset(current) ? "" : current,
+			validate: (v) => {
+				const t = v?.trim();
+				if (!t) return "Address is required";
+				if (t.startsWith("unix:")) return void 0;
+				if (!/^[\w.\-:]+$/.test(t)) return "Invalid host (allowed: IP, hostname, or unix:…)";
+			}
+		});
+		if (isCancel(custom)) return null;
+		return custom.trim();
+	}
+	return host;
+}
+/** Shared hint texts for session routing tri-state — used in add, edit, session-routing. */
+const SESSION_HINTS = {
+	auto: "Passthrough client ID, generate if missing",
+	always: "Always generate proxy session ID",
+	never: "Don't manage session headers"
+};
+/** Shared hint texts for cache control tri-state — used in add, edit, cache-control. */
+const CACHE_HINTS = {
+	auto: "Anthropic models only",
+	always: "All models",
+	never: "Off"
+};
+async function askTriState(message, current, hints) {
+	const result = await select({
+		message,
+		initialValue: current ?? "auto",
+		options: [
+			{
+				value: "auto",
+				label: "auto",
+				hint: hints.auto
+			},
+			{
+				value: "always",
+				label: "always",
+				hint: hints.always
+			},
+			{
+				value: "never",
+				label: "never",
+				hint: hints.never
+			}
+		]
+	});
+	if (isCancel(result)) return null;
+	return result;
+}
+async function askCacheControlTtl(current) {
+	const options = [{
+		value: "5m",
+		label: "5 minutes",
+		hint: "Anthropic default"
+	}, {
+		value: "1h",
+		label: "1 hour",
+		hint: "Higher write cost"
+	}];
+	if (current) options.push({
+		value: "reset",
+		label: "Reset to default",
+		hint: "Remove TTL override"
+	});
+	const result = await select({
+		message: "Cache TTL",
+		initialValue: current ?? "5m",
+		options
+	});
+	if (isCancel(result)) return null;
+	if (result === "reset") return "reset";
+	return result;
+}
+//#endregion
+//#region src/commands/config/tri-state.ts
+/**
+* Prompt the user for a session routing mode.
+* Returns the updated override (with `sessionId` set) or `null` on cancel.
+*/
+async function collectSessionTriState(currentSid) {
+	const sid = await askTriState("Session ID mode", currentSid ?? "auto", SESSION_HINTS);
+	if (sid === null) return null;
+	return { sessionId: sid };
+}
+/**
+* Prompt the user for a cache control mode and optional TTL.
+* Returns the updated fields or `null` on tri-state cancel.
+*
+* **TTL cancel behaviour**: when the user presses Escape on the TTL prompt
+* the existing TTL is preserved (not silently dropped).
+*/
+async function collectCacheTriState(currentCc, currentTtl) {
+	const cc = await askTriState("Cache control mode", currentCc ?? "auto", CACHE_HINTS);
+	if (cc === null) return null;
+	const result = { cacheControl: cc };
+	if (cc !== "never") {
+		const ttl = await askCacheControlTtl(currentTtl ?? void 0);
+		if (ttl === null) {
+			if (currentTtl) result.cacheControlTtl = currentTtl;
+		} else if (ttl !== "reset") result.cacheControlTtl = ttl;
+	}
+	return result;
+}
+//#endregion
 //#region src/commands/config/add.ts
 const CUSTOM_PATTERN_VALUE = "__proxitor_custom_pattern__";
 /** Run the interactive "Add model override" flow. */
@@ -20262,18 +20474,49 @@ async function enterPattern(models) {
 async function configureProviderAndSave(configPath, client, modelKey, isPattern) {
 	const mode = await selectRoutingMode("Configure provider routing");
 	if (isCancel(mode)) return;
+	let override = {};
 	if (mode === "skip") {
-		if (!await confirmAndSave(configPath, modelKey, {}, client)) return;
-		outro("✓ Override saved (no provider routing)");
+		if (!await confirmAndSave(configPath, modelKey, override, client)) return;
+		outro("✓ Model override saved (no provider routing)");
 		return;
 	}
 	const providerOptions = await fetchProvidersForModel(client, modelKey, isPattern);
 	if (!providerOptions) return;
-	const override = await selectProvidersByMode(mode, providerOptions);
-	if (!override) return;
+	const providerResult = await selectProvidersByMode(mode, providerOptions);
+	if (!providerResult) return;
+	override = providerResult;
+	override = await collectSessionAndCache(override);
 	if (!await confirmAndSave(configPath, modelKey, override, client)) return;
 	outro("✓ Model override saved");
 }
+async function collectSessionAndCache(override) {
+	override = await collectSession(override);
+	override = await collectCache(override);
+	return override;
+}
+async function collectSession(override) {
+	const want = await confirm({
+		message: "Configure session routing for this model?",
+		initialValue: false
+	});
+	if (isCancel(want) || !want) return override;
+	const result = await collectSessionTriState();
+	if (result) override.sessionId = result.sessionId;
+	return override;
+}
+async function collectCache(override) {
+	const want = await confirm({
+		message: "Configure cache control for this model?",
+		initialValue: false
+	});
+	if (isCancel(want) || !want) return override;
+	const result = await collectCacheTriState();
+	if (result) {
+		override.cacheControl = result.cacheControl;
+		if (result.cacheControlTtl) override.cacheControlTtl = result.cacheControlTtl;
+	}
+	return override;
+}
 /**
 * Show the proposed override and let the user Save / Test (dry-run) / Cancel.
 * Returns true if the override was saved.
@@ -20330,6 +20573,9 @@ function formatOverrideYaml(override) {
 		const p = override.provider;
 		for (const [key, value] of Object.entries(p)) parts.push(`provider.${key}: ${JSON.stringify(value)}`);
 	}
+	if (override.sessionId) parts.push(`sessionId: ${override.sessionId}`);
+	if (override.cacheControl) parts.push(`cacheControl: ${override.cacheControl}`);
+	if (override.cacheControlTtl) parts.push(`cacheControlTtl: ${override.cacheControlTtl}`);
 	return parts.join("\n    ") || "(empty)";
 }
 //#endregion
@@ -20416,39 +20662,59 @@ async function browseModelsCommand(client) {
 //#endregion
 //#region src/commands/config/edit.ts
 function formatOverrideHint(override) {
-	if (!override?.provider) return "(no provider routing)";
-	return Object.keys(override.provider).map((k) => `${k}: ${JSON.stringify(override.provider?.[k])}`).join(", ");
+	if (!override) return "(empty)";
+	const parts = [];
+	if (override.provider) {
+		const keys = Object.keys(override.provider);
+		parts.push(`provider: ${keys.join(", ")}`);
+	}
+	if (override.sessionId) parts.push(`session: ${override.sessionId}`);
+	if (override.cacheControl) parts.push(`cache: ${override.cacheControl}`);
+	if (override.headers) parts.push(`${Object.keys(override.headers).length} header(s)`);
+	return parts.join(", ") || "(empty)";
 }
 function showCurrentConfig(modelKey, current) {
 	log.info(`Current config for "${modelKey}":`);
 	if (current.provider) for (const [field, value] of Object.entries(current.provider)) log.info(`  provider.${field}: ${JSON.stringify(value)}`);
+	if (current.sessionId) log.info(`  sessionId: ${current.sessionId}`);
+	if (current.cacheControl) log.info(`  cacheControl: ${current.cacheControl}`);
+	if (current.cacheControlTtl) log.info(`  cacheControlTtl: ${current.cacheControlTtl}`);
 	if (current.headers) for (const [name, value] of Object.entries(current.headers)) log.info(`  headers.${name}: ${value}`);
 }
-function withoutProvider(current) {
-	return current.headers ? { headers: current.headers } : {};
-}
-async function updateProviderRouting(configPath, modelKey, current, client) {
+async function editProvider(modelKey, current, client) {
 	const isPattern = modelKey.includes("*");
 	const mode = await selectRoutingMode("Routing mode");
-	if (isCancel(mode)) return;
+	if (isCancel(mode)) return current;
 	if (mode === "skip") {
-		setModelOverride(configPath, modelKey, withoutProvider(current));
-		outro("✓ Override updated");
-		return;
+		const { provider: _, ...rest } = current;
+		return rest;
 	}
 	const providerOptions = await fetchProvidersForModel(client, modelKey, isPattern);
-	if (!providerOptions) return;
-	const override = await selectProvidersByMode(mode, providerOptions);
-	if (override === null) return;
-	const updated = withoutProvider(current);
-	if (override.provider) updated.provider = override.provider;
-	const save = await confirm({ message: "Save changes?" });
-	if (isCancel(save) || !save) {
-		outro("Cancelled");
-		return;
-	}
-	setModelOverride(configPath, modelKey, updated);
-	outro("✓ Override updated");
+	if (!providerOptions) return current;
+	const result = await selectProvidersByMode(mode, providerOptions);
+	if (!result) return current;
+	return {
+		...current,
+		provider: result.provider
+	};
+}
+async function editSessionId(current) {
+	const result = await collectSessionTriState(current.sessionId);
+	if (result === null) return current;
+	const { sessionId: _, ...rest } = current;
+	return {
+		...rest,
+		sessionId: result.sessionId
+	};
+}
+async function editCacheControl(current) {
+	const result = await collectCacheTriState(current.cacheControl, current.cacheControlTtl);
+	if (result === null) return current;
+	const { cacheControl: _cc, cacheControlTtl: _ttl, ...rest } = current;
+	return {
+		...rest,
+		...result
+	};
 }
 /** Run the interactive "Edit model override" flow. */
 async function editOverrideCommand(client, configPath) {
@@ -20471,9 +20737,53 @@ async function editOverrideCommand(client, configPath) {
 	});
 	if (isCancel(selected)) return;
 	const modelKey = selected;
-	const current = overrides[modelKey] ?? {};
+	let current = overrides[modelKey] ?? {};
 	showCurrentConfig(modelKey, current);
-	await updateProviderRouting(resolvedConfigPath, modelKey, current, client);
+	while (true) {
+		const field = await select({
+			message: "Edit which field?",
+			options: [
+				{
+					value: "provider",
+					label: "Provider routing",
+					hint: formatOverrideHint({ provider: current.provider })
+				},
+				{
+					value: "sessionId",
+					label: "Session ID",
+					hint: current.sessionId ?? "(inherit)"
+				},
+				{
+					value: "cacheControl",
+					label: "Cache control",
+					hint: [current.cacheControl, current.cacheControlTtl].filter(Boolean).join(", ") || "(inherit)"
+				},
+				{
+					value: "done",
+					label: "✓ Done"
+				}
+			]
+		});
+		if (isCancel(field) || field === "done") break;
+		switch (field) {
+			case "provider":
+				current = await editProvider(modelKey, current, client);
+				break;
+			case "sessionId":
+				current = await editSessionId(current);
+				break;
+			case "cacheControl":
+				current = await editCacheControl(current);
+				break;
+		}
+	}
+	const save = await confirm({ message: "Save changes?" });
+	if (isCancel(save) || !save) {
+		outro("Cancelled");
+		return;
+	}
+	setModelOverride(resolvedConfigPath, modelKey, current);
+	outro("✓ Override updated");
 }
 //#endregion
 //#region src/commands/config/list.ts
@@ -20483,6 +20793,9 @@ function formatOverrideSummary(override) {
 		for (const [field, value] of Object.entries(override.provider)) if (value !== void 0) parts.push(`${field}: ${JSON.stringify(value)}`);
 	}
 	if (override.headers) for (const [name, value] of Object.entries(override.headers)) parts.push(`header ${name}: ${value}`);
+	if (override.sessionId) parts.push(`session: ${override.sessionId}`);
+	if (override.cacheControl) parts.push(`cache: ${override.cacheControl}`);
+	if (override.cacheControlTtl) parts.push(`ttl: ${override.cacheControlTtl}`);
 	return parts.join(", ") || "(empty)";
 }
 async function listOverridesCommand(args = {}) {
@@ -20547,40 +20860,166 @@ async function removeOverrideCommand(args = {}) {
 	outro(`✓ ${toRemove.length} override(s) removed`);
 }
 //#endregion
-//#region src/openrouter/client.ts
-var OpenRouterClientError = class extends Error {
-	status;
-	constructor(status, message) {
-		super(`OpenRouter API error (${status}): ${message}`);
-		this.name = "OpenRouterClientError";
-		this.status = status;
+//#region src/commands/config/show.ts
+const SEPARATE_KEYS = new Set([
+	...new Set(["openrouterKey"]),
+	"modelOverrides",
+	"provider",
+	"headers"
+]);
+function logResolved(cfg, source) {
+	intro("Resolved configuration");
+	if (source) log.info(`Source: ${source}`);
+	else log.info("Source: defaults only");
+	for (const [key, value] of Object.entries(cfg)) {
+		if (SEPARATE_KEYS.has(key)) continue;
+		const label = key.padEnd(20);
+		if (value !== void 0 && value !== "") log.info(`  ${label} ${value}`);
 	}
-};
-/** HTTP client for OpenRouter REST endpoints. */
-var OpenRouterClient = class {
-	apiKey;
-	baseUrl;
-	authType;
-	constructor(apiKeyOrUrl, baseUrl, authType) {
-		if (baseUrl !== void 0) {
-			this.apiKey = apiKeyOrUrl;
-			this.baseUrl = baseUrl;
-			this.authType = authType;
-		} else {
-			this.apiKey = void 0;
-			this.baseUrl = apiKeyOrUrl;
-			this.authType = void 0;
-		}
+	log.info(`  ${"openrouterKey".padEnd(20)} ${maskKey(cfg.openrouterKey)}`);
+	if (cfg.provider) log.info(`  ${"provider".padEnd(20)} ${JSON.stringify(cfg.provider)}`);
+	if (cfg.headers && Object.keys(cfg.headers).length > 0) log.info(`  ${"headers".padEnd(20)} ${JSON.stringify(cfg.headers)}`);
+	if (cfg.modelOverrides && Object.keys(cfg.modelOverrides).length > 0) {
+		const count = Object.keys(cfg.modelOverrides).length;
+		log.info(`  ${"modelOverrides".padEnd(20)} ${count} model(s)`);
+		for (const key of Object.keys(cfg.modelOverrides)) log.info(`    ${key}`);
 	}
-	async get(path) {
-		const url = `${this.baseUrl}${path}`;
-		const headers = {};
-		if (this.apiKey !== void 0 && this.authType !== void 0) headers.Authorization = formatAuthHeader(this.apiKey, this.authType);
-		const res = await fetch(url, { headers });
-		if (!res.ok) {
-			const body = await res.text().catch(() => "");
-			throw new OpenRouterClientError(res.status, body || res.statusText);
-		}
+	outro(`Defaults loaded from schema: ${Object.keys(DEFAULTS).length} keys`);
+}
+async function showConfigCommand(args) {
+	let discoveredPath = null;
+	if (args.configPath) {
+		if (existsSync(args.configPath)) discoveredPath = resolve(args.configPath);
+	} else discoveredPath = tryFindConfigFile();
+	const configExists = discoveredPath !== null;
+	if (!configExists && !args.openrouterKey) {
+		log.warn("No config file and no --openrouter-key — cannot show a complete resolved view.");
+		if (args.json) {
+			process.stdout.write(`${JSON.stringify({
+				ok: false,
+				error: "No config available"
+			})}\n`);
+			return;
+		}
+		outro("Run `proxitor config wizard` to create one.");
+		return;
+	}
+	const cfg = await loadConfig({
+		configPath: args.configPath,
+		noConfig: !configExists && !args.configPath,
+		openrouterKey: args.openrouterKey
+	});
+	if (args.json) {
+		const masked = {
+			...cfg,
+			openrouterKey: maskKey(cfg.openrouterKey)
+		};
+		process.stdout.write(`${JSON.stringify(masked, null, 2)}\n`);
+		return;
+	}
+	logResolved(cfg, discoveredPath);
+}
+//#endregion
+//#region src/commands/config/validate.ts
+function validate(configPath) {
+	if (!configPath) return {
+		ok: false,
+		configPath: null,
+		error: "No config file found"
+	};
+	try {
+		const cfg = readConfigFile(configPath);
+		return {
+			ok: true,
+			configPath,
+			keyCount: Object.keys(cfg).length,
+			overrideCount: cfg.modelOverrides ? Object.keys(cfg.modelOverrides).length : 0
+		};
+	} catch (error) {
+		if (error instanceof ConfigValidationError) {
+			const issues = error.zodError.issues.map((issue) => ({
+				path: issue.path.length > 0 ? issue.path.join(".") : "(root)",
+				message: issue.message
+			}));
+			return {
+				ok: false,
+				configPath,
+				error: error.message,
+				issues
+			};
+		}
+		return {
+			ok: false,
+			configPath,
+			error: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+async function validateConfigCommand(args = {}) {
+	const result = validate(tryFindConfigFile(args.configPath));
+	if (args.json) {
+		process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+		return result.ok ? 0 : 1;
+	}
+	intro("Validate Config");
+	if (result.ok) {
+		log.success(`Config is valid: ${result.configPath}`);
+		log.info(`  ${result.keyCount} top-level keys, ${result.overrideCount} model override(s)`);
+		outro("Ready to run `proxitor start`.");
+		return 0;
+	}
+	if (!result.configPath) {
+		log.warn("No config file found — nothing to validate.");
+		log.info("Searched:");
+		outro("Run `proxitor config wizard` to create one.");
+		return 1;
+	}
+	log.error(`Invalid config: ${result.configPath}`);
+	if (result.issues && result.issues.length > 0) {
+		note(result.issues.map((i) => `  ${i.path}: ${i.message}`).join("\n"), "Validation issues");
+		log.info("Tips:");
+		log.info(`  • Open the file: \`$EDITOR ${result.configPath}\``);
+		log.info("  • Run `proxitor config wizard` to start fresh");
+		log.info("  • Or run `proxitor doctor` for a fuller diagnostic");
+	} else log.error(result.error);
+	outro("Fix the issues and re-run `proxitor config validate`.");
+	return 1;
+}
+//#endregion
+//#region src/openrouter/client.ts
+var OpenRouterClientError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(`OpenRouter API error (${status}): ${message}`);
+		this.name = "OpenRouterClientError";
+		this.status = status;
+	}
+};
+/** HTTP client for OpenRouter REST endpoints. */
+var OpenRouterClient = class {
+	apiKey;
+	baseUrl;
+	authType;
+	constructor(apiKeyOrUrl, baseUrl, authType) {
+		if (baseUrl !== void 0) {
+			this.apiKey = apiKeyOrUrl;
+			this.baseUrl = baseUrl;
+			this.authType = authType;
+		} else {
+			this.apiKey = void 0;
+			this.baseUrl = apiKeyOrUrl;
+			this.authType = void 0;
+		}
+	}
+	async get(path) {
+		const url = `${this.baseUrl}${path}`;
+		const headers = {};
+		if (this.apiKey !== void 0 && this.authType !== void 0) headers.Authorization = formatAuthHeader(this.apiKey, this.authType);
+		const res = await fetch(url, { headers });
+		if (!res.ok) {
+			const body = await res.text().catch(() => "");
+			throw new OpenRouterClientError(res.status, body || res.statusText);
+		}
 		return res.json();
 	}
 };
@@ -20722,11 +21161,6 @@ async function probeUpstream(baseUrl, apiKey, authType, timeoutMs = 3e3) {
 }
 //#endregion
 //#region src/commands/config/wizard.ts
-function maskKey(key) {
-	if (!key) return "(none)";
-	if (key.length <= 11) return "****";
-	return `${key.slice(0, 7)}…${key.slice(-4)}`;
-}
 function resolveSavePath(location) {
 	switch (location) {
 		case "local": return resolve("proxitor.config.yaml");
@@ -20782,108 +21216,6 @@ function buildYaml(apiKey, port, host, baseUrl, authType, existingRaw) {
 	if (authType !== DEFAULTS.authType) config.authType = authType;
 	return (0, import_dist.stringify)(config);
 }
-async function askApiKey(currentKey) {
-	if (currentKey) log.info(`Current key: ${maskKey(currentKey)}`);
-	const apiKey = await text({
-		message: "OpenRouter API key",
-		placeholder: currentKey ? "Press Enter to keep current key" : "sk-or-v1-...",
-		validate: (v) => {
-			if (!v?.trim() && !currentKey) return "API key is required";
-		}
-	});
-	if (isCancel(apiKey)) return null;
-	note("You can also set the OPENROUTER_API_KEY environment variable\nto avoid storing the key in the config file.", "Tip");
-	return apiKey.trim() || currentKey;
-}
-async function askPort(current) {
-	const input = await text({
-		message: "Proxy port",
-		initialValue: String(current),
-		placeholder: String(DEFAULTS.port),
-		validate: (v) => {
-			if (!v?.trim()) return void 0;
-			const n = Number.parseInt(v, 10);
-			if (Number.isNaN(n) || n < 1 || n > 65535) return "Port must be 1–65535";
-		}
-	});
-	if (isCancel(input)) return null;
-	return input.trim() ? Number.parseInt(input, 10) : DEFAULTS.port;
-}
-async function askBaseUrl(current) {
-	const url = await text({
-		message: "OpenRouter API base URL",
-		placeholder: DEFAULTS.openrouterBaseUrl,
-		initialValue: current === DEFAULTS.openrouterBaseUrl ? "" : current,
-		validate: (v) => {
-			if (!v?.trim()) return void 0;
-			try {
-				if (!new URL(v.trim()).protocol.startsWith("http")) return "URL must start with http:// or https://";
-			} catch {
-				return "Invalid URL";
-			}
-		}
-	});
-	if (isCancel(url)) return null;
-	return url.trim() || DEFAULTS.openrouterBaseUrl;
-}
-async function askAuthType(current) {
-	const authType = await select({
-		message: "Authentication type",
-		initialValue: current,
-		options: [{
-			value: "bearer",
-			label: "Bearer token",
-			hint: "Standard OpenRouter"
-		}, {
-			value: "oauth",
-			label: "OAuth token",
-			hint: "Custom proxy providers"
-		}]
-	});
-	if (isCancel(authType)) return null;
-	return authType;
-}
-async function askHost(current) {
-	const isPreset = (v) => v === "0.0.0.0" || v === "127.0.0.1";
-	const host = await select({
-		message: "Listen address",
-		initialValue: isPreset(current) ? current : "__custom__",
-		options: [
-			{
-				value: "0.0.0.0",
-				label: "All interfaces (0.0.0.0)",
-				hint: "Default"
-			},
-			{
-				value: "127.0.0.1",
-				label: "Localhost only (127.0.0.1)",
-				hint: "More secure"
-			},
-			{
-				value: "__custom__",
-				label: "Custom address…",
-				hint: "Specific IP, hostname, or unix:/path"
-			}
-		]
-	});
-	if (isCancel(host)) return null;
-	if (host === "__custom__") {
-		const custom = await text({
-			message: "Custom listen address",
-			placeholder: "192.168.1.1",
-			initialValue: isPreset(current) ? "" : current,
-			validate: (v) => {
-				const t = v?.trim();
-				if (!t) return "Address is required";
-				if (t.startsWith("unix:")) return void 0;
-				if (!/^[\w.\-:]+$/.test(t)) return "Invalid host (allowed: IP, hostname, or unix:…)";
-			}
-		});
-		if (isCancel(custom)) return null;
-		return custom.trim();
-	}
-	return host;
-}
 async function askSaveLocation(existingPath) {
 	const options = getSaveLocationOptions(existingPath);
 	const location = await select({
@@ -20998,197 +21330,221 @@ async function runWizard(opts = {}) {
 	}
 }
 //#endregion
-//#region src/commands/config/show.ts
-const SEPARATE_KEYS = new Set([
-	...new Set(["openrouterKey"]),
-	"modelOverrides",
-	"provider",
-	"headers"
-]);
-function logResolved(cfg, source) {
-	intro("Resolved configuration");
-	if (source) log.info(`Source: ${source}`);
-	else log.info("Source: defaults only");
-	for (const [key, value] of Object.entries(cfg)) {
-		if (SEPARATE_KEYS.has(key)) continue;
-		const label = key.padEnd(20);
-		if (value !== void 0 && value !== "") log.info(`  ${label} ${value}`);
-	}
-	log.info(`  ${"openrouterKey".padEnd(20)} ${maskKey(cfg.openrouterKey)}`);
-	if (cfg.provider) log.info(`  ${"provider".padEnd(20)} ${JSON.stringify(cfg.provider)}`);
-	if (cfg.headers && Object.keys(cfg.headers).length > 0) log.info(`  ${"headers".padEnd(20)} ${JSON.stringify(cfg.headers)}`);
-	if (cfg.modelOverrides && Object.keys(cfg.modelOverrides).length > 0) {
-		const count = Object.keys(cfg.modelOverrides).length;
-		log.info(`  ${"modelOverrides".padEnd(20)} ${count} model(s)`);
-		for (const key of Object.keys(cfg.modelOverrides)) log.info(`    ${key}`);
-	}
-	outro(`Defaults loaded from schema: ${Object.keys(DEFAULTS).length} keys`);
-}
-async function showConfigCommand(args) {
-	let discoveredPath = null;
-	if (args.configPath) {
-		if (existsSync(args.configPath)) discoveredPath = resolve(args.configPath);
-	} else discoveredPath = tryFindConfigFile();
-	const configExists = discoveredPath !== null;
-	if (!configExists && !args.openrouterKey) {
-		log.warn("No config file and no --openrouter-key — cannot show a complete resolved view.");
-		if (args.json) {
-			process.stdout.write(`${JSON.stringify({
-				ok: false,
-				error: "No config available"
-			})}\n`);
-			return;
-		}
-		outro("Run `proxitor config wizard` to create one.");
-		return;
-	}
-	const cfg = await loadConfig({
-		configPath: args.configPath,
-		noConfig: !configExists && !args.configPath,
-		openrouterKey: args.openrouterKey
-	});
-	if (args.json) {
-		const masked = {
-			...cfg,
-			openrouterKey: maskKey(cfg.openrouterKey)
-		};
-		process.stdout.write(`${JSON.stringify(masked, null, 2)}\n`);
-		return;
-	}
-	logResolved(cfg, discoveredPath);
+//#region src/commands/config/cache-control.ts
+async function cacheControlCommand(opts) {
+	const configPath = requireConfigPath(opts?.configPath);
+	const cfg = readConfigFile(configPath);
+	const currentCc = cfg.cacheControl ?? DEFAULTS.cacheControl;
+	const currentTtl = cfg.cacheControlTtl;
+	log.info(`Current: cacheControl = ${currentCc}`);
+	if (currentTtl) log.info(`Current: cacheControlTtl = ${currentTtl}`);
+	const cc = await askTriState("Cache control mode", currentCc, CACHE_HINTS);
+	if (cc === null) return;
+	const fields = { cacheControl: cc };
+	if (cc !== "never") {
+		const ttlResult = await askCacheControlTtl(currentTtl);
+		if (ttlResult === null) return;
+		if (ttlResult === "reset") fields.cacheControlTtl = void 0;
+		else fields.cacheControlTtl = ttlResult;
+	}
+	setGlobalConfigFields(configPath, fields);
+	const ttlPart = fields.cacheControlTtl ? `, TTL = ${fields.cacheControlTtl}` : "";
+	log.success(`cacheControl set to ${cc}${ttlPart}`);
 }
 //#endregion
-//#region src/commands/config/validate.ts
-function validate(configPath) {
-	if (!configPath) return {
-		ok: false,
-		configPath: null,
-		error: "No config file found"
-	};
-	try {
-		const cfg = readConfigFile(configPath);
-		return {
-			ok: true,
-			configPath,
-			keyCount: Object.keys(cfg).length,
-			overrideCount: cfg.modelOverrides ? Object.keys(cfg.modelOverrides).length : 0
-		};
-	} catch (error) {
-		if (error instanceof ConfigValidationError) {
-			const issues = error.zodError.issues.map((issue) => ({
-				path: issue.path.length > 0 ? issue.path.join(".") : "(root)",
-				message: issue.message
-			}));
-			return {
-				ok: false,
-				configPath,
-				error: error.message,
-				issues
-			};
-		}
-		return {
-			ok: false,
-			configPath,
-			error: error instanceof Error ? error.message : String(error)
-		};
-	}
-}
-async function validateConfigCommand(args = {}) {
-	const result = validate(tryFindConfigFile(args.configPath));
-	if (args.json) {
-		process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-		return result.ok ? 0 : 1;
-	}
-	intro("Validate Config");
-	if (result.ok) {
-		log.success(`Config is valid: ${result.configPath}`);
-		log.info(`  ${result.keyCount} top-level keys, ${result.overrideCount} model override(s)`);
-		outro("Ready to run `proxitor start`.");
-		return 0;
-	}
-	if (!result.configPath) {
-		log.warn("No config file found — nothing to validate.");
-		log.info("Searched:");
-		outro("Run `proxitor config wizard` to create one.");
-		return 1;
+//#region src/commands/config/connection.ts
+const FIELD_MAP = {
+	apiKey: {
+		configKey: "openrouterKey",
+		label: "API key",
+		ask: (cfg) => askApiKey(cfg.openrouterKey ?? DEFAULTS.openrouterKey)
+	},
+	port: {
+		configKey: "port",
+		label: "Proxy port",
+		ask: (cfg) => askPort(cfg.port ?? DEFAULTS.port)
+	},
+	host: {
+		configKey: "host",
+		label: "Listen address",
+		ask: (cfg) => askHost(cfg.host ?? DEFAULTS.host)
+	},
+	baseUrl: {
+		configKey: "openrouterBaseUrl",
+		label: "Base URL",
+		ask: (cfg) => askBaseUrl(cfg.openrouterBaseUrl ?? DEFAULTS.openrouterBaseUrl)
+	},
+	authType: {
+		configKey: "authType",
+		label: "Auth type",
+		ask: (cfg) => askAuthType(cfg.authType ?? DEFAULTS.authType)
 	}
-	log.error(`Invalid config: ${result.configPath}`);
-	if (result.issues && result.issues.length > 0) {
-		note(result.issues.map((i) => `  ${i.path}: ${i.message}`).join("\n"), "Validation issues");
-		log.info("Tips:");
-		log.info(`  • Open the file: \`$EDITOR ${result.configPath}\``);
-		log.info("  • Run `proxitor config wizard` to start fresh");
-		log.info("  • Or run `proxitor doctor` for a fuller diagnostic");
-	} else log.error(result.error);
-	outro("Fix the issues and re-run `proxitor config validate`.");
-	return 1;
-}
-//#endregion
-//#region src/commands/config.ts
-/** Run the interactive config manager menu. */
-async function runConfigMenu(client) {
-	intro("Proxitor Config Manager");
-	const action = await select({
-		message: "What would you like to do?",
+};
+async function connectionMenuCommand(opts) {
+	const configPath = requireConfigPath(opts?.configPath);
+	const cfg = readConfigFile(configPath);
+	const field = await select({
+		message: "Change which field?",
 		options: [
 			{
-				value: "add",
-				label: "➕  Add model override"
+				value: "apiKey",
+				label: "API key",
+				hint: maskKey(cfg.openrouterKey ?? "")
 			},
 			{
-				value: "edit",
-				label: "✏️   Edit model override"
+				value: "port",
+				label: "Proxy port",
+				hint: String(cfg.port ?? DEFAULTS.port)
 			},
 			{
-				value: "remove",
-				label: "🗑   Remove model override"
+				value: "host",
+				label: "Listen address",
+				hint: cfg.host ?? DEFAULTS.host
 			},
 			{
-				value: "list",
-				label: "📋  List current overrides"
+				value: "baseUrl",
+				label: "Base URL"
 			},
 			{
-				value: "browse",
-				label: "🔍  Browse models"
+				value: "authType",
+				label: "Auth type",
+				hint: cfg.authType ?? DEFAULTS.authType
 			},
 			{
-				value: "validate",
-				label: "✅  Validate config"
-			},
-			{
-				value: "exit",
-				label: "❌  Exit"
+				value: "back",
+				label: "← Back"
 			}
 		]
 	});
-	if (isCancel(action) || action === "exit") {
-		outro("Bye!");
-		return;
-	}
-	switch (action) {
-		case "add":
-			await addOverrideCommand({ client });
-			break;
-		case "edit":
-			await editOverrideCommand(client);
-			break;
-		case "remove":
-			await removeOverrideCommand();
-			break;
-		case "list":
-			await listOverridesCommand();
-			break;
-		case "browse":
-			await browseModelsCommand(client);
-			break;
-		case "validate":
-			await validateConfigCommand();
-			break;
+	if (isCancel(field) || field === "back") return;
+	const entry = FIELD_MAP[field];
+	if (!entry) return;
+	const result = await entry.ask(cfg);
+	if (result === null) return;
+	setGlobalConfigField(configPath, entry.configKey, result);
+	log.success(`${entry.label} updated`);
+}
+//#endregion
+//#region src/commands/config/session-routing.ts
+async function sessionRoutingCommand(opts) {
+	const configPath = requireConfigPath(opts?.configPath);
+	const current = readConfigFile(configPath).sessionId ?? DEFAULTS.sessionId;
+	log.info(`Current: sessionId = ${current}`);
+	const result = await askTriState("Session routing mode", current, SESSION_HINTS);
+	if (result === null) return;
+	setGlobalConfigField(configPath, "sessionId", result);
+	log.success(`sessionId set to ${result}`);
+}
+//#endregion
+//#region src/commands/config.ts
+async function runConfigMenu(client) {
+	intro("Proxitor Config Manager");
+	while (true) {
+		const action = await select({
+			message: "What would you like to do?",
+			options: [
+				{
+					value: "show",
+					label: "📋  Show current config"
+				},
+				{
+					value: "_sep1",
+					label: "── Global Settings ──",
+					disabled: true
+				},
+				{
+					value: "connection",
+					label: "🔑  API key & connection"
+				},
+				{
+					value: "session",
+					label: "🔗  Session routing"
+				},
+				{
+					value: "cache",
+					label: "💾  Cache control"
+				},
+				{
+					value: "_sep2",
+					label: "── Model Overrides ──",
+					disabled: true
+				},
+				{
+					value: "add",
+					label: "➕  Add model override"
+				},
+				{
+					value: "edit",
+					label: "✏️   Edit model override"
+				},
+				{
+					value: "remove",
+					label: "🗑   Remove model override"
+				},
+				{
+					value: "list",
+					label: "📄  List current overrides"
+				},
+				{
+					value: "browse",
+					label: "🔍  Browse models"
+				},
+				{
+					value: "_sep3",
+					label: "── Tools ──",
+					disabled: true
+				},
+				{
+					value: "validate",
+					label: "✅  Validate config"
+				},
+				{
+					value: "exit",
+					label: "❌  Exit"
+				}
+			]
+		});
+		if (isCancel(action) || action === "exit") {
+			outro("Bye!");
+			return;
+		}
+		switch (action) {
+			case "show":
+				await showConfigCommand({});
+				break;
+			case "connection":
+				await connectionMenuCommand();
+				break;
+			case "session":
+				await sessionRoutingCommand();
+				break;
+			case "cache":
+				await cacheControlCommand();
+				break;
+			case "add":
+				await addOverrideCommand({ client });
+				break;
+			case "edit":
+				await editOverrideCommand(client);
+				break;
+			case "remove":
+				await removeOverrideCommand();
+				break;
+			case "list":
+				await listOverridesCommand();
+				break;
+			case "browse":
+				await browseModelsCommand(client);
+				break;
+			case "validate":
+				await validateConfigCommand();
+				break;
+		}
 	}
 }
 //#endregion
 //#region src/version.ts
-const version = "0.9.0-beta.2";
+const version = "0.9.0-beta.3";
 //#endregion
 //#region src/commands/doctor.ts
 const DEFAULT_TIMEOUT_MS = 3e3;