1
-# Changelog
2
-
3
-All notable changes to the Composio Python SDK will be documented in this file.
4
-
5
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
-
8
-> Versions between `0.8.11` and `0.13.0` were released without CHANGELOG entries. See the [Git commit log](https://github.com/ComposioHQ/composio/commits/next/python) for changes in that window.
9
-
10
-## [0.17.1] - 2026-06-28
11
-
12
-### Added
13
-- **Tool Router session deletion**: delete sessions from Python via `composio.sessions.delete(session_id)` or `session.delete()`, matching the TypeScript SDK surface.
14
-
15
-### Changed
16
-- Bumped the Python SDK and provider packages from `0.17.0` to `0.17.1`.
17
-
18
-## [0.17.0] - 2026-06-26
19
-
20
-### Added
21
-- **`triggers.parse()`**: parse and optionally verify an incoming webhook request, mirroring the TypeScript SDK. Pass `verify_secret` to validate the signature; omit it to skip verification explicitly. A present-but-empty `verify_secret` (e.g. an unset `COMPOSIO_WEBHOOK_SECRET`) raises rather than silently skipping verification.
22
-- **`triggers.set_webhook_subscription()`**: create or update the project webhook subscription from the Python SDK.
23
-- **`connected_accounts.update_acl()`**: the experimental shared-connection ACL patch helper graduated to `connected_accounts`; `experimental.update_acl()` remains as a deprecated alias.
24
-
25
-### Changed
26
-- **`composio.sessions` is the canonical sessions entrypoint**: use `composio.sessions.create(...)` (or the `composio.create` / `composio.use` shortcuts). `composio.tool_router` is now a deprecated alias for the same object.
27
-- **MCP is now opt-in for sessions**: `composio.create()` / `composio.use()` return native-tool sessions by default and select the MCP-typed session only when `mcp=True`. The runtime object is unchanged.
28
-- **Prefer `sandbox` for session code-execution config**: the `sandbox` key is now preferred; the existing `workbench` key is still accepted as an alias.
29
-- Bumped the Python SDK and provider packages from `0.16.0` to `0.17.0`.
30
-
31
-## [0.16.0] - 2026-06-25
32
-
33
-### Fixed
34
-- **Auto file upload/download behind `$ref`/`$defs`**: tool schemas that express their file fields through a `$ref`/`$defs` indirection are now resolved before file handling, so `file_uploadable` inputs and `file_downloadable` outputs reachable only through a reference are no longer silently skipped when `dangerously_allow_auto_upload_download_files=True`. `GMAIL_GET_ATTACHMENT` (whose `file_downloadable` flag sits two `$ref` hops deep) is the canonical case. Adds a cycle-safe, depth-capped `dereference_json_schema` utility with Draft 2020-12 sibling-keyword merge, mirroring the TypeScript SDK's `dereferenceJsonSchema`.
35
-- **No retries on non-idempotent tool writes**: `tools.execute()` and `tools.proxy()` are non-idempotent POST writes, but the Stainless-generated client retried them by default (on read timeouts, 429s, and 5xx), which could duplicate side effects — e.g. send an email twice. Both paths now route through a cached `client.without_retries` clone (`max_retries=0`); idempotent reads and lists keep the default retries. This is an interim fix ahead of backend idempotency keys.
36
-- **Bounded timeouts on file transfers**: session file uploads/downloads and the presigned S3 `PUT`/`GET` paths now use bounded `(connect, read)` timeouts, and timeout or request failures surface as the SDK's typed file errors instead of hanging.
37
-- **Provider-visible tool schema aliasing**: centralized aliasing via `alias_tool_input_schema` / `restore_tool_arguments`, applied across the Anthropic, Claude Agent SDK, Gemini, Google ADK, and OpenAI Agents providers. Aliases invalid Python parameter names (e.g. `$top`), preserves the existing `from` → `from_rs` style, avoids leading-underscore aliases so Pydantic-backed providers can build models, caps aliases at 64 characters for Anthropic-style validators, and dereferences internal `$ref`/`$defs` before aliasing. Original backend argument names are restored before execution.
38
-- **OpenAI Agents schema mutation**: the tool schema is now deep-copied before its `examples`/`default` fields are stripped, so the source schema is no longer mutated in place.
39
-
40
-### Changed
41
-- Bumped the `composio-client` dependency from `1.39.0` → `1.41.0`.
42
-- Bumped the Python SDK and provider packages from `0.15.0` to `0.16.0`.
43
-- Refreshed Python core and provider dependency ranges, plus root and provider uv locks, to the newest compatible versions.
44
-
45
-## [0.15.0] - 2026-06-16
46
-
47
-### Fixed
48
-- Forwarded `user_id` from `triggers.create(..., user_id=...)` into the trigger upsert request via `extra_body`, so 2FA-enabled trigger projects can verify the pinned connected account belongs to the caller.
49
-
50
-### Changed
51
-- Bumped the Python SDK and provider packages from `0.14.0` to `0.15.0`.
52
-
53
-## [0.14.0] - 2026-06-05
54
-
55
-### Removed
56
-- Removed the legacy `composio.tools.custom_tool` registry path, including `core.models.custom_tools`, `ExecuteRequestFn`, the old fallback execution wiring, the old security tests, and the legacy custom-tools example.
57
-
58
-### Changed
59
-- Kept custom tools on the 2026 tool-router surface: `composio.experimental.tool()`, `composio.experimental.Toolkit`, inline execution, preload/attach/use flows, and `session.custom_tools()`.
60
-- Bumped the Python SDK and provider packages from `0.13.1` to `0.14.0`.
61
-
62
-## [0.13.1] - 2026-05-13
63
-
64
-### Added
65
-- **SHARED connected accounts (experimental)**: Connections can now be marked SHARED at create time and reached from a tool-router session by other `user_id`s when explicitly pinned and authorised via a per-user ACL. Mirrors the TypeScript SDK's `@composio/core@0.10.0` release.
66
- - `composio.connected_accounts.link(..., experimental={"account_type": "SHARED", "acl_config_for_shared": {...}})` to create.
67
- - `composio.experimental.update_acl(nanoid, allow_all_users=..., allowed_user_ids=[...], not_allowed_user_ids=[...])` to update the per-user ACL on an existing SHARED connection. PATCH semantics: omit a field to leave it unchanged; pass `[]` to clear an allow/deny list.
68
- - `session.authorize(toolkit, experimental={...})` for the same flow inside a tool-router session.
69
- - `composio.connected_accounts.list(account_type='PRIVATE' | 'SHARED' | 'ALL')` filter.
70
- - New typed errors: `ComposioAclOnlyForSharedError`, `ComposioSharedAccessDeniedError`, `ComposioSharedConnectionNotAccessibleError`.
71
- - **Experimental — shape may change in future releases.** Pinning a SHARED connection in a session config and direct execute by `connected_account_id` are unchanged.
72
-- **`composio.experimental` namespace**: new module housing experimental SDK methods that take a client (`update_acl`) alongside the existing decorators (`tool`, `Toolkit`).
73
-
74
-### Fixed
75
-- **`initiate()` deprecation warning false-positives**: the legacy `POST /api/v3/connected_accounts` deprecation warning is now gated on the response `Deprecation` HTTP header (RFC 9745) rather than the `auth_scheme` of the request. Custom auth configs and non-OAuth schemes no longer trigger a spurious warning. The legacy endpoint's retired-path 400 is also surfaced as a typed `ComposioLegacyConnectedAccountsEndpointRetiredError`. See https://docs.composio.dev/docs/changelog/2026/04/24.
76
-- **Schema converter nullability**: `null`-only `anyOf` blocks now preserve nullability instead of dropping to a bare `str` fallback.
77
-
78
-### Changed
79
-- Bumped `composio-client` dependency from `1.36.0` → `1.39.0` so the generated typed client carries the `Experimental` TypedDicts for the SHARED-connection surface.
80
-
81
-## [0.8.11] - 2025-09-10
82
-
83
-### Added
84
-- **Composio Connect Link Support**: New link() method for creating external authentication links
85
- - Added `link()` method to ConnectedAccounts class for generating user authentication links
86
- - Support for callback URL redirection after authentication
87
- - Enhanced user experience with external link-based authentication flow
88
- - Includes comprehensive documentation and usage examples
89
-
90
-### Fixed
91
-- **Documentation**: Fixed typo in connected account creation function docstring
92
- - Corrected "coneected" to "connected" in function documentation
93
-
94
-## [0.8.10] - 2024-12-19
95
-
96
-### Added
97
-- **LlamaIndex Provider**: New LlamaIndex provider for enhanced AI framework integration
98
- - Complete provider implementation with demo and documentation (`python/providers/llamaindex/`)
99
- - Support for LlamaIndex-specific tool execution patterns
100
- - Includes provider.py, demo script, and proper packaging setup
101
-
102
-### Changed
103
-- **Schema Parsing**: Improved OpenAPI schema parsing with default fallback to 'any' type for invalid schemas
104
- - Enhanced `python/composio/utils/openapi.py` to handle malformed schemas gracefully
105
- - More robust type inference for edge cases where schema type is missing or invalid
106
-
107
-### Fixed
108
-- **Type Checking**: Fixed type checking issues in core validation logic
109
- - Updated `python/composio/core/models/toolkits.py` for better type safety
110
- - Added proper type annotations and validation
111
-- **Sentinel Value Checks**: Fixed sentinel value validation in core models
112
- - Enhanced validation in `python/composio/core/models/toolkits.py`
113
- - Improved handling in `python/composio/core/models/tools.py` and `python/composio/core/models/triggers.py`
114
- - Added proper sentinel value checks in `python/composio/types.py`
115
-- **Build System**: Updated noxfile.py for improved development workflow
116
-
117
-## [0.8.9] - 2024-11-XX
118
-
119
-### Added
120
-- Initial stable release with core functionality
121
-- Support for multiple AI frameworks (OpenAI, Anthropic, Google, etc.)
122
-- Comprehensive tool execution capabilities
123
-- Authentication and connected account management
124
-- File upload and download support
125
-- Webhook and trigger system
126
-- Multi-provider support architecture
127
-
128
-### Features
129
-- Tool discovery and execution
130
-- Connected account management
131
-- Authentication configuration
132
-- File handling and processing
133
-- Webhook integration
134
-- Trigger system for automated workflows
135
-- Support for custom tools and integrations
136
-
137
----
138
-
139
-## Version History
140
-
141
-For detailed commit history and technical changes, see the [Git commit log](https://github.com/composio/composio/commits/main).
142
-
143
-## Support
144
-
145
-For questions, issues, or contributions, please visit:
146
-- [GitHub Repository](https://github.com/composio/composio)
147
-- [Documentation](https://docs.composio.dev)
148
-- [Community Discord](https://discord.gg/composio)