Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
// GENERATED by scripts/build-python-helpers.ts — do not edit; edit the .py source.
// Source: src/workbench/python-helpers/composio_helper.py
export const PYTHON_WORKBENCH_HELPER_SOURCE =
'import json\nimport os\nimport random\nimport time\nimport urllib.error\nimport urllib.parse\nimport urllib.request\nimport uuid\nfrom typing import Any, Dict, Literal, Optional\n\n\n# Config is injected by the SDK via an `_INTERNAL` dict in a prologue prepended\n# at runtime. When running this file directly (e.g. pytest), default to empty.\ntry:\n _INTERNAL\nexcept NameError:\n _INTERNAL = {}\n\n\nDEFAULT_INVOKE_LLM_MODEL = _INTERNAL.get("invoke_llm_model", "openai/gpt-oss-120b")\nRATE_LIMIT_PATTERNS = (\n "rate limit",\n "ratelimit",\n "too many requests",\n "quota exceeded",\n "resource exhausted",\n)\n\n\ndef _read_env(name, default=None):\n value = os.environ.get(name)\n return default if value is None or value == "" else value\n\n\ndef _require_value(value, label):\n if value is None or value == "":\n raise RuntimeError("%s is required" % label)\n return value\n\n\ndef _request_id():\n return str(uuid.uuid4())\n\n\ndef _session_execute_url():\n backend_url = _read_env("BACKEND_URL", "https://backend.composio.dev").rstrip("/")\n session_id = _require_value(\n _read_env("COMPOSIO_TOOLROUTER_SESSION_ID"),\n "COMPOSIO_TOOLROUTER_SESSION_ID",\n )\n encoded_session_id = urllib.parse.quote(session_id, safe="")\n return "%s/api/v3/tool_router/session/%s/execute" % (backend_url, encoded_session_id)\n\n\ndef _session_proxy_execute_url():\n backend_url = _read_env("BACKEND_URL", "https://backend.composio.dev").rstrip("/")\n session_id = _require_value(\n _read_env("COMPOSIO_TOOLROUTER_SESSION_ID"),\n "COMPOSIO_TOOLROUTER_SESSION_ID",\n )\n encoded_session_id = urllib.parse.quote(session_id, safe="")\n return "%s/api/v3/tool_router/session/%s/proxy_execute" % (\n backend_url,\n encoded_session_id,\n )\n\n\ndef _post_json(url, headers, payload, timeout=120):\n body = json.dumps(payload).encode("utf-8")\n request = urllib.request.Request(url, data=body, headers=headers, method="POST")\n try:\n with urllib.request.urlopen(request, timeout=timeout) as response:\n return response.status, dict(response.headers), response.read().decode("utf-8")\n except urllib.error.HTTPError as error:\n return error.code, dict(error.headers), error.read().decode("utf-8")\n\n\ndef _parse_json(text):\n if not text:\n return {}\n return json.loads(text)\n\n\ndef _safe_json(text):\n try:\n return _parse_json(text)\n except json.JSONDecodeError:\n return {"raw": text}\n\n\ndef _contains_rate_limit_error(payload):\n # Only inspect the API "error" field, not the whole body — otherwise benign\n # tool output mentioning "rate limit"/"quota" triggers spurious retries.\n if not isinstance(payload, dict):\n return False\n error = payload.get("error")\n if not error:\n return False\n text = json.dumps(error, default=str).lower()\n return any(pattern in text for pattern in RATE_LIMIT_PATTERNS)\n\n\ndef _retry_delay(attempt, delay_ms):\n base_delay = max(delay_ms, 0) / 1000.0\n if base_delay == 0:\n return\n # Exponential backoff: double the delay each attempt (parity with Apollo).\n backoff = base_delay * (2 ** attempt)\n jitter = random.uniform(0, min(backoff * 0.2, 0.5))\n time.sleep(backoff + jitter)\n\n\ndef _json_shape(value):\n if isinstance(value, dict):\n return {key: _json_shape(item) for key, item in value.items()}\n if isinstance(value, list):\n return [_json_shape(value[0])] if value else []\n if value is None:\n return "null"\n return type(value).__name__\n\n\ndef print_json_structure(value):\n print(json.dumps(_json_shape(value), indent=2, sort_keys=True))\n\n\ndef _track_helper_event(*_args, **_kwargs):\n return None\n\n\ndef run_composio_tool(\n tool_slug,\n arguments=None,\n retry_params=None,\n print_schema_for_tool=True,\n *,\n account=None,\n):\n if not tool_slug:\n return {}, "tool_slug is required"\n\n api_key = _require_value(_read_env("COMPOSIO_API_KEY"), "COMPOSIO_API_KEY")\n retry_config = {"max_retries": 3, "delay_ms": 2000}\n if retry_params:\n retry_config.update(retry_params)\n\n payload = {\n "tool_slug": str(tool_slug).strip().upper(),\n "arguments": arguments or {},\n }\n if account is not None:\n payload["account"] = account\n\n headers = {\n "Content-Type": "application/json",\n "x-api-key": api_key,\n "x-request-id": _request_id(),\n }\n max_retries = int(retry_config.get("max_retries", 3))\n delay_ms = int(retry_config.get("delay_ms", 2000))\n\n for attempt in range(max_retries + 1):\n try:\n status, _headers, text = _post_json(_session_execute_url(), headers, payload)\n except (urllib.error.URLError, TimeoutError) as error:\n # Network failure (timeout, connection/DNS error). Retry transient\n # failures, then surface as the error tuple instead of throwing.\n if attempt < max_retries:\n _retry_delay(attempt, delay_ms)\n continue\n return {}, "Composio tool request failed: %s" % error\n\n if status == 429 and attempt < max_retries:\n _retry_delay(attempt, delay_ms)\n continue\n\n if status >= 400:\n response_data = _safe_json(text)\n return response_data, "Composio tool execution failed with HTTP %s" % status\n\n try:\n response_data = _parse_json(text)\n except json.JSONDecodeError as error:\n return {"raw": text}, "Failed to parse Composio tool response as JSON: %s" % error\n\n if _contains_rate_limit_error(response_data) and attempt < max_retries:\n _retry_delay(attempt, delay_ms)\n continue\n\n # A failed tool call returns HTTP 200 with a top-level "error" field;\n # surface it as the error tuple element so callers don\'t read it as success.\n if isinstance(response_data, dict) and response_data.get("error"):\n return response_data, str(response_data["error"])\n\n if print_schema_for_tool:\n print_json_structure(response_data)\n return response_data, ""\n\n return {}, "Composio tool execution failed after retries"\n\n\ndef _strip_code_fence(content):\n stripped = content.strip()\n code_fence = chr(96) * 3\n if stripped.startswith(code_fence):\n stripped = stripped[3:].strip()\n if stripped.lower().startswith("json"):\n stripped = stripped[4:].strip()\n if stripped.endswith(code_fence):\n stripped = stripped[:-3].strip()\n elif stripped.lower().startswith("json\\n"):\n stripped = stripped[5:].strip()\n return stripped.strip()\n\n\ndef invoke_llm(query, reasoning_effort=None):\n if not query:\n return "", "query is required"\n\n system_prompt = (\n "You are a generic, smart large language model. "\n "When asked to output a JSON, respond only with valid JSON - "\n "no other text / code fences / quotes around the JSON."\n )\n response, error = run_composio_tool(\n "COMPOSIO_SEARCH_GROQ_CHAT",\n {\n "model": DEFAULT_INVOKE_LLM_MODEL,\n "messages": [\n {"role": "system", "content": system_prompt},\n {"role": "user", "content": query},\n ],\n "temperature": 0.5,\n },\n None,\n False,\n )\n _track_helper_event("invoke_llm", {"reasoning_effort": reasoning_effort})\n\n if error:\n return "", error\n\n choices = (response.get("data") or {}).get("choices", "")\n if not choices:\n return "", "No choices returned from invoke_llm"\n\n first_choice = choices[0] if isinstance(choices, list) else choices\n content = (first_choice.get("message") or {}).get("content", "")\n if not content:\n return "", "No content returned from invoke_llm"\n return _strip_code_fence(content), ""\n\n\ndef web_search(query):\n if not query:\n return "", "query is required"\n\n response, error = run_composio_tool(\n "COMPOSIO_SEARCH_EXA_ANSWER",\n {"content": query},\n None,\n False,\n )\n _track_helper_event("web_search", {})\n\n if error:\n return "", error\n return (response.get("data") or {}).get("answer", ""), ""\n\n\ndef proxy_execute(\n method: Literal["GET", "POST", "PUT", "DELETE", "PATCH"],\n endpoint: str,\n toolkit: str,\n query_params: Optional[Dict[str, str]] = None,\n body: Optional[object] = None,\n headers: Optional[Dict[str, str]] = None,\n) -> tuple[Any, str]:\n """Call a toolkit\'s API directly when no Composio tool exists.\n\n The session resolves the connected account and injects auth server-side, so\n your code never handles raw credentials.\n\n Args:\n method: HTTP method to use for the request. Example: "GET"\n endpoint: API endpoint to call. Example: "/repos/owner/repo"\n toolkit: Name of the toolkit. Example: "GITHUB"\n query_params: Query parameters as key-value pairs. Example: {"q": "is:unread"}\n body: The request body (required for POST, PUT, and PATCH requests)\n headers: HTTP headers as key-value pairs. Example: {"Accept": "application/json"}\n\n Returns:\n tuple[Any, str]:\n - data: Response data from the API (None if error)\n - error: Error message ("" if no error)\n """\n # Wrapped end-to-end so the helper always returns a (data, error) tuple\n # rather than raising.\n try:\n valid_methods = ["GET", "POST", "PUT", "DELETE", "PATCH"]\n if method.upper() not in valid_methods:\n return None, "Invalid HTTP method: " + method\n\n if not endpoint.strip():\n return None, "Endpoint cannot be empty"\n\n if not toolkit.strip():\n return None, "Toolkit cannot be empty"\n\n if query_params is not None and not isinstance(query_params, dict):\n return None, (\n "Invalid query_params type: expected dict or None, got "\n + type(query_params).__name__\n )\n\n if headers is not None and not isinstance(headers, dict):\n return None, (\n "Invalid headers type: expected dict or None, got "\n + type(headers).__name__\n )\n\n if method.upper() in ["POST", "PUT", "PATCH"] and body is None:\n return None, "Body is required for " + method.upper() + " requests"\n\n if method.upper() in ["GET", "DELETE"] and body is not None:\n return None, "Body should not be provided for " + method.upper() + " requests"\n\n api_key = _read_env("COMPOSIO_API_KEY")\n if not api_key:\n return None, "Missing environment variable COMPOSIO_API_KEY"\n if not _read_env("COMPOSIO_TOOLROUTER_SESSION_ID"):\n return None, "Missing environment variable COMPOSIO_TOOLROUTER_SESSION_ID"\n\n # Convert query_params and headers dicts to the flat parameters array.\n parameters = []\n if query_params:\n for key, value in query_params.items():\n parameters.append({"name": key, "value": str(value), "type": "query"})\n if headers:\n for key, value in headers.items():\n parameters.append({"name": key, "value": str(value), "type": "header"})\n\n payload = {\n "toolkit_slug": toolkit.lower(),\n "endpoint": endpoint,\n "method": method.upper(),\n }\n if parameters:\n payload["parameters"] = parameters\n if body is not None:\n payload["body"] = body\n\n request_headers = {\n "Content-Type": "application/json",\n "x-api-key": api_key,\n "x-request-id": _request_id(),\n }\n\n status, _response_headers, text = _post_json(\n _session_proxy_execute_url(), request_headers, payload\n )\n\n # Handle HTTP errors explicitly. Always surface a non-empty message so a\n # >=400 response never looks like success (an empty error/message field\n # must not win over the default).\n if status >= 400:\n error_msg = "HTTP " + str(status) + " Error"\n try:\n error_data = json.loads(text)\n if isinstance(error_data, dict):\n error_msg = (\n error_data.get("error") or error_data.get("message") or error_msg\n )\n except (ValueError, TypeError):\n if text:\n sanitized = text[:200].replace("\\n", " ").strip()\n error_msg = "HTTP " + str(status) + ": " + sanitized\n return None, str(error_msg)\n\n response_data = json.loads(text)\n\n # The session wraps the proxied response as {data, status, headers}; the\n # toolkit\'s own API may still report a >=400 status inside that envelope.\n # `status` can arrive as a string or null, so coerce it before comparing\n # — a bare `>= 400` against a non-int would raise and mask a valid result.\n if isinstance(response_data, dict):\n try:\n api_status = int(response_data.get("status", 200))\n except (TypeError, ValueError):\n api_status = 200\n if api_status >= 400:\n error_msg = "API request failed"\n if isinstance(response_data.get("data"), dict):\n error_msg = response_data["data"].get(\n "message", response_data["data"].get("error", error_msg)\n )\n return response_data, "API returned status " + str(api_status) + ": " + str(error_msg)\n return response_data.get("data"), ""\n\n return response_data, ""\n except Exception as error:\n return None, "Failed to execute proxy request: " + str(error)\n';