@fern-api/fern-api-dev 5.33.7 → 5.35.0

package/cli.cjs

@@ -4178,8 +4178,8 @@ function hrTimeDuration(startTime, endTime) {
 }
 function hrTimeToTimeStamp(time3) {
   const precision = NANOSECOND_DIGITS;
-  const tmp18 = `${"0".repeat(precision)}${time3[1]}Z`;
-  const nanoString = tmp18.substring(tmp18.length - precision - 1);
+  const tmp19 = `${"0".repeat(precision)}${time3[1]}Z`;
+  const nanoString = tmp19.substring(tmp19.length - precision - 1);
   const date26 = new Date(time3[0] * 1e3).toISOString();
   return date26.replace("000Z", nanoString);
 }
@@ -20549,15 +20549,15 @@ var init_cliui = __esm({
 // ../../../node_modules/.pnpm/escalade@3.2.0/node_modules/escalade/sync/index.mjs
 function sync_default(start2, callback) {
   let dir = (0, import_path5.resolve)(".", start2);
-  let tmp18, stats = (0, import_fs4.statSync)(dir);
+  let tmp19, stats = (0, import_fs4.statSync)(dir);
   if (!stats.isDirectory()) {
     dir = (0, import_path5.dirname)(dir);
   }
   while (true) {
-    tmp18 = callback(dir, (0, import_fs4.readdirSync)(dir));
-    if (tmp18) return (0, import_path5.resolve)(dir, tmp18);
-    dir = (0, import_path5.dirname)(tmp18 = dir);
-    if (tmp18 === dir) break;
+    tmp19 = callback(dir, (0, import_fs4.readdirSync)(dir));
+    if (tmp19) return (0, import_path5.resolve)(dir, tmp19);
+    dir = (0, import_path5.dirname)(tmp19 = dir);
+    if (tmp19 === dir) break;
   }
 }
 var import_path5, import_fs4;
@@ -27167,16 +27167,16 @@ var init_index_node_esm = __esm({
         for (let t3 = 0; t3 < ret.length; t3++) {
           const rett = ret[t3];
           if (rett && rett.isParentSelector) {
-            const tmp18 = this._trace(rett.expr, val, rett.path, parent, parentPropName, callback, hasArrExpr);
-            if (Array.isArray(tmp18)) {
-              ret[t3] = tmp18[0];
-              const tl5 = tmp18.length;
+            const tmp19 = this._trace(rett.expr, val, rett.path, parent, parentPropName, callback, hasArrExpr);
+            if (Array.isArray(tmp19)) {
+              ret[t3] = tmp19[0];
+              const tl5 = tmp19.length;
               for (let tt9 = 1; tt9 < tl5; tt9++) {
                 t3++;
-                ret.splice(t3, 0, tmp18[tt9]);
+                ret.splice(t3, 0, tmp19[tt9]);
               }
             } else {
-              ret[t3] = tmp18;
+              ret[t3] = tmp19;
             }
           }
         }
@@ -27205,8 +27205,8 @@ var init_index_node_esm = __esm({
       end = end < 0 ? Math.max(0, end + len) : Math.min(len, end);
       const ret = [];
       for (let i9 = start2; i9 < end; i9 += step) {
-        const tmp18 = this._trace(unshift(i9, expr), val, path115, parent, parentPropName, callback, true);
-        tmp18.forEach((t3) => {
+        const tmp19 = this._trace(unshift(i9, expr), val, path115, parent, parentPropName, callback, true);
+        tmp19.forEach((t3) => {
           ret.push(t3);
         });
       }
@@ -53021,10 +53021,10 @@ var require_tmp_promise = __commonJS({
   "../../../node_modules/.pnpm/tmp-promise@3.0.3/node_modules/tmp-promise/index.js"(exports2, module4) {
     "use strict";
     var { promisify: promisify8 } = require("util");
-    var tmp18 = require_tmp();
-    module4.exports.fileSync = tmp18.fileSync;
+    var tmp19 = require_tmp();
+    module4.exports.fileSync = tmp19.fileSync;
     var fileWithOptions = promisify8(
-      (options2, cb) => tmp18.file(
+      (options2, cb) => tmp19.file(
         options2,
         (err, path115, fd2, cleanup) => err ? cb(err) : cb(void 0, { path: path115, fd: fd2, cleanup: promisify8(cleanup) })
       )
@@ -53038,9 +53038,9 @@ var require_tmp_promise = __commonJS({
         await cleanup();
       }
     };
-    module4.exports.dirSync = tmp18.dirSync;
+    module4.exports.dirSync = tmp19.dirSync;
     var dirWithOptions = promisify8(
-      (options2, cb) => tmp18.dir(
+      (options2, cb) => tmp19.dir(
         options2,
         (err, path115, cleanup) => err ? cb(err) : cb(void 0, { path: path115, cleanup: promisify8(cleanup) })
       )
@@ -53054,10 +53054,10 @@ var require_tmp_promise = __commonJS({
         await cleanup();
       }
     };
-    module4.exports.tmpNameSync = tmp18.tmpNameSync;
-    module4.exports.tmpName = promisify8(tmp18.tmpName);
-    module4.exports.tmpdir = tmp18.tmpdir;
-    module4.exports.setGracefulCleanup = tmp18.setGracefulCleanup;
+    module4.exports.tmpNameSync = tmp19.tmpNameSync;
+    module4.exports.tmpName = promisify8(tmp19.tmpName);
+    module4.exports.tmpdir = tmp19.tmpdir;
+    module4.exports.setGracefulCleanup = tmp19.setGracefulCleanup;
   }
 });
 
@@ -59058,23 +59058,23 @@ function getValues(context3, operator2, key2, modifier) {
           });
         }
       } else {
-        const tmp18 = [];
+        const tmp19 = [];
         if (Array.isArray(value2)) {
           value2.filter(isDefined).forEach(function(value22) {
-            tmp18.push(encodeValue(operator2, value22));
+            tmp19.push(encodeValue(operator2, value22));
           });
         } else {
           Object.keys(value2).forEach(function(k5) {
             if (isDefined(value2[k5])) {
-              tmp18.push(encodeUnreserved(k5));
-              tmp18.push(encodeValue(operator2, value2[k5].toString()));
+              tmp19.push(encodeUnreserved(k5));
+              tmp19.push(encodeValue(operator2, value2[k5].toString()));
             }
           });
         }
         if (isKeyOperator(operator2)) {
-          result.push(encodeUnreserved(key2) + "=" + tmp18.join(","));
-        } else if (tmp18.length !== 0) {
-          result.push(tmp18.join(","));
+          result.push(encodeUnreserved(key2) + "=" + tmp19.join(","));
+        } else if (tmp19.length !== 0) {
+          result.push(tmp19.join(","));
         }
       }
     }
@@ -59109,8 +59109,8 @@ function expand2(template, context3) {
           expression = expression.substr(1);
         }
         expression.split(/,/g).forEach(function(variable3) {
-          var tmp18 = /([^:\*]*)(?::(\d+)|(\*))?/.exec(variable3);
-          values2.push(getValues(context3, operator2, tmp18[1], tmp18[2] || tmp18[3]));
+          var tmp19 = /([^:\*]*)(?::(\d+)|(\*))?/.exec(variable3);
+          values2.push(getValues(context3, operator2, tmp19[1], tmp19[2] || tmp19[3]));
         });
         if (operator2 && operator2 !== "+") {
           var separator = ",";
@@ -70623,7 +70623,7 @@ function readSingleQuotedScalar(state, nodeIndent) {
   throwError(state, "unexpected end of the stream within a single quoted scalar");
 }
 function readDoubleQuotedScalar(state, nodeIndent) {
-  var captureStart, captureEnd, hexLength, hexResult, tmp18, ch;
+  var captureStart, captureEnd, hexLength, hexResult, tmp19, ch;
   ch = state.input.charCodeAt(state.position);
   if (ch !== 34) {
     return false;
@@ -70645,13 +70645,13 @@ function readDoubleQuotedScalar(state, nodeIndent) {
       } else if (ch < 256 && simpleEscapeCheck[ch]) {
         state.result += simpleEscapeMap[ch];
         state.position++;
-      } else if ((tmp18 = escapedHexLen(ch)) > 0) {
-        hexLength = tmp18;
+      } else if ((tmp19 = escapedHexLen(ch)) > 0) {
+        hexLength = tmp19;
         hexResult = 0;
         for (; hexLength > 0; hexLength--) {
           ch = state.input.charCodeAt(++state.position);
-          if ((tmp18 = fromHexCode(ch)) >= 0) {
-            hexResult = (hexResult << 4) + tmp18;
+          if ((tmp19 = fromHexCode(ch)) >= 0) {
+            hexResult = (hexResult << 4) + tmp19;
           } else {
             throwError(state, "expected hexadecimal character");
           }
@@ -70752,7 +70752,7 @@ function readFlowCollection(state, nodeIndent) {
   throwError(state, "unexpected end of the stream within a flow collection");
 }
 function readBlockScalar(state, nodeIndent) {
-  var captureStart, folding, chomping = CHOMPING_CLIP, didReadContent = false, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp18, ch;
+  var captureStart, folding, chomping = CHOMPING_CLIP, didReadContent = false, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp19, ch;
   ch = state.input.charCodeAt(state.position);
   if (ch === 124) {
     folding = false;
@@ -70771,11 +70771,11 @@ function readBlockScalar(state, nodeIndent) {
       } else {
         throwError(state, "repeat of a chomping mode identifier");
       }
-    } else if ((tmp18 = fromDecimalCode(ch)) >= 0) {
-      if (tmp18 === 0) {
+    } else if ((tmp19 = fromDecimalCode(ch)) >= 0) {
+      if (tmp19 === 0) {
         throwError(state, "bad explicit indentation width of a block scalar; it cannot be less than one");
       } else if (!detectedIndent) {
-        textIndent = nodeIndent + tmp18 - 1;
+        textIndent = nodeIndent + tmp19 - 1;
         detectedIndent = true;
       } else {
         throwError(state, "repeat of an indentation width identifier");
@@ -77859,7 +77859,7 @@ var require_loader = __commonJS({
       throwError2(state, "unexpected end of the stream within a single quoted scalar");
     }
     function readDoubleQuotedScalar2(state, nodeIndent) {
-      var captureStart, captureEnd, hexLength, hexResult, tmp18, ch;
+      var captureStart, captureEnd, hexLength, hexResult, tmp19, ch;
       ch = state.input.charCodeAt(state.position);
       if (ch !== 34) {
         return false;
@@ -77881,13 +77881,13 @@ var require_loader = __commonJS({
           } else if (ch < 256 && simpleEscapeCheck2[ch]) {
             state.result += simpleEscapeMap2[ch];
             state.position++;
-          } else if ((tmp18 = escapedHexLen2(ch)) > 0) {
-            hexLength = tmp18;
+          } else if ((tmp19 = escapedHexLen2(ch)) > 0) {
+            hexLength = tmp19;
             hexResult = 0;
             for (; hexLength > 0; hexLength--) {
               ch = state.input.charCodeAt(++state.position);
-              if ((tmp18 = fromHexCode2(ch)) >= 0) {
-                hexResult = (hexResult << 4) + tmp18;
+              if ((tmp19 = fromHexCode2(ch)) >= 0) {
+                hexResult = (hexResult << 4) + tmp19;
               } else {
                 throwError2(state, "expected hexadecimal character");
               }
@@ -77988,7 +77988,7 @@ var require_loader = __commonJS({
       throwError2(state, "unexpected end of the stream within a flow collection");
     }
     function readBlockScalar2(state, nodeIndent) {
-      var captureStart, folding, chomping = CHOMPING_CLIP2, didReadContent = false, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp18, ch;
+      var captureStart, folding, chomping = CHOMPING_CLIP2, didReadContent = false, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp19, ch;
       ch = state.input.charCodeAt(state.position);
       if (ch === 124) {
         folding = false;
@@ -78007,11 +78007,11 @@ var require_loader = __commonJS({
           } else {
             throwError2(state, "repeat of a chomping mode identifier");
           }
-        } else if ((tmp18 = fromDecimalCode2(ch)) >= 0) {
-          if (tmp18 === 0) {
+        } else if ((tmp19 = fromDecimalCode2(ch)) >= 0) {
+          if (tmp19 === 0) {
             throwError2(state, "bad explicit indentation width of a block scalar; it cannot be less than one");
           } else if (!detectedIndent) {
-            textIndent = nodeIndent + tmp18 - 1;
+            textIndent = nodeIndent + tmp19 - 1;
             detectedIndent = true;
           } else {
             throwError2(state, "repeat of an indentation width identifier");
@@ -95473,9 +95473,9 @@ var require_js_levenshtein = __commonJS({
           return 0;
         }
         if (a3.length > b8.length) {
-          var tmp18 = a3;
+          var tmp19 = a3;
           a3 = b8;
-          b8 = tmp18;
+          b8 = tmp19;
         }
         var la7 = a3.length;
         var lb = b8.length;
@@ -104092,7 +104092,7 @@ var require_loader2 = __commonJS({
       throwError2(state, "unexpected end of the stream within a single quoted scalar");
     }
     function readDoubleQuotedScalar2(state, nodeIndent) {
-      var captureStart, captureEnd, hexLength, hexResult, tmp18, tmpEsc, ch;
+      var captureStart, captureEnd, hexLength, hexResult, tmp19, tmpEsc, ch;
       ch = state.input.charCodeAt(state.position);
       if (34 !== ch) {
         return false;
@@ -104119,13 +104119,13 @@ var require_loader2 = __commonJS({
           } else if (ch < 256 && (state.allowAnyEscape ? customEscapeCheck[ch] : simpleEscapeCheck2[ch])) {
             scalar.value += state.allowAnyEscape ? customEscapeMap[ch] : simpleEscapeMap2[ch];
             state.position++;
-          } else if ((tmp18 = escapedHexLen2(ch)) > 0) {
-            hexLength = tmp18;
+          } else if ((tmp19 = escapedHexLen2(ch)) > 0) {
+            hexLength = tmp19;
             hexResult = 0;
             for (; hexLength > 0; hexLength--) {
               ch = state.input.charCodeAt(++state.position);
-              if ((tmp18 = fromHexCode2(ch)) >= 0) {
-                hexResult = (hexResult << 4) + tmp18;
+              if ((tmp19 = fromHexCode2(ch)) >= 0) {
+                hexResult = (hexResult << 4) + tmp19;
               } else {
                 throwError2(state, "expected hexadecimal character");
               }
@@ -104234,7 +104234,7 @@ var require_loader2 = __commonJS({
       throwError2(state, "unexpected end of the stream within a flow collection");
     }
     function readBlockScalar2(state, nodeIndent) {
-      var captureStart, folding, chomping = CHOMPING_CLIP2, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp18, ch;
+      var captureStart, folding, chomping = CHOMPING_CLIP2, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp19, ch;
       ch = state.input.charCodeAt(state.position);
       if (ch === 124) {
         folding = false;
@@ -104255,11 +104255,11 @@ var require_loader2 = __commonJS({
           } else {
             throwError2(state, "repeat of a chomping mode identifier");
           }
-        } else if ((tmp18 = fromDecimalCode2(ch)) >= 0) {
-          if (tmp18 === 0) {
+        } else if ((tmp19 = fromDecimalCode2(ch)) >= 0) {
+          if (tmp19 === 0) {
             throwError2(state, "bad explicit indentation width of a block scalar; it cannot be less than one");
           } else if (!detectedIndent) {
-            textIndent = nodeIndent + tmp18 - 1;
+            textIndent = nodeIndent + tmp19 - 1;
             detectedIndent = true;
           } else {
             throwError2(state, "repeat of an indentation width identifier");
@@ -181714,7 +181714,7 @@ var require_loader3 = __commonJS({
       throwError2(state, "unexpected end of the stream within a single quoted scalar");
     }
     function readDoubleQuotedScalar2(state, nodeIndent) {
-      var captureStart, captureEnd, hexLength, hexResult, tmp18, ch;
+      var captureStart, captureEnd, hexLength, hexResult, tmp19, ch;
       ch = state.input.charCodeAt(state.position);
       if (ch !== 34) {
         return false;
@@ -181736,13 +181736,13 @@ var require_loader3 = __commonJS({
           } else if (ch < 256 && simpleEscapeCheck2[ch]) {
             state.result += simpleEscapeMap2[ch];
             state.position++;
-          } else if ((tmp18 = escapedHexLen2(ch)) > 0) {
-            hexLength = tmp18;
+          } else if ((tmp19 = escapedHexLen2(ch)) > 0) {
+            hexLength = tmp19;
             hexResult = 0;
             for (; hexLength > 0; hexLength--) {
               ch = state.input.charCodeAt(++state.position);
-              if ((tmp18 = fromHexCode2(ch)) >= 0) {
-                hexResult = (hexResult << 4) + tmp18;
+              if ((tmp19 = fromHexCode2(ch)) >= 0) {
+                hexResult = (hexResult << 4) + tmp19;
               } else {
                 throwError2(state, "expected hexadecimal character");
               }
@@ -181839,7 +181839,7 @@ var require_loader3 = __commonJS({
       throwError2(state, "unexpected end of the stream within a flow collection");
     }
     function readBlockScalar2(state, nodeIndent) {
-      var captureStart, folding, chomping = CHOMPING_CLIP2, didReadContent = false, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp18, ch;
+      var captureStart, folding, chomping = CHOMPING_CLIP2, didReadContent = false, detectedIndent = false, textIndent = nodeIndent, emptyLines = 0, atMoreIndented = false, tmp19, ch;
       ch = state.input.charCodeAt(state.position);
       if (ch === 124) {
         folding = false;
@@ -181858,11 +181858,11 @@ var require_loader3 = __commonJS({
           } else {
             throwError2(state, "repeat of a chomping mode identifier");
           }
-        } else if ((tmp18 = fromDecimalCode2(ch)) >= 0) {
-          if (tmp18 === 0) {
+        } else if ((tmp19 = fromDecimalCode2(ch)) >= 0) {
+          if (tmp19 === 0) {
             throwError2(state, "bad explicit indentation width of a block scalar; it cannot be less than one");
           } else if (!detectedIndent) {
-            textIndent = nodeIndent + tmp18 - 1;
+            textIndent = nodeIndent + tmp19 - 1;
             detectedIndent = true;
           } else {
             throwError2(state, "repeat of an indentation width identifier");
@@ -188523,16 +188523,16 @@ var require_URLSearchParams = __commonJS({
                     );
                   } else {
                     const V5 = [];
-                    const tmp18 = curArg;
-                    for (let nextItem of tmp18) {
+                    const tmp19 = curArg;
+                    for (let nextItem of tmp19) {
                       if (!utils2.isObject(nextItem)) {
                         throw new globalObject.TypeError(
                           "Failed to construct 'URLSearchParams': parameter 1 sequence's element is not an iterable object."
                         );
                       } else {
                         const V6 = [];
-                        const tmp19 = nextItem;
-                        for (let nextItem2 of tmp19) {
+                        const tmp20 = nextItem;
+                        for (let nextItem2 of tmp20) {
                           nextItem2 = conversions["USVString"](nextItem2, {
                             context: "Failed to construct 'URLSearchParams': parameter 1 sequence's element's element",
                             globals: globalObject
@@ -222713,13 +222713,13 @@ var require_fast_safe_stringify = __commonJS({
       if (typeof options2 === "undefined") {
         options2 = defaultOptions3();
       }
-      var tmp18 = deterministicDecirc(obj, "", 0, [], void 0, 0, options2) || obj;
+      var tmp19 = deterministicDecirc(obj, "", 0, [], void 0, 0, options2) || obj;
       var res;
       try {
         if (replacerStack.length === 0) {
-          res = JSON.stringify(tmp18, replacer, spacer);
+          res = JSON.stringify(tmp19, replacer, spacer);
         } else {
-          res = JSON.stringify(tmp18, replaceGetterValues(replacer), spacer);
+          res = JSON.stringify(tmp19, replaceGetterValues(replacer), spacer);
         }
       } catch (_7) {
         return JSON.stringify("[unable to serialize, circular reference is too complex to analyze]");
@@ -222766,18 +222766,18 @@ var require_fast_safe_stringify = __commonJS({
             deterministicDecirc(val[i9], i9, i9, stack, val, depth, options2);
           }
         } else {
-          var tmp18 = {};
+          var tmp19 = {};
           var keys25 = Object.keys(val).sort(compareFunction);
           for (i9 = 0; i9 < keys25.length; i9++) {
             var key2 = keys25[i9];
             deterministicDecirc(val[key2], key2, i9, stack, val, depth, options2);
-            tmp18[key2] = val[key2];
+            tmp19[key2] = val[key2];
           }
           if (typeof parent !== "undefined") {
             arr.push([parent, k5, val]);
-            parent[k5] = tmp18;
+            parent[k5] = tmp19;
           } else {
-            return tmp18;
+            return tmp19;
           }
         }
         stack.pop();
@@ -229775,9 +229775,9 @@ var init_suggestionList = __esm({
         let a3 = stringToArray2(optionLowerCase);
         let b8 = this._inputArray;
         if (a3.length < b8.length) {
-          const tmp18 = a3;
+          const tmp19 = a3;
           a3 = b8;
-          b8 = tmp18;
+          b8 = tmp19;
         }
         const aLength = a3.length;
         const bLength = b8.length;
@@ -236720,10 +236720,28 @@ var init_GraphQLConverter = __esm({
       namespace;
       processingTypes = /* @__PURE__ */ new Set();
       types = {};
-      constructor({ context: context3, filePath, namespace }) {
+      examplesByOperation = /* @__PURE__ */ new Map();
+      constructor({ context: context3, filePath, namespace, examples }) {
         this.context = context3;
         this.filePath = filePath;
         this.namespace = namespace;
+        if (examples != null) {
+          for (const entry of examples) {
+            const mapped = entry.examples.map((ex) => ({
+              name: ex.name ?? void 0,
+              description: ex.description ?? void 0,
+              query: ex.query,
+              variables: ex.variables ?? void 0,
+              response: ex.response ?? void 0
+            }));
+            if (entry.operationType != null) {
+              const key2 = `${entry.operationType.toLowerCase()}:${entry.operation}`;
+              this.examplesByOperation.set(key2, mapped);
+            } else {
+              this.examplesByOperation.set(entry.operation, mapped);
+            }
+          }
+        }
       }
       isBuiltInScalar(typeName) {
         return ["String", "Int", "Float", "Boolean", "ID"].includes(typeName);
@@ -236887,6 +236905,7 @@ var init_GraphQLConverter = __esm({
       }
       convertField(field5, name2, operationType) {
         const args = field5.args.map((arg) => this.convertArgument(arg));
+        const examples = this.examplesByOperation.get(`${operationType.toLowerCase()}:${name2}`) ?? this.examplesByOperation.get(name2);
         return {
           id: this.getNamespacedOperationId(`${operationType.toLowerCase()}_${name2}`),
           operationType,
@@ -236896,7 +236915,7 @@ var init_GraphQLConverter = __esm({
           availability: void 0,
           arguments: args.length > 0 ? args : void 0,
           returnType: this.convertOutputType(field5.type),
-          examples: void 0,
+          examples: examples != null && examples.length > 0 ? examples : void 0,
           snippets: void 0
         };
       }
@@ -265205,9 +265224,9 @@ var require_utf16 = __commonJS({
     Utf16BEEncoder.prototype.write = function(str3) {
       var buf = Buffer5.from(str3, "ucs2");
       for (var i9 = 0; i9 < buf.length; i9 += 2) {
-        var tmp18 = buf[i9];
+        var tmp19 = buf[i9];
         buf[i9] = buf[i9 + 1];
-        buf[i9 + 1] = tmp18;
+        buf[i9 + 1] = tmp19;
       }
       return buf;
     };
@@ -319876,9 +319895,9 @@ var init_mod = __esm({
     };
     distance = (a3, b8) => {
       if (a3.length < b8.length) {
-        const tmp18 = b8;
+        const tmp19 = b8;
         b8 = a3;
-        a3 = tmp18;
+        a3 = tmp19;
       }
       if (b8.length === 0) {
         return a3.length;
@@ -319933,7 +319952,7 @@ var require_levenshtein = __commonJS({
             var str1Len = str1.length, str2Len = str22.length;
             if (str1Len === 0) return str2Len;
             if (str2Len === 0) return str1Len;
-            var curCol, nextCol, i9, j7, tmp18;
+            var curCol, nextCol, i9, j7, tmp19;
             for (i9 = 0; i9 < str2Len; ++i9) {
               prevRow[i9] = i9;
               str2Char[i9] = str22.charCodeAt(i9);
@@ -319946,13 +319965,13 @@ var require_levenshtein = __commonJS({
                 curCol = nextCol;
                 strCmp = 0 === collator.compare(str1.charAt(i9), String.fromCharCode(str2Char[j7]));
                 nextCol = prevRow[j7] + (strCmp ? 0 : 1);
-                tmp18 = curCol + 1;
-                if (nextCol > tmp18) {
-                  nextCol = tmp18;
+                tmp19 = curCol + 1;
+                if (nextCol > tmp19) {
+                  nextCol = tmp19;
                 }
-                tmp18 = prevRow[j7 + 1] + 1;
-                if (nextCol > tmp18) {
-                  nextCol = tmp18;
+                tmp19 = prevRow[j7 + 1] + 1;
+                if (nextCol > tmp19) {
+                  nextCol = tmp19;
                 }
                 prevRow[j7] = curCol;
               }
@@ -322785,9 +322804,9 @@ var require_utf162 = __commonJS({
     Utf16BEEncoder.prototype.write = function(str3) {
       var buf = Buffer5.from(str3, "ucs2");
       for (var i9 = 0; i9 < buf.length; i9 += 2) {
-        var tmp18 = buf[i9];
+        var tmp19 = buf[i9];
         buf[i9] = buf[i9 + 1];
-        buf[i9 + 1] = tmp18;
+        buf[i9 + 1] = tmp19;
       }
       return buf;
     };
@@ -345201,9 +345220,9 @@ var require_buffer_crc32 = __commonJS({
       }
     }
     function bufferizeInt(num) {
-      var tmp18 = ensureBuffer(4);
-      tmp18.writeInt32BE(num, 0);
-      return tmp18;
+      var tmp19 = ensureBuffer(4);
+      tmp19.writeInt32BE(num, 0);
+      return tmp19;
     }
     function _crc32(buf, previous4) {
       buf = ensureBuffer(buf);
@@ -363113,17 +363132,17 @@ Patches absorbed by generator (${buckets.absorbed.length}):`;
     }
     async function unifiedDiff(beforeContent, afterContent, filePath) {
       if (beforeContent === afterContent) return "";
-      const tmp18 = await (0, import_promises410.mkdtemp)((0, import_node_path62.join)((0, import_node_os22.tmpdir)(), "fern-replay-pp-"));
+      const tmp19 = await (0, import_promises410.mkdtemp)((0, import_node_path62.join)((0, import_node_os22.tmpdir)(), "fern-replay-pp-"));
       try {
-        const beforePath = (0, import_node_path62.join)(tmp18, "before");
-        const afterPath = (0, import_node_path62.join)(tmp18, "after");
+        const beforePath = (0, import_node_path62.join)(tmp19, "before");
+        const afterPath = (0, import_node_path62.join)(tmp19, "after");
         await (0, import_promises410.writeFile)(beforePath, beforeContent, "utf-8");
         await (0, import_promises410.writeFile)(afterPath, afterContent, "utf-8");
         const raw = await runGitDiffNoIndex(beforePath, afterPath);
         if (!raw.trim()) return "";
         return rewriteDiffHeaders(raw, filePath);
       } finally {
-        await (0, import_promises410.rm)(tmp18, { recursive: true, force: true });
+        await (0, import_promises410.rm)(tmp19, { recursive: true, force: true });
       }
     }
     function runGitDiffNoIndex(beforePath, afterPath) {
@@ -365985,23 +366004,23 @@ function getValues2(context3, operator2, key2, modifier) {
           });
         }
       } else {
-        const tmp18 = [];
+        const tmp19 = [];
         if (Array.isArray(value2)) {
           value2.filter(isDefined2).forEach(function(value22) {
-            tmp18.push(encodeValue4(operator2, value22));
+            tmp19.push(encodeValue4(operator2, value22));
           });
         } else {
           Object.keys(value2).forEach(function(k5) {
             if (isDefined2(value2[k5])) {
-              tmp18.push(encodeUnreserved2(k5));
-              tmp18.push(encodeValue4(operator2, value2[k5].toString()));
+              tmp19.push(encodeUnreserved2(k5));
+              tmp19.push(encodeValue4(operator2, value2[k5].toString()));
             }
           });
         }
         if (isKeyOperator2(operator2)) {
-          result.push(encodeUnreserved2(key2) + "=" + tmp18.join(","));
-        } else if (tmp18.length !== 0) {
-          result.push(tmp18.join(","));
+          result.push(encodeUnreserved2(key2) + "=" + tmp19.join(","));
+        } else if (tmp19.length !== 0) {
+          result.push(tmp19.join(","));
         }
       }
     }
@@ -366036,8 +366055,8 @@ function expand3(template, context3) {
           expression = expression.substr(1);
         }
         expression.split(/,/g).forEach(function(variable3) {
-          var tmp18 = /([^:\*]*)(?::(\d+)|(\*))?/.exec(variable3);
-          values2.push(getValues2(context3, operator2, tmp18[1], tmp18[2] || tmp18[3]));
+          var tmp19 = /([^:\*]*)(?::(\d+)|(\*))?/.exec(variable3);
+          values2.push(getValues2(context3, operator2, tmp19[1], tmp19[2] || tmp19[3]));
         });
         if (operator2 && operator2 !== "+") {
           var separator = ",";
@@ -440581,9 +440600,9 @@ var require_receivebuffer = __commonJS({
           throw new Error("Attempted to append a non-buffer instance to ReceiveBuffer.");
         }
         if (this.offset + data2.length >= this.buffer.length) {
-          const tmp18 = this.buffer;
+          const tmp19 = this.buffer;
           this.buffer = Buffer.allocUnsafe(Math.max(this.buffer.length + this.originalSize, this.buffer.length + data2.length));
-          tmp18.copy(this.buffer);
+          tmp19.copy(this.buffer);
         }
         data2.copy(this.buffer, this.offset);
         return this.offset += data2.length;
@@ -454482,10 +454501,10 @@ var require_esprima = __commonJS({
               };
               Scanner2.prototype.testRegExp = function(pattern, flags2) {
                 var astralSubstitute = "\uFFFF";
-                var tmp18 = pattern;
+                var tmp19 = pattern;
                 var self2 = this;
                 if (flags2.indexOf("u") >= 0) {
-                  tmp18 = tmp18.replace(/\\u\{([0-9a-fA-F]+)\}|\\u([a-fA-F0-9]{4})/g, function($0, $1, $23) {
+                  tmp19 = tmp19.replace(/\\u\{([0-9a-fA-F]+)\}|\\u([a-fA-F0-9]{4})/g, function($0, $1, $23) {
                     var codePoint = parseInt($1 || $23, 16);
                     if (codePoint > 1114111) {
                       self2.throwUnexpectedToken(messages_1.Messages.InvalidRegExp);
@@ -454497,7 +454516,7 @@ var require_esprima = __commonJS({
                   }).replace(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g, astralSubstitute);
                 }
                 try {
-                  RegExp(tmp18);
+                  RegExp(tmp19);
                 } catch (e8) {
                   this.throwUnexpectedToken(messages_1.Messages.InvalidRegExp);
                 }
@@ -471795,15 +471814,15 @@ var require_sync2 = __commonJS({
     var { readdirSync: readdirSync4, statSync: statSync4 } = require("fs");
     module4.exports = function(start2, callback) {
       let dir = resolve15(".", start2);
-      let tmp18, stats = statSync4(dir);
+      let tmp19, stats = statSync4(dir);
       if (!stats.isDirectory()) {
         dir = dirname22(dir);
       }
       while (true) {
-        tmp18 = callback(dir, readdirSync4(dir));
-        if (tmp18) return resolve15(dir, tmp18);
-        dir = dirname22(tmp18 = dir);
-        if (tmp18 === dir) break;
+        tmp19 = callback(dir, readdirSync4(dir));
+        if (tmp19) return resolve15(dir, tmp19);
+        dir = dirname22(tmp19 = dir);
+        if (tmp19 === dir) break;
       }
     };
   }
@@ -561844,6 +561863,7 @@ var GraphQlSpecSchema = schemas_exports8.object({
   graphql: schemas_exports8.string(),
   origin: schemas_exports8.string().optional(),
   overrides: schemas_exports8.string().optional(),
+  examples: schemas_exports8.string().optional(),
   name: schemas_exports8.string().optional()
 });
 
@@ -596233,7 +596253,8 @@ async function parseApiConfigurationV2Schema({ apiConfiguration, rawConfiguratio
       definitionLocation = {
         schema: {
           type: "graphql",
-          path: spec.graphql
+          path: spec.graphql,
+          examples: spec.examples
         },
         origin: spec.origin,
         overrides: spec.overrides,
@@ -659909,9 +659930,12 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
     const graphqlSpecs = this.allSpecs.filter((spec) => spec.type === "graphql");
     for (const spec of graphqlSpecs) {
       try {
+        const examples = await loadGraphQlExamples(spec.absoluteFilepathToExamples, context3);
         const converter = new GraphQLConverter2({
           context: context3,
-          filePath: spec.absoluteFilepath
+          filePath: spec.absoluteFilepath,
+          namespace: spec.namespace,
+          examples
         });
         const result = await converter.convert();
         Object.assign(this.graphqlOperations, result.graphqlOperations);
@@ -660245,7 +660269,8 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
       ...this.allSpecs.flatMap((spec) => {
         const mainPath = spec.type === "protobuf" ? spec.absoluteFilepathToProtobufTarget : spec.absoluteFilepath;
         const overridePaths = Array.isArray(spec.absoluteFilepathToOverrides) ? spec.absoluteFilepathToOverrides : spec.absoluteFilepathToOverrides != null ? [spec.absoluteFilepathToOverrides] : [];
-        return [mainPath, ...overridePaths];
+        const examplesPath = spec.type === "graphql" ? spec.absoluteFilepathToExamples : void 0;
+        return [mainPath, ...overridePaths, ...examplesPath != null ? [examplesPath] : []];
       }).filter(isNonNullish)
     ];
   }
@@ -660270,6 +660295,52 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
     }, result);
   }
 };
+async function loadGraphQlExamples(absoluteFilepathToExamples, context3) {
+  if (absoluteFilepathToExamples == null) {
+    return void 0;
+  }
+  try {
+    const contents = (await (0, import_promises39.readFile)(absoluteFilepathToExamples)).toString();
+    const parsed = jsYaml.load(contents);
+    if (!Array.isArray(parsed)) {
+      return void 0;
+    }
+    for (const entry of parsed) {
+      if (typeof entry !== "object" || entry == null) {
+        context3.logger.warn(`Skipping invalid entry in GraphQL examples file ${absoluteFilepathToExamples}: expected object`);
+        continue;
+      }
+      if (typeof entry.operation !== "string") {
+        context3.logger.warn(`Skipping entry in GraphQL examples file ${absoluteFilepathToExamples}: missing or invalid 'operation' field`);
+        continue;
+      }
+      if (!Array.isArray(entry.examples)) {
+        context3.logger.warn(`Skipping entry for operation '${entry.operation}' in ${absoluteFilepathToExamples}: 'examples' must be an array`);
+        continue;
+      }
+    }
+    const validEntries = parsed.filter((entry) => typeof entry === "object" && entry != null && typeof entry.operation === "string" && Array.isArray(entry.examples)).map((entry) => {
+      const validExamples = entry.examples.filter((ex) => {
+        if (typeof ex !== "object" || ex == null || typeof ex.query !== "string") {
+          context3.logger.warn(`Skipping malformed example for operation '${entry.operation}' in ${absoluteFilepathToExamples}: missing or invalid 'query' field`);
+          return false;
+        }
+        return true;
+      });
+      if (entry.operationType != null) {
+        const lower = entry.operationType.toLowerCase();
+        if (lower !== "query" && lower !== "mutation" && lower !== "subscription") {
+          context3.logger.warn(`Invalid operationType '${entry.operationType}' for operation '${entry.operation}' in ${absoluteFilepathToExamples}: must be 'query', 'mutation', or 'subscription'`);
+        }
+      }
+      return { ...entry, examples: validExamples };
+    }).filter((entry) => entry.examples.length > 0);
+    return validEntries.length > 0 ? validEntries : void 0;
+  } catch (error50) {
+    context3.logger.error(`Failed to load GraphQL examples from ${absoluteFilepathToExamples}:`, extractErrorMessage(error50));
+    return void 0;
+  }
+}
 async function getAuthFromOverrideFiles(specs) {
   for (const spec of specs) {
     if (spec.type !== "openapi") {
@@ -661303,6 +661374,8 @@ var GraphQlSpecSchema2 = external_exports.object({
   origin: external_exports.string().optional(),
   /** Path to overrides file for the GraphQL spec. */
   overrides: external_exports.union([external_exports.string(), external_exports.array(external_exports.string()).nonempty()]).optional(),
+  /** Path to a YAML/JSON file containing named examples for GraphQL operations. */
+  examples: external_exports.string().optional(),
   /** Name used to group this GraphQL spec in the docs (rendered as a top-level section). */
   name: external_exports.string().optional()
 });
@@ -668495,7 +668568,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.33.7",
+          version: "5.35.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -668559,7 +668632,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.33.7",
+        version: "5.35.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -673153,6 +673226,13 @@ var ApiDefinitionConverter = class {
         sourced: sourced.overrides
       });
     }
+    if (spec.examples != null && !isNullish2(sourced.examples)) {
+      result.examples = await this.resolvePath({
+        absoluteFernYmlPath,
+        path: spec.examples,
+        sourced: sourced.examples
+      });
+    }
     if (spec.name != null) {
       result.name = spec.name;
     }
@@ -674588,6 +674668,7 @@ var LegacyApiSpecAdapter = class {
       type: "graphql",
       absoluteFilepath: spec.graphql,
       absoluteFilepathToOverrides: spec.overrides,
+      absoluteFilepathToExamples: spec.examples,
       namespace: spec.name
     };
   }
@@ -812991,7 +813072,7 @@ var V67_TO_V66_MIGRATION = {
     [GeneratorName.PHP_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.RUST_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.RUST_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
-    [GeneratorName.CLI]: GeneratorWasNotCreatedYet
+    [GeneratorName.CLI]: "0.0.1"
   },
   jsonifyEarlierVersion: (ir11) => IrSerialization_exports.V66.IntermediateRepresentation.jsonOrThrow(ir11, {
     unrecognizedObjectKeys: "passthrough",
@@ -825187,10 +825268,12 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     const graphqlSpecs = workspace.allSpecs.filter((spec) => spec.type === "graphql");
     for (const spec of graphqlSpecs) {
       try {
+        const examples = await this.loadGraphQlExamples(spec.absoluteFilepathToExamples);
         const converter = new GraphQLConverter({
           context: this.taskContext,
           filePath: spec.absoluteFilepath,
-          namespace: spec.namespace
+          namespace: spec.namespace,
+          examples
         });
         const graphqlResult = await converter.convert();
         Object.assign(graphqlOperations, graphqlResult.graphqlOperations);
@@ -825206,6 +825289,52 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     }
     return { operations: graphqlOperations, types: graphqlTypes, namespacesByOperationId };
   }
+  async loadGraphQlExamples(absoluteFilepathToExamples) {
+    if (absoluteFilepathToExamples == null) {
+      return void 0;
+    }
+    try {
+      const contents = (await (0, import_promises65.readFile)(absoluteFilepathToExamples)).toString();
+      const parsed = jsYaml.load(contents);
+      if (!Array.isArray(parsed)) {
+        return void 0;
+      }
+      for (const entry of parsed) {
+        if (typeof entry !== "object" || entry == null) {
+          this.taskContext.logger.warn(`Skipping invalid entry in GraphQL examples file ${absoluteFilepathToExamples}: expected object`);
+          continue;
+        }
+        if (typeof entry.operation !== "string") {
+          this.taskContext.logger.warn(`Skipping entry in GraphQL examples file ${absoluteFilepathToExamples}: missing or invalid 'operation' field`);
+          continue;
+        }
+        if (!Array.isArray(entry.examples)) {
+          this.taskContext.logger.warn(`Skipping entry for operation '${entry.operation}' in ${absoluteFilepathToExamples}: 'examples' must be an array`);
+          continue;
+        }
+      }
+      const validEntries = parsed.filter((entry) => typeof entry === "object" && entry != null && typeof entry.operation === "string" && Array.isArray(entry.examples)).map((entry) => {
+        const validExamples = entry.examples.filter((ex) => {
+          if (typeof ex !== "object" || ex == null || typeof ex.query !== "string") {
+            this.taskContext.logger.warn(`Skipping malformed example for operation '${entry.operation}' in ${absoluteFilepathToExamples}: missing or invalid 'query' field`);
+            return false;
+          }
+          return true;
+        });
+        if (entry.operationType != null) {
+          const lower = entry.operationType.toLowerCase();
+          if (lower !== "query" && lower !== "mutation" && lower !== "subscription") {
+            this.taskContext.logger.warn(`Invalid operationType '${entry.operationType}' for operation '${entry.operation}' in ${absoluteFilepathToExamples}: must be 'query', 'mutation', or 'subscription'`);
+          }
+        }
+        return { ...entry, examples: validExamples };
+      }).filter((entry) => entry.examples.length > 0);
+      return validEntries.length > 0 ? validEntries : void 0;
+    } catch (error50) {
+      this.taskContext.logger.error(`Failed to load GraphQL examples from ${absoluteFilepathToExamples}:`, String(error50));
+      return void 0;
+    }
+  }
   /**
    * Handles librarySection navigation items by reading pre-generated MDX files
    * and _navigation.yml from the library's output directory.
@@ -860356,7 +860485,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.33.7";
+  const version7 = "5.35.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -869684,10 +869813,22 @@ async function loadSingleNamespaceAPIWorkspace({ absolutePathToWorkspace, namesp
           }
         };
       }
+      const absoluteFilepathToExamples = definition3.schema.examples != null ? join8(absolutePathToWorkspace, RelativeFilePath2.of(definition3.schema.examples)) : void 0;
+      if (definition3.schema.examples != null && absoluteFilepathToExamples != null && !await doesPathExist(absoluteFilepathToExamples)) {
+        return {
+          didSucceed: false,
+          failures: {
+            [RelativeFilePath2.of(definition3.schema.examples)]: {
+              type: WorkspaceLoaderFailureType.FILE_MISSING
+            }
+          }
+        };
+      }
       specs.push({
         type: "graphql",
         absoluteFilepath: absoluteFilepathToGraphQL,
         absoluteFilepathToOverrides,
+        absoluteFilepathToExamples,
         namespace
       });
       continue;
@@ -876520,7 +876661,7 @@ async function retryWithRateLimit({ fn: fn10, retryRateLimited, logger: logger4,
 
 // ../generation/remote-generation/remote-workspace-runner/lib/createAndStartJob.js
 var gzipAsync = (0, import_util19.promisify)(import_zlib5.gzip);
-async function createAndStartJob({ projectConfig, workspace, organization, intermediateRepresentation, generatorInvocation, version: version7, context: context3, shouldLogS3Url, token, whitelabel, replay, irVersionOverride, absolutePathToPreview, fiddlePreview, pushPreviewBranch, fernignorePath, skipFernignore, retryRateLimited, automationMode, autoMerge, skipIfNoDiff, verify: verify2, loginCommand = "fern login" }) {
+async function createAndStartJob({ projectConfig, workspace, organization, intermediateRepresentation, generatorInvocation, version: version7, context: context3, shouldLogS3Url, token, whitelabel, replay, irVersionOverride, absolutePathToPreview, fiddlePreview, pushPreviewBranch, fernignorePath, skipFernignore, retryRateLimited, automationMode, autoMerge, skipIfNoDiff, verify: verify2, loginCommand = "fern login", specsTarGzBuffer }) {
   let fernignoreContents;
   if (skipFernignore) {
     fernignoreContents = "";
@@ -876559,7 +876700,14 @@ async function createAndStartJob({ projectConfig, workspace, organization, inter
     logger: context3.logger,
     onRateLimitedWithoutRetry: () => context3.failAndThrow("Received 429 Too Many Requests. Re-run with --retry-rate-limited to automatically retry.", void 0, { code: CliError.Code.NetworkError })
   });
-  await startJob({ intermediateRepresentation, job, context: context3, generatorInvocation, irVersionOverride });
+  await startJob({
+    intermediateRepresentation,
+    job,
+    context: context3,
+    generatorInvocation,
+    irVersionOverride,
+    specsTarGzBuffer
+  });
   return job;
 }
 async function createJob({ projectConfig, workspace, organization, generatorInvocation, version: version7, context: context3, shouldLogS3Url, token, whitelabel, replay, absolutePathToPreview, fiddlePreview, pushPreviewBranch, fernignoreContents, skipIfNoDiff, verify: verify2, loginCommand }) {
@@ -876663,7 +876811,7 @@ Please ensure you have membership at https://dashboard.buildwithfern.com, and as
   }
   return createResponse.body;
 }
-async function startJob({ intermediateRepresentation, generatorInvocation, job, context: context3, irVersionOverride }) {
+async function startJob({ intermediateRepresentation, generatorInvocation, job, context: context3, irVersionOverride, specsTarGzBuffer }) {
   const irVersionFromFdr = await getIrVersionForGenerator(generatorInvocation).then((version7) => version7 == null ? void 0 : "v" + version7.toString());
   const resolvedIrVersionOverride = irVersionOverride ?? irVersionFromFdr;
   const migratedIntermediateRepresentation = resolvedIrVersionOverride == null ? await migrateIntermediateRepresentationForGenerator({
@@ -876691,7 +876839,11 @@ async function startJob({ intermediateRepresentation, generatorInvocation, job,
   const irBytes = new TextEncoder().encode(irAsString);
   const compressed = await gzipAsync(irBytes);
   context3.logger.debug(`Compressed IR from ${irBytes.byteLength} bytes to ${compressed.length} bytes (${((1 - compressed.length / irBytes.byteLength) * 100).toFixed(1)}% reduction)`);
-  formData.append("file", compressed, { filename: "ir.json", contentType: "application/octet-stream" });
+  formData.append("ir", compressed, { filename: "ir.json", contentType: "application/octet-stream" });
+  if (specsTarGzBuffer != null) {
+    formData.append("specs", specsTarGzBuffer, { filename: "specs.tar.gz", contentType: "application/gzip" });
+    context3.logger.debug(`Appended specs tar.gz (${specsTarGzBuffer.length} bytes)`);
+  }
   const url3 = (0, import_url_join23.default)(getFiddleOrigin(), `/api/remote-gen/jobs/${job.jobId}/start`);
   try {
     await axios_default.post(url3, formData, {
@@ -877382,7 +877534,7 @@ var SourceUploader = class {
 };
 
 // ../generation/remote-generation/remote-workspace-runner/lib/runRemoteGenerationForGenerator.js
-async function runRemoteGenerationForGenerator({ projectConfig, organization, workspace, interactiveTaskContext, generatorInvocation, version: version7, audiences, shouldLogS3Url, token, whitelabel, replay, irVersionOverride, absolutePathToPreview, isPreview: isPreviewOverride, fiddlePreview, pushPreviewBranch, readme, fernignorePath, skipFernignore, dynamicIrOnly, retryRateLimited, requireEnvVars, automationMode, autoMerge, skipIfNoDiff, verify: verify2, noReplay, disableTelemetry, loginCommand }) {
+async function runRemoteGenerationForGenerator({ projectConfig, organization, workspace, interactiveTaskContext, generatorInvocation, version: version7, audiences, shouldLogS3Url, token, whitelabel, replay, irVersionOverride, absolutePathToPreview, isPreview: isPreviewOverride, fiddlePreview, pushPreviewBranch, readme, fernignorePath, skipFernignore, dynamicIrOnly, retryRateLimited, requireEnvVars, automationMode, autoMerge, skipIfNoDiff, verify: verify2, noReplay, disableTelemetry, loginCommand, specsTarGzBuffer }) {
   const fdr = createFdrService({ token: token.value });
   const fdrOrigin = "https://registry-dev2.buildwithfern.com";
   const isAirGapped = await detectAirGappedMode(`${fdrOrigin}/health`, interactiveTaskContext.logger);
@@ -877574,7 +877726,8 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     autoMerge,
     skipIfNoDiff,
     verify: verify2,
-    loginCommand
+    loginCommand,
+    specsTarGzBuffer
   });
   interactiveTaskContext.logger.debug(`Job ID: ${job.jobId}`);
   const taskId = job.taskIds[0];
@@ -877742,7 +877895,7 @@ function resolveVersionFallback(resolvedVersion) {
 }
 
 // ../generation/remote-generation/remote-workspace-runner/lib/runRemoteGenerationForAPIWorkspace.js
-async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization, workspace, context: context3, generatorGroup, version: version7, shouldLogS3Url, token, whitelabel, replay, absolutePathToPreview, isPreview, fiddlePreview, pushPreviewBranch, mode, fernignorePath, skipFernignore, dynamicIrOnly, validateWorkspace, retryRateLimited, requireEnvVars, automationMode, autoMerge, skipIfNoDiff, verify: verify2, noReplay, disableTelemetry, automation, occurrenceTracker, loginCommand }) {
+async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization, workspace, context: context3, generatorGroup, version: version7, shouldLogS3Url, token, whitelabel, replay, absolutePathToPreview, isPreview, fiddlePreview, pushPreviewBranch, mode, fernignorePath, skipFernignore, dynamicIrOnly, validateWorkspace, retryRateLimited, requireEnvVars, automationMode, autoMerge, skipIfNoDiff, verify: verify2, noReplay, disableTelemetry, automation, occurrenceTracker, loginCommand, getSpecsTarGzBuffer }) {
   if (generatorGroup.generators.length === 0) {
     context3.logger.warn("No generators specified.");
     return null;
@@ -877788,6 +877941,7 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
     generatorsYmlAbsolutePath,
     occurrenceTracker: effectiveOccurrenceTracker,
     loginCommand,
+    getSpecsTarGzBuffer,
     onSnippetsProduced: (invocation) => snippetsProducedBy.push(invocation)
   }))));
   if (automation == null && results.some((didSucceed) => !didSucceed)) {
@@ -877797,7 +877951,7 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
     snippetsProducedBy
   };
 }
-async function generateOne({ generatorInvocation, interactiveTaskContext, projectConfig, organization, workspace, context: context3, generatorGroup, version: version7, shouldLogS3Url, token, whitelabel, replay, absolutePathToPreview, isPreview, fiddlePreview, pushPreviewBranch, mode, fernignorePath, skipFernignore, dynamicIrOnly, validateWorkspace, retryRateLimited, requireEnvVars, automationMode, autoMerge, skipIfNoDiff, verify: verify2, noReplay, disableTelemetry, automation, generatorsYmlAbsolutePath, occurrenceTracker, loginCommand, onSnippetsProduced }) {
+async function generateOne({ generatorInvocation, interactiveTaskContext, projectConfig, organization, workspace, context: context3, generatorGroup, version: version7, shouldLogS3Url, token, whitelabel, replay, absolutePathToPreview, isPreview, fiddlePreview, pushPreviewBranch, mode, fernignorePath, skipFernignore, dynamicIrOnly, validateWorkspace, retryRateLimited, requireEnvVars, automationMode, autoMerge, skipIfNoDiff, verify: verify2, noReplay, disableTelemetry, automation, generatorsYmlAbsolutePath, occurrenceTracker, loginCommand, getSpecsTarGzBuffer, onSnippetsProduced }) {
   const startedAt = Date.now();
   try {
     const settings = getBaseOpenAPIWorkspaceSettingsFromGeneratorInvocation(generatorInvocation);
@@ -877863,7 +878017,8 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
       verify: verify2,
       noReplay,
       disableTelemetry,
-      loginCommand
+      loginCommand,
+      specsTarGzBuffer: await getSpecsTarGzBuffer?.(generatorInvocation.name)
     });
     if (remoteTaskHandlerResponse?.createdSnippets) {
       onSnippetsProduced(generatorInvocation);
@@ -879202,7 +879357,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.33.7",
+        cliVersion: "5.35.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -904619,7 +904774,7 @@ var EndpointSnippetGenerator3 = class {
     this.context.errors.scope(Scope4.PathParameters);
     const pathParameters = [...this.context.ir.pathParameters ?? [], ...request7.pathParameters ?? []];
     if (pathParameters.length > 0) {
-      otherArgs.push(...this.getPathParameters({ namedParameters: pathParameters, snippet: snippet2 }).map((field5) => field5.value));
+      otherArgs.push(...this.getPathParameters({ namedParameters: pathParameters, snippet: snippet2, asPointer: true }).map((field5) => field5.value));
     }
     this.context.errors.unscope();
     this.context.errors.scope(Scope4.RequestBody);
@@ -904657,20 +904812,25 @@ var EndpointSnippetGenerator3 = class {
       inlinePathParameters: this.context.customConfig?.inlinePathParameters ?? true,
       inlineFileProperties: this.context.customConfig?.inlineFileProperties ?? true
     };
+    const includePathParamsInRequest = this.context.includePathParametersInWrappedRequest({
+      request: request7,
+      inlinePathParameters
+    });
     this.context.errors.scope(Scope4.PathParameters);
     const pathParameterFields = [];
     const pathParameters = [...this.context.ir.pathParameters ?? [], ...request7.pathParameters ?? []];
     if (pathParameters.length > 0) {
       pathParameterFields.push(...this.getPathParameters({
         namedParameters: pathParameters,
-        snippet: snippet2
+        snippet: snippet2,
+        asPointer: !includePathParamsInRequest
       }));
     }
     this.context.errors.unscope();
     this.context.errors.scope(Scope4.RequestBody);
     const filePropertyInfo = this.getFilePropertyInfo({ request: request7, snippet: snippet2 });
     this.context.errors.unscope();
-    if (!this.context.includePathParametersInWrappedRequest({ request: request7, inlinePathParameters })) {
+    if (!includePathParamsInRequest) {
       otherArgs.push(...pathParameterFields.map((field5) => field5.value));
     }
     if (!inlineFileProperties) {
@@ -904683,10 +904843,7 @@ var EndpointSnippetGenerator3 = class {
     }) ? this.getInlinedRequestArg({
       request: request7,
       snippet: snippet2,
-      pathParameterFields: this.context.includePathParametersInWrappedRequest({
-        request: request7,
-        inlinePathParameters
-      }) ? pathParameterFields : [],
+      pathParameterFields: includePathParamsInRequest ? pathParameterFields : [],
       filePropertyInfo
     }) : void 0;
     return { otherArgs, requestArg };
@@ -904788,7 +904945,7 @@ var EndpointSnippetGenerator3 = class {
     }
     return fields;
   }
-  getPathParameters({ namedParameters, snippet: snippet2 }) {
+  getPathParameters({ namedParameters, snippet: snippet2, asPointer }) {
     const args = [];
     const pathParameters = this.context.associateByWireValueOrDefault({
       parameters: namedParameters,
@@ -904797,7 +904954,7 @@ var EndpointSnippetGenerator3 = class {
     for (const parameter6 of pathParameters) {
       args.push({
         name: this.context.getTypeName(parameter6.name.name),
-        value: this.context.dynamicTypeInstantiationMapper.convertToPointerIfPossible(parameter6)
+        value: asPointer ? this.context.dynamicTypeInstantiationMapper.convertToPointerIfPossible(parameter6) : this.context.dynamicTypeInstantiationMapper.convert(parameter6)
       });
     }
     return args;
@@ -930496,7 +930653,7 @@ var import_serialization = __toESM(require_serialization3(), 1);
 var import_promises118 = require("fs/promises");
 var path87 = __toESM(require("path"), 1);
 var import_path93 = require("path");
-var import_tmp_promise14 = __toESM(require_tmp_promise(), 1);
+var import_tmp_promise15 = __toESM(require_tmp_promise(), 1);
 
 // ../generation/local-generation/local-workspace-runner/lib/getGeneratorConfig.js
 init_lib9();
@@ -931674,21 +931831,35 @@ var LocalTaskHandler = class {
 
 // ../generation/local-generation/local-workspace-runner/lib/rawSpecs.js
 init_lib4();
+init_lib8();
 var import_promises117 = require("fs/promises");
 init_js_yaml();
 var import_path92 = __toESM(require("path"), 1);
+var import_tmp_promise14 = __toESM(require_tmp_promise(), 1);
 async function collectRawSpecs({ specs, hostOutputDir, containerBaseDir, context: context3, audiences }) {
   const manifest = { specs: [] };
   if (specs.length === 0) {
     return manifest;
   }
-  for (const [i9, spec] of specs.entries()) {
+  const typeCounters = {};
+  function nextIndex2(type8) {
+    const idx = typeCounters[type8] ?? 0;
+    typeCounters[type8] = idx + 1;
+    return idx;
+  }
+  for (const spec of specs) {
+    let specType;
+    if (spec.type === "openapi") {
+      specType = await isAsyncAPISpec(spec.absoluteFilepath) ? "asyncapi" : "openapi";
+    } else {
+      specType = spec.type;
+    }
     const entry = await resolveAndWriteSpec({
       spec,
       hostOutputDir,
       containerBaseDir,
       context: context3,
-      index: i9,
+      index: nextIndex2(specType),
       audiences
     });
     manifest.specs.push(entry);
@@ -931712,7 +931883,7 @@ async function resolveAndWriteSpec({ spec, hostOutputDir, containerBaseDir, cont
 }
 async function resolveOpenAPIOrAsyncAPI({ spec, hostOutputDir, containerBaseDir, context: context3, index: index3, audiences }) {
   const isAsync2 = await isAsyncAPISpec(spec.absoluteFilepath);
-  const filename = `spec-${index3}.json`;
+  const filename = isAsync2 ? `asyncapi${index3}.json` : `openapi${index3}.json`;
   let resolved;
   if (isAsync2) {
     resolved = await loadAsyncAPI({
@@ -931737,7 +931908,7 @@ async function resolveOpenAPIOrAsyncAPI({ spec, hostOutputDir, containerBaseDir,
   };
 }
 async function resolveOpenRPC({ spec, hostOutputDir, containerBaseDir, context: context3, index: index3 }) {
-  const filename = `spec-${index3}.json`;
+  const filename = `openrpc${index3}.json`;
   const rawContent = await (0, import_promises117.readFile)(spec.absoluteFilepath, "utf-8");
   let parsed;
   try {
@@ -931768,7 +931939,7 @@ async function resolveOpenRPC({ spec, hostOutputDir, containerBaseDir, context:
   };
 }
 async function copyProtobuf({ spec, hostOutputDir, containerBaseDir, index: index3 }) {
-  const dirName = `proto-${index3}`;
+  const dirName = `protobuf${index3}`;
   const destDir = import_path92.default.join(hostOutputDir, dirName);
   await (0, import_promises117.cp)(spec.absoluteFilepathToProtobufRoot, destDir, { recursive: true });
   const entry = {
@@ -931779,7 +931950,7 @@ async function copyProtobuf({ spec, hostOutputDir, containerBaseDir, index: inde
   if (overrides.length > 0) {
     entry.overridePaths = [];
     for (const [i9, override] of overrides.entries()) {
-      const overrideName = `proto-${index3}-override-${i9}${import_path92.default.extname(override)}`;
+      const overrideName = `protobuf${index3}-override-${i9}${import_path92.default.extname(override)}`;
       await (0, import_promises117.copyFile)(override, import_path92.default.join(hostOutputDir, overrideName));
       entry.overridePaths.push(toContainerPath(overrideName, containerBaseDir));
     }
@@ -931788,7 +931959,7 @@ async function copyProtobuf({ spec, hostOutputDir, containerBaseDir, index: inde
 }
 async function copyGraphQL({ spec, hostOutputDir, containerBaseDir, index: index3 }) {
   const ext2 = import_path92.default.extname(spec.absoluteFilepath) || ".graphql";
-  const filename = `spec-${index3}${ext2}`;
+  const filename = `graphql${index3}${ext2}`;
   await (0, import_promises117.copyFile)(spec.absoluteFilepath, import_path92.default.join(hostOutputDir, filename));
   const entry = {
     type: "graphql",
@@ -931798,7 +931969,7 @@ async function copyGraphQL({ spec, hostOutputDir, containerBaseDir, index: index
   if (overrides.length > 0) {
     entry.overridePaths = [];
     for (const [i9, override] of overrides.entries()) {
-      const overrideName = `graphql-${index3}-override-${i9}${import_path92.default.extname(override)}`;
+      const overrideName = `graphql${index3}-override-${i9}${import_path92.default.extname(override)}`;
       await (0, import_promises117.copyFile)(override, import_path92.default.join(hostOutputDir, overrideName));
       entry.overridePaths.push(toContainerPath(overrideName, containerBaseDir));
     }
@@ -931907,6 +932078,30 @@ function matchesAudiences(operation, selectedAudiences) {
 function hasOperations(pathItem) {
   return Object.keys(pathItem).some((key2) => HTTP_METHODS2.has(key2.toLowerCase()));
 }
+async function createSpecsTarGzBuffer({ specs, context: context3, audiences }) {
+  const tmpDir = await import_tmp_promise14.default.dir({ unsafeCleanup: true });
+  try {
+    const manifest = await collectRawSpecs({
+      specs,
+      hostOutputDir: AbsoluteFilePath2.of(tmpDir.path),
+      containerBaseDir: "/fern/specs",
+      context: context3,
+      audiences
+    });
+    await (0, import_promises117.writeFile)(join8(AbsoluteFilePath2.of(tmpDir.path), RelativeFilePath2.of(SPECS_MANIFEST_FILENAME)), JSON.stringify(manifest, void 0, 4));
+    const tarGzPath = join8(AbsoluteFilePath2.of(tmpDir.path), RelativeFilePath2.of("specs.tar.gz"));
+    await Zn8({
+      gzip: true,
+      cwd: tmpDir.path,
+      file: tarGzPath,
+      portable: true,
+      filter: (entryPath) => entryPath !== "./specs.tar.gz"
+    }, ["."]);
+    return await (0, import_promises117.readFile)(tarGzPath);
+  } finally {
+    await tmpDir.cleanup();
+  }
+}
 
 // ../generation/local-generation/local-workspace-runner/lib/runGenerator.js
 function extractLicenseFilePath(generatorInvocation, absolutePathToFernConfig) {
@@ -932065,7 +932260,7 @@ async function writeIrToFile({ ir: ir11, workspaceTempDir, filename, context: co
   if (filename) {
     absolutePathToIr = AbsoluteFilePath2.of((0, import_path93.join)(workspaceTempDir.path, filename));
   } else {
-    const irFile = await import_tmp_promise14.default.file({
+    const irFile = await import_tmp_promise15.default.file({
       tmpdir: workspaceTempDir.path
     });
     absolutePathToIr = AbsoluteFilePath2.of(irFile.path);
@@ -932102,7 +932297,7 @@ init_lib6();
 var fs18 = __toESM(require("fs/promises"), 1);
 var import_os13 = __toESM(require("os"), 1);
 var import_path94 = __toESM(require("path"), 1);
-var import_tmp_promise15 = __toESM(require_tmp_promise(), 1);
+var import_tmp_promise16 = __toESM(require_tmp_promise(), 1);
 
 // ../generation/local-generation/local-workspace-runner/lib/getGeneratorOutputSubfolder.js
 function getGeneratorOutputSubfolder(generatorName) {
@@ -932220,7 +932415,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
         intermediateRepresentation.publishConfig = publishConfig;
       }
       const absolutePathToPreviewForGenerator = resolveAbsolutePathToLocalPreview(absolutePathToPreview, generatorInvocation);
-      const absolutePathToLocalOutput = absolutePathToPreviewForGenerator ?? generatorInvocation.absolutePathToLocalOutput ?? AbsoluteFilePath2.of(await import_tmp_promise15.default.dir().then((dir) => dir.path));
+      const absolutePathToLocalOutput = absolutePathToPreviewForGenerator ?? generatorInvocation.absolutePathToLocalOutput ?? AbsoluteFilePath2.of(await import_tmp_promise16.default.dir().then((dir) => dir.path));
       const selfhostedGithubConfig = getSelfhostedGithubConfig(generatorInvocation, absolutePathToPreviewForGenerator != null);
       if (version7 != null && (0, import_autoversion4.isAutoVersion)(version7)) {
         if (selfhostedGithubConfig == null) {
@@ -932432,7 +932627,7 @@ function resolveAbsolutePathToLocalPreview(absolutePathToPreview, generatorInvoc
   return join8(absolutePathToPreview, RelativeFilePath2.of(subfolderName));
 }
 async function getWorkspaceTempDir() {
-  return import_tmp_promise15.default.dir({
+  return import_tmp_promise16.default.dir({
     // use the /private prefix on osx so that docker can access the tmpdir
     // see https://stackoverflow.com/a/45123074
     tmpdir: import_os13.default.platform() === "darwin" ? import_path94.default.join("/private", import_os13.default.tmpdir()) : void 0,
@@ -950011,7 +950206,7 @@ var initializeWithReadme = async ({ readmeUrl, organization, taskContext, versio
 var import_promises140 = require("fs/promises");
 init_js_yaml();
 var import_path100 = require("path");
-var import_tmp_promise16 = __toESM(require_tmp_promise(), 1);
+var import_tmp_promise17 = __toESM(require_tmp_promise(), 1);
 var LoadOpenAPIStatus;
 (function(LoadOpenAPIStatus2) {
   LoadOpenAPIStatus2["Success"] = "success";
@@ -950020,7 +950215,7 @@ var LoadOpenAPIStatus;
 async function loadOpenAPIFromUrl({ url: url3, logger: logger4 }) {
   try {
     const data2 = await fetchOpenAPIFromUrl({ url: url3, logger: logger4 });
-    const tmpDir = await import_tmp_promise16.default.dir();
+    const tmpDir = await import_tmp_promise17.default.dir();
     const filePath = (0, import_path100.join)(tmpDir.path, url3.endsWith(".json") ? "openapi.json" : "openapi.yaml");
     logger4.debug("tmpDir", tmpDir.path);
     logger4.debug("filePath", filePath);
@@ -953902,7 +954097,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.33.7"
+    cli_version: "5.35.0"
   };
 }
 function isAutomationMode() {
@@ -954728,7 +954923,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.33.7";
+    return "5.35.0";
   }
   getCliName() {
     if (false) {
@@ -956682,6 +956877,22 @@ async function generateWorkspace({
             disableTelemetry: isTelemetryDisabled()
           });
         } else if (token != null) {
+          let cachedSpecsTarGz;
+          let specsComputed = false;
+          const getSpecsTarGz = async (generatorName2) => {
+            if (!(workspace instanceof OSSWorkspace) || !generatorWantsSpecs(generatorName2)) {
+              return void 0;
+            }
+            if (!specsComputed) {
+              specsComputed = true;
+              cachedSpecsTarGz = await createSpecsTarGzBuffer({
+                specs: workspace.allSpecs,
+                context: groupContext,
+                audiences: group.audiences
+              });
+            }
+            return cachedSpecsTarGz;
+          };
           await runRemoteGenerationForAPIWorkspace({
             projectConfig,
             organization,
@@ -956708,7 +956919,8 @@ async function generateWorkspace({
             skipIfNoDiff,
             noReplay,
             verify: verify2,
-            disableTelemetry: isTelemetryDisabled()
+            disableTelemetry: isTelemetryDisabled(),
+            getSpecsTarGzBuffer: getSpecsTarGz
           });
         }
       })
@@ -967443,7 +967655,7 @@ async function mockServer({
 init_lib6();
 var import_promises191 = require("fs/promises");
 var import_path112 = __toESM(require("path"), 1);
-var import_tmp_promise17 = __toESM(require_tmp_promise(), 1);
+var import_tmp_promise18 = __toESM(require_tmp_promise(), 1);
 async function registerWorkspacesV1({
   project,
   cliContext,
@@ -967489,7 +967701,7 @@ async function registerWorkspacesV1({
           });
           return;
         }
-        const tmpDir = await import_tmp_promise17.default.dir();
+        const tmpDir = await import_tmp_promise18.default.dir();
         const tarPath = import_path112.default.join(tmpDir.path, "definition.tgz");
         context3.logger.debug(`Compressing definition at ${tmpDir.path}`);
         await Zn8({ file: tarPath, cwd: resolvedWorkspace.absoluteFilePath }, ["."]);