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 Ahamad committed
Oct 31, 2025 at 17:27 UTC
f88ab9936db11970de9eb7c7a6a3800e0333fc80
48 files changed
+313
-101
.changeset/fruity-times-stop.md
new
+5
@@ -0,0 +1,5 @@
1
+---
2
+'@composio/core': patch
3
+---
4
+
5
+Fix: SDK telemetry methods and request headers
package.json
+4
@@ -60,6 +60,10 @@
60
],
61
"ts/packages/**/*.{ts,tsx,js,jsx,json,md}": [
62
"prettier --write"
63
+ ],
64
+ "python/**/*.py": [
65
+ "ruff check --fix --config python/config/ruff.toml",
66
+ "ruff format --config python/config/ruff.toml"
67
]
68
}
69
}
python/composio/client/__init__.py
+98
-2
@@ -3,6 +3,8 @@ This module is a light wrapper around the auto-generated composio client.
3
"""
4
5
import contextvars
6
+import os
7
+import platform
8
import typing as t
9
from importlib.metadata import version
10
from uuid import uuid4
@@ -24,6 +26,93 @@ ComposioAPIError = APIError
26
APIEnvironment = te.Literal["production", "staging", "local"]
27
28
29
+def _get_python_implementation() -> str:
30
+ """
31
+ Get the Python implementation name.
32
+
33
+ Returns:
34
+ String identifier for Python implementation (CPYTHON, PYPY, JYTHON, IRONPYTHON, etc.)
35
+ """
36
+ impl = platform.python_implementation().upper()
37
+ return impl
38
+
39
+
40
+def _detect_runtime_environment() -> str:
41
+ """
42
+ Detect the runtime environment where the code is executing.
43
+
44
+ Returns a string identifier for the environment.
45
+ """
46
+ # Check for Google Colab
47
+ try:
48
+ import google.colab # type: ignore # noqa: F401
49
+
50
+ return "GOOGLE_COLAB"
51
+ except ImportError:
52
+ pass
53
+
54
+ # Check for Jupyter/IPython
55
+ try:
56
+ shell = get_ipython().__class__.__name__ # type: ignore # noqa: F821
57
+ if shell == "ZMQInteractiveShell":
58
+ return "JUPYTER_NOTEBOOK"
59
+ elif shell == "TerminalInteractiveShell":
60
+ return "IPYTHON"
61
+ except NameError:
62
+ pass
63
+
64
+ # Check for AWS Lambda
65
+ if os.environ.get("AWS_LAMBDA_FUNCTION_NAME"):
66
+ return "AWS_LAMBDA"
67
+
68
+ # Check for Google Cloud Functions
69
+ if os.environ.get("FUNCTION_NAME") or os.environ.get("K_SERVICE"):
70
+ return "GOOGLE_CLOUD_FUNCTION"
71
+
72
+ # Check for Azure Functions
73
+ if os.environ.get("FUNCTIONS_WORKER_RUNTIME"):
74
+ return "AZURE_FUNCTION"
75
+
76
+ # Check for Kaggle
77
+ if os.environ.get("KAGGLE_KERNEL_RUN_TYPE"):
78
+ return "KAGGLE"
79
+
80
+ # Check for Replit
81
+ if os.environ.get("REPL_ID") or os.environ.get("REPLIT_DB_URL"):
82
+ return "REPLIT"
83
+
84
+ # Check for GitHub Actions
85
+ if os.environ.get("GITHUB_ACTIONS"):
86
+ return "GITHUB_ACTIONS"
87
+
88
+ # Check for GitLab CI
89
+ if os.environ.get("GITLAB_CI"):
90
+ return "GITLAB_CI"
91
+
92
+ # Check for CircleCI
93
+ if os.environ.get("CIRCLECI"):
94
+ return "CIRCLECI"
95
+
96
+ # Check for Jenkins
97
+ if os.environ.get("JENKINS_HOME"):
98
+ return "JENKINS"
99
+
100
+ # Check for Docker
101
+ if os.path.exists("/.dockerenv") or os.path.exists("/run/.containerenv"):
102
+ return "DOCKER"
103
+
104
+ # Check if running in a container (generic)
105
+ try:
106
+ with open("/proc/1/cgroup", "r") as f:
107
+ if "docker" in f.read() or "containerd" in f.read():
108
+ return "CONTAINER"
109
+ except (FileNotFoundError, PermissionError):
110
+ pass
111
+
112
+ # Default to LOCAL for development environments
113
+ return "LOCAL"
114
+
115
+
116
class RequestContext(te.TypedDict):
117
id: te.NotRequired[t.Optional[str]]
118
provider: str
@@ -38,6 +127,11 @@ class HttpClient(BaseComposio, WithLogger):
127
request_ctx: contextvars.ContextVar[RequestContext]
128
not_given = NOT_GIVEN
129
130
+ # Detect once at class initialization
131
+ _runtime_env: str = (
132
+ f"{_detect_runtime_environment()}_{_get_python_implementation()}"
133
+ )
134
+
135
def __init__(
136
self,
137
*,
@@ -96,8 +190,10 @@ class HttpClient(BaseComposio, WithLogger):
190
ctx = self.request_ctx.get()
191
request.headers["x-request-id"] = ctx.get("id") or uuid4().hex
192
request.headers["x-framework"] = ctx["provider"]
99
- request.headers["x-source"] = "python"
193
+ request.headers["x-source"] = "PYTHON_SDK"
194
+ request.headers["x-runtime"] = HttpClient._runtime_env
195
+
196
try:
197
request.headers["x-sdk-version"] = version("composio")
198
except Exception:
103
- request.headers["x-sdk-version"] = "unknown"
199
+ request.headers["x-sdk-version"] = "unknwon"
python/examples/tools.py
+1
@@ -16,6 +16,7 @@ response = composio.tools.execute(
16
user_id="default",
17
slug="HACKERNEWS_GET_USER",
18
arguments={"username": "pg"},
19
+ version="20251023_00",
20
)
21
print(response)
22
python/providers/anthropic/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-anthropic"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your Anthropic LLMs."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/anthropic/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_anthropic",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Anthropic LLMs.",
python/providers/autogen/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-autogen"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your autogen agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/autogen/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_autogen",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Autogen agent.",
python/providers/crewai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-crewai"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your CrewAI agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/crewai/setup.py
+1
-1
@@ -6,7 +6,7 @@ from setuptools import setup
6
7
setup(
8
name="composio_crewai",
9
- version="0.9.0",
9
+ version="0.9.1",
10
author="Composio",
11
author_email="tech@composio.dev",
12
description="Use Composio to get an array of tools with your CrewAI agent.",
python/providers/gemini/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-gemini"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your Gemini agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/gemini/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_gemini",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Gemini agent.",
python/providers/google/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-google"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/google/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_google",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/google_adk/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-google-adk"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/google_adk/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_google_adk",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/langchain/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-langchain"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your Langchain agent."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/langchain/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_langchain",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Langchain agent.",
python/providers/langgraph/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-langgraph"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/langgraph/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_langgraph",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools with LangGraph Agent Workflows",
python/providers/llamaindex/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-llamaindex"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/llamaindex/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_llamaindex",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
python/providers/openai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-openai"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get an array of tools with your OpenAI Function Call."
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/openai/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_openai",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your OpenAI Function Call.",
python/providers/openai_agents/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-openai-agents"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5
readme = "README.md"
6
requires-python = ">=3.9,<4"
python/providers/openai_agents/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9
setup(
10
name="composio_openai_agents",
11
- version="0.9.0",
11
+ version="0.9.1",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of strongly typed tools for OpenAI Agents",
python/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio"
3
-version = "0.9.0"
3
+version = "0.9.1"
4
description = "SDK for integrating Composio with your applications."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
ts/examples/tools/src/index.ts
+3
-2
@@ -17,7 +17,7 @@ import path from 'path';
17
*/
18
const composio = new Composio({
19
apiKey: process.env.COMPOSIO_API_KEY,
20
- allowTracking: false
20
+ allowTracking: false,
21
});
22
23
/**
@@ -29,6 +29,7 @@ async function main() {
29
30
console.log('🔄 Uploading file...');
31
const result = await composio.tools.execute('GOOGLEDRIVE_UPLOAD_FILE', {
32
+ dangerouslySkipVersionCheck: true,
33
arguments: {
34
file_to_upload: path.join(__dirname, 'image.png'),
35
},
@@ -39,6 +40,7 @@ async function main() {
40
41
console.log('🔄 Downloading file...');
42
const result2 = await composio.tools.execute('GOOGLEDRIVE_DOWNLOAD_FILE', {
43
+ dangerouslySkipVersionCheck: true,
44
arguments: {
45
file_id: (result.data.response_data as unknown as { id: string }).id,
46
},
@@ -46,7 +48,6 @@ async function main() {
48
});
49
console.log('✅ File downloaded successfully...');
50
console.log(JSON.stringify(result2, null, 2));
49
-
51
} catch (error) {
52
console.error('❌ Error running example:', error);
53
}
ts/packages/core/src/composio.ts
+5
-2
@@ -276,9 +276,12 @@ export class Composio<
276
});
277
}
278
// instrument the composio instance
279
- telemetry.instrument(this);
279
+ telemetry.instrument(this, 'Composio');
280
// instrument the provider since we are not using the provider class directly
281
- telemetry.instrument(this.provider);
281
+ telemetry.instrument(
282
+ this.provider,
283
+ this.provider.name ?? this.provider.constructor.name ?? 'unknown'
284
+ );
285
286
// Check for the latest version of the Composio SDK from NPM.
287
if (!this.config.disableVersionCheck) {
ts/packages/core/src/models/AuthConfigs.ts
+1
-6
@@ -7,7 +7,6 @@
7
*/
8
import ComposioClient from '@composio/client';
9
import {
10
- AuthConfigRetrieveResponse as ComposioAuthConfigRetrieveResponse,
10
AuthConfigDeleteResponse,
11
AuthConfigUpdateResponse,
12
AuthConfigUpdateStatusResponse,
@@ -16,19 +15,15 @@ import {
15
AuthConfigListParams,
16
AuthConfigListParamsSchema,
17
AuthConfigListResponse,
19
- AuthConfigListResponseSchema,
18
AuthConfigRetrieveResponse,
21
- AuthConfigRetrieveResponseSchema,
19
AuthConfigUpdateParams,
20
AuthConfigUpdateParamsSchema,
21
CreateAuthConfigParams,
22
CreateAuthConfigParamsSchema,
23
CreateAuthConfigResponse,
27
- CreateAuthConfigResponseSchema,
24
} from '../types/authConfigs.types';
25
import { ValidationError } from '../errors/ValidationErrors';
26
import { telemetry } from '../telemetry/Telemetry';
31
-import logger from '../utils/logger';
27
import {
28
transformAuthConfigListResponse,
29
transformAuthConfigRetrieveResponse,
@@ -45,7 +40,7 @@ export class AuthConfigs {
40
41
constructor(client: ComposioClient) {
42
this.client = client;
48
- telemetry.instrument(this);
43
+ telemetry.instrument(this, 'AuthConfigs');
44
}
45
46
/**
ts/packages/core/src/models/ConnectedAccounts.ts
+1
-1
@@ -49,7 +49,7 @@ export class ConnectedAccounts {
49
50
constructor(client: ComposioClient) {
51
this.client = client;
52
- telemetry.instrument(this);
52
+ telemetry.instrument(this, 'ConnectedAccounts');
53
}
54
55
/**
ts/packages/core/src/models/ConnectionRequest.ts
+1
-1
@@ -42,7 +42,7 @@ export function createConnectionRequest(
42
redirectUrl,
43
};
44
45
- telemetry.instrument(state);
45
+ telemetry.instrument(state, 'ConnectionRequest');
46
47
/**
48
* Waits for the connection request to complete and become active.
ts/packages/core/src/models/CustomTools.ts
+1
-1
@@ -44,7 +44,7 @@ export class CustomTools {
44
}
45
this.client = client;
46
this.customToolsRegistry = new Map();
47
- telemetry.instrument(this);
47
+ telemetry.instrument(this, 'CustomTools');
48
}
49
50
/**
ts/packages/core/src/models/Files.ts
+1
-1
@@ -12,7 +12,7 @@ import { telemetry } from '../telemetry/Telemetry';
12
13
export class Files {
14
constructor(private readonly client: ComposioClient) {
15
- telemetry.instrument(this);
15
+ telemetry.instrument(this, 'Files');
16
}
17
18
/**
ts/packages/core/src/models/MCP.experimental.ts
+1
-1
@@ -48,7 +48,7 @@ export class MCP {
48
49
constructor(client: ComposioClient) {
50
this.client = client;
51
- telemetry.instrument(this);
51
+ telemetry.instrument(this, 'MCP');
52
}
53
54
/**
ts/packages/core/src/models/MCP.ts
+3
-3
@@ -46,6 +46,7 @@ import {
46
import { Toolkits } from './Toolkits';
47
import { ToolkitAuthFieldsResponse } from '../types/toolkit.types';
48
import { ConnectionRequest } from '../types/connectionRequest.types';
49
+import logger from '../utils/logger';
50
51
/**
52
* Extract the MCP response type from a provider.
@@ -73,7 +74,7 @@ export class MCP<TProvider extends BaseComposioProvider<unknown, unknown, unknow
74
this.client = client;
75
this.provider = provider;
76
this.toolkits = new Toolkits(client);
76
- telemetry.instrument(this);
77
+ telemetry.instrument(this, 'MCP');
78
}
79
80
/**
@@ -169,7 +170,6 @@ export class MCP<TProvider extends BaseComposioProvider<unknown, unknown, unknow
170
// If we reach here, server exists
171
const tools = mcpServer.tools?.sort()!;
172
const sortedCurrentTools = serverConfig.flatMap(config => config.allowedTools).sort();
172
- console.log(tools, sortedCurrentTools, 'tools');
173
if (tools?.length > 0 && !tools.every((tool, index) => tool === sortedCurrentTools[index])) {
174
throw new ValidationError('MCP server with this name already exists with different tools', {
175
meta: { serverName: name },
@@ -852,7 +852,7 @@ export class MCP<TProvider extends BaseComposioProvider<unknown, unknown, unknow
852
limit: 10,
853
});
854
} catch (error) {
855
- console.error(error);
855
+ logger.error(error);
856
throw new ValidationError('Failed to search MCP servers by name', {
857
cause: error,
858
});
ts/packages/core/src/models/ToolRouter.experimental.ts
+1
-1
@@ -12,7 +12,7 @@ import { transform } from '../utils/transform';
12
export class ToolRouter {
13
constructor(private client: ComposioClient) {
14
this.client = client;
15
- telemetry.instrument(this);
15
+ telemetry.instrument(this, 'ToolRouter');
16
}
17
18
/**
ts/packages/core/src/models/Toolkits.ts
+1
-1
@@ -34,7 +34,7 @@ export class Toolkits {
34
constructor(client: ComposioClient) {
35
this.client = client;
36
this.authorize = this.authorize.bind(this);
37
- telemetry.instrument(this);
37
+ telemetry.instrument(this, 'Toolkits');
38
}
39
/**
40
* Retrieves a list of toolkits based on the provided query parameters.
ts/packages/core/src/models/Tools.ts
+1
-1
@@ -86,7 +86,7 @@ export class Tools<
86
this.getRawComposioToolBySlug = this.getRawComposioToolBySlug.bind(this);
87
this.getRawComposioTools = this.getRawComposioTools.bind(this);
88
89
- telemetry.instrument(this);
89
+ telemetry.instrument(this, 'Tools');
90
}
91
92
/**
ts/packages/core/src/models/Triggers.ts
+1
-1
@@ -48,7 +48,7 @@ export class Triggers<TProvider extends BaseComposioProvider<unknown, unknown, u
48
this.client = client;
49
this.pusherService = new PusherService(client);
50
this.toolkitVersions = config?.toolkitVersions ?? 'latest';
51
- telemetry.instrument(this);
51
+ telemetry.instrument(this, 'Triggers');
52
}
53
54
/**
ts/packages/core/src/services/pusher/Pusher.ts
+1
-1
@@ -26,7 +26,7 @@ export class PusherService {
26
this.composioClient = client;
27
this.pusherBaseURL = client.baseURL;
28
this.apiKey = client.apiKey ?? process.env.COMPOSIO_API_KEY ?? '';
29
- telemetry.instrument(this);
29
+ telemetry.instrument(this, 'PusherService');
30
}
31
32
/**
ts/packages/core/src/telemetry/Telemetry.ts
+2
-2
@@ -95,8 +95,8 @@ export class TelemetryTransport {
95
descriptor.value.constructor.name === 'AsyncFunction'
96
);
97
});
98
- // use the constructor name if available, otherwise use the file name
99
- const instrumentedClassName = (instance.constructor?.name || fileName) ?? 'unknown';
98
+ // prioritize the explicitly passed class name, then fall back to constructor name, then 'unknown'
99
+ const instrumentedClassName = fileName ?? instance.constructor?.name ?? 'unknown';
100
101
for (const name of methodNames) {
102
const originalMethod = (instance as unknown as Record<string, Function>)[name] as (
ts/packages/core/src/utils/session.ts
+92
-2
@@ -2,12 +2,102 @@ import { BaseComposioProvider } from '../provider/BaseProvider';
2
import { version } from '../../package.json';
3
import { ComposioRequestHeaders } from '../types/composio.types';
4
5
+/**
6
+ * Extended globalThis interface for runtime detection
7
+ */
8
+interface ExtendedGlobalThis {
9
+ Bun?: unknown;
10
+ Deno?: unknown;
11
+ caches?: unknown;
12
+ WebSocketPair?: unknown;
13
+ EdgeRuntime?: unknown;
14
+ ServiceWorkerGlobalScope?: new () => unknown;
15
+ WorkerGlobalScope?: new () => unknown;
16
+ importScripts?: (url: string) => void;
17
+}
18
+
19
+/**
20
+ * Detect the JavaScript runtime environment without importing any external modules.
21
+ * Uses only built-in globals to avoid breaking in different environments.
22
+ */
23
+function detectRuntime(): string {
24
+ const global = globalThis as ExtendedGlobalThis;
25
+
26
+ // Check for Bun
27
+ if ('Bun' in global && typeof global.Bun !== 'undefined') {
28
+ return 'BUN';
29
+ }
30
+
31
+ // Check for Deno
32
+ if ('Deno' in global && typeof global.Deno !== 'undefined') {
33
+ return 'DENO';
34
+ }
35
+
36
+ // Check for Node.js
37
+ if (typeof process !== 'undefined' && process.versions && process.versions.node) {
38
+ return 'NODEJS';
39
+ }
40
+
41
+ // Check for Cloudflare Workers
42
+ if (
43
+ 'caches' in global &&
44
+ typeof global.caches !== 'undefined' &&
45
+ 'WebSocketPair' in global &&
46
+ typeof global.WebSocketPair !== 'undefined'
47
+ ) {
48
+ return 'CLOUDFLARE_WORKERS';
49
+ }
50
+
51
+ // Check for Vercel Edge Runtime
52
+ if ('EdgeRuntime' in global && typeof global.EdgeRuntime !== 'undefined') {
53
+ return 'VERCEL_EDGE';
54
+ }
55
+
56
+ // Check for Service Worker
57
+ if (
58
+ 'ServiceWorkerGlobalScope' in global &&
59
+ typeof global.ServiceWorkerGlobalScope !== 'undefined'
60
+ ) {
61
+ const ServiceWorkerScope = global.ServiceWorkerGlobalScope;
62
+ if (ServiceWorkerScope && global instanceof ServiceWorkerScope) {
63
+ return 'SERVICE_WORKER';
64
+ }
65
+ }
66
+
67
+ // Check for Web Worker
68
+ if (
69
+ 'WorkerGlobalScope' in global &&
70
+ typeof global.WorkerGlobalScope !== 'undefined' &&
71
+ 'importScripts' in global &&
72
+ typeof global.importScripts === 'function'
73
+ ) {
74
+ return 'WEB_WORKER';
75
+ }
76
+
77
+ // Check for React Native
78
+ if (typeof navigator !== 'undefined' && navigator.product === 'ReactNative') {
79
+ return 'REACT_NATIVE';
80
+ }
81
+
82
+ // Check for Browser
83
+ if (typeof window !== 'undefined' && typeof document !== 'undefined') {
84
+ return 'BROWSER';
85
+ }
86
+
87
+ // Fallback
88
+ return 'UNKNOWN';
89
+}
90
+
91
+// Detect once at module initialization
92
+const RUNTIME_ENV = detectRuntime();
93
+
94
export function getSessionHeaders(
95
provider: BaseComposioProvider<unknown, unknown, unknown> | undefined
96
) {
97
return {
9
- 'x-source': provider?.name || '@composio/core',
10
- 'x-runtime': 'composio-v3-ts-sdk',
98
+ 'x-framework': provider?.name || 'unknown',
99
+ 'x-source': 'TYPESCRIPT_SDK',
100
+ 'x-runtime': RUNTIME_ENV,
101
'x-sdk-version': version,
102
};
103
}
ts/packages/core/test/core/session.test.ts
+53
-36
@@ -32,8 +32,9 @@ describe('Composio Session Management', () => {
32
'x-request-id': '1234567890',
33
'x-correlation-id': 'session-abc-123',
34
'x-custom-header': 'custom-value',
35
- 'x-source': 'MockProvider', // from provider
36
- 'x-runtime': 'composio-v3-ts-sdk',
35
+ 'x-framework': 'MockProvider', // from provider
36
+ 'x-source': 'TYPESCRIPT_SDK',
37
+ 'x-runtime': 'NODEJS',
38
'x-sdk-version': version,
39
});
40
@@ -75,16 +76,18 @@ describe('Composio Session Management', () => {
76
expect(headersA).toEqual({
77
'x-user-id': 'user-a',
78
'x-tenant-id': 'tenant-1',
78
- 'x-source': 'MockProvider',
79
- 'x-runtime': 'composio-v3-ts-sdk',
79
+ 'x-framework': 'MockProvider',
80
+ 'x-source': 'TYPESCRIPT_SDK',
81
+ 'x-runtime': 'NODEJS',
82
'x-sdk-version': version,
83
});
84
85
expect(headersB).toEqual({
86
'x-user-id': 'user-b',
87
'x-tenant-id': 'tenant-2',
86
- 'x-source': 'MockProvider',
87
- 'x-runtime': 'composio-v3-ts-sdk',
88
+ 'x-framework': 'MockProvider',
89
+ 'x-source': 'TYPESCRIPT_SDK',
90
+ 'x-runtime': 'NODEJS',
91
'x-sdk-version': version,
92
});
93
@@ -100,8 +103,9 @@ describe('Composio Session Management', () => {
103
// @ts-expect-error: access private config for test
104
const defaultHeaders = session.config.defaultHeaders;
105
expect(defaultHeaders).toEqual({
103
- 'x-source': 'MockProvider', // from provider
104
- 'x-runtime': 'composio-v3-ts-sdk',
106
+ 'x-framework': 'MockProvider', // from provider
107
+ 'x-source': 'TYPESCRIPT_SDK',
108
+ 'x-runtime': 'NODEJS',
109
'x-sdk-version': version,
110
});
111
});
@@ -114,8 +118,9 @@ describe('Session Headers Generation', () => {
118
const headers = getSessionHeaders(openAIProvider);
119
120
expect(headers).toEqual({
117
- 'x-source': 'openai',
118
- 'x-runtime': 'composio-v3-ts-sdk',
121
+ 'x-framework': 'openai',
122
+ 'x-source': 'TYPESCRIPT_SDK',
123
+ 'x-runtime': 'NODEJS',
124
'x-sdk-version': version,
125
});
126
});
@@ -125,8 +130,9 @@ describe('Session Headers Generation', () => {
130
const headers = getSessionHeaders(mockProvider);
131
132
expect(headers).toEqual({
128
- 'x-source': 'MockProvider',
129
- 'x-runtime': 'composio-v3-ts-sdk',
133
+ 'x-framework': 'MockProvider',
134
+ 'x-source': 'TYPESCRIPT_SDK',
135
+ 'x-runtime': 'NODEJS',
136
'x-sdk-version': version,
137
});
138
});
@@ -135,8 +141,9 @@ describe('Session Headers Generation', () => {
141
const headers = getSessionHeaders(undefined);
142
143
expect(headers).toEqual({
138
- 'x-source': '@composio/core',
139
- 'x-runtime': 'composio-v3-ts-sdk',
144
+ 'x-framework': 'unknown',
145
+ 'x-source': 'TYPESCRIPT_SDK',
146
+ 'x-runtime': 'NODEJS',
147
'x-sdk-version': version,
148
});
149
});
@@ -148,8 +155,9 @@ describe('Session Headers Generation', () => {
155
const headers = getSessionHeaders(mockProvider);
156
157
expect(headers).toEqual({
151
- 'x-source': '@composio/core',
152
- 'x-runtime': 'composio-v3-ts-sdk',
158
+ 'x-framework': 'unknown',
159
+ 'x-source': 'TYPESCRIPT_SDK',
160
+ 'x-runtime': 'NODEJS',
161
'x-sdk-version': version,
162
});
163
});
@@ -168,8 +176,9 @@ describe('Session Headers Generation', () => {
176
expect(headers).toEqual({
177
'x-request-id': '1234567890',
178
'x-custom-header': 'custom-value',
171
- 'x-source': 'openai',
172
- 'x-runtime': 'composio-v3-ts-sdk',
179
+ 'x-framework': 'openai',
180
+ 'x-source': 'TYPESCRIPT_SDK',
181
+ 'x-runtime': 'NODEJS',
182
'x-sdk-version': version,
183
});
184
});
@@ -186,8 +195,9 @@ describe('Session Headers Generation', () => {
195
expect(headers).toEqual({
196
'x-user-id': 'user-123',
197
'x-tenant-id': 'tenant-456',
189
- 'x-source': 'MockProvider',
190
- 'x-runtime': 'composio-v3-ts-sdk',
198
+ 'x-framework': 'MockProvider',
199
+ 'x-source': 'TYPESCRIPT_SDK',
200
+ 'x-runtime': 'NODEJS',
201
'x-sdk-version': version,
202
});
203
});
@@ -204,8 +214,9 @@ describe('Session Headers Generation', () => {
214
const headers = getDefaultHeaders(customHeaders, openAIProvider);
215
216
expect(headers).toEqual({
207
- 'x-source': 'openai', // session header takes precedence
208
- 'x-runtime': 'composio-v3-ts-sdk', // session header takes precedence
217
+ 'x-framework': 'openai', // session header takes precedence
218
+ 'x-source': 'TYPESCRIPT_SDK', // session header takes precedence
219
+ 'x-runtime': 'NODEJS', // session header takes precedence
220
'x-sdk-version': version, // session header takes precedence
221
'x-custom-header': 'custom-value', // custom header preserved
222
});
@@ -216,8 +227,9 @@ describe('Session Headers Generation', () => {
227
const headers = getDefaultHeaders(undefined, openAIProvider);
228
229
expect(headers).toEqual({
219
- 'x-source': 'openai',
220
- 'x-runtime': 'composio-v3-ts-sdk',
230
+ 'x-framework': 'openai',
231
+ 'x-source': 'TYPESCRIPT_SDK',
232
+ 'x-runtime': 'NODEJS',
233
'x-sdk-version': version,
234
});
235
});
@@ -227,8 +239,9 @@ describe('Session Headers Generation', () => {
239
const headers = getDefaultHeaders({}, openAIProvider);
240
241
expect(headers).toEqual({
230
- 'x-source': 'openai',
231
- 'x-runtime': 'composio-v3-ts-sdk',
242
+ 'x-framework': 'openai',
243
+ 'x-source': 'TYPESCRIPT_SDK',
244
+ 'x-runtime': 'NODEJS',
245
'x-sdk-version': version,
246
});
247
});
@@ -242,8 +255,9 @@ describe('Session Headers Generation', () => {
255
256
expect(headers).toEqual({
257
'x-request-id': '1234567890',
245
- 'x-source': '@composio/core',
246
- 'x-runtime': 'composio-v3-ts-sdk',
258
+ 'x-framework': 'unknown',
259
+ 'x-source': 'TYPESCRIPT_SDK',
260
+ 'x-runtime': 'NODEJS',
261
'x-sdk-version': version,
262
});
263
});
@@ -312,8 +326,9 @@ describe('Session Headers Configuration Integration', () => {
326
expect(sessionDefaultHeaders).toEqual({
327
'x-request-id': '1234567890',
328
'x-user-context': 'user-session',
315
- 'x-source': 'openai',
316
- 'x-runtime': 'composio-v3-ts-sdk',
329
+ 'x-framework': 'openai',
330
+ 'x-source': 'TYPESCRIPT_SDK',
331
+ 'x-runtime': 'NODEJS',
332
'x-sdk-version': version,
333
});
334
});
@@ -352,10 +367,10 @@ describe('Session Headers Configuration Integration', () => {
367
// @ts-expect-error: access private config for test
368
const mockHeaders = sessionMock.config.defaultHeaders!;
369
355
- expect(openAIHeaders['x-source']).toBe('openai');
370
+ expect(openAIHeaders['x-framework']).toBe('openai');
371
expect(openAIHeaders['x-session']).toBe('openai-session');
372
358
- expect(mockHeaders['x-source']).toBe('MockProvider');
373
+ expect(mockHeaders['x-framework']).toBe('MockProvider');
374
expect(mockHeaders['x-session']).toBe('mock-session');
375
});
376
@@ -375,8 +390,9 @@ describe('Session Headers Configuration Integration', () => {
390
const sessionHeaders = session.config.defaultHeaders;
391
392
expect(sessionHeaders).toEqual({
378
- 'x-source': 'openai',
379
- 'x-runtime': 'composio-v3-ts-sdk',
393
+ 'x-framework': 'openai',
394
+ 'x-source': 'TYPESCRIPT_SDK',
395
+ 'x-runtime': 'NODEJS',
396
'x-sdk-version': version,
397
});
398
});
@@ -409,8 +425,9 @@ describe('Session Headers Configuration Integration', () => {
425
expect(sessionHeaders).toEqual({
426
'x-session-header': 'session-value',
427
'x-shared-header': 'session-shared-value', // session value takes precedence
412
- 'x-source': 'openai', // provider-specific header
413
- 'x-runtime': 'composio-v3-ts-sdk',
428
+ 'x-framework': 'openai', // provider-specific header
429
+ 'x-source': 'TYPESCRIPT_SDK',
430
+ 'x-runtime': 'NODEJS',
431
'x-sdk-version': version,
432
});
433
});
ts/packages/core/test/models/mcp.test.ts
+1
-1
@@ -239,7 +239,7 @@ describe('MCP', () => {
239
describe('constructor', () => {
240
it('should create an instance successfully', () => {
241
expect(mcp).toBeInstanceOf(MCP);
242
- expect(telemetry.instrument).toHaveBeenCalledWith(mcp);
242
+ expect(telemetry.instrument).toHaveBeenCalledWith(mcp, 'MCP');
243
});
244
245
it('should store the client reference', () => {
ts/packages/core/test/models/toolkits.test.ts
+1
-1
@@ -101,7 +101,7 @@ describe('Toolkits', () => {
101
describe('constructor', () => {
102
it('should create an instance successfully', () => {
103
expect(toolkits).toBeInstanceOf(Toolkits);
104
- expect(telemetry.instrument).toHaveBeenCalledWith(toolkits);
104
+ expect(telemetry.instrument).toHaveBeenCalledWith(toolkits, 'Toolkits');
105
});
106
107
it('should store the client reference', () => {
ts/packages/core/test/models/triggers.test.ts
+2
-2
@@ -230,7 +230,7 @@ describe('Triggers', () => {
230
describe('constructor', () => {
231
it('should create an instance successfully', () => {
232
expect(triggers).toBeInstanceOf(Triggers);
233
- expect(telemetry.instrument).toHaveBeenCalledWith(triggers);
233
+ expect(telemetry.instrument).toHaveBeenCalledWith(triggers, 'Triggers');
234
});
235
236
it('should store the client reference', () => {
@@ -830,7 +830,7 @@ describe('Triggers', () => {
830
831
describe('telemetry integration', () => {
832
it('should instrument the class for telemetry', () => {
833
- expect(telemetry.instrument).toHaveBeenCalledWith(triggers);
833
+ expect(telemetry.instrument).toHaveBeenCalledWith(triggers, 'Triggers');
834
});
835
});
836
uv.lock
+9
-9
@@ -468,7 +468,7 @@ wheels = [
468
469
[[package]]
470
name = "composio"
471
-version = "0.9.0"
471
+version = "0.9.1"
472
source = { virtual = "python" }
473
dependencies = [
474
{ name = "composio-client" },
@@ -517,7 +517,7 @@ dev = [
517
518
[[package]]
519
name = "composio-anthropic"
520
-version = "0.9.0"
520
+version = "0.9.1"
521
source = { virtual = "python/providers/anthropic" }
522
dependencies = [
523
{ name = "anthropic" },
@@ -549,7 +549,7 @@ wheels = [
549
550
[[package]]
551
name = "composio-crewai"
552
-version = "0.9.0"
552
+version = "0.9.1"
553
source = { virtual = "python/providers/crewai" }
554
dependencies = [
555
{ name = "composio" },
@@ -564,7 +564,7 @@ requires-dist = [
564
565
[[package]]
566
name = "composio-gemini"
567
-version = "0.9.0"
567
+version = "0.9.1"
568
source = { virtual = "python/providers/gemini" }
569
dependencies = [
570
{ name = "composio" },
@@ -579,7 +579,7 @@ requires-dist = [
579
580
[[package]]
581
name = "composio-google"
582
-version = "0.9.0"
582
+version = "0.9.1"
583
source = { virtual = "python/providers/google" }
584
dependencies = [
585
{ name = "composio" },
@@ -594,7 +594,7 @@ requires-dist = [
594
595
[[package]]
596
name = "composio-google-adk"
597
-version = "0.9.0"
597
+version = "0.9.1"
598
source = { virtual = "python/providers/google_adk" }
599
dependencies = [
600
{ name = "composio" },
@@ -609,7 +609,7 @@ requires-dist = [
609
610
[[package]]
611
name = "composio-langchain"
612
-version = "0.9.0"
612
+version = "0.9.1"
613
source = { virtual = "python/providers/langchain" }
614
dependencies = [
615
{ name = "composio" },
@@ -624,7 +624,7 @@ requires-dist = [
624
625
[[package]]
626
name = "composio-openai"
627
-version = "0.9.0"
627
+version = "0.9.1"
628
source = { virtual = "python/providers/openai" }
629
dependencies = [
630
{ name = "composio" },
@@ -639,7 +639,7 @@ requires-dist = [
639
640
[[package]]
641
name = "composio-openai-agents"
642
-version = "0.9.0"
642
+version = "0.9.1"
643
source = { virtual = "python/providers/openai_agents" }
644
dependencies = [
645
{ name = "composio" },