@fased/fased 0.1.55 → 0.1.56

package/dist/gateway/control-ui.js

@@ -8,7 +8,7 @@ import { resolveControlUiRootSync } from "../infra/control-ui-assets.js";
 import { DEFAULT_ASSISTANT_IDENTITY, resolveAssistantIdentity } from "./assistant-identity.js";
 import { CONTROL_UI_BOOTSTRAP_CONFIG_PATH } from "./control-ui-contract.js";
 import { buildControlUiCspHeader } from "./control-ui-csp.js";
-import fs from "node:fs";
+import syncFs from "node:fs";
 import path from "node:path";
 
 //#region src/gateway/control-ui.ts
@@ -152,10 +152,10 @@ function handleControlUiAvatarRequest(req, res, opts) {
 			res.end();
 			return true;
 		}
-		serveResolvedFile(res, safeAvatar.path, fs.readFileSync(safeAvatar.fd));
+		serveResolvedFile(res, safeAvatar.path, syncFs.readFileSync(safeAvatar.fd));
 		return true;
 	} finally {
-		fs.closeSync(safeAvatar.fd);
+		syncFs.closeSync(safeAvatar.fd);
 	}
 }
 function respondNotFound(res) {
@@ -318,7 +318,7 @@ function handleControlUiHttpRequest(req, res, opts) {
 	}
 	const rootReal = (() => {
 		try {
-			return fs.realpathSync(root);
+			return syncFs.realpathSync(root);
 		} catch (error) {
 			if (isExpectedSafePathError(error)) {
 				return null;
@@ -364,13 +364,13 @@ function handleControlUiHttpRequest(req, res, opts) {
 				return true;
 			}
 			if (path.basename(safeFile.path) === "index.html") {
-				serveResolvedIndexHtml(res, fs.readFileSync(safeFile.fd, "utf8"));
+				serveResolvedIndexHtml(res, syncFs.readFileSync(safeFile.fd, "utf8"));
 				return true;
 			}
-			serveResolvedFile(res, safeFile.path, fs.readFileSync(safeFile.fd));
+			serveResolvedFile(res, safeFile.path, syncFs.readFileSync(safeFile.fd));
 			return true;
 		} finally {
-			fs.closeSync(safeFile.fd);
+			syncFs.closeSync(safeFile.fd);
 		}
 	}
 	if (STATIC_ASSET_EXTENSIONS.has(path.extname(fileRel).toLowerCase())) {
@@ -387,10 +387,10 @@ function handleControlUiHttpRequest(req, res, opts) {
 				res.end();
 				return true;
 			}
-			serveResolvedIndexHtml(res, fs.readFileSync(safeIndex.fd, "utf8"));
+			serveResolvedIndexHtml(res, syncFs.readFileSync(safeIndex.fd, "utf8"));
 			return true;
 		} finally {
-			fs.closeSync(safeIndex.fd);
+			syncFs.closeSync(safeIndex.fd);
 		}
 	}
 	respondNotFound(res);

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

@@ -16,12 +16,16 @@ const ModelChoiceSchema = Type.Object({
 	catalogSource: Type.Optional(Type.Union([
 		Type.Literal("configured"),
 		Type.Literal("runtime"),
+		Type.Literal("provider-api"),
 		Type.Literal("current-preview"),
 		Type.Literal("provider-index"),
 		Type.Literal("manifest")
 	])),
 	metadata: Type.Optional(Type.Object({
+		ref: NonEmptyString,
 		provider: NonEmptyString,
+		publicProviderId: NonEmptyString,
+		publicProviderLabel: NonEmptyString,
 		model: NonEmptyString,
 		label: NonEmptyString,
 		contextWindow: Type.Optional(Type.Integer({ minimum: 1 })),
@@ -44,7 +48,8 @@ const ModelChoiceSchema = Type.Object({
 			Type.Literal("medium"),
 			Type.Literal("high"),
 			Type.Literal("xhigh"),
-			Type.Literal("max")
+			Type.Literal("max"),
+			Type.Literal("ultra")
 		]))),
 		defaultThinkingLevel: Type.Optional(Type.Union([
 			Type.Literal("off"),
@@ -53,7 +58,8 @@ const ModelChoiceSchema = Type.Object({
 			Type.Literal("medium"),
 			Type.Literal("high"),
 			Type.Literal("xhigh"),
-			Type.Literal("max")
+			Type.Literal("max"),
+			Type.Literal("ultra")
 		])),
 		thinkingMode: Type.Optional(Type.Union([
 			Type.Literal("openai-reasoning-effort"),
@@ -72,15 +78,68 @@ const ModelChoiceSchema = Type.Object({
 		])),
 		reasoningBudgetSupported: Type.Optional(Type.Boolean()),
 		streaming: Type.Boolean(),
-		capabilityConfidence: Type.Union([Type.Literal("declared"), Type.Literal("unknown")]),
+		capabilityConfidence: Type.Union([
+			Type.Literal("verified"),
+			Type.Literal("declared"),
+			Type.Literal("inferred"),
+			Type.Literal("unknown")
+		]),
+		capabilitySource: Type.Union([
+			Type.Literal("provider-api"),
+			Type.Literal("official-docs"),
+			Type.Literal("runtime"),
+			Type.Literal("configured"),
+			Type.Literal("inferred"),
+			Type.Literal("unknown")
+		]),
+		capabilityRetrievedAt: Type.Optional(NonEmptyString),
+		retrievedAt: NonEmptyString,
+		availabilitySource: Type.Union([
+			Type.Literal("provider-api"),
+			Type.Literal("runtime-catalog"),
+			Type.Literal("configured"),
+			Type.Literal("provider-plugin"),
+			Type.Literal("reviewed-catalog"),
+			Type.Literal("curated-recommendation")
+		]),
+		authRoute: NonEmptyString,
 		authMode: Type.Union([
 			Type.Literal("api-key"),
 			Type.Literal("oauth"),
-			Type.Literal("token")
+			Type.Literal("token"),
+			Type.Literal("aws-sdk")
 		]),
+		credentialRoute: Type.Object({
+			id: NonEmptyString,
+			label: NonEmptyString,
+			authMode: Type.Union([
+				Type.Literal("api-key"),
+				Type.Literal("oauth"),
+				Type.Literal("token"),
+				Type.Literal("aws-sdk")
+			])
+		}, { additionalProperties: false }),
+		credentialRoutes: Type.Array(Type.Object({
+			id: NonEmptyString,
+			label: NonEmptyString,
+			authMode: Type.Union([
+				Type.Literal("api-key"),
+				Type.Literal("oauth"),
+				Type.Literal("token"),
+				Type.Literal("aws-sdk")
+			])
+		}, { additionalProperties: false }), { minItems: 1 }),
+		price: Type.Optional(Type.Object({
+			input: Type.Number({ minimum: 0 }),
+			output: Type.Number({ minimum: 0 }),
+			cacheRead: Type.Number({ minimum: 0 }),
+			cacheWrite: Type.Number({ minimum: 0 }),
+			unit: Type.Literal("usd-per-million-tokens")
+		}, { additionalProperties: false })),
 		privateNetwork: Type.Boolean(),
 		privateNetworkAllowed: Type.Boolean(),
 		recommended: Type.Optional(Type.Boolean()),
+		recommendationRank: Type.Optional(Type.Integer({ minimum: 1 })),
 		default: Type.Optional(Type.Boolean())
 	}, { additionalProperties: false }))
 }, { additionalProperties: false });

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

@@ -51,7 +51,7 @@ import { buildGatewayProbePayload } from "./probe-payload.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";
@@ -2102,7 +2102,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,
@@ -2114,7 +2114,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,
@@ -2163,7 +2163,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;
 	}

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

@@ -30,7 +30,7 @@ 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";
 
 //#region src/gateway/server-methods/chat.ts
@@ -321,7 +321,7 @@ function resolveTranscriptPath(params) {
 }
 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;
@@ -349,7 +349,7 @@ function appendAssistantTranscriptMessage(params) {
 			error: "transcript path not resolved"
 		};
 	}
-	if (!fs.existsSync(transcriptPath)) {
+	if (!syncFs.existsSync(transcriptPath)) {
 		if (!params.createIfMissing) {
 			return {
 				ok: false,

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

@@ -11,14 +11,14 @@ import { loadConfig, writeConfigFile } from "../../config/io.js";
 import "../../config/config.js";
 import { resolveProfileUnusableUntilForDisplay } from "../../agents/auth-profiles/usage.js";
 import "../../agents/auth-profiles.js";
+import { deriveModelMetadata } from "../../agents/model-metadata.js";
+import { resolveAuthenticatedModelCatalog } from "../../agents/authenticated-model-catalog.js";
 import { ErrorCodes, errorShape } from "../protocol/schema/error-codes.js";
 import { formatValidationErrors, validateModelsAuthClearParams, validateModelsAuthConfigureParams, validateModelsAuthInteractiveStartParams, validateModelsAuthStatusParams, validateModelsAuthStoreParams, validateModelsCatalogStatusParams, validateModelsListParams } from "../protocol/index.js";
-import { deriveModelMetadata } from "../../agents/model-metadata.js";
 import { loadProviderExtensionCatalogIndex } from "../../agents/provider-extension-catalog-index.js";
 import { buildModelCatalogStatus } from "../../agents/model-catalog-status.js";
 import { DEFAULT_OAUTH_WARN_MS, buildAuthHealthSummary } from "../../agents/auth-health.js";
 import { normalizeLegacyOnboardAuthChoice } from "../../commands/auth-choice-legacy.js";
-import { resolveAuthenticatedModelCatalog } from "../../agents/authenticated-model-catalog.js";
 import { configureLmStudioProvider, configureOllamaProvider, configureVllmProvider } from "../../commands/vllm-setup.js";
 import { applyAuthChoice } from "../../commands/auth-choice.apply.js";
 import "../../commands/auth-choice.js";
@@ -858,7 +858,8 @@ const modelsHandlers = {
 				cfg,
 				store,
 				catalog,
-				defaultProvider: DEFAULT_PROVIDER
+				defaultProvider: DEFAULT_PROVIDER,
+				agentDir
 			});
 			const providerFilter = typeof params.provider === "string" && params.provider.trim() ? normalizeProviderId(params.provider) : "";
 			const modelSource = params.all === true || params.available === true ? usableCatalog : allowedCatalog.length > 0 ? allowedCatalog : usableCatalog;

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

@@ -16,7 +16,7 @@ import "../../config/sessions.js";
 import { captureSessionCompactionSnapshot, cleanupSessionCompactionSnapshot, getSessionCompactionCheckpoint, listSessionCompactionCheckpoints, persistSessionCompactionCheckpoint } from "../session-compaction-checkpoints.js";
 import { invalidateCombinedSessionStoreCache, listSessionsFromStore, loadCombinedSessionStoreForGateway, pruneLegacyStoreKeys, resolveGatewaySessionStoreTarget, resolveSessionModelRef } from "../session-utils.js";
 import { getGlobalHookRunner } from "../../plugins/hook-runner-global.js";
-import { clearBootstrapSnapshot } from "../../agents/bootstrap-cache.js";
+import { buildUsableModelProviderSet } from "../../agents/model-catalog-access.js";
 import "../../agents/pi-embedded.js";
 import { ErrorCodes, errorShape } from "../protocol/schema/error-codes.js";
 import { validateSessionsCompactParams, validateSessionsCompactionBranchParams, validateSessionsCompactionGetParams, validateSessionsCompactionListParams, validateSessionsCompactionRestoreParams, validateSessionsDeleteParams, validateSessionsListParams, validateSessionsMessagesSubscribeParams, validateSessionsMessagesUnsubscribeParams, validateSessionsPatchParams, validateSessionsPreviewParams, validateSessionsResetParams, validateSessionsResolveParams } from "../protocol/index.js";
@@ -24,13 +24,13 @@ import { clearSessionQueues } from "../../auto-reply/reply/queue/cleanup.js";
 import "../../auto-reply/reply/queue.js";
 import { stopSubagentsForRequester } from "../../auto-reply/reply/abort.js";
 import { getAcpSessionManager } from "../../acp/control-plane/manager.js";
-import { buildUsableModelProviderSet } from "../../agents/model-catalog-access.js";
+import { clearBootstrapSnapshot } from "../../agents/bootstrap-cache.js";
 import { abortEmbeddedPiRun, waitForEmbeddedPiRunEnd } from "../../agents/pi-embedded-runner/runs.js";
 import { clearCheckpointBranchIsolationFields } from "../session-compaction-isolation.js";
 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/tts.js

@@ -1,9 +1,9 @@
 import { loadConfig } from "../../config/io.js";
 import "../../config/config.js";
-import { OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from "../../tts/tts-core.js";
-import { getTtsProvider, isTtsEnabled, isTtsProviderConfigured, listTtsPersonas, resolveTtsApiKey, resolveTtsAutoMode, resolveTtsConfig, resolveTtsPrefsPath, resolveTtsProviderOrder, setTtsEnabled, setTtsProvider, textToSpeech } from "../../tts/tts.js";
 import { ErrorCodes, errorShape } from "../protocol/schema/error-codes.js";
 import "../protocol/index.js";
+import { OPENAI_TTS_MODELS, OPENAI_TTS_VOICES } from "../../tts/tts-core.js";
+import { getTtsProvider, isTtsEnabled, isTtsProviderConfigured, listTtsPersonas, resolveTtsApiKey, resolveTtsAutoMode, resolveTtsConfig, resolveTtsPrefsPath, resolveTtsProviderOrder, setTtsEnabled, setTtsProvider, textToSpeech } from "../../tts/tts.js";
 import { formatForLog } from "../ws-log.js";
 
 //#region src/gateway/server-methods/tts.ts

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-model-catalog.js

@@ -1,7 +1,7 @@
 import { loadConfig } from "../config/io.js";
 import "../config/config.js";
-import { loadModelCatalog, resetModelCatalogCacheForTest } from "../agents/model-catalog.js";
 import { resetRuntimeProviderModelCatalogCache } from "../providers/runtime-model-catalog.js";
+import { loadModelCatalog, resetModelCatalogCacheForTest } from "../agents/model-catalog.js";
 
 //#region src/gateway/server-model-catalog.ts
 function createGatewayModelCatalogCache() {

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 [];
 	}