@beeper/desktop-mcp 4.2.3 → 4.7.0

package/src/tools/accounts/get-accounts.ts

@@ -1,34 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'accounts',
-  operation: 'read',
-  tags: ['accounts'],
-  httpMethod: 'get',
-  httpPath: '/v1/accounts',
-  operationId: 'getAccounts',
-};
-
-export const tool: Tool = {
-  name: 'get_accounts',
-  description: 'List connected accounts on this device.',
-  inputSchema: {
-    type: 'object',
-    properties: {},
-    required: [],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  return asTextContentResult(await client.accounts.list());
-};
-
-export default { metadata, tool, handler };

package/src/tools/chats/archive-chat.ts

@@ -1,43 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'chats',
-  operation: 'write',
-  tags: ['chats'],
-  httpMethod: 'post',
-  httpPath: '/v1/chats/{chatID}/archive',
-  operationId: 'archiveChat',
-};
-
-export const tool: Tool = {
-  name: 'archive_chat',
-  description: 'Archive or unarchive a chat.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      chatID: {
-        type: 'string',
-        description: 'Unique identifier of the chat.',
-      },
-      archived: {
-        type: 'boolean',
-        description: 'True to archive, false to unarchive',
-      },
-    },
-    required: ['chatID'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const { chatID, ...body } = args as any;
-  const response = await client.chats.archive(chatID, body).asResponse();
-  return asTextContentResult(await response.text());
-};
-
-export default { metadata, tool, handler };

package/src/tools/chats/get-chat.ts

@@ -1,45 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'chats',
-  operation: 'read',
-  tags: ['chats'],
-  httpMethod: 'get',
-  httpPath: '/v1/chats/{chatID}',
-  operationId: 'getChat',
-};
-
-export const tool: Tool = {
-  name: 'get_chat',
-  description: 'Get chat details: metadata, participants (limited), last activity.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      chatID: {
-        type: 'string',
-        description: 'Unique identifier of the chat.',
-      },
-      maxParticipantCount: {
-        type: 'integer',
-        description:
-          'Maximum number of participants to return. Use -1 for all; otherwise 0–500. Defaults to all (-1).',
-      },
-    },
-    required: ['chatID'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const { chatID, ...body } = args as any;
-  return asTextContentResult(await client.chats.retrieve(chatID, body));
-};
-
-export default { metadata, tool, handler };

package/src/tools/chats/reminders/clear-chat-reminder.ts

@@ -1,41 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'chats.reminders',
-  operation: 'write',
-  tags: ['chats'],
-  httpMethod: 'delete',
-  httpPath: '/v1/chats/{chatID}/reminders',
-  operationId: 'clearChatReminder',
-};
-
-export const tool: Tool = {
-  name: 'clear_chat_reminder',
-  description: 'Clear a chat reminder.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      chatID: {
-        type: 'string',
-        description: 'Unique identifier of the chat.',
-      },
-    },
-    required: ['chatID'],
-  },
-  annotations: {
-    idempotentHint: true,
-  },
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const { chatID, ...body } = args as any;
-  const response = await client.chats.reminders.delete(chatID).asResponse();
-  return asTextContentResult(await response.text());
-};
-
-export default { metadata, tool, handler };

package/src/tools/chats/reminders/set-chat-reminder.ts

@@ -1,54 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'chats.reminders',
-  operation: 'write',
-  tags: ['chats'],
-  httpMethod: 'post',
-  httpPath: '/v1/chats/{chatID}/reminders',
-  operationId: 'setChatReminder',
-};
-
-export const tool: Tool = {
-  name: 'set_chat_reminder',
-  description: 'Set a reminder for a chat at a specific time.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      chatID: {
-        type: 'string',
-        description: 'Unique identifier of the chat.',
-      },
-      reminder: {
-        type: 'object',
-        description: 'Reminder configuration',
-        properties: {
-          remindAtMs: {
-            type: 'number',
-            description: 'Unix timestamp in milliseconds when reminder should trigger',
-          },
-          dismissOnIncomingMessage: {
-            type: 'boolean',
-            description: 'Cancel reminder if someone messages in the chat',
-          },
-        },
-        required: ['remindAtMs'],
-      },
-    },
-    required: ['chatID', 'reminder'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const { chatID, ...body } = args as any;
-  const response = await client.chats.reminders.create(chatID, body).asResponse();
-  return asTextContentResult(await response.text());
-};
-
-export default { metadata, tool, handler };

