@fern-api/fern-api-dev 5.67.1 → 5.69.0

package/cli.cjs

@@ -67272,6 +67272,13 @@ var init_HeaderApiVersionScheme = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/api/resources/ir/types/IdempotencyKeyGeneration.js
+var init_IdempotencyKeyGeneration = __esm({
+  "../../ir-sdk/lib/sdk/api/resources/ir/types/IdempotencyKeyGeneration.js"() {
+    "use strict";
+  }
+});
+
 // ../../ir-sdk/lib/sdk/api/resources/ir/types/IntermediateRepresentation.js
 var init_IntermediateRepresentation = __esm({
   "../../ir-sdk/lib/sdk/api/resources/ir/types/IntermediateRepresentation.js"() {
@@ -67400,6 +67407,7 @@ var init_types63 = __esm({
     init_ExampleStyle();
     init_GenerationMetadata();
     init_HeaderApiVersionScheme();
+    init_IdempotencyKeyGeneration();
     init_IntermediateRepresentation();
     init_InvocationSource();
     init_Package();
@@ -79542,6 +79550,20 @@ var init_GenerationMetadata2 = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/serialization/resources/ir/types/IdempotencyKeyGeneration.js
+var IdempotencyKeyGeneration;
+var init_IdempotencyKeyGeneration2 = __esm({
+  "../../ir-sdk/lib/sdk/serialization/resources/ir/types/IdempotencyKeyGeneration.js"() {
+    "use strict";
+    init_core2();
+    init_HttpMethod4();
+    IdempotencyKeyGeneration = schemas_exports3.objectWithoutOptionalProperties({
+      headerName: schemas_exports3.string(),
+      methods: schemas_exports3.list(HttpMethod4)
+    });
+  }
+});
+
 // ../../ir-sdk/lib/sdk/serialization/resources/publish/types/CratesPublishTarget.js
 var CratesPublishTarget;
 var init_CratesPublishTarget2 = __esm({
@@ -81375,13 +81397,15 @@ var init_SdkConfig2 = __esm({
   "../../ir-sdk/lib/sdk/serialization/resources/ir/types/SdkConfig.js"() {
     "use strict";
     init_core2();
+    init_IdempotencyKeyGeneration2();
     init_PlatformHeaders2();
     SdkConfig = schemas_exports3.objectWithoutOptionalProperties({
       isAuthMandatory: schemas_exports3.boolean(),
       hasStreamingEndpoints: schemas_exports3.boolean(),
       hasPaginatedEndpoints: schemas_exports3.boolean(),
       hasFileDownloadEndpoints: schemas_exports3.boolean(),
-      platformHeaders: PlatformHeaders
+      platformHeaders: PlatformHeaders,
+      idempotencyKeyGeneration: IdempotencyKeyGeneration.optional()
     });
   }
 });
@@ -81521,6 +81545,7 @@ var init_types92 = __esm({
     init_ExampleStyle2();
     init_GenerationMetadata2();
     init_HeaderApiVersionScheme2();
+    init_IdempotencyKeyGeneration2();
     init_IntermediateRepresentation2();
     init_InvocationSource2();
     init_Package2();
@@ -81549,6 +81574,7 @@ __export(ir_exports4, {
   ExampleStyle: () => ExampleStyle2,
   GenerationMetadata: () => GenerationMetadata,
   HeaderApiVersionScheme: () => HeaderApiVersionScheme,
+  IdempotencyKeyGeneration: () => IdempotencyKeyGeneration,
   IntermediateRepresentation: () => IntermediateRepresentation,
   InvocationSource: () => InvocationSource2,
   Package: () => Package,
@@ -82851,6 +82877,7 @@ __export(serialization_exports2, {
   HttpResponse: () => HttpResponse,
   HttpResponseBody: () => HttpResponseBody2,
   HttpService: () => HttpService,
+  IdempotencyKeyGeneration: () => IdempotencyKeyGeneration,
   InferredAuthScheme: () => InferredAuthScheme,
   InferredAuthSchemeTokenEndpoint: () => InferredAuthSchemeTokenEndpoint,
   InferredAuthenticatedRequestHeader: () => InferredAuthenticatedRequestHeader2,
@@ -83903,6 +83930,36 @@ function getUserAgentTemplateFromGeneratorConfig(generatorInvocation) {
   }
   return void 0;
 }
+function parseIdempotencyKeyMethods(value2) {
+  if (!Array.isArray(value2)) {
+    return DEFAULT_IDEMPOTENCY_KEY_METHODS;
+  }
+  const methods = value2.filter((entry) => typeof entry === "string").map((entry) => entry.toUpperCase()).filter((entry) => ALL_HTTP_METHODS.has(entry));
+  return methods.length > 0 ? methods : DEFAULT_IDEMPOTENCY_KEY_METHODS;
+}
+function getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation) {
+  const value2 = generatorInvocation.idempotencyKeyGenerationConfig ?? getRawPerGeneratorIdempotencyKeyConfig(generatorInvocation);
+  return resolveIdempotencyKeyGeneration(value2);
+}
+function getRawPerGeneratorIdempotencyKeyConfig(generatorInvocation) {
+  if (typeof generatorInvocation.raw?.config !== "object" || generatorInvocation.raw?.config === null) {
+    return void 0;
+  }
+  return generatorInvocation.raw.config["auto-generate-idempotency-key"];
+}
+function resolveIdempotencyKeyGeneration(value2) {
+  if (value2 === true) {
+    return { headerName: DEFAULT_IDEMPOTENCY_KEY_HEADER, methods: DEFAULT_IDEMPOTENCY_KEY_METHODS };
+  }
+  if (typeof value2 === "object" && value2 !== null) {
+    const headerName = value2["header-name"];
+    return {
+      headerName: typeof headerName === "string" ? headerName : DEFAULT_IDEMPOTENCY_KEY_HEADER,
+      methods: parseIdempotencyKeyMethods(value2["methods"])
+    };
+  }
+  return void 0;
+}
 function stripCliConfigKeys(config5) {
   if (typeof config5 !== "object" || config5 === null) {
     return config5;
@@ -84068,13 +84125,16 @@ function getRegistryName(language) {
       return language;
   }
 }
-var CLI_ONLY_CONFIG_KEYS, REGISTRY_TIMEOUT_MS;
+var DEFAULT_IDEMPOTENCY_KEY_HEADER, DEFAULT_IDEMPOTENCY_KEY_METHODS, ALL_HTTP_METHODS, CLI_ONLY_CONFIG_KEYS, REGISTRY_TIMEOUT_MS;
 var init_checkVersionExists = __esm({
   "../../commons/api-workspace-commons/lib/checkVersionExists.js"() {
     "use strict";
     init_lib4();
     init_lib6();
-    CLI_ONLY_CONFIG_KEYS = /* @__PURE__ */ new Set(["user-agent"]);
+    DEFAULT_IDEMPOTENCY_KEY_HEADER = "Idempotency-Key";
+    DEFAULT_IDEMPOTENCY_KEY_METHODS = ["POST", "PUT"];
+    ALL_HTTP_METHODS = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"]);
+    CLI_ONLY_CONFIG_KEYS = /* @__PURE__ */ new Set(["user-agent", "auto-generate-idempotency-key"]);
     REGISTRY_TIMEOUT_MS = 5e3;
   }
 });
@@ -129705,7 +129765,9 @@ var init_ApiConfigurationV2SettingsSchema2 = __esm({
     init_core6();
     init_AsyncApiSettingsSchema2();
     init_OpenApiSettingsSchema2();
-    ApiConfigurationV2SettingsSchema = schemas_exports8.object({}).extend(OpenApiSettingsSchema).extend(AsyncApiSettingsSchema);
+    ApiConfigurationV2SettingsSchema = schemas_exports8.object({
+      "auto-generate-idempotency-key": schemas_exports8.unknown().optional()
+    }).extend(OpenApiSettingsSchema).extend(AsyncApiSettingsSchema);
   }
 });
 
@@ -259592,6 +259654,8 @@ async function convertGeneratorsConfiguration({ absolutePathToGeneratorsConfigur
   const readme = rawGeneratorsConfiguration.readme;
   warnForDeprecatedConfiguration(context3, rawGeneratorsConfiguration);
   const parsedApiConfiguration = await parseAPIConfiguration(rawGeneratorsConfiguration);
+  const apiConfiguration = rawGeneratorsConfiguration.api;
+  const globalIdempotencyKeyGeneration = apiConfiguration != null && generators_yml_exports.isApiConfigurationV2Schema(apiConfiguration) ? apiConfiguration.settings?.["auto-generate-idempotency-key"] : void 0;
   return {
     absolutePathToConfiguration: absolutePathToGeneratorsConfiguration,
     api: parsedApiConfiguration,
@@ -259606,6 +259670,7 @@ async function convertGeneratorsConfiguration({ absolutePathToGeneratorsConfigur
       maybeTopLevelMetadata,
       maybeTopLevelReviewers: rawGeneratorsConfiguration.reviewers,
       maybeRootAutomation: rawGeneratorsConfiguration.automation,
+      globalIdempotencyKeyGeneration,
       readme,
       context: context3
     }))) : [],
@@ -259990,7 +260055,7 @@ async function parseAPIConfiguration(rawGeneratorsConfiguration) {
     definitions: await parseAPIConfigurationToApiLocations(apiConfiguration, rawGeneratorsConfiguration, emptySettings)
   };
 }
-async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName, group, maybeTopLevelMetadata, maybeTopLevelReviewers, maybeRootAutomation, readme, context: context3 }) {
+async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName, group, maybeTopLevelMetadata, maybeTopLevelReviewers, maybeRootAutomation, globalIdempotencyKeyGeneration, readme, context: context3 }) {
   const maybeGroupLevelMetadata = getOutputMetadata(group.metadata);
   return {
     groupName,
@@ -260005,6 +260070,7 @@ async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName,
       maybeGroupLevelReviewers: group.reviewers,
       maybeRootAutomation,
       maybeGroupAutomation: group.automation,
+      globalIdempotencyKeyGeneration,
       readme,
       context: context3
     })))
@@ -260026,10 +260092,12 @@ function getGeneratorNameAndImage(generator, context3) {
     containerImage: void 0
   };
 }
-async function convertGenerator({ absolutePathToGeneratorsConfiguration, generator, maybeGroupLevelMetadata, maybeTopLevelMetadata, maybeGroupLevelReviewers, maybeTopLevelReviewers, maybeRootAutomation, maybeGroupAutomation, readme, context: context3 }) {
+async function convertGenerator({ absolutePathToGeneratorsConfiguration, generator, maybeGroupLevelMetadata, maybeTopLevelMetadata, maybeGroupLevelReviewers, maybeTopLevelReviewers, maybeRootAutomation, maybeGroupAutomation, globalIdempotencyKeyGeneration, readme, context: context3 }) {
   const { normalizedName, containerImage } = getGeneratorNameAndImage(generator, context3);
+  const perGeneratorIdempotencyKeyGeneration = typeof generator.config === "object" && generator.config !== null ? generator.config["auto-generate-idempotency-key"] : void 0;
   return {
     raw: generator,
+    idempotencyKeyGenerationConfig: perGeneratorIdempotencyKeyGeneration ?? globalIdempotencyKeyGeneration,
     automation: generators_yml_exports.resolveAutomationConfig({
       rootAutomation: maybeRootAutomation,
       groupAutomation: maybeGroupAutomation,
@@ -276640,7 +276708,7 @@ var init_getIrGenerationSettings = __esm({
 });
 
 // ../generation/ir-generator/lib/generateIntermediateRepresentation.js
-function generateIntermediateRepresentation({ workspace, generationLanguage, keywords: keywords3, smartCasing, exampleGeneration, audiences, readme, packageName, userAgentTemplate, organization, version: version7, context: context3, fdrApiDefinitionId, sourceResolver, disableDynamicExamples, dynamicGeneratorConfig, generationMetadata }) {
+function generateIntermediateRepresentation({ workspace, generationLanguage, keywords: keywords3, smartCasing, exampleGeneration, audiences, readme, packageName, userAgentTemplate, idempotencyKeyGeneration, organization, version: version7, context: context3, fdrApiDefinitionId, sourceResolver, disableDynamicExamples, dynamicGeneratorConfig, generationMetadata }) {
   const irSettings = getIrGenerationSettings({ workspace });
   const casingsGenerator = constructCasingsGenerator({ generationLanguage, keywords: keywords3, smartCasing });
   const irGraph = new IrGraph(audiences);
@@ -276978,6 +277046,7 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
     hasStreamingEndpoints,
     hasPaginatedEndpoints,
     hasFileDownloadEndpoints,
+    idempotencyKeyGeneration,
     platformHeaders: {
       language: "X-Fern-Language",
       sdkName: "X-Fern-SDK-Name",
@@ -342420,6 +342489,7 @@ var init_AbstractSpecConverter = __esm({
             hasPaginatedEndpoints: false,
             hasStreamingEndpoints: false,
             isAuthMandatory: true,
+            idempotencyKeyGeneration: void 0,
             platformHeaders: {
               language: "",
               sdkName: "",
@@ -565816,7 +565886,8 @@ var require_AutoVersionStep = __commonJS({
       }
       async handleNormalFlow(params2) {
         const { prepared, service, language, mappedMagicVersion, previousGenerationSha } = params2;
-        const rawDiff = this.gitDiff(previousGenerationSha, prepared.currentGenerationSha);
+        const diffBase = this.resolveReachableGenerationBase(previousGenerationSha, prepared.currentGenerationSha);
+        const rawDiff = diffBase != null ? this.safeGitDiff(diffBase, prepared.currentGenerationSha) : "";
         const previousVersion = await this.resolvePreviousVersion({
           service,
           rawDiff,
@@ -566213,6 +566284,91 @@ var require_AutoVersionStep = __commonJS({
           maxBuffer: 256 * 1024 * 1024
         });
       }
+      /**
+       * Resolves a reachable base commit for the autoversion diff.
+       *
+       * `recordedSha` (the previous generation from replay.lock) is preferred when it exists
+       * in this clone. When it doesn't — e.g. the signed-commit push recreated the
+       * [fern-generated] commit under a new SHA, or the branch was squash-merged — we re-anchor
+       * on the most recent reachable [fern-generated] commit in history. Returns null when no
+       * generation baseline is reachable at all, in which case the caller resolves the previous
+       * version from metadata/git-tags and still rewrites the placeholder.
+       */
+      resolveReachableGenerationBase(recordedSha, currentGenerationSha) {
+        if (this.commitExists(recordedSha)) {
+          return recordedSha;
+        }
+        this.logger.warn(`AutoVersionStep: recorded previous generation ${recordedSha.slice(0, 7)} is unreachable in this clone; deriving the baseline from history.`);
+        const derived = this.findPreviousGenerationFromHistory(currentGenerationSha);
+        if (derived != null) {
+          this.logger.info(`AutoVersionStep: re-anchored autoversion baseline on ${derived.slice(0, 7)}.`);
+          return derived;
+        }
+        this.logger.warn("AutoVersionStep: no reachable [fern-generated] baseline found; falling back to metadata/git-tags.");
+        return null;
+      }
+      commitExists(sha) {
+        if (!/^[0-9a-f]{7,40}$/.test(sha)) {
+          return false;
+        }
+        try {
+          (0, child_process_1.execFileSync)("git", ["cat-file", "-e", `${sha}^{commit}`], {
+            cwd: this.outputDir,
+            stdio: "pipe"
+          });
+          return true;
+        } catch {
+          return false;
+        }
+      }
+      /**
+       * Walks first-parent history from the current generation commit and returns the most
+       * recent prior [fern-generated] commit — the reachable equivalent of replay.lock's
+       * recorded baseline. Mirrors @fern-api/replay's `findPreviousGenerationFromHistory`.
+       */
+      findPreviousGenerationFromHistory(currentGenerationSha) {
+        const start2 = this.commitExists(currentGenerationSha) ? currentGenerationSha : "HEAD";
+        let log4;
+        try {
+          log4 = (0, child_process_1.execFileSync)("git", ["log", "--first-parent", "--format=%H%x00%s", start2], {
+            cwd: this.outputDir,
+            encoding: "utf-8",
+            stdio: "pipe",
+            maxBuffer: 64 * 1024 * 1024
+          });
+        } catch (error50) {
+          this.logger.debug(`AutoVersionStep: git log history walk failed (${String(error50)}); no baseline derived.`);
+          return null;
+        }
+        for (const line of log4.split("\n")) {
+          if (line.trim().length === 0) {
+            continue;
+          }
+          const [sha, subject = ""] = line.split("\0");
+          if (sha == null || sha === currentGenerationSha) {
+            continue;
+          }
+          if (subject.startsWith("[fern-generated]")) {
+            return sha;
+          }
+        }
+        return null;
+      }
+      /**
+       * `gitDiff` that degrades to an empty diff instead of throwing. Both endpoints are
+       * expected to be reachable (the base is resolved via resolveReachableGenerationBase and
+       * `to` is this run's freshly-created HEAD), but we never want a `git diff` failure to
+       * abort autoversion and leave the magic placeholder in the shipped SDK — the empty diff
+       * routes version resolution to baseVersion/metadata/git-tags, which still rewrites it.
+       */
+      safeGitDiff(from4, to2) {
+        try {
+          return this.gitDiff(from4, to2);
+        } catch (error50) {
+          this.logger.warn(`AutoVersionStep: git diff ${from4.slice(0, 7)}..${to2.slice(0, 7)} failed (${error50 instanceof Error ? error50.message : String(error50)}); proceeding with an empty diff.`);
+          return "";
+        }
+      }
       gitDiff(from4, to2) {
         return (0, child_process_1.execFileSync)("git", ["diff", from4, to2, "--", ".", ":(exclude).fern/metadata.json"], {
           cwd: this.outputDir,
@@ -689087,7 +689243,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.67.1",
+          version: "5.69.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689153,7 +689309,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.67.1",
+        version: "5.69.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -834249,8 +834405,8 @@ var V67_TO_V66_MIGRATION = {
     [GeneratorName.TYPESCRIPT_SDK]: "3.70.9-rc.0",
     [GeneratorName.TYPESCRIPT_EXPRESS]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.JAVA]: GeneratorWasNeverUpdatedToConsumeNewIR,
-    [GeneratorName.JAVA_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
-    [GeneratorName.JAVA_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
+    [GeneratorName.JAVA_MODEL]: "1.9.0-rc.1",
+    [GeneratorName.JAVA_SDK]: "4.13.3-rc.0",
     [GeneratorName.JAVA_SPRING]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.OPENAPI_PYTHON_CLIENT]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.OPENAPI]: GeneratorWasNeverUpdatedToConsumeNewIR,
@@ -834261,13 +834417,13 @@ var V67_TO_V66_MIGRATION = {
     [GeneratorName.POSTMAN]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.GO_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.GO_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
-    [GeneratorName.RUBY_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
+    [GeneratorName.RUBY_SDK]: "1.16.0-rc.0",
     [GeneratorName.CSHARP_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.CSHARP_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.SWIFT_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.SWIFT_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.PHP_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
-    [GeneratorName.PHP_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
+    [GeneratorName.PHP_SDK]: "2.11.2-rc.0",
     [GeneratorName.RUST_MODEL]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.RUST_SDK]: GeneratorWasNeverUpdatedToConsumeNewIR,
     [GeneratorName.CLI]: "0.0.1"
@@ -870254,7 +870410,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.67.1";
+  const version7 = "5.69.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -900060,6 +900216,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
   }
   const effectiveIrVersion = resolvedVersion != null && (0, import_autoversion.isAutoVersion)(resolvedVersion) ? import_autoversion.MAGIC_VERSION : resolvedVersion;
   const userAgentTemplate = getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
+  const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
   const ir3 = generateIntermediateRepresentation({
     workspace,
     generationLanguage: generatorInvocation.language,
@@ -900074,6 +900231,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     readme,
     packageName,
     userAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     version: effectiveIrVersion,
     context: interactiveTaskContext,
@@ -902813,7 +902971,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.67.1",
+        cliVersion: "5.69.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -922377,6 +922535,8 @@ var Generation = class {
     extraDependencies: () => this.customConfig["extra-dependencies"] ?? {},
     /** When true, omits Fern platform headers (X-Fern-Language, SDK name/version, User-Agent) from generated SDK requests. Default: false. */
     omitFernHeaders: () => this.customConfig["omit-fern-headers"] ?? false,
+    /** When true, emits the platform observability headers (X-Fern-Runtime, X-Fern-Runtime-Version, X-Fern-Platform). Default: false. Still subject to omitFernHeaders. */
+    includePlatformHeaders: () => this.customConfig["include-platform-headers"] ?? false,
     /** When true, falls back to `<NuGetPackageId>/<version>` for the `User-Agent` header when the IR doesn't supply one. Default: false. */
     userAgentNameFromPackage: () => this.customConfig["user-agent-name-from-package"] ?? false,
     /** When true, moves auth params and IR headers into ClientOptions so the constructor takes only named arguments. Default: false. */
@@ -928964,6 +929124,7 @@ var BaseJavaCustomConfigSchema = external_exports2.object({
   "output-directory": external_exports2.enum(["source-root", "project-root"]).optional(),
   "custom-interceptors": external_exports2.boolean().optional(),
   "omit-fern-headers": external_exports2.boolean().optional(),
+  includePlatformHeaders: external_exports2.boolean().optional(),
   "retry-status-codes": external_exports2.optional(external_exports2.enum(["legacy", "recommended"])),
   // Hidden options (for debugging).
   "enable-gradle-profiling": external_exports2.boolean().optional(),
@@ -938657,6 +938818,19 @@ var DynamicSnippetsGeneratorContext5 = class _DynamicSnippetsGeneratorContext ex
     }
     return name2.snakeCase.safeName;
   }
+  /**
+   * Module/subpackage directory name, preserving any leading/trailing underscores
+   * from the original name that the casing functions would otherwise strip. This
+   * keeps snippet accessors and module paths consistent with the generated module
+   * directories (e.g. a group named `_agents` yields `client._agents`). It is scoped
+   * to namespace/module names and intentionally not applied to property or method names.
+   */
+  getModuleName(name2) {
+    const leading = name2.originalName.match(/^(_+)/)?.[1] ?? "";
+    const core2 = name2.originalName.slice(leading.length);
+    const trailing = core2.match(/(_+)$/)?.[1] ?? "";
+    return `${leading}${name2.snakeCase.safeName}${trailing}`;
+  }
   getRootClientClassReference() {
     return python_exports.reference({
       name: this.getRootClientClassName(),
@@ -938667,7 +938841,7 @@ var DynamicSnippetsGeneratorContext5 = class _DynamicSnippetsGeneratorContext ex
     const className = this.getClassName(declaration.name);
     const modulePath = [
       ...this.getRootModulePath(),
-      ...declaration.fernFilepath.allParts.map((part) => part.snakeCase.safeName)
+      ...declaration.fernFilepath.allParts.map((part) => this.getModuleName(part))
     ];
     return python_exports.reference({ name: className, modulePath });
   }
@@ -938676,7 +938850,7 @@ var DynamicSnippetsGeneratorContext5 = class _DynamicSnippetsGeneratorContext ex
     const variantName = discriminantValue.name.pascalCase.safeName;
     const modulePath = [
       ...this.getRootModulePath(),
-      ...unionDeclaration.fernFilepath.allParts.map((part) => part.snakeCase.safeName)
+      ...unionDeclaration.fernFilepath.allParts.map((part) => this.getModuleName(part))
     ];
     const name2 = this.customConfig.pydantic_config?.union_naming === "v1" ? `${variantName}${unionClassName}` : `${unionClassName}_${variantName}`;
     return python_exports.reference({ name: name2, modulePath });
@@ -939482,7 +939656,7 @@ var EndpointSnippetGenerator5 = class {
   }
   getMethod({ endpoint: endpoint3 }) {
     if (endpoint3.declaration.fernFilepath.allParts.length > 0) {
-      return `${endpoint3.declaration.fernFilepath.allParts.map((val) => this.context.getMethodName(val)).join(".")}.${this.context.getMethodName(endpoint3.declaration.name)}`;
+      return `${endpoint3.declaration.fernFilepath.allParts.map((val) => this.context.getModuleName(val)).join(".")}.${this.context.getMethodName(endpoint3.declaration.name)}`;
     }
     return this.context.getMethodName(endpoint3.declaration.name);
   }
@@ -952791,6 +952965,7 @@ var TypescriptCustomConfigSchema = external_exports2.strictObject({
   fetchSupport: external_exports2.optional(external_exports2.enum(["node-fetch", "native"])),
   packagePath: external_exports2.optional(external_exports2.string()),
   omitFernHeaders: external_exports2.optional(external_exports2.boolean()),
+  includePlatformHeaders: external_exports2.optional(external_exports2.boolean()),
   useDefaultRequestParameterValues: external_exports2.optional(external_exports2.boolean()),
   packageManager: external_exports2.optional(external_exports2.enum(["pnpm", "yarn"])),
   flattenRequestParameters: external_exports2.optional(external_exports2.boolean()),
@@ -955667,6 +955842,7 @@ init_lib26();
 init_lib22();
 async function getIntermediateRepresentation({ workspace, audiences, generatorInvocation, context: context3, irVersionOverride, version: version7, packageName, userAgentTemplate, organization, sourceConfig, includeOptionalRequestPropertyExamples, ir: ir3 }) {
   const resolvedUserAgentTemplate = userAgentTemplate ?? getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
+  const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
   const intermediateRepresentation = ir3 ?? generateIntermediateRepresentation({
     workspace,
     audiences,
@@ -955681,6 +955857,7 @@ async function getIntermediateRepresentation({ workspace, audiences, generatorIn
     version: version7,
     packageName,
     userAgentTemplate: resolvedUserAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     context: context3,
     sourceResolver: new SourceResolverImpl(context3, workspace),
@@ -957005,6 +957182,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
       });
       const packageName = getPackageNameFromGeneratorConfig(generatorInvocation);
       const userAgentTemplate = getUserAgentTemplateFromGeneratorConfig(generatorInvocation);
+      const idempotencyKeyGeneration = getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation);
       version7 = version7 ?? await computeSemanticVersion({ packageName, generatorInvocation });
       const irLanguage = generatorInvocation.language ?? (0, import_autoversion4.extractLanguageFromGeneratorName)(generatorInvocation.name);
       const effectiveIrVersion = version7 != null && (0, import_autoversion4.isAutoVersion)(version7) ? (0, import_autoversion4.mapMagicVersionForLanguage)(import_autoversion4.MAGIC_VERSION, irLanguage) : version7;
@@ -957022,6 +957200,7 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
         version: effectiveIrVersion,
         packageName,
         userAgentTemplate,
+        idempotencyKeyGeneration,
         organization: projectConfig.organization,
         context: context3,
         sourceResolver: new SourceResolverImpl(context3, fernWorkspace),
@@ -957564,6 +957743,7 @@ var GenerationRunner = class {
       version: outputVersionOverride,
       packageName: generators_yml_exports.getPackageName({ generatorInvocation }),
       userAgentTemplate: getUserAgentTemplateFromGeneratorConfig(generatorInvocation),
+      idempotencyKeyGeneration: getIdempotencyKeyGenerationFromGeneratorConfig(generatorInvocation),
       organization,
       context: context3,
       sourceResolver: new SourceResolverImpl(context3, workspace),
@@ -969152,7 +969332,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.67.1"
+    cli_version: "5.69.0"
   };
 }
 function isAutomationMode() {
@@ -969984,7 +970164,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.67.1";
+    return "5.69.0";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.67.1",
+  "version": "5.69.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",