Skip to main content
← back to extensions

Microsoft/teams

@webframp/microsoft/teamsv2026.07.18.2· 9d agoMODELSREPORTS
01README

Microsoft Teams read-only integration — channels, chats, mentions via Graph API (public client, device code flow)

02Release Notes

2026.07.18.2

Added: An upgrades array entry (no-op) to teams.ts for proper typeVersion tracking on existing instances. No schema or behavior changes.

2026.07.18.1

Changed: Pinned the zod import specifier to npm:zod@4.4.3 (was npm:zod@4) for hermetic dependency resolution. No runtime behavior change.

2026.07.13.1

Changed: Upgraded the test-only dev dependency @systeminit/swamp-testing to 0.20260504.10, matching the rest of the repo. This is a test-harness change only — the published extension bundle is unchanged and no runtime behavior is affected.

03Models1
@webframp/microsoft/teamsv2026.07.18.2microsoft/teams.ts

Global Arguments

ArgumentTypeDescription
tenantIdstringEntra tenant GUID (e.g. e9b2b7ba-b238-42a9-b271-2adfc82da650)
clientIdstringAzure public client app registration ID
refreshTokenstringOAuth2 refresh token obtained via bootstrap. Re-run bootstrap if expired.
fn bootstrap()
Authenticate via device code flow. Displays a user code and
fn list_teams()
List Teams the signed-in user is a member of
fn list_channels(teamId: string)
List channels in a team
ArgumentTypeDescription
teamIdstringTeam ID (from list_teams output)
fn channel_messages(teamId: string, channelId: string, limit: number, includeReplies: boolean)
Fetch threaded messages from a Teams channel. Returns root messages
ArgumentTypeDescription
teamIdstringTeam ID
channelIdstringChannel ID
limitnumberMaximum root messages to fetch (replies under each are always fetched in full)
includeRepliesbooleanFetch and nest replies under each root message
fn list_chats(nameFilter?: string, limit: number)
List Teams chats (1:1 and group) the signed-in user participates in,
ArgumentTypeDescription
nameFilter?stringFilter to chats where a member name/email contains this substring
limitnumberMaximum chats to return
fn chat_messages(chatId: string, since?: string, limit: number)
Fetch messages from a specific Teams chat, newest first
ArgumentTypeDescription
chatIdstringChat ID (from list_chats output)
since?stringOnly messages at or after this ISO 8601 timestamp
limitnumberMaximum messages to return
fn attention(since?: string, chatLimit: number, mode: enum)
Aggregate things that want your attention: unread chats and @mentions
ArgumentTypeDescription
since?stringLook back to this ISO 8601 timestamp (default: 24h ago)
chatLimitnumberMax chats to scan (most-recent-first)
modeenumFilter attention items by type

Resources

teams(15m)— Teams the signed-in user is a member of
channels(15m)— Channels in a team
channelMessages(15m)— Threaded messages from a Teams channel (roots with nested replies)
chats(15m)— Teams chats the signed-in user participates in
chatMessages(15m)— Messages from a specific Teams chat
attention(15m)— Aggregated attention items: unread chats and @mentions
bootstrap(infinite)— Device code flow authentication result
04Reports1
@webframp/teams-digest-reportworkflow
teams_digest_report.ts

Surfaces Teams @mentions, active chat threads, and recent channel activity into a digest view for daily review

microsoftteamsdigestmentionsproductivity
05Previous Versions3
2026.07.18.1

2026.07.18.1

Changed: Pinned the zod import specifier to npm:zod@4.4.3 (was npm:zod@4) for hermetic dependency resolution. No runtime behavior change.

2026.07.13.1

Changed: Upgraded the test-only dev dependency @systeminit/swamp-testing to 0.20260504.10, matching the rest of the repo. This is a test-harness change only — the published extension bundle is unchanged and no runtime behavior is affected.

2026.07.13.1

2026.07.13.1

Changed: Upgraded the test-only dev dependency @systeminit/swamp-testing to 0.20260504.10, matching the rest of the repo. This is a test-harness change only — the published extension bundle is unchanged and no runtime behavior is affected.

2026.06.30.1
06Stats
A
100 / 100
Downloads
8
Archive size
24.3 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
Repository
https://github.com/webframp/swamp-extensions
07Platforms
08Labels
#microsoft#microsoft365#teams#graph-api