@fased/fased 0.1.48 → 0.1.49

package/dist/gateway/hooks-mapping.js

@@ -1,7 +1,7 @@
 import { CONFIG_PATH } from "../config/paths.js";
 import "../config/config.js";
 import { importFileModule, resolveFunctionModuleExport } from "../hooks/module-loader.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/gateway/hooks-mapping.ts
@@ -301,8 +301,8 @@ function escapesBase(baseDir, candidate) {
 }
 function safeRealpathSync(candidate) {
 	try {
-		const nativeRealpath = fs.realpathSync.native;
-		return nativeRealpath ? nativeRealpath(candidate) : fs.realpathSync(candidate);
+		const nativeRealpath = syncFs.realpathSync.native;
+		return nativeRealpath ? nativeRealpath(candidate) : syncFs.realpathSync(candidate);
 	} catch {
 		return null;
 	}
@@ -310,7 +310,7 @@ function safeRealpathSync(candidate) {
 function resolveExistingAncestor(candidate) {
 	let current = path.resolve(candidate);
 	while (true) {
-		if (fs.existsSync(current)) {
+		if (syncFs.existsSync(current)) {
 			return current;
 		}
 		const parent = path.dirname(current);

package/dist/gateway/protocol/schema/agents-models-skills.js

@@ -303,6 +303,7 @@ const ModelsAuthStatusParamsSchema = Type.Object({}, { additionalProperties: fal
 const ModelsAuthStatusKindSchema = Type.Union([
 	Type.Literal("ok"),
 	Type.Literal("expiring"),
+	Type.Literal("refresh-required"),
 	Type.Literal("expired"),
 	Type.Literal("missing"),
 	Type.Literal("static")

package/dist/gateway/protocol/schema/frames.js

@@ -47,6 +47,11 @@ const HelloOkSchema = Type.Object({
 	protocol: Type.Integer({ minimum: 1 }),
 	server: Type.Object({
 		version: NonEmptyString,
+		runtimeSource: Type.Optional(Type.Union([
+			Type.Literal("source-checkout"),
+			Type.Literal("managed-package"),
+			Type.Literal("packaged-runtime")
+		])),
 		connId: NonEmptyString
 	}, { additionalProperties: false }),
 	features: Type.Object({

package/dist/gateway/protocol/schema/snapshot.js

@@ -6,6 +6,7 @@ const PresenceEntrySchema = Type.Object({
 	host: Type.Optional(NonEmptyString),
 	ip: Type.Optional(NonEmptyString),
 	version: Type.Optional(NonEmptyString),
+	runtimeSource: Type.Optional(NonEmptyString),
 	platform: Type.Optional(NonEmptyString),
 	deviceFamily: Type.Optional(NonEmptyString),
 	modelIdentifier: Type.Optional(NonEmptyString),

package/dist/gateway/server/ws-connection/message-handler.js

@@ -1,4 +1,4 @@
-import { resolveRuntimeServiceVersion } from "../../../version.js";
+import { resolveRuntimeServiceVersion, resolveRuntimeSource } from "../../../version.js";
 import { loadConfig } from "../../../config/io.js";
 import "../../../config/config.js";
 import { GATEWAY_CLIENT_IDS } from "../../protocol/client-info.js";
@@ -744,6 +744,7 @@ function attachGatewayWsMessageHandler(params) {
 					protocol: PROTOCOL_VERSION,
 					server: {
 						version: resolveRuntimeServiceVersion(process.env, "dev"),
+						runtimeSource: resolveRuntimeSource(process.env),
 						connId
 					},
 					features: {

package/dist/gateway/server-discovery.js

@@ -1,6 +1,6 @@
 import { runExec } from "../process/exec.js";
 import { getTailnetHostname } from "../infra/tailscale.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/gateway/server-discovery.ts
@@ -20,7 +20,7 @@ function resolveBonjourCliPath(opts = {}) {
 	if (envPath) {
 		return envPath;
 	}
-	const statSync = opts.statSync ?? fs.statSync;
+	const statSync = opts.statSync ?? syncFs.statSync;
 	const isFile = (candidate) => {
 		try {
 			return statSync(candidate).isFile();

package/dist/gateway/server-http.js

@@ -50,7 +50,7 @@ import { handleOpenAiHttpRequest } from "./openai-http.js";
 import { canonicalizePathVariant } from "./security-path.js";
 import { handleToolsInvokeHttpRequest } from "./tools-invoke-http.js";
 import { authorizeGatewayConnect, isLocalDirectRequest } from "./auth.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 import { createServer } from "node:http";
 import { createServer as createServer$1 } from "node:https";
@@ -2101,7 +2101,7 @@ async function readLocalFederationStatus(env = process.env, fetchImpl = fetch) {
 	const sourcePath = path.join(resolveStateDir(env), "federation", "access-token.json");
 	const managed = (env.FASED_GATEWAY_MODE ?? "").trim().toLowerCase() === "managed";
 	const configured = resolveConfiguredFederationStatus(env);
-	if (!fs.existsSync(sourcePath)) {
+	if (!syncFs.existsSync(sourcePath)) {
 		return {
 			managed,
 			sourcePath,
@@ -2113,7 +2113,7 @@ async function readLocalFederationStatus(env = process.env, fetchImpl = fetch) {
 	}
 	let rawText = "";
 	try {
-		rawText = fs.readFileSync(sourcePath, "utf-8");
+		rawText = syncFs.readFileSync(sourcePath, "utf-8");
 	} catch {
 		return {
 			managed,
@@ -2162,7 +2162,7 @@ async function readLocalFederationStatus(env = process.env, fetchImpl = fetch) {
 	const lifecycle = Number.isFinite(expiresAtMs) ? expiresAtMs > Date.now() ? "active" : "expired" : "invalid";
 	let fileUpdatedAt;
 	try {
-		fileUpdatedAt = fs.statSync(sourcePath).mtime.toISOString();
+		fileUpdatedAt = syncFs.statSync(sourcePath).mtime.toISOString();
 	} catch {
 		fileUpdatedAt = undefined;
 	}
@@ -5693,6 +5693,7 @@ function createGatewayHttpServer(opts) {
 					"yes"
 				].includes(String(parsedUrl.searchParams.get("forceFresh") ?? "").trim().toLowerCase());
 				const result = await callSatMiningGateway("sat.getMiningStatus", {
+					statusMode: "ui",
 					responsive: true,
 					...forceFresh ? { forceFresh: true } : {}
 				}, { timeoutMs: 6e4 });

package/dist/gateway/server-methods/chat.js

@@ -10,6 +10,7 @@ import { stripEnvelopeFromMessage, stripEnvelopeFromMessages } from "../chat-san
 import { capArrayByJsonBytes, readSessionMessages } from "../session-utils.fs.js";
 import { loadSessionStore } from "../../config/sessions/store.js";
 import { emitSessionTranscriptUpdate } from "../../sessions/transcript-events.js";
+import { ensureSessionTranscriptHeader } from "../../config/sessions/transcript.js";
 import "../../config/sessions.js";
 import { loadSessionEntry, resolveGatewaySessionStoreTarget, resolveSessionModelRef } from "../session-utils.js";
 import { GATEWAY_CLIENT_CAPS, hasGatewayClientCap } from "../protocol/client-info.js";
@@ -29,9 +30,8 @@ import { parseMessageWithAttachments } from "../chat-attachments.js";
 import { injectTimestamp, timestampOptsFromConfig } from "./agent-timestamp.js";
 import { normalizeRpcAttachmentsToChatAttachments } from "./attachment-normalize.js";
 import { appendInjectedAssistantMessageToTranscript } from "./chat-transcript-inject.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
-import { CURRENT_SESSION_VERSION } from "@mariozechner/pi-coding-agent";
 
 //#region src/gateway/server-methods/chat.ts
 const CHAT_HISTORY_TEXT_MAX_CHARS = 12e3;
@@ -319,34 +319,9 @@ function resolveTranscriptPath(params) {
 		return null;
 	}
 }
-function ensureTranscriptFile(params) {
-	if (fs.existsSync(params.transcriptPath)) {
-		return { ok: true };
-	}
-	try {
-		fs.mkdirSync(path.dirname(params.transcriptPath), { recursive: true });
-		const header = {
-			type: "session",
-			version: CURRENT_SESSION_VERSION,
-			id: params.sessionId,
-			timestamp: new Date().toISOString(),
-			cwd: process.cwd()
-		};
-		fs.writeFileSync(params.transcriptPath, `${JSON.stringify(header)}\n`, {
-			encoding: "utf-8",
-			mode: 384
-		});
-		return { ok: true };
-	} catch (err) {
-		return {
-			ok: false,
-			error: err instanceof Error ? err.message : String(err)
-		};
-	}
-}
 function transcriptHasIdempotencyKey(transcriptPath, idempotencyKey) {
 	try {
-		const lines = fs.readFileSync(transcriptPath, "utf-8").split(/\r?\n/);
+		const lines = syncFs.readFileSync(transcriptPath, "utf-8").split(/\r?\n/);
 		for (const line of lines) {
 			if (!line.trim()) {
 				continue;
@@ -374,18 +349,18 @@ function appendAssistantTranscriptMessage(params) {
 			error: "transcript path not resolved"
 		};
 	}
-	if (!fs.existsSync(transcriptPath)) {
+	if (!syncFs.existsSync(transcriptPath)) {
 		if (!params.createIfMissing) {
 			return {
 				ok: false,
 				error: "transcript file not found"
 			};
 		}
-		const ensured = ensureTranscriptFile({
-			transcriptPath,
+		const ensured = ensureSessionTranscriptHeader({
+			sessionFile: transcriptPath,
 			sessionId: params.sessionId
 		});
-		if (!ensured.ok) {
+		if (ensured.error) {
 			return {
 				ok: false,
 				error: ensured.error ?? "failed to create transcript file"

package/dist/gateway/server-methods/sessions.js

@@ -30,7 +30,7 @@ import { clearCheckpointBranchIsolationFields } from "../session-compaction-isol
 import { applySessionsPatchToStore } from "../sessions-patch.js";
 import { resolveSessionKeyFromResolveParams } from "../sessions-resolve.js";
 import { assertValidParams } from "./validation.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
 import { SessionManager } from "@mariozechner/pi-coding-agent";
@@ -196,7 +196,7 @@ function resolveCheckpointSnapshotFile(params) {
 		return null;
 	}
 	try {
-		if (!fs.statSync(filePath).isFile()) {
+		if (!syncFs.statSync(filePath).isFile()) {
 			return null;
 		}
 	} catch {
@@ -543,7 +543,7 @@ const sessionsHandlers = {
 		}
 		const cleanupRestoredFile = () => {
 			try {
-				fs.rmSync(sessionFile, { force: true });
+				syncFs.rmSync(sessionFile, { force: true });
 			} catch {}
 		};
 		const cleanupError = await ensureSessionRuntimeCleanup({
@@ -1068,7 +1068,7 @@ const sessionsHandlers = {
 			}, undefined);
 			return;
 		}
-		const filePath = resolveSessionTranscriptCandidates(sessionId, storePath, entry?.sessionFile, target.agentId).find((candidate) => fs.existsSync(candidate));
+		const filePath = resolveSessionTranscriptCandidates(sessionId, storePath, entry?.sessionFile, target.agentId).find((candidate) => syncFs.existsSync(candidate));
 		if (!filePath) {
 			respond(true, {
 				ok: true,
@@ -1078,7 +1078,7 @@ const sessionsHandlers = {
 			}, undefined);
 			return;
 		}
-		const raw = fs.readFileSync(filePath, "utf-8");
+		const raw = syncFs.readFileSync(filePath, "utf-8");
 		const lines = raw.split(/\r?\n/).filter((l) => l.trim().length > 0);
 		if (lines.length <= maxLines) {
 			respond(true, {
@@ -1096,7 +1096,7 @@ const sessionsHandlers = {
 		const archived = archiveFileOnDisk(filePath, "bak");
 		const keptLines = lines.slice(-maxLines);
 		try {
-			fs.writeFileSync(filePath, `${keptLines.join("\n")}\n`, "utf-8");
+			syncFs.writeFileSync(filePath, `${keptLines.join("\n")}\n`, "utf-8");
 		} catch (error) {
 			if (preCompactionSnapshot) {
 				cleanupSessionCompactionSnapshot(preCompactionSnapshot);

package/dist/gateway/server-methods/usage.js

@@ -12,7 +12,7 @@ import { readCronRunLogEntriesPageAll } from "../../cron/run-log.js";
 import { loadCronStore, resolveCronStorePath } from "../../cron/store.js";
 import { discoverAllSessions, loadCostUsageSummary, loadSessionCostSummary, loadSessionUsageTimeSeries } from "../../infra/session-cost-usage.js";
 import { buildUsageAggregateTail } from "../../shared/usage-aggregates.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 
 //#region src/gateway/server-methods/usage.ts
 const COST_USAGE_CACHE_TTL_MS = 3e4;
@@ -662,7 +662,7 @@ const usageHandlers = {
 				return;
 			}
 			try {
-				const stats = fs.statSync(sessionFile);
+				const stats = syncFs.statSync(sessionFile);
 				if (stats.isFile()) {
 					mergedEntries.push({
 						key: resolvedStoreKey,

package/dist/gateway/server.impl.js

@@ -68,7 +68,7 @@ import { createWizardSessionTracker } from "./server-wizard-sessions.js";
 import { attachGatewayWsHandlers } from "./server-ws-runtime.js";
 import { loadGatewayTlsRuntime } from "./server/tls.js";
 import { createSessionEventSubscriberRegistry, createSessionMessageSubscriberRegistry } from "./session-event-subscribers.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/gateway/server.impl.ts
@@ -99,10 +99,10 @@ function hasConfiguredLocalSignerKeystoreMaterial(env) {
 	}
 	try {
 		const materialDir = resolveLocalSignerMaterialRootDir(env);
-		if (!fs.existsSync(materialDir)) {
+		if (!syncFs.existsSync(materialDir)) {
 			return false;
 		}
-		return fs.readdirSync(materialDir, { withFileTypes: true }).some((entry) => entry.isFile() && /^keystore-solana(?:-.+)?\.v1\.enc$/i.test(entry.name));
+		return syncFs.readdirSync(materialDir, { withFileTypes: true }).some((entry) => entry.isFile() && /^keystore-solana(?:-.+)?\.v1\.enc$/i.test(entry.name));
 	} catch {
 		return false;
 	}

package/dist/gateway/session-compaction-checkpoints.js

@@ -1,6 +1,6 @@
 import { isSessionCompactionCheckpointArtifactName } from "../config/sessions/artifacts.js";
 import "../config/sessions.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
 
@@ -88,7 +88,7 @@ function deleteCheckpointSnapshotIfSafe(filePath, expectedDir) {
 		return;
 	}
 	try {
-		fs.unlinkSync(resolved);
+		syncFs.unlinkSync(resolved);
 	} catch {}
 }
 function cleanupSessionCompactionSnapshot(reference) {
@@ -105,7 +105,7 @@ function captureSessionCompactionSnapshot(params) {
 	const resolved = path.resolve(sessionFile);
 	let stat;
 	try {
-		stat = fs.statSync(resolved);
+		stat = syncFs.statSync(resolved);
 	} catch {
 		return null;
 	}
@@ -123,7 +123,7 @@ function captureSessionCompactionSnapshot(params) {
 	const base = path.basename(resolved, ".jsonl");
 	const snapshotFile = path.join(dir, `${base}.checkpoint.${randomUUID()}.jsonl`);
 	try {
-		fs.copyFileSync(resolved, snapshotFile);
+		syncFs.copyFileSync(resolved, snapshotFile);
 	} catch {
 		return null;
 	}

package/dist/gateway/session-utils.fs.js

@@ -7,7 +7,7 @@ import { extractToolCallNames, hasToolCall } from "../utils/transcript-tools.js"
 import { stripEnvelope } from "../shared/chat-envelope.js";
 import "./chat-sanitize.js";
 import "../config/sessions.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
@@ -50,11 +50,11 @@ function setCachedSessionTitleFields(cacheKey, stat, value) {
 }
 function readSessionMessages(sessionId, storePath, sessionFile) {
 	const candidates = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile);
-	const filePath = candidates.find((p) => fs.existsSync(p));
+	const filePath = candidates.find((p) => syncFs.existsSync(p));
 	if (!filePath) {
 		return [];
 	}
-	const lines = fs.readFileSync(filePath, "utf-8").split(/\r?\n/);
+	const lines = syncFs.readFileSync(filePath, "utf-8").split(/\r?\n/);
 	const messages = [];
 	for (const line of lines) {
 		if (!line.trim()) {
@@ -123,7 +123,7 @@ function resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, a
 function canonicalizePathForComparison(filePath) {
 	const resolved = path.resolve(filePath);
 	try {
-		return fs.realpathSync(resolved);
+		return syncFs.realpathSync(resolved);
 	} catch {
 		return resolved;
 	}
@@ -131,7 +131,7 @@ function canonicalizePathForComparison(filePath) {
 function archiveFileOnDisk(filePath, reason) {
 	const ts = formatSessionArchiveTimestamp();
 	const archived = `${filePath}.${reason}.${ts}`;
-	fs.renameSync(filePath, archived);
+	syncFs.renameSync(filePath, archived);
 	return archived;
 }
 /**
@@ -149,7 +149,7 @@ function archiveSessionTranscripts(opts) {
 				continue;
 			}
 		}
-		if (!fs.existsSync(candidatePath)) {
+		if (!syncFs.existsSync(candidatePath)) {
 			continue;
 		}
 		try {
@@ -171,7 +171,7 @@ async function cleanupArchivedSessionTranscripts(opts) {
 	let removed = 0;
 	let scanned = 0;
 	for (const dir of directories) {
-		const entries = await fs.promises.readdir(dir).catch(() => []);
+		const entries = await syncFs.promises.readdir(dir).catch(() => []);
 		for (const entry of entries) {
 			const timestamp = parseSessionArchiveTimestamp(entry, reason);
 			if (timestamp == null) {
@@ -182,11 +182,11 @@ async function cleanupArchivedSessionTranscripts(opts) {
 				continue;
 			}
 			const fullPath = path.join(dir, entry);
-			const stat = await fs.promises.stat(fullPath).catch(() => null);
+			const stat = await syncFs.promises.stat(fullPath).catch(() => null);
 			if (!stat?.isFile()) {
 				continue;
 			}
-			await fs.promises.rm(fullPath).catch(() => undefined);
+			await syncFs.promises.rm(fullPath).catch(() => undefined);
 			removed += 1;
 		}
 	}
@@ -225,7 +225,7 @@ function capArrayByJsonBytes(items, maxBytes) {
 const MAX_LINES_TO_SCAN = 10;
 function readSessionTitleFieldsFromTranscript(sessionId, storePath, sessionFile, agentId, opts) {
 	const candidates = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId);
-	const filePath = candidates.find((p) => fs.existsSync(p));
+	const filePath = candidates.find((p) => syncFs.existsSync(p));
 	if (!filePath) {
 		return {
 			firstUserMessage: null,
@@ -234,7 +234,7 @@ function readSessionTitleFieldsFromTranscript(sessionId, storePath, sessionFile,
 	}
 	let stat;
 	try {
-		stat = fs.statSync(filePath);
+		stat = syncFs.statSync(filePath);
 	} catch {
 		return {
 			firstUserMessage: null,
@@ -256,7 +256,7 @@ function readSessionTitleFieldsFromTranscript(sessionId, storePath, sessionFile,
 	}
 	let fd = null;
 	try {
-		fd = fs.openSync(filePath, "r");
+		fd = syncFs.openSync(filePath, "r");
 		const size = stat.size;
 		let firstUserMessage = null;
 		try {
@@ -286,7 +286,7 @@ function readSessionTitleFieldsFromTranscript(sessionId, storePath, sessionFile,
 	} finally {
 		if (fd !== null) {
 			try {
-				fs.closeSync(fd);
+				syncFs.closeSync(fd);
 			} catch {}
 		}
 	}
@@ -314,7 +314,7 @@ function extractTextFromContent(content) {
 }
 function readTranscriptHeadChunk(fd, maxBytes = 8192) {
 	const buf = Buffer.alloc(maxBytes);
-	const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);
+	const bytesRead = syncFs.readSync(fd, buf, 0, buf.length, 0);
 	if (bytesRead <= 0) {
 		return null;
 	}
@@ -345,16 +345,16 @@ function extractFirstUserMessageFromTranscriptChunk(chunk, opts) {
 }
 function findExistingTranscriptPath(sessionId, storePath, sessionFile, agentId) {
 	const candidates = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId);
-	return candidates.find((p) => fs.existsSync(p)) ?? null;
+	return candidates.find((p) => syncFs.existsSync(p)) ?? null;
 }
 function withOpenTranscriptFd(filePath, read) {
 	let fd = null;
 	try {
-		fd = fs.openSync(filePath, "r");
+		fd = syncFs.openSync(filePath, "r");
 		return read(fd);
 	} catch {} finally {
 		if (fd !== null) {
-			fs.closeSync(fd);
+			syncFs.closeSync(fd);
 		}
 	}
 	return null;
@@ -378,7 +378,7 @@ function readLastMessagePreviewFromOpenTranscript(params) {
 	const readStart = Math.max(0, params.size - LAST_MSG_MAX_BYTES);
 	const readLen = Math.min(params.size, LAST_MSG_MAX_BYTES);
 	const buf = Buffer.alloc(readLen);
-	fs.readSync(params.fd, buf, 0, readLen, readStart);
+	syncFs.readSync(params.fd, buf, 0, readLen, readStart);
 	const chunk = buf.toString("utf-8");
 	const lines = chunk.split(/\r?\n/).filter((l) => l.trim());
 	const tailLines = lines.slice(-LAST_MSG_MAX_LINES);
@@ -404,7 +404,7 @@ function readLastMessagePreviewFromTranscript(sessionId, storePath, sessionFile,
 		return null;
 	}
 	return withOpenTranscriptFd(filePath, (fd) => {
-		const stat = fs.fstatSync(fd);
+		const stat = syncFs.fstatSync(fd);
 		const size = stat.size;
 		if (size === 0) {
 			return null;
@@ -522,8 +522,8 @@ function buildPreviewItems(messages, maxItems, maxChars) {
 function readRecentMessagesFromTranscript(filePath, maxMessages, readBytes) {
 	let fd = null;
 	try {
-		fd = fs.openSync(filePath, "r");
-		const stat = fs.fstatSync(fd);
+		fd = syncFs.openSync(filePath, "r");
+		const stat = syncFs.fstatSync(fd);
 		const size = stat.size;
 		if (size === 0) {
 			return [];
@@ -531,7 +531,7 @@ function readRecentMessagesFromTranscript(filePath, maxMessages, readBytes) {
 		const readStart = Math.max(0, size - readBytes);
 		const readLen = Math.min(size, readBytes);
 		const buf = Buffer.alloc(readLen);
-		fs.readSync(fd, buf, 0, readLen, readStart);
+		syncFs.readSync(fd, buf, 0, readLen, readStart);
 		const chunk = buf.toString("utf-8");
 		const lines = chunk.split(/\r?\n/).filter((l) => l.trim());
 		const tailLines = lines.slice(-PREVIEW_MAX_LINES);
@@ -554,13 +554,13 @@ function readRecentMessagesFromTranscript(filePath, maxMessages, readBytes) {
 		return [];
 	} finally {
 		if (fd !== null) {
-			fs.closeSync(fd);
+			syncFs.closeSync(fd);
 		}
 	}
 }
 function readSessionPreviewItemsFromTranscript(sessionId, storePath, sessionFile, agentId, maxItems, maxChars) {
 	const candidates = resolveSessionTranscriptCandidates(sessionId, storePath, sessionFile, agentId);
-	const filePath = candidates.find((p) => fs.existsSync(p));
+	const filePath = candidates.find((p) => syncFs.existsSync(p));
 	if (!filePath) {
 		return [];
 	}

package/dist/gateway/session-utils.js

@@ -19,7 +19,7 @@ import { loadSessionStore } from "../config/sessions/store.js";
 import "../config/sessions.js";
 import { lookupContextTokens } from "../agents/context.js";
 import { listSessionCompactionCheckpoints } from "./session-compaction-checkpoints.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/gateway/session-utils.ts
@@ -41,7 +41,7 @@ function isCombinedSessionStoreCacheFresh(entry) {
 }
 function readSessionStoreSignature(storePath) {
 	try {
-		const stat = fs.statSync(storePath);
+		const stat = syncFs.statSync(storePath);
 		return {
 			storePath,
 			exists: true,
@@ -94,7 +94,7 @@ function clearCombinedSessionStoreCacheForTest() {
 }
 function tryResolveExistingPath(value) {
 	try {
-		return fs.realpathSync(value);
+		return syncFs.realpathSync(value);
 	} catch {
 		return null;
 	}
@@ -132,11 +132,11 @@ function resolveIdentityAvatarUrl(cfg, agentId, avatar) {
 			return undefined;
 		}
 		try {
-			const buffer = fs.readFileSync(opened.fd);
+			const buffer = syncFs.readFileSync(opened.fd);
 			const mime = resolveAvatarMime(resolvedCandidate);
 			return `data:${mime};base64,${buffer.toString("base64")}`;
 		} finally {
-			fs.closeSync(opened.fd);
+			syncFs.closeSync(opened.fd);
 		}
 	} catch {
 		return undefined;
@@ -304,7 +304,7 @@ function listExistingAgentIdsFromDisk() {
 	const root = resolveStateDir();
 	const agentsDir = path.join(root, "agents");
 	try {
-		const entries = fs.readdirSync(agentsDir, { withFileTypes: true });
+		const entries = syncFs.readdirSync(agentsDir, { withFileTypes: true });
 		return entries.filter((entry) => entry.isDirectory()).map((entry) => normalizeAgentId(entry.name)).filter(Boolean);
 	} catch {
 		return [];

package/dist/hooks/bundled-dir.js

@@ -1,5 +1,5 @@
 import { fileURLToPath } from "node:url";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/hooks/bundled-dir.ts
@@ -11,14 +11,14 @@ function resolveBundledHooksDir() {
 	try {
 		const execDir = path.dirname(process.execPath);
 		const sibling = path.join(execDir, "hooks", "bundled");
-		if (fs.existsSync(sibling)) {
+		if (syncFs.existsSync(sibling)) {
 			return sibling;
 		}
 	} catch {}
 	try {
 		const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 		const distBundled = path.join(moduleDir, "bundled");
-		if (fs.existsSync(distBundled)) {
+		if (syncFs.existsSync(distBundled)) {
 			return distBundled;
 		}
 	} catch {}
@@ -26,7 +26,7 @@ function resolveBundledHooksDir() {
 		const moduleDir = path.dirname(fileURLToPath(import.meta.url));
 		const root = path.resolve(moduleDir, "..", "..");
 		const srcBundled = path.join(root, "src", "hooks", "bundled");
-		if (fs.existsSync(srcBundled)) {
+		if (syncFs.existsSync(srcBundled)) {
 			return srcBundled;
 		}
 	} catch {}

package/dist/hooks/gmail-setup-utils.js

@@ -3,7 +3,7 @@ import { runCommandWithTimeout } from "../process/exec.js";
 import { hasBinary } from "../shared/config-eval.js";
 import "../agents/skills.js";
 import { normalizeServePath } from "./gmail.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/hooks/gmail-setup-utils.ts
@@ -71,7 +71,7 @@ function findExecutablesOnPath(bins) {
 				continue;
 			}
 			try {
-				fs.accessSync(candidate, fs.constants.X_OK);
+				syncFs.accessSync(candidate, syncFs.constants.X_OK);
 				matches.push(candidate);
 				seen.add(candidate);
 			} catch {}
@@ -100,7 +100,7 @@ function ensureGcloudOnPath() {
 	];
 	for (const candidate of candidates) {
 		try {
-			fs.accessSync(candidate, fs.constants.X_OK);
+			syncFs.accessSync(candidate, syncFs.constants.X_OK);
 			ensurePathIncludes(path.dirname(candidate), "append");
 			return true;
 		} catch {}
@@ -126,7 +126,7 @@ async function resolvePythonExecutablePath() {
 			continue;
 		}
 		try {
-			fs.accessSync(resolved, fs.constants.X_OK);
+			syncFs.accessSync(resolved, syncFs.constants.X_OK);
 			cachedPythonPath = resolved;
 			return resolved;
 		} catch {}
@@ -303,11 +303,11 @@ async function ensureTailscaleEndpoint(params) {
 async function resolveProjectIdFromGogCredentials() {
 	const candidates = gogCredentialsPaths();
 	for (const candidate of candidates) {
-		if (!fs.existsSync(candidate)) {
+		if (!syncFs.existsSync(candidate)) {
 			continue;
 		}
 		try {
-			const raw = fs.readFileSync(candidate, "utf-8");
+			const raw = syncFs.readFileSync(candidate, "utf-8");
 			const parsed = JSON.parse(raw);
 			const clientId = extractGogClientId(parsed);
 			const projectNumber = extractProjectNumber(clientId);