package/src/tools/chats/search-chats.ts

@@ -1,104 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'chats',
-  operation: 'read',
-  tags: ['chats'],
-  httpMethod: 'get',
-  httpPath: '/v1/chats/search',
-  operationId: 'searchChats',
-};
-
-export const tool: Tool = {
-  name: 'search_chats',
-  description:
-    "Search chats by title/network or participants using Beeper Desktop's renderer algorithm. Optional 'scope'.",
-  inputSchema: {
-    type: 'object',
-    properties: {
-      accountIDs: {
-        type: 'array',
-        description: 'Provide an array of account IDs to filter chats from specific messaging accounts only',
-        items: {
-          type: 'string',
-          description: 'Account ID this resource belongs to.',
-        },
-      },
-      cursor: {
-        type: 'string',
-        description: "Opaque pagination cursor; do not inspect. Use together with 'direction'.",
-      },
-      direction: {
-        type: 'string',
-        description:
-          "Pagination direction used with 'cursor': 'before' fetches older results, 'after' fetches newer results. Defaults to 'before' when only 'cursor' is provided.",
-        enum: ['after', 'before'],
-      },
-      inbox: {
-        type: 'string',
-        description:
-          'Filter by inbox type: "primary" (non-archived, non-low-priority), "low-priority", or "archive". If not specified, shows all chats.',
-        enum: ['primary', 'low-priority', 'archive'],
-      },
-      includeMuted: {
-        type: 'boolean',
-        description:
-          'Include chats marked as Muted by the user, which are usually less important. Default: true. Set to false if the user wants a more refined search.',
-      },
-      lastActivityAfter: {
-        type: 'string',
-        description:
-          'Provide an ISO datetime string to only retrieve chats with last activity after this time',
-        format: 'date-time',
-      },
-      lastActivityBefore: {
-        type: 'string',
-        description:
-          'Provide an ISO datetime string to only retrieve chats with last activity before this time',
-        format: 'date-time',
-      },
-      limit: {
-        type: 'integer',
-        description: 'Set the maximum number of chats to retrieve. Valid range: 1-200, default is 50',
-      },
-      query: {
-        type: 'string',
-        description:
-          'Literal token search (non-semantic). Use single words users type (e.g., "dinner"). When multiple words provided, ALL must match. Case-insensitive.',
-      },
-      scope: {
-        type: 'string',
-        description:
-          "Search scope: 'titles' matches title + network; 'participants' matches participant names.",
-        enum: ['titles', 'participants'],
-      },
-      type: {
-        type: 'string',
-        description:
-          'Specify the type of chats to retrieve: use "single" for direct messages, "group" for group chats, or "any" to get all types',
-        enum: ['single', 'group', 'any'],
-      },
-      unreadOnly: {
-        type: 'boolean',
-        description: 'Set to true to only retrieve chats that have unread messages',
-      },
-    },
-    required: [],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  const response = await client.chats.search(body).asResponse();
-  return asTextContentResult(await response.json());
-};
-
-export default { metadata, tool, handler };

package/src/tools/index.ts

@@ -1,92 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, Endpoint, HandlerFunction } from './types';
-
-export { Metadata, Endpoint, HandlerFunction };
-
-import focus_app from './top-level/focus-app';
-import search from './top-level/search';
-import get_accounts from './accounts/get-accounts';
-import get_chat from './chats/get-chat';
-import archive_chat from './chats/archive-chat';
-import search_chats from './chats/search-chats';
-import set_chat_reminder from './chats/reminders/set-chat-reminder';
-import clear_chat_reminder from './chats/reminders/clear-chat-reminder';
-import list_messages from './messages/list-messages';
-import search_messages from './messages/search-messages';
-import send_message from './messages/send-message';
-import { mapEndpoint } from '../handlers';
-
-export const endpoints: Endpoint[] = [];
-
-function addEndpoint(endpoint: Endpoint) {
-  endpoints.push(mapEndpoint(endpoint));
-}
-
-addEndpoint(focus_app);
-addEndpoint(search);
-addEndpoint(get_accounts);
-addEndpoint(get_chat);
-addEndpoint(archive_chat);
-addEndpoint(search_chats);
-addEndpoint(set_chat_reminder);
-addEndpoint(clear_chat_reminder);
-addEndpoint(list_messages);
-addEndpoint(search_messages);
-addEndpoint(send_message);
-
-export type Filter = {
-  type: 'resource' | 'operation' | 'tag' | 'tool';
-  op: 'include' | 'exclude';
-  value: string;
-};
-
-export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
-  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
-  const unmatchedFilters = new Set(filters);
-
-  const filtered = endpoints.filter((endpoint: Endpoint) => {
-    let included = false || allExcludes;
-
-    for (const filter of filters) {
-      if (match(filter, endpoint)) {
-        unmatchedFilters.delete(filter);
-        included = filter.op === 'include';
-      }
-    }
-
-    return included;
-  });
-
-  // Check if any filters didn't match
-  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
-  if (unmatched.length > 0) {
-    throw new Error(
-      `The following filters did not match any endpoints: ${unmatched
-        .map((f) => `${f.type}=${f.value}`)
-        .join(', ')}`,
-    );
-  }
-
-  return filtered;
-}
-
-function match({ type, value }: Filter, endpoint: Endpoint): boolean {
-  switch (type) {
-    case 'resource': {
-      const regexStr = '^' + normalizeResource(value).replace(/\*/g, '.*') + '$';
-      const regex = new RegExp(regexStr);
-      return regex.test(normalizeResource(endpoint.metadata.resource));
-    }
-    case 'operation':
-      return endpoint.metadata.operation === value;
-    case 'tag':
-      return endpoint.metadata.tags.includes(value);
-    case 'tool':
-      return endpoint.tool.name === value;
-  }
-}
-
-function normalizeResource(resource: string): string {
-  return resource.toLowerCase().replace(/[^a-z.*\-_]*/g, '');
-}

