@fern-api/fern-api-dev 4.81.1 → 4.82.0-1-g000d7384e60

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) {
@@ -524639,7 +524641,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 +527801,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 +528133,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 +528167,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 +528223,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 +529063,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 +530395,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 +530908,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 +530926,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 +530943,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 +530960,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 +530981,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 +531112,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 +531389,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 +531634,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 +531644,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 +531966,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 +531980,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 +531997,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 +532011,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 +532025,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 +532793,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 +534307,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 +534491,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 +535810,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 +535843,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 +535860,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 +536023,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 +536637,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 +536797,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 +536815,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 +536916,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 +537048,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 +537373,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 +537565,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 +537843,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 +537972,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 +537998,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 +544563,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 +545133,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 +545329,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 +545354,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 +551838,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 +552048,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 +552138,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 +552183,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 +552250,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 +552294,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 +552353,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 +552533,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 +553003,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 +553481,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 +553504,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 +553730,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 +553802,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 +553853,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 +553909,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 +553953,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 +553983,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 +554015,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 +554034,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 +554104,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 +554265,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 +554352,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 +554392,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 +554410,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 +554423,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 +554509,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 +554621,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 +554704,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 +554757,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 +555145,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 +555316,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 +555333,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 +555345,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 +555570,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 +555851,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 +556347,7 @@ var DynamicSnippetsConverter = class {
           }))
         }),
         _other: () => {
-          throw new Error("Unknown environments type");
+          throw new CliError({ message: "Unknown environments type", code: CliError.Code.InternalError });
         }
       })
     };
@@ -556168,10 +556384,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 +556678,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 +556859,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 +556971,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 +557238,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 +557266,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 +557308,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 +557338,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 +557425,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 +557579,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 +557630,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 +557727,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 +558122,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 +558156,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 +558551,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 +558563,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 +558579,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 +558645,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 +558692,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 +558774,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 +558905,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 +558994,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 +559041,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 +559092,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 +559139,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 +559309,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 +559330,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 +559510,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 +559666,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 +559728,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 +559754,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 +559929,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({
@@ -581572,7 +581884,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 +581897,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 +581921,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 +581948,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 +581967,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 +581979,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 +581991,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 +592538,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 +592549,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 +592563,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 +592632,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 +592794,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 +592880,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 +592891,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) {
@@ -604748,7 +605093,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 +605104,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 +605178,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 +605370,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 +605590,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 +605598,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 +605616,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 +605664,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 +605675,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 +605749,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 +605870,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 +605892,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 +605929,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 +605989,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 +606002,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 +606042,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 +606067,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 +606077,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 +606464,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 +606563,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 +606600,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 +614735,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.81.1",
+          version: "4.82.0-1-g000d7384e60",
           usingAccessToken: true
         }
       });
@@ -614410,7 +614789,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.81.1",
+        version: "4.82.0-1-g000d7384e60",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -615614,7 +615993,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 +616008,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 +616023,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 +616038,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) {
@@ -617763,7 +618154,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 +618199,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 +618273,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 +618394,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 +618576,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 +619939,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));
@@ -746685,7 +747091,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 +748251,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;
   }));
@@ -788205,7 +788617,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 +788689,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 +788754,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 +790270,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 +790298,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 +790365,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 +790456,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 +790470,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 +790937,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 +790952,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 +790989,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 +791024,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 +791140,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 +791197,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 +791440,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 +791569,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 +791611,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 +791915,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
+    });
   }
 }
 
@@ -827894,7 +828371,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);
@@ -831728,7 +832205,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-1-g000d7384e60";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -841126,7 +841603,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 +841619,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 +841644,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 +841694,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 +841731,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 +841778,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 +841845,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 +841904,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 +841957,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 +842034,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 +842211,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 +842266,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 +842282,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 +842384,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 +842397,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 +842427,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 +842463,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 +842631,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 +843070,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 +843099,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 +843109,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 +843123,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 +843185,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 +843227,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 +843694,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 +843757,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 +843807,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.81.1"
+        cliVersion: "4.82.0-1-g000d7384e60"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -843770,7 +844282,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 +845557,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 +847090,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 +847150,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 +847166,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 +847201,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 +848208,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 +848240,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 +873753,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 +895330,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 +895394,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 +895593,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 +895617,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 +896494,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 +896685,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 +896741,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 +896755,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 +896825,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 +897066,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 +897111,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 +897238,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 +897262,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 +897317,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 +897359,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 +897393,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 +897439,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 +897497,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 +897706,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 +897740,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 +897749,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 +898055,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 +898241,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 +898266,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 +898568,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 +898803,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 +899485,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 +899603,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 +899639,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 +899660,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 {
@@ -917803,13 +918411,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 +918433,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 +919051,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.81.1";
+    return "4.82.0-1-g000d7384e60";
   }
   getCliName() {
     if (false) {
@@ -920342,7 +920978,8 @@ async function generateWorkspace({
             requireEnvVars,
             skipFernignore,
             automationMode,
-            autoMerge
+            autoMerge,
+            disableTelemetry: isTelemetryDisabled()
           });
         } else if (token != null) {
           await runRemoteGenerationForAPIWorkspace({
@@ -931417,7 +932054,8 @@ async function sdkPreview({
               noReplay: true,
               validateWorkspace: true,
               publishToRegistry,
-              isPreview: true
+              isPreview: true,
+              disableTelemetry: isTelemetryDisabled()
             });
           });
         }