npm - pi-antigravity-rotator - Versions diffs - 1.1.0 → 1.3.0 - Mend

pi-antigravity-rotator 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "pi-antigravity-rotator",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Multi-account rotation proxy for Google Antigravity with per-model routing, real-time quota tracking, and infringement detection",
   "license": "MIT",
   "type": "module",

package/src/dashboard.ts CHANGED Viewed

@@ -254,6 +254,17 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
     word-break: break-all;
   }
+  .card-hint {
+    margin-top: 6px;
+    padding: 8px 10px;
+    background: rgba(250, 204, 21, 0.08);
+    border-radius: 8px;
+    border-left: 3px solid var(--yellow);
+    font-size: 11px;
+    color: var(--yellow);
+    line-height: 1.4;
+  }
   .card-actions { margin-top: 10px; display: flex; gap: 8px; }
   .btn-enable {
@@ -355,6 +366,82 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
   .pulse { animation: pulse 2s ease-in-out infinite; }
   @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.6; } }
+  .badge-pro { background: rgba(52, 211, 153, 0.15); color: var(--green); }
+  .badge-free { background: rgba(110, 110, 130, 0.08); color: var(--text-dim); }
+  .badge-fmgr { background: rgba(124, 92, 252, 0.15); color: var(--accent); font-size: 9px; }
+  .advisor-panel {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    padding: 16px 18px;
+    margin-bottom: 24px;
+  }
+  .advisor-title {
+    font-size: 11px;
+    text-transform: uppercase;
+    letter-spacing: 0.8px;
+    color: var(--text-dim);
+    margin-bottom: 10px;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+  }
+  .advisor-slots {
+    font-size: 12px;
+    font-family: 'JetBrains Mono', monospace;
+    color: var(--text);
+    margin-left: auto;
+    text-transform: none;
+    letter-spacing: 0;
+  }
+  .advisor-action {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 8px 10px;
+    margin-bottom: 6px;
+    border-radius: 8px;
+    font-size: 12px;
+  }
+  .advisor-action.add-pro {
+    background: rgba(52, 211, 153, 0.06);
+    border-left: 3px solid var(--green);
+  }
+  .advisor-action.remove-pro {
+    background: rgba(251, 191, 36, 0.06);
+    border-left: 3px solid var(--yellow);
+  }
+  .advisor-action-type {
+    font-weight: 600;
+    font-size: 10px;
+    text-transform: uppercase;
+    letter-spacing: 0.5px;
+    padding: 2px 6px;
+    border-radius: 4px;
+    flex-shrink: 0;
+  }
+  .advisor-action.add-pro .advisor-action-type {
+    background: rgba(52, 211, 153, 0.15);
+    color: var(--green);
+  }
+  .advisor-action.remove-pro .advisor-action-type {
+    background: rgba(251, 191, 36, 0.15);
+    color: var(--yellow);
+  }
+  .advisor-action-label { font-weight: 500; }
+  .advisor-action-reason { color: var(--text-dim); font-size: 11px; margin-left: auto; }
+  .advisor-empty { color: var(--text-dim); font-size: 12px; font-style: italic; }
 </style>
 </head>
 <body>
@@ -364,7 +451,8 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
   <div class="header-stats">
     Uptime: <span id="uptime">--</span> |
     Port: <span id="port">--</span> |
-    Rotation: <span id="rotation">--</span> reqs
+    Rotation: <span id="rotation">--</span> reqs |
+    <button id="maskBtn" onclick="toggleMask()" style="background:none;border:1px solid var(--border);color:var(--text-dim);padding:2px 8px;border-radius:4px;cursor:pointer;font-size:12px;font-family:inherit;">PII: Visible</button>
   </div>
 </div>
