@pablopunk/tau 0.1.0 → 0.1.2

package/dist/{wait-for-lock-D2V3vuye.js → src-DO9LUlhi.js}

@@ -682,7 +682,9 @@ const HubLinkSchema = Type.Object({
 	hubUrl: Type.Union([Type.String(), Type.Null()]),
 	since: Type.Union([Type.Number(), Type.Null()]),
 	/** A neutral sentence for the user ("Hub unreachable", "Update tau on the hub"). */
-	message: Type.Union([Type.String(), Type.Null()])
+	message: Type.Union([Type.String(), Type.Null()]),
+	/** The OS of this tau itself ("darwin arm64"), set by core on every read. */
+	os: Type.Optional(Type.String())
 });
 const HUB_LINK_NONE = {
 	state: "none",
@@ -827,6 +829,15 @@ const OpenTerminalInputSchema = Type.Object({
 });
 const TerminalAvailabilitySchema = Type.Object({ available: Type.Boolean() });
 //#endregion
+//#region ../protocol/src/updates.ts
+/** This tau's version against the latest published one. `latest` and `checkedAt` are null until a check succeeds. */
+const UpdateStatusSchema = Type.Object({
+	current: Type.String(),
+	latest: Type.Union([Type.String(), Type.Null()]),
+	checkedAt: Type.Union([Type.Number(), Type.Null()]),
+	behind: Type.Boolean()
+});
+//#endregion
 //#region ../protocol/src/rest.ts
 const API_PREFIX$1 = "/api";
 const LIVE_PATH = `${API_PREFIX$1}/live`;
@@ -962,6 +973,18 @@ const routes = {
 		path: `${API_PREFIX$1}/machines/link`,
 		status: 200
 	},
+	getUpdateStatus: {
+		method: "GET",
+		path: `${API_PREFIX$1}/update`,
+		status: 200,
+		response: UpdateStatusSchema
+	},
+	refreshUpdateStatus: {
+		method: "POST",
+		path: `${API_PREFIX$1}/update/refresh`,
+		status: 200,
+		response: UpdateStatusSchema
+	},
 	getSettings: {
 		method: "GET",
 		path: `${API_PREFIX$1}/settings`,
@@ -2524,7 +2547,7 @@ function* chunkBody(id, body, text = false) {
 * `protocol-version.test.ts` fails when the surface changes and this value does not; run
 * `mise exec -- pnpm --filter @tau/protocol bump-protocol` to rewrite it.
 */
-const PROTOCOL_VERSION = "2920245394fa6ab6f484a959fae886b4";
+const PROTOCOL_VERSION = "52f4e01e45d4338519dfea5564becdf1";
 //#endregion
 //#region ../protocol/src/retry.ts
 const RETRY_ENTRY_KINDS = [
@@ -2545,6 +2568,41 @@ function isRetryable(view) {
 	return last !== void 0 && !isFinishedAnswer(last);
 }
 //#endregion
+//#region ../protocol/src/versions.ts
+const PLAIN = /^(\d+)\.(\d+)\.(\d+)$/;
+const WITH_PRE = /^(\d+)\.(\d+)\.(\d+)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+const isPlainVersion = (text) => PLAIN.test(text);
+function parts(version) {
+	const match = WITH_PRE.exec(version);
+	if (!match) throw new Error(`Not a version: ${version}`);
+	return {
+		core: [
+			Number(match[1]),
+			Number(match[2]),
+			Number(match[3])
+		],
+		prerelease: version.includes("-")
+	};
+}
+/** Negative when `a < b`, 0 when equal, positive when `a > b`. A prerelease is below its release. */
+function compareVersions(a, b) {
+	const left = parts(a);
+	const right = parts(b);
+	for (let index = 0; index < 3; index++) {
+		const diff = (left.core[index] ?? 0) - (right.core[index] ?? 0);
+		if (diff !== 0) return diff;
+	}
+	return Number(right.prerelease) - Number(left.prerelease);
+}
+/** Total: `undefined` when either side is empty or not a version. Equal or ahead is not behind. */
+function isBehind(current, latest) {
+	try {
+		return compareVersions(current, latest) < 0;
+	} catch {
+		return;
+	}
+}
+//#endregion
 //#region ../protocol/src/view-text.ts
 const TOOL_ARGUMENT_LIMIT = 80;
 const blocksOf$1 = (content) => Array.isArray(content) ? content : [];
@@ -5883,7 +5941,7 @@ function loadConfig2() {
 		throw new Error(`Failed to parse ${CONFIG_PATH3}: ${message}`);
 	}
 }
-function withTimeout(signal, timeoutMs) {
+function withTimeout$1(signal, timeoutMs) {
 	const timeout = AbortSignal.timeout(timeoutMs);
 	return signal ? AbortSignal.any([signal, timeout]) : timeout;
 }
@@ -6017,7 +6075,7 @@ function isGeminiApiAvailableWithVideo() {
 	return hasGeminiApiKeySource2() || isGatewayConfigured();
 }
 async function queryGeminiApiWithInlineData(prompt, data, mimeType, options = {}) {
-	const signal = withTimeout(options.signal, options.timeoutMs ?? 12e4);
+	const signal = withTimeout$1(options.signal, options.timeoutMs ?? 12e4);
 	const apiKey = isGeminiAdcAvailable() ? null : options.apiKey ?? await getApiKey(signal);
 	if (!apiKey && !isGatewayConfigured() && !isGeminiAdcAvailable()) throw new Error(`Gemini API not configured. Either:
   1. Configure geminiApiKey in ${CONFIG_PATH3} or set GEMINI_API_KEY
@@ -6049,7 +6107,7 @@ async function queryGeminiApiWithInlineData(prompt, data, mimeType, options = {}
 	};
 }
 async function queryGeminiApiWithVideo(prompt, videoUri, options = {}) {
-	const signal = withTimeout(options.signal, options.timeoutMs ?? 12e4);
+	const signal = withTimeout$1(options.signal, options.timeoutMs ?? 12e4);
 	const apiKey = options.apiKey ?? await getApiKey(signal);
 	if (!apiKey && !isGatewayConfigured()) throw new Error(`Gemini API not configured. Either:
   1. Configure geminiApiKey in ${CONFIG_PATH3} or set GEMINI_API_KEY
@@ -8188,7 +8246,7 @@ async function fetchBatch(urls, apiKey, signal, options = {}) {
 	return tinyFishJsonRequest("Fetch", TINYFISH_FETCH_URL, apiKey, {
 		method: "POST",
 		body: JSON.stringify(fetchBody(urls, options))
-	}, FETCH_TIMEOUT_MS, signal);
+	}, FETCH_TIMEOUT_MS$1, signal);
 }
 async function fetchInlineContent(urls, apiKey, signal) {
 	const content = [];
@@ -8277,7 +8335,7 @@ var TINYFISH_SEARCH_URL;
 var TINYFISH_FETCH_URL;
 var CONFIG_PATH11;
 var SEARCH_TIMEOUT_MS5;
-var FETCH_TIMEOUT_MS;
+var FETCH_TIMEOUT_MS$1;
 var MAX_FETCH_URLS;
 var MAX_FETCH_PER_URL_TIMEOUT_MS;
 var cachedConfig10;
@@ -8292,7 +8350,7 @@ var init_tinyfish = __esm({ "tinyfish.ts"() {
 	TINYFISH_FETCH_URL = "https://api.fetch.tinyfish.ai";
 	CONFIG_PATH11 = getWebSearchConfigPath();
 	SEARCH_TIMEOUT_MS5 = 6e4;
-	FETCH_TIMEOUT_MS = 15e4;
+	FETCH_TIMEOUT_MS$1 = 15e4;
 	MAX_FETCH_URLS = 10;
 	MAX_FETCH_PER_URL_TIMEOUT_MS = 11e4;
 	cachedConfig10 = null;
@@ -37376,7 +37434,10 @@ function createMachines(deps) {
 			await deps.access.revokeDevice(id);
 			announce();
 		},
-		hubState: async () => link,
+		hubState: async () => ({
+			...link,
+			os: `${process.platform} ${process.arch}`
+		}),
 		async disconnectHub() {
 			await deps.forgetHub?.();
 			link = HUB_LINK_NONE;
@@ -41880,7 +41941,10 @@ function createFakeRemoteAdapter(now = Date.now) {
 			state: "online",
 			since: now()
 		} : online()),
-		disable: async () => set(REMOTE_OFF),
+		disable: async () => set({
+			...REMOTE_OFF,
+			url: current.url
+		}),
 		recreate: async () => set(online()),
 		onStatus(listener) {
 			listeners.add(listener);
@@ -41900,6 +41964,9 @@ function createFakeRemoteAdapter(now = Date.now) {
 		close: async () => void listeners.clear()
 	};
 }
+//#endregion
+//#region ../core/src/remote/neutral-text.ts
+const STARTING_TEXT = "Setting up remote access (usually 3-6 minutes).";
 const OFFLINE_TEXT = "Cannot reach the tunnel service";
 const RECREATE_TEXT = "The tunnel has been offline for 10 minutes. You can make a new URL.";
 const GENERIC = "The tunnel service had a problem.";
@@ -41913,6 +41980,14 @@ function isNetworkFailure(error) {
 	return NETWORK_CODES.test(text);
 }
 const neutralFailure = (error) => neutralRemoteText(isNetworkFailure(error));
+const CREATE_DEADLINE_MS = 72e4;
+const STAGE_TEXT = {
+	"generating-csr": "Preparing the certificate request.",
+	"requesting-certificate": "Requesting the certificate.",
+	"waiting-certificate": "Waiting for the certificate (usually 3-6 minutes)."
+};
+/** The message for a provisioning stage; stages without text keep the generic one. */
+const stageText = (stage) => STAGE_TEXT[stage] ?? "Setting up remote access (usually 3-6 minutes).";
 //#endregion
 //#region ../core/src/remote/status-machine.ts
 const RECREATE_AFTER_MS = 6e5;
@@ -41956,8 +42031,8 @@ function createStatusMachine(now, schedule = timeoutSchedule) {
 			if (offlineStates.includes(state) && !keepsOfflineClock) armRecreateTimer();
 			if (!offlineStates.includes(state)) cancelTimer?.();
 			const canRecreate = keepsOfflineClock && current.canRecreate;
-			const message = patch.message ?? (state === "starting" ? "Starting. The first time takes a few minutes." : null);
-			const url = patch.url === void 0 ? state === "off" ? null : current.url : patch.url;
+			const message = patch.message ?? (state === "starting" ? keptStartingMessage(current) : null);
+			const url = patch.url === void 0 ? current.url : patch.url;
 			const since = state === current.state && current.since !== null ? current.since : now();
 			publish({
 				...current,
@@ -41976,6 +42051,7 @@ function createStatusMachine(now, schedule = timeoutSchedule) {
 		}
 	};
 }
+const keptStartingMessage = (current) => current.state === "starting" && current.message ? current.message : STARTING_TEXT;
 //#endregion
 //#region ../core/src/remote/tunnel-profiles.ts
 const profileNameFor = (directory) => `tau-${createHash("sha256").update(directory).digest("hex").slice(0, 8)}`;
@@ -42055,7 +42131,20 @@ function createOpenTunnelAdapter(deps) {
 		}
 	}
 	async function connect(run) {
-		const identity = await client.tunnel.get({ profile }) ?? await client.tunnel.resume({ profile }) ?? await client.tunnel.create({ profile });
+		const onProgress = (stage) => {
+			if (run === generation && machine.status().state === "starting") machine.set("starting", { message: stageText(stage) });
+		};
+		const cancelCreate = schedule(() => {
+			if (run === generation && machine.status().state === "starting") machine.set("error", { message: OFFLINE_TEXT });
+		}, CREATE_DEADLINE_MS);
+		const identity = await client.tunnel.get({ profile }) ?? await client.tunnel.resume({
+			profile,
+			onProgress
+		}) ?? await client.tunnel.create({
+			profile,
+			onProgress
+		});
+		cancelCreate();
 		if (run !== generation) return;
 		const url = urlOf(identity.hostname);
 		machine.set("starting", { url });
@@ -42095,6 +42184,10 @@ function createOpenTunnelAdapter(deps) {
 		connection = void 0;
 		await live?.close().catch(() => void 0);
 	}
+	async function showKeptUrl() {
+		const kept = await client.tunnel.get({ profile }).catch(() => void 0);
+		if (kept && machine.status().state === "off") machine.set("off", { url: urlOf(kept.hostname) });
+	}
 	const active = () => [
 		"starting",
 		"online",
@@ -42111,13 +42204,7 @@ function createOpenTunnelAdapter(deps) {
 		},
 		async disable() {
 			await stopConnection();
-			try {
-				await client.tunnel.remove({ profile });
-			} catch {
-				await profiles.retireMain().catch(() => void 0);
-				retryRemovals();
-			}
-			machine.set("off");
+			machine.set("off", { message: null });
 			return machine.status();
 		},
 		async recreate() {
@@ -42133,6 +42220,7 @@ function createOpenTunnelAdapter(deps) {
 			retryRemovals();
 			if (holdReason) machine.set("off", { message: holdReason });
 			else if (enabled) await this.enable();
+			else await showKeptUrl();
 		},
 		async close() {
 			await stopConnection();
@@ -42157,8 +42245,6 @@ function createRemoteService({ adapter, settings, access, changes, forgetMachine
 		async disable() {
 			const status = await adapter.disable();
 			await settings.setRemoteEnabled(false);
-			await access.clearAll();
-			await forgetMachines?.();
 			changes.emit({ resource: "remote" });
 			return status;
 		},
@@ -43130,6 +43216,70 @@ function createTitleService(deps) {
 		}
 	} };
 }
+//#endregion
+//#region ../core/src/updates/update-service.ts
+const REFRESH_EVERY_MS = 216e5;
+const FETCH_TIMEOUT_MS = 1e4;
+function withTimeout(work, ms) {
+	let timer;
+	const timeout = new Promise((_, reject) => {
+		timer = setTimeout(() => reject(/* @__PURE__ */ new Error("timed out")), ms);
+		timer.unref();
+	});
+	return Promise.race([work, timeout]).finally(() => clearTimeout(timer));
+}
+function createUpdateService(deps) {
+	let latest = null;
+	let checkedAt = null;
+	let lastAttemptAt = null;
+	let inflight;
+	let timer;
+	let stopped = false;
+	const snapshot = () => ({
+		current: deps.currentVersion,
+		latest,
+		checkedAt,
+		behind: latest === null ? false : isBehind(deps.currentVersion, latest) ?? false
+	});
+	const check = () => {
+		if (inflight) return inflight;
+		lastAttemptAt = deps.now();
+		inflight = withTimeout(Promise.resolve().then(deps.latestVersion), FETCH_TIMEOUT_MS).then((version) => {
+			latest = version;
+			checkedAt = deps.now();
+		}).catch(() => void 0).finally(() => {
+			inflight = void 0;
+		});
+		return inflight;
+	};
+	const startTimer = () => {
+		if (timer || stopped) return;
+		timer = setInterval(() => void check(), REFRESH_EVERY_MS);
+		timer.unref();
+	};
+	return {
+		async status() {
+			if (lastAttemptAt === null && !stopped) {
+				check();
+				startTimer();
+			}
+			return snapshot();
+		},
+		async refresh() {
+			if (stopped) return snapshot();
+			startTimer();
+			const recent = lastAttemptAt !== null && deps.now() - lastAttemptAt < 6e4;
+			if (inflight) await inflight;
+			else if (!recent) await check();
+			return snapshot();
+		},
+		stop() {
+			stopped = true;
+			if (timer) clearInterval(timer);
+			timer = void 0;
+		}
+	};
+}
 const CRASH_LOOP_WINDOW_MS = 3e5;
 const REASONS = [
 	"clean",
@@ -43793,6 +43943,11 @@ async function createCoreWith(options, deps) {
 			remoteUrl: () => tunnel.status().url,
 			announce: () => changes.emit({ resource: "devices" })
 		});
+		const updates = createUpdateService({
+			currentVersion: options.currentVersion,
+			latestVersion: options.latestVersion,
+			now: deps.now
+		});
 		const machines = createMachines({
 			directory: home.machinesDirectory,
 			now: deps.now,
@@ -43879,10 +44034,15 @@ async function createCoreWith(options, deps) {
 				mcp,
 				changes
 			}),
+			updates: {
+				status: () => updates.status(),
+				refresh: () => updates.refresh()
+			},
 			onChange: (listener) => changes.subscribe(listener),
 			close() {
 				closing ??= (async () => {
 					changes.clear();
+					updates.stop();
 					await remote.close();
 					await archivedCleanup.stop();
 					clones.stopAll();
@@ -43925,27 +44085,4 @@ function publishServerUrl(home, url, version) {
 	}));
 }
 //#endregion
-//#region src/lifecycle/wait-for-lock.ts
-const LOCK_POLL_MS = 5e3;
-const sleepFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-/** `serve --service` waits here while a foreground tau holds the home, so no manager sees an exit loop. */
-async function waitForFreeHome(home, dependencies = {}) {
-	const { readInstance = readRunningInstance, sleep = sleepFor, log, intervalMs = LOCK_POLL_MS } = dependencies;
-	let announced = false;
-	for (let owner = await readInstance(home); owner; owner = await readInstance(home)) {
-		if (!announced) log?.(`Another tau (pid ${owner.pid}) holds ${home}. Waiting for it to stop.`);
-		announced = true;
-		await sleep(intervalMs);
-	}
-}
-/** Polls until the running server has published its URL. */
-async function waitForUrl(home, dependencies = {}) {
-	const { readInstance = readRunningInstance, sleep = sleepFor, intervalMs = 250, attempts = 60 } = dependencies;
-	for (let attempt = 0; attempt < attempts; attempt += 1) {
-		const info = await readInstance(home);
-		if (info?.url) return info;
-		await sleep(intervalMs);
-	}
-}
-//#endregion
-export { routes as $, changedFrame as A, COMMAND_NOUNS as B, LIVE_MAX_FRAME_BYTES as C, TERMINAL_STREAM_PATH as D, TERMINAL_STREAM_MAX_INPUT_BYTES as E, ERROR_STATUS as F, isModelRefNode as G, commandOf as H, isAppError as I, LIVE_PATH as J, routeFields as K, isErrorBody as L, decodeServerFrame as M, encodeFrame as N, TerminalClientFrameSchema as O, AppError as P, iconCandidateUrl as Q, toErrorBody as R, encodeDataFrame as S, TERMINAL_STREAM_CLOSE_UNKNOWN as T, commands as U, FLOW_COMMANDS as V, flagNameOf as W, PAIR_PAGE_PATH as X, MESSAGE_BODY_LIMIT as Y, fillPath as Z, LINK_PING_INTERVAL_MS as _, readRunningInstance as a, chunkBody as b, lastAssistantText as c, CHUNK_BYTES as d, HUB_LINK_NONE as et, CREDIT_WINDOW_BYTES as f, LINK_OFFLINE_AFTER_MS as g, LINK_NO_CREDIT_CLOSE_MS as h, publishServerUrl as i, RedeemPairingResponseSchema as it, decodeClientFrame as j, WS_MAX_PAYLOAD_BYTES as k, viewToText as l, LINK_CLOSE_UPDATE_REQUIRED as m, waitForFreeHome as n, nextViewState as nt, createCore as o, LINK_CLOSE_NO_CREDIT as p, API_PREFIX$1 as q, waitForUrl as r, RETIRED_OPS as rt, createExitMarker as s, LOCK_POLL_MS as t, MACHINE_PROXY_PREFIX as tt, PROTOCOL_VERSION as u, LinkFrameSchema as v, TERMINAL_STREAM_CLOSE_SLOW as w, decodeDataFrame as x, MACHINE_LINK_PATH as y, AUTO_FIELDS as z };
+export { routes as $, changedFrame as A, COMMAND_NOUNS as B, LIVE_MAX_FRAME_BYTES as C, TERMINAL_STREAM_PATH as D, TERMINAL_STREAM_MAX_INPUT_BYTES as E, ERROR_STATUS as F, isModelRefNode as G, commandOf as H, isAppError as I, LIVE_PATH as J, routeFields as K, isErrorBody as L, decodeServerFrame as M, encodeFrame as N, TerminalClientFrameSchema as O, AppError as P, iconCandidateUrl as Q, toErrorBody as R, encodeDataFrame as S, TERMINAL_STREAM_CLOSE_UNKNOWN as T, commands as U, FLOW_COMMANDS as V, flagNameOf as W, PAIR_PAGE_PATH as X, MESSAGE_BODY_LIMIT as Y, fillPath as Z, LINK_PING_INTERVAL_MS as _, lastAssistantText as a, chunkBody as b, isBehind as c, CHUNK_BYTES as d, HUB_LINK_NONE as et, CREDIT_WINDOW_BYTES as f, LINK_OFFLINE_AFTER_MS as g, LINK_NO_CREDIT_CLOSE_MS as h, createExitMarker as i, RedeemPairingResponseSchema as it, decodeClientFrame as j, WS_MAX_PAYLOAD_BYTES as k, isPlainVersion as l, LINK_CLOSE_UPDATE_REQUIRED as m, readRunningInstance as n, nextViewState as nt, viewToText as o, LINK_CLOSE_NO_CREDIT as p, API_PREFIX$1 as q, createCore as r, RETIRED_OPS as rt, compareVersions as s, publishServerUrl as t, MACHINE_PROXY_PREFIX as tt, PROTOCOL_VERSION as u, LinkFrameSchema as v, TERMINAL_STREAM_CLOSE_SLOW as w, decodeDataFrame as x, MACHINE_LINK_PATH as y, AUTO_FIELDS as z };

package/dist/wait-for-lock-B1Qx8GWg.js

@@ -0,0 +1 @@
+export { r as waitForUrl } from "./wait-for-lock-CrSl2mi1.js";

package/dist/wait-for-lock-CrSl2mi1.js

@@ -0,0 +1,25 @@
+import { n as readRunningInstance } from "./src-DO9LUlhi.js";
+//#region src/lifecycle/wait-for-lock.ts
+const LOCK_POLL_MS = 5e3;
+const sleepFor = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** `serve --service` waits here while a foreground tau holds the home, so no manager sees an exit loop. */
+async function waitForFreeHome(home, dependencies = {}) {
+	const { readInstance = readRunningInstance, sleep = sleepFor, log, intervalMs = LOCK_POLL_MS } = dependencies;
+	let announced = false;
+	for (let owner = await readInstance(home); owner; owner = await readInstance(home)) {
+		if (!announced) log?.(`Another tau (pid ${owner.pid}) holds ${home}. Waiting for it to stop.`);
+		announced = true;
+		await sleep(intervalMs);
+	}
+}
+/** Polls until the running server has published its URL. */
+async function waitForUrl(home, dependencies = {}) {
+	const { readInstance = readRunningInstance, sleep = sleepFor, intervalMs = 250, attempts = 60 } = dependencies;
+	for (let attempt = 0; attempt < attempts; attempt += 1) {
+		const info = await readInstance(home);
+		if (info?.url) return info;
+		await sleep(intervalMs);
+	}
+}
+//#endregion
+export { waitForFreeHome as n, waitForUrl as r, LOCK_POLL_MS as t };