@framers/agentos 0.1.26 → 0.1.28

package/dist/channels/adapters/TeamsChannelAdapter.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @fileoverview Microsoft Teams Channel Adapter for AgentOS.
+ *
+ * Integrates with Microsoft Teams via the Bot Framework SDK
+ * (`botbuilder` / `botframework-connector`). The adapter creates
+ * a Bot Framework connector client and sends proactive messages
+ * and activities to Teams conversations.
+ *
+ * **Dependencies**: Requires `botbuilder` and `botframework-connector`
+ * to be installed.
+ *
+ * The adapter supports:
+ * - Personal (1:1) chat messages
+ * - Group chat messages
+ * - Channel messages (with threading)
+ * - Adaptive Cards (via buttons / rich text)
+ * - File attachments
+ * - Typing indicators
+ * - Reactions
+ * - Mentions
+ *
+ * @example
+ * ```typescript
+ * const teams = new TeamsChannelAdapter();
+ * await teams.initialize({
+ *   platform: 'teams',
+ *   credential: '<app_id>',
+ *   params: {
+ *     appPassword: 'your-app-password',
+ *     tenantId: 'your-tenant-id',         // optional, for single-tenant
+ *     serviceUrl: 'https://smba.trafficmanager.net/teams/',
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/TeamsChannelAdapter
+ */
+import type { ChannelAuthConfig, ChannelCapability, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+/** Platform-specific authentication parameters for Microsoft Teams. */
+export interface TeamsAuthParams extends Record<string, string | undefined> {
+    /** Bot application password (client secret). */
+    appPassword: string;
+    /** Azure AD tenant ID. Optional for multi-tenant bots. */
+    tenantId?: string;
+    /** Bot Framework service URL. Default: 'https://smba.trafficmanager.net/teams/'. */
+    serviceUrl?: string;
+}
+/**
+ * Channel adapter for Microsoft Teams via Bot Framework.
+ *
+ * Uses `botbuilder` and `botframework-connector` via dynamic imports.
+ *
+ * Capabilities: `text`, `rich_text`, `images`, `documents`, `buttons`,
+ * `threads`, `mentions`, `reactions`, `group_chat`, `channels`.
+ *
+ * Conversation ID format:
+ * - Direct: the conversation ID from Teams (opaque string)
+ * - Channel: `<channelId>` with optional `replyToMessageId` for threading
+ */
+export declare class TeamsChannelAdapter extends BaseChannelAdapter<TeamsAuthParams> {
+    readonly platform: ChannelPlatform;
+    readonly displayName = "Microsoft Teams";
+    readonly capabilities: readonly ChannelCapability[];
+    /** Bot Framework connector client. */
+    private connectorClient;
+    /** Bot Framework adapter (for processing incoming activities). */
+    private botAdapter;
+    /** Microsoft App credentials. */
+    private credentials;
+    /** Bot application ID. */
+    private appId;
+    /** Service URL for the Teams tenant. */
+    private serviceUrl;
+    /** Tenant ID (optional). */
+    private tenantId;
+    /** Conversation references for proactive messaging, keyed by conversation ID. */
+    private conversationReferences;
+    protected doConnect(auth: ChannelAuthConfig & {
+        params?: TeamsAuthParams;
+    }): Promise<void>;
+    protected doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    protected doShutdown(): Promise<void>;
+    sendTypingIndicator(conversationId: string, _isTyping: boolean): Promise<void>;
+    editMessage(conversationId: string, messageId: string, content: MessageContent): Promise<void>;
+    deleteMessage(conversationId: string, messageId: string): Promise<void>;
+    /**
+     * Process an incoming Bot Framework request (webhook handler).
+     * Call this from your HTTP endpoint that receives Teams webhook POSTs.
+     *
+     * @param req - HTTP request object.
+     * @param res - HTTP response object.
+     */
+    processIncomingActivity(req: {
+        body: unknown;
+        headers: Record<string, string>;
+    }, res: {
+        status: (code: number) => {
+            send: (body?: unknown) => void;
+        };
+    }): Promise<void>;
+    /**
+     * Store a conversation reference for later proactive messaging.
+     * Typically called when first receiving a message from a conversation.
+     */
+    storeConversationReference(conversationId: string, reference: Record<string, unknown>): void;
+    /**
+     * Create a new conversation with a Teams user (proactive outreach).
+     *
+     * @param userId - The Teams user ID to start a conversation with.
+     * @returns The new conversation ID.
+     */
+    createConversation(userId: string): Promise<string>;
+    /**
+     * Get the Bot Framework adapter for advanced use cases.
+     * Returns undefined if botbuilder is not installed.
+     */
+    getBotAdapter(): any | undefined;
+    private buildActivity;
+    /**
+     * Build an Adaptive Card attachment containing action buttons.
+     */
+    private buildAdaptiveCardWithButtons;
+    /**
+     * Build an Adaptive Card for embed-style content.
+     */
+    private buildAdaptiveCardEmbed;
+    /**
+     * Build an Adaptive Card for poll content.
+     */
+    private buildAdaptiveCardPoll;
+    private sendProactiveMessage;
+    private handleTurnContext;
+    private handleIncomingMessage;
+    private handleReaction;
+    private handleConversationUpdate;
+}
+//# sourceMappingURL=TeamsChannelAdapter.d.ts.map

package/dist/channels/adapters/TeamsChannelAdapter.d.ts.map

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