Merge remote-tracking branch 'origin/main' into jsklan/aiohttp-python

Author: jsklan

generators/python/sdk/versions.yml

@@ -1,5 +1,16 @@
 # yaml-language-server: $schema=../../../fern-versions-yml.schema.json
 # For unreleased changes, use unreleased.yml
+- version: 5.0.0
+  changelogEntry:
+    - summary: |
+        Raise the default minimum Python version from `^3.8` to `^3.10` in generated
+        `pyproject.toml`. This allows the dependency resolver to pick Pydantic 2.11+ and
+        pydantic-core 2.33+, which ship pre-built wheels for Python 3.14, fixing
+        installation failures on Python 3.14.
+      type: feat
+  createdAt: "2026-03-16"
+  irVersion: 65
+
 - version: 4.64.1
   changelogEntry:
     - summary: |

generators/python/src/fern_python/cli/abstract_generator.py

@@ -75,7 +75,7 @@ def generate_project(
                                     update={"installation_token": ir_publish_config.token}
                                 )
 
-        python_version = "^3.8"
+        python_version = "^3.10"
         if generator_config.custom_config is not None and "pyproject_python_version" in generator_config.custom_config:
             python_version = generator_config.custom_config.get("pyproject_python_version")
 

generators/python/src/fern_python/codegen/project.py

@@ -41,7 +41,7 @@ def __init__(
         filepath: str,
         relative_path_to_project: str,
         package_path: Optional[str] = None,
-        python_version: str = "^3.8",
+        python_version: str = "^3.10",
         project_config: Optional[ProjectConfig] = None,
         sorted_modules: Optional[Sequence[str]] = None,
         flat_layout: bool = False,

generators/python/src/fern_python/generators/sdk/custom_config.py

@@ -100,7 +100,7 @@ class SDKCustomConfig(pydantic.BaseModel):
     # WARNING - this changes your declared python dependency, which is not meant to
     # be done often if at all. This is a last resort if any dependencies force you
     # to change your version requirements.
-    pyproject_python_version: Optional[str] = "^3.8"
+    pyproject_python_version: Optional[str] = "^3.10"
 
     # Whether or not to generate TypedDicts instead of Pydantic
     # Models for request objects.

generators/python/tests/codegen/test_github_ci_python_version.py

@@ -4,11 +4,11 @@
 
 
 class TestGithubCIPythonVersionResolver:
-    def test_resolve_default_constraint_returns_3_9(self) -> None:
-        """Default pyproject_python_version (^3.8) should resolve to 3.9 for CI."""
-        default_python_version_constraint = "^3.8"
+    def test_resolve_default_constraint_returns_3_10(self) -> None:
+        """Default pyproject_python_version (^3.10) should resolve to 3.10 for CI."""
+        default_python_version_constraint = "^3.10"
         result = GithubCIPythonVersionResolver.resolve(default_python_version_constraint)
-        assert result == PythonVersion.PY3_9
+        assert result == PythonVersion.PY3_10
 
     def test_resolve_uses_minimum_when_3_9_not_in_intersection(self) -> None:
         result = GithubCIPythonVersionResolver.resolve("^3.10")

generators/python/tests/codegen/test_python_version_utils.py

@@ -86,13 +86,8 @@ def test_impossible_constraint_returns_empty(self) -> None:
 class TestGetMinimumCompatibleVersion:
     """Tests for get_minimum_compatible_version function."""
 
-    def test_caret_3_8_returns_3_8(self) -> None:
-        """Test ^3.8 returns 3.8 as minimum."""
-        min_version = get_minimum_compatible_version("^3.8")
-        assert min_version == PythonVersion.PY3_8
-
     def test_caret_3_10_returns_3_10(self) -> None:
-        """Test ^3.10 returns 3.10 as minimum."""
+        """Test ^3.10 (the default) returns 3.10 as minimum."""
         min_version = get_minimum_compatible_version("^3.10")
         assert min_version == PythonVersion.PY3_10
 

generators/typescript/sdk/client-class-generator/src/websocket/GeneratedDefaultWebsocketImplementation.ts

@@ -42,6 +42,7 @@ export class GeneratedDefaultWebsocketImplementation implements GeneratedWebsock
     private static readonly HEADERS_PROPERTY_NAME = "headers";
     private static readonly HEADERS_VARIABLE_NAME = "_headers";
 
+    private static readonly PROTOCOLS_PROPERTY_NAME = "protocols";
     private static readonly RECONNECT_ATTEMPTS_PROPERTY_NAME = "reconnectAttempts";
     private static readonly CONNECTION_TIMEOUT_PROPERTY_NAME = "connectionTimeoutInSeconds";
     private static readonly ABORT_SIGNAL_PROPERTY_NAME = "abortSignal";
@@ -188,6 +189,19 @@ export class GeneratedDefaultWebsocketImplementation implements GeneratedWebsock
                         hasQuestionToken: context.type.isOptional(header.valueType)
                     };
                 }),
