feat(api): update via SDK Studio

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 13
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-10508b7bd52381c216ed2584b7b0894f70fcc97fbd7f86792e78f72d108157c5.yml
-openapi_spec_hash: d5f07fd2a363877f4c72da1187b8aaf1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-b81d5fe4f2baa8712e836253bbe1b2dac923e8cae22c8354725a7bbb80ac28bb.yml
+openapi_spec_hash: 147d897197c083303459f0973895e69f
 config_hash: 7069b7e0f261442a13c7367bdc04f880

src/App/AppFocusParams.php

@@ -10,11 +10,7 @@
 use BeeperDesktop\Core\Contracts\BaseModel;
 
 /**
- * Bring Beeper Desktop to the foreground on this device. Optionally focuses a specific chat if chatID is provided.
- * - When to use: open Beeper, or jump to a specific chat.
- * - Constraints: requires Beeper Desktop running locally; no-op in headless environments.
- * - Idempotent: safe to call repeatedly. Returns an error if chatID is not found.
- * Returns: success.
+ * Bring Beeper Desktop to the foreground on this device.
  */
 final class AppFocusParams implements BaseModel
 {

src/Chats/ChatFindParams.php

@@ -13,11 +13,6 @@
 
 /**
  * Search and filter conversations across all messaging accounts.
- * - When to use: browse chats by inbox (primary/low-priority/archive), type, unread status, or search terms.
- * - Pagination: use cursor + direction for pagination.
- * - Performance: provide accountIDs when known for faster filtering.
- * Returns: matching chats with pagination.
- * Agents: ALWAYS use linkToChat to make clickable links in your response.
  */
 final class ChatFindParams implements BaseModel
 {

src/Chats/ChatRetrieveParams.php

@@ -10,10 +10,7 @@
 use BeeperDesktop\Core\Contracts\BaseModel;
 
 /**
- * Retrieve chat details: metadata, participants (limited), and latest message.
- * - When to use: fetch a complete view of a chat beyond what search returns.
- * - Constraints: not available for iMessage chats ('imsg##'). Participants limited by 'maxParticipantCount' (default 20, max 500).
- * Returns: chat details.Agents: ALWAYS use linkToChat to make clickable links in your response.
+ * Retrieve chat details including metadata, participants, and latest message.
  */
 final class ChatRetrieveParams implements BaseModel
 {

src/Messages/MessageSearchParams.php

@@ -13,20 +13,6 @@
 
 /**
  * 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.
- *   • ✅ RIGHT: query="dinner" or query="sick" or query="error" (single words users type)
- *   • ❌ WRONG: query="dinner plans tonight" or query="health issues" (phrases/concepts)
- *   • The query matches ALL words provided (in any order). Example: query="flight booking" finds messages with both "flight" AND "booking".
- * - Media filters: Use onlyWithMedia for any media, or specific filters like onlyWithVideo, onlyWithImage, onlyWithLink, onlyWithFile for specific types.
- * - Pagination: use 'oldestCursor' + direction='before' for older; 'newestCursor' + direction='after' for newer.
- * - Performance: provide chatIDs/accountIDs when known. Omitted 'query' returns results based on filters only. Partial matches enabled; 'excludeLowPriority' defaults to true.
- * - Workflow tip: To search messages in specific conversations: 1) Use find-chats to get chatIDs, 2) Use search-messages with those chatIDs.
- * - IMPORTANT: Chat names vary widely. ASK the user for clarification:
- *   • "Which chat do you mean by family?" (could be "The Smiths", "Mom Dad Kids", etc.)
- *   • "What's the name of your work chat?" (could be "Team", company name, project name)
- *   • "Who are the participants?" (use participantQuery in find-chats)
- * Returns: matching messages and referenced chats.
  */
 final class MessageSearchParams implements BaseModel
 {

src/Services/AccountsService.php

@@ -19,9 +19,6 @@ public function __construct(private Client $client) {}
 
     /**
      * List connected Beeper accounts available on this device.
-     * - When to use: select account context before account-scoped operations.
-     * - Scope: only accounts currently Connected on this device are included.
-     * Returns: connected accounts.
      */
     public function list(
         ?RequestOptions $requestOptions = null

src/Services/AppService.php

@@ -20,11 +20,7 @@ final class AppService implements AppContract
     public function __construct(private Client $client) {}
 
     /**
-     * Bring Beeper Desktop to the foreground on this device. Optionally focuses a specific chat if chatID is provided.
-     * - When to use: open Beeper, or jump to a specific chat.
-     * - Constraints: requires Beeper Desktop running locally; no-op in headless environments.
-     * - Idempotent: safe to call repeatedly. Returns an error if chatID is not found.
-     * Returns: success.
+     * Bring Beeper Desktop to the foreground on this device.
      *
      * @param string $chatID Optional Beeper chat ID to focus after bringing the app to foreground. If omitted, only foregrounds the app. Required if messageSortKey is present. No-op in headless environments.
      * @param string $messageSortKey Optional message sort key. Jumps to that message in the chat when foregrounding.

src/Services/ChatsService.php

@@ -28,10 +28,7 @@ final class ChatsService implements ChatsContract
     public function __construct(private Client $client) {}
 
     /**
-     * Retrieve chat details: metadata, participants (limited), and latest message.
-     * - When to use: fetch a complete view of a chat beyond what search returns.
-     * - Constraints: not available for iMessage chats ('imsg##'). Participants limited by 'maxParticipantCount' (default 20, max 500).
-     * Returns: chat details.Agents: ALWAYS use linkToChat to make clickable links in your response.
+     * Retrieve chat details including metadata, participants, and latest message.
      *
      * @param string $chatID Unique identifier of the chat to retrieve. Not available for iMessage chats. Participants are limited by 'maxParticipantCount'.
      * @param int|null $maxParticipantCount Maximum number of participants to return. Use -1 for all; otherwise 0–500. Defaults to 20.
@@ -90,11 +87,6 @@ public function archive(
 
     /**
      * Search and filter conversations across all messaging accounts.
-     * - When to use: browse chats by inbox (primary/low-priority/archive), type, unread status, or search terms.
-     * - Pagination: use cursor + direction for pagination.
-     * - Performance: provide accountIDs when known for faster filtering.
-     * Returns: matching chats with pagination.
-     * Agents: ALWAYS use linkToChat to make clickable links in your response.
      *
      * @param list<string> $accountIDs Provide an array of account IDs to filter chats from specific messaging accounts only
      * @param string $endingBefore A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.

src/Services/MessagesService.php

@@ -57,20 +57,6 @@ public function draft(
 
     /**
      * 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.
-     *   • ✅ RIGHT: query="dinner" or query="sick" or query="error" (single words users type)
-     *   • ❌ WRONG: query="dinner plans tonight" or query="health issues" (phrases/concepts)
-     *   • The query matches ALL words provided (in any order). Example: query="flight booking" finds messages with both "flight" AND "booking".
-     * - Media filters: Use onlyWithMedia for any media, or specific filters like onlyWithVideo, onlyWithImage, onlyWithLink, onlyWithFile for specific types.
-     * - Pagination: use 'oldestCursor' + direction='before' for older; 'newestCursor' + direction='after' for newer.
-     * - Performance: provide chatIDs/accountIDs when known. Omitted 'query' returns results based on filters only. Partial matches enabled; 'excludeLowPriority' defaults to true.
-     * - Workflow tip: To search messages in specific conversations: 1) Use find-chats to get chatIDs, 2) Use search-messages with those chatIDs.
-     * - IMPORTANT: Chat names vary widely. ASK the user for clarification:
-     *   • "Which chat do you mean by family?" (could be "The Smiths", "Mom Dad Kids", etc.)
-     *   • "What's the name of your work chat?" (could be "Team", company name, project name)
-     *   • "Who are the participants?" (use participantQuery in find-chats)
-     * Returns: matching messages and referenced chats.
      *
      * @param list<string> $accountIDs limit search to specific Beeper account IDs (bridge instances)
      * @param list<string> $chatIDs limit search to specific Beeper chat IDs