Function resolveContextId

npm_modules/cli/src/utils/daemonClient.ts:425–457

(
  conn: DaemonConnection,
  clientId: string,
  contextIdOverride?: string,
)

 * Priority: explicit contextId argument → auto (single context) → prompt.
 */
export async function resolveContextId(
  conn: DaemonConnection,
  clientId: string,
  contextIdOverride?: string,
): Promise<string> {
  const contexts = await conn.listContexts(clientId);

  if (contexts.length === 0) {
    throw new CliError('No contexts found on the connected device.');
  }

  if (contextIdOverride) {
    if (!contexts.some((c) => c.id === contextIdOverride)) {
      throw new CliError(
        `Context "${contextIdOverride}" not found. Run "valdi inspect contexts" to see available contexts.`,
      );
    }
    return contextIdOverride;
  }

  if (contexts.length === 1) {
    return contexts[0]!.id;
  }

  // Multiple contexts — prompt
  return getUserChoice(
    contexts.map((c) => ({
      name: `${c.rootComponentName}  [${c.id}]`,
      value: c.id,
    })),
    'Multiple contexts found. Select one:',
  );
}

/**
 * Resolve which connected client to target.