feat: add agent tool event

Author: hexiaochun

volcenginesdkarkruntime/resources/responses/responses.py

@@ -125,6 +125,7 @@ def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | None = None,
         reasoning: Optional[Reasoning] | None = None,
+        session: Optional[dict] | None = None,
     ) -> Response | Stream[ResponseStreamEvent]:
         extra_headers = _add_beta_headers(extra_headers, tools)
         resp = self._post(
@@ -148,6 +149,7 @@ def create(
                 "max_tool_calls": max_tool_calls,
                 "expire_at": expire_at,
                 "reasoning": reasoning,
+                "session": session,
             },
             options=make_request_options(
                 extra_headers=extra_headers,
@@ -248,6 +250,7 @@ async def create(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | None = None,
         reasoning: Optional[Reasoning] | None = None,
+        session: Optional[dict] | None = None,
     ) -> Response | AsyncStream[ResponseStreamEvent]:
         extra_headers = _add_beta_headers(extra_headers, tools)
         await self._prepare_responses_input(input=input)
@@ -273,6 +276,7 @@ async def create(
                 "max_tool_calls": max_tool_calls,
                 "expire_at": expire_at,
                 "reasoning": reasoning,
+                "session": session,
             },
             options=make_request_options(
                 extra_headers=extra_headers,

volcenginesdkarkruntime/types/responses/__init__.py

@@ -12,6 +12,8 @@
 from __future__ import annotations
 
 from .tool import Tool as Tool
+from .session import Session as Session
+from .item_agent_tool_call import ItemAgentToolCall as ItemAgentToolCall
 from .response import Response as Response
 from .tool_param import ToolParam as ToolParam
 from .function_tool import FunctionTool as FunctionTool

volcenginesdkarkruntime/types/responses/item_agent_tool_call.py

@@ -0,0 +1,30 @@
+# 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
+
+from ..._models import BaseModel
+
+__all__ = ["ItemAgentToolCall"]
+
+
+class ItemAgentToolCall(BaseModel):
+    id: Optional[str] = None
+
+    type: Literal["agent_tool_call"]
+
+    name: str
+
+    status: Literal["in_progress", "completed", "incomplete", "searching", "failed"]

volcenginesdkarkruntime/types/responses/response.py

@@ -22,6 +22,7 @@
 from .response_output_item import ResponseOutputItem
 from .response_text_config import ResponseTextConfig
 from .response_usage import ResponseUsage
+from .session import Session
 from .tool import Tool
 from .tool_choice_function import ToolChoiceFunction
 from .tool_choice_knowledge_search import ToolChoiceKnowledgeSearch
@@ -116,3 +117,5 @@ class Response(BaseModel):
 
     reasoning: Optional[Reasoning] = None
     """Configuration options for reasoning models"""
+
+    session: Optional[Session] = None

volcenginesdkarkruntime/types/responses/response_agent_tool_call_completed_event.py

@@ -0,0 +1,28 @@
+# 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_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ResponseAgentToolCallCompletedEvent"]
+
+
+class ResponseAgentToolCallCompletedEvent(BaseModel):
+    type: Literal["response.agent_tool_call.completed"]
+
+    item_id: str
+
+    sequence_number: int
+
+    name: str

volcenginesdkarkruntime/types/responses/response_agent_tool_call_in_progress_event.py

@@ -0,0 +1,28 @@
+# 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_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ResponseAgentToolCallInProgressEvent"]
+
+
+class ResponseAgentToolCallInProgressEvent(BaseModel):
+    type: Literal["response.agent_tool_call.in_progress"]
+
+    item_id: str
+
+    sequence_number: int
+
+    name: str

volcenginesdkarkruntime/types/responses/response_output_item.py

@@ -14,6 +14,7 @@
 from typing_extensions import Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
+from .item_agent_tool_call import ItemAgentToolCall
 from .item_doubao_app_call import ItemDoubaoAppCall
 from .item_function_image_process import ItemFunctionImageProcess
 from .response_function_tool_call import ResponseFunctionToolCall
@@ -37,6 +38,7 @@
         McpCall,
         ResponseKnowledgeSearchItem,
         ItemDoubaoAppCall,
+        ItemAgentToolCall,
     ],
     PropertyInfo(discriminator="type"),
 ]

volcenginesdkarkruntime/types/responses/response_stream_event.py

@@ -14,6 +14,12 @@
 from typing_extensions import Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
+from .response_agent_tool_call_completed_event import (
+    ResponseAgentToolCallCompletedEvent,
+)
+from .response_agent_tool_call_in_progress_event import (
+    ResponseAgentToolCallInProgressEvent,
+)
 from .response_completed_event import ResponseCompletedEvent
 from .response_content_part_added_event import ResponseContentPartAddedEvent
 from .response_content_part_done_event import ResponseContentPartDoneEvent
@@ -185,6 +191,8 @@
         ResponseDoubaoAppCallReasoningSearchCompletedEvent,
         ResponseDoubaoAppCallBlockAddedEvent,
         ResponseDoubaoAppCallBlockDoneEvent,
+        ResponseAgentToolCallInProgressEvent,
+        ResponseAgentToolCallCompletedEvent,
     ],
     PropertyInfo(discriminator="type"),
 ]

volcenginesdkarkruntime/types/responses/session.py

@@ -0,0 +1,20 @@
+# 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 ..._models import BaseModel
+
+__all__ = ["Session"]
+
+
+class Session(BaseModel):
+    id: str