@elizaos/app-core 2.0.0-beta.3 → 2.0.3-beta.3

package/platforms/electrobun/src/startup-trace.ts

@@ -4,66 +4,70 @@ import path from "node:path";
 import { getBrandConfig } from "./brand-config";
 
 export const STARTUP_TRACE_PHASES = [
-	"main_start",
-	"env_loaded",
-	"crash_prompt_checked",
-	"webgpu_initialized",
-	"browser_workspace_bridge_ready",
-	"desktop_test_bridge_ready",
-	"creating_window",
-	"window_ready",
-	"autostart_requested",
-	"agent_start_entered",
-	"port_selected",
-	"runtime_path_resolved",
-	"child_spawned",
-	"health_ready",
-	"runtime_ready",
-	"metadata_ready",
-	"fatal",
+  "main_start",
+  "env_loaded",
+  "crash_prompt_checked",
+  "webgpu_initialized",
+  "browser_workspace_bridge_ready",
+  "desktop_test_bridge_ready",
+  "creating_window",
+  "window_ready",
+  "autostart_requested",
+  "agent_start_entered",
+  "port_selected",
+  "runtime_path_resolved",
+  "database_mode_resolved",
+  "database_migration_started",
+  "database_migration_completed",
+  "database_migration_failed",
+  "child_spawned",
+  "health_ready",
+  "runtime_ready",
+  "metadata_ready",
+  "fatal",
 ] as const;
 
 export type StartupTracePhase = (typeof STARTUP_TRACE_PHASES)[number];
 
 export type StartupTraceState = {
-	session_id: string;
-	phase: StartupTracePhase;
-	pid: number | null;
-	child_pid: number | null;
-	port: number | null;
-	exec_path: string | null;
-	bundle_path: string | null;
-	elapsed_ms: number;
-	error: string | null;
-	exit_code: number | null;
-	updated_at: string;
+  session_id: string;
+  phase: StartupTracePhase;
+  pid: number | null;
+  child_pid: number | null;
+  port: number | null;
+  exec_path: string | null;
+  bundle_path: string | null;
+  elapsed_ms: number;
+  error: string | null;
+  exit_code: number | null;
+  updated_at: string;
 };
 
 type StartupTraceUpdate = Partial<
-	Pick<
-		StartupTraceState,
-		| "pid"
-		| "child_pid"
-		| "port"
-		| "exec_path"
-		| "bundle_path"
-		| "error"
-		| "exit_code"
-	>
+  Pick<
+    StartupTraceState,
+    | "pid"
+    | "child_pid"
+    | "port"
+    | "exec_path"
+    | "bundle_path"
+    | "error"
+    | "exit_code"
+  >
 >;
 
 type StartupTraceConfig = {
-	enabled: boolean;
-	sessionId: string | null;
-	stateFile: string | null;
-	eventsFile: string | null;
+  enabled: boolean;
+  sessionId: string | null;
+  stateFile: string | null;
+  eventsFile: string | null;
 };
 
 type StartupTraceBootstrap = {
-	session_id?: string | null;
-	state_file?: string | null;
-	events_file?: string | null;
-	expires_at?: string | null;
+  session_id?: string | null;
+  state_file?: string | null;
+  events_file?: string | null;
+  expires_at?: string | null;
 };
 
 const sessionStartMs = new Map<string, number>();
