@atproto/ozone 0.0.8 → 0.0.9

package/dist/index.js

@@ -15144,7 +15144,7 @@ var require_object_inspect = __commonJS({
       if (isBoolean2(obj)) {
         return markBoxed(booleanValueOf.call(obj));
       }
-      if (isString2(obj)) {
+      if (isString3(obj)) {
         return markBoxed(inspect(String(obj)));
       }
       if (!isDate2(obj) && !isRegExp(obj)) {
@@ -15183,7 +15183,7 @@ var require_object_inspect = __commonJS({
     function isError(obj) {
       return toStr(obj) === "[object Error]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
     }
-    function isString2(obj) {
+    function isString3(obj) {
       return toStr(obj) === "[object String]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
     }
     function isNumber2(obj) {
@@ -22264,13 +22264,13 @@ var require_implementation2 = __commonJS({
         var isObject3 = object2 !== null && typeof object2 === "object";
         var isFunction2 = toStr.call(object2) === "[object Function]";
         var isArguments = isArgs(object2);
-        var isString2 = isObject3 && toStr.call(object2) === "[object String]";
+        var isString3 = isObject3 && toStr.call(object2) === "[object String]";
         var theKeys = [];
         if (!isObject3 && !isFunction2 && !isArguments) {
           throw new TypeError("Object.keys called on a non-object");
         }
         var skipProto = hasProtoEnumBug && isFunction2;
-        if (isString2 && object2.length > 0 && !has.call(object2, 0)) {
+        if (isString3 && object2.length > 0 && !has.call(object2, 0)) {
           for (var i = 0; i < object2.length; ++i) {
             theKeys.push(String(i));
           }
@@ -33941,7 +33941,7 @@ var require_lib4 = __commonJS({
         preflightContinue: false,
         optionsSuccessStatus: 204
       };
-      function isString2(s) {
+      function isString3(s) {
         return typeof s === "string" || s instanceof String;
       }
       function isOriginAllowed(origin, allowedOrigin) {
@@ -33952,7 +33952,7 @@ var require_lib4 = __commonJS({
             }
           }
           return false;
-        } else if (isString2(allowedOrigin)) {
+        } else if (isString3(allowedOrigin)) {
           return origin === allowedOrigin;
         } else if (allowedOrigin instanceof RegExp) {
           return allowedOrigin.test(origin);
@@ -33967,7 +33967,7 @@ var require_lib4 = __commonJS({
             key: "Access-Control-Allow-Origin",
             value: "*"
           }]);
-        } else if (isString2(options.origin)) {
+        } else if (isString3(options.origin)) {
           headers.push([{
             key: "Access-Control-Allow-Origin",
             value: options.origin
@@ -43357,30 +43357,292 @@ var require_dist2 = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/node-gyp-build-optional-packages@5.0.3/node_modules/node-gyp-build-optional-packages/index.js
+// ../../node_modules/.pnpm/detect-libc@2.0.2/node_modules/detect-libc/lib/process.js
+var require_process = __commonJS({
+  "../../node_modules/.pnpm/detect-libc@2.0.2/node_modules/detect-libc/lib/process.js"(exports, module2) {
+    "use strict";
+    var isLinux = () => process.platform === "linux";
+    var report = null;
+    var getReport = () => {
+      if (!report) {
+        report = isLinux() && process.report ? process.report.getReport() : {};
+      }
+      return report;
+    };
+    module2.exports = { isLinux, getReport };
+  }
+});
+
+// ../../node_modules/.pnpm/detect-libc@2.0.2/node_modules/detect-libc/lib/filesystem.js
+var require_filesystem = __commonJS({
+  "../../node_modules/.pnpm/detect-libc@2.0.2/node_modules/detect-libc/lib/filesystem.js"(exports, module2) {
+    "use strict";
+    var fs = require("fs");
+    var LDD_PATH = "/usr/bin/ldd";
+    var readFileSync = (path) => fs.readFileSync(path, "utf-8");
+    var readFile = (path) => new Promise((resolve, reject) => {
+      fs.readFile(path, "utf-8", (err, data) => {
+        if (err) {
+          reject(err);
+        } else {
+          resolve(data);
+        }
+      });
+    });
+    module2.exports = {
+      LDD_PATH,
+      readFileSync,
+      readFile
+    };
+  }
+});
+
+// ../../node_modules/.pnpm/detect-libc@2.0.2/node_modules/detect-libc/lib/detect-libc.js
+var require_detect_libc = __commonJS({
+  "../../node_modules/.pnpm/detect-libc@2.0.2/node_modules/detect-libc/lib/detect-libc.js"(exports, module2) {
+    "use strict";
+    var childProcess = require("child_process");
+    var { isLinux, getReport } = require_process();
+    var { LDD_PATH, readFile, readFileSync } = require_filesystem();
+    var cachedFamilyFilesystem;
+    var cachedVersionFilesystem;
+    var command = "getconf GNU_LIBC_VERSION 2>&1 || true; ldd --version 2>&1 || true";
+    var commandOut = "";
+    var safeCommand = () => {
+      if (!commandOut) {
+        return new Promise((resolve) => {
+          childProcess.exec(command, (err, out) => {
+            commandOut = err ? " " : out;
+            resolve(commandOut);
+          });
+        });
+      }
+      return commandOut;
+    };
+    var safeCommandSync = () => {
+      if (!commandOut) {
+        try {
+          commandOut = childProcess.execSync(command, { encoding: "utf8" });
+        } catch (_err) {
+          commandOut = " ";
+        }
+      }
+      return commandOut;
+    };
+    var GLIBC = "glibc";
+    var RE_GLIBC_VERSION = /GLIBC\s(\d+\.\d+)/;
+    var MUSL = "musl";
+    var GLIBC_ON_LDD = GLIBC.toUpperCase();
+    var MUSL_ON_LDD = MUSL.toLowerCase();
+    var isFileMusl = (f) => f.includes("libc.musl-") || f.includes("ld-musl-");
+    var familyFromReport = () => {
+      const report = getReport();
+      if (report.header && report.header.glibcVersionRuntime) {
+        return GLIBC;
+      }
+      if (Array.isArray(report.sharedObjects)) {
+        if (report.sharedObjects.some(isFileMusl)) {
+          return MUSL;
+        }
+      }
+      return null;
+    };
+    var familyFromCommand = (out) => {
+      const [getconf, ldd1] = out.split(/[\r\n]+/);
+      if (getconf && getconf.includes(GLIBC)) {
+        return GLIBC;
+      }
+      if (ldd1 && ldd1.includes(MUSL)) {
+        return MUSL;
+      }
+      return null;
+    };
+    var getFamilyFromLddContent = (content) => {
+      if (content.includes(MUSL_ON_LDD)) {
+        return MUSL;
+      }
+      if (content.includes(GLIBC_ON_LDD)) {
+        return GLIBC;
+      }
+      return null;
+    };
+    var familyFromFilesystem = async () => {
+      if (cachedFamilyFilesystem !== void 0) {
+        return cachedFamilyFilesystem;
+      }
+      cachedFamilyFilesystem = null;
+      try {
+        const lddContent = await readFile(LDD_PATH);
+        cachedFamilyFilesystem = getFamilyFromLddContent(lddContent);
+      } catch (e) {
+      }
+      return cachedFamilyFilesystem;
+    };
+    var familyFromFilesystemSync = () => {
+      if (cachedFamilyFilesystem !== void 0) {
+        return cachedFamilyFilesystem;
+      }
+      cachedFamilyFilesystem = null;
+      try {
+        const lddContent = readFileSync(LDD_PATH);
+        cachedFamilyFilesystem = getFamilyFromLddContent(lddContent);
+      } catch (e) {
+      }
+      return cachedFamilyFilesystem;
+    };
+    var family = async () => {
+      let family2 = null;
+      if (isLinux()) {
+        family2 = await familyFromFilesystem();
+        if (!family2) {
+          family2 = familyFromReport();
+        }
+        if (!family2) {
+          const out = await safeCommand();
+          family2 = familyFromCommand(out);
+        }
+      }
+      return family2;
+    };
+    var familySync = () => {
+      let family2 = null;
+      if (isLinux()) {
+        family2 = familyFromFilesystemSync();
+        if (!family2) {
+          family2 = familyFromReport();
+        }
+        if (!family2) {
+          const out = safeCommandSync();
+          family2 = familyFromCommand(out);
+        }
+      }
+      return family2;
+    };
+    var isNonGlibcLinux = async () => isLinux() && await family() !== GLIBC;
+    var isNonGlibcLinuxSync = () => isLinux() && familySync() !== GLIBC;
+    var versionFromFilesystem = async () => {
+      if (cachedVersionFilesystem !== void 0) {
+        return cachedVersionFilesystem;
+      }
+      cachedVersionFilesystem = null;
+      try {
+        const lddContent = await readFile(LDD_PATH);
+        const versionMatch = lddContent.match(RE_GLIBC_VERSION);
+        if (versionMatch) {
+          cachedVersionFilesystem = versionMatch[1];
+        }
+      } catch (e) {
+      }
+      return cachedVersionFilesystem;
+    };
+    var versionFromFilesystemSync = () => {
+      if (cachedVersionFilesystem !== void 0) {
+        return cachedVersionFilesystem;
+      }
+      cachedVersionFilesystem = null;
+      try {
+        const lddContent = readFileSync(LDD_PATH);
+        const versionMatch = lddContent.match(RE_GLIBC_VERSION);
+        if (versionMatch) {
+          cachedVersionFilesystem = versionMatch[1];
+        }
+      } catch (e) {
+      }
+      return cachedVersionFilesystem;
+    };
+    var versionFromReport = () => {
+      const report = getReport();
+      if (report.header && report.header.glibcVersionRuntime) {
+        return report.header.glibcVersionRuntime;
+      }
+      return null;
+    };
+    var versionSuffix = (s) => s.trim().split(/\s+/)[1];
+    var versionFromCommand = (out) => {
+      const [getconf, ldd1, ldd2] = out.split(/[\r\n]+/);
+      if (getconf && getconf.includes(GLIBC)) {
+        return versionSuffix(getconf);
+      }
+      if (ldd1 && ldd2 && ldd1.includes(MUSL)) {
+        return versionSuffix(ldd2);
+      }
+      return null;
+    };
+    var version2 = async () => {
+      let version3 = null;
+      if (isLinux()) {
+        version3 = await versionFromFilesystem();
+        if (!version3) {
+          version3 = versionFromReport();
+        }
+        if (!version3) {
+          const out = await safeCommand();
+          version3 = versionFromCommand(out);
+        }
+      }
+      return version3;
+    };
+    var versionSync = () => {
+      let version3 = null;
+      if (isLinux()) {
+        version3 = versionFromFilesystemSync();
+        if (!version3) {
+          version3 = versionFromReport();
+        }
+        if (!version3) {
+          const out = safeCommandSync();
+          version3 = versionFromCommand(out);
+        }
+      }
+      return version3;
+    };
+    module2.exports = {
+      GLIBC,
+      MUSL,
+      family,
+      familySync,
+      isNonGlibcLinux,
+      isNonGlibcLinuxSync,
+      version: version2,
+      versionSync
+    };
+  }
+});
+
+// ../../node_modules/.pnpm/node-gyp-build-optional-packages@5.1.1/node_modules/node-gyp-build-optional-packages/index.js
 var require_node_gyp_build_optional_packages = __commonJS({
-  "../../node_modules/.pnpm/node-gyp-build-optional-packages@5.0.3/node_modules/node-gyp-build-optional-packages/index.js"(exports, module2) {
+  "../../node_modules/.pnpm/node-gyp-build-optional-packages@5.1.1/node_modules/node-gyp-build-optional-packages/index.js"(exports, module2) {
     var fs = require("fs");
     var path = require("path");
-    var runtimeRequire = typeof __webpack_require__ === "function" ? __non_webpack_require__ : require;
+    var url = require("url");
     var vars = process.config && process.config.variables || {};
     var prebuildsOnly = !!process.env.PREBUILDS_ONLY;
-    var abi = process.versions.modules;
+    var versions = process.versions;
+    var abi = versions.modules;
+    if (versions.deno || process.isBun) {
+      abi = "unsupported";
+    }
     var runtime = isElectron() ? "electron" : "node";
     var arch = process.arch;
     var platform = process.platform;
-    var libc = process.env.LIBC || (isAlpine(platform) ? "musl" : "glibc");
+    var libc = process.env.LIBC || (isMusl(platform) ? "musl" : "glibc");
     var armv = process.env.ARM_VERSION || (arch === "arm64" ? "8" : vars.arm_version) || "";
-    var uv = (process.versions.uv || "").split(".")[0];
+    var uv = (versions.uv || "").split(".")[0];
     module2.exports = load;
     function load(dir) {
-      return runtimeRequire(load.path(dir));
+      if (typeof __webpack_require__ === "function")
+        return __non_webpack_require__(load.path(dir));
+      else
+        return require(load.path(dir));
     }
     load.path = function(dir) {
       dir = path.resolve(dir || ".");
-      var packageName;
+      var packageName = "";
       try {
-        packageName = runtimeRequire(path.join(dir, "package.json")).name;
+        if (typeof __webpack_require__ === "function")
+          packageName = __non_webpack_require__(path.join(dir, "package.json")).name;
+        else
+          packageName = require(path.join(dir, "package.json")).name;
         var varName = packageName.toUpperCase().replace(/-/g, "_") + "_PREBUILD";
         if (process.env[varName])
           dir = process.env[varName];
@@ -43402,7 +43664,7 @@ var require_node_gyp_build_optional_packages = __commonJS({
         return nearby;
       var platformPackage = (packageName[0] == "@" ? "" : "@" + packageName + "/") + packageName + "-" + platform + "-" + arch;
       try {
-        var prebuildPackage = path.dirname(require("module").createRequire(path.join(dir, "package.json")).resolve(platformPackage));
+        var prebuildPackage = path.dirname(require("module").createRequire(url.pathToFileURL(path.join(dir, "package.json"))).resolve(platformPackage));
         return resolveFile(prebuildPackage);
       } catch (error) {
       }
@@ -43418,7 +43680,7 @@ var require_node_gyp_build_optional_packages = __commonJS({
         process.versions.electron ? "electron=" + process.versions.electron : "",
         typeof __webpack_require__ === "function" ? "webpack=true" : ""
       ].filter(Boolean).join(" ");
-      throw new Error("No native build was found for " + target2 + "\n    loaded from: " + dir + " and package: " + platformPackage + "\n");
+      throw new Error("No native build was found for " + target2 + "\n    attempted loading from: " + dir + " and package: " + platformPackage + "\n");
       function resolve(dir2) {
         var tuples = readdirSync(path.join(dir2, "prebuilds")).map(parseTuple);
         var tuple = tuples.filter(matchTuple(platform, arch)).sort(compareTuples)[0];
@@ -43541,8 +43803,11 @@ var require_node_gyp_build_optional_packages = __commonJS({
         return true;
       return typeof window !== "undefined" && window.process && window.process.type === "renderer";
     }
-    function isAlpine(platform2) {
-      return platform2 === "linux" && fs.existsSync("/etc/alpine-release");
+    function isMusl(platform2) {
+      if (platform2 !== "linux")
+        return false;
+      const { familySync, MUSL } = require_detect_libc();
+      return familySync() === MUSL;
     }
     load.parseTags = parseTags;
     load.matchTags = matchTags;
@@ -43553,9 +43818,9 @@ var require_node_gyp_build_optional_packages = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/cbor-extract@2.1.1/node_modules/cbor-extract/index.js
+// ../../node_modules/.pnpm/cbor-extract@2.2.0/node_modules/cbor-extract/index.js
 var require_cbor_extract = __commonJS({
-  "../../node_modules/.pnpm/cbor-extract@2.1.1/node_modules/cbor-extract/index.js"(exports, module2) {
+  "../../node_modules/.pnpm/cbor-extract@2.2.0/node_modules/cbor-extract/index.js"(exports, module2) {
     module2.exports = require_node_gyp_build_optional_packages()(__dirname);
   }
 });
@@ -75987,7 +76252,7 @@ if (cid) {
       }
       return result;
     }
-    var isString2 = typeOfTest("string");
+    var isString3 = typeOfTest("string");
     var isFunction2 = typeOfTest("function");
     var isNumber2 = typeOfTest("number");
     var isObject22 = (thing) => thing !== null && typeof thing === "object";
@@ -76263,7 +76528,7 @@ if (cid) {
       isBuffer: isBuffer32,
       isFormData,
       isArrayBufferView,
-      isString: isString2,
+      isString: isString3,
       isNumber: isNumber2,
       isBoolean: isBoolean2,
       isObject: isObject22,
@@ -79444,7 +79709,7 @@ var require_utils4 = __commonJS({
       }
       return result;
     }
-    function isString2(val) {
+    function isString3(val) {
       return typeof val === "string";
     }
     function isNumber2(val) {
@@ -79594,7 +79859,7 @@ var require_utils4 = __commonJS({
       isBuffer: isBuffer3,
       isFormData,
       isArrayBufferView,
-      isString: isString2,
+      isString: isString3,
       isNumber: isNumber2,
       isObject: isObject3,
       isPlainObject,
@@ -81022,7 +81287,7 @@ var require_follow_redirects = __commonJS({
       if (this._ending) {
         throw new WriteAfterEndError();
       }
-      if (!isString2(data) && !isBuffer3(data)) {
+      if (!isString3(data) && !isBuffer3(data)) {
         throw new TypeError("data should be a string, Buffer or Uint8Array");
       }
       if (isFunction2(encoding)) {
@@ -81282,14 +81547,14 @@ var require_follow_redirects = __commonJS({
         var nativeProtocol = nativeProtocols[protocol] = protocols[scheme];
         var wrappedProtocol = exports2[scheme] = Object.create(nativeProtocol);
         function request(input, options, callback) {
-          if (isString2(input)) {
+          if (isString3(input)) {
             var parsed;
             try {
               parsed = urlToOptions(new URL2(input));
             } catch (err) {
               parsed = url.parse(input);
             }
-            if (!isString2(parsed.protocol)) {
+            if (!isString3(parsed.protocol)) {
               throw new InvalidUrlError({ input });
             }
             input = parsed;
@@ -81309,7 +81574,7 @@ var require_follow_redirects = __commonJS({
             maxBodyLength: exports2.maxBodyLength
           }, input, options);
           options.nativeProtocols = nativeProtocols;
-          if (!isString2(options.host) && !isString2(options.hostname)) {
+          if (!isString3(options.host) && !isString3(options.hostname)) {
             options.hostname = "::1";
           }
           assert7.equal(options.protocol, protocol, "protocol mismatch");
@@ -81375,11 +81640,11 @@ var require_follow_redirects = __commonJS({
       request.abort();
     }
     function isSubdomain(subdomain, domain) {
-      assert7(isString2(subdomain) && isString2(domain));
+      assert7(isString3(subdomain) && isString3(domain));
       var dot = subdomain.length - domain.length - 1;
       return dot > 0 && subdomain[dot] === "." && subdomain.endsWith(domain);
     }
-    function isString2(value) {
+    function isString3(value) {
       return typeof value === "string" || value instanceof String;
     }
     function isFunction2(value) {
@@ -94769,6 +95034,11 @@ var handlerSuccess = z.object({
   body: z.any(),
   headers: z.record(z.string()).optional()
 });
+var handlerPipeThrough = z.object({
+  encoding: z.string(),
+  buffer: z.instanceof(ArrayBuffer),
+  headers: z.record(z.string()).optional()
+});
 var handlerError = z.object({
   status: z.number(),
   error: z.string().optional(),
@@ -101405,6 +101675,15 @@ var Server = class {
         if (isHandlerError(outputUnvalidated)) {
           throw XRPCError2.fromError(outputUnvalidated);
         }
+        if (outputUnvalidated && isHandlerPipeThrough(outputUnvalidated)) {
+          if (outputUnvalidated?.headers) {
+            Object.entries(outputUnvalidated.headers).forEach(([name2, val]) => {
+              res.header(name2, val);
+            });
+          }
+          res.header("Content-Type", outputUnvalidated.encoding).status(200).send(Buffer.from(outputUnvalidated.buffer));
+          return;
+        }
         if (!outputUnvalidated || isHandlerSuccess(outputUnvalidated)) {
           const output2 = validateResOutput(outputUnvalidated);
           if (output2?.headers) {
@@ -101546,6 +101825,24 @@ var Server = class {
 function isHandlerSuccess(v) {
   return handlerSuccess.safeParse(v).success;
 }
+function isHandlerPipeThrough(v) {
+  if (v === null || typeof v !== "object") {
+    return false;
+  }
+  if (!isString(v["encoding"]) || !(v["buffer"] instanceof ArrayBuffer)) {
+    return false;
+  }
+  if (v["headers"] !== void 0) {
+    if (v["headers"] === null || typeof v["headers"] !== "object") {
+      return false;
+    }
+    if (!Object.values(v["headers"]).every(isString)) {
+      return false;
+    }
+  }
+  return true;
+}
+var isString = (val) => typeof val === "string";
 var kRequestLocals = Symbol("requestLocals");
 function createLocalsMiddleware(nsid2) {
   return function(req, _res, next) {
@@ -103481,7 +103778,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"],
@@ -103515,7 +103812,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: {
@@ -103524,7 +103821,8 @@ var schemaDict = {
             properties: {
               handle: {
                 type: "string",
-                format: "handle"
+                format: "handle",
+                description: "The new handle."
               }
             }
           }
@@ -103607,7 +103905,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"],
@@ -103666,13 +103964,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."
             }
           }
         },
@@ -103728,7 +104026,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: {
@@ -103737,10 +104035,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",
@@ -103849,7 +104149,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: {
@@ -103859,12 +104159,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",
@@ -103880,6 +104180,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"
               }
             }
@@ -103887,13 +104188,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: {
@@ -103911,7 +104213,7 @@ var schemaDict = {
       },
       update: {
         type: "object",
-        description: "Update an existing record.",
+        description: "Operation which updates an existing record.",
         required: ["collection", "rkey", "value"],
         properties: {
           collection: {
@@ -103928,7 +104230,7 @@ var schemaDict = {
       },
       delete: {
         type: "object",
-        description: "Delete an existing record.",
+        description: "Operation which deletes an existing record.",
         required: ["collection", "rkey"],
         properties: {
           collection: {
@@ -103948,7 +104250,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: {
@@ -103958,7 +104260,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",
@@ -103967,17 +104269,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",
@@ -104006,7 +104308,8 @@ var schemaDict = {
         },
         errors: [
           {
-            name: "InvalidSwap"
+            name: "InvalidSwap",
+            description: "Indicates that 'swapCommit' didn't match current repo commit."
           }
         ]
       }
@@ -104018,7 +104321,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: {
@@ -104028,7 +104331,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",
@@ -104037,7 +104340,7 @@ var schemaDict = {
               },
               rkey: {
                 type: "string",
-                description: "The key of the record."
+                description: "The Record Key."
               },
               swapRecord: {
                 type: "string",
@@ -104066,7 +104369,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"],
@@ -104099,17 +104402,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)"
               }
             }
           }
@@ -104123,7 +104429,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"],
@@ -104140,7 +104446,7 @@ var schemaDict = {
             },
             rkey: {
               type: "string",
-              description: "The key of the record."
+              description: "The Record Key."
             },
             cid: {
               type: "string",
@@ -104178,7 +104484,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"],
@@ -104262,7 +104568,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: {
@@ -104273,7 +104579,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",
@@ -104282,13 +104588,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",
@@ -104297,7 +104603,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",
@@ -104359,7 +104665,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: "*/*"
         },
@@ -104423,7 +104729,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Create an account.",
+        description: "Create an account. Implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -104435,11 +104741,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"
@@ -104451,13 +104759,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."
               }
             }
           }
@@ -104466,6 +104777,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: {
@@ -104480,10 +104792,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."
               }
             }
           }
@@ -104528,7 +104842,8 @@ var schemaDict = {
             required: ["name"],
             properties: {
               name: {
-                type: "string"
+                type: "string",
+                description: "A short name for the App Password, to help distinguish them."
               }
             }
           }
@@ -104795,7 +105110,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: {
@@ -104832,7 +105147,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "procedure",
-        description: "Delete the current session."
+        description: "Delete the current session. Requires auth."
       }
     }
   },
@@ -104842,7 +105157,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: {
@@ -104850,19 +105165,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"
               }
             }
@@ -104888,7 +105207,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: {
@@ -104898,7 +105217,8 @@ var schemaDict = {
             },
             createAvailable: {
               type: "boolean",
-              default: true
+              default: true,
+              description: "Controls whether any new 'earned' but not 'created' invites should be created."
             }
           }
         },
@@ -104932,7 +105252,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: {
@@ -105012,7 +105332,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: {
@@ -105117,7 +105437,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: {
@@ -105125,7 +105445,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."
               }
             }
           }
@@ -105138,7 +105459,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."
               }
             }
           }
@@ -105244,7 +105565,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"],
@@ -105252,7 +105573,7 @@ var schemaDict = {
             did: {
               type: "string",
               format: "did",
-              description: "The DID of the repo."
+              description: "The DID of the account."
             },
             cid: {
               type: "string",
@@ -105273,7 +105594,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"],
@@ -105367,7 +105688,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"],
@@ -105409,7 +105730,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"],
@@ -105424,7 +105745,8 @@ var schemaDict = {
               format: "nsid"
             },
             rkey: {
-              type: "string"
+              type: "string",
+              description: "Record Key"
             },
             commit: {
               type: "string",
@@ -105445,7 +105767,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"],
@@ -105457,7 +105779,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."
             }
           }
         },
@@ -105473,7 +105795,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"],
@@ -105526,7 +105848,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: {
@@ -105571,7 +105893,8 @@ var schemaDict = {
           },
           head: {
             type: "string",
-            format: "cid"
+            format: "cid",
+            description: "Current repo commit CID"
           },
           rev: {
             type: "string"
@@ -105586,7 +105909,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: {
@@ -105595,7 +105918,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."
               }
             }
           }
@@ -105609,7 +105932,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: {
@@ -105618,7 +105941,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."
               }
             }
           }
@@ -105632,13 +105955,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."
             }
           }
         },
@@ -105659,12 +105982,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",
@@ -105681,59 +106006,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: {
@@ -105755,6 +106090,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: {
@@ -105776,6 +106112,7 @@ var schemaDict = {
       },
       tombstone: {
         type: "object",
+        description: "Indicates that an account has been deleted.",
         required: ["seq", "did", "time"],
         properties: {
           seq: {
@@ -105806,7 +106143,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: {
@@ -105818,7 +106155,8 @@ var schemaDict = {
             type: "string"
           },
           cid: {
-            type: "cid-link"
+            type: "cid-link",
+            description: "For creates and updates, the new record CID. For deletions, null."
           }
         }
       }
@@ -105858,7 +106196,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: {
@@ -105971,7 +106309,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: {
@@ -106044,7 +106382,6 @@ var schemaDict = {
   AppBskyActorDefs: {
     lexicon: 1,
     id: "app.bsky.actor.defs",
-    description: "A reference to an actor in the network.",
     defs: {
       profileViewBasic: {
         type: "object",
@@ -106177,6 +106514,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"
@@ -106261,6 +106599,9 @@ var schemaDict = {
               type: "string",
               format: "at-uri"
             }
+          },
+          timelineIndex: {
+            type: "integer"
           }
         }
       },
@@ -106342,7 +106683,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: {}
@@ -106369,14 +106710,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."
             }
           }
         },
@@ -106436,7 +106778,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: {
@@ -106479,7 +106821,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",
@@ -106491,21 +106833,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"]
             }
           }
@@ -106542,7 +106888,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: {
@@ -106593,7 +106939,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: {
@@ -106635,10 +106981,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: {
@@ -106702,7 +107048,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",
@@ -106728,7 +107074,8 @@ var schemaDict = {
             maxSize: 1e6
           },
           alt: {
-            type: "string"
+            type: "string",
+            description: "Alt text description of the image, for accessibility."
           },
           aspectRatio: {
             type: "ref",
@@ -106770,13 +107117,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",
@@ -106789,7 +107139,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",
@@ -106834,7 +107184,8 @@ var schemaDict = {
             ref: "lex:app.bsky.actor.defs#profileViewBasic"
           },
           value: {
-            type: "unknown"
+            type: "unknown",
+            description: "The record data itself."
           },
           labels: {
             type: "array",
@@ -106898,7 +107249,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",
@@ -106997,6 +107348,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",
@@ -107256,7 +107608,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: {
@@ -107311,7 +107663,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",
@@ -107345,6 +107697,7 @@ var schemaDict = {
             },
             labels: {
               type: "union",
+              description: "Self-label values",
               refs: ["lex:com.atproto.label.defs#selfLabels"]
             },
             createdAt: {
@@ -107362,7 +107715,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"],
@@ -107410,7 +107763,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"],
@@ -107466,7 +107819,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"],
@@ -107486,6 +107839,7 @@ var schemaDict = {
             },
             filter: {
               type: "string",
+              description: "Combinations of post/repost types to include in response.",
               knownValues: [
                 "posts_with_replies",
                 "posts_no_replies",
@@ -107532,7 +107886,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"],
@@ -107585,14 +107939,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."
             }
           }
         },
@@ -107607,10 +107962,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."
               }
             }
           }
@@ -107663,14 +108020,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",
@@ -107716,18 +108074,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",
@@ -107794,14 +108154,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",
@@ -107847,23 +108208,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
@@ -107901,13 +108265,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"
@@ -107941,18 +108306,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",
@@ -108001,7 +108368,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: {
@@ -108044,12 +108411,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",
@@ -108090,7 +108458,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",
@@ -108115,7 +108483,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a post.",
+        description: "Record containing a Bluesky post.",
         key: "tid",
         record: {
           type: "object",
@@ -108124,11 +108492,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"
@@ -108136,6 +108505,7 @@ var schemaDict = {
             },
             facets: {
               type: "array",
+              description: "Annotations of text (mentions, URLs, hashtags, etc)",
               items: {
                 type: "ref",
                 ref: "lex:app.bsky.richtext.facet"
@@ -108156,6 +108526,7 @@ var schemaDict = {
             },
             langs: {
               type: "array",
+              description: "Indicates human language of post primary text content.",
               maxLength: 3,
               items: {
                 type: "string",
@@ -108164,21 +108535,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."
             }
           }
         }
@@ -108237,7 +108610,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: {
@@ -108263,7 +108636,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"],
@@ -108322,14 +108695,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",
@@ -108379,7 +108753,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",
@@ -108387,7 +108761,8 @@ var schemaDict = {
           properties: {
             subject: {
               type: "string",
-              format: "did"
+              format: "did",
+              description: "DID of the account to be blocked."
             },
             createdAt: {
               type: "string",
@@ -108571,7 +108946,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",
@@ -108596,7 +108971,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: {
@@ -108639,7 +109014,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"],
@@ -108691,7 +109066,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"],
@@ -108743,14 +109118,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",
@@ -108795,7 +109171,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: {
@@ -108838,7 +109214,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: {
@@ -108881,14 +109257,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",
@@ -108929,7 +109306,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: {
@@ -108972,17 +109349,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",
@@ -109029,7 +109408,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"],
@@ -109065,7 +109444,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",
@@ -109073,12 +109452,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",
@@ -109116,7 +109497,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",
@@ -109124,7 +109505,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",
@@ -109141,7 +109523,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",
@@ -109149,11 +109531,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",
@@ -109170,7 +109554,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: {
@@ -109193,7 +109577,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: {
@@ -109216,7 +109600,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: {
@@ -109239,7 +109623,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: {
@@ -109262,7 +109646,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: {
@@ -109293,7 +109677,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: {
@@ -109403,7 +109787,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: {
@@ -109436,7 +109820,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: {
@@ -109459,6 +109843,7 @@ var schemaDict = {
     defs: {
       main: {
         type: "object",
+        description: "Annotation of a sub-string within rich text.",
         required: ["index", "features"],
         properties: {
           index: {
@@ -109480,7 +109865,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: {
@@ -109491,7 +109876,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: {
@@ -109502,7 +109887,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: {
@@ -109514,7 +109899,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: {
@@ -110433,7 +110818,7 @@ var import_express2 = __toESM(require_express2());
 function isUndefined(obj) {
   return obj === void 0;
 }
-function isString(obj) {
+function isString2(obj) {
   return typeof obj === "string";
 }
 function isNumber(obj) {
@@ -111175,7 +111560,7 @@ var DynamicReferenceBuilder = class {
   }
 };
 function isDynamicReferenceBuilder(obj) {
-  return isObject2(obj) && isOperationNodeSource(obj) && isString(obj.dynamicReference);
+  return isObject2(obj) && isOperationNodeSource(obj) && isString2(obj.dynamicReference);
 }
 
 // ../../node_modules/.pnpm/kysely@0.22.0/node_modules/kysely/dist/esm/parser/reference-parser.js
@@ -111187,7 +111572,7 @@ function parseReferenceExpressionOrList(arg) {
   }
 }
 function parseReferenceExpression(exp) {
-  if (isString(exp)) {
+  if (isString2(exp)) {
     return parseStringReference(exp);
   } else if (isDynamicReferenceBuilder(exp)) {
     return exp.toOperationNode();
@@ -111337,7 +111722,7 @@ function parseIsFilter(left, op, right) {
   return FilterNode.create(parseReferenceExpression(left), parseFilterOperator(op), ValueNode.createImmediate(right));
 }
 function parseFilterOperator(op) {
-  if (isString(op) && OPERATORS.includes(op)) {
+  if (isString2(op) && OPERATORS.includes(op)) {
     return OperatorNode.create(op);
   } else if (isOperationNodeSource(op)) {
     return op.toOperationNode();
@@ -111440,7 +111825,7 @@ function parseSelectExpressionOrList(selection) {
   }
 }
 function parseSelectExpression(selection) {
-  if (isString(selection)) {
+  if (isString2(selection)) {
     return SelectionNode.create(parseAliasedStringReference(selection));
   } else if (isDynamicReferenceBuilder(selection)) {
     return SelectionNode.create(selection.toOperationNode());
@@ -111458,7 +111843,7 @@ function parseSelectAll(table) {
   }
 }
 function parseSelectAllArg(table) {
-  if (isString(table)) {
+  if (isString2(table)) {
     return SelectionNode.createSelectAllFromTable(parseTable(table));
   }
   throw new Error(`invalid value selectAll expression: ${JSON.stringify(table)}`);
@@ -114388,7 +114773,7 @@ function parseTableExpressionOrList(table) {
   }
 }
 function parseTableExpression(table) {
-  if (isString(table)) {
+  if (isString2(table)) {
     return parseAliasedTable(table);
   } else {
     return parseAliasedComplexExpression(table);
@@ -116703,7 +117088,7 @@ var DefaultQueryCompiler = class extends OperationNodeVisitor {
     this.append(this.getRightIdentifierWrapper());
   }
   compileUnwrappedIdentifier(node) {
-    if (!isString(node.name)) {
+    if (!isString2(node.name)) {
       throw new Error("a non-string identifier was passed to compileUnwrappedIdentifier.");
     }
     this.append(this.sanitizeIdentifier(node.name));
@@ -117402,7 +117787,7 @@ var DefaultQueryCompiler = class extends OperationNodeVisitor {
     this.#parameters.push(parameter);
   }
   appendImmediateValue(value) {
-    if (isString(value)) {
+    if (isString2(value)) {
       this.append(`'${value}'`);
     } else if (isNumber(value) || isBoolean(value)) {
       this.append(value.toString());
@@ -117839,7 +118224,7 @@ ${stackExtension}`;
   return err;
 }
 function isStackHolder(obj) {
-  return isObject2(obj) && isString(obj.stack);
+  return isObject2(obj) && isString2(obj.stack);
 }
 
 // ../../node_modules/.pnpm/kysely@0.22.0/node_modules/kysely/dist/esm/dialect/postgres/postgres-driver.js
@@ -120887,7 +121272,7 @@ var schemaDict2 = {
     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"],
@@ -120921,7 +121306,7 @@ var schemaDict2 = {
     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: {
@@ -120930,7 +121315,8 @@ var schemaDict2 = {
             properties: {
               handle: {
                 type: "string",
-                format: "handle"
+                format: "handle",
+                description: "The new handle."
               }
             }
           }
@@ -121013,7 +121399,7 @@ var schemaDict2 = {
     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"],
@@ -121072,13 +121458,13 @@ var schemaDict2 = {
     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."
             }
           }
         },
@@ -121134,7 +121520,7 @@ var schemaDict2 = {
     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: {
@@ -121143,10 +121529,12 @@ var schemaDict2 = {
             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",
@@ -121255,7 +121643,7 @@ var schemaDict2 = {
     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: {
@@ -121265,12 +121653,12 @@ var schemaDict2 = {
               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",
@@ -121286,6 +121674,7 @@ var schemaDict2 = {
               },
               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"
               }
             }
@@ -121293,13 +121682,14 @@ var schemaDict2 = {
         },
         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: {
@@ -121317,7 +121707,7 @@ var schemaDict2 = {
       },
       update: {
         type: "object",
-        description: "Update an existing record.",
+        description: "Operation which updates an existing record.",
         required: ["collection", "rkey", "value"],
         properties: {
           collection: {
@@ -121334,7 +121724,7 @@ var schemaDict2 = {
       },
       delete: {
         type: "object",
-        description: "Delete an existing record.",
+        description: "Operation which deletes an existing record.",
         required: ["collection", "rkey"],
         properties: {
           collection: {
@@ -121354,7 +121744,7 @@ var schemaDict2 = {
     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: {
@@ -121364,7 +121754,7 @@ var schemaDict2 = {
               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",
@@ -121373,17 +121763,17 @@ var schemaDict2 = {
               },
               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",
@@ -121412,7 +121802,8 @@ var schemaDict2 = {
         },
         errors: [
           {
-            name: "InvalidSwap"
+            name: "InvalidSwap",
+            description: "Indicates that 'swapCommit' didn't match current repo commit."
           }
         ]
       }
@@ -121424,7 +121815,7 @@ var schemaDict2 = {
     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: {
@@ -121434,7 +121825,7 @@ var schemaDict2 = {
               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",
@@ -121443,7 +121834,7 @@ var schemaDict2 = {
               },
               rkey: {
                 type: "string",
-                description: "The key of the record."
+                description: "The Record Key."
               },
               swapRecord: {
                 type: "string",
@@ -121472,7 +121863,7 @@ var schemaDict2 = {
     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"],
@@ -121505,17 +121896,20 @@ var schemaDict2 = {
                 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)"
               }
             }
           }
@@ -121529,7 +121923,7 @@ var schemaDict2 = {
     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"],
@@ -121546,7 +121940,7 @@ var schemaDict2 = {
             },
             rkey: {
               type: "string",
-              description: "The key of the record."
+              description: "The Record Key."
             },
             cid: {
               type: "string",
@@ -121584,7 +121978,7 @@ var schemaDict2 = {
     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"],
@@ -121668,7 +122062,7 @@ var schemaDict2 = {
     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: {
@@ -121679,7 +122073,7 @@ var schemaDict2 = {
               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",
@@ -121688,13 +122082,13 @@ var schemaDict2 = {
               },
               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",
@@ -121703,7 +122097,7 @@ var schemaDict2 = {
               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",
@@ -121765,7 +122159,7 @@ var schemaDict2 = {
     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: "*/*"
         },
@@ -121829,7 +122223,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "procedure",
-        description: "Create an account.",
+        description: "Create an account. Implemented by PDS.",
         input: {
           encoding: "application/json",
           schema: {
@@ -121841,11 +122235,13 @@ var schemaDict2 = {
               },
               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"
@@ -121857,13 +122253,16 @@ var schemaDict2 = {
                 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."
               }
             }
           }
@@ -121872,6 +122271,7 @@ var schemaDict2 = {
           encoding: "application/json",
           schema: {
             type: "object",
+            description: "Account login session returned on successful account creation.",
             required: ["accessJwt", "refreshJwt", "handle", "did"],
             properties: {
               accessJwt: {
@@ -121886,10 +122286,12 @@ var schemaDict2 = {
               },
               did: {
                 type: "string",
-                format: "did"
+                format: "did",
+                description: "The DID of the new account."
               },
               didDoc: {
-                type: "unknown"
+                type: "unknown",
+                description: "Complete DID document."
               }
             }
           }
@@ -121934,7 +122336,8 @@ var schemaDict2 = {
             required: ["name"],
             properties: {
               name: {
-                type: "string"
+                type: "string",
+                description: "A short name for the App Password, to help distinguish them."
               }
             }
           }
@@ -122201,7 +122604,7 @@ var schemaDict2 = {
     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: {
@@ -122238,7 +122641,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "procedure",
-        description: "Delete the current session."
+        description: "Delete the current session. Requires auth."
       }
     }
   },
@@ -122248,7 +122651,7 @@ var schemaDict2 = {
     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: {
@@ -122256,19 +122659,23 @@ var schemaDict2 = {
             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"
               }
             }
@@ -122294,7 +122701,7 @@ var schemaDict2 = {
     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: {
@@ -122304,7 +122711,8 @@ var schemaDict2 = {
             },
             createAvailable: {
               type: "boolean",
-              default: true
+              default: true,
+              description: "Controls whether any new 'earned' but not 'created' invites should be created."
             }
           }
         },
@@ -122338,7 +122746,7 @@ var schemaDict2 = {
     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: {
@@ -122418,7 +122826,7 @@ var schemaDict2 = {
     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: {
@@ -122523,7 +122931,7 @@ var schemaDict2 = {
     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: {
@@ -122531,7 +122939,8 @@ var schemaDict2 = {
             properties: {
               did: {
                 type: "string",
-                description: "The did to reserve a new did:key for"
+                format: "did",
+                description: "The DID to reserve a key for."
               }
             }
           }
@@ -122544,7 +122953,7 @@ var schemaDict2 = {
             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."
               }
             }
           }
@@ -122650,7 +123059,7 @@ var schemaDict2 = {
     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"],
@@ -122658,7 +123067,7 @@ var schemaDict2 = {
             did: {
               type: "string",
               format: "did",
-              description: "The DID of the repo."
+              description: "The DID of the account."
             },
             cid: {
               type: "string",
@@ -122679,7 +123088,7 @@ var schemaDict2 = {
     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"],
@@ -122773,7 +123182,7 @@ var schemaDict2 = {
     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"],
@@ -122815,7 +123224,7 @@ var schemaDict2 = {
     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"],
@@ -122830,7 +123239,8 @@ var schemaDict2 = {
               format: "nsid"
             },
             rkey: {
-              type: "string"
+              type: "string",
+              description: "Record Key"
             },
             commit: {
               type: "string",
@@ -122851,7 +123261,7 @@ var schemaDict2 = {
     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"],
@@ -122863,7 +123273,7 @@ var schemaDict2 = {
             },
             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."
             }
           }
         },
@@ -122879,7 +123289,7 @@ var schemaDict2 = {
     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"],
@@ -122932,7 +123342,7 @@ var schemaDict2 = {
     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: {
@@ -122977,7 +123387,8 @@ var schemaDict2 = {
           },
           head: {
             type: "string",
-            format: "cid"
+            format: "cid",
+            description: "Current repo commit CID"
           },
           rev: {
             type: "string"
@@ -122992,7 +123403,7 @@ var schemaDict2 = {
     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: {
@@ -123001,7 +123412,7 @@ var schemaDict2 = {
             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."
               }
             }
           }
@@ -123015,7 +123426,7 @@ var schemaDict2 = {
     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: {
@@ -123024,7 +123435,7 @@ var schemaDict2 = {
             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."
               }
             }
           }
@@ -123038,13 +123449,13 @@ var schemaDict2 = {
     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."
             }
           }
         },
@@ -123065,12 +123476,14 @@ var schemaDict2 = {
             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",
@@ -123087,59 +123500,69 @@ var schemaDict2 = {
         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: {
@@ -123161,6 +123584,7 @@ var schemaDict2 = {
       },
       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: {
@@ -123182,6 +123606,7 @@ var schemaDict2 = {
       },
       tombstone: {
         type: "object",
+        description: "Indicates that an account has been deleted.",
         required: ["seq", "did", "time"],
         properties: {
           seq: {
@@ -123212,7 +123637,7 @@ var schemaDict2 = {
       },
       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: {
@@ -123224,7 +123649,8 @@ var schemaDict2 = {
             type: "string"
           },
           cid: {
-            type: "cid-link"
+            type: "cid-link",
+            description: "For creates and updates, the new record CID. For deletions, null."
           }
         }
       }
@@ -123264,7 +123690,7 @@ var schemaDict2 = {
     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: {
@@ -123377,7 +123803,7 @@ var schemaDict2 = {
     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: {
@@ -123450,7 +123876,6 @@ var schemaDict2 = {
   AppBskyActorDefs: {
     lexicon: 1,
     id: "app.bsky.actor.defs",
-    description: "A reference to an actor in the network.",
     defs: {
       profileViewBasic: {
         type: "object",
@@ -123583,6 +124008,7 @@ var schemaDict2 = {
       },
       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"
@@ -123667,6 +124093,9 @@ var schemaDict2 = {
               type: "string",
               format: "at-uri"
             }
+          },
+          timelineIndex: {
+            type: "integer"
           }
         }
       },
@@ -123748,7 +124177,7 @@ var schemaDict2 = {
     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: {}
@@ -123775,14 +124204,15 @@ var schemaDict2 = {
     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."
             }
           }
         },
@@ -123842,7 +124272,7 @@ var schemaDict2 = {
     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: {
@@ -123885,7 +124315,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a profile.",
+        description: "A declaration of a Bluesky account profile.",
         key: "literal:self",
         record: {
           type: "object",
@@ -123897,21 +124327,25 @@ var schemaDict2 = {
             },
             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"]
             }
           }
@@ -123948,7 +124382,7 @@ var schemaDict2 = {
     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: {
@@ -123999,7 +124433,7 @@ var schemaDict2 = {
     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: {
@@ -124041,10 +124475,10 @@ var schemaDict2 = {
   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: {
@@ -124108,7 +124542,7 @@ var schemaDict2 = {
   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",
@@ -124134,7 +124568,8 @@ var schemaDict2 = {
             maxSize: 1e6
           },
           alt: {
-            type: "string"
+            type: "string",
+            description: "Alt text description of the image, for accessibility."
           },
           aspectRatio: {
             type: "ref",
@@ -124176,13 +124611,16 @@ var schemaDict2 = {
         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",
@@ -124195,7 +124633,7 @@ var schemaDict2 = {
   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",
@@ -124240,7 +124678,8 @@ var schemaDict2 = {
             ref: "lex:app.bsky.actor.defs#profileViewBasic"
           },
           value: {
-            type: "unknown"
+            type: "unknown",
+            description: "The record data itself."
           },
           labels: {
             type: "array",
@@ -124304,7 +124743,7 @@ var schemaDict2 = {
   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",
@@ -124403,6 +124842,7 @@ var schemaDict2 = {
       },
       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",
@@ -124662,7 +125102,7 @@ var schemaDict2 = {
     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: {
@@ -124717,7 +125157,7 @@ var schemaDict2 = {
     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",
@@ -124751,6 +125191,7 @@ var schemaDict2 = {
             },
             labels: {
               type: "union",
+              description: "Self-label values",
               refs: ["lex:com.atproto.label.defs#selfLabels"]
             },
             createdAt: {
@@ -124768,7 +125209,7 @@ var schemaDict2 = {
     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"],
@@ -124816,7 +125257,7 @@ var schemaDict2 = {
     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"],
@@ -124872,7 +125313,7 @@ var schemaDict2 = {
     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"],
@@ -124892,6 +125333,7 @@ var schemaDict2 = {
             },
             filter: {
               type: "string",
+              description: "Combinations of post/repost types to include in response.",
               knownValues: [
                 "posts_with_replies",
                 "posts_no_replies",
@@ -124938,7 +125380,7 @@ var schemaDict2 = {
     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"],
@@ -124991,14 +125433,15 @@ var schemaDict2 = {
     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."
             }
           }
         },
@@ -125013,10 +125456,12 @@ var schemaDict2 = {
                 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."
               }
             }
           }
@@ -125069,14 +125514,15 @@ var schemaDict2 = {
     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",
@@ -125122,18 +125568,20 @@ var schemaDict2 = {
     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",
@@ -125200,14 +125648,15 @@ var schemaDict2 = {
     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",
@@ -125253,23 +125702,26 @@ var schemaDict2 = {
     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
@@ -125307,13 +125759,14 @@ var schemaDict2 = {
     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"
@@ -125347,18 +125800,20 @@ var schemaDict2 = {
     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",
@@ -125407,7 +125862,7 @@ var schemaDict2 = {
     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: {
@@ -125450,12 +125905,13 @@ var schemaDict2 = {
     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",
@@ -125496,7 +125952,7 @@ var schemaDict2 = {
     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",
@@ -125521,7 +125977,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "record",
-        description: "A declaration of a post.",
+        description: "Record containing a Bluesky post.",
         key: "tid",
         record: {
           type: "object",
@@ -125530,11 +125986,12 @@ var schemaDict2 = {
             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"
@@ -125542,6 +125999,7 @@ var schemaDict2 = {
             },
             facets: {
               type: "array",
+              description: "Annotations of text (mentions, URLs, hashtags, etc)",
               items: {
                 type: "ref",
                 ref: "lex:app.bsky.richtext.facet"
@@ -125562,6 +126020,7 @@ var schemaDict2 = {
             },
             langs: {
               type: "array",
+              description: "Indicates human language of post primary text content.",
               maxLength: 3,
               items: {
                 type: "string",
@@ -125570,21 +126029,23 @@ var schemaDict2 = {
             },
             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."
             }
           }
         }
@@ -125643,7 +126104,7 @@ var schemaDict2 = {
     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: {
@@ -125669,7 +126130,7 @@ var schemaDict2 = {
     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"],
@@ -125728,14 +126189,15 @@ var schemaDict2 = {
       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",
@@ -125785,7 +126247,7 @@ var schemaDict2 = {
     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",
@@ -125793,7 +126255,8 @@ var schemaDict2 = {
           properties: {
             subject: {
               type: "string",
-              format: "did"
+              format: "did",
+              description: "DID of the account to be blocked."
             },
             createdAt: {
               type: "string",
@@ -125977,7 +126440,7 @@ var schemaDict2 = {
     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",
@@ -126002,7 +126465,7 @@ var schemaDict2 = {
     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: {
@@ -126045,7 +126508,7 @@ var schemaDict2 = {
     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"],
@@ -126097,7 +126560,7 @@ var schemaDict2 = {
     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"],
@@ -126149,14 +126612,15 @@ var schemaDict2 = {
     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",
@@ -126201,7 +126665,7 @@ var schemaDict2 = {
     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: {
@@ -126244,7 +126708,7 @@ var schemaDict2 = {
     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: {
@@ -126287,14 +126751,15 @@ var schemaDict2 = {
     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",
@@ -126335,7 +126800,7 @@ var schemaDict2 = {
     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: {
@@ -126378,17 +126843,19 @@ var schemaDict2 = {
     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",
@@ -126435,7 +126902,7 @@ var schemaDict2 = {
     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"],
@@ -126471,7 +126938,7 @@ var schemaDict2 = {
     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",
@@ -126479,12 +126946,14 @@ var schemaDict2 = {
           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",
@@ -126522,7 +126991,7 @@ var schemaDict2 = {
     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",
@@ -126530,7 +126999,8 @@ var schemaDict2 = {
           properties: {
             subject: {
               type: "string",
-              format: "at-uri"
+              format: "at-uri",
+              description: "Reference (AT-URI) to the mod list record."
             },
             createdAt: {
               type: "string",
@@ -126547,7 +127017,7 @@ var schemaDict2 = {
     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",
@@ -126555,11 +127025,13 @@ var schemaDict2 = {
           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",
@@ -126576,7 +127048,7 @@ var schemaDict2 = {
     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: {
@@ -126599,7 +127071,7 @@ var schemaDict2 = {
     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: {
@@ -126622,7 +127094,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "procedure",
-        description: "Unmute an actor by DID or handle.",
+        description: "Unmutes the specified account. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -126645,7 +127117,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "procedure",
-        description: "Unmute a list of actors.",
+        description: "Unmutes the specified list of accounts. Requires auth.",
         input: {
           encoding: "application/json",
           schema: {
@@ -126668,7 +127140,7 @@ var schemaDict2 = {
     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: {
@@ -126699,7 +127171,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "query",
-        description: "Get a list of notifications.",
+        description: "Enumerate notifications for the requesting account. Requires auth.",
         parameters: {
           type: "params",
           properties: {
@@ -126809,7 +127281,7 @@ var schemaDict2 = {
     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: {
@@ -126842,7 +127314,7 @@ var schemaDict2 = {
     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: {
@@ -126865,6 +127337,7 @@ var schemaDict2 = {
     defs: {
       main: {
         type: "object",
+        description: "Annotation of a sub-string within rich text.",
         required: ["index", "features"],
         properties: {
           index: {
@@ -126886,7 +127359,7 @@ var schemaDict2 = {
       },
       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: {
@@ -126897,7 +127370,7 @@ var schemaDict2 = {
       },
       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: {
@@ -126908,7 +127381,7 @@ var schemaDict2 = {
       },
       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: {
@@ -126920,7 +127393,7 @@ var schemaDict2 = {
       },
       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: {