chore: update comments

PiperOrigin-RevId: 888423404

Author: hkt74

google/genai/_interactions/types/content.py

@@ -51,18 +51,18 @@
         VideoContent,
         ThoughtContent,
         FunctionCallContent,
-        FunctionResultContent,
         CodeExecutionCallContent,
-        CodeExecutionResultContent,
         URLContextCallContent,
-        URLContextResultContent,
+        MCPServerToolCallContent,
         GoogleSearchCallContent,
+        FileSearchCallContent,
+        GoogleMapsCallContent,
+        FunctionResultContent,
+        CodeExecutionResultContent,
+        URLContextResultContent,
         GoogleSearchResultContent,
-        MCPServerToolCallContent,
         MCPServerToolResultContent,
-        FileSearchCallContent,
         FileSearchResultContent,
-        GoogleMapsCallContent,
         GoogleMapsResultContent,
     ],
     PropertyInfo(discriminator="type"),

google/genai/_interactions/types/content_delta.py

@@ -43,24 +43,20 @@
     "DeltaThoughtSummaryContent",
     "DeltaThoughtSignature",
     "DeltaFunctionCall",
-    "DeltaFunctionResult",
-    "DeltaFunctionResultResult",
-    "DeltaFunctionResultResultItems",
-    "DeltaFunctionResultResultItemsItem",
     "DeltaCodeExecutionCall",
-    "DeltaCodeExecutionResult",
     "DeltaURLContextCall",
-    "DeltaURLContextResult",
     "DeltaGoogleSearchCall",
-    "DeltaGoogleSearchResult",
     "DeltaMCPServerToolCall",
-    "DeltaMCPServerToolResult",
-    "DeltaMCPServerToolResultResult",
-    "DeltaMCPServerToolResultResultItems",
-    "DeltaMCPServerToolResultResultItemsItem",
     "DeltaFileSearchCall",
-    "DeltaFileSearchResult",
     "DeltaGoogleMapsCall",
+    "DeltaFunctionResult",
+    "DeltaFunctionResultResultFunctionResultSubcontentList",
+    "DeltaCodeExecutionResult",
+    "DeltaURLContextResult",
+    "DeltaGoogleSearchResult",
+    "DeltaMCPServerToolResult",
+    "DeltaMCPServerToolResultResultFunctionResultSubcontentList",
+    "DeltaFileSearchResult",
     "DeltaGoogleMapsResult",
 ]
 
@@ -165,146 +161,157 @@ class DeltaFunctionCall(BaseModel):
     """A signature hash for backend validation."""
 
 
-DeltaFunctionResultResultItemsItem: TypeAlias = Union[TextContent, ImageContent]
+class DeltaCodeExecutionCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
 
+    arguments: CodeExecutionCallArguments
+    """The arguments to pass to the code execution."""
 
-class DeltaFunctionResultResultItems(BaseModel):
-    items: Optional[List[DeltaFunctionResultResultItemsItem]] = None
+    type: Literal["code_execution_call"]
 
+    signature: Optional[str] = None
+    """A signature hash for backend validation."""
 
-DeltaFunctionResultResult: TypeAlias = Union[DeltaFunctionResultResultItems, str, object]
 
+class DeltaURLContextCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
 
-class DeltaFunctionResult(BaseModel):
-    call_id: str
-    """ID to match the ID from the function call block."""
+    arguments: URLContextCallArguments
+    """The arguments to pass to the URL context."""
 
-    result: DeltaFunctionResultResult
-    """Tool call result delta."""
+    type: Literal["url_context_call"]
 
-    type: Literal["function_result"]
+    signature: Optional[str] = None
+    """A signature hash for backend validation."""
 
-    is_error: Optional[bool] = None
 
-    name: Optional[str] = None
+class DeltaGoogleSearchCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
+
+    arguments: GoogleSearchCallArguments
+    """The arguments to pass to Google Search."""
+
+    type: Literal["google_search_call"]
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-class DeltaCodeExecutionCall(BaseModel):
+class DeltaMCPServerToolCall(BaseModel):
     id: str
     """A unique ID for this specific tool call."""
 
