chore: update protocol

Author: sowelipililimute

content/docs/protocol.auth.v1.md

@@ -111,7 +111,18 @@ Begins an authentication session
 ##### <span class="codicon codicon-symbol-structure symbol-structure"></span>BeginAuthRequest
 Used in `BeginAuth` endpoint.
 
-This item has no fields.
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>for_guest_token
+Type: optional `string`
+
+If provided, this is the guest token
+for the account being upgraded from
+a guest account to a full account
+during the auth flow.
+
+This token is provided by the server
+at the end of the auth flow that
+created the guest account.
 
 
 <br/>
@@ -246,6 +257,24 @@ user_id: the ID of the user you logged in as
 Type: optional `string`
 
 session_token: the session token to use in authorization
+### <span class="codicon codicon-symbol-field symbol-field"></span>guest_token
+Type: optional `string`
+
+A token allowing for this account to be upgraded to a
+"full" account by beginning an auth session and providing
+this token.
+
+The guest token only exists to upgrade a guest account to a full
+account, and does not permit logging in with a guest account
+on more than one session.
+
+A "guest token" MAY be provided to BeginAuth to begin
+an authorization process that will upgrade the guest account
+to a full account if completed successfully.
+This MUST only affect now being able to log
+into the account with more than one session, and MUST not
+change other information about the account, such as username
+and password.
 
 ------
 ## <span class="codicon codicon-symbol-structure symbol-structure"></span>AuthStep

content/docs/protocol.bots.v1.md

