@beeper/desktop-mcp 4.2.3 → 4.6.0

package/src/dynamic-tools.ts

@@ -1,159 +0,0 @@
-import BeeperDesktop from '@beeper/desktop-api';
-import { Endpoint, asTextContentResult, ToolCallResult } from './tools/types';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { z } from 'zod';
-import { Cabidela } from '@cloudflare/cabidela';
-
-function zodToInputSchema(schema: z.ZodSchema) {
-  return {
-    type: 'object' as const,
-    ...(zodToJsonSchema(schema) as any),
-  };
-}
-
-/**
- * A list of tools that expose all the endpoints in the API dynamically.
- *
- * Instead of exposing every endpoint as its own tool, which uses up too many tokens for LLMs to use at once,
- * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
- * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
- *
- * @param endpoints - The endpoints to include in the list.
- */
-export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
-  const listEndpointsSchema = z.object({
-    search_query: z
-      .string()
-      .optional()
-      .describe(
-        'An optional search query to filter the endpoints by. Provide a partial name, resource, operation, or tag to filter the endpoints returned.',
-      ),
-  });
-
-  const listEndpointsTool = {
-    metadata: {
-      resource: 'dynamic_tools',
-      operation: 'read' as const,
-      tags: [],
-    },
-    tool: {
-      name: 'list_api_endpoints',
-      description: 'List or search for all endpoints in the TypeScript SDK for Beeper Desktop API',
-      inputSchema: zodToInputSchema(listEndpointsSchema),
-    },
-    handler: async (
-      client: BeeperDesktop,
-      args: Record<string, unknown> | undefined,
-    ): Promise<ToolCallResult> => {
-      const query = args && listEndpointsSchema.parse(args).search_query?.trim();
-
-      const filteredEndpoints =
-        query && query.length > 0 ?
-          endpoints.filter((endpoint) => {
-            const fieldsToMatch = [
-              endpoint.tool.name,
-              endpoint.tool.description,
-              endpoint.metadata.resource,
-              endpoint.metadata.operation,
-              ...endpoint.metadata.tags,
-            ];
-            return fieldsToMatch.some((field) => field && field.toLowerCase().includes(query.toLowerCase()));
-          })
-        : endpoints;
-
-      return asTextContentResult({
-        tools: filteredEndpoints.map(({ tool, metadata }) => ({
-          name: tool.name,
-          description: tool.description,
-          resource: metadata.resource,
-          operation: metadata.operation,
-          tags: metadata.tags,
-        })),
-      });
-    },
-  };
-
-  const getEndpointSchema = z.object({
-    endpoint: z.string().describe('The name of the endpoint to get the schema for.'),
-  });
-  const getEndpointTool = {
-    metadata: {
-      resource: 'dynamic_tools',
-      operation: 'read' as const,
-      tags: [],
-    },
-    tool: {
-      name: 'get_api_endpoint_schema',
-      description:
-        'Get the schema for an endpoint in the TypeScript SDK for Beeper Desktop API. You can use the schema returned by this tool to invoke an endpoint with the `invoke_api_endpoint` tool.',
-      inputSchema: zodToInputSchema(getEndpointSchema),
-    },
-    handler: async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
-      if (!args) {
-        throw new Error('No endpoint provided');
-      }
-      const endpointName = getEndpointSchema.parse(args).endpoint;
-
-      const endpoint = endpoints.find((e) => e.tool.name === endpointName);
-      if (!endpoint) {
-        throw new Error(`Endpoint ${endpointName} not found`);
-      }
-      return asTextContentResult(endpoint.tool);
-    },
-  };
-
-  const invokeEndpointSchema = z.object({
-    endpoint_name: z.string().describe('The name of the endpoint to invoke.'),
-    args: z
-      .record(z.string(), z.any())
-      .describe(
-        'The arguments to pass to the endpoint. This must match the schema returned by the `get_api_endpoint_schema` tool.',
-      ),
-  });
-
-  const invokeEndpointTool = {
-    metadata: {
-      resource: 'dynamic_tools',
-      operation: 'write' as const,
-      tags: [],
-    },
-    tool: {
-      name: 'invoke_api_endpoint',
-      description:
-        'Invoke an endpoint in the TypeScript SDK for Beeper Desktop API. Note: use the `list_api_endpoints` tool to get the list of endpoints and `get_api_endpoint_schema` tool to get the schema for an endpoint.',
-      inputSchema: zodToInputSchema(invokeEndpointSchema),
-    },
-    handler: async (
-      client: BeeperDesktop,
-      args: Record<string, unknown> | undefined,
-    ): Promise<ToolCallResult> => {
-      if (!args) {
-        throw new Error('No endpoint provided');
-      }
-      const { success, data, error } = invokeEndpointSchema.safeParse(args);
-      if (!success) {
-        throw new Error(`Invalid arguments for endpoint. ${error?.format()}`);
-      }
-      const { endpoint_name, args: endpointArgs } = data;
-
-      const endpoint = endpoints.find((e) => e.tool.name === endpoint_name);
-      if (!endpoint) {
-        throw new Error(
-          `Endpoint ${endpoint_name} not found. Use the \`list_api_endpoints\` tool to get the list of available endpoints.`,
-        );
-      }
-
-      try {
-        // Try to validate the arguments for a better error message
-        const cabidela = new Cabidela(endpoint.tool.inputSchema, { fullErrors: true });
-        cabidela.validate(endpointArgs);
-      } catch (error) {
-        throw new Error(`Invalid arguments for endpoint ${endpoint_name}:\n${error}`);
-      }
-
-      return await endpoint.handler(client, endpointArgs);
-    },
-  };
-
-  return [getEndpointTool, listEndpointsTool, invokeEndpointTool];
-}

package/src/filtering.ts

@@ -1,14 +0,0 @@
-// @ts-nocheck
-import initJq from 'jq-web';
-
-export async function maybeFilter(jqFilter: unknown | undefined, response: any): Promise<any> {
-  if (jqFilter && typeof jqFilter === 'string') {
-    return await jq(response, jqFilter);
-  } else {
-    return response;
-  }
-}
-
-async function jq(json: any, jqFilter: string) {
-  return (await initJq).json(json, jqFilter);
-}

package/src/handlers/get-accounts.ts

@@ -1,28 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { asMarkdownContentResult } from './utils';
-
-export const handler: HandlerFunction = async (client) => {
-  const accounts = await client.accounts.list();
-  if (!accounts || accounts.length === 0)
-    throw new Error('No accounts found. This should never happen, please contact help@beeper.com.');
-  const lines: string[] = [];
-  lines.push('# Accounts');
-  for (const acc of accounts) {
-    if (!acc.user) {
-      lines.push(`\n## ${acc.network}`);
-      lines.push(`**Account ID**: \`${acc.accountID}\``);
-      lines.push('**User**: Unknown');
-      continue;
-    }
-
-    const name = acc.user.fullName || acc.user.username || acc.user.id;
-    lines.push(`\n## ${acc.network}`);
-    lines.push(`**Account ID**: \`${acc.accountID}\``);
-    lines.push(`**User**: ${name}`);
-    if (acc.user.email) lines.push(`**Email**: ${acc.user.email}`);
-    if (acc.user.phoneNumber) lines.push(`**Phone**: ${acc.user.phoneNumber}`);
-  }
-  lines.push('\n# Using this information\n');
-  lines.push('- Pass accountIDs to narrow chat/message queries when known.');
-  return asMarkdownContentResult(lines);
-};

package/src/handlers/get-chat.ts

@@ -1,18 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { asMarkdownContentResult, formatChatToMarkdown } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const { chatID, ...queryParams } = args as any;
-  const chat = await client.chats.retrieve(chatID, queryParams);
-
-  const lines: string[] = [];
-  if (!chat) {
-    lines.push('Chat not found.');
-    return asMarkdownContentResult(lines);
-  }
-  lines.push(formatChatToMarkdown(chat, undefined));
-  lines.push('\n# Using this information\n');
-  lines.push('- Use search_messages to find specific content in this chat.');
-  lines.push('- Link the "open" link to the user to allow them to view the chat in Beeper Desktop.');
-  return asMarkdownContentResult(lines);
-};

