Correct auth session acquisition flow in provider documentation

[Copilot]

The provider reference incorrectly stated that providers acquire auth sessions via Context.AcquireAuthSession(...). In reality, steps acquire sessions and pass them to provider methods.

Changes

• Line 23 (Choosing a provider): Clarified that steps acquire auth sessions via Context.AcquireAuthSession(...) and pass them to provider methods that accept an optional AuthSession parameter
• Line 39 (Authoring a provider): Updated checklist item to reflect that provider methods accept an optional AuthSession parameter rather than acquiring sessions themselves

Actual Flow

# In Invoke-IdleProviderMethod.ps1 (step helper):
$authSession = $Context.AcquireAuthSession($sessionName, $sessionOptions)

# Provider method receives the session:
if ($supportsAuthSession -and $null -ne $authSession) {
    return $provider.$MethodName.Invoke($MethodArguments + $authSession)
}

Providers are passive recipients of auth sessions, not active acquirers.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.