Merge branch 'swift-docs' of https://github.com/fern-api/docs into swift-docs

Author: devalog

fern/apis/fai/definition/chat.yml

@@ -19,19 +19,34 @@ service:
         name: ChatCompletionRequest
         body:
           properties:
-            model: optional<string>
-            system_prompt: optional<string>
-            messages: list<ChatTurn>
+            model:
+              type: LanguageModel
+              docs: The model to use for the chat completion.
+            system_prompt:
+              type: optional<string>
+              docs: The system prompt to use for the chat completion.
+            messages: 
+              type: list<ChatTurn>
+              docs: The messages to use for the chat completion.
       response: ChatCompletionResponse
       errors:
         - commons.BadRequestError
         - commons.InternalError
 
 types:
   ChatCompletionResponse:
-    type: list<ChatTurn>
+    properties:
+      turns: list<ChatTurn>
+      citations: list<string>
 
   ChatTurn:
     properties:
       role: string
       content: string
+
+  LanguageModel:
+    enum:
+      - name: claude_4
+        value: claude-4-sonnet-20250514
+      - name: command_a
+        value: command-a-03-2025

fern/products/cli-api-reference/cli-changelog/2025-04-09.mdx

@@ -3,12 +3,12 @@
 
 
 ## 0.57.19
-**`(fix):`** Fix an issue in the OpenAPI parser where array references were not being properly resolved. The parser now correctly resolves references 
+**`(fix):`** Fix an issue in the OpenAPI parser where array references were not being properly resolved. The parser now correctly resolves references
 within array schemas, ensuring that arrays of referenced types are properly handled throughout the API definition.
 
 
 ## 0.57.18
-**`(fix):`** Improve the ReadMe migrator to respect the original navigation structure when creating the file hierarchy. Previously, nested navigation groups were 
+**`(fix):`** Improve the ReadMe migrator to respect the original navigation structure when creating the file hierarchy. Previously, nested navigation groups were
 flattened, but now the file structure will mirror the navigation hierarchy, preserving the original organization of documentation.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-12.mdx

@@ -1,5 +1,5 @@
 ## 0.57.24
-**`(fix):`** Fix an issue in the OpenAPI importer where discriminated unions with literal discriminant values in the variants would render the discriminant property twice. 
+**`(fix):`** Fix an issue in the OpenAPI importer where discriminated unions with literal discriminant values in the variants would render the discriminant property twice.
 The importer now correctly checks if union variants contain the discriminant property as a literal value and handles them appropriately.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-21.mdx

@@ -6,13 +6,13 @@ Single element type arrays will resolve to the single element in the example.
 
 
 ## 0.57.33
-**`(feat):`** Improve OpenRPC response example generation by wrapping example payloads in JSON-RPC 2.0 format with metadata 
+**`(feat):`** Improve OpenRPC response example generation by wrapping example payloads in JSON-RPC 2.0 format with metadata
 (jsonrpc version and request id). This ensures generated examples match the actual JSON-RPC response format.
 
 
 ## 0.57.32
-**`(feat):`** Improve server handling in OpenAPI imports by exploding servers with enum variables into multiple servers, 
-one for each enum value. For example, a server with URL "https://{region}.example.com" where region 
+**`(feat):`** Improve server handling in OpenAPI imports by exploding servers with enum variables into multiple servers,
+one for each enum value. For example, a server with URL "https://{region}.example.com" where region
 is an enum ["us", "eu"] will be exploded into two servers: "https://us.example.com" and "https://eu.example.com".
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-22.mdx

@@ -1,7 +1,7 @@
 ## 0.57.35
-**`(feat):`** Improve OpenAPI response handling for 204 status codes by respecting schema definitions. 
-When a 204 (No Content) response includes a schema, the importer now properly processes 
-and preserves this schema information, ensuring accurate API documentation and SDK generation 
+**`(feat):`** Improve OpenAPI response handling for 204 status codes by respecting schema definitions.
+When a 204 (No Content) response includes a schema, the importer now properly processes
+and preserves this schema information, ensuring accurate API documentation and SDK generation
 even for endpoints that don't return content in successful responses.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-24.mdx

