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: Telemetry and request headers (#2134)

Musthaq Ahamadf88ab9936db1
diff --git a/.changeset/fruity-times-stop.md b/.changeset/fruity-times-stop.md
new file mode 100644
index 000000000..bd9a9dbec
--- /dev/null
+++ b/.changeset/fruity-times-stop.md
@@ -0,0 +1,5 @@
+---
+'@composio/core': patch
+---
+
+Fix: SDK telemetry methods and request headers
diff --git a/package.json b/package.json
index b819eda57..6c3364529 100644
--- a/package.json
+++ b/package.json
@@ -60,6 +60,10 @@
],
"ts/packages/**/*.{ts,tsx,js,jsx,json,md}": [
"prettier --write"
+ ],
+ "python/**/*.py": [
+ "ruff check --fix --config python/config/ruff.toml",
+ "ruff format --config python/config/ruff.toml"
]
}
}
diff --git a/python/composio/client/__init__.py b/python/composio/client/__init__.py
index 7eaea8b4c..534934ab2 100644
--- a/python/composio/client/__init__.py
+++ b/python/composio/client/__init__.py
@@ -3,6 +3,8 @@ This module is a light wrapper around the auto-generated composio client.
"""
import contextvars
+import os
+import platform
import typing as t
from importlib.metadata import version
from uuid import uuid4
@@ -24,6 +26,93 @@ ComposioAPIError = APIError
APIEnvironment = te.Literal["production", "staging", "local"]
+def _get_python_implementation() -> str:
+ """
+ Get the Python implementation name.
+
+ Returns:
+ String identifier for Python implementation (CPYTHON, PYPY, JYTHON, IRONPYTHON, etc.)
+ """
+ impl = platform.python_implementation().upper()
+ return impl
+
+
+def _detect_runtime_environment() -> str:
+ """
+ Detect the runtime environment where the code is executing.
+
+ Returns a string identifier for the environment.
+ """
+ # Check for Google Colab
+ try:
+ import google.colab # type: ignore # noqa: F401
+
+ return "GOOGLE_COLAB"
+ except ImportError:
+ pass
+
+ # Check for Jupyter/IPython
+ try:
+ shell = get_ipython().__class__.__name__ # type: ignore # noqa: F821
+ if shell == "ZMQInteractiveShell":
+ return "JUPYTER_NOTEBOOK"
+ elif shell == "TerminalInteractiveShell":
+ return "IPYTHON"
+ except NameError:
+ pass
+
+ # Check for AWS Lambda
+ if os.environ.get("AWS_LAMBDA_FUNCTION_NAME"):
+ return "AWS_LAMBDA"
+
+ # Check for Google Cloud Functions
+ if os.environ.get("FUNCTION_NAME") or os.environ.get("K_SERVICE"):
+ return "GOOGLE_CLOUD_FUNCTION"
+
+ # Check for Azure Functions
+ if os.environ.get("FUNCTIONS_WORKER_RUNTIME"):
+ return "AZURE_FUNCTION"
+
+ # Check for Kaggle
+ if os.environ.get("KAGGLE_KERNEL_RUN_TYPE"):
+ return "KAGGLE"
+
+ # Check for Replit
+ if os.environ.get("REPL_ID") or os.environ.get("REPLIT_DB_URL"):
+ return "REPLIT"
+
+ # Check for GitHub Actions
+ if os.environ.get("GITHUB_ACTIONS"):
+ return "GITHUB_ACTIONS"
+
+ # Check for GitLab CI
+ if os.environ.get("GITLAB_CI"):
+ return "GITLAB_CI"
+
+ # Check for CircleCI
+ if os.environ.get("CIRCLECI"):
+ return "CIRCLECI"
+
+ # Check for Jenkins
+ if os.environ.get("JENKINS_HOME"):
+ return "JENKINS"
+
+ # Check for Docker
+ if os.path.exists("/.dockerenv") or os.path.exists("/run/.containerenv"):
+ return "DOCKER"
+
+ # Check if running in a container (generic)
+ try:
+ with open("/proc/1/cgroup", "r") as f:
+ if "docker" in f.read() or "containerd" in f.read():
+ return "CONTAINER"
+ except (FileNotFoundError, PermissionError):
+ pass
+
+ # Default to LOCAL for development environments
+ return "LOCAL"
+
+
class RequestContext(te.TypedDict):
id: te.NotRequired[t.Optional[str]]
provider: str
@@ -38,6 +127,11 @@ class HttpClient(BaseComposio, WithLogger):
request_ctx: contextvars.ContextVar[RequestContext]
not_given = NOT_GIVEN
+ # Detect once at class initialization
+ _runtime_env: str = (
+ f"{_detect_runtime_environment()}_{_get_python_implementation()}"
+ )
+
def __init__(
self,
*,
@@ -96,8 +190,10 @@ class HttpClient(BaseComposio, WithLogger):
ctx = self.request_ctx.get()
request.headers["x-request-id"] = ctx.get("id") or uuid4().hex
request.headers["x-framework"] = ctx["provider"]
- request.headers["x-source"] = "python"
+ request.headers["x-source"] = "PYTHON_SDK"
+ request.headers["x-runtime"] = HttpClient._runtime_env
+
try:
request.headers["x-sdk-version"] = version("composio")
except Exception:
- request.headers["x-sdk-version"] = "unknown"
+ request.headers["x-sdk-version"] = "unknwon"
diff --git a/python/examples/tools.py b/python/examples/tools.py
index ed4645033..21c97507b 100644
--- a/python/examples/tools.py
+++ b/python/examples/tools.py
@@ -16,6 +16,7 @@ response = composio.tools.execute(
user_id="default",
slug="HACKERNEWS_GET_USER",
arguments={"username": "pg"},
+ version="20251023_00",
)
print(response)
diff --git a/python/providers/anthropic/pyproject.toml b/python/providers/anthropic/pyproject.toml
index d5a3552b2..1e7e92bd9 100644
--- a/python/providers/anthropic/pyproject.toml
+++ b/python/providers/anthropic/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-anthropic"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your Anthropic LLMs."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/anthropic/setup.py b/python/providers/anthropic/setup.py
index cdc23db0f..9d0253803 100644
--- a/python/providers/anthropic/setup.py
+++ b/python/providers/anthropic/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_anthropic",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Anthropic LLMs.",
diff --git a/python/providers/autogen/pyproject.toml b/python/providers/autogen/pyproject.toml
index 75d22913e..32d79e29b 100644
--- a/python/providers/autogen/pyproject.toml
+++ b/python/providers/autogen/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-autogen"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your autogen agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/autogen/setup.py b/python/providers/autogen/setup.py
index 9b3f4fcc0..ca60e34b7 100644
--- a/python/providers/autogen/setup.py
+++ b/python/providers/autogen/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_autogen",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Autogen agent.",
diff --git a/python/providers/crewai/pyproject.toml b/python/providers/crewai/pyproject.toml
index 804cd3206..63e3771d1 100644
--- a/python/providers/crewai/pyproject.toml
+++ b/python/providers/crewai/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-crewai"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your CrewAI agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/crewai/setup.py b/python/providers/crewai/setup.py
index 59606ecec..b9b36e502 100644
--- a/python/providers/crewai/setup.py
+++ b/python/providers/crewai/setup.py
@@ -6,7 +6,7 @@ from setuptools import setup
setup(
name="composio_crewai",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your CrewAI agent.",
diff --git a/python/providers/gemini/pyproject.toml b/python/providers/gemini/pyproject.toml
index 52074ff5e..6a93bc062 100644
--- a/python/providers/gemini/pyproject.toml
+++ b/python/providers/gemini/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-gemini"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your Gemini agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/gemini/setup.py b/python/providers/gemini/setup.py
index 58121077a..d935e3ad7 100644
--- a/python/providers/gemini/setup.py
+++ b/python/providers/gemini/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_gemini",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Gemini agent.",
diff --git a/python/providers/google/pyproject.toml b/python/providers/google/pyproject.toml
index 665cdfd21..5641eb262 100644
--- a/python/providers/google/pyproject.toml
+++ b/python/providers/google/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-google"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/google/setup.py b/python/providers/google/setup.py
index c6b17b27a..00fb19fe7 100644
--- a/python/providers/google/setup.py
+++ b/python/providers/google/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_google",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
diff --git a/python/providers/google_adk/pyproject.toml b/python/providers/google_adk/pyproject.toml
index fc6c77a26..ddb54da3a 100644
--- a/python/providers/google_adk/pyproject.toml
+++ b/python/providers/google_adk/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-google-adk"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/google_adk/setup.py b/python/providers/google_adk/setup.py
index b4023b5ad..aa1ddd60c 100644
--- a/python/providers/google_adk/setup.py
+++ b/python/providers/google_adk/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_google_adk",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
diff --git a/python/providers/langchain/pyproject.toml b/python/providers/langchain/pyproject.toml
index 9f420b278..4797bd24b 100644
--- a/python/providers/langchain/pyproject.toml
+++ b/python/providers/langchain/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-langchain"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your Langchain agent."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/langchain/setup.py b/python/providers/langchain/setup.py
index c6c284e62..1be5ce475 100644
--- a/python/providers/langchain/setup.py
+++ b/python/providers/langchain/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_langchain",
- version="0.9.0",
+ version="0.9.1",
author="composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Langchain agent.",
diff --git a/python/providers/langgraph/pyproject.toml b/python/providers/langgraph/pyproject.toml
index b6ee761cf..31aa43991 100644
--- a/python/providers/langgraph/pyproject.toml
+++ b/python/providers/langgraph/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-langgraph"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/langgraph/setup.py b/python/providers/langgraph/setup.py
index 3aeb4d160..a126f5ac1 100644
--- a/python/providers/langgraph/setup.py
+++ b/python/providers/langgraph/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_langgraph",
- version="0.9.0",
+ version="0.9.1",
author="composio",
author_email="[email protected]",
description="Use Composio to get array of tools with LangGraph Agent Workflows",
diff --git a/python/providers/llamaindex/pyproject.toml b/python/providers/llamaindex/pyproject.toml
index b7b9ad9a9..1e52f7dbf 100644
--- a/python/providers/llamaindex/pyproject.toml
+++ b/python/providers/llamaindex/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-llamaindex"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/llamaindex/setup.py b/python/providers/llamaindex/setup.py
index 796b3f193..c691ac97e 100644
--- a/python/providers/llamaindex/setup.py
+++ b/python/providers/llamaindex/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_llamaindex",
- version="0.9.0",
+ version="0.9.1",
author="composio",
author_email="[email protected]",
description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
diff --git a/python/providers/openai/pyproject.toml b/python/providers/openai/pyproject.toml
index 7e5bfc5b8..b1408b285 100644
--- a/python/providers/openai/pyproject.toml
+++ b/python/providers/openai/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-openai"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get an array of tools with your OpenAI Function Call."
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/openai/setup.py b/python/providers/openai/setup.py
index 5ad56d2fc..6f40216ee 100644
--- a/python/providers/openai/setup.py
+++ b/python/providers/openai/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_openai",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your OpenAI Function Call.",
diff --git a/python/providers/openai_agents/pyproject.toml b/python/providers/openai_agents/pyproject.toml
index e956076fa..a82eafb6c 100644
--- a/python/providers/openai_agents/pyproject.toml
+++ b/python/providers/openai_agents/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-openai-agents"
-version = "0.9.0"
+version = "0.9.1"
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
readme = "README.md"
requires-python = ">=3.9,<4"
diff --git a/python/providers/openai_agents/setup.py b/python/providers/openai_agents/setup.py
index 7a6c62643..706ceafab 100644
--- a/python/providers/openai_agents/setup.py
+++ b/python/providers/openai_agents/setup.py
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
setup(
name="composio_openai_agents",
- version="0.9.0",
+ version="0.9.1",
author="Composio",
author_email="[email protected]",
description="Use Composio to get array of strongly typed tools for OpenAI Agents",
diff --git a/python/pyproject.toml b/python/pyproject.toml
index 0f4313b8f..7dddcedc9 100644
--- a/python/pyproject.toml
+++ b/python/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio"
-version = "0.9.0"
+version = "0.9.1"
description = "SDK for integrating Composio with your applications."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/ts/examples/tools/src/index.ts b/ts/examples/tools/src/index.ts
index 944e6d079..702f8c8e7 100644
--- a/ts/examples/tools/src/index.ts
+++ b/ts/examples/tools/src/index.ts
@@ -17,7 +17,7 @@ import path from 'path';
*/
const composio = new Composio({
apiKey: process.env.COMPOSIO_API_KEY,
- allowTracking: false
+ allowTracking: false,
});
/**
@@ -29,6 +29,7 @@ async function main() {
console.log('πŸ”„ Uploading file...');
const result = await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {
+ dangerouslySkipVersionCheck: true,
arguments: {
file_to_upload: path.join(__dirname, 'image.png'),
},
@@ -39,6 +40,7 @@ async function main() {
console.log('πŸ”„ Downloading file...');
const result2 = await composio.tools.execute('GOOGLEDRIVE_DOWNLOAD_FILE', {
+ dangerouslySkipVersionCheck: true,
arguments: {
file_id: (result.data.response_data as unknown as { id: string }).id,
},
@@ -46,7 +48,6 @@ async function main() {
});
console.log('βœ… File downloaded successfully...');
console.log(JSON.stringify(result2, null, 2));
-
} catch (error) {
console.error('❌ Error running example:', error);
}
diff --git a/ts/packages/core/src/composio.ts b/ts/packages/core/src/composio.ts
index 29ed020cc..32b327cea 100644
--- a/ts/packages/core/src/composio.ts
+++ b/ts/packages/core/src/composio.ts
@@ -276,9 +276,12 @@ export class Composio<
});
}
// instrument the composio instance
- telemetry.instrument(this);
+ telemetry.instrument(this, 'Composio');
// instrument the provider since we are not using the provider class directly
- telemetry.instrument(this.provider);
+ telemetry.instrument(
+ this.provider,
+ this.provider.name ?? this.provider.constructor.name ?? 'unknown'
+ );
// Check for the latest version of the Composio SDK from NPM.
if (!this.config.disableVersionCheck) {
diff --git a/ts/packages/core/src/models/AuthConfigs.ts b/ts/packages/core/src/models/AuthConfigs.ts
index c4a32d5d2..d8cea9493 100644
--- a/ts/packages/core/src/models/AuthConfigs.ts
+++ b/ts/packages/core/src/models/AuthConfigs.ts
@@ -7,7 +7,6 @@
*/
import ComposioClient from '@composio/client';
import {
- AuthConfigRetrieveResponse as ComposioAuthConfigRetrieveResponse,
AuthConfigDeleteResponse,
AuthConfigUpdateResponse,
AuthConfigUpdateStatusResponse,
@@ -16,19 +15,15 @@ import {
AuthConfigListParams,
AuthConfigListParamsSchema,
AuthConfigListResponse,
- AuthConfigListResponseSchema,
AuthConfigRetrieveResponse,
- AuthConfigRetrieveResponseSchema,
AuthConfigUpdateParams,
AuthConfigUpdateParamsSchema,
CreateAuthConfigParams,
CreateAuthConfigParamsSchema,
CreateAuthConfigResponse,
- CreateAuthConfigResponseSchema,
} from '../types/authConfigs.types';
import { ValidationError } from '../errors/ValidationErrors';
import { telemetry } from '../telemetry/Telemetry';
-import logger from '../utils/logger';
import {
transformAuthConfigListResponse,
transformAuthConfigRetrieveResponse,
@@ -45,7 +40,7 @@ export class AuthConfigs {
constructor(client: ComposioClient) {
this.client = client;
- telemetry.instrument(this);
+ telemetry.instrument(this, 'AuthConfigs');
}
/**
diff --git a/ts/packages/core/src/models/ConnectedAccounts.ts b/ts/packages/core/src/models/ConnectedAccounts.ts
index 21d7a3cbe..b49737e29 100644
--- a/ts/packages/core/src/models/ConnectedAccounts.ts
+++ b/ts/packages/core/src/models/ConnectedAccounts.ts
@@ -49,7 +49,7 @@ export class ConnectedAccounts {
constructor(client: ComposioClient) {
this.client = client;
- telemetry.instrument(this);
+ telemetry.instrument(this, 'ConnectedAccounts');
}
/**
diff --git a/ts/packages/core/src/models/ConnectionRequest.ts b/ts/packages/core/src/models/ConnectionRequest.ts
index a2329381f..e08b6e3c5 100644
--- a/ts/packages/core/src/models/ConnectionRequest.ts
+++ b/ts/packages/core/src/models/ConnectionRequest.ts
@@ -42,7 +42,7 @@ export function createConnectionRequest(
redirectUrl,
};
- telemetry.instrument(state);
+ telemetry.instrument(state, 'ConnectionRequest');
/**
* Waits for the connection request to complete and become active.
diff --git a/ts/packages/core/src/models/CustomTools.ts b/ts/packages/core/src/models/CustomTools.ts
index 08ed94fe8..022bc4901 100644
--- a/ts/packages/core/src/models/CustomTools.ts
+++ b/ts/packages/core/src/models/CustomTools.ts
@@ -44,7 +44,7 @@ export class CustomTools {
}
this.client = client;
this.customToolsRegistry = new Map();
- telemetry.instrument(this);
+ telemetry.instrument(this, 'CustomTools');
}
/**
diff --git a/ts/packages/core/src/models/Files.ts b/ts/packages/core/src/models/Files.ts
index 41593cdfe..3f32e14f0 100644
--- a/ts/packages/core/src/models/Files.ts
+++ b/ts/packages/core/src/models/Files.ts
@@ -12,7 +12,7 @@ import { telemetry } from '../telemetry/Telemetry';
export class Files {
constructor(private readonly client: ComposioClient) {
- telemetry.instrument(this);
+ telemetry.instrument(this, 'Files');
}
/**
diff --git a/ts/packages/core/src/models/MCP.experimental.ts b/ts/packages/core/src/models/MCP.experimental.ts
index 29ec36d0a..8eef1ea73 100644
--- a/ts/packages/core/src/models/MCP.experimental.ts
+++ b/ts/packages/core/src/models/MCP.experimental.ts
@@ -48,7 +48,7 @@ export class MCP {
constructor(client: ComposioClient) {
this.client = client;
- telemetry.instrument(this);
+ telemetry.instrument(this, 'MCP');
}
/**
diff --git a/ts/packages/core/src/models/MCP.ts b/ts/packages/core/src/models/MCP.ts
index f2a744b2a..8604c7113 100644
--- a/ts/packages/core/src/models/MCP.ts
+++ b/ts/packages/core/src/models/MCP.ts
@@ -46,6 +46,7 @@ import {
import { Toolkits } from './Toolkits';
import { ToolkitAuthFieldsResponse } from '../types/toolkit.types';
import { ConnectionRequest } from '../types/connectionRequest.types';
+import logger from '../utils/logger';
/**
* Extract the MCP response type from a provider.
@@ -73,7 +74,7 @@ export class MCP<TProvider extends BaseComposioProvider<unknown, unknown, unknow
this.client = client;
this.provider = provider;
this.toolkits = new Toolkits(client);
- telemetry.instrument(this);
+ telemetry.instrument(this, 'MCP');
}
/**
@@ -169,7 +170,6 @@ export class MCP<TProvider extends BaseComposioProvider<unknown, unknown, unknow
// If we reach here, server exists
const tools = mcpServer.tools?.sort()!;
const sortedCurrentTools = serverConfig.flatMap(config => config.allowedTools).sort();
- console.log(tools, sortedCurrentTools, 'tools');
if (tools?.length > 0 && !tools.every((tool, index) => tool === sortedCurrentTools[index])) {
throw new ValidationError('MCP server with this name already exists with different tools', {
meta: { serverName: name },
@@ -852,7 +852,7 @@ export class MCP<TProvider extends BaseComposioProvider<unknown, unknown, unknow
limit: 10,
});
} catch (error) {
- console.error(error);
+ logger.error(error);
throw new ValidationError('Failed to search MCP servers by name', {
cause: error,
});
diff --git a/ts/packages/core/src/models/ToolRouter.experimental.ts b/ts/packages/core/src/models/ToolRouter.experimental.ts
index f914217f4..f92bf13e2 100644
--- a/ts/packages/core/src/models/ToolRouter.experimental.ts
+++ b/ts/packages/core/src/models/ToolRouter.experimental.ts
@@ -12,7 +12,7 @@ import { transform } from '../utils/transform';
export class ToolRouter {
constructor(private client: ComposioClient) {
this.client = client;
- telemetry.instrument(this);
+ telemetry.instrument(this, 'ToolRouter');
}
/**
diff --git a/ts/packages/core/src/models/Toolkits.ts b/ts/packages/core/src/models/Toolkits.ts
index f49934d20..de1a64c9e 100644
--- a/ts/packages/core/src/models/Toolkits.ts
+++ b/ts/packages/core/src/models/Toolkits.ts
@@ -34,7 +34,7 @@ export class Toolkits {
constructor(client: ComposioClient) {
this.client = client;
this.authorize = this.authorize.bind(this);
- telemetry.instrument(this);
+ telemetry.instrument(this, 'Toolkits');
}
/**
* Retrieves a list of toolkits based on the provided query parameters.
diff --git a/ts/packages/core/src/models/Tools.ts b/ts/packages/core/src/models/Tools.ts
index 46653bdd5..085277e77 100644
--- a/ts/packages/core/src/models/Tools.ts
+++ b/ts/packages/core/src/models/Tools.ts
@@ -86,7 +86,7 @@ export class Tools<
this.getRawComposioToolBySlug = this.getRawComposioToolBySlug.bind(this);
this.getRawComposioTools = this.getRawComposioTools.bind(this);
- telemetry.instrument(this);
+ telemetry.instrument(this, 'Tools');
}
/**
diff --git a/ts/packages/core/src/models/Triggers.ts b/ts/packages/core/src/models/Triggers.ts
index 3a26a5d8b..c437fac8c 100644
--- a/ts/packages/core/src/models/Triggers.ts
+++ b/ts/packages/core/src/models/Triggers.ts
@@ -48,7 +48,7 @@ export class Triggers<TProvider extends BaseComposioProvider<unknown, unknown, u
this.client = client;
this.pusherService = new PusherService(client);
this.toolkitVersions = config?.toolkitVersions ?? 'latest';
- telemetry.instrument(this);
+ telemetry.instrument(this, 'Triggers');
}
/**
diff --git a/ts/packages/core/src/services/pusher/Pusher.ts b/ts/packages/core/src/services/pusher/Pusher.ts
index bb62fb1bf..b6647fbc2 100644
--- a/ts/packages/core/src/services/pusher/Pusher.ts
+++ b/ts/packages/core/src/services/pusher/Pusher.ts
@@ -26,7 +26,7 @@ export class PusherService {
this.composioClient = client;
this.pusherBaseURL = client.baseURL;
this.apiKey = client.apiKey ?? process.env.COMPOSIO_API_KEY ?? '';
- telemetry.instrument(this);
+ telemetry.instrument(this, 'PusherService');
}
/**
diff --git a/ts/packages/core/src/telemetry/Telemetry.ts b/ts/packages/core/src/telemetry/Telemetry.ts
index e576c5865..8bf3ba92d 100644
--- a/ts/packages/core/src/telemetry/Telemetry.ts
+++ b/ts/packages/core/src/telemetry/Telemetry.ts
@@ -95,8 +95,8 @@ export class TelemetryTransport {
descriptor.value.constructor.name === 'AsyncFunction'
);
});
- // use the constructor name if available, otherwise use the file name
- const instrumentedClassName = (instance.constructor?.name || fileName) ?? 'unknown';
+ // prioritize the explicitly passed class name, then fall back to constructor name, then 'unknown'
+ const instrumentedClassName = fileName ?? instance.constructor?.name ?? 'unknown';
for (const name of methodNames) {
const originalMethod = (instance as unknown as Record<string, Function>)[name] as (
diff --git a/ts/packages/core/src/utils/session.ts b/ts/packages/core/src/utils/session.ts
index ca29df889..5915160f8 100644
--- a/ts/packages/core/src/utils/session.ts
+++ b/ts/packages/core/src/utils/session.ts
@@ -2,12 +2,102 @@ import { BaseComposioProvider } from '../provider/BaseProvider';
import { version } from '../../package.json';
import { ComposioRequestHeaders } from '../types/composio.types';
+/**
+ * Extended globalThis interface for runtime detection
+ */
+interface ExtendedGlobalThis {
+ Bun?: unknown;
+ Deno?: unknown;
+ caches?: unknown;
+ WebSocketPair?: unknown;
+ EdgeRuntime?: unknown;
+ ServiceWorkerGlobalScope?: new () => unknown;
+ WorkerGlobalScope?: new () => unknown;
+ importScripts?: (url: string) => void;
+}
+
+/**
+ * Detect the JavaScript runtime environment without importing any external modules.
+ * Uses only built-in globals to avoid breaking in different environments.
+ */
+function detectRuntime(): string {
+ const global = globalThis as ExtendedGlobalThis;
+
+ // Check for Bun
+ if ('Bun' in global && typeof global.Bun !== 'undefined') {
+ return 'BUN';
+ }
+
+ // Check for Deno
+ if ('Deno' in global && typeof global.Deno !== 'undefined') {
+ return 'DENO';
+ }
+
+ // Check for Node.js
+ if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+ return 'NODEJS';
+ }
+
+ // Check for Cloudflare Workers
+ if (
+ 'caches' in global &&
+ typeof global.caches !== 'undefined' &&
+ 'WebSocketPair' in global &&
+ typeof global.WebSocketPair !== 'undefined'
+ ) {
+ return 'CLOUDFLARE_WORKERS';
+ }
+
+ // Check for Vercel Edge Runtime
+ if ('EdgeRuntime' in global && typeof global.EdgeRuntime !== 'undefined') {
+ return 'VERCEL_EDGE';
+ }
+
+ // Check for Service Worker
+ if (
+ 'ServiceWorkerGlobalScope' in global &&
+ typeof global.ServiceWorkerGlobalScope !== 'undefined'
+ ) {
+ const ServiceWorkerScope = global.ServiceWorkerGlobalScope;
+ if (ServiceWorkerScope && global instanceof ServiceWorkerScope) {
+ return 'SERVICE_WORKER';
+ }
+ }
+
+ // Check for Web Worker
+ if (
+ 'WorkerGlobalScope' in global &&
+ typeof global.WorkerGlobalScope !== 'undefined' &&
+ 'importScripts' in global &&
+ typeof global.importScripts === 'function'
+ ) {
+ return 'WEB_WORKER';
+ }
+
+ // Check for React Native
+ if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
+ return 'REACT_NATIVE';
+ }
+
+ // Check for Browser
+ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
+ return 'BROWSER';
+ }
+
+ // Fallback
+ return 'UNKNOWN';
+}
+
+// Detect once at module initialization
+const RUNTIME_ENV = detectRuntime();
+
export function getSessionHeaders(
provider: BaseComposioProvider<unknown, unknown, unknown> | undefined
) {
return {
- 'x-source': provider?.name || '@composio/core',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': provider?.name || 'unknown',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': RUNTIME_ENV,
'x-sdk-version': version,
};
}
diff --git a/ts/packages/core/test/core/session.test.ts b/ts/packages/core/test/core/session.test.ts
index 167457762..3985f612f 100644
--- a/ts/packages/core/test/core/session.test.ts
+++ b/ts/packages/core/test/core/session.test.ts
@@ -32,8 +32,9 @@ describe('Composio Session Management', () => {
'x-request-id': '1234567890',
'x-correlation-id': 'session-abc-123',
'x-custom-header': 'custom-value',
- 'x-source': 'MockProvider', // from provider
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'MockProvider', // from provider
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
@@ -75,16 +76,18 @@ describe('Composio Session Management', () => {
expect(headersA).toEqual({
'x-user-id': 'user-a',
'x-tenant-id': 'tenant-1',
- 'x-source': 'MockProvider',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'MockProvider',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
expect(headersB).toEqual({
'x-user-id': 'user-b',
'x-tenant-id': 'tenant-2',
- 'x-source': 'MockProvider',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'MockProvider',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
@@ -100,8 +103,9 @@ describe('Composio Session Management', () => {
// @ts-expect-error: access private config for test
const defaultHeaders = session.config.defaultHeaders;
expect(defaultHeaders).toEqual({
- 'x-source': 'MockProvider', // from provider
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'MockProvider', // from provider
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -114,8 +118,9 @@ describe('Session Headers Generation', () => {
const headers = getSessionHeaders(openAIProvider);
expect(headers).toEqual({
- 'x-source': 'openai',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -125,8 +130,9 @@ describe('Session Headers Generation', () => {
const headers = getSessionHeaders(mockProvider);
expect(headers).toEqual({
- 'x-source': 'MockProvider',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'MockProvider',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -135,8 +141,9 @@ describe('Session Headers Generation', () => {
const headers = getSessionHeaders(undefined);
expect(headers).toEqual({
- 'x-source': '@composio/core',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'unknown',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -148,8 +155,9 @@ describe('Session Headers Generation', () => {
const headers = getSessionHeaders(mockProvider);
expect(headers).toEqual({
- 'x-source': '@composio/core',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'unknown',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -168,8 +176,9 @@ describe('Session Headers Generation', () => {
expect(headers).toEqual({
'x-request-id': '1234567890',
'x-custom-header': 'custom-value',
- 'x-source': 'openai',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -186,8 +195,9 @@ describe('Session Headers Generation', () => {
expect(headers).toEqual({
'x-user-id': 'user-123',
'x-tenant-id': 'tenant-456',
- 'x-source': 'MockProvider',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'MockProvider',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -204,8 +214,9 @@ describe('Session Headers Generation', () => {
const headers = getDefaultHeaders(customHeaders, openAIProvider);
expect(headers).toEqual({
- 'x-source': 'openai', // session header takes precedence
- 'x-runtime': 'composio-v3-ts-sdk', // session header takes precedence
+ 'x-framework': 'openai', // session header takes precedence
+ 'x-source': 'TYPESCRIPT_SDK', // session header takes precedence
+ 'x-runtime': 'NODEJS', // session header takes precedence
'x-sdk-version': version, // session header takes precedence
'x-custom-header': 'custom-value', // custom header preserved
});
@@ -216,8 +227,9 @@ describe('Session Headers Generation', () => {
const headers = getDefaultHeaders(undefined, openAIProvider);
expect(headers).toEqual({
- 'x-source': 'openai',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -227,8 +239,9 @@ describe('Session Headers Generation', () => {
const headers = getDefaultHeaders({}, openAIProvider);
expect(headers).toEqual({
- 'x-source': 'openai',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -242,8 +255,9 @@ describe('Session Headers Generation', () => {
expect(headers).toEqual({
'x-request-id': '1234567890',
- 'x-source': '@composio/core',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'unknown',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -312,8 +326,9 @@ describe('Session Headers Configuration Integration', () => {
expect(sessionDefaultHeaders).toEqual({
'x-request-id': '1234567890',
'x-user-context': 'user-session',
- 'x-source': 'openai',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -352,10 +367,10 @@ describe('Session Headers Configuration Integration', () => {
// @ts-expect-error: access private config for test
const mockHeaders = sessionMock.config.defaultHeaders!;
- expect(openAIHeaders['x-source']).toBe('openai');
+ expect(openAIHeaders['x-framework']).toBe('openai');
expect(openAIHeaders['x-session']).toBe('openai-session');
- expect(mockHeaders['x-source']).toBe('MockProvider');
+ expect(mockHeaders['x-framework']).toBe('MockProvider');
expect(mockHeaders['x-session']).toBe('mock-session');
});
@@ -375,8 +390,9 @@ describe('Session Headers Configuration Integration', () => {
const sessionHeaders = session.config.defaultHeaders;
expect(sessionHeaders).toEqual({
- 'x-source': 'openai',
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai',
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
@@ -409,8 +425,9 @@ describe('Session Headers Configuration Integration', () => {
expect(sessionHeaders).toEqual({
'x-session-header': 'session-value',
'x-shared-header': 'session-shared-value', // session value takes precedence
- 'x-source': 'openai', // provider-specific header
- 'x-runtime': 'composio-v3-ts-sdk',
+ 'x-framework': 'openai', // provider-specific header
+ 'x-source': 'TYPESCRIPT_SDK',
+ 'x-runtime': 'NODEJS',
'x-sdk-version': version,
});
});
diff --git a/ts/packages/core/test/models/mcp.test.ts b/ts/packages/core/test/models/mcp.test.ts
index 9ca7ba6f7..d2edb9906 100644
--- a/ts/packages/core/test/models/mcp.test.ts
+++ b/ts/packages/core/test/models/mcp.test.ts
@@ -239,7 +239,7 @@ describe('MCP', () => {
describe('constructor', () => {
it('should create an instance successfully', () => {
expect(mcp).toBeInstanceOf(MCP);
- expect(telemetry.instrument).toHaveBeenCalledWith(mcp);
+ expect(telemetry.instrument).toHaveBeenCalledWith(mcp, 'MCP');
});
it('should store the client reference', () => {
diff --git a/ts/packages/core/test/models/toolkits.test.ts b/ts/packages/core/test/models/toolkits.test.ts
index 5d4de7461..50ba6ebff 100644
--- a/ts/packages/core/test/models/toolkits.test.ts
+++ b/ts/packages/core/test/models/toolkits.test.ts
@@ -101,7 +101,7 @@ describe('Toolkits', () => {
describe('constructor', () => {
it('should create an instance successfully', () => {
expect(toolkits).toBeInstanceOf(Toolkits);
- expect(telemetry.instrument).toHaveBeenCalledWith(toolkits);
+ expect(telemetry.instrument).toHaveBeenCalledWith(toolkits, 'Toolkits');
});
it('should store the client reference', () => {
diff --git a/ts/packages/core/test/models/triggers.test.ts b/ts/packages/core/test/models/triggers.test.ts
index 587592a4c..1cf8a5911 100644
--- a/ts/packages/core/test/models/triggers.test.ts
+++ b/ts/packages/core/test/models/triggers.test.ts
@@ -230,7 +230,7 @@ describe('Triggers', () => {
describe('constructor', () => {
it('should create an instance successfully', () => {
expect(triggers).toBeInstanceOf(Triggers);
- expect(telemetry.instrument).toHaveBeenCalledWith(triggers);
+ expect(telemetry.instrument).toHaveBeenCalledWith(triggers, 'Triggers');
});
it('should store the client reference', () => {
@@ -830,7 +830,7 @@ describe('Triggers', () => {
describe('telemetry integration', () => {
it('should instrument the class for telemetry', () => {
- expect(telemetry.instrument).toHaveBeenCalledWith(triggers);
+ expect(telemetry.instrument).toHaveBeenCalledWith(triggers, 'Triggers');
});
});
diff --git a/uv.lock b/uv.lock
index 7b085a501..2a078e431 100644
--- a/uv.lock
+++ b/uv.lock
@@ -468,7 +468,7 @@ wheels = [
[[package]]
name = "composio"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python" }
dependencies = [
{ name = "composio-client" },
@@ -517,7 +517,7 @@ dev = [
[[package]]
name = "composio-anthropic"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/anthropic" }
dependencies = [
{ name = "anthropic" },
@@ -549,7 +549,7 @@ wheels = [
[[package]]
name = "composio-crewai"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/crewai" }
dependencies = [
{ name = "composio" },
@@ -564,7 +564,7 @@ requires-dist = [
[[package]]
name = "composio-gemini"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/gemini" }
dependencies = [
{ name = "composio" },
@@ -579,7 +579,7 @@ requires-dist = [
[[package]]
name = "composio-google"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/google" }
dependencies = [
{ name = "composio" },
@@ -594,7 +594,7 @@ requires-dist = [
[[package]]
name = "composio-google-adk"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/google_adk" }
dependencies = [
{ name = "composio" },
@@ -609,7 +609,7 @@ requires-dist = [
[[package]]
name = "composio-langchain"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/langchain" }
dependencies = [
{ name = "composio" },
@@ -624,7 +624,7 @@ requires-dist = [
[[package]]
name = "composio-openai"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/openai" }
dependencies = [
{ name = "composio" },
@@ -639,7 +639,7 @@ requires-dist = [
[[package]]
name = "composio-openai-agents"
-version = "0.9.0"
+version = "0.9.1"
source = { virtual = "python/providers/openai_agents" }
dependencies = [
{ name = "composio" },