Add Agent 365 token support

[heyitsaamir]

Adds foundational token support for Agent 365 scenarios:

• AgenticIdentity type (agenticAppId, agenticUserId, tenantId, agenticAppBlueprintId)
• agenticBotScope on CloudEnvironment (https://botapi.skype.com/.default)
• TokenRequestOptions type for extensible token callback options
• TokenManager.getAgenticToken(agenticIdentity, scope) — 3-step FMI token exchange (T1 → T2 → T3)
• TokenManager.getAppToken(scope, tenantId?) — generalized app token method
• TokenCredentials.token signature extended: (scope, tenantId?, options?: TokenRequestOptions)

[heyitsaamir]

This change is part of the following stack:

• DNP - Feature Branch ACF support #627
  • Add Agent 365 token support #628 ◀
    • Support Entra inbound Agent ID tokens #629
      • Add agentic auth provider infrastructure #630
        • Add AgenticIdentity API surface #631
          • Add agentic send helpers #632

_{Change managed by git-spice.}

[Copilot]

Pull request overview

Adds foundational types and plumbing for Agent 365 token scenarios across @microsoft/teams.api and @microsoft/teams.apps, including new agent identity modeling, an extensible token-provider callback shape, and a new TokenManager agentic token acquisition path.

Changes:

• Introduces AgenticIdentity and exports it from the API models barrel.
• Extends auth surface area: CloudEnvironment.agenticBotScope and TokenCredentials.token(..., options?: TokenRequestOptions).
• Updates TokenManager with getAppToken(...) and getAgenticToken(...) plus an @azure/msal-node version bump.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/apps/src/token-manager.ts	Adds getAppToken and implements a 3-step getAgenticToken exchange flow plus new MSAL client caching.
packages/apps/src/token-manager.spec.ts	Updates TokenCredentials-provider expectations for the new optional options argument.
packages/apps/package.json	Bumps @azure/msal-node dependency version.
packages/api/src/models/index.ts	Exports the new agentic-identity model.
packages/api/src/models/agentic-identity.ts	Adds the AgenticIdentity type.
packages/api/src/auth/credentials.ts	Adds TokenRequestOptions and extends TokenCredentials.token signature to accept options.
packages/api/src/auth/cloud-environment.ts	Adds agenticBotScope to CloudEnvironment and populates it for predefined clouds.
package-lock.json	Updates lockfile for the MSAL dependency bump.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 8 changed files in this pull request and generated 5 comments.