@@ -8,8 +8,8 @@ multiple API Definitions that have overlapping schema names or operation names.
 
 
 ## 0.57.37
-**`(feat):`** Improve OpenRPC request example generation by not wrapping request payloads in JSON-RPC 2.0 format. 
-This ensures generated request examples match the expected format for the API's method parameters 
+**`(feat):`** Improve OpenRPC request example generation by not wrapping request payloads in JSON-RPC 2.0 format.
+This ensures generated request examples match the expected format for the API's method parameters
 without the additional JSON-RPC envelope.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-26.mdx

@@ -1,7 +1,7 @@
 ## 0.58.2
-**`(feat):`** Enhance example generation to consider default values when generating examples for primitive types. 
-When a string primitive type has a default value specified, the example generator now uses this 
-default value instead of a generic example. This produces more realistic and contextually 
+**`(feat):`** Enhance example generation to consider default values when generating examples for primitive types.
+When a string primitive type has a default value specified, the example generator now uses this
+default value instead of a generic example. This produces more realistic and contextually
 appropriate examples in generated SDKs and documentation.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-27.mdx

@@ -1,8 +1,8 @@
 ## 0.58.3
-**`(feat):`** Enhance OpenAPI security scheme handling in the parser to support both global and endpoint-level security requirements. 
-The parser now properly converts security schemes from OpenAPI's `securitySchemes` component into appropriate authentication 
-headers, supporting bearer tokens, basic auth, and custom API key headers. Global security requirements defined at the 
-document level are applied to all endpoints, while endpoint-specific security requirements override or supplement the 
+**`(feat):`** Enhance OpenAPI security scheme handling in the parser to support both global and endpoint-level security requirements.
+The parser now properly converts security schemes from OpenAPI's `securitySchemes` component into appropriate authentication
+headers, supporting bearer tokens, basic auth, and custom API key headers. Global security requirements defined at the
+document level are applied to all endpoints, while endpoint-specific security requirements override or supplement the
 global configuration, ensuring accurate authentication representation in generated SDKs.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-29.mdx

@@ -3,7 +3,7 @@
 
 
 ## 0.59.1
-**`(feat):`** Enhance OpenAPI -> IR parser to better handle inlined oneOf schemas. The parser now uses the schema ID when 
+**`(feat):`** Enhance OpenAPI -> IR parser to better handle inlined oneOf schemas. The parser now uses the schema ID when
 generating names for oneOf variants, resulting in more predictable and consistent type names in the generated SDKs.
 
 
@@ -13,8 +13,8 @@ This command is in-development; changes are expected.
 
 
 ## 0.58.6
-**`(feat):`** Add support for schema conversion in OpenRPC importer. The importer now properly converts schemas defined in the 
-OpenRPC document's components section into Fern types, enabling full type definitions for request and response 
+**`(feat):`** Add support for schema conversion in OpenRPC importer. The importer now properly converts schemas defined in the
+OpenRPC document's components section into Fern types, enabling full type definitions for request and response
 objects. This enhancement allows for more complete and accurate SDK generation from OpenRPC specifications.
 
 

fern/products/cli-api-reference/cli-changelog/2025-04-30.mdx

@@ -1,12 +1,12 @@
 ## 0.59.4
-**`(fix):`** Enhance OpenAPI -> IR conversion to properly handle default values in schemas. The converter now correctly extracts 
-and preserves default values from OpenAPI schemas, ensuring they are properly represented in the generated SDKs. 
+**`(fix):`** Enhance OpenAPI -> IR conversion to properly handle default values in schemas. The converter now correctly extracts
+and preserves default values from OpenAPI schemas, ensuring they are properly represented in the generated SDKs.
 This improvement allows API providers to specify meaningful defaults that will be respected in client implementations.
 
 
 ## 0.59.3
-**`(fix):`** Improve OpenRPC importer to generate more unique schema IDs for request parameters by combining method name, 
-"Param" keyword, and parameter name. This prevents naming conflicts when different methods have parameters 
+**`(fix):`** Improve OpenRPC importer to generate more unique schema IDs for request parameters by combining method name,
+"Param" keyword, and parameter name. This prevents naming conflicts when different methods have parameters
 with the same name, resulting in more reliable and consistent type generation in the SDKs.