google-genai 1.53.0__py3-none-any.whl → 1.55.0__py3-none-any.whl

google/genai/_interactions/types/__init__.py

@@ -0,0 +1,107 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .tool import Tool as Tool
+from .turn import Turn as Turn
+from .model import Model as Model
+from .usage import Usage as Usage
+from .function import Function as Function
+from .annotation import Annotation as Annotation
+from .tool_param import ToolParam as ToolParam
+from .turn_param import TurnParam as TurnParam
+from .error_event import ErrorEvent as ErrorEvent
+from .interaction import Interaction as Interaction
+from .model_param import ModelParam as ModelParam
+from .tool_choice import ToolChoice as ToolChoice
+from .usage_param import UsageParam as UsageParam
+from .content_stop import ContentStop as ContentStop
+from .text_content import TextContent as TextContent
+from .allowed_tools import AllowedTools as AllowedTools
+from .audio_content import AudioContent as AudioContent
+from .content_delta import ContentDelta as ContentDelta
+from .content_start import ContentStart as ContentStart
+from .image_content import ImageContent as ImageContent
+from .speech_config import SpeechConfig as SpeechConfig
+from .video_content import VideoContent as VideoContent
+from .function_param import FunctionParam as FunctionParam
+from .thinking_level import ThinkingLevel as ThinkingLevel
+from .audio_mime_type import AudioMimeType as AudioMimeType
+from .image_mime_type import ImageMimeType as ImageMimeType
+from .thought_content import ThoughtContent as ThoughtContent
+from .video_mime_type import VideoMimeType as VideoMimeType
+from .annotation_param import AnnotationParam as AnnotationParam
+from .document_content import DocumentContent as DocumentContent
+from .tool_choice_type import ToolChoiceType as ToolChoiceType
+from .generation_config import GenerationConfig as GenerationConfig
+from .interaction_event import InteractionEvent as InteractionEvent
+from .tool_choice_param import ToolChoiceParam as ToolChoiceParam
+from .text_content_param import TextContentParam as TextContentParam
+from .tool_choice_config import ToolChoiceConfig as ToolChoiceConfig
+from .url_context_result import URLContextResult as URLContextResult
+from .allowed_tools_param import AllowedToolsParam as AllowedToolsParam
+from .audio_content_param import AudioContentParam as AudioContentParam
+from .image_content_param import ImageContentParam as ImageContentParam
+from .speech_config_param import SpeechConfigParam as SpeechConfigParam
+from .video_content_param import VideoContentParam as VideoContentParam
+from .dynamic_agent_config import DynamicAgentConfig as DynamicAgentConfig
+from .google_search_result import GoogleSearchResult as GoogleSearchResult
+from .audio_mime_type_param import AudioMimeTypeParam as AudioMimeTypeParam
+from .function_call_content import FunctionCallContent as FunctionCallContent
+from .image_mime_type_param import ImageMimeTypeParam as ImageMimeTypeParam
+from .interaction_sse_event import InteractionSSEEvent as InteractionSSEEvent
+from .thought_content_param import ThoughtContentParam as ThoughtContentParam
+from .video_mime_type_param import VideoMimeTypeParam as VideoMimeTypeParam
+from .document_content_param import DocumentContentParam as DocumentContentParam
+from .interaction_get_params import InteractionGetParams as InteractionGetParams
+from .function_result_content import FunctionResultContent as FunctionResultContent
+from .generation_config_param import GenerationConfigParam as GenerationConfigParam
+from .tool_choice_config_param import ToolChoiceConfigParam as ToolChoiceConfigParam
+from .url_context_call_content import URLContextCallContent as URLContextCallContent
+from .url_context_result_param import URLContextResultParam as URLContextResultParam
+from .interaction_create_params import InteractionCreateParams as InteractionCreateParams
+from .interaction_status_update import InteractionStatusUpdate as InteractionStatusUpdate
+from .deep_research_agent_config import DeepResearchAgentConfig as DeepResearchAgentConfig
+from .dynamic_agent_config_param import DynamicAgentConfigParam as DynamicAgentConfigParam
+from .file_search_result_content import FileSearchResultContent as FileSearchResultContent
+from .google_search_call_content import GoogleSearchCallContent as GoogleSearchCallContent
+from .google_search_result_param import GoogleSearchResultParam as GoogleSearchResultParam
+from .url_context_call_arguments import URLContextCallArguments as URLContextCallArguments
+from .url_context_result_content import URLContextResultContent as URLContextResultContent
+from .code_execution_call_content import CodeExecutionCallContent as CodeExecutionCallContent
+from .function_call_content_param import FunctionCallContentParam as FunctionCallContentParam
+from .google_search_call_arguments import GoogleSearchCallArguments as GoogleSearchCallArguments
+from .google_search_result_content import GoogleSearchResultContent as GoogleSearchResultContent
+from .mcp_server_tool_call_content import MCPServerToolCallContent as MCPServerToolCallContent
+from .code_execution_call_arguments import CodeExecutionCallArguments as CodeExecutionCallArguments
+from .code_execution_result_content import CodeExecutionResultContent as CodeExecutionResultContent
+from .function_result_content_param import FunctionResultContentParam as FunctionResultContentParam
+from .mcp_server_tool_result_content import MCPServerToolResultContent as MCPServerToolResultContent
+from .url_context_call_content_param import URLContextCallContentParam as URLContextCallContentParam
+from .deep_research_agent_config_param import DeepResearchAgentConfigParam as DeepResearchAgentConfigParam
+from .file_search_result_content_param import FileSearchResultContentParam as FileSearchResultContentParam
+from .google_search_call_content_param import GoogleSearchCallContentParam as GoogleSearchCallContentParam
+from .url_context_call_arguments_param import URLContextCallArgumentsParam as URLContextCallArgumentsParam
+from .url_context_result_content_param import URLContextResultContentParam as URLContextResultContentParam
+from .code_execution_call_content_param import CodeExecutionCallContentParam as CodeExecutionCallContentParam
+from .google_search_call_arguments_param import GoogleSearchCallArgumentsParam as GoogleSearchCallArgumentsParam
+from .google_search_result_content_param import GoogleSearchResultContentParam as GoogleSearchResultContentParam
+from .mcp_server_tool_call_content_param import MCPServerToolCallContentParam as MCPServerToolCallContentParam
+from .code_execution_call_arguments_param import CodeExecutionCallArgumentsParam as CodeExecutionCallArgumentsParam
+from .code_execution_result_content_param import CodeExecutionResultContentParam as CodeExecutionResultContentParam
+from .mcp_server_tool_result_content_param import MCPServerToolResultContentParam as MCPServerToolResultContentParam

