Need a way to force recreation of a specific session

[TylerLeonhardt]

So in API Sync yesterday, @joyceerhl brought up a really good point on my getSessions API proposal… the issue is that it is possible to get back all of these accounts, but there is no way to say that a specific account is bad.

Currently we have this:

await vscode.authentication.getSession('github', scopes, { forceNewSession: true })

// or

await vscode.authentication.getSession('github', scopes, { forceNewSession: { detail: 'because SAML is a pain' }})

but that only forces recreation of the session for the account that has preference and doesn’t allow for specifying a specific account to recreate… so with that, we have a couple ideas:

interface AuthenticationForceNewSessionOptions {
  detail?: string;
  accountId?: string;
}

or

interface AuthenticationForceNewSessionOptions {
  detail?: string;
  account?: AuthenticationSessionAccountInformation;
}

or even

interface AuthenticationForceNewSessionOptions {
  detail?: string;
  session?: AuthenticationSession;
}

one of which will then go here:

await vscode.authentication.getSession('github', scopes, { forceNewSession: obj })

and will take the user through the flow to create a new session for the account and scopes provided.

Some helpful dts links:

• AuthenticationSessionAccountInformation
• AuthenticationSession
• forceNewSession today
• getSession

[TylerLeonhardt]

New idea is to allow getSession to take in an accountHint which an auth provider can opt in to supporting.:

declare module 'vscode' {
	export interface AuthenticationProviderOptions {
		/**
		 * Whether the provider supports the concept of an account hint.
		 */
		readonly supportsAccountHint?: boolean;
	}
	export interface AuthenticationGetSessionOptions {
		/**
		 * An account hint to use when getting a session.
		 */
		readonly accountHint?: string;
	}
}

Then the caller can pass in a hint like an account id or an email address and the provider can interpret that and use that in deciding which session getSession will return.

[TylerLeonhardt]

Additionally, we consider the proposal in #115626 ... which would allow the caller to pass down anything to the provider to determine the session to return back.

[TylerLeonhardt]

We're going to merge this in with #152399