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): prepare 0.19.0 release (#4114)
This PR: - builds on top of https://github.com/ComposioHQ/composio/pull/4094 - bumps `composio` and all 12 provider distributions from `0.18.2` to `0.19.0` - keeps `python/composio/__version__.py` and `uv.lock` aligned with package metadata - documents recursive provider argument-presence preservation in the existing cross-SDK changelog - passes the release-workflow guard, Ruff, mypy, provider type inference, and 1,167 Python tests - builds and validates 26 wheel/sdist artifacts with Twine - must be retargeted to `next` after #4094 merges
Alberto Schiabel committed
Aug 11, 2026 at 10:44 UTC
26ec42a38ceeb803c5f3252b14ac5d0a04336b6c
28 files changed
+48
-36
docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
+13
-1
@@ -120,11 +120,23 @@ wrapped.run({"name": "a", "typo": 1})
120
121
This brings Python in line with the TypeScript SDK, where the Zod converter has always rejected unknown keys for schemas that name properties. Strictness applies only when `additionalProperties` is omitted; `additionalProperties: true` and schema-valued forms behave as declared.
122
123
+#### Provider argument presence is preserved
124
+
125
+CrewAI, LangChain, and LangGraph now keep the difference between an omitted optional field and a field explicitly set to `None`. JSON Schema defaults are included, while optional fields with no default stay absent. The same rules apply inside nested objects, arrays, maps, combiners, and dynamic-key values.
126
+
127
+```python
128
+# The schema requires `query`, allows a nullable `note`, and defaults `page` to 5.
129
+wrapped.run({"query": "agents", "note": None})
130
+# The tool receives {"query": "agents", "note": None, "page": 5}.
131
+```
132
+
133
+If you omit `note`, the tool does not receive it. Before this release, provider serialization could add an omitted nullable field as `None`, or drop an explicit `None`, a declared default, or a dynamic extra.
134
+
135
#### Not affected
136
137
- **`composio_openai`, `composio_anthropic`, and the other non-agentic providers.** These hand the raw JSON schema to the model API and pass the returned arguments straight through, so they never build a Pydantic model from a tool schema.
138
- **`composio_gemini`.** Gemini builds a typed signature through `json_schema_to_pydantic_type`, so free-form object arguments now use `Dict[str, Any]` instead of an empty model. It does not use `json_schema_to_model`, so the unknown-key rejection above does not apply.
127
-- **Declared field behavior, aliases for reserved Python keywords, `skip_default`, combiners, and references in declared fields.** All unchanged. Dynamic-key schema validation is the exception, as described above.
139
+- **Provider APIs and invocation signatures.** You wrap and call tools the same way. The change is limited to validated arguments passed to the tool.
140
141
### Behavior Change for the Claude Agent SDK Provider
142
python/composio/__version__.py
+1
-1
@@ -1 +1 @@
1
-__version__ = "0.18.2"
1
+__version__ = "0.19.0"
python/providers/anthropic/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-anthropic"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your Anthropic LLMs."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/anthropic/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_anthropic",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Anthropic LLMs.",
python/providers/autogen/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-autogen"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your autogen agent."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/autogen/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_autogen",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Autogen agent.",
python/providers/claude_agent_sdk/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-claude-agent-sdk"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with Claude Code Agents SDK."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/claude_agent_sdk/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9
setup(
10
name="composio_claude_agent_sdk",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools for Claude Agent SDK",
python/providers/crewai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-crewai"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your CrewAI agent."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/crewai/setup.py
+1
-1
@@ -6,7 +6,7 @@ from setuptools import setup
6
7
setup(
8
name="composio_crewai",
9
- version="0.18.2",
9
+ version="0.19.0",
10
author="Composio",
11
author_email="tech@composio.dev",
12
description="Use Composio to get an array of tools with your CrewAI agent.",
python/providers/gemini/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-gemini"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your Gemini agent."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/gemini/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_gemini",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Gemini agent.",
python/providers/google/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-google"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/google/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_google",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/google_adk/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-google-adk"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/google_adk/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_google_adk",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
python/providers/langchain/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-langchain"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your Langchain agent."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/langchain/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_langchain",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your Langchain agent.",
python/providers/langgraph/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-langgraph"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/langgraph/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_langgraph",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools with LangGraph Agent Workflows",
python/providers/llamaindex/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-llamaindex"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/llamaindex/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_llamaindex",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
python/providers/openai/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-openai"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get an array of tools with your OpenAI Function Call."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/openai/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import setup
8
9
setup(
10
name="composio_openai",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get an array of tools with your OpenAI Function Call.",
python/providers/openai_agents/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio-openai-agents"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
python/providers/openai_agents/setup.py
+1
-1
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
8
9
setup(
10
name="composio_openai_agents",
11
- version="0.18.2",
11
+ version="0.19.0",
12
author="Composio",
13
author_email="tech@composio.dev",
14
description="Use Composio to get array of strongly typed tools for OpenAI Agents",
python/pyproject.toml
+1
-1
@@ -1,6 +1,6 @@
1
[project]
2
name = "composio"
3
-version = "0.18.2"
3
+version = "0.19.0"
4
description = "SDK for integrating Composio with your applications."
5
readme = "README.md"
6
requires-python = ">=3.10,<4"
uv.lock
+9
-9
@@ -714,7 +714,7 @@ wheels = [
714
715
[[package]]
716
name = "composio"
717
-version = "0.18.2"
717
+version = "0.19.0"
718
source = { editable = "python" }
719
dependencies = [
720
{ name = "composio-client" },
@@ -773,7 +773,7 @@ dev = [
773
774
[[package]]
775
name = "composio-anthropic"
776
-version = "0.18.2"
776
+version = "0.19.0"
777
source = { editable = "python/providers/anthropic" }
778
dependencies = [
779
{ name = "anthropic" },
@@ -805,7 +805,7 @@ wheels = [
805
806
[[package]]
807
name = "composio-crewai"
808
-version = "0.18.2"
808
+version = "0.19.0"
809
source = { editable = "python/providers/crewai" }
810
dependencies = [
811
{ name = "composio" },
@@ -820,7 +820,7 @@ requires-dist = [
820
821
[[package]]
822
name = "composio-gemini"
823
-version = "0.18.2"
823
+version = "0.19.0"
824
source = { virtual = "python/providers/gemini" }
825
dependencies = [
826
{ name = "composio" },
@@ -835,7 +835,7 @@ requires-dist = [
835
836
[[package]]
837
name = "composio-google"
838
-version = "0.18.2"
838
+version = "0.19.0"
839
source = { editable = "python/providers/google" }
840
dependencies = [
841
{ name = "composio" },
@@ -850,7 +850,7 @@ requires-dist = [
850
851
[[package]]
852
name = "composio-google-adk"
853
-version = "0.18.2"
853
+version = "0.19.0"
854
source = { editable = "python/providers/google_adk" }
855
dependencies = [
856
{ name = "composio" },
@@ -865,7 +865,7 @@ requires-dist = [
865
866
[[package]]
867
name = "composio-langchain"
868
-version = "0.18.2"
868
+version = "0.19.0"
869
source = { editable = "python/providers/langchain" }
870
dependencies = [
871
{ name = "composio" },
@@ -880,7 +880,7 @@ requires-dist = [
880
881
[[package]]
882
name = "composio-openai"
883
-version = "0.18.2"
883
+version = "0.19.0"
884
source = { editable = "python/providers/openai" }
885
dependencies = [
886
{ name = "composio" },
@@ -895,7 +895,7 @@ requires-dist = [
895
896
[[package]]
897
name = "composio-openai-agents"
898
-version = "0.18.2"
898
+version = "0.19.0"
899
source = { editable = "python/providers/openai_agents" }
900
dependencies = [
901
{ name = "composio" },