chore: update comment

PiperOrigin-RevId: 879203048

Author: hkt74

google/genai/_interactions/types/code_execution_call_content.py

@@ -30,6 +30,6 @@ class CodeExecutionCallContent(BaseModel):
     """A unique ID for this specific tool call."""
 
     arguments: CodeExecutionCallArguments
-    """The arguments to pass to the code execution."""
+    """Required. The arguments to pass to the code execution."""
 
     type: Literal["code_execution_call"]

google/genai/_interactions/types/code_execution_call_content_param.py

@@ -31,6 +31,6 @@ class CodeExecutionCallContentParam(TypedDict, total=False):
     """A unique ID for this specific tool call."""
 
     arguments: Required[CodeExecutionCallArgumentsParam]
-    """The arguments to pass to the code execution."""
+    """Required. The arguments to pass to the code execution."""
 
     type: Required[Literal["code_execution_call"]]

google/genai/_interactions/types/code_execution_result_content.py

@@ -30,7 +30,7 @@ class CodeExecutionResultContent(BaseModel):
     """ID to match the ID from the code execution call block."""
 
     result: str
-    """The output of the code execution."""
+    """Required. The output of the code execution."""
 
     type: Literal["code_execution_result"]
 

google/genai/_interactions/types/code_execution_result_content_param.py

@@ -29,7 +29,7 @@ class CodeExecutionResultContentParam(TypedDict, total=False):
     """ID to match the ID from the code execution call block."""
 
     result: Required[str]
-    """The output of the code execution."""
+    """Required. The output of the code execution."""
 
     type: Required[Literal["code_execution_result"]]
 

google/genai/_interactions/types/content.py

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

google/genai/_interactions/types/content_delta.py

@@ -41,22 +41,18 @@
     "DeltaThoughtSummaryContent",
     "DeltaThoughtSignature",
     "DeltaFunctionCall",
-    "DeltaFunctionResult",
-    "DeltaFunctionResultResult",
-    "DeltaFunctionResultResultItems",
-    "DeltaFunctionResultResultItemsItem",
     "DeltaCodeExecutionCall",
-    "DeltaCodeExecutionResult",
     "DeltaURLContextCall",
-    "DeltaURLContextResult",
     "DeltaGoogleSearchCall",
-    "DeltaGoogleSearchResult",
     "DeltaMCPServerToolCall",
-    "DeltaMCPServerToolResult",
-    "DeltaMCPServerToolResultResult",
-    "DeltaMCPServerToolResultResultItems",
-    "DeltaMCPServerToolResultResultItemsItem",
     "DeltaFileSearchCall",
+    "DeltaFunctionResult",
+    "DeltaFunctionResultResultFunctionResultSubcontentList",
+    "DeltaCodeExecutionResult",
+    "DeltaURLContextResult",
+    "DeltaGoogleSearchResult",
+    "DeltaMCPServerToolResult",
+    "DeltaMCPServerToolResultResultFunctionResultSubcontentList",
     "DeltaFileSearchResult",
     "DeltaFileSearchResultResult",
 ]
@@ -157,22 +153,66 @@ class DeltaFunctionCall(BaseModel):
     type: Literal["function_call"]
 
 
