release: 4.1.293 (#14)

* chore: do not install brew dependencies in ./scripts/bootstrap by default

* feat(mcp): enable experimental docs search tool

* feat(mcp): add option for including docs tools

* perf: faster formatting

* chore(internal): remove deprecated `compilerOptions.baseUrl` from tsconfig.json

This allows sdks to be built using tsgo - see microsoft/typescript-go#474

* chore(internal): fix incremental formatting in some cases

* chore(mcp): allow pointing `docs_search` tool at other URLs

* chore(internal): codegen related update

* chore(internal): ignore .eslintcache

* fix(mcp): fix cli argument parsing logic

* fix(mcp): resolve a linting issue in server code

* chore: update lockfile

* chore(internal): remove .eslintcache

* chore(internal): codegen related update

* chore(jsdoc): fix @link annotations to refer only to parts of the package‘s public interface

* chore(internal): use npm pack for build uploads

* feat(api): manual updates

* chore: configure new SDK language

* codegen metadata

* feat(api): manual updates

* chore: configure new SDK language

* codegen metadata

* codegen metadata

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* codegen metadata

* codegen metadata

* codegen metadata

* feat(api): remove limit from list routes

* feat(api): manual updates

* codegen metadata

* feat(api): manual updates

* feat(api): manual updates

* feat(api): revert work in progress changes

* feat(api): bump for new endpoints

* codegen metadata

* release: 4.1.293

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/release-doctor.yml

@@ -19,3 +19,4 @@ jobs:
           bash ./bin/check-release-environment
         env:
           NPM_TOKEN: ${{ secrets.BEEPER_DESKTOP_NPM_TOKEN || secrets.NPM_TOKEN }}
+

.gitignore

@@ -7,5 +7,6 @@ dist
 dist-deno
 /*.tgz
 .idea/
+.eslintcache
 dist-bundle
 *.mcpb

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.5"
+  ".": "4.1.293"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-8c712fe19f280b0b89ecc8a3ce61e9f6b165cee97ce33f66c66a7a5db339c755.yml
-openapi_spec_hash: 1ea71129cc1a1ccc3dc8a99566082311
-config_hash: 061b75b88f80bb43b4121e5e7c1255e2
+configured_endpoints: 15
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-0763b61997721da6f4514241bf0f7bb5f7a88c7298baf0f1b2d58036aaf7e2f1.yml
+openapi_spec_hash: 5158475919c04bb52fb03c6a4582188d
+config_hash: 15424d9ae390c7fca17dbf08619fc88b

CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 4.1.293 (2025-10-16)
+
+Full Changelog: [v0.1.5...v4.1.293](https://github.com/beeper/desktop-api-js/compare/v0.1.5...v4.1.293)
+
+### Features
+
+* **api:** bump for new endpoints ([8b4b937](https://github.com/beeper/desktop-api-js/commit/8b4b9379cc2bf313e684e4883996274cb3c45624))
+* **api:** manual updates ([f35c718](https://github.com/beeper/desktop-api-js/commit/f35c71843c8d3692e2cf9d5d3f060b925653ea12))
+* **api:** manual updates ([41bbaa1](https://github.com/beeper/desktop-api-js/commit/41bbaa182be124d0bd0b5cf5265b3fa2793bc0e1))
+* **api:** manual updates ([27afe3a](https://github.com/beeper/desktop-api-js/commit/27afe3a031672191b4837e996f11c6425c0c692f))
+* **api:** manual updates ([e12ab16](https://github.com/beeper/desktop-api-js/commit/e12ab16a4664ef6b770750225dc0e9ea53005b89))
+* **api:** manual updates ([914badc](https://github.com/beeper/desktop-api-js/commit/914badc5d98d1b3ab5b7d1b404c687110ef34913))
+* **api:** manual updates ([e657efe](https://github.com/beeper/desktop-api-js/commit/e657efe6bf48b6c76e09060ac00c8e0403213982))
+* **api:** manual updates ([0de85a3](https://github.com/beeper/desktop-api-js/commit/0de85a39f784415474e73187609e4ef4c5fe2cf1))
+* **api:** manual updates ([d7c35d2](https://github.com/beeper/desktop-api-js/commit/d7c35d27538be9752a6e15a4d17c4b5354b44b3f))
+* **api:** manual updates ([80f8804](https://github.com/beeper/desktop-api-js/commit/80f880478414edcba479e4717c5a1033a2545d3d))
+* **api:** manual updates ([e404d7e](https://github.com/beeper/desktop-api-js/commit/e404d7ebd08830f115f7468598cc275db637d508))
+* **api:** manual updates ([540c168](https://github.com/beeper/desktop-api-js/commit/540c168bfa982178e5ab743c9ef3986784438617))
+* **api:** manual updates ([3501ff9](https://github.com/beeper/desktop-api-js/commit/3501ff900847979fcf7b6e543a99364b74a979a5))
+* **api:** manual updates ([d1a5970](https://github.com/beeper/desktop-api-js/commit/d1a5970f917e9ddfe1060a4129feee7bb1be1414))
+* **api:** remove limit from list routes ([c145154](https://github.com/beeper/desktop-api-js/commit/c1451540df373793b5fd90e780faab8acf38a1dc))
+* **api:** revert work in progress changes ([50eb07e](https://github.com/beeper/desktop-api-js/commit/50eb07e2412770c28316f25349a6894dfca88004))
+* **mcp:** add option for including docs tools ([a521cb8](https://github.com/beeper/desktop-api-js/commit/a521cb8f972778c0253b657b712da7681dd78853))
+* **mcp:** enable experimental docs search tool ([c349699](https://github.com/beeper/desktop-api-js/commit/c349699a05745356ce3d12dc693d643a85a52d5d))
+
+
+### Bug Fixes
+
+* **mcp:** fix cli argument parsing logic ([98c6489](https://github.com/beeper/desktop-api-js/commit/98c6489b8780dbe7d4ba377fb64364fb862fc7f7))
+* **mcp:** resolve a linting issue in server code ([2c84441](https://github.com/beeper/desktop-api-js/commit/2c8444166c9b4e6f67c9bf4827989aee65d672e8))
+
+
+### Performance Improvements
+
+* faster formatting ([a4321bf](https://github.com/beeper/desktop-api-js/commit/a4321bf9c91f3043414724486c130f3b0bd25606))
+
+
+### Chores
+
+* configure new SDK language ([f50310b](https://github.com/beeper/desktop-api-js/commit/f50310b4a7cc3e2286430530c8ffc867f77f7ef9))
+* configure new SDK language ([fee94ba](https://github.com/beeper/desktop-api-js/commit/fee94ba4b23ec91abc030ddbb872c08af43e2df8))
+* do not install brew dependencies in ./scripts/bootstrap by default ([cd62f83](https://github.com/beeper/desktop-api-js/commit/cd62f83fc5e6e93501df72cf49c0ee2838e02476))
+* fix changelog with actual entries ([45de3f5](https://github.com/beeper/desktop-api-js/commit/45de3f5a1d86486b9752e32cbd5283d6efe88434))
+* **internal:** codegen related update ([3598172](https://github.com/beeper/desktop-api-js/commit/3598172f0839f111c6000c9f29502d21afabee0c))
+* **internal:** codegen related update ([44137d6](https://github.com/beeper/desktop-api-js/commit/44137d644ffcd7407acc815a68d8df093e17f45d))
+* **internal:** fix incremental formatting in some cases ([697d742](https://github.com/beeper/desktop-api-js/commit/697d742608fead14c628f5d809b6a4beedff4656))
+* **internal:** ignore .eslintcache ([22d7f29](https://github.com/beeper/desktop-api-js/commit/22d7f29cd477bf4d22c68b51cd4b99bcf710efbd))
+* **internal:** remove .eslintcache ([f2a0dfb](https://github.com/beeper/desktop-api-js/commit/f2a0dfbd7930292f715ab530a6dedbf53e6ae8e3))
+* **internal:** remove deprecated `compilerOptions.baseUrl` from tsconfig.json ([ffaa6d6](https://github.com/beeper/desktop-api-js/commit/ffaa6d646236e88ecf997dc9a0b77733029a885b))
+* **internal:** use npm pack for build uploads ([31e0341](https://github.com/beeper/desktop-api-js/commit/31e0341efbad7c4b9abc13d145c477eb3676cc0b))
+* **jsdoc:** fix [@link](https://github.com/link) annotations to refer only to parts of the package‘s public interface ([8cf89a9](https://github.com/beeper/desktop-api-js/commit/8cf89a9e31969a45d24179342955b2a4e931ae6f))
+* **mcp:** allow pointing `docs_search` tool at other URLs ([6044c34](https://github.com/beeper/desktop-api-js/commit/6044c3467dd578e2fba46fa10f83ad3240222c3f))
+* update lockfile ([a9a736f](https://github.com/beeper/desktop-api-js/commit/a9a736fba58dde3c39bc2f5501be1ae30f380367))
+
 ## 0.1.5 (2025-09-19)
 
 Full Changelog: [v0.1.4...v0.1.5](https://github.com/beeper/desktop-api-js/compare/v0.1.4...v0.1.5)

README.md

@@ -55,17 +55,15 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const response = await client.messages
-  .send({ chatID: '1229391', text: 'Hello! Just checking in on the project status.' })
-  .catch(async (err) => {
-    if (err instanceof BeeperDesktop.APIError) {
-      console.log(err.status); // 400
-      console.log(err.name); // BadRequestError
-      console.log(err.headers); // {server: 'nginx', ...}
-    } else {
-      throw err;
-    }
-  });
+const accounts = await client.accounts.list().catch(async (err) => {
+  if (err instanceof BeeperDesktop.APIError) {
+    console.log(err.status); // 400
+    console.log(err.name); // BadRequestError
+    console.log(err.headers); // {server: 'nginx', ...}
+  } else {
+    throw err;
+  }
+});
 ```
 
 Error codes are as follows:

api.md

@@ -1,9 +1,20 @@
+# BeeperDesktop
+
+Types:
+
+- <code><a href="./src/resources/top-level.ts">FocusResponse</a></code>
+- <code><a href="./src/resources/top-level.ts">SearchResponse</a></code>
+
+Methods:
+
+- <code title="post /v1/focus">client.<a href="./src/index.ts">focus</a>({ ...params }) -> FocusResponse</code>
+- <code title="get /v1/search">client.<a href="./src/index.ts">search</a>({ ...params }) -> SearchResponse</code>
+
 # Shared
 
 Types:
 
 - <code><a href="./src/resources/shared.ts">Attachment</a></code>
-- <code><a href="./src/resources/shared.ts">BaseResponse</a></code>
 - <code><a href="./src/resources/shared.ts">Error</a></code>
 - <code><a href="./src/resources/shared.ts">Message</a></code>
 - <code><a href="./src/resources/shared.ts">Reaction</a></code>
@@ -13,57 +24,45 @@ Types:
 
 Types:
 
-- <code><a href="./src/resources/accounts.ts">Account</a></code>
-- <code><a href="./src/resources/accounts.ts">AccountListResponse</a></code>
-
-Methods:
-
-- <code title="get /v0/get-accounts">client.accounts.<a href="./src/resources/accounts.ts">list</a>() -> AccountListResponse</code>
-
-# App
-
-Types:
-
-- <code><a href="./src/resources/app.ts">AppDownloadAssetResponse</a></code>
-- <code><a href="./src/resources/app.ts">AppOpenResponse</a></code>
-- <code><a href="./src/resources/app.ts">AppSearchResponse</a></code>
+- <code><a href="./src/resources/accounts/accounts.ts">Account</a></code>
+- <code><a href="./src/resources/accounts/accounts.ts">AccountListResponse</a></code>
 
 Methods:
 
-- <code title="post /v0/download-asset">client.app.<a href="./src/resources/app.ts">downloadAsset</a>({ ...params }) -> AppDownloadAssetResponse</code>
-- <code title="post /v0/open-app">client.app.<a href="./src/resources/app.ts">open</a>({ ...params }) -> AppOpenResponse</code>
-- <code title="get /v0/search">client.app.<a href="./src/resources/app.ts">search</a>({ ...params }) -> AppSearchResponse</code>
+- <code title="get /v1/accounts">client.accounts.<a href="./src/resources/accounts/accounts.ts">list</a>() -> AccountListResponse</code>
 
-# Contacts
+## Contacts
 
 Types:
 
-- <code><a href="./src/resources/contacts.ts">ContactSearchResponse</a></code>
+- <code><a href="./src/resources/accounts/contacts.ts">ContactSearchResponse</a></code>
 
 Methods:
 
-- <code title="get /v0/search-users">client.contacts.<a href="./src/resources/contacts.ts">search</a>({ ...params }) -> ContactSearchResponse</code>
+- <code title="get /v1/accounts/{accountID}/contacts">client.accounts.contacts.<a href="./src/resources/accounts/contacts.ts">search</a>(accountID, { ...params }) -> ContactSearchResponse</code>
 
 # Chats
 
 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 /v0/create-chat">client.chats.<a href="./src/resources/chats/chats.ts">create</a>({ ...params }) -> ChatCreateResponse</code>
-- <code title="get /v0/get-chat">client.chats.<a href="./src/resources/chats/chats.ts">retrieve</a>({ ...params }) -> Chat</code>
-- <code title="post /v0/archive-chat">client.chats.<a href="./src/resources/chats/chats.ts">archive</a>({ ...params }) -> BaseResponse</code>
-- <code title="get /v0/search-chats">client.chats.<a href="./src/resources/chats/chats.ts">search</a>({ ...params }) -> ChatsCursor</code>
+- <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 }) -> ChatListResponsesCursorNoLimit</code>
+- <code title="post /v1/chats/{chatID}/archive">client.chats.<a href="./src/resources/chats/chats.ts">archive</a>(chatID, { ...params }) -> void</code>
+- <code title="get /v1/chats/search">client.chats.<a href="./src/resources/chats/chats.ts">search</a>({ ...params }) -> ChatsCursorSearch</code>
 
 ## Reminders
 
 Methods:
 
-- <code title="post /v0/set-chat-reminder">client.chats.reminders.<a href="./src/resources/chats/reminders.ts">create</a>({ ...params }) -> BaseResponse</code>
-- <code title="post /v0/clear-chat-reminder">client.chats.reminders.<a href="./src/resources/chats/reminders.ts">delete</a>({ ...params }) -> BaseResponse</code>
+- <code title="post /v1/chats/{chatID}/reminders">client.chats.reminders.<a href="./src/resources/chats/reminders.ts">create</a>(chatID, { ...params }) -> void</code>
+- <code title="delete /v1/chats/{chatID}/reminders">client.chats.reminders.<a href="./src/resources/chats/reminders.ts">delete</a>(chatID) -> void</code>
 
 # Messages
 
@@ -73,16 +72,16 @@ Types:
 
 Methods:
 
-- <code title="get /v0/search-messages">client.messages.<a href="./src/resources/messages.ts">search</a>({ ...params }) -> MessagesCursor</code>
-- <code title="post /v0/send-message">client.messages.<a href="./src/resources/messages.ts">send</a>({ ...params }) -> MessageSendResponse</code>
+- <code title="get /v1/chats/{chatID}/messages">client.messages.<a href="./src/resources/messages.ts">list</a>(chatID, { ...params }) -> MessagesCursorSortKey</code>
+- <code title="get /v1/messages/search">client.messages.<a href="./src/resources/messages.ts">search</a>({ ...params }) -> MessagesCursorSearch</code>
+- <code title="post /v1/chats/{chatID}/messages">client.messages.<a href="./src/resources/messages.ts">send</a>(chatID, { ...params }) -> MessageSendResponse</code>
 
-# Token
+# Assets
 
 Types:
 
-- <code><a href="./src/resources/token.ts">RevokeRequest</a></code>
-- <code><a href="./src/resources/token.ts">UserInfo</a></code>
+- <code><a href="./src/resources/assets.ts">AssetDownloadResponse</a></code>
 
 Methods:
 
-- <code title="get /oauth/userinfo">client.token.<a href="./src/resources/token.ts">info</a>() -> UserInfo</code>
+- <code title="post /v1/assets/download">client.assets.<a href="./src/resources/assets.ts">download</a>({ ...params }) -> AssetDownloadResponse</code>

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeper/desktop-api",
-  "version": "0.1.5",
+  "version": "4.1.293",
   "description": "The official TypeScript library for the Beeper Desktop API",
   "author": "Beeper Desktop <[email protected]>",
   "types": "dist/index.d.ts",

packages/mcp-server/README.md

@@ -180,7 +180,7 @@ http://localhost:3000?client=cursor&capability=tool-name-length%3D40
 import { server, endpoints, init } from "@beeper/desktop-mcp/server";
 
 // import a specific tool
-import getAccounts from "@beeper/desktop-mcp/tools/accounts/get-accounts";
+import focusApp from "@beeper/desktop-mcp/tools/top-level/focus-app";
 
 // initialize the server and all endpoints
 init({ server, endpoints });
@@ -205,21 +205,21 @@ const myCustomEndpoint = {
 };
 
 // initialize the server with your custom endpoints
-init({ server: myServer, endpoints: [getAccounts, myCustomEndpoint] });
+init({ server: myServer, endpoints: [focusApp, myCustomEndpoint] });
 ```
 
 ## Available Tools
 
 The following tools are available in this MCP server.
 
-### Resource `accounts`:
+### Resource `$client`:
 
-- `get_accounts` (`read`) tags: [accounts]: List connected accounts on this device. Use to pick account context.
+- `focus_app` (`write`) tags: [app]: Focus Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment.
+- `search` (`read`) tags: [app]: 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.
 
-### Resource `app`:
+### Resource `accounts`:
 
-- `open_in_app` (`write`) tags: [app]: Open Beeper Desktop and optionally navigate to a specific chat, message, or pre-fill draft text and attachment.
-- `search` (`read`) tags: [app]: 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.
+- `get_accounts` (`read`) tags: [accounts]: List connected accounts on this device.
 
 ### Resource `chats`:
 
@@ -234,6 +234,7 @@ The following tools are available in this MCP server.
 
 ### Resource `messages`:
 
+- `list_messages` (`read`) tags: [messages]: List messages from a specific chat with pagination support.
 - `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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeper/desktop-mcp",
-  "version": "0.1.5",
+  "version": "4.1.293",
   "description": "The official MCP Server for the Beeper Desktop API",
   "author": "Beeper Desktop <[email protected]>",
   "types": "dist/index.d.ts",