@atproto/api 0.9.6 → 0.9.7

package/dist/index.js

@@ -17563,7 +17563,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Provides the DID of a repo.",
+        description: "Resolves a handle (domain name) to a DID.",
         parameters: {
           type: "params",
           required: ["handle"],
@@ -17597,7 +17597,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Updates the handle of the account.",
+        description: "Updates the current account's handle. Verifies handle validity, and updates did:plc document if necessary. Implemented by PDS, and requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -17606,7 +17606,8 @@ var schemaDict = {
             properties: {
               handle: {
                 type: "string",
-                format: "handle"
+                format: "handle",
+                description: "The new handle."
               }
             }
           }
@@ -17689,7 +17690,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Find labels relevant to the provided URI patterns.",
+        description: "Find labels relevant to the provided AT-URI patterns. Public endpoint for moderation services, though may return different or additional results with auth.",
         parameters: {
           type: "params",
           required: ["uriPatterns"],
@@ -17748,13 +17749,13 @@ var schemaDict = {
     defs: {
       main: {
         type: "subscription",
-        description: "Subscribe to label updates.",
+        description: "Subscribe to stream of labels (and negations). Public endpoint implemented by mod services. Uses same sequencing scheme as repo event stream.",
         parameters: {
           type: "params",
           properties: {
             cursor: {
               type: "integer",
-              description: "The last known event to backfill from."
+              description: "The last known event seq number to backfill from."
             }
           }
         },
@@ -17810,7 +17811,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Report a repo or a record.",
+        description: "Submit a moderation report regarding an atproto account or record. Implemented by moderation services (with PDS proxying), and requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -17819,10 +17820,12 @@ var schemaDict = {
             properties: {
               reasonType: {
                 type: "ref",
+                description: "Indicates the broad category of violation the report is for.",
                 ref: "lex:com.atproto.moderation.defs#reasonType"
               },
               reason: {
-                type: "string"
+                type: "string",
+                description: "Additional context about the content and violation."
               },
               subject: {
                 type: "union",
@@ -17931,7 +17934,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Apply a batch transaction of creates, updates, and deletes.",
+        description: "Apply a batch transaction of repository creates, updates, and deletes. Requires auth, implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -17941,12 +17944,12 @@ var schemaDict = {
               repo: {
                 type: "string",
                 format: "at-identifier",
-                description: "The handle or DID of the repo."
+                description: "The handle or DID of the repo (aka, current account)."
               },
               validate: {
                 type: "boolean",
                 default: true,
-                description: "Flag for validating the records."
+                description: "Can be set to 'false' to skip Lexicon schema validation of record data, for all operations."
               },
               writes: {
                 type: "array",
@@ -17962,6 +17965,7 @@ var schemaDict = {
               },
               swapCommit: {
                 type: "string",
+                description: "If provided, the entire operation will fail if the current repo commit CID does not match this value. Used to prevent conflicting repo mutations.",
                 format: "cid"
               }
             }
@@ -17969,13 +17973,14 @@ var schemaDict = {
         },
         errors: [
           {
-            name: "InvalidSwap"
+            name: "InvalidSwap",
+            description: "Indicates that the 'swapCommit' parameter did not match current commit."
           }
         ]
       },
       create: {
         type: "object",
-        description: "Create a new record.",
+        description: "Operation which creates a new record.",
         required: ["collection", "value"],
         properties: {
           collection: {
@@ -17993,7 +17998,7 @@ var schemaDict = {
       },
       update: {
         type: "object",
-        description: "Update an existing record.",
+        description: "Operation which updates an existing record.",
         required: ["collection", "rkey", "value"],
         properties: {
           collection: {
@@ -18010,7 +18015,7 @@ var schemaDict = {
       },
       delete: {
         type: "object",
-        description: "Delete an existing record.",
+        description: "Operation which deletes an existing record.",
         required: ["collection", "rkey"],
         properties: {
           collection: {
@@ -18030,7 +18035,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Create a new record.",
+        description: "Create a single new repository record. Requires auth, implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -18040,7 +18045,7 @@ var schemaDict = {
               repo: {
                 type: "string",
                 format: "at-identifier",
-                description: "The handle or DID of the repo."
+                description: "The handle or DID of the repo (aka, current account)."
               },
               collection: {
                 type: "string",
@@ -18049,17 +18054,17 @@ var schemaDict = {
               },
               rkey: {
                 type: "string",
-                description: "The key of the record.",
+                description: "The Record Key.",
                 maxLength: 15
               },
               validate: {
                 type: "boolean",
                 default: true,
-                description: "Flag for validating the record."
+                description: "Can be set to 'false' to skip Lexicon schema validation of record data."
               },
               record: {
                 type: "unknown",
-                description: "The record to create."
+                description: "The record itself. Must contain a $type field."
               },
               swapCommit: {
                 type: "string",
@@ -18088,7 +18093,8 @@ var schemaDict = {
         },
         errors: [
           {
-            name: "InvalidSwap"
+            name: "InvalidSwap",
+            description: "Indicates that 'swapCommit' didn't match current repo commit."
           }
         ]
       }
@@ -18100,7 +18106,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Delete a record, or ensure it doesn't exist.",
+        description: "Delete a repository record, or ensure it doesn't exist. Requires auth, implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -18110,7 +18116,7 @@ var schemaDict = {
               repo: {
                 type: "string",
                 format: "at-identifier",
-                description: "The handle or DID of the repo."
+                description: "The handle or DID of the repo (aka, current account)."
               },
               collection: {
                 type: "string",
@@ -18119,7 +18125,7 @@ var schemaDict = {
               },
               rkey: {
                 type: "string",
-                description: "The key of the record."
+                description: "The Record Key."
               },
               swapRecord: {
                 type: "string",
@@ -18148,7 +18154,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get information about the repo, including the list of collections.",
+        description: "Get information about an account and repository, including the list of collections. Does not require auth.",
         parameters: {
           type: "params",
           required: ["repo"],
@@ -18181,17 +18187,20 @@ var schemaDict = {
                 format: "did"
               },
               didDoc: {
-                type: "unknown"
+                type: "unknown",
+                description: "The complete DID document for this account."
               },
               collections: {
                 type: "array",
+                description: "List of all the collections (NSIDs) for which this repo contains at least one record.",
                 items: {
                   type: "string",
                   format: "nsid"
                 }
               },
               handleIsCorrect: {
-                type: "boolean"
+                type: "boolean",
+                description: "Indicates if handle is currently valid (resolves bi-directionally)"
               }
             }
           }
@@ -18205,7 +18214,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a record.",
+        description: "Get a single record from a repository. Does not require auth.",
         parameters: {
           type: "params",
           required: ["repo", "collection", "rkey"],
@@ -18222,7 +18231,7 @@ var schemaDict = {
             },
             rkey: {
               type: "string",
-              description: "The key of the record."
+              description: "The Record Key."
             },
             cid: {
               type: "string",
@@ -18260,7 +18269,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "List a range of records in a collection.",
+        description: "List a range of records in a repository, matching a specific collection. Does not require auth.",
         parameters: {
           type: "params",
           required: ["repo", "collection"],
@@ -18344,7 +18353,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Write a record, creating or updating it as needed.",
+        description: "Write a repository record, creating or updating it as needed. Requires auth, implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -18355,7 +18364,7 @@ var schemaDict = {
               repo: {
                 type: "string",
                 format: "at-identifier",
-                description: "The handle or DID of the repo."
+                description: "The handle or DID of the repo (aka, current account)."
               },
               collection: {
                 type: "string",
@@ -18364,13 +18373,13 @@ var schemaDict = {
               },
               rkey: {
                 type: "string",
-                description: "The key of the record.",
+                description: "The Record Key.",
                 maxLength: 15
               },
               validate: {
                 type: "boolean",
                 default: true,
-                description: "Flag for validating the record."
+                description: "Can be set to 'false' to skip Lexicon schema validation of record data."
               },
               record: {
                 type: "unknown",
@@ -18379,7 +18388,7 @@ var schemaDict = {
               swapRecord: {
                 type: "string",
                 format: "cid",
-                description: "Compare and swap with the previous record by CID."
+                description: "Compare and swap with the previous record by CID. WARNING: nullable and optional field; may cause problems with golang implementation"
               },
               swapCommit: {
                 type: "string",
@@ -18441,7 +18450,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Upload a new blob to be added to repo in a later request.",
+        description: "Upload a new blob, to be referenced from a repository record. The blob will be deleted if it is not referenced within a time window (eg, minutes). Blob restrictions (mimetype, size, etc) are enforced when the reference is created. Requires auth, implemented by PDS.",
         input: {
           encoding: "*/*"
         },
@@ -18505,7 +18514,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Create an account.",
+        description: "Create an account. Implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -18517,11 +18526,13 @@ var schemaDict = {
               },
               handle: {
                 type: "string",
-                format: "handle"
+                format: "handle",
+                description: "Requested handle for the account."
               },
               did: {
                 type: "string",
-                format: "did"
+                format: "did",
+                description: "Pre-existing atproto DID, being imported to a new account."
               },
               inviteCode: {
                 type: "string"
@@ -18533,13 +18544,16 @@ var schemaDict = {
                 type: "string"
               },
               password: {
-                type: "string"
+                type: "string",
+                description: "Initial account password. May need to meet instance-specific password strength requirements."
               },
               recoveryKey: {
-                type: "string"
+                type: "string",
+                description: "DID PLC rotation key (aka, recovery key) to be included in PLC creation operation."
               },
               plcOp: {
-                type: "unknown"
+                type: "unknown",
+                description: "A signed DID PLC operation to be submitted as part of importing an existing account to this instance. NOTE: this optional field may be updated when full account migration is implemented."
               }
             }
           }
@@ -18548,6 +18562,7 @@ var schemaDict = {
           encoding: "application/json",
           schema: {
             type: "object",
+            description: "Account login session returned on successful account creation.",
             required: ["accessJwt", "refreshJwt", "handle", "did"],
             properties: {
               accessJwt: {
@@ -18562,10 +18577,12 @@ var schemaDict = {
               },
               did: {
                 type: "string",
-                format: "did"
+                format: "did",
+                description: "The DID of the new account."
               },
               didDoc: {
-                type: "unknown"
+                type: "unknown",
+                description: "Complete DID document."
               }
             }
           }
@@ -18610,7 +18627,8 @@ var schemaDict = {
             required: ["name"],
             properties: {
               name: {
-                type: "string"
+                type: "string",
+                description: "A short name for the App Password, to help distinguish them."
               }
             }
           }
@@ -18877,7 +18895,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Delete an actor's account with a token and password.",
+        description: "Delete an actor's account with a token and password. Can only be called after requesting a deletion token. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -18914,7 +18932,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Delete the current session."
+        description: "Delete the current session. Requires auth."
       }
     }
   },
@@ -18924,7 +18942,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a document describing the service's accounts configuration.",
+        description: "Describes the server's account creation requirements and capabilities. Implemented by PDS.",
         output: {
           encoding: "application/json",
           schema: {
@@ -18932,19 +18950,23 @@ var schemaDict = {
             required: ["availableUserDomains"],
             properties: {
               inviteCodeRequired: {
-                type: "boolean"
+                type: "boolean",
+                description: "If true, an invite code must be supplied to create an account on this instance."
               },
               phoneVerificationRequired: {
-                type: "boolean"
+                type: "boolean",
+                description: "If true, a phone verification token must be supplied to create an account on this instance."
               },
               availableUserDomains: {
                 type: "array",
+                description: "List of domain suffixes that can be used in account handles.",
                 items: {
                   type: "string"
                 }
               },
               links: {
                 type: "ref",
+                description: "URLs of service policy documents.",
                 ref: "lex:com.atproto.server.describeServer#links"
               }
             }
@@ -18970,7 +18992,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get all invite codes for a given account.",
+        description: "Get all invite codes for the current account. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -18980,7 +19002,8 @@ var schemaDict = {
             },
             createAvailable: {
               type: "boolean",
-              default: true
+              default: true,
+              description: "Controls whether any new 'earned' but not 'created' invites should be created."
             }
           }
         },
@@ -19014,7 +19037,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get information about the current session.",
+        description: "Get information about the current auth session. Requires auth.",
         output: {
           encoding: "application/json",
           schema: {
@@ -19094,7 +19117,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Refresh an authentication session.",
+        description: "Refresh an authentication session. Requires auth using the 'refreshJwt' (not the 'accessJwt').",
         output: {
           encoding: "application/json",
           schema: {
@@ -19199,7 +19222,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Reserve a repo signing key for account creation.",
+        description: "Reserve a repo signing key, for use with account creation. Necessary so that a DID PLC update operation can be constructed during an account migraiton. Public and does not require auth; implemented by PDS. NOTE: this endpoint may change when full account migration is implemented.",
         input: {
           encoding: "application/json",
           schema: {
@@ -19207,7 +19230,8 @@ var schemaDict = {
             properties: {
               did: {
                 type: "string",
-                description: "The did to reserve a new did:key for"
+                format: "did",
+                description: "The DID to reserve a key for."
               }
             }
           }
@@ -19220,7 +19244,7 @@ var schemaDict = {
             properties: {
               signingKey: {
                 type: "string",
-                description: "Public signing key in the form of a did:key."
+                description: "The public key for the reserved signing key, in did:key serialization."
               }
             }
           }
@@ -19326,7 +19350,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a blob associated with a given repo.",
+        description: "Get a blob associated with a given account. Returns the full blob as originally uploaded. Does not require auth; implemented by PDS.",
         parameters: {
           type: "params",
           required: ["did", "cid"],
@@ -19334,7 +19358,7 @@ var schemaDict = {
             did: {
               type: "string",
               format: "did",
-              description: "The DID of the repo."
+              description: "The DID of the account."
             },
             cid: {
               type: "string",
@@ -19355,7 +19379,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get blocks from a given repo.",
+        description: "Get data blocks from a given repo, by CID. For example, intermediate MST nodes, or records. Does not require auth; implemented by PDS.",
         parameters: {
           type: "params",
           required: ["did", "cids"],
@@ -19449,7 +19473,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get the current commit CID & revision of the repo.",
+        description: "Get the current commit CID & revision of the specified repo. Does not require auth.",
         parameters: {
           type: "params",
           required: ["did"],
@@ -19491,7 +19515,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get blocks needed for existence or non-existence of record.",
+        description: "Get data blocks needed to prove the existence or non-existence of record in the current version of repo. Does not require auth.",
         parameters: {
           type: "params",
           required: ["did", "collection", "rkey"],
@@ -19506,7 +19530,8 @@ var schemaDict = {
               format: "nsid"
             },
             rkey: {
-              type: "string"
+              type: "string",
+              description: "Record Key"
             },
             commit: {
               type: "string",
@@ -19527,7 +19552,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Gets the DID's repo, optionally catching up from a specific revision.",
+        description: "Download a repository export as CAR file. Optionally only a 'diff' since a previous revision. Does not require auth; implemented by PDS.",
         parameters: {
           type: "params",
           required: ["did"],
@@ -19539,7 +19564,7 @@ var schemaDict = {
             },
             since: {
               type: "string",
-              description: "The revision of the repo to catch up from."
+              description: "The revision ('rev') of the repo to create a diff from."
             }
           }
         },
@@ -19555,7 +19580,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "List blob CIDs since some revision.",
+        description: "List blob CIDso for an account, since some repo revision. Does not require auth; implemented by PDS.",
         parameters: {
           type: "params",
           required: ["did"],
@@ -19608,7 +19633,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "List DIDs and root CIDs of hosted repos.",
+        description: "Enumerates all the DID, rev, and commit CID for all repos hosted by this service. Does not require auth; implemented by PDS and Relay.",
         parameters: {
           type: "params",
           properties: {
@@ -19653,7 +19678,8 @@ var schemaDict = {
           },
           head: {
             type: "string",
-            format: "cid"
+            format: "cid",
+            description: "Current repo commit CID"
           },
           rev: {
             type: "string"
@@ -19668,7 +19694,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Notify a crawling service of a recent update; often when a long break between updates causes the connection with the crawling service to break.",
+        description: "Notify a crawling service of a recent update, and that crawling should resume. Intended use is after a gap between repo stream events caused the crawling service to disconnect. Does not require auth; implemented by Relay.",
         input: {
           encoding: "application/json",
           schema: {
@@ -19677,7 +19703,7 @@ var schemaDict = {
             properties: {
               hostname: {
                 type: "string",
-                description: "Hostname of the service that is notifying of update."
+                description: "Hostname of the current service (usually a PDS) that is notifying of update."
               }
             }
           }
@@ -19691,7 +19717,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Request a service to persistently crawl hosted repos.",
+        description: "Request a service to persistently crawl hosted repos. Expected use is new PDS instances declaring their existence to Relays. Does not require auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -19700,7 +19726,7 @@ var schemaDict = {
             properties: {
               hostname: {
                 type: "string",
-                description: "Hostname of the service that is requesting to be crawled."
+                description: "Hostname of the current service (eg, PDS) that is requesting to be crawled."
               }
             }
           }
@@ -19714,13 +19740,13 @@ var schemaDict = {
     defs: {
       main: {
         type: "subscription",
-        description: "Subscribe to repo updates.",
+        description: "Repository event stream, aka Firehose endpoint. Outputs repo commits with diff data, and identity update events, for all repositories on the current server. See the atproto specifications for details around stream sequencing, repo versioning, CAR diff format, and more. Public and does not require auth; implemented by PDS and Relay.",
         parameters: {
           type: "params",
           properties: {
             cursor: {
               type: "integer",
-              description: "The last known event to backfill from."
+              description: "The last known event seq number to backfill from."
             }
           }
         },
@@ -19741,12 +19767,14 @@ var schemaDict = {
             name: "FutureCursor"
           },
           {
-            name: "ConsumerTooSlow"
+            name: "ConsumerTooSlow",
+            description: "If the consumer of the stream can not keep up with events, and a backlog gets too large, the server will drop the connection."
           }
         ]
       },
       commit: {
         type: "object",
+        description: "Represents an update of repository state. Note that empty commits are allowed, which include no repo data changes, but an update to rev and signature.",
         required: [
           "seq",
           "rebase",
@@ -19763,59 +19791,69 @@ var schemaDict = {
         nullable: ["prev", "since"],
         properties: {
           seq: {
-            type: "integer"
+            type: "integer",
+            description: "The stream sequence number of this message."
           },
           rebase: {
-            type: "boolean"
+            type: "boolean",
+            description: "DEPRECATED -- unused"
           },
           tooBig: {
-            type: "boolean"
+            type: "boolean",
+            description: "Indicates that this commit contained too many ops, or data size was too large. Consumers will need to make a separate request to get missing data."
           },
           repo: {
             type: "string",
-            format: "did"
+            format: "did",
+            description: "The repo this event comes from."
           },
           commit: {
-            type: "cid-link"
+            type: "cid-link",
+            description: "Repo commit object CID."
           },
           prev: {
-            type: "cid-link"
+            type: "cid-link",
+            description: "DEPRECATED -- unused. WARNING -- nullable and optional; stick with optional to ensure golang interoperability."
           },
           rev: {
             type: "string",
-            description: "The rev of the emitted commit."
+            description: "The rev of the emitted commit. Note that this information is also in the commit object included in blocks, unless this is a tooBig event."
           },
           since: {
             type: "string",
-            description: "The rev of the last emitted commit from this repo."
+            description: "The rev of the last emitted commit from this repo (if any)."
           },
           blocks: {
             type: "bytes",
-            description: "CAR file containing relevant blocks.",
+            description: "CAR file containing relevant blocks, as a diff since the previous repo state.",
             maxLength: 1e6
           },
           ops: {
             type: "array",
             items: {
               type: "ref",
-              ref: "lex:com.atproto.sync.subscribeRepos#repoOp"
+              ref: "lex:com.atproto.sync.subscribeRepos#repoOp",
+              description: "List of repo mutation operations in this commit (eg, records created, updated, or deleted)."
             },
             maxLength: 200
           },
           blobs: {
             type: "array",
             items: {
-              type: "cid-link"
+              type: "cid-link",
+              description: "List of new blobs (by CID) referenced by records in this commit."
             }
           },
           time: {
             type: "string",
-            format: "datetime"
+            format: "datetime",
+            description: "Timestamp of when this message was originally broadcast."
           }
         }
       },
       handle: {
         type: "object",
+        description: "Represents an update of the account's handle, or transition to/from invalid state.",
         required: ["seq", "did", "handle", "time"],
         properties: {
           seq: {
@@ -19837,6 +19875,7 @@ var schemaDict = {
       },
       migrate: {
         type: "object",
+        description: "Represents an account moving from one PDS instance to another. NOTE: not implemented; full account migration may introduce a new message instead.",
         required: ["seq", "did", "migrateTo", "time"],
         nullable: ["migrateTo"],
         properties: {
@@ -19858,6 +19897,7 @@ var schemaDict = {
       },
       tombstone: {
         type: "object",
+        description: "Indicates that an account has been deleted.",
         required: ["seq", "did", "time"],
         properties: {
           seq: {
@@ -19888,7 +19928,7 @@ var schemaDict = {
       },
       repoOp: {
         type: "object",
-        description: "A repo operation, ie a write of a single record. For creates and updates, CID is the record's CID as of this operation. For deletes, it's null.",
+        description: "A repo operation, ie a mutation of a single record.",
         required: ["action", "path", "cid"],
         nullable: ["cid"],
         properties: {
@@ -19900,7 +19940,8 @@ var schemaDict = {
             type: "string"
           },
           cid: {
-            type: "cid-link"
+            type: "cid-link",
+            description: "For creates and updates, the new record CID. For deletions, null."
           }
         }
       }
@@ -19940,7 +19981,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Fetch all labels from a labeler created after a certain date.",
+        description: "Fetch all labels from a labeler created after a certain date. DEPRECATED: use queryLabels or subscribeLabels instead",
         parameters: {
           type: "params",
           properties: {
@@ -20053,7 +20094,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Transfer an account.",
+        description: "Transfer an account. NOTE: temporary method, necessarily how account migration will be implemented.",
         input: {
           encoding: "application/json",
           schema: {
@@ -20126,7 +20167,6 @@ var schemaDict = {
   AppBskyActorDefs: {
     lexicon: 1,
     id: "app.bsky.actor.defs",
-    description: "A reference to an actor in the network.",
     defs: {
       profileViewBasic: {
         type: "object",
@@ -20259,6 +20299,7 @@ var schemaDict = {
       },
       viewerState: {
         type: "object",
+        description: "Metadata about the requesting account's relationship with the subject account. Only has meaningful content for authed requests.",
         properties: {
           muted: {
             type: "boolean"
@@ -20343,6 +20384,9 @@ var schemaDict = {
               type: "string",
               format: "at-uri"
             }
+          },
+          timelineIndex: {
+            type: "integer"
           }
         }
       },
@@ -20424,7 +20468,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get private preferences attached to the account.",
+        description: "Get private preferences attached to the current account. Expected use is synchronization between multiple devices, and import/export during account migration. Requires auth.",
         parameters: {
           type: "params",
           properties: {}
@@ -20451,14 +20495,15 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get detailed profile view of an actor.",
+        description: "Get detailed profile view of an actor. Does not require auth, but contains relevant metadata with auth.",
         parameters: {
           type: "params",
           required: ["actor"],
           properties: {
             actor: {
               type: "string",
-              format: "at-identifier"
+              format: "at-identifier",
+              description: "Handle or DID of account to fetch profile of."
             }
           }
         },
@@ -20518,7 +20563,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of suggested actors, used for discovery.",
+        description: "Get a list of suggested actors. Expected use is discovery of accounts to follow during new account onboarding.",
         parameters: {
           type: "params",
           properties: {
@@ -20561,7 +20606,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a profile.",
+        description: "A declaration of a Bluesky account profile.",
         key: "literal:self",
         record: {
           type: "object",
@@ -20573,21 +20618,25 @@ var schemaDict = {
             },
             description: {
               type: "string",
+              description: "Free-form profile description text.",
               maxGraphemes: 256,
               maxLength: 2560
             },
             avatar: {
               type: "blob",
+              description: "Small image to be displayed next to posts from account. AKA, 'profile picture'",
               accept: ["image/png", "image/jpeg"],
               maxSize: 1e6
             },
             banner: {
               type: "blob",
+              description: "Larger horizontal image to display behind profile view.",
               accept: ["image/png", "image/jpeg"],
               maxSize: 1e6
             },
             labels: {
               type: "union",
+              description: "Self-label values, specific to the Bluesky application, on the overall account.",
               refs: ["lex:com.atproto.label.defs#selfLabels"]
             }
           }
@@ -20624,7 +20673,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Find actors (profiles) matching search criteria.",
+        description: "Find actors (profiles) matching search criteria. Does not require auth.",
         parameters: {
           type: "params",
           properties: {
@@ -20675,7 +20724,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Find actor suggestions for a prefix search term.",
+        description: "Find actor suggestions for a prefix search term. Expected use is for auto-completion during text field entry. Does not require auth.",
         parameters: {
           type: "params",
           properties: {
@@ -20717,10 +20766,10 @@ var schemaDict = {
   AppBskyEmbedExternal: {
     lexicon: 1,
     id: "app.bsky.embed.external",
-    description: "A representation of some externally linked content, embedded in another form of content.",
     defs: {
       main: {
         type: "object",
+        description: "A representation of some externally linked content (eg, a URL and 'card'), embedded in a Bluesky record (eg, a post).",
         required: ["external"],
         properties: {
           external: {
@@ -20784,7 +20833,7 @@ var schemaDict = {
   AppBskyEmbedImages: {
     lexicon: 1,
     id: "app.bsky.embed.images",
-    description: "A set of images embedded in some other form of content.",
+    description: "A set of images embedded in a Bluesky record (eg, a post).",
     defs: {
       main: {
         type: "object",
@@ -20810,7 +20859,8 @@ var schemaDict = {
             maxSize: 1e6
           },
           alt: {
-            type: "string"
+            type: "string",
+            description: "Alt text description of the image, for accessibility."
           },
           aspectRatio: {
             type: "ref",
@@ -20852,13 +20902,16 @@ var schemaDict = {
         required: ["thumb", "fullsize", "alt"],
         properties: {
           thumb: {
-            type: "string"
+            type: "string",
+            description: "Fully-qualified URL where a thumbnail of the image can be fetched. For example, CDN location provided by the App View."
           },
           fullsize: {
-            type: "string"
+            type: "string",
+            description: "Fully-qualified URL where a large version of the image can be fetched. May or may not be the exact original blob. For example, CDN location provided by the App View."
           },
           alt: {
-            type: "string"
+            type: "string",
+            description: "Alt text description of the image, for accessibility."
           },
           aspectRatio: {
             type: "ref",
@@ -20871,7 +20924,7 @@ var schemaDict = {
   AppBskyEmbedRecord: {
     lexicon: 1,
     id: "app.bsky.embed.record",
-    description: "A representation of a record embedded in another form of content.",
+    description: "A representation of a record embedded in a Bluesky record (eg, a post). For example, a quote-post, or sharing a feed generator record.",
     defs: {
       main: {
         type: "object",
@@ -20916,7 +20969,8 @@ var schemaDict = {
             ref: "lex:app.bsky.actor.defs#profileViewBasic"
           },
           value: {
-            type: "unknown"
+            type: "unknown",
+            description: "The record data itself."
           },
           labels: {
             type: "array",
@@ -20980,7 +21034,7 @@ var schemaDict = {
   AppBskyEmbedRecordWithMedia: {
     lexicon: 1,
     id: "app.bsky.embed.recordWithMedia",
-    description: "A representation of a record embedded in another form of content, alongside other compatible embeds.",
+    description: "A representation of a record embedded in a Bluesky record (eg, a post), alongside other compatible embeds. For example, a quote post and image, or a quote post and external URL card.",
     defs: {
       main: {
         type: "object",
@@ -21079,6 +21133,7 @@ var schemaDict = {
       },
       viewerState: {
         type: "object",
+        description: "Metadata about the requesting account's relationship with the subject content. Only has meaningful content for authed requests.",
         properties: {
           repost: {
             type: "string",
@@ -21338,7 +21393,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get information about a feed generator, including policies and offered feed URIs.",
+        description: "Get information about a feed generator, including policies and offered feed URIs. Does not require auth; implemented by Feed Generator services (not App View).",
         output: {
           encoding: "application/json",
           schema: {
@@ -21393,7 +21448,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of the existence of a feed generator.",
+        description: "Record declaring of the existence of a feed generator, and containing metadata about it. The record can exist in any repository.",
         key: "any",
         record: {
           type: "object",
@@ -21427,6 +21482,7 @@ var schemaDict = {
             },
             labels: {
               type: "union",
+              description: "Self-label values",
               refs: ["lex:com.atproto.label.defs#selfLabels"]
             },
             createdAt: {
@@ -21444,7 +21500,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of feeds created by the actor.",
+        description: "Get a list of feeds (feed generator records) created by the actor (in the actor's repo).",
         parameters: {
           type: "params",
           required: ["actor"],
@@ -21492,7 +21548,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of posts liked by an actor.",
+        description: "Get a list of posts liked by an actor. Does not require auth.",
         parameters: {
           type: "params",
           required: ["actor"],
@@ -21548,7 +21604,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a view of an actor's feed.",
+        description: "Get a view of an actor's 'author feed' (post and reposts by the author). Does not require auth.",
         parameters: {
           type: "params",
           required: ["actor"],
@@ -21568,6 +21624,7 @@ var schemaDict = {
             },
             filter: {
               type: "string",
+              description: "Combinations of post/repost types to include in response.",
               knownValues: [
                 "posts_with_replies",
                 "posts_no_replies",
@@ -21614,7 +21671,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a hydrated feed from an actor's selected feed generator.",
+        description: "Get a hydrated feed from an actor's selected feed generator. Implemented by App View.",
         parameters: {
           type: "params",
           required: ["feed"],
@@ -21667,14 +21724,15 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get information about a feed generator.",
+        description: "Get information about a feed generator. Implemented by AppView.",
         parameters: {
           type: "params",
           required: ["feed"],
           properties: {
             feed: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "AT-URI of the feed generator record."
             }
           }
         },
@@ -21689,10 +21747,12 @@ var schemaDict = {
                 ref: "lex:app.bsky.feed.defs#generatorView"
               },
               isOnline: {
-                type: "boolean"
+                type: "boolean",
+                description: "Indicates whether the feed generator service has been online recently, or else seems to be inactive."
               },
               isValid: {
-                type: "boolean"
+                type: "boolean",
+                description: "Indicates whether the feed generator service is compatible with the record declaration."
               }
             }
           }
@@ -21745,14 +21805,15 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a skeleton of a feed provided by a feed generator.",
+        description: "Get a skeleton of a feed provided by a feed generator. Auth is optional, depending on provider requirements, and provides the DID of the requester. Implemented by Feed Generator Service.",
         parameters: {
           type: "params",
           required: ["feed"],
           properties: {
             feed: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference to feed generator record describing the specific feed being requested."
             },
             limit: {
               type: "integer",
@@ -21798,18 +21859,20 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get the list of likes.",
+        description: "Get like records which reference a subject (by AT-URI and CID).",
         parameters: {
           type: "params",
           required: ["uri"],
           properties: {
             uri: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "AT-URI of the subject (eg, a post record)."
             },
             cid: {
               type: "string",
-              format: "cid"
+              format: "cid",
+              description: "CID of the subject record (aka, specific version of record), to filter likes."
             },
             limit: {
               type: "integer",
@@ -21876,14 +21939,15 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a view of a recent posts from actors in a list.",
+        description: "Get a feed of recent posts from a list (posts and reposts from any actors on the list). Does not require auth.",
         parameters: {
           type: "params",
           required: ["list"],
           properties: {
             list: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) to the list record."
             },
             limit: {
               type: "integer",
@@ -21929,23 +21993,26 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get posts in a thread.",
+        description: "Get posts in a thread. Does not require auth, but additional metadata and filtering will be applied for authed requests.",
         parameters: {
           type: "params",
           required: ["uri"],
           properties: {
             uri: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) to post record."
             },
             depth: {
               type: "integer",
+              description: "How many levels of reply depth should be included in response.",
               default: 6,
               minimum: 0,
               maximum: 1e3
             },
             parentHeight: {
               type: "integer",
+              description: "How many levels of parent (and grandparent, etc) post to include.",
               default: 80,
               minimum: 0,
               maximum: 1e3
@@ -21983,13 +22050,14 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a view of an actor's feed.",
+        description: "Gets post views for a specified list of posts (by AT-URI). This is sometimes referred to as 'hydrating' a 'feed skeleton'.",
         parameters: {
           type: "params",
           required: ["uris"],
           properties: {
             uris: {
               type: "array",
+              description: "List of post AT-URIs to return hydrated views for.",
               items: {
                 type: "string",
                 format: "at-uri"
@@ -22023,18 +22091,20 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of reposts.",
+        description: "Get a list of reposts for a given post.",
         parameters: {
           type: "params",
           required: ["uri"],
           properties: {
             uri: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) of post record"
             },
             cid: {
               type: "string",
-              format: "cid"
+              format: "cid",
+              description: "If supplied, filters to reposts of specific version (by CID) of the post record."
             },
             limit: {
               type: "integer",
@@ -22083,7 +22153,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of suggested feeds for the viewer.",
+        description: "Get a list of suggested feeds (feed generators) for the requesting account.",
         parameters: {
           type: "params",
           properties: {
@@ -22126,12 +22196,13 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a view of the actor's home timeline.",
+        description: "Get a view of the requesting account's home timeline. This is expected to be some form of reverse-chronological feed.",
         parameters: {
           type: "params",
           properties: {
             algorithm: {
-              type: "string"
+              type: "string",
+              description: "Variant 'algorithm' for timeline. Implementation-specific. NOTE: most feed flexibility has been moved to feed generator mechanism."
             },
             limit: {
               type: "integer",
@@ -22172,7 +22243,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a like.",
+        description: "Record declaring a 'like' of a piece of subject content.",
         key: "tid",
         record: {
           type: "object",
@@ -22197,7 +22268,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a post.",
+        description: "Record containing a Bluesky post.",
         key: "tid",
         record: {
           type: "object",
@@ -22206,11 +22277,12 @@ var schemaDict = {
             text: {
               type: "string",
               maxLength: 3e3,
-              maxGraphemes: 300
+              maxGraphemes: 300,
+              description: "The primary post content. May be an empty string, if there are embeds."
             },
             entities: {
               type: "array",
-              description: "Deprecated: replaced by app.bsky.richtext.facet.",
+              description: "DEPRECATED: replaced by app.bsky.richtext.facet.",
               items: {
                 type: "ref",
                 ref: "lex:app.bsky.feed.post#entity"
@@ -22218,6 +22290,7 @@ var schemaDict = {
             },
             facets: {
               type: "array",
+              description: "Annotations of text (mentions, URLs, hashtags, etc)",
               items: {
                 type: "ref",
                 ref: "lex:app.bsky.richtext.facet"
@@ -22238,6 +22311,7 @@ var schemaDict = {
             },
             langs: {
               type: "array",
+              description: "Indicates human language of post primary text content.",
               maxLength: 3,
               items: {
                 type: "string",
@@ -22246,21 +22320,23 @@ var schemaDict = {
             },
             labels: {
               type: "union",
+              description: "Self-label values for this post. Effectively content warnings.",
               refs: ["lex:com.atproto.label.defs#selfLabels"]
             },
             tags: {
               type: "array",
+              description: "Additional non-inline tags describing this post.",
               maxLength: 8,
               items: {
                 type: "string",
                 maxLength: 640,
                 maxGraphemes: 64
-              },
-              description: "Additional non-inline tags describing this post."
+              }
             },
             createdAt: {
               type: "string",
-              format: "datetime"
+              format: "datetime",
+              description: "Client-declared timestamp when this post was originally created."
             }
           }
         }
@@ -22319,7 +22395,7 @@ var schemaDict = {
     id: "app.bsky.feed.repost",
     defs: {
       main: {
-        description: "A declaration of a repost.",
+        description: "Record representing a 'repost' of an existing Bluesky post.",
         type: "record",
         key: "tid",
         record: {
@@ -22345,7 +22421,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Find posts matching search criteria.",
+        description: "Find posts matching search criteria, returning views of those posts.",
         parameters: {
           type: "params",
           required: ["q"],
@@ -22404,14 +22480,15 @@ var schemaDict = {
       main: {
         type: "record",
         key: "tid",
-        description: "Defines interaction gating rules for a thread. The rkey of the threadgate record should match the rkey of the thread's root post.",
+        description: "Record defining interaction gating rules for a thread (aka, reply controls). The record key (rkey) of the threadgate record must match the record key of the thread's root post, and that record must be in the same repository..",
         record: {
           type: "object",
           required: ["post", "createdAt"],
           properties: {
             post: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) to the post record."
             },
             allow: {
               type: "array",
@@ -22461,7 +22538,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a block.",
+        description: "Record declaring a 'block' relationship against another account. NOTE: blocks are public in Bluesky; see blog posts for details.",
         key: "tid",
         record: {
           type: "object",
@@ -22469,7 +22546,8 @@ var schemaDict = {
           properties: {
             subject: {
               type: "string",
-              format: "did"
+              format: "did",
+              description: "DID of the account to be blocked."
             },
             createdAt: {
               type: "string",
@@ -22653,7 +22731,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a social follow.",
+        description: "Record declaring a social 'follow' relationship of another account. Duplicate follows will be ignored by the AppView.",
         key: "tid",
         record: {
           type: "object",
@@ -22678,7 +22756,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of who the actor is blocking.",
+        description: "Enumerates which accounts the requesting account is currently blocking. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -22721,7 +22799,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of an actor's followers.",
+        description: "Enumerates accounts which follow a specified account (actor).",
         parameters: {
           type: "params",
           required: ["actor"],
@@ -22773,7 +22851,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of who the actor follows.",
+        description: "Enumerates accounts which a specified account (actor) follows.",
         parameters: {
           type: "params",
           required: ["actor"],
@@ -22825,14 +22903,15 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of actors.",
+        description: "Gets a 'view' (with additional context) of a specified list.",
         parameters: {
           type: "params",
           required: ["list"],
           properties: {
             list: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) of the list record to hydrate."
             },
             limit: {
               type: "integer",
@@ -22877,7 +22956,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get lists that the actor is blocking.",
+        description: "Get mod lists that the requesting account (actor) is blocking. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -22920,7 +22999,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get lists that the actor is muting.",
+        description: "Enumerates mod lists that the requesting account (actor) currently has muted. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -22963,14 +23042,15 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of lists that belong to an actor.",
+        description: "Enumerates the lists created by a specified account (actor).",
         parameters: {
           type: "params",
           required: ["actor"],
           properties: {
             actor: {
               type: "string",
-              format: "at-identifier"
+              format: "at-identifier",
+              description: "The account (actor) to enumerate lists from."
             },
             limit: {
               type: "integer",
@@ -23011,7 +23091,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of who the actor mutes.",
+        description: "Enumerates accounts that the requesting account (actor) currently has muted. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -23054,17 +23134,19 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Enumerates public relationships between one account, and a list of other accounts",
+        description: "Enumerates public relationships between one account, and a list of other accounts. Does not require auth.",
         parameters: {
           type: "params",
           required: ["actor"],
           properties: {
             actor: {
               type: "string",
-              format: "at-identifier"
+              format: "at-identifier",
+              description: "Primary account requesting relationships for."
             },
             others: {
               type: "array",
+              description: "List of 'other' accounts to be related back to the primary.",
               maxLength: 30,
               items: {
                 type: "string",
@@ -23111,7 +23193,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get suggested follows related to a given actor.",
+        description: "Enumerates follows similar to a given account (actor). Expected use is to recommend additional accounts immediately after following one account.",
         parameters: {
           type: "params",
           required: ["actor"],
@@ -23147,7 +23229,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a list of actors.",
+        description: "Record representing a list of accounts (actors). Scope includes both moderation-oriented lists and curration-oriented lists.",
         key: "tid",
         record: {
           type: "object",
@@ -23155,12 +23237,14 @@ var schemaDict = {
           properties: {
             purpose: {
               type: "ref",
+              description: "Defines the purpose of the list (aka, moderation-oriented or curration-oriented)",
               ref: "lex:app.bsky.graph.defs#listPurpose"
             },
             name: {
               type: "string",
               maxLength: 64,
-              minLength: 1
+              minLength: 1,
+              description: "Display name for list; can not be empty."
             },
             description: {
               type: "string",
@@ -23198,7 +23282,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A block of an entire list of actors.",
+        description: "Record representing a block relationship against an entire an entire list of accounts (actors).",
         key: "tid",
         record: {
           type: "object",
@@ -23206,7 +23290,8 @@ var schemaDict = {
           properties: {
             subject: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) to the mod list record."
             },
             createdAt: {
               type: "string",
@@ -23223,7 +23308,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "An item under a declared list of actors.",
+        description: "Record representing an account's inclusion on a specific list. The AppView will ignore duplicate listitem records.",
         key: "tid",
         record: {
           type: "object",
@@ -23231,11 +23316,13 @@ var schemaDict = {
           properties: {
             subject: {
               type: "string",
-              format: "did"
+              format: "did",
+              description: "The account which is included on the list."
             },
             list: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) to the list record (app.bsky.graph.list)."
             },
             createdAt: {
               type: "string",
@@ -23252,7 +23339,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Mute an actor by DID or handle.",
+        description: "Creates a mute relationship for the specified account. Mutes are private in Bluesky. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -23275,7 +23362,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Mute a list of actors.",
+        description: "Creates a mute relationship for the specified list of accounts. Mutes are private in Bluesky. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -23298,7 +23385,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Unmute an actor by DID or handle.",
+        description: "Unmutes the specified account. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -23321,7 +23408,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Unmute a list of actors.",
+        description: "Unmutes the specified list of accounts. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -23344,7 +23431,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get the count of unread notifications.",
+        description: "Count the number of unread notifications for the requesting account. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -23375,7 +23462,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of notifications.",
+        description: "Enumerate notifications for the requesting account. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -23485,7 +23572,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Register for push notifications with a service.",
+        description: "Register to receive push notifications, via a specified service, for the requesting account. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -23518,7 +23605,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Notify server that the user has seen notifications.",
+        description: "Notify server that the requesting account has seen notifications. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -23541,6 +23628,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "object",
+        description: "Annotation of a sub-string within rich text.",
         required: ["index", "features"],
         properties: {
           index: {
@@ -23562,7 +23650,7 @@ var schemaDict = {
       },
       mention: {
         type: "object",
-        description: "A facet feature for actor mentions.",
+        description: "Facet feature for mention of another account. The text is usually a handle, including a '@' prefix, but the facet reference is a DID.",
         required: ["did"],
         properties: {
           did: {
@@ -23573,7 +23661,7 @@ var schemaDict = {
       },
       link: {
         type: "object",
-        description: "A facet feature for links.",
+        description: "Facet feature for a URL. The text URL may have been simplified or truncated, but the facet reference should be a complete URL.",
         required: ["uri"],
         properties: {
           uri: {
@@ -23584,7 +23672,7 @@ var schemaDict = {
       },
       tag: {
         type: "object",
-        description: "A hashtag.",
+        description: "Facet feature for a hashtag. The text usually includes a '#' prefix, but the facet reference should not (except in the case of 'double hash tags').",
         required: ["tag"],
         properties: {
           tag: {
@@ -23596,7 +23684,7 @@ var schemaDict = {
       },
       byteSlice: {
         type: "object",
-        description: "A text segment. Start is inclusive, end is exclusive. Indices are for utf8-encoded strings.",
+        description: "Specifies the sub-string range a facet feature applies to. Start index is inclusive, end index is exclusive. Indices are zero-indexed, counting bytes of the UTF-8 encoded text. NOTE: some languages, like Javascript, use UTF-16 or Unicode codepoints for string slice indexing; in these languages, convert to byte arrays before working with facets.",
         required: ["byteStart", "byteEnd"],
         properties: {
           byteStart: {