@fern-api/fern-api-dev 5.67.0 → 5.68.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,30 @@ 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) {
+  if (typeof generatorInvocation.raw?.config !== "object" || generatorInvocation.raw?.config === null) {
+    return void 0;
+  }
+  const value2 = generatorInvocation.raw.config["auto-generate-idempotency-key"];
+  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 +84119,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;
   }
 });
@@ -276640,7 +276694,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 +277032,7 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
     hasStreamingEndpoints,
     hasPaginatedEndpoints,
     hasFileDownloadEndpoints,
+    idempotencyKeyGeneration,
     platformHeaders: {
       language: "X-Fern-Language",
       sdkName: "X-Fern-SDK-Name",
@@ -342420,6 +342475,7 @@ var init_AbstractSpecConverter = __esm({
             hasPaginatedEndpoints: false,
             hasStreamingEndpoints: false,
             isAuthMandatory: true,
+            idempotencyKeyGeneration: void 0,
             platformHeaders: {
               language: "",
               sdkName: "",
@@ -564284,7 +564340,8 @@ var require_AutoVersioningService = __commonJS({
             contentLines.push(line);
           }
         }
-        let processedContent = this.removeVersionChangePairs(contentLines, mappedMagicVersion);
+        let processedContent = this.removeGoModulePathSuffixPairs(contentLines);
+        processedContent = this.removeVersionChangePairs(processedContent, mappedMagicVersion);
         processedContent = this.removeRemainingMagicVersionLines(processedContent, mappedMagicVersion);
         let hasChanges2 = false;
         for (const line of processedContent) {
@@ -564420,21 +564477,83 @@ var require_AutoVersioningService = __commonJS({
        * so non-Go diffs like API URL version changes are not affected.
        */
       isGoModulePathSuffixChange(minusLine, plusLine) {
-        const minusContent = minusLine.substring(1);
-        const plusContent = plusLine.substring(1);
-        const goModulePathPattern = /"[^"]*(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/[^"]*"/;
-        const goModuleDirectivePattern = /^\s*module\s+(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/\S+/;
-        const hasGoModulePath = goModulePathPattern.test(minusContent) || goModulePathPattern.test(plusContent) || goModuleDirectivePattern.test(minusContent.trim()) || goModuleDirectivePattern.test(plusContent.trim());
-        if (!hasGoModulePath) {
+        const minus = this.analyzeGoModulePathLine(minusLine);
+        const plus = this.analyzeGoModulePathLine(plusLine);
+        if (minus == null || plus == null) {
           return false;
         }
-        const suffixPattern = /\/v\d+(?=\/|"\s*$|$)/g;
-        const minusWithoutSuffix = minusContent.replace(suffixPattern, "");
-        const plusWithoutSuffix = plusContent.replace(suffixPattern, "");
-        if (minusWithoutSuffix !== plusWithoutSuffix) {
+        if (minus.strippedContent !== plus.strippedContent) {
           return false;
         }
-        return /\/v\d+(?=\/|"\s*$|$)/.test(minusContent) || /\/v\d+(?=\/|"\s*$|$)/.test(plusContent);
+        return minus.hasSuffix || plus.hasSuffix;
+      }
+      /**
+       * Removes Go module path `/vN` suffix-only churn from a diff section, regardless of how the
+       * deletion and addition lines are laid out. `removeVersionChangePairs` only removes a deletion
+       * when it can pair it with a *nearby* addition and keeps every line in between — so a diff that
+       * groups all deletions before all additions (as Go import blocks do) leaks the suffix churn for
+       * every line except the first. That churn then reaches the AI diff analyzer, which sees the
+       * previously published `/vN` module path changing on every import and misclassifies a
+       * no-op regeneration as a breaking change (spurious major bump).
+       *
+       * This pass matches each suffix-bearing deletion with any suffix-only-equivalent addition in
+       * the section (by suffix-stripped content) and drops both, so only genuine content changes to
+       * Go module path lines survive.
+       */
+      removeGoModulePathSuffixPairs(lines) {
+        const additions = [];
+        for (let index3 = 0; index3 < lines.length; index3++) {
+          const line = lines[index3];
+          if (line == null || !this.isAdditionLine(line)) {
+            continue;
+          }
+          const info = this.analyzeGoModulePathLine(line);
+          if (info != null) {
+            additions.push({ index: index3, strippedContent: info.strippedContent });
+          }
+        }
+        const removed = /* @__PURE__ */ new Set();
+        const usedAdditions = /* @__PURE__ */ new Set();
+        for (let index3 = 0; index3 < lines.length; index3++) {
+          const line = lines[index3];
+          if (line == null || !this.isDeletionLine(line)) {
+            continue;
+          }
+          const info = this.analyzeGoModulePathLine(line);
+          if (info == null || !info.hasSuffix) {
+            continue;
+          }
+          const match3 = additions.find((addition) => !usedAdditions.has(addition.index) && addition.strippedContent === info.strippedContent);
+          if (match3 != null) {
+            usedAdditions.add(match3.index);
+            removed.add(index3);
+            removed.add(match3.index);
+          }
+        }
+        if (removed.size === 0) {
+          return lines;
+        }
+        return lines.filter((_5, index3) => !removed.has(index3));
+      }
+      /**
+       * If a diff line (with its leading +/- stripped) references a Go module path — either a quoted
+       * import path or a `module` directive — returns its content with any `/vN` module-version
+       * suffixes removed, plus whether a suffix was present. Returns undefined for non-Go lines so
+       * unrelated diffs (e.g. API URL version segments) are never touched.
+       */
+      analyzeGoModulePathLine(line) {
+        const content5 = line.substring(1);
+        const goModulePathPattern = /"[^"]*(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/[^"]*"/;
+        const goModuleDirectivePattern = /^\s*module\s+(?:github\.com|golang\.org|google\.golang\.org|gopkg\.in)\/\S+/;
+        const isGoModulePathLine = goModulePathPattern.test(content5) || goModuleDirectivePattern.test(content5.trim());
+        if (!isGoModulePathLine) {
+          return void 0;
+        }
+        const suffixPattern = /\/v\d+(?=\/|"|$)/g;
+        return {
+          strippedContent: content5.replace(suffixPattern, ""),
+          hasSuffix: suffixPattern.test(content5)
+        };
       }
       /**
        * Gets the latest semantic version from git tags in the given repository.
@@ -564733,8 +564852,8 @@ var require_VersionUtils = __commonJS({
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.VersionBump = exports2.MAX_RAW_DIFF_BYTES = exports2.MAX_CHUNKS = exports2.MAX_AI_DIFF_BYTES = exports2.MAGIC_VERSION_PYTHON = exports2.MAGIC_VERSION = exports2.AUTO_VERSION = void 0;
-    exports2.extractLanguageFromGeneratorName = extractLanguageFromGeneratorName2;
-    exports2.mapMagicVersionForLanguage = mapMagicVersionForLanguage3;
+    exports2.extractLanguageFromGeneratorName = extractLanguageFromGeneratorName3;
+    exports2.mapMagicVersionForLanguage = mapMagicVersionForLanguage4;
     exports2.maxVersionBump = maxVersionBump3;
     exports2.isAutoVersion = isAutoVersion5;
     exports2.isValidSemver = isValidSemver;
@@ -564742,7 +564861,7 @@ var require_VersionUtils = __commonJS({
     exports2.extractPreviousVersionFromDiffLine = extractPreviousVersionFromDiffLine;
     var semver_1 = __importDefault2(require_semver2());
     var AutoVersioningService_js_1 = require_AutoVersioningService();
-    function extractLanguageFromGeneratorName2(generatorName) {
+    function extractLanguageFromGeneratorName3(generatorName) {
       const name2 = generatorName.toLowerCase();
       if (name2.includes("typescript") || name2.includes("ts-sdk") || name2.includes("node-sdk")) {
         return "typescript";
@@ -564779,7 +564898,7 @@ var require_VersionUtils = __commonJS({
     exports2.AUTO_VERSION = "AUTO";
     exports2.MAGIC_VERSION = "0.0.0-fern-placeholder";
     exports2.MAGIC_VERSION_PYTHON = "0.0.0.dev0";
-    function mapMagicVersionForLanguage3(magicVersion, language) {
+    function mapMagicVersionForLanguage4(magicVersion, language) {
       if (magicVersion !== exports2.MAGIC_VERSION) {
         return magicVersion;
       }
@@ -582073,6 +582192,8 @@ var require_GithubStep = __commonJS({
     exports2.shouldCheckNoDiff = shouldCheckNoDiff;
     exports2.shouldPushGenerationBaseTag = shouldPushGenerationBaseTag;
     exports2.resolveBranchAction = resolveBranchAction;
+    exports2.buildChangelogFileContents = buildChangelogFileContents;
+    exports2.resolveChangelogUrl = resolveChangelogUrl;
     var core_utils_1 = (init_lib4(), __toCommonJS(lib_exports));
     var github_1 = (init_lib11(), __toCommonJS(lib_exports4));
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
@@ -582173,11 +582294,16 @@ var require_GithubStep = __commonJS({
             throw new Error(`Unexpected branch action: ${String(_exhaustive)}`);
           }
         }
+        const createdChangelog = await this.ensureChangelogFile(resolved);
         if (!skipCommit) {
           await this.ensureFernignore();
           this.logger.debug("Committing changes...");
           await repository.commitAllChanges(resolved.commitMessage);
           this.logger.debug(`Committed changes to local copy of GitHub repository at ${this.outputDir}`);
+        } else if (createdChangelog) {
+          this.logger.debug("Committing reconstructed changelog.md on top of the replay commit...");
+          await repository.add("changelog.md");
+          await repository.commit(resolved.commitMessage);
         }
         if (shouldCheckNoDiff(this.config)) {
           const noDiff = await repository.treeHashEquals(`origin/${baseBranch}`);
@@ -582218,7 +582344,18 @@ var require_GithubStep = __commonJS({
           }
         }
         const headSha = await repository.getHeadSha();
-        const changelogUrl = resolved.changelogEntry ? `https://${remote}/${owner}/${repo}/blob/${headSha}/changelog.md` : void 0;
+        const changelogCommitted = (await repository.listTrackedFiles()).includes("changelog.md");
+        const changelogUrl = resolveChangelogUrl({
+          changelogEntry: resolved.changelogEntry,
+          changelogCommitted,
+          remote,
+          owner,
+          repo,
+          headSha
+        });
+        if (resolved.changelogEntry && !changelogCommitted) {
+          this.logger.warn('changelog.md is not present in the committed tree; omitting the "See full changelog" link.');
+        }
         const { prTitle, prBody } = (0, parseCommitMessage_1.parseCommitMessageForPR)(resolved.commitMessage, resolved.changelogEntry, resolved.prDescription, resolved.versionBumpReason, resolved.previousVersion, resolved.newVersion, resolved.versionBump, changelogUrl);
         const replaySection = (0, replay_summary_1.formatReplayPrBody)(replayResult, { branchName: prBranch, repoUri: this.config.uri });
         let enrichedBody = replaySection != null ? prBody + "\n\n---\n\n" + replaySection : prBody;
@@ -582284,6 +582421,7 @@ var require_GithubStep = __commonJS({
           this.logger.debug(`Checking out branch ${this.config.branch}`);
           await repository.checkout(this.config.branch);
         }
+        await this.ensureChangelogFile(resolved);
         await this.ensureFernignore();
         this.logger.debug("Committing changes...");
         await repository.commitAllChanges(resolved.commitMessage);
@@ -582325,6 +582463,7 @@ var require_GithubStep = __commonJS({
           this.logger.debug(`Checking out branch ${this.config.branch}`);
           await repository.checkout(this.config.branch);
         }
+        await this.ensureChangelogFile(resolved);
         await this.ensureFernignore();
         this.logger.debug("Committing changes...");
         await repository.commitAllChanges(resolved.commitMessage);
@@ -582400,6 +582539,33 @@ var require_GithubStep = __commonJS({
           await (0, promises_1.writeFile)(fernignorePath, "# Specify files that shouldn't be modified by Fern\n", "utf-8");
         }
       }
+      /**
+       * Guarantees `changelog.md` is present in the output directory whenever a changelog entry
+       * exists for this run, so the file lands in the committed tree that GithubStep pushes and the
+       * "See full changelog" link resolves. AutoVersionStep normally writes this file via
+       * `prependChangelogEntry`; this is a safety net for paths where that write never reached the
+       * directory GithubStep commits (e.g. non-replay self-hosted generation), which previously left
+       * the link pointing at a non-existent blob (404).
+       *
+       * Returns `true` when it created the file, `false` when the file already existed (or there is
+       * no changelog entry to write).
+       */
+      async ensureChangelogFile(resolved) {
+        const entry = resolved.changelogEntry?.trim();
+        if (entry == null || entry.length === 0) {
+          return false;
+        }
+        const changelogPath = (0, path_1.join)(this.outputDir, "changelog.md");
+        try {
+          await (0, promises_1.access)(changelogPath);
+          return false;
+        } catch {
+          const version7 = resolved.newVersion ?? resolved.previousVersion;
+          await (0, promises_1.writeFile)(changelogPath, buildChangelogFileContents(entry, version7), "utf-8");
+          this.logger.debug(`Wrote changelog.md${version7 != null ? ` for ${version7}` : ""}.`);
+          return true;
+        }
+      }
       deriveSkipCommit(replayResult) {
         if (replayResult == null) {
           return false;
@@ -582480,6 +582646,24 @@ _Fern Run ID: \`${config5.runId}\`_`;
       }
       return "create-from-head";
     }
+    function buildChangelogFileContents(entry, version7) {
+      const trimmed2 = entry.trim();
+      const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const header = version7 != null ? `## [${version7}] - ${now}
+` : `## ${now}
+`;
+      return `# Changelog
+
+${header}${trimmed2}
+
+`;
+    }
+    function resolveChangelogUrl({ changelogEntry, changelogCommitted, remote, owner, repo, headSha }) {
+      if (changelogEntry == null || changelogEntry.trim().length === 0 || !changelogCommitted) {
+        return void 0;
+      }
+      return `https://${remote}/${owner}/${repo}/blob/${headSha}/changelog.md`;
+    }
   }
 });
 
@@ -688959,7 +689143,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.67.0",
+          version: "5.68.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -689025,7 +689209,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.67.0",
+        version: "5.68.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -870126,7 +870310,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.0";
+  const version7 = "5.68.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -899932,6 +900116,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,
@@ -899946,6 +900131,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     readme,
     packageName,
     userAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     version: effectiveIrVersion,
     context: interactiveTaskContext,
@@ -902685,7 +902871,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.67.0",
+        cliVersion: "5.68.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -922249,6 +922435,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. */
@@ -928836,6 +929024,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(),
@@ -952663,6 +952852,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()),
@@ -955539,6 +955729,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,
@@ -955553,6 +955744,7 @@ async function getIntermediateRepresentation({ workspace, audiences, generatorIn
     version: version7,
     packageName,
     userAgentTemplate: resolvedUserAgentTemplate,
+    idempotencyKeyGeneration,
     organization,
     context: context3,
     sourceResolver: new SourceResolverImpl(context3, workspace),
@@ -956877,7 +957069,10 @@ 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;
       const intermediateRepresentation = generateIntermediateRepresentation({
         workspace: fernWorkspace,
         audiences: generatorGroup.audiences,
@@ -956889,9 +957084,10 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
           disabled: generatorInvocation.disableExamples
         },
         readme: generatorInvocation.readme,
-        version: version7 ?? await computeSemanticVersion({ packageName, generatorInvocation }),
+        version: effectiveIrVersion,
         packageName,
         userAgentTemplate,
+        idempotencyKeyGeneration,
         organization: projectConfig.organization,
         context: context3,
         sourceResolver: new SourceResolverImpl(context3, fernWorkspace),
@@ -957171,6 +957367,10 @@ async function getWorkspaceTempDir() {
   });
 }
 function getPublishConfig2({ generatorInvocation, org, version: version7, userProvidedVersion, packageName, context: context3, generateTests }) {
+  const publishLanguage = generatorInvocation.language ?? (0, import_autoversion4.extractLanguageFromGeneratorName)(generatorInvocation.name);
+  const substituteAutoVersion = (candidate) => candidate != null && (0, import_autoversion4.isAutoVersion)(candidate) ? (0, import_autoversion4.mapMagicVersionForLanguage)(import_autoversion4.MAGIC_VERSION, publishLanguage) : candidate;
+  const effectiveVersion = substituteAutoVersion(version7);
+  const effectiveUserProvidedVersion = substituteAutoVersion(userProvidedVersion);
   if (generatorInvocation.raw?.github != null && isGithubSelfhosted2(generatorInvocation.raw.github)) {
     const parsed = parseRepository(generatorInvocation.raw.github.uri);
     const irMode = generatorInvocation.raw.github.mode === "pull-request" ? "pull-request" : void 0;
@@ -957181,35 +957381,39 @@ function getPublishConfig2({ generatorInvocation, org, version: version7, userPr
       token: generatorInvocation.raw.github.token,
       mode: irMode,
       branch: generatorInvocation.raw.github.branch,
-      target: getPublishTarget({ outputSchema: generatorInvocation.raw.output, version: version7, packageName })
+      target: getPublishTarget({
+        outputSchema: generatorInvocation.raw.output,
+        version: effectiveVersion,
+        packageName
+      })
     });
   }
   if (generatorInvocation.raw?.output?.location === "local-file-system") {
     let publishTarget = void 0;
     if (generatorInvocation.language === "python") {
       publishTarget = PublishTarget.pypi({
-        version: version7,
+        version: effectiveVersion,
         packageName
       });
-      context3.logger.debug(`Created PyPiPublishTarget: version ${version7} package name: ${packageName}`);
+      context3.logger.debug(`Created PyPiPublishTarget: version ${effectiveVersion} package name: ${packageName}`);
     } else if (generatorInvocation.language === "typescript") {
-      if (userProvidedVersion != null) {
+      if (effectiveUserProvidedVersion != null) {
         const tsPackageName = packageName ?? (typeof generatorInvocation.raw?.config === "object" && generatorInvocation.raw?.config !== null ? generatorInvocation.raw.config.packageJson?.name : void 0);
         publishTarget = PublishTarget.npm({
-          version: userProvidedVersion,
+          version: effectiveUserProvidedVersion,
           packageName: tsPackageName,
           tokenEnvironmentVariable: ""
         });
-        context3.logger.debug(`Created NpmPublishTarget: version ${userProvidedVersion} package name: ${tsPackageName}`);
+        context3.logger.debug(`Created NpmPublishTarget: version ${effectiveUserProvidedVersion} package name: ${tsPackageName}`);
       }
     } else if (generatorInvocation.language === "rust") {
       publishTarget = PublishTarget.crates({
-        version: version7,
+        version: effectiveVersion,
         packageName
       });
-      context3.logger.debug(`Created CratesPublishTarget: version ${version7} package name: ${packageName}`);
+      context3.logger.debug(`Created CratesPublishTarget: version ${effectiveVersion} package name: ${packageName}`);
     } else if (generatorInvocation.language === "go") {
-      if (userProvidedVersion != null) {
+      if (effectiveUserProvidedVersion != null) {
         const goModulePath = (() => {
           const config5 = generatorInvocation.raw?.config;
           if (typeof config5 !== "object" || config5 === null) {
@@ -957222,10 +957426,10 @@ function getPublishConfig2({ generatorInvocation, org, version: version7, userPr
           return module4.path;
         })();
         publishTarget = PublishTarget.go({
-          version: userProvidedVersion,
+          version: effectiveUserProvidedVersion,
           modulePath: goModulePath
         });
-        context3.logger.debug(`Created GoPublishTarget: version ${userProvidedVersion} module path: ${goModulePath}`);
+        context3.logger.debug(`Created GoPublishTarget: version ${effectiveUserProvidedVersion} module path: ${goModulePath}`);
       }
     } else if (generatorInvocation.language === "java") {
       const config5 = generatorInvocation.raw?.config;
@@ -957251,7 +957455,7 @@ function getPublishConfig2({ generatorInvocation, org, version: version7, userPr
       })();
       const coordinate = mavenCoordinate ? `${mavenCoordinate.groupId}:${mavenCoordinate.artifactId}` : void 0;
       if (coordinate) {
-        const mavenVersion = version7 ?? "0.0.0";
+        const mavenVersion = effectiveVersion ?? "0.0.0";
         publishTarget = PublishTarget.maven({
           coordinate,
           version: mavenVersion,
@@ -957426,6 +957630,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),
@@ -969014,7 +969219,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.0"
+    cli_version: "5.68.0"
   };
 }
 function isAutomationMode() {
@@ -969846,7 +970051,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.67.0";
+    return "5.68.0";
   }
   getCliName() {
     if (false) {

package/package.json

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