agor-live 0.21.2 → 0.22.0

package/dist/core/gateway/connectors/teams.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Microsoft Teams Connector
+ *
+ * Sends messages via Bot Framework SDK and listens for inbound messages
+ * via an HTTP webhook endpoint.
+ *
+ * Config shape (stored encrypted in gateway_channels.config):
+ *   {
+ *     app_id: string,              // Azure Bot Registration App ID
+ *     app_password: string,        // Azure Bot Registration App Secret
+ *     tenant_id?: string,          // Single-tenant restriction (optional)
+ *     webhook_port?: number,       // Port for Bot Framework endpoint (default: 3978)
+ *     webhook_path?: string,       // Webhook path (default: /api/messages)
+ *     require_mention?: boolean,   // Require @mention in channels (default: true)
+ *     allow_thread_replies_without_mention?: boolean, // Allow thread replies without @mention (default: true)
+ *   }
+ *
+ * Thread ID format: "{conversationId}|{activityId}"
+ *   e.g. "19:abc123@thread.tacv2|1234567890"
+ *
+ * Uses last-pipe split because conversationId can contain colons and other special chars.
+ */
+import type { ChannelType } from '../../types/gateway';
+import type { GatewayConnector, InboundMessage } from '../connector';
+/**
+ * Parse a composite thread ID into conversationId + activityId.
+ *
+ * Format: "{conversationId}|{activityId}" — uses last pipe as delimiter
+ * because conversationId can contain special characters.
+ *
+ * e.g. "19:abc123@thread.tacv2|1234567890" →
+ *   { conversationId: "19:abc123@thread.tacv2", activityId: "1234567890" }
+ */
+export declare function parseThreadId(threadId: string): {
+    conversationId: string;
+    activityId: string;
+};
+/**
+ * Strip `<at>BotName</at>` mention tags from Teams message text.
+ *
+ * Teams wraps @mentions in `<at>...</at>` tags. This removes them
+ * (case-insensitive) and cleans up surrounding whitespace.
+ */
+export declare function stripMention(text: string, botName: string): string;
+/**
+ * Extract the actual user text from a Teams quoted-reply message.
+ *
+ * When a user replies to a specific message in a 1:1 (personal) chat, Teams
+ * prepends the quoted message content to `activity.text` (making it garbled),
+ * but provides the structured data in an HTML attachment like:
+ *
+ * ```html
+ * <blockquote itemtype="http://schema.skype.com/Reply" ...>
+ *   ...quoted message preview...
+ * </blockquote>
+ * <p>actual user message</p>
+ * ```
+ *
+ * This function checks for that pattern and returns only the user's text.
+ * Returns null if no quoted-reply attachment is found.
+ */
+export declare function extractQuotedReplyText(attachments: Array<{
+    contentType?: string;
+    content?: string;
+}> | undefined): string | null;
+export declare class TeamsConnector implements GatewayConnector {
+    readonly channelType: ChannelType;
+    private adapter;
+    private config;
+    private server;
+    /** Stored ConversationReferences for proactive messaging, keyed by threadId */
+    private conversationRefs;
+    constructor(config: Record<string, unknown>);
+    /**
+     * Send a message to a Teams thread using a stored ConversationReference.
+     *
+     * Uses the proactive messaging pattern: look up the stored reference
+     * from the inbound turn, then use adapter.continueConversation() to
+     * send a message outside of a turn.
+     */
+    sendMessage(req: {
+        threadId: string;
+        text: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<string>;
+    /**
+     * Start listening for inbound messages via an HTTP webhook.
+     *
+     * Creates a lightweight HTTP server that receives Bot Framework activities
+     * from Azure Bot Service, processes them, and calls the gateway callback.
+     */
+    startListening(callback: (msg: InboundMessage) => void): Promise<void>;
+    /**
+     * Stop the HTTP webhook server
+     */
+    stopListening(): Promise<void>;
+    /**
+     * Convert markdown to Teams-compatible format.
+     *
+     * Teams natively supports most markdown (bold, italic, code blocks, links, lists).
+     * Main adjustments:
+     * - Collapse <details>/<summary> blocks (not supported in Teams)
+     * - Strip unsupported HTML tags
+     */
+    formatMessage(markdown: string): string;
+}
+//# sourceMappingURL=teams.d.ts.map

package/dist/core/gateway/connectors/teams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.d.ts","sourceRoot":"","sources":["../../../src/gateway/connectors/teams.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAYrE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAkBA;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKlE;AAsBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,GACzE,MAAM,GAAG,IAAI,CAiBf;AAmCD,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAW;IAE5C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAuB;IAErC,+EAA+E;IAC/E,OAAO,CAAC,gBAAgB,CAAqD;gBAEjE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiB3C;;;;;;OAMG;IACG,WAAW,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnB;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqO5E;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAYpC;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAkBxC"}

package/dist/core/gateway/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/gateway/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAWD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CA4ChE"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/gateway/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CA4ChE"}