google/genai/_interactions/types/allowed_tools.py

@@ -0,0 +1,33 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .._models import BaseModel
+from .tool_choice_type import ToolChoiceType
+
+__all__ = ["AllowedTools"]
+
+
+class AllowedTools(BaseModel):
+    """The configuration for allowed tools."""
+
+    mode: Optional[ToolChoiceType] = None
+    """The mode of the tool choice."""
+
+    tools: Optional[List[str]] = None
+    """The names of the allowed tools."""

google/genai/_interactions/types/allowed_tools_param.py

@@ -0,0 +1,35 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+from .._types import SequenceNotStr
+from .tool_choice_type import ToolChoiceType
+
+__all__ = ["AllowedToolsParam"]
+
+
+class AllowedToolsParam(TypedDict, total=False):
+    """The configuration for allowed tools."""
+
+    mode: ToolChoiceType
+    """The mode of the tool choice."""
+
+    tools: SequenceNotStr[str]
+    """The names of the allowed tools."""

google/genai/_interactions/types/annotation.py

@@ -0,0 +1,42 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["Annotation"]
+
+
+class Annotation(BaseModel):
+    """Citation information for model-generated content."""
+
+    end_index: Optional[int] = None
+    """End of the attributed segment, exclusive."""
+
+    source: Optional[str] = None
+    """Source attributed for a portion of the text.
+
+    Could be a URL, title, or
+    other identifier.
+    """
+
+    start_index: Optional[int] = None
+    """Start of segment of the response that is attributed to this source.
+
+    Index indicates the start of the segment, measured in bytes.
+    """

google/genai/_interactions/types/annotation_param.py

@@ -0,0 +1,42 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["AnnotationParam"]
+
+
+class AnnotationParam(TypedDict, total=False):
+    """Citation information for model-generated content."""
+
+    end_index: int
+    """End of the attributed segment, exclusive."""
+
+    source: str
+    """Source attributed for a portion of the text.
+
+    Could be a URL, title, or
+    other identifier.
+    """
+
+    start_index: int
+    """Start of segment of the response that is attributed to this source.
+
+    Index indicates the start of the segment, measured in bytes.
+    """

google/genai/_interactions/types/audio_content.py

@@ -0,0 +1,38 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .audio_mime_type import AudioMimeType
+
+__all__ = ["AudioContent"]
+
+
+class AudioContent(BaseModel):
+    """An audio content block."""
+
+    type: Literal["audio"]
+    """Used as the OpenAPI type discriminator for the content oneof."""
+
+    data: Optional[str] = None
+
+    mime_type: Optional[AudioMimeType] = None
+    """The mime type of the audio."""
+
+    uri: Optional[str] = None

google/genai/_interactions/types/audio_content_param.py