@@ -385,6 +473,8 @@ const DASHBOARD_HTML = `<!DOCTYPE html>
 <div class="model-routing" id="modelRouting"></div>
+<div class="advisor-panel" id="proAdvisor" style="display:none"></div>
 <div class="accounts-grid" id="accounts"></div>
 <script>
@@ -443,7 +533,7 @@ function renderModelRouting(activeAccounts) {
     return '<div class="model-route">' +
       '<span class="model-name">' + e[0] + '</span>' +
       '<span class="route-arrow">-></span>' +
-      '<span class="account-name">' + e[1] + '</span>' +
+      '<span class="account-name">' + maskText(e[1]) + '</span>' +
     '</div>';
   }).join('');
   container.innerHTML = '<div class="model-routing-title">Model Routing</div>' + rows;
@@ -487,13 +577,15 @@ function renderAccounts(data) {
     return '<div class="account-card ' + a.status + '">' +
       '<div class="card-header">' +
-        '<div class="card-label">' + a.label + '</div>' +
+        '<div class="card-label">' + maskText(a.label) + '</div>' +
         '<div class="card-badges">' +
+          (a.proDetected ? '<span class="badge badge-pro">PRO</span>' : '<span class="badge badge-free">FREE</span>') +
+          (a.familyManager ? '<span class="badge badge-fmgr">FAMILY MGR</span>' : '') +
           '<span class="badge badge-' + a.status + (isActive ? ' pulse' : '') + '">' + a.status + '</span>' +
           modelBadges +
         '</div>' +
       '</div>' +
-      '<div class="card-email">' + a.email + '</div>' +
+      '<div class="card-email">' + maskEmail(a.email) + '</div>' +
       (a.quota && a.quota.length > 0 ? renderQuotaBars(a.quota) : '') +
       '<div class="card-stats">' +
         '<div class="card-stat"><div class="stat-label">Requests</div><div class="stat-value">' +
@@ -506,12 +598,38 @@ function renderAccounts(data) {
           (a.hasValidToken ? 'var(--green)' : 'var(--text-dim)') + '">' +
           (a.hasValidToken ? 'Valid' : 'Expired') + '</div></div>' +
       '</div>' +
-      (a.lastError ? '<div class="card-error">' + a.lastError.slice(0, 150) + '</div>' : '') +
+      (a.lastError ? '<div class="card-error">' + a.lastError.slice(0, 150) + '</div>' +
+        (a.lastError.toLowerCase().includes('verif') ?
+          '<div class="card-hint">Fix: Open Antigravity IDE, sign in with this account, and complete the verification prompt. Then click Re-enable.</div>' :
+        a.lastError.toLowerCase().includes('terms of service') ?
+          '<div class="card-hint">This account was suspended by Google. Submit an appeal at <a href="https://support.google.com/accounts/troubleshooter/2402620" target="_blank" style="color:var(--cyan)">Google Account Recovery</a>, then Re-enable.</div>' :
+          '') : '') +
       (isDisabled ? '<div class="card-actions"><button class="btn-enable" onclick="enableAccount(\\'' +
         a.email + '\\')">Re-enable</button></div>' : '') +
       (isCooldown && cooldownPercent > 0 ? '<div class="cooldown-bar" style="width:' + cooldownPercent + '%"></div>' : '') +
     '</div>';
   }).join('');
+  renderProAdvisor(data.proAdvisor);
+}
+var MASK_MODE = new URLSearchParams(window.location.search).has('mask');
+var maskCounter = 0;
+var maskMap = {};
+function maskText(text) {
+  if (!MASK_MODE) return text;
+  if (!maskMap[text]) {
+    maskCounter++;
+    maskMap[text] = 'Account ' + maskCounter;
+  }
+  return maskMap[text];
+}
+function maskEmail(email) {
+  if (!MASK_MODE) return email;
+  var masked = maskText(email.split('@')[0]);
+  return masked.toLowerCase().replace(/ /g, '-') + '@***.com';
 }
 async function enableAccount(email) {
@@ -519,16 +637,50 @@ async function enableAccount(email) {
   refresh();
 }
+function renderProAdvisor(advisor) {
+  var panel = document.getElementById('proAdvisor');
+  if (!advisor) { panel.style.display = 'none'; return; }
+  panel.style.display = 'block';
+  var title = '<div class="advisor-title">Pro Family Advisor' +
+    '<span class="advisor-slots">Slots: ' + advisor.currentProCount + '/' + advisor.maxProSlots + '</span></div>';
+  if (advisor.actions.length === 0) {
+    panel.innerHTML = title + '<div class="advisor-empty">No actions recommended</div>';
+    return;
+  }
+  var rows = advisor.actions.map(function(a) {
+    var cls = a.type === 'add-pro' ? 'add-pro' : 'remove-pro';
+    var typeLabel = a.type === 'add-pro' ? 'Add Pro' : 'Remove Pro';
+    return '<div class="advisor-action ' + cls + '">' +
+      '<span class="advisor-action-type">' + typeLabel + '</span>' +
+      '<span class="advisor-action-label">' + maskText(a.label) + '</span>' +
+      '<span class="advisor-action-reason">' + a.reason + '</span>' +
+    '</div>';
+  }).join('');
+  panel.innerHTML = title + rows;
+}
 async function refresh() {
   try {
     var res = await fetch('/api/status');
     var data = await res.json();
     renderAccounts(data);
+    var btn = document.getElementById('maskBtn');
+    if (btn) btn.textContent = MASK_MODE ? 'PII: Hidden' : 'PII: Visible';
   } catch (err) {
     console.error('Status fetch failed:', err);
   }
 }
+function toggleMask() {
+  var url = new URL(window.location);
+  if (MASK_MODE) {
+    url.searchParams.delete('mask');
+  } else {
+    url.searchParams.set('mask', '1');
+  }
+  window.location.href = url.toString();
+}
 refresh();
 setInterval(refresh, 3000);
 </script>

package/src/proxy.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 // HTTP reverse proxy - forwards requests to Antigravity with credential rotation
 import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
+import { Readable } from "node:stream";
 import { ANTIGRAVITY_ENDPOINTS } from "./types.js";
 import type { AccountRuntime } from "./types.js";
 import type { AccountRotator } from "./rotator.js";
@@ -92,14 +93,12 @@ function readBody(req: IncomingMessage): Promise<Buffer> {
 /**
  * Forward a request to the real Antigravity endpoint with credential swapping.
- * Handles endpoint cascade (daily -> autopush -> prod) and 429 retry.
  */
 async function forwardRequest(
 	account: AccountRuntime,
 	body: RequestBody,
 	originalHeaders: Record<string, string>,
-	rotator: AccountRotator,
-): Promise<{ status: number; headers: Headers; body: ReadableStream<Uint8Array> | null }> {
+): Promise<Response> {
 	// Swap credentials
 	body.project = account.config.projectId;
 	const requestBody = JSON.stringify(body);
@@ -129,11 +128,9 @@ async function forwardRequest(
 		const isProd = endpointIdx === ANTIGRAVITY_ENDPOINTS.length - 1;
 		try {
-			// Timeout non-prod endpoints after 10s to avoid long hangs
 			const controller = !isProd ? new AbortController() : undefined;
 			const timeout = controller ? setTimeout(() => controller.abort(), 10_000) : undefined;
-			const fetchStart = Date.now();
 			const response = await fetch(url, {
 				method: "POST",
 				headers: forwardHeaders,
@@ -142,23 +139,13 @@ async function forwardRequest(
 			});
 			if (timeout) clearTimeout(timeout);
-			const fetchMs = Date.now() - fetchStart;
-			// On 401/403/404, try next endpoint
 			if ((response.status === 401 || response.status === 403 || response.status === 404) && endpointIdx < ANTIGRAVITY_ENDPOINTS.length - 1) {
-				log(`Endpoint ${endpoint} returned ${response.status} (${fetchMs}ms), cascading...`);
+				log(`Endpoint ${endpoint} returned ${response.status}, cascading...`);
+				response.text().catch(() => {});
 				continue;
 			}
-			if (endpointIdx > 0) {
-				log(`Using endpoint ${endpoint} (${fetchMs}ms)`);
-			}
-			return {
-				status: response.status,
-				headers: response.headers,
-				body: response.body,
-			};
+			return response;
 		} catch (err) {
 			if (endpointIdx < ANTIGRAVITY_ENDPOINTS.length - 1) {
 				log(`Endpoint ${endpoint} failed: ${err instanceof Error ? err.message : err}, cascading...`);
@@ -194,7 +181,6 @@ async function handleProxyRequest(
 		return;
 	}
-	// Try up to MAX_ENDPOINT_RETRIES accounts on 429
 	for (let attempt = 0; attempt < MAX_ENDPOINT_RETRIES; attempt++) {
 		const account = await rotator.getActiveAccount(body.model);
 		if (!account) {
@@ -207,31 +193,29 @@ async function handleProxyRequest(
 		log(`[${label}] Forwarding ${body.model} request (attempt ${attempt + 1})`);
 		try {
-			const upstream = await forwardRequest(account, { ...body }, flattenHeaders(req.headers), rotator);
+			const response = await forwardRequest(account, { ...body }, flattenHeaders(req.headers));
-			if (upstream.status === 429) {
-				// Rate limited - extract delay, mark exhausted, try next account
-				const errorText = upstream.body ? await streamToString(upstream.body) : "";
-				const cooldownMs = capCooldown(extractRetryDelay(errorText, upstream.headers));
+			if (response.status === 429) {
+				const errorText = await response.text().catch(() => "");
+				const cooldownMs = capCooldown(extractRetryDelay(errorText, response.headers));
 				log(`[${label}] 429 rate limited, cooldown ${Math.ceil(cooldownMs / 1000)}s`);
 				rotator.markExhausted(account, cooldownMs);
 				await rotator.rotateToNext(body.model);
 				continue;
 			}
-			if (upstream.status === 401) {
-				// Token was valid but API rejected it - account is blocked
-				const errorText = upstream.body ? await streamToString(upstream.body) : "";
+			if (response.status === 401) {
+				const errorText = await response.text().catch(() => "");
 				log(`[${label}] BLOCKED (401): ${errorText.slice(0, 200)}`);
 				rotator.markFlagged(account, `Account blocked (401): ${errorText.slice(0, 300)}`);
 				await rotator.rotateToNext(body.model);
 				continue;
 			}
-			if (upstream.status === 403) {
-				const errorText = upstream.body ? await streamToString(upstream.body) : "";
+			if (response.status === 403) {
+				const errorText = await response.text().catch(() => "");
 				const lower = errorText.toLowerCase();
-				const flagPatterns = ["infring", "suspend", "abus", "terminat", "violat", "banned", "policy", "forbidden"];
+				const flagPatterns = ["infring", "suspend", "abus", "terminat", "violat", "banned", "policy", "forbidden", "verif"];
 				const isFlagged = flagPatterns.some((p) => lower.includes(p));
 				if (isFlagged) {
@@ -240,54 +224,56 @@ async function handleProxyRequest(
 					await rotator.rotateToNext(body.model);
 					continue;
 				}
-				// Non-infringement 403 falls through to cascade in forwardRequest
+				// Non-flagging 403: return to client
+				log(`[${label}] 403: ${errorText.slice(0, 200)}`);
+				res.writeHead(403, { "Content-Type": "application/json" });
+				res.end(errorText || JSON.stringify({ error: "Forbidden" }));
+				return;
 			}
-			if (upstream.status >= 500) {
-				const errorText = upstream.body ? await streamToString(upstream.body) : "";
-				log(`[${label}] Server error ${upstream.status}: ${errorText.slice(0, 200)}`);
-				// On 503, don't rotate -- it's a Google capacity issue, not an account issue
-				// Return the error to the agent so it can handle retries/backoff
-				if (upstream.status === 503) {
+			if (response.status >= 500) {
+				const errorText = await response.text().catch(() => "");
+				log(`[${label}] Server error ${response.status}: ${errorText.slice(0, 200)}`);
+				if (response.status === 503) {
 					res.writeHead(503, { "Content-Type": "application/json" });
 					res.end(errorText || JSON.stringify({ error: "Server unavailable" }));
 					return;
 				}
-				rotator.markError(account, `${upstream.status}: ${errorText.slice(0, 200)}`);
+				rotator.markError(account, `${response.status}: ${errorText.slice(0, 200)}`);
 				await rotator.rotateToNext(body.model);
 				continue;
 			}
-			// Success or client error (4xx other than 429)
+			// Success or non-error client response
 			const shouldRotate = rotator.recordRequest(account);
-			// Copy response headers
 			const responseHeaders: Record<string, string> = {};
-			upstream.headers.forEach((value, key) => {
-				// Skip hop-by-hop headers
+			response.headers.forEach((value, key) => {
 				if (key.toLowerCase() !== "transfer-encoding" && key.toLowerCase() !== "connection") {
 					responseHeaders[key] = value;
 				}
 			});
-			res.writeHead(upstream.status, responseHeaders);
+			res.writeHead(response.status, responseHeaders);
-			// Stream the body back to the client
-			if (upstream.body) {
-				const reader = upstream.body.getReader();
+			// Stream body using Node.js Readable (avoids ReadableStream locking issues)
+			if (response.body) {
 				try {
-					while (true) {
-						const { done, value } = await reader.read();
-						if (done) break;
-						res.write(value);
-					}
+					const nodeStream = Readable.fromWeb(response.body as import("node:stream/web").ReadableStream);
+					await new Promise<void>((resolve) => {
+						nodeStream.on("data", (chunk: Buffer) => res.write(chunk));
+						nodeStream.on("end", resolve);
+						nodeStream.on("error", (err) => {
+							log(`[${label}] Stream error: ${err}`);
+							resolve();
+						});
+					});
 				} catch (err) {
-					log(`[${label}] Stream error: ${err}`);
+					log(`[${label}] Stream setup error: ${err}`);
 				}
 			}
 			res.end();
-			// Rotate after response completes if threshold was hit
 			if (shouldRotate) {
 				await rotator.rotateToNext(body.model);
 			}
@@ -295,13 +281,18 @@ async function handleProxyRequest(
 		} catch (err) {
 			log(`[${label}] Request failed: ${err}`);
 			rotator.markError(account, err instanceof Error ? err.message : String(err));
+			if (res.headersSent) {
+				res.end();
+				return;
+			}
 			await rotator.rotateToNext(body.model);
 			continue;
 		}
 	}
-	// All retry attempts exhausted
-	res.writeHead(502, { "Content-Type": "application/json" });
+	if (!res.headersSent) {
+		res.writeHead(502, { "Content-Type": "application/json" });
+	}
 	res.end(JSON.stringify({ error: "All retry attempts failed" }));
 }
@@ -315,25 +306,13 @@ function flattenHeaders(headers: IncomingMessage["headers"]): Record<string, str
 	return flat;
 }
-async function streamToString(stream: ReadableStream<Uint8Array>): Promise<string> {
-	const reader = stream.getReader();
-	const decoder = new TextDecoder();
-	let result = "";
-	while (true) {
-		const { done, value } = await reader.read();
-		if (done) break;
-		result += decoder.decode(value, { stream: true });
-	}
-	return result;
-}
 export function startProxy(rotator: AccountRotator, port: number): void {
 	const server = createServer((req, res) => {
-		const url = req.url || "/";
-		const method = req.method || "GET";
+		const method = req.method?.toUpperCase();
+		const url = req.url || "";
+		const pathname = url.split("?")[0];
-		// Dashboard and API routes
-		if (method === "GET" && (url === "/" || url === "/dashboard")) {
+		if (method === "GET" && (pathname === "/" || pathname === "/dashboard")) {
 			serveDashboard(res);
 			return;
 		}
@@ -366,24 +345,12 @@ export function startProxy(rotator: AccountRotator, port: number): void {
 			return;
 		}
-		// 404
 		res.writeHead(404, { "Content-Type": "application/json" });
 		res.end(JSON.stringify({ error: "Not found" }));
 	});
 	server.listen(port, "0.0.0.0", () => {
-		log(`Proxy listening on http://0.0.0.0:${port}`);
-		log(`Dashboard: http://localhost:${port}/dashboard`);
-		log(`API endpoint: http://localhost:${port}/v1internal:streamGenerateContent?alt=sse`);
+		console.log(`[proxy] Listening on 0.0.0.0:${port}`);
+		console.log(`[proxy] Dashboard: http://localhost:${port}/dashboard`);
 	});
-	// Graceful shutdown
-	const shutdown = () => {
-		log("Shutting down...");
-		rotator.saveState();
-		server.close();
-		process.exit(0);
-	};
-	process.on("SIGINT", shutdown);
-	process.on("SIGTERM", shutdown);
 }

package/src/rotator.ts CHANGED Viewed

@@ -9,6 +9,7 @@ import {
 	type ModelQuota,
 	type ModelRotationState,
 	type PersistedState,
+	type ProAdvisorAction,
 	type StatusResponse,
 	CLIENT_ID,
 	CLIENT_SECRET,
@@ -310,6 +311,16 @@ export class AccountRotator {
 		const current = this.accounts[idx];
 		if (current && this.isAvailable(current, now)) {
+			// Check if this account has quota for the requested model
+			if (modelKey) {
+				const quota = this.getModelQuota(current, modelKey);
+				if (quota === 0) {
+					this.log(
+						`${current.config.label || current.config.email} [${modelKey}]: 0% quota, skipping`,
+					);
+					return this.rotateModel(modelKey);
+				}
+			}
 			await this.ensureValidToken(current);
 			return current;
 		}
@@ -333,9 +344,13 @@ export class AccountRotator {
 			const account = this.accounts[i];
 			if (this.isAvailable(account, now)) {
-				const priority = this.getModelTimerPriority(account, modelKey);
 				const quota = this.getModelQuota(account, modelKey);
+				// Skip accounts with 0% quota for this model (they will 429)
+				if (quota === 0) continue;
+				const priority = this.getModelTimerPriority(account, modelKey);
 				if (priority < bestPriority || (priority === bestPriority && quota > bestQuota)) {
 					best = account;
 					bestPriority = priority;
@@ -600,6 +615,8 @@ export class AccountRotator {
 				consecutiveErrors: a.consecutiveErrors,
 				hasValidToken: !!(a.accessToken && a.tokenExpires > now),
 				quota: a.quota,
+				proDetected: this.isProAccount(a),
+				familyManager: !!a.config.familyManager,
 			};
 		});
@@ -610,6 +627,7 @@ export class AccountRotator {
 			totalRequestsAllAccounts: this.accounts.reduce((sum, a) => sum + a.totalRequests, 0),
 			uptime: now - this.startTime,
 			accounts,
+			proAdvisor: this.getProAdvisor(),
 		};
 	}
@@ -621,4 +639,90 @@ export class AccountRotator {
 		const ts = new Date().toISOString().slice(11, 19);
 		console.log(`[${ts}] [rotator] ${msg}`);
 	}
+	// =========================================================================
+	// Pro Family Sharing Advisor
+	// =========================================================================
+	// Model keys relevant for Pro advisor decisions (ignore Flash)
+	private static PRO_ADVISOR_MODELS = ["gemini-3.1-pro", "claude-opus-4-6-thinking"];
+	private isProAccount(account: AccountRuntime): boolean {
+		return account.quota.some((q) => q.timerType === "5h");
+	}
+	private getProAdvisor(): StatusResponse["proAdvisor"] {
+		const maxSlots = this.config.proSlots ?? 6;
+		const proAccounts = this.accounts.filter((a) => !a.disabled && !a.flagged && this.isProAccount(a));
+		const currentProCount = proAccounts.length;
+		const actions: ProAdvisorAction[] = [];
+		// Suggest "remove-pro" for Pro accounts (not family manager) with 0% on all advisor models
+		for (const account of proAccounts) {
+			if (account.config.familyManager) continue;
+			const advisorQuotas = account.quota.filter((q) =>
+				AccountRotator.PRO_ADVISOR_MODELS.some((m) => q.modelKey.includes(m) || m.includes(q.modelKey)),
+			);
+			if (advisorQuotas.length === 0) continue;
+			const allExhausted = advisorQuotas.every((q) => q.percentRemaining === 0);
+			if (allExhausted) {
+				actions.push({
+					type: "remove-pro",
+					email: account.config.email,
+					label: account.config.label || account.config.email,
+					reason: "Pro quota exhausted on G3Pro and Claude",
+				});
+			}
+		}
+		// Suggest "add-pro" for Free accounts with 0% quota and long reset, if slots available
+		const slotsAvailable = maxSlots - currentProCount + actions.filter((a) => a.type === "remove-pro").length;
+		if (slotsAvailable > 0) {
+			const candidates: { account: AccountRuntime; maxResetMs: number }[] = [];
+			for (const account of this.accounts) {
+				if (account.disabled || account.flagged) continue;
+				if (this.isProAccount(account)) continue;
+				const advisorQuotas = account.quota.filter((q) =>
+					AccountRotator.PRO_ADVISOR_MODELS.some((m) => q.modelKey.includes(m) || m.includes(q.modelKey)),
+				);
+				if (advisorQuotas.length === 0) continue;
+				// Only suggest if at least one advisor model is at 0%
+				const hasExhausted = advisorQuotas.some((q) => q.percentRemaining === 0);
+				if (!hasExhausted) continue;
+				// Find the longest reset time among exhausted models
+				let maxResetMs = 0;
+				for (const q of advisorQuotas) {
+					if (q.percentRemaining === 0 && q.resetTime) {
+						const resetMs = new Date(q.resetTime).getTime() - Date.now();
+						if (resetMs > maxResetMs) maxResetMs = resetMs;
+					}
+				}
+				// Only suggest if reset is > 24h away (otherwise not worth the Pro slot)
+				if (maxResetMs > 24 * 60 * 60 * 1000) {
+					candidates.push({ account, maxResetMs });
+				}
+			}
+			// Sort by longest reset time first (maximizes benefit)
+			candidates.sort((a, b) => b.maxResetMs - a.maxResetMs);
+			for (const { account, maxResetMs } of candidates.slice(0, slotsAvailable)) {
+				const days = Math.floor(maxResetMs / (24 * 60 * 60 * 1000));
+				const hours = Math.floor((maxResetMs % (24 * 60 * 60 * 1000)) / (60 * 60 * 1000));
+				actions.push({
+					type: "add-pro",
+					email: account.config.email,
+					label: account.config.label || account.config.email,
+					reason: `0% quota, resets in ${days}d ${hours}h`,
+				});
+			}
+		}
+		return { currentProCount, maxProSlots: maxSlots, actions };
+	}
 }

package/src/types.ts CHANGED Viewed

@@ -9,6 +9,8 @@ export interface AccountConfig {
 	label?: string;
 	// Optional - pro/free is detected dynamically from quota API reset times
 	type?: AccountType;
+	// This account owns the family plan and can never be removed from Pro
+	familyManager?: boolean;
 }
 export interface Config {
@@ -19,6 +21,8 @@ export interface Config {
 	rotateOnQuotaDrop: number;
 	// How often to poll quota (ms). Default: 5min
 	quotaPollIntervalMs: number;
+	// Max simultaneous Pro accounts (owner + members). Default: 6
+	proSlots?: number;
 }
 // Quota API response from Google
@@ -59,7 +63,7 @@ export const QUOTA_MODEL_KEYS: Record<string, { key: string; altKeys: string[];
 	},
 	claude: {
 		key: "claude-opus-4-6-thinking",
-		altKeys: ["claude-opus-4-5-thinking", "claude-opus-4-5", "claude-sonnet-4-6", "claude-sonnet-4-5"],
+		altKeys: ["claude-opus-4-5-thinking", "claude-opus-4-5", "claude-sonnet-4-6-thinking", "claude-sonnet-4-6", "claude-sonnet-4-5-thinking", "claude-sonnet-4-5"],
 		display: "Claude",
 	},
 };
@@ -134,6 +138,12 @@ export interface StatusResponse {
 	// Per-model active account
 	activeAccounts: Record<string, string>;
 	accounts: AccountStatus[];
+	// Pro family sharing advisor
+	proAdvisor: {
+		currentProCount: number;
+		maxProSlots: number;
+		actions: ProAdvisorAction[];
+	};
 }
 export interface AccountStatus {
@@ -151,6 +161,17 @@ export interface AccountStatus {
 	consecutiveErrors: number;
 	hasValidToken: boolean;
 	quota: ModelQuota[];
+	// Pro family sharing
+	proDetected: boolean;
+	familyManager: boolean;
+}
+// Pro advisor suggestion
+export interface ProAdvisorAction {
+	type: "add-pro" | "remove-pro";
+	email: string;
+	label: string;
+	reason: string;
 }
 // Antigravity OAuth constants (same as pi-mono)