@fased/fased 0.1.56 → 0.1.57

package/dist/agents/workspace.js

@@ -5,10 +5,10 @@ import "../routing/session-key.js";
 import { openBoundaryFile } from "../infra/boundary-file-read.js";
 import { runCommandWithTimeout } from "../process/exec.js";
 import { resolveWorkspaceTemplateDir } from "./workspace-templates.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import fs from "node:fs/promises";
+import fs$1 from "node:fs/promises";
 
 //#region src/agents/workspace.ts
 function resolveDefaultAgentWorkspaceDir(env = process.env, homedir = os.homedir) {
@@ -95,14 +95,14 @@ async function readWorkspaceFileWithGuards(params) {
 	const identity = workspaceFileIdentity(opened.stat, opened.path);
 	const cached = workspaceFileCache.get(params.filePath);
 	if (cached && cached.identity === identity) {
-		syncFs.closeSync(opened.fd);
+		fs.closeSync(opened.fd);
 		return {
 			ok: true,
 			content: cached.content
 		};
 	}
 	try {
-		const content = syncFs.readFileSync(opened.fd, "utf-8");
+		const content = fs.readFileSync(opened.fd, "utf-8");
 		workspaceFileCache.set(params.filePath, {
 			content,
 			identity
@@ -119,7 +119,7 @@ async function readWorkspaceFileWithGuards(params) {
 			error
 		};
 	} finally {
-		syncFs.closeSync(opened.fd);
+		fs.closeSync(opened.fd);
 	}
 }
 function stripFrontMatter(content) {
@@ -144,7 +144,7 @@ async function loadTemplate(name) {
 		const templateDir = await resolveWorkspaceTemplateDir();
 		const templatePath = path.join(templateDir, name);
 		try {
-			const content = await fs.readFile(templatePath, "utf-8");
+			const content = await fs$1.readFile(templatePath, "utf-8");
 			return stripFrontMatter(content);
 		} catch {
 			const fallback = BUILTIN_WORKSPACE_TEMPLATES[name];
@@ -176,7 +176,7 @@ const VALID_BOOTSTRAP_NAMES = new Set([
 ]);
 async function writeFileIfMissing(filePath, content) {
 	try {
-		await fs.writeFile(filePath, content, {
+		await fs$1.writeFile(filePath, content, {
 			encoding: "utf-8",
 			flag: "wx"
 		});
@@ -191,14 +191,14 @@ async function writeFileIfMissing(filePath, content) {
 }
 async function fileExists(filePath) {
 	try {
-		await fs.access(filePath);
+		await fs$1.access(filePath);
 		return true;
 	} catch {
 		return false;
 	}
 }
 async function ensureMemoryRoots(dir) {
-	await fs.mkdir(path.join(dir, "memory"), { recursive: true });
+	await fs$1.mkdir(path.join(dir, "memory"), { recursive: true });
 	await writeFileIfMissing(path.join(dir, DEFAULT_MEMORY_FILENAME), DEFAULT_MEMORY_CONTENT);
 }
 function resolveWorkspaceStatePath(dir) {
@@ -221,7 +221,7 @@ function parseWorkspaceOnboardingState(raw) {
 }
 async function readWorkspaceOnboardingState(statePath) {
 	try {
-		const raw = await fs.readFile(statePath, "utf-8");
+		const raw = await fs$1.readFile(statePath, "utf-8");
 		return parseWorkspaceOnboardingState(raw) ?? { version: WORKSPACE_STATE_VERSION };
 	} catch (err) {
 		const anyErr = err;
@@ -240,20 +240,20 @@ async function isWorkspaceOnboardingCompleted(dir) {
 	return typeof state.onboardingCompletedAt === "string" && state.onboardingCompletedAt.trim().length > 0;
 }
 async function writeWorkspaceOnboardingState(statePath, state) {
-	await fs.mkdir(path.dirname(statePath), { recursive: true });
+	await fs$1.mkdir(path.dirname(statePath), { recursive: true });
 	const payload = `${JSON.stringify(state, null, 2)}\n`;
 	const tmpPath = `${statePath}.tmp-${process.pid}-${Date.now().toString(36)}`;
 	try {
-		await fs.writeFile(tmpPath, payload, { encoding: "utf-8" });
-		await fs.rename(tmpPath, statePath);
+		await fs$1.writeFile(tmpPath, payload, { encoding: "utf-8" });
+		await fs$1.rename(tmpPath, statePath);
 	} catch (err) {
-		await fs.unlink(tmpPath).catch(() => {});
+		await fs$1.unlink(tmpPath).catch(() => {});
 		throw err;
 	}
 }
 async function hasGitRepo(dir) {
 	try {
-		await fs.stat(path.join(dir, ".git"));
+		await fs$1.stat(path.join(dir, ".git"));
 		return true;
 	} catch {
 		return false;
@@ -293,7 +293,7 @@ async function ensureGitRepo(dir, isBrandNewWorkspace) {
 async function ensureAgentWorkspace(params) {
 	const rawDir = params?.dir?.trim() ? params.dir.trim() : DEFAULT_AGENT_WORKSPACE_DIR;
 	const dir = resolveUserPath(rawDir);
-	await fs.mkdir(dir, { recursive: true });
+	await fs$1.mkdir(dir, { recursive: true });
 	if (!params?.ensureBootstrapFiles) {
 		return { dir };
 	}
@@ -322,7 +322,7 @@ async function ensureAgentWorkspace(params) {
 		const paths = [...templatePaths, ...userContentPaths];
 		const existing = await Promise.all(paths.map(async (p) => {
 			try {
-				await fs.access(p);
+				await fs$1.access(p);
 				return true;
 			} catch {
 				return false;
@@ -360,7 +360,7 @@ async function ensureAgentWorkspace(params) {
 		markState({ onboardingCompletedAt: nowIso() });
 	}
 	if (!state.bootstrapSeededAt && !state.onboardingCompletedAt && !bootstrapExists) {
-		const [identityContent, userContent] = await Promise.all([fs.readFile(identityPath, "utf-8"), fs.readFile(userPath, "utf-8")]);
+		const [identityContent, userContent] = await Promise.all([fs$1.readFile(identityPath, "utf-8"), fs$1.readFile(userPath, "utf-8")]);
 		const hasUserContent = await (async () => {
 			const indicators = [
 				path.join(dir, "memory"),
@@ -369,7 +369,7 @@ async function ensureAgentWorkspace(params) {
 			];
 			for (const indicator of indicators) {
 				try {
-					await fs.access(indicator);
+					await fs$1.access(indicator);
 					return true;
 				} catch {}
 			}
@@ -413,7 +413,7 @@ async function resolveMemoryBootstrapEntries(resolvedDir) {
 	for (const name of candidates) {
 		const filePath = path.join(resolvedDir, name);
 		try {
-			await fs.access(filePath);
+			await fs$1.access(filePath);
 			entries.push({
 				name,
 				filePath
@@ -428,7 +428,7 @@ async function resolveMemoryBootstrapEntries(resolvedDir) {
 	for (const entry of entries) {
 		let key = entry.filePath;
 		try {
-			key = await fs.realpath(entry.filePath);
+			key = await fs$1.realpath(entry.filePath);
 		} catch {}
 		if (seen.has(key)) {
 			continue;
@@ -523,7 +523,7 @@ async function loadExtraBootstrapFilesWithDiagnostics(dir, extraPatterns) {
 	for (const pattern of extraPatterns) {
 		if (pattern.includes("*") || pattern.includes("?") || pattern.includes("{")) {
 			try {
-				const matches = fs.glob(pattern, { cwd: resolvedDir });
+				const matches = fs$1.glob(pattern, { cwd: resolvedDir });
 				for await (const m of matches) {
 					resolvedPaths.add(m);
 				}

package/dist/auto-reply/reply/agent-runner-execution.js

@@ -18,7 +18,7 @@ import { isCompactionFailureError, isContextOverflowError, isLikelyContextOverfl
 import "../../agents/pi-embedded-helpers.js";
 import { buildEmbeddedRunBaseParams, buildEmbeddedRunContexts, resolveModelFallbackOptions } from "./agent-runner-utils.js";
 import { createBlockReplyDeliveryHandler } from "./reply-delivery.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import crypto from "node:crypto";
 
 //#region src/auto-reply/reply/agent-runner-execution.ts
@@ -369,7 +369,7 @@ async function runAgentTurnWithFallback(params) {
 					if (corruptedSessionId) {
 						const transcriptPath = resolveSessionTranscriptPath(corruptedSessionId);
 						try {
-							syncFs.unlinkSync(transcriptPath);
+							fs.unlinkSync(transcriptPath);
 						} catch {}
 					}
 					delete params.activeSessionStore[sessionKey];

package/dist/auto-reply/reply/agent-runner.js

@@ -35,7 +35,7 @@ import { createTypingSignaler } from "./typing-mode.js";
 import { createFollowupRunner } from "./followup-runner.js";
 import { auditPostCompactionReads, extractReadPaths, formatAuditWarning, readSessionMessages } from "./post-compaction-audit.js";
 import { resolveActiveRunQueueAction } from "./queue-policy.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 
 //#region src/auto-reply/reply/agent-runner.ts
 const BLOCK_REPLY_SEND_TIMEOUT_MS = 15e3;
@@ -305,7 +305,7 @@ async function runReplyAgent(params) {
 			transcriptCandidates.add(resolveSessionTranscriptPath(prevSessionId, agentId));
 			for (const candidate of transcriptCandidates) {
 				try {
-					syncFs.unlinkSync(candidate);
+					fs.unlinkSync(candidate);
 				} catch {}
 			}
 		}

package/dist/auto-reply/reply/commands-export-session.js

@@ -2,14 +2,14 @@ import { resolveDefaultSessionStorePath, resolveSessionFilePath, resolveSessionF
 import { loadSessionStore } from "../../config/sessions/store.js";
 import { resolveCommandsSystemPromptBundle } from "./commands-system-prompt.js";
 import { fileURLToPath } from "node:url";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 import { SessionManager } from "@mariozechner/pi-coding-agent";
 
 //#region src/auto-reply/reply/commands-export-session.ts
 const EXPORT_HTML_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), "export-html");
 function loadTemplate(fileName) {
-	return syncFs.readFileSync(path.join(EXPORT_HTML_DIR, fileName), "utf-8");
+	return fs.readFileSync(path.join(EXPORT_HTML_DIR, fileName), "utf-8");
 }
 function generateHtml(sessionData) {
 	const template = loadTemplate("template.html");
@@ -84,7 +84,7 @@ function writeNewDefaultExportFile(filePath, html) {
 	for (let suffix = 1; suffix <= 100; suffix++) {
 		const candidate = suffix === 1 ? filePath : addCollisionSuffix(filePath, suffix);
 		try {
-			syncFs.writeFileSync(candidate, html, {
+			fs.writeFileSync(candidate, html, {
 				encoding: "utf-8",
 				flag: "wx"
 			});
@@ -119,7 +119,7 @@ async function buildExportSessionReply(params) {
 	} catch (err) {
 		return { text: `❌ Failed to resolve session file: ${err instanceof Error ? err.message : String(err)}` };
 	}
-	if (!syncFs.existsSync(sessionFile)) {
+	if (!fs.existsSync(sessionFile)) {
 		return { text: `❌ Session file not found: ${sessionFile}` };
 	}
 	const sessionManager = SessionManager.open(sessionFile);
@@ -143,11 +143,11 @@ async function buildExportSessionReply(params) {
 	const defaultFileName = `fased-session-${entry.sessionId.slice(0, 8)}-${timestamp}.html`;
 	let outputPath = args.outputPath ? path.resolve(args.outputPath.startsWith("~") ? args.outputPath.replace("~", process.env.HOME ?? "") : args.outputPath) : path.join(params.workspaceDir, defaultFileName);
 	const outputDir = path.dirname(outputPath);
-	if (!syncFs.existsSync(outputDir)) {
-		syncFs.mkdirSync(outputDir, { recursive: true });
+	if (!fs.existsSync(outputDir)) {
+		fs.mkdirSync(outputDir, { recursive: true });
 	}
 	if (args.outputPath) {
-		syncFs.writeFileSync(outputPath, html, "utf-8");
+		fs.writeFileSync(outputPath, html, "utf-8");
 	} else {
 		outputPath = writeNewDefaultExportFile(outputPath, html);
 	}

package/dist/auto-reply/reply/post-compaction-audit.js

@@ -1,4 +1,4 @@
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/auto-reply/reply/post-compaction-audit.ts
@@ -38,11 +38,11 @@ function auditPostCompactionReads(readFilePaths, workspaceDir, requiredReads = D
 * Returns messages from the last N lines (default 100).
 */
 function readSessionMessages(sessionFile, maxLines = 100) {
-	if (!syncFs.existsSync(sessionFile)) {
+	if (!fs.existsSync(sessionFile)) {
 		return [];
 	}
 	try {
-		const content = syncFs.readFileSync(sessionFile, "utf-8");
+		const content = fs.readFileSync(sessionFile, "utf-8");
 		const lines = content.trim().split("\n");
 		const recentLines = lines.slice(-maxLines);
 		const messages = [];

package/dist/auto-reply/reply/post-compaction-context.js

@@ -1,4 +1,4 @@
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/auto-reply/reply/post-compaction-context.ts
@@ -10,10 +10,10 @@ const MAX_CONTEXT_CHARS = 3e3;
 async function readPostCompactionContext(workspaceDir) {
 	const agentsPath = path.join(workspaceDir, "AGENTS.md");
 	try {
-		if (!syncFs.existsSync(agentsPath)) {
+		if (!fs.existsSync(agentsPath)) {
 			return null;
 		}
-		const content = await syncFs.promises.readFile(agentsPath, "utf-8");
+		const content = await fs.promises.readFile(agentsPath, "utf-8");
 		const sections = extractSections(content, ["Session Startup", "Red Lines"]);
 		if (sections.length === 0) {
 			return null;

package/dist/auto-reply/reply/session.js

@@ -20,7 +20,7 @@ import { getGlobalHookRunner } from "../../plugins/hook-runner-global.js";
 import { resolveCommandAuthorization } from "../command-auth.js";
 import { stripMentions, stripStructuralPrefixes } from "./mentions.js";
 import { deliverSessionMaintenanceWarning } from "../../infra/session-maintenance-warning.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
 import { CURRENT_SESSION_VERSION, SessionManager } from "@mariozechner/pi-coding-agent";
@@ -85,7 +85,7 @@ function forkSessionFromParent(params) {
 		agentId: params.agentId,
 		sessionsDir: params.sessionsDir
 	});
-	if (!parentSessionFile || !syncFs.existsSync(parentSessionFile)) {
+	if (!parentSessionFile || !fs.existsSync(parentSessionFile)) {
 		return null;
 	}
 	try {
@@ -113,7 +113,7 @@ function forkSessionFromParent(params) {
 			cwd: manager.getCwd(),
 			parentSession: parentSessionFile
 		};
-		syncFs.writeFileSync(sessionFile, `${JSON.stringify(header)}\n`, "utf-8");
+		fs.writeFileSync(sessionFile, `${JSON.stringify(header)}\n`, "utf-8");
 		return {
 			sessionId,
 			sessionFile

package/dist/auto-reply/skill-commands.js

@@ -3,7 +3,7 @@ import { listChatCommands } from "./commands-registry.js";
 import { buildWorkspaceSkillCommandSpecs } from "../agents/skills/workspace.js";
 import "../agents/skills.js";
 import { getRemoteSkillEligibility } from "../infra/skills-remote.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 
 //#region src/auto-reply/skill-commands.ts
 function listReservedChatSlashCommandNames(extraNames = []) {
@@ -43,10 +43,10 @@ function listSkillCommandsForAgents(params) {
 	const visitedDirs = new Set();
 	for (const agentId of agentIds) {
 		const workspaceDir = resolveAgentWorkspaceDir(params.cfg, agentId);
-		if (!syncFs.existsSync(workspaceDir)) {
+		if (!fs.existsSync(workspaceDir)) {
 			continue;
 		}
-		const canonicalDir = syncFs.realpathSync(workspaceDir);
+		const canonicalDir = fs.realpathSync(workspaceDir);
 		if (visitedDirs.has(canonicalDir)) {
 			continue;
 		}

package/dist/auto-reply/status.js

@@ -20,7 +20,7 @@ import { formatProviderModelRef, resolveSelectedAndActiveModel } from "./model-r
 import { resolveActiveFallbackState } from "./fallback-state.js";
 import { resolveSandboxRuntimeStatus } from "../agents/sandbox/runtime-status.js";
 import "../agents/sandbox.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 
 //#region src/auto-reply/status.ts
 const formatTokenCount = formatTokenCount$1;
@@ -135,19 +135,19 @@ const readUsageFromSessionLog = (sessionId, sessionEntry, agentId, sessionKey, s
 	} catch {
 		return undefined;
 	}
-	if (!syncFs.existsSync(logPath)) {
+	if (!fs.existsSync(logPath)) {
 		return undefined;
 	}
 	try {
 		const TAIL_BYTES = 8192;
-		const stat = syncFs.statSync(logPath);
+		const stat = fs.statSync(logPath);
 		const offset = Math.max(0, stat.size - TAIL_BYTES);
 		const buf = Buffer.alloc(Math.min(TAIL_BYTES, stat.size));
-		const fd = syncFs.openSync(logPath, "r");
+		const fd = fs.openSync(logPath, "r");
 		try {
-			syncFs.readSync(fd, buf, 0, buf.length, offset);
+			fs.readSync(fd, buf, 0, buf.length, offset);
 		} finally {
-			syncFs.closeSync(fd);
+			fs.closeSync(fd);
 		}
 		const tail = buf.toString("utf-8");
 		const lines = (offset > 0 ? tail.slice(tail.indexOf("\n") + 1) : tail).split(/\n+/);

package/dist/brand.js

@@ -2,7 +2,7 @@
 const FASED_BRAND_NAME = "Fased";
 const FASED_AGENT_NAME = "Fased Agent";
 const FASED_CONTROL_NAME = "Fased Control";
-const FASED_PRODUCT_VERSION = "0.1.56";
+const FASED_PRODUCT_VERSION = "0.1.57";
 const FASED_DISPLAY_VERSION = `v${FASED_PRODUCT_VERSION}`;
 function formatFasedDisplayLine() {
 	return `${FASED_AGENT_NAME} ${FASED_DISPLAY_VERSION}`;

package/dist/browser/chrome.executables.js

@@ -1,4 +1,4 @@
-import syncFs from "node:fs";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
@@ -79,7 +79,7 @@ const CHROMIUM_EXE_NAMES = new Set([
 ]);
 function exists(filePath) {
 	try {
-		return syncFs.existsSync(filePath);
+		return fs.existsSync(filePath);
 	} catch {
 		return false;
 	}
@@ -295,7 +295,7 @@ function findDesktopFilePath(desktopId) {
 }
 function readDesktopExecLine(desktopPath) {
 	try {
-		const raw = syncFs.readFileSync(desktopPath, "utf8");
+		const raw = fs.readFileSync(desktopPath, "utf8");
 		const lines = raw.split(/\r?\n/);
 		for (const line of lines) {
 			if (line.startsWith("Exec=")) {

package/dist/browser/chrome.js

@@ -6,7 +6,7 @@ import { normalizeCdpWsUrl } from "./cdp.js";
 import { ensurePortAvailable } from "../infra/ports.js";
 import { findChromeExecutableLinux, findChromeExecutableMac, findChromeExecutableWindows, resolveBrowserExecutableForPlatform } from "./chrome.executables.js";
 import { decorateFasedAgentProfile, ensureProfileCleanExit, isProfileDecorated } from "./chrome.profile-decoration.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { spawn } from "node:child_process";
@@ -16,7 +16,7 @@ import WebSocket$1 from "ws";
 const log = createSubsystemLogger("browser").child("chrome");
 function exists(filePath) {
 	try {
-		return syncFs.existsSync(filePath);
+		return fs.existsSync(filePath);
 	} catch {
 		return false;
 	}
@@ -108,7 +108,7 @@ async function launchFasedAgentChrome(resolved, profile) {
 		throw new Error("No supported browser found (Chrome/Brave/Edge/Chromium on macOS, Linux, or Windows).");
 	}
 	const userDataDir = resolveFasedAgentUserDataDir(profile.name);
-	syncFs.mkdirSync(userDataDir, { recursive: true });
+	fs.mkdirSync(userDataDir, { recursive: true });
 	const needsDecorate = !isProfileDecorated(userDataDir, profile.name, (profile.color ?? DEFAULT_FASED_BROWSER_COLOR).toUpperCase());
 	const spawnOnce = () => {
 		const args = [

package/dist/browser/chrome.profile-decoration.js

@@ -1,5 +1,5 @@
 import { DEFAULT_FASED_BROWSER_COLOR, DEFAULT_FASED_BROWSER_PROFILE_NAME } from "./constants.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/browser/chrome.profile-decoration.ts
@@ -8,10 +8,10 @@ function decoratedMarkerPath(userDataDir) {
 }
 function safeReadJson(filePath) {
 	try {
-		if (!syncFs.existsSync(filePath)) {
+		if (!fs.existsSync(filePath)) {
 			return null;
 		}
-		const raw = syncFs.readFileSync(filePath, "utf-8");
+		const raw = fs.readFileSync(filePath, "utf-8");
 		const parsed = JSON.parse(raw);
 		if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
 			return null;
@@ -22,8 +22,8 @@ function safeReadJson(filePath) {
 	}
 }
 function safeWriteJson(filePath, data) {
-	syncFs.mkdirSync(path.dirname(filePath), { recursive: true });
-	syncFs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+	fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
 }
 function setDeep(obj, keys, value) {
 	let node = obj;
@@ -158,7 +158,7 @@ function decorateFasedAgentProfile(userDataDir, opts) {
 	}
 	safeWriteJson(preferencesPath, prefs);
 	try {
-		syncFs.writeFileSync(decoratedMarkerPath(userDataDir), `${Date.now()}\n`, "utf-8");
+		fs.writeFileSync(decoratedMarkerPath(userDataDir), `${Date.now()}\n`, "utf-8");
 	} catch {}
 }
 function ensureProfileCleanExit(userDataDir) {

package/dist/browser/profiles-service.js

@@ -6,7 +6,7 @@ import { allocateCdpPort, allocateColor, getUsedColors, getUsedPorts, isValidPro
 import { parseHttpUrl, resolveProfile } from "./config.js";
 import { resolveFasedAgentUserDataDir } from "./chrome.js";
 import { movePathToTrash } from "./trash.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/browser/profiles-service.ts
@@ -106,7 +106,7 @@ function createBrowserProfilesService(ctx) {
 			} catch {}
 			const userDataDir = resolveFasedAgentUserDataDir(name);
 			const profileDir = path.dirname(userDataDir);
-			if (syncFs.existsSync(profileDir)) {
+			if (fs.existsSync(profileDir)) {
 				await movePathToTrash(profileDir);
 				deleted = true;
 			}

package/dist/browser/server-context.js

@@ -9,7 +9,7 @@ import { getPwAiModule } from "./pw-ai-module.js";
 import { refreshResolvedBrowserConfigFromDisk, resolveBrowserProfileWithHotReload } from "./resolved-config-refresh.js";
 import { resolveTargetIdFromTabs } from "./target-id.js";
 import { movePathToTrash } from "./trash.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 
 //#region src/browser/server-context.ts
 function listKnownProfileNames(state) {
@@ -396,7 +396,7 @@ function createProfileContext(opts, profile) {
 			const mod = await import("./pw-ai.js");
 			await mod.closePlaywrightBrowserConnection();
 		} catch {}
-		if (!syncFs.existsSync(userDataDir)) {
+		if (!fs.existsSync(userDataDir)) {
 			return {
 				moved: false,
 				from: userDataDir

package/dist/browser/trash.js

@@ -1,6 +1,6 @@
 import { runExec } from "../process/exec.js";
 import { generateSecureToken } from "../infra/secure-random.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
@@ -11,13 +11,13 @@ async function movePathToTrash(targetPath) {
 		return targetPath;
 	} catch {
 		const trashDir = path.join(os.homedir(), ".Trash");
-		syncFs.mkdirSync(trashDir, { recursive: true });
+		fs.mkdirSync(trashDir, { recursive: true });
 		const base = path.basename(targetPath);
 		let dest = path.join(trashDir, `${base}-${Date.now()}`);
-		if (syncFs.existsSync(dest)) {
+		if (fs.existsSync(dest)) {
 			dest = path.join(trashDir, `${base}-${Date.now()}-${generateSecureToken(6)}`);
 		}
-		syncFs.renameSync(targetPath, dest);
+		fs.renameSync(targetPath, dest);
 		return dest;
 	}
 }

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.56",
-  "commit": "2b4261aec306a95c17fd7e3a3b80d318cf0a1e3e",
-  "builtAt": "2026-07-13T10:46:43.796Z"
+  "version": "0.1.57",
+  "commit": "91e53d4b2c1ca02701eff503d93e889ccfaab43d",
+  "builtAt": "2026-07-13T13:04:23.327Z"
 }

package/dist/canvas-host/a2ui/.bundle.hash

@@ -1 +1 @@
-3eaa0d3b051a6ad465c7d09c5328d97ea63ce8c30c19339661271a0fee218ae4
+bfd05e986c05a91921422f61d2871d036c3e2622a756b89cd75c7ba92ccf4947

package/dist/canvas-host/server.js

@@ -6,7 +6,7 @@ import { normalizeUrlPath, resolveFileWithinRoot } from "./file-resolver.js";
 import { CANVAS_HOST_PATH, CANVAS_WS_PATH, handleA2uiHttpRequest, injectCanvasLiveReload } from "./a2ui.js";
 import * as fsSync from "node:fs";
 import path from "node:path";
-import fs from "node:fs/promises";
+import fs$1 from "node:fs/promises";
 import http from "node:http";
 import chokidar from "chokidar";
 import { WebSocketServer } from "ws";
@@ -127,13 +127,13 @@ function normalizeBasePath(rawPath) {
 }
 async function prepareCanvasRoot(rootDir) {
 	await ensureDir(rootDir);
-	const rootReal = await fs.realpath(rootDir);
+	const rootReal = await fs$1.realpath(rootDir);
 	try {
 		const indexPath = path.join(rootReal, "index.html");
-		await fs.stat(indexPath);
+		await fs$1.stat(indexPath);
 	} catch {
 		try {
-			await fs.writeFile(path.join(rootReal, "index.html"), defaultIndexHTML(), "utf8");
+			await fs$1.writeFile(path.join(rootReal, "index.html"), defaultIndexHTML(), "utf8");
 		} catch {}
 	}
 	return rootReal;

package/dist/capabilities/catalog.js

@@ -2,7 +2,7 @@ import { resolveFasedAgentPackageRootSync } from "../infra/fased-root.js";
 import { loadConfig } from "../config/io.js";
 import "../config/config.js";
 import { buildPluginMarketplaceReport } from "../plugins/marketplace.js";
-import syncFs from "node:fs";
+import fs from "node:fs";
 import path from "node:path";
 
 //#region src/capabilities/catalog.ts
@@ -82,14 +82,14 @@ function resolveCatalogPath() {
 	].filter((entry, index, all) => Boolean(entry) && all.indexOf(entry) === index);
 	for (const root of roots) {
 		const candidate = path.join(root, CATALOG_RELATIVE_PATH);
-		if (syncFs.existsSync(candidate)) {
+		if (fs.existsSync(candidate)) {
 			return candidate;
 		}
 	}
 	throw new Error(`Fased capability catalog not found (${CATALOG_RELATIVE_PATH})`);
 }
 function loadCapabilityCatalog() {
-	const payload = JSON.parse(syncFs.readFileSync(resolveCatalogPath(), "utf8"));
+	const payload = JSON.parse(fs.readFileSync(resolveCatalogPath(), "utf8"));
 	if (!isRecord(payload) || !Array.isArray(payload.entries)) {
 		throw new Error("capability catalog must contain an entries array");
 	}

package/dist/capabilities/install.js

@@ -0,0 +1,43 @@
+import { installPluginFromNpmSpec } from "../plugins/install.js";
+import { buildNpmResolutionInstallFields } from "../plugins/installs.js";
+import { finalizeInstalledPluginConfig } from "../plugins/lifecycle.js";
+import { loadCapabilityCatalog } from "./catalog.js";
+
+//#region src/capabilities/install.ts
+async function installCapabilityComponent(params) {
+	const entry = loadCapabilityCatalog().find((candidate) => candidate.id === params.id);
+	if (!entry) {
+		throw new Error(`Unknown component: ${params.id}. Run \`fased components\` to list choices.`);
+	}
+	if (entry.delivery !== "npm-addon" || !entry.packageName || !entry.pluginId) {
+		throw new Error(`${entry.label} is delivered as ${entry.delivery} and cannot be installed as an add-on. See ${entry.docsPath}.`);
+	}
+	const packageSpec = params.packageSpec?.trim() || entry.packageName;
+	const result = await installPluginFromNpmSpec({ spec: packageSpec });
+	if (!result.ok) {
+		throw new Error(result.error);
+	}
+	const finalized = finalizeInstalledPluginConfig({
+		config: params.config,
+		pluginId: result.pluginId,
+		refreshManifestRegistry: true,
+		installRecord: {
+			source: "npm",
+			spec: packageSpec,
+			installPath: result.targetDir,
+			version: result.version,
+			...buildNpmResolutionInstallFields(result.npmResolution)
+		}
+	});
+	return {
+		config: finalized.config,
+		entry,
+		pluginId: result.pluginId,
+		targetDir: result.targetDir,
+		...result.version ? { version: result.version } : {},
+		slotWarnings: finalized.slotWarnings
+	};
+}
+
+//#endregion
+export { installCapabilityComponent };