Files
composiohq__composio/python/CHANGELOG.md
T
Alberto Schiabel 5dcb363446 docs(py): add 0.13.1 entry to CHANGELOG (#3427)
Adds a `0.13.1` entry to `python/CHANGELOG.md` covering the changes
accumulated on `next` since the last Python release (`py@0.13.0`, May
7).

The CHANGELOG had been quietly abandoned since `0.8.11` (Sept 2025);
rather than try to backfill the 4-minor gap, this PR draws a line and
adds a banner pointing readers at the git log for that window. Future
releases start fresh from here.

## What's in 0.13.1

- **SHARED connected accounts (experimental)** —
`composio.experimental.update_acl`, `experimental={...}` on `link()` /
`session.authorize()`, `account_type` filter on `list()`. Mirrors
`@composio/core@0.10.0` shipping in #3425.
- **`initiate()` deprecation warning** — gated on response `Deprecation`
header (RFC 9745) instead of `auth_scheme`, eliminating false positives
for custom auth configs and non-OAuth schemes.
- **Schema converter** — preserves nullability on `null`-only `anyOf`
blocks.
- **Dep bump** — `composio-client` 1.36.0 → 1.39.0.

## Release plan

Documentation only — does NOT trigger a release on its own. The Python
release flow is tag-triggered:

```bash
# After this PR merges and after #3425 ships:
git tag py@0.13.1 <next HEAD sha>
git push origin py@0.13.1
```

That fires `.github/workflows/py.release.yml` which builds and publishes
to PyPI.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: jkomyno <12381818+jkomyno@users.noreply.github.com>
2026-05-14 09:32:03 +02:00

5.3 KiB

Changelog

All notable changes to the Composio Python SDK will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Versions between 0.8.11 and 0.13.0 were released without CHANGELOG entries. See the Git commit log for changes in that window.

[0.13.1] - 2026-05-13

Added

  • SHARED connected accounts (experimental): Connections can now be marked SHARED at create time and reached from a tool-router session by other user_ids when explicitly pinned and authorised via a per-user ACL. Mirrors the TypeScript SDK's @composio/core@0.10.0 release.
    • composio.connected_accounts.link(..., experimental={"account_type": "SHARED", "acl_config_for_shared": {...}}) to create.
    • 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.
    • session.authorize(toolkit, experimental={...}) for the same flow inside a tool-router session.
    • composio.connected_accounts.list(account_type='PRIVATE' | 'SHARED' | 'ALL') filter.
    • New typed errors: ComposioAclOnlyForSharedError, ComposioSharedAccessDeniedError, ComposioSharedConnectionNotAccessibleError.
    • Experimental — shape may change in future releases. Pinning a SHARED connection in a session config and direct execute by connected_account_id are unchanged.
  • composio.experimental namespace: new module housing experimental SDK methods that take a client (update_acl) alongside the existing decorators (tool, Toolkit).

Fixed

  • 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.
  • Schema converter nullability: null-only anyOf blocks now preserve nullability instead of dropping to a bare str fallback.

Changed

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

[0.8.11] - 2025-09-10

Added

  • Composio Connect Link Support: New link() method for creating external authentication links
    • Added link() method to ConnectedAccounts class for generating user authentication links
    • Support for callback URL redirection after authentication
    • Enhanced user experience with external link-based authentication flow
    • Includes comprehensive documentation and usage examples

Fixed

  • Documentation: Fixed typo in connected account creation function docstring
    • Corrected "coneected" to "connected" in function documentation

[0.8.10] - 2024-12-19

Added

  • LlamaIndex Provider: New LlamaIndex provider for enhanced AI framework integration
    • Complete provider implementation with demo and documentation (python/providers/llamaindex/)
    • Support for LlamaIndex-specific tool execution patterns
    • Includes provider.py, demo script, and proper packaging setup

Changed

  • Schema Parsing: Improved OpenAPI schema parsing with default fallback to 'any' type for invalid schemas
    • Enhanced python/composio/utils/openapi.py to handle malformed schemas gracefully
    • More robust type inference for edge cases where schema type is missing or invalid

Fixed

  • Type Checking: Fixed type checking issues in core validation logic
    • Updated python/composio/core/models/toolkits.py for better type safety
    • Added proper type annotations and validation
  • Sentinel Value Checks: Fixed sentinel value validation in core models
    • Enhanced validation in python/composio/core/models/toolkits.py
    • Improved handling in python/composio/core/models/tools.py and python/composio/core/models/triggers.py
    • Added proper sentinel value checks in python/composio/types.py
  • Build System: Updated noxfile.py for improved development workflow

[0.8.9] - 2024-11-XX

Added

  • Initial stable release with core functionality
  • Support for multiple AI frameworks (OpenAI, Anthropic, Google, etc.)
  • Comprehensive tool execution capabilities
  • Authentication and connected account management
  • File upload and download support
  • Webhook and trigger system
  • Multi-provider support architecture

Features

  • Tool discovery and execution
  • Connected account management
  • Authentication configuration
  • File handling and processing
  • Webhook integration
  • Trigger system for automated workflows
  • Support for custom tools and integrations

Version History

For detailed commit history and technical changes, see the Git commit log.

Support

For questions, issues, or contributions, please visit: