ci: diff explicit base...head shas to match files-changed

* Replace eval with safe expression parser in calculator tool example

Update the calculator tool example in the CLI template to use
ast.parse instead of eval for expression evaluation.

Co-authored-by: Vinicius Brasil <vini@hey.com>

* Replace calculator example with practical file reader tool

* Use word count example - safe, no file/eval risk

---------

Co-authored-by: Vinicius Brasil <vini@hey.com>

.github/workflows/pr-size.yml

@@ -29,4 +29,30 @@ jobs:
             lib/crewai/src/crewai/cli/templates/**
             **/*.json
             **/test_durations/**
-            **/cassettes/**
+            **/cassettes/**
+
+  python-diff-size:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
+        with:
+          fetch-depth: 0
+      - name: Enforce Python diff size limit
+        env:
+          MAX: "1500"
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: |
+          # Three-dot base...head == merge-base(base, head)..head: matches GitHub's
+          # "Files changed" diff and ignores the synthetic merge commit at HEAD.
+          # Sum added + deleted lines across changed .py files; skip binaries ("-").
+          total=$(git diff --numstat "$BASE_SHA...$HEAD_SHA" -- '*.py' \
+            | awk '$1 != "-" && $2 != "-" { sum += $1 + $2 } END { print sum + 0 }')
+          echo "Python churn: $total lines (limit $MAX)"
+          if [ "$total" -gt "$MAX" ]; then
+            echo "::error::Python changes total $total lines, over the $MAX-line limit. Split into smaller PRs."
+            git diff --numstat "$BASE_SHA...$HEAD_SHA" -- '*.py' | sort -rn
+            exit 1
+          fi

lib/cli/src/crewai_cli/templates/AGENTS.md

@@ -767,10 +767,11 @@ class CustomSearchTool(BaseTool):
 ```python
 from crewai.tools import tool
 
-@tool("Calculator")
-def calculator(expression: str) -> str:
-    """Evaluates a mathematical expression and returns the result."""
-    return str(eval(expression))
+@tool("WordCount")
+def word_count(text: str) -> str:
+    """Counts the number of words in the given text."""
+    count = len(text.split())
+    return f"Word count: {count}"
 ```
 
 ### Built-in Tools (install with `uv add crewai-tools`)

lib/crewai-tools/src/crewai_tools/generate_tool_specs.py

@@ -32,6 +32,8 @@ class ToolSpecExtractor:
             if name.endswith("Tool") and name not in self.processed_tools:
                 obj = getattr(tools, name, None)
                 if inspect.isclass(obj) and issubclass(obj, BaseTool):
+                    if getattr(obj, "is_deprecated_alias", False):
+                        continue
                     self.extract_tool_info(obj)
                     self.processed_tools.add(name)
         return self.tools_spec

lib/crewai-tools/src/crewai_tools/tools/exa_tools/exa_search_tool.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from builtins import type as type_
 import os
-from typing import Any, TypedDict
+from typing import Any, ClassVar, TypedDict
 import warnings
 
 from crewai.tools import BaseTool, EnvVar
@@ -160,6 +160,8 @@ class ExaSearchTool(BaseTool):
 class EXASearchTool(ExaSearchTool):
     """Deprecated alias for :class:`ExaSearchTool`. Kept for backwards compatibility."""
 
+    is_deprecated_alias: ClassVar[bool] = True
+
     name: str = "ExaSearchTool"
 
     def __init__(self, *args: Any, **kwargs: Any) -> None:

lib/crewai-tools/tests/test_generate_tool_specs.py

@@ -1,3 +1,4 @@
+import builtins
 import json
 from unittest import mock
 
@@ -7,6 +8,19 @@ from pydantic import BaseModel, Field
 import pytest
 
 
+def _getattr_for(tool_name, tool_cls):
+    """Build a getattr side_effect that resolves the patched tool name to
+    ``tool_cls`` while delegating every other lookup (e.g. the
+    ``is_deprecated_alias`` check) to the real builtin."""
+
+    def _getattr(obj, name, *default):
+        if name == tool_name:
+            return tool_cls
+        return builtins.getattr(obj, name, *default)
+
+    return _getattr
+
+
 class MockToolSchema(BaseModel):
     query: str = Field(..., description="The query parameter")
     count: int = Field(5, description="Number of results to return")
@@ -84,7 +98,10 @@ def test_unwrap_schema(extractor):
 def mock_tool_extractor(extractor):
     with (
         mock.patch("crewai_tools.generate_tool_specs.dir", return_value=["MockTool"]),
-        mock.patch("crewai_tools.generate_tool_specs.getattr", return_value=MockTool),
+        mock.patch(
+            "crewai_tools.generate_tool_specs.getattr",
+            side_effect=_getattr_for("MockTool", MockTool),
+        ),
     ):
         extractor.extract_all_tools()
         assert len(extractor.tools_spec) == 1
@@ -223,7 +240,7 @@ def test_intermediate_base_fields_preserved_for_derived_tool(extractor):
         ),
         mock.patch(
             "crewai_tools.generate_tool_specs.getattr",
-            return_value=MockDerivedTool,
+            side_effect=_getattr_for("MockDerivedTool", MockDerivedTool),
         ),
     ):
         extractor.extract_all_tools()
@@ -253,7 +270,10 @@ def test_future_base_tool_field_auto_excluded(extractor):
     by checking that ONLY non-BaseTool fields appear."""
     with (
         mock.patch("crewai_tools.generate_tool_specs.dir", return_value=["MockTool"]),
-        mock.patch("crewai_tools.generate_tool_specs.getattr", return_value=MockTool),
+        mock.patch(
+            "crewai_tools.generate_tool_specs.getattr",
+            side_effect=_getattr_for("MockTool", MockTool),
+        ),
     ):
         extractor.extract_all_tools()
         tool_info = extractor.tools_spec[0]

lib/crewai-tools/tests/tools/exa_search_tool_test.py

@@ -111,3 +111,11 @@ def test_exasearchtool_alias_is_deprecated():
         with pytest.warns(DeprecationWarning, match="ExaSearchTool"):
             tool = EXASearchTool(api_key="test_api_key")
         assert isinstance(tool, ExaSearchTool)
+
+
+def test_deprecated_alias_excluded_from_tool_specs():
+    from crewai_tools.generate_tool_specs import ToolSpecExtractor
+
+    names = {tool["name"] for tool in ToolSpecExtractor().extract_all_tools()}
+    assert "ExaSearchTool" in names
+    assert "EXASearchTool" not in names

lib/crewai-tools/tool.specs.json

@@ -9622,225 +9622,6 @@
         "type": "object"
       }
     },
-    {
-      "description": "Search the web with Exa, the fastest and most accurate web search API.",
-      "env_vars": [
-        {
-          "default": null,
-          "description": "API key for Exa services",
-          "name": "EXA_API_KEY",
-          "required": false
-        },
-        {
-          "default": null,
-          "description": "API url for the Exa services",
-          "name": "EXA_BASE_URL",
-          "required": false
-        }
-      ],
-      "humanized_name": "ExaSearchTool",
-      "init_params_schema": {
-        "$defs": {
-          "EnvVar": {
-            "properties": {
-              "default": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "default": null,
-                "title": "Default"
-              },
-              "description": {
-                "title": "Description",
-                "type": "string"
-              },
-              "name": {
-                "title": "Name",
-                "type": "string"
-              },
-              "required": {
-                "default": true,
-                "title": "Required",
-                "type": "boolean"
-              }
-            },
-            "required": [
-              "name",
-              "description"
-            ],
-            "title": "EnvVar",
-            "type": "object"
-          }
-        },
-        "description": "Deprecated alias for :class:`ExaSearchTool`. Kept for backwards compatibility.",
-        "properties": {
-          "api_key": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "API key for Exa services",
-            "required": false,
-            "title": "Api Key"
-          },
-          "base_url": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "API server url",
-            "required": false,
-            "title": "Base Url"
-          },
-          "client": {
-            "anyOf": [
-              {},
-              {
-                "type": "null"
-              }
-            ],
-            "default": null,
-            "title": "Client"
-          },
-          "content": {
-            "anyOf": [
-              {
-                "type": "boolean"
-              },
-              {
-                "additionalProperties": true,
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": false,
-            "title": "Content"
-          },
-          "highlights": {
-            "anyOf": [
-              {
-                "type": "boolean"
-              },
-              {
-                "additionalProperties": true,
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": true,
-            "title": "Highlights"
-          },
-          "summary": {
-            "anyOf": [
-              {
-                "type": "boolean"
-              },
-              {
-                "additionalProperties": true,
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": false,
-            "title": "Summary"
-          },
-          "type": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": "auto",
-            "title": "Type"
-          }
-        },
-        "required": [],
-        "title": "EXASearchTool",
-        "type": "object"
-      },
-      "name": "EXASearchTool",
-      "package_dependencies": [
-        "exa_py"
-      ],
-      "run_params_schema": {
-        "properties": {
-          "end_published_date": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": null,
-            "description": "End date for the search",
-            "title": "End Published Date"
-          },
-          "include_domains": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": null,
-            "description": "List of domains to include in the search",
-            "title": "Include Domains"
-          },
-          "search_query": {
-            "description": "Mandatory search query you want to use to search the internet",
-            "title": "Search Query",
-            "type": "string"
-          },
-          "start_published_date": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "default": null,
-            "description": "Start date for the search",
-            "title": "Start Published Date"
-          }
-        },
-        "required": [
-          "search_query"
-        ],
-        "title": "ExaBaseToolSchema",
-        "type": "object"
-      }
-    },
     {
       "description": "Search the web with Exa, the fastest and most accurate web search API.",
       "env_vars": [

uv.lock

@@ -978,7 +978,7 @@ wheels = [
 
 [[package]]
 name = "chromadb"
-version = "1.5.9"
+version = "1.1.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "bcrypt" },
@@ -997,9 +997,9 @@ dependencies = [
     { name = "opentelemetry-sdk" },
     { name = "orjson" },
     { name = "overrides" },
+    { name = "posthog" },
     { name = "pybase64" },
     { name = "pydantic" },
-    { name = "pydantic-settings" },
     { name = "pypika" },
     { name = "pyyaml" },
     { name = "rich" },
@@ -1010,13 +1010,13 @@ dependencies = [
     { name = "typing-extensions" },
     { name = "uvicorn", extra = ["standard"] },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/92/d1/5e33b26985f0c7046a0be1cee2158ada1748ee700d2545057fde1468d74d/chromadb-1.5.9.tar.gz", hash = "sha256:5c20e62a455c28bacac927f26116a73fd8e1799e0d908be8e8a4f02197a54731", size = 2595635, upload-time = "2026-05-05T05:54:51.713Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7f/48/11851dddeadad6abe36ee071fedc99b5bdd2c324df3afa8cb952ae02798b/chromadb-1.1.1.tar.gz", hash = "sha256:ebfce0122753e306a76f1e291d4ddaebe5f01b5979b97ae0bc80b1d4024ff223", size = 1338109, upload-time = "2025-10-05T02:49:14.834Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/dd/5b/3cced915244f43ed14b53fe9f63a37f05f865064f4e4fe7d9448d3f2a352/chromadb-1.5.9-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:60701011b5e6409647fa40d12c7c5a66b2b0bfcf33a52db2ad53a30a2abc4957", size = 22564540, upload-time = "2026-05-05T05:54:48.906Z" },
-    { url = "https://files.pythonhosted.org/packages/34/4c/adcef1f4e82a2ef69ccd3711d55fc289193d54c4c0ff7a0292a3631db46f/chromadb-1.5.9-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:814b9c95617377f6501e5757d63dfddb554a283a7739c87b9fa573850174e6f3", size = 21699698, upload-time = "2026-05-05T05:54:45.078Z" },
-    { url = "https://files.pythonhosted.org/packages/38/4e/937bc4d2e6f8ab9664ec79931fbbd69efff47e513ec2924b071e4b0ff774/chromadb-1.5.9-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9192d111bd662241625867962333d99369a00769a50f8b2f58cb388731274d7e", size = 22680924, upload-time = "2026-05-05T05:54:36.25Z" },
-    { url = "https://files.pythonhosted.org/packages/e6/ec/0c42039e80b9acc534f67b73b7a42471948042859b3a64867b50a4a77fa3/chromadb-1.5.9-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc09b3df76e5a5cb386aed2715a2eea152e3949f9e1ba93c7119505377749929", size = 23316203, upload-time = "2026-05-05T05:54:41.157Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/ce/0f7be6e5d0feafa2cda54b12e6542afeea7dea89d2d411e14da90f8abb96/chromadb-1.5.9-cp39-abi3-win_amd64.whl", hash = "sha256:4fd0b560e56761b7f3cb4d5c6205fd5f20814484b4a3e4e9af9038c2b428fc6c", size = 23542454, upload-time = "2026-05-05T05:54:54.942Z" },
+    { url = "https://files.pythonhosted.org/packages/39/59/0d881a9b7eb63d8d2446cf67fcbb53fb8ae34991759d2b6024a067e90a9a/chromadb-1.1.1-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:27fe0e25ef0f83fb09c30355ab084fe6f246808a7ea29e8c19e85cf45785b90d", size = 19175479, upload-time = "2025-10-05T02:49:12.525Z" },
+    { url = "https://files.pythonhosted.org/packages/94/4f/5a9fa317c84c98e70af48f74b00aa25589626c03a0428b4381b2095f3d73/chromadb-1.1.1-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:95aed58869683f12e7dcbf68b039fe5f576dbe9d1b86b8f4d014c9d077ccafd2", size = 18267188, upload-time = "2025-10-05T02:49:09.236Z" },
+    { url = "https://files.pythonhosted.org/packages/45/1a/02defe2f1c8d1daedb084bbe85f5b6083510a3ba192ed57797a3649a4310/chromadb-1.1.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:06776dad41389a00e7d63d936c3a15c179d502becaf99f75745ee11b062c9b6a", size = 18855754, upload-time = "2025-10-05T02:49:03.299Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/0d/80be82717e5dc19839af24558494811b6f2af2b261a8f21c51b872193b09/chromadb-1.1.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bba0096a7f5e975875ead23a91c0d41d977fbd3767f60d3305a011b0ace7afd3", size = 19893681, upload-time = "2025-10-05T02:49:06.481Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/6e/956e62975305a4e31daf6114a73b3b0683a8f36f8d70b20aabd466770edb/chromadb-1.1.1-cp39-abi3-win_amd64.whl", hash = "sha256:a77aa026a73a18181fd89bbbdb86191c9a82fd42aa0b549ff18d8cae56394c8b", size = 19844042, upload-time = "2025-10-05T02:49:16.925Z" },
 ]
 
 [[package]]
@@ -1421,7 +1421,7 @@ requires-dist = [
     { name = "boto3", marker = "extra == 'aws'", specifier = "~=1.42.79" },
     { name = "boto3", marker = "extra == 'bedrock'", specifier = "~=1.42.79" },
     { name = "cel-python", specifier = ">=0.5.0,<0.6" },
-    { name = "chromadb", specifier = "~=1.5.9" },
+    { name = "chromadb", specifier = "~=1.1.0" },
     { name = "click", specifier = ">=8.1.7,<9" },
     { name = "crewai-cli", editable = "lib/cli" },
     { name = "crewai-core", editable = "lib/crewai-core" },