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): prepare 0.19.0 release (#4114)

Alberto Schiabel26ec42a38cee
diff --git a/docs/content/changelog/08-06-26-free-form-tool-arguments.mdx b/docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
index c68fe03bd..7477f18d7 100644
--- a/docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
+++ b/docs/content/changelog/08-06-26-free-form-tool-arguments.mdx
@@ -120,11 +120,23 @@ wrapped.run({"name": "a", "typo": 1})
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.
+#### Provider argument presence is preserved
+
+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.
+
+```python
+# The schema requires `query`, allows a nullable `note`, and defaults `page` to 5.
+wrapped.run({"query": "agents", "note": None})
+# The tool receives {"query": "agents", "note": None, "page": 5}.
+```
+
+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.
+
#### Not affected
- **`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.
- **`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.
-- **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.
+- **Provider APIs and invocation signatures.** You wrap and call tools the same way. The change is limited to validated arguments passed to the tool.
### Behavior Change for the Claude Agent SDK Provider
diff --git a/python/composio/__version__.py b/python/composio/__version__.py
index b0d7306ae..11ac8e1a9 100644
--- a/python/composio/__version__.py
+++ b/python/composio/__version__.py
@@ -1 +1 @@
-__version__ = "0.18.2"
+__version__ = "0.19.0"
diff --git a/python/providers/anthropic/pyproject.toml b/python/providers/anthropic/pyproject.toml
index 0f7416114..f50f95e78 100644
--- a/python/providers/anthropic/pyproject.toml
+++ b/python/providers/anthropic/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-anthropic"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your Anthropic LLMs."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/anthropic/setup.py b/python/providers/anthropic/setup.py
index e3dd3eae6..936464f6b 100644
--- a/python/providers/anthropic/setup.py
+++ b/python/providers/anthropic/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_anthropic",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Anthropic LLMs.",
diff --git a/python/providers/autogen/pyproject.toml b/python/providers/autogen/pyproject.toml
index 9ba0e7d0a..f290fa5cf 100644
--- a/python/providers/autogen/pyproject.toml
+++ b/python/providers/autogen/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-autogen"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your autogen agent."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/autogen/setup.py b/python/providers/autogen/setup.py
index 024a57ef2..3bb954815 100644
--- a/python/providers/autogen/setup.py
+++ b/python/providers/autogen/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_autogen",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Autogen agent.",
diff --git a/python/providers/claude_agent_sdk/pyproject.toml b/python/providers/claude_agent_sdk/pyproject.toml
index 47579c000..bdb541ef5 100644
--- a/python/providers/claude_agent_sdk/pyproject.toml
+++ b/python/providers/claude_agent_sdk/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-claude-agent-sdk"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with Claude Code Agents SDK."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/claude_agent_sdk/setup.py b/python/providers/claude_agent_sdk/setup.py
index 9b2e2478e..0ce5b373e 100644
--- a/python/providers/claude_agent_sdk/setup.py
+++ b/python/providers/claude_agent_sdk/setup.py
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
setup(
name="composio_claude_agent_sdk",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get array of tools for Claude Agent SDK",
diff --git a/python/providers/crewai/pyproject.toml b/python/providers/crewai/pyproject.toml
index 2c0492025..2aac7e200 100644
--- a/python/providers/crewai/pyproject.toml
+++ b/python/providers/crewai/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-crewai"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your CrewAI agent."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/crewai/setup.py b/python/providers/crewai/setup.py
index 8b697d1ad..2bd4856f0 100644
--- a/python/providers/crewai/setup.py
+++ b/python/providers/crewai/setup.py
@@ -6,7 +6,7 @@ from setuptools import setup
setup(
name="composio_crewai",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your CrewAI agent.",
diff --git a/python/providers/gemini/pyproject.toml b/python/providers/gemini/pyproject.toml
index 283ccd651..a1b8c964f 100644
--- a/python/providers/gemini/pyproject.toml
+++ b/python/providers/gemini/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-gemini"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your Gemini agent."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/gemini/setup.py b/python/providers/gemini/setup.py
index dbf83f65f..236f807b4 100644
--- a/python/providers/gemini/setup.py
+++ b/python/providers/gemini/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_gemini",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Gemini agent.",
diff --git a/python/providers/google/pyproject.toml b/python/providers/google/pyproject.toml
index 01aaa26fc..d69cd770d 100644
--- a/python/providers/google/pyproject.toml
+++ b/python/providers/google/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-google"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/google/setup.py b/python/providers/google/setup.py
index 54a361262..e6be39ffd 100644
--- a/python/providers/google/setup.py
+++ b/python/providers/google/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_google",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
diff --git a/python/providers/google_adk/pyproject.toml b/python/providers/google_adk/pyproject.toml
index 6216d15bf..064e85438 100644
--- a/python/providers/google_adk/pyproject.toml
+++ b/python/providers/google_adk/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-google-adk"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your Google AI Python Gemini model."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/google_adk/setup.py b/python/providers/google_adk/setup.py
index f0a17da99..0946a3a97 100644
--- a/python/providers/google_adk/setup.py
+++ b/python/providers/google_adk/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_google_adk",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Google AI Python Gemini model.",
diff --git a/python/providers/langchain/pyproject.toml b/python/providers/langchain/pyproject.toml
index fe6ba7b24..f0b427247 100644
--- a/python/providers/langchain/pyproject.toml
+++ b/python/providers/langchain/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-langchain"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your Langchain agent."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/langchain/setup.py b/python/providers/langchain/setup.py
index 830923b96..9630ebce2 100644
--- a/python/providers/langchain/setup.py
+++ b/python/providers/langchain/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_langchain",
- version="0.18.2",
+ version="0.19.0",
author="composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your Langchain agent.",
diff --git a/python/providers/langgraph/pyproject.toml b/python/providers/langgraph/pyproject.toml
index ef144b48c..4d1bdd609 100644
--- a/python/providers/langgraph/pyproject.toml
+++ b/python/providers/langgraph/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-langgraph"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get array of tools with LangGraph Agent Workflows."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/langgraph/setup.py b/python/providers/langgraph/setup.py
index 33ac14450..f4ff7d12b 100644
--- a/python/providers/langgraph/setup.py
+++ b/python/providers/langgraph/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_langgraph",
- version="0.18.2",
+ version="0.19.0",
author="composio",
author_email="[email protected]",
description="Use Composio to get array of tools with LangGraph Agent Workflows",
diff --git a/python/providers/llamaindex/pyproject.toml b/python/providers/llamaindex/pyproject.toml
index 9ed809185..d2d6090fd 100644
--- a/python/providers/llamaindex/pyproject.toml
+++ b/python/providers/llamaindex/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-llamaindex"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get array of tools with LlamaIndex Agent Workflows."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/llamaindex/setup.py b/python/providers/llamaindex/setup.py
index d79230b19..c2f05a2f9 100644
--- a/python/providers/llamaindex/setup.py
+++ b/python/providers/llamaindex/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_llamaindex",
- version="0.18.2",
+ version="0.19.0",
author="composio",
author_email="[email protected]",
description="Use Composio to get array of tools with LlamaIndex Agent Workflows",
diff --git a/python/providers/openai/pyproject.toml b/python/providers/openai/pyproject.toml
index 1a0c9cd77..bc1306660 100644
--- a/python/providers/openai/pyproject.toml
+++ b/python/providers/openai/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-openai"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get an array of tools with your OpenAI Function Call."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/openai/setup.py b/python/providers/openai/setup.py
index c509cf564..adae20003 100644
--- a/python/providers/openai/setup.py
+++ b/python/providers/openai/setup.py
@@ -8,7 +8,7 @@ from setuptools import setup
setup(
name="composio_openai",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get an array of tools with your OpenAI Function Call.",
diff --git a/python/providers/openai_agents/pyproject.toml b/python/providers/openai_agents/pyproject.toml
index c7d59a949..787c63c79 100644
--- a/python/providers/openai_agents/pyproject.toml
+++ b/python/providers/openai_agents/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio-openai-agents"
-version = "0.18.2"
+version = "0.19.0"
description = "Use Composio to get array of strongly typed tools for OpenAI Agents"
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/python/providers/openai_agents/setup.py b/python/providers/openai_agents/setup.py
index 2a8a75378..8d984638f 100644
--- a/python/providers/openai_agents/setup.py
+++ b/python/providers/openai_agents/setup.py
@@ -8,7 +8,7 @@ from setuptools import find_packages, setup
setup(
name="composio_openai_agents",
- version="0.18.2",
+ version="0.19.0",
author="Composio",
author_email="[email protected]",
description="Use Composio to get array of strongly typed tools for OpenAI Agents",
diff --git a/python/pyproject.toml b/python/pyproject.toml
index 8fcb82dd5..2568df30e 100644
--- a/python/pyproject.toml
+++ b/python/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "composio"
-version = "0.18.2"
+version = "0.19.0"
description = "SDK for integrating Composio with your applications."
readme = "README.md"
requires-python = ">=3.10,<4"
diff --git a/uv.lock b/uv.lock
index 339815359..8c8401fd7 100644
--- a/uv.lock
+++ b/uv.lock
@@ -714,7 +714,7 @@ wheels = [
[[package]]
name = "composio"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python" }
dependencies = [
{ name = "composio-client" },
@@ -773,7 +773,7 @@ dev = [
[[package]]
name = "composio-anthropic"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/anthropic" }
dependencies = [
{ name = "anthropic" },
@@ -805,7 +805,7 @@ wheels = [
[[package]]
name = "composio-crewai"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/crewai" }
dependencies = [
{ name = "composio" },
@@ -820,7 +820,7 @@ requires-dist = [
[[package]]
name = "composio-gemini"
-version = "0.18.2"
+version = "0.19.0"
source = { virtual = "python/providers/gemini" }
dependencies = [
{ name = "composio" },
@@ -835,7 +835,7 @@ requires-dist = [
[[package]]
name = "composio-google"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/google" }
dependencies = [
{ name = "composio" },
@@ -850,7 +850,7 @@ requires-dist = [
[[package]]
name = "composio-google-adk"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/google_adk" }
dependencies = [
{ name = "composio" },
@@ -865,7 +865,7 @@ requires-dist = [
[[package]]
name = "composio-langchain"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/langchain" }
dependencies = [
{ name = "composio" },
@@ -880,7 +880,7 @@ requires-dist = [
[[package]]
name = "composio-openai"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/openai" }
dependencies = [
{ name = "composio" },
@@ -895,7 +895,7 @@ requires-dist = [
[[package]]
name = "composio-openai-agents"
-version = "0.18.2"
+version = "0.19.0"
source = { editable = "python/providers/openai_agents" }
dependencies = [
{ name = "composio" },