Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Responses API provider support added

Sushmithamalleshe035c8bf75b5
diff --git a/python/composio/core/provider/_openai_responses.py b/python/composio/core/provider/_openai_responses.py
new file mode 100644
index 000000000..2e385c31e
--- /dev/null
+++ b/python/composio/core/provider/_openai_responses.py
@@ -0,0 +1,96 @@
+"""
+OpenAI Responses API provider implementation.
+
+This provider wraps tools for the new OpenAI Responses API which uses
+a flattened tool structure compared to the Chat Completions API.
+"""
+
+from __future__ import annotations
+
+import json
+import typing as t
+
+from openai.types.responses.response import Response
+from openai.types.responses.response_output_item import ResponseFunctionToolCall
+from openai.types.chat.chat_completion_message_tool_call import (
+ ChatCompletionMessageToolCall,
+)
+
+from composio.core.provider import NonAgenticProvider
+from composio.types import Modifiers, Tool, ToolExecutionResponse
+
+# Responses API uses a flattened tool structure
+ResponsesTool = t.Dict[str, t.Any]
+ResponsesToolCollection = t.List[ResponsesTool]
+
+
+class OpenAIResponsesProvider(
+ NonAgenticProvider[ResponsesTool, ResponsesToolCollection], name="openai_responses"
+):
+ """OpenAI Responses API Provider class definition.
+ """
+
+ def wrap_tool(self, tool: Tool) -> ResponsesTool:
+ """Wrap a tool for the Responses API format.
+ """
+ return {
+ "type": "function",
+ "name": tool.slug,
+ "description": tool.description,
+ "parameters": tool.input_parameters,
+ }
+
+ def wrap_tools(self, tools: t.Sequence[Tool]) -> ResponsesToolCollection:
+ """Wrap multiple tools for the Responses API format."""
+ return [self.wrap_tool(tool) for tool in tools]
+
+ def execute_tool_call(
+ self,
+ user_id: str,
+ tool_call: t.Union[ChatCompletionMessageToolCall, ResponseFunctionToolCall],
+ modifiers: t.Optional[Modifiers] = None,
+ ) -> ToolExecutionResponse:
+ """Execute a tool call from the Responses API.
+
+ :param tool_call: Tool call metadata from Responses API.
+ :param user_id: User ID to use for executing the function call.
+ :param modifiers: Optional modifiers for tool execution.
+ :return: Object containing output data from the tool call.
+ """
+ slug = tool_call.name
+ arguments = json.loads(tool_call.arguments)
+
+ return self.execute_tool(
+ slug=slug,
+ arguments=arguments,
+ modifiers=modifiers,
+ user_id=user_id,
+ )
+
+ def handle_tool_calls(
+ self,
+ user_id: str,
+ response: Response,
+ modifiers: t.Optional[Modifiers] = None,
+ ) -> t.List[ToolExecutionResponse]:
+ """
+ Handle tool calls from OpenAI Responses API.
+
+ :param response: Response object from openai.OpenAI.beta.responses.create
+ :param user_id: User ID to use for executing the function call.
+ :param modifiers: Optional modifiers for tool execution
+ :return: List[ToolExecutionResponse] with tool execution results
+ """
+ outputs = []
+
+ if response.output:
+ for item in response.output:
+ if isinstance(item, ResponseFunctionToolCall):
+ result = self.execute_tool_call(
+ user_id=user_id,
+ tool_call=item,
+ modifiers=modifiers,
+ )
+ outputs.append(result)
+
+ return outputs
\ No newline at end of file
diff --git a/python/providers/openai/composio_openai/__init__.py b/python/providers/openai/composio_openai/__init__.py
index 44b834593..53b944721 100644
--- a/python/providers/openai/composio_openai/__init__.py
+++ b/python/providers/openai/composio_openai/__init__.py
@@ -1,3 +1,3 @@
-from composio_openai.provider import OpenAIProvider
+from composio_openai.provider import OpenAIProvider, OpenAIResponsesProvider
-__all__ = ("OpenAIProvider",)
+__all__ = ("OpenAIProvider", "OpenAIResponsesProvider")
diff --git a/python/providers/openai/composio_openai/provider.py b/python/providers/openai/composio_openai/provider.py
index 7db882600..9329c5372 100644
--- a/python/providers/openai/composio_openai/provider.py
+++ b/python/providers/openai/composio_openai/provider.py
@@ -3,5 +3,6 @@ OpenAI Provider for composio SDK.
"""
from composio.core.provider._openai import OpenAIProvider
+from composio.core.provider._openai_responses import OpenAIResponsesProvider
-__all__ = ["OpenAIProvider"]
+__all__ = ["OpenAIProvider", "OpenAIResponsesProvider"]