+                {
+                    name: GeneratedDefaultWebsocketImplementation.PROTOCOLS_PROPERTY_NAME,
+                    type: getTextOfTsNode(
+                        ts.factory.createUnionTypeNode([
+                            ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword),
+                            ts.factory.createArrayTypeNode(
+                                ts.factory.createKeywordTypeNode(ts.SyntaxKind.StringKeyword)
+                            )
+                        ])
+                    ),
+                    hasQuestionToken: true,
+                    docs: ["WebSocket subprotocols to use for the connection."]
+                },
                 {
                     name: GeneratedDefaultWebsocketImplementation.ADDITIONAL_QUERY_PARAMETERS_PROPERTY_NAME,
                     type: getTextOfTsNode(
@@ -302,6 +316,15 @@ export class GeneratedDefaultWebsocketImplementation implements GeneratedWebsock
             );
         }
 
+        // Add protocols binding
+        bindingElements.push(
+            ts.factory.createBindingElement(
+                undefined,
+                undefined,
+                ts.factory.createIdentifier(GeneratedDefaultWebsocketImplementation.PROTOCOLS_PROPERTY_NAME)
+            )
+        );
+
         // Add additional query parameters binding
         bindingElements.push(
             ts.factory.createBindingElement(
@@ -534,7 +557,11 @@ export class GeneratedDefaultWebsocketImplementation implements GeneratedWebsock
 
         return context.coreUtilities.websocket.ReconnectingWebSocket._connect({
             url: context.coreUtilities.urlUtils.join._invoke([baseUrl, url]),
-            protocols: ts.factory.createArrayLiteralExpression([]),
+            protocols: ts.factory.createBinaryExpression(
+                ts.factory.createIdentifier(GeneratedDefaultWebsocketImplementation.PROTOCOLS_PROPERTY_NAME),
+                ts.factory.createToken(ts.SyntaxKind.QuestionQuestionToken),
+                ts.factory.createArrayLiteralExpression([])
+            ),
             options: ts.factory.createObjectLiteralExpression([
                 ts.factory.createPropertyAssignment(
                     "debug",

generators/typescript/sdk/versions.yml

@@ -1,4 +1,16 @@
 # yaml-language-server: $schema=../../../fern-versions-yml.schema.json
+- version: 3.57.0
+  changelogEntry:
+    - summary: |
+        Expose an optional `protocols` field on `RealtimeClient.ConnectArgs` for WebSocket
+        subprotocol negotiation. The `ReconnectingWebSocket` constructor already accepted a
+        `protocols` parameter but it was hardcoded to an empty array. Browser callers can now
+        authenticate via subprotocols (e.g. `xai-client-secret.<token>`) where custom headers
+        are forbidden by the browser security model.
+      type: feat
+  createdAt: "2026-03-16"
+  irVersion: 65
+
 - version: 3.56.4
   changelogEntry:
     - summary: |

packages/cli/api-importers/openapi-to-ir/src/3.1/paths/RequestBodyConverter.ts

@@ -418,7 +418,9 @@ export class RequestBodyConverter extends Converters.AbstractConverters.Abstract
                     contentType,
                     docs: undefined,
                     name: this.context.casingsGenerator.generateName(
-                        isStreaming ? `${this.schemaId}_streaming` : this.schemaId
+                        isStreaming
+                            ? (this.streamingExtension?.streamRequestName ?? `${this.schemaId}_streaming`)
+                            : this.schemaId
                     ),
                     extendedProperties: requestBodyTypeShape.extendedProperties,
                     extends: requestBodyTypeShape.extends,

packages/cli/api-importers/openapi-to-ir/src/extensions/x-fern-streaming.ts

@@ -8,6 +8,7 @@ const StreamingExtensionObjectSchema = z.object({
     "stream-condition": z.string().optional(),
     format: z.enum(["sse", "json"]).optional(),
     "stream-description": z.string().optional(),
+    "stream-request-name": z.string().optional(),
     "response-stream": z.any(),
     response: z.any(),
     terminator: z.string().optional()
@@ -27,6 +28,7 @@ type StreamConditionEndpoint = {
     terminator: string | undefined;
     streamDescription: string | undefined;
     streamConditionProperty: string;
+    streamRequestName: string | undefined;
     responseStream: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject;
     response: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject;
 };
@@ -88,6 +90,7 @@ export class FernStreamingExtension extends AbstractExtension<FernStreamingExten
                 result.data["stream-condition"],
                 REQUEST_PREFIX
             ),
+            streamRequestName: result.data["stream-request-name"],
             responseStream: result.data["response-stream"],
             response: result.data.response
         };