volcengine-python-sdk 4.0.17__py2.py3-none-any.whl → 4.0.19__py2.py3-none-any.whl

volcenginesdkarkruntime/types/responses/response_mcp_list_tools_in_progress_event.py

@@ -0,0 +1,31 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ResponseMcpListToolsInProgressEvent"]
+
+
+class ResponseMcpListToolsInProgressEvent(BaseModel):
+    item_id: str
+    """The ID of the MCP tool call item that is being processed."""
+
+    output_index: int
+    """The index of the output item that is being processed."""
+
+    sequence_number: int
+    """The sequence number of this event."""
+
+    type: Literal["response.mcp_list_tools.in_progress"]
+    """The type of the event. Always 'response.mcp_list_tools.in_progress'."""

volcenginesdkarkruntime/types/responses/response_output_item.py

@@ -18,6 +18,7 @@ from .response_output_message import ResponseOutputMessage
 from .response_reasoning_item import ResponseReasoningItem
 from .response_function_tool_call import ResponseFunctionToolCall
 from .response_web_search_item import ResponseWebSearchItem
+from .response_mcp_item import McpListTools, McpCall, McpApprovalRequest
 
 __all__ = ["ResponseOutputItem"]
 
@@ -27,6 +28,9 @@ ResponseOutputItem: TypeAlias = Annotated[
         ResponseFunctionToolCall,
         ResponseReasoningItem,
         ResponseWebSearchItem,
+        McpListTools,
+        McpCall,
+        McpApprovalRequest,
     ],
     PropertyInfo(discriminator="type"),
 ]

volcenginesdkarkruntime/types/responses/response_stream_event.py

@@ -36,6 +36,15 @@ from .response_web_search_call_in_progress_event import ResponseWebSearchCallInP
 from .response_web_search_call_searching_event import ResponseWebSearchCallSearchingEvent
 from .response_web_search_call_completed_event import ResponseWebSearchCallCompletedEvent
 from .response_annotation_added_event import ResponseOutputTextAnnotationAddedEvent
+from .response_mcp_call_failed_event import ResponseMcpCallFailedEvent
+from .response_mcp_call_in_progress_event import ResponseMcpCallInProgressEvent
+from .response_mcp_call_completed_event import ResponseMcpCallCompletedEvent
+from .response_mcp_call_arguments_done_event import ResponseMcpCallArgumentsDoneEvent
+from .response_mcp_call_arguments_delta_event import ResponseMcpCallArgumentsDeltaEvent
+from .response_mcp_list_tools_failed_event import ResponseMcpListToolsFailedEvent
+from .response_mcp_list_tools_in_progress_event import ResponseMcpListToolsInProgressEvent
+from .response_mcp_list_tools_completed_event import ResponseMcpListToolsCompletedEvent
+
 
 __all__ = ["ResponseStreamEvent"]
 
@@ -70,6 +79,15 @@ ResponseStreamEvent: TypeAlias = Annotated[
         ResponseWebSearchCallSearchingEvent,
         ResponseWebSearchCallCompletedEvent,
         ResponseOutputTextAnnotationAddedEvent,
+
+        ResponseMcpCallFailedEvent,
+        ResponseMcpCallInProgressEvent,
+        ResponseMcpCallCompletedEvent,
+        ResponseMcpCallArgumentsDoneEvent,
+        ResponseMcpCallArgumentsDeltaEvent,
+        ResponseMcpListToolsFailedEvent,
+        ResponseMcpListToolsInProgressEvent,
+        ResponseMcpListToolsCompletedEvent,
     ],
     PropertyInfo(discriminator="type"),
 ]

volcenginesdkarkruntime/types/responses/response_tool_usage.py

@@ -0,0 +1,32 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing_extensions import Dict, Optional
+
+from ..._models import BaseModel
+
+__all__ = ["ToolUsage", "ToolUsageDetails"]
+
+
+class ToolUsage(BaseModel):
+    web_search: Optional[int]
+    """The usage of web search tools."""
+    mcp: Optional[int]
+    """The usage of MCP tools."""
+
+
+class ToolUsageDetails(BaseModel):
+    web_search: Optional[Dict[str, int]]
+    """The usage of web search tools."""
+    mcp: Optional[Dict[str, int]]
+    """The usage of MCP tools."""
+

volcenginesdkarkruntime/types/responses/response_usage.py

@@ -13,6 +13,7 @@
 from typing import Optional
 
 from ..._models import BaseModel
+from .response_tool_usage import ToolUsage, ToolUsageDetails
 
 __all__ = ["ResponseUsage", "InputTokensDetails", "OutputTokensDetails"]
 
@@ -45,3 +46,9 @@ class ResponseUsage(BaseModel):
 
     total_tokens: int
     """The total number of tokens used."""
