msteams-mcp 0.19.0 → 0.19.2

package/dist/api/chatsvc-activity.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Chat Service API - Activity feed operations.
+ *
+ * Fetches the user's activity feed (mentions, reactions, replies, notifications).
+ */
+import { type Result } from '../types/result.js';
+import { type ExtractedLink } from '../utils/parsers.js';
+/** Type of activity item. */
+export type ActivityType = 'mention' | 'reaction' | 'reply' | 'message' | 'unknown';
+/** An activity item from the notifications feed. */
+export interface ActivityItem {
+    /** Activity/message ID. */
+    id: string;
+    /** Type of activity (mention, reaction, reply, etc.). */
+    type: ActivityType;
+    /** Activity content (HTML stripped). */
+    content: string;
+    /** Raw content type from API. */
+    contentType: string;
+    /** Sender information. */
+    sender: {
+        mri: string;
+        displayName?: string;
+    };
+    /** When the activity occurred. */
+    timestamp: string;
+    /** The source conversation ID (where the activity happened). */
+    conversationId?: string;
+    /** The conversation/thread topic name. */
+    topic?: string;
+    /** Direct link to the activity in Teams. */
+    activityLink?: string;
+    /** Links extracted from content. */
+    links?: ExtractedLink[];
+}
+/** Result of fetching the activity feed. */
+export interface GetActivityResult {
+    /** Activity items (newest first). */
+    activities: ActivityItem[];
+    /** Sync state for incremental polling. */
+    syncState?: string;
+}
+/**
+ * Gets the activity feed (notifications) for the current user.
+ * Includes mentions, reactions, replies, and other notifications.
+ */
+export declare function getActivityFeed(options?: {
+    limit?: number;
+}): Promise<Result<GetActivityResult>>;

package/dist/api/chatsvc-activity.js

