feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 14
+configured_endpoints: 16
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-9f5190d7df873112f3512b5796cd95341f0fa0d2585488d3e829be80ee6045ce.yml
 openapi_spec_hash: ba834200758376aaea47b2a276f64c1b
-config_hash: f83b2b6eb86f2dd68101065998479cb2
+config_hash: be3f3b31e322be0f4de6a23e32ab004c

api.md

@@ -50,11 +50,13 @@ Types:
 
 - <code><a href="./src/resources/chats/chats.ts">Chat</a></code>
 - <code><a href="./src/resources/chats/chats.ts">ChatCreateResponse</a></code>
+- <code><a href="./src/resources/chats/chats.ts">ChatListResponse</a></code>
 
 Methods:
 
 - <code title="post /v1/chats">client.chats.<a href="./src/resources/chats/chats.ts">create</a>({ ...params }) -> ChatCreateResponse</code>
 - <code title="get /v1/chats/{chatID}">client.chats.<a href="./src/resources/chats/chats.ts">retrieve</a>(chatID, { ...params }) -> Chat</code>
+- <code title="get /v1/chats">client.chats.<a href="./src/resources/chats/chats.ts">list</a>({ ...params }) -> ChatListResponsesCursor</code>
 - <code title="post /v1/chats/{chatID}/archive">client.chats.<a href="./src/resources/chats/chats.ts">archive</a>(chatID, { ...params }) -> BaseResponse</code>
 - <code title="get /v1/chats/search">client.chats.<a href="./src/resources/chats/chats.ts">search</a>({ ...params }) -> ChatsCursor</code>
 
@@ -73,6 +75,7 @@ Types:
 
 Methods:
 
+- <code title="get /v1/messages">client.messages.<a href="./src/resources/messages.ts">list</a>({ ...params }) -> MessagesCursor</code>
 - <code title="get /v1/messages/search">client.messages.<a href="./src/resources/messages.ts">search</a>({ ...params }) -> MessagesCursor</code>
 - <code title="post /v1/messages">client.messages.<a href="./src/resources/messages.ts">send</a>({ ...params }) -> MessageSendResponse</code>
 

packages/mcp-server/README.md

@@ -220,7 +220,7 @@ The following tools are available in this MCP server.
 
 ### Resource `accounts`:
 
-- `get_accounts` (`read`) tags: [accounts]: List connected accounts on this device. Use to pick account context.
+- `get_accounts` (`read`) tags: [accounts]: List connected accounts on this device.
 
 ### Resource `contacts`:
 
@@ -230,6 +230,7 @@ The following tools are available in this MCP server.
 
 - `create_chats` (`write`): Create a single or group chat on a specific account using participant IDs and optional title.
 - `get_chat` (`read`) tags: [chats]: Get chat details: metadata, participants (limited), last activity.
+- `list_chats` (`read`): List all chats sorted by last activity (most recent first). Combines all accounts into a single paginated list.
 - `archive_chat` (`write`) tags: [chats]: Archive or unarchive a chat.
 - `search_chats` (`read`) tags: [chats]: Search chats by title/network or participants using Beeper Desktop's renderer algorithm. Optional 'scope'.
 
@@ -240,6 +241,7 @@ The following tools are available in this MCP server.
 
 ### Resource `messages`:
 
+- `list_messages` (`read`): List all messages in a chat with cursor-based pagination. Sorted by timestamp.
 - `search_messages` (`read`) tags: [messages]: Search messages across chats using Beeper's message index.
   - When to use: find messages by text and/or filters (chatIDs, accountIDs, chatType, media type filters, sender, date ranges).
   - CRITICAL: Query is LITERAL WORD MATCHING, NOT semantic search! Only finds messages containing these EXACT words.

packages/mcp-server/src/tools/accounts/get-accounts.ts

