# @microsoft/agents-hosting-extensions-teams

> DEPRECATED: Use @microsoft/agents-hosting-extensions-msteams instead.

Latest version **1.8.1** (published 2026-08-27) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install @microsoft/agents-hosting-extensions-teams
pnpm add @microsoft/agents-hosting-extensions-teams
yarn add @microsoft/agents-hosting-extensions-teams
bun add @microsoft/agents-hosting-extensions-teams
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.8.1 |
| Published | 2026-08-27 |
| First published | 2025-05-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=20.0.0 |
| Dependencies | 4 |
| Unpacked size | 531 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 88 |
| Author | Microsoft |
| Maintainers | microsoft1es, microsoft-oss-releases |
| Keywords | Agents, deprecated |

## Links

- npm: https://www.npmjs.com/package/@microsoft/agents-hosting-extensions-teams
- Repository: https://github.com/microsoft/Agents-for-js
- Issues: https://github.com/microsoft/Agents-for-js/issues
- npm.io page: https://npm.io/package/@microsoft/agents-hosting-extensions-teams

## Dependencies (4)

- [zod](https://npm.io/package/zod.md) 3.25.75
- [@microsoft/agents-hosting](https://npm.io/package/@microsoft/agents-hosting.md) 1.8.1
- [@microsoft/agents-activity](https://npm.io/package/@microsoft/agents-activity.md) 1.8.1
- [@microsoft/agents-telemetry](https://npm.io/package/@microsoft/agents-telemetry.md) 1.8.1

## Recent versions

- 1.8.1 (latest) — 2026-08-27
- 1.9.0-beta.8.gf58e66b2ee (next) — 2026-09-15
- 1.2.0-alpha.19.g9aeee229e8 (rc) — 2026-01-09
- 1.1.4-g8d884129e7 (preview) — 2025-12-15
- 1.9.0-beta.3.gb2d23c1c44 — 2026-09-03
- 1.9.0-beta.1.gaa38b73718 — 2026-08-28
- 1.8.0-beta.40.g837137bc36 — 2026-08-27
- 1.8.0-beta.36.gb033f0abc1 — 2026-08-26
- 1.8.0-beta.34.g5d543f96c0 — 2026-08-25
- 1.7.0-beta.11.gb5d3e8c751 — 2026-08-12
- 1.7.0-beta.10.g0c6864b626 — 2026-08-08
- 1.7.0-beta.8.gc2b086aef6 — 2026-08-04
- 1.7.2 — 2026-08-03
- 1.7.1 — 2026-07-22
- 1.7.0-beta.5.g67b2005119 — 2026-07-21
- … 100 more at https://npm.io/package/@microsoft/agents-hosting-extensions-teams/versions

## README

# @microsoft/agents-hosting-extensions-teams

Microsoft Teams extension for the Microsoft 365 Agents SDK for JavaScript.

> [!WARNING]
> This package is deprecated and is retained for backward compatibility. For new development, use [`@microsoft/agents-hosting-extensions-msteams`](../agents-hosting-extensions-msteams), which uses the Microsoft Teams SDK models and client.

## Installation

```bash
npm install @microsoft/agents-hosting-extensions-teams
```

## Overview

This package provides Teams-specific functionality for building agents in Microsoft Teams. It includes support for:

- Message handling (edit, delete, undelete)
- Meeting events (start, end, participant join/leave)
- Reactions and screen sharing events
- Message extensions and task modules
- Teams information access

## Usage

### Basic Setup

```typescript
import { AgentApplication, MemoryStorage, TurnContext, TurnState } from '@microsoft/agents-hosting'
import { startServer } from '@microsoft/agents-hosting-express'
import { TeamsAgentExtension } from '@microsoft/agents-hosting-extensions-teams'

// Create the agent application
const app = new AgentApplication<TurnState>({ storage: new MemoryStorage() })

// Create and register the Teams extension
const teamsExt = new TeamsAgentExtension(app)

app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
  // Configure Teams-specific handlers here
  console.log('Teams extension registered')
})

// Handle messages
app.onActivity('message', async (context: TurnContext, state: TurnState) => {
  await context.sendActivity(`I received your message: "${context.activity.text}"`)
})

// Start the server
startServer(app)
```

### Meeting Events

Handle various meeting events in Teams:

```typescript
app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
  tae.meeting
    .onMeetingStart(async (context, state) => {
      await context.sendActivity('Meeting started! I\'m here to assist.')
    })
    .onMeetingEnd(async (context, state) => {
      await context.sendActivity('The meeting has ended. Thanks for participating!')
    })
    .onParticipantsJoin(async (context, state) => {
      await context.sendActivity('Welcome to the meeting!')
    })
    .onScreenShareStart(async (context, state) => {
      await context.sendActivity('Screen sharing has started.')
    })
    .onRecordingStarted(async (context, state) => {
      await context.sendActivity('Recording has started.')
    })
})
```

### Message Handling

Handle message events in Teams:

```typescript
app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
  tae.onMessageEdit(async (context, state) => {
    await context.sendActivity('I noticed you edited your message.')
  })

  tae.onMessageDelete(async (context, state) => {
    await context.sendActivity('I noticed you deleted a message.')
  })

  tae.onMessageUndelete(async (context, state) => {
    await context.sendActivity('I noticed you undeleted a message.')
  })
})
```

### Message Extensions

Work with Teams message extensions:

```typescript
app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
  tae.messageExtension
    .onQuery(async (context, state) => {
      // Handle message extension query
      return {
        composeExtension: {
          type: 'result',
          attachmentLayout: 'list',
          attachments: [
            // Your card attachments here
          ]
        }
      }
    })
    .onSelectItem(async (context, state) => {
      // Handle item selection
    })
})
```

### Task Modules

Handle Teams task modules:

```typescript
app.registerExtension<TeamsAgentExtension>(teamsExt, (tae) => {
  tae.taskModule
    .onFetch(async (context, state) => {
      // Return task module card
    })
    .onSubmit(async (context, state) => {
      // Handle task module submission
    })
})
```

## License

MIT

---
_Source: https://npm.io/package/@microsoft/agents-hosting-extensions-teams · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._