@devries-cameron20 / composio Mirror · read-only / commits / edd0bf047
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 18:30 UTC

docs: centralize SDK release notes (#3814)

This PR: - Adds public docs changelog entries for the Python and TypeScript SDK releases since May 15, 2026, including the previously unmigrated Python 0.13.1 entry. - Removes the Python-local changelog and replaces it with canonical changelog links from the repository and Python READMEs. - Retargets the Python release guard to the docs changelog, documents its table contract, and covers prior-version plus PEP 440 version parsing. Validation: - pnpm test:release-workflow - docs: bun run test - docs: bun run lint:links - docs: bun run types:check - docs: bun run build - pnpm exec prettier --check test/release-workflow.test.ts docs/agent-guidance/guides/changelog.md docs/content/changelog/*.mdx Review: - ce-code-review completed with correctness, testing, maintainability, project-standards, agent-native, learnings, and adversarial passes. All actionable findings were fixed; final adversarial re-review found no remaining P0-P2 issue.

Alberto Schiabel committed Jul 13, 2026 at 16:23 UTC edd0bf047917af05f197c56054f0b6cf905e9b7e
14 files changed +364 -158
CHANGELOG.md new
+3
@@ -0,0 +1,3 @@
1 +# Changelog
2 +
3 +Composio release notes are published in the [official changelog](https://docs.composio.dev/reference/changelog).
README.md
+2 -1
@@ -10,7 +10,8 @@
10 <p align="center">
11 <a href="https://composio.dev"><b>composio.dev</b></a> •
12 <a href="https://docs.composio.dev">Documentation</a> •
13 - <a href="https://docs.composio.dev/docs/quickstart">Quickstart</a>
13 + <a href="https://docs.composio.dev/docs/quickstart">Quickstart</a> •
14 + <a href="https://docs.composio.dev/reference/changelog">Changelog</a>
15 </p>
16
17 <p align="center">
docs/agent-guidance/guides/changelog.md
+4 -2
@@ -21,8 +21,8 @@ Brief intro paragraph.
21
22 | SDK | Version |
23 |-----|---------|
24 -| Python | v0.10.2 |
25 -| TypeScript | v0.3.1 |
24 +| Python `composio` | `0.10.2` |
25 +| TypeScript `@composio/core` | `0.3.1` |
26
27 ### Breaking Changes (if applicable)
28
@@ -48,6 +48,8 @@ new_code()
48 - Change 2
49 ```
50
51 +Use the released version in the final table column. The Python release guard reads that column from rows labelled `Python \`composio\``.
52 +
53 ## Rules
54
55 1. **Frontmatter required** — `title` and `date` (YYYY-MM-DD format)
docs/content/changelog/05-13-26-python-sdk-0131.mdx new
+23
@@ -0,0 +1,23 @@
1 +---
2 +title: "Python SDK 0.13.1 adds experimental shared connections"
3 +description: "Python SDK 0.13.1 adds experimental shared connected accounts, ACL helpers, and fixes legacy initiate warnings."
4 +date: "2026-05-13"
5 +---
6 +
7 +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.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| Python `composio` | `0.13.1` |
14 +
15 +### Shared connections
16 +
17 +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.
18 +
19 +<Callout>
20 +Shared connections are experimental. Their shape may change, so pin a specific SDK version if your application depends on the current API.
21 +</Callout>
22 +
23 +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.
docs/content/changelog/06-16-26-python-sdk-014.mdx new
+63
@@ -0,0 +1,63 @@
1 +---
2 +title: "Python SDK 0.14.0 removes the legacy custom-tool registry"
3 +description: "Python SDK 0.14.0 removes the legacy in-memory custom-tool registry. Tool Router custom tools remain the supported path."
4 +date: "2026-06-16"
5 +---
6 +
7 +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.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| Python `composio` | `0.14.0` |
14 +
15 +### Breaking change
16 +
17 +<Callout type="warn">
18 +**Breaking change**
19 +
20 +`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.
21 +</Callout>
22 +
23 +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.
24 +
25 +### Migration
26 +
27 +1. Replace `@composio.tools.custom_tool` with `@composio.experimental.tool`.
28 +2. Change the tool signature from a request object plus execution callback to `input, ctx`.
29 +3. Attach the tool when creating the session through `experimental.custom_tools`.
30 +
31 +Before:
32 +
33 +```python
34 +from composio import Composio
35 +
36 +composio = Composio()
37 +
38 +
39 +@composio.tools.custom_tool
40 +def add_two_numbers(request: AddTwoNumbersInput) -> int:
41 + return request.a + request.b
42 +```
43 +
44 +After:
45 +
46 +```python
47 +from composio import Composio
48 +
49 +composio = Composio()
50 +
51 +
52 +@composio.experimental.tool
53 +def add_two_numbers(input: AddTwoNumbersInput, ctx):
54 + return {"result": input.a + input.b}
55 +
56 +
57 +session = composio.create(
58 + user_id="user_123",
59 + experimental={"custom_tools": [add_two_numbers]},
60 +)
61 +```
62 +
63 +For a tool that calls a toolkit API, set `extends_toolkit` on the decorator and use `ctx.proxy_execute(...)` from the function body.
docs/content/changelog/06-18-26-python-sdk-015.mdx new
+15
@@ -0,0 +1,15 @@
1 +---
2 +title: "Python SDK 0.15.0 supports trigger 2FA ownership checks"
3 +description: "Python SDK 0.15.0 forwards user_id when creating triggers so 2FA-enabled projects can verify connected-account ownership."
4 +date: "2026-06-18"
5 +---
6 +
7 +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.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| Python `composio` | `0.15.0` |
14 +
15 +No call-site migration is required. Pass `user_id` to `triggers.create()` when the trigger should be associated with a specific user.
docs/content/changelog/06-19-26-typescript-sdk-011.mdx new
+56
@@ -0,0 +1,56 @@
1 +---
2 +title: "TypeScript SDK 0.11.0 moves custom tools to Tool Router"
3 +description: "TypeScript SDK 0.11.0 removes the legacy custom-tool registry and improves trigger ownership, schemas, file handling, and provider tool arguments."
4 +date: "2026-06-19"
5 +---
6 +
7 +TypeScript SDK `@composio/core` `0.11.0` removes the old in-memory custom-tool registry. Custom tools now have one home: Tool Router sessions.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| TypeScript `@composio/core` | `0.11.0` |
14 +
15 +### Breaking change
16 +
17 +<Callout type="warn">
18 +**Breaking change**
19 +
20 +`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.
21 +</Callout>
22 +
23 +**Before:**
24 +
25 +```typescript
26 +// @noErrors
27 +const tool = composio.tools.createCustomTool({ /* ... */ });
28 +```
29 +
30 +**After:**
31 +
32 +```typescript
33 +// @noErrors
34 +import { experimental_createTool } from '@composio/core';
35 +
36 +const tool = experimental_createTool('GREP', {
37 + name: 'Grep Search',
38 + description: 'Search local files',
39 + inputParams: /* zod schema */,
40 + execute: async (input) => ({ input }),
41 +});
42 +
43 +await composio.create('user_123', {
44 + experimental: { customTools: [tool] },
45 +});
46 +```
47 +
48 +Use `experimental_createToolkit(...)` when several local tools belong together. The `experimental_*` names are intentional: this API is still evolving.
49 +
50 +### Improvements and fixes
51 +
52 +- `triggers.create()` now forwards `userId`, enabling trigger 2FA ownership checks.
53 +- Telemetry sends no longer delay SDK results or rethrown errors.
54 +- Automatic file handling now selects the correct branch for schemas that accept either one file or a list of files.
55 +- Providers normalize model-produced JSON-string tool arguments and raise `ComposioInvalidToolArgumentsError` for invalid values instead of leaking raw parser errors.
56 +- 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.
docs/content/changelog/06-25-26-sdk-012-and-python-016.mdx new
+52
@@ -0,0 +1,52 @@
1 +---
2 +title: "TypeScript SDK 0.12.0 and Python SDK 0.16.0"
3 +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."
4 +date: "2026-06-25"
5 +---
6 +
7 +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.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| TypeScript `@composio/core` | `0.12.0` |
14 +| Python `composio` | `0.16.0` |
15 +
16 +### TypeScript: request cancellation and ESM-only packages
17 +
18 +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`.
19 +
20 +<Callout type="warn">
21 +**Breaking change**
22 +
23 +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.
24 +</Callout>
25 +
26 +**Before:**
27 +
28 +```javascript
29 +const { Composio } = require('@composio/core');
30 +```
31 +
32 +**After:**
33 +
34 +```javascript
35 +import { Composio } from '@composio/core';
36 +```
37 +
38 +The deprecated auth-config `uuid` response field was also removed. Use the canonical `id` field instead.
39 +
40 +### TypeScript improvements
41 +
42 +- `authConfigs.list()` adds `search` and `showDisabled` filters.
43 +- Tool schema handling preserves and resolves internal `$defs` and `$ref` values for automatic file upload and download.
44 +- Custom tools correctly convert both Zod 3 and Zod 4 schemas to JSON Schema.
45 +- The Anthropic provider sanitizes unsupported input-schema property names and restores the original tool arguments before execution.
46 +
47 +### Python fixes
48 +
49 +- File fields hidden behind `$ref` or `$defs` are resolved before automatic upload and download handling.
50 +- `tools.execute()` and `tools.proxy()` no longer retry non-idempotent writes, preventing duplicate side effects after timeouts, 429s, or 5xx responses.
51 +- Session file transfers and presigned S3 requests now use bounded connect and read timeouts, surfacing typed file errors rather than hanging.
52 +- Provider tool schemas safely alias Python-invalid parameter names, preserve the original names for execution, and avoid mutating OpenAI Agents source schemas.
docs/content/changelog/06-26-26-typescript-sdk-013.mdx new
+36
@@ -0,0 +1,36 @@
1 +---
2 +title: "TypeScript SDK 0.13.0 adds sessions and 0.13.1 adds deletion"
3 +description: "TypeScript SDK 0.13.0 makes sessions first-class and MCP opt-in. Version 0.13.1 adds session deletion."
4 +date: "2026-06-26"
5 +---
6 +
7 +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.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| TypeScript `@composio/core` | `0.13.0` |
14 +| TypeScript `@composio/core` | `0.13.1` |
15 +
16 +### Sessions are first-class
17 +
18 +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.
19 +
20 +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.
21 +
22 +```typescript
23 +import { Composio } from '@composio/core';
24 +
25 +const composio = new Composio({ apiKey: 'your-api-key' });
26 +const session = await composio.sessions.create('user_123', { mcp: true });
27 +
28 +const mcp = session.mcp;
29 +```
30 +
31 +### Other session and trigger updates
32 +
33 +- Session responses expose the resolved workbench configuration. Prefer `sandbox` for code-execution configuration; `workbench` remains an accepted alias.
34 +- `triggers.parse()` parses incoming webhook requests and can verify their signatures.
35 +- `triggers.setWebhookSubscription()` creates or updates a project webhook subscription.
36 +- `composio.sessions.delete(sessionId)` and `session.delete()` remove a Tool Router session in `0.13.1`.
docs/content/changelog/06-27-26-python-sdk-017.mdx new
+26
@@ -0,0 +1,26 @@
1 +---
2 +title: "Python SDK 0.17.0 makes sessions first-class"
3 +description: "Python SDK 0.17.0 adds the sessions API, opt-in MCP, webhook helpers, shared-connection ACL updates, and sandbox configuration."
4 +date: "2026-06-27"
5 +---
6 +
7 +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.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| Python `composio` | `0.17.0` |
14 +
15 +### Sessions and MCP
16 +
17 +`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.
18 +
19 +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.
20 +
21 +### New APIs and behavior
22 +
23 +- `triggers.parse()` parses an incoming webhook request and can verify its signature. Passing an empty `verify_secret` now raises instead of silently skipping verification.
24 +- `triggers.set_webhook_subscription()` creates or updates the project webhook subscription.
25 +- `connected_accounts.update_acl()` is the primary shared-connection ACL patch helper. `experimental.update_acl()` remains as a deprecated alias.
26 +- Prefer `sandbox` for session code-execution configuration. `workbench` remains an accepted alias.
docs/content/changelog/06-28-26-python-sdk-0171.mdx new
+21
@@ -0,0 +1,21 @@
1 +---
2 +title: "Python SDK 0.17.1 adds session deletion"
3 +description: "Python SDK 0.17.1 adds Tool Router session deletion through the sessions API and a session instance method."
4 +date: "2026-06-28"
5 +---
6 +
7 +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`.
8 +
9 +### SDK versions
10 +
11 +| SDK | Version |
12 +| --- | --- |
13 +| Python `composio` | `0.17.1` |
14 +
15 +Delete a session from the client or from the session itself:
16 +
17 +```python
18 +composio.sessions.delete(session_id)
19 +
20 +session.delete()
21 +```
python/CHANGELOG.md deleted
-148
@@ -1,148 +0,0 @@
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)
python/README.md
+2
@@ -13,6 +13,7 @@ Composio gives your AI agents 1000+ pre-authenticated toolkits, per-user session
13
14 - [Documentation](https://docs.composio.dev)
15 - [Quickstart](https://docs.composio.dev/docs/quickstart)
16 +- [Changelog](https://docs.composio.dev/reference/changelog)
17 - [Dashboard](https://dashboard.composio.dev) (grab your `COMPOSIO_API_KEY` from [Settings](https://dashboard.composio.dev/settings))
18
19 ## Install
@@ -136,6 +137,7 @@ This package lives in the [Composio SDK monorepo](https://github.com/ComposioHQ/
137
138 - [Documentation](https://docs.composio.dev)
139 - [Python SDK reference](https://docs.composio.dev/reference/sdk-reference/python)
140 +- [Changelog](https://docs.composio.dev/reference/changelog)
141 - [Discord community](https://discord.gg/composio)
142 - [Open an issue](https://github.com/ComposioHQ/composio/issues)
143 - [support@composio.dev](mailto:support@composio.dev)
test/release-workflow.test.ts
+61 -7
@@ -22,7 +22,6 @@ const tsReleaseWorkflow = readFileSync(
22 'utf8'
23 );
24 const pythonPyproject = readFileSync(new URL('../python/pyproject.toml', import.meta.url), 'utf8');
25 -const pythonChangelog = readFileSync(new URL('../python/CHANGELOG.md', import.meta.url), 'utf8');
25 const pythonRuntimeVersionModule = readFileSync(
26 new URL('../python/composio/__version__.py', import.meta.url),
27 'utf8'
@@ -66,8 +65,63 @@ function readPyprojectVersion(text, label) {
65 return requireMatch(text, /^\s*version\s*=\s*"([^"]+)"\s*$/m, label);
66 }
67
69 -function readChangelogVersions(text) {
70 - return [...text.matchAll(/^## \[([^\]]+)\]/gm)].map(match => match[1]);
68 +function readPythonSdkVersions(rows) {
69 + const versions = new Set();
70 + const pythonVersionPattern =
71 + /\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;
72 +
73 + for (const row of rows) {
74 + const cells = row.split('|').map(cell => cell.trim()).filter(Boolean);
75 + const releaseVersionCell = cells[cells.length - 1];
76 + if (!releaseVersionCell) continue;
77 +
78 + for (const version of releaseVersionCell.matchAll(pythonVersionPattern)) {
79 + versions.add(version[1]);
80 + }
81 + }
82 +
83 + return versions;
84 +}
85 +
86 +function readDocumentedPythonSdkVersions() {
87 + const changelogDir = new URL('../docs/content/changelog/', import.meta.url);
88 + const rows = [];
89 +
90 + for (const entry of readdirSync(changelogDir, { withFileTypes: true })) {
91 + if (!entry.isFile() || !entry.name.endsWith('.mdx')) continue;
92 +
93 + const source = readFileSync(new URL(`../docs/content/changelog/${entry.name}`, import.meta.url), 'utf8');
94 + rows.push(...(source.match(/^\|\s*Python `composio`\s*\|.*$/gm) ?? []));
95 + }
96 +
97 + return readPythonSdkVersions(rows);
98 +}
99 +
100 +{
101 + const directVersion = readPythonSdkVersions(['| Python `composio` | `9.9.9` |']);
102 + const versionWithPrevious = readPythonSdkVersions([
103 + '| Python `composio` | v9.9.8 | **v9.9.9** |',
104 + ]);
105 + const previousVersionOnly = readPythonSdkVersions([
106 + '| Python `composio` | v9.9.9 | **v9.9.10** |',
107 + ]);
108 + const pep440Versions = readPythonSdkVersions([
109 + '| Python `composio` | `9.9.9rc1` |',
110 + '| Python `composio` | `9.9.9.post1` |',
111 + '| Python `composio` | `9.9.9.dev1` |',
112 + ]);
113 +
114 + if (!directVersion.has('9.9.9') || !versionWithPrevious.has('9.9.9')) {
115 + throw new Error('Python SDK changelog version rows must recognize the released version');
116 + }
117 + if (previousVersionOnly.has('9.9.9')) {
118 + throw new Error('Python SDK changelog version rows must not treat the previous version as released');
119 + }
120 + for (const version of ['9.9.9rc1', '9.9.9.post1', '9.9.9.dev1']) {
121 + if (!pep440Versions.has(version)) {
122 + throw new Error(`Python SDK changelog version rows must recognize PEP 440 version ${version}`);
123 + }
124 + }
125 }
126
127 if (!tsReleaseWorkflow.includes('publish: pnpm changeset:release')) {
@@ -91,7 +145,7 @@ if (
145 );
146 }
147
94 -// --- Python release metadata: package version, runtime version, and changelog must agree ---
148 +// --- Python release metadata: package version, runtime version, and docs changelog must agree ---
149
150 {
151 const pythonVersion = readPyprojectVersion(pythonPyproject, 'python/pyproject.toml version');
@@ -107,10 +161,10 @@ if (
161 );
162 }
163
110 - const changelogVersions = readChangelogVersions(pythonChangelog);
111 - if (changelogVersions[0] !== pythonVersion) {
164 + const documentedPythonVersions = readDocumentedPythonSdkVersions();
165 + if (!documentedPythonVersions.has(pythonVersion)) {
166 throw new Error(
113 - `python/CHANGELOG.md must start with the current Python package version (${changelogVersions[0] ?? 'none'} !== ${pythonVersion})`
167 + `docs/content/changelog must document the current Python package version (${pythonVersion})`
168 );
169 }
170