-    arguments: CodeExecutionCallArguments
-    """The arguments to pass to the code execution."""
+    arguments: Dict[str, object]
 
-    type: Literal["code_execution_call"]
+    name: str
 
-    signature: Optional[str] = None
-    """A signature hash for backend validation."""
+    server_name: str
 
+    type: Literal["mcp_server_tool_call"]
 
-class DeltaCodeExecutionResult(BaseModel):
-    call_id: str
-    """ID to match the ID from the function call block."""
+    signature: Optional[str] = None
+    """A signature hash for backend validation."""
 
-    result: str
 
-    type: Literal["code_execution_result"]
+class DeltaFileSearchCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
 
-    is_error: Optional[bool] = None
+    type: Literal["file_search_call"]
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-class DeltaURLContextCall(BaseModel):
+class DeltaGoogleMapsCall(BaseModel):
     id: str
     """A unique ID for this specific tool call."""
 
-    arguments: URLContextCallArguments
-    """The arguments to pass to the URL context."""
+    type: Literal["google_maps_call"]
 
-    type: Literal["url_context_call"]
+    arguments: Optional[GoogleMapsCallArguments] = None
+    """The arguments to pass to the Google Maps tool."""
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-class DeltaURLContextResult(BaseModel):
+DeltaFunctionResultResultFunctionResultSubcontentList: TypeAlias = Annotated[
+    Union[TextContent, ImageContent], PropertyInfo(discriminator="type")
+]
+
+
+class DeltaFunctionResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
 
-    result: List[URLContextResult]
+    result: Union[List[DeltaFunctionResultResultFunctionResultSubcontentList], str, object]
 
-    type: Literal["url_context_result"]
+    type: Literal["function_result"]
 
     is_error: Optional[bool] = None
 
+    name: Optional[str] = None
+
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-class DeltaGoogleSearchCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
+class DeltaCodeExecutionResult(BaseModel):
+    call_id: str
+    """ID to match the ID from the function call block."""
 
-    arguments: GoogleSearchCallArguments
-    """The arguments to pass to Google Search."""
+    result: str
 
-    type: Literal["google_search_call"]
+    type: Literal["code_execution_result"]
+
+    is_error: Optional[bool] = None
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-class DeltaGoogleSearchResult(BaseModel):
+class DeltaURLContextResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
 
-    result: List[GoogleSearchResult]
+    result: List[URLContextResult]
 
-    type: Literal["google_search_result"]
+    type: Literal["url_context_result"]
 
     is_error: Optional[bool] = None
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-class DeltaMCPServerToolCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
-
-    arguments: Dict[str, object]
+class DeltaGoogleSearchResult(BaseModel):
+    call_id: str
+    """ID to match the ID from the function call block."""
 
-    name: str
+    result: List[GoogleSearchResult]
 
-    server_name: str
+    type: Literal["google_search_result"]
 
-    type: Literal["mcp_server_tool_call"]
+    is_error: Optional[bool] = None
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
 
 
-DeltaMCPServerToolResultResultItemsItem: TypeAlias = Union[TextContent, ImageContent]
-
-
-class DeltaMCPServerToolResultResultItems(BaseModel):
-    items: Optional[List[DeltaMCPServerToolResultResultItemsItem]] = None
-
-
-DeltaMCPServerToolResultResult: TypeAlias = Union[DeltaMCPServerToolResultResultItems, str, object]
+DeltaMCPServerToolResultResultFunctionResultSubcontentList: TypeAlias = Annotated[
+    Union[TextContent, ImageContent], PropertyInfo(discriminator="type")
+]
 
 
 class DeltaMCPServerToolResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
 
-    result: DeltaMCPServerToolResultResult
-    """Tool call result delta."""
+    result: Union[List[DeltaMCPServerToolResultResultFunctionResultSubcontentList], str, object]
 
     type: Literal["mcp_server_tool_result"]
 