package/src/tools/messages/list-messages.ts

@@ -1,51 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'messages',
-  operation: 'read',
-  tags: ['messages'],
-  httpMethod: 'get',
-  httpPath: '/v1/chats/{chatID}/messages',
-  operationId: 'listMessages',
-};
-
-export const tool: Tool = {
-  name: 'list_messages',
-  description: 'List messages from a specific chat with pagination support.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      chatID: {
-        type: 'string',
-        description: 'Unique identifier of the chat.',
-      },
-      cursor: {
-        type: 'string',
-        description: "Opaque pagination cursor; do not inspect. Use together with 'direction'.",
-      },
-      direction: {
-        type: 'string',
-        description:
-          "Pagination direction used with 'cursor': 'before' fetches older results, 'after' fetches newer results. Defaults to 'before' when only 'cursor' is provided.",
-        enum: ['after', 'before'],
-      },
-    },
-    required: ['chatID'],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const { chatID, ...body } = args as any;
-  const response = await client.messages.list(chatID, body).asResponse();
-  return asTextContentResult(await response.json());
-};
-
-export default { metadata, tool, handler };

package/src/tools/messages/search-messages.ts

@@ -1,123 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'messages',
-  operation: 'read',
-  tags: ['messages'],
-  httpMethod: 'get',
-  httpPath: '/v1/messages/search',
-  operationId: 'searchMessages',
-};
-
-export const tool: Tool = {
-  name: 'search_messages',
-  description:
-    'Search messages across chats using Beeper\'s message index.\n- When to use: find messages by text and/or filters (chatIDs, accountIDs, chatType, media type filters, sender, date ranges).\n- CRITICAL: Query is LITERAL WORD MATCHING, NOT semantic search! Only finds messages containing these EXACT words.\n  • ✅ RIGHT: query="dinner" or query="sick" or query="error" (single words users type)\n  • ❌ WRONG: query="dinner plans tonight" or query="health issues" (phrases/concepts)\n  • The query matches ALL words provided (in any order). Example: query="flight booking" finds messages with both "flight" AND "booking".\n- Performance: provide chatIDs/accountIDs when known. Omitted \'query\' returns results based on filters only. Partial matches enabled; \'excludeLowPriority\' defaults to true.\n- Workflow tip: To search messages in specific conversations: 1) Use find-chats to get chatIDs, 2) Use search-messages with those chatIDs.\n- IMPORTANT: Chat names vary widely. ASK the user for clarification:\n  • "Which chat do you mean by family?" (could be "The Smiths", "Mom Dad Kids", etc.)\n  • "What\'s the name of your work chat?" (could be "Team", company name, project name)\n  • "Who are the participants?" (use scope="participants" in search-chats)\nReturns: matching messages and referenced chats.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      accountIDs: {
-        type: 'array',
-        description: 'Limit search to specific account IDs.',
-        items: {
-          type: 'string',
-          description: 'Account ID this resource belongs to.',
-        },
-      },
-      chatIDs: {
-        type: 'array',
-        description: 'Limit search to specific chat IDs.',
-        items: {
-          type: 'string',
-        },
-      },
-      chatType: {
-        type: 'string',
-        description: "Filter by chat type: 'group' for group chats, 'single' for 1:1 chats.",
-        enum: ['group', 'single'],
-      },
-      cursor: {
-        type: 'string',
-        description: "Opaque pagination cursor; do not inspect. Use together with 'direction'.",
-      },
-      dateAfter: {
-        type: 'string',
-        description:
-          "Only include messages with timestamp strictly after this ISO 8601 datetime (e.g., '2024-07-01T00:00:00Z' or '2024-07-01T00:00:00+02:00').",
-        format: 'date-time',
-      },
-      dateBefore: {
-        type: 'string',
-        description:
-          "Only include messages with timestamp strictly before this ISO 8601 datetime (e.g., '2024-07-31T23:59:59Z' or '2024-07-31T23:59:59+02:00').",
-        format: 'date-time',
-      },
-      direction: {
-        type: 'string',
-        description:
-          "Pagination direction used with 'cursor': 'before' fetches older results, 'after' fetches newer results. Defaults to 'before' when only 'cursor' is provided.",
-        enum: ['after', 'before'],
-      },
-      excludeLowPriority: {
-        type: 'boolean',
-        description:
-          'Exclude messages marked Low Priority by the user. Default: true. Set to false to include all.',
-      },
-      includeMuted: {
-        type: 'boolean',
-        description:
-          'Include messages in chats marked as Muted by the user, which are usually less important. Default: true. Set to false if the user wants a more refined search.',
-      },
-      limit: {
-        type: 'integer',
-        description: 'Maximum number of messages to return.',
-      },
-      mediaTypes: {
-        type: 'array',
-        description:
-          "Filter messages by media types. Use ['any'] for any media type, or specify exact types like ['video', 'image']. Omit for no media filtering.",
-        items: {
-          type: 'string',
-          enum: ['any', 'video', 'image', 'link', 'file'],
-        },
-      },
-      query: {
-        type: 'string',
-        description:
-          'Literal word search (NOT semantic). Finds messages containing these EXACT words in any order. Use single words users actually type, not concepts or phrases. Example: use "dinner" not "dinner plans", use "sick" not "health issues". If omitted, returns results filtered only by other parameters.',
-      },
-      sender: {
-        anyOf: [
-          {
-            type: 'string',
-            description:
-              "Filter by sender: 'me' (messages sent by the authenticated user), 'others' (messages sent by others), or a specific user ID string (user.id).",
-            enum: ['me', 'others'],
-          },
-          {
-            type: 'string',
-          },
-        ],
-        description:
-          "Filter by sender: 'me' (messages sent by the authenticated user), 'others' (messages sent by others), or a specific user ID string (user.id).",
-      },
-    },
-    required: [],
-  },
-  annotations: {
-    readOnlyHint: true,
-  },
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const body = args as any;
-  const response = await client.messages.search(body).asResponse();
-  return asTextContentResult(await response.json());
-};
-
-export default { metadata, tool, handler };

package/src/tools/messages/send-message.ts

@@ -1,47 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { Metadata, asTextContentResult } from '@beeper/desktop-mcp/tools/types';
-
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import BeeperDesktop from '@beeper/desktop-api';
-
-export const metadata: Metadata = {
-  resource: 'messages',
-  operation: 'write',
-  tags: ['messages'],
-  httpMethod: 'post',
-  httpPath: '/v1/chats/{chatID}/messages',
-  operationId: 'sendMessage',
-};
-
-export const tool: Tool = {
-  name: 'send_message',
-  description:
-    'Send a text message to a specific chat. Supports replying to existing messages. Returns the sent message ID and a deeplink to the chat',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      chatID: {
-        type: 'string',
-        description: 'Unique identifier of the chat.',
-      },
-      replyToMessageID: {
-        type: 'string',
-        description: 'Provide a message ID to send this as a reply to an existing message',
-      },
-      text: {
-        type: 'string',
-        description: 'Text content of the message you want to send. You may use markdown.',
-      },
-    },
-    required: ['chatID'],
-  },
-  annotations: {},
-};
-
-export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-  const { chatID, ...body } = args as any;
-  return asTextContentResult(await client.messages.send(chatID, body));
-};
-
-export default { metadata, tool, handler };