Add agentic send helpers

[heyitsaamir]

Wires agentic identity into the app-layer send/reply helpers (mirrors Python PR #480):

• app.send(conversationId, activity, options?) accepts RequestOptions
• app.reply() supports options via isRequestOptions type guard
• app.getAgenticIdentity(appId, userId, opts?) factory method
• ActivitySender refactored to accept pre-built Client; merges agenticIdentity and serviceUrl into all API calls
• Per-turn ActivitySender in $process with identity from activity.recipient
• IActivitySender interface extended with readonly agenticIdentity?
• ActivityContext.send() simplified — delegates to sender directly
• examples/agent365/ — reactive echo + proactive send sample

[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

This PR wires agentic identity and request-level overrides into the @microsoft/teams.apps send/reply pipeline by threading RequestOptions (serviceUrl + agenticIdentity) through App, ActivityContext, and ActivitySender, and adds a new examples/agent365 sample demonstrating reactive + proactive agentic sends.

Changes:

• Extend app-layer send() / reply() helpers to accept RequestOptions, and add an App.getAgenticIdentity() convenience factory.
• Refactor ActivitySender to reuse a pre-built Teams API Client and pass RequestOptions into conversation activity operations.
• Add examples/agent365 workspace showing reactive echo and proactive agentic sends.

Reviewed changes

Copilot reviewed 16 out of 19 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/apps/src/types/plugin/sender.ts	Extends IActivitySender with optional agentic identity + RequestOptions support.
packages/apps/src/contexts/activity.ts	Simplifies ActivityContext.send() delegation to activitySender.
packages/apps/src/app.ts	Adds RequestOptions plumbing to send/reply and introduces getAgenticIdentity().
packages/apps/src/app.spec.ts	Updates tests to pass valid ActivityLike payloads (explicit type).
packages/apps/src/app.process.ts	Creates per-turn ApiClient/ActivitySender with agentic identity from inbound recipient.
packages/apps/src/app.process.spec.ts	Adjusts serviceUrl capture tests to hook ActivitySender.send.
packages/apps/src/activity-sender.ts	Refactors sender to reuse Client and forward RequestOptions into API calls.
packages/apps/src/activity-sender.spec.ts	Reworks sender tests to mock the API client instead of raw HTTP.
package-lock.json	Adds workspace entries for the new @examples/agent365 package.
examples/agent365/turbo.json	Adds turbo task config for building the new example workspace.
examples/agent365/tsconfig.json	TypeScript configuration for the new example.
examples/agent365/src/proactive.ts	Proactive messaging sample using AgenticIdentity with both app.send and API client.
examples/agent365/src/main.ts	Reactive echo sample demonstrating automatic propagation of inbound agentic identity/serviceUrl.
examples/agent365/README.md	Documentation for running reactive and proactive samples.
examples/agent365/package.json	Declares the new example workspace and scripts.
examples/agent365/eslint.config.js	ESLint config for the new example workspace.
examples/agent365/appPackage/manifest.json	Teams app manifest for the example agent package.

---

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

[corinagum]

getAgenticIdentity diverges from PY.  get_agentic_identity raises if it can't resolve a tenant, and accepts agentic_app_blueprint_id . The TS version returns { tenantId: undefined } silently, and there's no way to set the blueprint id. Worth noting the TS extractor getAgenticIdentity(account) in account.ts does carry agenticAppBlueprintId , so the factory is varied even within TS. Should a tenant guard + a blueprintId option be added to match PY?

[corinagum]

Also: PY resolves tenant from credentials.tenantId  vs TS  options.tenantId , are those equivalent?)

[heyitsaamir]

Good catch -

1. Default agentic_app_blueprint_id to app client id in get_agentic_identity teams.py#494 - updated Py to default with self.id if blueprint id is not provided
2. Updated this to accept blueprint id optionally and default to this.id if not provided.

[corinagum]

This collides with app.ts, will this cause confusion?

[corinagum]

Is anything meant to read this? Looks like this is not set anywhere.

[heyitsaamir]

You're right - no longer necessary (and in fact we should just remove this sender concept, it feels legacy)