@beeper/desktop-mcp 0.1.3 → 0.1.5

package/src/server.ts

@@ -5,8 +5,9 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Endpoint, endpoints, HandlerFunction, query } from './tools';
 import {
   CallToolRequestSchema,
-  Implementation,
   ListToolsRequestSchema,
+  SetLevelRequestSchema,
+  Implementation,
   Tool,
 } from '@modelcontextprotocol/sdk/types.js';
 import { ClientOptions } from '@beeper/desktop-api';
@@ -32,12 +33,12 @@ export const newMcpServer = () =>
   new McpServer(
     {
       name: 'beeper_desktop_api_api',
-      version: '0.1.3',
+      version: '0.1.5',
     },
     {
       capabilities: { tools: {}, logging: {} },
       instructions:
-        'This MCP server provides access to your Beeper Desktop messages and chats. Use the search and find tools to locate messages and conversations, then use send_message to respond.',
+        'Access to all chats and messages across networks using Beeper Desktop. Can be used to find, get, send, and manage messages and chats.',
     },
   );
 
@@ -59,7 +60,7 @@ export function initMcpServer(params: {
   let providedEndpoints: Endpoint[] | null = null;
   let endpointMap: Record<string, Endpoint> | null = null;
 
-  const initTools = (implementation?: Implementation) => {
+  const initTools = async (implementation?: Implementation) => {
     if (implementation && (!mcpOptions.client || mcpOptions.client === 'infer')) {
       mcpOptions.client =
         implementation.name.toLowerCase().includes('claude') ? 'claude'
@@ -70,8 +71,8 @@ export function initMcpServer(params: {
         ...mcpOptions.capabilities,
       };
     }
-    providedEndpoints = selectTools(endpoints, mcpOptions);
-    endpointMap = Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
+    providedEndpoints ??= await selectTools(endpoints, mcpOptions);
+    endpointMap ??= Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
   };
 
   const logAtLevel =
@@ -89,7 +90,7 @@ export function initMcpServer(params: {
     error: logAtLevel('error'),
   };
 
-  const client = new BeeperDesktop({
+  let client = new BeeperDesktop({
     logger,
     ...params.clientOptions,
     defaultHeaders: {
@@ -100,7 +101,7 @@ export function initMcpServer(params: {
 
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     if (providedEndpoints === null) {
-      initTools(server.getClientVersion());
+      await initTools(server.getClientVersion());
     }
     return {
       tools: providedEndpoints!.map((endpoint) => endpoint.tool),
@@ -109,7 +110,7 @@ export function initMcpServer(params: {
 
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     if (endpointMap === null) {
-      initTools(server.getClientVersion());
+      await initTools(server.getClientVersion());
     }
     const { name, arguments: args } = request.params;
     const endpoint = endpointMap![name];
@@ -119,12 +120,35 @@ export function initMcpServer(params: {
 
     return executeHandler(endpoint.tool, endpoint.handler, client, args, mcpOptions.capabilities);
   });
+
+  server.setRequestHandler(SetLevelRequestSchema, async (request) => {
+    const { level } = request.params;
+    switch (level) {
+      case 'debug':
+        client = client.withOptions({ logLevel: 'debug' });
+        break;
+      case 'info':
+        client = client.withOptions({ logLevel: 'info' });
+        break;
+      case 'notice':
+      case 'warning':
+        client = client.withOptions({ logLevel: 'warn' });
+        break;
+      case 'error':
+        client = client.withOptions({ logLevel: 'error' });
+        break;
+      default:
+        client = client.withOptions({ logLevel: 'off' });
+        break;
+    }
+    return {};
+  });
 }
 
 /**
  * Selects the tools to include in the MCP Server based on the provided options.
  */
-export function selectTools(endpoints: Endpoint[], options?: McpOptions): Endpoint[] {
+export async function selectTools(endpoints: Endpoint[], options?: McpOptions): Promise<Endpoint[]> {
   const filteredEndpoints = query(options?.filters ?? [], endpoints);
 
   let includedTools = filteredEndpoints;
@@ -139,7 +163,7 @@ export function selectTools(endpoints: Endpoint[], options?: McpOptions): Endpoi
     } else if (options?.includeDynamicTools) {
       includedTools = dynamicTools(endpoints);
     } else if (options?.includeCodeTools) {
-      includedTools = [codeTool()];
+      includedTools = [await codeTool()];
     } else {
       includedTools = endpoints;
     }

package/src/tools/app/{open-app.ts → open-in-app.ts}

@@ -15,8 +15,9 @@ export const metadata: Metadata = {
 };
 
 export const tool: Tool = {
-  name: 'open_app',
-  description: 'Open Beeper, optionally focusing a chat or message, or pre-filling a draft.',
+  name: 'open_in_app',
+  description:
+    'Open Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment.',
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,13 +26,17 @@ export const tool: Tool = {
         description:
           'Optional Beeper chat ID (or local chat ID) to focus after opening the app. If omitted, only opens/focuses the app.',
       },
+      draftAttachmentPath: {
+        type: 'string',
+        description: 'Optional draft attachment path to populate in the message input field.',
+      },
       draftText: {
         type: 'string',
         description: 'Optional draft text to populate in the message input field.',
       },
-      messageSortKey: {
+      messageID: {
         type: 'string',
-        description: 'Optional message sort key. Jumps to that message in the chat when opening.',
+        description: 'Optional message ID. Jumps to that message in the chat when opening.',
       },
     },
     required: [],
@@ -41,7 +46,7 @@ export const tool: Tool = {
 
 export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await client.app.focus(body));
+  return asTextContentResult(await client.app.open(body));
 };
 
 export default { metadata, tool, handler };

package/src/tools/app/search.ts

@@ -0,0 +1,41 @@
+// 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: 'app',
+  operation: 'read',
+  tags: ['app'],
+  httpMethod: 'get',
+  httpPath: '/v0/search',
+  operationId: 'search',
+};
+
+export const tool: Tool = {
+  name: 'search',
+  description:
+    'Search for chats, participant name matches in groups, and the first page of messages in one call. Use this when the user asks for a specific chat, group, or person.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: {
+        type: 'string',
+        description: 'User-typed search text. Literal word matching (NOT semantic).',
+      },
+    },
+    required: ['query'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return asTextContentResult(await client.app.search(body));
+};
+
+export default { metadata, tool, handler };

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

@@ -40,7 +40,7 @@ export const tool: Tool = {
 
 export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await client.chats.get(body));
+  return asTextContentResult(await client.chats.retrieve(body));
 };
 
 export default { metadata, tool, handler };

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

@@ -6,9 +6,9 @@ import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import BeeperDesktop from '@beeper/desktop-api';
 
 export const metadata: Metadata = {
-  resource: 'reminders',
+  resource: 'chats.reminders',
   operation: 'write',
-  tags: ['reminders'],
+  tags: ['chats'],
   httpMethod: 'post',
   httpPath: '/v0/clear-chat-reminder',
   operationId: 'clear_chat_reminder',
@@ -33,7 +33,7 @@ export const tool: Tool = {
 
 export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await client.reminders.clear(body));
+  return asTextContentResult(await client.chats.reminders.delete(body));
 };
 
 export default { metadata, tool, handler };

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

@@ -6,9 +6,9 @@ import { Tool } from '@modelcontextprotocol/sdk/types.js';
 import BeeperDesktop from '@beeper/desktop-api';
 
 export const metadata: Metadata = {
-  resource: 'reminders',
+  resource: 'chats.reminders',
   operation: 'write',
-  tags: ['reminders'],
+  tags: ['chats'],
   httpMethod: 'post',
   httpPath: '/v0/set-chat-reminder',
   operationId: 'set_chat_reminder',
@@ -47,7 +47,7 @@ export const tool: Tool = {
 
 export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return asTextContentResult(await client.reminders.set(body));
+  return asTextContentResult(await client.chats.reminders.create(body));
 };
 
 export default { metadata, tool, handler };

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

@@ -16,7 +16,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'search_chats',
-  description: 'Search chats by inbox, type, unread status, or text. Paginates.',
+  description:
+    "Search chats by title/network or participants using Beeper Desktop's renderer algorithm. Optional 'scope'.",
   inputSchema: {
     type: 'object',
     properties: {
@@ -25,6 +26,7 @@ export const tool: Tool = {
         description: 'Provide an array of account IDs to filter chats from specific messaging accounts only',
         items: {
           type: 'string',
+          description: 'Beeper account ID this resource belongs to.',
         },
       },
       cursor: {
@@ -64,21 +66,22 @@ export const tool: Tool = {
         type: 'integer',
         description: 'Set the maximum number of chats to retrieve. Valid range: 1-200, default is 50',
       },
-      participantQuery: {
+      query: {
         type: 'string',
         description:
-          'Search string to filter chats by participant names. When multiple words provided, ALL words must match. Searches in username, displayName, and fullName fields.',
+          'Literal token search (non-semantic). Use single words users type (e.g., "dinner"). When multiple words provided, ALL must match. Case-insensitive.',
       },
-      query: {
+      scope: {
         type: 'string',
         description:
-          'Search string to filter chats by title. When multiple words provided, ALL words must match. Matches are case-insensitive substrings.',
+          "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, "channel" for channels, or "any" to get all types',
-        enum: ['single', 'group', 'channel', 'any'],
+          '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',

package/src/tools/index.ts

@@ -5,15 +5,15 @@ import { Metadata, Endpoint, HandlerFunction } from './types';
 export { Metadata, Endpoint, HandlerFunction };
 
 import get_accounts from './accounts/get-accounts';
-import open_app from './app/open-app';
-import archive_chat from './chats/archive-chat';
+import open_in_app from './app/open-in-app';
+import search from './app/search';
 import get_chat from './chats/get-chat';
+import archive_chat from './chats/archive-chat';
 import search_chats from './chats/search-chats';
-import get_attachment from './messages/get-attachment';
+import set_chat_reminder from './chats/reminders/set-chat-reminder';
+import clear_chat_reminder from './chats/reminders/clear-chat-reminder';
 import search_messages from './messages/search-messages';
 import send_message from './messages/send-message';
-import clear_chat_reminder from './reminders/clear-chat-reminder';
-import set_chat_reminder from './reminders/set-chat-reminder';
 
 export const endpoints: Endpoint[] = [];
 
@@ -22,15 +22,15 @@ function addEndpoint(endpoint: Endpoint) {
 }
 
 addEndpoint(get_accounts);
-addEndpoint(open_app);
-addEndpoint(archive_chat);
+addEndpoint(open_in_app);
+addEndpoint(search);
 addEndpoint(get_chat);
+addEndpoint(archive_chat);
 addEndpoint(search_chats);
-addEndpoint(get_attachment);
+addEndpoint(set_chat_reminder);
+addEndpoint(clear_chat_reminder);
 addEndpoint(search_messages);
 addEndpoint(send_message);
-addEndpoint(clear_chat_reminder);
-addEndpoint(set_chat_reminder);
 
 export type Filter = {
   type: 'resource' | 'operation' | 'tag' | 'tool';

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

@@ -17,7 +17,7 @@ export const metadata: Metadata = {
 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- Media filters: Use onlyWithMedia for any media, or specific filters like onlyWithVideo, onlyWithImage, onlyWithLink, onlyWithFile for specific types.\n- Pagination: use \'oldestCursor\' + direction=\'before\' for older; \'newestCursor\' + direction=\'after\' for newer.\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 participantQuery in find-chats)\nReturns: matching messages and referenced chats.',
+    '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: {
@@ -26,6 +26,7 @@ export const tool: Tool = {
         description: 'Limit search to specific Beeper account IDs (bridge instances).',
         items: {
           type: 'string',
+          description: 'Beeper account ID this resource belongs to.',
         },
       },
       chatIDs: {
@@ -74,27 +75,17 @@ export const tool: Tool = {
       },
       limit: {
         type: 'integer',
-        description: 'Maximum number of messages to return (1–500). Defaults to 50.',
-      },
-      onlyWithFile: {
-        type: 'boolean',
-        description: 'Only return messages that contain file attachments.',
-      },
-      onlyWithImage: {
-        type: 'boolean',
-        description: 'Only return messages that contain image attachments.',
-      },
-      onlyWithLink: {
-        type: 'boolean',
-        description: 'Only return messages that contain link attachments.',
-      },
-      onlyWithMedia: {
-        type: 'boolean',
-        description: 'Only return messages that contain any type of media attachment.',
+        description:
+          'Maximum number of messages to return (1–500). Defaults to 20. The current implementation caps each page at 20 items even if a higher limit is requested.',
       },
-      onlyWithVideo: {
-        type: 'boolean',
-        description: 'Only return messages that contain video attachments.',
+      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',

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

@@ -23,8 +23,7 @@ export const tool: Tool = {
     properties: {
       chatID: {
         type: 'string',
-        description:
-          'The identifier of the chat where the message will send (accepts both chatID and local chat ID)',
+        description: 'Unique identifier of the chat (a.k.a. room or thread).',
       },
       replyToMessageID: {
         type: 'string',

package/tools/{messages/get-attachment.d.ts → app/open-in-app.d.mts}

@@ -42,4 +42,4 @@ declare const _default: {
     handler: (client: BeeperDesktop, args: Record<string, unknown> | undefined) => Promise<import("@beeper/desktop-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
-//# sourceMappingURL=get-attachment.d.ts.map
+//# sourceMappingURL=open-in-app.d.mts.map

package/tools/app/open-in-app.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-app.d.mts","sourceRoot":"","sources":["../../src/tools/app/open-in-app.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,iCAAiC;OAExE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,aAAa,MAAM,qBAAqB;AAE/C,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA4BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sEAG7F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,aAAa,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK9F,wBAA2C"}

package/tools/{messages/get-attachment.d.mts → app/open-in-app.d.ts}

@@ -42,4 +42,4 @@ declare const _default: {
     handler: (client: BeeperDesktop, args: Record<string, unknown> | undefined) => Promise<import("@beeper/desktop-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
-//# sourceMappingURL=get-attachment.d.mts.map
+//# sourceMappingURL=open-in-app.d.ts.map

package/tools/app/open-in-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-app.d.ts","sourceRoot":"","sources":["../../src/tools/app/open-in-app.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,iCAAiC;OAExE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,aAAa,MAAM,qBAAqB;AAE/C,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IA4BlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sEAG7F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,aAAa,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK9F,wBAA2C"}

package/tools/app/{open-app.js → open-in-app.js}

@@ -12,8 +12,8 @@ exports.metadata = {
     operationId: 'open_app',
 };
 exports.tool = {
-    name: 'open_app',
-    description: 'Open Beeper, optionally focusing a chat or message, or pre-filling a draft.',
+    name: 'open_in_app',
+    description: 'Open Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -21,13 +21,17 @@ exports.tool = {
                 type: 'string',
                 description: 'Optional Beeper chat ID (or local chat ID) to focus after opening the app. If omitted, only opens/focuses the app.',
             },
+            draftAttachmentPath: {
+                type: 'string',
+                description: 'Optional draft attachment path to populate in the message input field.',
+            },
             draftText: {
                 type: 'string',
                 description: 'Optional draft text to populate in the message input field.',
             },
-            messageSortKey: {
+            messageID: {
                 type: 'string',
-                description: 'Optional message sort key. Jumps to that message in the chat when opening.',
+                description: 'Optional message ID. Jumps to that message in the chat when opening.',
             },
         },
         required: [],
@@ -36,8 +40,8 @@ exports.tool = {
 };
 const handler = async (client, args) => {
     const body = args;
-    return (0, types_1.asTextContentResult)(await client.app.focus(body));
+    return (0, types_1.asTextContentResult)(await client.app.open(body));
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
-//# sourceMappingURL=open-app.js.map
+//# sourceMappingURL=open-in-app.js.map

package/tools/app/open-in-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-app.js","sourceRoot":"","sources":["../../src/tools/app/open-in-app.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAAgF;AAKnE,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,KAAK,CAAC;IACb,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,UAAU;CACxB,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,iHAAiH;IACnH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oHAAoH;aACvH;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wEAAwE;aACtF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAqB,EAAE,IAAyC,EAAE,EAAE;IAChG,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,OAAO,IAAA,2BAAmB,EAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/app/{open-app.mjs → open-in-app.mjs}

@@ -9,8 +9,8 @@ export const metadata = {
     operationId: 'open_app',
 };
 export const tool = {
-    name: 'open_app',
-    description: 'Open Beeper, optionally focusing a chat or message, or pre-filling a draft.',
+    name: 'open_in_app',
+    description: 'Open Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -18,13 +18,17 @@ export const tool = {
                 type: 'string',
                 description: 'Optional Beeper chat ID (or local chat ID) to focus after opening the app. If omitted, only opens/focuses the app.',
             },
+            draftAttachmentPath: {
+                type: 'string',
+                description: 'Optional draft attachment path to populate in the message input field.',
+            },
             draftText: {
                 type: 'string',
                 description: 'Optional draft text to populate in the message input field.',
             },
-            messageSortKey: {
+            messageID: {
                 type: 'string',
-                description: 'Optional message sort key. Jumps to that message in the chat when opening.',
+                description: 'Optional message ID. Jumps to that message in the chat when opening.',
             },
         },
         required: [],
@@ -33,7 +37,7 @@ export const tool = {
 };
 export const handler = async (client, args) => {
     const body = args;
-    return asTextContentResult(await client.app.focus(body));
+    return asTextContentResult(await client.app.open(body));
 };
 export default { metadata, tool, handler };
-//# sourceMappingURL=open-app.mjs.map
+//# sourceMappingURL=open-in-app.mjs.map

package/tools/app/open-in-app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-in-app.mjs","sourceRoot":"","sources":["../../src/tools/app/open-in-app.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,mBAAmB,EAAE,MAAM,iCAAiC;AAK/E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,OAAO;IAClB,IAAI,EAAE,CAAC,KAAK,CAAC;IACb,UAAU,EAAE,MAAM;IAClB,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,UAAU;CACxB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,iHAAiH;IACnH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,oHAAoH;aACvH;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wEAAwE;aACtF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAqB,EAAE,IAAyC,EAAE,EAAE;IAChG,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,OAAO,mBAAmB,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/app/{open-app.d.ts → search.d.mts}

@@ -42,4 +42,4 @@ declare const _default: {
     handler: (client: BeeperDesktop, args: Record<string, unknown> | undefined) => Promise<import("@beeper/desktop-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
-//# sourceMappingURL=open-app.d.ts.map
+//# sourceMappingURL=search.d.mts.map

package/tools/app/search.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.mts","sourceRoot":"","sources":["../../src/tools/app/search.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,iCAAiC;OAExE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,aAAa,MAAM,qBAAqB;AAE/C,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAiBlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sEAG7F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,aAAa,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK9F,wBAA2C"}

package/tools/app/{open-app.d.mts → search.d.ts}

@@ -42,4 +42,4 @@ declare const _default: {
     handler: (client: BeeperDesktop, args: Record<string, unknown> | undefined) => Promise<import("@beeper/desktop-mcp/tools/types").ToolCallResult>;
 };
 export default _default;
-//# sourceMappingURL=open-app.d.mts.map
+//# sourceMappingURL=search.d.ts.map

package/tools/app/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/app/search.ts"],"names":[],"mappings":"OAEO,EAAE,QAAQ,EAAuB,MAAM,iCAAiC;OAExE,EAAE,IAAI,EAAE,MAAM,oCAAoC;OAClD,aAAa,MAAM,qBAAqB;AAE/C,eAAO,MAAM,QAAQ,EAAE,QAOtB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,IAiBlB,CAAC;AAEF,eAAO,MAAM,OAAO,GAAU,QAAQ,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,sEAG7F,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAHoC,aAAa,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;;AAK9F,wBAA2C"}

package/tools/app/search.js

@@ -0,0 +1,37 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handler = exports.tool = exports.metadata = void 0;
+const types_1 = require("@beeper/desktop-mcp/tools/types");
+exports.metadata = {
+    resource: 'app',
+    operation: 'read',
+    tags: ['app'],
+    httpMethod: 'get',
+    httpPath: '/v0/search',
+    operationId: 'search',
+};
+exports.tool = {
+    name: 'search',
+    description: 'Search for chats, participant name matches in groups, and the first page of messages in one call. Use this when the user asks for a specific chat, group, or person.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'User-typed search text. Literal word matching (NOT semantic).',
+            },
+        },
+        required: ['query'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+const handler = async (client, args) => {
+    const body = args;
+    return (0, types_1.asTextContentResult)(await client.app.search(body));
+};
+exports.handler = handler;
+exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };
+//# sourceMappingURL=search.js.map

package/tools/app/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/app/search.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAAgF;AAKnE,QAAA,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,KAAK,CAAC;IACb,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEW,QAAA,IAAI,GAAS;IACxB,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,sKAAsK;IACxK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEK,MAAM,OAAO,GAAG,KAAK,EAAE,MAAqB,EAAE,IAAyC,EAAE,EAAE;IAChG,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,OAAO,IAAA,2BAAmB,EAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC;AAHW,QAAA,OAAO,WAGlB;AAEF,kBAAe,EAAE,QAAQ,EAAR,gBAAQ,EAAE,IAAI,EAAJ,YAAI,EAAE,OAAO,EAAP,eAAO,EAAE,CAAC"}

package/tools/app/search.mjs

@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { asTextContentResult } from '@beeper/desktop-mcp/tools/types';
+export const metadata = {
+    resource: 'app',
+    operation: 'read',
+    tags: ['app'],
+    httpMethod: 'get',
+    httpPath: '/v0/search',
+    operationId: 'search',
+};
+export const tool = {
+    name: 'search',
+    description: 'Search for chats, participant name matches in groups, and the first page of messages in one call. Use this when the user asks for a specific chat, group, or person.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'User-typed search text. Literal word matching (NOT semantic).',
+            },
+        },
+        required: ['query'],
+    },
+    annotations: {
+        readOnlyHint: true,
+    },
+};
+export const handler = async (client, args) => {
+    const body = args;
+    return asTextContentResult(await client.app.search(body));
+};
+export default { metadata, tool, handler };
+//# sourceMappingURL=search.mjs.map

package/tools/app/search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.mjs","sourceRoot":"","sources":["../../src/tools/app/search.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAY,mBAAmB,EAAE,MAAM,iCAAiC;AAK/E,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,CAAC,KAAK,CAAC;IACb,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,QAAQ;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAS;IACxB,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,sKAAsK;IACxK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IACD,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,EAAE,MAAqB,EAAE,IAAyC,EAAE,EAAE;IAChG,MAAM,IAAI,GAAG,IAAW,CAAC;IACzB,OAAO,mBAAmB,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC"}

package/tools/chats/get-chat.js

@@ -34,7 +34,7 @@ exports.tool = {
 };
 const handler = async (client, args) => {
     const body = args;
-    return (0, types_1.asTextContentResult)(await client.chats.get(body));
+    return (0, types_1.asTextContentResult)(await client.chats.retrieve(body));
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };