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
import { PYTHON_WORKBENCH_HELPER_SOURCE } from './python-helpers.generated';
export interface WorkbenchEnvOptions {
sessionId: string;
backendUrl: string;
apiKey: string;
}
export interface PythonWorkbenchHelperSourceOptions {
invokeLlmModel?: string;
}
function trimTrailingSlashes(value: string): string {
let end = value.length;
while (end > 0 && value.charCodeAt(end - 1) === 47) {
end -= 1;
}
return value.slice(0, end);
}
export function experimental_createWorkbenchEnv(env: WorkbenchEnvOptions): Record<string, string> {
return {
BACKEND_URL: trimTrailingSlashes(env.backendUrl),
COMPOSIO_TOOLROUTER_SESSION_ID: env.sessionId,
// SECURITY: this is the developer's full *project* API key, placed in the
// sandbox env. Any code or tool output in the sandbox can read it and
// exfiltrate it, so treat the sandbox as your security boundary and rotate
// this key. The execute endpoint also accepts a session-scoped
// `x-session-access-key`; swapping to that (so the project key never enters
// the sandbox) is the planned follow-up.
COMPOSIO_API_KEY: env.apiKey,
};
}
export function experimental_createPythonWorkbenchHelperSource(
opts: PythonWorkbenchHelperSourceOptions = {}
): string {
// Inject config by prepending an `_INTERNAL` prologue the helper reads from,
// rather than string-substituting a sentinel. The helper `.py` is authored as
// real, lintable/testable Python; the generated constant is verbatim.
// JSON.stringify-of-JSON.stringify yields a double-quoted string literal that
// is valid Python — JSON string escapes are a subset of Python's.
const config = { invoke_llm_model: opts.invokeLlmModel ?? 'openai/gpt-oss-120b' };
const prologue =
`import json as _composio_internal_json\n` +
`_INTERNAL = _composio_internal_json.loads(${JSON.stringify(JSON.stringify(config))})\n`;
return prologue + PYTHON_WORKBENCH_HELPER_SOURCE;
}