package/src/handlers/index.ts

@@ -1,29 +0,0 @@
-import type { Endpoint, HandlerFunction } from '../tools';
-
-import { handler as get_accounts } from './get-accounts';
-import { handler as open_in_app } from './open-app';
-import { handler as search } from './search';
-import { handler as get_chat } from './get-chat';
-import { handler as search_chats } from './search-chats';
-import { handler as search_messages } from './search-messages';
-import { handler as send_message } from './send-message';
-
-const HANDLER_OVERRIDES: Record<string, HandlerFunction> = {
-  get_accounts,
-  open_in_app,
-  focus_app: open_in_app,
-  search,
-  get_chat,
-  search_chats,
-  search_messages,
-  send_message,
-};
-
-export function mapEndpoint(endpoint: Endpoint): Endpoint {
-  const handler = HANDLER_OVERRIDES[endpoint.tool.name];
-  if (!handler) return endpoint;
-  return {
-    ...endpoint,
-    handler,
-  };
-}

package/src/handlers/list-chats.ts

@@ -1,47 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { asMarkdownContentResult, formatChatToMarkdown } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const body = args as any;
-  const output = await client.chats.search(body);
-
-  const lines: string[] = [];
-  lines.push('# Chats');
-
-  const items = output.items || [];
-  const hasMore = !!output.hasMore;
-
-  if (hasMore) {
-    lines.push(`\nShowing ${items.length} chats (more available)`);
-    if (output.oldestCursor) {
-      lines.push(`Next page (older): cursor='${output.oldestCursor}', direction='before'`);
-    }
-    if (output.newestCursor) {
-      lines.push(`Previous page (newer): cursor='${output.newestCursor}', direction='after'`);
-    }
-  } else if (items.length > 0) {
-    lines.push(`\nShowing ${items.length} chat${items.length === 1 ? '' : 's'}`);
-  }
-
-  if (items.length === 0) {
-    lines.push('\nNo chats found.');
-  } else {
-    for (const chatWithPreview of items) {
-      lines.push(formatChatToMarkdown(chatWithPreview, undefined));
-      const preview = (chatWithPreview as any).preview;
-      if (preview) {
-        lines.push(`**Last message**: ${preview.text || '(no text)'}`);
-        if (preview.senderName) {
-          lines.push(`**From**: ${preview.senderName}`);
-        }
-        lines.push(`**Timestamp**: ${preview.timestamp}`);
-      }
-    }
-  }
-  lines.push('\n# Using this information\n');
-  lines.push(
-    '- Pass the "chatID" to get_chat or search_messages for details about a chat, or send_message to send a message to a chat.',
-  );
-  lines.push('- Link the "open" link to the user to allow them to view the chat in Beeper Desktop.');
-  return asMarkdownContentResult(lines);
-};

package/src/handlers/list-messages.ts

@@ -1,33 +0,0 @@
-import { asTextContentResult, type HandlerFunction } from '../tools/types';
-import { mapMessagesToText } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const body = args as any;
-  const output = await client.messages.search(body);
-
-  const lines: string[] = [];
-  lines.push('# Messages');
-
-  const items = (output as any).items || [];
-  const hasMore = !!(output as any).hasMore;
-
-  if (hasMore) {
-    lines.push(`\nShowing ${items.length} messages (more available)`);
-    if ((output as any).oldestCursor) {
-      lines.push(`Next page (older): cursor='${(output as any).oldestCursor}', direction='before'`);
-    }
-    if ((output as any).newestCursor) {
-      lines.push(`Previous page (newer): cursor='${(output as any).newestCursor}', direction='after'`);
-    }
-  } else if (items.length > 0) {
-    lines.push(`\nShowing ${items.length} message${items.length === 1 ? '' : 's'}`);
-  }
-
-  if (items.length === 0) {
-    lines.push('\nNo messages found.');
-  } else {
-    lines.push(mapMessagesToText(output as any, body, undefined));
-  }
-
-  return asTextContentResult(lines.join('\n'));
-};

package/src/handlers/open-app.ts

