@pixelzx/genesis 2026.6.13-beta.3 → 2026.6.13

package/dist/client-BtyYQE4I.js

@@ -1,713 +0,0 @@
-import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString } from "./string-coerce-DPP_aYVc.js";
-import { _ as resolveStateDir } from "./paths-Bv2rGpO9.js";
-import { n as VERSION } from "./version-qod78efn.js";
-import { n as logError, t as logDebug } from "./logger-BbnBrdB_.js";
-import { a as isLoopbackHost, c as isSecureWebSocketUrl } from "./net-BzaeD_3Q.js";
-import { n as resolveSafeTimeoutDelayMs } from "./timer-delay-Hmw9LpJm.js";
-import { n as normalizeDeviceAuthScopes, t as normalizeDeviceAuthRole } from "./device-auth-DtRVQUtN.js";
-import { t as safeParseJsonWithSchema } from "./zod-parse-B6oqrVWQ.js";
-import { a as signDevicePayload, i as publicKeyRawBase64UrlFromPem, n as loadOrCreateDeviceIdentity } from "./device-identity-zZsol52n.js";
-import { t as normalizeFingerprint } from "./fingerprint-C2pvSvS8.js";
-import { t as rawDataToString } from "./ws-CsGH_-98.js";
-import { i as GATEWAY_CLIENT_NAMES, r as GATEWAY_CLIENT_MODES } from "./client-info-DeQMz3zN.js";
-import "./message-channel-DGBKBihv.js";
-import { t as normalizeDeviceMetadataForAuth } from "./device-metadata-normalization-Diexj41H.js";
-import { l as readConnectErrorDetailCode, s as formatConnectErrorMessage, t as ConnectErrorDetailCodes, u as readConnectErrorRecoveryAdvice } from "./connect-error-details-dpux1X7K.js";
-import { Ft as validateRequestFrame, It as validateResponseFrame, W as validateEventFrame } from "./protocol-D2Tvt0kQ.js";
-import fs from "node:fs";
-import path from "node:path";
-import { randomUUID } from "node:crypto";
-import { z } from "zod";
-import { WebSocket as WebSocket$1 } from "ws";
-//#region src/shared/device-auth-store.ts
-function loadDeviceAuthTokenFromStore(params) {
-	const store = params.adapter.readStore();
-	if (!store || store.deviceId !== params.deviceId) return null;
-	const role = normalizeDeviceAuthRole(params.role);
-	const entry = store.tokens[role];
-	if (!entry || typeof entry.token !== "string") return null;
-	return entry;
-}
-function storeDeviceAuthTokenInStore(params) {
-	const role = normalizeDeviceAuthRole(params.role);
-	const existing = params.adapter.readStore();
-	const next = {
-		version: 1,
-		deviceId: params.deviceId,
-		tokens: existing && existing.deviceId === params.deviceId && existing.tokens ? { ...existing.tokens } : {}
-	};
-	const entry = {
-		token: params.token,
-		role,
-		scopes: normalizeDeviceAuthScopes(params.scopes),
-		updatedAtMs: Date.now()
-	};
-	next.tokens[role] = entry;
-	params.adapter.writeStore(next);
-	return entry;
-}
-function clearDeviceAuthTokenFromStore(params) {
-	const store = params.adapter.readStore();
-	if (!store || store.deviceId !== params.deviceId) return;
-	const role = normalizeDeviceAuthRole(params.role);
-	if (!store.tokens[role]) return;
-	const next = {
-		version: 1,
-		deviceId: store.deviceId,
-		tokens: { ...store.tokens }
-	};
-	delete next.tokens[role];
-	params.adapter.writeStore(next);
-}
-//#endregion
-//#region src/infra/device-auth-store.ts
-const DEVICE_AUTH_FILE = "device-auth.json";
-const DeviceAuthStoreSchema = z.object({
-	version: z.literal(1),
-	deviceId: z.string(),
-	tokens: z.record(z.string(), z.unknown())
-});
-function resolveDeviceAuthPath(env = process.env) {
-	return path.join(resolveStateDir(env), "identity", DEVICE_AUTH_FILE);
-}
-function readStore(filePath) {
-	try {
-		if (!fs.existsSync(filePath)) return null;
-		return safeParseJsonWithSchema(DeviceAuthStoreSchema, fs.readFileSync(filePath, "utf8"));
-	} catch {
-		return null;
-	}
-}
-function writeStore(filePath, store) {
-	fs.mkdirSync(path.dirname(filePath), { recursive: true });
-	fs.writeFileSync(filePath, `${JSON.stringify(store, null, 2)}\n`, { mode: 384 });
-	try {
-		fs.chmodSync(filePath, 384);
-	} catch {}
-}
-function loadDeviceAuthToken(params) {
-	const filePath = resolveDeviceAuthPath(params.env);
-	return loadDeviceAuthTokenFromStore({
-		adapter: {
-			readStore: () => readStore(filePath),
-			writeStore: (_store) => {}
-		},
-		deviceId: params.deviceId,
-		role: params.role
-	});
-}
-function storeDeviceAuthToken(params) {
-	const filePath = resolveDeviceAuthPath(params.env);
-	return storeDeviceAuthTokenInStore({
-		adapter: {
-			readStore: () => readStore(filePath),
-			writeStore: (store) => writeStore(filePath, store)
-		},
-		deviceId: params.deviceId,
-		role: params.role,
-		token: params.token,
-		scopes: params.scopes
-	});
-}
-function clearDeviceAuthToken(params) {
-	const filePath = resolveDeviceAuthPath(params.env);
-	clearDeviceAuthTokenFromStore({
-		adapter: {
-			readStore: () => readStore(filePath),
-			writeStore: (store) => writeStore(filePath, store)
-		},
-		deviceId: params.deviceId,
-		role: params.role
-	});
-}
-//#endregion
-//#region src/gateway/device-auth.ts
-function buildDeviceAuthPayload(params) {
-	const scopes = params.scopes.join(",");
-	const token = params.token ?? "";
-	return [
-		"v2",
-		params.deviceId,
-		params.clientId,
-		params.clientMode,
-		params.role,
-		scopes,
-		String(params.signedAtMs),
-		token,
-		params.nonce
-	].join("|");
-}
-function buildDeviceAuthPayloadV3(params) {
-	const scopes = params.scopes.join(",");
-	const token = params.token ?? "";
-	const platform = normalizeDeviceMetadataForAuth(params.platform);
-	const deviceFamily = normalizeDeviceMetadataForAuth(params.deviceFamily);
-	return [
-		"v3",
-		params.deviceId,
-		params.clientId,
-		params.clientMode,
-		params.role,
-		scopes,
-		String(params.signedAtMs),
-		token,
-		params.nonce,
-		platform,
-		deviceFamily
-	].join("|");
-}
-//#endregion
-//#region src/gateway/handshake-timeouts.ts
-const DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS = 1e4;
-const MAX_CONNECT_CHALLENGE_TIMEOUT_MS = DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS;
-function clampConnectChallengeTimeoutMs(timeoutMs) {
-	return Math.max(250, Math.min(MAX_CONNECT_CHALLENGE_TIMEOUT_MS, timeoutMs));
-}
-function getConnectChallengeTimeoutMsFromEnv(env = process.env) {
-	const raw = env.GENESIS_CONNECT_CHALLENGE_TIMEOUT_MS;
-	if (raw) {
-		const parsed = Number(raw);
-		if (Number.isFinite(parsed) && parsed > 0) return parsed;
-	}
-}
-function resolveConnectChallengeTimeoutMs(timeoutMs) {
-	if (typeof timeoutMs === "number" && Number.isFinite(timeoutMs)) return clampConnectChallengeTimeoutMs(timeoutMs);
-	const envOverride = getConnectChallengeTimeoutMsFromEnv();
-	if (envOverride !== void 0) return clampConnectChallengeTimeoutMs(envOverride);
-	return DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS;
-}
-function getPreauthHandshakeTimeoutMsFromEnv(env = process.env) {
-	const configuredTimeout = env.GENESIS_HANDSHAKE_TIMEOUT_MS || env.VITEST && env.GENESIS_TEST_HANDSHAKE_TIMEOUT_MS;
-	if (configuredTimeout) {
-		const parsed = Number(configuredTimeout);
-		if (Number.isFinite(parsed) && parsed > 0) return parsed;
-	}
-	return DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS;
-}
-//#endregion
-//#region src/gateway/client.ts
-var GatewayClientRequestError = class extends Error {
-	constructor(error) {
-		super(formatConnectErrorMessage({
-			message: error.message,
-			details: error.details
-		}));
-		this.name = "GatewayClientRequestError";
-		this.gatewayCode = error.code ?? "UNAVAILABLE";
-		this.details = error.details;
-		this.retryable = error.retryable === true;
-		this.retryAfterMs = error.retryAfterMs;
-	}
-};
-function readConnectChallengeTimeoutOverride(opts) {
-	if (typeof opts.connectChallengeTimeoutMs === "number" && Number.isFinite(opts.connectChallengeTimeoutMs)) return opts.connectChallengeTimeoutMs;
-	if (typeof opts.connectDelayMs === "number" && Number.isFinite(opts.connectDelayMs)) return opts.connectDelayMs;
-}
-function isGatewayClientStoppedError(err) {
-	const message = err instanceof Error ? err.message : String(err);
-	return message === "gateway client stopped" || message === "Error: gateway client stopped";
-}
-function resolveGatewayClientConnectChallengeTimeoutMs(opts) {
-	return resolveConnectChallengeTimeoutMs(readConnectChallengeTimeoutOverride(opts));
-}
-const FORCE_STOP_TERMINATE_GRACE_MS = 250;
-const STOP_AND_WAIT_TIMEOUT_MS = 1e3;
-var GatewayClient = class {
-	constructor(opts) {
-		this.ws = null;
-		this.pending = /* @__PURE__ */ new Map();
-		this.backoffMs = 1e3;
-		this.closed = false;
-		this.lastSeq = null;
-		this.connectNonce = null;
-		this.connectSent = false;
-		this.connectTimer = null;
-		this.pendingDeviceTokenRetry = false;
-		this.deviceTokenRetryBudgetUsed = false;
-		this.pendingConnectErrorDetailCode = null;
-		this.lastTick = null;
-		this.tickIntervalMs = 3e4;
-		this.tickTimer = null;
-		this.pendingStop = null;
-		this.socketOpened = false;
-		this.opts = {
-			...opts,
-			deviceIdentity: opts.deviceIdentity === null ? void 0 : opts.deviceIdentity ?? loadOrCreateDeviceIdentity()
-		};
-		this.requestTimeoutMs = typeof opts.requestTimeoutMs === "number" && Number.isFinite(opts.requestTimeoutMs) ? resolveSafeTimeoutDelayMs(opts.requestTimeoutMs) : 3e4;
-	}
-	start() {
-		if (this.closed) return;
-		this.clearConnectChallengeTimeout();
-		this.connectNonce = null;
-		this.connectSent = false;
-		const url = this.opts.url ?? "ws://127.0.0.1:18789";
-		if (this.opts.tlsFingerprint && !url.startsWith("wss://")) {
-			this.opts.onConnectError?.(/* @__PURE__ */ new Error("gateway tls fingerprint requires wss:// gateway url"));
-			return;
-		}
-		const allowPrivateWs = process.env.GENESIS_ALLOW_INSECURE_PRIVATE_WS === "1";
-		if (!isSecureWebSocketUrl(url, { allowPrivateWs })) {
-			let displayHost = url;
-			try {
-				displayHost = new URL(url).hostname || url;
-			} catch {}
-			const error = /* @__PURE__ */ new Error(`SECURITY ERROR: Cannot connect to "${displayHost}" over plaintext ws://. Both credentials and chat data would be exposed to network interception. Use wss:// for remote URLs. Safe defaults: keep gateway.bind=loopback and connect via SSH tunnel (ssh -N -L 18789:127.0.0.1:18789 user@gateway-host), or use Tailscale Serve/Funnel. ` + (allowPrivateWs ? "" : "Break-glass (trusted private networks only): set GENESIS_ALLOW_INSECURE_PRIVATE_WS=1. ") + "Run `genesis doctor --fix` for guidance.");
-			this.opts.onConnectError?.(error);
-			return;
-		}
-		const wsOptions = { maxPayload: 25 * 1024 * 1024 };
-		if (url.startsWith("wss://") && this.opts.tlsFingerprint) {
-			wsOptions.rejectUnauthorized = false;
-			wsOptions.checkServerIdentity = (_host, cert) => {
-				const fingerprintValue = typeof cert === "object" && cert && "fingerprint256" in cert ? cert.fingerprint256 ?? "" : "";
-				const fingerprint = normalizeFingerprint(typeof fingerprintValue === "string" ? fingerprintValue : "");
-				const expected = normalizeFingerprint(this.opts.tlsFingerprint ?? "");
-				if (!expected) return;
-				if (!fingerprint) return /* @__PURE__ */ new Error("Missing server TLS fingerprint");
-				if (fingerprint !== expected) return /* @__PURE__ */ new Error("Server TLS fingerprint mismatch");
-			};
-		}
-		const ws = new WebSocket$1(url, wsOptions);
-		this.ws = ws;
-		this.socketOpened = false;
-		this.connectNonce = null;
-		this.connectSent = false;
-		this.clearConnectChallengeTimeout();
-		ws.on("open", () => {
-			this.socketOpened = true;
-			if (url.startsWith("wss://") && this.opts.tlsFingerprint) {
-				const tlsError = this.validateTlsFingerprint();
-				if (tlsError) {
-					this.opts.onConnectError?.(tlsError);
-					this.ws?.close(1008, tlsError.message);
-					return;
-				}
-			}
-			this.beginPreauthHandshake();
-		});
-		ws.on("message", (data) => this.handleMessage(rawDataToString(data)));
-		ws.on("close", (code, reason) => {
-			const reasonText = rawDataToString(reason);
-			const connectErrorDetailCode = this.pendingConnectErrorDetailCode;
-			this.pendingConnectErrorDetailCode = null;
-			if (this.ws === ws) this.ws = null;
-			this.socketOpened = false;
-			this.resolvePendingStop(ws);
-			if (code === 1008 && normalizeLowercaseStringOrEmpty(reasonText).includes("device token mismatch") && !this.opts.token && !this.opts.password && this.opts.deviceIdentity) {
-				const deviceId = this.opts.deviceIdentity.deviceId;
-				const role = this.opts.role ?? "operator";
-				try {
-					clearDeviceAuthToken({
-						deviceId,
-						role
-					});
-					logDebug(`cleared stale device-auth token for device ${deviceId}`);
-				} catch (err) {
-					logDebug(`failed clearing stale device-auth token for device ${deviceId}: ${String(err)}`);
-				}
-			}
-			this.flushPendingErrors(/* @__PURE__ */ new Error(`gateway closed (${code}): ${reasonText}`));
-			if (this.shouldPauseReconnectAfterAuthFailure(connectErrorDetailCode)) {
-				this.opts.onClose?.(code, reasonText);
-				return;
-			}
-			this.scheduleReconnect();
-			this.opts.onClose?.(code, reasonText);
-		});
-		ws.on("error", (err) => {
-			logDebug(`gateway client error: ${String(err)}`);
-			if (!this.connectSent) this.opts.onConnectError?.(err instanceof Error ? err : new Error(String(err)));
-		});
-	}
-	stop() {
-		this.beginStop();
-	}
-	async stopAndWait(opts) {
-		const stopPromise = this.beginStop();
-		if (!stopPromise) return;
-		const timeoutMs = typeof opts?.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) ? Math.max(1, Math.floor(opts.timeoutMs)) : STOP_AND_WAIT_TIMEOUT_MS;
-		let timeout = null;
-		try {
-			await Promise.race([stopPromise, new Promise((_, reject) => {
-				timeout = setTimeout(() => {
-					reject(/* @__PURE__ */ new Error(`gateway client stop timed out after ${timeoutMs}ms`));
-				}, timeoutMs);
-				timeout.unref?.();
-			})]);
-		} finally {
-			if (timeout) clearTimeout(timeout);
-		}
-	}
-	beginStop() {
-		this.closed = true;
-		this.pendingDeviceTokenRetry = false;
-		this.deviceTokenRetryBudgetUsed = false;
-		this.pendingConnectErrorDetailCode = null;
-		if (this.tickTimer) {
-			clearInterval(this.tickTimer);
-			this.tickTimer = null;
-		}
-		this.clearConnectChallengeTimeout();
-		if (this.pendingStop) {
-			this.flushPendingErrors(/* @__PURE__ */ new Error("gateway client stopped"));
-			return this.pendingStop.promise;
-		}
-		const ws = this.ws;
-		this.ws = null;
-		if (ws) {
-			const stopPromise = this.createPendingStop(ws);
-			ws.close();
-			setTimeout(() => {
-				try {
-					ws.terminate();
-				} catch {}
-				this.resolvePendingStop(ws);
-			}, FORCE_STOP_TERMINATE_GRACE_MS).unref?.();
-			this.flushPendingErrors(/* @__PURE__ */ new Error("gateway client stopped"));
-			return stopPromise;
-		}
-		this.flushPendingErrors(/* @__PURE__ */ new Error("gateway client stopped"));
-		return null;
-	}
-	createPendingStop(ws) {
-		if (this.pendingStop?.ws === ws) return this.pendingStop.promise;
-		let resolve;
-		const promise = new Promise((res) => {
-			resolve = res;
-		});
-		this.pendingStop = {
-			ws,
-			promise,
-			resolve
-		};
-		return promise;
-	}
-	resolvePendingStop(ws) {
-		if (this.pendingStop?.ws !== ws) return;
-		const { resolve } = this.pendingStop;
-		this.pendingStop = null;
-		resolve();
-	}
-	sendConnect() {
-		if (this.connectSent) return;
-		const nonce = normalizeOptionalString(this.connectNonce) ?? "";
-		if (!nonce) {
-			this.opts.onConnectError?.(/* @__PURE__ */ new Error("gateway connect challenge missing nonce"));
-			this.ws?.close(1008, "connect challenge missing nonce");
-			return;
-		}
-		this.connectSent = true;
-		this.clearConnectChallengeTimeout();
-		const role = this.opts.role ?? "operator";
-		const { authToken, authBootstrapToken, authDeviceToken, authPassword, signatureToken, resolvedDeviceToken, storedToken, storedScopes, usingStoredDeviceToken } = this.selectConnectAuth(role);
-		if (this.pendingDeviceTokenRetry && authDeviceToken) this.pendingDeviceTokenRetry = false;
-		const auth = authToken || authBootstrapToken || authPassword || resolvedDeviceToken ? {
-			token: authToken,
-			bootstrapToken: authBootstrapToken,
-			deviceToken: authDeviceToken ?? resolvedDeviceToken,
-			password: authPassword
-		} : void 0;
-		const signedAtMs = Date.now();
-		const scopes = this.resolveConnectScopes({
-			usingStoredDeviceToken,
-			storedScopes
-		});
-		const platform = this.opts.platform ?? process.platform;
-		const device = (() => {
-			if (!this.opts.deviceIdentity) return;
-			const payload = buildDeviceAuthPayloadV3({
-				deviceId: this.opts.deviceIdentity.deviceId,
-				clientId: this.opts.clientName ?? GATEWAY_CLIENT_NAMES.GATEWAY_CLIENT,
-				clientMode: this.opts.mode ?? GATEWAY_CLIENT_MODES.BACKEND,
-				role,
-				scopes,
-				signedAtMs,
-				token: signatureToken ?? null,
-				nonce,
-				platform,
-				deviceFamily: this.opts.deviceFamily
-			});
-			const signature = signDevicePayload(this.opts.deviceIdentity.privateKeyPem, payload);
-			return {
-				id: this.opts.deviceIdentity.deviceId,
-				publicKey: publicKeyRawBase64UrlFromPem(this.opts.deviceIdentity.publicKeyPem),
-				signature,
-				signedAt: signedAtMs,
-				nonce
-			};
-		})();
-		const params = {
-			minProtocol: this.opts.minProtocol ?? 4,
-			maxProtocol: this.opts.maxProtocol ?? 4,
-			client: {
-				id: this.opts.clientName ?? GATEWAY_CLIENT_NAMES.GATEWAY_CLIENT,
-				displayName: this.opts.clientDisplayName,
-				version: this.opts.clientVersion ?? VERSION,
-				platform,
-				deviceFamily: this.opts.deviceFamily,
-				mode: this.opts.mode ?? GATEWAY_CLIENT_MODES.BACKEND,
-				instanceId: this.opts.instanceId
-			},
-			caps: Array.isArray(this.opts.caps) ? this.opts.caps : [],
-			commands: Array.isArray(this.opts.commands) ? this.opts.commands : void 0,
-			permissions: this.opts.permissions && typeof this.opts.permissions === "object" ? this.opts.permissions : void 0,
-			pathEnv: this.opts.pathEnv,
-			auth,
-			role,
-			scopes,
-			device
-		};
-		this.request("connect", params).then((helloOk) => {
-			this.pendingDeviceTokenRetry = false;
-			this.deviceTokenRetryBudgetUsed = false;
-			this.pendingConnectErrorDetailCode = null;
-			const authInfo = helloOk?.auth;
-			if (authInfo?.deviceToken && this.opts.deviceIdentity) storeDeviceAuthToken({
-				deviceId: this.opts.deviceIdentity.deviceId,
-				role: authInfo.role ?? role,
-				token: authInfo.deviceToken,
-				scopes: authInfo.scopes ?? []
-			});
-			this.backoffMs = 1e3;
-			this.tickIntervalMs = typeof helloOk.policy?.tickIntervalMs === "number" ? helloOk.policy.tickIntervalMs : 3e4;
-			this.lastTick = Date.now();
-			this.startTickWatch();
-			this.opts.onHelloOk?.(helloOk);
-		}).catch((err) => {
-			this.pendingConnectErrorDetailCode = err instanceof GatewayClientRequestError ? readConnectErrorDetailCode(err.details) : null;
-			if (this.shouldRetryWithStoredDeviceToken({
-				error: err,
-				explicitGatewayToken: normalizeOptionalString(this.opts.token),
-				resolvedDeviceToken,
-				storedToken: storedToken ?? void 0
-			})) {
-				this.pendingDeviceTokenRetry = true;
-				this.deviceTokenRetryBudgetUsed = true;
-				this.backoffMs = Math.min(this.backoffMs, 250);
-			}
-			this.opts.onConnectError?.(err instanceof Error ? err : new Error(String(err)));
-			const msg = `gateway connect failed: ${String(err)}`;
-			if (this.opts.mode === GATEWAY_CLIENT_MODES.PROBE || isGatewayClientStoppedError(err)) logDebug(msg);
-			else logError(msg);
-			this.ws?.close(1008, "connect failed");
-		});
-	}
-	resolveConnectScopes(params) {
-		if (params.usingStoredDeviceToken && Array.isArray(params.storedScopes) && params.storedScopes.length > 0) return params.storedScopes;
-		return this.opts.scopes ?? ["operator.admin"];
-	}
-	loadStoredDeviceAuth(role) {
-		if (!this.opts.deviceIdentity) return null;
-		const storedAuth = loadDeviceAuthToken({
-			deviceId: this.opts.deviceIdentity.deviceId,
-			role
-		});
-		if (!storedAuth) return null;
-		return {
-			token: storedAuth.token,
-			scopes: storedAuth.scopes
-		};
-	}
-	shouldPauseReconnectAfterAuthFailure(detailCode) {
-		if (!detailCode) return false;
-		if (detailCode === ConnectErrorDetailCodes.AUTH_TOKEN_MISSING || detailCode === ConnectErrorDetailCodes.AUTH_BOOTSTRAP_TOKEN_INVALID || detailCode === ConnectErrorDetailCodes.AUTH_PASSWORD_MISSING || detailCode === ConnectErrorDetailCodes.AUTH_PASSWORD_MISMATCH || detailCode === ConnectErrorDetailCodes.AUTH_RATE_LIMITED || detailCode === ConnectErrorDetailCodes.PAIRING_REQUIRED || detailCode === ConnectErrorDetailCodes.CONTROL_UI_DEVICE_IDENTITY_REQUIRED || detailCode === ConnectErrorDetailCodes.DEVICE_IDENTITY_REQUIRED) return true;
-		if (detailCode !== ConnectErrorDetailCodes.AUTH_TOKEN_MISMATCH) return false;
-		if (this.pendingDeviceTokenRetry) return false;
-		if (!this.isTrustedDeviceRetryEndpoint()) return true;
-		return this.deviceTokenRetryBudgetUsed;
-	}
-	shouldRetryWithStoredDeviceToken(params) {
-		if (this.deviceTokenRetryBudgetUsed) return false;
-		if (params.resolvedDeviceToken) return false;
-		if (!params.explicitGatewayToken || !params.storedToken) return false;
-		if (!this.isTrustedDeviceRetryEndpoint()) return false;
-		if (!(params.error instanceof GatewayClientRequestError)) return false;
-		const detailCode = readConnectErrorDetailCode(params.error.details);
-		const advice = readConnectErrorRecoveryAdvice(params.error.details);
-		const retryWithDeviceTokenRecommended = advice.recommendedNextStep === "retry_with_device_token";
-		return advice.canRetryWithDeviceToken === true || retryWithDeviceTokenRecommended || detailCode === ConnectErrorDetailCodes.AUTH_TOKEN_MISMATCH;
-	}
-	isTrustedDeviceRetryEndpoint() {
-		const rawUrl = this.opts.url ?? "ws://127.0.0.1:18789";
-		try {
-			const parsed = new URL(rawUrl);
-			const protocol = parsed.protocol === "https:" ? "wss:" : parsed.protocol === "http:" ? "ws:" : parsed.protocol;
-			if (isLoopbackHost(parsed.hostname)) return true;
-			return protocol === "wss:" && Boolean(this.opts.tlsFingerprint?.trim());
-		} catch {
-			return false;
-		}
-	}
-	selectConnectAuth(role) {
-		const explicitGatewayToken = normalizeOptionalString(this.opts.token);
-		const explicitBootstrapToken = normalizeOptionalString(this.opts.bootstrapToken);
-		const explicitDeviceToken = normalizeOptionalString(this.opts.deviceToken);
-		const authPassword = normalizeOptionalString(this.opts.password);
-		const storedAuth = this.loadStoredDeviceAuth(role);
-		const storedToken = storedAuth?.token ?? null;
-		const storedScopes = storedAuth?.scopes;
-		const shouldUseDeviceRetryToken = this.pendingDeviceTokenRetry && !explicitDeviceToken && Boolean(explicitGatewayToken) && Boolean(storedToken) && this.isTrustedDeviceRetryEndpoint();
-		const resolvedDeviceToken = explicitDeviceToken ?? (shouldUseDeviceRetryToken || !(explicitGatewayToken || authPassword) && (!explicitBootstrapToken || Boolean(storedToken)) ? storedToken ?? void 0 : void 0);
-		const reusingStoredDeviceToken = Boolean(resolvedDeviceToken) && !explicitDeviceToken && Boolean(storedToken) && resolvedDeviceToken === storedToken;
-		const authToken = explicitGatewayToken ?? resolvedDeviceToken;
-		const authBootstrapToken = !explicitGatewayToken && !resolvedDeviceToken ? explicitBootstrapToken : void 0;
-		return {
-			authToken,
-			authBootstrapToken,
-			authDeviceToken: shouldUseDeviceRetryToken ? storedToken ?? void 0 : void 0,
-			authPassword,
-			signatureToken: authToken ?? authBootstrapToken ?? void 0,
-			resolvedDeviceToken,
-			storedToken: storedToken ?? void 0,
-			storedScopes,
-			usingStoredDeviceToken: reusingStoredDeviceToken
-		};
-	}
-	handleMessage(raw) {
-		try {
-			const parsed = JSON.parse(raw);
-			if (validateEventFrame(parsed)) {
-				this.lastTick = Date.now();
-				const evt = parsed;
-				if (evt.event === "connect.challenge") {
-					const payload = evt.payload;
-					const nonce = payload && typeof payload.nonce === "string" ? payload.nonce : null;
-					if (!nonce || nonce.trim().length === 0) {
-						this.opts.onConnectError?.(/* @__PURE__ */ new Error("gateway connect challenge missing nonce"));
-						this.ws?.close(1008, "connect challenge missing nonce");
-						return;
-					}
-					this.connectNonce = nonce.trim();
-					if (this.socketOpened) this.sendConnect();
-					return;
-				}
-				const seq = typeof evt.seq === "number" ? evt.seq : null;
-				if (seq !== null) {
-					if (this.lastSeq !== null && seq > this.lastSeq + 1) this.opts.onGap?.({
-						expected: this.lastSeq + 1,
-						received: seq
-					});
-					this.lastSeq = seq;
-				}
-				if (evt.event === "tick") this.lastTick = Date.now();
-				this.opts.onEvent?.(evt);
-				return;
-			}
-			if (validateResponseFrame(parsed)) {
-				this.lastTick = Date.now();
-				const pending = this.pending.get(parsed.id);
-				if (!pending) return;
-				const status = parsed.payload?.status;
-				if (pending.expectFinal && status === "accepted") return;
-				this.pending.delete(parsed.id);
-				if (pending.timeout) clearTimeout(pending.timeout);
-				if (parsed.ok) pending.resolve(parsed.payload);
-				else pending.reject(new GatewayClientRequestError({
-					code: parsed.error?.code,
-					message: parsed.error?.message ?? "unknown error",
-					details: parsed.error?.details,
-					retryable: parsed.error?.retryable,
-					retryAfterMs: parsed.error?.retryAfterMs
-				}));
-			}
-		} catch (err) {
-			logDebug(`gateway client parse error: ${String(err)}`);
-		}
-	}
-	beginPreauthHandshake() {
-		if (this.connectSent) return;
-		if (this.connectNonce && !this.connectSent) {
-			this.armConnectChallengeTimeout();
-			this.sendConnect();
-			return;
-		}
-		this.armConnectChallengeTimeout();
-	}
-	clearConnectChallengeTimeout() {
-		if (this.connectTimer) {
-			clearTimeout(this.connectTimer);
-			this.connectTimer = null;
-		}
-	}
-	armConnectChallengeTimeout() {
-		const connectChallengeTimeoutMs = resolveGatewayClientConnectChallengeTimeoutMs(this.opts);
-		const armedAt = Date.now();
-		this.clearConnectChallengeTimeout();
-		this.connectTimer = setTimeout(() => {
-			if (this.connectSent || this.ws?.readyState !== WebSocket$1.OPEN) return;
-			const elapsedMs = Date.now() - armedAt;
-			this.opts.onConnectError?.(/* @__PURE__ */ new Error(`gateway connect challenge timeout (waited ${elapsedMs}ms, limit ${connectChallengeTimeoutMs}ms)`));
-			this.ws?.close(1008, "connect challenge timeout");
-		}, connectChallengeTimeoutMs);
-	}
-	scheduleReconnect() {
-		if (this.closed) return;
-		if (this.tickTimer) {
-			clearInterval(this.tickTimer);
-			this.tickTimer = null;
-		}
-		const delay = this.backoffMs;
-		this.backoffMs = Math.min(this.backoffMs * 2, 3e4);
-		setTimeout(() => this.start(), delay).unref();
-	}
-	flushPendingErrors(err) {
-		for (const [, p] of this.pending) {
-			if (p.timeout) clearTimeout(p.timeout);
-			p.reject(err);
-		}
-		this.pending.clear();
-	}
-	startTickWatch() {
-		if (this.tickTimer) clearInterval(this.tickTimer);
-		const rawMinInterval = this.opts.tickWatchMinIntervalMs;
-		const minInterval = typeof rawMinInterval === "number" && Number.isFinite(rawMinInterval) ? Math.max(1, Math.min(3e4, rawMinInterval)) : 1e3;
-		const interval = Math.max(this.tickIntervalMs, minInterval);
-		this.tickTimer = setInterval(() => {
-			if (this.closed) return;
-			if (!this.lastTick) return;
-			if (this.pending.size > 0) return;
-			if (Date.now() - this.lastTick > this.tickIntervalMs * 2) this.ws?.close(4e3, "tick timeout");
-		}, interval);
-	}
-	validateTlsFingerprint() {
-		if (!this.opts.tlsFingerprint || !this.ws) return null;
-		const expected = normalizeFingerprint(this.opts.tlsFingerprint);
-		if (!expected) return /* @__PURE__ */ new Error("gateway tls fingerprint missing");
-		const socket = this.ws._socket;
-		if (!socket || typeof socket.getPeerCertificate !== "function") return /* @__PURE__ */ new Error("gateway tls fingerprint unavailable");
-		const fingerprint = normalizeFingerprint(socket.getPeerCertificate()?.fingerprint256 ?? "");
-		if (!fingerprint) return /* @__PURE__ */ new Error("gateway tls fingerprint unavailable");
-		if (fingerprint !== expected) return /* @__PURE__ */ new Error("gateway tls fingerprint mismatch");
-		return null;
-	}
-	async request(method, params, opts) {
-		if (!this.ws || this.ws.readyState !== WebSocket$1.OPEN) throw new Error("gateway not connected");
-		const id = randomUUID();
-		const frame = {
-			type: "req",
-			id,
-			method,
-			params
-		};
-		if (!validateRequestFrame(frame)) throw new Error(`invalid request frame: ${JSON.stringify(validateRequestFrame.errors, null, 2)}`);
-		const expectFinal = opts?.expectFinal === true;
-		const timeoutMs = opts?.timeoutMs === null ? null : typeof opts?.timeoutMs === "number" && Number.isFinite(opts.timeoutMs) ? resolveSafeTimeoutDelayMs(opts.timeoutMs) : expectFinal ? null : this.requestTimeoutMs;
-		const p = new Promise((resolve, reject) => {
-			const timeout = timeoutMs === null ? null : setTimeout(() => {
-				this.pending.delete(id);
-				reject(/* @__PURE__ */ new Error(`gateway request timeout for ${method}`));
-			}, timeoutMs);
-			this.pending.set(id, {
-				resolve: (value) => resolve(value),
-				reject,
-				expectFinal,
-				timeout
-			});
-		});
-		this.ws.send(JSON.stringify(frame));
-		return p;
-	}
-};
-//#endregion
-export { buildDeviceAuthPayloadV3 as a, buildDeviceAuthPayload as i, GatewayClientRequestError as n, getPreauthHandshakeTimeoutMsFromEnv as r, GatewayClient as t };