github ComposioHQ/composio py@0.12.0

latest releases: @composio/cli@0.6.2-beta.551, @composio/cli@0.6.2-beta.550, @composio/cli@0.6.1...
6 months ago

[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.

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.

Don't miss a new composio release

NewReleases is sending notifications on new releases.