Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
fix(py): cursorbot
jkomynoee738a6b9330
diff --git a/python/composio/core/models/tool_router.py b/python/composio/core/models/tool_router.pyindex 43b68dd0f..c2ab083a6 100644--- a/python/composio/core/models/tool_router.py+++ b/python/composio/core/models/tool_router.py@@ -11,9 +11,9 @@ import typing as tfrom dataclasses import dataclassfrom enum import Enum+import typing_extensions as tefrom composio_client import omitfrom composio_client.types.tool_router import session_create_params-import typing_extensions as tefrom composio.client import HttpClientfrom composio.core.models.base import Resourcediff --git a/python/composio/core/models/tools.py b/python/composio/core/models/tools.pyindex d51823ed6..28cc08d30 100644--- a/python/composio/core/models/tools.py+++ b/python/composio/core/models/tools.py@@ -20,6 +20,7 @@ from composio.core.provider import (TProvider,)from composio.core.provider.agentic import AgenticProvider, AgenticProviderExecuteFn+from composio.core.provider.base import ExecuteToolFnfrom composio.core.provider.none_agentic import (NonAgenticProvider,)@@ -27,7 +28,6 @@ from composio.core.types import ToolkitVersionParamfrom composio.exceptions import InvalidParams, NotFoundError, ToolVersionRequiredErrorfrom composio.utils.pydantic import none_to_omitfrom composio.utils.toolkit_version import get_toolkit_version-from composio.core.provider.base import ExecuteToolFnfrom ._modifiers import (Modifiers,diff --git a/python/composio/core/models/triggers.py b/python/composio/core/models/triggers.pyindex 922667c53..15cd4f2ce 100644--- a/python/composio/core/models/triggers.py+++ b/python/composio/core/models/triggers.py@@ -13,9 +13,9 @@ from concurrent.futures import ThreadPoolExecutorfrom enum import Enumfrom unittest import mock-from composio_client.types import TriggersTypeRetrieveResponseimport typing_extensions as tefrom composio_client import omit+from composio_client.types import TriggersTypeRetrieveResponsefrom pysher import Pusherfrom pysher.channel import Channel as PusherChannelfrom pysher.connection import Connection as PusherConnection@@ -110,8 +110,20 @@ class WebhookPayloadV2(te.TypedDict):data: t.Dict[str, t.Any]-class WebhookPayloadV3Metadata(te.TypedDict):- """V3 webhook payload metadata."""+class WebhookPayloadV3(te.TypedDict):+ """V3 webhook payload structure - generic envelope for all composio.* events."""++ id: str+ timestamp: str+ type: str # Any composio.* event type (e.g., 'composio.trigger.message', 'composio.connected_account.expired')+ metadata: t.Dict[+ str, t.Any+ ] # Shape varies by event type (trigger vs connection events)+ data: t.Dict[str, t.Any]+++class WebhookTriggerPayloadV3Metadata(te.TypedDict):+ """V3 trigger-specific webhook payload metadata."""log_id: strtrigger_slug: str@@ -121,13 +133,13 @@ class WebhookPayloadV3Metadata(te.TypedDict):user_id: str-class WebhookPayloadV3(te.TypedDict):- """V3 webhook payload structure."""+class WebhookTriggerPayloadV3(te.TypedDict):+ """V3 trigger-specific webhook payload structure."""id: strtimestamp: str- type: str # Any composio.* event type (e.g., 'composio.trigger.message', 'composio.connected_account.expired')- metadata: WebhookPayloadV3Metadata+ type: str+ metadata: WebhookTriggerPayloadV3Metadatadata: t.Dict[str, t.Any]@@ -1222,35 +1234,41 @@ class Triggers(Resource):)if is_trigger_event:+ trigger_data = t.cast(WebhookTriggerPayloadV3, data)+ trigger_metadata = trigger_data["metadata"]return t.cast(TriggerEvent,{- "id": metadata["trigger_id"],- "uuid": metadata["trigger_id"],- "user_id": metadata["user_id"],- "toolkit_slug": metadata["trigger_slug"].split("_")[0].upper()- if "_" in metadata["trigger_slug"]+ "id": trigger_metadata["trigger_id"],+ "uuid": trigger_metadata["trigger_id"],+ "user_id": trigger_metadata["user_id"],+ "toolkit_slug": trigger_metadata["trigger_slug"]+ .split("_")[0]+ .upper()+ if "_" in trigger_metadata["trigger_slug"]else "UNKNOWN",- "trigger_slug": metadata["trigger_slug"],+ "trigger_slug": trigger_metadata["trigger_slug"],"metadata": {- "id": metadata["trigger_id"],- "uuid": metadata["trigger_id"],- "toolkit_slug": metadata["trigger_slug"].split("_")[0].upper()- if "_" in metadata["trigger_slug"]+ "id": trigger_metadata["trigger_id"],+ "uuid": trigger_metadata["trigger_id"],+ "toolkit_slug": trigger_metadata["trigger_slug"]+ .split("_")[0]+ .upper()+ if "_" in trigger_metadata["trigger_slug"]else "UNKNOWN",- "trigger_slug": metadata["trigger_slug"],+ "trigger_slug": trigger_metadata["trigger_slug"],"trigger_data": None,"trigger_config": {},"connected_account": {- "id": metadata["connected_account_id"],- "uuid": metadata["connected_account_id"],- "auth_config_id": metadata["auth_config_id"],- "auth_config_uuid": metadata["auth_config_id"],- "user_id": metadata["user_id"],+ "id": trigger_metadata["connected_account_id"],+ "uuid": trigger_metadata["connected_account_id"],+ "auth_config_id": trigger_metadata["auth_config_id"],+ "auth_config_uuid": trigger_metadata["auth_config_id"],+ "user_id": trigger_metadata["user_id"],"status": "ACTIVE",},},- "payload": data["data"],+ "payload": trigger_data["data"],"original_payload": None,},)diff --git a/python/composio/sdk.py b/python/composio/sdk.pyindex f1eb65b3e..07fd002a9 100644--- a/python/composio/sdk.py+++ b/python/composio/sdk.py@@ -10,8 +10,8 @@ from composio.client import DEFAULT_MAX_RETRIES, APIEnvironment, HttpClientfrom composio.core.models import (AuthConfigs,ConnectedAccounts,- ToolRouter,Toolkits,+ ToolRouter,Tools,Triggers,)diff --git a/python/composio/utils/schema_converter.py b/python/composio/utils/schema_converter.pyindex f641842d0..a3c801b00 100644--- a/python/composio/utils/schema_converter.py+++ b/python/composio/utils/schema_converter.py@@ -12,10 +12,12 @@ We handle those by pre-filtering them before passing to the library.import typing as tfrom functools import reduce+from json_schema_to_pydantic import (+ CombinerError,+ SchemaError,+)from json_schema_to_pydantic import ( # type: ignore[import-untyped]create_model as create_model_from_schema,- SchemaError,- CombinerError,)from composio.utils.logging import get as get_loggerdiff --git a/python/composio/utils/shared.py b/python/composio/utils/shared.pyindex 1d2633d73..22eed52d8 100644--- a/python/composio/utils/shared.py+++ b/python/composio/utils/shared.py@@ -11,10 +11,10 @@ from pydantic.fields import FieldInfofrom composio.utils.logging import get as get_loggerfrom composio.utils.schema_converter import (- json_schema_to_pydantic_type,- PYDANTIC_TYPE_TO_PYTHON_TYPE,CONTAINER_TYPE,FALLBACK_VALUES,+ PYDANTIC_TYPE_TO_PYTHON_TYPE,+ json_schema_to_pydantic_type,)logger = get_logger(__name__)diff --git a/python/examples/experimental_tool_router_advanced_example.py b/python/examples/experimental_tool_router_advanced_example.pyindex cbb884f2a..6e9b62e56 100644--- a/python/examples/experimental_tool_router_advanced_example.py+++ b/python/examples/experimental_tool_router_advanced_example.py@@ -138,8 +138,8 @@ def example_type_safe_configuration():print("\n=== Type-Safe Configuration Example ===")from composio.core.models.tool_router import (- ToolRouterToolkitsDisabledConfig,ToolRouterManageConnectionsConfig,+ ToolRouterToolkitsDisabledConfig,)# Type-safe toolkit configdiff --git a/python/examples/tool_router/authorize.py b/python/examples/tool_router/authorize.pyindex 19659ff6c..2f1074b51 100644--- a/python/examples/tool_router/authorize.py+++ b/python/examples/tool_router/authorize.py@@ -6,6 +6,7 @@ within a Tool Router session."""import os+from composio import Composio# Initialize Composiodiff --git a/python/examples/tool_router/claude_agent.py b/python/examples/tool_router/claude_agent.pyindex 9cc620103..e7c584d18 100644--- a/python/examples/tool_router/claude_agent.py+++ b/python/examples/tool_router/claude_agent.py@@ -1,8 +1,10 @@-from composio import Composio-from composio_claude_agent_sdk import ClaudeAgentSDKProvider-from claude_agent_sdk import query, ClaudeAgentOptionsimport asyncio+from claude_agent_sdk import ClaudeAgentOptions, query+from composio_claude_agent_sdk import ClaudeAgentSDKProvider++from composio import Composio+composio = Composio(provider=ClaudeAgentSDKProvider())session = composio.create(user_id="user_123",diff --git a/python/examples/tool_router/crewai_agent.py b/python/examples/tool_router/crewai_agent.pyindex e671e8b6c..33e4c5a4c 100644--- a/python/examples/tool_router/crewai_agent.py+++ b/python/examples/tool_router/crewai_agent.py@@ -1,7 +1,7 @@-from crewai import Agent, Task, Crew-from composio import Composio+from crewai import Agent, Crew, Taskfrom crewai.mcp import MCPServerHTTP+from composio import Composiocomposio = Composio()session = composio.create(diff --git a/python/examples/tool_router/langchain_agent.py b/python/examples/tool_router/langchain_agent.pyindex 81b37bcf1..b8e8bb765 100644--- a/python/examples/tool_router/langchain_agent.py+++ b/python/examples/tool_router/langchain_agent.py@@ -1,8 +1,10 @@-from composio import Composio-from langchain_mcp_adapters.client import MultiServerMCPClient+import asyncio+from langchain.agents import create_agent+from langchain_mcp_adapters.client import MultiServerMCPClientfrom langchain_openai.chat_models import ChatOpenAI-import asyncio++from composio import Composiocomposio = Composio()session = composio.create(diff --git a/python/examples/tool_router/openai_agents.py b/python/examples/tool_router/openai_agents.pyindex 72153aa05..37b248990 100644--- a/python/examples/tool_router/openai_agents.py+++ b/python/examples/tool_router/openai_agents.py@@ -1,5 +1,6 @@+from agents import Agent, HostedMCPTool, Runner+from composio import Composio-from agents import Agent, Runner, HostedMCPToolcomposio = Composio()session = composio.create(diff --git a/python/examples/tool_router/tool_router_mcp.py b/python/examples/tool_router/tool_router_mcp.pyindex 66a9c7ddf..0287e69e6 100644--- a/python/examples/tool_router/tool_router_mcp.py+++ b/python/examples/tool_router/tool_router_mcp.py@@ -6,11 +6,13 @@ The MCP server provides a standardized way to access tools across different platand OpenAI Agents provider allows you to use these tools with OpenAI's agent framework."""-import osimport asyncio-from composio import Composio+import os++from agents import Agent, HostedMCPTool, Runnerfrom composio_openai_agents import OpenAIAgentsProvider-from agents import Agent, Runner, HostedMCPTool++from composio import Composioasync def main():diff --git a/python/examples/tool_router/tools.py b/python/examples/tool_router/tools.pyindex 823bb75d1..59f841e8e 100644--- a/python/examples/tool_router/tools.py+++ b/python/examples/tool_router/tools.py@@ -7,10 +7,12 @@ and execute complex workflows."""import asyncio+from agents import Agent, Runner+from composio_openai_agents import OpenAIAgentsProvider+from composio import Composio, after_execute, before_executefrom composio.types import ToolExecuteParams, ToolExecutionResponse-from composio_openai_agents import OpenAIAgentsProviderasync def main():diff --git a/python/providers/claude_agent_sdk/composio_claude_agent_sdk/provider.py b/python/providers/claude_agent_sdk/composio_claude_agent_sdk/provider.pyindex deb76767a..3f4a43969 100644--- a/python/providers/claude_agent_sdk/composio_claude_agent_sdk/provider.py+++ b/python/providers/claude_agent_sdk/composio_claude_agent_sdk/provider.py@@ -13,6 +13,8 @@ from claude_agent_sdk import (McpSdkServerConfig,SdkMcpTool,create_sdk_mcp_server,+)+from claude_agent_sdk import (tool as sdk_tool,)diff --git a/python/providers/claude_agent_sdk/tests/test_provider.py b/python/providers/claude_agent_sdk/tests/test_provider.pyindex 9944cd316..07eb8697d 100644--- a/python/providers/claude_agent_sdk/tests/test_provider.py+++ b/python/providers/claude_agent_sdk/tests/test_provider.py@@ -6,7 +6,6 @@ import jsonfrom unittest.mock import MagicMock, patchimport pytest-from composio_claude_agent_sdk.provider import ClaudeAgentSDKProviderdiff --git a/python/providers/langchain/langchain_demo.py b/python/providers/langchain/langchain_demo.pyindex ac86cd4fd..83381d376 100644--- a/python/providers/langchain/langchain_demo.py+++ b/python/providers/langchain/langchain_demo.py@@ -8,7 +8,6 @@ from langchain_openai import ChatOpenAIfrom composio import Composio-openai_client = ChatOpenAI(model="gpt-5")diff --git a/python/providers/openai_agents/openai_agents_demo.py b/python/providers/openai_agents/openai_agents_demo.pyindex 642f4cd48..102abb0c3 100644--- a/python/providers/openai_agents/openai_agents_demo.py+++ b/python/providers/openai_agents/openai_agents_demo.py@@ -2,6 +2,7 @@ import asynciofrom agents import Agent, Runnerfrom composio_openai_agents import OpenAIAgentsProvider+from composio import Composio# Initialize Composio toolsetdiff --git a/python/scripts/generate-docs.py b/python/scripts/generate-docs.pyindex 43f82bdd4..86e686d37 100644--- a/python/scripts/generate-docs.py+++ b/python/scripts/generate-docs.py@@ -26,12 +26,7 @@ except ImportError:SCRIPT_DIR = Path(__file__).parentPACKAGE_DIR = SCRIPT_DIR.parentOUTPUT_DIR = (- PACKAGE_DIR.parent- / "docs"- / "content"- / "reference"- / "sdk-reference"- / "python"+ PACKAGE_DIR.parent / "docs" / "content" / "reference" / "sdk-reference" / "python")# GitHub base URL for source linksdiff --git a/python/tests/test_auth_configs.py b/python/tests/test_auth_configs.pyindex 3129d98da..2b2b57ef7 100644--- a/python/tests/test_auth_configs.py+++ b/python/tests/test_auth_configs.py@@ -1,14 +1,15 @@"""Tests for auth configs management."""-import pytestfrom unittest.mock import Mock-from composio.core.models.auth_configs import AuthConfigs+import pytest+from composio.client.types import (- auth_config_list_response,auth_config_create_response,+ auth_config_list_response,auth_config_retrieve_response,)+from composio.core.models.auth_configs import AuthConfigsclass TestAuthConfigs:diff --git a/python/tests/test_connected_accounts.py b/python/tests/test_connected_accounts.pyindex 9f941d299..e55e8d84d 100644--- a/python/tests/test_connected_accounts.py+++ b/python/tests/test_connected_accounts.py@@ -7,8 +7,8 @@ import pytestfrom composio import exceptionsfrom composio.core.models.connected_accounts import (AuthScheme,- ConnectionRequest,ConnectedAccounts,+ ConnectionRequest,)diff --git a/python/tests/test_tool_router.py b/python/tests/test_tool_router.pyindex b94287afb..32930ad11 100644--- a/python/tests/test_tool_router.py+++ b/python/tests/test_tool_router.py@@ -5,16 +5,16 @@ from unittest.mock import MagicMock, patchimport pytestfrom composio.core.models.tool_router import (+ ToolkitConnectionsDetails,+ ToolkitConnectionState,ToolRouter,- ToolRouterMCPServerConfig,- ToolRouterToolkitsEnableConfig,- ToolRouterToolkitsDisableConfig,- ToolRouterManageConnectionsConfig,ToolRouterExperimentalConfig,- ToolRouterSessionExperimental,- ToolkitConnectionState,- ToolkitConnectionsDetails,+ ToolRouterManageConnectionsConfig,+ ToolRouterMCPServerConfig,ToolRouterMCPServerType,+ ToolRouterSessionExperimental,+ ToolRouterToolkitsDisableConfig,+ ToolRouterToolkitsEnableConfig,)@@ -1117,9 +1117,9 @@ class TestToolRouterTypes:def test_toolkit_connection_state(self):"""Test ToolkitConnectionState dataclass."""from composio.core.models.tool_router import (+ ToolkitConnectedAccount,ToolkitConnection,ToolkitConnectionAuthConfig,- ToolkitConnectedAccount,)connection = ToolkitConnection(@@ -1242,8 +1242,8 @@ class TestToolRouterExecution:return response# Create a real execute function with modifiers- from composio.core.models.tools import Tools as RealToolsfrom composio.core.models._modifiers import Modifier+ from composio.core.models.tools import Tools as RealToolsreal_tools = RealTools(client=mock_client, provider=mock_provider)diff --git a/python/tests/test_triggers.py b/python/tests/test_triggers.pyindex fa32dbae2..17122e456 100644--- a/python/tests/test_triggers.py+++ b/python/tests/test_triggers.py@@ -5,12 +5,14 @@ import hashlibimport hmacimport jsonimport time-import pytestfrom datetime import datetime, timezonefrom unittest.mock import Mock, patch++import pytestfrom composio_client import omit-from composio.core.models.triggers import Triggers, WebhookVersion+from composio import exceptions+from composio.core.models.triggers import Triggers, WebhookVersionclass TestTriggers: