@cmmd-center/forge 0.13.44 → 0.13.45

package/dist/bin.cjs

@@ -66243,7 +66243,7 @@ function normalizeNumberish(value) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.13.44";
+var version$1 = "0.13.45";
 //#endregion
 //#region src/sentry.ts
 const SERVER_APP_NAME = "forge-server";
@@ -94509,7 +94509,7 @@ const prepareBootstrapWorktree = (input) => require_Schema$1.gen(function* () {
 		projectCwd: bootstrapWorktree.projectCwd
 	};
 });
-const dispatchBootstrapTurnStart = (input, command) => require_Schema$1.gen(function* () {
+const dispatchBootstrapTurnStart$1 = (input, command) => require_Schema$1.gen(function* () {
 	const { orchestrationEngine, git, gitStatusBroadcaster, projectSetupScriptRunner } = input;
 	const bootstrap = command.bootstrap;
 	const { bootstrap: _bootstrap, ...finalTurnStartCommand } = command;
@@ -94659,6 +94659,48 @@ const dispatchBootstrapTurnStart = (input, command) => require_Schema$1.gen(func
 	})), command.threadId);
 });
 //#endregion
+//#region src/orchestration/Services/SpriteTaskHoldReactor.ts
+/**
+* SpriteTaskHoldReactor - keeps a Fly.io Sprite awake while a turn is running.
+*
+* Reacts to provider turn lifecycle events and holds the sprite's run open for
+* the duration of each turn. See `sprite/spriteTaskHold.ts` for the measurements
+* and the ordering rule this depends on.
+*
+* @module SpriteTaskHoldReactor
+*/
+/**
+* SpriteTaskHoldReactor - Service tag for the sprite task hold worker.
+*/
+var SpriteTaskHoldReactor = class extends require_Schema$1.Service()("forge/orchestration/Services/SpriteTaskHoldReactor") {};
+//#endregion
+//#region src/orchestration/bootstrapLaunch.ts
+/**
+* The entry point for launching a thread: a bootstrap turn start, held awake.
+*
+* A launch creates the thread, adds the worktree and starts the setup script before the first
+* provider event exists, so no turn hold covers it. On a sprite with nothing connected that
+* work advances at about 1.7% of wall clock (`sprite/spriteTaskHold.ts`). A person who sends a
+* first message and closes the tab would otherwise wait most of an hour for a one-minute
+* install.
+*
+* Callers import the dispatch from here. `bootstrapDispatch.ts` stays unaware of sprites.
+*/
+/**
+* Runs a launch with the sprite held awake. A launch that fails or is cancelled releases the
+* hold. One that succeeds keeps it: the reactor hands over to the turn's own hold when the turn
+* starts, and the hold's refresh budget ends it if the turn never does. Where no reactor is
+* wired the launch runs unchanged.
+*/
+const withLaunchHold = (threadId, launch) => require_Schema$1.gen(function* () {
+	const reactor = yield* require_Schema$1.serviceOption(SpriteTaskHoldReactor);
+	if (require_Schema$1.isNone(reactor)) return yield* launch;
+	const release = () => reactor.value.releaseLaunch(threadId);
+	return yield* require_Schema$1.uninterruptible(reactor.value.holdLaunch(threadId)).pipe(require_Schema$1.andThen(require_Schema$1.yieldNow), require_Schema$1.andThen(launch), require_Schema$1.onError(release));
+});
+/** `dispatchBootstrapTurnStart` from `bootstrapDispatch.ts`, with the launch held awake. */
+const dispatchBootstrapTurnStart = (input, command) => withLaunchHold(String(command.threadId), dispatchBootstrapTurnStart$1(input, command));
+//#endregion
 //#region src/orchestration/Services/OrchestrationEngine.ts
 /**
 * OrchestrationEngineService - Service tag for orchestration engine access.
@@ -240999,8 +241041,13 @@ var SpriteTaskHoldManager = class {
 	activeTurnIds() {
 		return [...this.#holds.keys()];
 	}
-	async acquire(turnId, threadId = null) {
+	/**
+	* `maxRefreshes` bounds a hold that has no terminal event of its own, such as a launch
+	* whose turn may never start. When the budget is spent the hold releases itself.
+	*/
+	async acquire(turnId, threadId = null, options = {}) {
 		if (this.#holds.has(turnId)) return;
+		let refreshesLeft = options.maxRefreshes ?? Number.POSITIVE_INFINITY;
 		const name = spriteTaskHoldName(this.#config.namePrefix, turnId);
 		const hold = {
 			name,
@@ -241024,6 +241071,11 @@ var SpriteTaskHoldManager = class {
 		if (hold.released || this.#holds.get(turnId) !== hold) return;
 		hold.refresher = this.#timer.setInterval(() => {
 			if (hold.inFlight.size > 0) return;
+			if (refreshesLeft <= 0) {
+				if (this.#holds.get(turnId) === hold) this.release(turnId);
+				return;
+			}
+			refreshesLeft -= 1;
 			const refresh = this.#transport.put(name, 300).catch((cause) => this.#onError(`failed to refresh sprite task hold for turn ${turnId}`, cause));
 			hold.inFlight.add(refresh);
 			refresh.finally(() => hold.inFlight.delete(refresh));
@@ -287087,21 +287139,6 @@ var ProviderRuntimeIngestionService = class extends require_Schema$1.Service()("
 //#region src/orchestration/Services/PlanTaskCreationReactor.ts
 var PlanTaskCreationReactor = class extends require_Schema$1.Service()("forge/orchestration/Services/PlanTaskCreationReactor") {};
 //#endregion
-//#region src/orchestration/Services/SpriteTaskHoldReactor.ts
-/**
-* SpriteTaskHoldReactor - keeps a Fly.io Sprite awake while a turn is running.
-*
-* Reacts to provider turn lifecycle events and holds the sprite's run open for
-* the duration of each turn. See `sprite/spriteTaskHold.ts` for the measurements
-* and the ordering rule this depends on.
-*
-* @module SpriteTaskHoldReactor
-*/
-/**
-* SpriteTaskHoldReactor - Service tag for the sprite task hold worker.
-*/
-var SpriteTaskHoldReactor = class extends require_Schema$1.Service()("forge/orchestration/Services/SpriteTaskHoldReactor") {};
-//#endregion
 //#region src/persistence/Services/ProjectionProjects.ts
 /**
 * ProjectionProjectRepository - Projection repository interface for projects.
@@ -293651,34 +293688,67 @@ const CheckpointReactorLive = require_Schema$1.effect(CheckpointReactor, make$7)
 * it is provider-agnostic: codex, claude and every other adapter emit
 * `turn.started` / `turn.completed` through `ProviderService.streamEvents`.
 */
+/**
+* A launch hold refreshes every 60 s, so this budget is about ten minutes. A launch whose turn
+* never starts, because the provider refused it or the process died first, has no event to
+* release it. The budget is what stops that hold from keeping the sprite billing.
+*/
+const LAUNCH_HOLD_MAX_REFRESHES = 10;
+/** The hold id of a thread's launch. One launch per thread, so the thread names it. */
+const launchHoldId = (threadId) => `launch-${threadId}`;
 const make$6 = require_Schema$1.gen(function* () {
 	const providerService = yield* ProviderService;
 	const manager = makeSpriteTaskHoldManager(process.env, (message, cause) => {
 		require_Schema$1.runFork(require_Schema$1.logWarning(message, { cause: cause instanceof Error ? cause.message : cause }));
 	});
+	const launchCallers = /* @__PURE__ */ new Map();
+	const start = require_Schema$1.fn("start")(function* () {
+		if (manager === null) return;
+		yield* require_Schema$1.forkScoped(require_Path.runForEach(providerService.streamEvents, (event) => {
+			if (event.type === "turn.started") {
+				const turnId = event.turnId;
+				if (turnId === void 0) return require_Schema$1.void_;
+				return require_Schema$1.promise(async () => {
+					await manager.acquire(String(turnId), String(event.threadId));
+					launchCallers.delete(String(event.threadId));
+					await manager.release(launchHoldId(String(event.threadId)));
+				});
+			}
+			if (event.type === "turn.completed") {
+				const turnId = event.turnId;
+				if (turnId === void 0) return require_Schema$1.void_;
+				return require_Schema$1.promise(() => manager.release(String(turnId)));
+			}
+			if (event.type === "turn.aborted") {
+				const turnId = event.turnId;
+				if (turnId === void 0) return require_Schema$1.void_;
+				return require_Schema$1.promise(() => manager.release(String(turnId)));
+			}
+			if (event.type === "session.exited") {
+				launchCallers.delete(String(event.threadId));
+				return require_Schema$1.promise(() => manager.releaseThread(String(event.threadId)));
+			}
+			return require_Schema$1.void_;
+		}));
+	});
+	/** Takes the launch hold for one more caller. The budget bounds a launch that never starts a turn. */
+	const holdLaunch = (threadId) => require_Schema$1.promise(async () => {
+		if (manager === null) return;
+		launchCallers.set(threadId, (launchCallers.get(threadId) ?? 0) + 1);
+		await manager.acquire(launchHoldId(threadId), threadId, { maxRefreshes: LAUNCH_HOLD_MAX_REFRESHES });
+	});
+	/** Lets one caller go. The hold itself is released when the last caller has let go. */
+	const releaseLaunch = (threadId) => require_Schema$1.promise(async () => {
+		if (manager === null) return;
+		const remaining = (launchCallers.get(threadId) ?? 1) - 1;
+		if (remaining > 0) return void launchCallers.set(threadId, remaining);
+		launchCallers.delete(threadId);
+		await manager.release(launchHoldId(threadId));
+	});
 	return {
-		start: require_Schema$1.fn("start")(function* () {
-			if (manager === null) return;
-			yield* require_Schema$1.forkScoped(require_Path.runForEach(providerService.streamEvents, (event) => {
-				if (event.type === "turn.started") {
-					const turnId = event.turnId;
-					if (turnId === void 0) return require_Schema$1.void_;
-					return require_Schema$1.promise(() => manager.acquire(String(turnId), String(event.threadId)));
-				}
-				if (event.type === "turn.completed") {
-					const turnId = event.turnId;
-					if (turnId === void 0) return require_Schema$1.void_;
-					return require_Schema$1.promise(() => manager.release(String(turnId)));
-				}
-				if (event.type === "turn.aborted") {
-					const turnId = event.turnId;
-					if (turnId === void 0) return require_Schema$1.void_;
-					return require_Schema$1.promise(() => manager.release(String(turnId)));
-				}
-				if (event.type === "session.exited") return require_Schema$1.promise(() => manager.releaseThread(String(event.threadId)));
-				return require_Schema$1.void_;
-			}));
-		}),
+		start,
+		holdLaunch,
+		releaseLaunch,
 		releaseAll: require_Schema$1.promise(() => manager === null ? Promise.resolve() : manager.releaseAll())
 	};
 });
@@ -297824,7 +297894,7 @@ function resolveBuildCommitFromEnv(env) {
 * environment descriptor down instead of reporting an honest "unknown".
 */
 function readBakedBuildCommit() {
-	return "26f43848517ca37f7f080fc7a81902c6d0a197f1";
+	return "8ada8bfccfb8a4b0827961f304821e7b11249865";
 }
 async function resolveServerBuildCommit(input) {
 	if (isFullCommitSha(input.baked)) return input.baked;

package/dist/bin.mjs

@@ -23,7 +23,7 @@ import { createCipheriv, createDecipheriv, createHash, createHmac, createPublicK
 import * as FS$1 from "node:fs";
 import fs, { accessSync, chmodSync, constants, createReadStream, existsSync, mkdirSync, mkdtempSync, promises, readFile, readFileSync, readdir, readdirSync, realpathSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import * as NodeOS from "node:os";
-import $U, { homedir, networkInterfaces, tmpdir } from "node:os";
+import os, { homedir, networkInterfaces, tmpdir } from "node:os";
 import * as Path$1 from "node:path";
 import path, { basename, delimiter, dirname, extname, isAbsolute, join, posix, relative, resolve, sep } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -50560,7 +50560,7 @@ function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
 	const min = forceColor || 0;
 	if (env.TERM === "dumb") return min;
 	if (process$1.platform === "win32") {
-		const osRelease = $U.release().split(".");
+		const osRelease = os.release().split(".");
 		if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) return Number(osRelease[2]) >= 14931 ? 3 : 2;
 		return 1;
 	}
@@ -53003,7 +53003,7 @@ var require_ProcessDetector = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.processDetector = void 0;
 	const api_1 = (init_esm$1(), __toCommonJS(esm_exports$1));
 	const semconv_1 = require_semconv$1();
-	const os$3 = __require("os");
+	const os$4 = __require("os");
 	/**
 	* ProcessDetector will be used to detect the resources related current process running
 	* and being instrumented from the NodeJS Process module.
@@ -53025,7 +53025,7 @@ var require_ProcessDetector = /* @__PURE__ */ __commonJSMin(((exports) => {
 			};
 			if (process.argv.length > 1) attributes[semconv_1.ATTR_PROCESS_COMMAND] = process.argv[1];
 			try {
-				const userInfo = os$3.userInfo();
+				const userInfo = os$4.userInfo();
 				attributes[semconv_1.ATTR_PROCESS_OWNER] = userInfo.username;
 			} catch (e) {
 				api_1.diag.debug(`error obtaining process owner: ${e}`);
@@ -65948,7 +65948,7 @@ function normalizeNumberish(value) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.13.44";
+var version$1 = "0.13.45";
 //#endregion
 //#region src/sentry.ts
 const SERVER_APP_NAME = "forge-server";
@@ -75830,7 +75830,7 @@ var require_node_gyp_build = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 	var fs$6 = __require("fs");
 	var path$5 = __require("path");
 	var url$1 = __require("url");
-	var os$2 = __require("os");
+	var os$3 = __require("os");
 	var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : __require;
 	var vars = process.config && process.config.variables || {};
 	var prebuildsOnly = !!process.env.PREBUILDS_ONLY;
@@ -75838,8 +75838,8 @@ var require_node_gyp_build = /* @__PURE__ */ __commonJSMin(((exports, module) =>
 	var abi = versions.modules;
 	if (versions.deno || process.isBun) abi = "unsupported";
 	var runtime = isElectron() ? "electron" : isNwjs() ? "node-webkit" : "node";
-	var arch = process.env.npm_config_arch || os$2.arch();
-	var platform = process.env.npm_config_platform || os$2.platform();
+	var arch = process.env.npm_config_arch || os$3.arch();
+	var platform = process.env.npm_config_platform || os$3.platform();
 	var libc = process.env.LIBC || (isMusl(platform) ? "musl" : "glibc");
 	var armv = process.env.ARM_VERSION || (arch === "arm64" ? "8" : vars.arm_version) || "";
 	var uv = (versions.uv || "").split(".")[0];
@@ -93527,7 +93527,7 @@ const launchDetached = (launch) => gen(function* () {
 });
 const OpenLive = effect(Open, gen(function* () {
 	const open = yield* tryPromise({
-		try: () => import("./open-2-reBrpv.mjs"),
+		try: () => import("./open-yHTUkd2Y.mjs"),
 		catch: (cause) => new OpenError$1({
 			message: "failed to load browser opener",
 			cause
@@ -94146,7 +94146,7 @@ const prepareBootstrapWorktree = (input) => gen(function* () {
 		projectCwd: bootstrapWorktree.projectCwd
 	};
 });
-const dispatchBootstrapTurnStart = (input, command) => gen(function* () {
+const dispatchBootstrapTurnStart$1 = (input, command) => gen(function* () {
 	const { orchestrationEngine, git, gitStatusBroadcaster, projectSetupScriptRunner } = input;
 	const bootstrap = command.bootstrap;
 	const { bootstrap: _bootstrap, ...finalTurnStartCommand } = command;
@@ -94296,6 +94296,48 @@ const dispatchBootstrapTurnStart = (input, command) => gen(function* () {
 	})), command.threadId);
 });
 //#endregion
+//#region src/orchestration/Services/SpriteTaskHoldReactor.ts
+/**
+* SpriteTaskHoldReactor - keeps a Fly.io Sprite awake while a turn is running.
+*
+* Reacts to provider turn lifecycle events and holds the sprite's run open for
+* the duration of each turn. See `sprite/spriteTaskHold.ts` for the measurements
+* and the ordering rule this depends on.
+*
+* @module SpriteTaskHoldReactor
+*/
+/**
+* SpriteTaskHoldReactor - Service tag for the sprite task hold worker.
+*/
+var SpriteTaskHoldReactor = class extends Service$1()("forge/orchestration/Services/SpriteTaskHoldReactor") {};
+//#endregion
+//#region src/orchestration/bootstrapLaunch.ts
+/**
+* The entry point for launching a thread: a bootstrap turn start, held awake.
+*
+* A launch creates the thread, adds the worktree and starts the setup script before the first
+* provider event exists, so no turn hold covers it. On a sprite with nothing connected that
+* work advances at about 1.7% of wall clock (`sprite/spriteTaskHold.ts`). A person who sends a
+* first message and closes the tab would otherwise wait most of an hour for a one-minute
+* install.
+*
+* Callers import the dispatch from here. `bootstrapDispatch.ts` stays unaware of sprites.
+*/
+/**
+* Runs a launch with the sprite held awake. A launch that fails or is cancelled releases the
+* hold. One that succeeds keeps it: the reactor hands over to the turn's own hold when the turn
+* starts, and the hold's refresh budget ends it if the turn never does. Where no reactor is
+* wired the launch runs unchanged.
+*/
+const withLaunchHold = (threadId, launch) => gen(function* () {
+	const reactor = yield* serviceOption(SpriteTaskHoldReactor);
+	if (isNone(reactor)) return yield* launch;
+	const release = () => reactor.value.releaseLaunch(threadId);
+	return yield* uninterruptible(reactor.value.holdLaunch(threadId)).pipe(andThen(yieldNow), andThen(launch), onError$1(release));
+});
+/** `dispatchBootstrapTurnStart` from `bootstrapDispatch.ts`, with the launch held awake. */
+const dispatchBootstrapTurnStart = (input, command) => withLaunchHold(String(command.threadId), dispatchBootstrapTurnStart$1(input, command));
+//#endregion
 //#region src/orchestration/Services/OrchestrationEngine.ts
 /**
 * OrchestrationEngineService - Service tag for orchestration engine access.
@@ -191003,7 +191045,7 @@ var Vce = {
 function Ve() {
 	return Vce;
 }
-var Us = $U.homedir(), lk = $U.tmpdir(), { env: Vc } = process$1, Yce = (e) => {
+var Us = os.homedir(), lk = os.tmpdir(), { env: Vc } = process$1, Yce = (e) => {
 	let t = path.join(Us, "Library");
 	return {
 		data: path.join(t, "Application Support", e),
@@ -201203,12 +201245,12 @@ function qZ(e, t) {
 	}
 	return n;
 }
-var os$1 = "https://code.claude.com/docs/en", kKe = [
+var os$2 = "https://code.claude.com/docs/en", kKe = [
 	{
 		matches: (e) => e.path === "permissions.defaultMode" && e.code === "invalid_value",
 		tip: {
 			suggestion: "Valid modes: \"acceptEdits\" (ask before file changes), \"plan\" (analysis only), \"bypassPermissions\" (auto-accept all), or \"default\" (standard behavior)",
-			docLink: `${os$1}/iam#permission-modes`
+			docLink: `${os$2}/iam#permission-modes`
 		}
 	},
 	{
@@ -201223,7 +201265,7 @@ var os$1 = "https://code.claude.com/docs/en", kKe = [
 		matches: (e) => e.path.startsWith("env.") && e.code === "invalid_type",
 		tip: {
 			suggestion: "Environment variables must be strings. Wrap numbers and booleans in quotes. Example: \"DEBUG\": \"true\", \"PORT\": \"3000\"",
-			docLink: `${os$1}/settings#environment-variables`
+			docLink: `${os$2}/settings#environment-variables`
 		}
 	},
 	{
@@ -201234,14 +201276,14 @@ var os$1 = "https://code.claude.com/docs/en", kKe = [
 		matches: (e) => e.path.startsWith("hooks.") && e.code === "invalid_key",
 		tip: {
 			suggestion: "Not a recognized hook event. Common events: PreToolUse, PostToolUse, UserPromptSubmit, SessionStart, SessionEnd, Stop. Check spelling and capitalization.",
-			docLink: `${os$1}/hooks`
+			docLink: `${os$2}/hooks`
 		}
 	},
 	{
 		matches: (e) => /\.hooks\.\d+\.command$/.test(e.path) && e.code === "invalid_type" && e.received === "undefined",
 		tip: {
 			suggestion: "Command hooks require `command`. For exec form (no shell), set `command` to the executable and `args` to its arguments: {\"type\": \"command\", \"command\": \"echo\", \"args\": [\"hi\"]}. For shell form, set `command` to the full shell string: {\"type\": \"command\", \"command\": \"echo hi\"}.",
-			docLink: `${os$1}/hooks#exec-form-and-shell-form`
+			docLink: `${os$2}/hooks#exec-form-and-shell-form`
 		}
 	},
 	{
@@ -201256,7 +201298,7 @@ var os$1 = "https://code.claude.com/docs/en", kKe = [
 		matches: (e) => e.code === "unrecognized_keys",
 		tip: {
 			suggestion: "Check for typos or refer to the documentation for valid fields",
-			docLink: `${os$1}/settings`
+			docLink: `${os$2}/settings`
 		}
 	},
 	{
@@ -201271,13 +201313,13 @@ var os$1 = "https://code.claude.com/docs/en", kKe = [
 		matches: (e) => e.path === "permissions.additionalDirectories" && e.code === "invalid_type",
 		tip: {
 			suggestion: "Must be an array of directory paths. Example: [\"~/projects\", \"/tmp/workspace\"]. You can also use --add-dir flag or /add-dir command",
-			docLink: `${os$1}/iam#working-directories`
+			docLink: `${os$2}/iam#working-directories`
 		}
 	}
 ], AKe = {
-	permissions: `${os$1}/iam#configuring-permissions`,
-	env: `${os$1}/settings#environment-variables`,
-	hooks: `${os$1}/hooks`
+	permissions: `${os$2}/iam#configuring-permissions`,
+	env: `${os$2}/settings#environment-variables`,
+	hooks: `${os$2}/hooks`
 };
 function GZ(e) {
 	let t = kKe.find((r) => r.matches(e));
@@ -240517,8 +240559,13 @@ var SpriteTaskHoldManager = class {
 	activeTurnIds() {
 		return [...this.#holds.keys()];
 	}
-	async acquire(turnId, threadId = null) {
+	/**
+	* `maxRefreshes` bounds a hold that has no terminal event of its own, such as a launch
+	* whose turn may never start. When the budget is spent the hold releases itself.
+	*/
+	async acquire(turnId, threadId = null, options = {}) {
 		if (this.#holds.has(turnId)) return;
+		let refreshesLeft = options.maxRefreshes ?? Number.POSITIVE_INFINITY;
 		const name = spriteTaskHoldName(this.#config.namePrefix, turnId);
 		const hold = {
 			name,
@@ -240542,6 +240589,11 @@ var SpriteTaskHoldManager = class {
 		if (hold.released || this.#holds.get(turnId) !== hold) return;
 		hold.refresher = this.#timer.setInterval(() => {
 			if (hold.inFlight.size > 0) return;
+			if (refreshesLeft <= 0) {
+				if (this.#holds.get(turnId) === hold) this.release(turnId);
+				return;
+			}
+			refreshesLeft -= 1;
 			const refresh = this.#transport.put(name, 300).catch((cause) => this.#onError(`failed to refresh sprite task hold for turn ${turnId}`, cause));
 			hold.inFlight.add(refresh);
 			refresh.finally(() => hold.inFlight.delete(refresh));
@@ -269248,7 +269300,7 @@ var import_multicast_dns = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMi
 	var dgram = __require("dgram");
 	var thunky = require_thunky();
 	var events = __require("events");
-	var os = __require("os");
+	var os$1 = __require("os");
 	var noop = function() {};
 	module.exports = function(opts) {
 		if (!opts) opts = {};
@@ -269379,14 +269431,14 @@ var import_multicast_dns = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMi
 		return that;
 	};
 	function defaultInterface() {
-		var networks = os.networkInterfaces();
+		var networks = os$1.networkInterfaces();
 		var names = Object.keys(networks);
 		for (var i = 0; i < names.length; i++) {
 			var net = networks[names[i]];
 			for (var j = 0; j < net.length; j++) {
 				var iface = net[j];
 				if (isIPv4(iface.family) && !iface.internal) {
-					if (os.platform() === "darwin" && names[i] === "en0") return iface.address;
+					if (os$1.platform() === "darwin" && names[i] === "en0") return iface.address;
 					return "0.0.0.0";
 				}
 			}
@@ -269394,7 +269446,7 @@ var import_multicast_dns = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMi
 		return "127.0.0.1";
 	}
 	function allInterfaces() {
-		var networks = os.networkInterfaces();
+		var networks = os$1.networkInterfaces();
 		var names = Object.keys(networks);
 		var res = [];
 		for (var i = 0; i < names.length; i++) {
@@ -286597,21 +286649,6 @@ var ProviderRuntimeIngestionService = class extends Service$1()("forge/orchestra
 //#region src/orchestration/Services/PlanTaskCreationReactor.ts
 var PlanTaskCreationReactor = class extends Service$1()("forge/orchestration/Services/PlanTaskCreationReactor") {};
 //#endregion
-//#region src/orchestration/Services/SpriteTaskHoldReactor.ts
-/**
-* SpriteTaskHoldReactor - keeps a Fly.io Sprite awake while a turn is running.
-*
-* Reacts to provider turn lifecycle events and holds the sprite's run open for
-* the duration of each turn. See `sprite/spriteTaskHold.ts` for the measurements
-* and the ordering rule this depends on.
-*
-* @module SpriteTaskHoldReactor
-*/
-/**
-* SpriteTaskHoldReactor - Service tag for the sprite task hold worker.
-*/
-var SpriteTaskHoldReactor = class extends Service$1()("forge/orchestration/Services/SpriteTaskHoldReactor") {};
-//#endregion
 //#region src/persistence/Services/ProjectionProjects.ts
 /**
 * ProjectionProjectRepository - Projection repository interface for projects.
@@ -293113,34 +293150,82 @@ const CheckpointReactorLive = effect(CheckpointReactor, gen(function* () {
 		drain: worker.drain
 	};
 }));
+//#endregion
+//#region src/orchestration/Layers/SpriteTaskHoldReactor.ts
+/**
+* Holds the sprite awake for the duration of every agent turn.
+*
+* A sprite's cgroup freezes ~1s after the last inbound request, so a turn that
+* nobody is watching advances at ~1.7% of wall clock. A task hold restores it to
+* 100%. Measurements and the release-ordering rule live in
+* `sprite/spriteTaskHold.ts`; the platform contract is documented in
+* `docs/specs/2026-07-30-sprites-platform-ground-truth.md` §1.
+*
+* This subscribes to the same provider event stream CheckpointReactor uses, so
+* it is provider-agnostic: codex, claude and every other adapter emit
+* `turn.started` / `turn.completed` through `ProviderService.streamEvents`.
+*/
+/**
+* A launch hold refreshes every 60 s, so this budget is about ten minutes. A launch whose turn
+* never starts, because the provider refused it or the process died first, has no event to
+* release it. The budget is what stops that hold from keeping the sprite billing.
+*/
+const LAUNCH_HOLD_MAX_REFRESHES = 10;
+/** The hold id of a thread's launch. One launch per thread, so the thread names it. */
+const launchHoldId = (threadId) => `launch-${threadId}`;
 const SpriteTaskHoldReactorLive = effect(SpriteTaskHoldReactor, gen(function* () {
 	const providerService = yield* ProviderService;
 	const manager = makeSpriteTaskHoldManager(process.env, (message, cause) => {
 		runFork(logWarning$1(message, { cause: cause instanceof Error ? cause.message : cause }));
 	});
+	const launchCallers = /* @__PURE__ */ new Map();
+	const start = fn$1("start")(function* () {
+		if (manager === null) return;
+		yield* forkScoped(runForEach(providerService.streamEvents, (event) => {
+			if (event.type === "turn.started") {
+				const turnId = event.turnId;
+				if (turnId === void 0) return void_$1;
+				return promise(async () => {
+					await manager.acquire(String(turnId), String(event.threadId));
+					launchCallers.delete(String(event.threadId));
+					await manager.release(launchHoldId(String(event.threadId)));
+				});
+			}
+			if (event.type === "turn.completed") {
+				const turnId = event.turnId;
+				if (turnId === void 0) return void_$1;
+				return promise(() => manager.release(String(turnId)));
+			}
+			if (event.type === "turn.aborted") {
+				const turnId = event.turnId;
+				if (turnId === void 0) return void_$1;
+				return promise(() => manager.release(String(turnId)));
+			}
+			if (event.type === "session.exited") {
+				launchCallers.delete(String(event.threadId));
+				return promise(() => manager.releaseThread(String(event.threadId)));
+			}
+			return void_$1;
+		}));
+	});
+	/** Takes the launch hold for one more caller. The budget bounds a launch that never starts a turn. */
+	const holdLaunch = (threadId) => promise(async () => {
+		if (manager === null) return;
+		launchCallers.set(threadId, (launchCallers.get(threadId) ?? 0) + 1);
+		await manager.acquire(launchHoldId(threadId), threadId, { maxRefreshes: LAUNCH_HOLD_MAX_REFRESHES });
+	});
+	/** Lets one caller go. The hold itself is released when the last caller has let go. */
+	const releaseLaunch = (threadId) => promise(async () => {
+		if (manager === null) return;
+		const remaining = (launchCallers.get(threadId) ?? 1) - 1;
+		if (remaining > 0) return void launchCallers.set(threadId, remaining);
+		launchCallers.delete(threadId);
+		await manager.release(launchHoldId(threadId));
+	});
 	return {
-		start: fn$1("start")(function* () {
-			if (manager === null) return;
-			yield* forkScoped(runForEach(providerService.streamEvents, (event) => {
-				if (event.type === "turn.started") {
-					const turnId = event.turnId;
-					if (turnId === void 0) return void_$1;
-					return promise(() => manager.acquire(String(turnId), String(event.threadId)));
-				}
-				if (event.type === "turn.completed") {
-					const turnId = event.turnId;
-					if (turnId === void 0) return void_$1;
-					return promise(() => manager.release(String(turnId)));
-				}
-				if (event.type === "turn.aborted") {
-					const turnId = event.turnId;
-					if (turnId === void 0) return void_$1;
-					return promise(() => manager.release(String(turnId)));
-				}
-				if (event.type === "session.exited") return promise(() => manager.releaseThread(String(event.threadId)));
-				return void_$1;
-			}));
-		}),
+		start,
+		holdLaunch,
+		releaseLaunch,
 		releaseAll: promise(() => manager === null ? Promise.resolve() : manager.releaseAll())
 	};
 }));
@@ -297255,7 +297340,7 @@ function resolveBuildCommitFromEnv(env) {
 * environment descriptor down instead of reporting an honest "unknown".
 */
 function readBakedBuildCommit() {
-	return "26f43848517ca37f7f080fc7a81902c6d0a197f1";
+	return "8ada8bfccfb8a4b0827961f304821e7b11249865";
 }
 async function resolveServerBuildCommit(input) {
 	if (isFullCommitSha(input.baked)) return input.baked;
@@ -321856,7 +321941,7 @@ const connectLoginCommand = make$34("login", {
 			})).json();
 		},
 		openBrowser: async (url) => {
-			const open = (await import("./open-2-reBrpv.mjs")).default;
+			const open = (await import("./open-yHTUkd2Y.mjs")).default;
 			await open(url);
 			return true;
 		},