+
+    tool_usage: Optional[ToolUsage]
+    """The usage of tools."""
+
+    tool_usage_details: Optional[ToolUsageDetails]
+    """A detailed breakdown of the tool usage."""

volcenginesdkarkruntime/types/responses/tool.py

@@ -15,9 +15,11 @@ from typing_extensions import Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
 from .function_tool import FunctionTool
+from .mcp_tool import Mcp
+from .web_search_tool import WebSearchTool
 
 __all__ = ["Tool"]
 
 Tool: TypeAlias = Annotated[
-    Union[FunctionTool], PropertyInfo(discriminator="type")
+    Union[FunctionTool, WebSearchTool, Mcp], PropertyInfo(discriminator="type")
 ]

volcenginesdkarkruntime/types/responses/tool_choice_mcp_param.py

@@ -0,0 +1,29 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ToolChoiceMcpParam"]
+
+
+class ToolChoiceMcpParam(TypedDict, total=False):
+    server_label: Required[str]
+    """The label of the MCP server to use."""
+
+    type: Required[Literal["mcp"]]
+    """For MCP tools, the type is always `mcp`."""
+
+    name: Optional[str]
+    """The name of the tool to call on the server."""

volcenginesdkarkruntime/types/responses/tool_param.py

@@ -17,7 +17,8 @@ from typing_extensions import TypeAlias
 
 from .function_tool_param import FunctionToolParam
 from .web_search_tool_param import WebSearchToolParam
+from .mcp_tool_param import Mcp
 
 __all__ = ["ToolParam"]
 
-ToolParam: TypeAlias = Union[FunctionToolParam, WebSearchToolParam]
+ToolParam: TypeAlias = Union[FunctionToolParam, WebSearchToolParam, Mcp]

volcenginesdkarkruntime/types/responses/web_search_tool.py

@@ -0,0 +1,49 @@
+
+# Copyright (c) [2025] [OpenAI]
+# Copyright (c) [2025] [ByteDance Ltd. and/or its affiliates.]
+# SPDX-License-Identifier: Apache-2.0
+#
+# This file has been modified by [ByteDance Ltd. and/or its affiliates.] on 2025.7
+#
+# Original file was released under Apache License Version 2.0, with the full license text
+# available at https://github.com/openai/openai-python/blob/main/LICENSE.
+#
+# This modified file is released under the same license.
+
+from typing_extensions import Literal, Required, Optional, List
+
+from ..._models import BaseModel
+
+__all__ = [
+    "WebSearchTool",
+    "UserLocation",
+]
+
+
+class UserLocation(BaseModel):
+    type: Literal["approximate"]
+    """The type of the user location. Always `approximate`."""
+    city: Optional[str]
+    """The city of the user location."""
+    country: Optional[str]
+    """The country of the user location."""
+    region: Optional[str]
+    """The region of the user location."""
+    timezone: Optional[float]
+    """The timezone of the user location."""
+
+
+class WebSearchTool(BaseModel):
+
+    type: Literal["web_search"]
+    """The type of the web search. Always `web_search`."""
+
+    limit: Optional[int]
+    """The maximum number of results to return. Defaults to 3."""
+
+    sources: Optional[List[Literal["toutiao", "douyin", "moji", "search_engine"]]]
+    """The source type of web search."""
+
+    user_location: Optional[UserLocation]
+    """The user location."""
+

volcenginesdkarkruntime/types/responses/web_search_tool_param.py

@@ -26,7 +26,7 @@ class WebSearchToolParam(TypedDict, total=False):
     limit: Optional[int]
     """The maximum number of results to return. Defaults to 3."""
 
-    sources: Optional[List[Literal["toutiao", "douyin", "moji"]]]
+    sources: Optional[List[Literal["toutiao", "douyin", "moji", "search_engine"]]]
     """The source type of web search."""
 
     user_location: Optional[UserLocationParam]

volcenginesdkcen/__init__.py

@@ -24,6 +24,7 @@ from volcenginesdkcen.models.associate_cen_bandwidth_package_response import Ass
 from volcenginesdkcen.models.attach_instance_to_cen_request import AttachInstanceToCenRequest
 from volcenginesdkcen.models.attach_instance_to_cen_response import AttachInstanceToCenResponse
 from volcenginesdkcen.models.attached_instance_for_describe_cen_attached_instances_output import AttachedInstanceForDescribeCenAttachedInstancesOutput
