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

next
py 99 lines 4.05 KB
Raw
1 """
2 Utilities for handling toolkit versions.
3 """
4
5 import os
6 import typing as t
7
8 from composio.core.types import ToolkitVersion, ToolkitVersionParam, ToolkitVersions
9
10
11 def normalize_toolkit_slug(toolkit_slug: str) -> str:
12 """
13 Canonicalizes a toolkit slug into the form used as a version-map key.
14
15 Toolkit slugs are matched case-insensitively. This is the single source of
16 truth for that rule: every write into a version map (env vars, user-supplied
17 dicts) and every read out of one MUST go through this helper so the two sides
18 can never drift apart and silently miss a configured pin.
19
20 Kept intentionally equivalent to the TypeScript SDK's ``normalizeToolkitSlug``
21 (see ts/packages/core/src/utils/toolkitVersion.ts).
22
23 :param toolkit_slug: The slug/name of the toolkit, in any casing
24 :return: The normalized (lowercase) slug used as a version-map key
25 """
26 return toolkit_slug.lower()
27
28
29 def get_toolkit_version(
30 toolkit_slug: str, toolkit_versions: t.Optional[ToolkitVersionParam] = None
31 ) -> ToolkitVersion:
32 """
33 Gets the version for a specific toolkit based on the provided toolkit versions configuration.
34
35 :param toolkit_slug: The slug/name of the toolkit to get the version for
36 :param toolkit_versions: Optional toolkit versions configuration (string for global version
37 or dict mapping toolkit slugs to versions)
38 :return: The toolkit version to use - either the specific version from config, or 'latest' as fallback
39 """
40 # If toolkit_versions is a string, use it as a global version for all toolkits
41 if isinstance(toolkit_versions, str):
42 return toolkit_versions
43
44 # If toolkit_versions is a dict mapping, look up the specific toolkit version.
45 # The map is keyed by normalized slugs, so normalize the lookup too
46 # (see normalize_toolkit_slug for why).
47 if isinstance(toolkit_versions, dict) and len(toolkit_versions) > 0:
48 return toolkit_versions.get(normalize_toolkit_slug(toolkit_slug), "latest")
49
50 # Else use 'latest'
51 return "latest"
52
53
54 def get_toolkit_versions(
55 default_versions: t.Optional[ToolkitVersionParam] = None,
56 ) -> ToolkitVersionParam:
57 """
58 Gets toolkit versions configuration by merging environment variables, user-provided defaults, and fallbacks.
59
60 Priority order:
61 1. If default_versions is a string, use it as a global version for all toolkits
62 2. User-provided toolkit version mappings (default_versions dict)
63 3. Environment variables (COMPOSIO_TOOLKIT_VERSION_<TOOLKIT_NAME>)
64 4. Fallback to 'latest' if no versions are configured
65
66 :param default_versions: Optional default versions configuration (string for global version or dict mapping toolkit names to versions)
67 :return: Toolkit versions configuration - either a string for global version or dict mapping toolkit names to versions
68 """
69 # If already set by user as a string, use it as global version for all toolkits
70 if isinstance(default_versions, str):
71 return default_versions
72
73 # Check if there are envs similar to COMPOSIO_TOOLKIT_VERSION_GITHUB then extract the toolkit name
74 toolkit_versions_from_env: ToolkitVersions = {}
75 for key, value in os.environ.items():
76 if key.startswith("COMPOSIO_TOOLKIT_VERSION_"):
77 toolkit_name = key.replace("COMPOSIO_TOOLKIT_VERSION_", "")
78 toolkit_versions_from_env[normalize_toolkit_slug(toolkit_name)] = value
79
80 # Normalize keys via normalize_toolkit_slug (the same helper the lookup uses);
81 # user-provided values override env.
82 user_provided_toolkit_versions: ToolkitVersions = {}
83 if default_versions and isinstance(default_versions, dict):
84 user_provided_toolkit_versions = {
85 normalize_toolkit_slug(key): value
86 for key, value in default_versions.items()
87 }
88
89 # Final toolkit versions
90 toolkit_versions = {
91 **toolkit_versions_from_env,
92 **user_provided_toolkit_versions,
93 }
94
95 # If the toolkit_versions are empty, use 'latest'
96 if len(toolkit_versions) == 0:
97 return "latest"
98
99 return toolkit_versions