@fern-api/fern-api-dev 4.81.1 → 4.82.0-3-gc1f31446d2e

package/cli.cjs

@@ -469477,6 +469477,7 @@ var CliError = class _CliError extends Error {
     NetworkError: "NETWORK_ERROR",
     AuthError: "AUTH_ERROR",
     ConfigError: "CONFIG_ERROR",
+    UserError: "USER_ERROR",
     Unclassified: "UNCLASSIFIED"
   };
 })(CliError || (CliError = {}));
@@ -469493,6 +469494,7 @@ var SENTRY_REPORTABLE = {
   [CliError.Code.NetworkError]: false,
   [CliError.Code.AuthError]: false,
   [CliError.Code.ConfigError]: false,
+  [CliError.Code.UserError]: false,
   [CliError.Code.Unclassified]: false
 };
 function shouldReportToSentry(code5) {
@@ -486635,7 +486637,7 @@ async function checkVersionDoesNotAlreadyExist({ version: version7, packageName,
   }
   if (exists2) {
     if (isPublishMode) {
-      context3.failAndThrow(`Version ${version7} of ${resolvedPackageName} already exists on the ${getRegistryName(language)} registry. Please use a different version number. If you want to automatically increment the version, omit the --version flag.`);
+      context3.failAndThrow(`Version ${version7} of ${resolvedPackageName} already exists on the ${getRegistryName(language)} registry. Please use a different version number. If you want to automatically increment the version, omit the --version flag.`, void 0, { code: CliError.Code.VersionError });
     } else {
       context3.logger.warn(`Version ${version7} of ${resolvedPackageName} already exists on the ${getRegistryName(language)} registry. If your CI pipeline publishes this version, it may fail.`);
     }
@@ -518573,13 +518575,13 @@ function convertToHttpMethod(httpMethod) {
     delete: () => schemas_exports2.HttpMethodSchema.Delete,
     head: () => schemas_exports2.HttpMethodSchema.Head,
     options: () => {
-      throw new Error("OPTIONS is unsupported");
+      throw new CliError({ message: "OPTIONS is unsupported", code: CliError.Code.ConfigError });
     },
     trace: () => {
-      throw new Error("TRACE is unsupported");
+      throw new CliError({ message: "TRACE is unsupported", code: CliError.Code.ConfigError });
     },
     _other: () => {
-      throw new Error("Unknown http method is unsupported");
+      throw new CliError({ message: "Unknown http method is unsupported", code: CliError.Code.ConfigError });
     }
   });
 }
@@ -518813,7 +518815,10 @@ function buildEndpoint({ endpoint: endpoint3, declarationFile, context: context3
         };
       },
       _other: () => {
-        throw new Error("Unrecognized Response type: " + endpoint3.response?.type);
+        throw new CliError({
+          message: "Unrecognized Response type: " + endpoint3.response?.type,
+          code: CliError.Code.InternalError
+        });
       }
     });
   }
@@ -519343,7 +519348,10 @@ function getUnresolvedEndpointLocation(endpoint3) {
     }
   }
   if (fileParts.length >= operationIdTokens.length) {
-    throw new Error(`Cannot get file for endpoint ${JSON.stringify(endpoint3)}`);
+    throw new CliError({
+      message: `Cannot get file for endpoint ${JSON.stringify(endpoint3)}`,
+      code: CliError.Code.InternalError
+    });
   }
   return {
     file: RelativeFilePath.of(camelCase_default(fileParts.join("_")) + ".yml"),
@@ -519585,7 +519593,10 @@ function buildWebhooks(context3) {
           };
         },
         _other: () => {
-          throw new Error("Unrecognized Response type: " + webhook.response?.type);
+          throw new CliError({
+            message: "Unrecognized Response type: " + webhook.response?.type,
+            code: CliError.Code.InternalError
+          });
         }
       });
     }
