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.

chore(py): document pending releases (#3583)

Alberto Schiabeleeaac651d87e
diff --git a/python/CHANGELOG.md b/python/CHANGELOG.md
index d3c1a2b49..119df4787 100644
--- a/python/CHANGELOG.md
+++ b/python/CHANGELOG.md
@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
> 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.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
@@ -93,4 +110,4 @@ For detailed commit history and technical changes, see the [Git commit log](http
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)
\ No newline at end of file
+- [Community Discord](https://discord.gg/composio)
diff --git a/python/composio/__version__.py b/python/composio/__version__.py
index 76595651c..9da2f8fcc 100644
--- a/python/composio/__version__.py
+++ b/python/composio/__version__.py
@@ -1 +1 @@
-__version__ = "1.0.0-rc2"
+__version__ = "0.15.0"
diff --git a/test/release-workflow.test.ts b/test/release-workflow.test.ts
index 8a7d6f78c..a016962eb 100644
--- a/test/release-workflow.test.ts
+++ b/test/release-workflow.test.ts
@@ -1,5 +1,14 @@
#!/usr/bin/env node
-import { chmodSync, mkdirSync, mkdtempSync, rmSync, writeFileSync, readFileSync } from 'node:fs';
+import {
+ chmodSync,
+ existsSync,
+ mkdirSync,
+ mkdtempSync,
+ readdirSync,
+ rmSync,
+ writeFileSync,
+ readFileSync,
+} from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { spawnSync } from 'node:child_process';
@@ -12,6 +21,12 @@ const tsReleaseWorkflow = readFileSync(
new URL('../.github/workflows/ts.release.yml', import.meta.url),
'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'
+);
const changesetBinPath = new URL('../node_modules/.bin/changeset', import.meta.url).pathname;
const releaseScriptUrl = new URL('../ts/scripts/changeset-release.sh', import.meta.url);
const releaseScriptPath = releaseScriptUrl.pathname;
@@ -39,6 +54,22 @@ const verifyAssetsScript = readFileSync(
'utf8'
);
+function requireMatch(text, pattern, label) {
+ const match = text.match(pattern);
+ if (!match?.[1]) {
+ throw new Error(`Could not read ${label}`);
+ }
+ return match[1];
+}
+
+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]);
+}
+
if (!tsReleaseWorkflow.includes('publish: pnpm changeset:release')) {
throw new Error('ts.release.yml must use the repository-controlled changeset:release script');
}
@@ -60,6 +91,63 @@ if (
);
}
+// --- Python release metadata: package version, runtime version, and changelog must agree ---
+
+{
+ const pythonVersion = readPyprojectVersion(pythonPyproject, 'python/pyproject.toml version');
+ const runtimeVersion = requireMatch(
+ pythonRuntimeVersionModule,
+ /^\s*__version__\s*=\s*"([^"]+)"\s*$/m,
+ 'python/composio/__version__.py version'
+ );
+
+ if (runtimeVersion !== pythonVersion) {
+ throw new Error(
+ `python/composio/__version__.py must match python/pyproject.toml (${runtimeVersion} !== ${pythonVersion})`
+ );
+ }
+
+ const changelogVersions = readChangelogVersions(pythonChangelog);
+ if (changelogVersions[0] !== pythonVersion) {
+ throw new Error(
+ `python/CHANGELOG.md must start with the current Python package version (${changelogVersions[0] ?? 'none'} !== ${pythonVersion})`
+ );
+ }
+
+ const providerDir = new URL('../python/providers/', import.meta.url);
+ for (const entry of readdirSync(providerDir, { withFileTypes: true })) {
+ if (!entry.isDirectory()) continue;
+
+ const pyprojectPath = new URL(
+ `../python/providers/${entry.name}/pyproject.toml`,
+ import.meta.url
+ );
+ const setupPath = new URL(`../python/providers/${entry.name}/setup.py`, import.meta.url);
+ if (!existsSync(pyprojectPath) || !existsSync(setupPath)) continue;
+
+ const providerPyprojectVersion = readPyprojectVersion(
+ readFileSync(pyprojectPath, 'utf8'),
+ `python/providers/${entry.name}/pyproject.toml version`
+ );
+ const providerSetupVersion = requireMatch(
+ readFileSync(setupPath, 'utf8'),
+ /version\s*=\s*"([^"]+)"/,
+ `python/providers/${entry.name}/setup.py version`
+ );
+
+ if (providerPyprojectVersion !== pythonVersion) {
+ throw new Error(
+ `python/providers/${entry.name}/pyproject.toml must match python/pyproject.toml (${providerPyprojectVersion} !== ${pythonVersion})`
+ );
+ }
+ if (providerSetupVersion !== pythonVersion) {
+ throw new Error(
+ `python/providers/${entry.name}/setup.py must match python/pyproject.toml (${providerSetupVersion} !== ${pythonVersion})`
+ );
+ }
+ }
+}
+
if (!releaseScript.includes('pnpm changeset publish')) {
throw new Error('release script must still publish non-CLI changeset packages');
}