msteams-mcp 0.2.0 → 0.3.0

package/README.md

@@ -66,6 +66,7 @@ Then configure:
 | `teams_search` | Search messages with operators (`from:`, `sent:`, `in:`, `hasattachment:`, etc.) |
 | `teams_get_thread` | Get messages from a conversation/thread |
 | `teams_find_channel` | Find channels by name (your teams + org-wide discovery) |
+| `teams_get_activity` | Get activity feed (mentions, reactions, replies, notifications) |
 
 ### Messaging
 
@@ -94,6 +95,8 @@ Then configure:
 | `teams_remove_favorite` | Unpin a conversation |
 | `teams_save_message` | Bookmark a message |
 | `teams_unsave_message` | Remove bookmark from a message |
+| `teams_get_unread` | Get unread counts (aggregate or per-conversation) |
+| `teams_mark_read` | Mark a conversation as read up to a message |
 
 ### Session
 
@@ -166,6 +169,8 @@ npm run test:mcp -- search "your query"
 npm run test:mcp -- status
 npm run test:mcp -- people "john smith"
 npm run test:mcp -- favorites
+npm run test:mcp -- activity              # Get activity feed
+npm run test:mcp -- unread                # Check unread counts
 ```
 
 ## Limitations

package/dist/__fixtures__/api-responses.d.ts

@@ -14,7 +14,7 @@ export declare const searchResultItem: {
     HitHighlightedSummary: string;
     Summary: string;
     Source: {
-        ReceivedTime: string;
+        DateTimeReceived: string;
         From: {
             EmailAddress: {
                 Name: string;
@@ -37,7 +37,7 @@ export declare const searchResultWithHtml: {
     ReferenceId: string;
     HitHighlightedSummary: string;
     Source: {
-        ReceivedTime: string;
+        DateTimeReceived: string;
         From: string;
         ClientThreadId: string;
     };
@@ -69,7 +69,7 @@ export declare const searchEntitySetsResponse: {
                 HitHighlightedSummary: string;
                 Summary: string;
                 Source: {
-                    ReceivedTime: string;
+                    DateTimeReceived: string;
                     From: {
                         EmailAddress: {
                             Name: string;
@@ -88,7 +88,7 @@ export declare const searchEntitySetsResponse: {
                 ReferenceId: string;
                 HitHighlightedSummary: string;
                 Source: {
-                    ReceivedTime: string;
+                    DateTimeReceived: string;
                     From: string;
                     ClientThreadId: string;
                 };
@@ -183,14 +183,14 @@ export declare const jwtPayloadSpaceName: {
  */
 export declare const sourceWithMessageId: {
     MessageId: string;
-    ReceivedTime: string;
+    DateTimeReceived: string;
     ClientConversationId: string;
 };
 /**
  * Message source with ID in ClientConversationId.
  */
 export declare const sourceWithConvIdMessageId: {
-    ReceivedTime: string;
+    DateTimeReceived: string;
     ClientConversationId: string;
 };
 /**

package/dist/__fixtures__/api-responses.js

@@ -14,7 +14,7 @@ export const searchResultItem = {
     HitHighlightedSummary: 'Let me check the <c0>budget</c0> report for Q3',
     Summary: 'Let me check the budget report for Q3',
     Source: {
-        ReceivedTime: '2026-01-20T14:30:00.000Z',
+        DateTimeReceived: '2026-01-20T14:30:00.000Z',
         From: {
             EmailAddress: {
                 Name: 'Smith, John',
@@ -37,7 +37,7 @@ export const searchResultWithHtml = {
     ReferenceId: 'xyz789.1000.1',
     HitHighlightedSummary: '<p>Meeting <strong>notes</strong> from &amp; yesterday&apos;s call</p><br/><div>Action items:</div>',
     Source: {
-        ReceivedTime: '2026-01-21T09:00:00.000Z',
+        DateTimeReceived: '2026-01-21T09:00:00.000Z',
         From: 'Jane Doe',
         ClientThreadId: '19:meeting123@thread.v2',
     },
@@ -163,14 +163,14 @@ export const jwtPayloadSpaceName = {
  */
 export const sourceWithMessageId = {
     MessageId: '1705760000000',
-    ReceivedTime: '2026-01-20T12:00:00.000Z',
+    DateTimeReceived: '2026-01-20T12:00:00.000Z',
     ClientConversationId: '19:thread@tacv2',
 };
 /**
  * Message source with ID in ClientConversationId.
  */
 export const sourceWithConvIdMessageId = {
-    ReceivedTime: '2026-01-20T12:00:00.000Z',
+    DateTimeReceived: '2026-01-20T12:00:00.000Z',
     ClientConversationId: '19:thread@tacv2;messageid=1705770000000',
 };
 /**

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

@@ -76,18 +76,8 @@ export interface ReplyToThreadResult extends SendMessageResult {
 /**
  * Replies to a thread in a Teams channel.
  *
- * Uses the provided messageId directly as the thread root. In Teams channels:
- * - If messageId is a top-level post, the reply goes under that post
- * - If messageId is already a reply within a thread, the reply goes to the same thread
- *
- * For channel messages from search results, the messageId is typically the thread root
- * (the original message that started the thread).
- *
- * @param conversationId - The channel conversation ID (from search results)
- * @param messageId - The message ID to reply to (typically the thread root from search)
- * @param content - The reply content
- * @param region - API region (default: 'amer')
- * @returns The result including the new message ID
+ * Uses the provided messageId as the thread root. For search results,
+ * this is typically the original message that started the thread.
  */
 export declare function replyToThread(conversationId: string, messageId: string, content: string, region?: string): Promise<Result<ReplyToThreadResult>>;
 /**
@@ -158,14 +148,88 @@ export interface GetOneOnOneChatResult {
 /**
  * Gets the conversation ID for a 1:1 chat with another user.
  *
- * This constructs the predictable conversation ID format used by Teams
- * for 1:1 chats. The conversation ID is: `19:{id1}_{id2}@unq.gbl.spaces`
- * where id1 and id2 are the two users' object IDs sorted lexicographically.
- *
- * Note: This doesn't create the conversation - it just returns the ID.
- * The conversation is implicitly created when the first message is sent.
- *
- * @param otherUserIdentifier - The other user's MRI, object ID, or ID with tenant
- * @returns The conversation ID, or an error if auth is missing or ID is invalid
+ * 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>;
+/** 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, region?: string): Promise<Result<ConsumptionHorizonInfo>>;
+/**
+ * Marks a conversation as read up to a specific message.
+ */
+export declare function markAsRead(conversationId: string, messageId: string, region?: string): Promise<Result<MarkAsReadResult>>;
+/**
+ * Gets unread count for a conversation by comparing consumption horizon
+ * with recent messages.
+ */
+export declare function getUnreadStatus(conversationId: string, region?: 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;
+}
+/** 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;
+}, region?: string): Promise<Result<GetActivityResult>>;

package/dist/api/chatsvc-api.js

@@ -9,7 +9,8 @@ import { ErrorCode, createError } from '../types/errors.js';
 import { ok, err } from '../types/result.js';
 import { getUserDisplayName } from '../auth/token-extractor.js';
 import { requireMessageAuth } from '../utils/auth-guards.js';
-import { stripHtml, buildMessageLink, buildOneOnOneConversationId, extractObjectId } from '../utils/parsers.js';
+import { stripHtml, buildMessageLink, buildOneOnOneConversationId, extractObjectId, extractActivityTimestamp } from '../utils/parsers.js';
+import { DEFAULT_ACTIVITY_LIMIT } from '../constants.js';
 /**
  * Sends a message to a Teams conversation.
  *
@@ -63,24 +64,11 @@ export async function sendNoteToSelf(content) {
 /**
  * Replies to a thread in a Teams channel.
  *
- * Uses the provided messageId directly as the thread root. In Teams channels:
- * - If messageId is a top-level post, the reply goes under that post
- * - If messageId is already a reply within a thread, the reply goes to the same thread
- *
- * For channel messages from search results, the messageId is typically the thread root
- * (the original message that started the thread).
- *
- * @param conversationId - The channel conversation ID (from search results)
- * @param messageId - The message ID to reply to (typically the thread root from search)
- * @param content - The reply content
- * @param region - API region (default: 'amer')
- * @returns The result including the new message ID
+ * Uses the provided messageId as the thread root. For search results,
+ * this is typically the original message that started the thread.
  */
 export async function replyToThread(conversationId, messageId, content, region = 'amer') {
-    // Use the provided messageId directly as the thread root
-    // Search results return the thread root ID for channel messages
     const threadRootMessageId = messageId;
-    // Send the reply using the provided message ID as the thread root
     const sendResult = await sendMessage(conversationId, content, {
         region,
         replyToMessageId: threadRootMessageId,
@@ -420,15 +408,9 @@ function escapeHtml(text) {
 /**
  * Gets the conversation ID for a 1:1 chat with another user.
  *
- * This constructs the predictable conversation ID format used by Teams
- * for 1:1 chats. The conversation ID is: `19:{id1}_{id2}@unq.gbl.spaces`
- * where id1 and id2 are the two users' object IDs sorted lexicographically.
- *
- * Note: This doesn't create the conversation - it just returns the ID.
- * The conversation is implicitly created when the first message is sent.
- *
- * @param otherUserIdentifier - The other user's MRI, object ID, or ID with tenant
- * @returns The conversation ID, or an error if auth is missing or ID is invalid
+ * 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 function getOneOnOneChatId(otherUserIdentifier) {
     const authResult = requireMessageAuth();
@@ -457,3 +439,227 @@ export function getOneOnOneChatId(otherUserIdentifier) {
         currentUserId,
     });
 }
+/**
+ * Gets the consumption horizon (read receipts) for a conversation.
+ * The consumption horizon indicates where each user has read up to.
+ */
+export async function getConsumptionHorizon(conversationId, region = 'amer') {
+    const authResult = requireMessageAuth();
+    if (!authResult.ok) {
+        return authResult;
+    }
+    const auth = authResult.value;
+    const validRegion = validateRegion(region);
+    const url = CHATSVC_API.consumptionHorizons(validRegion, conversationId);
+    const response = await httpRequest(url, {
+        method: 'GET',
+        headers: getSkypeAuthHeaders(auth.skypeToken, auth.authToken),
+    });
+    if (!response.ok) {
+        return response;
+    }
+    const data = response.value.data;
+    const horizons = data.consumptionhorizons || [];
+    // Find the current user's consumption horizon
+    let lastReadMessageId;
+    let lastReadTimestamp;
+    for (const h of horizons) {
+        if (h.id === auth.userMri || h.id.includes(auth.userMri)) {
+            // Consumption horizon format: "{timestamp};{timestamp};{messageId}"
+            const parts = h.consumptionhorizon.split(';');
+            if (parts.length >= 3) {
+                lastReadMessageId = parts[2];
+                lastReadTimestamp = parseInt(parts[0], 10);
+            }
+            break;
+        }
+    }
+    return ok({
+        conversationId,
+        version: data.version,
+        lastReadMessageId,
+        lastReadTimestamp,
+        consumptionHorizons: horizons.map(h => ({
+            id: h.id,
+            consumptionHorizon: h.consumptionhorizon,
+        })),
+    });
+}
+/**
+ * Marks a conversation as read up to a specific message.
+ */
+export async function markAsRead(conversationId, messageId, region = 'amer') {
+    const authResult = requireMessageAuth();
+    if (!authResult.ok) {
+        return authResult;
+    }
+    const auth = authResult.value;
+    const validRegion = validateRegion(region);
+    const url = CHATSVC_API.updateConsumptionHorizon(validRegion, conversationId);
+    // Format: "{messageId};{messageId};{messageId}" - all three values are the same
+    const consumptionHorizon = `${messageId};${messageId};${messageId}`;
+    const response = await httpRequest(url, {
+        method: 'PUT',
+        headers: getSkypeAuthHeaders(auth.skypeToken, auth.authToken),
+        body: JSON.stringify({
+            consumptionhorizon: consumptionHorizon,
+        }),
+    });
+    if (!response.ok) {
+        return response;
+    }
+    return ok({
+        conversationId,
+        markedUpTo: messageId,
+    });
+}
+/**
+ * Gets unread count for a conversation by comparing consumption horizon
+ * with recent messages.
+ */
+export async function getUnreadStatus(conversationId, region = 'amer') {
+    // Get consumption horizon
+    const horizonResult = await getConsumptionHorizon(conversationId, region);
+    if (!horizonResult.ok) {
+        return horizonResult;
+    }
+    // Get recent messages
+    const messagesResult = await getThreadMessages(conversationId, { limit: 50 }, region);
+    if (!messagesResult.ok) {
+        return messagesResult;
+    }
+    const lastReadId = horizonResult.value.lastReadMessageId;
+    const messages = messagesResult.value.messages;
+    // Count messages after the last read position
+    let unreadCount = 0;
+    let foundLastRead = false;
+    let latestMessageId;
+    // Messages are sorted oldest-first, so reverse to process newest-first
+    const reversedMessages = [...messages].reverse();
+    for (const msg of reversedMessages) {
+        if (!latestMessageId && !msg.isFromMe) {
+            latestMessageId = msg.id;
+        }
+        if (lastReadId && msg.id === lastReadId) {
+            foundLastRead = true;
+            break;
+        }
+        // Count messages not from the current user
+        if (!msg.isFromMe) {
+            unreadCount++;
+        }
+    }
+    // If last read message wasn't in our window, count is a lower bound
+    return ok({
+        conversationId,
+        unreadCount,
+        lastReadMessageId: lastReadId,
+        latestMessageId,
+    });
+}
+/**
+ * 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';
+}
+/**
+ * Gets the activity feed (notifications) for the current user.
+ * Includes mentions, reactions, replies, and other notifications.
+ */
+export async function getActivityFeed(options = {}, region = 'amer') {
+    const authResult = requireMessageAuth();
+    if (!authResult.ok) {
+        return authResult;
+    }
+    const auth = authResult.value;
+    const validRegion = validateRegion(region);
+    const limit = options.limit ?? DEFAULT_ACTIVITY_LIMIT;
+    let url = CHATSVC_API.activityFeed(validRegion);
+    url += `?view=msnp24Equivalent&pageSize=${limit}`;
+    const response = await httpRequest(url, {
+        method: 'GET',
+        headers: getSkypeAuthHeaders(auth.skypeToken, auth.authToken),
+    });
+    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;
+        const conversationId = msg.conversationid || msg.conversationId;
+        const topic = msg.threadtopic || msg.topic;
+        // Build activity link if we have the conversation context
+        let activityLink;
+        if (conversationId && /^\d+$/.test(id)) {
+            activityLink = buildMessageLink(conversationId, id);
+        }
+        const activityType = detectActivityType(msg);
+        activities.push({
+            id,
+            type: activityType,
+            content: stripHtml(content),
+            contentType,
+            sender: {
+                mri: fromMri,
+                displayName,
+            },
+            timestamp,
+            conversationId,
+            topic,
+            activityLink,
+        });
+    }
+    // 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/auth/index.d.ts

@@ -3,4 +3,5 @@
  */
 export * from './session-store.js';
 export * from './token-extractor.js';
+export * from './token-refresh.js';
 export { encrypt, decrypt, isEncrypted, type EncryptedData } from './crypto.js';

package/dist/auth/index.js

@@ -3,4 +3,5 @@
  */
 export * from './session-store.js';
 export * from './token-extractor.js';
+export * from './token-refresh.js';
 export { encrypt, decrypt, isEncrypted } from './crypto.js';