feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-ee25e67fc85ccc86cedb2ca0865385709877582132103e0afa68d7b43551784a.yml
-openapi_spec_hash: d41fd99c9a8645a1fd69c519cd25a637
-config_hash: 07a9227b2e53d5bf022c964ac30d72fa
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-1b8324f05cd39e88cfc36b9b86a868b6f7e0c9e0827bb30d70a6d875c151ae52.yml
+openapi_spec_hash: 41410e315f6a3d0be787ece9e4fcb96a
+config_hash: abdcaeff62a619bdf25d727cdeacf3b0

pkg/cmd/chat.go

@@ -15,19 +15,63 @@ import (
 	"github.com/urfave/cli/v3"
 )
 
-var chatsCreate = cli.Command{
+var chatsCreate = requestflag.WithInnerFlags(cli.Command{
 	Name:    "create",
 	Usage:   "Create a single/group chat (mode='create') or start a direct chat from merged\nuser data (mode='start').",
 	Suggest: true,
 	Flags: []cli.Flag{
 		&requestflag.Flag[map[string]any]{
 			Name:     "chat",
+			Required: true,
 			BodyRoot: true,
 		},
 	},
 	Action:          handleChatsCreate,
 	HideHelpCommand: true,
-}
+}, map[string][]requestflag.HasOuterFlag{
+	"chat": {
+		&requestflag.InnerFlag[string]{
+			Name:       "chat.account-id",
+			Usage:      "Account to create or start the chat on.",
+			InnerField: "accountID",
+		},
+		&requestflag.InnerFlag[bool]{
+			Name:       "chat.allow-invite",
+			Usage:      "Whether invite-based DM creation is allowed when required by the platform. Used for mode='start'.",
+			InnerField: "allowInvite",
+		},
+		&requestflag.InnerFlag[string]{
+			Name:       "chat.message-text",
+			Usage:      "Optional first message content if the platform requires it to create the chat.",
+			InnerField: "messageText",
+		},
+		&requestflag.InnerFlag[string]{
+			Name:       "chat.mode",
+			Usage:      "Operation mode. Defaults to 'create' when omitted.",
+			InnerField: "mode",
+		},
+		&requestflag.InnerFlag[[]string]{
+			Name:       "chat.participant-ids",
+			Usage:      "Required when mode='create'. User IDs to include in the new chat.",
+			InnerField: "participantIDs",
+		},
+		&requestflag.InnerFlag[string]{
+			Name:       "chat.title",
+			Usage:      "Optional title for group chats when mode='create'; ignored for single chats on most platforms.",
+			InnerField: "title",
+		},
+		&requestflag.InnerFlag[string]{
+			Name:       "chat.type",
+			Usage:      "Required when mode='create'. 'single' requires exactly one participantID; 'group' supports multiple participants and optional title.",
+			InnerField: "type",
+		},
+		&requestflag.InnerFlag[map[string]any]{
+			Name:       "chat.user",
+			Usage:      "Required when mode='start'. Merged user-like contact payload used to resolve the best identifier.",
+			InnerField: "user",
+		},
+	},
+})
 
 var chatsRetrieve = cli.Command{
 	Name:    "retrieve",

pkg/cmd/chat_test.go

@@ -6,13 +6,31 @@ import (
 	"testing"
 
 	"github.com/beeper/desktop-api-cli/internal/mocktest"
+	"github.com/beeper/desktop-api-cli/internal/requestflag"
 )
 
 func TestChatsCreate(t *testing.T) {
 	mocktest.TestRunMockTestWithFlags(
 		t,
 		"chats", "create",
-		"--chat", "{accountID: accountID, participantIDs: [string], type: single, messageText: messageText, mode: create, title: title}",
+		"--chat", "{accountID: accountID, allowInvite: true, messageText: messageText, mode: create, participantIDs: [string], title: title, type: single, user: {id: id, email: email, fullName: fullName, phoneNumber: phoneNumber, username: username}}",
+	)
+
+	// Check that inner flags have been set up correctly
+	requestflag.CheckInnerFlags(chatsCreate)
+
+	// Alternative argument passing style using inner flags
+	mocktest.TestRunMockTestWithFlags(
+		t,
+		"chats", "create",
+		"--chat.account-id", "accountID",
+		"--chat.allow-invite=true",
+		"--chat.message-text", "messageText",
+		"--chat.mode", "create",
+		"--chat.participant-ids", "[string]",
+		"--chat.title", "title",
+		"--chat.type", "single",
+		"--chat.user", "{id: id, email: email, fullName: fullName, phoneNumber: phoneNumber, username: username}",
 	)
 }