@@ -0,0 +1,138 @@
+/**
+ * Chat Service API - Activity feed operations.
+ *
+ * Fetches the user's activity feed (mentions, reactions, replies, notifications).
+ */
+import { httpRequest } from '../utils/http.js';
+import { CHATSVC_API, getSkypeAuthHeaders } from '../utils/api-config.js';
+import { ok } from '../types/result.js';
+import { requireMessageAuthWithConfig, getTeamsBaseUrl, getTenantId } from '../utils/auth-guards.js';
+import { stripHtml, extractLinks, buildMessageLink, extractActivityTimestamp } from '../utils/parsers.js';
+import { DEFAULT_ACTIVITY_LIMIT, VIRTUAL_CONVERSATION_PREFIX } from '../constants.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Determines the activity type from message content and properties.
+ */
+function detectActivityType(msg) {
+    const content = msg.content || '';
+    const messageType = msg.messagetype || '';
+    // Check for @mention
+    if (content.includes('itemtype="http://schema.skype.com/Mention"') ||
+        content.includes('itemscope itemtype="http://schema.skype.com/Mention"')) {
+        return 'mention';
+    }
+    // Check for reaction-related message types
+    if (messageType.toLowerCase().includes('reaction')) {
+        return 'reaction';
+    }
+    // Check for thread/reply indicators
+    if (msg.threadtopic || msg.parentMessageId) {
+        return 'reply';
+    }
+    // Standard message
+    if (messageType.includes('RichText') || messageType.includes('Text')) {
+        return 'message';
+    }
+    return 'unknown';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// API Functions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Gets the activity feed (notifications) for the current user.
+ * Includes mentions, reactions, replies, and other notifications.
+ */
+export async function getActivityFeed(options = {}) {
+    const authResult = requireMessageAuthWithConfig();
+    if (!authResult.ok) {
+        return authResult;
+    }
+    const { auth, region, baseUrl } = authResult.value;
+    const limit = options.limit ?? DEFAULT_ACTIVITY_LIMIT;
+    let url = CHATSVC_API.activityFeed(region, baseUrl);
+    url += `?view=msnp24Equivalent&pageSize=${limit}`;
+    const response = await httpRequest(url, {
+        method: 'GET',
+        headers: getSkypeAuthHeaders(auth.skypeToken, auth.authToken, baseUrl),
+    });
+    if (!response.ok) {
+        return response;
+    }
+    const rawMessages = response.value.data.messages;
+    const syncState = response.value.data.syncState;
+    if (!Array.isArray(rawMessages)) {
+        return ok({
+            activities: [],
+            syncState,
+        });
+    }
+    const activities = [];
+    for (const raw of rawMessages) {
+        const msg = raw;
+        // Skip control/system messages that aren't relevant
+        const messageType = msg.messagetype;
+        if (!messageType ||
+            messageType.startsWith('Control/') ||
+            messageType === 'ThreadActivity/AddMember' ||
+            messageType === 'ThreadActivity/DeleteMember') {
+            continue;
+        }
+        const id = msg.id || msg.originalarrivaltime;
+        if (!id)
+            continue;
+        const content = msg.content || '';
+        const contentType = msg.messagetype || 'Text';
+        const fromMri = msg.from || '';
+        const displayName = msg.imdisplayname || msg.displayName;
+        // Safely extract timestamp - returns null if no valid timestamp found
+        const timestamp = extractActivityTimestamp(msg);
+        if (!timestamp)
+            continue;
+        // Get source conversation - prefer clumpId (actual source) over conversationid
+        // Some activity items have conversationid as "48:notifications" (the virtual conversation)
+        // which doesn't work for deep links. clumpId contains the real source conversation.
+        const rawConversationId = msg.conversationid || msg.conversationId;
+        const clumpId = msg.clumpId;
+        // Use clumpId if conversationid is a virtual conversation (48:xxx format)
+        const isVirtualConversation = rawConversationId?.startsWith(VIRTUAL_CONVERSATION_PREFIX);
+        const conversationId = (isVirtualConversation && clumpId) ? clumpId : rawConversationId;
+        const topic = msg.threadtopic || msg.topic;
+        // Build activity link if we have a valid source conversation context
+        // Skip virtual conversations (48:xxx) as they don't produce working deep links
+        let activityLink;
+        if (conversationId && !conversationId.startsWith(VIRTUAL_CONVERSATION_PREFIX) && /^\d+$/.test(id)) {
+            activityLink = buildMessageLink({
+                conversationId,
+                messageId: id,
+                tenantId: getTenantId() ?? undefined,
+                teamsBaseUrl: getTeamsBaseUrl(),
+            });
+        }
+        const activityType = detectActivityType(msg);
+        // Extract links before stripping HTML
+        const links = extractLinks(content);
+        activities.push({
+            id,
+            type: activityType,
+            content: stripHtml(content),
+            contentType,
+            sender: {
+                mri: fromMri,
+                displayName,
+            },
+            timestamp,
+            conversationId,
+            topic,
+            activityLink,
+            links: links.length > 0 ? links : undefined,
+        });
+    }
+    // Sort by timestamp (newest first for activity feed)
+    activities.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    return ok({
+        activities,
+        syncState,
+    });
+}

package/dist/api/chatsvc-api.d.ts

@@ -3,350 +3,18 @@
  *
  * Handles all calls to teams.microsoft.com/api/chatsvc endpoints.
  * Base URL is extracted from session config to support different Teams environments.
- */
-import { type Result } from '../types/result.js';
-import { type ExtractedLink } from '../utils/parsers.js';
-/** Result of sending a message. */
-export interface SendMessageResult {
-    messageId: string;
-    timestamp?: number;
-}
-/** A message from a thread/conversation. */
-export interface ThreadMessage {
-    id: string;
-    content: string;
-    contentType: string;
-    sender: {
-        mri: string;
-        displayName?: string;
-    };
-    timestamp: string;
-    /** Human-readable date with day of week, e.g., "Friday, January 30, 2026, 10:45 AM UTC" */
-    when?: string;
-    conversationId: string;
-    clientMessageId?: string;
-    isFromMe?: boolean;
-    messageLink?: string;
-    links?: ExtractedLink[];
-    /** For channel messages: the ID of the thread root post (if this is a reply within a thread) */
-    threadRootId?: string;
-    /** True if this message is a reply within a channel thread (not a top-level post) */
-    isThreadReply?: boolean;
-}
-/** Result of getting thread messages. */
-export interface GetThreadResult {
-    conversationId: string;
-    messages: ThreadMessage[];
-}
-/** Result of saving/unsaving a message. */
-export interface SaveMessageResult {
-    conversationId: string;
-    messageId: string;
-    saved: boolean;
-}
-/** A saved message from the virtual 48:saved conversation. */
-export interface SavedMessage {
-    id: string;
-    content: string;
-    contentType: string;
-    sender: {
-        mri: string;
-        displayName?: string;
-    };
-    timestamp: string;
-    /** The original conversation where this message lives. */
-    sourceConversationId: string;
-    /** The original message ID in the source conversation. */
-    sourceMessageId?: string;
-    messageLink?: string;
-    links?: ExtractedLink[];
-}
-/** Result of getting saved messages. */
-export interface GetSavedMessagesResult {
-    messages: SavedMessage[];
-}
-/** A followed thread from the virtual 48:threads conversation. */
-export interface FollowedThread {
-    id: string;
-    content: string;
-    contentType: string;
-    sender: {
-        mri: string;
-        displayName?: string;
-    };
-    timestamp: string;
-    /** The original conversation/thread where this post lives. */
-    sourceConversationId: string;
-    /** The original post ID in the source conversation. */
-    sourcePostId?: string;
-    messageLink?: string;
-    links?: ExtractedLink[];
-}
-/** Result of getting followed threads. */
-export interface GetFollowedThreadsResult {
-    threads: FollowedThread[];
-}
-/** Options for sending a message. */
-export interface SendMessageOptions {
-    /**
-     * Message ID of the thread root to reply to.
-     *
-     * When provided, the message is posted as a reply to an existing thread
-     * in a channel. The conversationId should be the channel ID, and this
-     * should be the ID of the first message in the thread.
-     *
-     * For chats (1:1, group, meeting), this is not needed - all messages
-     * are part of the same flat conversation.
-     */
-    replyToMessageId?: string;
-}
-/**
- * Sends a message to a Teams conversation.
- *
- * For channels, you can either:
- * - Post a new top-level message: just provide the channel's conversationId
- * - Reply to a thread: provide the channel's conversationId AND replyToMessageId
- *
- * For chats (1:1, group, meeting), all messages go to the same conversation
- * without threading - just provide the conversationId.
- */
-export declare function sendMessage(conversationId: string, content: string, options?: SendMessageOptions): Promise<Result<SendMessageResult>>;
-/**
- * Sends a message to your own notes/self-chat.
- */
-export declare function sendNoteToSelf(content: string): Promise<Result<SendMessageResult>>;
-/**
- * Gets messages from a Teams conversation/thread.
  *
- * @param conversationId - The conversation ID to fetch messages from
- * @param options.limit - Maximum messages to return (default 50)
- * @param options.startTime - Fetch messages from this timestamp onwards
- * @param options.order - Sort order: 'desc' (newest-first, default) or 'asc' (oldest-first)
- */
-export declare function getThreadMessages(conversationId: string, options?: {
-    limit?: number;
-    startTime?: number;
-    order?: 'asc' | 'desc';
-}): Promise<Result<GetThreadResult>>;
-/**
- * Gets saved (bookmarked) messages from the virtual 48:saved conversation.
- * Returns messages the user has bookmarked across all conversations.
- */
-export declare function getSavedMessages(options?: {
-    limit?: number;
-}): Promise<Result<GetSavedMessagesResult>>;
-/**
- * Gets followed threads from the virtual 48:threads conversation.
- * Returns threads the user is following for updates.
- */
-export declare function getFollowedThreads(options?: {
-    limit?: number;
-}): Promise<Result<GetFollowedThreadsResult>>;
-/**
- * Saves (bookmarks) a message.
- *
- * @param rootMessageId - For channel threaded replies, the ID of the thread root post.
- *                        For top-level posts and non-channel messages, omit or pass undefined.
- */
-export declare function saveMessage(conversationId: string, messageId: string, rootMessageId?: string): Promise<Result<SaveMessageResult>>;
-/**
- * Unsaves (removes bookmark from) a message.
- *
- * @param rootMessageId - For channel threaded replies, the ID of the thread root post.
- *                        For top-level posts and non-channel messages, omit or pass undefined.
- */
-export declare function unsaveMessage(conversationId: string, messageId: string, rootMessageId?: string): Promise<Result<SaveMessageResult>>;
-/** Result of editing a message. */
-export interface EditMessageResult {
-    messageId: string;
-    conversationId: string;
-}
-/** Result of deleting a message. */
-export interface DeleteMessageResult {
-    messageId: string;
-    conversationId: string;
-}
-/**
- * Edits an existing message.
- *
- * Note: You can only edit your own messages. The API will reject
- * attempts to edit messages from other users.
- *
- * @param conversationId - The conversation containing the message
- * @param messageId - The ID of the message to edit
- * @param newContent - The new content for the message
- */
-export declare function editMessage(conversationId: string, messageId: string, newContent: string): Promise<Result<EditMessageResult>>;
-/**
- * Deletes a message (soft delete).
- *
- * Note: You can only delete your own messages, unless you are a
- * channel owner/moderator. The API will reject unauthorised attempts.
- *
- * @param conversationId - The conversation containing the message
- * @param messageId - The ID of the message to delete
- */
-export declare function deleteMessage(conversationId: string, messageId: string): Promise<Result<DeleteMessageResult>>;
-/**
- * Gets properties for a single conversation.
- */
-export declare function getConversationProperties(conversationId: string): Promise<Result<{
-    displayName?: string;
-    conversationType?: string;
-}>>;
-/**
- * Extracts unique participant names from recent messages.
- */
-export declare function extractParticipantNames(conversationId: string): Promise<Result<string | undefined>>;
-/** Result of getting a 1:1 conversation. */
-export interface GetOneOnOneChatResult {
-    conversationId: string;
-    otherUserId: string;
-    currentUserId: string;
-}
-/**
- * Gets the conversation ID for a 1:1 chat with another user.
- *
- * Constructs the predictable format: `19:{id1}_{id2}@unq.gbl.spaces`
- * where IDs are sorted lexicographically. The conversation is created
- * implicitly when the first message is sent.
- */
-export declare function getOneOnOneChatId(otherUserIdentifier: string): Result<GetOneOnOneChatResult>;
-/** Result of creating a group chat. */
-export interface CreateGroupChatResult {
-    /** The newly created conversation ID. */
-    conversationId: string;
-    /** The member MRIs included in the chat. */
-    members: string[];
-    /** Optional topic/name set for the chat. */
-    topic?: string;
-    /** Optional note about the result, e.g. if the ID could not be retrieved. */
-    note?: string;
-}
-/**
- * Creates a new group chat with multiple members.
- *
- * Unlike 1:1 chats which have a predictable ID format, group chats require
- * an API call to create. The conversation ID is returned by the server.
- *
- * @param memberIdentifiers - Array of user identifiers (MRI, object ID, or GUID)
- * @param topic - Optional chat topic/name
- * @param region - API region (default: 'amer')
- *
- * @example
- * ```typescript
- * // Create a group chat with 2 other people
- * const result = await createGroupChat(
- *   ['8:orgid:abc123...', '8:orgid:def456...'],
- *   'Project Discussion'
- * );
- * if (result.ok) {
- *   console.log('Created chat:', result.value.conversationId);
- * }
- * ```
- */
-export declare function createGroupChat(memberIdentifiers: string[], topic?: string): Promise<Result<CreateGroupChatResult>>;
-/** Consumption horizon information for a conversation. */
-export interface ConsumptionHorizonInfo {
-    /** The conversation/thread ID. */
-    conversationId: string;
-    /** The version timestamp of the consumption horizon. */
-    version?: string;
-    /** The last read message ID (timestamp). */
-    lastReadMessageId?: string;
-    /** The last read timestamp. */
-    lastReadTimestamp?: number;
-    /** Raw consumption horizons array from API. */
-    consumptionHorizons: Array<{
-        id: string;
-        consumptionHorizon: string;
-    }>;
-}
-/** Result of marking a conversation as read. */
-export interface MarkAsReadResult {
-    conversationId: string;
-    markedUpTo: string;
-}
-/**
- * Gets the consumption horizon (read receipts) for a conversation.
- * The consumption horizon indicates where each user has read up to.
- */
-export declare function getConsumptionHorizon(conversationId: string): Promise<Result<ConsumptionHorizonInfo>>;
-/**
- * Marks a conversation as read up to a specific message.
- */
-export declare function markAsRead(conversationId: string, messageId: string): Promise<Result<MarkAsReadResult>>;
-/**
- * Gets unread count for a conversation by comparing consumption horizon
- * with recent messages.
- */
-export declare function getUnreadStatus(conversationId: string): Promise<Result<{
-    conversationId: string;
-    unreadCount: number;
-    lastReadMessageId?: string;
-    latestMessageId?: string;
-}>>;
-/** Type of activity item. */
-export type ActivityType = 'mention' | 'reaction' | 'reply' | 'message' | 'unknown';
-/** An activity item from the notifications feed. */
-export interface ActivityItem {
-    /** Activity/message ID. */
-    id: string;
-    /** Type of activity (mention, reaction, reply, etc.). */
-    type: ActivityType;
-    /** Activity content (HTML stripped). */
-    content: string;
-    /** Raw content type from API. */
-    contentType: string;
-    /** Sender information. */
-    sender: {
-        mri: string;
-        displayName?: string;
-    };
-    /** When the activity occurred. */
-    timestamp: string;
-    /** The source conversation ID (where the activity happened). */
-    conversationId?: string;
-    /** The conversation/thread topic name. */
-    topic?: string;
-    /** Direct link to the activity in Teams. */
-    activityLink?: string;
-    /** Links extracted from content. */
-    links?: ExtractedLink[];
-}
-/** Result of fetching the activity feed. */
-export interface GetActivityResult {
-    /** Activity items (newest first). */
-    activities: ActivityItem[];
-    /** Sync state for incremental polling. */
-    syncState?: string;
-}
-/**
- * Gets the activity feed (notifications) for the current user.
- * Includes mentions, reactions, replies, and other notifications.
- */
-export declare function getActivityFeed(options?: {
-    limit?: number;
-}): Promise<Result<GetActivityResult>>;
-/** Result of adding/removing a reaction. */
-export interface ReactionResult {
-    conversationId: string;
-    messageId: string;
-    emoji: string;
-}
-/**
- * Adds a reaction (emoji) to a message.
- *
- * @param conversationId - The conversation containing the message
- * @param messageId - The message ID to react to
- * @param emojiKey - The emoji key (e.g., 'like', 'heart', 'laugh')
- */
-export declare function addReaction(conversationId: string, messageId: string, emojiKey: string): Promise<Result<ReactionResult>>;
-/**
- * Removes a reaction (emoji) from a message.
- *
- * @param conversationId - The conversation containing the message
- * @param messageId - The message ID to remove the reaction from
- * @param emojiKey - The emoji key to remove (e.g., 'like', 'heart')
- */
-export declare function removeReaction(conversationId: string, messageId: string, emojiKey: string): Promise<Result<ReactionResult>>;
+ * This barrel file re-exports from focused sub-modules:
+ * - chatsvc-messaging: send, edit, delete, thread messages, 1:1/group chat
+ * - chatsvc-activity: activity feed (mentions, reactions, replies)
+ * - chatsvc-reactions: add/remove emoji reactions
+ * - chatsvc-virtual: saved messages, followed threads, save/unsave
+ * - chatsvc-readstatus: consumption horizons, mark as read, unread counts
+ * - chatsvc-common: shared utilities (date formatting)
+ */
+export * from './chatsvc-messaging.js';
+export * from './chatsvc-activity.js';
+export * from './chatsvc-reactions.js';
+export * from './chatsvc-virtual.js';
+export * from './chatsvc-readstatus.js';
+export * from './chatsvc-common.js';