Function resolveClientId

npm_modules/cli/src/utils/daemonClient.ts:463–502

(
  conn: DaemonConnection,
  clientIdOverride?: string,
)

 * Priority: explicit --client flag → saved config → auto (single device) → prompt.
 */
export async function resolveClientId(
  conn: DaemonConnection,
  clientIdOverride?: string,
): Promise<string> {
  const clients = await conn.listConnectedClients();

  if (clients.length === 0) {
    throw new CliError(
      'No devices connected to the Valdi daemon.\n' +
      'Make sure the Valdi app is running and connected to the hot-reloader.',
    );
  }

  if (clientIdOverride) {
    if (!clients.some((c) => c.client_id === clientIdOverride)) {
      throw new CliError(
        `Client "${clientIdOverride}" not found. Run "valdi inspect devices" to see connected clients.`,
      );
    }
    return clientIdOverride;
  }

  const config = loadInspectConfig();
  if (config.selectedClientId && clients.some((c) => c.client_id === config.selectedClientId)) {
    return config.selectedClientId;
  }

  if (clients.length === 1) {
    return clients[0]!.client_id;
  }

  // Multiple devices — prompt
  return getUserChoice(
    clients.map((c) => ({
      name: `${c.application_id} (${c.platform})  [${c.client_id}]`,
      value: c.client_id,
    })),
    'Multiple devices connected. Select one:',
  );
}