Enhances authentication token handling with metadata

[sergeibbb]

Description

Implements #4880

Introduces TokenInfo and TokenWithInfo types to encapsulate authentication access tokens along with their relevant metadata, such as provider ID, cloud status, scopes, and expiration.

This refactoring replaces direct accessToken strings with the new TokenWithInfo object across various API calls within integration providers. Benefits include:

• Provides richer context in AuthenticationError messages for improved debugging.
• Increases type safety and clarity by explicitly passing token metadata.

Implementation Details

Notes about the PR size

Despite it looks big, the only thing is done is passing more information from the point where we have the whole session to the point where a error is handled and the AuthenticationError is formed. Nothing else is changed. The PR does not change the behavior. For example,

• I have not added or removed any try-catch blocks
• I haven't added new handling wrappers in a method even when a neighboring method, that looks similar, has such wrappers
  • for such changes I would need to identify whether a wrapper missed by a mistake or by a reason, identify a problem that it can cause, and make sure that a change does not produce new problems. That's why in this ticket I'm keeping things unchanged as much as possible.

Notes about the solution

There was an option to catch AuthenticationError upper in the call-stack and enrich it with the session metadata. By doing this I could reduce amount of changes. But it's hard identify all the possible points where it should be done, because a thrown exception does not highlight its type: such a place where AuthenticationError caught and logged can be missed, it can be caught earlier before it reaches your point, new points can appear later.

By requiring AuthenticationError to receive all the meta information everything is checked at compile time. Yes, we have to do massive changes once, but then it's always correct and checked by the compiler.

Checklist

• I have followed the guidelines in the Contributing document
• My changes follow the coding style of this project
• My changes build without any errors or warnings
• My changes have been formatted and linted
• My changes include any required corresponding changes to the documentation (including CHANGELOG.md and README.md)
• My changes have been rebased and squashed to the minimal number (typically 1) of relevant commits
• My changes have a descriptive commit message with a short title, including a Fixes $XXX - or Closes #XXX - prefix to auto-close the issue that your PR addresses

[augmentcode]

🤖 Augment PR Summary

Summary: This PR threads richer authentication-token metadata through integrations to improve diagnostics (especially for auth failures) without intending to change request behavior.

Changes:

• Adds TokenInfo / TokenWithInfo (including an obfuscated microHash) plus helpers (toTokenInfo, toTokenWithInfo).
• Extends ProviderAuthenticationSession and stored sessions to carry auth type (oauth/pat), cloud flag, scopes, and expiration.
• Updates AuthenticationError to accept TokenInfo and append token metadata in toString() for improved logging.
• Refactors provider integrations/APIs (GitHub, GitLab, Bitbucket, Azure DevOps, Jira, Linear) to pass TokenWithInfo through request layers and use it when constructing auth/rate-limit errors.
• Updates ProvidersApi to accept TokenOptInfo and to derive token+metadata from the authentication service when needed.
• Enhances GitKraken server connection error handling to include token metadata when throwing auth-related errors.

Technical Notes: Token metadata is intended to be surfaced primarily in logs via Error.toString() to help correlate auth/session issues across refresh and provider boundaries.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 3 suggestions posted.

Comment augment review to trigger a new review at any time.

[augmentcode]

Review completed. 1 suggestions posted.

Comment augment review to trigger a new review at any time.