@fern-api/fern-api-dev 5.23.3-2060-gef10ff1af19 → 5.23.3-2069-g46cdcdac844

package/cli.cjs

@@ -25708,6 +25708,116 @@ var init_addPrefixToString = __esm({
   }
 });
 
+// ../../commons/core-utils/lib/anyOfPresenceConstraint.js
+function isRecord(value2) {
+  return typeof value2 === "object" && value2 != null && !Array.isArray(value2);
+}
+function isObjectTypeOrAbsent(type7) {
+  if (type7 == null) {
+    return true;
+  }
+  if (typeof type7 === "string") {
+    return type7 === "object";
+  }
+  if (Array.isArray(type7)) {
+    const nonNull = type7.filter((entry) => entry !== "null");
+    return nonNull.length === 1 && nonNull[0] === "object";
+  }
+  return false;
+}
+function restatesSiblingSubschema(branchSubschema, siblingSubschema) {
+  if (branchSubschema === true) {
+    return true;
+  }
+  if (!isRecord(branchSubschema)) {
+    return false;
+  }
+  const sibling2 = isRecord(siblingSubschema) ? siblingSubschema : void 0;
+  for (const [keyword, value2] of Object.entries(branchSubschema)) {
+    if (ANNOTATION_KEYWORDS.has(keyword)) {
+      continue;
+    }
+    if (sibling2 == null || !(keyword in sibling2) || !deepEquals(value2, sibling2[keyword])) {
+      return false;
+    }
+  }
+  return true;
+}
+function deepEquals(a3, b5) {
+  if (a3 === b5) {
+    return true;
+  }
+  if (Array.isArray(a3) && Array.isArray(b5)) {
+    return a3.length === b5.length && a3.every((entry, index3) => deepEquals(entry, b5[index3]));
+  }
+  if (isRecord(a3) && isRecord(b5)) {
+    const aKeys = Object.keys(a3).sort();
+    const bKeys = Object.keys(b5).sort();
+    return aKeys.length === bKeys.length && aKeys.every((key2, index3) => key2 === bKeys[index3]) && aKeys.every((key2) => deepEquals(a3[key2], b5[key2]));
+  }
+  return false;
+}
+function isPresenceConstraintBranch(branch, siblingProperties) {
+  if (!isRecord(branch) || "$ref" in branch) {
+    return false;
+  }
+  if (branch.allOf != null || branch.oneOf != null || branch.anyOf != null || branch.additionalProperties != null || !isObjectTypeOrAbsent(branch.type)) {
+    return false;
+  }
+  const branchProperties = isRecord(branch.properties) ? branch.properties : {};
+  const branchRequired = Array.isArray(branch.required) ? branch.required : [];
+  if (Object.keys(branchProperties).length === 0 && branchRequired.length === 0) {
+    return false;
+  }
+  for (const name2 of branchRequired) {
+    if (typeof name2 !== "string" || !(name2 in siblingProperties)) {
+      return false;
+    }
+  }
+  for (const [name2, subschema] of Object.entries(branchProperties)) {
+    if (!(name2 in siblingProperties)) {
+      return false;
+    }
+    if (!restatesSiblingSubschema(subschema, siblingProperties[name2])) {
+      return false;
+    }
+  }
+  return true;
+}
+function anyOfIsPresenceConstraint(schema) {
+  const anyOf = schema.anyOf;
+  if (!Array.isArray(anyOf) || anyOf.length === 0) {
+    return false;
+  }
+  if (schema.oneOf != null || schema.allOf != null) {
+    return false;
+  }
+  if (!isRecord(schema.properties) || Object.keys(schema.properties).length === 0) {
+    return false;
+  }
+  const siblingProperties = schema.properties;
+  return anyOf.every((branch) => isPresenceConstraintBranch(branch, siblingProperties));
+}
+var ANNOTATION_KEYWORDS;
+var init_anyOfPresenceConstraint = __esm({
+  "../../commons/core-utils/lib/anyOfPresenceConstraint.js"() {
+    "use strict";
+    ANNOTATION_KEYWORDS = /* @__PURE__ */ new Set([
+      "title",
+      "description",
+      "default",
+      "deprecated",
+      "example",
+      "examples",
+      "readOnly",
+      "writeOnly",
+      "externalDocs",
+      "xml",
+      "$comment"
+    ]);
+  }
+});
+
 // ../../../node_modules/.pnpm/jsonpath-plus@10.4.0/node_modules/jsonpath-plus/dist/index-node-esm.js
 function push(arr, item) {
   arr = arr.slice();
@@ -44690,6 +44800,7 @@ __export(lib_exports, {
   SKIP_MARKER: () => SKIP_MARKER,
   SymbolRegistry: () => SymbolRegistry,
   addPrefixToString: () => addPrefixToString,
+  anyOfIsPresenceConstraint: () => anyOfIsPresenceConstraint,
   applyOpenAPIOverlay: () => applyOpenAPIOverlay,
   assert: () => assert2,
   assertDefined: () => assertDefined,
@@ -44710,6 +44821,7 @@ __export(lib_exports, {
   isGitAvailable: () => isGitAvailable,
   isNonNullish: () => isNonNullish,
   isPlainObject: () => isPlainObject4,
+  isPresenceConstraintBranch: () => isPresenceConstraintBranch,
   keys: () => keys2,
   mapValues: () => mapValues2,
   mergeWithOverrides: () => mergeWithOverrides,
@@ -44737,6 +44849,7 @@ var init_lib4 = __esm({
   "../../commons/core-utils/lib/index.js"() {
     "use strict";
     init_addPrefixToString();
+    init_anyOfPresenceConstraint();
     init_applyOpenAPIOverlay();
     init_assert();
     init_delay();
@@ -101228,9 +101341,9 @@ var require_graceful_fs = __commonJS({
         }
       }
       var fs$readdir = fs35.readdir;
-      fs35.readdir = readdir23;
+      fs35.readdir = readdir24;
       var noReaddirOptionVersions = /^v[0-5]\./;
-      function readdir23(path122, options2, cb) {
+      function readdir24(path122, options2, cb) {
         if (typeof options2 === "function")
           cb = options2, options2 = null;
         var go$readdir = noReaddirOptionVersions.test(process.version) ? function go$readdir2(path123, options3, cb2, startTime) {
@@ -131124,6 +131237,7 @@ var init_OpenApiSettingsSchema2 = __esm({
       "type-dates-as-strings": schemas_exports8.boolean().optional(),
       "preserve-single-schema-oneof": schemas_exports8.boolean().optional(),
       "preserve-one-of-in-all-of": schemas_exports8.boolean().optional(),
+      "any-of-sibling-properties-as-object": schemas_exports8.boolean().optional(),
       "inline-all-of-schemas": schemas_exports8.boolean().optional(),
       "resolve-aliases": ResolveAliases.optional(),
       "group-multi-api-environments": schemas_exports8.boolean().optional(),
@@ -152982,6 +153096,7 @@ var init_options2 = __esm({
       typeDatesAsStrings: false,
       preserveSingleSchemaOneOf: false,
       preserveOneOfInAllOf: false,
+      anyOfSiblingPropertiesAsObject: false,
       inlineAllOfSchemas: false,
       resolveAliases: false,
       groupMultiApiEnvironments: false,
@@ -156641,6 +156756,12 @@ function convertSchemaObject(schema, wrapAsOptional, wrapAsNullable, context3, b
       }
     }
     if (schema.anyOf != null && schema.anyOf.length > 0) {
+      if (context3.options.anyOfSiblingPropertiesAsObject && anyOfIsPresenceConstraint(schema)) {
+        context3.logger.debug(`Treating the anyOf at ${breadcrumbs.join(".")} as an "at least one of" constraint over its sibling properties rather than a union, and converting the schema as an object.`);
+        const { anyOf: _constraint, ...schemaWithoutAnyOf } = schema;
+        const convertedSchema = convertSchema2(schemaWithoutAnyOf, wrapAsOptional, wrapAsNullable, context3, breadcrumbs, source2, namespace, referencedAsRequest);
+        return maybeInjectDescriptionOrGroupName(convertedSchema, description, namespace, groupName);
+      }
       if (schema.anyOf.length === 1 && schema.anyOf[0] != null) {
         const convertedSchema = convertSchema2(schema.anyOf[0], wrapAsOptional, wrapAsNullable, context3, breadcrumbs, source2, namespace, referencedAsRequest);
         return maybeInjectDescriptionOrGroupName(convertedSchema, description, namespace, groupName);
@@ -157251,6 +157372,7 @@ var SCHEMA_REFERENCE_PREFIX, globalTitleCollisionTracker;
 var init_convertSchemas = __esm({
   "../api-importers/openapi/openapi-ir-parser/lib/schema/convertSchemas.js"() {
     "use strict";
+    init_lib4();
     init_lib13();
     init_lib6();
     init_lodash();
@@ -200202,6 +200324,7 @@ var init_getAPIDefinitionSettings = __esm({
       typeDatesAsStrings: "typeDatesAsStrings",
       preserveSingleSchemaOneOf: "preserveSingleSchemaOneOf",
       preserveOneOfInAllOf: "preserveOneOfInAllOf",
+      anyOfSiblingPropertiesAsObject: "anyOfSiblingPropertiesAsObject",
       inlineAllOfSchemas: "inlineAllOfSchemas",
       resolveAliases: "resolveAliases",
       groupMultiApiEnvironments: "groupMultiApiEnvironments",
@@ -200287,6 +200410,13 @@ var init_openapi = __esm({
   }
 });
 
+// ../../commons/api-workspace-commons/lib/RawSpecs.js
+var init_RawSpecs = __esm({
+  "../../commons/api-workspace-commons/lib/RawSpecs.js"() {
+    "use strict";
+  }
+});
+
 // ../../commons/api-workspace-commons/lib/Source.js
 var init_Source5 = __esm({
   "../../commons/api-workspace-commons/lib/Source.js"() {
@@ -200445,6 +200575,7 @@ var init_lib17 = __esm({
     init_getFilesystemPublishTarget();
     init_getOriginGitCommit();
     init_openapi();
+    init_RawSpecs();
     init_Source5();
     init_Spec();
     init_utils11();
@@ -264823,6 +264954,7 @@ function parseOpenApiDefinitionSettingsSchema(settings) {
     typeDatesAsStrings: settings?.["type-dates-as-strings"],
     preserveSingleSchemaOneOf: settings?.["preserve-single-schema-oneof"],
     preserveOneOfInAllOf: settings?.["preserve-one-of-in-all-of"],
+    anyOfSiblingPropertiesAsObject: settings?.["any-of-sibling-properties-as-object"],
     inlineAllOfSchemas: settings?.["inline-all-of-schemas"],
     resolveAliases: settings?.["resolve-aliases"],
     groupMultiApiEnvironments: settings?.["group-multi-api-environments"],
@@ -265685,6 +265817,7 @@ var init_convertGeneratorsConfiguration = __esm({
       typeDatesAsStrings: void 0,
       preserveSingleSchemaOneOf: void 0,
       preserveOneOfInAllOf: void 0,
+      anyOfSiblingPropertiesAsObject: void 0,
       inlineAllOfSchemas: void 0,
       resolveAliases: void 0,
       groupMultiApiEnvironments: void 0,
@@ -343851,7 +343984,7 @@ var require_oas_kit_common = __commonJS({
     function allSame(array3) {
       return new Set(array3).size <= 1;
     }
-    function deepEquals(obj1, obj2) {
+    function deepEquals2(obj1, obj2) {
       function _equals(obj12, obj22) {
         return sjs.stringify(obj12) === sjs.stringify(Object.assign({}, obj12, obj22));
       }
@@ -343861,7 +343994,7 @@ var require_oas_kit_common = __commonJS({
       let result = [];
       for (let candidate of arr) {
         let dupe = result.find(function(e2, i5, a3) {
-          return deepEquals(e2, candidate);
+          return deepEquals2(e2, candidate);
         });
         if (!dupe) result.push(candidate);
       }
@@ -346319,7 +346452,7 @@ async function parseOverlayFile(absoluteFilePathToOverlay, context3) {
   }
 }
 function validateOverlay(overlay, context3) {
-  if (!isRecord(overlay)) {
+  if (!isRecord2(overlay)) {
     context3.logger.error("Overlay file must be a YAML or JSON object");
     return false;
   }
@@ -346328,7 +346461,7 @@ function validateOverlay(overlay, context3) {
     return false;
   }
   const info = overlay.info;
-  if (!isRecord(info) || typeof info.title !== "string" || info.title.length === 0 || typeof info.version !== "string" || info.version.length === 0) {
+  if (!isRecord2(info) || typeof info.title !== "string" || info.title.length === 0 || typeof info.version !== "string" || info.version.length === 0) {
     context3.logger.error("Overlay file missing required 'info.title' or 'info.version' field");
     return false;
   }
@@ -346339,7 +346472,7 @@ function validateOverlay(overlay, context3) {
   }
   for (let i5 = 0; i5 < actions.length; i5++) {
     const action = actions[i5];
-    if (!isRecord(action) || !action.target) {
+    if (!isRecord2(action) || !action.target) {
       context3.logger.error(`Overlay action at index ${i5} missing required 'target' field`);
       return false;
     }
@@ -346350,7 +346483,7 @@ function validateOverlay(overlay, context3) {
   }
   return true;
 }
-function isRecord(value2) {
+function isRecord2(value2) {
   return typeof value2 === "object" && value2 != null && !Array.isArray(value2);
 }
 var import_promises28, import_path36, import_tmp_promise6, tempDir;
@@ -351696,6 +351829,7 @@ var TYPE_INVARIANT_KEYS, SchemaConverter;
 var init_SchemaConverter = __esm({
   "../api-importers/v3-importer-commons/lib/converters/schema/SchemaConverter.js"() {
     "use strict";
+    init_lib4();
     init_lib9();
     init_lib30();
     init_CreateTypeReferenceFromFernType();
@@ -351769,6 +351903,10 @@ var init_SchemaConverter = __esm({
         if (maybeConvertedTypeArraySchema != null) {
           return maybeConvertedTypeArraySchema;
         }
+        const maybeConvertedSiblingAnyOfConstraint = this.tryConvertSiblingAnyOfConstraint();
+        if (maybeConvertedSiblingAnyOfConstraint != null) {
+          return maybeConvertedSiblingAnyOfConstraint;
+        }
         const maybeConvertedOneOfAnyOfSchema = this.tryConvertOneOfAnyOfSchema();
         if (maybeConvertedOneOfAnyOfSchema != null) {
           return maybeConvertedOneOfAnyOfSchema;
@@ -352109,6 +352247,50 @@ var init_SchemaConverter = __esm({
         }
         return void 0;
       }
+      /**
+       * A schema may declare `properties` alongside an `anyOf` whose branches only
+       * re-declare some of those same properties as required, for example:
+       *
+       *     type: object
+       *     properties: { a: {...}, b: {...} }
+       *     anyOf:
+       *       - { properties: { a: {...} }, required: [a] }
+       *       - { properties: { b: {...} }, required: [b] }
+       *
+       * Per JSON Schema an instance must satisfy both keywords, so the `anyOf` here
+       * is a validation constraint -- "at least one of a, b" -- and not a set of
+       * variants. Converting it as a union discards the sibling `properties`
+       * entirely and makes the variants mutually exclusive, so a body carrying both
+       * `a` and `b` silently loses one on the wire.
+       *
+       * Drop the `anyOf` and convert the schema as the object it declares. The "at
+       * least one" constraint is not expressible in the IR and is not enforced.
+       *
+       * This only applies when every branch is an inline object whose properties are
+       * a subset of the sibling `properties`. A branch that introduces a property,
+       * or is a reference, is a genuine variant and is left to the union converter.
+       *
+       * Gated behind the `any-of-sibling-properties-as-object` setting.
+       */
+      tryConvertSiblingAnyOfConstraint() {
+        if (!this.context.settings.anyOfSiblingPropertiesAsObject) {
+          return void 0;
+        }
+        if (!anyOfIsPresenceConstraint(this.schema)) {
+          return void 0;
+        }
+        this.context.logger.debug(`Treating the anyOf at ${this.breadcrumbs.join(".")} as an "at least one of" constraint over its sibling properties rather than a union, and converting the schema as an object.`);
+        const { anyOf: _constraint, ...schemaWithoutAnyOf } = this.schema;
+        return new _SchemaConverter({
+          id: this.id,
+          context: this.context,
+          breadcrumbs: this.breadcrumbs,
+          schema: schemaWithoutAnyOf,
+          inlined: this.inlined,
+          nameOverride: this.nameOverride,
+          visitedRefs: this.visitedRefs
+        }).convert();
+      }
       tryConvertOneOfAnyOfSchema() {
         if (this.schema.oneOf != null || this.schema.anyOf != null) {
           const oneOfConverter = new OneOfSchemaConverter({
@@ -374091,6 +374273,7 @@ var init_OSSWorkspace = __esm({
     init_lib31();
     init_lib21();
     init_lib12();
+    init_lib20();
     init_lib4();
     init_lib8();
     init_lib9();
@@ -374121,6 +374304,8 @@ var init_OSSWorkspace = __esm({
       // This avoids running buf generate twice when both toFernWorkspace() and
       // validateOSSWorkspace() need the same OpenAPI specs.
       openApiSpecsCache = /* @__PURE__ */ new Map();
+      /** Guards the orphaned-`auth-schemes` warning so one command warns once. */
+      hasWarnedOrphanedAuthSchemes = false;
       constructor({ allSpecs, specs, ...superArgs }) {
         const openapiSpecs = specs.filter((spec) => spec.type === "openapi" && spec.source.type === "openapi");
         super({
@@ -374260,10 +374445,7 @@ var init_OSSWorkspace = __esm({
         const specs = await this.getOpenAPISpecsCached({ context: context3 });
         const documents = await this.loader.loadDocuments({ context: context3, specs });
         let authOverrides = this.generatorsConfiguration?.api?.auth != null ? { ...this.generatorsConfiguration?.api } : void 0;
-        const orphanedAuthSchemeWarning = getOrphanedAuthSchemeWarning(this.generatorsConfiguration?.api);
-        if (orphanedAuthSchemeWarning != null) {
-          context3.logger.warn(orphanedAuthSchemeWarning);
-        }
+        this.warnOnOrphanedAuthSchemes(context3);
         if (authOverrides == null) {
           authOverrides = await getAuthFromOverrideFiles(specs);
         }
@@ -374442,7 +374624,29 @@ var init_OSSWorkspace = __esm({
         }
         return results;
       }
+      /**
+       * Emit the orphaned-`auth-schemes` warning, at most once per workspace.
+       *
+       * Called from BOTH `toFernWorkspace` and `getIntermediateRepresentation`,
+       * because they are different entry points: `fern generate` and plain
+       * `fern check` go through the former, and only `fern check --from-openapi`
+       * reaches the latter (see `validateWorkspaces.ts`, where that branch is
+       * gated on `directFromOpenapi`). Warning from only one of them meant the
+       * customer who hits this bug — silently, on `fern generate` — saw nothing,
+       * which is the entire failure mode.
+       */
+      warnOnOrphanedAuthSchemes(context3) {
+        if (this.hasWarnedOrphanedAuthSchemes) {
+          return;
+        }
+        const warning = getOrphanedAuthSchemeWarning(this.generatorsConfiguration?.api);
+        if (warning != null) {
+          this.hasWarnedOrphanedAuthSchemes = true;
+          context3.logger.warn(warning);
+        }
+      }
       async toFernWorkspace({ context: context3 }, settings, specsOverride) {
+        this.warnOnOrphanedAuthSchemes(context3);
         if (specsOverride != null) {
           return this.createWorkspaceWithSpecsOverride({ context: context3 }, specsOverride, settings);
         }
@@ -374471,6 +374675,13 @@ var init_OSSWorkspace = __esm({
           sources: this.sources
         });
       }
+      async getAllSpecsForGenerator(specsOverride) {
+        if (specsOverride == null) {
+          return this.allSpecs;
+        }
+        const overrideSpecs = await this.convertSpecsOverrideToSpecs(specsOverride);
+        return overrideSpecs.filter((spec) => spec.type !== "protobuf" || !spec.fromOpenAPI);
+      }
       async createWorkspaceWithSpecsOverride({ context: context3 }, specsOverride, settings) {
         const overrideSpecs = await this.convertSpecsOverrideToSpecs(specsOverride);
         const overrideAllSpecs = overrideSpecs.filter((spec) => spec.type !== "protobuf" || !spec.fromOpenAPI);
@@ -374529,8 +374740,9 @@ var init_OSSWorkspace = __esm({
               absoluteFilepath,
               absoluteFilepathToOverrides,
               absoluteFilepathToOverlays,
-              // Use default settings from existing specs for compatibility
-              settings: this.specs.length > 0 ? this.specs[0]?.settings : void 0,
+              settings: getOpenAPISettings({
+                options: mergeSettings(this.generatorsConfiguration?.api?.settings ?? parseOpenApiDefinitionSettingsSchema(void 0), parseOpenApiDefinitionSettingsSchema(spec.settings))
+              }),
               source: {
                 type: "openapi",
                 file: absoluteFilepath
@@ -494376,9 +494588,9 @@ var require_graceful_fs2 = __commonJS({
         }
       }
       var fs$readdir = fs35.readdir;
-      fs35.readdir = readdir23;
+      fs35.readdir = readdir24;
       var noReaddirOptionVersions = /^v[0-5]\./;
-      function readdir23(path122, options2, cb) {
+      function readdir24(path122, options2, cb) {
         if (typeof options2 === "function")
           cb = options2, options2 = null;
         var go$readdir = noReaddirOptionVersions.test(process.version) ? function go$readdir2(path123, options3, cb2, startTime) {
@@ -503231,10 +503443,10 @@ var require_make_dir = __commonJS({
     module4.exports = (input3, opts) => Promise.resolve().then(() => {
       checkPath(input3);
       opts = Object.assign({}, defaults3, opts);
-      const mkdir49 = pify(opts.fs.mkdir);
+      const mkdir50 = pify(opts.fs.mkdir);
       const stat8 = pify(opts.fs.stat);
       const make = (pth) => {
-        return mkdir49(pth, opts.mode).then(() => pth).catch((err) => {
+        return mkdir50(pth, opts.mode).then(() => pth).catch((err) => {
           if (err.code === "ENOENT") {
             if (err.message.includes("null bytes") || path122.dirname(pth) === pth) {
               throw err;
@@ -637258,14 +637470,14 @@ var require_empty2 = __commonJS({
     var u5 = require_universalify().fromPromise;
     var fs34 = require_fs();
     var path122 = require("path");
-    var mkdir49 = require_mkdirs();
+    var mkdir50 = require_mkdirs();
     var remove3 = require_remove3();
     var emptyDir = u5(async function emptyDir2(dir) {
       let items;
       try {
         items = await fs34.readdir(dir);
       } catch {
-        return mkdir49.mkdirs(dir);
+        return mkdir50.mkdirs(dir);
       }
       return Promise.all(items.map((item) => remove3.remove(path122.join(dir, item))));
     });
@@ -637274,7 +637486,7 @@ var require_empty2 = __commonJS({
       try {
         items = fs34.readdirSync(dir);
       } catch {
-        return mkdir49.mkdirsSync(dir);
+        return mkdir50.mkdirsSync(dir);
       }
       items.forEach((item) => {
         item = path122.join(dir, item);
@@ -637297,7 +637509,7 @@ var require_file2 = __commonJS({
     var u5 = require_universalify().fromPromise;
     var path122 = require("path");
     var fs34 = require_fs();
-    var mkdir49 = require_mkdirs();
+    var mkdir50 = require_mkdirs();
     async function createFile(file4) {
       let stats;
       try {
@@ -637311,7 +637523,7 @@ var require_file2 = __commonJS({
         dirStats = await fs34.stat(dir);
       } catch (err) {
         if (err.code === "ENOENT") {
-          await mkdir49.mkdirs(dir);
+          await mkdir50.mkdirs(dir);
           await fs34.writeFile(file4, "");
           return;
         } else {
@@ -637337,7 +637549,7 @@ var require_file2 = __commonJS({
           fs34.readdirSync(dir);
         }
       } catch (err) {
-        if (err && err.code === "ENOENT") mkdir49.mkdirsSync(dir);
+        if (err && err.code === "ENOENT") mkdir50.mkdirsSync(dir);
         else throw err;
       }
       fs34.writeFileSync(file4, "");
@@ -637356,7 +637568,7 @@ var require_link = __commonJS({
     var u5 = require_universalify().fromPromise;
     var path122 = require("path");
     var fs34 = require_fs();
-    var mkdir49 = require_mkdirs();
+    var mkdir50 = require_mkdirs();
     var { pathExists: pathExists2 } = require_path_exists();
     var { areIdentical } = require_stat();
     async function createLink(srcpath, dstpath) {
@@ -637376,7 +637588,7 @@ var require_link = __commonJS({
       const dir = path122.dirname(dstpath);
       const dirExists = await pathExists2(dir);
       if (!dirExists) {
-        await mkdir49.mkdirs(dir);
+        await mkdir50.mkdirs(dir);
       }
       await fs34.link(srcpath, dstpath);
     }
@@ -637396,7 +637608,7 @@ var require_link = __commonJS({
       const dir = path122.dirname(dstpath);
       const dirExists = fs34.existsSync(dir);
       if (dirExists) return fs34.linkSync(srcpath, dstpath);
-      mkdir49.mkdirsSync(dir);
+      mkdir50.mkdirsSync(dir);
       return fs34.linkSync(srcpath, dstpath);
     }
     module4.exports = {
@@ -637732,19 +637944,19 @@ var require_output_file = __commonJS({
     var u5 = require_universalify().fromPromise;
     var fs34 = require_fs();
     var path122 = require("path");
-    var mkdir49 = require_mkdirs();
+    var mkdir50 = require_mkdirs();
     var pathExists2 = require_path_exists().pathExists;
     async function outputFile(file4, data2, encoding = "utf-8") {
       const dir = path122.dirname(file4);
       if (!await pathExists2(dir)) {
-        await mkdir49.mkdirs(dir);
+        await mkdir50.mkdirs(dir);
       }
       return fs34.writeFile(file4, data2, encoding);
     }
     function outputFileSync(file4, ...args) {
       const dir = path122.dirname(file4);
       if (!fs34.existsSync(dir)) {
-        mkdir49.mkdirsSync(dir);
+        mkdir50.mkdirsSync(dir);
       }
       fs34.writeFileSync(file4, ...args);
     }
@@ -696657,6 +696869,14 @@ var OpenApiSettingsSchema2 = BaseApiSettingsSchema2.extend({
    * Defaults to false.
    */
   preserveOneOfInAllOf: external_exports.boolean().optional(),
+  /**
+   * When a schema declares `properties` alongside an `anyOf` that only marks
+   * some of those same properties required, the `anyOf` is a constraint rather
+   * than a set of variants. Set to true to convert such a schema as an object.
+   * Defaults to false, converting it to a union, which drops the sibling
+   * `properties`.
+   */
+  anyOfSiblingPropertiesAsObject: external_exports.boolean().optional(),
   /**
    * Whether to inline allOf schemas. If false, allOf schemas will be
    * extended in the code generation.
@@ -705301,7 +705521,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-2060-gef10ff1af19",
+          version: "5.23.3-2069-g46cdcdac844",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -705367,7 +705587,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-2060-gef10ff1af19",
+        version: "5.23.3-2069-g46cdcdac844",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -712176,6 +712396,7 @@ var LegacyApiSpecAdapter = class {
       typeDatesAsStrings: settings.typeDatesAsStrings,
       preserveSingleSchemaOneOf: settings.preserveSingleSchemaOneof,
       preserveOneOfInAllOf: settings.preserveOneOfInAllOf,
+      anyOfSiblingPropertiesAsObject: settings.anyOfSiblingPropertiesAsObject,
       inlineAllOfSchemas: settings.inlineAllOfSchemas,
       resolveAliases: settings.resolveAliases,
       groupMultiApiEnvironments: settings.groupMultiApiEnvironments,
@@ -885132,6 +885353,7 @@ var SETTINGS_KEY_MAP = {
   "type-dates-as-strings": "typeDatesAsStrings",
   "preserve-single-schema-oneof": "preserveSingleSchemaOneof",
   "preserve-one-of-in-all-of": "preserveOneOfInAllOf",
+  "any-of-sibling-properties-as-object": "anyOfSiblingPropertiesAsObject",
   "inline-all-of-schemas": "inlineAllOfSchemas",
   "resolve-aliases": "resolveAliases",
   "group-multi-api-environments": "groupMultiApiEnvironments",
@@ -887041,7 +887263,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.23.3-2060-gef10ff1af19";
+  const version7 = "5.23.3-2069-g46cdcdac844";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -908698,6 +908920,28 @@ function getGeneratorLanguage(generatorId) {
   return getGeneratorPolicy(generatorId)?.language;
 }
 function validateGeneratorConfigCompatibility(input3) {
+  const route = selectGeneratorConfigRoute(input3);
+  const receivedConfigKind = input3.configKind;
+  if (!isGenerationConfigKind(receivedConfigKind)) {
+    throw compatibilityError(input3, {
+      code: "INVALID_CONFIG_KIND",
+      message: "Configuration kind must be legacy-fern or sdk-config-v1",
+      cutoverVersion: route.cutoverVersion,
+      expectedLanguage: route.language,
+      expectedConfigKind: route.configKind,
+      recommendedAction: "USE_SUPPORTED_CONFIG_KIND"
+    }, receivedConfigKind);
+  }
+  if (receivedConfigKind !== route.configKind) {
+    const policy = getGeneratorPolicy(input3.generatorId);
+    if (policy === void 0) {
+      throw new Error(`Missing validated generator policy for ${input3.generatorId}`);
+    }
+    throw configKindError(input3, policy, route.configKind, receivedConfigKind);
+  }
+  return route;
+}
+function selectGeneratorConfigRoute(input3) {
   const policy = getGeneratorPolicy(input3.generatorId);
   if (policy === void 0) {
     throw compatibilityError(input3, {
@@ -908732,27 +908976,13 @@ function validateGeneratorConfigCompatibility(input3) {
   }
   const isBeforeCutover = compareSemver(requestedVersion, policy.parsedCutoverVersion) < 0;
   const expectedConfigKind = isBeforeCutover ? "legacy-fern" : "sdk-config-v1";
-  const receivedConfigKind = input3.configKind;
-  if (!isGenerationConfigKind(receivedConfigKind)) {
-    throw compatibilityError(input3, {
-      code: "INVALID_CONFIG_KIND",
-      message: "Configuration kind must be legacy-fern or sdk-config-v1",
-      cutoverVersion: policy.cutoverVersion,
-      expectedLanguage: policy.language,
-      expectedConfigKind,
-      recommendedAction: "USE_SUPPORTED_CONFIG_KIND"
-    }, receivedConfigKind);
-  }
-  if (receivedConfigKind !== expectedConfigKind) {
-    throw configKindError(input3, policy, expectedConfigKind, receivedConfigKind);
-  }
   return {
     generatorId: input3.generatorId,
     language: policy.language,
     requestedVersion: input3.requestedVersion,
     cutoverVersion: policy.cutoverVersion,
-    configKind: receivedConfigKind,
-    payloadKind: isBeforeCutover ? "fern-runtime-bundle" : "sdk-config-ir-v1"
+    configKind: expectedConfigKind,
+    payloadKind: isBeforeCutover ? "fern-runtime-bundle" : "sdk-config-v1"
   };
 }
 function compatibilityError(input3, details, receivedConfigKind = input3.configKind) {
@@ -908783,13 +909013,15 @@ function isGenerationConfigKind(value2) {
 var POLL_INTERVAL_MS2 = 2e3;
 var POLL_TIMEOUT_MS2 = 15 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 6e4;
-var MAX_BUNDLES = 64;
+var MAX_PAYLOADS = 64;
 var MAX_SOURCE_COMPRESSED_BYTES = 25 * 1024 * 1024;
 var MAX_SOURCE_DECOMPRESSED_BYTES = 25 * 1024 * 1024;
-var MAX_BUNDLE_COMPRESSED_BYTES = 5 * 1024 * 1024;
-var MAX_BUNDLE_DECOMPRESSED_BYTES = 25 * 1024 * 1024;
-var MAX_TOTAL_BUNDLE_COMPRESSED_BYTES = 25 * 1024 * 1024;
-var MAX_TOTAL_BUNDLE_DECOMPRESSED_BYTES = 100 * 1024 * 1024;
+var MAX_RUNTIME_BUNDLE_COMPRESSED_BYTES = 5 * 1024 * 1024;
+var MAX_PAYLOAD_BYTES = 25 * 1024 * 1024;
+var MAX_TOTAL_RUNTIME_BUNDLE_COMPRESSED_BYTES = 25 * 1024 * 1024;
+var MAX_TOTAL_PAYLOAD_BYTES = 100 * 1024 * 1024;
+var MAX_TOTAL_UPLOAD_FILE_BYTES = 50 * 1024 * 1024;
+var MAX_REQUEST_FIELD_BYTES = 1024 * 1024;
 var MAX_MULTIPART_BODY_BYTES = 60 * 1024 * 1024;
 var LOOPBACK_HOSTNAMES2 = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]", "::1"]);
 var TARGET_ID_SEED_COLLATOR = new Intl.Collator("en", { numeric: true });
@@ -908820,6 +909052,18 @@ function getFernSdkGenApiOrigin() {
 function getFernSdkGenApiLanguage(generatorName) {
   return getGeneratorLanguage(generatorName);
 }
+function selectFernSdkGenApiRoute(generatorInvocation) {
+  const language = getFernSdkGenApiLanguage(generatorInvocation.name);
+  if (language == null) {
+    return void 0;
+  }
+  return validateGeneratorConfigCompatibility({
+    generatorId: generatorInvocation.name,
+    language: generatorInvocation.language ?? language,
+    requestedVersion: generatorInvocation.version,
+    configKind: "legacy-fern"
+  });
+}
 function mapFernSdkGenApiOutput(generatorInvocation) {
   const outputMode = generatorInvocation.outputMode;
   switch (outputMode.type) {
@@ -909021,6 +909265,7 @@ function isEligibleForFernSdkGenApi(candidate) {
 var FernSdkGenApiBatch = class {
   expectedTargets;
   participants = [];
+  removedTargetIds = /* @__PURE__ */ new Set();
   terminalError;
   dispatched = false;
   constructor(expectedTargets) {
@@ -909033,6 +909278,9 @@ var FernSdkGenApiBatch = class {
     if (this.terminalError != null) {
       return Promise.reject(this.terminalError);
     }
+    if (parameters2.targetIdSeed != null && this.removedTargetIds.has(parameters2.targetIdSeed)) {
+      return Promise.reject(new Error(`Fern sdk-gen-api target ${parameters2.targetIdSeed} was removed`));
+    }
     if (this.dispatched) {
       return Promise.reject(new Error("The Fern sdk-gen-api batch was already dispatched"));
     }
@@ -909049,6 +909297,22 @@ var FernSdkGenApiBatch = class {
     this.expectedTargets -= 1;
     this.dispatchIfReady();
   }
+  /** Removes one failed automation target while preserving undispatched siblings. */
+  remove(targetIdSeed, error50) {
+    if (this.dispatched || this.terminalError != null) {
+      return false;
+    }
+    if (this.removedTargetIds.has(targetIdSeed)) {
+      return false;
+    }
+    this.removedTargetIds.add(targetIdSeed);
+    const participantIndex = this.participants.findIndex((participant2) => participant2.targetIdSeed === targetIdSeed);
+    const [participant] = participantIndex >= 0 ? this.participants.splice(participantIndex, 1) : [];
+    participant?.reject(error50);
+    this.expectedTargets -= 1;
+    this.dispatchIfReady();
+    return true;
+  }
   /** Prevents siblings waiting at the batch barrier from hanging if preparation of one fails. */
   cancel(error50) {
     if (this.dispatched || this.terminalError != null) {
@@ -909060,7 +909324,7 @@ var FernSdkGenApiBatch = class {
     }
   }
   dispatchIfReady() {
-    if (this.dispatched || this.terminalError != null || this.participants.length !== this.expectedTargets) {
+    if (this.dispatched || this.terminalError != null || this.expectedTargets === 0 || this.participants.length !== this.expectedTargets) {
       return;
     }
     this.dispatched = true;
@@ -909086,6 +909350,72 @@ var FernSdkGenApiBatch = class {
     }
   }
 };
+var FernSdkGenApiPreparationBatch = class {
+  expectedTargetIds;
+  settledTargetIds = /* @__PURE__ */ new Set();
+  waiters = [];
+  preflightParticipants = [];
+  terminalError;
+  didRunPreflight = false;
+  constructor(targetIds) {
+    this.expectedTargetIds = new Set(targetIds);
+    if (this.expectedTargetIds.size !== targetIds.length) {
+      throw new Error("Fern sdk-gen-api preparation target IDs must be unique");
+    }
+  }
+  ready(targetId, preflightParameters) {
+    this.assertExpected(targetId);
+    if (this.settledTargetIds.has(targetId)) {
+      throw new Error(`Fern sdk-gen-api target ${targetId} prepared more than once`);
+    }
+    this.settledTargetIds.add(targetId);
+    if (preflightParameters != null) {
+      this.preflightParticipants.push(preflightParameters);
+    }
+    return new Promise((resolve15, reject) => {
+      this.waiters.push({ resolve: resolve15, reject });
+      this.finishIfSettled();
+    });
+  }
+  /** Returns true only when this call newly settles a target that failed before preparation. */
+  fail(targetId, error50, isolateFailure) {
+    this.assertExpected(targetId);
+    if (this.settledTargetIds.has(targetId)) {
+      return false;
+    }
+    this.settledTargetIds.add(targetId);
+    if (!isolateFailure) {
+      this.terminalError = error50;
+    }
+    this.finishIfSettled();
+    return true;
+  }
+  assertExpected(targetId) {
+    if (!this.expectedTargetIds.has(targetId)) {
+      throw new Error(`Unexpected Fern sdk-gen-api preparation target ${targetId}`);
+    }
+  }
+  finishIfSettled() {
+    if (this.settledTargetIds.size !== this.expectedTargetIds.size) {
+      return;
+    }
+    if (!this.didRunPreflight && this.terminalError == null && this.preflightParticipants.length > 0) {
+      this.didRunPreflight = true;
+      try {
+        prepareFernSdkGenApiSubmission(this.preflightParticipants);
+      } catch (error50) {
+        this.terminalError = error50;
+      }
+    }
+    for (const waiter of this.waiters) {
+      if (this.terminalError != null) {
+        waiter.reject(this.terminalError);
+      } else {
+        waiter.resolve();
+      }
+    }
+  }
+};
 async function runFernSdkGenApiBuild(parameters2) {
   const [result] = await executeFernSdkGenApiBuild([parameters2]);
   if (result?.status === "fulfilled") {
@@ -909093,7 +909423,12 @@ async function runFernSdkGenApiBuild(parameters2) {
   }
   throw result?.reason ?? new Error("sdk-gen-api did not return the requested target");
 }
-async function executeFernSdkGenApiBuild(participants) {
+function validateFernSdkGenApiTargetCount(targetCount) {
+  if (targetCount > MAX_PAYLOADS) {
+    throw new Error(`sdk-gen-api supports at most ${MAX_PAYLOADS} target payloads per build; received ${targetCount}`);
+  }
+}
+function prepareFernSdkGenApiSubmission(participants) {
   const first3 = participants[0];
   if (first3 == null) {
     throw new Error("Cannot submit an empty Fern sdk-gen-api build");
@@ -909120,13 +909455,20 @@ async function executeFernSdkGenApiBuild(participants) {
     targets: participants.map((participant) => ({
       generatorInvocation: participant.generatorInvocation,
       sdkVersion: participant.sdkVersion,
+      apiVersion: participant.apiVersion,
       targetIdSeed: participant.targetIdSeed,
+      sourceSpecIndexes: participant.sourceSpecIndexes,
       audiences: participant.audiences,
-      runtimeBundle: participant.runtimeBundle
+      payload: participant.payload
     }))
   });
+  const serializedRequest = JSON.stringify(request7);
+  const serializedRequestBytes = Buffer.byteLength(serializedRequest, "utf8");
+  if (serializedRequestBytes > MAX_REQUEST_FIELD_BYTES) {
+    return first3.context.failAndThrow(`sdk-gen-api serialized request field is ${formatMiB(serializedRequestBytes)}, exceeding the 1 MiB UTF-8 field limit; reduce generator customConfig, readme, settings, or API override metadata`, void 0, { code: CliError.Code.ConfigError });
+  }
   const form = new import_form_data4.default();
-  form.append("request", JSON.stringify(request7));
+  form.append("request", serializedRequest);
   form.append("sources", first3.specsTarGzBuffer, {
     filename: "specs.tar.gz",
     contentType: "application/gzip"
@@ -909134,17 +909476,22 @@ async function executeFernSdkGenApiBuild(participants) {
   participants.forEach((participant, index3) => {
     const target = request7.targets[index3];
     if (target == null) {
-      throw new Error(`Cannot pair sdk-gen-api runtime bundle at index ${index3} with a target`);
+      throw new Error(`Cannot pair sdk-gen-api payload at index ${index3} with a target`);
     }
-    form.append("bundles", participant.runtimeBundle, {
-      filename: `${target.targetId}.json.gz`,
-      contentType: "application/gzip"
+    const isRuntimeBundle = participant.payload.payloadKind === "fern-runtime-bundle";
+    form.append("payloads", participant.payload.body, {
+      filename: `${target.targetId}.json${isRuntimeBundle ? ".gz" : ""}`,
+      contentType: isRuntimeBundle ? "application/gzip" : "application/json"
     });
   });
   const multipartBodyLength = form.getLengthSync();
   if (multipartBodyLength > MAX_MULTIPART_BODY_BYTES) {
-    return first3.context.failAndThrow(`sdk-gen-api multipart request is ${formatMiB(multipartBodyLength)}, exceeding the 60 MiB limit; reduce source or target bundle size`, void 0, { code: CliError.Code.ConfigError });
+    return first3.context.failAndThrow(`sdk-gen-api multipart request is ${formatMiB(multipartBodyLength)}, exceeding the 60 MiB limit; reduce source or target payload size`, void 0, { code: CliError.Code.ConfigError });
   }
+  return { first: first3, origin: origin2, request: request7, form };
+}
+async function executeFernSdkGenApiBuild(participants) {
+  const { first: first3, origin: origin2, request: request7, form } = prepareFernSdkGenApiSubmission(participants);
   let buildId;
   try {
     const response = await axios_default.post(`${origin2}/v1/fern/build`, form, {
@@ -909222,7 +909569,7 @@ function assertGeneratorConfigCompatibility(participants) {
         generatorId: generatorInvocation.name,
         language,
         requestedVersion: generatorInvocation.version,
-        configKind: "legacy-fern"
+        configKind: participant.payload.payloadKind === "fern-runtime-bundle" ? "legacy-fern" : "sdk-config-v1"
       });
     } catch (error50) {
       if (!(error50 instanceof GeneratorConfigCompatibilityError)) {
@@ -909247,8 +909594,8 @@ function formatGeneratorConfigCompatibilityError(error50) {
     `retryable=${error50.retryable}`,
     `recommendedAction=${error50.recommendedAction}`
   ].join("; ");
-  const remediation = error50.code === "SDK_CONFIG_V1_REQUIRED" ? " Run `fern sdk-config migrate` to create SDK Config v1 for this target." : "";
-  return `Cannot submit SDK generation to sdk-gen-api: ${error50.message} [${diagnostic}].${remediation}`;
+  const migrationHint = error50.recommendedAction === "USE_SDK_CONFIG_V1" ? " Run `fern sdk migrate --output <path>` to migrate this SDK configuration before using this generator version." : "";
+  return `Cannot submit SDK generation to sdk-gen-api: ${error50.message} [${diagnostic}].${migrationHint}`;
 }
 function compareFernSdkGenApiParticipants(left3, right3) {
   const seedComparison = TARGET_ID_SEED_COLLATOR.compare(left3.targetIdSeed ?? "", right3.targetIdSeed ?? "");
@@ -909266,20 +909613,25 @@ function compareFernSdkGenApiParticipants(left3, right3) {
   return left3.sdkVersion.localeCompare(right3.sdkVersion);
 }
 function validateProtocolInputs(participants, first3) {
-  if (participants.length > MAX_BUNDLES) {
-    first3.context.failAndThrow(`sdk-gen-api supports at most ${MAX_BUNDLES} runtime bundles per build; received ${participants.length}`, void 0, { code: CliError.Code.ConfigError });
+  if (participants.length > MAX_PAYLOADS) {
+    first3.context.failAndThrow(`sdk-gen-api supports at most ${MAX_PAYLOADS} target payloads per build; received ${participants.length}`, void 0, { code: CliError.Code.ConfigError });
   }
   if (first3.specsTarGzBuffer.length > MAX_SOURCE_COMPRESSED_BYTES) {
     first3.context.failAndThrow(`sdk-gen-api source archive is ${formatMiB(first3.specsTarGzBuffer.length)}, exceeding the 25 MiB compressed limit`, void 0, { code: CliError.Code.ConfigError });
   }
-  const oversizedBundleIndex = participants.findIndex((participant) => participant.runtimeBundle.length > MAX_BUNDLE_COMPRESSED_BYTES);
-  if (oversizedBundleIndex >= 0) {
-    const participant = participants[oversizedBundleIndex];
-    first3.context.failAndThrow(`sdk-gen-api runtime bundle ${participant?.targetIdSeed ?? oversizedBundleIndex.toString()} is ${formatMiB(participant?.runtimeBundle.length ?? 0)}, exceeding the 5 MiB compressed limit`, void 0, { code: CliError.Code.ConfigError });
+  const oversizedPayloadIndex = participants.findIndex((participant) => participant.payload.body.length > (participant.payload.payloadKind === "fern-runtime-bundle" ? MAX_RUNTIME_BUNDLE_COMPRESSED_BYTES : MAX_PAYLOAD_BYTES));
+  if (oversizedPayloadIndex >= 0) {
+    const participant = participants[oversizedPayloadIndex];
+    const maxBytes = participant?.payload.payloadKind === "fern-runtime-bundle" ? MAX_RUNTIME_BUNDLE_COMPRESSED_BYTES : MAX_PAYLOAD_BYTES;
+    first3.context.failAndThrow(`sdk-gen-api ${payloadLabel(participant, oversizedPayloadIndex)} is ${formatMiB(participant?.payload.body.length ?? 0)}, exceeding the ${formatMiB(maxBytes)} upload limit`, void 0, { code: CliError.Code.ConfigError });
+  }
+  const totalUploadFileBytes = participants.reduce((total, participant) => total + participant.payload.body.length, first3.specsTarGzBuffer.length);
+  if (totalUploadFileBytes > MAX_TOTAL_UPLOAD_FILE_BYTES) {
+    first3.context.failAndThrow(`sdk-gen-api source archive and target payloads total ${formatMiB(totalUploadFileBytes)}, exceeding the 50 MiB in-memory upload limit; reduce the source archive size, target payload size, or number of targets`, void 0, { code: CliError.Code.ConfigError });
   }
-  const totalBundleBytes = participants.reduce((total, participant) => total + participant.runtimeBundle.length, 0);
-  if (totalBundleBytes > MAX_TOTAL_BUNDLE_COMPRESSED_BYTES) {
-    first3.context.failAndThrow(`sdk-gen-api runtime bundles total ${formatMiB(totalBundleBytes)}, exceeding the 25 MiB compressed limit; reduce the number or size of targets`, void 0, { code: CliError.Code.ConfigError });
+  const totalRuntimeBundleBytes = participants.reduce((total, participant) => participant.payload.payloadKind === "fern-runtime-bundle" ? total + participant.payload.body.length : total, 0);
+  if (totalRuntimeBundleBytes > MAX_TOTAL_RUNTIME_BUNDLE_COMPRESSED_BYTES) {
+    first3.context.failAndThrow(`sdk-gen-api runtime bundles total ${formatMiB(totalRuntimeBundleBytes)}, exceeding the 25 MiB compressed limit; reduce the number or size of targets`, void 0, { code: CliError.Code.ConfigError });
   }
   getBoundedGzipSize({
     buffer: first3.specsTarGzBuffer,
@@ -909287,19 +909639,23 @@ function validateProtocolInputs(participants, first3) {
     label: "source archive",
     context: first3.context
   });
-  let totalDecompressedBundleBytes = 0;
+  let totalPayloadBytes = 0;
   for (const [index3, participant] of participants.entries()) {
-    totalDecompressedBundleBytes += getBoundedGzipSize({
-      buffer: participant.runtimeBundle,
-      maxBytes: MAX_BUNDLE_DECOMPRESSED_BYTES,
-      label: `runtime bundle ${participant.targetIdSeed ?? index3.toString()}`,
+    totalPayloadBytes += participant.payload.payloadKind === "fern-runtime-bundle" ? getBoundedGzipSize({
+      buffer: participant.payload.body,
+      maxBytes: MAX_PAYLOAD_BYTES,
+      label: payloadLabel(participant, index3),
       context: first3.context
-    });
-    if (totalDecompressedBundleBytes > MAX_TOTAL_BUNDLE_DECOMPRESSED_BYTES) {
-      first3.context.failAndThrow(`sdk-gen-api runtime bundles total ${formatMiB(totalDecompressedBundleBytes)} decompressed, exceeding the 100 MiB decompressed limit; reduce the number or size of targets`, void 0, { code: CliError.Code.ConfigError });
+    }) : participant.payload.body.length;
+    if (totalPayloadBytes > MAX_TOTAL_PAYLOAD_BYTES) {
+      first3.context.failAndThrow(`sdk-gen-api target payloads total ${formatMiB(totalPayloadBytes)}, exceeding the 100 MiB decoded limit; reduce the number or size of targets`, void 0, { code: CliError.Code.ConfigError });
     }
   }
 }
+function payloadLabel(participant, index3) {
+  const kind = participant?.payload.payloadKind ?? "target payload";
+  return `${kind} ${participant?.targetIdSeed ?? index3.toString()}`;
+}
 function getBoundedGzipSize({ buffer, maxBytes, label, context: context3 }) {
   let decompressed;
   try {
@@ -909382,23 +909738,41 @@ function createFernSdkGenApiBatchRequest({ apiName, organization, cliVersion, sp
   if (targets2.length === 0) {
     throw new Error("Cannot create an empty Fern sdk-gen-api request");
   }
-  const requestTargets = targets2.map(({ generatorInvocation, sdkVersion, targetIdSeed, audiences }, index3) => {
+  const apiInputs = [];
+  const apiInputIds = targets2.map(({ targetIdSeed, sourceSpecIndexes }, index3) => {
+    if (sourceSpecIndexes == null) {
+      if (!apiInputs.some((input3) => input3.id === "default")) {
+        apiInputs.push({ id: "default", specIndexes: "all" });
+      }
+      return "default";
+    }
+    const id = `target-${targetIdSeed ?? index3.toString()}`;
+    apiInputs.push({ id, specIndexes: sourceSpecIndexes });
+    return id;
+  });
+  const requestTargets = targets2.map(({ generatorInvocation, sdkVersion, apiVersion, targetIdSeed, audiences, payload }, index3) => {
     const language = getFernSdkGenApiLanguage(generatorInvocation.name);
     if (language == null) {
       throw new Error(`Unsupported Fern SDK generator: ${generatorInvocation.name}`);
     }
     const output2 = mapFernSdkGenApiOutput(generatorInvocation);
+    const packageConfig = payload.package ?? output2.package;
     const targetId = (0, import_crypto10.createHash)("sha256").update(`${apiName}:${generatorInvocation.name}:${generatorInvocation.version}:${targetIdSeed ?? index3.toString()}`).digest("hex").slice(0, 20);
     return {
       targetId,
-      apiInputId: "default",
+      apiInputId: apiInputIds[index3] ?? "default",
       language,
-      sdk: { name: apiName, version: sdkVersion },
+      sdk: {
+        name: apiName,
+        version: sdkVersion,
+        ...apiVersion != null ? { apiVersion } : {}
+      },
       fernGenerator: {
         id: generatorInvocation.name,
         version: generatorInvocation.version
       },
-      ...output2.package != null ? { package: output2.package } : {},
+      payloadKind: payload.payloadKind,
+      ...packageConfig != null ? { package: packageConfig } : {},
       invocation: {
         customConfig: stripCliConfigKeys(generatorInvocation.config) ?? {},
         keywords: generatorInvocation.keywords ?? [],
@@ -909417,15 +909791,14 @@ function createFernSdkGenApiBatchRequest({ apiName, organization, cliVersion, sp
       requestedOutput: output2.requestedOutput
     };
   });
-  const apiInputs = [{ id: "default", specIndexes: "all" }];
-  const runtimeBundleHashes = targets2.map((target) => (0, import_crypto10.createHash)("sha256").update(target.runtimeBundle).digest("hex"));
+  const payloadHashes = targets2.map((target) => (0, import_crypto10.createHash)("sha256").update(target.payload.body).digest("hex"));
   const idempotencyKey = (0, import_crypto10.createHash)("sha256").update(specsTarGzBuffer).update(JSON.stringify({
     protocolVersion: 2,
     organization,
     apiName,
     apiInputs,
     targets: requestTargets,
-    runtimeBundleHashes
+    payloadHashes
   })).digest("hex");
   return {
     protocolVersion: 2,
@@ -910553,6 +910926,33 @@ async function downloadFileForTask({ s3PreSignedReadUrl, absolutePathToLocalOutp
   await (0, import_promises122.pipeline)(request7.data, (0, import_fs37.createWriteStream)(absolutePathToLocalOutput));
 }
 
+// ../generation/remote-generation/remote-workspace-runner/lib/fernSdkGenApiSourceArchive.js
+function validateFernSdkGenApiSourceCompatibility(route, sourceArchive) {
+  if (route.payloadKind !== "sdk-config-v1" || route.configKind !== "sdk-config-v1") {
+    return;
+  }
+  if (sourceArchive.specIndexes.length === 0) {
+    throw new Error("SDK Config v1 requires at least one effective Fern source spec");
+  }
+  const seenIndexes = /* @__PURE__ */ new Set();
+  for (const manifestIndex of sourceArchive.specIndexes) {
+    if (seenIndexes.has(manifestIndex)) {
+      throw new Error(`Fern target source selection contains duplicate manifest index ${manifestIndex}`);
+    }
+    seenIndexes.add(manifestIndex);
+    const source2 = sourceArchive.manifest.specs[manifestIndex];
+    if (source2 == null) {
+      throw new Error(`Fern source manifest does not contain selected index ${manifestIndex}`);
+    }
+    if (!isSupportedSourceType(source2.type)) {
+      throw new Error(`Generator ${route.generatorId} ${route.requestedVersion} requires SDK Config v1, but selected source ${manifestIndex} cannot be represented downstream: SDK Config generation does not support Fern source type ${source2.type} (${source2.specPath}). Use an OpenAPI, AsyncAPI, or GraphQL source for this generator version.`);
+    }
+  }
+}
+function isSupportedSourceType(type7) {
+  return type7 === "openapi" || type7 === "asyncapi" || type7 === "graphql";
+}
+
 // ../generation/remote-generation/remote-workspace-runner/lib/resolveAutoDiscoveredFernignorePath.js
 init_lib12();
 init_lib8();
@@ -911112,26 +911512,25 @@ 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, specsTarGzBuffer, sdkGenApiBatch, sdkGenApiTargetIdSeed, generateFullProject }) {
+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, sdkGenApiSourceArchive, sdkGenApiRoute, sdkGenApiPreparationBatch, sdkGenApiBatch, sdkGenApiTargetIdSeed, generateFullProject }) {
   const fdr = createFdrService({ token: token.value });
   const fdrOrigin = "https://registry-dev2.buildwithfern.com";
   const isAirGapped = await detectAirGappedMode(`${fdrOrigin}/health`, interactiveTaskContext.logger);
   const packageName = generators_yml_exports.getPackageName({ generatorInvocation }) ?? (generatorInvocation.outputMode.type === "downloadFiles" ? getPackageNameFromGeneratorConfig(generatorInvocation) : void 0);
   const isPreview = isPreviewOverride ?? absolutePathToPreview != null;
-  const substituteEnvVars = (stringOrObject) => replaceEnvVariables(stringOrObject, {
-    onError: (e2) => {
+  const resolvedWhitelabel = whitelabel == null ? void 0 : replaceEnvVariables(whitelabel, {
+    onError: (error50) => {
       if (!isPreview && requireEnvVars) {
-        interactiveTaskContext.failAndThrow(void 0, e2, {
+        interactiveTaskContext.failAndThrow(void 0, error50, {
           code: CliError.Code.EnvironmentError
         });
       }
     }
   }, { substituteAsEmpty: isPreview });
-  const generatorInvocationWithEnvVarSubstitutions = substituteEnvVars(generatorInvocation);
   const dynamicGeneratorConfig = getDynamicGeneratorConfig({
     apiName: workspace.definition.rootApiFile.contents.name,
     organization,
-    generatorInvocation: generatorInvocationWithEnvVarSubstitutions
+    generatorInvocation
   });
   const resolvedVersion = version7 ?? await computeSemanticVersion({ packageName, generatorInvocation });
   if (version7 != null) {
@@ -911182,10 +911581,43 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
       ciProvider: detectCiProvider()
     }
   });
-  const venus = createVenusService({ token: token.value });
+  let sdkGenApiCandidate;
+  const sdkGenApiLanguage = getFernSdkGenApiLanguage(generatorInvocation.name);
+  if (sdkGenApiRoute != null) {
+    if (replay?.enabled === true) {
+      return interactiveTaskContext.failAndThrow("sdk-gen-api does not yet support replay", void 0, {
+        code: CliError.Code.ConfigError
+      });
+    }
+    if (generateFullProject === true) {
+      return interactiveTaskContext.failAndThrow("sdk-gen-api does not yet support full-project generation", void 0, { code: CliError.Code.ConfigError });
+    }
+    const candidate = {
+      generatorInvocation,
+      sdkVersion: resolvedVersion,
+      specsTarGzBuffer,
+      whitelabel
+    };
+    if (!isEligibleForFernSdkGenApi(candidate)) {
+      const reason = resolvedVersion == null ? "the SDK version could not be resolved" : (0, import_autoversion2.isAutoVersion)(resolvedVersion) ? "automatic SDK versioning has not yet moved from Fiddle to the shared pipeline" : whitelabel != null ? "whitelabel generation has not yet moved from Fiddle to the shared pipeline" : specsTarGzBuffer == null ? "the source archive is unavailable" : `generator language ${generatorInvocation.language ?? "unknown"} does not match ${sdkGenApiLanguage}`;
+      return interactiveTaskContext.failAndThrow(`Cannot submit SDK generation to sdk-gen-api: ${reason}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
+    }
+    sdkGenApiCandidate = candidate;
+    if (sdkGenApiRoute.payloadKind === "sdk-config-v1") {
+      return interactiveTaskContext.failAndThrow(`Cannot submit ${candidate.generatorInvocation.name} ${candidate.generatorInvocation.version} from legacy Fern configuration. Run \`fern sdk migrate --output <path>\` to create SDK Config v1 before using this generator version.`, void 0, { code: CliError.Code.ConfigError });
+    }
+    if (sdkGenApiTargetIdSeed == null) {
+      throw new Error("sdk-gen-api target is missing its preparation ID");
+    }
+    await sdkGenApiPreparationBatch?.ready(sdkGenApiTargetIdSeed);
+  }
+  const requiresFdrRegistration = sdkGenApiRoute?.payloadKind !== "sdk-config-v1";
   let generateOauthClients = false;
   let generatePaginatedClients = false;
-  if (!isAirGapped) {
+  if (!isAirGapped && requiresFdrRegistration) {
+    const venus = createVenusService({ token: token.value });
     const orgResponse = await venus.organization.get({ orgId: projectConfig.organization });
     if (orgResponse.ok) {
       if (orgResponse.body.isWhitelabled) {
@@ -911199,50 +911631,52 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
       generatePaginatedClients = orgResponse.body.paginationEnabled ?? false;
     }
   }
-  const sources = workspace.getSources();
   let fdrApiDefinitionId;
-  let sourceUploads;
-  const apiDefinition = convertIrToFdrApi({
-    ir: ir3,
-    snippetsConfig: {
-      typescriptSdk: void 0,
-      pythonSdk: void 0,
-      javaSdk: void 0,
-      rubySdk: void 0,
-      goSdk: void 0,
-      csharpSdk: void 0,
-      phpSdk: void 0,
-      swiftSdk: void 0,
-      rustSdk: void 0
-    },
-    context: interactiveTaskContext
-  });
-  try {
-    const response = await fdr.api.register.registerApiDefinition({
-      orgId: FdrAPI_exports.OrgId(organization),
-      apiId: FdrAPI_exports.ApiId(getOriginalName(ir3.apiName)),
-      definition: apiDefinition,
-      sources: sources.length > 0 ? convertToFdrApiDefinitionSources(sources) : void 0
+  if (requiresFdrRegistration) {
+    const sources = workspace.getSources();
+    let sourceUploads;
+    const apiDefinition = convertIrToFdrApi({
+      ir: ir3,
+      snippetsConfig: {
+        typescriptSdk: void 0,
+        pythonSdk: void 0,
+        javaSdk: void 0,
+        rubySdk: void 0,
+        goSdk: void 0,
+        csharpSdk: void 0,
+        phpSdk: void 0,
+        swiftSdk: void 0,
+        rustSdk: void 0
+      },
+      context: interactiveTaskContext
     });
-    fdrApiDefinitionId = response.apiDefinitionId;
-    sourceUploads = response.sources ?? void 0;
-  } catch (error50) {
-    const sourceUploader2 = new SourceUploader(interactiveTaskContext, sources);
-    if (sourceUploader2.sourceTypes.has("protobuf")) {
-      interactiveTaskContext.failAndThrow(`Failed to register API definition: ${JSON.stringify(error50)}`);
+    try {
+      const response = await fdr.api.register.registerApiDefinition({
+        orgId: FdrAPI_exports.OrgId(organization),
+        apiId: FdrAPI_exports.ApiId(getOriginalName(ir3.apiName)),
+        definition: apiDefinition,
+        sources: sources.length > 0 ? convertToFdrApiDefinitionSources(sources) : void 0
+      });
+      fdrApiDefinitionId = response.apiDefinitionId;
+      sourceUploads = response.sources ?? void 0;
+    } catch (error50) {
+      const sourceUploader2 = new SourceUploader(interactiveTaskContext, sources);
+      if (sourceUploader2.sourceTypes.has("protobuf")) {
+        interactiveTaskContext.failAndThrow(`Failed to register API definition: ${JSON.stringify(error50)}`);
+      }
+    }
+    const sourceUploader = new SourceUploader(interactiveTaskContext, sources);
+    if (sourceUploads == null && sourceUploader.sourceTypes.has("protobuf")) {
+      interactiveTaskContext.failAndThrow("Did not successfully upload Protobuf source files.", void 0, {
+        code: CliError.Code.NetworkError
+      });
+    }
+    if (sourceUploads != null) {
+      interactiveTaskContext.logger.debug("Uploading source files ...");
+      const sourceConfig = await sourceUploader.uploadSources(sourceUploads);
+      interactiveTaskContext.logger.debug("Setting IR source configuration ...");
+      ir3.sourceConfig = sourceConfig;
     }
-  }
-  const sourceUploader = new SourceUploader(interactiveTaskContext, sources);
-  if (sourceUploads == null && sourceUploader.sourceTypes.has("protobuf")) {
-    interactiveTaskContext.failAndThrow("Did not successfully upload Protobuf source files.", void 0, {
-      code: CliError.Code.NetworkError
-    });
-  }
-  if (sourceUploads != null) {
-    interactiveTaskContext.logger.debug("Uploading source files ...");
-    const sourceConfig = await sourceUploader.uploadSources(sourceUploads);
-    interactiveTaskContext.logger.debug("Setting IR source configuration ...");
-    ir3.sourceConfig = sourceConfig;
   }
   if (dynamicIrOnly) {
     interactiveTaskContext.logger.info("Dynamic IR only mode: skipping SDK generation and uploading dynamic IR only");
@@ -911293,7 +911727,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     ...ir3,
     fdrApiDefinitionId,
     publishConfig: getPublishConfig({
-      generatorInvocation: generatorInvocationWithEnvVarSubstitutions,
+      generatorInvocation,
       version: resolvedVersion,
       userProvidedVersion: version7,
       packageName,
@@ -911303,76 +911737,56 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     })
   };
   let result;
-  let usedSdkGenApi = false;
-  const sdkGenApiEnabled = isFernSdkGenApiEnabled();
-  const sdkGenApiLanguage = getFernSdkGenApiLanguage(generatorInvocationWithEnvVarSubstitutions.name);
-  if (sdkGenApiEnabled && sdkGenApiLanguage != null) {
-    if (replay?.enabled === true) {
-      return interactiveTaskContext.failAndThrow("sdk-gen-api does not yet support replay", void 0, {
-        code: CliError.Code.ConfigError
-      });
-    }
-    if (generateFullProject === true) {
-      return interactiveTaskContext.failAndThrow("sdk-gen-api does not yet support full-project generation", void 0, { code: CliError.Code.ConfigError });
-    }
-    const candidate = {
-      generatorInvocation: generatorInvocationWithEnvVarSubstitutions,
-      sdkVersion: resolvedVersion,
-      specsTarGzBuffer,
-      whitelabel
-    };
-    if (!isEligibleForFernSdkGenApi(candidate)) {
-      const reason = resolvedVersion == null ? "the SDK version could not be resolved" : (0, import_autoversion2.isAutoVersion)(resolvedVersion) ? "automatic SDK versioning has not yet moved from Fiddle to the shared pipeline" : whitelabel != null ? "whitelabel generation has not yet moved from Fiddle to the shared pipeline" : specsTarGzBuffer == null ? "the source archive is unavailable" : `generator language ${generatorInvocationWithEnvVarSubstitutions.language ?? "unknown"} does not match ${sdkGenApiLanguage}`;
-      return interactiveTaskContext.failAndThrow(`Cannot submit SDK generation to sdk-gen-api: ${reason}`, void 0, {
-        code: CliError.Code.ConfigError
-      });
+  if (sdkGenApiRoute != null) {
+    if (sdkGenApiCandidate == null) {
+      throw new Error("sdk-gen-api target passed preflight without an eligible candidate");
     }
-    if (verify2 === true) {
-      interactiveTaskContext.logger.warn("sdk-gen-api does not yet run Fern's post-generation verification step");
+    if (sdkGenApiRoute.payloadKind !== "fern-runtime-bundle") {
+      throw new Error("Legacy Fern generation reached sdk-gen-api without a Fern runtime bundle route");
     }
-    const runtimeBundle = await prepareFernSdkGenApiRuntimeBundle({
-      apiName: getOriginalName(ir3.apiName),
-      organization,
-      generatorInvocation: candidate.generatorInvocation,
-      sdkVersion: candidate.sdkVersion,
-      intermediateRepresentation: enrichedIntermediateRepresentation,
-      irVersionOverride,
-      generateOauthClients,
-      generatePaginatedClients,
-      context: interactiveTaskContext
-    });
     const parameters2 = {
       apiName: getOriginalName(ir3.apiName),
       organization,
       cliVersion: workspace.cliVersion,
-      generatorInvocation: candidate.generatorInvocation,
-      sdkVersion: candidate.sdkVersion,
+      generatorInvocation: sdkGenApiCandidate.generatorInvocation,
+      sdkVersion: sdkGenApiCandidate.sdkVersion,
+      apiVersion: ir3.specVersion,
       token,
-      specsTarGzBuffer: candidate.specsTarGzBuffer,
-      runtimeBundle,
+      specsTarGzBuffer: sdkGenApiCandidate.specsTarGzBuffer,
+      payload: {
+        payloadKind: sdkGenApiRoute.payloadKind,
+        body: await prepareFernSdkGenApiRuntimeBundle({
+          apiName: getOriginalName(ir3.apiName),
+          organization,
+          generatorInvocation: sdkGenApiCandidate.generatorInvocation,
+          sdkVersion: sdkGenApiCandidate.sdkVersion,
+          intermediateRepresentation: enrichedIntermediateRepresentation,
+          irVersionOverride,
+          generateOauthClients,
+          generatePaginatedClients,
+          context: interactiveTaskContext
+        })
+      },
       absolutePathToPreview,
       context: interactiveTaskContext,
       targetIdSeed: sdkGenApiTargetIdSeed,
+      sourceSpecIndexes: sdkGenApiSourceArchive?.specIndexes,
       audiences: audiences.type === "select" ? audiences.audiences : void 0,
       skipFernignore
     };
     result = await (sdkGenApiBatch?.run(parameters2) ?? runFernSdkGenApiBuild(parameters2));
-    usedSdkGenApi = true;
   } else {
-    sdkGenApiBatch?.skip();
-  }
-  if (!usedSdkGenApi) {
     const job = await createAndStartJob({
       projectConfig,
       workspace,
       organization,
-      generatorInvocation: generatorInvocationWithEnvVarSubstitutions,
+      generatorInvocation,
       context: interactiveTaskContext,
       version: resolvedVersion,
       intermediateRepresentation: enrichedIntermediateRepresentation,
       shouldLogS3Url,
       token,
-      whitelabel: whitelabel != null ? substituteEnvVars(whitelabel) : void 0,
+      whitelabel: resolvedWhitelabel,
       replay,
       irVersionOverride,
       absolutePathToPreview,
@@ -911579,10 +911993,51 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
     effectiveOccurrenceTracker.recordOccurrences(generatorGroup.generators);
   }
   const generatorsYmlAbsolutePath = workspace.generatorsConfiguration?.absolutePathToConfiguration;
-  const sdkGenApiCandidateIndexes = new Set(isFernSdkGenApiEnabled() ? generatorGroup.generators.flatMap((generator, index3) => getFernSdkGenApiLanguage(generator.name) != null ? [index3] : []) : []);
+  const routePreparation = prepareFernSdkGenApiRoutes({
+    generators: generatorGroup.generators,
+    enabled: isFernSdkGenApiEnabled(),
+    requireEnvVars,
+    isPreview: isPreview ?? absolutePathToPreview != null,
+    verify: verify2,
+    skipIfNoDiff,
+    autoMerge
+  });
+  const sdkGenApiRoutes = routePreparation.map((result) => result.route);
+  const resolvedGenerators = routePreparation.map((result) => result.generatorInvocation);
+  const routeErrors = routePreparation.map((result) => result.error);
+  if (automation == null) {
+    throwFirstPreflightError(routeErrors, generatorGroup.generators);
+  }
+  const sourceRequests = resolvedGenerators.flatMap((generatorInvocation, generatorIndex) => routePreparation[generatorIndex]?.error == null ? [{ generatorIndex, generatorInvocation, sdkGenApiRoute: sdkGenApiRoutes[generatorIndex] }] : []);
+  let sourceResolution = { sourceArchives: /* @__PURE__ */ new Map(), errors: /* @__PURE__ */ new Map() };
+  if (sourceRequests.length > 0) {
+    try {
+      sourceResolution = await getSpecsTarGzBuffer?.(sourceRequests) ?? sourceResolution;
+    } catch (error50) {
+      sourceResolution = {
+        sourceArchives: /* @__PURE__ */ new Map(),
+        errors: new Map(sourceRequests.map((request7) => [request7.generatorIndex, error50]))
+      };
+    }
+  }
+  const sourcePreflight = preflightFernSdkGenApiSources({
+    generators: resolvedGenerators,
+    routes: sdkGenApiRoutes,
+    routeErrors,
+    sourceResolution
+  });
+  const sourceArchives = sourcePreflight.sourceArchives;
+  const preflightErrors = routePreparation.map((result, index3) => result.error ?? sourcePreflight.preflightErrors[index3]);
+  if (automation == null) {
+    throwFirstPreflightError(preflightErrors, generatorGroup.generators);
+  }
+  const sdkGenApiCandidateIndexes = getFernSdkGenApiCandidateIndexes(sdkGenApiRoutes, preflightErrors);
+  validateFernSdkGenApiTargetCount(sdkGenApiCandidateIndexes.size);
   const sdkGenApiBatch = sdkGenApiCandidateIndexes.size > 1 ? new FernSdkGenApiBatch(sdkGenApiCandidateIndexes.size) : void 0;
+  const sdkGenApiPreparationBatch = sdkGenApiCandidateIndexes.size > 0 ? new FernSdkGenApiPreparationBatch([...sdkGenApiCandidateIndexes].map(String)) : void 0;
   const results = await Promise.all(generatorGroup.generators.map((generatorInvocation, generatorIndex) => context3.runInteractiveTask({ name: generatorInvocation.name }, (interactiveTaskContext) => generateOne({
     generatorInvocation,
+    resolvedGeneratorInvocation: resolvedGenerators[generatorIndex] ?? generatorInvocation,
     interactiveTaskContext,
     // Closed-over state + params passed through to the per-generator worker.
     projectConfig,
@@ -911616,7 +912071,10 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
     generatorsYmlAbsolutePath,
     occurrenceTracker: effectiveOccurrenceTracker,
     loginCommand,
-    getSpecsTarGzBuffer,
+    specsTarGzArchive: sourceArchives[generatorIndex],
+    sdkGenApiPreflightError: preflightErrors[generatorIndex],
+    sdkGenApiRoute: sdkGenApiRoutes[generatorIndex],
+    sdkGenApiPreparationBatch: sdkGenApiCandidateIndexes.has(generatorIndex) ? sdkGenApiPreparationBatch : void 0,
     sdkGenApiBatch: sdkGenApiCandidateIndexes.has(generatorIndex) ? sdkGenApiBatch : void 0,
     sdkGenApiTargetIdSeed: generatorIndex.toString(),
     generateFullProject,
@@ -911629,11 +912087,105 @@ 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, getSpecsTarGzBuffer, sdkGenApiBatch, sdkGenApiTargetIdSeed, generateFullProject, onSnippetsProduced }) {
+function prepareFernSdkGenApiRoutes({ generators, enabled, requireEnvVars, isPreview, verify: verify2, skipIfNoDiff, autoMerge }) {
+  return generators.map((generatorInvocation) => {
+    let resolved = generatorInvocation;
+    try {
+      resolved = replaceEnvVariables(generatorInvocation, {
+        onError: (error50) => {
+          if (!isPreview && requireEnvVars) {
+            throw error50;
+          }
+        }
+      }, { substituteAsEmpty: isPreview });
+      const route = selectFernSdkGenApiRoute(resolved);
+      if (!enabled) {
+        return { generatorInvocation: resolved, route: void 0, error: void 0 };
+      }
+      const unsupportedOutput = getFernSdkGenApiUnsupportedOutput({
+        generatorInvocation: resolved,
+        verify: verify2,
+        skipIfNoDiff,
+        autoMerge
+      });
+      if (route != null && unsupportedOutput != null) {
+        if (route.configKind === "legacy-fern") {
+          return { generatorInvocation: resolved, route: void 0, error: void 0 };
+        }
+        throw new Error(`Cannot route ${resolved.name} ${resolved.version} through sdk-gen-api: ${unsupportedOutput}. This generator version requires SDK Config v1, so Fern cannot fall back to legacy Fiddle generation.`);
+      }
+      return {
+        generatorInvocation: resolved,
+        route,
+        error: void 0
+      };
+    } catch (error50) {
+      if (!enabled && error50 instanceof GeneratorConfigCompatibilityError && error50.code === "INVALID_GENERATOR_VERSION") {
+        return { generatorInvocation: resolved, route: void 0, error: void 0 };
+      }
+      const routeError = error50 instanceof GeneratorConfigCompatibilityError ? new CliError({
+        message: formatGeneratorConfigCompatibilityError(error50),
+        code: CliError.Code.ConfigError
+      }) : error50;
+      return { generatorInvocation: resolved, route: void 0, error: routeError };
+    }
+  });
+}
+function getFernSdkGenApiUnsupportedOutput({ generatorInvocation, verify: verify2, skipIfNoDiff, autoMerge }) {
+  const unsupported = [];
+  if (generatorInvocation.outputMode.type !== "downloadFiles") {
+    unsupported.push(`${generatorInvocation.outputMode.type} delivery requires Fern-managed GitHub or registry credentials that sdk-gen-api cannot resolve`);
+  }
+  if (verify2 === true) {
+    unsupported.push("verify=true is not implemented by sdk-gen-api");
+  }
+  if (skipIfNoDiff === true) {
+    unsupported.push("skipIfNoDiff=true is not implemented by sdk-gen-api");
+  }
+  if (autoMerge === true) {
+    unsupported.push("autoMerge=true is not implemented by sdk-gen-api");
+  }
+  return unsupported.length > 0 ? unsupported.join("; ") : void 0;
+}
+function preflightFernSdkGenApiSources({ generators, routes, routeErrors, sourceResolution }) {
+  return {
+    sourceArchives: generators.map((_5, index3) => sourceResolution.sourceArchives.get(index3)),
+    preflightErrors: generators.map((_5, index3) => {
+      if (routeErrors?.[index3] != null) {
+        return void 0;
+      }
+      const route = routes[index3];
+      if (route == null) {
+        return void 0;
+      }
+      const sourceError = sourceResolution.errors.get(index3);
+      if (sourceError != null) {
+        return sourceError;
+      }
+      const sourceArchive = sourceResolution.sourceArchives.get(index3);
+      if (sourceArchive == null) {
+        return new Error(`Resolved source archive is unavailable for ${route.generatorId}`);
+      }
+      try {
+        validateFernSdkGenApiSourceCompatibility(route, sourceArchive);
+        return void 0;
+      } catch (error50) {
+        return error50;
+      }
+    })
+  };
+}
+function getFernSdkGenApiCandidateIndexes(routes, preflightErrors) {
+  return new Set(routes.flatMap((route, index3) => route != null && preflightErrors[index3] == null ? [index3] : []));
+}
+async function generateOne({ generatorInvocation, resolvedGeneratorInvocation, 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, specsTarGzArchive, sdkGenApiPreflightError, sdkGenApiRoute, sdkGenApiPreparationBatch, sdkGenApiBatch, sdkGenApiTargetIdSeed, generateFullProject, onSnippetsProduced }) {
   const startedAt = Date.now();
   try {
-    const settings = getBaseOpenAPIWorkspaceSettingsFromGeneratorInvocation(generatorInvocation);
-    const fernWorkspace = await workspace.toFernWorkspace({ context: context3 }, settings, generatorInvocation.apiOverride?.specs);
+    if (sdkGenApiPreflightError != null) {
+      throw sdkGenApiPreflightError;
+    }
+    const settings = getBaseOpenAPIWorkspaceSettingsFromGeneratorInvocation(resolvedGeneratorInvocation);
+    const fernWorkspace = await workspace.toFernWorkspace({ context: context3 }, settings, resolvedGeneratorInvocation.apiOverride?.specs);
     if (validateWorkspace) {
       await validateAPIWorkspaceAndLogIssues({
         workspace: fernWorkspace,
@@ -911643,7 +912195,7 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
       });
     }
     const effectiveFernignorePath = skipFernignore ? void 0 : fernignorePath ?? await resolveAutoDiscoveredFernignorePath({
-      generatorInvocation,
+      generatorInvocation: resolvedGeneratorInvocation,
       context: interactiveTaskContext
     });
     const remoteTaskHandlerResponse = await runRemoteGenerationForGenerator({
@@ -911652,9 +912204,9 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
       workspace: fernWorkspace,
       interactiveTaskContext,
       generatorInvocation: {
-        ...generatorInvocation,
-        outputMode: generatorInvocation.outputMode._visit({
-          downloadFiles: () => generatorInvocation.outputMode,
+        ...resolvedGeneratorInvocation,
+        outputMode: resolvedGeneratorInvocation.outputMode._visit({
+          downloadFiles: () => resolvedGeneratorInvocation.outputMode,
           github: (val) => {
             return api_exports4.OutputMode.github({
               ...val,
@@ -911665,11 +912217,11 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
             if (mode === "pull-request") {
               return api_exports4.OutputMode.githubV2(api_exports4.GithubOutputModeV2.pullRequest(val));
             }
-            return generatorInvocation.outputMode;
+            return resolvedGeneratorInvocation.outputMode;
           },
-          publish: () => generatorInvocation.outputMode,
-          publishV2: () => generatorInvocation.outputMode,
-          _other: () => generatorInvocation.outputMode
+          publish: () => resolvedGeneratorInvocation.outputMode,
+          publishV2: () => resolvedGeneratorInvocation.outputMode,
+          _other: () => resolvedGeneratorInvocation.outputMode
         })
       },
       version: version7,
@@ -911678,8 +912230,8 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
       token,
       whitelabel,
       replay,
-      readme: generatorInvocation.readme,
-      irVersionOverride: generatorInvocation.irVersionOverride,
+      readme: resolvedGeneratorInvocation.readme,
+      irVersionOverride: resolvedGeneratorInvocation.irVersionOverride,
       absolutePathToPreview,
       isPreview,
       fiddlePreview,
@@ -911696,7 +912248,10 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
       noReplay,
       disableTelemetry,
       loginCommand,
-      specsTarGzBuffer: await getSpecsTarGzBuffer?.(generatorInvocation.name),
+      specsTarGzBuffer: specsTarGzArchive?.buffer,
+      sdkGenApiSourceArchive: specsTarGzArchive,
+      sdkGenApiRoute,
+      sdkGenApiPreparationBatch,
       sdkGenApiBatch,
       sdkGenApiTargetIdSeed,
       generateFullProject
@@ -911738,7 +912293,12 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
       isAutomation: automation != null
     });
   } catch (error50) {
-    sdkGenApiBatch?.cancel(error50);
+    sdkGenApiPreparationBatch?.fail(sdkGenApiTargetIdSeed, error50, automation != null);
+    if (automation != null) {
+      sdkGenApiBatch?.remove(sdkGenApiTargetIdSeed, error50);
+    } else {
+      sdkGenApiBatch?.cancel(error50);
+    }
     if (automation == null) {
       throw error50;
     }
@@ -911773,6 +912333,17 @@ async function generateOne({ generatorInvocation, interactiveTaskContext, projec
     });
   }
 }
+function throwFirstPreflightError(errors4, generators) {
+  const failedIndex = errors4.findIndex((error51) => error51 != null);
+  if (failedIndex < 0) {
+    return;
+  }
+  const error50 = errors4[failedIndex];
+  if (error50 instanceof CliError) {
+    throw error50;
+  }
+  throw new Error(`Cannot prepare sdk-gen-api target ${generators[failedIndex]?.name ?? failedIndex.toString()}: ${extractErrorMessage(error50)}`, { cause: error50 });
+}
 async function emitGenerationAnnotations(ctx) {
   if (!shouldEmitGithubAnnotations()) {
     return;
@@ -914005,7 +914576,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-2060-gef10ff1af19",
+        cliVersion: "5.23.3-2069-g46cdcdac844",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -930482,16 +931053,16 @@ var TestClass = class extends Node5 {
 };
 
 // ../../../generators/csharp/codegen/lib/context/filesystem-nuget-publish-target.js
-function isRecord2(value2) {
+function isRecord3(value2) {
   return typeof value2 === "object" && value2 != null;
 }
 function getFilesystemNugetPublishTarget(ir3) {
   const publishConfig = ir3.publishConfig;
-  if (!isRecord2(publishConfig) || publishConfig.type !== "filesystem") {
+  if (!isRecord3(publishConfig) || publishConfig.type !== "filesystem") {
     return void 0;
   }
   const publishTarget = publishConfig.publishTarget;
-  if (!isRecord2(publishTarget) || publishTarget.type !== "nuget") {
+  if (!isRecord3(publishTarget) || publishTarget.type !== "nuget") {
     return void 0;
   }
   return {
@@ -968300,6 +968871,8 @@ async function copySnippetJsonIfNonEmpty({ src, dest }) {
 }
 
 // ../generation/local-generation/local-workspace-runner/lib/rawSpecs.js
+var import_node_util10 = require("util");
+init_lib17();
 init_lib4();
 init_lib8();
 init_lib35();
@@ -968342,7 +968915,14 @@ async function collectRawSpecs({ specs, hostOutputDir, containerBaseDir, context
 async function resolveAndWriteSpec({ spec, hostOutputDir, containerBaseDir, context: context3, index: index3, audiences }) {
   switch (spec.type) {
     case "openapi":
-      return resolveOpenAPIOrAsyncAPI({ spec, hostOutputDir, containerBaseDir, context: context3, index: index3, audiences });
+      return resolveOpenAPIOrAsyncAPI({
+        spec,
+        hostOutputDir,
+        containerBaseDir,
+        context: context3,
+        index: index3,
+        audiences
+      });
     case "openrpc":
       return resolveOpenRPC({ spec, hostOutputDir, containerBaseDir, context: context3, index: index3 });
     case "protobuf":
@@ -968377,9 +968957,41 @@ async function resolveOpenAPIOrAsyncAPI({ spec, hostOutputDir, containerBaseDir,
   return {
     type: isAsync2 ? "asyncapi" : "openapi",
     specPath: toContainerPath(filename, containerBaseDir),
-    namespace: spec.namespace
+    namespace: spec.namespace,
+    apiImportSettings: mapApiImportSettings(getOpenAPISettings({ overrides: spec.settings }))
   };
 }
+var SDK_CONFIG_IMPORT_SETTING_MAPPERS = {
+  respectNullableSchemas: (settings) => ({ respectNullableSchemas: settings.respectNullableSchemas }),
+  useTitlesAsName: (settings) => ({ titleAsSchemaName: settings.useTitlesAsName }),
+  coerceEnumsToLiterals: (settings) => ({ coerceEnumsToLiterals: settings.coerceEnumsToLiterals }),
+  shouldUseIdiomaticRequestNames: (settings) => ({
+    idiomaticRequestNames: settings.shouldUseIdiomaticRequestNames
+  }),
+  wrapReferencesToNullableInOptional: (settings) => ({
+    wrapReferencesToNullableInOptional: settings.wrapReferencesToNullableInOptional
+  }),
+  coerceOptionalSchemasToNullable: (settings) => ({
+    coerceOptionalSchemasToNullable: settings.coerceOptionalSchemasToNullable
+  }),
+  pathParameterOrder: (settings) => ({ pathParameterOrder: settings.pathParameterOrder }),
+  onlyIncludeReferencedSchemas: (settings) => ({
+    onlyIncludeReferencedSchemas: settings.onlyIncludeReferencedSchemas
+  }),
+  objectQueryParameters: (settings) => ({ objectQueryParameters: settings.objectQueryParameters }),
+  typeDatesAsStrings: (settings) => ({ typeDatesAsStrings: settings.typeDatesAsStrings }),
+  groupMultiApiEnvironments: (settings) => ({
+    groupMultiApiEnvironments: settings.groupMultiApiEnvironments
+  }),
+  defaultIntegerFormat: (settings) => ({ defaultIntegerFormat: settings.defaultIntegerFormat })
+};
+function mapApiImportSettings(settings) {
+  const mappedSettings = {};
+  for (const mapSetting of Object.values(SDK_CONFIG_IMPORT_SETTING_MAPPERS)) {
+    Object.assign(mappedSettings, mapSetting(settings));
+  }
+  return mappedSettings;
+}
 async function resolveOpenRPC({ spec, hostOutputDir, containerBaseDir, context: context3, index: index3 }) {
   const filename = `openrpc${index3}.json`;
   const rawContent = await (0, import_promises143.readFile)(spec.absoluteFilepath, "utf-8");
@@ -968553,30 +969165,318 @@ function matchesAudiences(operation, selectedAudiences) {
 function hasOperations(pathItem) {
   return Object.keys(pathItem).some((key2) => HTTP_METHODS3.has(key2.toLowerCase()));
 }
-async function createSpecsTarGzBuffer({ specs, context: context3, audiences }) {
+async function createGroupedSpecsTarGzArchiveSettled({ generatorSelections, context: context3, audiences }) {
+  const deduplicated = deduplicateGeneratorSelections(generatorSelections);
+  const errorsByGeneratorIndex = /* @__PURE__ */ new Map();
   const tmpDir = await import_tmp_promise17.default.dir({ unsafeCleanup: true });
   try {
+    const materializedRoot = import_path99.default.join(tmpDir.path, "materialized");
+    await (0, import_promises143.mkdir)(materializedRoot);
+    const materializedSpecs = await Promise.allSettled(deduplicated.uniqueSpecs.map(async (spec, uniqueSpecIndex) => {
+      const directory = import_path99.default.join(materializedRoot, uniqueSpecIndex.toString());
+      await (0, import_promises143.mkdir)(directory);
+      const manifest = await collectRawSpecs({
+        specs: [spec],
+        hostOutputDir: AbsoluteFilePath2.of(directory),
+        containerBaseDir: "/fern/specs",
+        context: context3,
+        audiences
+      });
+      const manifestEntry = manifest.specs[0];
+      if (manifestEntry == null) {
+        throw new Error(`Materialized source ${uniqueSpecIndex} did not produce a manifest entry`);
+      }
+      return { directory, manifestEntry };
+    }));
+    materializedSpecs.forEach((result, uniqueSpecIndex) => {
+      if (result.status === "fulfilled") {
+        return;
+      }
+      for (const generatorIndex of deduplicated.generatorIndexesByUniqueSpecIndex[uniqueSpecIndex] ?? []) {
+        if (!errorsByGeneratorIndex.has(generatorIndex)) {
+          errorsByGeneratorIndex.set(generatorIndex, result.reason);
+        }
+      }
+    });
+    const successfulGeneratorIndexes = new Set(generatorSelections.map((selection) => selection.generatorIndex).filter((generatorIndex) => !errorsByGeneratorIndex.has(generatorIndex)));
+    if (successfulGeneratorIndexes.size === 0) {
+      return { archive: void 0, errorsByGeneratorIndex };
+    }
+    try {
+      const archive3 = await createArchiveFromMaterializedSpecs({
+        materializedSpecs,
+        deduplicated,
+        successfulGeneratorIndexes,
+        root: tmpDir.path
+      });
+      assertGeneratorSelectionOutcomes({ generatorSelections, archive: archive3, errorsByGeneratorIndex });
+      return { archive: archive3, errorsByGeneratorIndex };
+    } catch (error50) {
+      for (const generatorIndex of successfulGeneratorIndexes) {
+        errorsByGeneratorIndex.set(generatorIndex, error50);
+      }
+      return { archive: void 0, errorsByGeneratorIndex };
+    }
+  } finally {
+    await tmpDir.cleanup();
+  }
+}
+function deduplicateGeneratorSelections(generatorSelections) {
+  const uniqueSpecs = [];
+  const indexesBySpecKey = /* @__PURE__ */ new Map();
+  const uniqueSpecIndexesByGeneratorIndex = /* @__PURE__ */ new Map();
+  const generatorIndexesByUniqueSpecIndex = [];
+  const orderedSelections = [...generatorSelections].sort((left3, right3) => left3.generatorIndex - right3.generatorIndex);
+  for (const selection of orderedSelections) {
+    if (uniqueSpecIndexesByGeneratorIndex.has(selection.generatorIndex)) {
+      throw new Error(`Duplicate source selection for generator index ${selection.generatorIndex}`);
+    }
+    const indexes = selection.specs.map((spec) => {
+      const key2 = createSpecDeduplicationKey(spec);
+      const existingIndex = indexesBySpecKey.get(key2);
+      if (existingIndex != null) {
+        return existingIndex;
+      }
+      const index3 = uniqueSpecs.length;
+      uniqueSpecs.push(spec);
+      indexesBySpecKey.set(key2, index3);
+      generatorIndexesByUniqueSpecIndex[index3] = /* @__PURE__ */ new Set();
+      return index3;
+    });
+    for (const index3 of new Set(indexes)) {
+      generatorIndexesByUniqueSpecIndex[index3]?.add(selection.generatorIndex);
+    }
+    uniqueSpecIndexesByGeneratorIndex.set(selection.generatorIndex, [...new Set(indexes)]);
+  }
+  return { uniqueSpecs, uniqueSpecIndexesByGeneratorIndex, generatorIndexesByUniqueSpecIndex };
+}
+async function createArchiveFromMaterializedSpecs({ materializedSpecs, deduplicated, successfulGeneratorIndexes, root: root6 }) {
+  const contentDirectory = import_path99.default.join(root6, "content");
+  await (0, import_promises143.mkdir)(contentDirectory);
+  const manifest = { specs: [] };
+  const archiveSpecIndexByUniqueSpecIndex = /* @__PURE__ */ new Map();
+  const typeCounters = /* @__PURE__ */ new Map();
+  for (const [uniqueSpecIndex, generatorIndexes] of deduplicated.generatorIndexesByUniqueSpecIndex.entries()) {
+    if (![...generatorIndexes].some((generatorIndex) => successfulGeneratorIndexes.has(generatorIndex))) {
+      continue;
+    }
+    const materialized = materializedSpecs[uniqueSpecIndex];
+    if (materialized?.status !== "fulfilled") {
+      throw new Error(`Successful generator references source ${uniqueSpecIndex}, which was not materialized`);
+    }
+    const type7 = materialized.value.manifestEntry.type;
+    const typeIndex = typeCounters.get(type7) ?? 0;
+    typeCounters.set(type7, typeIndex + 1);
+    const manifestEntry = await copyMaterializedSpec({
+      materialized: materialized.value,
+      contentDirectory,
+      typeIndex
+    });
+    archiveSpecIndexByUniqueSpecIndex.set(uniqueSpecIndex, manifest.specs.length);
+    manifest.specs.push(manifestEntry);
+  }
+  const specIndexesByGeneratorIndex = /* @__PURE__ */ new Map();
+  for (const [generatorIndex, uniqueSpecIndexes] of deduplicated.uniqueSpecIndexesByGeneratorIndex) {
+    if (!successfulGeneratorIndexes.has(generatorIndex)) {
+      continue;
+    }
+    specIndexesByGeneratorIndex.set(generatorIndex, uniqueSpecIndexes.map((uniqueSpecIndex) => {
+      const archiveSpecIndex = archiveSpecIndexByUniqueSpecIndex.get(uniqueSpecIndex);
+      if (archiveSpecIndex == null) {
+        throw new Error(`Source ${uniqueSpecIndex} is unavailable for generator index ${generatorIndex}`);
+      }
+      return archiveSpecIndex;
+    }));
+  }
+  const archive3 = await createArchiveFromDirectory({
+    contentDirectory,
+    tarGzPath: import_path99.default.join(root6, "specs.tar.gz"),
+    manifest
+  });
+  return { ...archive3, specIndexesByGeneratorIndex };
+}
+async function copyMaterializedSpec({ materialized, contentDirectory, typeIndex }) {
+  const sourcePrefix = `${materialized.manifestEntry.type}0`;
+  const targetPrefix = `${materialized.manifestEntry.type}${typeIndex}`;
+  assertSupportedMaterializedManifestEntry(materialized.manifestEntry);
+  for (const entry of await (0, import_promises143.readdir)(materialized.directory, { withFileTypes: true })) {
+    if (!hasSourcePrefix(entry.name) || !entry.isFile() && !entry.isDirectory()) {
+      throw new Error(`Unsupported materialized source entry: ${entry.name}`);
+    }
+    await (0, import_promises143.cp)(import_path99.default.join(materialized.directory, entry.name), import_path99.default.join(contentDirectory, replacePrefix(entry.name)), {
+      recursive: entry.isDirectory()
+    });
+  }
+  return {
+    ...materialized.manifestEntry,
+    specPath: replaceContainerPathPrefix(materialized.manifestEntry.specPath),
+    ...materialized.manifestEntry.overridePaths == null ? {} : {
+      overridePaths: materialized.manifestEntry.overridePaths.map(replaceContainerPathPrefix)
+    }
+  };
+  function replacePrefix(value2) {
+    return `${targetPrefix}${value2.slice(sourcePrefix.length)}`;
+  }
+  function hasSourcePrefix(value2) {
+    return value2 === sourcePrefix || value2.startsWith(`${sourcePrefix}.`) || value2.startsWith(`${sourcePrefix}-`);
+  }
+  function replaceContainerPathPrefix(value2) {
+    const basename8 = import_path99.default.posix.basename(value2);
+    if (!hasSourcePrefix(basename8)) {
+      throw new Error(`Unexpected materialized source path: ${value2}`);
+    }
+    return import_path99.default.posix.join(import_path99.default.posix.dirname(value2), replacePrefix(basename8));
+  }
+}
+var SUPPORTED_MATERIALIZED_MANIFEST_ENTRY_KEYS = /* @__PURE__ */ new Set([
+  "type",
+  "specPath",
+  "overridePaths",
+  "namespace",
+  "apiImportSettings"
+]);
+function assertSupportedMaterializedManifestEntry(entry) {
+  for (const key2 of Object.keys(entry)) {
+    if (!SUPPORTED_MATERIALIZED_MANIFEST_ENTRY_KEYS.has(key2)) {
+      throw new Error(`Unsupported materialized manifest entry field: ${key2}`);
+    }
+  }
+}
+function assertGeneratorSelectionOutcomes({ generatorSelections, archive: archive3, errorsByGeneratorIndex }) {
+  for (const { generatorIndex } of generatorSelections) {
+    const hasArchive = archive3.specIndexesByGeneratorIndex.has(generatorIndex);
+    const hasError = errorsByGeneratorIndex.has(generatorIndex);
+    if (hasArchive === hasError) {
+      throw new Error(`Generator index ${generatorIndex} must have exactly one source archive or materialization error outcome`);
+    }
+  }
+}
+var SDK_CONFIG_IMPORT_SETTING_KEYS = new Set(Object.keys(SDK_CONFIG_IMPORT_SETTING_MAPPERS));
+var DEFAULT_OPENAPI_SETTINGS = getOpenAPISettings();
+function validateSdkConfigImportSettings(specs) {
+  for (const spec of specs) {
+    if (spec.type !== "openapi") {
+      continue;
+    }
+    const settings = getOpenAPISettings({ overrides: spec.settings });
+    for (const key2 of Object.getOwnPropertyNames(settings)) {
+      const value2 = Reflect.get(settings, key2);
+      if (SDK_CONFIG_IMPORT_SETTING_KEYS.has(key2) || key2 === "audiences" && Array.isArray(value2) && value2.length === 0 || (0, import_node_util10.isDeepStrictEqual)(value2, Reflect.get(DEFAULT_OPENAPI_SETTINGS, key2))) {
+        continue;
+      }
+      throw new Error(`SDK Config v1 cannot preserve effective OpenAPI import setting ${key2}=${JSON.stringify(value2)} for ${spec.absoluteFilepath}. Remove that setting or use a pre-cutover generator version until the shared SDK Config contract supports it.`);
+    }
+  }
+}
+async function createSpecsTarGzArchive({ specs, context: context3, audiences }) {
+  const tmpDir = await import_tmp_promise17.default.dir({ unsafeCleanup: true });
+  try {
+    const contentDirectory = import_path99.default.join(tmpDir.path, "content");
+    await (0, import_promises143.mkdir)(contentDirectory);
     const manifest = await collectRawSpecs({
       specs,
-      hostOutputDir: AbsoluteFilePath2.of(tmpDir.path),
+      hostOutputDir: AbsoluteFilePath2.of(contentDirectory),
       containerBaseDir: "/fern/specs",
       context: context3,
       audiences
     });
-    await (0, import_promises143.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 Kn({
-      gzip: true,
-      cwd: tmpDir.path,
-      file: tarGzPath,
-      portable: true,
-      filter: (entryPath) => entryPath !== "./specs.tar.gz"
-    }, ["."]);
-    return await (0, import_promises143.readFile)(tarGzPath);
+    return await createArchiveFromDirectory({
+      contentDirectory,
+      tarGzPath: import_path99.default.join(tmpDir.path, "specs.tar.gz"),
+      manifest
+    });
   } finally {
     await tmpDir.cleanup();
   }
 }
+async function createArchiveFromDirectory({ contentDirectory, tarGzPath, manifest }) {
+  await (0, import_promises143.writeFile)(join8(AbsoluteFilePath2.of(contentDirectory), RelativeFilePath2.of(SPECS_MANIFEST_FILENAME)), JSON.stringify(manifest, void 0, 4));
+  const archiveEntries = await listDeterministicArchiveEntries(contentDirectory);
+  await Kn({
+    gzip: true,
+    cwd: contentDirectory,
+    file: tarGzPath,
+    portable: true,
+    mtime: /* @__PURE__ */ new Date(0),
+    onWriteEntry: (entry) => {
+      if (entry.stat != null) {
+        entry.stat.mode = 420;
+      }
+    }
+  }, archiveEntries);
+  return { buffer: await (0, import_promises143.readFile)(tarGzPath), manifest };
+}
+async function listDeterministicArchiveEntries(root6, relativeDirectory = "") {
+  const absoluteDirectory = relativeDirectory === "" ? root6 : import_path99.default.join(root6, ...relativeDirectory.split(import_path99.default.posix.sep));
+  const directoryEntries = await (0, import_promises143.readdir)(absoluteDirectory, { withFileTypes: true });
+  const archiveEntries = [];
+  for (const entry of directoryEntries.sort((left3, right3) => compareStrings(left3.name, right3.name))) {
+    const relativePath = import_path99.default.posix.join(relativeDirectory, entry.name);
+    if (entry.isDirectory()) {
+      archiveEntries.push(...await listDeterministicArchiveEntries(root6, relativePath));
+      continue;
+    }
+    if (!entry.isFile()) {
+      throw new Error(`Unsupported generated source archive entry: ${relativePath}`);
+    }
+    archiveEntries.push(relativePath);
+  }
+  return archiveEntries;
+}
+function compareStrings(left3, right3) {
+  return left3 < right3 ? -1 : left3 > right3 ? 1 : 0;
+}
+function createSpecDeduplicationKey(spec) {
+  switch (spec.type) {
+    case "openapi":
+      return stableStringify3({
+        type: spec.type,
+        path: spec.absoluteFilepath,
+        overrides: normalizeOverrides(spec.absoluteFilepathToOverrides),
+        overlay: spec.absoluteFilepathToOverlays,
+        namespace: spec.namespace,
+        settings: getOpenAPISettings({ overrides: spec.settings })
+      });
+    case "openrpc":
+      return stableStringify3({
+        type: spec.type,
+        path: spec.absoluteFilepath,
+        overrides: normalizeOverrides(spec.absoluteFilepathToOverrides),
+        namespace: spec.namespace
+      });
+    case "protobuf":
+      return stableStringify3({
+        type: spec.type,
+        root: spec.absoluteFilepathToProtobufRoot,
+        target: spec.absoluteFilepathToProtobufTarget,
+        overrides: normalizeOverrides(spec.absoluteFilepathToOverrides),
+        dependencies: spec.dependencies,
+        settings: getOpenAPISettings({ overrides: spec.settings })
+      });
+    case "graphql":
+      return stableStringify3({
+        type: spec.type,
+        path: spec.absoluteFilepath,
+        overrides: normalizeOverrides(spec.absoluteFilepathToOverrides),
+        examples: spec.absoluteFilepathToExamples,
+        namespace: spec.namespace
+      });
+    default:
+      assertNever(spec);
+  }
+}
+function stableStringify3(value2) {
+  return JSON.stringify(sortJsonValue(value2));
+}
+function sortJsonValue(value2) {
+  if (Array.isArray(value2)) {
+    return value2.map(sortJsonValue);
+  }
+  if (value2 == null || typeof value2 !== "object") {
+    return value2;
+  }
+  return Object.fromEntries(Object.entries(value2).sort(([left3], [right3]) => compareStrings(left3, right3)).map(([key2, child]) => [key2, sortJsonValue(child)]));
+}
 
 // ../generation/local-generation/local-workspace-runner/lib/runGenerator.js
 function extractLicenseFilePath(generatorInvocation, absolutePathToFernConfig) {
@@ -973180,11 +974080,11 @@ function getFirstUrlSegment({ path: path122 }) {
 }
 
 // ../docs-importers/mintlify/lib/MintlifyImporter.js
-function isRecord3(value2) {
+function isRecord4(value2) {
   return typeof value2 === "object" && value2 != null && !Array.isArray(value2);
 }
 function hasNavigationArray(value2) {
-  return isRecord3(value2) && Array.isArray(value2.navigation);
+  return isRecord4(value2) && Array.isArray(value2.navigation);
 }
 var MintlifyImporter = class extends DocsImporter {
   documentationTab = void 0;
@@ -979476,7 +980376,7 @@ var {
 } = signalExitWrap(processOk(process21) ? new SignalExit(process21) : new SignalExitFallback());
 
 // ../../../node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.17/node_modules/@inquirer/core/dist/esm/lib/screen-manager.js
-var import_node_util10 = require("util");
+var import_node_util11 = require("util");
 
 // ../../../node_modules/.pnpm/@inquirer+ansi@1.0.2/node_modules/@inquirer/ansi/dist/esm/index.js
 var ESC2 = "\x1B[";
@@ -979514,7 +980414,7 @@ var ScreenManager2 = class {
   }
   render(content5, bottomContent = "") {
     const promptLine = lastLine2(content5);
-    const rawPromptLine = (0, import_node_util10.stripVTControlCharacters)(promptLine);
+    const rawPromptLine = (0, import_node_util11.stripVTControlCharacters)(promptLine);
     let prompt2 = rawPromptLine;
     if (this.rl.line.length > 0) {
       prompt2 = prompt2.slice(0, -this.rl.line.length);
@@ -980925,7 +981825,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.23.3-2060-gef10ff1af19"
+    cli_version: "5.23.3-2069-g46cdcdac844"
   };
 }
 function isAutomationMode() {
@@ -981757,7 +982657,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-2060-gef10ff1af19";
+    return "5.23.3-2069-g46cdcdac844";
   }
   getCliName() {
     if (false) {
@@ -983400,18 +984300,118 @@ function expandGroupFilter(groupNames, generatorsConfiguration) {
 // src/commands/generate/generateAPIWorkspace.ts
 init_lib20();
 init_lib8();
-init_lib35();
 init_lib6();
 init_esm18();
 
-// src/commands/generate/createSpecsTarGzCache.ts
-function createSpecsTarGzCache(createArchive) {
-  let archivePromise;
-  return () => {
-    archivePromise ??= createArchive();
-    return archivePromise;
+// src/commands/generate/createFernSourceArchiveResolver.ts
+init_lib35();
+function createFernSourceArchiveResolver({
+  workspace,
+  context: context3,
+  group
+}) {
+  return async (requests3) => {
+    const sourceArchives = /* @__PURE__ */ new Map();
+    const errors4 = /* @__PURE__ */ new Map();
+    if (!(workspace instanceof OSSWorkspace)) {
+      for (const request7 of requests3) {
+        if (requestRequiresSourceArchive(request7)) {
+          errors4.set(
+            request7.generatorIndex,
+            new Error(
+              `Generator index ${request7.generatorIndex} (${request7.generatorInvocation.name}) requires a source archive, but workspace type ${workspace.type} does not expose source specs`
+            )
+          );
+        }
+      }
+      return { sourceArchives, errors: errors4 };
+    }
+    const settledSelections = await Promise.allSettled(
+      requests3.map(async (request7) => {
+        if (request7.sdkGenApiRoute == null) {
+          return void 0;
+        }
+        const specs = await workspace.getAllSpecsForGenerator(request7.generatorInvocation.apiOverride?.specs);
+        if (request7.sdkGenApiRoute.payloadKind === "sdk-config-v1") {
+          validateSdkConfigImportSettings(specs);
+        }
+        return specs;
+      })
+    );
+    const generatorSelections = settledSelections.flatMap((result, index3) => {
+      const request7 = requests3[index3];
+      if (request7 == null) {
+        throw new Error(`Missing source archive request at settled index ${index3}`);
+      }
+      if (result.status === "rejected") {
+        errors4.set(request7.generatorIndex, result.reason);
+        return [];
+      }
+      return result.value == null ? [] : [{ generatorIndex: request7.generatorIndex, specs: result.value }];
+    });
+    if (generatorSelections.length > 0) {
+      const settledArchive = await createGroupedSpecsTarGzArchiveSettled({
+        generatorSelections,
+        context: context3,
+        audiences: group.audiences
+      });
+      for (const [generatorIndex, error50] of settledArchive.errorsByGeneratorIndex) {
+        errors4.set(generatorIndex, error50);
+      }
+      if (settledArchive.archive != null) {
+        const { specIndexesByGeneratorIndex, ...sourceArchive } = settledArchive.archive;
+        for (const [generatorIndex, specIndexes] of specIndexesByGeneratorIndex) {
+          sourceArchives.set(generatorIndex, { ...sourceArchive, specIndexes });
+        }
+      }
+    }
+    const rootRequests = requests3.filter(
+      (request7) => request7.sdkGenApiRoute == null && generatorWantsSpecs(request7.generatorInvocation.name) && !errors4.has(request7.generatorIndex)
+    );
+    if (rootRequests.length > 0) {
+      try {
+        const archive3 = await createSpecsTarGzArchive({
+          specs: workspace.allSpecs,
+          context: context3,
+          audiences: group.audiences
+        });
+        const specIndexes = archive3.manifest.specs.map((_5, index3) => index3);
+        for (const request7 of rootRequests) {
+          sourceArchives.set(request7.generatorIndex, { ...archive3, specIndexes });
+        }
+      } catch (error50) {
+        for (const request7 of rootRequests) {
+          errors4.set(request7.generatorIndex, error50);
+        }
+      }
+    }
+    for (const request7 of requests3) {
+      if (!requestRequiresSourceArchive(request7)) {
+        continue;
+      }
+      const hasArchive = sourceArchives.has(request7.generatorIndex);
+      const hasError = errors4.has(request7.generatorIndex);
+      if (hasArchive && hasError) {
+        throw new Error(
+          `Generator index ${request7.generatorIndex} produced both a source archive and a source preparation error`,
+          { cause: errors4.get(request7.generatorIndex) }
+        );
+      }
+      if (!hasArchive && !hasError) {
+        errors4.set(
+          request7.generatorIndex,
+          new Error(
+            `Generator index ${request7.generatorIndex} did not produce a source archive or source preparation error`
+          )
+        );
+      }
+    }
+    return { sourceArchives, errors: errors4 };
   };
 }
+function requestRequiresSourceArchive(request7) {
+  return request7.sdkGenApiRoute != null || generatorWantsSpecs(request7.generatorInvocation.name);
+}
 
 // src/commands/generate/packLocalOutput.ts
 init_lib20();
@@ -984068,21 +985068,11 @@ async function generateWorkspace({
             disableTelemetry: isTelemetryDisabled()
           });
         } else if (token != null) {
-          const ossWorkspace = workspace instanceof OSSWorkspace ? workspace : void 0;
-          const getCachedSpecsTarGz = ossWorkspace == null ? void 0 : createSpecsTarGzCache(
-            () => createSpecsTarGzBuffer({
-              specs: ossWorkspace.allSpecs,
-              context: groupContext,
-              audiences: group.audiences
-            })
-          );
-          const getSpecsTarGz = async (generatorName2) => {
-            const sdkGenApiNeedsSpecs = isFernSdkGenApiEnabled() && getFernSdkGenApiLanguage(generatorName2) != null;
-            if (getCachedSpecsTarGz == null || !generatorWantsSpecs(generatorName2) && !sdkGenApiNeedsSpecs) {
-              return void 0;
-            }
-            return getCachedSpecsTarGz();
-          };
+          const getSpecsTarGz = createFernSourceArchiveResolver({
+            workspace,
+            context: groupContext,
+            group
+          });
           await runRemoteGenerationForAPIWorkspace({
             projectConfig,
             organization,
@@ -994973,7 +995963,7 @@ function upsertServerInJsonConfig({
   includeTransportType
 }) {
   const config5 = parseJsonConfig(existingContents);
-  const mcpServers = isRecord4(config5.mcpServers) ? config5.mcpServers : {};
+  const mcpServers = isRecord5(config5.mcpServers) ? config5.mcpServers : {};
   config5.mcpServers = {
     ...mcpServers,
     [MCP_SERVER_NAME]: {
@@ -994990,12 +995980,12 @@ function parseJsonConfig(existingContents) {
     return {};
   }
   const parsed = JSON.parse(existingContents);
-  if (!isRecord4(parsed)) {
+  if (!isRecord5(parsed)) {
     throw new Error("Expected the config to contain a JSON object");
   }
   return parsed;
 }
-function isRecord4(value2) {
+function isRecord5(value2) {
   return typeof value2 === "object" && value2 !== null && !Array.isArray(value2);
 }
 var CODEX_SERVER_TABLE_PATH = `mcp_servers.${MCP_SERVER_NAME}`;
@@ -996550,7 +997540,12 @@ async function sdkPreview({
               absolutePathToPreview: absolutePathToOutput,
               isPreview: true,
               fiddlePreview: false,
-              pushPreviewBranch: false
+              pushPreviewBranch: false,
+              getSpecsTarGzBuffer: createFernSourceArchiveResolver({
+                workspace,
+                context: context3,
+                group: publishGroup
+              })
             });
           });
           if (shouldRunTwoJobs) {
@@ -996565,7 +997560,12 @@ async function sdkPreview({
                   absolutePathToPreview: void 0,
                   isPreview: true,
                   fiddlePreview: true,
-                  pushPreviewBranch: true
+                  pushPreviewBranch: true,
+                  getSpecsTarGzBuffer: createFernSourceArchiveResolver({
+                    workspace,
+                    context: context3,
+                    group: diffGroup
+                  })
                 });
               });
             }