@hahnfeld/teams-adapter 1.0.9

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenACP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,286 @@
+# @hahnfeld/teams-adapter
+
+Microsoft Teams adapter plugin for [OpenACP](https://github.com/Open-ACP/OpenACP) — Adaptive Cards, slash commands, streaming.
+
+## Features
+
+- **Adaptive Cards** — Rich tool card rendering with progress indicators and action buttons
+- **Slash Commands** — Full command suite: `/new`, `/cancel`, `/agents`, `/menu`, and more
+- **Streaming** — Real-time text updates via Teams message editing
+- **Threads** — Session threads within Teams channels
+- **Permissions** — Allow/Deny/Always Allow via Adaptive Card buttons
+- **Output Modes** — Low/Medium/High detail levels
+- **File Sharing** — Upload and share files via Microsoft Graph / OneDrive
+- **Interactive Install Wizard** — Guided setup with credential validation, auto-discovery, and app package generation
+- **Auto-session Creation** — First message automatically creates a session with the default agent
+
+## Prerequisites
+
+- [OpenACP CLI](https://github.com/Open-ACP/OpenACP) `>= 2026.0.0`
+- Node.js 18+
+- An **Azure Bot registration** with the Microsoft Teams channel enabled
+- A Microsoft 365 tenant with a Teams team and channel (a [Business Basic trial](https://www.microsoft.com/en-us/microsoft-365/business/compare-all-plans) works for testing)
+
+## Installation
+
+### Option A: OpenACP plugin install (recommended)
+
+```bash
+openacp plugin install @hahnfeld/teams-adapter
+```
+
+This launches an interactive wizard that walks you through Azure Bot setup, credential validation, team/channel selection, and generates a Teams app package for sideloading.
+
+### Option B: Manual npm install
+
+```bash
+npm install @hahnfeld/teams-adapter
+# or
+pnpm add @hahnfeld/teams-adapter
+```
+
+## Azure Bot Setup
+
+Before configuring the adapter you need an Azure Bot registration. If you don't have one yet:
+
+1. Go to the [Azure Bot creation page](https://portal.azure.com/#create/Microsoft.AzureBot)
+2. Fill in:
+   - **Bot handle**: any unique name (e.g. `openacp-bot`)
+   - **Pricing tier**: Free (F0) for testing
+   - **App type**: "Single Tenant" for enterprise use
+   - **Creation type**: "Create new Microsoft App ID"
+3. Click **Create** and wait for deployment
+4. Go to the Bot resource > **Settings** > **Configuration**
+   - Copy the **Microsoft App ID** — this is your `botAppId`
+5. Click **Manage Password** > **New client secret**
+   - Copy the secret value immediately (shown only once) — this is your `botAppPassword`
+6. Under **Channels**, add the **Microsoft Teams** channel
+
+For full details see the [Azure Bot Service docs](https://learn.microsoft.com/en-us/azure/bot-service/bot-service-quickstart-registration).
+
+## Configuration
+
+### Interactive wizard
+
+If you installed via `openacp plugin install`, the wizard runs automatically. To re-run it later:
+
+```bash
+openacp plugin configure @hahnfeld/teams-adapter
+```
+
+The wizard guides you through:
+1. Bot credential entry and real-time validation
+2. Tenant type selection (single-tenant enterprise vs. multi-tenant)
+3. Team and channel selection — auto-discovered via Graph API, or paste a Teams channel link
+4. Optional notification channel for session completions and errors
+5. Optional Graph API file sharing (OneDrive)
+6. **Auto-generates a Teams app package** (`openacp-bot.zip`) for sideloading
+
+### Adding the bot to Teams
+
+After the wizard completes, you need to upload the app package to Teams:
+
+1. The wizard generates `openacp-bot.zip` — note the path it prints
+2. Open Microsoft Teams
+3. Go to **Apps** (left sidebar) > **Manage your apps** > **Upload a custom app**
+4. Select the `openacp-bot.zip` file
+5. Click **Add to a team** > select your team > **Set up a bot**
+
+The bot will now appear in your team. You can @mention it in channels or DM it directly.
+
+### Manual configuration
+
+Add the following to your `openacp.yaml`:
+
+```yaml
+channels:
+  teams:
+    enabled: true
+    botAppId: "${TEAMS_BOT_APP_ID}"
+    botAppPassword: "${TEAMS_BOT_APP_PASSWORD}"
+    tenantId: "${TEAMS_TENANT_ID}"
+    teamId: "${TEAMS_TEAM_ID}"
+    channelId: "${TEAMS_CHANNEL_ID}"
+    botPort: 3978                                                # Bot Framework port (default)
+    notificationChannelId: "${TEAMS_NOTIFICATION_CHANNEL_ID}"  # optional
+    assistantThreadId: null  # auto-set after first run
+    graphClientSecret: "${TEAMS_GRAPH_CLIENT_SECRET}"           # optional, for file sharing
+```
+
+### Configuration reference
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `enabled` | `boolean` | Yes | Enable the Teams adapter |
+| `botAppId` | `string` | Yes | Azure AD App ID for the bot |
+| `botAppPassword` | `string` | Yes | Bot client secret |
+| `tenantId` | `string` | Yes | Microsoft tenant ID (GUID), or `botframework.com` for multi-tenant |
+| `teamId` | `string` | Yes | Default team ID (groupId GUID) |
+| `channelId` | `string` | Yes | Primary channel for sessions (e.g. `19:abc@thread.tacv2`) |
+| `botPort` | `number` | No | Bot Framework HTTP server port (default: `3978`) |
+| `notificationChannelId` | `string \| null` | No | Separate channel for notifications |
+| `assistantThreadId` | `string \| null` | No | Thread for the assistant (auto-populated) |
+| `graphClientSecret` | `string` | No | Azure AD client secret for Graph API file sharing |
+
+### Finding your Team and Channel IDs
+
+**From a channel link (easiest):**
+1. Open Microsoft Teams
+2. Right-click the channel name > **Get link to channel**
+3. The link contains `groupId` (Team ID) and the channel path
+
+Both `teams.microsoft.com` and `teams.cloud.microsoft` link formats are supported.
+
+**From the Azure/Graph API:**
+- Team ID = the `groupId` parameter from the Teams URL
+- Channel ID = the encoded string like `19:xxx@thread.tacv2`
+
+### Networking: Bot port vs API port
+
+The Teams adapter runs its **own HTTP server** for Bot Framework webhook traffic. This is separate from the OpenACP API server:
+
+| Server | Default Port | Purpose |
+|--------|-------------|---------|
+| **Bot Framework** (this adapter) | `3978` | Receives messages from Azure Bot Service |
+| **OpenACP API** | `21420` | REST API, SSE, web UI |
+
+**Your tunnel must point to the bot port (3978), not the OpenACP API port.** If you use OpenACP's built-in tunnel, it tunnels the API port — the Teams adapter requests its own separate tunnel on the bot port automatically.
+
+The bot port is configurable via the `botPort` setting (default: `3978`, the Bot Framework standard).
+
+### Messaging endpoint
+
+After installation, set the bot's messaging endpoint in Azure:
+
+1. Azure Portal > Bot resource > **Configuration** > **Messaging endpoint**
+2. Set it to: `https://<your-tunnel-url>/api/messages`
+3. The URL must reach port 3978 (or your configured `botPort`) on the machine running OpenACP
+
+### Tunneling
+
+The adapter automatically requests a tunnel on the bot port at startup if an OpenACP tunnel provider is available. The tunnel URL is logged on boot.
+
+**Recommended: `@hahnfeld/devtunnel-provider`** — a tunnel provider plugin using [Microsoft Dev Tunnels](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started), which aligns with the Microsoft/Azure ecosystem:
+
+```bash
+openacp plugin install @hahnfeld/devtunnel-provider
+```
+
+**Manual tunnel setup** (if not using an OpenACP tunnel provider):
+
+```bash
+# Install Dev Tunnels CLI
+brew install --cask devtunnel   # macOS
+
+# Login and create a persistent tunnel
+devtunnel user login
+devtunnel create --allow-anonymous
+devtunnel port create -p 3978
+
+# Host it (use the same tunnel ID each time for a stable URL)
+devtunnel host <tunnel-id> --allow-anonymous
+```
+
+Set the tunnel URL as the messaging endpoint in Azure: `https://<id>.devtunnels.ms/api/messages`
+
+> **Important:** Always use `--allow-anonymous` — Azure Bot Service cannot authenticate with Dev Tunnel auth.
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/new [agent]` | Create a new agent session |
+| `/newchat` | New chat, same agent & workspace |
+| `/cancel` | Cancel the current session |
+| `/status` | Show session or global status |
+| `/sessions` | List all sessions |
+| `/agents` | List available agents |
+| `/install <name>` | Install an agent by name |
+| `/menu` | Show the action menu |
+| `/help` | Show help |
+| `/outputmode low\|medium\|high` | Set output detail level |
+| `/bypass` | Auto-approve permissions |
+| `/doctor` | Run system diagnostics |
+| `/handoff` | Generate terminal resume command |
+| `/restart` | Restart OpenACP |
+| `/respawn` | Restart the assistant session |
+| `/update` | Update to latest version |
+| `/settings` | Show configuration settings |
+| `/integrate` | Manage agent integrations |
+| `/clear` | Reset the assistant session |
+| `/tts [on\|off]` | Toggle Text to Speech |
+| `/mode` | Switch session mode |
+| `/model` | Switch AI model |
+| `/thought` | Adjust thinking level |
+
+## Uninstalling
+
+```bash
+openacp plugin uninstall @hahnfeld/teams-adapter --purge
+```
+
+The `--purge` flag removes all saved settings. After uninstalling, you may also want to:
+1. Remove the bot from your Teams team
+2. Delete the Azure Bot resource in the Azure Portal
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Watch mode
+pnpm dev
+
+# Run tests
+pnpm test
+```
+
+## Architecture
+
+```
+src/
+├── index.ts             # Plugin entry point & public exports
+├── plugin.ts            # Plugin factory (install wizard, configure, setup/teardown)
+├── adapter.ts           # TeamsAdapter — extends MessagingAdapter
+├── app-package.ts       # Teams app manifest package generator
+├── renderer.ts          # TeamsRenderer (Adaptive Card rendering)
+├── activity.ts          # ActivityTracker (tool card state, streaming)
+├── formatting.ts        # Tool card formatting, usage cards, citations
+├── draft-manager.ts     # Message draft handling
+├── permissions.ts       # PermissionHandler (Adaptive Card buttons)
+├── graph.ts             # GraphFileClient (OneDrive file sharing)
+├── media.ts             # File download/upload utilities
+├── conversation-store.ts # Conversation reference storage
+├── send-utils.ts        # Message sending helpers (Teams SDK compat)
+├── task-modules.ts      # Task module dialogs (new session, settings)
+├── assistant.ts         # Assistant session spawning
+├── validators.ts        # Credential & tenant validation, Teams link parsing
+├── types.ts             # TeamsChannelConfig, TeamsPlatformData
+└── commands/
+    ├── index.ts          # Command router + SLASH_COMMANDS registry
+    ├── new-session.ts    # /new, /newchat
+    ├── session.ts        # /cancel, /status, /sessions, /handoff
+    ├── admin.ts          # /bypass, /tts, /restart, /respawn, /update, /outputmode
+    ├── menu.ts           # /menu, /help, /clear
+    ├── agents.ts         # /agents, /install
+    ├── doctor.ts         # /doctor
+    ├── integrate.ts      # /integrate
+    └── settings.ts       # /settings
+```
+
+## Tech Stack
+
+- [`@microsoft/teams.apps`](https://www.npmjs.com/package/@microsoft/teams.apps) — App class, server hosting, activity routing
+- [`@microsoft/teams.botbuilder`](https://www.npmjs.com/package/@microsoft/teams.botbuilder) — Bot Framework adapter plugin
+- [`@microsoft/agents-hosting`](https://www.npmjs.com/package/@microsoft/agents-hosting) — Express server hosting
+- [`botbuilder`](https://www.npmjs.com/package/botbuilder) — CloudAdapter for single-tenant auth
+- [`botframework-connector`](https://www.npmjs.com/package/botframework-connector) — Credential factory for token validation
+- [`@openacp/plugin-sdk`](https://github.com/Open-ACP/OpenACP) — OpenACP plugin interface
+
+## License
+
+MIT

package/dist/activity.d.ts

@@ -0,0 +1,23 @@
+export { ToolStateMap, ThoughtBuffer, DisplaySpecBuilder } from "@openacp/plugin-sdk";
+export type { OutputMode, ToolDisplaySpec, ToolCardSnapshot, PlanEntry, ToolCallMeta, ViewerLinks, } from "@openacp/plugin-sdk";
+export interface ToolEntry {
+    id: string;
+    name: string;
+    kind: string;
+    rawInput: unknown;
+    content: string | null;
+    status: string;
+    viewerLinks?: {
+        file?: string;
+        diff?: string;
+    };
+    diffStats?: {
+        added: number;
+        removed: number;
+    };
+    displaySummary?: string;
+    displayTitle?: string;
+    displayKind?: string;
+    isNoise: boolean;
+}
+//# sourceMappingURL=activity.d.ts.map

package/dist/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,YAAY,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/activity.js

@@ -0,0 +1,3 @@
+// Re-export activity tracking types from plugin-sdk
+export { ToolStateMap, ThoughtBuffer, DisplaySpecBuilder } from "@openacp/plugin-sdk";
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../src/activity.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/adapter.d.ts

@@ -0,0 +1,174 @@
+import type { TurnContext } from "@microsoft/agents-hosting";
+import type { OutgoingMessage, PermissionRequest, NotificationMessage, OpenACPCore, DisplayVerbosity, AdapterCapabilities, IRenderer } from "@openacp/plugin-sdk";
+import { MessagingAdapter } from "@openacp/plugin-sdk";
+import type { TeamsChannelConfig } from "./types.js";
+export declare class TeamsAdapter extends MessagingAdapter {
+    readonly name = "teams";
+    readonly renderer: IRenderer;
+    readonly capabilities: AdapterCapabilities;
+    readonly core: OpenACPCore;
+    private app;
+    private teamsConfig;
+    private sendQueue;
+    private draftManager;
+    private permissionHandler;
+    private notificationChannelId?;
+    private assistantSession;
+    private assistantInitializing;
+    private fileService;
+    private graphClient?;
+    private conversationStore;
+    /**
+     * Per-session TurnContext references, set during inbound message handling.
+     * Handler overrides read from this map during sendMessage dispatch.
+     */
+    private _sessionContexts;
+    private _sessionOutputModes;
+    /**
+     * Per-session serial dispatch queues — matches Telegram's _dispatchQueues pattern.
+     * SessionBridge fires sendMessage() as fire-and-forget, so multiple events can arrive
+     * concurrently. Without serialization, fast handlers overtake slow ones, causing
+     * out-of-order delivery. This queue ensures events are processed in arrival order.
+     *
+     * Entries are replaced with Promise.resolve() once their chain settles, preventing
+     * unbounded closure growth for long-lived sessions.
+     */
+    private _dispatchQueues;
+    /** Track processed activity IDs to handle Teams 15-second retry deduplication */
+    private _processedActivities;
+    private _processedCleanupTimer?;
+    /** Messages buffered during assistant initialization — replayed once ready. Capped to prevent unbounded growth. */
+    private static readonly MAX_INIT_BUFFER;
+    private _assistantInitBuffer;
+    /** Bot token cache for proactive messaging via connector REST API */
+    private _botTokenCache?;
+    constructor(core: OpenACPCore, config: TeamsChannelConfig);
+    private _started;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private setupMessageHandler;
+    /**
+     * Handle Action.Submit payloads from Adaptive Cards.
+     *
+     * Action.Submit (v1.2 compatible) sends the card's data directly as
+     * activity.value with no text. This handles permission responses, command
+     * buttons, and output mode changes — all of which embed a `verb` field.
+     */
+    private handleSubmitAction;
+    /**
+     * Shared card action dispatch — handles verbs from both Action.Submit and
+     * Action.Execute (invoke) paths. Eliminates duplication between
+     * handleSubmitAction and cardActionHandler.
+     */
+    private dispatchCardVerb;
+    /**
+     * Handle message reactions (like, heart, laugh, surprised, sad, angry).
+     *
+     * Teams sends messageReaction activities when users react to bot messages.
+     * We log them as engagement signals and emit an event so plugins can act
+     * on them (e.g., aggregate feedback, adjust behavior).
+     */
+    private setupReactionHandler;
+    /**
+     * Create a session in the background — sends status updates to the conversation.
+     * Runs async without blocking the invoke response.
+     */
+    private createSessionInBackground;
+    /**
+     * Handle form submissions from inline wizard cards (dialogAction payloads).
+     * These come from Action.Execute buttons on cards rendered directly in chat.
+     */
+    private handleDialogAction;
+    private setupCardActionHandler;
+    private cardActionHandler;
+    private getCommandRegistry;
+    handleCommand(text: string, context: TurnContext, sessionId: string | null, userId: string): Promise<void>;
+    private renderCommandResponse;
+    private setupAssistant;
+    respawnAssistant(): Promise<void>;
+    restartAssistant(): Promise<void>;
+    /** Send a typing indicator to the user. Non-critical — failures are silently ignored. */
+    private sendTyping;
+    /**
+     * Acquire a bot framework token for proactive messaging via the MSA/AAD endpoint.
+     * Required when posting to the Bot Connector REST API outside of a turn context.
+     */
+    private acquireBotToken;
+    /**
+     * Validate that a serviceUrl is a trusted Bot Framework endpoint.
+     * Prevents SSRF where a spoofed serviceUrl could redirect bot tokens.
+     *
+     * @see https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-connector-api-reference
+     */
+    private static readonly TRUSTED_SERVICE_URL_PATTERNS;
+    static isValidServiceUrl(url: string): boolean;
+    /** AI-generated content entity — attached to all outbound messages for the Teams "AI generated" badge */
+    private static readonly AI_ENTITY;
+    /**
+     * Send a Teams activity with exponential backoff retry on transient failures.
+     * Handles HTTP 429 (rate limited), 502, 504 per Microsoft best practices.
+     */
+    private sendActivityWithRetry;
+    private resolveMode;
+    /**
+     * Primary outbound dispatch — routes agent messages to Teams.
+     *
+     * Wraps the base class `sendMessage` in a per-session promise chain (_dispatchQueues)
+     * so concurrent events fired from SessionBridge are serialized and delivered in order,
+     * preventing fast handlers from overtaking slower ones (matches Telegram pattern).
+     *
+     * Context is NOT deleted after dispatch — it persists from the inbound message handler
+     * and is available for the entire session lifetime, avoiding the race condition where
+     * async handlers lose their context mid-execution.
+     */
+    sendMessage(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleThought(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
+    protected handleText(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleToolCall(sessionId: string, content: OutgoingMessage, verbosity: DisplayVerbosity): Promise<void>;
+    protected handleToolUpdate(sessionId: string, content: OutgoingMessage, verbosity: DisplayVerbosity): Promise<void>;
+    protected handlePlan(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
+    protected handleUsage(sessionId: string, content: OutgoingMessage, _verbosity: DisplayVerbosity): Promise<void>;
+    /** Suggested quick-reply actions (Teams restricts these to 1:1 personal chat only) */
+    private static readonly QUICK_ACTIONS;
+    /** Return QUICK_ACTIONS only if the conversation is 1:1 personal chat (Teams requirement) */
+    private getQuickActions;
+    /**
+     * Clean up all per-session state (contexts, drafts, dispatch queues, output modes).
+     * Removes both sessionId and threadId entries from _sessionContexts to prevent leaks.
+     */
+    private cleanupSessionState;
+    protected handleSessionEnd(sessionId: string, _content: OutgoingMessage): Promise<void>;
+    protected handleError(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleAttachment(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleSystem(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleModeChange(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleConfigUpdate(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleModelUpdate(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleUserReplay(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleResource(sessionId: string, content: OutgoingMessage): Promise<void>;
+    protected handleResourceLink(sessionId: string, content: OutgoingMessage): Promise<void>;
+    sendPermissionRequest(sessionId: string, request: PermissionRequest): Promise<void>;
+    sendNotification(notification: NotificationMessage): Promise<void>;
+    /**
+     * Create a new conversation thread for a session.
+     *
+     * Attempts to create a real Teams channel conversation via the Bot Framework
+     * connector API. If that fails (e.g., missing permissions, no stored conversation
+     * reference), falls back to using the existing conversation ID as thread context.
+     */
+    createSessionThread(sessionId: string, name: string): Promise<string>;
+    /**
+     * Rename a session thread. This is a no-op for Teams — the Teams API does not
+     * support renaming channel conversations. Renaming a group chat requires
+     * Graph API with Chat.ReadWrite.All permission, which most bot registrations
+     * don't have. The new name is stored in the session record for display purposes.
+     */
+    renameSessionThread(sessionId: string, newName: string): Promise<void>;
+    deleteSessionThread(sessionId: string): Promise<void>;
+    getChannelId(): string;
+    getTeamId(): string;
+    getAssistantSessionId(): string | null;
+    getAssistantThreadId(): string | null;
+    setSessionOutputMode(sessionId: string, mode: "low" | "medium" | "high"): void;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}