@@ -520177,7 +520188,10 @@ var FernDefinitionDirectory = class _FernDefinitionDirectory {
     }
     const [directory, ...remainingPath] = pathParts;
     if (directory == null) {
-      throw new Error(`Internal error; cannot add file with path: ${pathParts}`);
+      throw new CliError({
+        message: `Internal error; cannot add file with path: ${pathParts}`,
+        code: CliError.Code.InternalError
+      });
     }
     if (!this.directories[directory]) {
       this.directories[directory] = new _FernDefinitionDirectory();
@@ -524639,7 +524653,10 @@ function getSchemaFromFernType({ fernType, nameOverride, generatedName, title: t
           string: (value2) => LiteralSchemaValue.string(value2),
           boolean: (value2) => LiteralSchemaValue.boolean(value2),
           _other: () => {
-            throw new Error("Unexpected literal type");
+            throw new CliError({
+              message: "Unexpected literal type",
+              code: CliError.Code.InternalError
+            });
           }
         }),
         description,
@@ -527796,7 +527813,10 @@ function convertToReferencedSchema(schema2, breadcrumbs, source2, preserveSchema
   const availability = convertAvailability2(schema2);
   const schemaId = getSchemaIdFromReference(schema2);
   if (schemaId == null) {
-    throw new Error(`Invalid schema reference ${JSON.stringify(schema2)}`);
+    throw new CliError({
+      message: `Invalid schema reference ${JSON.stringify(schema2)}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return Schema.reference({
     // TODO(dsinghvi): references may contain files
@@ -528125,21 +528145,33 @@ var AbstractAsyncAPIParserContext = class {
    */
   resolveSchemaReference(schema2) {
     if (!schema2.$ref.startsWith(SCHEMA_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve schema reference: ${schema2.$ref}`);
+      throw new CliError({
+        message: `Failed to resolve schema reference: ${schema2.$ref}`,
+        code: CliError.Code.ReferenceError
+      });
     }
     const schemaKey = schema2.$ref.substring(SCHEMA_REFERENCE_PREFIX.length);
     const splitSchemaKey = schemaKey.split("/");
     const components = this.document.components;
     if (components == null || components.schemas == null) {
-      throw new Error("Document does not have components.schemas.");
+      throw new CliError({
+        message: "Document does not have components.schemas.",
+        code: CliError.Code.ReferenceError
+      });
     }
     const [topKey, maybeProps, maybePropKey] = splitSchemaKey;
     if (topKey == null || topKey === "") {
-      throw new Error(`${schema2.$ref} cannot be resolved. No schema key provided.`);
+      throw new CliError({
+        message: `${schema2.$ref} cannot be resolved. No schema key provided.`,
+        code: CliError.Code.ReferenceError
+      });
     }
     let resolvedSchema = components.schemas[topKey];
     if (resolvedSchema == null) {
-      throw new Error(`Schema "${topKey}" is undefined in document.components.schemas.`);
+      throw new CliError({
+        message: `Schema "${topKey}" is undefined in document.components.schemas.`,
+        code: CliError.Code.ReferenceError
+      });
     }
     if (isReferenceObject(resolvedSchema)) {
       resolvedSchema = this.resolveSchemaReference(resolvedSchema);
@@ -528147,7 +528179,10 @@ var AbstractAsyncAPIParserContext = class {
     if (maybeProps === "properties" && maybePropKey != null) {
       const resolvedProperty = resolvedSchema.properties?.[maybePropKey];
       if (resolvedProperty == null) {
-        throw new Error(`Property "${maybePropKey}" not found on "${topKey}". Full ref: ${schema2.$ref}`);
+        throw new CliError({
+          message: `Property "${maybePropKey}" not found on "${topKey}". Full ref: ${schema2.$ref}`,
+          code: CliError.Code.ReferenceError
+        });
       } else if (isReferenceObject(resolvedProperty)) {
         resolvedSchema = this.resolveSchemaReference(resolvedProperty);
       } else {
@@ -528200,12 +528235,15 @@ var AsyncAPIV2ParserContext = class extends AbstractAsyncAPIParserContext {
     const MESSAGE_REFERENCE_PREFIX = "#/components/messages/";
     const components = this.document.components;
     if (components == null || components.messages == null || !message.$ref.startsWith(MESSAGE_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve message reference: ${message.$ref} in v2 components`);
+      throw new CliError({
+        message: `Failed to resolve message reference: ${message.$ref} in v2 components`,
+        code: CliError.Code.ReferenceError
+      });
     }
     const messageKey = message.$ref.substring(MESSAGE_REFERENCE_PREFIX.length);
     const resolvedMessage = components.messages[messageKey];
     if (resolvedMessage == null) {
-      throw new Error(`${message.$ref} is undefined`);
+      throw new CliError({ message: `${message.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     return resolvedMessage;
   }
@@ -529037,7 +529075,10 @@ var ExampleTypeFactory = class _ExampleTypeFactory {
     while (schema2.type === "reference") {
       const resolvedSchema = this.schemas[schema2.schema];
       if (resolvedSchema == null) {
-        throw new Error(`Unexpected error: Failed to resolve schema reference: ${schema2.schema}`);
+        throw new CliError({
+          message: `Unexpected error: Failed to resolve schema reference: ${schema2.schema}`,
+          code: CliError.Code.InternalError
+        });
       }
       schema2 = resolvedSchema;
     }
@@ -530366,7 +530407,10 @@ var ExampleWebsocketSessionFactory = class {
     while (schema2.type === "reference") {
       const resolvedSchema = this.schemas[schema2.schema];
       if (resolvedSchema == null) {
-        throw new Error(`Unexpected error: Failed to resolve schema reference: ${schema2.schema}`);
+        throw new CliError({
+          message: `Unexpected error: Failed to resolve schema reference: ${schema2.schema}`,
+          code: CliError.Code.InternalError
+        });
       }
       schema2 = resolvedSchema;
     }
@@ -530876,7 +530920,10 @@ var AsyncAPIV3ParserContext = class extends AbstractAsyncAPIParserContext {
   getExampleMessageReference(message) {
     const channelId = message.channelId ?? this.getDefaultChannelId();
     if (channelId == null) {
-      throw new Error(`Cannot resolve example message reference: no channelId provided and no channels found in document`);
+      throw new CliError({
+        message: `Cannot resolve example message reference: no channelId provided and no channels found in document`,
+        code: CliError.Code.InternalError
+      });
     }
     return `#/channels/${channelId}/messages/${message.messageId}`;
   }
@@ -530891,12 +530938,12 @@ var AsyncAPIV3ParserContext = class extends AbstractAsyncAPIParserContext {
   resolveParameterReference(parameter6) {
     const PARAMETER_REFERENCE_PREFIX2 = "#/components/parameters/";
     if (this.document.components == null || this.document.components.parameters == null || !parameter6.$ref.startsWith(PARAMETER_REFERENCE_PREFIX2)) {
-      throw new Error(`Failed to resolve ${parameter6.$ref}`);
+      throw new CliError({ message: `Failed to resolve ${parameter6.$ref}`, code: CliError.Code.ReferenceError });
     }
     const parameterKey = parameter6.$ref.substring(PARAMETER_REFERENCE_PREFIX2.length);
     const resolvedParameter = this.document.components.parameters[parameterKey];
     if (resolvedParameter == null) {
-      throw new Error(`${parameter6.$ref} is undefined`);
+      throw new CliError({ message: `${parameter6.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     if ("$ref" in resolvedParameter) {
       return this.resolveParameterReference(resolvedParameter);
@@ -530908,10 +530955,16 @@ var AsyncAPIV3ParserContext = class extends AbstractAsyncAPIParserContext {
     const CHANNELS_PATH_PART = "#/channels/";
     const MESSAGE_REFERENCE_PREFIX = "#/components/messages/";
     if (message == null) {
-      throw new Error("Cannot resolve message reference: message is null or undefined");
+      throw new CliError({
+        message: "Cannot resolve message reference: message is null or undefined",
+        code: CliError.Code.InternalError
+      });
     }
     if (!message.$ref) {
-      throw new Error("Cannot resolve message reference: message.$ref is undefined or empty");
+      throw new CliError({
+        message: "Cannot resolve message reference: message.$ref is undefined or empty",
+        code: CliError.Code.ReferenceError
+      });
     }
     if (message.$ref.startsWith(CHANNELS_PATH_PART)) {
       const parts = message.$ref.split("/");
@@ -530919,12 +530972,15 @@ var AsyncAPIV3ParserContext = class extends AbstractAsyncAPIParserContext {
       const messageKey2 = parts[4];
       const channelPath = rawChannelPath?.replace(/~1/g, "/").replace(/~0/g, "~");
       if (channelPath == null || messageKey2 == null || !this.document.channels?.[channelPath]) {
-        throw new Error(`Failed to resolve message reference ${message.$ref} in channel ${channelPath}`);
+        throw new CliError({
+          message: `Failed to resolve message reference ${message.$ref} in channel ${channelPath}`,
+          code: CliError.Code.ReferenceError
+        });
       }
       const channel3 = this.document.channels[channelPath];
       const resolvedInChannel = channel3.messages?.[messageKey2];
       if (resolvedInChannel == null) {
-        throw new Error(`${message.$ref} is undefined`);
+        throw new CliError({ message: `${message.$ref} is undefined`, code: CliError.Code.ReferenceError });
       }
       if ("$ref" in resolvedInChannel && !shallow) {
         return this.resolveMessageReference(resolvedInChannel);
@@ -530937,12 +530993,15 @@ var AsyncAPIV3ParserContext = class extends AbstractAsyncAPIParserContext {
     }
     const components = this.document.components;
     if (!message.$ref.startsWith(MESSAGE_REFERENCE_PREFIX) || !components?.messages) {
-      throw new Error(`Failed to resolve message reference: ${message.$ref} in v3 components`);
+      throw new CliError({
+        message: `Failed to resolve message reference: ${message.$ref} in v3 components`,
+        code: CliError.Code.ReferenceError
+      });
     }
     const messageKey = message.$ref.substring(MESSAGE_REFERENCE_PREFIX.length);
     const resolvedInComponents = components.messages[messageKey];
     if (resolvedInComponents == null) {
-      throw new Error(`${message.$ref} is undefined`);
+      throw new CliError({ message: `${message.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     return {
       ...resolvedInComponents,
@@ -531065,14 +531124,20 @@ function parseAsyncAPIV3({ context: context3, breadcrumbs, source: source2, asyn
     }));
     const channelEvent = channelEvents[channelPath];
     if (channelEvent == null) {
-      throw new Error(`Internal error: channelEvents["${channelPath}"] is unexpectedly undefined for operation ${operationId}`);
+      throw new CliError({
+        message: `Internal error: channelEvents["${channelPath}"] is unexpectedly undefined for operation ${operationId}`,
+        code: CliError.Code.InternalError
+      });
     }
     if (operation.action === "receive") {
       channelEvent.subscribe.push(...messagesWithMethodName);
     } else if (operation.action === "send") {
       channelEvent.publish.push(...messagesWithMethodName);
     } else {
-      throw new Error(`Operation ${operationId} has an invalid action: ${operation.action}`);
+      throw new CliError({
+        message: `Operation ${operationId} has an invalid action: ${operation.action}`,
+        code: CliError.Code.ValidationError
+      });
     }
   }
   for (const [channelPath, events] of Object.entries(channelEvents)) {
@@ -531336,42 +531401,63 @@ function decodeJsonPointerSegment(segment) {
 }
 function getChannelPathFromOperation(operation) {
   if (!operation.channel) {
-    throw new Error("Operation is missing required 'channel' field");
+    throw new CliError({
+      message: "Operation is missing required 'channel' field",
+      code: CliError.Code.ValidationError
+    });
   }
   if (!operation.channel.$ref) {
-    throw new Error("Operation channel is missing required '$ref' field");
+    throw new CliError({
+      message: "Operation channel is missing required '$ref' field",
+      code: CliError.Code.ValidationError
+    });
   }
   if (!operation.channel.$ref.startsWith(CHANNEL_REFERENCE_PREFIX)) {
-    throw new Error(`Failed to resolve channel path from operation ${operation.channel.$ref}`);
+    throw new CliError({
+      message: `Failed to resolve channel path from operation ${operation.channel.$ref}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return decodeJsonPointerSegment(operation.channel.$ref.substring(CHANNEL_REFERENCE_PREFIX.length));
 }
 function convertChannelParameterLocation(location2) {
-  try {
-    const [messageType, parameterKey] = location2.split("#/");
-    if (messageType == null || parameterKey == null) {
-      throw new Error(`Invalid location format: ${location2}; unable to parse message type and parameter key`);
-    }
-    if (!messageType.startsWith(LOCATION_PREFIX)) {
-      throw new Error(`Invalid location format: ${location2}; expected ${LOCATION_PREFIX} prefix`);
-    }
-    const type8 = messageType.substring(LOCATION_PREFIX.length);
-    if (type8 !== "header" && type8 !== "path" && type8 !== "payload") {
-      throw new Error(`Invalid message type: ${type8}. Must be one of: header, path, payload`);
-    }
-    return { type: type8, parameterKey };
-  } catch (error50) {
-    throw new Error(`Invalid location format: ${location2}; see here for more details: https://www.asyncapi.com/docs/reference/specification/v3.0.0#runtimeExpression`);
+  const ASYNCAPI_RUNTIME_EXPRESSION_DOCS = "https://www.asyncapi.com/docs/reference/specification/v3.0.0#runtimeExpression";
+  const [messageType, parameterKey] = location2.split("#/");
+  if (messageType == null || parameterKey == null) {
+    throw new CliError({
+      message: `Invalid location format: ${location2}; unable to parse message type and parameter key. See ${ASYNCAPI_RUNTIME_EXPRESSION_DOCS} for the expected format.`,
+      code: CliError.Code.ValidationError
+    });
   }
+  if (!messageType.startsWith(LOCATION_PREFIX)) {
+    throw new CliError({
+      message: `Invalid location format: ${location2}; expected ${LOCATION_PREFIX} prefix`,
+      code: CliError.Code.ValidationError
+    });
+  }
+  const type8 = messageType.substring(LOCATION_PREFIX.length);
+  if (type8 !== "header" && type8 !== "path" && type8 !== "payload") {
+    throw new CliError({
+      message: `Invalid message type: ${type8}. Must be one of: header, path, payload`,
+      code: CliError.Code.ValidationError
+    });
+  }
+  return { type: type8, parameterKey };
 }
 function getServerNameFromServerRef(servers, serverRef) {
   if (!serverRef.$ref.startsWith(SERVER_REFERENCE_PREFIX)) {
-    throw new Error(`Failed to resolve server name from server ref ${serverRef.$ref}`);
+    throw new CliError({
+      message: `Failed to resolve server name from server ref ${serverRef.$ref}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   const serverName = serverRef.$ref.substring(SERVER_REFERENCE_PREFIX.length);
   const server = servers[serverName];
   if (server == null) {
-    throw new Error(`Failed to find server with name ${serverName}`);
+    throw new CliError({
+      message: `Failed to find server with name ${serverName}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return server;
 }
@@ -531560,7 +531646,7 @@ function convertPaginationExtension(pagination) {
       results: customPagination.results
     });
   }
-  throw new Error("Invalid pagination extension");
+  throw new CliError({ message: "Invalid pagination extension", code: CliError.Code.ValidationError });
 }
 function getFernPaginationExtension(document4, operation) {
   const pagination = getExtension(operation, FernOpenAPIExtension.PAGINATION);
@@ -531570,7 +531656,10 @@ function getFernPaginationExtension(document4, operation) {
   if (typeof pagination === "boolean") {
     const topLevelPagination = getExtension(document4, FernOpenAPIExtension.PAGINATION);
     if (typeof topLevelPagination === "boolean") {
-      throw new Error("Global pagination extension is a boolean, expected an object. Only endpoints may declare a boolean for x-fern-pagination.");
+      throw new CliError({
+        message: "Global pagination extension is a boolean, expected an object. Only endpoints may declare a boolean for x-fern-pagination.",
+        code: CliError.Code.ValidationError
+      });
     }
     return topLevelPagination == null ? void 0 : convertPaginationExtension(topLevelPagination);
   }
@@ -531889,12 +531978,12 @@ var AbstractOpenAPIV3ParserContext = class {
   }
   resolveParameterReference(parameter6) {
     if (this.document.components == null || this.document.components.parameters == null || !parameter6.$ref.startsWith(PARAMETER_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve ${parameter6.$ref}`);
+      throw new CliError({ message: `Failed to resolve ${parameter6.$ref}`, code: CliError.Code.ReferenceError });
     }
     const parameterKey = parameter6.$ref.substring(PARAMETER_REFERENCE_PREFIX.length);
     const resolvedParameter = this.document.components.parameters[parameterKey];
     if (resolvedParameter == null) {
-      throw new Error(`${parameter6.$ref} is undefined`);
+      throw new CliError({ message: `${parameter6.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     if (isReferenceObject(resolvedParameter)) {
       return this.resolveParameterReference(resolvedParameter);
@@ -531903,12 +531992,15 @@ var AbstractOpenAPIV3ParserContext = class {
   }
   resolveRequestBodyReference(requestBody) {
     if (this.document.components == null || this.document.components.requestBodies == null || !requestBody.$ref.startsWith(REQUEST_BODY_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve ${requestBody.$ref}`);
+      throw new CliError({
+        message: `Failed to resolve ${requestBody.$ref}`,
+        code: CliError.Code.ReferenceError
+      });
     }
     const requestBodyKey = requestBody.$ref.substring(REQUEST_BODY_REFERENCE_PREFIX.length);
     const resolvedRequestBody = this.document.components.requestBodies[requestBodyKey];
     if (resolvedRequestBody == null) {
-      throw new Error(`${requestBody.$ref} is undefined`);
+      throw new CliError({ message: `${requestBody.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     if (isReferenceObject(resolvedRequestBody)) {
       return this.resolveRequestBodyReference(resolvedRequestBody);
@@ -531917,12 +532009,12 @@ var AbstractOpenAPIV3ParserContext = class {
   }
   resolveResponseReference(response) {
     if (this.document.components == null || this.document.components.responses == null || !response.$ref.startsWith(RESPONSE_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve ${response.$ref}`);
+      throw new CliError({ message: `Failed to resolve ${response.$ref}`, code: CliError.Code.ReferenceError });
     }
     const parameterKey = response.$ref.substring(RESPONSE_REFERENCE_PREFIX.length);
     const resolvedResponse = this.document.components.responses[parameterKey];
     if (resolvedResponse == null) {
-      throw new Error(`${response.$ref} is undefined`);
+      throw new CliError({ message: `${response.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     if (isReferenceObject(resolvedResponse)) {
       return this.resolveResponseReference(resolvedResponse);
@@ -531931,12 +532023,12 @@ var AbstractOpenAPIV3ParserContext = class {
   }
   resolveExampleReference(example) {
     if (this.document.components == null || this.document.components.examples == null || !example.$ref.startsWith(EXAMPLES_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve ${example.$ref}`);
+      throw new CliError({ message: `Failed to resolve ${example.$ref}`, code: CliError.Code.ReferenceError });
     }
     const parameterKey = example.$ref.substring(EXAMPLES_REFERENCE_PREFIX.length);
     const resolvedExample = this.document.components.examples[parameterKey];
     if (resolvedExample == null) {
-      throw new Error(`${example.$ref} is undefined`);
+      throw new CliError({ message: `${example.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     if (isReferenceObject(resolvedExample)) {
       return this.resolveExampleReference(resolvedExample);
@@ -531945,12 +532037,15 @@ var AbstractOpenAPIV3ParserContext = class {
   }
   resolveSecuritySchemeReference(securityScheme) {
     if (this.document.components == null || this.document.components.securitySchemes == null || !securityScheme.$ref.startsWith(SECURITY_SCHEME_REFERENCE_PREFIX)) {
-      throw new Error(`Failed to resolve ${securityScheme.$ref}`);
+      throw new CliError({
+        message: `Failed to resolve ${securityScheme.$ref}`,
+        code: CliError.Code.ReferenceError
+      });
     }
     const securitySchemeKey = securityScheme.$ref.substring(SECURITY_SCHEME_REFERENCE_PREFIX.length);
     const resolvedSecurityScheme = this.document.components.securitySchemes[securitySchemeKey];
     if (resolvedSecurityScheme == null) {
-      throw new Error(`${securityScheme.$ref} is undefined`);
+      throw new CliError({ message: `${securityScheme.$ref} is undefined`, code: CliError.Code.ReferenceError });
     }
     if (isReferenceObject(resolvedSecurityScheme)) {
       return this.resolveSecuritySchemeReference(resolvedSecurityScheme);
@@ -532710,15 +532805,24 @@ function getMultipartPartEncodingFromContentType(contentType) {
 }
 function resolveSchema(schema2, document4) {
   if (!schema2.$ref.startsWith(SCHEMA_REFERENCE_PREFIX)) {
-    throw new Error(`Failed to resolve schema reference because of unsupported prefix: ${schema2.$ref}`);
+    throw new CliError({
+      message: `Failed to resolve schema reference because of unsupported prefix: ${schema2.$ref}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   const schemaId = getSchemaIdFromReference(schema2);
   if (schemaId == null) {
-    throw new Error(`Failed to resolve schema reference because missing schema id: ${schema2.$ref}`);
+    throw new CliError({
+      message: `Failed to resolve schema reference because missing schema id: ${schema2.$ref}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   const resolvedSchema = document4.components?.schemas?.[schemaId];
   if (resolvedSchema == null) {
-    throw new Error(`Failed to resolve schema reference because missing: ${schema2.$ref}`);
+    throw new CliError({
+      message: `Failed to resolve schema reference because missing: ${schema2.$ref}`,
+      code: CliError.Code.ReferenceError
+    });
   }
   if (isReferenceObject(resolvedSchema)) {
     return resolveSchema(resolvedSchema, document4);
@@ -534215,7 +534319,10 @@ function getBasicSecuritySchemeNameAndEnvvar(securityScheme) {
 function convertSecurityScheme(securityScheme, source2, taskContext, context3) {
   if (isReferenceObject(securityScheme)) {
     if (context3 == null) {
-      throw new Error(`Converting referenced security schemes requires context: ${JSON.stringify(securityScheme)}`);
+      throw new CliError({
+        message: `Converting referenced security schemes requires context: ${JSON.stringify(securityScheme)}`,
+        code: CliError.Code.InternalError
+      });
     }
     const resolvedSecurityScheme = context3.resolveSecuritySchemeReference(securityScheme);
     return convertSecuritySchemeHelper(resolvedSecurityScheme, source2, taskContext);
@@ -534396,7 +534503,10 @@ function getVariableDefinitions(document4, preserveSchemaIds) {
         }
       ];
     } else {
-      throw new Error(`Variable ${variableName} has unsupported schema ${JSON.stringify(schema2)}`);
+      throw new CliError({
+        message: `Variable ${variableName} has unsupported schema ${JSON.stringify(schema2)}`,
+        code: CliError.Code.ValidationError
+      });
     }
   }));
 }
@@ -535712,7 +535822,7 @@ async function validateSchema({ schema: schema2, value: value2, context: context
     });
   });
   const errorMessage = [`Failed to parse file: ${import_path20.default.relative(process.cwd(), filepathBeingParsed)}`, ...issues].join("\n");
-  return context3.failAndThrow(errorMessage);
+  return context3.failAndThrow(errorMessage, void 0, { code: CliError.Code.ConfigError });
 }
 function joinZodPath(arr) {
   return arr.reduce((acc, value2) => {
@@ -535745,7 +535855,9 @@ async function convertDependenciesConfiguration({ absolutePathToWorkspace, rawDe
           path: versionOrPath
         };
       } else {
-        context3.failWithoutThrowing(`Path to ${coordinate} dependency does not exist: ${pathToApi}`);
+        context3.failWithoutThrowing(`Path to ${coordinate} dependency does not exist: ${pathToApi}`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
     } else {
       const unprefixedCoordinate = coordinate.substring(1);
@@ -535760,12 +535872,14 @@ async function convertDependenciesConfiguration({ absolutePathToWorkspace, rawDe
           version: versionOrPath
         };
       } else {
-        context3.failWithoutThrowing(`Failed to parse dependency: ${coordinate}`);
+        context3.failWithoutThrowing(`Failed to parse dependency: ${coordinate}`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
     }
   }
   if (context3.getResult() === TaskResult.Failure) {
-    context3.failAndThrow();
+    context3.failAndThrow(void 0, void 0, { code: CliError.Code.ConfigError });
   }
   return {
     dependencies
@@ -535921,7 +536035,7 @@ function getColorInstanceFromRawConfigOrThrow(raw, context3, key2, theme) {
   }
   const instance = tinycolor(color3);
   if (!instance.isValid()) {
-    context3.failAndThrow(`'${typeof raw === "string" ? key2 : `colors.${key2}.${theme}`}' should be a hex color of the format #FFFFFF`);
+    context3.failAndThrow(`'${typeof raw === "string" ? key2 : `colors.${key2}.${theme}`}' should be a hex color of the format #FFFFFF`, void 0, { code: CliError.Code.ConfigError });
   }
   return instance;
 }
@@ -536535,7 +536649,7 @@ async function parseContext7File({ rawPath, absoluteFilepathToDocsConfig, contex
   try {
     JSON.parse(contents);
   } catch (error50) {
-    context3.failAndThrow(`Invalid JSON in Context7 config file: ${rawPath}`, error50 instanceof Error ? error50.message : String(error50));
+    context3.failAndThrow(`Invalid JSON in Context7 config file: ${rawPath}`, error50 instanceof Error ? error50.message : String(error50), { code: CliError.Code.ConfigError });
   }
   return absolutePath;
 }
@@ -536695,7 +536809,10 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
           featureFlags: convertFeatureFlag(product.featureFlag)
         });
       } else {
-        throw new Error(`Invalid product configuration: product must have either 'path' or valid 'href' property`);
+        throw new CliError({
+          message: `Invalid product configuration: product must have either 'path' or valid 'href' property`,
+          code: CliError.Code.ConfigError
+        });
       }
     }
     return {
@@ -536710,7 +536827,10 @@ async function getNavigationConfiguration({ tabs, products, versions, navigation
       folderTitleSource
     });
   }
-  throw new Error("Unexpected. Docs have neither navigation or versions defined.");
+  throw new CliError({
+    message: "Unexpected. Docs have neither navigation or versions defined.",
+    code: CliError.Code.ConfigError
+  });
 }
 function convertFeatureFlag(flag) {
   if (flag == null) {
@@ -536808,7 +536928,10 @@ function parseWeight(weight) {
 async function convertNavigationTabConfiguration({ tabs, item, absolutePathToFernFolder, absolutePathToConfig, context: context3, folderTitleSource }) {
   const tab2 = tabs[item.tab];
   if (tab2 == null) {
-    throw new Error(`Tab ${item.tab} is not defined in the tabs config.`);
+    throw new CliError({
+      message: `Tab ${item.tab} is not defined in the tabs config.`,
+      code: CliError.Code.ConfigError
+    });
   }
   if (tabbedNavigationItemHasVariants(item)) {
     const variants = await Promise.all(item.variants.map(async (variant) => {
@@ -536937,7 +537060,9 @@ var DEFAULT_CHANGELOG_TITLE = "Changelog";
 async function expandFolderConfiguration({ rawConfig, absolutePathToFernFolder, absolutePathToConfig, context: context3, folderTitleSource }) {
   const folderPath = resolveFilepath(rawConfig.folder, absolutePathToConfig);
   if (!await doesPathExist(folderPath)) {
-    context3.failAndThrow(`Folder not found: ${rawConfig.folder}`);
+    context3.failAndThrow(`Folder not found: ${rawConfig.folder}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   validateCollapsibleConfig({
     context: context3,
@@ -537260,7 +537385,10 @@ function parseLibrariesConfiguration(libraries) {
   const result = {};
   for (const [name2, config5] of Object.entries(libraries)) {
     if (!isGitLibraryInput(config5.input)) {
-      throw new Error(`Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`);
+      throw new CliError({
+        message: `Library '${name2}' uses 'path' input which is not yet supported. Please use 'git' input.`,
+        code: CliError.Code.ConfigError
+      });
     }
     result[name2] = {
       input: {
@@ -537449,10 +537577,10 @@ function parseAudiences(raw) {
 }
 function validateCollapsibleConfig({ context: context3, sectionTitle, collapsed, collapsible, collapsedByDefault }) {
   if (collapsible != null && collapsed != null) {
-    context3.failAndThrow(`Section "${sectionTitle}": cannot use both "collapsible" and the deprecated "collapsed" property. Please use "collapsible" and "collapsed-by-default" instead.`);
+    context3.failAndThrow(`Section "${sectionTitle}": cannot use both "collapsible" and the deprecated "collapsed" property. Please use "collapsible" and "collapsed-by-default" instead.`, void 0, { code: CliError.Code.ConfigError });
   }
   if (collapsedByDefault != null && collapsible !== true) {
-    context3.failAndThrow(`Section "${sectionTitle}": "collapsed-by-default" requires "collapsible: true". "collapsed-by-default" has no effect on a non-collapsible section.`);
+    context3.failAndThrow(`Section "${sectionTitle}": "collapsed-by-default" requires "collapsible: true". "collapsed-by-default" has no effect on a non-collapsible section.`, void 0, { code: CliError.Code.ConfigError });
   }
 }
 
@@ -537727,7 +537855,9 @@ function removeDefaultDockerOrgIfPresent(generatorName) {
 function getGeneratorNameOrThrow(generatorName, context3) {
   const normalizedGeneratorName = normalizeGeneratorName(generatorName);
   if (normalizedGeneratorName == null) {
-    return context3.failAndThrow("Unrecognized generator: " + generatorName);
+    return context3.failAndThrow("Unrecognized generator: " + generatorName, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   return normalizedGeneratorName;
 }
@@ -537854,9 +537984,9 @@ async function updateGeneratorGroup({ generatorsConfiguration, groupName = gener
     const availableGroups = Object.keys(generatorsConfiguration.groups ?? {});
     if (availableGroups.length > 0) {
       const message = "No group specified. Use the --group option:\n" + availableGroups.map((name2) => ` \u203A ${name2}`).join("\n");
-      return context3.failAndThrow(message);
+      return context3.failAndThrow(message, void 0, { code: CliError.Code.ConfigError });
     }
-    return context3.failAndThrow("No group specified.");
+    return context3.failAndThrow("No group specified.", void 0, { code: CliError.Code.ConfigError });
   }
   const groups2 = generatorsConfiguration.groups ??= {};
   const group = groups2[groupName];
@@ -537880,7 +538010,9 @@ async function addGenerator({ generatorName, generatorsConfiguration, groupName
     context: context3,
     update: async (group) => {
       if (group.generators.some((generator) => addDefaultDockerOrgIfNotPresent("image" in generator ? generator.image.name : generator.name) === normalizedGeneratorName)) {
-        context3.failAndThrow(`${generatorName} is already installed in group ${groupName}.`);
+        context3.failAndThrow(`${generatorName} is already installed in group ${groupName}.`, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
       const latestVersion2 = await getLatestGeneratorVersion({
         cliVersion,
@@ -544443,7 +544575,10 @@ function parseRemoveDiscriminantsFromSchemas(option) {
   } else if (option === "never") {
     return generators_yml_exports.RemoveDiscriminantsFromSchemas.Never;
   }
-  throw new Error(`Unknown value for generators.yml API setting: remove-discriminants-from-schemas: ${option}`);
+  throw new CliError({
+    message: `Unknown value for generators.yml API setting: remove-discriminants-from-schemas: ${option}`,
+    code: CliError.Code.ConfigError
+  });
 }
 function mergeSettings(base4, override) {
   return {
@@ -545010,7 +545145,10 @@ async function getGithubLicense({ absolutePathToGeneratorsConfiguration, githubL
 function getGithubPublishInfo(output2, maybeGroupLevelMetadata, maybeTopLevelMetadata) {
   switch (output2.location) {
     case "local-file-system":
-      throw new Error("Cannot use local-file-system with github publishing");
+      throw new CliError({
+        message: "Cannot use local-file-system with github publishing",
+        code: CliError.Code.ConfigError
+      });
     case "npm":
       return api_exports4.GithubPublishInfo.npm({
         registryUrl: output2.url ?? "https://registry.npmjs.org",
@@ -545203,7 +545341,10 @@ async function loadRawGeneratorsConfiguration({ absolutePathToWorkspace, context
     if (parsed.ok) {
       return parsed.value;
     }
-    throw new Error(parsed.errors.map((e5) => e5.message).join("\n"));
+    throw new CliError({
+      message: parsed.errors.map((e5) => e5.message).join("\n"),
+      code: CliError.Code.ConfigError
+    });
   } catch (e5) {
     if (e5 instanceof jsYaml.YAMLException) {
       const relativePath = import_path24.default.relative(process.cwd(), filepath);
@@ -545225,7 +545366,7 @@ ${e5.mark.snippet}`;
           errorMessage += '\n\nHint: Values starting with "@" (such as scoped npm packages) must be wrapped in quotes.\n  Example: package-name: "@scope/package"';
         }
       }
-      context3.failAndThrow(errorMessage);
+      context3.failAndThrow(errorMessage, void 0, { code: CliError.Code.ConfigError });
     } else {
       throw e5;
     }
@@ -551709,7 +551850,7 @@ function parseTypeName({ typeName, file: file4 }) {
     imports: file4.imports
   });
   if (reference4 == null) {
-    throw new Error("Failed to locate type: " + typeName);
+    throw new CliError({ message: "Failed to locate type: " + typeName, code: CliError.Code.ResolutionError });
   }
   const nameWithoutId = {
     name: file4.casingsGenerator.generateName(reference4.typeName),
@@ -551919,7 +552060,7 @@ function convertHttpRequestBody({ request: request7, file: file4 }) {
   }
   if (isInlineRequestBody(request7.body)) {
     if (request7.name == null) {
-      throw new Error("Name is missing for inlined request");
+      throw new CliError({ message: "Name is missing for inlined request", code: CliError.Code.InternalError });
     }
     return HttpRequestBody.inlinedRequestBody({
       name: file4.casingsGenerator.generateName(request7.name),
@@ -552009,13 +552150,19 @@ function getObjectPropertyFromResolvedType({ typeResolver, file: file4, resolved
     default:
       assertNever(resolvedType);
   }
-  throw new Error("Internal error; response must be an object in order to return a property as a response");
+  throw new CliError({
+    message: "Internal error; response must be an object in order to return a property as a response",
+    code: CliError.Code.InternalError
+  });
 }
 function getObjectPropertyFromObjectSchema({ typeResolver, file: file4, objectSchema, property: property24 }) {
   const properties7 = getAllPropertiesForRawObjectSchema(objectSchema, file4, typeResolver);
   const objectProperty = properties7[property24];
   if (objectProperty == null) {
-    throw new Error(`Object does not have a property named ${property24}.`);
+    throw new CliError({
+      message: `Object does not have a property named ${property24}.`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return objectProperty;
 }
@@ -552048,7 +552195,10 @@ function getAllPropertiesForExtendedType(extendedType, file4, typeResolver) {
   if (resolvedType._type === "named" && isRawObjectDefinition(resolvedType.declaration)) {
     return getAllPropertiesForRawObjectSchema(resolvedType.declaration, file4, typeResolver);
   }
-  throw new Error(`Extended type ${extendedType} must be another named type`);
+  throw new CliError({
+    message: `Extended type ${extendedType} must be another named type`,
+    code: CliError.Code.InternalError
+  });
 }
 
 // ../generation/ir-generator/lib/converters/services/convertProperty.js
@@ -552112,7 +552262,10 @@ function getPropertyTypeFromObjectSchema({ typeResolver, file: file4, objectSche
   });
   const propertyType = properties7[property24];
   if (propertyType == null) {
-    throw new Error(`Response does not have a property named ${property24}.`);
+    throw new CliError({
+      message: `Response does not have a property named ${property24}.`,
+      code: CliError.Code.ReferenceError
+    });
   }
   return propertyType;
 }
@@ -552153,7 +552306,10 @@ function getAllPropertiesForExtendedType2({ typeResolver, file: file4, extendedT
       objectSchema: resolvedType.declaration
     });
   }
-  throw new Error(`Extended type ${extendedType} must be another named type.`);
+  throw new CliError({
+    message: `Extended type ${extendedType} must be another named type.`,
+    code: CliError.Code.InternalError
+  });
 }
 function maybeFileFromResolvedType(resolvedType) {
   if (resolvedType == null) {
@@ -552209,7 +552365,7 @@ function convertHttpSdkRequest({ request: request7, endpointKey, endpoint: endpo
 function convertHttpSdkRequestShape({ service, request: request7, file: file4, typeResolver }) {
   const constructWrapper = () => {
     if (typeof request7 === "string" || request7?.name == null) {
-      throw new Error("Name is missing for request wrapper");
+      throw new CliError({ message: "Name is missing for request wrapper", code: CliError.Code.InternalError });
     }
     return SdkRequestShape.wrapper({
       wrapperName: file4.casingsGenerator.generateName(request7.name),
@@ -552389,7 +552545,7 @@ function parseErrorName({ errorName, file: file4 }) {
     imports: file4.imports
   });
   if (reference4 == null) {
-    throw new Error("Failed to locate error " + errorName);
+    throw new CliError({ message: "Failed to locate error " + errorName, code: CliError.Code.ResolutionError });
   }
   const nameWithoutId = {
     name: file4.casingsGenerator.generateName(reference4.typeName),
@@ -552859,7 +553015,10 @@ function validateObjectExample({ typeName, typeNameForBreadcrumb, rawObject, fil
     } else {
       const definitionFile = getDefinitionFile(workspace, propertyWithPath.filepathOfDeclaration);
       if (definitionFile == null) {
-        throw new Error("Service file does not exist for property: " + propertyWithPath.wireKey);
+        throw new CliError({
+          message: "Service file does not exist for property: " + propertyWithPath.wireKey,
+          code: CliError.Code.InternalError
+        });
       }
       violations.push(...validateTypeReferenceExample({
         rawTypeReference: propertyWithPath.propertyType,
@@ -553334,7 +553493,10 @@ function validatePrimitiveExample({ primitiveType: primitiveType2, example }) {
       base64: () => validateString(example),
       bigInteger: () => validateString(example),
       _other: () => {
-        throw new Error("Unknown primitive type v2: " + primitiveType2.v2);
+        throw new CliError({
+          message: "Unknown primitive type v2: " + primitiveType2.v2,
+          code: CliError.Code.InternalError
+        });
       }
     });
   }
@@ -553354,7 +553516,10 @@ function validatePrimitiveExample({ primitiveType: primitiveType2, example }) {
     base64: () => validateString(example),
     bigInteger: () => validateString(example),
     _other: () => {
-      throw new Error("Unknown primitive type: " + primitiveType2.v1);
+      throw new CliError({
+        message: "Unknown primitive type: " + primitiveType2.v1,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -553577,7 +553742,10 @@ function convertEnumTypeDeclaration({ _enum: _enum3, file: file4 }) {
   if (_enum3.default != null) {
     defaultValue = values2.find((enumValue) => getWireValue(enumValue.name) === _enum3.default);
     if (defaultValue == null) {
-      throw new Error(`Default value ${_enum3.default} not found in enum values`);
+      throw new CliError({
+        message: `Default value ${_enum3.default} not found in enum values`,
+        code: CliError.Code.ValidationError
+      });
     }
   }
   return {
@@ -553646,18 +553814,27 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
     discriminatedUnion: (rawUnion) => {
       const discriminant21 = getUnionDiscriminant(rawUnion);
       if (!isPlainObject4(example)) {
-        throw new Error("Example is not an object");
+        throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
       }
       const discriminantValueForExample = example[discriminant21];
       if (discriminantValueForExample == null) {
-        throw new Error("Example is missing discriminant: " + discriminant21);
+        throw new CliError({
+          message: "Example is missing discriminant: " + discriminant21,
+          code: CliError.Code.ValidationError
+        });
       }
       if (typeof discriminantValueForExample !== "string") {
-        throw new Error("Discriminant value is not a string");
+        throw new CliError({
+          message: "Discriminant value is not a string",
+          code: CliError.Code.ValidationError
+        });
       }
       const rawSingleUnionType = rawUnion.union[discriminantValueForExample];
       if (rawSingleUnionType == null) {
-        throw new Error(`${discriminantValueForExample} is not one of the specified discriminant values.`);
+        throw new CliError({
+          message: `${discriminantValueForExample} is not one of the specified discriminant values.`,
+          code: CliError.Code.ValidationError
+        });
       }
       const rawValueType = typeof rawSingleUnionType === "string" ? rawSingleUnionType : typeof rawSingleUnionType.type === "string" ? rawSingleUnionType.type : void 0;
       const baseProperties = Object.entries(rawUnion["base-properties"] ?? {}).map(([propertyName, property24]) => {
@@ -553688,7 +553865,10 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
           referenceToNamedType: extendedTypeName
         });
         if (resolvedExtendedType._type !== "named" || !isRawObjectDefinition(resolvedExtendedType.declaration)) {
-          throw new Error("Extended type is not a named object");
+          throw new CliError({
+            message: "Extended type is not a named object",
+            code: CliError.Code.InternalError
+          });
         }
         const extendedObject = resolvedExtendedType.declaration;
         const propertiesFromExtension = Object.entries(extendedObject.properties ?? {}).map(([propertyName, property24]) => {
@@ -553741,7 +553921,10 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
     enum: (rawEnum) => {
       if (typeof example !== "string") {
         const validValues = rawEnum.enum.map((enumEntry) => typeof enumEntry === "string" ? enumEntry : enumEntry.value).join(", ");
-        throw new Error(`Expected one of ${validValues}. Received ${example}`);
+        throw new CliError({
+          message: `Expected one of ${validValues}. Received ${example}`,
+          code: CliError.Code.ValidationError
+        });
       }
       return ExampleTypeShape.enum({
         value: fileContainingExample.casingsGenerator.generateNameAndWireValue({
@@ -553782,7 +553965,10 @@ function convertTypeExample({ typeName, typeDeclaration: typeDeclaration2, examp
         return typeof variant === "string" ? variant : variant.type;
       });
       const validValues = variantOptions.join(", ");
-      throw new Error(`Expected one of ${validValues}. Received ${example}`);
+      throw new CliError({
+        message: `Expected one of ${validValues}. Received ${example}`,
+        code: CliError.Code.ValidationError
+      });
     }
   });
 }
@@ -553809,7 +553995,7 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
       },
       map: ({ keyType, valueType }) => {
         if (!isPlainObject4(resolvedExample)) {
-          throw new Error("Example is not an object");
+          throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
         }
         const nextContext = { depth: ctx.depth + 1, seenTypeIds: ctx.seenTypeIds };
         return ExampleTypeReferenceShape.container(ExampleContainer.map({
@@ -553841,7 +554027,7 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
       },
       list: (itemType) => {
         if (!Array.isArray(resolvedExample)) {
-          throw new Error("Example is not a list");
+          throw new CliError({ message: "Example is not a list", code: CliError.Code.ValidationError });
         }
         const nextContext = { depth: ctx.depth + 1, seenTypeIds: ctx.seenTypeIds };
         return ExampleTypeReferenceShape.container(ExampleContainer.list({
@@ -553860,7 +554046,7 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
       },
       set: (itemType) => {
         if (!Array.isArray(resolvedExample)) {
-          throw new Error("Example is not a list");
+          throw new CliError({ message: "Example is not a list", code: CliError.Code.ValidationError });
         }
         const nextContext = { depth: ctx.depth + 1, seenTypeIds: ctx.seenTypeIds };
         return ExampleTypeReferenceShape.container(ExampleContainer.set({
@@ -553930,7 +554116,10 @@ function convertTypeReferenceExample({ example, fileContainingExample, rawTypeBe
         });
         const parsedReferenceToNamedType = fileContainingRawTypeReference.parseTypeReference(named);
         if (parsedReferenceToNamedType.type !== "named") {
-          throw new Error("Type reference is not to a named type.");
+          throw new CliError({
+            message: "Type reference is not to a named type.",
+            code: CliError.Code.InternalError
+          });
         }
         const typeName = {
           typeId: parsedReferenceToNamedType.typeId,
@@ -554088,13 +554277,19 @@ function convertPrimitiveExample({ example, typeBeingExemplified }) {
       }));
     },
     _other: () => {
-      throw new Error("Unknown primitive type: " + typeBeingExemplified);
+      throw new CliError({
+        message: "Unknown primitive type: " + typeBeingExemplified,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
 function convertObject4({ typeName, rawObject, example, fileContainingType, fileContainingExample, typeResolver, exampleResolver, workspace, recursionContext }) {
   if (!isPlainObject4(example)) {
-    throw new Error(`Example is not an object. Got: ${JSON.stringify(example)}`);
+    throw new CliError({
+      message: `Example is not an object. Got: ${JSON.stringify(example)}`,
+      code: CliError.Code.ValidationError
+    });
   }
   const properties7 = Object.entries(example).map(([wireKey, propertyExample]) => {
     const originalTypeDeclaration = getOriginalTypeDeclarationForProperty({
@@ -554169,7 +554364,10 @@ function getOriginalTypeDeclarationForPropertyFromExtensions({ wirePropertyKey,
         file: file4
       });
       if (resolvedType._type !== "named" || !isRawObjectDefinition(resolvedType.declaration)) {
-        throw new Error("Extension is not of a named object");
+        throw new CliError({
+          message: "Extension is not of a named object",
+          code: CliError.Code.InternalError
+        });
       }
       const originalTypeDeclaration = getOriginalTypeDeclarationForProperty({
         wirePropertyKey,
@@ -554206,7 +554404,7 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
   switch (parsedSingleUnionTypeProperties.propertiesType) {
     case "singleProperty": {
       if (!isPlainObject4(example)) {
-        throw new Error("Example is not an object");
+        throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
       }
       return {
         wireDiscriminantValue,
@@ -554224,7 +554422,7 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
     }
     case "samePropertiesAsObject": {
       if (!isPlainObject4(example)) {
-        throw new Error("Example is not an object");
+        throw new CliError({ message: "Example is not an object", code: CliError.Code.ValidationError });
       }
       let rawDeclaration = typeResolver.getDeclarationOfNamedTypeOrThrow({
         referenceToNamedType: rawValueType,
@@ -554237,7 +554435,10 @@ function convertSingleUnionType({ rawValueType, rawSingleUnionType, fileContaini
         });
       }
       if (!isRawObjectDefinition(rawDeclaration.declaration)) {
-        throw new Error(`${rawValueType} is not an object`);
+        throw new CliError({
+          message: `${rawValueType} is not an object`,
+          code: CliError.Code.ValidationError
+        });
       }
       const typeName = {
         typeId: parsedSingleUnionTypeProperties.typeId,
@@ -554320,7 +554521,10 @@ function convertExampleEndpointCall2({ service, endpoint: endpoint3, example, ty
     queryParameters: example["query-parameters"] != null ? Object.entries(example["query-parameters"]).map(([wireKey, value2]) => {
       const queryParameterDeclaration = typeof endpoint3.request !== "string" ? endpoint3.request?.["query-parameters"]?.[wireKey] : void 0;
       if (queryParameterDeclaration == null) {
-        throw new Error(`Query parameter ${wireKey} does not exist`);
+        throw new CliError({
+          message: `Query parameter ${wireKey} does not exist`,
+          code: CliError.Code.ReferenceError
+        });
       }
       const isAllowMultiple = typeof queryParameterDeclaration !== "string" && queryParameterDeclaration["allow-multiple"] === true;
       const rawType = typeof queryParameterDeclaration === "string" ? queryParameterDeclaration : queryParameterDeclaration.type;
@@ -554429,7 +554633,10 @@ function convertPathParameters({ service, endpoint: endpoint3, example, typeReso
           examplePathParameter
         }));
       } else {
-        throw new Error(`Path parameter ${key2} does not exist`);
+        throw new CliError({
+          message: `Path parameter ${key2} does not exist`,
+          code: CliError.Code.ReferenceError
+        });
       }
     }
   }
@@ -554509,7 +554716,10 @@ function convertExampleRequestBody({ endpoint: endpoint3, example, typeResolver,
     return void 0;
   }
   if (!isPlainObject4(example.request)) {
-    throw new Error(`Example is not an object. Got: ${JSON.stringify(example.request)}`);
+    throw new CliError({
+      message: `Example is not an object. Got: ${JSON.stringify(example.request)}`,
+      code: CliError.Code.ValidationError
+    });
   }
   const exampleProperties = [];
   const exampleExtraProperties = [];
@@ -554559,7 +554769,10 @@ function convertExampleRequestBody({ endpoint: endpoint3, example, typeResolver,
           });
           continue;
         }
-        throw new Error("Could not find original type declaration for property: " + wireKey);
+        throw new CliError({
+          message: "Could not find original type declaration for property: " + wireKey,
+          code: CliError.Code.ResolutionError
+        });
       }
       exampleProperties.push({
         name: file4.casingsGenerator.generateNameAndWireValue({
@@ -554944,7 +555157,7 @@ function getPaginationPropertyComponents(endpointPagination) {
       results: getResponsePropertyComponents(endpointPagination.results)
     };
   }
-  throw new Error("Invalid pagination schema");
+  throw new CliError({ message: "Invalid pagination schema", code: CliError.Code.ValidationError });
 }
 function isRawCursorPaginationSchema(rawPaginationSchema) {
   return rawPaginationSchema.cursor != null;
@@ -555115,7 +555328,10 @@ function getTransportForEndpoint({ file: file4, serviceTransport, endpointDeclar
     return void 0;
   }
   if (isHttpService && isGrpcEndpoint) {
-    throw new Error("Cannot have a grpc endpoint on an http service");
+    throw new CliError({
+      message: "Cannot have a grpc endpoint on an http service",
+      code: CliError.Code.ValidationError
+    });
   }
   if (isGrpcService && isHttpEndpoint) {
     return Transport.http();
@@ -555129,8 +555345,11 @@ function getTransportForEndpoint({ file: file4, serviceTransport, endpointDeclar
       return createProtobufService(file4, protoSource, sourceResolver, serviceNameOverride);
     }
   }
-  throw new Error(`Internal error; failed to determine endpoint transport for
-  ${JSON.stringify(endpointDeclaration)}"`);
+  throw new CliError({
+    message: `Internal error; failed to determine endpoint transport for
+  ${JSON.stringify(endpointDeclaration)}"`,
+    code: CliError.Code.InternalError
+  });
 }
 function createProtobufService(file4, source2, sourceResolver, serviceNameOverride) {
   const resolvedSource = sourceResolver.resolveSourceOrThrow({
@@ -555138,14 +555357,20 @@ function createProtobufService(file4, source2, sourceResolver, serviceNameOverri
     relativeFilepath: file4.relativeFilepath
   });
   if (resolvedSource == null || resolvedSource.type !== "protobuf") {
-    throw new Error(`Expected a protobuf source for ${source2.proto}.`);
+    throw new CliError({
+      message: `Expected a protobuf source for ${source2.proto}.`,
+      code: CliError.Code.ResolutionError
+    });
   }
   const protobufService = convertProtobufService({
     source: resolvedSource,
     serviceNameOverride
   });
   if (protobufService == null) {
-    throw new Error(`Failed to resolve service name from ${resolvedSource.relativeFilePath}.`);
+    throw new CliError({
+      message: `Failed to resolve service name from ${resolvedSource.relativeFilePath}.`,
+      code: CliError.Code.IrConversionError
+    });
   }
   return Transport.grpc({
     service: protobufService
@@ -555357,7 +555582,7 @@ function resolvePathParameterOrThrow({ parameter: parameter6, variableResolver,
     file: file4
   });
   if (resolved == null) {
-    throw new Error("Cannot resolve path parameter");
+    throw new CliError({ message: "Cannot resolve path parameter", code: CliError.Code.InternalError });
   }
   return resolved;
 }
@@ -555638,7 +555863,10 @@ var DynamicSnippetsConverter = class {
       return dynamic_exports.Request.body({ pathParameters, body: void 0 });
     }
     if (endpoint3.sdkRequest == null) {
-      throw new Error(`Internal error; endpoint "${endpoint3.id}" has a request body but no SDK request`);
+      throw new CliError({
+        message: `Internal error; endpoint "${endpoint3.id}" has a request body but no SDK request`,
+        code: CliError.Code.InternalError
+      });
     }
     switch (endpoint3.sdkRequest.shape.type) {
       case "justRequestBody":
@@ -556131,7 +556359,7 @@ var DynamicSnippetsConverter = class {
           }))
         }),
         _other: () => {
-          throw new Error("Unknown environments type");
+          throw new CliError({ message: "Unknown environments type", code: CliError.Code.InternalError });
         }
       })
     };
@@ -556168,10 +556396,16 @@ var DynamicSnippetsConverter = class {
   resolveObjectTypeOrThrow(typeId) {
     const typeDeclaration2 = this.ir.types[typeId];
     if (typeDeclaration2 == null) {
-      throw new Error(`Internal error; type "${typeId}" not found`);
+      throw new CliError({
+        message: `Internal error; type "${typeId}" not found`,
+        code: CliError.Code.InternalError
+      });
     }
     if (typeDeclaration2.shape.type !== "object") {
-      throw new Error(`Internal error; type "${typeId}" is not an object`);
+      throw new CliError({
+        message: `Internal error; type "${typeId}" is not an object`,
+        code: CliError.Code.InternalError
+      });
     }
     return typeDeclaration2.shape;
   }
@@ -556456,7 +556690,10 @@ function convertOAuthClientCredentials({ propertyResolver, endpointResolver, typ
     tokenEndpoint
   });
   if (oauthTokenEndpoint == null) {
-    throw new Error("Failed to convert OAuth token endpoint.");
+    throw new CliError({
+      message: "Failed to convert OAuth token endpoint.",
+      code: CliError.Code.IrConversionError
+    });
   }
   const refreshEndpoint = refreshTokenEndpoint != null ? convertOAuthRefreshEndpoint({
     propertyResolver,
@@ -556634,7 +556871,7 @@ function convertSchemeReference2({ reference: reference4, authSchemeDeclarations
   const convertNamedAuthSchemeReference = (reference5, docs2) => {
     const declaration = authSchemeDeclarations?.[reference5];
     if (declaration == null) {
-      throw new Error("Unknown auth scheme: " + reference5);
+      throw new CliError({ message: "Unknown auth scheme: " + reference5, code: CliError.Code.ReferenceError });
     }
     return visitRawAuthSchemeDeclaration(declaration, {
       header: (rawHeader) => AuthScheme.header({
@@ -556746,7 +556983,10 @@ function generateOAuth({ key: key2, file: file4, docs: docs2, rawScheme, propert
         }))
       });
     default:
-      throw new Error(`Unknown OAuth type: '${rawScheme?.type}'`);
+      throw new CliError({
+        message: `Unknown OAuth type: '${rawScheme?.type}'`,
+        code: CliError.Code.ValidationError
+      });
   }
 }
 function generateInferredAuth({ key: key2, file: file4, docs: docs2, rawScheme, propertyResolver, endpointResolver }) {
@@ -557010,7 +557250,10 @@ function convertChannel({ channel: channel3, typeResolver, exampleResolver, vari
         queryParameters: example["query-parameters"] != null ? Object.entries(example["query-parameters"]).map(([wireKey, value2]) => {
           const queryParameterDeclaration = channel3["query-parameters"]?.[wireKey];
           if (queryParameterDeclaration == null) {
-            throw new Error(`Query parameter ${wireKey} does not exist`);
+            throw new CliError({
+              message: `Query parameter ${wireKey} does not exist`,
+              code: CliError.Code.ReferenceError
+            });
           }
           return {
             name: file4.casingsGenerator.generateNameAndWireValue({
@@ -557035,7 +557278,10 @@ function convertChannel({ channel: channel3, typeResolver, exampleResolver, vari
         messages: example.messages.map((messageExample) => {
           const message = channel3.messages?.[messageExample.type];
           if (message == null) {
-            throw new Error(`Message ${messageExample.type} does not exist`);
+            throw new CliError({
+              message: `Message ${messageExample.type} does not exist`,
+              code: CliError.Code.ReferenceError
+            });
           }
           return {
             type: messageExample.type,
@@ -557074,7 +557320,7 @@ function convertExampleWebSocketMessageBody({ message, example, typeResolver, ex
     }));
   }
   if (!isPlainObject4(example)) {
-    throw new Error("Example must be an object");
+    throw new CliError({ message: "Example must be an object", code: CliError.Code.ValidationError });
   }
   const exampleProperties = [];
   for (const [wireKey, propertyExample] of Object.entries(example)) {
@@ -557104,7 +557350,10 @@ function convertExampleWebSocketMessageBody({ message, example, typeResolver, ex
         file: file4
       });
       if (originalTypeDeclaration == null) {
-        throw new Error("Could not find original type declaration for property: " + wireKey);
+        throw new CliError({
+          message: "Could not find original type declaration for property: " + wireKey,
+          code: CliError.Code.ResolutionError
+        });
       }
       exampleProperties.push({
         name: file4.casingsGenerator.generateNameAndWireValue({
@@ -557188,7 +557437,10 @@ function convertChannelPathParameters({ channel: channel3, example, typeResolver
           examplePathParameter
         }));
       } else {
-        throw new Error(`Path parameter ${key2} does not exist`);
+        throw new CliError({
+          message: `Path parameter ${key2} does not exist`,
+          code: CliError.Code.ReferenceError
+        });
       }
     }
   }
@@ -557339,7 +557591,10 @@ var ReadmeEndpointCache = class {
   getEndpointForReadmeOrThrow(readmeEndpoint) {
     const endpoint3 = this.getEndpointForReadme(readmeEndpoint);
     if (endpoint3 == null) {
-      throw new Error(`Endpoint not found for ${JSON.stringify(readmeEndpoint)}`);
+      throw new CliError({
+        message: `Endpoint not found for ${JSON.stringify(readmeEndpoint)}`,
+        code: CliError.Code.ResolutionError
+      });
     }
     return endpoint3;
   }
@@ -557387,7 +557642,7 @@ function getReadmeEndpointObject({ endpoint: endpoint3 }) {
   if (typeof endpoint3 === "string") {
     const split2 = endpoint3.split(" ");
     if (split2.length !== 2 || split2[0] == null || split2[1] == null) {
-      throw new Error(`invalid endpoint string: ${endpoint3}`);
+      throw new CliError({ message: `invalid endpoint string: ${endpoint3}`, code: CliError.Code.ParseError });
     }
     return {
       method: split2[0],
@@ -557484,7 +557739,10 @@ function convertWebhookExamples2({ webhook, examples, file: file4, typeResolver,
     }));
   }
   if (!isPlainObject4(webhook.payload)) {
-    throw new Error(`Example webhook payload is not an object. Got: ${JSON.stringify(webhook.payload)}`);
+    throw new CliError({
+      message: `Example webhook payload is not an object. Got: ${JSON.stringify(webhook.payload)}`,
+      code: CliError.Code.ValidationError
+    });
   }
   return examples.map((example) => ({
     docs: webhook.docs,
@@ -557876,7 +558134,10 @@ function convertGenericTypeDeclaration({ generic, file: file4, typeResolver }) {
   const genericInstantiation = typeof generic === "string" ? generic : generic.type;
   const maybeGeneric = parseGeneric(genericInstantiation);
   if (maybeGeneric == null) {
-    throw new Error(`Invalid generic type definition: ${genericInstantiation}`);
+    throw new CliError({
+      message: `Invalid generic type definition: ${genericInstantiation}`,
+      code: CliError.Code.ValidationError
+    });
   }
   const resolvedBaseGeneric = typeResolver.getDeclarationOfNamedTypeOrThrow({
     referenceToNamedType: genericInstantiation,
@@ -557907,7 +558168,10 @@ function convertGenericTypeDeclaration({ generic, file: file4, typeResolver }) {
       extendedProperties: void 0
     });
   }
-  throw new Error(`Generic type definition not supported: ${genericInstantiation}`);
+  throw new CliError({
+    message: `Generic type definition not supported: ${genericInstantiation}`,
+    code: CliError.Code.ValidationError
+  });
 }
 
 // ../generation/ir-generator/lib/converters/type-declarations/convertAliasTypeDeclaration.js
@@ -558299,7 +558563,10 @@ var PackageTreeGenerator = class {
   addPackageRedirection({ from: from4, to: to10 }) {
     const package_ = this.getPackageForFernFilepath(from4);
     if (package_.navigationConfig != null) {
-      throw new Error("Found duplicate navigationConfig for package");
+      throw new CliError({
+        message: "Found duplicate navigationConfig for package",
+        code: CliError.Code.InternalError
+      });
     }
     package_.navigationConfig = {
       pointsTo: IdGenerator.generateSubpackageId(to10)
@@ -558308,7 +558575,7 @@ var PackageTreeGenerator = class {
   addDocs(fernFilepath, docs2) {
     const package_ = this.getPackageForFernFilepath(fernFilepath);
     if (package_.docs != null) {
-      throw new Error("Found duplicate docs for package");
+      throw new CliError({ message: "Found duplicate docs for package", code: CliError.Code.InternalError });
     }
     package_.docs = docs2;
   }
@@ -558324,21 +558591,30 @@ var PackageTreeGenerator = class {
   addService(serviceId, service) {
     const package_ = this.getPackageForFernFilepath(service.name.fernFilepath);
     if (package_.service != null) {
-      throw new Error("Found duplicate service for " + serviceId);
+      throw new CliError({
+        message: "Found duplicate service for " + serviceId,
+        code: CliError.Code.InternalError
+      });
     }
     package_.service = serviceId;
   }
   addWebhookGroup(webhookGroupId, fernFilepath) {
     const package_ = this.getPackageForFernFilepath(fernFilepath);
     if (package_.webhooks != null) {
-      throw new Error("Found duplicate webhook group for " + webhookGroupId);
+      throw new CliError({
+        message: "Found duplicate webhook group for " + webhookGroupId,
+        code: CliError.Code.InternalError
+      });
     }
     package_.webhooks = webhookGroupId;
   }
   addWebSocketChannel(websocketChannelId, fernFilepath) {
     const package_ = this.getPackageForFernFilepath(fernFilepath);
     if (package_.webhooks != null) {
-      throw new Error("Found duplicate webhook group for " + websocketChannelId);
+      throw new CliError({
+        message: "Found duplicate webhook group for " + websocketChannelId,
+        code: CliError.Code.InternalError
+      });
     }
     package_.websocket = websocketChannelId;
   }
@@ -558381,24 +558657,33 @@ var PackageTreeGenerator = class {
   }
   sortRootPackage(subpackagesInOrder) {
     if (!isEqualIgnoreOrder(this.rootPackage.subpackages, subpackagesInOrder)) {
-      throw new Error("Sorted subpackages differ from unsorted packages in root");
+      throw new CliError({
+        message: "Sorted subpackages differ from unsorted packages in root",
+        code: CliError.Code.InternalError
+      });
     }
     this.rootPackage.subpackages = subpackagesInOrder;
   }
   sortSubpackage(subpackageId, subpackagesInOrder) {
     const subpackage = this.subpackages[subpackageId];
     if (subpackage == null) {
-      throw new Error("Subpackage does not exist: " + subpackageId);
+      throw new CliError({
+        message: "Subpackage does not exist: " + subpackageId,
+        code: CliError.Code.ResolutionError
+      });
     }
     if (!isEqualIgnoreOrder(subpackage.subpackages, subpackagesInOrder)) {
-      throw new Error("Sorted subpackages differ from unsorted packages");
+      throw new CliError({
+        message: "Sorted subpackages differ from unsorted packages",
+        code: CliError.Code.InternalError
+      });
     }
     subpackage.subpackages = subpackagesInOrder;
   }
   getAllSubpackagesWithEndpoints(root6) {
     const subpackage = this.subpackages[root6];
     if (subpackage == null) {
-      throw new Error("Subpackage does not exist: " + root6);
+      throw new CliError({ message: "Subpackage does not exist: " + root6, code: CliError.Code.ResolutionError });
     }
     const subpackagesWithEndpoints = this.getAllChildrenWithEndpoints(subpackage);
     if (subpackagesWithEndpoints.length > 0 || subpackage.service != null) {
@@ -558419,7 +558704,10 @@ var PackageTreeGenerator = class {
     const subpackagesInParent = parent.subpackages.map((subpackageId) => {
       const subpackage = this.subpackages[subpackageId];
       if (subpackage == null) {
-        throw new Error("Subpackage ID is invalid: " + subpackageId);
+        throw new CliError({
+          message: "Subpackage ID is invalid: " + subpackageId,
+          code: CliError.Code.InternalError
+        });
       }
       return subpackage;
     });
@@ -558498,7 +558786,10 @@ var EndpointResolverImpl = class {
   resolveEndpointOrThrow({ endpoint: endpoint3, file: file4 }) {
     const resolvedEndpoint = this.resolveEndpoint({ endpoint: endpoint3, file: file4 });
     if (resolvedEndpoint == null) {
-      throw new Error("Cannot resolve endpoint: " + endpoint3 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve endpoint: " + endpoint3 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedEndpoint;
   }
@@ -558626,7 +558917,10 @@ var ErrorResolverImpl = class {
   getDeclarationOrThrow(referenceToError, file4) {
     const declaration = this.getDeclaration(referenceToError, file4);
     if (declaration == null) {
-      throw new Error("Error does not exist: " + referenceToError);
+      throw new CliError({
+        message: "Error does not exist: " + referenceToError,
+        code: CliError.Code.ResolutionError
+      });
     }
     return declaration;
   }
@@ -558712,7 +559006,7 @@ var ExampleResolverImpl = class {
   resolveAllReferencesInExampleOrThrow({ example, file: file4 }) {
     const resolvedExample = this.resolveAllReferencesInExample({ example, file: file4 });
     if (resolvedExample == null) {
-      throw new Error("Failed to resolve examples");
+      throw new CliError({ message: "Failed to resolve examples", code: CliError.Code.ResolutionError });
     }
     return resolvedExample;
   }
@@ -558759,7 +559053,7 @@ var ExampleResolverImpl = class {
   resolveExampleOrThrow({ example, file: file4 }) {
     const resolvedExample = this.resolveExample({ example, file: file4 });
     if (resolvedExample == null) {
-      throw new Error("Cannot resolve example: " + example);
+      throw new CliError({ message: "Cannot resolve example: " + example, code: CliError.Code.ResolutionError });
     }
     return resolvedExample;
   }
@@ -558810,7 +559104,10 @@ var PropertyResolverImpl = class {
   resolveRequestPropertyOrThrow({ file: file4, endpoint: endpoint3, propertyComponents }) {
     const resolvedRequestProperty = this.resolveRequestProperty({ file: file4, endpoint: endpoint3, propertyComponents });
     if (resolvedRequestProperty == null) {
-      throw new Error("Cannot resolve request property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve request property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedRequestProperty;
   }
@@ -558854,7 +559151,10 @@ var PropertyResolverImpl = class {
   resolveResponsePropertyOrThrow({ file: file4, endpoint: endpoint3, propertyComponents }) {
     const resolvedResponseProperty = this.resolveResponseProperty({ file: file4, endpoint: endpoint3, propertyComponents });
     if (resolvedResponseProperty == null) {
-      throw new Error("Cannot resolve response property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve response property from endpoint: " + endpoint3 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedResponseProperty;
   }
@@ -559021,7 +559321,10 @@ var PropertyResolverImpl = class {
         propertyComponents: breadcrumbs
       });
       if (!currentType) {
-        throw new Error(`Cannot find property '${breadcrumbs.join(".")}' in inline request body in file ${file4.relativeFilepath}`);
+        throw new CliError({
+          message: `Cannot find property '${breadcrumbs.join(".")}' in inline request body in file ${file4.relativeFilepath}`,
+          code: CliError.Code.InternalError
+        });
       }
       result.push({
         name: file4.casingsGenerator.generateName(component),
@@ -559039,7 +559342,10 @@ function getNestedObjectPropertyTypeOrThrow({ typeResolver, file: file4, resolve
     propertyName
   });
   if (!nestedPropertyType) {
-    throw new Error(`Cannot find property '${breadcrumbs.join(".")}' in ${rootTypeLabel}`);
+    throw new CliError({
+      message: `Cannot find property '${breadcrumbs.join(".")}' in ${rootTypeLabel}`,
+      code: CliError.Code.InternalError
+    });
   }
   return nestedPropertyType;
 }
@@ -559216,14 +559522,20 @@ var TypeResolverImpl = class {
   resolveTypeOrThrow({ type: type8, file: file4 }) {
     const resolvedType = this.resolveType({ type: type8, file: file4 });
     if (resolvedType == null) {
-      throw new Error("Cannot resolve type: " + type8 + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot resolve type: " + type8 + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedType;
   }
   getDeclarationOfNamedTypeOrThrow({ referenceToNamedType, file: file4 }) {
     const declaration = this.getDeclarationOfNamedType({ referenceToNamedType, file: file4 });
     if (declaration == null) {
-      throw new Error("Cannot find declaration of type: " + referenceToNamedType + " in file " + file4.relativeFilepath);
+      throw new CliError({
+        message: "Cannot find declaration of type: " + referenceToNamedType + " in file " + file4.relativeFilepath,
+        code: CliError.Code.ResolutionError
+      });
     }
     return declaration;
   }
@@ -559366,7 +559678,10 @@ var TypeResolverImpl = class {
   resolveNamedTypeOrThrow({ referenceToNamedType, file: file4 }) {
     const resolvedType = this.resolveNamedType({ referenceToNamedType, file: file4 });
     if (resolvedType == null) {
-      throw new Error("Cannot resolve type: " + referenceToNamedType);
+      throw new CliError({
+        message: "Cannot resolve type: " + referenceToNamedType,
+        code: CliError.Code.ResolutionError
+      });
     }
     return resolvedType;
   }
@@ -559425,7 +559740,10 @@ var VariableResolverImpl = class _VariableResolverImpl {
   getDeclarationOrThrow(referenceToVariable, file4) {
     const declaration = this.getDeclaration(referenceToVariable, file4);
     if (declaration == null) {
-      throw new Error("Variable does not exist: " + referenceToVariable);
+      throw new CliError({
+        message: "Variable does not exist: " + referenceToVariable,
+        code: CliError.Code.ResolutionError
+      });
     }
     return declaration;
   }
@@ -559448,7 +559766,10 @@ var VariableResolverImpl = class _VariableResolverImpl {
   getVariableIdOrThrow(referenceToVariable) {
     const variableId = this.getVariableId(referenceToVariable);
     if (variableId == null) {
-      throw new Error("Variable reference does not start with " + _VariableResolverImpl.VARIABLE_PREFIX);
+      throw new CliError({
+        message: "Variable reference does not start with " + _VariableResolverImpl.VARIABLE_PREFIX,
+        code: CliError.Code.ResolutionError
+      });
     }
     return variableId;
   }
@@ -559620,7 +559941,10 @@ function generateIntermediateRepresentation({ workspace, generationLanguage, key
         }
         const errorDiscriminationSchema = workspace.definition.rootApiFile.contents["error-discrimination"];
         if (errorDiscriminationSchema == null) {
-          throw new Error("error-discrimination is missing in api.yml but there are declared errors.");
+          throw new CliError({
+            message: "error-discrimination is missing in api.yml but there are declared errors.",
+            code: CliError.Code.ConfigError
+          });
         }
         for (const [errorName, errorDeclaration] of Object.entries(errors4)) {
           const convertedErrorDeclaration = convertErrorDeclaration({
@@ -562560,7 +562884,10 @@ var ValidNavigationRule = {
           }
           const expectedItems = directoryToChildren[dirname6(relativeFilepath)];
           if (expectedItems == null) {
-            throw new Error(`Could not find expected contents of ${relativeFilepath}`);
+            throw new CliError({
+              message: `Could not find expected contents of ${relativeFilepath}`,
+              code: CliError.Code.InternalError
+            });
           }
           const violations = [];
           const seen = /* @__PURE__ */ new Set();
@@ -563804,7 +564131,10 @@ var ValidPaginationRule = {
               pathPagination: endpointPagination
             });
           }
-          throw new Error("Invalid pagination schema");
+          throw new CliError({
+            message: "Invalid pagination schema",
+            code: CliError.Code.ValidationError
+          });
         }
       }
     };
@@ -566237,7 +566567,10 @@ var ConjureImporter = class extends APIDefinitionImporter {
       if (definition3.services == null || Object.keys(definition3.services ?? {}).length === 0) {
         const fernFilePath = this.conjureFilepathToFernFilepath[filepath];
         if (fernFilePath == null) {
-          throw new Error(`Failed to find corresponding fern filepath for conjure file ${filepath}`);
+          throw new CliError({
+            message: `Failed to find corresponding fern filepath for conjure file ${filepath}`,
+            code: CliError.Code.InternalError
+          });
         }
         for (const [import_, importedFilepath] of Object.entries(definition3.types?.conjureImports ?? {})) {
           const fernFileToImport = this.getFernFileToImport({
@@ -566299,7 +566632,10 @@ var ConjureImporter = class extends APIDefinitionImporter {
             for (const pathParameter of endpointLocator.pathParameters) {
               const pathParameterType = endpointDeclaration.args[pathParameter];
               if (pathParameterType == null) {
-                throw new Error(`Failed to find path parameter ${pathParameter} in ${endpointDeclaration.http}`);
+                throw new CliError({
+                  message: `Failed to find path parameter ${pathParameter} in ${endpointDeclaration.http}`,
+                  code: CliError.Code.InternalError
+                });
               }
               pathParameters[pathParameter] = typeof pathParameterType === "string" ? pathParameterType : (
                 // biome-ignore lint/suspicious/noExplicitAny: allow explicit any
@@ -566435,7 +566771,10 @@ var ConjureImporter = class extends APIDefinitionImporter {
     const relativeFilePathToImportedFile = relativize(absoluteFilePathToConjureFolder, absoluteFilePathToImportedFile);
     const correspondingFernFilePath = this.conjureFilepathToFernFilepath[relativeFilePathToImportedFile];
     if (correspondingFernFilePath == null) {
-      throw new Error(`Failed to find corresponding fern filepath for conjure file ${relativeFilePathToImportedFile}`);
+      throw new CliError({
+        message: `Failed to find corresponding fern filepath for conjure file ${relativeFilePathToImportedFile}`,
+        code: CliError.Code.InternalError
+      });
     }
     return correspondingFernFilePath;
   }
@@ -581572,7 +581911,9 @@ function getPathToLocalStorageDependency(dependency) {
 }
 async function validateLocalDependencyAndGetDefinition({ dependency, context: context3, cliVersion, settings, loadAPIWorkspace: loadAPIWorkspace2 }) {
   if (loadAPIWorkspace2 == null) {
-    context3.failWithoutThrowing("Failed to load api definition");
+    context3.failWithoutThrowing("Failed to load api definition", void 0, {
+      code: CliError.Code.ResolutionError
+    });
     return void 0;
   }
   context3.logger.info("Parsing...");
@@ -581583,7 +581924,9 @@ async function validateLocalDependencyAndGetDefinition({ dependency, context: co
     workspaceName: void 0
   });
   if (!loadDependencyWorkspaceResult.didSucceed) {
-    context3.failWithoutThrowing("Failed to load api definition", loadDependencyWorkspaceResult.failures);
+    context3.failWithoutThrowing("Failed to load api definition", loadDependencyWorkspaceResult.failures, {
+      code: CliError.Code.ResolutionError
+    });
     return void 0;
   }
   context3.logger.info("Modifying source filepath ...");
@@ -581605,16 +581948,24 @@ async function validateVersionedDependencyAndGetDefinition({ dependency, context
     if (!response.ok) {
       response.error._visit({
         orgDoesNotExistError: () => {
-          context3.failWithoutThrowing("Organization does not exist");
+          context3.failWithoutThrowing("Organization does not exist", void 0, {
+            code: CliError.Code.ResolutionError
+          });
         },
         apiDoesNotExistError: () => {
-          context3.failWithoutThrowing("API does not exist");
+          context3.failWithoutThrowing("API does not exist", void 0, {
+            code: CliError.Code.ResolutionError
+          });
         },
         versionDoesNotExistError: () => {
-          context3.failWithoutThrowing("Version does not exist");
+          context3.failWithoutThrowing("Version does not exist", void 0, {
+            code: CliError.Code.ResolutionError
+          });
         },
         _other: (error50) => {
-          context3.failWithoutThrowing("Failed to download API manifest", error50);
+          context3.failWithoutThrowing("Failed to download API manifest", error50, {
+            code: CliError.Code.NetworkError
+          });
         }
       });
       return void 0;
@@ -581624,14 +581975,14 @@ async function validateVersionedDependencyAndGetDefinition({ dependency, context
     const parsedCliVersionOfDependency = parseVersion(response.body.cliVersion);
     if (parsedYamlVersionOfDependency != null) {
       if (parsedYamlVersionOfDependency > YAML_SCHEMA_VERSION) {
-        context3.failWithoutThrowing(`${dependency.organization}/${dependency.apiName}@${dependency.version} on a higher version of fern. Upgrade this workspace to ${response.body.cliVersion}`);
+        context3.failWithoutThrowing(`${dependency.organization}/${dependency.apiName}@${dependency.version} on a higher version of fern. Upgrade this workspace to ${response.body.cliVersion}`, void 0, { code: CliError.Code.VersionError });
         return void 0;
       } else if (parsedYamlVersionOfDependency < YAML_SCHEMA_VERSION) {
-        context3.failWithoutThrowing(`${dependency.organization}/${dependency.apiName}@${dependency.version} on a lower version of fern. Upgrade it to ${cliVersion}`);
+        context3.failWithoutThrowing(`${dependency.organization}/${dependency.apiName}@${dependency.version} on a lower version of fern. Upgrade it to ${cliVersion}`, void 0, { code: CliError.Code.VersionError });
         return void 0;
       }
     } else if (parsedCliVersion.major !== parsedCliVersionOfDependency.major || parsedCliVersion.minor !== parsedCliVersionOfDependency.minor) {
-      context3.failWithoutThrowing(`CLI version is ${response.body.cliVersion}. Expected ${parsedCliVersion.major}.${parsedCliVersion.minor}.x (to match current workspace).`);
+      context3.failWithoutThrowing(`CLI version is ${response.body.cliVersion}. Expected ${parsedCliVersion.major}.${parsedCliVersion.minor}.x (to match current workspace).`, void 0, { code: CliError.Code.VersionError });
       return void 0;
     }
     context3.logger.info("Downloading...");
@@ -581643,7 +581994,9 @@ async function validateVersionedDependencyAndGetDefinition({ dependency, context
         absolutePathToLocalOutput: pathToDefinition
       });
     } catch (error50) {
-      context3.failWithoutThrowing("Failed to download API", error50);
+      context3.failWithoutThrowing("Failed to download API", error50, {
+        code: CliError.Code.NetworkError
+      });
       return void 0;
     }
     metadata = response.body;
@@ -581653,7 +582006,9 @@ async function validateVersionedDependencyAndGetDefinition({ dependency, context
   }
   context3.logger.info("Parsing...");
   if (loadAPIWorkspace2 == null) {
-    context3.failWithoutThrowing("Failed to load API");
+    context3.failWithoutThrowing("Failed to load API", void 0, {
+      code: CliError.Code.ResolutionError
+    });
     return void 0;
   }
   const loadDependencyWorkspaceResult = await loadAPIWorkspace2({
@@ -581663,12 +582018,14 @@ async function validateVersionedDependencyAndGetDefinition({ dependency, context
     workspaceName: void 0
   });
   if (!loadDependencyWorkspaceResult.didSucceed) {
-    context3.failWithoutThrowing("Failed to parse dependency after downloading", loadDependencyWorkspaceResult.failures);
+    context3.failWithoutThrowing("Failed to parse dependency after downloading", loadDependencyWorkspaceResult.failures, { code: CliError.Code.ParseError });
     return void 0;
   }
   const workspaceOfDependency = loadDependencyWorkspaceResult.workspace;
   if (workspaceOfDependency.type === "oss") {
-    context3.failWithoutThrowing("Dependency must be a fern workspace.");
+    context3.failWithoutThrowing("Dependency must be a fern workspace.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return void 0;
   }
   return await loadDependencyWorkspaceResult.workspace.getDefinition({ context: context3 }, settings);
@@ -592208,7 +592565,9 @@ var LazyFernWorkspace = class extends AbstractAPIWorkspace {
       const parseResult = await parseYamlFiles(yamlFiles);
       if (!parseResult.didSucceed) {
         handleFailedWorkspaceParserResultRaw(parseResult.failures, defaultedContext.logger);
-        return defaultedContext.failAndThrow();
+        return defaultedContext.failAndThrow(void 0, void 0, {
+          code: CliError.Code.ValidationError
+        });
       }
       const structuralValidationResult = validateStructureOfYamlFiles({
         files: parseResult.files,
@@ -592217,7 +592576,9 @@ var LazyFernWorkspace = class extends AbstractAPIWorkspace {
       });
       if (!structuralValidationResult.didSucceed) {
         handleFailedWorkspaceParserResultRaw(structuralValidationResult.failures, defaultedContext.logger);
-        return defaultedContext.failAndThrow();
+        return defaultedContext.failAndThrow(void 0, void 0, {
+          code: CliError.Code.ValidationError
+        });
       }
       const processPackageMarkersResult = await processPackageMarkers({
         dependenciesConfiguration,
@@ -592229,7 +592590,9 @@ var LazyFernWorkspace = class extends AbstractAPIWorkspace {
       });
       if (!processPackageMarkersResult.didSucceed) {
         handleFailedWorkspaceParserResultRaw(processPackageMarkersResult.failures, defaultedContext.logger);
-        return defaultedContext.failAndThrow();
+        return defaultedContext.failAndThrow(void 0, void 0, {
+          code: CliError.Code.ValidationError
+        });
       }
       let definition3 = {
         absoluteFilePath: absolutePathToDefinition,
@@ -592296,7 +592659,9 @@ async function mergeWithOverrides2({ absoluteFilePathToOverrides, data: data2, c
       parsedOverrides = jsYaml.load(contents, { json: true });
     }
   } catch (err) {
-    return context3.failAndThrow(`Failed to read overrides from file ${absoluteFilePathToOverrides}`);
+    return context3.failAndThrow(`Failed to read overrides from file ${absoluteFilePathToOverrides}`, void 0, {
+      code: CliError.Code.ParseError
+    });
   }
   return mergeWithOverrides({ data: data2, overrides: parsedOverrides, allowNullKeys });
 }
@@ -592456,7 +592821,10 @@ async function resolveExternalRefs(obj, baseDir, mainFileAbsPath, registry2, app
     }
     const cacheKey = `${absoluteRefPath}#${jsonPointer}`;
     if (visited.has(cacheKey)) {
-      throw new Error(`Circular $ref detected: "${ref2}" (resolved to "${cacheKey}")`);
+      throw new CliError({
+        message: `Circular $ref detected: "${ref2}" (resolved to "${cacheKey}")`,
+        code: CliError.Code.ReferenceError
+      });
     }
     const newVisited = new Set(visited);
     newVisited.add(cacheKey);
@@ -592539,7 +592907,9 @@ async function parseOverlayFile(absoluteFilePathToOverlay, context3) {
   try {
     contents = await (0, import_promises26.readFile)(absoluteFilePathToOverlay, "utf8");
   } catch (err) {
-    return context3.failAndThrow(`Failed to read overlay file at ${absoluteFilePathToOverlay}: ${err}`);
+    return context3.failAndThrow(`Failed to read overlay file at ${absoluteFilePathToOverlay}: ${err}`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   try {
     try {
@@ -592548,7 +592918,9 @@ async function parseOverlayFile(absoluteFilePathToOverlay, context3) {
       return jsYaml.load(contents, { json: true });
     }
   } catch (err) {
-    return context3.failAndThrow(`Failed to parse overlay file at ${absoluteFilePathToOverlay}: ${err}`);
+    return context3.failAndThrow(`Failed to parse overlay file at ${absoluteFilePathToOverlay}: ${err}`, void 0, {
+      code: CliError.Code.ParseError
+    });
   }
 }
 function validateOverlay(overlay, context3) {
@@ -595871,7 +596243,10 @@ function createTypeReferenceFromFernType(fernType) {
           string: (value2) => Literal.string(value2),
           boolean: (value2) => Literal.boolean(value2),
           _other: () => {
-            throw new Error("Unexpected literal type");
+            throw new CliError({
+              message: "Unexpected literal type",
+              code: CliError.Code.InternalError
+            });
           }
         })));
       },
@@ -599912,7 +600287,10 @@ var ChannelConverter3_0 = class extends AbstractChannelConverter {
   }
   getChannelPathFromOperation(operation) {
     if (!operation.channel.$ref.startsWith(CHANNEL_REFERENCE_PREFIX2)) {
-      throw new Error(`Failed to resolve channel path from operation ${operation.channel.$ref}`);
+      throw new CliError({
+        message: `Failed to resolve channel path from operation ${operation.channel.$ref}`,
+        code: CliError.Code.ReferenceError
+      });
     }
     return operation.channel.$ref.substring(CHANNEL_REFERENCE_PREFIX2.length);
   }
@@ -604748,7 +605126,7 @@ function getPlatformInfo() {
       osName = "Windows";
       break;
     default:
-      throw new Error(`Unsupported platform: ${platform3}`);
+      throw new CliError({ message: `Unsupported platform: ${platform3}`, code: CliError.Code.EnvironmentError });
   }
   let archName;
   switch (arch3) {
@@ -604759,7 +605137,7 @@ function getPlatformInfo() {
       archName = platform3 === "linux" ? "aarch64" : "arm64";
       break;
     default:
-      throw new Error(`Unsupported architecture: ${arch3}`);
+      throw new CliError({ message: `Unsupported architecture: ${arch3}`, code: CliError.Code.EnvironmentError });
   }
   return {
     os: osName,
@@ -604833,7 +605211,10 @@ async function acquireLock(logger4) {
         await new Promise((resolve14) => setTimeout(resolve14, LOCK_RETRY_INTERVAL_MS));
       }
     }
-    throw new Error(`Failed to acquire buf lock after timeout and retry`);
+    throw new CliError({
+      message: `Failed to acquire buf lock after timeout and retry`,
+      code: CliError.Code.InternalError
+    });
   }
   return createLockReleaser(lockPath, logger4);
 }
@@ -605022,7 +605403,10 @@ async function ensureBufCommand(logger4) {
       logger4.debug(`Using auto-downloaded buf: ${downloadedBufPath}`);
       return downloadedBufPath;
     }
-    throw new Error("Missing required dependency; please install 'buf' to continue (e.g. 'brew install buf').");
+    throw new CliError({
+      message: "Missing required dependency; please install 'buf' to continue (e.g. 'brew install buf').",
+      code: CliError.Code.EnvironmentError
+    });
   }
 }
 var PROTOBUF_GENERATOR_CONFIG_FILENAME = "buf.gen.yaml";
@@ -605239,7 +605623,7 @@ var ProtobufIRGenerator = class {
           try {
             await (0, import_promises34.access)(bufLockPath);
           } catch {
-            this.context.failAndThrow("Air-gapped mode requires a pre-cached buf.lock file. Please run 'buf dep update' at build time to cache dependencies.");
+            this.context.failAndThrow("Air-gapped mode requires a pre-cached buf.lock file. Please run 'buf dep update' at build time to cache dependencies.", void 0, { code: CliError.Code.InternalError });
           }
         } else {
           await buf(["dep", "update"]);
@@ -605247,7 +605631,9 @@ var ProtobufIRGenerator = class {
       }
       const bufGenerateResult = await buf(["generate"]);
       if (bufGenerateResult.exitCode !== 0) {
-        this.context.failAndThrow(bufGenerateResult.stderr);
+        this.context.failAndThrow(bufGenerateResult.stderr, void 0, {
+          code: CliError.Code.IrConversionError
+        });
       }
       await (0, import_promises34.unlink)(bufYamlPath);
     } catch (error50) {
@@ -605263,11 +605649,15 @@ var ProtobufIRGenerator = class {
     try {
       this.resolvedBufCommand = await ensureBufCommand(this.context.logger);
     } catch (error50) {
-      this.context.failAndThrow(error50 instanceof Error ? error50.message : String(error50));
+      this.context.failAndThrow(error50 instanceof Error ? error50.message : String(error50), void 0, {
+        code: CliError.Code.EnvironmentError
+      });
     }
   }
   async generateRemote() {
-    this.context.failAndThrow("Remote Protobuf generation is unimplemented.");
+    this.context.failAndThrow("Remote Protobuf generation is unimplemented.", void 0, {
+      code: CliError.Code.InternalError
+    });
   }
 };
 
@@ -605307,7 +605697,7 @@ function getPlatformInfo2() {
       osName = "windows";
       break;
     default:
-      throw new Error(`Unsupported platform: ${platform3}`);
+      throw new CliError({ message: `Unsupported platform: ${platform3}`, code: CliError.Code.EnvironmentError });
   }
   let archName;
   switch (arch3) {
@@ -605318,7 +605708,7 @@ function getPlatformInfo2() {
       archName = "arm64";
       break;
     default:
-      throw new Error(`Unsupported architecture: ${arch3}`);
+      throw new CliError({ message: `Unsupported architecture: ${arch3}`, code: CliError.Code.EnvironmentError });
   }
   return {
     os: osName,
@@ -605392,7 +605782,10 @@ async function acquireLock2(logger4) {
         await new Promise((resolve14) => setTimeout(resolve14, LOCK_RETRY_INTERVAL_MS2));
       }
     }
-    throw new Error(`Failed to acquire lock after timeout and retry`);
+    throw new CliError({
+      message: `Failed to acquire lock after timeout and retry`,
+      code: CliError.Code.InternalError
+    });
   }
   return createLockReleaser2(lockPath, logger4);
 }
@@ -605510,7 +605903,9 @@ var ProtobufOpenAPIGenerator = class {
    */
   async prepare({ absoluteFilepathToProtobufRoot, relativeFilepathToProtobufRoot, local, deps }) {
     if (!local) {
-      this.context.failAndThrow("Remote Protobuf generation is unimplemented.");
+      this.context.failAndThrow("Remote Protobuf generation is unimplemented.", void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     await this.ensureBufResolved();
     await this.ensureProtocGenOpenAPIResolved();
@@ -605530,7 +605925,7 @@ var ProtobufOpenAPIGenerator = class {
         try {
           await (0, import_promises36.access)(bufLockPath);
         } catch {
-          this.context.failAndThrow("Air-gapped mode requires a pre-cached buf.lock file. Please run 'buf dep update' at build time to cache dependencies.");
+          this.context.failAndThrow("Air-gapped mode requires a pre-cached buf.lock file. Please run 'buf dep update' at build time to cache dependencies.", void 0, { code: CliError.Code.InternalError });
         }
       } else {
         const bufCommand = this.resolvedBufCommand ?? "buf";
@@ -605567,7 +605962,9 @@ var ProtobufOpenAPIGenerator = class {
     });
     const bufGenerateResult = await buf(["generate", target.toString()]);
     if (bufGenerateResult.exitCode !== 0) {
-      this.context.failAndThrow(bufGenerateResult.stderr);
+      this.context.failAndThrow(bufGenerateResult.stderr, void 0, {
+        code: CliError.Code.IrConversionError
+      });
     }
     const outputPath = join8(preparedDir.cwd, RelativeFilePath2.of(PROTOBUF_GENERATOR_OUTPUT_FILEPATH2));
     const uniqueOutput = AbsoluteFilePath2.of((await import_tmp_promise7.default.file({ postfix: ".yaml" })).path);
@@ -605625,7 +606022,7 @@ var ProtobufOpenAPIGenerator = class {
           try {
             await (0, import_promises36.access)(bufLockPath);
           } catch {
-            this.context.failAndThrow("Air-gapped mode requires a pre-cached buf.lock file. Please run 'buf dep update' at build time to cache dependencies.");
+            this.context.failAndThrow("Air-gapped mode requires a pre-cached buf.lock file. Please run 'buf dep update' at build time to cache dependencies.", void 0, { code: CliError.Code.InternalError });
           }
         } else {
           await buf(["dep", "update"]);
@@ -605638,7 +606035,9 @@ var ProtobufOpenAPIGenerator = class {
       }
       const bufGenerateResult = await buf(["generate", target.toString()]);
       if (bufGenerateResult.exitCode !== 0) {
-        this.context.failAndThrow(bufGenerateResult.stderr);
+        this.context.failAndThrow(bufGenerateResult.stderr, void 0, {
+          code: CliError.Code.IrConversionError
+        });
       }
       if (cleanupBufLock) {
         await (0, import_promises36.unlink)(bufLockPath);
@@ -605676,7 +606075,7 @@ var ProtobufOpenAPIGenerator = class {
         this.protocGenOpenAPIResolved = true;
         return;
       } catch {
-        this.context.failAndThrow("FERN_USE_LOCAL_PROTOC_GEN_OPENAPI is set but protoc-gen-openapi was not found on PATH.");
+        this.context.failAndThrow("FERN_USE_LOCAL_PROTOC_GEN_OPENAPI is set but protoc-gen-openapi was not found on PATH.", void 0, { code: CliError.Code.EnvironmentError });
       }
     }
     this.context.logger.debug("Resolving protoc-gen-openapi (preferring auto-downloaded fern fork)");
@@ -605701,7 +606100,7 @@ var ProtobufOpenAPIGenerator = class {
       }
       this.protocGenOpenAPIResolved = true;
     } catch {
-      this.context.failAndThrow("Missing required dependency; please install 'protoc-gen-openapi' to continue (e.g. 'brew install go && go install github.com/fern-api/protoc-gen-openapi/cmd/protoc-gen-openapi@latest').");
+      this.context.failAndThrow("Missing required dependency; please install 'protoc-gen-openapi' to continue (e.g. 'brew install go && go install github.com/fern-api/protoc-gen-openapi/cmd/protoc-gen-openapi@latest').", void 0, { code: CliError.Code.EnvironmentError });
     }
   }
   async ensureBufResolved() {
@@ -605711,11 +606110,15 @@ var ProtobufOpenAPIGenerator = class {
     try {
       this.resolvedBufCommand = await ensureBufCommand(this.context.logger);
     } catch (error50) {
-      this.context.failAndThrow(error50 instanceof Error ? error50.message : String(error50));
+      this.context.failAndThrow(error50 instanceof Error ? error50.message : String(error50), void 0, {
+        code: CliError.Code.EnvironmentError
+      });
     }
   }
   async generateRemote() {
-    this.context.failAndThrow("Remote Protobuf generation is unimplemented.");
+    this.context.failAndThrow("Remote Protobuf generation is unimplemented.", void 0, {
+      code: CliError.Code.InternalError
+    });
   }
 };
 function getProtobufGeneratorConfig({ relativeFilepathToProtobufRoot }) {
@@ -606094,7 +606497,10 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
       }
     }
     if (mergedIr === void 0) {
-      throw new Error("Failed to generate intermediate representation");
+      throw new CliError({
+        message: "Failed to generate intermediate representation",
+        code: CliError.Code.IrConversionError
+      });
     }
     if (authOverrides != null) {
       mergedIr = resolveOAuthEndpointReferences({ ir: mergedIr, authOverrides });
@@ -606190,7 +606596,10 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
   }
   async convertSpecsOverrideToSpecs(specsOverride) {
     if (!Array.isArray(specsOverride)) {
-      throw new Error("Conjure specs override is not yet supported");
+      throw new CliError({
+        message: "Conjure specs override is not yet supported",
+        code: CliError.Code.InternalError
+      });
     }
     const specs = [];
     for (const spec of specsOverride) {
@@ -606224,7 +606633,10 @@ var OSSWorkspace = class _OSSWorkspace extends BaseOpenAPIWorkspace {
         };
         specs.push(openApiSpec);
       } else {
-        throw new Error(`Spec type override not yet supported. Only OpenAPI specs are currently supported in specs override.`);
+        throw new CliError({
+          message: `Spec type override not yet supported. Only OpenAPI specs are currently supported in specs override.`,
+          code: CliError.Code.InternalError
+        });
       }
     }
     return specs;
@@ -614356,7 +614768,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.81.1",
+          version: "4.82.0-3-gc1f31446d2e",
           usingAccessToken: true
         }
       });
@@ -614410,7 +614822,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.81.1",
+        version: "4.82.0-3-gc1f31446d2e",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -615290,7 +615702,7 @@ async function doAuth0DeviceAuthorizationFlow({ auth0Domain: auth0Domain2, auth0
     validateStatus: () => true
   });
   if (deviceCodeResponse.status !== 200) {
-    context3.failAndThrow("Failed to authenticate", deviceCodeResponse.data);
+    context3.failAndThrow("Failed to authenticate", deviceCodeResponse.data, { code: CliError.Code.AuthError });
   }
   await (0, import_open.default)(deviceCodeResponse.data.verification_uri_complete);
   context3.logger.info([
@@ -615345,7 +615757,7 @@ async function pollForToken({ auth0Domain: auth0Domain2, auth0ClientId, deviceCo
     case "access_denied":
     case "expired_token":
     default:
-      return context3.failAndThrow("Failed to authenticate", data2);
+      return context3.failAndThrow("Failed to authenticate", data2, { code: CliError.Code.AuthError });
   }
 }
 
@@ -615435,10 +615847,10 @@ async function getTokenFromCode({ auth0Domain: auth0Domain2, auth0ClientId, code
   });
   const { access_token: accessToken, id_token: idToken } = response.data;
   if (accessToken == null) {
-    throw new Error("Access token is not defined");
+    throw new CliError({ message: "Access token is not defined", code: CliError.Code.AuthError });
   }
   if (idToken == null) {
-    throw new Error("ID token is not defined");
+    throw new CliError({ message: "ID token is not defined", code: CliError.Code.AuthError });
   }
   return { accessToken, idToken };
 }
@@ -615469,17 +615881,26 @@ async function resolveSsoConnection({ dashboardBaseUrl, email: email3 }) {
     });
   } catch (error50) {
     if (axios_default.isAxiosError(error50) && error50.response?.status === 404) {
-      throw new Error(`No SSO connection associated with email: ${email3}`);
+      throw new CliError({
+        message: `No SSO connection associated with email: ${email3}`,
+        code: CliError.Code.AuthError
+      });
     }
     throw error50;
   }
   const responseData = response.data;
   if (typeof responseData !== "object" || responseData == null) {
-    throw new Error("Invalid response format from SSO resolve endpoint");
+    throw new CliError({
+      message: "Invalid response format from SSO resolve endpoint",
+      code: CliError.Code.AuthError
+    });
   }
   const { connection } = responseData;
   if (typeof connection !== "string" || connection.length === 0) {
-    throw new Error("No SSO connection found for this email");
+    throw new CliError({
+      message: "No SSO connection found for this email",
+      code: CliError.Code.AuthError
+    });
   }
   return connection;
 }
@@ -615547,14 +615968,14 @@ async function askToLogin(context3) {
   if (!await isLoggedIn() && process.stdout.isTTY) {
     await context3.takeOverTerminal(async () => {
       if (!await askForConfirmation("Login required. Continue?")) {
-        context3.failAndThrow();
+        context3.failAndThrow(void 0, void 0, { code: CliError.Code.AuthError });
       }
     });
     await login(context3);
   }
   const token = await getToken2();
   if (token == null) {
-    context3.failAndThrow("Authentication required. Please run 'fern login' or set the FERN_TOKEN environment variable.");
+    context3.failAndThrow("Authentication required. Please run 'fern login' or set the FERN_TOKEN environment variable.", void 0, { code: CliError.Code.AuthError });
   }
   return token;
 }
@@ -615614,7 +616035,10 @@ var PlatformKeyring = class {
         await this.setPasswordWindows(service, account, password);
         break;
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async getPassword(service, account) {
@@ -615626,7 +616050,10 @@ var PlatformKeyring = class {
       case "win32":
         return this.getPasswordWindows(service, account);
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async deletePassword(service, account) {
@@ -615638,7 +616065,10 @@ var PlatformKeyring = class {
       case "win32":
         return this.deletePasswordWindows(service, account);
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async findCredentials(service) {
@@ -615650,7 +616080,10 @@ var PlatformKeyring = class {
       case "win32":
         return this.findCredentialsWindows(service);
       default:
-        throw new Error(`Unsupported platform: ${process.platform}`);
+        throw new CliError({
+          message: `Unsupported platform: ${process.platform}`,
+          code: CliError.Code.EnvironmentError
+        });
     }
   }
   async setPasswordDarwin(service, account, password) {
@@ -617574,7 +618007,10 @@ var YamlSourceResolver = class {
       case "boolean":
         return new SourcedBoolean(value2, location2);
       default:
-        throw new Error(`Unexpected value type: ${typeof value2}`);
+        throw new CliError({
+          message: `Unexpected value type: ${typeof value2}`,
+          code: CliError.Code.InternalError
+        });
     }
   }
 };
@@ -617654,7 +618090,10 @@ var YamlConfigLoader = class {
     try {
       return await this.parser.parseDocument({ absoluteFilePath, cwd: this.cwd });
     } catch (err) {
-      throw new Error(`Failed to parse YAML file ${absoluteFilePath}: ${extractErrorMessage(err)}`);
+      throw new CliError({
+        message: `Failed to parse YAML file ${absoluteFilePath}: ${extractErrorMessage(err)}`,
+        code: CliError.Code.ParseError
+      });
     }
   }
   async resolveReferences({ document: document4, resolveReferences }) {
@@ -617763,7 +618202,10 @@ var FileFinder = class {
   async findOrThrow({ filename, remediationMessage }) {
     const filepath = await this.find({ filename });
     if (filepath == null) {
-      throw new Error(`${filename} file not found in any parent directory from ${this.from}`);
+      throw new CliError({
+        message: `${filename} file not found in any parent directory from ${this.from}`,
+        code: CliError.Code.InternalError
+      });
     }
     return filepath;
   }
@@ -617805,7 +618247,10 @@ var FernYmlSchemaLoader = class {
   async loadOrThrow() {
     const loadResult = await this.load();
     if (loadResult.type === "notFound") {
-      throw new Error(`${FILENAME2} file not found in any parent directory; did you forget to run \`fern init\`?`);
+      throw new CliError({
+        message: `${FILENAME2} file not found in any parent directory; did you forget to run \`fern init\`?`,
+        code: CliError.Code.InternalError
+      });
     }
     if (loadResult.type === "failure") {
       throw new SourcedValidationError(loadResult.issues);
@@ -617876,7 +618321,10 @@ var TelemetryClient = class _TelemetryClient {
     if (sentryDsn != null && sentryDsn.length > 0 && isTelemetryEnabled) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
-        throw new Error("SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured");
+        throw new CliError({
+          message: "SENTRY_ENVIRONMENT must be set when SENTRY_DSN is configured",
+          code: CliError.Code.ConfigError
+        });
       }
       this.sentry = init2({
         dsn: sentryDsn,
@@ -617994,7 +618442,7 @@ var TelemetryClient = class _TelemetryClient {
     return join8(AbsoluteFilePath2.of((0, import_os8.homedir)()), RelativeFilePath2.of(".fern"), RelativeFilePath2.of("id"));
   }
   /**
-   * Returns true if telemetry should be disabled.
+   * Returns true if telemetry is enabled.
    *
    * Priority:
    *  1. FERN_TELEMETRY_DISABLED env var (any non-empty value)
@@ -618176,7 +618624,10 @@ var ApiDefinitionConverter = class {
         sourced
       });
     }
-    throw new Error(`Unknown spec type: ${JSON.stringify(spec)}`);
+    throw new CliError({
+      message: `Unknown spec type: ${JSON.stringify(spec)}`,
+      code: CliError.Code.InternalError
+    });
   }
   async convertOpenApiSpec({ absoluteFernYmlPath, spec, sourced }) {
     const result = {
@@ -619536,7 +619987,10 @@ var LegacyApiSpecAdapter = class {
     if (isOpenRpcSpec(spec)) {
       return this.adaptOpenRpcSpec(spec);
     }
-    throw new Error(`Unsupported spec type: ${JSON.stringify(spec)}`);
+    throw new CliError({
+      message: `Unsupported spec type: ${JSON.stringify(spec)}`,
+      code: CliError.Code.InternalError
+    });
   }
   convertAll(specs) {
     return specs.map((spec) => this.adapt(spec));
@@ -742131,7 +742585,7 @@ function convertTypes(types4) {
           return IrVersions_exports.V54.types.Type.undiscriminatedUnion(convertUndiscriminatedUnion(undiscriminatedUnion21));
         },
         _other: () => {
-          throw new Error("Encountered unknown shape");
+          throw new CliError({ message: "Encountered unknown shape", code: CliError.Code.InternalError });
         }
       })
     };
@@ -742294,7 +742748,10 @@ function convertTypeReference(typeReference2) {
     named: IrVersions_exports.V54.types.TypeReference.named,
     unknown: IrVersions_exports.V54.types.TypeReference.unknown,
     _other: () => {
-      throw new Error("Unknown type reference: " + typeReference2.type);
+      throw new CliError({
+        message: "Unknown type reference: " + typeReference2.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -742322,7 +742779,10 @@ function convertContainerType(container) {
     }),
     literal: IrVersions_exports.V54.types.ContainerType.literal,
     _other: () => {
-      throw new Error("Unknown ContainerType: " + container.type);
+      throw new CliError({
+        message: "Unknown ContainerType: " + container.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -742341,7 +742801,10 @@ function convertSingleUnionTypeProperties(properties7) {
     }),
     noProperties: IrVersions_exports.V54.types.SingleUnionTypeProperties.noProperties,
     _other: () => {
-      throw new Error(`Unknown SingleUnionTypeProperties: ${JSON.stringify(properties7)}`);
+      throw new CliError({
+        message: `Unknown SingleUnionTypeProperties: ${JSON.stringify(properties7)}`,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -742352,7 +742815,10 @@ function convertResolvedType(resolvedType) {
     primitive: (primitiveType2) => IrVersions_exports.V54.types.ResolvedTypeReference.primitive(convertPrimitiveType(primitiveType2)),
     unknown: IrVersions_exports.V54.types.ResolvedTypeReference.unknown,
     _other: () => {
-      throw new Error("Unknown ResolvedTypeReference: " + resolvedType.type);
+      throw new CliError({
+        message: "Unknown ResolvedTypeReference: " + resolvedType.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -742551,7 +743017,10 @@ function convertSdkRequestShape(shape) {
     justRequestBody: (reference4) => IrVersions_exports.V54.http.SdkRequestShape.justRequestBody(convertSdkRequestBodyType(reference4)),
     wrapper: IrVersions_exports.V54.http.SdkRequestShape.wrapper,
     _other: () => {
-      throw new Error("Unknown SdkRequestShape: " + shape.type);
+      throw new CliError({
+        message: "Unknown SdkRequestShape: " + shape.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -742601,7 +743070,10 @@ function convertRequestBody(requestBody) {
       return IrVersions_exports.V54.http.HttpRequestBody.bytes(bytes);
     },
     _other: () => {
-      throw new Error("Unknown HttpRequestBody: " + requestBody.type);
+      throw new CliError({
+        message: "Unknown HttpRequestBody: " + requestBody.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -744039,7 +744511,7 @@ function convertAuthScheme(scheme) {
     case "inferred":
       return IrVersions_exports.V62.AuthScheme.inferred(scheme);
     default:
-      throw new Error("Unknown AuthScheme type");
+      throw new CliError({ message: "Unknown AuthScheme type", code: CliError.Code.InternalError });
   }
 }
 function convertTypeDeclaration2(typeDeclaration2) {
@@ -746454,10 +746926,16 @@ var IntermediateRepresentationMigratorImpl = class {
       if (targetGenerator != null) {
         const minVersion = this.getMinimumGeneratorVersion(targetGenerator.name);
         if (minVersion != null) {
-          throw new Error(`${targetGenerator.name}@${targetGenerator.version} is not compatible with CLI v4.x.x+. Please upgrade to ${targetGenerator.name}@${minVersion} or later using 'fern generator upgrade --include-major'.`);
+          throw new CliError({
+            message: `${targetGenerator.name}@${targetGenerator.version} is not compatible with CLI v4.x.x+. Please upgrade to ${targetGenerator.name}@${minVersion} or later using 'fern generator upgrade --include-major'.`,
+            code: CliError.Code.VersionError
+          });
         }
       }
-      throw new Error("This generator version is not compatible with CLI v4.x.x+. Please upgrade your generator using 'fern generator upgrade --include-major'.");
+      throw new CliError({
+        message: "This generator version is not compatible with CLI v4.x.x+. Please upgrade your generator using 'fern generator upgrade --include-major'.",
+        code: CliError.Code.VersionError
+      });
     }
   }
   migrateThroughVersion({ version: version7, intermediateRepresentation, context: context3, targetGenerator }) {
@@ -746483,7 +746961,7 @@ var IntermediateRepresentationMigratorImpl = class {
       targetGenerator
     });
     if (!hasEncounteredMigrationYet) {
-      context3.failAndThrow(`IR ${version7} does not exist`);
+      context3.failAndThrow(`IR ${version7} does not exist`, void 0, { code: CliError.Code.VersionError });
     }
     return migrated;
   }
@@ -746513,15 +746991,28 @@ var IntermediateRepresentationMigratorImpl = class {
   shouldRunMigration({ migration: migration23, targetGenerator }) {
     const minVersionToExclude = migration23.firstGeneratorVersionToConsumeNewIR[targetGenerator.name];
     if (minVersionToExclude == null) {
-      throw new Error(`Cannot migrate intermediate representation. Unrecognized generator: ${targetGenerator.name}. If leveraging a custom generator, ensure you are specifying "ir-version" within the generator configuration.`);
+      throw new CliError({
+        message: `Cannot migrate intermediate representation. Unrecognized generator: ${targetGenerator.name}. If leveraging a custom generator, ensure you are specifying "ir-version" within the generator configuration.`,
+        code: CliError.Code.ConfigError
+      });
     }
     switch (minVersionToExclude) {
       case GeneratorWasNeverUpdatedToConsumeNewIR:
         return true;
       case GeneratorWasNotCreatedYet:
-        throw new Error(`Cannot migrate intermediate representation. Generator was created after intermediate representation ${migration23.laterVersion}.`);
+        throw new CliError({
+          message: `Cannot migrate intermediate representation. Generator was created after intermediate representation ${migration23.laterVersion}.`,
+          code: CliError.Code.VersionError
+        });
+    }
+    try {
+      return isVersionAhead(minVersionToExclude, targetGenerator.version);
+    } catch (error50) {
+      throw new CliError({
+        message: `Failed to compare versions: ${error50 instanceof Error ? error50.message : String(error50)}`,
+        code: CliError.Code.VersionError
+      });
     }
-    return isVersionAhead(minVersionToExclude, targetGenerator.version);
   }
   getIRVersionForGenerator({ targetGenerator }) {
     let lastIrVersion = this.migrations[0]?.laterVersion;
@@ -746685,7 +747176,10 @@ var LegacyFernWorkspaceAdapter = class {
       generatorsConfiguration: apiConfig != null ? this.buildGeneratorsConfiguration(apiConfig) : void 0
     });
     if (ossWorkspace == null) {
-      throw new Error("Internal error; failed to build API definitions");
+      throw new CliError({
+        message: "Internal error; failed to build API definitions",
+        code: CliError.Code.InternalError
+      });
     }
     return ossWorkspace.toFernWorkspace({ context: this.taskContext });
   }
@@ -747842,7 +748336,10 @@ function addSplitCommand(cli) {
     description: `Output format: '${OVERLAY_NAME}' (OpenAPI Overlay 1.0.0) or '${OVERRIDES_NAME}' (Fern deep-merge)`
   }).coerce("format", (value2) => {
     if (!ALL_FORMAT_NAMES.includes(value2)) {
-      throw new Error(`Invalid format '${value2}'. Expected one of: ${OVERLAY_NAME}, ${OVERRIDES_NAME}`);
+      throw new CliError({
+        message: `Invalid format '${value2}'. Expected one of: ${OVERLAY_NAME}, ${OVERRIDES_NAME}`,
+        code: CliError.Code.ValidationError
+      });
     }
     return value2;
   }));
@@ -786403,7 +786900,10 @@ function mergeEndpointPairs({ children: children2, findEndpointById, stringifyEn
     }
     const endpoint3 = findEndpointById(child.endpointId);
     if (endpoint3 == null) {
-      throw new Error(`Endpoint ${child.endpointId} not found`);
+      throw new CliError({
+        message: `Endpoint ${child.endpointId} not found`,
+        code: CliError.Code.InternalError
+      });
     }
     const methodAndPath = `${endpoint3.method} ${stringifyEndpointPathParts3(endpoint3)}`;
     const existing = methodAndPathToEndpointNode.get(methodAndPath);
@@ -787407,7 +787907,9 @@ ${tagInfo.description}`;
   getFileId(filepath) {
     const fileId = this.collectedFileIds.get(filepath);
     if (fileId == null) {
-      return this.taskContext.failAndThrow("Failed to locate file after uploading: " + filepath);
+      return this.taskContext.failAndThrow("Failed to locate file after uploading: " + filepath, void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     return fileId;
   }
@@ -787449,7 +787951,10 @@ var NodeIdGenerator2 = class _NodeIdGenerator {
       hashedId = this.#getHashedId(id);
       loop++;
       if (loop > 100) {
-        throw new Error(`Infinite loop detected for id: ${id}`);
+        throw new CliError({
+          message: `Infinite loop detected for id: ${id}`,
+          code: CliError.Code.ReferenceError
+        });
       }
     }
     return hashedId;
@@ -788205,7 +788710,10 @@ var LambdaExampleEnhancer = class {
     this.context = context3;
     const lambdaOrigin = "https://ykq45y6fvnszd35iv5yuuatkze0rpwuz.lambda-url.us-east-1.on.aws";
     if (!lambdaOrigin) {
-      throw new Error("DEFAULT_FDR_LAMBDA_DOCS_ORIGIN environment variable is not set. AI example enhancement requires this to be configured.");
+      throw new CliError({
+        message: "DEFAULT_FDR_LAMBDA_DOCS_ORIGIN environment variable is not set. AI example enhancement requires this to be configured.",
+        code: CliError.Code.EnvironmentError
+      });
     }
     this.lambdaOrigin = lambdaOrigin;
     this.venusOrigin = "https://venus-dev2.buildwithfern.com";
@@ -788274,7 +788782,10 @@ var LambdaExampleEnhancer = class {
     });
     if (!response.ok) {
       const errorText = await response.text();
-      throw new Error(`Failed to fetch JWT from Venus: ${response.status} ${errorText || response.statusText}`);
+      throw new CliError({
+        message: `Failed to fetch JWT from Venus: ${response.status} ${errorText || response.statusText}`,
+        code: CliError.Code.NetworkError
+      });
     }
     const result = await response.json();
     this.context.logger.debug(`Successfully obtained JWT from Venus (expires at ${result.expiresAt})`);
@@ -788336,7 +788847,10 @@ var LambdaExampleEnhancer = class {
         });
         if (!response.ok) {
           const errorText = await response.text();
-          throw new Error(`Lambda returned ${response.status}: ${errorText || response.statusText}`);
+          throw new CliError({
+            message: `Lambda returned ${response.status}: ${errorText || response.statusText}`,
+            code: CliError.Code.NetworkError
+          });
         }
         const result = await response.json();
         return {
@@ -789849,7 +790363,10 @@ function convertTypeShape(irType) {
                 extraProperties: void 0
               }),
               _other: () => {
-                throw new Error("Unknown SingleUnionTypeProperties: " + variant.shape.propertiesType);
+                throw new CliError({
+                  message: "Unknown SingleUnionTypeProperties: " + variant.shape.propertiesType,
+                  code: CliError.Code.InternalError
+                });
               }
             })
           };
@@ -789874,7 +790391,7 @@ function convertTypeShape(irType) {
       };
     },
     _other: () => {
-      throw new Error("Unknown Type shape: " + irType.type);
+      throw new CliError({ message: "Unknown Type shape: " + irType.type, code: CliError.Code.InternalError });
     }
   });
 }
@@ -789941,12 +790458,18 @@ function convertTypeReference3(irTypeReference) {
               };
             },
             _other: () => {
-              throw new Error("Unknown literal type: " + literal3.type);
+              throw new CliError({
+                message: "Unknown literal type: " + literal3.type,
+                code: CliError.Code.InternalError
+              });
             }
           });
         },
         _other: () => {
-          throw new Error("Unknown container reference: " + container.type);
+          throw new CliError({
+            message: "Unknown container reference: " + container.type,
+            code: CliError.Code.InternalError
+          });
         }
       });
     },
@@ -790026,7 +790549,10 @@ function convertTypeReference3(irTypeReference) {
             };
           },
           _other: () => {
-            throw new Error("Unknown primitive: " + primitive.v1);
+            throw new CliError({
+              message: "Unknown primitive: " + primitive.v1,
+              code: CliError.Code.InternalError
+            });
           }
         })
       };
@@ -790037,7 +790563,10 @@ function convertTypeReference3(irTypeReference) {
       };
     },
     _other: () => {
-      throw new Error("Unknown Type reference: " + irTypeReference.type);
+      throw new CliError({
+        message: "Unknown Type reference: " + irTypeReference.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
 }
@@ -790501,7 +791030,10 @@ function convertIrEnvironments({ environmentsConfig, endpoint: endpoint3 }) {
           return environmentsConfigValue.environments.map((singleBaseUrlEnvironment) => {
             const endpointBaseUrl = singleBaseUrlEnvironment.urls[baseUrlId];
             if (endpointBaseUrl == null) {
-              throw new Error(`Encountered undefined server name "${baseUrlId}" at endpoint ${endpoint3.method.toUpperCase()} ${endpoint3.path}. Expected environment ${singleBaseUrlEnvironment.id} to contain url for ${baseUrlId}`);
+              throw new CliError({
+                message: `Encountered undefined server name "${baseUrlId}" at endpoint ${endpoint3.method.toUpperCase()} ${endpoint3.path}. Expected environment ${singleBaseUrlEnvironment.id} to contain url for ${baseUrlId}`,
+                code: CliError.Code.IrConversionError
+              });
             }
             return {
               id: FdrAPI_exports.EnvironmentId(baseUrlId),
@@ -790513,12 +791045,18 @@ function convertIrEnvironments({ environmentsConfig, endpoint: endpoint3 }) {
         return environments2.filter((environment2, index3, self2) => index3 === self2.findIndex((t3) => t3.id === environment2.id && t3.baseUrl === environment2.baseUrl));
       }
       if (endpointBaseUrlId == null) {
-        throw new Error(`Expected endpoint ${getOriginalName(endpoint3.name)} to have base url.`);
+        throw new CliError({
+          message: `Expected endpoint ${getOriginalName(endpoint3.name)} to have base url.`,
+          code: CliError.Code.IrConversionError
+        });
       }
       return environmentsConfigValue.environments.map((singleBaseUrlEnvironment) => {
         const endpointBaseUrl = singleBaseUrlEnvironment.urls[endpointBaseUrlId];
         if (endpointBaseUrl == null) {
-          throw new Error(`Encountered undefined server name "${endpointBaseUrlId}" at endpoint ${endpoint3.method.toUpperCase()} ${endpoint3.path.head}. Expected environment ${singleBaseUrlEnvironment.id} to contain url for ${endpointBaseUrlId}`);
+          throw new CliError({
+            message: `Encountered undefined server name "${endpointBaseUrlId}" at endpoint ${endpoint3.method.toUpperCase()} ${endpoint3.path.head}. Expected environment ${singleBaseUrlEnvironment.id} to contain url for ${endpointBaseUrlId}`,
+            code: CliError.Code.IrConversionError
+          });
         }
         return {
           id: FdrAPI_exports.EnvironmentId(singleBaseUrlEnvironment.id),
@@ -790544,12 +791082,18 @@ function convertIrWebSocketEnvironments({ environmentsConfig, channel: channel3
       });
     case "multipleBaseUrls":
       if (channelBaseUrlId == null) {
-        throw new Error(`Expected channel ${getOriginalName(channel3.name)} to have base url.`);
+        throw new CliError({
+          message: `Expected channel ${getOriginalName(channel3.name)} to have base url.`,
+          code: CliError.Code.IrConversionError
+        });
       }
       return environmentsConfigValue.environments.map((singleBaseUrlEnvironment) => {
         const channelBaseUrl = singleBaseUrlEnvironment.urls[channelBaseUrlId];
         if (channelBaseUrl == null) {
-          throw new Error(`Encountered undefined server name ${channelBaseUrl} at channel ${getOriginalName(channel3.name)} ${channel3.path.head}. Expected environment ${singleBaseUrlEnvironment.id} to contain url for ${channelBaseUrlId}`);
+          throw new CliError({
+            message: `Encountered undefined server name ${channelBaseUrl} at channel ${getOriginalName(channel3.name)} ${channel3.path.head}. Expected environment ${singleBaseUrlEnvironment.id} to contain url for ${channelBaseUrlId}`,
+            code: CliError.Code.IrConversionError
+          });
         }
         return {
           id: FdrAPI_exports.EnvironmentId(singleBaseUrlEnvironment.id),
@@ -790573,7 +791117,7 @@ function convertHttpMethod2(method8) {
     delete: () => FdrAPI_exports.HttpMethod.Delete,
     head: () => FdrAPI_exports.HttpMethod.Head,
     _other: () => {
-      throw new Error("Unknown http method: " + method8);
+      throw new CliError({ message: "Unknown http method: " + method8, code: CliError.Code.InternalError });
     }
   });
 }
@@ -790689,7 +791233,10 @@ function convertRequestBody3(irRequest) {
       contentType: bytes.contentType
     }),
     _other: () => {
-      throw new Error("Unknown HttpRequestBody: " + irRequest.type);
+      throw new CliError({
+        message: "Unknown HttpRequestBody: " + irRequest.type,
+        code: CliError.Code.InternalError
+      });
     }
   });
   return requestBodyShape != null ? { type: requestBodyShape, description: irRequest.docs } : void 0;
@@ -790743,7 +791290,10 @@ function convertResponse2(irResponse) {
         return void 0;
       },
       _other: () => {
-        throw new Error("Unknown HttpResponse: " + irResponse.body);
+        throw new CliError({
+          message: "Unknown HttpResponse: " + irResponse.body,
+          code: CliError.Code.InternalError
+        });
       }
     });
   }
@@ -790983,7 +791533,10 @@ function convertV2HttpEndpointExample({ shouldUseExampleName, exampleName, examp
         return void 0;
       },
       _other: () => {
-        throw new Error("Unknown ExampleResponseBody: " + example.response?.body?.type);
+        throw new CliError({
+          message: "Unknown ExampleResponseBody: " + example.response?.body?.type,
+          code: CliError.Code.InternalError
+        });
       }
     }) : void 0,
     codeSamples: example.codeSamples?.map((codeSample) => ({
@@ -791109,18 +791662,27 @@ function convertHttpEndpointExample({ userSpecifiedExample, autogeneratedExample
         stream: (stream5) => stream5.length > 0 ? 200 : 204,
         sse: (stream5) => stream5.length > 0 ? 200 : 204,
         _other: () => {
-          throw new Error("Unknown ExampleResponseBody: " + ok3.type);
+          throw new CliError({
+            message: "Unknown ExampleResponseBody: " + ok3.type,
+            code: CliError.Code.InternalError
+          });
         }
       }),
       error: ({ error: errorName }) => {
         const error50 = ir10.errors[errorName.errorId];
         if (error50 == null) {
-          throw new Error("Cannot find error " + errorName.errorId);
+          throw new CliError({
+            message: "Cannot find error " + errorName.errorId,
+            code: CliError.Code.ResolutionError
+          });
         }
         return error50.statusCode;
       },
       _other: () => {
-        throw new Error("Unknown ExampleResponse: " + example.response.type);
+        throw new CliError({
+          message: "Unknown ExampleResponse: " + example.response.type,
+          code: CliError.Code.InternalError
+        });
       }
     }),
     responseBody: example.response._visit({
@@ -791142,12 +791704,18 @@ function convertHttpEndpointExample({ userSpecifiedExample, autogeneratedExample
           value: sse.map(({ event, data: data2 }) => ({ event, data: data2.jsonExample }))
         }),
         _other: () => {
-          throw new Error("Unknown ExampleResponseBody: " + ok3.type);
+          throw new CliError({
+            message: "Unknown ExampleResponseBody: " + ok3.type,
+            code: CliError.Code.InternalError
+          });
         }
       }),
       error: (error50) => error50.body != null ? { type: "json", value: error50.body.jsonExample } : void 0,
       _other: () => {
-        throw new Error("Unknown ExampleResponse: " + example.response.type);
+        throw new CliError({
+          message: "Unknown ExampleResponse: " + example.response.type,
+          code: CliError.Code.InternalError
+        });
       }
     }),
     // irExample.response.body != null ? { type: "json", value: irExample.response.body.jsonExample } : undefined,
@@ -791440,7 +792008,9 @@ async function registerApi({ organization, workspace, context: context3, token,
     context3.logger.debug(`Registered API Definition ${response.apiDefinitionId}`);
     return { id: response.apiDefinitionId, ir: ir10 };
   } catch (error50) {
-    return context3.failAndThrow("Failed to register API", error50);
+    return context3.failAndThrow("Failed to register API", error50, {
+      code: CliError.Code.NetworkError
+    });
   }
 }
 
@@ -791994,7 +792564,7 @@ var DocsDefinitionResolver = class {
   _parsedDocsConfig;
   get parsedDocsConfig() {
     if (this._parsedDocsConfig == null) {
-      throw new Error("parsedDocsConfig is not set");
+      throw new CliError({ message: "parsedDocsConfig is not set", code: CliError.Code.InternalError });
     }
     return this._parsedDocsConfig;
   }
@@ -792490,7 +793060,7 @@ var DocsDefinitionResolver = class {
 A valid API configuration was not found at the path: fern/apis/${apiSection.apiName}.
 Learn more about project structure:
 https://buildwithfern.com/learn/docs/getting-started/project-structure#api-definitions` : "Failed to load API Definition referenced in docs.\nLearn more about project structure:\nhttps://buildwithfern.com/learn/docs/getting-started/project-structure#api-definitions";
-    throw new Error(errorMessage);
+    throw new CliError({ message: errorMessage, code: CliError.Code.ConfigError });
   }
   getOpenApiWorkspaceForApiSection(apiSection) {
     if (apiSection.apiName != null) {
@@ -792505,7 +793075,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
 A valid API configuration was not found at the path: fern/apis/${apiSection.apiName}.
 Learn more about project structure:
 https://buildwithfern.com/learn/docs/getting-started/project-structure#api-definitions` : "Failed to load API Definition referenced in docs.\nLearn more about project structure:\nhttps://buildwithfern.com/learn/docs/getting-started/project-structure#api-definitions";
-    throw new Error(errorMessage);
+    throw new CliError({ message: errorMessage, code: CliError.Code.ConfigError });
   }
   async toRootNode() {
     const slug = navigation_exports.V1.SlugGenerator.init(navigation_exports.slugjoin(this.getDocsBasePath()));
@@ -792582,7 +793152,10 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     const id = this.#idgen.get("versioned");
     const defaultVersion = versioned.versions[0];
     if (defaultVersion?.hidden === true) {
-      throw new Error(`The default version "${defaultVersion.version}" cannot be hidden. Please set a non-hidden version as the first version in your versions list, or remove the hidden flag from the default version.`);
+      throw new CliError({
+        message: `The default version "${defaultVersion.version}" cannot be hidden. Please set a non-hidden version as the first version in your versions list, or remove the hidden flag from the default version.`,
+        code: CliError.Code.ConfigError
+      });
     }
     const BATCH_SIZE2 = 5;
     const children2 = [];
@@ -792886,7 +793459,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     }
     if (this.docsWorkspace.config.settings?.substituteEnvVars) {
       ir10 = replaceEnvVariables(ir10, {
-        onError: (e5) => this.taskContext.failAndThrow(`Error substituting environment variables in API spec: ${e5}`)
+        onError: (e5) => this.taskContext.failAndThrow(`Error substituting environment variables in API spec: ${e5}`, void 0, { code: CliError.Code.EnvironmentError })
       }, { substituteAsEmpty: false });
     }
     let graphqlWorkspace = openapiWorkspace;
@@ -793298,7 +793871,9 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
     }
     const fileId = this.collectedFileIds.get(filepath);
     if (fileId == null) {
-      return this.taskContext.failAndThrow("Failed to locate file after uploading: " + filepath);
+      return this.taskContext.failAndThrow("Failed to locate file after uploading: " + filepath, void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     return DocsV1Write_exports.FileId(fileId);
   }
@@ -793455,7 +794030,9 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
         value: this.getFileId(value2)
       }),
       url: ({ value: value2 }) => ({ type: "url", value: DocsV1Write_exports.Url(value2) }),
-      _other: () => this.taskContext.failAndThrow("Invalid metadata configuration")
+      _other: () => this.taskContext.failAndThrow("Invalid metadata configuration", void 0, {
+        code: CliError.Code.ConfigError
+      })
     });
   }
   /**
@@ -826658,7 +827235,10 @@ function collectLinksAndSources({ readFile: readFile104 = (path99) => (0, import
   do {
     loopCount++;
     if (loopCount > LOOP_LIMIT) {
-      throw new Error("Infinite loop detected while collecting links and sources");
+      throw new CliError({
+        message: "Infinite loop detected while collecting links and sources",
+        code: CliError.Code.ReferenceError
+      });
     }
     const popped = contentQueue.shift();
     if (popped == null) {
@@ -826667,7 +827247,10 @@ function collectLinksAndSources({ readFile: readFile104 = (path99) => (0, import
     const { content: content5, absoluteFilepath } = popped;
     if (absoluteFilepath != null) {
       if (visitedAbsoluteFilepaths.has(absoluteFilepath)) {
-        throw new Error(`Circular import detected: ${absoluteFilepath}`);
+        throw new CliError({
+          message: `Circular import detected: ${absoluteFilepath}`,
+          code: CliError.Code.ReferenceError
+        });
       }
       visitedAbsoluteFilepaths.add(absoluteFilepath);
     }
@@ -826884,7 +827467,7 @@ var ValidMarkdownLinks = {
     const resolvedDocsDefinition = await docsDefinitionResolver.resolve();
     const configRoot = resolvedDocsDefinition.config.root;
     if (!configRoot || !isV1RootNode2(configRoot)) {
-      throw new Error("Root node not found");
+      throw new CliError({ message: "Root node not found", code: CliError.Code.InternalError });
     }
     const root6 = navigation_exports.migrate.FernNavigationV1ToLatest.create().root(configRoot);
     const collector = navigation_exports.NodeCollector.collect(root6);
@@ -827894,7 +828477,7 @@ var DocsWorkspaceValidator = class {
     const startTime = performance.now();
     if (workspace.config.settings?.substituteEnvVars) {
       workspace.config = replaceEnvVariables(workspace.config, {
-        onError: (error50) => this.taskContext.failAndThrow(error50)
+        onError: (error50) => this.taskContext.failAndThrow(error50, void 0, { code: CliError.Code.ConfigError })
       });
     }
     const violations = await validateDocsWorkspace(workspace, this.taskContext, apiWorkspaces, ossWorkspaces, false, excludeRules);
@@ -830034,7 +830617,10 @@ function buildPreviewDomain({ orgId, previewId }) {
   const availableSpace = SUBDOMAIN_LIMIT - prefix2.length;
   const minIdLength = 8;
   if (availableSpace < minIdLength) {
-    throw new Error(`Organization name "${orgId}" is too long to generate a valid preview URL`);
+    throw new CliError({
+      message: `Organization name "${orgId}" is too long to generate a valid preview URL`,
+      code: CliError.Code.ValidationError
+    });
   }
   const truncatedId = sanitizedId.slice(0, availableSpace).replace(/-+$/, "");
   return `${prefix2}${truncatedId}.${DOMAIN_SUFFIX}`;
@@ -831728,7 +832314,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 = "4.81.1";
+  const version7 = "4.82.0-3-gc1f31446d2e";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -832236,7 +832822,10 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
   try {
     const docsBundleZipResponse = await fetch(docsBundleUrl);
     if (!docsBundleZipResponse.ok) {
-      throw new Error(`Failed to download docs preview bundle. Status code: ${docsBundleZipResponse.status}`);
+      throw new CliError({
+        message: `Failed to download docs preview bundle. Status code: ${docsBundleZipResponse.status}`,
+        code: CliError.Code.NetworkError
+      });
     }
     const outputZipPath = join8(absoluteDirectoryToTmpDir, RelativeFilePath2.of(tryTar ? "output.tar.gz" : "output.zip"));
     if (docsBundleZipResponse.body == null) {
@@ -832377,7 +832966,10 @@ async function downloadBundle({ bucketUrl, logger: logger4, preferCached, app =
           doNotPipeOutput: true
         });
       } catch (error50) {
-        throw new Error("Requires [pnpm] to run local development. Please run: npm install -g pnpm, and then: fern docs dev");
+        throw new CliError({
+          message: "Requires [pnpm] to run local development. Please run: npm install -g pnpm, and then: fern docs dev",
+          code: CliError.Code.EnvironmentError
+        });
       }
       try {
         logger4.debug("Installing esbuild");
@@ -832676,7 +833268,7 @@ async function getPreviewDocsDefinition({ domain: domain3, project, context: con
   const docsWorkspace = project.docsWorkspaces;
   const apiWorkspaces = project.apiWorkspaces;
   if (docsWorkspace == null) {
-    throw new Error("No docs workspace found in project");
+    throw new CliError({ message: "No docs workspace found in project", code: CliError.Code.ConfigError });
   }
   if (editedAbsoluteFilepaths != null && previousDocsDefinition != null) {
     const allMarkdownFiles = editedAbsoluteFilepaths.every((filepath) => filepath.endsWith(".mdx") || filepath.endsWith(".md"));
@@ -833247,7 +833839,10 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
     try {
       const url3 = "https://dev2-local-preview-bundle4.s3.amazonaws.com/";
       if (url3 == null) {
-        throw new Error("Failed to connect to the docs preview server. Please contact support@buildwithfern.com");
+        throw new CliError({
+          message: "Failed to connect to the docs preview server. Please contact support@buildwithfern.com",
+          code: CliError.Code.InternalError
+        });
       }
       await downloadBundle({
         bucketUrl: url3,
@@ -833265,7 +833860,10 @@ async function runAppPreviewServer({ initialProject, reloadProject, validateProj
       try {
         const url3 = "https://dev2-local-preview-bundle3.s3.amazonaws.com/";
         if (url3 == null) {
-          throw new Error("Failed to connect to the docs preview server. Please contact support@buildwithfern.com");
+          throw new CliError({
+            message: "Failed to connect to the docs preview server. Please contact support@buildwithfern.com",
+            code: CliError.Code.InternalError
+          });
         }
         await downloadBundle({
           bucketUrl: url3,
@@ -833735,7 +834333,10 @@ async function runPreviewServer({ initialProject, reloadProject, validateProject
     try {
       const url3 = "https://dev2-local-preview-bundle2.s3.amazonaws.com/";
       if (url3 == null) {
-        throw new Error("Failed to connect to the docs preview server. Please contact support@buildwithfern.com");
+        throw new CliError({
+          message: "Failed to connect to the docs preview server. Please contact support@buildwithfern.com",
+          code: CliError.Code.InternalError
+        });
       }
       await downloadBundle({ bucketUrl: url3, logger: context3.logger, preferCached: true, tryTar: false });
     } catch (err) {
@@ -834417,7 +835018,16 @@ function createGeneratorsYmlAstVisitorForRules({ relativeFilepath, contents, all
 
 // ../yaml/generators-validator/lib/rules/compatible-ir-versions/compatible-ir-versions.js
 function getMaybeBadVersionMessage(generatorName, minCliVersion, cliVersion) {
-  if (!isVersionAhead(cliVersion, minCliVersion)) {
+  let isAhead;
+  try {
+    isAhead = isVersionAhead(cliVersion, minCliVersion);
+  } catch (error50) {
+    throw new CliError({
+      message: `Failed to compare versions: ${error50 instanceof Error ? error50.message : String(error50)}`,
+      code: CliError.Code.VersionError
+    });
+  }
+  if (!isAhead) {
     return [
       {
         severity: "fatal",
@@ -834552,7 +835162,7 @@ async function validateGeneratorsYmlFile({ contents, allRuleVisitors, cliVersion
 var import_validate_npm_package_name = __toESM(require_lib18(), 1);
 async function collectAPIWorkspaceViolations({ workspace, context: context3, ossWorkspace }) {
   if (!(0, import_validate_npm_package_name.default)(workspace.definition.rootApiFile.contents.name).validForNewPackages) {
-    context3.failAndThrow("API name is not valid.");
+    context3.failAndThrow("API name is not valid.", void 0, { code: CliError.Code.ValidationError });
   }
   const startTime = performance.now();
   const apiViolations = validateFernWorkspace(workspace, context3.logger);
@@ -834590,7 +835200,7 @@ async function validateAPIWorkspaceWithoutExiting({ workspace, context: context3
 }
 async function validateAPIWorkspaceAndLogIssues({ workspace, context: context3, logWarnings, ossWorkspace }) {
   if (!(0, import_validate_npm_package_name.default)(workspace.definition.rootApiFile.contents.name).validForNewPackages) {
-    context3.failAndThrow("API name is not valid.");
+    context3.failAndThrow("API name is not valid.", void 0, { code: CliError.Code.ValidationError });
   }
   const { hasErrors } = await validateAPIWorkspaceWithoutExiting({
     workspace,
@@ -834599,7 +835209,7 @@ async function validateAPIWorkspaceAndLogIssues({ workspace, context: context3,
     ossWorkspace
   });
   if (hasErrors) {
-    context3.failAndThrow();
+    context3.failAndThrow(void 0, void 0, { code: CliError.Code.ValidationError });
   }
 }
 
@@ -841028,11 +841638,17 @@ async function loadRawDocsConfiguration({ absolutePathOfConfiguration, context:
     } catch (err) {
       context3.logger.error(`Parsing failed even after sanitization: ${extractErrorMessage(err)}`);
       context3.logger.debug(`Sanitized JSON structure: ${JSON.stringify(sanitizedJson, null, 2)}`);
-      throw new Error(`Failed to parse ${absolutePathOfConfiguration}: ${extractErrorMessage(err)}`);
+      throw new CliError({
+        message: `Failed to parse ${absolutePathOfConfiguration}: ${extractErrorMessage(err)}`,
+        code: CliError.Code.ParseError
+      });
     }
   } else {
-    throw new Error(`Failed to parse docs.yml:
-${result.error?.message ?? "Unknown error"}`);
+    throw new CliError({
+      message: `Failed to parse docs.yml:
+${result.error?.message ?? "Unknown error"}`,
+      code: CliError.Code.ParseError
+    });
   }
 }
 
@@ -841126,7 +841742,10 @@ async function retryWithRateLimit({ fn: fn10, retryRateLimited, logger: logger4,
       }
     }
   }
-  throw new Error("Exceeded maximum retries for 429 Too Many Requests.");
+  throw new CliError({
+    message: "Exceeded maximum retries for 429 Too Many Requests.",
+    code: CliError.Code.InternalError
+  });
 }
 
 // ../generation/remote-generation/remote-workspace-runner/lib/createAndStartJob.js
@@ -841139,7 +841758,9 @@ async function createAndStartJob({ projectConfig, workspace, organization, inter
     try {
       fernignoreContents = await (0, import_promises86.readFile)(fernignorePath, "utf-8");
     } catch (error50) {
-      context3.failAndThrow(`Failed to read fernignore file at ${fernignorePath}: ${error50}`);
+      context3.failAndThrow(`Failed to read fernignore file at ${fernignorePath}: ${error50}`, void 0, {
+        code: CliError.Code.ConfigError
+      });
     }
   }
   const job = await retryWithRateLimit({
@@ -841162,7 +841783,7 @@ async function createAndStartJob({ projectConfig, workspace, organization, inter
     }),
     retryRateLimited,
     logger: context3.logger,
-    onRateLimitedWithoutRetry: () => context3.failAndThrow("Received 429 Too Many Requests. Re-run with --retry-rate-limited to automatically retry.")
+    onRateLimitedWithoutRetry: () => context3.failAndThrow("Received 429 Too Many Requests. Re-run with --retry-rate-limited to automatically retry.", void 0, { code: CliError.Code.NetworkError })
   });
   await startJob({ intermediateRepresentation, job, context: context3, generatorInvocation, irVersionOverride });
   return job;
@@ -841212,33 +841833,35 @@ async function createJob({ projectConfig, workspace, organization, generatorInvo
     }
     return convertCreateJobError(rawError)._visit({
       illegalApiNameError: () => {
-        return context3.failAndThrow("API name is invalid: " + workspace.definition.rootApiFile.contents.name);
+        return context3.failAndThrow("API name is invalid: " + workspace.definition.rootApiFile.contents.name, void 0, { code: CliError.Code.ConfigError });
       },
       illegalApiVersionError: () => {
-        return context3.failAndThrow("API version is invalid: " + version7);
+        return context3.failAndThrow("API version is invalid: " + version7, void 0, {
+          code: CliError.Code.ConfigError
+        });
       },
       cannotPublishToNpmScope: ({ validScope, invalidScope }) => {
-        return context3.failAndThrow(`You do not have permission to publish to ${invalidScope} (expected ${validScope})`);
+        return context3.failAndThrow(`You do not have permission to publish to ${invalidScope} (expected ${validScope})`, void 0, { code: CliError.Code.AuthError });
       },
       cannotPublishToMavenGroup: ({ validGroup, invalidGroup }) => {
-        return context3.failAndThrow(`You do not have permission to publish to ${invalidGroup} (expected ${validGroup})`);
+        return context3.failAndThrow(`You do not have permission to publish to ${invalidGroup} (expected ${validGroup})`, void 0, { code: CliError.Code.AuthError });
       },
       cannotPublishPypiPackage: ({ validPrefix, invalidPackageName }) => {
-        return context3.failAndThrow(`You do not have permission to publish to ${invalidPackageName} (expected ${validPrefix})`);
+        return context3.failAndThrow(`You do not have permission to publish to ${invalidPackageName} (expected ${validPrefix})`, void 0, { code: CliError.Code.AuthError });
       },
       generatorsDoNotExistError: (value2) => {
-        return context3.failAndThrow("Generators do not exist: " + value2.nonExistentGenerators.map((generator) => `${generator.id}@${generator.version}`).join(", "));
+        return context3.failAndThrow("Generators do not exist: " + value2.nonExistentGenerators.map((generator) => `${generator.id}@${generator.version}`).join(", "), void 0, { code: CliError.Code.ConfigError });
       },
       insufficientPermissions: () => {
         return context3.failAndThrow(`You do not have permission to run this generator for organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.
 
-Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`);
+Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`, void 0, { code: CliError.Code.AuthError });
       },
       orgNotConfiguredForWhitelabel: () => {
-        return context3.failAndThrow("Your org is not configured for white-labeling. Please reach out to support@buildwithfern.com.");
+        return context3.failAndThrow("Your org is not configured for white-labeling. Please reach out to support@buildwithfern.com.", void 0, { code: CliError.Code.AuthError });
       },
       branchDoesNotExist: (value2) => {
-        return context3.failAndThrow(`Branch ${value2.branch} does not exist in repository ${value2.repositoryOwner}/${value2.repositoryName}`);
+        return context3.failAndThrow(`Branch ${value2.branch} does not exist in repository ${value2.repositoryOwner}/${value2.repositoryName}`, void 0, { code: CliError.Code.ConfigError });
       },
       rateLimitExceeded: () => {
         throw new TooManyRequestsError();
@@ -841247,9 +841870,9 @@ Please ensure you have membership at https://dashboard.buildwithfern.com, and as
         context3.logger.debug(`Failed to create job: ${JSON.stringify(content5)}`);
         const errorMessage = extractErrorMessage2(content5);
         if (errorMessage != null) {
-          return context3.failAndThrow(errorMessage);
+          return context3.failAndThrow(errorMessage, void 0, { code: CliError.Code.NetworkError });
         }
-        return context3.failAndThrow("Failed to create job. Please try again or contact support@buildwithfern.com for assistance.");
+        return context3.failAndThrow("Failed to create job. Please try again or contact support@buildwithfern.com for assistance.", void 0, { code: CliError.Code.NetworkError });
       }
     });
   }
@@ -841294,7 +841917,7 @@ async function startJob({ intermediateRepresentation, generatorInvocation, job,
   } catch (error50) {
     const errorBody = error50 instanceof AxiosError2 ? error50.response?.data : error50;
     context3.logger.debug(`POST ${url3} failed with ${JSON.stringify(error50)}`);
-    context3.failAndThrow("Failed to start job", errorBody);
+    context3.failAndThrow("Failed to start job", errorBody, { code: CliError.Code.NetworkError });
   }
 }
 function extractErrorMessage2(error50) {
@@ -841361,7 +841984,9 @@ function pollJobAndReportStatus({ job, taskId, taskHandler, context: context3 })
         if (taskStatus == null) {
           numConsecutiveFailed++;
           if (numConsecutiveFailed === MAX_UNSUCCESSFUL_ATTEMPTS) {
-            context3.failAndThrow(`Failed to get job status after ${numConsecutiveFailed} attempts.`);
+            context3.failAndThrow(`Failed to get job status after ${numConsecutiveFailed} attempts.`, void 0, {
+              code: CliError.Code.NetworkError
+            });
           }
           setTimeout(pollForStatus, 2e3 + 1e3 * numConsecutiveFailed);
         } else {
@@ -841418,7 +842043,9 @@ var RemoteTaskHandler = class {
   }
   async processUpdate(remoteTask2) {
     if (remoteTask2 == null) {
-      this.context.failAndThrow("Task is missing on job status");
+      this.context.failAndThrow("Task is missing on job status", void 0, {
+        code: CliError.Code.InternalError
+      });
     }
     const coordinates = remoteTask2.packages.map((p9) => {
       return p9.coordinate._visit({
@@ -841469,7 +842096,7 @@ var RemoteTaskHandler = class {
         if (s3PreSignedReadUrl != null) {
           logS3Url(s3PreSignedReadUrl);
         }
-        this.context.failAndThrow(message);
+        this.context.failAndThrow(message, void 0, { code: CliError.Code.ContainerError });
       },
       finished: async (finishedStatus) => {
         if (finishedStatus.s3PreSignedReadUrlV2 != null) {
@@ -841546,7 +842173,7 @@ async function downloadFilesForTask({ s3PreSignedReadUrl, absolutePathToLocalOut
     }
     context3.logger.info(source_default.green(`Downloaded to ${absolutePathToLocalOutput}`));
   } catch (e5) {
-    context3.failAndThrow("Failed to download files", e5);
+    context3.failAndThrow("Failed to download files", e5, { code: CliError.Code.NetworkError });
   }
 }
 async function downloadZipForTask({ s3PreSignedReadUrl, absolutePathToLocalOutput }) {
@@ -841723,7 +842350,7 @@ var SourceUploader = class {
     });
     await uploadCommand.cleanup();
     if (!response.ok) {
-      this.context.failAndThrow(`Failed to upload source file: ${source2.absoluteFilePath}. Status: ${response.status}, ${response.statusText}`);
+      this.context.failAndThrow(`Failed to upload source file: ${source2.absoluteFilePath}. Status: ${response.status}, ${response.statusText}`, void 0, { code: CliError.Code.NetworkError });
     }
   }
   async getUploadCommand(source2) {
@@ -841778,7 +842405,7 @@ var SourceUploader = class {
   getSourceOrThrow(id) {
     const source2 = this.sources[id];
     if (source2 == null) {
-      this.context.failAndThrow(`Internal error; server responded with source id "${id}" which does not exist in the workspace.`);
+      this.context.failAndThrow(`Internal error; server responded with source id "${id}" which does not exist in the workspace.`, void 0, { code: CliError.Code.InternalError });
     }
     return source2;
   }
@@ -841794,7 +842421,9 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
   const substituteEnvVars = (stringOrObject) => replaceEnvVariables(stringOrObject, {
     onError: (e5) => {
       if (!isPreview && requireEnvVars) {
-        interactiveTaskContext.failAndThrow(e5);
+        interactiveTaskContext.failAndThrow(void 0, e5, {
+          code: CliError.Code.EnvironmentError
+        });
       }
     }
   }, { substituteAsEmpty: isPreview });
@@ -841894,7 +842523,9 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
   }
   const sourceUploader = new SourceUploader(interactiveTaskContext, sources);
   if (sourceUploads == null && sourceUploader.sourceTypes.has("protobuf")) {
-    interactiveTaskContext.failAndThrow("Did not successfully upload Protobuf source files.");
+    interactiveTaskContext.failAndThrow("Did not successfully upload Protobuf source files.", void 0, {
+      code: CliError.Code.NetworkError
+    });
   }
   if (sourceUploads != null) {
     interactiveTaskContext.logger.debug("Uploading source files ...");
@@ -841905,15 +842536,21 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
   if (dynamicIrOnly) {
     interactiveTaskContext.logger.info("Dynamic IR only mode: skipping SDK generation and uploading dynamic IR only");
     if (version7 == null) {
-      interactiveTaskContext.failAndThrow("Version is required for dynamic IR only mode");
+      interactiveTaskContext.failAndThrow("Version is required for dynamic IR only mode", void 0, {
+        code: CliError.Code.ConfigError
+      });
       return void 0;
     }
     if (generatorInvocation.language == null) {
-      interactiveTaskContext.failAndThrow("Language is required for dynamic IR only mode");
+      interactiveTaskContext.failAndThrow("Language is required for dynamic IR only mode", void 0, {
+        code: CliError.Code.ConfigError
+      });
       return void 0;
     }
     if (packageName == null) {
-      interactiveTaskContext.failAndThrow("Package name is required for dynamic IR only mode");
+      interactiveTaskContext.failAndThrow("Package name is required for dynamic IR only mode", void 0, {
+        code: CliError.Code.ConfigError
+      });
       return void 0;
     }
     try {
@@ -841929,7 +842566,7 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
         context: interactiveTaskContext
       });
     } catch (error50) {
-      interactiveTaskContext.failAndThrow(`Failed to upload dynamic IR: ${extractErrorMessage(error50)}`);
+      interactiveTaskContext.failAndThrow(`Failed to upload dynamic IR: ${extractErrorMessage(error50)}`, void 0, { code: CliError.Code.NetworkError });
     }
     return {
       createdSnippets: false,
@@ -841965,7 +842602,9 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
   interactiveTaskContext.logger.debug(`Job ID: ${job.jobId}`);
   const taskId = job.taskIds[0];
   if (taskId == null) {
-    interactiveTaskContext.failAndThrow("Did not receive a task ID.");
+    interactiveTaskContext.failAndThrow("Did not receive a task ID.", void 0, {
+      code: CliError.Code.NetworkError
+    });
     return void 0;
   }
   interactiveTaskContext.logger.debug(`Task ID: ${taskId}`);
@@ -842131,7 +842770,7 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
     onSnippetsProduced: (invocation) => snippetsProducedBy.push(invocation)
   }))));
   if (automation == null && results.some((didSucceed) => !didSucceed)) {
-    context3.failAndThrow();
+    throw new TaskAbortSignal();
   }
   return {
     snippetsProducedBy
@@ -842570,9 +843209,9 @@ async function publishDocs({ token, organization, docsWorkspace, domain: domain3
           context3.logger.error(`FDR registerApiDefinition failed. Error details:
 ${JSON.stringify(errorDetails, void 0, 2)}`);
           if (apiName != null) {
-            return context3.failAndThrow(`Failed to publish docs because API definition (${apiName}) could not be uploaded. Please contact support@buildwithfern.com`, errorDetails);
+            return context3.failAndThrow(`Failed to publish docs because API definition (${apiName}) could not be uploaded. Please contact support@buildwithfern.com`, errorDetails, { code: CliError.Code.NetworkError });
           } else {
-            return context3.failAndThrow(`Failed to publish docs because API definition could not be uploaded. Please contact support@buildwithfern.com`, errorDetails);
+            return context3.failAndThrow(`Failed to publish docs because API definition could not be uploaded. Please contact support@buildwithfern.com`, errorDetails, { code: CliError.Code.NetworkError });
           }
         }
         context3.logger.debug(`Registered API Definition ${apiName}: ${response.apiDefinitionId}`);
@@ -842599,7 +843238,7 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
     if (docsWorkspace.config.settings?.substituteEnvVars) {
       context3.logger.debug("Applying environment variable substitution to docs definition...");
       const { jsFiles, ...docsWithoutJsFiles } = docsDefinition;
-      const substitutedDocs = replaceEnvVariables(docsWithoutJsFiles, { onError: (e5) => context3.failAndThrow(e5) }, { substituteAsEmpty: false });
+      const substitutedDocs = replaceEnvVariables(docsWithoutJsFiles, { onError: (e5) => context3.failAndThrow(void 0, e5, { code: CliError.Code.EnvironmentError }) }, { substituteAsEmpty: false });
       docsDefinition = { ...substitutedDocs, jsFiles };
     }
     const pageCount = Object.keys(docsDefinition.pages).length;
@@ -842609,7 +843248,9 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
     context3.logger.debug(`Memory after resolve: RSS=${(resolveMemory.rss / 1024 / 1024).toFixed(2)}MB, Heap=${(resolveMemory.heapUsed / 1024 / 1024).toFixed(2)}MB`);
     if (docsRegistrationId == null) {
       doUnlock();
-      return context3.failAndThrow("Failed to publish docs.", "Docs registration ID is missing.");
+      return context3.failAndThrow("Failed to publish docs.", "Docs registration ID is missing.", {
+        code: CliError.Code.InternalError
+      });
     }
     context3.logger.info("Publishing docs to FDR...");
     const publishStart = performance.now();
@@ -842621,7 +843262,9 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
         ...isBasepathAware && !preview && { basepathAware: true }
       });
     } catch (error50) {
-      return context3.failAndThrow("Failed to publish docs to " + domain3, error50);
+      return context3.failAndThrow("Failed to publish docs to " + domain3, error50, {
+        code: CliError.Code.NetworkError
+      });
     }
     const publishTime = performance.now() - publishStart;
     context3.logger.debug(`Docs published to FDR in ${publishTime.toFixed(0)}ms`);
@@ -842681,7 +843324,9 @@ async function uploadFiles(filesToUpload, docsWorkspacePath, context3, batchSize
           }
         });
       } catch (e5) {
-        context3.failAndThrow(`Failed to upload ${absoluteFilePath}`, e5);
+        context3.failAndThrow(`Failed to upload ${absoluteFilePath}`, e5, {
+          code: CliError.Code.NetworkError
+        });
       }
     }));
     const endTime2 = Date.now();
@@ -842721,24 +843366,26 @@ ${JSON.stringify(errorDetails, void 0, 2)}`);
   }
   const authErrorMessage = getAuthenticationErrorMessage(error50, organization, domain3);
   if (authErrorMessage != null) {
-    return context3.failAndThrow(authErrorMessage);
+    return context3.failAndThrow(authErrorMessage, void 0, { code: CliError.Code.AuthError });
   }
   const errorType = errorObj?.error;
   switch (errorType) {
     case "InvalidCustomDomainError":
-      return context3.failAndThrow(`Your docs domain should end with ${"docs.dev.buildwithfern.com"}`);
+      return context3.failAndThrow(`Your docs domain should end with ${"docs.dev.buildwithfern.com"}`, void 0, { code: CliError.Code.ConfigError });
     case "InvalidDomainError":
-      return context3.failAndThrow("Please make sure that none of your custom domains are not overlapping (i.e. one is a substring of another)");
+      return context3.failAndThrow("Please make sure that none of your custom domains are not overlapping (i.e. one is a substring of another)", void 0, { code: CliError.Code.ConfigError });
     case "UnauthorizedError":
-      return context3.failAndThrow(buildAuthFailureMessage(domain3, organization, errorContent));
+      return context3.failAndThrow(buildAuthFailureMessage(domain3, organization, errorContent), void 0, {
+        code: CliError.Code.AuthError
+      });
     case "UserNotInOrgError":
       return context3.failAndThrow(`You do not belong to organization '${organization}'. Please run 'fern login' to ensure you are logged in with the correct account.
 
-Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`);
+Please ensure you have membership at https://dashboard.buildwithfern.com, and ask a team member for an invite if not.`, void 0, { code: CliError.Code.AuthError });
     case "UnavailableError":
-      return context3.failAndThrow("Failed to publish docs. Please try again later or reach out to Fern support at support@buildwithfern.com.");
+      return context3.failAndThrow("Failed to publish docs. Please try again later or reach out to Fern support at support@buildwithfern.com.", void 0, { code: CliError.Code.NetworkError });
     default:
-      return context3.failAndThrow("Failed to publish docs.", error50);
+      return context3.failAndThrow("Failed to publish docs.", error50, { code: CliError.Code.NetworkError });
   }
 }
 function getAuthenticationErrorMessage(error50, organization, domain3) {
@@ -843186,21 +843833,25 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
   docsWorkspace.config = replaceEnvVariables(
     docsWorkspace.config,
     // Wrap in a closure for correct binding of `this` downstream
-    { onError: (e5) => context3.failAndThrow(e5) },
+    { onError: (e5) => context3.failAndThrow(void 0, e5, { code: CliError.Code.EnvironmentError }) },
     { substituteAsEmpty: shouldSubstituteAsEmpty }
   );
   const instances2 = docsWorkspace.config.instances;
   if (instances2.length === 0) {
-    context3.failAndThrow("No instances specified in docs.yml! Cannot register docs.");
+    context3.failAndThrow("No instances specified in docs.yml! Cannot register docs.", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   if (instances2.length > 1 && instanceUrl == null) {
-    context3.failAndThrow(`More than one docs instances. Please specify one (e.g. --instance ${instances2[0]?.url})`);
+    context3.failAndThrow(`More than one docs instances. Please specify one (e.g. --instance ${instances2[0]?.url})`, void 0, { code: CliError.Code.ConfigError });
     return;
   }
   const maybeInstance = instances2.find((instance) => instance.url === instanceUrl) ?? instances2[0];
   if (maybeInstance == null) {
-    context3.failAndThrow(`No docs instance with url ${instanceUrl}. Failed to register.`);
+    context3.failAndThrow(`No docs instance with url ${instanceUrl}. Failed to register.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const customDomains = [];
@@ -843245,7 +843896,7 @@ async function runRemoteGenerationForDocsWorkspace({ organization, apiWorkspaces
       } catch (error50) {
         if (!(error50 instanceof DocsPublishConflictError) || attempt >= PUBLISH_CONFLICT_RETRY_DELAYS_MS.length) {
           if (error50 instanceof DocsPublishConflictError) {
-            return context3.failAndThrow("Another docs publish is currently in progress. Please try again once the other publish is complete.");
+            return context3.failAndThrow("Another docs publish is currently in progress. Please try again once the other publish is complete.", void 0, { code: CliError.Code.NetworkError });
           }
           throw error50;
         }
@@ -843295,7 +843946,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.81.1"
+        cliVersion: "4.82.0-3-gc1f31446d2e"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -843770,7 +844421,10 @@ var DocsTask = class {
   getTask() {
     const task = this.taskGroup.getTask(this.id);
     if (task == null) {
-      throw new Error(`Internal error; task '${this.id}' does not exist`);
+      throw new CliError({
+        message: `Internal error; task '${this.id}' does not exist`,
+        code: CliError.Code.InternalError
+      });
     }
     return task;
   }
@@ -845042,7 +845696,10 @@ var Wizard = class {
   async fetchApiFromUrl(url3, specFormat) {
     const response = await fetch(url3, { signal: AbortSignal.timeout(FETCH_API_SPEC_REQUEST_TIMEOUT_MS) });
     if (!response.ok) {
-      throw new Error(`HTTP ${response.status} ${response.statusText}`);
+      throw new CliError({
+        message: `HTTP ${response.status} ${response.statusText}`,
+        code: CliError.Code.NetworkError
+      });
     }
     const content5 = await response.text();
     const filename = this.resolveFilenameFromUrl({ url: url3, specFormat });
@@ -846572,20 +847229,29 @@ var ApiSpecDetector = class {
   async detect({ absoluteFilePath, reference: reference4, content: content5 }) {
     const parsed = this.parseOrThrow({ content: content5, reference: reference4 });
     if (typeof parsed !== "object" || parsed == null) {
-      throw new Error(`Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`);
+      throw new CliError({
+        message: `Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`,
+        code: CliError.Code.InternalError
+      });
     }
     for (const specType of DETECTABLE_SPEC_TYPES) {
       if (specType in parsed) {
         return specType;
       }
     }
-    throw new Error(`Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`);
+    throw new CliError({
+      message: `Could not determine API type for "${reference4}". File must contain a top-level "openapi" or "asyncapi" key.`,
+      code: CliError.Code.InternalError
+    });
   }
   parseOrThrow({ content: content5, reference: reference4 }) {
     try {
       return jsYaml.load(content5);
     } catch {
-      throw new Error(`Could not parse "${reference4}" as YAML or JSON. Ensure the file is a valid OpenAPI or AsyncAPI specification.`);
+      throw new CliError({
+        message: `Could not parse "${reference4}" as YAML or JSON. Ensure the file is a valid OpenAPI or AsyncAPI specification.`,
+        code: CliError.Code.ParseError
+      });
     }
   }
 };
@@ -846623,7 +847289,10 @@ var ApiSpecResolver = class {
   async resolveLocal({ reference: reference4 }) {
     const absoluteFilePath = resolve6(this.context.cwd, reference4);
     if (!await doesPathExist(absoluteFilePath)) {
-      throw new Error(`API spec file does not exist: ${reference4}`);
+      throw new CliError({
+        message: `API spec file does not exist: ${reference4}`,
+        code: CliError.Code.ConfigError
+      });
     }
     const content5 = await (0, import_promises92.readFile)(absoluteFilePath, "utf-8");
     const specType = await this.detector.detect({ absoluteFilePath, content: content5, reference: reference4 });
@@ -846636,11 +847305,17 @@ var ApiSpecResolver = class {
   async fetchContent({ url: url3 }) {
     const response = await fetch(url3, { signal: AbortSignal.timeout(FETCH_API_SPEC_REQUEST_TIMEOUT_MS) });
     if (!response.ok) {
-      throw new Error(`Failed to fetch "${url3}": HTTP ${response.status} ${response.statusText}`);
+      throw new CliError({
+        message: `Failed to fetch "${url3}": HTTP ${response.status} ${response.statusText}`,
+        code: CliError.Code.NetworkError
+      });
     }
     const contentType = response.headers.get("content-type") ?? "";
     if (contentType.includes("text/html")) {
-      throw new Error(`The URL "${url3}" returned HTML content. Ensure you're pointing to a raw spec URL, not a documentation page.`);
+      throw new CliError({
+        message: `The URL "${url3}" returned HTML content. Ensure you're pointing to a raw spec URL, not a documentation page.`,
+        code: CliError.Code.ConfigError
+      });
     }
     const content5 = await response.text();
     return { content: content5, contentType };
@@ -846665,7 +847340,10 @@ var ApiSpecResolver = class {
       case "asyncapi":
         return { asyncapi: absoluteFilePath, origin: origin2 };
       default:
-        throw new Error(`Unsupported spec type for flags mode: "${specType}". Supported: openapi, asyncapi`);
+        throw new CliError({
+          message: `Unsupported spec type for flags mode: "${specType}". Supported: openapi, asyncapi`,
+          code: CliError.Code.ConfigError
+        });
     }
   }
   isUrl(reference4) {
@@ -847669,10 +848347,12 @@ var ContainerExecutionEnvironment = class {
   containerImage;
   keepContainer;
   runner;
-  constructor({ containerImage, keepContainer, runner, dockerImage, keepDocker }) {
+  disableTelemetry;
+  constructor({ containerImage, keepContainer, runner, disableTelemetry, dockerImage, keepDocker }) {
     this.containerImage = containerImage ?? dockerImage ?? "";
     this.keepContainer = keepContainer ?? keepDocker ?? false;
     this.runner = runner;
+    this.disableTelemetry = disableTelemetry ?? false;
   }
   async execute({ generatorName, irPath, configPath, outputPath, snippetPath, snippetTemplatePath, licenseFilePath, sourceMounts, context: context3, inspect: inspect6, runner }) {
     context3.logger.info(`Executing generator ${generatorName} using container image: ${this.containerImage}`);
@@ -847699,16 +848379,29 @@ var ContainerExecutionEnvironment = class {
       envVars["NODE_OPTIONS"] = `--inspect-brk=0.0.0.0:${DEFAULT_NODE_DEBUG_PORT}`;
       ports[DEFAULT_NODE_DEBUG_PORT] = DEFAULT_NODE_DEBUG_PORT;
     }
-    await runContainer({
-      logger: context3.logger,
-      imageName: this.containerImage,
-      args: [CONTAINER_GENERATOR_CONFIG_PATH],
-      binds,
-      envVars,
-      ports,
-      removeAfterCompletion: !this.keepContainer,
-      runner: this.runner ?? runner
-    });
+    if (this.disableTelemetry) {
+      envVars["FERN_DISABLE_TELEMETRY"] = "true";
+    }
+    try {
+      await runContainer({
+        logger: context3.logger,
+        imageName: this.containerImage,
+        args: [CONTAINER_GENERATOR_CONFIG_PATH],
+        binds,
+        envVars,
+        ports,
+        removeAfterCompletion: !this.keepContainer,
+        runner: this.runner ?? runner
+      });
+    } catch (error50) {
+      if (error50 instanceof CliError) {
+        throw error50;
+      }
+      throw new CliError({
+        message: `Container execution failed: ${error50 instanceof Error ? error50.message : String(error50)}`,
+        code: CliError.Code.ContainerError
+      });
+    }
   }
 };
 
@@ -873199,7 +873892,7 @@ var DynamicSnippetsJavaTestGenerator = class {
           }
         }
       } catch (e5) {
-        this.context.failAndThrow("Failed to run spotlessApply", e5);
+        this.context.failAndThrow("Failed to run spotlessApply", e5, { code: CliError.Code.InternalError });
       }
     }
     this.context.logger.debug("Done generating dynamic snippet tests");
@@ -894776,11 +895469,17 @@ var DynamicSnippetsTypeScriptTestGenerator = class {
   buildGeneratorConfig(config5) {
     const outputMode = config5.output.mode;
     if (outputMode.type !== "github") {
-      throw new Error("GitHub output mode is required for TypeScript dynamic snippet tests");
+      throw new CliError({
+        message: "GitHub output mode is required for TypeScript dynamic snippet tests",
+        code: CliError.Code.ConfigError
+      });
     }
     const publishInfo = outputMode.publishInfo;
     if (!publishInfo || publishInfo.type !== "npm") {
-      throw new Error("NPM publish info is required for TypeScript dynamic snippet tests");
+      throw new CliError({
+        message: "NPM publish info is required for TypeScript dynamic snippet tests",
+        code: CliError.Code.ConfigError
+      });
     }
     return {
       ...config5,
@@ -894834,7 +895533,10 @@ var DynamicSnippetsTestGenerator = class _DynamicSnippetsTestGenerator {
 // ../generation/local-generation/local-workspace-runner/lib/dynamic-snippets/generateDynamicSnippetsTestSuite.js
 async function generateDynamicSnippetsTestSuite({ ir: ir10, config: config5 }) {
   if (ir10.dynamic == null) {
-    throw new Error("Internal error; dynamic IR is not available");
+    throw new CliError({
+      message: "Internal error; dynamic IR is not available",
+      code: CliError.Code.InternalError
+    });
   }
   return {
     ir: ir10.dynamic,
@@ -895030,7 +895732,10 @@ function getGeneratorConfig({ generatorInvocation, customConfig, workspaceName,
         push: (value3) => `https://github.com/${value3.owner}/${value3.repo}`,
         pullRequest: (value3) => `https://github.com/${value3.owner}/${value3.repo}`,
         _other: () => {
-          throw new Error("Encountered unknown github mode");
+          throw new CliError({
+            message: "Encountered unknown github mode",
+            code: CliError.Code.InternalError
+          });
         }
       });
       const outputConfig = {
@@ -895051,7 +895756,10 @@ function getGeneratorConfig({ generatorInvocation, customConfig, workspaceName,
       return outputConfig;
     },
     _other: () => {
-      throw new Error("Output type did not match any of the types supported by Fern");
+      throw new CliError({
+        message: "Output type did not match any of the types supported by Fern",
+        code: CliError.Code.InternalError
+      });
     }
   });
   return {
@@ -895925,7 +896633,10 @@ var LocalTaskHandler = class {
         return null;
       }
       if (!this.version) {
-        throw new Error("Version is required for auto versioning");
+        throw new CliError({
+          message: "Version is required for auto versioning",
+          code: CliError.Code.InternalError
+        });
       }
       let previousVersion;
       try {
@@ -896113,7 +896824,10 @@ var LocalTaskHandler = class {
         };
       }
       this.context.logger.error(`Failed to perform automatic versioning: ${error50}`);
-      throw new Error(`Automatic versioning failed: ${error50}`);
+      throw new CliError({
+        message: `Automatic versioning failed: ${error50}`,
+        code: error50 instanceof CliError ? error50.code : CliError.Code.InternalError
+      });
     } finally {
       if (diffFile) {
         try {
@@ -896166,7 +896880,7 @@ var LocalTaskHandler = class {
   incrementVersion(version7, versionBump) {
     const cleanVersion = import_semver13.default.clean(version7);
     if (!cleanVersion) {
-      throw new Error(`Invalid version format: ${version7}`);
+      throw new CliError({ message: `Invalid version format: ${version7}`, code: CliError.Code.VersionError });
     }
     let releaseType;
     switch (versionBump) {
@@ -896180,11 +896894,17 @@ var LocalTaskHandler = class {
         releaseType = "patch";
         break;
       default:
-        throw new Error(`Unsupported version bump: ${versionBump}`);
+        throw new CliError({
+          message: `Unsupported version bump: ${versionBump}`,
+          code: CliError.Code.VersionError
+        });
     }
     const newVersion = import_semver13.default.inc(cleanVersion, releaseType);
     if (!newVersion) {
-      throw new Error(`Failed to increment version: ${version7}`);
+      throw new CliError({
+        message: `Failed to increment version: ${version7}`,
+        code: CliError.Code.VersionError
+      });
     }
     return version7.startsWith("v") ? `v${newVersion}` : newVersion;
   }
@@ -896244,7 +896964,10 @@ var LocalTaskHandler = class {
    */
   async getClientRegistry() {
     if (this.ai == null) {
-      throw new Error("No AI service configuration found in generators.yml. Please add an 'ai' section with provider and model.");
+      throw new CliError({
+        message: "No AI service configuration found in generators.yml. Please add an 'ai' section with provider and model.",
+        code: CliError.Code.ConfigError
+      });
     }
     this.context.logger.debug(`Using AI service: ${this.ai.provider} with model ${this.ai.model}`);
     return configureBamlClient(this.ai);
@@ -896482,7 +897205,7 @@ function extractLicenseFilePath(generatorInvocation, absolutePathToFernConfig) {
   }
   return void 0;
 }
-async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFernConfig, workspace, generatorInvocation, absolutePathToLocalOutput, absolutePathToLocalSnippetJSON, absolutePathToLocalSnippetTemplateJSON, audiences, version: version7, workspaceTempDir, keepDocker, context: context3, irVersionOverride, outputVersionOverride, writeUnitTests, generateOauthClients, generatePaginatedClients, includeOptionalRequestPropertyExamples, inspect: inspect6, executionEnvironment, runner, whiteLabel, publishToRegistry, ir: ir10, ai: ai10, autoVersioningCache, absolutePathToSpecRepo, skipFernignore }) {
+async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFernConfig, workspace, generatorInvocation, absolutePathToLocalOutput, absolutePathToLocalSnippetJSON, absolutePathToLocalSnippetTemplateJSON, audiences, version: version7, workspaceTempDir, keepDocker, context: context3, irVersionOverride, outputVersionOverride, writeUnitTests, generateOauthClients, generatePaginatedClients, includeOptionalRequestPropertyExamples, inspect: inspect6, executionEnvironment, runner, whiteLabel, publishToRegistry, ir: ir10, ai: ai10, autoVersioningCache, absolutePathToSpecRepo, skipFernignore, disableTelemetry }) {
   const { latest: latest2, migrated } = await getIntermediateRepresentation({
     workspace,
     audiences,
@@ -896527,7 +897250,8 @@ async function writeFilesToDiskAndRunGenerator({ organization, absolutePathToFer
   }
   const environment2 = executionEnvironment ?? new ContainerExecutionEnvironment({
     containerImage: generatorInvocation.containerImage ? `${generatorInvocation.containerImage}:${generatorInvocation.version}` : `${generatorInvocation.name}:${generatorInvocation.version}`,
-    keepContainer: keepDocker
+    keepContainer: keepDocker,
+    disableTelemetry
   });
   const paths = environment2.usesContainerPaths ? {
     outputDirectory: AbsoluteFilePath2.of(CONTAINER_CODEGEN_OUTPUT_DIRECTORY),
@@ -896653,7 +897377,7 @@ function getGeneratorOutputSubfolder(generatorName) {
 }
 
 // ../generation/local-generation/local-workspace-runner/lib/runLocalGenerationForWorkspace.js
-async function runLocalGenerationForWorkspace({ token, projectConfig, workspace, generatorGroup, version: version7, keepDocker, inspect: inspect6, context: context3, absolutePathToPreview, runner, ai: ai10, replay, noReplay, validateWorkspace, requireEnvVars, skipFernignore, publishToRegistry, isPreview: isPreviewOverride, automationMode, autoMerge }) {
+async function runLocalGenerationForWorkspace({ token, projectConfig, workspace, generatorGroup, version: version7, keepDocker, inspect: inspect6, context: context3, absolutePathToPreview, runner, ai: ai10, replay, noReplay, validateWorkspace, requireEnvVars, skipFernignore, publishToRegistry, isPreview: isPreviewOverride, automationMode, autoMerge, disableTelemetry }) {
   const userProvidedVersion = version7;
   if (userProvidedVersion != null) {
     if (absolutePathToPreview != null) {
@@ -896677,7 +897401,9 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
       const substituteEnvVars = (stringOrObject) => replaceEnvVariables(stringOrObject, {
         onError: (e5) => {
           if (!isPreview && (requireEnvVars ?? true)) {
-            interactiveTaskContext.failAndThrow(e5);
+            interactiveTaskContext.failAndThrow(e5, void 0, {
+              code: CliError.Code.EnvironmentError
+            });
           }
         }
       }, { substituteAsEmpty: isPreview });
@@ -896730,13 +897456,13 @@ async function runLocalGenerationForWorkspace({ token, projectConfig, workspace,
       if (generatorInvocation.absolutePathToLocalOutput == null) {
         token ??= await getAccessToken();
         if (token == null) {
-          interactiveTaskContext.failWithoutThrowing("Please provide a FERN_TOKEN in your environment.");
+          interactiveTaskContext.failWithoutThrowing("Please provide a FERN_TOKEN in your environment.", void 0, { code: CliError.Code.AuthError });
           return;
         }
       }
       const organization = await venus.organization.get(projectConfig.organization);
       if (generatorInvocation.absolutePathToLocalOutput == null && !organization.ok) {
-        interactiveTaskContext.failWithoutThrowing(`Failed to load details for organization ${projectConfig.organization}.`);
+        interactiveTaskContext.failWithoutThrowing(`Failed to load details for organization ${projectConfig.organization}.`, void 0, { code: CliError.Code.NetworkError });
         return;
       }
       if (organization.ok) {
@@ -896772,7 +897498,7 @@ generators:
       uri: your-org/your-sdk-repo
       token: \${GITHUB_TOKEN}
       mode: pull-request
-`);
+`, void 0, { code: CliError.Code.ConfigError });
         }
       }
       if (selfhostedGithubConfig != null) {
@@ -896806,13 +897532,13 @@ generators:
               const branchExists = await repo.remoteBranchExists(selfhostedGithubConfig.branch);
               if (!branchExists) {
                 const parsedRepo = parseRepository(selfhostedGithubConfig.uri);
-                interactiveTaskContext.failAndThrow(`Branch ${selfhostedGithubConfig.branch} does not exist in repository ${parsedRepo.owner}/${parsedRepo.repo}`);
+                interactiveTaskContext.failAndThrow(`Branch ${selfhostedGithubConfig.branch} does not exist in repository ${parsedRepo.owner}/${parsedRepo.repo}`, void 0, { code: CliError.Code.ConfigError });
               }
             }
             await repo.checkoutRemoteBranch(selfhostedGithubConfig.branch);
           }
         } catch (error50) {
-          interactiveTaskContext.failAndThrow(`Failed to clone GitHub repository ${selfhostedGithubConfig.uri}: ${extractErrorMessage(error50)}`);
+          interactiveTaskContext.failAndThrow(`Failed to clone GitHub repository ${selfhostedGithubConfig.uri}: ${extractErrorMessage(error50)}`, void 0, { code: CliError.Code.NetworkError });
         }
       }
       let absolutePathToLocalSnippetJSON = void 0;
@@ -896852,7 +897578,8 @@ generators:
         ai: ai10,
         autoVersioningCache,
         absolutePathToSpecRepo: dirname6(workspace.absoluteFilePath),
-        skipFernignore
+        skipFernignore,
+        disableTelemetry
       });
       interactiveTaskContext.logger.info(source_default.green("Wrote files to " + absolutePathToLocalOutput));
       if (selfhostedGithubConfig != null && shouldCommit) {
@@ -896909,13 +897636,13 @@ generators:
           interactiveTaskContext.logger.info(source_default.green("Automerge enabled on PR"));
         }
         if (!pipelineResult.success) {
-          interactiveTaskContext.failAndThrow(`Post-generation pipeline failed: ${pipelineResult.errors?.join(", ")}`);
+          interactiveTaskContext.failAndThrow(`Post-generation pipeline failed: ${pipelineResult.errors?.join(", ")}`, void 0, { code: CliError.Code.UserError });
         }
       }
     });
   }));
   if (results.some((didSucceed) => !didSucceed)) {
-    context3.failAndThrow();
+    throw new TaskAbortSignal();
   }
 }
 function resolveAbsolutePathToLocalPreview(absolutePathToPreview, generatorInvocation) {
@@ -897118,7 +897845,7 @@ var GenerationRunner = class {
     const results = await Promise.all(generatorGroup.generators.map(async (generatorInvocation) => {
       return context3.runInteractiveTask({ name: generatorInvocation.name }, async (interactiveTaskContext) => {
         if (generatorInvocation.absolutePathToLocalOutput == null) {
-          interactiveTaskContext.failWithoutThrowing("Cannot generate because output location is not local-file-system");
+          interactiveTaskContext.failWithoutThrowing("Cannot generate because output location is not local-file-system", void 0, { code: CliError.Code.ConfigError });
           return;
         }
         try {
@@ -897152,7 +897879,7 @@ var GenerationRunner = class {
         } catch (error50) {
           if (error50 instanceof TaskAbortSignal) {
           } else {
-            interactiveTaskContext.failWithoutThrowing(`Generation failed: ${error50 instanceof Error ? error50.message : "Unknown error"}`, error50);
+            interactiveTaskContext.failWithoutThrowing(`Generation failed: ${error50 instanceof Error ? error50.message : "Unknown error"}`, error50, { code: error50 instanceof CliError ? error50.code : CliError.Code.InternalError });
           }
         }
       });
@@ -897161,7 +897888,7 @@ var GenerationRunner = class {
   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");
+      throw new CliError({ message: "Output path is required for generation", code: CliError.Code.ConfigError });
     }
     const rawIr = generateIntermediateRepresentation({
       workspace,
@@ -897467,7 +898194,10 @@ var LegacyGeneratorInvocationAdapter = class {
     }
     const absolutePath = join8(this.context.cwd, RelativeFilePath2.of(license));
     if (!await doesPathExist(absolutePath, "file")) {
-      throw new Error(`Custom license file "${absolutePath}" does not exist; did you mean to use either MIT or Apache-2.0?`);
+      throw new CliError({
+        message: `Custom license file "${absolutePath}" does not exist; did you mean to use either MIT or Apache-2.0?`,
+        code: CliError.Code.InternalError
+      });
     }
     const contents = await (0, import_promises106.readFile)(absolutePath, "utf-8");
     return api_exports4.GithubLicense.custom({ contents });
@@ -897650,7 +898380,8 @@ var LegacyLocalGenerationRunner = class {
       inspect: false,
       ai: void 0,
       skipFernignore: args.skipFernignore,
-      requireEnvVars: args.requireEnvVars
+      requireEnvVars: args.requireEnvVars,
+      disableTelemetry: !this.context.telemetry.isTelemetryEnabled()
     });
     if (taskContext.getResult() === TaskResult.Failure) {
       return {
@@ -897674,7 +898405,8 @@ var LegacyLocalGenerationRunner = class {
     const executionEnvironment = new ContainerExecutionEnvironment({
       containerImage,
       keepContainer: args.keepContainer ?? false,
-      runner: args.containerEngine
+      runner: args.containerEngine,
+      disableTelemetry: !this.context.telemetry.isTelemetryEnabled()
     });
     const runner = new GenerationRunner(executionEnvironment);
     await runner.run({
@@ -897975,7 +898707,10 @@ var SdkTask = class {
   getTask() {
     const task = this.taskGroup.getTask(this.id);
     if (task == null) {
-      throw new Error(`Internal error; task '${this.id}' does not exist`);
+      throw new CliError({
+        message: `Internal error; task '${this.id}' does not exist`,
+        code: CliError.Code.InternalError
+      });
     }
     return task;
   }
@@ -898207,7 +898942,7 @@ var GenerateCommand = class {
   }
   async runGeneration({ context: context3, workspace, targets: targets2, args, forceLocal }) {
     if (workspace.sdks == null) {
-      throw new Error("No SDKs configured");
+      throw new CliError({ message: "No SDKs configured", code: CliError.Code.InternalError });
     }
     const apisToCheck = [...new Set(targets2.map((t3) => t3.api))];
     const apiChecker = new ApiChecker({
@@ -898889,7 +899624,10 @@ var GeneratorMigrator = class _GeneratorMigrator {
         const packageJsonContent = await (0, import_promises110.readFile)(packageJsonPath, "utf-8");
         const packageJson2 = JSON.parse(packageJsonContent);
         if (packageJson2.main == null) {
-          throw new Error(`No main field found in package.json for ${MIGRATION_PACKAGE_NAME}`);
+          throw new CliError({
+            message: `No main field found in package.json for ${MIGRATION_PACKAGE_NAME}`,
+            code: CliError.Code.InternalError
+          });
         }
         const packageEntryPoint = (0, import_path80.join)(packageDir, packageJson2.main);
         const { migrations } = await import((0, import_url8.pathToFileURL)(packageEntryPoint).href);
@@ -899004,11 +899742,14 @@ var GeneratorMigrator = class _GeneratorMigrator {
         this.logger.debug(`No migration package found for ${generatorName}.`);
         return void 0;
       }
-      throw new Error(`Failed to load generator migrations for ${generatorName}.
+      throw new CliError({
+        message: `Failed to load generator migrations for ${generatorName}.
 
 Reason: ${errorMessage}
 
-Please check your internet connection and npm configuration, then try again.`);
+Please check your internet connection and npm configuration, then try again.`,
+        code: CliError.Code.InternalError
+      });
     }
   }
   /**
@@ -899037,7 +899778,10 @@ Please check your internet connection and npm configuration, then try again.`);
       const aVersion = import_semver14.default.parse(a4.version);
       const bVersion = import_semver14.default.parse(b7.version);
       if (aVersion == null || bVersion == null) {
-        throw new Error(`Internal error: Invalid migration version found during sort. Version A: ${a4.version}, Version B: ${b7.version}. This should not happen as invalid versions are filtered out.`);
+        throw new CliError({
+          message: `Internal error: Invalid migration version found during sort. Version A: ${a4.version}, Version B: ${b7.version}. This should not happen as invalid versions are filtered out.`,
+          code: CliError.Code.InternalError
+        });
       }
       return import_semver14.default.compare(aVersion, bVersion);
     });
@@ -899055,11 +899799,14 @@ Please check your internet connection and npm configuration, then try again.`);
         appliedVersions.push(migration23.version);
       } catch (error50) {
         const errorMessage = extractErrorMessage(error50);
-        throw new Error(`Failed to apply migration for version ${migration23.version}.
+        throw new CliError({
+          message: `Failed to apply migration for version ${migration23.version}.
 
 Reason: ${errorMessage}
 
-Please report this issue at: https://github.com/fern-api/fern/issues`);
+Please report this issue at: https://github.com/fern-api/fern/issues`,
+          code: CliError.Code.InternalError
+        });
       }
     }
     return {
@@ -899475,7 +900222,9 @@ async function createFernDirectoryAndWorkspace({ organization, taskContext, vers
         if (response.ok) {
           organization = response.body.organizationId;
         } else {
-          taskContext.failAndThrow("Unauthorized. FERN_TOKEN is invalid.");
+          taskContext.failAndThrow("Unauthorized. FERN_TOKEN is invalid.", void 0, {
+            code: CliError.Code.AuthError
+          });
           return { absolutePathToFernDirectory: AbsoluteFilePath2.of("/dummy"), organization: "dummy" };
         }
       }
@@ -899709,7 +900458,7 @@ async function formatFernWorkspace({ workspace, context: context3, shouldFix })
         context3.logger.info(source_default.green(`Formatted ${source_default.bold(relativeFilepath)}`));
       } else {
         context3.logger.info(source_default.red(`Invalid formatting: ${source_default.bold(relativeFilepath)}`));
-        context3.failWithoutThrowing();
+        context3.failWithoutThrowing(void 0, void 0, { code: CliError.Code.ValidationError });
       }
     }
   }
@@ -900015,9 +900764,21 @@ async function writeSampleApiDefinition({ directoryOfDefinition, apiName }) {
   await (0, import_promises113.mkdir)(directoryOfDefinition);
   await (0, import_promises113.writeFile)(join8(directoryOfDefinition, RelativeFilePath2.of(ROOT_API_FILENAME)), jsYaml.dump(rootApi));
   const absoluteFilepathToImdbYaml = join8(directoryOfDefinition, RelativeFilePath2.of("imdb.yml"));
-  await (0, import_promises113.writeFile)(absoluteFilepathToImdbYaml, await formatDefinitionFile({
-    fileContents: SAMPLE_IMDB_API
-  }));
+  let formattedContent;
+  try {
+    formattedContent = await formatDefinitionFile({
+      fileContents: SAMPLE_IMDB_API
+    });
+  } catch (error50) {
+    if (error50 instanceof CliError) {
+      throw error50;
+    }
+    throw new CliError({
+      message: `Failed to format definition file: ${error50 instanceof Error ? error50.message : String(error50)}`,
+      code: CliError.Code.ParseError
+    });
+  }
+  await (0, import_promises113.writeFile)(absoluteFilepathToImdbYaml, formattedContent);
 }
 
 // ../init/lib/initializeAPI.js
@@ -900209,7 +900970,7 @@ var FernDocsBuilderImpl = class extends FernDocsBuilder {
     return this.nonTabbedNavigation;
   }
   addVersion({ versionConfig, navigation: navigation2 }) {
-    throw new Error("Method not implemented.");
+    throw new CliError({ message: "Method not implemented.", code: CliError.Code.InternalError });
   }
   addNavbarLink({ link: link3 }) {
     if (this.docsYml.navbarLinks == null) {
@@ -900641,7 +901402,7 @@ var MintlifyImporter = class extends DocsImporter {
     if (Object.keys(this.tabUrlToInfo).length > 0) {
       const tabUrl = getTabForMintItem({ mintItem });
       if (tabUrl == null) {
-        return this.context.failAndThrow(`Failed to assign navigation item to a tab group: ${mintItem.group}`);
+        return this.context.failAndThrow(`Failed to assign navigation item to a tab group: ${mintItem.group}`, void 0, { code: CliError.Code.ConfigError });
       }
       const tab2 = this.tabUrlToInfo[tabUrl] ?? this.getDefaultDocumentationTab(builder);
       return tab2.navigationBuilder;
@@ -900685,19 +901446,23 @@ async function runMintlifyMigration({ absolutePathToMintJson, outputPath, taskCo
 // ../init/lib/initializeWithMintlify.js
 var initializeWithMintlify = async ({ pathToMintJson, taskContext, versionOfCli, organization }) => {
   if (!pathToMintJson?.includes("mint.json")) {
-    taskContext.failAndThrow("Provide a path to a mint.json file");
+    taskContext.failAndThrow("Provide a path to a mint.json file", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   let absolutePathToMintJson = void 0;
   if (isURL(pathToMintJson)) {
-    taskContext.failAndThrow("Clone the repo locally and run this command again by referencing the path to the local mint.json file");
+    taskContext.failAndThrow("Clone the repo locally and run this command again by referencing the path to the local mint.json file", void 0, { code: CliError.Code.ConfigError });
     return;
   } else {
     absolutePathToMintJson = AbsoluteFilePath2.of(resolve6(cwd(), pathToMintJson));
   }
   const pathExists2 = await doesPathExist(absolutePathToMintJson);
   if (!pathExists2 || !absolutePathToMintJson) {
-    taskContext.failAndThrow(`${absolutePathToMintJson} does not exist`);
+    taskContext.failAndThrow(`${absolutePathToMintJson} does not exist`, void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const outputPath = AbsoluteFilePath2.of(cwd());
@@ -900721,7 +901486,7 @@ function assertIsNumber(val) {
 }
 function assertIsDefined(val) {
   if (val === void 0 || val == null) {
-    throw new Error("Value is nullable.");
+    throw new CliError({ message: "Value is nullable.", code: CliError.Code.InternalError });
   }
 }
 function assertIsStringArray(val) {
@@ -913584,7 +914349,7 @@ async function startPuppeteer() {
   try {
     return await launch3({ headless: true, args: ["--ignore-certificate-errors"] });
   } catch (error50) {
-    throw new Error("Could not create a Puppeteer instance");
+    throw new CliError({ message: "Could not create a Puppeteer instance", code: CliError.Code.EnvironmentError });
   }
 }
 async function getHtmlWithPuppeteer(browser, url3) {
@@ -913609,18 +914374,18 @@ async function getHtmlWithPuppeteer(browser, url3) {
     await page.close();
     return content5;
   } catch (error50) {
-    throw new Error("Failed to download page from Puppeteer");
+    throw new CliError({ message: "Failed to download page from Puppeteer", code: CliError.Code.NetworkError });
   }
 }
 async function fetchPageResponse(url3) {
   try {
     const res = await fetch(url3);
     if (!res.ok) {
-      throw new Error(`${res.status} ${res.statusText}`);
+      throw new CliError({ message: `${res.status} ${res.statusText}`, code: CliError.Code.NetworkError });
     }
     return await res.text();
   } catch (error50) {
-    throw new Error("Failed to fetch page from source");
+    throw new CliError({ message: "Failed to fetch page from source", code: CliError.Code.NetworkError });
   }
 }
 async function fetchPageHtml({ url: url3, browser }) {
@@ -913634,22 +914399,28 @@ async function fetchPageHtml({ url: url3, browser }) {
     if (res) {
       return res;
     }
-    throw new Error("An unknown error occurred.");
+    throw new CliError({ message: "An unknown error occurred.", code: CliError.Code.NetworkError });
   } catch (error50) {
-    throw new Error(`Error retrieving HTML for ${url3.toString()}`);
+    throw new CliError({
+      message: `Error retrieving HTML for ${url3.toString()}`,
+      code: CliError.Code.NetworkError
+    });
   }
 }
 async function fetchImage(url3) {
   try {
     const res = await exponentialBackoff(() => fetch(url3));
     if (!res.ok) {
-      throw new Error(`${res.status} ${res.statusText}`);
+      throw new CliError({ message: `${res.status} ${res.statusText}`, code: CliError.Code.NetworkError });
     }
     const imageBuffer = await res.arrayBuffer();
     const imageData = new Uint8Array(imageBuffer);
     return imageData;
   } catch (error50) {
-    throw new Error(`Failed to retrieve image from source url ${url3}`);
+    throw new CliError({
+      message: `Failed to retrieve image from source url ${url3}`,
+      code: CliError.Code.NetworkError
+    });
   }
 }
 
@@ -913688,7 +914459,10 @@ async function writeImageToFile(src, rootPath) {
   const filename = removeMetadataFromImageSrc(src);
   const imagePath = (0, import_node_path40.join)(rootPath, filename);
   if (!isValidImageSrc(filename)) {
-    throw new Error(`${filename} - file extension not supported`);
+    throw new CliError({
+      message: `${filename} - file extension not supported`,
+      code: CliError.Code.InternalError
+    });
   }
   if ((0, import_node_fs31.existsSync)(imagePath)) {
     return imagePath;
@@ -913696,14 +914470,17 @@ async function writeImageToFile(src, rootPath) {
   try {
     (0, import_node_fs31.mkdirSync)((0, import_node_path40.dirname)(imagePath), { recursive: true });
   } catch (error50) {
-    throw new Error(`${imagePath} - failed to create directory`);
+    throw new CliError({ message: `${imagePath} - failed to create directory`, code: CliError.Code.InternalError });
   }
   try {
     const imageData = await fetchImage(src);
     write2(imagePath, imageData);
     return imagePath;
   } catch (error50) {
-    throw new Error(`${imagePath}: failed to download file from source`);
+    throw new CliError({
+      message: `${imagePath}: failed to download file from source`,
+      code: CliError.Code.NetworkError
+    });
   }
 }
 function isValidImageSrc(src) {
@@ -914082,7 +914859,9 @@ async function runReadmeMigration({ readmeUrl, outputPath, taskContext, versionO
 // ../init/lib/initializeWithReadme.js
 var initializeWithReadme = async ({ readmeUrl, organization, taskContext, versionOfCli }) => {
   if (!readmeUrl || !isURL(readmeUrl)) {
-    taskContext.failAndThrow("Provide a URL to a readme-generated site");
+    taskContext.failAndThrow("Provide a URL to a readme-generated site", void 0, {
+      code: CliError.Code.ConfigError
+    });
     return;
   }
   const outputPath = AbsoluteFilePath2.of(cwd());
@@ -917803,13 +918582,17 @@ function reportError2(reporter, error50, options2) {
   }
 }
 
+// src/telemetry/isTelemetryDisabled.ts
+function isTelemetryDisabled() {
+  return process.env.FERN_DISABLE_TELEMETRY === "true";
+}
+
 // src/telemetry/SentryClient.ts
 var SentryClient = class {
   sentry;
   constructor({ release: release2 }) {
-    const isTelemetryEnabled = process.env.FERN_DISABLE_TELEMETRY !== "true";
     const sentryDsn = "https://84f58b5e457f06999d92f11ce4b79158@o4509504076185600.ingest.us.sentry.io/4511021546602496";
-    if (isTelemetryEnabled && sentryDsn != null && sentryDsn.length > 0) {
+    if (!isTelemetryDisabled() && sentryDsn != null && sentryDsn.length > 0) {
       const sentryEnvironment = "development";
       if (sentryEnvironment == null || sentryEnvironment.length === 0) {
         throw new CliError({
@@ -917821,9 +918604,33 @@ var SentryClient = class {
         dsn: sentryDsn,
         release: release2,
         environment: sentryEnvironment,
+        // Opt out of every built-in integration (HTTP tracing, local
+        // variables, console breadcrumbs, etc.) — error capture is all
+        // we need.
         defaultIntegrations: false,
-        integrations: [rewriteFramesIntegration()],
-        tracesSampleRate: 0
+        // Rewrite absolute frame paths to repo-root-relative paths so
+        // they align with the source maps uploaded at publish time.
+        // onUncaughtException / onUnhandledRejection catch errors that
+        // escape the CLI's top-level handler (fire-and-forget callbacks,
+        // unhandled rejections in background work, etc.).
+        // linkedErrors chains .cause so wrapped errors stay traceable.
+        // nodeContext adds Node.js version and OS to every event.
+        integrations: [
+          rewriteFramesIntegration(),
+          onUncaughtExceptionIntegration(),
+          onUnhandledRejectionIntegration(),
+          linkedErrorsIntegration(),
+          nodeContextIntegration()
+        ],
+        // The CLI doesn't emit transactions; disable performance
+        // sampling entirely.
+        tracesSampleRate: 0,
+        // Always attach a stack trace, even when the thrown value is
+        // not an Error instance (e.g. a plain string or object).
+        attachStacktrace: true,
+        // Suppress the client-report envelope Sentry sends when events
+        // are dropped (e.g. due to rate limits).
+        sendClientReports: false
       });
       setSentryRunIdTags();
     }
@@ -918415,7 +919222,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.81.1";
+    return "4.82.0-3-gc1f31446d2e";
   }
   getCliName() {
     if (false) {
@@ -918717,7 +919524,9 @@ var import_promises127 = require("fs/promises");
 async function loadProject({ context: context3, nameOverride, ...args }) {
   const fernDirectory = await getFernDirectory(nameOverride);
   if (fernDirectory == null) {
-    return context3.failAndThrow(`Directory "${nameOverride ?? FERN_DIRECTORY}" not found.`);
+    return context3.failAndThrow(`Directory "${nameOverride ?? FERN_DIRECTORY}" not found.`, void 0, {
+      code: CliError.Code.ConfigError
+    });
   }
   return await loadProjectFromDirectory({
     absolutePathToFernDirectory: fernDirectory,
@@ -918758,7 +919567,7 @@ Or one of the following directories:
  \u203A ${ASYNCAPI_DIRECTORY}/
 For more information:
  \u203A SDK project structure: https://buildwithfern.com/learn/api-definitions/overview/project-structure
- \u203A Docs project structure: https://buildwithfern.com/learn/docs/getting-started/project-structure`);
+ \u203A Docs project structure: https://buildwithfern.com/learn/docs/getting-started/project-structure`, void 0, { code: CliError.Code.ConfigError });
   }
   return {
     config: await loadProjectConfig({ directory: absolutePathToFernDirectory, context: context3 }),
@@ -918785,10 +919594,12 @@ async function loadApis({ cliName, fernDirectory, context: context3, cliVersion,
     }, []);
     if (commandLineApiWorkspace != null) {
       if (!apiWorkspaceDirectoryNames.includes(commandLineApiWorkspace)) {
-        return context3.failAndThrow("API does not exist: " + commandLineApiWorkspace);
+        return context3.failAndThrow("API does not exist: " + commandLineApiWorkspace, void 0, {
+          code: CliError.Code.ConfigError
+        });
       }
     } else if (apiWorkspaceDirectoryNames.length === 0) {
-      return context3.failAndThrow("No APIs found.");
+      return context3.failAndThrow("No APIs found.", void 0, { code: CliError.Code.ConfigError });
     } else if (apiWorkspaceDirectoryNames.length > 1 && !defaultToAllApiWorkspaces) {
       let message = "There are multiple workspaces. You must specify one with --api:\n";
       const longestWorkspaceName = Math.max(...apiWorkspaceDirectoryNames.map((workspaceName) => workspaceName.length));
@@ -918796,7 +919607,7 @@ async function loadApis({ cliName, fernDirectory, context: context3, cliVersion,
         const suggestedCommand = `${cliName} ${process.argv.slice(2).join(" ")} --api ${workspaceName}`;
         return ` \u203A ${source_default.bold(workspaceName.padEnd(longestWorkspaceName))}  ${source_default.dim(suggestedCommand)}`;
       }).join("\n");
-      return context3.failAndThrow(message);
+      return context3.failAndThrow(message, void 0, { code: CliError.Code.ConfigError });
     }
     const apiWorkspaces = [];
     const filteredWorkspaces = commandLineApiWorkspace != null ? apiWorkspaceDirectoryNames.filter((api2) => {
@@ -918813,7 +919624,7 @@ async function loadApis({ cliName, fernDirectory, context: context3, cliVersion,
         apiWorkspaces.push(workspace2.workspace);
       } else {
         handleFailedWorkspaceParserResult(workspace2, context3.logger);
-        context3.failAndThrow();
+        context3.failAndThrow(void 0, void 0, { code: CliError.Code.ConfigError });
       }
     }));
     return apiWorkspaces;
@@ -920342,7 +921153,8 @@ async function generateWorkspace({
             requireEnvVars,
             skipFernignore,
             automationMode,
-            autoMerge
+            autoMerge,
+            disableTelemetry: isTelemetryDisabled()
           });
         } else if (token != null) {
           await runRemoteGenerationForAPIWorkspace({
@@ -925077,7 +925889,10 @@ function renderCompoundPage(compound, meta5) {
       return renderVariablePage(compound.data, meta5);
     default: {
       const _exhaustive = compound;
-      throw new Error(`Unknown compound kind: ${JSON.stringify(_exhaustive)}`);
+      throw new CliError({
+        message: `Unknown compound kind: ${JSON.stringify(_exhaustive)}`,
+        code: CliError.Code.InternalError
+      });
     }
   }
 }
@@ -925371,7 +926186,10 @@ function categoryFolderForCompound(collected) {
       return "variables";
     default: {
       const _exhaustive = collected.compound;
-      throw new Error(`Unknown compound kind: ${JSON.stringify(_exhaustive)}`);
+      throw new CliError({
+        message: `Unknown compound kind: ${JSON.stringify(_exhaustive)}`,
+        code: CliError.Code.InternalError
+      });
     }
   }
 }
@@ -926633,7 +927451,10 @@ function resolveTarget({
     return { type: "id", value: id };
   }
   if (target == null) {
-    throw new Error("Must provide a preview URL or --id.");
+    throw new CliError({
+      message: "Must provide a preview URL or --id.",
+      code: CliError.Code.ConfigError
+    });
   }
   if (isPreviewUrl(target)) {
     return { type: "url", value: target };
@@ -930076,7 +930897,7 @@ var JsonSchemaConverterContext = class {
         this.context.logger.error(`Type ${typeName} not found`);
       } else {
       }
-      return this.context.failAndThrow();
+      return this.context.failAndThrow(void 0, void 0, { code: CliError.Code.ReferenceError });
     }
     return typeDeclaration2;
   }
@@ -931417,7 +932238,8 @@ async function sdkPreview({
               noReplay: true,
               validateWorkspace: true,
               publishToRegistry,
-              isPreview: true
+              isPreview: true,
+              disableTelemetry: isTelemetryDisabled()
             });
           });
         }
@@ -939050,10 +939872,16 @@ function addDocsPreviewDeleteCommand(cli, cliContext) {
     }).check((argv) => {
       const sources = [argv.target, argv.url, argv.id].filter(Boolean);
       if (sources.length === 0) {
-        throw new Error("Must provide a preview URL or --id.");
+        throw new CliError({
+          message: "Must provide a preview URL or --id.",
+          code: CliError.Code.ConfigError
+        });
       }
       if (sources.length > 1) {
-        throw new Error("Provide only one of: [target], --url, or --id.");
+        throw new CliError({
+          message: "Provide only one of: [target], --url, or --id.",
+          code: CliError.Code.ConfigError
+        });
       }
       return true;
     }),