@@ -16,7 +16,7 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'get_accounts',
-  description: 'List connected accounts on this device. Use to pick account context.',
+  description: 'List connected accounts on this device.',
   inputSchema: {
     type: 'object',
     properties: {},

packages/mcp-server/src/tools/chats/list-chats.ts

@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@beeper/desktop-api-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: [],
+  httpMethod: 'get',
+  httpPath: '/v1/chats',
+  operationId: 'listChats',
+};
+
+export const tool: Tool = {
+  name: 'list_chats',
+  description:
+    'List all chats sorted by last activity (most recent first). Combines all accounts into a single paginated list.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      accountIDs: {
+        type: 'array',
+        description: 'Limit to specific account IDs. If omitted, fetches from all accounts.',
+        items: {
+          type: 'string',
+          description: 'Account ID this resource belongs to.',
+        },
+      },
+      cursor: {
+        type: 'string',
+        description:
+          'Timestamp cursor (milliseconds since epoch) for pagination. Use with direction to navigate results.',
+      },
+      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'],
+      },
+      limit: {
+        type: 'integer',
+        description: 'Maximum number of chats to return (1–200). Defaults to 50.',
+      },
+    },
+    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.list(body).asResponse();
+  return asTextContentResult(await response.json());
+};
+
+export default { metadata, tool, handler };

packages/mcp-server/src/tools/index.ts

@@ -11,10 +11,12 @@ import get_accounts from './accounts/get-accounts';
 import search_contacts from './contacts/search-contacts';
 import create_chats from './chats/create-chats';
 import get_chat from './chats/get-chat';
+import list_chats from './chats/list-chats';
 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 info_token from './token/info-token';
@@ -32,10 +34,12 @@ addEndpoint(get_accounts);
 addEndpoint(search_contacts);
 addEndpoint(create_chats);
 addEndpoint(get_chat);
+addEndpoint(list_chats);
 addEndpoint(archive_chat);
 addEndpoint(search_chats);
 addEndpoint(set_chat_reminder);
 addEndpoint(clear_chat_reminder);
+addEndpoint(list_messages);
 addEndpoint(search_messages);
 addEndpoint(send_message);
 addEndpoint(info_token);

packages/mcp-server/src/tools/messages/list-messages.ts

@@ -0,0 +1,55 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@beeper/desktop-api-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: [],
+  httpMethod: 'get',
+  httpPath: '/v1/messages',
+  operationId: 'listMessages',
+};
+
+export const tool: Tool = {
+  name: 'list_messages',
+  description: 'List all messages in a chat with cursor-based pagination. Sorted by timestamp.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      chatID: {
+        type: 'string',
+        description: 'The chat ID to list messages from',
+      },
+      cursor: {
+        type: 'string',
+        description: 'Message cursor for pagination. Use with direction to navigate results.',
+      },
+      direction: {
+        type: 'string',
+        description:
+          "Pagination direction used with 'cursor': 'before' fetches older messages, 'after' fetches newer messages. Defaults to 'before' when only 'cursor' is provided.",
+        enum: ['after', 'before'],
+      },
+      limit: {
+        type: 'integer',
+        description: 'Maximum number of messages to return (1–500). Defaults to 50.',
+      },
+    },
+    required: ['chatID'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: BeeperDesktop, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  const response = await client.messages.list(body).asResponse();
+  return asTextContentResult(await response.json());
+};
+
+export default { metadata, tool, handler };

src/client.ts

