feat(python): preserve unknown fields and open-union variants in Interactions models

Enable `preserveUnknownFields` and `modelSerializationMethods` in the Python SDK. Unknown fields are kept at every nesting level, in responses and in requests: unknown request fields are forwarded instead of silently dropped, so unsupported options such as `transcription_config.diarization` are rejected by the API rather than ignored (#3162), and fields missing from the SDK schema reach the API. Unknown steps, content blocks and annotations round-trip as the payload the server sent, including stateless multi-turn history sent back as SDK objects or as stored dicts; known variants with invalid payloads still raise locally.

FUTURE_COPYBARA_INTEGRATE_REVIEW=#3209 from googleapis:release-please--branches--main 39c95f2
PiperOrigin-RevId: 1009673588

Author: google-genai-bot

.github/workflows/mypy.yml

@@ -10,7 +10,7 @@ on:
       - main
 
 env:
-  SPEAKEASY_VERSION: v2.952.4
+  SPEAKEASY_VERSION: v2.955.0
 
 jobs:
   mypy:

google/genai/_gaos/credentials.py

@@ -237,7 +237,7 @@ def create(
         :param refresh_token: Required. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Required. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -268,7 +268,7 @@ def create(
             Accepts either a single location (e.g. \"header\") or an array of locations.
         :param trusted_domains: Optional. List of domains allowed to receive this environment variable
             value in HTTP requests.
-        :param type:
+        :param type_:
         :param value: Required. Input only. Secret value of the environment variable. Write-only; never
             returned in responses.
         :param extra_headers: Additional headers to set or replace on requests.
@@ -301,7 +301,7 @@ def create(
         :param prefix: Optional. Prefix to prepend to the token. Defaults to 'Bearer'. Set to ''
             for no prefix.
         :param token: Required. Input only. The static bearer token. Write-only; never returned in responses.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -331,7 +331,7 @@ def create(
         :param refresh_token: Required. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Required. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Required. Locations where the environment variable can be injected in
             outgoing HTTP requests. Must contain at least one location.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -372,7 +372,7 @@ def create(
         :param refresh_token: Required. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Required. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Required. Locations where the environment variable can be injected in
             outgoing HTTP requests. Must contain at least one location.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -991,7 +991,7 @@ def update(
         :param refresh_token: Optional. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Optional. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -1023,7 +1023,7 @@ def update(
             Accepts either a single location (e.g. \"header\") or an array of locations.
         :param trusted_domains: Optional. List of domains allowed to receive this environment variable
             value in HTTP requests.
-        :param type:
+        :param type_:
         :param value: Optional. Input only. Secret value of the environment variable. Write-only; never
             returned in responses.
         :param extra_headers: Additional headers to set or replace on requests.
@@ -1057,7 +1057,7 @@ def update(
         :param prefix: Optional. Prefix to prepend to the token. Defaults to 'Bearer'. Set to ''
             for no prefix.
         :param token: Optional. Input only. The static bearer token. Write-only; never returned in responses.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -1089,7 +1089,7 @@ def update(
         :param refresh_token: Optional. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Optional. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Optional. Locations where the environment variable can be injected in
             outgoing HTTP requests.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -1132,7 +1132,7 @@ def update(
         :param refresh_token: Optional. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Optional. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Optional. Locations where the environment variable can be injected in
             outgoing HTTP requests.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -1650,7 +1650,7 @@ async def create(
         :param refresh_token: Required. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Required. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -1681,7 +1681,7 @@ async def create(
             Accepts either a single location (e.g. \"header\") or an array of locations.
         :param trusted_domains: Optional. List of domains allowed to receive this environment variable
             value in HTTP requests.
-        :param type:
+        :param type_:
         :param value: Required. Input only. Secret value of the environment variable. Write-only; never
             returned in responses.
         :param extra_headers: Additional headers to set or replace on requests.
@@ -1714,7 +1714,7 @@ async def create(
         :param prefix: Optional. Prefix to prepend to the token. Defaults to 'Bearer'. Set to ''
             for no prefix.
         :param token: Required. Input only. The static bearer token. Write-only; never returned in responses.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -1744,7 +1744,7 @@ async def create(
         :param refresh_token: Required. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Required. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Required. Locations where the environment variable can be injected in
             outgoing HTTP requests. Must contain at least one location.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -1785,7 +1785,7 @@ async def create(
         :param refresh_token: Required. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Required. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Required. Locations where the environment variable can be injected in
             outgoing HTTP requests. Must contain at least one location.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -2413,7 +2413,7 @@ async def update(
         :param refresh_token: Optional. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Optional. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -2445,7 +2445,7 @@ async def update(
             Accepts either a single location (e.g. \"header\") or an array of locations.
         :param trusted_domains: Optional. List of domains allowed to receive this environment variable
             value in HTTP requests.
-        :param type:
+        :param type_:
         :param value: Optional. Input only. Secret value of the environment variable. Write-only; never
             returned in responses.
         :param extra_headers: Additional headers to set or replace on requests.
@@ -2479,7 +2479,7 @@ async def update(
         :param prefix: Optional. Prefix to prepend to the token. Defaults to 'Bearer'. Set to ''
             for no prefix.
         :param token: Optional. Input only. The static bearer token. Write-only; never returned in responses.
-        :param type:
+        :param type_:
         :param extra_headers: Additional headers to set or replace on requests.
         :param extra_query: Additional query parameters to append to requests.
         :param extra_body: Additional JSON object fields to merge into request bodies.
@@ -2511,7 +2511,7 @@ async def update(
         :param refresh_token: Optional. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Optional. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Optional. Locations where the environment variable can be injected in
             outgoing HTTP requests.
             Accepts either a single location (e.g. \"header\") or an array of locations.
@@ -2554,7 +2554,7 @@ async def update(
         :param refresh_token: Optional. Input only. OAuth2 refresh token. Write-only; never returned in responses.
         :param scopes: Optional. List of OAuth2 scopes.
         :param token_url: Optional. OAuth2 token endpoint URL for refreshing access tokens.
-        :param type:
+        :param type_:
         :param injection_location: Optional. Locations where the environment variable can be injected in
             outgoing HTTP requests.
             Accepts either a single location (e.g. \"header\") or an array of locations.

google/genai/_gaos/models/cancelinteractionbyid.py

@@ -18,7 +18,12 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from ..types import BaseModel, UNSET_SENTINEL
+from ..types import BaseModel, UNSET_SENTINEL, current_exclude_none, serialize_with_info
+from ..types.basemodel import (
+    current_by_alias,
+    current_filtered_dump,
+    current_serialization_methods_dump,
+)
 from ..utils import FieldMetadata, PathParamMetadata
 import pydantic
 from pydantic import model_serializer
@@ -39,18 +44,35 @@ class CancelInteractionByIDGlobals(BaseModel):
     r"""API version for request routing."""
 
     @model_serializer(mode="wrap")
+    def _serialize_model_with_info(self, handler, info):
+        return serialize_with_info(self.serialize_model, handler, info)
+
     def serialize_model(self, handler):
         optional_fields = set(["api_version"])
+        exclude_none = current_exclude_none()
+        by_alias = current_by_alias()
+        use_field_names = by_alias is False
+        serialization_methods_dump = current_serialization_methods_dump()
+        skip_filtered = (
+            serialization_methods_dump
+            or exclude_none is False
+            or current_filtered_dump()
+        )
         serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
-            k = f.alias or n
-            val = serialized.get(k, serialized.get(n))
+            k = f.alias if f.alias is not None else n
+            key = k if by_alias or k in serialized else n
+            if key not in serialized and skip_filtered:
+                continue
+            val = serialized.pop(key, None)
 
             if val != UNSET_SENTINEL:
                 if val is not None or k not in optional_fields:
-                    m[k] = val
+                    m[n if use_field_names else k] = val
+        for k, v in serialized.items():
+            m[k] = v
 
         return m
 
@@ -77,17 +99,34 @@ class CancelInteractionByIDRequest(BaseModel):
     r"""API version for request routing."""
 
     @model_serializer(mode="wrap")
+    def _serialize_model_with_info(self, handler, info):
+        return serialize_with_info(self.serialize_model, handler, info)
+
     def serialize_model(self, handler):
         optional_fields = set(["api_version"])
+        exclude_none = current_exclude_none()
+        by_alias = current_by_alias()
+        use_field_names = by_alias is False
+        serialization_methods_dump = current_serialization_methods_dump()
+        skip_filtered = (
+            serialization_methods_dump
+            or exclude_none is False
+            or current_filtered_dump()
+        )
         serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
-            k = f.alias or n
-            val = serialized.get(k, serialized.get(n))
+            k = f.alias if f.alias is not None else n
+            key = k if by_alias or k in serialized else n
+            if key not in serialized and skip_filtered:
+                continue
+            val = serialized.pop(key, None)
 
             if val != UNSET_SENTINEL:
                 if val is not None or k not in optional_fields:
-                    m[k] = val
+                    m[n if use_field_names else k] = val
+        for k, v in serialized.items():
+            m[k] = v
 
         return m

google/genai/_gaos/models/createagent.py

@@ -18,8 +18,13 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from ..types import BaseModel, UNSET_SENTINEL
+from ..types import BaseModel, UNSET_SENTINEL, current_exclude_none, serialize_with_info
 from ..types.agents import agent as agents_agent
+from ..types.basemodel import (
+    current_by_alias,
+    current_filtered_dump,
+    current_serialization_methods_dump,
+)
 from ..utils import FieldMetadata, PathParamMetadata, RequestMetadata
 from pydantic import model_serializer
 from typing import Optional
@@ -39,18 +44,35 @@ class CreateAgentGlobals(BaseModel):
     r"""API version for request routing."""
 
     @model_serializer(mode="wrap")
+    def _serialize_model_with_info(self, handler, info):
+        return serialize_with_info(self.serialize_model, handler, info)
+
     def serialize_model(self, handler):
         optional_fields = set(["api_version"])
+        exclude_none = current_exclude_none()
+        by_alias = current_by_alias()
+        use_field_names = by_alias is False
+        serialization_methods_dump = current_serialization_methods_dump()
+        skip_filtered = (
+            serialization_methods_dump
+            or exclude_none is False
+            or current_filtered_dump()
+        )
         serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
-            k = f.alias or n
-            val = serialized.get(k, serialized.get(n))
+            k = f.alias if f.alias is not None else n
+            key = k if by_alias or k in serialized else n
+            if key not in serialized and skip_filtered:
+                continue
+            val = serialized.pop(key, None)
 
             if val != UNSET_SENTINEL:
                 if val is not None or k not in optional_fields:
-                    m[k] = val
+                    m[n if use_field_names else k] = val
+        for k, v in serialized.items():
+            m[k] = v
 
         return m
 
@@ -76,17 +98,34 @@ class CreateAgentRequest(BaseModel):
     r"""API version for request routing."""
 
     @model_serializer(mode="wrap")
+    def _serialize_model_with_info(self, handler, info):
+        return serialize_with_info(self.serialize_model, handler, info)
+
     def serialize_model(self, handler):
         optional_fields = set(["api_version"])
+        exclude_none = current_exclude_none()
+        by_alias = current_by_alias()
+        use_field_names = by_alias is False
+        serialization_methods_dump = current_serialization_methods_dump()
+        skip_filtered = (
+            serialization_methods_dump
+            or exclude_none is False
+            or current_filtered_dump()
+        )
         serialized = handler(self)
         m = {}
 
         for n, f in type(self).model_fields.items():
-            k = f.alias or n
-            val = serialized.get(k, serialized.get(n))
+            k = f.alias if f.alias is not None else n
+            key = k if by_alias or k in serialized else n
+            if key not in serialized and skip_filtered:
+                continue
+            val = serialized.pop(key, None)
 
             if val != UNSET_SENTINEL:
                 if val is not None or k not in optional_fields:
-                    m[k] = val
+                    m[n if use_field_names else k] = val
+        for k, v in serialized.items():
+            m[k] = v
 
         return m