+from volcenginesdkcen.models.cen_bandwidth_package_for_describe_cen_bandwidth_packages_billing_output import CenBandwidthPackageForDescribeCenBandwidthPackagesBillingOutput
 from volcenginesdkcen.models.cen_bandwidth_package_for_describe_cen_bandwidth_packages_output import CenBandwidthPackageForDescribeCenBandwidthPackagesOutput
 from volcenginesdkcen.models.cen_for_describe_cens_output import CenForDescribeCensOutput
 from volcenginesdkcen.models.cen_grant_rule_for_describe_grant_rules_to_cen_output import CenGrantRuleForDescribeGrantRulesToCenOutput
@@ -58,6 +59,8 @@ from volcenginesdkcen.models.describe_cen_attributes_request import DescribeCenA
 from volcenginesdkcen.models.describe_cen_attributes_response import DescribeCenAttributesResponse
 from volcenginesdkcen.models.describe_cen_bandwidth_package_attributes_request import DescribeCenBandwidthPackageAttributesRequest
 from volcenginesdkcen.models.describe_cen_bandwidth_package_attributes_response import DescribeCenBandwidthPackageAttributesResponse
+from volcenginesdkcen.models.describe_cen_bandwidth_packages_billing_request import DescribeCenBandwidthPackagesBillingRequest
+from volcenginesdkcen.models.describe_cen_bandwidth_packages_billing_response import DescribeCenBandwidthPackagesBillingResponse
 from volcenginesdkcen.models.describe_cen_bandwidth_packages_request import DescribeCenBandwidthPackagesRequest
 from volcenginesdkcen.models.describe_cen_bandwidth_packages_response import DescribeCenBandwidthPackagesResponse
 from volcenginesdkcen.models.describe_cen_inter_region_bandwidth_attributes_request import DescribeCenInterRegionBandwidthAttributesRequest
@@ -87,6 +90,8 @@ from volcenginesdkcen.models.list_tags_for_resources_request import ListTagsForR
 from volcenginesdkcen.models.list_tags_for_resources_response import ListTagsForResourcesResponse
 from volcenginesdkcen.models.modify_cen_attributes_request import ModifyCenAttributesRequest
 from volcenginesdkcen.models.modify_cen_attributes_response import ModifyCenAttributesResponse
+from volcenginesdkcen.models.modify_cen_bandwidth_package_association_request import ModifyCenBandwidthPackageAssociationRequest
+from volcenginesdkcen.models.modify_cen_bandwidth_package_association_response import ModifyCenBandwidthPackageAssociationResponse
 from volcenginesdkcen.models.modify_cen_bandwidth_package_attributes_request import ModifyCenBandwidthPackageAttributesRequest
 from volcenginesdkcen.models.modify_cen_bandwidth_package_attributes_response import ModifyCenBandwidthPackageAttributesResponse
 from volcenginesdkcen.models.modify_cen_inter_region_bandwidth_attributes_request import ModifyCenInterRegionBandwidthAttributesRequest
@@ -98,10 +103,14 @@ from volcenginesdkcen.models.publish_cen_route_entry_response import PublishCenR
 from volcenginesdkcen.models.publish_to_instance_for_create_cen_service_route_entry_input import PublishToInstanceForCreateCenServiceRouteEntryInput
 from volcenginesdkcen.models.publish_to_instance_for_describe_cen_service_route_entries_output import PublishToInstanceForDescribeCenServiceRouteEntriesOutput
 from volcenginesdkcen.models.publish_to_instance_for_modify_cen_service_route_entry_attributes_input import PublishToInstanceForModifyCenServiceRouteEntryAttributesInput
+from volcenginesdkcen.models.renew_cen_bandwidth_package_request import RenewCenBandwidthPackageRequest
+from volcenginesdkcen.models.renew_cen_bandwidth_package_response import RenewCenBandwidthPackageResponse
 from volcenginesdkcen.models.resource_tag_for_list_tags_for_resources_output import ResourceTagForListTagsForResourcesOutput
 from volcenginesdkcen.models.revoke_instance_from_cen_request import RevokeInstanceFromCenRequest
 from volcenginesdkcen.models.revoke_instance_from_cen_response import RevokeInstanceFromCenResponse
 from volcenginesdkcen.models.service_route_entry_for_describe_cen_service_route_entries_output import ServiceRouteEntryForDescribeCenServiceRouteEntriesOutput
+from volcenginesdkcen.models.set_cen_bandwidth_package_renewal_request import SetCenBandwidthPackageRenewalRequest
+from volcenginesdkcen.models.set_cen_bandwidth_package_renewal_response import SetCenBandwidthPackageRenewalResponse
 from volcenginesdkcen.models.tag_filter_for_describe_cen_bandwidth_packages_input import TagFilterForDescribeCenBandwidthPackagesInput
 from volcenginesdkcen.models.tag_filter_for_describe_cens_input import TagFilterForDescribeCensInput
 from volcenginesdkcen.models.tag_filter_for_list_tags_for_resources_input import TagFilterForListTagsForResourcesInput