add vscode.env.remoteAuthority-api, #74188

src/vs/vscode.d.ts

@@ -6040,6 +6040,17 @@ declare module 'vscode' {
 		 * @returns A promise indicating if open was successful.
 		 */
 		export function openExternal(target: Uri): Thenable<boolean>;
+
+		/**
+		 * The [authority](#Uri.authority)-component. When `undefined`, extensions are
+		 * executed in the same context (e.g. operating system or machine) in which the UI
+		 * of the editor is executed. If defined, extensions are running on a different
+		 * context, for instance a remote machine.
+		 *
+		 * *Note* that no assumptions about the actual value should be made as it is defined
+		 * by extensions and not by the editor.
+		 */
+		export const remoteAuthority: string | undefined;
 	}
 
 	/**

src/vs/workbench/api/node/extHost.api.impl.ts

@@ -256,7 +256,8 @@ export function createApiFactory(
 			},
 			openExternal(uri: URI) {
 				return extHostWindow.openUri(uri, { allowTunneling: !!initData.remoteAuthority });
-			}
+			},
+			get remoteAuthority() { return initData.remoteAuthority || undefined; }
 		});
 
 		// namespace: extensions