feat(list-conversations): paginate and find conversations by participant

package.json

@@ -49,7 +49,7 @@
         "prepublishOnly": "npm run build && npm test"
     },
     "dependencies": {
-        "@doist/comms-sdk": "0.9.0",
+        "@doist/comms-sdk": "1.0.1",
         "dotenv": "17.4.2",
         "p-limit": "6.2.0",
         "zod": "4.1.13"

src/mcp-server.ts

@@ -38,7 +38,7 @@ You have access to comprehensive Comms management tools for team communication a
 
 - **fetch-inbox**: Use to fetch inbox threads for a workspace, along with unread conversations and counts. Supports archiveFilter values of active, archived, or all; use all when the user needs both open and done threads. Optionally set onlyUnread to focus on unread items.
 - **list-channels**: Use to discover channels in a workspace. Requires a workspace ID. Optionally set includeArchived to true to also list archived channels. Returns channel names, IDs, descriptions, visibility, archive status, and URLs.
-- **list-conversations**: Use to discover conversations (direct messages) in a workspace. Requires a workspace ID. Optionally set includeArchived to true to also list archived conversations. Returns conversation IDs, titles, a partial list of participant user IDs and names, archive status, last-active timestamps, snippets, and URLs.
+- **list-conversations**: Use to discover conversations (direct messages) in a workspace, or to find one by who is in it. Requires a workspace ID. To find a specific conversation, pass userIds (excluding yourself) — by default that returns the single conversation whose participants are exactly you plus those users, which is how you locate a particular direct or group DM; an empty array finds the conversation containing only you. Set matchMode to "includes" instead to list every conversation those users appear in. Prefer this over listing and scanning yourself: filtered lookups page through the whole workspace internally and answer in one call. Without userIds, returns a page of conversations — pass the returned cursor to fetch the next page, and limit to size it. Keep fetching until a page comes back empty; a short page does not mean the end of the list. Optionally set includeArchived to true to also list archived conversations. Returns conversation IDs, titles, a partial list of participant user IDs and names, archive status, last-active timestamps, snippets, and URLs. To send a message you do not need this tool: create-conversation resolves the right conversation from its recipients on its own.
 - **get-groups**: Use to discover group IDs in a workspace before notifying groups from tools that support group notifications. Requires a workspace ID. Optionally filter by group IDs or search text. Returns group IDs, names, and member counts (descriptions are never returned). Set includeMembers to true to also get each member's user ID, name, and email — use that to answer "who is in this group?" or to expand a group into individual recipients; leave it off when you only need IDs, since member lists make the response much longer.
 - **create-channel**: Use to create a channel in a workspace. Pass workspaceId, name, and optional description or public; omitting public creates a private channel. Pass numeric userIds to add initial members.
 - **update-channel**: Use to rename a channel or update its description/visibility. Pass channelId and at least one of name, description, or public. Pass description: null to clear the description.