@@ -316,16 +323,6 @@ class DeltaMCPServerToolResult(BaseModel):
     """A signature hash for backend validation."""
 
 
-class DeltaFileSearchCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
-
-    type: Literal["file_search_call"]
-
-    signature: Optional[str] = None
-    """A signature hash for backend validation."""
-
-
 class DeltaFileSearchResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
@@ -338,19 +335,6 @@ class DeltaFileSearchResult(BaseModel):
     """A signature hash for backend validation."""
 
 
-class DeltaGoogleMapsCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
-
-    type: Literal["google_maps_call"]
-
-    arguments: Optional[GoogleMapsCallArguments] = None
-    """The arguments to pass to the Google Maps tool."""
-
-    signature: Optional[str] = None
-    """A signature hash for backend validation."""
-
-
 class DeltaGoogleMapsResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
@@ -374,18 +358,18 @@ class DeltaGoogleMapsResult(BaseModel):
         DeltaThoughtSummary,
         DeltaThoughtSignature,
         DeltaFunctionCall,
-        DeltaFunctionResult,
         DeltaCodeExecutionCall,
-        DeltaCodeExecutionResult,
         DeltaURLContextCall,
-        DeltaURLContextResult,
         DeltaGoogleSearchCall,
-        DeltaGoogleSearchResult,
         DeltaMCPServerToolCall,
-        DeltaMCPServerToolResult,
         DeltaFileSearchCall,
-        DeltaFileSearchResult,
         DeltaGoogleMapsCall,
+        DeltaFunctionResult,
+        DeltaCodeExecutionResult,
+        DeltaURLContextResult,
+        DeltaGoogleSearchResult,
+        DeltaMCPServerToolResult,
+        DeltaFileSearchResult,
         DeltaGoogleMapsResult,
     ],
     PropertyInfo(discriminator="type"),
@@ -394,12 +378,14 @@ class DeltaGoogleMapsResult(BaseModel):
 
 class ContentDelta(BaseModel):
     delta: Delta
+    """The delta content data for a content block."""
 
     event_type: Literal["content.delta"]
 
     index: int
 
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from this event.
+    The event_id token to be used to resume the interaction stream, from
+    this event.
     """

google/genai/_interactions/types/content_param.py

@@ -51,17 +51,17 @@
     VideoContentParam,
     ThoughtContentParam,
     FunctionCallContentParam,
-    FunctionResultContentParam,
     CodeExecutionCallContentParam,
-    CodeExecutionResultContentParam,
     URLContextCallContentParam,
-    URLContextResultContentParam,
+    MCPServerToolCallContentParam,
     GoogleSearchCallContentParam,
+    FileSearchCallContentParam,
+    GoogleMapsCallContentParam,
+    FunctionResultContentParam,
+    CodeExecutionResultContentParam,
+    URLContextResultContentParam,
     GoogleSearchResultContentParam,
-    MCPServerToolCallContentParam,
     MCPServerToolResultContentParam,
-    FileSearchCallContentParam,
     FileSearchResultContentParam,
-    GoogleMapsCallContentParam,
     GoogleMapsResultContentParam,
 ]

google/genai/_interactions/types/content_start.py

@@ -34,5 +34,6 @@ class ContentStart(BaseModel):
 
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from this event.
+    The event_id token to be used to resume the interaction stream, from
+    this event.
     """

google/genai/_interactions/types/content_stop.py

@@ -30,5 +30,6 @@ class ContentStop(BaseModel):
 
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from this event.
+    The event_id token to be used to resume the interaction stream, from
+    this event.
     """

google/genai/_interactions/types/error_event.py

@@ -41,5 +41,6 @@ class ErrorEvent(BaseModel):
 
     event_id: Optional[str] = None
     """
-    The event_id token to be used to resume the interaction stream, from this event.
+    The event_id token to be used to resume the interaction stream, from
+    this event.
     """