@@ -30,13 +30,22 @@ import {
 import { APIPromise } from './core/api-promise';
 import { Account, AccountListResponse, Accounts } from './resources/accounts';
 import { ContactSearchParams, ContactSearchResponse, Contacts } from './resources/contacts';
-import { MessageSearchParams, MessageSendParams, MessageSendResponse, Messages } from './resources/messages';
+import {
+  MessageListParams,
+  MessageSearchParams,
+  MessageSendParams,
+  MessageSendResponse,
+  Messages,
+} from './resources/messages';
 import { Token, UserInfo } from './resources/token';
 import {
   Chat,
   ChatArchiveParams,
   ChatCreateParams,
   ChatCreateResponse,
+  ChatListParams,
+  ChatListResponse,
+  ChatListResponsesCursor,
   ChatRetrieveParams,
   ChatSearchParams,
   Chats,
@@ -805,7 +814,7 @@ export class BeeperDesktop {
   static toFile = Uploads.toFile;
 
   /**
-   * Accounts operations
+   * Manage connected chat accounts
    */
   accounts: API.Accounts = new API.Accounts(this);
   /**
@@ -859,16 +868,20 @@ export declare namespace BeeperDesktop {
     Chats as Chats,
     type Chat as Chat,
     type ChatCreateResponse as ChatCreateResponse,
+    type ChatListResponse as ChatListResponse,
+    type ChatListResponsesCursor as ChatListResponsesCursor,
     type ChatsCursor as ChatsCursor,
     type ChatCreateParams as ChatCreateParams,
     type ChatRetrieveParams as ChatRetrieveParams,
+    type ChatListParams as ChatListParams,
     type ChatArchiveParams as ChatArchiveParams,
     type ChatSearchParams as ChatSearchParams,
   };
 
   export {
     Messages as Messages,
     type MessageSendResponse as MessageSendResponse,
+    type MessageListParams as MessageListParams,
     type MessageSearchParams as MessageSearchParams,
     type MessageSendParams as MessageSendParams,
   };

src/resources/accounts.ts

@@ -6,7 +6,7 @@ import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 
 /**
- * Accounts operations
+ * Manage connected chat accounts
  */
 export class Accounts extends APIResource {
   /**

src/resources/chats/chats.ts

@@ -51,6 +51,25 @@ export class Chats extends APIResource {
     return this._client.get(path`/v1/chats/${chatID}`, { query, ...options });
   }
 
+  /**
+   * List all chats sorted by last activity (most recent first). Combines all
+   * accounts into a single paginated list.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const chatListResponse of client.chats.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ChatListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ChatListResponsesCursor, ChatListResponse> {
+    return this._client.getAPIList('/v1/chats', Cursor<ChatListResponse>, { query, ...options });
+  }
+
   /**
    * Archive or unarchive a chat. Set archived=true to move to archive,
    * archived=false to move back to inbox
@@ -90,6 +109,8 @@ export class Chats extends APIResource {
   }
 }
 
+export type ChatListResponsesCursor = Cursor<ChatListResponse>;
+
 export type ChatsCursor = Cursor<Chat>;
 
 export interface Chat {
@@ -189,6 +210,13 @@ export interface ChatCreateResponse extends Shared.BaseResponse {
   chatID?: string;
 }
 
+export interface ChatListResponse extends Chat {
+  /**
+   * Last message preview for this chat, if available.
+   */
+  preview?: Shared.Message;
+}
+
 export interface ChatCreateParams {
   /**
    * Account to create the chat on.
@@ -225,6 +253,13 @@ export interface ChatRetrieveParams {
   maxParticipantCount?: number | null;
 }
 
+export interface ChatListParams extends CursorParams {
+  /**
+   * Limit to specific account IDs. If omitted, fetches from all accounts.
+   */
+  accountIDs?: Array<string>;
+}
+
 export interface ChatArchiveParams {
   /**
    * True to archive, false to unarchive
@@ -293,9 +328,12 @@ export declare namespace Chats {
   export {
     type Chat as Chat,
     type ChatCreateResponse as ChatCreateResponse,
+    type ChatListResponse as ChatListResponse,
+    type ChatListResponsesCursor as ChatListResponsesCursor,
     type ChatsCursor as ChatsCursor,
     type ChatCreateParams as ChatCreateParams,
     type ChatRetrieveParams as ChatRetrieveParams,
+    type ChatListParams as ChatListParams,
     type ChatArchiveParams as ChatArchiveParams,
     type ChatSearchParams as ChatSearchParams,
   };