@@ -0,0 +1,255 @@
+---
+title: "Reference: protocol.bots.v1"
+---
+## Bot Invite Codes
+
+Bot invite codes work similarly to HMC URLs.
+They can either be server+code or just code,
+to refer to a bot on the current homeserver.
+
+The format for an invite code is:
+> [url[:port]/]code
+
+where `code` is a purely alphanumeric code.
+
+# Services 
+
+## <span class="codicon codicon-symbol-class symbol-class"></span>BotsService
+
+The Bots service allows the management of bot accounts
+<span class="h3" aria-level="3">Fields</span>
+#### <span class="codicon codicon-symbol-method symbol-method"></span>MyBots
+[protocol.bots.v1.MyBotsRequest](#mybotsrequest) -> [protocol.bots.v1.MyBotsResponse](#mybotsresponse)
+
+Gets the list of bots that you own
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>MyBotsRequest
+Request type for MyBots
+
+This item has no fields.
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>MyBotsResponse
+Response type for MyBots
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>bots
+Type: repeated [protocol.bots.v1.Bot](#bot)
+
+The list of owned bots
+
+------
+#### <span class="codicon codicon-symbol-method symbol-method"></span>GetBot
+[protocol.bots.v1.GetBotRequest](#getbotrequest) -> [protocol.bots.v1.GetBotResponse](#getbotresponse)
+
+Gets information on a given bot
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>GetBotRequest
+Request type for GetBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>bot_id
+Type: optional `uint64`
+
+The bot to get the information of
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>GetBotResponse
+Response type for GetBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>bot
+Type: optional [protocol.bots.v1.Bot](#bot)
+
+The requested bot
+
+------
+#### <span class="codicon codicon-symbol-method symbol-method"></span>CreateBot
+[protocol.bots.v1.CreateBotRequest](#createbotrequest) -> [protocol.bots.v1.CreateBotResponse](#createbotresponse)
+
+Creates a new bot account
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>CreateBotRequest
+Request type for CreateBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>display_name
+Type: optional `string`
+
+The bot's display name
+###### <span class="codicon codicon-symbol-field symbol-field"></span>avatar_url
+Type: optional `string`
+
+The bot's avatar URL
+###### <span class="codicon codicon-symbol-field symbol-field"></span>invite
+Type: optional `string`
+
+The bot's invite code, if it has one
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>CreateBotResponse
+Response type for CreateBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>bot_id
+Type: optional `uint64`
+
+The newly minted ID of the bot
+
+------
+#### <span class="codicon codicon-symbol-method symbol-method"></span>EditBot
+[protocol.bots.v1.EditBotRequest](#editbotrequest) -> [protocol.bots.v1.EditBotResponse](#editbotresponse)
+
+Modifies a bot account that you own
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>EditBotRequest
+Request type for EditBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>bot_id
+Type: optional `uint64`
+
+The ID of the bot to edit
+###### <span class="codicon codicon-symbol-field symbol-field"></span>new_display_name
+Type: optional `string`
+
+The bot's new display name
+###### <span class="codicon codicon-symbol-field symbol-field"></span>new_avatar_url
+Type: optional `string`
+
+The bot's new avatar URL
+###### <span class="codicon codicon-symbol-field symbol-field"></span>invite
+Type: optional `string`
+
+The bot's new invite code
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>EditBotResponse
+Response type for EditBot
+
+This item has no fields.
+
+------
+#### <span class="codicon codicon-symbol-method symbol-method"></span>DeleteBot
+[protocol.bots.v1.DeleteBotRequest](#deletebotrequest) -> [protocol.bots.v1.DeleteBotResponse](#deletebotresponse)
+
+Deletes a bot account that you own
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>DeleteBotRequest
+Request type for DeleteBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>bot_id
+Type: optional `uint64`
+
+The bot to delete
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>DeleteBotResponse
+Response type for DeleteBot
+
+This item has no fields.
+
+------
+#### <span class="codicon codicon-symbol-method symbol-method"></span>Policies
+[protocol.bots.v1.PoliciesRequest](#policiesrequest) -> [protocol.bots.v1.PoliciesResponse](#policiesresponse)
+
+Server policies for bot accounts that the client
+may display in its UI or restrict actions to prevent
+request errors
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>PoliciesRequest
+Request type for Policies
+
+This item has no fields.
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>PoliciesResponse
+Response type for Policies
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>max_bots
+Type: optional `uint32`
+
+How many bots an individual account is allowed to own
+
+------
+#### <span class="codicon codicon-symbol-method symbol-method"></span>AddBot
+[protocol.bots.v1.AddBotRequest](#addbotrequest) -> [protocol.bots.v1.AddBotResponse](#addbotresponse)
+
+Requests a bot to add itself to the guild.
+
+For cross-server bots, this dispatches a UserInvited
+request across sync, inviting the bot to the guild.
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>AddBotRequest
+Request type for AddBot
+
+<span class="h5" aria-level="5">Fields</span>
+###### <span class="codicon codicon-symbol-field symbol-field"></span>guild_id
+Type: optional `uint64`
+
+The guild to add the bot to
+###### <span class="codicon codicon-symbol-field symbol-field"></span>invite_code
+Type: optional `string`
+
+The bot's invite code.
+
+
+<br/>
+
+##### <span class="codicon codicon-symbol-structure symbol-structure"></span>AddBotResponse
+Response type for AddBot
+
+This item has no fields.
+
+# Standalone Message Types 
+
+## <span class="codicon codicon-symbol-structure symbol-structure"></span>Bot
+A description of a bot account
+
+<span class="h3" aria-level="3">Fields</span>
+### <span class="codicon codicon-symbol-field symbol-field"></span>bot_id
+Type: optional `uint64`
+
+The ID of the bot
+### <span class="codicon codicon-symbol-field symbol-field"></span>display_name
+Type: optional `string`
+
+The bot's display name
+### <span class="codicon codicon-symbol-field symbol-field"></span>avatar_url
+Type: optional `string`
+
+The bot's avatar URL
+### <span class="codicon codicon-symbol-field symbol-field"></span>invite
+Type: optional `string`
+
+The bot's invite code, if it has one
+
+------

content/docs/protocol.mediaproxy.v1.md

@@ -149,5 +149,13 @@ Mimetype of the media.
 Type: optional `string`
 
 Filename of the media.
+### <span class="codicon codicon-symbol-field symbol-field"></span>size
+Type: optional `uint32`
+
+Sıze of the media.
+
+This should (usually) be the size taken from the `Content-Length` header
+(for HTTP requests).
+If this is not included, then it means the size could not be determined.
 
 ------

content/docs/protocol.profile.v1.md

@@ -62,7 +62,10 @@ new status of the user.
 ###### <span class="codicon codicon-symbol-field symbol-field"></span>new_is_bot
 Type: optional `bool`
 
-new whether the user is a bot or not.
+new whether the user is a bot or not
+
+Deprecated; see bot service and guest handling
+in auth.
 
 
 <br/>
@@ -208,7 +211,11 @@ the status of the user.
 ### <span class="codicon codicon-symbol-field symbol-field"></span>is_bot
 Type: optional `bool`
 
-whether the user is a bot or not.
+whether the user is a bot or not
+### <span class="codicon codicon-symbol-field symbol-field"></span>account_kind
+Type: UNHANDLED | TYPE
+
+what kind of account the user is, e.g. full, guest, bot
 
 ------
 ## <span class="codicon codicon-symbol-structure symbol-structure"></span>ProfileUpdated
@@ -238,6 +245,11 @@ New status for this user.
 Type: optional `bool`
 
 New is bot or not for this user.
+Deprecated, prefer new_account_kind if set.
+### <span class="codicon codicon-symbol-field symbol-field"></span>new_account_kind
+Type: UNHANDLED | TYPE
+
+The new account kind for this account
 
 ------
 ## <span class="codicon codicon-symbol-structure symbol-structure"></span>StreamEvent
@@ -272,3 +284,16 @@ User is on mobile.
 ### <span class="codicon codicon-symbol-enum-member symbol-enum-member"></span>USER_STATUS_STREAMING
 User is streaming
 
+------
+## <span class="codicon codicon-symbol-enum symbol-enum"></span>AccountKind
+
+The possible kinds of an account
+### <span class="codicon codicon-symbol-enum-member symbol-enum-member"></span>ACCOUNT_KIND_FULL_UNSPECIFIED
+The account is a full-fledged account controlled by a human
+
+### <span class="codicon codicon-symbol-enum-member symbol-enum-member"></span>ACCOUNT_KIND_BOT
+The account is an account controlled by a bot
+
+### <span class="codicon codicon-symbol-enum-member symbol-enum-member"></span>ACCOUNT_KIND_GUEST
+The account is a guest account controlled by a human
+