Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: centralize SDK release notes (#3814)

Alberto Schiabeledd0bf047917
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 000000000..cc9b396e4
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,3 @@
+# Changelog
+
+Composio release notes are published in the [official changelog](https://docs.composio.dev/reference/changelog).
diff --git a/README.md b/README.md
index de45b5af9..f27f14530 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,8 @@
<p align="center">
<a href="https://composio.dev"><b>composio.dev</b></a> •
<a href="https://docs.composio.dev">Documentation</a> •
- <a href="https://docs.composio.dev/docs/quickstart">Quickstart</a>
+ <a href="https://docs.composio.dev/docs/quickstart">Quickstart</a> •
+ <a href="https://docs.composio.dev/reference/changelog">Changelog</a>
</p>
<p align="center">
diff --git a/docs/agent-guidance/guides/changelog.md b/docs/agent-guidance/guides/changelog.md
index 8b9f0fd6e..c06ca6518 100644
--- a/docs/agent-guidance/guides/changelog.md
+++ b/docs/agent-guidance/guides/changelog.md
@@ -21,8 +21,8 @@ Brief intro paragraph.
| SDK | Version |
|-----|---------|
-| Python | v0.10.2 |
-| TypeScript | v0.3.1 |
+| Python `composio` | `0.10.2` |
+| TypeScript `@composio/core` | `0.3.1` |
### Breaking Changes (if applicable)
@@ -48,6 +48,8 @@ new_code()
- Change 2
```
+Use the released version in the final table column. The Python release guard reads that column from rows labelled `Python \`composio\``.
+
## Rules
1. **Frontmatter required** — `title` and `date` (YYYY-MM-DD format)
diff --git a/docs/content/changelog/05-13-26-python-sdk-0131.mdx b/docs/content/changelog/05-13-26-python-sdk-0131.mdx
new file mode 100644
index 000000000..a9f0c4c7e
--- /dev/null
+++ b/docs/content/changelog/05-13-26-python-sdk-0131.mdx
@@ -0,0 +1,23 @@
+---
+title: "Python SDK 0.13.1 adds experimental shared connections"
+description: "Python SDK 0.13.1 adds experimental shared connected accounts, ACL helpers, and fixes legacy initiate warnings."
+date: "2026-05-13"
+---
+
+Python SDK `composio` `0.13.1` adds experimental shared connected accounts. A shared connection can be pinned in a Tool Router session and used by another `user_id` only when its per-user ACL permits it.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| Python `composio` | `0.13.1` |
+
+### Shared connections
+
+Create a shared connection with `connected_accounts.link(..., experimental={...})`, update its ACL with `experimental.update_acl(...)`, and use the same experimental shape from `session.authorize(...)`. `connected_accounts.list()` also accepts the `PRIVATE`, `SHARED`, and `ALL` account-type filters.
+
+<Callout>
+Shared connections are experimental. Their shape may change, so pin a specific SDK version if your application depends on the current API.
+</Callout>
+
+This release also fixes false-positive `initiate()` deprecation warnings for custom and non-OAuth auth configs, preserves null-only `anyOf` schema branches, and adds typed errors for invalid shared-connection operations.
diff --git a/docs/content/changelog/06-16-26-python-sdk-014.mdx b/docs/content/changelog/06-16-26-python-sdk-014.mdx
new file mode 100644
index 000000000..1da9e840b
--- /dev/null
+++ b/docs/content/changelog/06-16-26-python-sdk-014.mdx
@@ -0,0 +1,63 @@
+---
+title: "Python SDK 0.14.0 removes the legacy custom-tool registry"
+description: "Python SDK 0.14.0 removes the legacy in-memory custom-tool registry. Tool Router custom tools remain the supported path."
+date: "2026-06-16"
+---
+
+Python SDK `composio` `0.14.0` removes the legacy `composio.tools.custom_tool` registry. It was an older, separate custom-tool path that duplicated the Tool Router model and made it unclear which execution surface a tool belonged to.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| Python `composio` | `0.14.0` |
+
+### Breaking change
+
+<Callout type="warn">
+**Breaking change**
+
+`composio.tools.custom_tool`, `core.models.custom_tools`, and their legacy execution wiring were removed. Use `composio.experimental.tool()` and `composio.experimental.Toolkit` with a Tool Router session instead.
+</Callout>
+
+The current custom-tool APIs support inline execution and Tool Router preload, attach, and reuse flows. They are the only custom-tool path supported by the SDK.
+
+### Migration
+
+1. Replace `@composio.tools.custom_tool` with `@composio.experimental.tool`.
+2. Change the tool signature from a request object plus execution callback to `input, ctx`.
+3. Attach the tool when creating the session through `experimental.custom_tools`.
+
+Before:
+
+```python
+from composio import Composio
+
+composio = Composio()
+
+
+def add_two_numbers(request: AddTwoNumbersInput) -> int:
+ return request.a + request.b
+```
+
+After:
+
+```python
+from composio import Composio
+
+composio = Composio()
+
+
+def add_two_numbers(input: AddTwoNumbersInput, ctx):
+ return {"result": input.a + input.b}
+
+
+session = composio.create(
+ user_id="user_123",
+ experimental={"custom_tools": [add_two_numbers]},
+)
+```
+
+For a tool that calls a toolkit API, set `extends_toolkit` on the decorator and use `ctx.proxy_execute(...)` from the function body.
diff --git a/docs/content/changelog/06-18-26-python-sdk-015.mdx b/docs/content/changelog/06-18-26-python-sdk-015.mdx
new file mode 100644
index 000000000..066fd8769
--- /dev/null
+++ b/docs/content/changelog/06-18-26-python-sdk-015.mdx
@@ -0,0 +1,15 @@
+---
+title: "Python SDK 0.15.0 supports trigger 2FA ownership checks"
+description: "Python SDK 0.15.0 forwards user_id when creating triggers so 2FA-enabled projects can verify connected-account ownership."
+date: "2026-06-18"
+---
+
+Python SDK `composio` `0.15.0` forwards `user_id` from `triggers.create()` to the trigger upsert request. This lets projects with trigger 2FA verify that the connected account belongs to the caller.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| Python `composio` | `0.15.0` |
+
+No call-site migration is required. Pass `user_id` to `triggers.create()` when the trigger should be associated with a specific user.
diff --git a/docs/content/changelog/06-19-26-typescript-sdk-011.mdx b/docs/content/changelog/06-19-26-typescript-sdk-011.mdx
new file mode 100644
index 000000000..1751dfec1
--- /dev/null
+++ b/docs/content/changelog/06-19-26-typescript-sdk-011.mdx
@@ -0,0 +1,56 @@
+---
+title: "TypeScript SDK 0.11.0 moves custom tools to Tool Router"
+description: "TypeScript SDK 0.11.0 removes the legacy custom-tool registry and improves trigger ownership, schemas, file handling, and provider tool arguments."
+date: "2026-06-19"
+---
+
+TypeScript SDK `@composio/core` `0.11.0` removes the old in-memory custom-tool registry. Custom tools now have one home: Tool Router sessions.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| TypeScript `@composio/core` | `0.11.0` |
+
+### Breaking change
+
+<Callout type="warn">
+**Breaking change**
+
+`composio.tools.createCustomTool(...)` was removed. Because the SDK is still pre-1.0, this shipped as a minor release. Existing `^0.10.0` ranges do not upgrade to `0.11.0` automatically.
+</Callout>
+
+**Before:**
+
+```typescript
+// @noErrors
+const tool = composio.tools.createCustomTool({ /* ... */ });
+```
+
+**After:**
+
+```typescript
+// @noErrors
+import { experimental_createTool } from '@composio/core';
+
+const tool = experimental_createTool('GREP', {
+ name: 'Grep Search',
+ description: 'Search local files',
+ inputParams: /* zod schema */,
+ execute: async (input) => ({ input }),
+});
+
+await composio.create('user_123', {
+ experimental: { customTools: [tool] },
+});
+```
+
+Use `experimental_createToolkit(...)` when several local tools belong together. The `experimental_*` names are intentional: this API is still evolving.
+
+### Improvements and fixes
+
+- `triggers.create()` now forwards `userId`, enabling trigger 2FA ownership checks.
+- Telemetry sends no longer delay SDK results or rethrown errors.
+- Automatic file handling now selects the correct branch for schemas that accept either one file or a list of files.
+- Providers normalize model-produced JSON-string tool arguments and raise `ComposioInvalidToolArgumentsError` for invalid values instead of leaking raw parser errors.
+- MCP-backed toolkits with empty or missing output schemas no longer fail validation. Mastra also tolerates unresolved backend `$ref` values without making the whole tool list unusable.
diff --git a/docs/content/changelog/06-25-26-sdk-012-and-python-016.mdx b/docs/content/changelog/06-25-26-sdk-012-and-python-016.mdx
new file mode 100644
index 000000000..4d442efa4
--- /dev/null
+++ b/docs/content/changelog/06-25-26-sdk-012-and-python-016.mdx
@@ -0,0 +1,52 @@
+---
+title: "TypeScript SDK 0.12.0 and Python SDK 0.16.0"
+description: "TypeScript SDK 0.12.0 adds request cancellation and becomes ESM-only. Python SDK 0.16.0 fixes file transfer, retries, schema handling, and provider aliases."
+date: "2026-06-25"
+---
+
+This release improves failure handling on both SDKs. TypeScript callers can cancel a request rather than waiting for a slow network operation. Python fixes file handling, request timeouts, retry safety, and schema compatibility that could otherwise produce incorrect tool calls.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| TypeScript `@composio/core` | `0.12.0` |
+| Python `composio` | `0.16.0` |
+
+### TypeScript: request cancellation and ESM-only packages
+
+Public TypeScript SDK methods accept a trailing `{ signal?: AbortSignal }` request-options argument. Caller-initiated aborts are normalized to `ComposioRequestCancelledError`, including custom tools that cooperatively use `SessionContext.signal`.
+
+<Callout type="warn">
+**Breaking change**
+
+The TypeScript SDK packages are ESM-only in `0.12.0`. Use Node.js `22.22.3` or newer and ESM imports. The SDK no longer ships `.cjs` artifacts or its prior CommonJS compatibility layer.
+</Callout>
+
+**Before:**
+
+```javascript
+const { Composio } = require('@composio/core');
+```
+
+**After:**
+
+```javascript
+import { Composio } from '@composio/core';
+```
+
+The deprecated auth-config `uuid` response field was also removed. Use the canonical `id` field instead.
+
+### TypeScript improvements
+
+- `authConfigs.list()` adds `search` and `showDisabled` filters.
+- Tool schema handling preserves and resolves internal `$defs` and `$ref` values for automatic file upload and download.
+- Custom tools correctly convert both Zod 3 and Zod 4 schemas to JSON Schema.
+- The Anthropic provider sanitizes unsupported input-schema property names and restores the original tool arguments before execution.
+
+### Python fixes
+
+- File fields hidden behind `$ref` or `$defs` are resolved before automatic upload and download handling.
+- `tools.execute()` and `tools.proxy()` no longer retry non-idempotent writes, preventing duplicate side effects after timeouts, 429s, or 5xx responses.
+- Session file transfers and presigned S3 requests now use bounded connect and read timeouts, surfacing typed file errors rather than hanging.
+- Provider tool schemas safely alias Python-invalid parameter names, preserve the original names for execution, and avoid mutating OpenAI Agents source schemas.
diff --git a/docs/content/changelog/06-26-26-typescript-sdk-013.mdx b/docs/content/changelog/06-26-26-typescript-sdk-013.mdx
new file mode 100644
index 000000000..5913a9231
--- /dev/null
+++ b/docs/content/changelog/06-26-26-typescript-sdk-013.mdx
@@ -0,0 +1,36 @@
+---
+title: "TypeScript SDK 0.13.0 adds sessions and 0.13.1 adds deletion"
+description: "TypeScript SDK 0.13.0 makes sessions first-class and MCP opt-in. Version 0.13.1 adds session deletion."
+date: "2026-06-26"
+---
+
+TypeScript SDK `@composio/core` `0.13.0` makes the sessions API the primary way to work with Tool Router. Version `0.13.1` completes the lifecycle with session deletion.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| TypeScript `@composio/core` | `0.13.0` |
+| TypeScript `@composio/core` | `0.13.1` |
+
+### Sessions are first-class
+
+Use `composio.sessions.create()` as the canonical entry point. `composio.create()` remains an alias. The shared-connection ACL helper also graduates to `connectedAccounts.updateAcl()`, while `experimental.updateAcl()` remains as a compatibility alias.
+
+MCP is now opt-in at the type level. Sessions return native tools by default. Create a session with `{ mcp: true }` before reading `session.mcp` in TypeScript.
+
+```typescript
+import { Composio } from '@composio/core';
+
+const composio = new Composio({ apiKey: 'your-api-key' });
+const session = await composio.sessions.create('user_123', { mcp: true });
+
+const mcp = session.mcp;
+```
+
+### Other session and trigger updates
+
+- Session responses expose the resolved workbench configuration. Prefer `sandbox` for code-execution configuration; `workbench` remains an accepted alias.
+- `triggers.parse()` parses incoming webhook requests and can verify their signatures.
+- `triggers.setWebhookSubscription()` creates or updates a project webhook subscription.
+- `composio.sessions.delete(sessionId)` and `session.delete()` remove a Tool Router session in `0.13.1`.
diff --git a/docs/content/changelog/06-27-26-python-sdk-017.mdx b/docs/content/changelog/06-27-26-python-sdk-017.mdx
new file mode 100644
index 000000000..5e8f2614c
--- /dev/null
+++ b/docs/content/changelog/06-27-26-python-sdk-017.mdx
@@ -0,0 +1,26 @@
+---
+title: "Python SDK 0.17.0 makes sessions first-class"
+description: "Python SDK 0.17.0 adds the sessions API, opt-in MCP, webhook helpers, shared-connection ACL updates, and sandbox configuration."
+date: "2026-06-27"
+---
+
+Python SDK `composio` `0.17.0` moves Tool Router onto a sessions-first API. It also adds webhook helpers and makes the current shared-connection ACL API easier to discover.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| Python `composio` | `0.17.0` |
+
+### Sessions and MCP
+
+`composio.sessions.create(...)` is now the canonical sessions entry point. `composio.create(...)` and `composio.use(...)` remain supported shortcuts, while `composio.tool_router` is deprecated as an alias for the same object.
+
+Sessions return native tools by default. Set `mcp=True` when a typed MCP session is required. The runtime object is unchanged, but the explicit option makes the MCP dependency visible in application code.
+
+### New APIs and behavior
+
+- `triggers.parse()` parses an incoming webhook request and can verify its signature. Passing an empty `verify_secret` now raises instead of silently skipping verification.
+- `triggers.set_webhook_subscription()` creates or updates the project webhook subscription.
+- `connected_accounts.update_acl()` is the primary shared-connection ACL patch helper. `experimental.update_acl()` remains as a deprecated alias.
+- Prefer `sandbox` for session code-execution configuration. `workbench` remains an accepted alias.
diff --git a/docs/content/changelog/06-28-26-python-sdk-0171.mdx b/docs/content/changelog/06-28-26-python-sdk-0171.mdx
new file mode 100644
index 000000000..6a53cec3d
--- /dev/null
+++ b/docs/content/changelog/06-28-26-python-sdk-0171.mdx
@@ -0,0 +1,21 @@
+---
+title: "Python SDK 0.17.1 adds session deletion"
+description: "Python SDK 0.17.1 adds Tool Router session deletion through the sessions API and a session instance method."
+date: "2026-06-28"
+---
+
+Python SDK `composio` `0.17.1` adds deletion to the Tool Router session lifecycle. This matches the TypeScript SDK surface released in `@composio/core` `0.13.1`.
+
+### SDK versions
+
+| SDK | Version |
+| --- | --- |
+| Python `composio` | `0.17.1` |
+
+Delete a session from the client or from the session itself:
+
+```python
+composio.sessions.delete(session_id)
+
+session.delete()
+```
diff --git a/python/CHANGELOG.md b/python/CHANGELOG.md
deleted file mode 100644
index 98db84db6..000000000
--- a/python/CHANGELOG.md
+++ /dev/null
@@ -1,148 +0,0 @@
-# Changelog
-
-All notable changes to the Composio Python SDK will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-> 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.
-
-## [0.17.1] - 2026-06-28
-
-### Added
-- **Tool Router session deletion**: delete sessions from Python via `composio.sessions.delete(session_id)` or `session.delete()`, matching the TypeScript SDK surface.
-
-### Changed
-- Bumped the Python SDK and provider packages from `0.17.0` to `0.17.1`.
-
-## [0.17.0] - 2026-06-26
-
-### Added
-- **`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.
-- **`triggers.set_webhook_subscription()`**: create or update the project webhook subscription from the Python SDK.
-- **`connected_accounts.update_acl()`**: the experimental shared-connection ACL patch helper graduated to `connected_accounts`; `experimental.update_acl()` remains as a deprecated alias.
-
-### Changed
-- **`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.
-- **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.
-- **Prefer `sandbox` for session code-execution config**: the `sandbox` key is now preferred; the existing `workbench` key is still accepted as an alias.
-- Bumped the Python SDK and provider packages from `0.16.0` to `0.17.0`.
-
-## [0.16.0] - 2026-06-25
-
-### Fixed
-- **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`.
-- **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.
-- **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.
-- **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.
-- **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.
-
-### Changed
-- Bumped the `composio-client` dependency from `1.39.0` → `1.41.0`.
-- Bumped the Python SDK and provider packages from `0.15.0` to `0.16.0`.
-- Refreshed Python core and provider dependency ranges, plus root and provider uv locks, to the newest compatible versions.
-
-## [0.15.0] - 2026-06-16
-
-### Fixed
-- 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.
-
-### Changed
-- Bumped the Python SDK and provider packages from `0.14.0` to `0.15.0`.
-
-## [0.14.0] - 2026-06-05
-
-### Removed
-- 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.
-
-### Changed
-- 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()`.
-- Bumped the Python SDK and provider packages from `0.13.1` to `0.14.0`.
-
-## [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_id`s when explicitly pinned and authorised via a per-user ACL. Mirrors the TypeScript SDK's `@composio/[email protected]` 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](https://github.com/composio/composio/commits/main).
-
-## Support
-
-For questions, issues, or contributions, please visit:
-- [GitHub Repository](https://github.com/composio/composio)
-- [Documentation](https://docs.composio.dev)
-- [Community Discord](https://discord.gg/composio)
diff --git a/python/README.md b/python/README.md
index 096d2795c..6300252ce 100644
--- a/python/README.md
+++ b/python/README.md
@@ -13,6 +13,7 @@ Composio gives your AI agents 1000+ pre-authenticated toolkits, per-user session
- [Documentation](https://docs.composio.dev)
- [Quickstart](https://docs.composio.dev/docs/quickstart)
+- [Changelog](https://docs.composio.dev/reference/changelog)
- [Dashboard](https://dashboard.composio.dev) (grab your `COMPOSIO_API_KEY` from [Settings](https://dashboard.composio.dev/settings))
## Install
@@ -136,6 +137,7 @@ This package lives in the [Composio SDK monorepo](https://github.com/ComposioHQ/
- [Documentation](https://docs.composio.dev)
- [Python SDK reference](https://docs.composio.dev/reference/sdk-reference/python)
+- [Changelog](https://docs.composio.dev/reference/changelog)
- [Discord community](https://discord.gg/composio)
- [Open an issue](https://github.com/ComposioHQ/composio/issues)
diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.ts
index 5ffbf8bbc..eb62ce5c6 100644
--- a/test/release-workflow.test.ts
+++ b/test/release-workflow.test.ts
@@ -22,7 +22,6 @@ const tsReleaseWorkflow = readFileSync(
'utf8'
);
const pythonPyproject = readFileSync(new URL('../python/pyproject.toml', import.meta.url), 'utf8');
-const pythonChangelog = readFileSync(new URL('../python/CHANGELOG.md', import.meta.url), 'utf8');
const pythonRuntimeVersionModule = readFileSync(
new URL('../python/composio/__version__.py', import.meta.url),
'utf8'
@@ -66,8 +65,63 @@ function readPyprojectVersion(text, label) {
return requireMatch(text, /^\s*version\s*=\s*"([^"]+)"\s*$/m, label);
}
-function readChangelogVersions(text) {
- return [...text.matchAll(/^## \[([^\]]+)\]/gm)].map(match => match[1]);
+function readPythonSdkVersions(rows) {
+ const versions = new Set();
+ const pythonVersionPattern =
+ /\bv?(\d+(?:\.\d+)+(?:[._-]?(?:a|b|c|rc|alpha|beta|pre|preview)\d*)?(?:[._-]?(?:post|rev|r)\d*)?(?:[._-]?dev\d*)?(?:\+[a-z0-9]+(?:[._-][a-z0-9]+)*)?)\b/gi;
+
+ for (const row of rows) {
+ const cells = row.split('|').map(cell => cell.trim()).filter(Boolean);
+ const releaseVersionCell = cells[cells.length - 1];
+ if (!releaseVersionCell) continue;
+
+ for (const version of releaseVersionCell.matchAll(pythonVersionPattern)) {
+ versions.add(version[1]);
+ }
+ }
+
+ return versions;
+}
+
+function readDocumentedPythonSdkVersions() {
+ const changelogDir = new URL('../docs/content/changelog/', import.meta.url);
+ const rows = [];
+
+ for (const entry of readdirSync(changelogDir, { withFileTypes: true })) {
+ if (!entry.isFile() || !entry.name.endsWith('.mdx')) continue;
+
+ const source = readFileSync(new URL(`../docs/content/changelog/${entry.name}`, import.meta.url), 'utf8');
+ rows.push(...(source.match(/^\|\s*Python `composio`\s*\|.*$/gm) ?? []));
+ }
+
+ return readPythonSdkVersions(rows);
+}
+
+{
+ const directVersion = readPythonSdkVersions(['| Python `composio` | `9.9.9` |']);
+ const versionWithPrevious = readPythonSdkVersions([
+ '| Python `composio` | v9.9.8 | **v9.9.9** |',
+ ]);
+ const previousVersionOnly = readPythonSdkVersions([
+ '| Python `composio` | v9.9.9 | **v9.9.10** |',
+ ]);
+ const pep440Versions = readPythonSdkVersions([
+ '| Python `composio` | `9.9.9rc1` |',
+ '| Python `composio` | `9.9.9.post1` |',
+ '| Python `composio` | `9.9.9.dev1` |',
+ ]);
+
+ if (!directVersion.has('9.9.9') || !versionWithPrevious.has('9.9.9')) {
+ throw new Error('Python SDK changelog version rows must recognize the released version');
+ }
+ if (previousVersionOnly.has('9.9.9')) {
+ throw new Error('Python SDK changelog version rows must not treat the previous version as released');
+ }
+ for (const version of ['9.9.9rc1', '9.9.9.post1', '9.9.9.dev1']) {
+ if (!pep440Versions.has(version)) {
+ throw new Error(`Python SDK changelog version rows must recognize PEP 440 version ${version}`);
+ }
+ }
}
if (!tsReleaseWorkflow.includes('publish: pnpm changeset:release')) {
@@ -91,7 +145,7 @@ if (
);
}
-// --- Python release metadata: package version, runtime version, and changelog must agree ---
+// --- Python release metadata: package version, runtime version, and docs changelog must agree ---
{
const pythonVersion = readPyprojectVersion(pythonPyproject, 'python/pyproject.toml version');
@@ -107,10 +161,10 @@ if (
);
}
- const changelogVersions = readChangelogVersions(pythonChangelog);
- if (changelogVersions[0] !== pythonVersion) {
+ const documentedPythonVersions = readDocumentedPythonSdkVersions();
+ if (!documentedPythonVersions.has(pythonVersion)) {
throw new Error(
- `python/CHANGELOG.md must start with the current Python package version (${changelogVersions[0] ?? 'none'} !== ${pythonVersion})`
+ `docs/content/changelog must document the current Python package version (${pythonVersion})`
);
}