Skip to main content

Microsoft/teams

@webframp/microsoft/teamsv2026.08.28.1· 14d agoMODELSREPORTS
01README

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

02Release Notes

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

03Models1
@webframp/microsoft/teamsv2026.08.28.1microsoft/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 Versions10
2026.08.26.2

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.24.1

2026.08.24.1

Added: Output metadata attributes for observability.

  • durationMs: Method execution duration in milliseconds.
  • collectedBy: Extension name that produced the data.
  • fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.23.1

2026.08.23.1

Changed: Documentation only — no code changes. Added usage examples for attention with mode=unread_only, list_chats with nameFilter, and chat_messages with since. Added a ## Troubleshooting section covering device-code expiry during bootstrap, invalid_grant as the one recognizable OAuth error code from refreshAccessToken (vs. raw Graph codes otherwise), the two independent sources of a truncated: true flag on channel and chat listings, and Authorization_RequestDenied meaning missing admin consent rather than a stale token.

2026.08.21.2

2026.08.21.2

Changed:

  • list_channels, channel_messages, and chat_messages now reject an empty teamId, channelId, or chatId with a clear validation error before calling the Graph API, instead of sending an empty ID and letting Graph return an opaque 404/400 deep in the call chain.
  • Every Graph API call that lists or fetches teams, channels, chats, and messages (list_teams, list_channels, channel_messages, list_chats, chat_messages, and attention) now reports failures with the operation attempted and the relevant team/channel/chat ID, instead of surfacing only the raw Graph error status/code. The underlying GraphApiError is preserved as the error's cause for callers that need the original status code.
2026.08.21.1

2026.08.21.1

Changed: Added .describe() documentation to every previously undocumented field across all resource schemas (teams, channels, messages, mentions, replies, chats, chat members, viewpoints, and attention items). Tightened tenantId, clientId, and refreshToken in the global arguments to require a non-empty string. No behavioral change — a no-op upgrades entry was added to keep the model's typeVersion tracking in sync with the version bump.

2026.08.20.1

Upgrade note: Bumped zod from 4.3.6 to 4.4.3. No behavioral changes — dependency version alignment only.

2026.08.20.1

2026.08.20.1

Upgrade note: Bumped zod from 4.3.6 to 4.4.3. No behavioral changes — dependency version alignment only.

2026.07.18.2

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.

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
29
Archive size
30.7 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
07Platforms
08Labels