@fern-api/fern-api-dev 4.58.0 → 4.60.0-2-g325260da1cd

package/cli.cjs

@@ -495612,6 +495612,7 @@ __export(DocsYmlSchemas_exports, {
   PageActionsConfig: () => PageActionsConfig,
   PageActionsThemeConfig: () => PageActionsThemeConfig,
   PageConfiguration: () => PageConfiguration,
+  PageDescriptionSource: () => PageDescriptionSource,
   PathLibraryInputSchema: () => PathLibraryInputSchema,
   PlaygroundButtonSettings: () => PlaygroundButtonSettings,
   PlaygroundSettings: () => PlaygroundSettings,
@@ -495819,8 +495820,10 @@ var AIChatWebsiteDatasource = external_exports.object({
   title: external_exports.string().optional()
 });
 var AIChatDatasource = AIChatWebsiteDatasource;
+var PageDescriptionSource = external_exports.enum(["description", "subtitle"]);
 var AgentsConfig = external_exports.object({
-  "page-directive": external_exports.string().optional()
+  "page-directive": external_exports.string().optional(),
+  "page-description-source": PageDescriptionSource.optional()
 });
 var AIChatConfig = external_exports.object({
   model: AIChatModel.optional(),
@@ -496383,6 +496386,7 @@ __export(schemas_exports7, {
   LibraryLanguage: () => LibraryLanguage2,
   PageActionOption: () => PageActionOption2,
   PageActionsThemeConfig: () => PageActionsThemeConfig2,
+  PageDescriptionSource: () => PageDescriptionSource2,
   ProductSwitcherThemeConfig: () => ProductSwitcherThemeConfig2,
   ProgrammingLanguage: () => ProgrammingLanguage2,
   SearchbarPlacement: () => SearchbarPlacement2,
@@ -496423,6 +496427,7 @@ __export(api_exports2, {
   LibraryLanguage: () => LibraryLanguage2,
   PageActionOption: () => PageActionOption2,
   PageActionsThemeConfig: () => PageActionsThemeConfig2,
+  PageDescriptionSource: () => PageDescriptionSource2,
   ProductSwitcherThemeConfig: () => ProductSwitcherThemeConfig2,
   ProgrammingLanguage: () => ProgrammingLanguage2,
   SearchbarPlacement: () => SearchbarPlacement2,
@@ -496460,6 +496465,7 @@ __export(docs_exports, {
   LibraryLanguage: () => LibraryLanguage2,
   PageActionOption: () => PageActionOption2,
   PageActionsThemeConfig: () => PageActionsThemeConfig2,
+  PageDescriptionSource: () => PageDescriptionSource2,
   ProductSwitcherThemeConfig: () => ProductSwitcherThemeConfig2,
   ProgrammingLanguage: () => ProgrammingLanguage2,
   SearchbarPlacement: () => SearchbarPlacement2,
@@ -496623,6 +496629,12 @@ var PageActionsThemeConfig2 = {
   Toolbar: "toolbar"
 };
 
+// ../configuration/lib/docs-yml/schemas/sdk/api/resources/docs/types/PageDescriptionSource.js
+var PageDescriptionSource2 = {
+  Description: "description",
+  Subtitle: "subtitle"
+};
+
 // ../configuration/lib/docs-yml/schemas/sdk/api/resources/docs/types/ProductSwitcherThemeConfig.js
 var ProductSwitcherThemeConfig2 = {
   Default: "default",
@@ -496999,6 +497011,7 @@ __export(serialization_exports3, {
   PageActionsConfig: () => PageActionsConfig2,
   PageActionsThemeConfig: () => PageActionsThemeConfig3,
   PageConfiguration: () => PageConfiguration2,
+  PageDescriptionSource: () => PageDescriptionSource3,
   PathLibraryInputSchema: () => PathLibraryInputSchema2,
   PlaygroundButtonSettings: () => PlaygroundButtonSettings2,
   PlaygroundSettings: () => PlaygroundSettings2,
@@ -497146,6 +497159,7 @@ __export(docs_exports2, {
   PageActionsConfig: () => PageActionsConfig2,
   PageActionsThemeConfig: () => PageActionsThemeConfig3,
   PageConfiguration: () => PageConfiguration2,
+  PageDescriptionSource: () => PageDescriptionSource3,
   PathLibraryInputSchema: () => PathLibraryInputSchema2,
   PlaygroundButtonSettings: () => PlaygroundButtonSettings2,
   PlaygroundSettings: () => PlaygroundSettings2,
@@ -498607,9 +498621,13 @@ var AbsoluteProductPath2 = schemas_exports6.object({
   href: schemas_exports6.string()
 });
 
+// ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/PageDescriptionSource.js
+var PageDescriptionSource3 = schemas_exports6.enum_(["description", "subtitle"]);
+
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/AgentsConfig.js
 var AgentsConfig2 = schemas_exports6.object({
-  pageDirective: schemas_exports6.property("page-directive", schemas_exports6.string().optional())
+  pageDirective: schemas_exports6.property("page-directive", schemas_exports6.string().optional()),
+  pageDescriptionSource: schemas_exports6.property("page-description-source", PageDescriptionSource3.optional())
 });
 
 // ../configuration/lib/docs-yml/schemas/sdk/serialization/resources/docs/types/AiChatWebsiteDatasource.js
@@ -499925,14 +499943,18 @@ __export(serialization_exports4, {
   AsyncApiSettingsSchema: () => AsyncApiSettingsSchema,
   AsyncApiSpecSchema: () => AsyncApiSpecSchema,
   BaseApiSettingsSchema: () => BaseApiSettingsSchema,
+  BaseGeneratorInvocationSchema: () => BaseGeneratorInvocationSchema,
   CoerceConstsTo: () => CoerceConstsTo2,
   ConjureSchema: () => ConjureSchema,
   CratesOutputLocationSchema: () => CratesOutputLocationSchema,
+  CustomGeneratorInvocationSchema: () => CustomGeneratorInvocationSchema,
+  DefaultGeneratorInvocationSchema: () => DefaultGeneratorInvocationSchema,
   DefaultIntegerFormat: () => DefaultIntegerFormat2,
   ExampleStyle: () => ExampleStyle4,
   FormParameterEncoding: () => FormParameterEncoding2,
   GeneratorApiSettingsSchema: () => GeneratorApiSettingsSchema,
   GeneratorGroupSchema: () => GeneratorGroupSchema,
+  GeneratorImageObjectSchema: () => GeneratorImageObjectSchema,
   GeneratorInvocationSchema: () => GeneratorInvocationSchema,
   GeneratorOutputSchema: () => GeneratorOutputSchema,
   GeneratorPublishMetadataSchema: () => GeneratorPublishMetadataSchema,
@@ -501908,6 +501930,7 @@ __export(generators_exports2, {
   DefaultIntegerFormat: () => DefaultIntegerFormat2,
   ExampleStyle: () => ExampleStyle4,
   FormParameterEncoding: () => FormParameterEncoding2,
+  GeneratorImageObjectSchema: () => GeneratorImageObjectSchema,
   GeneratorsConfigurationSchema: () => GeneratorsConfigurationSchema,
   GeneratorsOpenApiObjectSchema: () => GeneratorsOpenApiObjectSchema,
   GeneratorsOpenApiSchema: () => GeneratorsOpenApiSchema,
@@ -502179,6 +502202,12 @@ var ApiConfigurationSchema = schemas_exports8.undiscriminatedUnion([
 // ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/ExampleStyle.js
 var ExampleStyle4 = schemas_exports8.enum_(["minimal", "comprehensive"]);
 
+// ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/GeneratorImageObjectSchema.js
+var GeneratorImageObjectSchema = schemas_exports8.object({
+  name: schemas_exports8.string(),
+  registry: schemas_exports8.string()
+});
+
 // ../configuration/lib/generators-yml/schemas/serialization/resources/generators/types/OutputMetadataAuthor.js
 var OutputMetadataAuthor2 = schemas_exports8.object({
   name: schemas_exports8.string(),
@@ -502371,9 +502400,8 @@ var GithubConfigurationSchema = schemas_exports8.undiscriminatedUnion([
   GithubPushSchema
 ]);
 
-// ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/GeneratorInvocationSchema.js
-var GeneratorInvocationSchema = schemas_exports8.object({
-  name: schemas_exports8.string(),
+// ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/BaseGeneratorInvocationSchema.js
+var BaseGeneratorInvocationSchema = schemas_exports8.object({
   version: schemas_exports8.string(),
   output: GeneratorOutputSchema.optional(),
   github: GithubConfigurationSchema.optional(),
@@ -502389,6 +502417,19 @@ var GeneratorInvocationSchema = schemas_exports8.object({
   autorelease: schemas_exports8.boolean().optional()
 });
 
+// ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/CustomGeneratorInvocationSchema.js
+var CustomGeneratorInvocationSchema = schemas_exports8.object({
+  image: GeneratorImageObjectSchema
+}).extend(BaseGeneratorInvocationSchema);
+
+// ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/DefaultGeneratorInvocationSchema.js
+var DefaultGeneratorInvocationSchema = schemas_exports8.object({
+  name: schemas_exports8.string()
+}).extend(BaseGeneratorInvocationSchema);
+
+// ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/GeneratorInvocationSchema.js
+var GeneratorInvocationSchema = schemas_exports8.undiscriminatedUnion([DefaultGeneratorInvocationSchema, CustomGeneratorInvocationSchema]);
+
 // ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/GeneratorGroupSchema.js
 var GeneratorGroupSchema = schemas_exports8.object({
   audiences: schemas_exports8.list(schemas_exports8.string()).optional(),
@@ -502483,7 +502524,10 @@ var GeneratorsConfigurationSchema = schemas_exports8.object({
 // ../configuration/lib/generators-yml/schemas/serialization/resources/group/index.js
 var group_exports2 = {};
 __export(group_exports2, {
+  BaseGeneratorInvocationSchema: () => BaseGeneratorInvocationSchema,
   CratesOutputLocationSchema: () => CratesOutputLocationSchema,
+  CustomGeneratorInvocationSchema: () => CustomGeneratorInvocationSchema,
+  DefaultGeneratorInvocationSchema: () => DefaultGeneratorInvocationSchema,
   GeneratorApiSettingsSchema: () => GeneratorApiSettingsSchema,
   GeneratorGroupSchema: () => GeneratorGroupSchema,
   GeneratorInvocationSchema: () => GeneratorInvocationSchema,
@@ -535240,7 +535284,7 @@ async function addGenerator({ generatorName, generatorsConfiguration, groupName
     groupName,
     context: context3,
     update: async (group) => {
-      if (group.generators.some((generator) => addDefaultDockerOrgIfNotPresent(generator.name) === normalizedGeneratorName)) {
+      if (group.generators.some((generator) => addDefaultDockerOrgIfNotPresent("image" in generator ? generator.image.name : generator.name) === normalizedGeneratorName)) {
         context3.failAndThrow(`${generatorName} is already installed in group ${groupName}.`);
       }
       const latestVersion2 = await getLatestGeneratorVersion({
@@ -535702,12 +535746,28 @@ async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName,
     })))
   };
 }
-async function convertGenerator({ absolutePathToGeneratorsConfiguration, generator, maybeGroupLevelMetadata, maybeTopLevelMetadata, maybeGroupLevelReviewers, maybeTopLevelReviewers, readme, context: context3 }) {
+function getGeneratorNameAndImage(generator, context3) {
+  if ("image" in generator) {
+    const correctedImageName = correctIncorrectDockerOrgWithWarning(generator.image.name, context3);
+    const normalizedImageName = addDefaultDockerOrgIfNotPresent(correctedImageName);
+    return {
+      normalizedName: normalizedImageName,
+      containerImage: `${generator.image.registry}/${correctedImageName}`
+    };
+  }
   const correctedName = correctIncorrectDockerOrgWithWarning(generator.name, context3);
   const normalizedName = addDefaultDockerOrgIfNotPresent(correctedName);
+  return {
+    normalizedName,
+    containerImage: void 0
+  };
+}
+async function convertGenerator({ absolutePathToGeneratorsConfiguration, generator, maybeGroupLevelMetadata, maybeTopLevelMetadata, maybeGroupLevelReviewers, maybeTopLevelReviewers, readme, context: context3 }) {
+  const { normalizedName, containerImage } = getGeneratorNameAndImage(generator, context3);
   return {
     raw: generator,
     name: normalizedName,
+    containerImage,
     version: generator.version,
     config: generator.config,
     outputMode: await convertOutputMode({
@@ -595524,6 +595584,8 @@ __export(schemas_exports12, {
   FolderConfigurationSchema: () => FolderConfigurationSchema,
   FooterLinksConfigSchema: () => FooterLinksConfigSchema,
   FormParameterEncodingSchema: () => FormParameterEncodingSchema,
+  GeneratorImageObjectSchema: () => GeneratorImageObjectSchema2,
+  GeneratorImageSchema: () => GeneratorImageSchema,
   GitHubOutputModeSchema: () => GitHubOutputModeSchema,
   GitHubRepositoryOutputModeSchema: () => GitHubRepositoryOutputModeSchema,
   GitHubRepositoryOutputSchema: () => GitHubRepositoryOutputSchema,
@@ -596012,6 +596074,13 @@ var ReadmeSchema2 = external_exports.object({
   exampleStyle: ExampleStyleSchema.optional()
 });
 
+// ../config/lib/schemas/GeneratorImageSchema.js
+var GeneratorImageObjectSchema2 = external_exports.object({
+  name: external_exports.string(),
+  registry: external_exports.string()
+});
+var GeneratorImageSchema = external_exports.union([external_exports.string(), GeneratorImageObjectSchema2]);
+
 // ../config/lib/schemas/MetadataSchema.js
 var AuthorSchema = external_exports.object({
   name: external_exports.string(),
@@ -596141,7 +596210,7 @@ var PublishSchema = external_exports.object({
 var SdkTargetSchema = external_exports.object({
   api: external_exports.string().optional(),
   lang: SdkTargetLanguageSchema.optional(),
-  image: external_exports.string().optional(),
+  image: GeneratorImageSchema.optional(),
   version: external_exports.string().optional(),
   config: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   publish: PublishSchema.optional(),
@@ -602681,7 +602750,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.58.0",
+          version: "4.60.0-2-g325260da1cd",
           usingAccessToken: true
         }
       });
@@ -602732,7 +602801,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.58.0",
+        version: "4.60.0-2-g325260da1cd",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -627403,6 +627472,7 @@ var SdkConfigConverter = class {
       name: name2,
       lang: generatorInfo.lang,
       image: generatorInfo.image,
+      registry: generatorInfo.registry,
       version: generatorInfo.version,
       api: this.resolveApi({ api: target.api }),
       sourceLocation: sourced.$loc,
@@ -627438,11 +627508,28 @@ var SdkConfigConverter = class {
     if (lang == null) {
       return void 0;
     }
+    if (target.image != null) {
+      if (typeof target.image === "string") {
+        return {
+          lang,
+          image: addDefaultDockerOrgIfNotPresent(target.image),
+          version: target.version ?? "latest",
+          registry: void 0
+        };
+      }
+      return {
+        lang,
+        image: addDefaultDockerOrgIfNotPresent(target.image.name),
+        version: target.version ?? "latest",
+        registry: target.image.registry
+      };
+    }
     const resolvedDockerImage = getImageReferenceFromLanguage({ lang, version: target.version });
     return {
       lang,
       image: resolvedDockerImage.image,
-      version: resolvedDockerImage.tag
+      version: resolvedDockerImage.tag,
+      registry: void 0
     };
   }
   convertConfig(config5) {
@@ -627453,7 +627540,8 @@ var SdkConfigConverter = class {
       return target.lang;
     }
     if (target.image != null) {
-      return getLanguageFromImage({ image: target.image });
+      const imageName = typeof target.image === "string" ? target.image : target.image.name;
+      return getLanguageFromImage({ image: addDefaultDockerOrgIfNotPresent(imageName) });
     }
     const lang = name2;
     if (LANGUAGES.includes(lang)) {
@@ -837241,18 +837329,19 @@ function convertSdkTargetsFromRaw(options2) {
 }
 function convertRawGeneratorToTarget(options2) {
   const { generator, groupName, languageCounts, apiName, warnings } = options2;
-  if (generator.name == null) {
+  const generatorName = generator.name ?? generator.image?.name;
+  if (generatorName == null) {
     warnings.push({
       type: "conflict",
-      message: "Generator missing 'name' field"
+      message: "Generator missing 'name' or 'image.name' field"
     });
     return void 0;
   }
-  const language = getLanguageFromGeneratorName2(generator.name);
+  const language = getLanguageFromGeneratorName2(generatorName);
   if (language == null) {
     warnings.push({
       type: "unsupported",
-      message: `Unknown generator: ${generator.name}`,
+      message: `Unknown generator: ${generatorName}`,
       suggestion: "Manually add this generator to your fern.yml"
     });
     return void 0;
@@ -837264,6 +837353,12 @@ function convertRawGeneratorToTarget(options2) {
   const target = {
     output: {}
   };
+  if (generator.image != null) {
+    target.image = {
+      name: generator.image.name,
+      registry: generator.image.registry
+    };
+  }
   target.lang = language;
   if (apiName != null) {
     target.api = apiName;
@@ -839962,7 +840057,7 @@ var import_path54 = __toESM(require("path"), 1);
 var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 function getCliSource() {
-  const version7 = "4.58.0";
+  const version7 = "4.60.0-2-g325260da1cd";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -842259,7 +842354,7 @@ async function visitGeneratorGroup({ group, visitor, nodePath, cliVersion }) {
     ...nodePath,
     "generators",
     idx.toString(),
-    generator.name
+    "image" in generator ? generator.image.name : generator.name
   ])));
 }
 
@@ -842345,13 +842440,14 @@ var CompatibleIrVersionsRule = {
             return [];
           }
           const cliIrVersion = cliRelease.body.irVersion;
+          const invocationName = "image" in invocation ? invocation.image.name : invocation.name;
           let invocationIrVersion;
           if (invocation["ir-version"] != null) {
             invocationIrVersion = getOverriddenIrVersion(invocation["ir-version"]);
           } else {
             const normalizedInvocation = {
               ...invocation,
-              name: addDefaultDockerOrgIfNotPresent(invocation.name)
+              name: addDefaultDockerOrgIfNotPresent(invocationName)
             };
             const maybeIrVersion = await getIrVersionForGenerator(normalizedInvocation);
             if (maybeIrVersion == null) {
@@ -842364,7 +842460,7 @@ var CompatibleIrVersionsRule = {
           }
           const minCliVersion = await fdr.generators.cli.getMinCliForIr(invocationIrVersion);
           if (minCliVersion.ok) {
-            return getMaybeBadVersionMessage(invocation.name, minCliVersion.body.version, cliVersion) ?? [];
+            return getMaybeBadVersionMessage(invocationName, minCliVersion.body.version, cliVersion) ?? [];
           } else {
             return [];
           }
@@ -847330,6 +847426,13 @@ var definitions6 = {
     },
     additionalProperties: false
   },
+  "docs.PageDescriptionSource": {
+    type: "string",
+    enum: [
+      "description",
+      "subtitle"
+    ]
+  },
   "docs.AgentsConfig": {
     type: "object",
     properties: {
@@ -847342,6 +847445,16 @@ var definitions6 = {
             type: "null"
           }
         ]
+      },
+      "page-description-source": {
+        oneOf: [
+          {
+            $ref: "#/definitions/docs.PageDescriptionSource"
+          },
+          {
+            type: "null"
+          }
+        ]
       }
     },
     additionalProperties: false
@@ -851063,7 +851176,7 @@ var LegacyDocsPublisher = class {
         previewId: void 0,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.58.0"
+        cliVersion: "4.60.0-2-g325260da1cd"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -876262,7 +876375,8 @@ var BaseJavaCustomConfigSchema = external_exports2.object({
   // Hidden options (for debugging).
   "enable-gradle-profiling": external_exports2.boolean().optional(),
   // Deprecated.
-  "wrapped-aliases": external_exports2.boolean().optional()
+  "wrapped-aliases": external_exports2.boolean().optional(),
+  maxRetries: external_exports2.number().int().min(0).optional()
 });
 
 // ../../../generators/java-v2/ast/lib/java.js
@@ -894511,6 +894625,11 @@ var NameRegistry2 = class _NameRegistry {
         const symbolId = this.symbolRegistry.inferSymbolIdForSourceModuleType(templateId);
         return swift_exports.Symbol.create(symbolId, templateId, { type: "class" });
       }
+      case "ClientConfig": {
+        const symbol3 = this.sourceStaticSymbolsByName.get(templateId);
+        assertDefined(symbol3, `Source template symbol not found for name "${templateId}"`);
+        return symbol3;
+      }
       default:
         assertNever(templateId);
     }
@@ -896690,11 +896809,6 @@ var SourceAsIsFileSpecs = {
     filenameWithoutExtension: "CalendarDate",
     symbols: [{ name: "CalendarDate", shape: { type: "struct" } }]
   },
-  ClientConfig: {
-    relativePathToDir: "Public",
-    filenameWithoutExtension: "ClientConfig",
-    symbols: [{ name: "ClientConfig", shape: { type: "class" } }]
-  },
   FormFile: {
     relativePathToDir: "Public",
     filenameWithoutExtension: "FormFile",
@@ -897164,6 +897278,11 @@ var SourceTemplateFileSpecs = {
   HTTPClient: {
     relativePath: "Core/Networking",
     filenameWithoutExtension: () => "HTTPClient"
+  },
+  // Public
+  ClientConfig: {
+    relativePath: "Public",
+    filenameWithoutExtension: () => "ClientConfig"
   }
 };
 
@@ -897937,6 +898056,9 @@ var DynamicSnippetsGeneratorContext8 = class _DynamicSnippetsGeneratorContext ex
         case "HTTPClient":
           nameRegistry.registerSourceStaticSymbol(templateId, { type: "class" });
           break;
+        case "ClientConfig":
+          nameRegistry.registerSourceStaticSymbol(templateId, { type: "class" });
+          break;
         default:
           assertNever(templateId);
       }
@@ -902577,7 +902699,7 @@ async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFer
     context3.logger.debug("Will write snippet-templates.json to: " + absolutePathToTmpSnippetTemplatesJSON);
   }
   const environment2 = executionEnvironment ?? new ContainerExecutionEnvironment({
-    containerImage: `${generatorInvocation.name}:${generatorInvocation.version}`,
+    containerImage: generatorInvocation.containerImage ? `${generatorInvocation.containerImage}:${generatorInvocation.version}` : `${generatorInvocation.name}:${generatorInvocation.version}`,
     keepContainer: keepDocker
   });
   const paths = environment2.usesContainerPaths ? {
@@ -903109,7 +903231,7 @@ var GenerationRunner = class {
   constructor(executionEnvironment) {
     this.executionEnvironment = executionEnvironment;
   }
-  async run({ organization, absolutePathToFernConfig, workspace, generatorGroup, context: context3, irVersionOverride, outputVersionOverride, shouldGenerateDynamicSnippetTests, skipUnstableDynamicSnippetTests, inspect: inspect6, skipFernignore }) {
+  async run({ organization, absolutePathToFernConfig, workspace, generatorGroup, context: context3, irVersionOverride, outputVersionOverride, shouldGenerateDynamicSnippetTests, skipUnstableDynamicSnippetTests, inspect: inspect6, skipFernignore, skipAutogenerationIfManualExamplesExist }) {
     const results = await Promise.all(generatorGroup.generators.map(async (generatorInvocation) => {
       return context3.runInteractiveTask({ name: generatorInvocation.name }, async (interactiveTaskContext) => {
         if (generatorInvocation.absolutePathToLocalOutput == null) {
@@ -903127,7 +903249,8 @@ var GenerationRunner = class {
             outputVersionOverride,
             absolutePathToFernConfig,
             inspect: inspect6,
-            skipFernignore
+            skipFernignore,
+            skipAutogenerationIfManualExamplesExist
           });
           interactiveTaskContext.logger.info(source_default.green("Wrote files to " + generatorInvocation.absolutePathToLocalOutput));
           if (shouldGenerateDynamicSnippetTests && generatorInvocation.language != null) {
@@ -903154,7 +903277,7 @@ var GenerationRunner = class {
       });
     }));
   }
-  async executeGenerator({ generatorGroup, generatorInvocation, context: context3, workspace, organization, irVersionOverride, outputVersionOverride, absolutePathToFernConfig, inspect: inspect6, skipFernignore }) {
+  async executeGenerator({ generatorGroup, generatorInvocation, context: context3, workspace, organization, irVersionOverride, outputVersionOverride, absolutePathToFernConfig, inspect: inspect6, skipFernignore, skipAutogenerationIfManualExamplesExist }) {
     context3.logger.info(`Starting generation for ${generatorInvocation.name}`);
     if (generatorInvocation.absolutePathToLocalOutput == null) {
       throw new Error("Output path is required for generation");
@@ -903167,7 +903290,8 @@ var GenerationRunner = class {
       smartCasing: generatorInvocation.smartCasing,
       exampleGeneration: {
         includeOptionalRequestPropertyExamples: true,
-        disabled: generatorInvocation.disableExamples
+        disabled: generatorInvocation.disableExamples,
+        skipAutogenerationIfManualExamplesExist: skipAutogenerationIfManualExamplesExist ?? false
       },
       readme: generatorInvocation.readme,
       version: outputVersionOverride,
@@ -903231,6 +903355,7 @@ var LegacyGeneratorInvocationAdapter = class {
     return {
       raw: this.buildRaw(target),
       name: target.image,
+      containerImage: target.registry ? `${target.registry}/${removeDefaultDockerOrgIfPresent(target.image)}` : void 0,
       version: target.version,
       config: target.config,
       language: this.mapLanguage(target.lang),
@@ -903653,7 +903778,8 @@ var LegacyLocalGenerationRunner = class {
     };
   }
   async runLocalGeneration({ args, taskContext, fernWorkspace, generatorGroup, generatorInvocation }) {
-    const containerImage = `${args.target.image}:${args.target.version}`;
+    const imageRef = args.target.registry ? `${args.target.registry}/${removeDefaultDockerOrgIfPresent(args.target.image)}` : args.target.image;
+    const containerImage = `${imageRef}:${args.target.version}`;
     const executionEnvironment = new ContainerExecutionEnvironment({
       containerImage,
       keepContainer: args.keepContainer ?? false,
@@ -903846,6 +903972,11 @@ var GeneratorPipeline = class {
       if (this.isLocalGeneration(args)) {
         return await this.runLocalGeneration(args);
       }
+      if (args.target.registry != null) {
+        throw new CliError({
+          message: `Custom image configurations are only supported with local generation (--local). Target "${args.target.name}" uses a custom image registry.`
+        });
+      }
       return await this.runRemoteGeneration(args);
     } catch (error50) {
       const message = extractErrorMessage(error50);
@@ -904072,6 +904203,7 @@ var WorkspaceBuilder = class {
       name: lang,
       api: DEFAULT_API_NAME,
       image: imageRef.image,
+      registry: void 0,
       lang,
       version: imageRef.tag,
       sourceLocation,
@@ -904683,11 +904815,12 @@ var GeneratorMigrator = class _GeneratorMigrator {
    * migration system expects.
    */
   toGeneratorInvocationSchema(target) {
-    return {
+    const invocation = {
       name: target.image,
       version: target.version,
       config: target.config
     };
+    return invocation;
   }
   /**
    * Applies the migrated `config` field back to the YAML document via
@@ -924217,7 +924350,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.58.0";
+    return "4.60.0-2-g325260da1cd";
   }
   getCliName() {
     if (false) {
@@ -925026,7 +925159,12 @@ Please report this issue at: https://github.com/fern-api/fern/issues`
   };
 }
 function isValidGeneratorConfig(config5) {
-  return typeof config5 === "object" && config5 != null && "name" in config5 && typeof config5.name === "string";
+  if (typeof config5 !== "object" || config5 == null) {
+    return false;
+  }
+  const hasValidName = "name" in config5 && typeof config5.name === "string";
+  const hasValidImage = "image" in config5 && config5.image != null && typeof config5.image === "object";
+  return hasValidName || hasValidImage;
 }
 async function loadAndRunMigrations(params2) {
   const { generatorName, from: from4, to: to8, config: config5, logger: logger4 } = params2;
@@ -925034,7 +925172,7 @@ async function loadAndRunMigrations(params2) {
     throw new Error(
       `Invalid generator configuration for ${generatorName}.
 
-The generator configuration must be an object with a 'name' property, but the current configuration does not match this structure. This may indicate a malformed generators.yml file.
+The generator configuration must be an object with either a 'name' property or an 'image' property, but the current configuration does not match this structure. This may indicate a malformed generators.yml file.
 
 Please check your generators.yml file and ensure the generator is properly configured.`
     );
@@ -925143,6 +925281,14 @@ async function loadAndUpdateGenerators({
           `Expected generator in group ${groupName} to be a map in ${import_path79.default.relative(process.cwd(), filepath)}`
         );
       }
+      if (generator.get("image") != null) {
+        const imageNode = generator.get("image");
+        const imageName = import_yaml6.default.isMap(imageNode) ? imageNode.get("name") : "unknown";
+        context3.logger.warn(
+          `Skipping custom image generator "${imageName}" in group ${groupName}: generators using a custom image cannot be auto-upgraded.`
+        );
+        continue;
+      }
       const generatorName = generator.get("name");
       const normalizedGeneratorName = normalizeGeneratorName(generatorName);
       if (normalizedGeneratorName == null) {
@@ -933515,6 +933661,13 @@ async function generateWorkspace({
           skipFernignore
         });
       } else if (token != null) {
+        const customImageGenerators = group.generators.filter((g19) => g19.containerImage != null);
+        if (customImageGenerators.length > 0) {
+          const names2 = customImageGenerators.map((g19) => g19.name).join(", ");
+          return context3.failAndThrow(
+            `Custom image configurations are only supported with local generation (--local). The following generators use custom images: ${names2}`
+          );
+        }
         await runRemoteGenerationForAPIWorkspace({
           projectConfig,
           organization,
@@ -937299,7 +937452,7 @@ async function getFernDirectory9() {
 }
 
 // ../cli-migrations/lib/migrations/0.0.241/add-generator-groups/old-generators-configuration/BaseGeneratorInvocationSchema.js
-var BaseGeneratorInvocationSchema = external_exports2.strictObject({
+var BaseGeneratorInvocationSchema2 = external_exports2.strictObject({
   name: external_exports2.string(),
   version: external_exports2.string(),
   config: external_exports2.unknown(),
@@ -937307,7 +937460,7 @@ var BaseGeneratorInvocationSchema = external_exports2.strictObject({
 });
 
 // ../cli-migrations/lib/migrations/0.0.241/add-generator-groups/old-generators-configuration/DraftGeneratorInvocationSchema.js
-var DraftGeneratorInvocationSchema = BaseGeneratorInvocationSchema.extend({
+var DraftGeneratorInvocationSchema = BaseGeneratorInvocationSchema2.extend({
   mode: external_exports2.union([external_exports2.literal("publish"), external_exports2.literal("download-files")]),
   "output-path": external_exports2.optional(external_exports2.string())
 });
@@ -937354,7 +937507,7 @@ var GithubRepositoryOutputSchema = external_exports2.strictObject({
 });
 
 // ../cli-migrations/lib/migrations/0.0.241/add-generator-groups/old-generators-configuration/ReleaseGeneratorInvocationSchema.js
-var ReleaseGeneratorInvocationSchema = BaseGeneratorInvocationSchema.extend({
+var ReleaseGeneratorInvocationSchema = BaseGeneratorInvocationSchema2.extend({
   publishing: external_exports2.optional(GeneratorPublishingSchema),
   github: external_exports2.optional(GithubRepositoryOutputSchema)
 });

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.58.0",
+  "version": "4.60.0-2-g325260da1cd",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",