@fern-api/fern-api-dev 4.81.0-1-g51d703eda99 → 4.81.0-11-gc0c2550bc58

package/cli.cjs

@@ -524639,7 +524639,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 +527799,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 +528131,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 +528165,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 +528221,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 +529061,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 +530393,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 +530906,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 +530924,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 +530941,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 +530958,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 +530979,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 +531110,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 +531387,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 +531632,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 +531642,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 +531964,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 +531978,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 +531995,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 +532009,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 +532023,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 +532791,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 +534305,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 +534489,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 +535808,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 +535841,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 +535858,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 +536021,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 +536635,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 +536795,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 +536813,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 +536914,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 +537046,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 +537371,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 +537563,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 +537841,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 +537970,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 +537996,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 +544561,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 +545131,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 +545327,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 +545352,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 +551836,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 +552046,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 +552136,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 +552181,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 +552248,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 +552292,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 +552351,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 +552531,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 +553001,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 +553479,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 +553502,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 +553728,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 +553800,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 +553851,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 +553907,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 +553951,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 +553981,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 +554013,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 +554032,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 +554102,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 +554263,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 +554350,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 +554390,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 +554408,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 +554421,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 +554507,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 +554619,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 +554702,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 +554755,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 +555143,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 +555314,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 +555331,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 +555343,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 +555568,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 +555849,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 +556345,7 @@ var DynamicSnippetsConverter = class {
           }))
         }),
         _other: () => {
-          throw new Error("Unknown environments type");
+          throw new CliError({ message: "Unknown environments type", code: CliError.Code.InternalError });
         }
       })
     };
@@ -556168,10 +556382,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 +556676,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 +556857,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 +556969,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 +557236,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 +557264,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 +557306,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 +557336,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 +557423,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 +557577,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 +557628,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 +557725,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 +558120,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 +558154,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 +558549,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 +558561,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 +558577,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 +558643,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 +558690,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 +558772,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 +558903,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 +558992,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 +559039,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 +559090,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 +559137,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 +559307,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 +559328,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 +559508,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 +559664,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 +559726,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 +559752,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 +559927,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({
@@ -614356,7 +614666,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.81.0-1-g51d703eda99",
+          version: "4.81.0-11-gc0c2550bc58",
           usingAccessToken: true
         }
       });
@@ -614410,7 +614720,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.81.0-1-g51d703eda99",
+        version: "4.81.0-11-gc0c2550bc58",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -615614,7 +615924,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 +615939,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 +615954,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 +615969,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 +618085,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 +618130,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 +618204,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,
@@ -618176,7 +618507,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 +619870,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 +747022,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 +748182,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;
   }));
@@ -827894,7 +828237,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 +832071,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.0-1-g51d703eda99";
+  const version7 = "4.81.0-11-gc0c2550bc58";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -843295,7 +843638,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.81.0-1-g51d703eda99"
+        cliVersion: "4.81.0-11-gc0c2550bc58"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -843770,7 +844113,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 +845388,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 +846921,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 +846981,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 +846997,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 +847032,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) {
@@ -847699,16 +848069,26 @@ 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
-    });
+    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
+      });
+    }
   }
 };
 
@@ -897467,7 +897847,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 });
@@ -897975,7 +898358,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 +898593,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 +899275,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 +899393,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 +899429,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 +899450,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 {
@@ -918415,7 +918813,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.81.0-1-g51d703eda99";
+    return "4.81.0-11-gc0c2550bc58";
   }
   getCliName() {
     if (false) {