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.

fix(py): cursorbot

jkomynoee738a6b9330
diff --git a/python/composio/core/models/tool_router.py b/python/composio/core/models/tool_router.py
index 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 t
from dataclasses import dataclass
from enum import Enum
+import typing_extensions as te
from composio_client import omit
from composio_client.types.tool_router import session_create_params
-import typing_extensions as te
from composio.client import HttpClient
from composio.core.models.base import Resource
diff --git a/python/composio/core/models/tools.py b/python/composio/core/models/tools.py
index 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 ExecuteToolFn
from composio.core.provider.none_agentic import (
NonAgenticProvider,
)
@@ -27,7 +28,6 @@ from composio.core.types import ToolkitVersionParam
from composio.exceptions import InvalidParams, NotFoundError, ToolVersionRequiredError
from composio.utils.pydantic import none_to_omit
from composio.utils.toolkit_version import get_toolkit_version
-from composio.core.provider.base import ExecuteToolFn
from ._modifiers import (
Modifiers,
diff --git a/python/composio/core/models/triggers.py b/python/composio/core/models/triggers.py
index 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 ThreadPoolExecutor
from enum import Enum
from unittest import mock
-from composio_client.types import TriggersTypeRetrieveResponse
import typing_extensions as te
from composio_client import omit
+from composio_client.types import TriggersTypeRetrieveResponse
from pysher import Pusher
from pysher.channel import Channel as PusherChannel
from 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: str
trigger_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: str
timestamp: str
- type: str # Any composio.* event type (e.g., 'composio.trigger.message', 'composio.connected_account.expired')
- metadata: WebhookPayloadV3Metadata
+ type: str
+ metadata: WebhookTriggerPayloadV3Metadata
data: 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.py
index 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, HttpClient
from 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.py
index 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 t
from 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_logger
diff --git a/python/composio/utils/shared.py b/python/composio/utils/shared.py
index 1d2633d73..22eed52d8 100644
--- a/python/composio/utils/shared.py
+++ b/python/composio/utils/shared.py
@@ -11,10 +11,10 @@ from pydantic.fields import FieldInfo
from composio.utils.logging import get as get_logger
from 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.py
index 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 config
diff --git a/python/examples/tool_router/authorize.py b/python/examples/tool_router/authorize.py
index 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 Composio
diff --git a/python/examples/tool_router/claude_agent.py b/python/examples/tool_router/claude_agent.py
index 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, ClaudeAgentOptions
import 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.py
index 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, Task
from crewai.mcp import MCPServerHTTP
+from composio import Composio
composio = Composio()
session = composio.create(
diff --git a/python/examples/tool_router/langchain_agent.py b/python/examples/tool_router/langchain_agent.py
index 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 MultiServerMCPClient
from langchain_openai.chat_models import ChatOpenAI
-import asyncio
+
+from composio import Composio
composio = Composio()
session = composio.create(
diff --git a/python/examples/tool_router/openai_agents.py b/python/examples/tool_router/openai_agents.py
index 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, HostedMCPTool
composio = Composio()
session = composio.create(
diff --git a/python/examples/tool_router/tool_router_mcp.py b/python/examples/tool_router/tool_router_mcp.py
index 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 plat
and OpenAI Agents provider allows you to use these tools with OpenAI's agent framework.
"""
-import os
import asyncio
-from composio import Composio
+import os
+
+from agents import Agent, HostedMCPTool, Runner
from composio_openai_agents import OpenAIAgentsProvider
-from agents import Agent, Runner, HostedMCPTool
+
+from composio import Composio
async def main():
diff --git a/python/examples/tool_router/tools.py b/python/examples/tool_router/tools.py
index 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_execute
from composio.types import ToolExecuteParams, ToolExecutionResponse
-from composio_openai_agents import OpenAIAgentsProvider
async 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.py
index 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.py
index 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 json
from unittest.mock import MagicMock, patch
import pytest
-
from composio_claude_agent_sdk.provider import ClaudeAgentSDKProvider
diff --git a/python/providers/langchain/langchain_demo.py b/python/providers/langchain/langchain_demo.py
index 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 ChatOpenAI
from 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.py
index 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 asyncio
from agents import Agent, Runner
from composio_openai_agents import OpenAIAgentsProvider
+
from composio import Composio
# Initialize Composio toolset
diff --git a/python/scripts/generate-docs.py b/python/scripts/generate-docs.py
index 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__).parent
PACKAGE_DIR = SCRIPT_DIR.parent
OUTPUT_DIR = (
- PACKAGE_DIR.parent
- / "docs"
- / "content"
- / "reference"
- / "sdk-reference"
- / "python"
+ PACKAGE_DIR.parent / "docs" / "content" / "reference" / "sdk-reference" / "python"
)
# GitHub base URL for source links
diff --git a/python/tests/test_auth_configs.py b/python/tests/test_auth_configs.py
index 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 pytest
from 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 AuthConfigs
class TestAuthConfigs:
diff --git a/python/tests/test_connected_accounts.py b/python/tests/test_connected_accounts.py
index 9f941d299..e55e8d84d 100644
--- a/python/tests/test_connected_accounts.py
+++ b/python/tests/test_connected_accounts.py
@@ -7,8 +7,8 @@ import pytest
from composio import exceptions
from 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.py
index 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, patch
import pytest
from 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 RealTools
from composio.core.models._modifiers import Modifier
+ from composio.core.models.tools import Tools as RealTools
real_tools = RealTools(client=mock_client, provider=mock_provider)
diff --git a/python/tests/test_triggers.py b/python/tests/test_triggers.py
index fa32dbae2..17122e456 100644
--- a/python/tests/test_triggers.py
+++ b/python/tests/test_triggers.py
@@ -5,12 +5,14 @@ import hashlib
import hmac
import json
import time
-import pytest
from datetime import datetime, timezone
from unittest.mock import Mock, patch
+
+import pytest
from composio_client import omit
-from composio.core.models.triggers import Triggers, WebhookVersion
+
from composio import exceptions
+from composio.core.models.triggers import Triggers, WebhookVersion
class TestTriggers: