Function handleSessionStateCommands

src/daemon/handlers/session-state.ts:144–376

(params: {
  req: DaemonRequest;
  sessionName: string;
  logPath: string;
  sessionStore: SessionStore;
})

}

export async function handleSessionStateCommands(params: {
  req: DaemonRequest;
  sessionName: string;
  logPath: string;
  sessionStore: SessionStore;
}): Promise<DaemonResponse | null> {
  const { req, sessionName, logPath, sessionStore } = params;

  if (req.command === 'boot') {
    const session = sessionStore.get(sessionName);
    const flags = req.flags ?? {};
    const guard = requireSessionOrExplicitSelector(req.command, session, flags);
    if (guard) return guard;

    const normalizedPlatform = flags.platform ?? session?.device.platform;
    const targetsAndroid = normalizedPlatform === 'android';
    const wantsAndroidHeadless = flags.headless === true;
    if (wantsAndroidHeadless && !targetsAndroid) {
      return errorResponse(
        'INVALID_ARGS',
        'boot --headless is supported only for Android emulators.',
      );
    }

    const fallbackAvdName = resolveAndroidEmulatorAvdName({
      flags,
      sessionDevice: session?.device,
    });
    const canFallbackLaunchAndroidEmulator = targetsAndroid && Boolean(fallbackAvdName);

    let device: DeviceInfo;
    let launchedAndroidEmulator = false;
    try {
      device = await resolveCommandDevice({
        session,
        flags,
        ensureReady: false,
        allowStoppedAndroidAvdPlaceholders: true,
      });
    } catch (error) {
      const appErr = asAppError(error);
      if (
        targetsAndroid &&
        wantsAndroidHeadless &&
        !fallbackAvdName &&
        appErr.code === 'DEVICE_NOT_FOUND'
      ) {
        return errorResponse(
          'INVALID_ARGS',
          'boot --headless requires --device <avd-name> (or an Android emulator session target).',
        );
      }
      if (
        !canFallbackLaunchAndroidEmulator ||
        appErr.code !== 'DEVICE_NOT_FOUND' ||
        !fallbackAvdName
      ) {
        throw error;