[0.12.0] - 2026-04-28
Changed
- BREAKING — Automatic file upload/download is now opt-in. The SDK no longer
auto-stages local paths or URLs for tools with file_uploadable inputs, and no
longer auto-downloads file_downloadable results. Existing code that relied
on this behaviour must opt back in via the new flag below.- Removed: the legacy auto_upload_download_files constructor option. Code
that sets it must migrate to dangerously_allow_auto_upload_download_files. - Added: dangerously_allow_auto_upload_download_files: bool = False on
Composio(...). When True, the SDK collapses file_uploadable schemas to
{"type": "string", "format": "path"} for the model and stages local
paths/URLs at execute time. - Added: file_upload_dirs: Sequence[str] | Literal[False] | None = None —
fail-closed allowlist for local upload paths. None defaults to
[/.composio/temp]; False rejects all local paths; an explicit list
replaces the default. Only consulted when
dangerously_allow_auto_upload_download_files=True. - Added: file_download_dir: str | None — directory used to stage downloads
on file_downloadable results. - Added: the before_file_upload modifier now receives source:
Literal["path", "url", "file"] so hooks can branch on the original input
type. - Added: when auto-upload is off but a tool with file_uploadable inputs is
executed, the SDK emits a one-shot warning per tool slug pointing at
composio.files.upload() for manual staging. - Manual upload/download APIs (composio.files.upload(...),
composio.files.download(...)) are unchanged and remain the supported way to
handle files explicitly.
- Removed: the legacy auto_upload_download_files constructor option. Code
Migration
Before
composio = Composio(api_key=...) # auto upload/download was on by default
After — explicit opt-in if you need the old behaviour
composio = Composio(
api_key=...,
dangerously_allow_auto_upload_download_files=True,
file_upload_dirs=["/path/to/allowed/dir"], # optional; defaults to
~/.composio/temp
file_download_dir="/path/to/downloads", # optional
)
Notes
- Provider packages (composio-openai, composio-anthropic, composio-langchain,
composio-agno, composio-llamaindex, etc.) are bumped alongside composio in
this release train so the version line stays aligned across the monorepo,
even though they have no public-API changes of their own. - Mirrors the TypeScript SDK release: @composio/core@0.8.0 (TS PR #3260,
train PR #3299). @composio/*@0.7.0 was published briefly and has been
deprecated on npm in favour of 0.8.0.