@@ -0,0 +1,45 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._types import Base64FileInput
+from .._utils import PropertyInfo
+from .._models import set_pydantic_config
+from .audio_mime_type_param import AudioMimeTypeParam
+
+__all__ = ["AudioContentParam"]
+
+
+class AudioContentParam(TypedDict, total=False):
+    """An audio content block."""
+
+    type: Required[Literal["audio"]]
+    """Used as the OpenAPI type discriminator for the content oneof."""
+
+    data: Annotated[Union[str, Base64FileInput], PropertyInfo(format="base64")]
+
+    mime_type: AudioMimeTypeParam
+    """The mime type of the audio."""
+
+    uri: str
+
+
+set_pydantic_config(AudioContentParam, {"arbitrary_types_allowed": True})

google/genai/_interactions/types/audio_mime_type.py

@@ -0,0 +1,25 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["AudioMimeType"]
+
+AudioMimeType: TypeAlias = Union[
+    Literal["audio/wav", "audio/mp3", "audio/aiff", "audio/aac", "audio/ogg", "audio/flac"], str
+]

google/genai/_interactions/types/audio_mime_type_param.py

@@ -0,0 +1,27 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["AudioMimeTypeParam"]
+
+AudioMimeTypeParam: TypeAlias = Union[
+    Literal["audio/wav", "audio/mp3", "audio/aiff", "audio/aac", "audio/ogg", "audio/flac"], str
+]

google/genai/_interactions/types/code_execution_call_arguments.py

@@ -0,0 +1,33 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["CodeExecutionCallArguments"]
+
+
+class CodeExecutionCallArguments(BaseModel):
+    """The arguments to pass to the code execution."""
+
+    code: Optional[str] = None
+    """The code to be executed."""
+
+    language: Optional[Literal["python"]] = None
+    """Programming language of the `code`."""

google/genai/_interactions/types/code_execution_call_arguments_param.py

@@ -0,0 +1,32 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["CodeExecutionCallArgumentsParam"]
+
+
+class CodeExecutionCallArgumentsParam(TypedDict, total=False):
+    """The arguments to pass to the code execution."""
+
+    code: str
+    """The code to be executed."""
+
+    language: Literal["python"]
+    """Programming language of the `code`."""

google/genai/_interactions/types/code_execution_call_content.py

@@ -0,0 +1,37 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+from .code_execution_call_arguments import CodeExecutionCallArguments
+
+__all__ = ["CodeExecutionCallContent"]
+
+
+class CodeExecutionCallContent(BaseModel):
+    """Code execution content."""
+
+    type: Literal["code_execution_call"]
+    """Used as the OpenAPI type discriminator for the content oneof."""
+
+    id: Optional[str] = None
+    """A unique ID for this specific tool call."""
+
+    arguments: Optional[CodeExecutionCallArguments] = None
+    """The arguments to pass to the code execution."""

google/genai/_interactions/types/code_execution_call_content_param.py

@@ -0,0 +1,37 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+from .code_execution_call_arguments_param import CodeExecutionCallArgumentsParam
+
+__all__ = ["CodeExecutionCallContentParam"]
+
+
+class CodeExecutionCallContentParam(TypedDict, total=False):
+    """Code execution content."""
+
+    type: Required[Literal["code_execution_call"]]
+    """Used as the OpenAPI type discriminator for the content oneof."""
+
+    id: str
+    """A unique ID for this specific tool call."""
+
+    arguments: CodeExecutionCallArgumentsParam
+    """The arguments to pass to the code execution."""

google/genai/_interactions/types/code_execution_result_content.py

@@ -0,0 +1,42 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["CodeExecutionResultContent"]
+
+
+class CodeExecutionResultContent(BaseModel):
+    """Code execution result content."""
+
+    type: Literal["code_execution_result"]
+    """Used as the OpenAPI type discriminator for the content oneof."""
+
+    call_id: Optional[str] = None
+    """ID to match the ID from the code execution call block."""
+
+    is_error: Optional[bool] = None
+    """Whether the code execution resulted in an error."""
+
+    result: Optional[str] = None
+    """The output of the code execution."""
+
+    signature: Optional[str] = None
+    """A signature hash for backend validation."""

google/genai/_interactions/types/code_execution_result_content_param.py

@@ -0,0 +1,41 @@
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["CodeExecutionResultContentParam"]
+
+
+class CodeExecutionResultContentParam(TypedDict, total=False):
+    """Code execution result content."""
+
+    type: Required[Literal["code_execution_result"]]
+    """Used as the OpenAPI type discriminator for the content oneof."""
+
+    call_id: str
+    """ID to match the ID from the code execution call block."""
+
+    is_error: bool
+    """Whether the code execution resulted in an error."""
+
+    result: str
+    """The output of the code execution."""
+
+    signature: str
+    """A signature hash for backend validation."""