@@ -73,279 +77,279 @@ const enabledTraceSessionsLogged = new Set<string>();
 let disabledTraceLogged = false;
 
 function trimEnv(value: string | undefined): string | null {
-	const trimmed = value?.trim();
-	return trimmed ? trimmed : null;
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
 }
 
 function hasOwn<T extends object>(value: T, key: keyof T): boolean {
-	return Object.hasOwn(value, key);
+  return Object.hasOwn(value, key);
 }
 
 function ensureParentDir(filePath: string): void {
-	fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
 }
 
 function writeJsonAtomic(filePath: string, value: StartupTraceState): void {
-	ensureParentDir(filePath);
-	const tempPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
-	fs.writeFileSync(tempPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
-	fs.renameSync(tempPath, filePath);
+  ensureParentDir(filePath);
+  const tempPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+  fs.writeFileSync(tempPath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+  fs.renameSync(tempPath, filePath);
 }
 
 function appendJsonLine(filePath: string, value: StartupTraceState): void {
-	ensureParentDir(filePath);
-	fs.appendFileSync(filePath, `${JSON.stringify(value)}\n`, "utf8");
+  ensureParentDir(filePath);
+  fs.appendFileSync(filePath, `${JSON.stringify(value)}\n`, "utf8");
 }
 
 function writeStartupTraceDebugLine(
-	message: string,
-	env: NodeJS.ProcessEnv = process.env,
+  message: string,
+  env: NodeJS.ProcessEnv = process.env,
 ): void {
-	try {
-		const logPath = path.join(
-			resolveStartupTraceControlDir(env, process.platform),
-			getBrandConfig().startupLogFileName,
-		);
-		ensureParentDir(logPath);
-		fs.appendFileSync(
-			logPath,
-			`[${new Date().toISOString()}] [StartupTrace] ${message}\n`,
-			"utf8",
-		);
-	} catch {
-		// Ignore debug log write failures; trace file writes are the real contract.
-	}
+  try {
+    const logPath = path.join(
+      resolveStartupTraceControlDir(env, process.platform),
+      getBrandConfig().startupLogFileName,
+    );
+    ensureParentDir(logPath);
+    fs.appendFileSync(
+      logPath,
+      `[${new Date().toISOString()}] [StartupTrace] ${message}\n`,
+      "utf8",
+    );
+  } catch {
+    // Ignore debug log write failures; trace file writes are the real contract.
+  }
 }
 
 export function resolveStartupBundlePath(
-	execPath: string = process.execPath,
+  execPath: string = process.execPath,
 ): string | null {
-	const normalizedExecPath = execPath.replaceAll("\\", "/");
-	const appBundleMatch = normalizedExecPath.match(/^(.*?\.app)(?:\/|$)/);
-	if (appBundleMatch) {
-		return execPath.slice(0, appBundleMatch[1].length);
-	}
-
-	const execDir = path.dirname(execPath);
-	if (path.basename(execDir).toLowerCase() === "bin") {
-		return path.dirname(execDir);
-	}
-
-	return null;
+  const normalizedExecPath = execPath.replaceAll("\\", "/");
+  const appBundleMatch = normalizedExecPath.match(/^(.*?\.app)(?:\/|$)/);
+  if (appBundleMatch) {
+    return execPath.slice(0, appBundleMatch[1].length);
+  }
+
+  const execDir = path.dirname(execPath);
+  if (path.basename(execDir).toLowerCase() === "bin") {
+    return path.dirname(execDir);
+  }
+
+  return null;
 }
 
 function resolveStartupTraceControlDir(
-	env: NodeJS.ProcessEnv = process.env,
-	platform: NodeJS.Platform = process.platform,
+  env: NodeJS.ProcessEnv = process.env,
+  platform: NodeJS.Platform = process.platform,
 ): string {
-	const homeDir = trimEnv(env.HOME) ?? trimEnv(env.USERPROFILE) ?? os.homedir();
-	if (platform === "win32") {
-		const appData =
-			trimEnv(env.APPDATA) ?? path.join(homeDir, "AppData", "Roaming");
-		return path.join(appData, getBrandConfig().configDirName);
-	}
-
-	return path.join(homeDir, ".config", getBrandConfig().configDirName);
+  const homeDir = trimEnv(env.HOME) ?? trimEnv(env.USERPROFILE) ?? os.homedir();
+  if (platform === "win32") {
+    const appData =
+      trimEnv(env.APPDATA) ?? path.join(homeDir, "AppData", "Roaming");
+    return path.join(appData, getBrandConfig().configDirName);
+  }
+
+  return path.join(homeDir, ".config", getBrandConfig().configDirName);
 }
 
 export function resolveStartupTraceBootstrapFile(
-	execPath: string = process.execPath,
-	platform: NodeJS.Platform = process.platform,
+  execPath: string = process.execPath,
+  platform: NodeJS.Platform = process.platform,
 ): string | null {
-	const bundlePath = resolveStartupBundlePath(execPath);
-	if (!bundlePath) {
-		return null;
-	}
-
-	const normalizedBundlePath = bundlePath.replaceAll("\\", "/").toLowerCase();
-	if (platform === "darwin" && normalizedBundlePath.endsWith(".app")) {
-		return path.join(
-			bundlePath,
-			"Contents",
-			"Resources",
-			STARTUP_TRACE_BOOTSTRAP_FILENAME,
-		);
-	}
-
-	return path.join(bundlePath, STARTUP_TRACE_BOOTSTRAP_FILENAME);
+  const bundlePath = resolveStartupBundlePath(execPath);
+  if (!bundlePath) {
+    return null;
+  }
+
+  const normalizedBundlePath = bundlePath.replaceAll("\\", "/").toLowerCase();
+  if (platform === "darwin" && normalizedBundlePath.endsWith(".app")) {
+    return path.join(
+      bundlePath,
+      "Contents",
+      "Resources",
+      STARTUP_TRACE_BOOTSTRAP_FILENAME,
+    );
+  }
+
+  return path.join(bundlePath, STARTUP_TRACE_BOOTSTRAP_FILENAME);
 }
 
 function readStartupTraceBootstrapFile(
-	bootstrapFile: string | null,
+  bootstrapFile: string | null,
 ): StartupTraceBootstrap | null {
-	if (!bootstrapFile || !fs.existsSync(bootstrapFile)) {
-		return null;
-	}
-
-	try {
-		const bootstrap = JSON.parse(
-			fs.readFileSync(bootstrapFile, "utf8"),
-		) as StartupTraceBootstrap;
-		const expiresAt = trimEnv(bootstrap.expires_at ?? undefined);
-		if (expiresAt) {
-			const expiresAtMs = Date.parse(expiresAt);
-			if (Number.isFinite(expiresAtMs) && expiresAtMs < Date.now()) {
-				return null;
-			}
-		}
-		return bootstrap;
-	} catch {
-		return null;
-	}
+  if (!bootstrapFile || !fs.existsSync(bootstrapFile)) {
+    return null;
+  }
+
+  try {
+    const bootstrap = JSON.parse(
+      fs.readFileSync(bootstrapFile, "utf8"),
+    ) as StartupTraceBootstrap;
+    const expiresAt = trimEnv(bootstrap.expires_at ?? undefined);
+    if (expiresAt) {
+      const expiresAtMs = Date.parse(expiresAt);
+      if (Number.isFinite(expiresAtMs) && expiresAtMs < Date.now()) {
+        return null;
+      }
+    }
+    return bootstrap;
+  } catch {
+    return null;
+  }
 }
 
 function resolveStartupTraceControlBootstrapFile(
-	env: NodeJS.ProcessEnv = process.env,
-	platform: NodeJS.Platform = process.platform,
+  env: NodeJS.ProcessEnv = process.env,
+  platform: NodeJS.Platform = process.platform,
 ): string {
-	return path.join(
-		resolveStartupTraceControlDir(env, platform),
-		STARTUP_TRACE_BOOTSTRAP_FILENAME,
-	);
+  return path.join(
+    resolveStartupTraceControlDir(env, platform),
+    STARTUP_TRACE_BOOTSTRAP_FILENAME,
+  );
 }
 
 function readStartupTraceBootstrap(
-	env: NodeJS.ProcessEnv = process.env,
-	execPath: string = process.execPath,
-	platform: NodeJS.Platform = process.platform,
+  env: NodeJS.ProcessEnv = process.env,
+  execPath: string = process.execPath,
+  platform: NodeJS.Platform = process.platform,
 ): StartupTraceBootstrap | null {
-	return (
-		readStartupTraceBootstrapFile(
-			resolveStartupTraceBootstrapFile(execPath, platform),
-		) ??
-		readStartupTraceBootstrapFile(
-			resolveStartupTraceControlBootstrapFile(env, platform),
-		)
-	);
+  return (
+    readStartupTraceBootstrapFile(
+      resolveStartupTraceBootstrapFile(execPath, platform),
+    ) ??
+    readStartupTraceBootstrapFile(
+      resolveStartupTraceControlBootstrapFile(env, platform),
+    )
+  );
 }
 
 export function getStartupTraceConfig(
-	env: NodeJS.ProcessEnv = process.env,
-	execPath: string = process.execPath,
-	platform: NodeJS.Platform = process.platform,
+  env: NodeJS.ProcessEnv = process.env,
+  execPath: string = process.execPath,
+  platform: NodeJS.Platform = process.platform,
 ): StartupTraceConfig {
-	const bootstrap = readStartupTraceBootstrap(env, execPath, platform);
-	const sessionId =
-		trimEnv(env.ELIZA_STARTUP_SESSION_ID) ??
-		trimEnv(env.MILADY_STARTUP_SESSION_ID) ??
-		trimEnv(bootstrap?.session_id ?? undefined) ??
-		null;
-	const stateFile =
-		trimEnv(env.ELIZA_STARTUP_STATE_FILE) ??
-		trimEnv(env.MILADY_STARTUP_STATE_FILE) ??
-		trimEnv(bootstrap?.state_file ?? undefined) ??
-		null;
-	const eventsFile =
-		trimEnv(env.ELIZA_STARTUP_EVENTS_FILE) ??
-		trimEnv(env.MILADY_STARTUP_EVENTS_FILE) ??
-		trimEnv(bootstrap?.events_file ?? undefined) ??
-		null;
-	return {
-		enabled: Boolean(sessionId && (stateFile || eventsFile)),
-		sessionId,
-		stateFile,
-		eventsFile,
-	};
+  const bootstrap = readStartupTraceBootstrap(env, execPath, platform);
+  const sessionId =
+    trimEnv(env.ELIZA_STARTUP_SESSION_ID) ??
+    trimEnv(env.ELIZA_STARTUP_SESSION_ID) ??
+    trimEnv(bootstrap?.session_id ?? undefined) ??
+    null;
+  const stateFile =
+    trimEnv(env.ELIZA_STARTUP_STATE_FILE) ??
+    trimEnv(env.ELIZA_STARTUP_STATE_FILE) ??
+    trimEnv(bootstrap?.state_file ?? undefined) ??
+    null;
+  const eventsFile =
+    trimEnv(env.ELIZA_STARTUP_EVENTS_FILE) ??
+    trimEnv(env.ELIZA_STARTUP_EVENTS_FILE) ??
+    trimEnv(bootstrap?.events_file ?? undefined) ??
+    null;
+  return {
+    enabled: Boolean(sessionId && (stateFile || eventsFile)),
+    sessionId,
+    stateFile,
+    eventsFile,
+  };
 }
 
 export function recordStartupPhase(
-	phase: StartupTracePhase,
-	update: StartupTraceUpdate = {},
-	env: NodeJS.ProcessEnv = process.env,
-	execPath: string = process.execPath,
-	platform: NodeJS.Platform = process.platform,
+  phase: StartupTracePhase,
+  update: StartupTraceUpdate = {},
+  env: NodeJS.ProcessEnv = process.env,
+  execPath: string = process.execPath,
+  platform: NodeJS.Platform = process.platform,
 ): StartupTraceState | null {
-	const config = getStartupTraceConfig(env, execPath, platform);
-	if (!config.enabled || !config.sessionId) {
-		if (!disabledTraceLogged) {
-			const bootstrapFile = resolveStartupTraceBootstrapFile(execPath);
-			const controlBootstrapFile = resolveStartupTraceControlBootstrapFile(
-				env,
-				platform,
-			);
-			disabledTraceLogged = true;
-			writeStartupTraceDebugLine(
-				`disabled session=${config.sessionId ?? "<none>"} ` +
-					`state=${config.stateFile ?? "<none>"} ` +
-					`events=${config.eventsFile ?? "<none>"} ` +
-					`bootstrap=${bootstrapFile ?? "<none>"} exists=${bootstrapFile ? fs.existsSync(bootstrapFile) : false} ` +
-					`controlBootstrap=${controlBootstrapFile} exists=${fs.existsSync(controlBootstrapFile)} ` +
-					`execPath=${process.execPath}`,
-				env,
-			);
-		}
-		return null;
-	}
-
-	if (!enabledTraceSessionsLogged.has(config.sessionId)) {
-		enabledTraceSessionsLogged.add(config.sessionId);
-		writeStartupTraceDebugLine(
-			`enabled session=${config.sessionId} ` +
-				`state=${config.stateFile ?? "<none>"} ` +
-				`events=${config.eventsFile ?? "<none>"} ` +
-				`execPath=${process.execPath}`,
-			env,
-		);
-	}
-
-	const now = Date.now();
-	if (!sessionStartMs.has(config.sessionId)) {
-		sessionStartMs.set(config.sessionId, now);
-	}
-	const startedAt = sessionStartMs.get(config.sessionId) ?? now;
-	const previous = latestStateBySession.get(config.sessionId);
-	const stateExecPath =
-		hasOwn(update, "exec_path") && update.exec_path !== undefined
-			? update.exec_path
-			: (previous?.exec_path ?? process.execPath ?? null);
-	const nextState: StartupTraceState = {
-		session_id: config.sessionId,
-		phase,
-		pid:
-			hasOwn(update, "pid") && update.pid !== undefined
-				? update.pid
-				: (previous?.pid ?? process.pid),
-		child_pid:
-			hasOwn(update, "child_pid") && update.child_pid !== undefined
-				? update.child_pid
-				: (previous?.child_pid ?? null),
-		port:
-			hasOwn(update, "port") && update.port !== undefined
-				? update.port
-				: (previous?.port ?? null),
-		exec_path: stateExecPath,
-		bundle_path:
-			hasOwn(update, "bundle_path") && update.bundle_path !== undefined
-				? update.bundle_path
-				: (previous?.bundle_path ??
-					resolveStartupBundlePath(stateExecPath ?? "")),
-		elapsed_ms: now - startedAt,
-		error:
-			hasOwn(update, "error") && update.error !== undefined
-				? update.error
-				: null,
-		exit_code:
-			hasOwn(update, "exit_code") && update.exit_code !== undefined
-				? update.exit_code
-				: null,
-		updated_at: new Date(now).toISOString(),
-	};
-
-	latestStateBySession.set(config.sessionId, nextState);
-
-	if (config.stateFile) {
-		writeJsonAtomic(config.stateFile, nextState);
-	}
-	if (config.eventsFile) {
-		appendJsonLine(config.eventsFile, nextState);
-	}
-
-	return nextState;
+  const config = getStartupTraceConfig(env, execPath, platform);
+  if (!config.enabled || !config.sessionId) {
+    if (!disabledTraceLogged) {
+      const bootstrapFile = resolveStartupTraceBootstrapFile(execPath);
+      const controlBootstrapFile = resolveStartupTraceControlBootstrapFile(
+        env,
+        platform,
+      );
+      disabledTraceLogged = true;
+      writeStartupTraceDebugLine(
+        `disabled session=${config.sessionId ?? "<none>"} ` +
+          `state=${config.stateFile ?? "<none>"} ` +
+          `events=${config.eventsFile ?? "<none>"} ` +
+          `bootstrap=${bootstrapFile ?? "<none>"} exists=${bootstrapFile ? fs.existsSync(bootstrapFile) : false} ` +
+          `controlBootstrap=${controlBootstrapFile} exists=${fs.existsSync(controlBootstrapFile)} ` +
+          `execPath=${process.execPath}`,
+        env,
+      );
+    }
+    return null;
+  }
+
+  if (!enabledTraceSessionsLogged.has(config.sessionId)) {
+    enabledTraceSessionsLogged.add(config.sessionId);
+    writeStartupTraceDebugLine(
+      `enabled session=${config.sessionId} ` +
+        `state=${config.stateFile ?? "<none>"} ` +
+        `events=${config.eventsFile ?? "<none>"} ` +
+        `execPath=${process.execPath}`,
+      env,
+    );
+  }
+
+  const now = Date.now();
+  if (!sessionStartMs.has(config.sessionId)) {
+    sessionStartMs.set(config.sessionId, now);
+  }
+  const startedAt = sessionStartMs.get(config.sessionId) ?? now;
+  const previous = latestStateBySession.get(config.sessionId);
+  const stateExecPath =
+    hasOwn(update, "exec_path") && update.exec_path !== undefined
+      ? update.exec_path
+      : (previous?.exec_path ?? process.execPath);
+  const nextState: StartupTraceState = {
+    session_id: config.sessionId,
+    phase,
+    pid:
+      hasOwn(update, "pid") && update.pid !== undefined
+        ? update.pid
+        : (previous?.pid ?? process.pid),
+    child_pid:
+      hasOwn(update, "child_pid") && update.child_pid !== undefined
+        ? update.child_pid
+        : (previous?.child_pid ?? null),
+    port:
+      hasOwn(update, "port") && update.port !== undefined
+        ? update.port
+        : (previous?.port ?? null),
+    exec_path: stateExecPath,
+    bundle_path:
+      hasOwn(update, "bundle_path") && update.bundle_path !== undefined
+        ? update.bundle_path
+        : (previous?.bundle_path ??
+          resolveStartupBundlePath(stateExecPath ?? "")),
+    elapsed_ms: now - startedAt,
+    error:
+      hasOwn(update, "error") && update.error !== undefined
+        ? update.error
+        : null,
+    exit_code:
+      hasOwn(update, "exit_code") && update.exit_code !== undefined
+        ? update.exit_code
+        : null,
+    updated_at: new Date(now).toISOString(),
+  };
+
+  latestStateBySession.set(config.sessionId, nextState);
+
+  if (config.stateFile) {
+    writeJsonAtomic(config.stateFile, nextState);
+  }
+  if (config.eventsFile) {
+    appendJsonLine(config.eventsFile, nextState);
+  }
+
+  return nextState;
 }
 
 export function resetStartupTraceForTests(): void {
-	sessionStartMs.clear();
-	latestStateBySession.clear();
-	enabledTraceSessionsLogged.clear();
-	disabledTraceLogged = false;
+  sessionStartMs.clear();
+  latestStateBySession.clear();
+  enabledTraceSessionsLogged.clear();
+  disabledTraceLogged = false;
 }