@@ -1,20 +0,0 @@
-import { asTextContentResult, type HandlerFunction } from '../tools/types';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const body = args as any;
-  const output = await client.focus(body);
-
-  const lines: string[] = [];
-  if (output.success) {
-    lines.push('Beeper was opened.');
-    if (body?.chatID) {
-      const chatRef = String(body.chatID);
-      lines.push(`Focused chat: ${chatRef}`);
-    }
-    if (body?.draftText) lines.push(`Draft text populated: ${body.draftText}`);
-    if (body?.draftAttachmentPath) lines.push(`Draft attachment populated: ${body.draftAttachmentPath}`);
-  } else {
-    lines.push('Failed to open Beeper.');
-  }
-  return asTextContentResult(lines.join('\n'));
-};

package/src/handlers/search-chats.ts

@@ -1,39 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { asMarkdownContentResult, formatChatToMarkdown } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const body = args as any;
-  const output = await client.chats.search(body);
-
-  const lines: string[] = [];
-  lines.push('# Chats');
-
-  const items = output.items || [];
-  const hasMore = !!output.hasMore;
-
-  if (hasMore) {
-    lines.push(`\nFound ${items.length}+ chats (showing ${items.length})`);
-    if (output.oldestCursor) {
-      lines.push(`Next page (older): cursor='${output.oldestCursor}', direction='before'`);
-    }
-    if (output.newestCursor) {
-      lines.push(`Previous page (newer): cursor='${output.newestCursor}', direction='after'`);
-    }
-  } else if (items.length > 0) {
-    lines.push(`\nFound ${items.length} chat${items.length === 1 ? '' : 's'}`);
-  }
-
-  if (items.length === 0) {
-    lines.push('\nNo chats found.');
-  } else {
-    for (const chat of items) {
-      lines.push(formatChatToMarkdown(chat, undefined));
-    }
-  }
-  lines.push('\n# Using this information\n');
-  lines.push(
-    '- Pass the "chatID" to get_chat or search_messages for details about a chat, or send_message to send a message to a chat.',
-  );
-  lines.push('- Link the "open" link to the user to allow them to view the chat in Beeper Desktop.');
-  return asMarkdownContentResult(lines);
-};

package/src/handlers/search-messages.ts

@@ -1,8 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { mapMessagesToText, asMarkdownContentResult } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const body = args as any;
-  const output = await client.messages.search(body);
-  return asMarkdownContentResult(mapMessagesToText(output, body, undefined));
-};

package/src/handlers/search.ts

@@ -1,24 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { asMarkdownContentResult, formatChatToMarkdown, mapMessagesToText } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const body = args as any;
-  const output = await client.search(body);
-
-  const lines: string[] = [];
-  if (body?.query) lines.push(`Query: "${body.query}"`);
-  const results = output?.results;
-  if (results?.chats?.length) {
-    lines.push('\n# Chats');
-    for (const chat of results.chats) lines.push(formatChatToMarkdown(chat, undefined));
-  }
-  if (results?.in_groups?.length) {
-    lines.push('\n# In Groups');
-    for (const chat of results.in_groups) lines.push(formatChatToMarkdown(chat, undefined));
-  }
-  if (results?.messages?.items?.length) {
-    lines.push('\n# Messages');
-    lines.push(mapMessagesToText(results.messages as any, body, undefined));
-  }
-  return asMarkdownContentResult(lines);
-};

package/src/handlers/send-message.ts

@@ -1,17 +0,0 @@
-import type { HandlerFunction } from '../tools/types';
-import { asMarkdownContentResult, createOpenLink } from './utils';
-
-export const handler: HandlerFunction = async (client, args) => {
-  const { chatID, ...body } = args as any;
-  const output = await client.messages.send(chatID, body);
-
-  const lines: string[] = [];
-  if (output.pendingMessageID) {
-    const deeplink = createOpenLink('', chatID ?? '');
-    if (deeplink) lines.push(`**Open the chat in Beeper**: ${deeplink}`);
-  } else {
-    lines.push('Failed to send message.');
-  }
-
-  return asMarkdownContentResult(lines);
-};