Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: centralize SDK release notes (#3814)
Alberto Schiabeledd0bf047917
diff --git a/CHANGELOG.md b/CHANGELOG.mdnew file mode 100644index 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.mdindex 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.mdindex 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\``.+## Rules1. **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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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()++[email protected]_tool+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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mdxnew file mode 100644index 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.mddeleted file mode 100644index 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.mdindex 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)- [[email protected]](mailto:[email protected])diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.tsindex 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})`);}