Add agentic send helpers#632
Open
heyitsaamir wants to merge 2 commits into
Open
Conversation
Collaborator
Author
|
This change is part of the following stack: Change managed by git-spice. |
This was referenced Jun 26, 2026
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
94dbb33 to
089807c
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
from
ad1251d to
f54a6f6
Compare
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
089807c to
a8f0e2c
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
from
f54a6f6 to
1cf0b6f
Compare
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
a8f0e2c to
eb8d2e2
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
from
1cf0b6f to
e582bcb
Compare
heyitsaamir
commented
Jun 26, 2026
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
eb8d2e2 to
c92e38c
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
2 times, most recently
from
cefad04 to
9088f52
Compare
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
c92e38c to
b57702e
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
from
9088f52 to
6925d74
Compare
Contributor
There was a problem hiding this comment.
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 acceptRequestOptions, and add anApp.getAgenticIdentity()convenience factory. - Refactor
ActivitySenderto reuse a pre-built Teams APIClientand passRequestOptionsinto conversation activity operations. - Add
examples/agent365workspace 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.
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
b57702e to
fbf0cbd
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
from
6925d74 to
b8e2b61
Compare
- Add RequestOptions (agenticIdentity, serviceUrl) to app.send() - Add isRequestOptions guard for reply() overload disambiguation - Refactor ActivitySender to accept pre-built API Client - Wire agentic identity from inbound recipient into per-turn sender - Forward serviceUrl from ConversationReference in all API calls - Add getAgenticIdentity() factory on App - Add agenticIdentity to IActivitySender interface - Simplify ActivityContext.send() to delegate to sender directly - Add examples/agent365 reactive + proactive sample Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
heyitsaamir
force-pushed
the
agentic-api-surface
branch
from
fbf0cbd to
c5dfbda
Compare
heyitsaamir
force-pushed
the
agentic-send-helpers
branch
from
b8e2b61 to
80a73f2
Compare
Comment on lines
45
to
49
| if (activity.id) { | ||
| const res = isTargeted | ||
| ? await api.conversations.activities(ref.conversation.id).updateTargeted(activity.id, activity) | ||
| : await api.conversations.activities(ref.conversation.id).update(activity.id, activity); | ||
| ? await this.api.conversations.activities(ref.conversation.id).updateTargeted(activity.id, activity, reqOptions) | ||
| : await this.api.conversations.activities(ref.conversation.id).update(activity.id, activity, reqOptions); | ||
| return { ...activity, ...res }; |
Comment on lines
52
to
55
| const res = isTargeted | ||
| ? await api.conversations.activities(ref.conversation.id).createTargeted(activity) | ||
| : await api.conversations.activities(ref.conversation.id).create(activity); | ||
| ? await this.api.conversations.activities(ref.conversation.id).createTargeted(activity, reqOptions) | ||
| : await this.api.conversations.activities(ref.conversation.id).create(activity, reqOptions); | ||
| return { ...activity, ...res }; |
Comment on lines
+19
to
+21
| log.info(`[Agent365 reactive] Message received: ${activity.text}`); | ||
| log.info(`[Agent365 reactive] From: ${JSON.stringify(activity.from)}`); | ||
| log.info(`[Agent365 reactive] Recipient agentic identity: ${JSON.stringify(activity.recipient)}`); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Wires agentic identity into the app-layer send/reply helpers (mirrors Python PR #480):
app.send(conversationId, activity, options?)acceptsRequestOptionsapp.reply()supports options viaisRequestOptionstype guardapp.getAgenticIdentity(appId, userId, opts?)factory methodActivitySenderrefactored to accept pre-builtClient; mergesagenticIdentityandserviceUrlinto all API callsActivitySenderin$processwith identity fromactivity.recipientIActivitySenderinterface extended withreadonly agenticIdentity?ActivityContext.send()simplified — delegates to sender directlyexamples/agent365/— reactive echo + proactive send sample