-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."""
+
+    type: Literal["code_execution_call"]
+
+
+class DeltaURLContextCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
+
+    arguments: URLContextCallArguments
+    """The arguments to pass to the URL context."""
+
+    type: Literal["url_context_call"]
+
+
+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"]
+
 
+class DeltaMCPServerToolCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
+
+    arguments: Dict[str, object]
 
-class DeltaFunctionResultResultItems(BaseModel):
-    items: Optional[List[DeltaFunctionResultResultItemsItem]] = None
+    name: str
 
+    server_name: str
 
-DeltaFunctionResultResult: TypeAlias = Union[DeltaFunctionResultResultItems, str, object]
+    type: Literal["mcp_server_tool_call"]
+
+
+class DeltaFileSearchCall(BaseModel):
+    id: str
+    """A unique ID for this specific tool call."""
+
+    type: Literal["file_search_call"]
+
+
+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: DeltaFunctionResultResult
-    """Tool call result delta."""
+    result: Union[List[DeltaFunctionResultResultFunctionResultSubcontentList], str, object]
 
     type: Literal["function_result"]
 
@@ -184,16 +224,6 @@ class DeltaFunctionResult(BaseModel):
     """A signature hash for backend validation."""
 
 
-class DeltaCodeExecutionCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
-
-    arguments: CodeExecutionCallArguments
-    """The arguments to pass to the code execution."""
-
-    type: Literal["code_execution_call"]
-
-
 class DeltaCodeExecutionResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
@@ -208,16 +238,6 @@ class DeltaCodeExecutionResult(BaseModel):
     """A signature hash for backend validation."""
 
 
-class DeltaURLContextCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
-
-    arguments: URLContextCallArguments
-    """The arguments to pass to the URL context."""
-
-    type: Literal["url_context_call"]
-
-
 class DeltaURLContextResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
@@ -232,16 +252,6 @@ class DeltaURLContextResult(BaseModel):
     """A signature hash for backend validation."""
 
 
-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"]
-
-
 class DeltaGoogleSearchResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
@@ -256,35 +266,16 @@ class DeltaGoogleSearchResult(BaseModel):
     """A signature hash for backend validation."""
 
 
-class DeltaMCPServerToolCall(BaseModel):
-    id: str
-    """A unique ID for this specific tool call."""
-
-    arguments: Dict[str, object]
-
-    name: str
-
-    server_name: str
-
-    type: Literal["mcp_server_tool_call"]
-
-
-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"]
 
@@ -296,13 +287,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"]
-
-
 class DeltaFileSearchResultResult(BaseModel):
     """The result of the File Search."""
 
@@ -320,9 +304,9 @@ class DeltaFileSearchResult(BaseModel):
     call_id: str
     """ID to match the ID from the function call block."""
 
-    type: Literal["file_search_result"]
+    result: List[DeltaFileSearchResultResult]
 
-    result: Optional[List[DeltaFileSearchResultResult]] = None
+    type: Literal["file_search_result"]
 
     signature: Optional[str] = None
     """A signature hash for backend validation."""
@@ -338,16 +322,16 @@ class DeltaFileSearchResult(BaseModel):
         DeltaThoughtSummary,
         DeltaThoughtSignature,
         DeltaFunctionCall,
-        DeltaFunctionResult,
         DeltaCodeExecutionCall,
-        DeltaCodeExecutionResult,
         DeltaURLContextCall,
-        DeltaURLContextResult,
         DeltaGoogleSearchCall,
-        DeltaGoogleSearchResult,
         DeltaMCPServerToolCall,
-        DeltaMCPServerToolResult,
         DeltaFileSearchCall,
+        DeltaFunctionResult,
+        DeltaCodeExecutionResult,
+        DeltaURLContextResult,
+        DeltaGoogleSearchResult,
+        DeltaMCPServerToolResult,
         DeltaFileSearchResult,
     ],
     PropertyInfo(discriminator="type"),
@@ -356,12 +340,14 @@ class DeltaFileSearchResult(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

@@ -49,15 +49,15 @@
     VideoContentParam,
     ThoughtContentParam,
     FunctionCallContentParam,
-    FunctionResultContentParam,
     CodeExecutionCallContentParam,
-    CodeExecutionResultContentParam,
     URLContextCallContentParam,
-    URLContextResultContentParam,
+    MCPServerToolCallContentParam,
     GoogleSearchCallContentParam,
+    FileSearchCallContentParam,
+    FunctionResultContentParam,
+    CodeExecutionResultContentParam,
+    URLContextResultContentParam,
     GoogleSearchResultContentParam,
-    MCPServerToolCallContentParam,
     MCPServerToolResultContentParam,
-    FileSearchCallContentParam,
     FileSearchResultContentParam,
 ]

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.
     """