msteams-mcp 0.2.0

package/dist/tools/message-tools.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Messaging-related tool handlers.
+ */
+import { z } from 'zod';
+import type { RegisteredTool } from './index.js';
+export declare const SendMessageInputSchema: z.ZodObject<{
+    content: z.ZodString;
+    conversationId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    replyToMessageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    replyToMessageId?: string | undefined;
+}, {
+    content: string;
+    conversationId?: string | undefined;
+    replyToMessageId?: string | undefined;
+}>;
+export declare const ReplyToThreadInputSchema: z.ZodObject<{
+    content: z.ZodString;
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const FavoriteInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+}, {
+    conversationId: string;
+}>;
+export declare const SaveMessageInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const GetChatInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+}, {
+    userId: string;
+}>;
+export declare const EditMessageInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const DeleteMessageInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const sendMessageTool: RegisteredTool<typeof SendMessageInputSchema>;
+export declare const replyToThreadTool: RegisteredTool<typeof ReplyToThreadInputSchema>;
+export declare const getFavoritesTool: RegisteredTool<z.ZodObject<Record<string, never>>>;
+export declare const addFavoriteTool: RegisteredTool<typeof FavoriteInputSchema>;
+export declare const removeFavoriteTool: RegisteredTool<typeof FavoriteInputSchema>;
+export declare const saveMessageTool: RegisteredTool<typeof SaveMessageInputSchema>;
+export declare const unsaveMessageTool: RegisteredTool<typeof SaveMessageInputSchema>;
+export declare const getChatTool: RegisteredTool<typeof GetChatInputSchema>;
+export declare const editMessageTool: RegisteredTool<typeof EditMessageInputSchema>;
+export declare const deleteMessageTool: RegisteredTool<typeof DeleteMessageInputSchema>;
+/** All message-related tools. */
+export declare const messageTools: (RegisteredTool<z.ZodObject<{
+    content: z.ZodString;
+    conversationId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    replyToMessageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    replyToMessageId?: string | undefined;
+}, {
+    content: string;
+    conversationId?: string | undefined;
+    replyToMessageId?: string | undefined;
+}>> | RegisteredTool<z.ZodObject<{
+    content: z.ZodString;
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}>> | RegisteredTool<z.ZodObject<Record<string, never>, z.UnknownKeysParam, z.ZodTypeAny, {
+    [x: string]: never;
+}, {
+    [x: string]: never;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+}, {
+    conversationId: string;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>> | RegisteredTool<z.ZodObject<{
+    userId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+}, {
+    userId: string;
+}>>)[];

package/dist/tools/message-tools.js

@@ -0,0 +1,433 @@
+/**
+ * Messaging-related tool handlers.
+ */
+import { z } from 'zod';
+import { sendMessage, sendNoteToSelf, replyToThread, saveMessage, unsaveMessage, getOneOnOneChatId, editMessage, deleteMessage, } from '../api/chatsvc-api.js';
+import { getFavorites, addFavorite, removeFavorite } from '../api/csa-api.js';
+import { SELF_CHAT_ID } from '../constants.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Schemas
+// ─────────────────────────────────────────────────────────────────────────────
+export const SendMessageInputSchema = z.object({
+    content: z.string().min(1, 'Message content cannot be empty'),
+    conversationId: z.string().optional().default(SELF_CHAT_ID),
+    replyToMessageId: z.string().optional(),
+});
+export const ReplyToThreadInputSchema = z.object({
+    content: z.string().min(1, 'Reply content cannot be empty'),
+    conversationId: z.string().min(1, 'Conversation ID is required'),
+    messageId: z.string().min(1, 'Message ID is required'),
+});
+export const FavoriteInputSchema = z.object({
+    conversationId: z.string().min(1, 'Conversation ID cannot be empty'),
+});
+export const SaveMessageInputSchema = z.object({
+    conversationId: z.string().min(1, 'Conversation ID cannot be empty'),
+    messageId: z.string().min(1, 'Message ID cannot be empty'),
+});
+export const GetChatInputSchema = z.object({
+    userId: z.string().min(1, 'User ID cannot be empty'),
+});
+export const EditMessageInputSchema = z.object({
+    conversationId: z.string().min(1, 'Conversation ID cannot be empty'),
+    messageId: z.string().min(1, 'Message ID cannot be empty'),
+    content: z.string().min(1, 'Content cannot be empty'),
+});
+export const DeleteMessageInputSchema = z.object({
+    conversationId: z.string().min(1, 'Conversation ID cannot be empty'),
+    messageId: z.string().min(1, 'Message ID cannot be empty'),
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Definitions
+// ─────────────────────────────────────────────────────────────────────────────
+const sendMessageToolDefinition = {
+    name: 'teams_send_message',
+    description: 'Send a message to a Teams conversation. By default, sends to your own notes (self-chat). For channel thread replies, use teams_reply_to_thread instead (simpler). For chats (1:1, group, meeting), just provide the conversationId.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The message content to send. Can include basic HTML formatting.',
+            },
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID to send to. Use "48:notes" for self-chat (default), or a channel/chat conversation ID.',
+            },
+            replyToMessageId: {
+                type: 'string',
+                description: 'For channel thread replies (advanced). Prefer using teams_reply_to_thread instead.',
+            },
+        },
+        required: ['content'],
+    },
+};
+const replyToThreadToolDefinition = {
+    name: 'teams_reply_to_thread',
+    description: 'Reply to a channel message as a threaded reply. Use the conversationId and messageId from search results, or conversationId and threadReplyId from a previous teams_send_message response.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The reply content to send.',
+            },
+            conversationId: {
+                type: 'string',
+                description: 'The channel conversation ID.',
+            },
+            messageId: {
+                type: 'string',
+                description: 'The message ID to reply to. Use messageId from search results, or threadReplyId from a teams_send_message response.',
+            },
+        },
+        required: ['content', 'conversationId', 'messageId'],
+    },
+};
+const getFavoritesToolDefinition = {
+    name: 'teams_get_favorites',
+    description: 'Get the user\'s favourite/pinned conversations in Teams. Returns conversation IDs with display names (channel name, chat topic, or participant names) and type (Channel, Chat, Meeting).',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+    },
+};
+const addFavoriteToolDefinition = {
+    name: 'teams_add_favorite',
+    description: 'Add a conversation to the user\'s favourites/pinned list.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID to pin (e.g., "19:abc@thread.tacv2")',
+            },
+        },
+        required: ['conversationId'],
+    },
+};
+const removeFavoriteToolDefinition = {
+    name: 'teams_remove_favorite',
+    description: 'Remove a conversation from the user\'s favourites/pinned list.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID to unpin',
+            },
+        },
+        required: ['conversationId'],
+    },
+};
+const saveMessageToolDefinition = {
+    name: 'teams_save_message',
+    description: 'Save (bookmark) a message in Teams. Saved messages can be accessed later from the Saved view in Teams.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID containing the message',
+            },
+            messageId: {
+                type: 'string',
+                description: 'The message ID to save (numeric string from search results)',
+            },
+        },
+        required: ['conversationId', 'messageId'],
+    },
+};
+const unsaveMessageToolDefinition = {
+    name: 'teams_unsave_message',
+    description: 'Remove a saved (bookmarked) message in Teams.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID containing the message',
+            },
+            messageId: {
+                type: 'string',
+                description: 'The message ID to unsave',
+            },
+        },
+        required: ['conversationId', 'messageId'],
+    },
+};
+const getChatToolDefinition = {
+    name: 'teams_get_chat',
+    description: 'Get the conversation ID for a 1:1 chat with a person. Use this to start a new chat or find an existing one. The conversation ID can then be used with teams_send_message to send messages.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            userId: {
+                type: 'string',
+                description: 'The user\'s identifier. Can be: MRI (8:orgid:guid), object ID with tenant (guid@tenantId), or raw object ID (guid). Get this from teams_search_people results.',
+            },
+        },
+        required: ['userId'],
+    },
+};
+const editMessageToolDefinition = {
+    name: 'teams_edit_message',
+    description: 'Edit one of your own messages. You can only edit messages you sent. The API will reject attempts to edit other users\' messages.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID containing the message',
+            },
+            messageId: {
+                type: 'string',
+                description: 'The message ID to edit (numeric string from search results or teams_get_thread)',
+            },
+            content: {
+                type: 'string',
+                description: 'The new content for the message. Can include basic HTML formatting.',
+            },
+        },
+        required: ['conversationId', 'messageId', 'content'],
+    },
+};
+const deleteMessageToolDefinition = {
+    name: 'teams_delete_message',
+    description: 'Delete one of your own messages (soft delete). You can only delete messages you sent, unless you are a channel owner/moderator. The API will reject unauthorised attempts.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            conversationId: {
+                type: 'string',
+                description: 'The conversation ID containing the message',
+            },
+            messageId: {
+                type: 'string',
+                description: 'The message ID to delete (numeric string from search results or teams_get_thread)',
+            },
+        },
+        required: ['conversationId', 'messageId'],
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Handlers
+// ─────────────────────────────────────────────────────────────────────────────
+async function handleSendMessage(input, _ctx) {
+    const result = input.conversationId === SELF_CHAT_ID
+        ? await sendNoteToSelf(input.content)
+        : await sendMessage(input.conversationId, input.content, {
+            replyToMessageId: input.replyToMessageId,
+        });
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    // The timestamp is what Teams uses for threading - convert to string for use as threadReplyId
+    const threadReplyId = result.value.timestamp ? String(result.value.timestamp) : undefined;
+    const response = {
+        messageId: result.value.messageId,
+        timestamp: result.value.timestamp,
+        conversationId: input.conversationId,
+    };
+    // Add threadReplyId for channel messages (needed to reply to this message later)
+    if (threadReplyId && input.conversationId.includes('@thread.tacv2')) {
+        response.threadReplyId = threadReplyId;
+        response.note = 'Use threadReplyId (not messageId) if you want to reply to this message later.';
+    }
+    // Include replyToMessageId in response if this was a thread reply
+    if (input.replyToMessageId) {
+        response.replyToMessageId = input.replyToMessageId;
+        response.note = 'Message posted as a reply to the thread.';
+    }
+    return { success: true, data: response };
+}
+async function handleReplyToThread(input, _ctx) {
+    const result = await replyToThread(input.conversationId, input.messageId, input.content);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            messageId: result.value.messageId,
+            timestamp: result.value.timestamp,
+            conversationId: result.value.conversationId,
+            threadRootMessageId: result.value.threadRootMessageId,
+            note: 'Reply posted to thread successfully.',
+        },
+    };
+}
+async function handleGetFavorites(_input, _ctx) {
+    const result = await getFavorites();
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            count: result.value.favorites.length,
+            favorites: result.value.favorites,
+        },
+    };
+}
+async function handleAddFavorite(input, _ctx) {
+    const result = await addFavorite(input.conversationId);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            message: `Added ${input.conversationId} to favourites`,
+        },
+    };
+}
+async function handleRemoveFavorite(input, _ctx) {
+    const result = await removeFavorite(input.conversationId);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            message: `Removed ${input.conversationId} from favourites`,
+        },
+    };
+}
+async function handleSaveMessage(input, _ctx) {
+    const result = await saveMessage(input.conversationId, input.messageId);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            message: 'Message saved',
+            conversationId: input.conversationId,
+            messageId: input.messageId,
+        },
+    };
+}
+async function handleUnsaveMessage(input, _ctx) {
+    const result = await unsaveMessage(input.conversationId, input.messageId);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            message: 'Message unsaved',
+            conversationId: input.conversationId,
+            messageId: input.messageId,
+        },
+    };
+}
+async function handleGetChat(input, _ctx) {
+    const result = getOneOnOneChatId(input.userId);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            conversationId: result.value.conversationId,
+            otherUserId: result.value.otherUserId,
+            currentUserId: result.value.currentUserId,
+            note: 'Use this conversationId with teams_send_message to send a message. The conversation is created automatically when the first message is sent.',
+        },
+    };
+}
+async function handleEditMessage(input, _ctx) {
+    const result = await editMessage(input.conversationId, input.messageId, input.content);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            message: 'Message edited successfully',
+            conversationId: result.value.conversationId,
+            messageId: result.value.messageId,
+        },
+    };
+}
+async function handleDeleteMessage(input, _ctx) {
+    const result = await deleteMessage(input.conversationId, input.messageId);
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return {
+        success: true,
+        data: {
+            message: 'Message deleted successfully',
+            conversationId: result.value.conversationId,
+            messageId: result.value.messageId,
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export const sendMessageTool = {
+    definition: sendMessageToolDefinition,
+    schema: SendMessageInputSchema,
+    handler: handleSendMessage,
+};
+export const replyToThreadTool = {
+    definition: replyToThreadToolDefinition,
+    schema: ReplyToThreadInputSchema,
+    handler: handleReplyToThread,
+};
+export const getFavoritesTool = {
+    definition: getFavoritesToolDefinition,
+    schema: z.object({}),
+    handler: handleGetFavorites,
+};
+export const addFavoriteTool = {
+    definition: addFavoriteToolDefinition,
+    schema: FavoriteInputSchema,
+    handler: handleAddFavorite,
+};
+export const removeFavoriteTool = {
+    definition: removeFavoriteToolDefinition,
+    schema: FavoriteInputSchema,
+    handler: handleRemoveFavorite,
+};
+export const saveMessageTool = {
+    definition: saveMessageToolDefinition,
+    schema: SaveMessageInputSchema,
+    handler: handleSaveMessage,
+};
+export const unsaveMessageTool = {
+    definition: unsaveMessageToolDefinition,
+    schema: SaveMessageInputSchema,
+    handler: handleUnsaveMessage,
+};
+export const getChatTool = {
+    definition: getChatToolDefinition,
+    schema: GetChatInputSchema,
+    handler: handleGetChat,
+};
+export const editMessageTool = {
+    definition: editMessageToolDefinition,
+    schema: EditMessageInputSchema,
+    handler: handleEditMessage,
+};
+export const deleteMessageTool = {
+    definition: deleteMessageToolDefinition,
+    schema: DeleteMessageInputSchema,
+    handler: handleDeleteMessage,
+};
+/** All message-related tools. */
+export const messageTools = [
+    sendMessageTool,
+    replyToThreadTool,
+    getFavoritesTool,
+    addFavoriteTool,
+    removeFavoriteTool,
+    saveMessageTool,
+    unsaveMessageTool,
+    getChatTool,
+    editMessageTool,
+    deleteMessageTool,
+];

package/dist/tools/people-tools.d.ts

@@ -0,0 +1,46 @@
+/**
+ * People-related tool handlers.
+ */
+import { z } from 'zod';
+import type { RegisteredTool } from './index.js';
+export declare const SearchPeopleInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;
+export declare const FrequentContactsInputSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+}, {
+    limit?: number | undefined;
+}>;
+export declare const getMeTool: RegisteredTool<z.ZodObject<Record<string, never>>>;
+export declare const searchPeopleTool: RegisteredTool<typeof SearchPeopleInputSchema>;
+export declare const frequentContactsTool: RegisteredTool<typeof FrequentContactsInputSchema>;
+/** All people-related tools. */
+export declare const peopleTools: (RegisteredTool<z.ZodObject<Record<string, never>, z.UnknownKeysParam, z.ZodTypeAny, {
+    [x: string]: never;
+}, {
+    [x: string]: never;
+}>> | RegisteredTool<z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>> | RegisteredTool<z.ZodObject<{
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+}, {
+    limit?: number | undefined;
+}>>)[];